Maemo Wiki Mirror - User contributions [en]

Mbarcode Plugin Tutorial

2011-06-14T09:58:31Z

81.217.39.232:

This tutorial will give you a quick introduction to writing plugins for [[mBarcode]]. We will try to guide you from your very first steps all the way to a full fledged plugin.

The plugin we are going to create will show a quick dialog with info about the data contained in the barcode.

== Prerequisites ==

In this tutorial we'll be using Qt together with C++ to connect to the mBarcode plugin framework. To make the process very easy we are also using Qt Creator to write our code and Scratchbox to test and compile it. You don't have to use Scratchbox or Qt Creator if you don't want to, but this is not covered by this tutorial.

Heck, you can even get through this without Qt installed, but bare in mind that you are on your own then.

You must have:
* Some basic knowledge about C++ and Qt
* Scratchbox installed
* Qt
* Access to a terminal
* An OS with dpkg

You could use:
* Qt Creator

Using [[MADDE]] for development is currently a bit of a pain since it lacks an option for third party libraries. There is a tutorial that covers writing these plugins using the Nokia Qt SDK available here [[Mbarcode_Plugin_Tutorial_MADDE]]

== Writing the plugin ==

Using Scratchbox is the easiest way to get started. Log in to Scratchbox by typing

/scratchbox/login

Install the <code>mbarcode-dev</code> package

apt-get install mbarcode-dev

Next, create a new "Empty Qt project" using Qt Creator and store this in <code>/scratchbox/users/<your username>/home/<your username>/</code>. For the sake of simplicity, we'll name our project "plugin".

Alternatively, create an empty folder using the terminal and add an empty plugin.pro file.

=== The project file ===

Add the following to your plugin.pro file:

<pre>
TEMPLATE = lib
CONFIG += plugin
INCLUDEPATH += ../..

HEADERS = plugin.h \
showdialogaction.h
SOURCES = plugin.cpp \
showdialogaction.cpp
TARGET = $$qtLibraryTarget(mbarcode_myplugin)

unix {
# VARIABLES
isEmpty(PREFIX):PREFIX = /usr
BINDIR = $$PREFIX/bin
DATADIR = $$PREFIX/share
DEFINES += DATADIR=\"$$DATADIR\" \
PKGDATADIR=\"$$PKGDATADIR\"

# MAKE INSTALL
INSTALLS += target
target.path = $$DATADIR/mbarcode/plugins
}
OTHER_FILES += debian/changelog \
debian/control
</pre>

=== The plugin actions ===

Let's add some actions for our plugin! In Qt Creator, right click on your project and select "Add New...". Choose "C++ Class" and name it <code>ShowDialogAction</code>.

Open the <code>showdialogaction.h</code> file and overwrite it with the following:

<source lang="cpp">
#ifndef SHOWDIALOGACTION_H
#define SHOWDIALOGACTION_H

#include <QtCore>
#include <mbarcode-qt/plugininterfaces.h>
#include <mbarcode-qt/pluginaction.h>

class ShowDialogAction : public PluginAction
{
Q_OBJECT
public:
ShowDialogAction(const PluginInterface *interface);
QString getName() { return "EAN Local Analyser"; } // This name is just for convenience
QString getText(); // This is the text that will show in the list
void clickAction(QWidget *parentWindow); // The action which is called whenever we are clicked
signals:
void isReady();
private slots:
void barcodeAnalysed(QString barcodeType, QString barcodeData); // The slot where all the processing goes down
private:
QString barcodeType;
QString barcodeData;
};

//Q_DECLARE_METATYPE(ShowDialogAction *);

#endif // SHOWDIALOGACTION_H
</source>

Open the <code>showdialogaction.cpp</code> file and overwrite it with the following:

<source lang="cpp">
#include "showdialogaction.h"

#include <QMessageBox>

ShowDialogAction::ShowDialogAction(const PluginInterface *interface) : PluginAction(interface)
{
// Do your initialization here.
}
QString ShowDialogAction::getText() {
// This is the text which will show in the list of results.
return "Show Dialog";
}
void ShowDialogAction::clickAction(QWidget* parentWindow)
{
// This is what happens when the user clicks our button.
QMessageBox msg(parentWindow);
msg.setWindowTitle("You clicked the button!");
msg.setText("A window should be a dynamic object. Otherwise it is removed at the end of this function. A message box, on the other hand, has the exec().");
msg.exec();
}
void ShowDialogAction::barcodeAnalysed(QString barcodeType, QString barcodeData) {
// In this function you process the data. This could be used for early web lookups or whatever.
// We just store the data in memory for now.
this->barcodeType = barcodeType;
this->barcodeData = barcodeData;
// We've done what we need to and are ready to show ourselves
emit isReady();
}
</source>

You could add more classes like this if you want different buttons with different actions, but for now, this will do.

=== Plugin interface ===

Let's connect to mBarcode's plugin interface. In Qt Creator, right click on your project and select "Add New...". Choose "C++ Class" and name it <code>Plugin</code>.

Open your <code>plugin.h</code> file and overwrite it with the following:

<source lang="cpp">
// This is a plugin used as an example in different tutorials.

#ifndef PLUGIN_H
#define PLUGIN_H

#include <QObject>

#include <mbarcode-qt/plugininterfaces.h>
#include <mbarcode-qt/pluginaction.h>

class Plugin : public QObject, public PluginInterface
{
Q_OBJECT
Q_INTERFACES(PluginInterface)
public:
void initInterface(QWidget *parent);

QSet<PluginAction*> getPluginActions(); // returns a list of actions this plugin provides
QString getName() { return "My Plugin"; } // a name of your choosing

private:
QWidget *parent;
QSet<PluginAction*> pluginActions;

};

#endif // PLUGIN_H
</source>

Open your <code>plugin.cpp</code> file and add the following:

<source lang="cpp">
#include "plugin.h"
#include "showdialogaction.h"

void Plugin::initInterface(QWidget *parent)
{
this->parent = parent;

// Create an action

ShowDialogAction *showDialogAction = new ShowDialogAction(this);

// Add our action to the list

pluginActions.insert(showDialogAction);

// Connect the signal from the MaemoBarcodeWindow to our Action classes.

connect(parent, SIGNAL(barcodeAnalysedSignal(QString,QString)),
showDialogAction, SLOT(barcodeAnalysed(QString,QString)));

// If you like to, you can connect this to whatever you want.
// This means that you could even connect it to a slot in this class.
// We've only chosen to do it this way for convenience.
}

QSet<PluginAction*> Plugin::getPluginActions() {
return pluginActions;
}

Q_EXPORT_PLUGIN2(mbqt_myplugin, Plugin) // Please change this name
</source>

=== Testing your fancy new plugin ===

There you go! You are now ready to build your plugin and test it out. Before we build a complete Debian package, let's see if everything works.

Build your plugin by issuing this command in your project folder in Scratchbox:

qmake && make

Go to your directory and pick up the new file named <code>libmbarcode_myplugin.so</code>. Copy this to your device and place it in <code>/home/user/.config/mbarcode/plugins</code>. (Note: final plugins are stored in <code>/usr/share/mbarcode/plugins</code>. The former path with .config didn't work for me).

Start mBarcode and scan a barcode as usual. Your plugin should now show up.

==== Troubleshooting ====

If your plugin doesn't load, please run mbarcode from terminal and look for error messages during the loading of the application.

== Creating a Debian package ==

To be continued...

[[Category:Development]]
[[Category:mBarcode]]

Nitdroid easy install on EMMC

2011-04-17T20:07:34Z

81.217.39.232: /* Installing NITDroid 0.0.9 to EMMC */

{{danger}}
{{ambox|text='''Under heavy construction'''}}
Original Talk Maemo thread:

http://talk.maemo.org/showpost.php?p=887394&postcount=1

== Installing Nitdroid ==

This tutorial is specifically designed to install Nitdroid on the internal memory of the N900 (EMMC) and does not apply to installation on an external micro SD card.

The main purpose of installing Nitdroid on the internal memory is that in most cases you will see an increased performance.

The EMMC is referred to the internal memory, (27 Gigabyte memory). MMC is referred to the external memory expansion card, the microSD.

What bugs most people is that, this installing procedure is not clarified command by command, but basically, by following the next steps, you will download Nitdroid's system files, unarchive them to a specific partition in your EMMC (/home), and then create a multiboot entry to load them up.

Reference installation video:
http://www.youtube.com/watch?v=Bm6spW5yadk
===Installing NITDroid 0.0.9 to EMMC===

# Download the image + the kernel to /MyDocs i.e. root dir. of N900:
#* Image: http://downloads.nitdroid.com/e-yes/NITDroid-0.0.9.tar.bz2
#* Kernel:http://www.mediafire.com/?zmh7gvj626c6lrp

----

<ol>
<li>
Enable all repositories from App manager ([[Extras-testing]], [[Extras-devel]], [[Extras]] and the default [[User:Jebba/Repositories#Nokia_Official|Nokia repos]])
</li>
<li>
Install [http://maemo.org/downloads/product/Maemo5/leafpad Leafpad] from the App manager and make sure that you have [[root access]]
</li>
<li>
Close App manager, open [[terminal|X Terminal]] and execute the following commands:
<pre>
root
apt-get update
apt-get install nitdroid-installer
y
y again if it asks again.
</pre>
</li>
<li>
After the [http://maemo.org/packages/view/nitdroid-installer/ nitdroid-installer] package is installed, close X Terminal, but do '''NOT''' run the installer you just downloaded.
</li>
<li>
Open X Terminal, and execute the following commands:
<pre>
root
cd /home/user/MyDocs
bzip2 -d NITDroid-0.0.9.tar.bz2
cd /home
mkdir /and
cd /
mount /home /and
cd /and
tar xvf /home/user/MyDocs/NITDroid-0.0.9.tar
dpkg -i /home/user/MyDocs/NITDroid-kernel-Mido.Fayad.deb
</pre>
</li>
<li>
Edit the boot file:
<pre>leafpad /etc/multiboot.d/11</pre>
(then tap the tab button, .item file will show, hit enter to open it in Leafpad). Edit <code>ITEM_DEVICE</code> in the file according to this:
<ul>
<li>
If you have an MMC (micro SD card) plugged in your N900, change <code>ITEM_DEVICE</code> to this:
<pre>
ITEM_DEVICE=${INT_CARD}p2
</pre>
</li>
<li>
If you don't have an MMC plugged in your N900, change <code>ITEM_DEVICE</code> to this:
<pre>
ITEM_DEVICE=mmcblk0p2
</pre>
</li>
</ul>
</li>
<li>
Once editing is complete click the drop down menu on Leafpad and save then close Leafpad.
</li>
<li>
Close X Terminal, reboot N900 and type ‘2’ for NITDroid. (Note: If boot menu doesn't come up at poweron, slide open the keyboard before turning N900 on)
</li>
</ol>

=== Installing Gingerbread to EMMC ===

# Download the image + the kernel to /MyDocs i.e. root dir. of N900:
#* Image: http://downloads.nitdroid.com/e-yes/gingerbread.tar.bz2
#* Kernel: http://www.mediafire.com/?zmh7gvj626c6lrp

----

<ol>
<li>
Enable all repositories from App manager ([[Extras-testing]], [[Extras-devel]], [[Extras]] and the default [[User:Jebba/Repositories#Nokia_Official|Nokia repos]])
</li>
<li>
Install [http://maemo.org/downloads/product/Maemo5/leafpad Leafpad] from the App manager and make sure that you have [[root access]]
</li>
<li>
Close App manager, open [[terminal|X Terminal]] and execute the following commands:
<pre>
root
apt-get update
apt-get install nitdroid-installer
y
y again if it asks again.
</pre>
</li>
<li>
After the [http://maemo.org/packages/view/nitdroid-installer/ nitdroid-installer] package is installed, close X Terminal, but do '''NOT''' run the installer you just downloaded.
</li>
<li>
Open X Terminal, and execute the following commands:
<pre>
root
cd /home/user/MyDocs
bzip2 -d gingerbread.tar.bz2
cd /home
mkdir /and
cd /
mount /home /and
cd /and
tar xvf /home/user/MyDocs/gingerbread.tar
dpkg -i /home/user/MyDocs/NITDroid-kernel-Mido.Fayad.deb
</pre>
</li>
<li>
Edit the boot file:
<pre>leafpad /etc/multiboot.d/11</pre>(then tap the tab button, .item file will show, hit enter to open it in Leafpad). Edit <code>ITEM_DEVICE</code> in the file according to this:
<ul>
<li>
If you have an MMC plugged in your N900, change <code>ITEM_DEVICE</code> to this:
<pre>
ITEM_DEVICE=${INT_CARD}p2
</pre>
</li>
<li>
If you don't have an MMC plugged in your N900, change <code>ITEM_DEVICE</code> to this:
<pre>
ITEM_DEVICE=mmcblk0p2
</pre>
</li>
</ul>
</li>
<li>
Once editing is complete click the drop down menu on Leafpad and save then close Leafpad.
</li>
<li>
Close X Terminal, reboot N900 and type ‘2’ for NITDroid.
</li>
</ol>

==== Applying Gingerbread updates: ====
Place all updates in MyDocs i.e. root dir. of N900.

'''Update 1:''' http://downloads.nitdroid.com/e-yes/gingerbread_update1.tar.bz2
<pre>
root
cd /home/user/MyDocs
bzip2 -d gingerbread_update1.tar.bz2
cd /
mount /home /and
cd /and
tar xvf /home/user/MyDocs/gingerbread_update1.tar
</pre>
'''Update 2:''' http://downloads.nitdroid.com/e-yes/gingerbread_update2.tar.bz2
<pre>
root
cd /home/user/MyDocs
bzip2 -d gingerbread_update2.tar.bz2
cd /
mount /home /and
cd /and
tar xvf /home/user/MyDocs/gingerbread_update2.tar
</pre>
'''Update 3:''' http://downloads.nitdroid.com/e-yes/gingerbread_superuser.tar.bz2
<pre>
root
cd /home/user/MyDocs
bzip2 -d gingerbread_superuser.tar.bz2
cd /
mount /home /and
cd /and
tar xvf /home/user/MyDocs/gingerbread_superuser.tar
</pre>
'''Update 4:''' http://downloads.nitdroid.com/e-yes/LatinIME.apk
<pre>
root
mount /home /and
cd /home/user/MyDocs
cp LatinIME.apk /and/system/app/
</pre>
'''Update 5:''' http://downloads.nitdroid.com/e-yes/gps.nokia.so
<pre>
root
mount /home /and
cd /home/user/MyDocs
cp gps.nokia.so /and/system/lib/hw/
</pre>

===Installing NITDroid N11 to EMMC (in development)===

# Download the image + the kernel to /MyDocs i.e. root dir. of N900:
#* Image: http://downloads.nitdroid.com/e-yes/N11_Vostok.tar.bz2
#* Kernel:http://downloads.nitdroid.com/e-yes/nitdroid-kernel-2.6.28-06_final1_armel.deb

----

<ol>
<li>
Enable all repositories from App manager ([[Extras-testing]], [[Extras-devel]], [[Extras]] and the default [[User:Jebba/Repositories#Nokia_Official|Nokia repos]])
</li>
<li>
Install [http://maemo.org/downloads/product/Maemo5/leafpad Leafpad] from the App manager and make sure that you have [[root access]]
</li>
<li>
Close App manager, open [[terminal|X Terminal]] and execute the following commands:
<pre>
root
apt-get update
apt-get install nitdroid-installer
y
y again if it asks again.
</pre>
</li>
<li>
After the [http://maemo.org/packages/view/nitdroid-installer/ nitdroid-installer] package is installed, close X Terminal, but do '''NOT''' run the installer you just downloaded.
</li>
<li>
Open X Terminal, and execute the following commands:
<pre>
root
cd /home/user/MyDocs
bzip2 -d N11_Vostok.tar.bz2
cd /home
mkdir /and
cd /
mount /home /and
cd /and
tar xvf /home/user/MyDocs/N11_Vostok.tar
dpkg -i /home/user/MyDocs/nitdroid-kernel-2.6.28-06_final1_armel.deb
</pre>
</li>
<li>
Edit the boot file:
<pre>leafpad /etc/multiboot.d/11</pre>
(then tap the tab button, .item file will show, hit enter to open it in Leafpad). Edit <code>ITEM_DEVICE</code> in the file according to this:
<ul>
<li>
If you have an MMC (micro SD card) plugged in your N900, change <code>ITEM_DEVICE</code> to this:
<pre>
ITEM_DEVICE=${INT_CARD}p2
</pre>
</li>
<li>
If you don't have an MMC plugged in your N900, change <code>ITEM_DEVICE</code> to this:
<pre>
ITEM_DEVICE=mmcblk0p2
</pre>
</li>
</ul>
</li>
<li>
Once editing is complete click the drop down menu on Leafpad and save then close Leafpad.
</li>
<li>
Close X Terminal, reboot N900 and type ‘2’ for NITDroid.
</li>
</ol>

==Fixes==

===APP Market Fix===

# Open the '''Market''' app (from the Home screen or app launcher)
# Leaving the Market app running, return to the Home screen and open the '''Settings''' app again
# Within Settings select '''Applications''' → '''Manage applications''' → '''Running''' (from Tab at top)
# Scroll to select the '''Market''' app → press the '''Clear Cache''' button → then press the '''Force Stop''' button (Do not press the '''Clear Data''' button)
# Press the back button (to go back to the list of running apps)
# Scroll to select '''Google Services Framework''' → press the '''Clear Data''' button → '''OK''' (to confirm) → then press the '''Force Stop''' button
# Return to the Home screen
# Launch the '''Market''' app again, which will give an error "Attention an error has occurred..." → '''OK''' button
# Shutdown by holding power button → '''Power Off''' → '''OK'''
# Restart, wait for wi-fi to reconnect, open '''Market''' again (You may have to reboot several times and check '''Market''')

The opening '''Market''' screen should no longer be blank, and many more apps (free & paid) should now be available. (Although apps can be downloaded, some may still fail to install or run properly)

===WIFI Fix (rare cases)===

Change the encryption from WPA2 to WPA from your Wireless Access Point. This is a compatibility issue hopefully going to be fixed in later releases.

===Airplane Mode Fix===

For people who enabled airplane mode, fixes are here:

<ol>
<li>
Enable the widget power control and turn airplane mode off
</li>
<li>
If this didn't work disable pin code in maemo
</li>
<li>
'''menu'''→'''devtools'''→'''terminal emulator'''
<pre>
su
rr
</pre>
</li>
<li>
The technical solution:
<pre>
cd /and/data
rm -rf *
mkdir logs
chmod 777 logs
cd /
umount /and
</pre>
</li>
</ol>

===Google account sign-in===

Skip google sign-up in the first tutorial instead, sign up/in google once in NITDroid.

==Overclocking Nitdroid==

#You can download ready GUI's from the market for OCing: http://talk.maemo.org/attachment.php?attachmentid=16607&d=1293643705
#Or use one of these profiles: http://forum.nitdroid.com/index.php?topic=116.0

==Kernel Power installation==

For kernel-power multiboot entry:
http://www.mediafire.com/?t3mdemq1hj7v5ur

1. Unrar this archive to ./MyDocs, then:
2. On Xterminal, execute:<pre>root
mount /home /and
dpkg -i /home/user/MyDocs/multiboot-0.2.11-kernel-power-46-Android-Kernel/*
</pre>
3. Reboot your device, you shall see a new multiboot entry for kernel-power.

==Custom EMMC's==

Just in case you fear to run out of memory, here are custom EMMC's if you want to reflash with:

5GB app memory 24GB /MyDocs: http://www.mediafire.com/?j6srnaxwr3notaf

and/or

8GB app memory 21GB /MyDocs: http://www.mediafire.com/?5o1hkuuwhn8hh1c

== Uninstalling Nitdroid ==
Open X Terminal and type the following commands:

If on your mmc:

<pre>
root
mount /dev/mmcblk1p2 /and -o noatime
nitdroid-uninstaller
</pre>

If on your emmc:
<pre>
root
mount /dev/mmcblk0p2 /and -o noatime
nitdroid-uninstaller
</pre>

After it completes, simply format your microSD card, then using filebox delete nitdroid's installation folders and files that were copied to home:
bin, data, dev, etc (symlink), initrd, lib (symlink), mnt, proc, sbin, sdcard, sys, system, tmp, usr,default.prop, init, init.nokia.rc, init.rc

==Videos of NITDroid running on EMMC==

My video: http://www.youtube.com/watch?v=l_9kG81m-S4

Mr.NokiaTecs' video: http://www.youtube.com/watch?v=z7MIGu2POzY

Nokiatolo: http://www.youtube.com/watch?v=KYmOpftdtqg

Warlord1994's video: http://www.youtube.com/watch?v=UCVAho3_rDM

[[Category:Power users]]
[[Category:N900]]

Nitdroid easy install on EMMC

2011-04-17T20:05:56Z

81.217.39.232: /* Installing NITDroid 0.0.9 to EMMC */

{{danger}}
{{ambox|text='''Under heavy construction'''}}
Original Talk Maemo thread:

http://talk.maemo.org/showpost.php?p=887394&postcount=1

== Installing Nitdroid ==

This tutorial is specifically designed to install Nitdroid on the internal memory of the N900 (EMMC) and does not apply to installation on an external micro SD card.

The main purpose of installing Nitdroid on the internal memory is that in most cases you will see an increased performance.

The EMMC is referred to the internal memory, (27 Gigabyte memory). MMC is referred to the external memory expansion card, the microSD.

What bugs most people is that, this installing procedure is not clarified command by command, but basically, by following the next steps, you will download Nitdroid's system files, unarchive them to a specific partition in your EMMC (/home), and then create a multiboot entry to load them up.

Reference installation video:
http://www.youtube.com/watch?v=Bm6spW5yadk
===Installing NITDroid 0.0.9 to EMMC===

# Download the image + the kernel to /MyDocs i.e. root dir. of N900:
#* Image: http://downloads.nitdroid.com/e-yes/NITDroid-0.0.9.tar.bz2
#* Kernel:http://www.mediafire.com/?zmh7gvj626c6lrp

----

<ol>
<li>
Enable all repositories from App manager ([[Extras-testing]], [[Extras-devel]], [[Extras]] and the default [[User:Jebba/Repositories#Nokia_Official|Nokia repos]])
</li>
<li>
Install [http://maemo.org/downloads/product/Maemo5/leafpad Leafpad] from the App manager and make sure that you have [[root access]]
</li>
<li>
Close App manager, open [[terminal|X Terminal]] and execute the following commands:
<pre>
root
apt-get update
apt-get install nitdroid-installer
y
y again if it asks again.
</pre>
</li>
<li>
After the [http://maemo.org/packages/view/nitdroid-installer/ nitdroid-installer] package is installed, close X Terminal, but do '''NOT''' run the installer you just downloaded.
</li>
<li>
Open X Terminal, and execute the following commands:
<pre>
root
cd /home/user/MyDocs
bzip2 -d NITDroid-0.0.9.tar.bz2
cd /home
mkdir /and
cd /
mount /home /and
cd /and
tar xvf /home/user/MyDocs/NITDroid-0.0.9.tar
dpkg -i /home/user/MyDocs/NITDroid-kernel-Mido.Fayad.deb
</pre>
</li>
<li>
Edit the boot file:
<pre>leafpad /etc/multiboot.d/11</pre>
(then tap the tab button, .item file will show, hit enter to open it in Leafpad). Edit <code>ITEM_DEVICE</code> in the file according to this:
<ul>
<li>
If you have an MMC (micro SD card) plugged in your N900, change <code>ITEM_DEVICE</code> to this:
<pre>
ITEM_DEVICE=${INT_CARD}p2
</pre>
</li>
<li>
If you don't have an MMC plugged in your N900, change <code>ITEM_DEVICE</code> to this:
<pre>
ITEM_DEVICE=mmcblk0p2
</pre>
</li>
</ul>
</li>
<li>
Once editing is complete click the drop down menu on Leafpad and save then close Leafpad.
</li>
<li>
Close X Terminal, reboot N900 and type ‘2’ for NITDroid. (Note: If boot menu doesn't come up on reboot, slide open the keyboard before turning N900 on)
</li>
</ol>

=== Installing Gingerbread to EMMC ===

# Download the image + the kernel to /MyDocs i.e. root dir. of N900:
#* Image: http://downloads.nitdroid.com/e-yes/gingerbread.tar.bz2
#* Kernel: http://www.mediafire.com/?zmh7gvj626c6lrp

----

<ol>
<li>
Enable all repositories from App manager ([[Extras-testing]], [[Extras-devel]], [[Extras]] and the default [[User:Jebba/Repositories#Nokia_Official|Nokia repos]])
</li>
<li>
Install [http://maemo.org/downloads/product/Maemo5/leafpad Leafpad] from the App manager and make sure that you have [[root access]]
</li>
<li>
Close App manager, open [[terminal|X Terminal]] and execute the following commands:
<pre>
root
apt-get update
apt-get install nitdroid-installer
y
y again if it asks again.
</pre>
</li>
<li>
After the [http://maemo.org/packages/view/nitdroid-installer/ nitdroid-installer] package is installed, close X Terminal, but do '''NOT''' run the installer you just downloaded.
</li>
<li>
Open X Terminal, and execute the following commands:
<pre>
root
cd /home/user/MyDocs
bzip2 -d gingerbread.tar.bz2
cd /home
mkdir /and
cd /
mount /home /and
cd /and
tar xvf /home/user/MyDocs/gingerbread.tar
dpkg -i /home/user/MyDocs/NITDroid-kernel-Mido.Fayad.deb
</pre>
</li>
<li>
Edit the boot file:
<pre>leafpad /etc/multiboot.d/11</pre>(then tap the tab button, .item file will show, hit enter to open it in Leafpad). Edit <code>ITEM_DEVICE</code> in the file according to this:
<ul>
<li>
If you have an MMC plugged in your N900, change <code>ITEM_DEVICE</code> to this:
<pre>
ITEM_DEVICE=${INT_CARD}p2
</pre>
</li>
<li>
If you don't have an MMC plugged in your N900, change <code>ITEM_DEVICE</code> to this:
<pre>
ITEM_DEVICE=mmcblk0p2
</pre>
</li>
</ul>
</li>
<li>
Once editing is complete click the drop down menu on Leafpad and save then close Leafpad.
</li>
<li>
Close X Terminal, reboot N900 and type ‘2’ for NITDroid.
</li>
</ol>

==== Applying Gingerbread updates: ====
Place all updates in MyDocs i.e. root dir. of N900.

'''Update 1:''' http://downloads.nitdroid.com/e-yes/gingerbread_update1.tar.bz2
<pre>
root
cd /home/user/MyDocs
bzip2 -d gingerbread_update1.tar.bz2
cd /
mount /home /and
cd /and
tar xvf /home/user/MyDocs/gingerbread_update1.tar
</pre>
'''Update 2:''' http://downloads.nitdroid.com/e-yes/gingerbread_update2.tar.bz2
<pre>
root
cd /home/user/MyDocs
bzip2 -d gingerbread_update2.tar.bz2
cd /
mount /home /and
cd /and
tar xvf /home/user/MyDocs/gingerbread_update2.tar
</pre>
'''Update 3:''' http://downloads.nitdroid.com/e-yes/gingerbread_superuser.tar.bz2
<pre>
root
cd /home/user/MyDocs
bzip2 -d gingerbread_superuser.tar.bz2
cd /
mount /home /and
cd /and
tar xvf /home/user/MyDocs/gingerbread_superuser.tar
</pre>
'''Update 4:''' http://downloads.nitdroid.com/e-yes/LatinIME.apk
<pre>
root
mount /home /and
cd /home/user/MyDocs
cp LatinIME.apk /and/system/app/
</pre>
'''Update 5:''' http://downloads.nitdroid.com/e-yes/gps.nokia.so
<pre>
root
mount /home /and
cd /home/user/MyDocs
cp gps.nokia.so /and/system/lib/hw/
</pre>

===Installing NITDroid N11 to EMMC (in development)===

# Download the image + the kernel to /MyDocs i.e. root dir. of N900:
#* Image: http://downloads.nitdroid.com/e-yes/N11_Vostok.tar.bz2
#* Kernel:http://downloads.nitdroid.com/e-yes/nitdroid-kernel-2.6.28-06_final1_armel.deb

----

<ol>
<li>
Enable all repositories from App manager ([[Extras-testing]], [[Extras-devel]], [[Extras]] and the default [[User:Jebba/Repositories#Nokia_Official|Nokia repos]])
</li>
<li>
Install [http://maemo.org/downloads/product/Maemo5/leafpad Leafpad] from the App manager and make sure that you have [[root access]]
</li>
<li>
Close App manager, open [[terminal|X Terminal]] and execute the following commands:
<pre>
root
apt-get update
apt-get install nitdroid-installer
y
y again if it asks again.
</pre>
</li>
<li>
After the [http://maemo.org/packages/view/nitdroid-installer/ nitdroid-installer] package is installed, close X Terminal, but do '''NOT''' run the installer you just downloaded.
</li>
<li>
Open X Terminal, and execute the following commands:
<pre>
root
cd /home/user/MyDocs
bzip2 -d N11_Vostok.tar.bz2
cd /home
mkdir /and
cd /
mount /home /and
cd /and
tar xvf /home/user/MyDocs/N11_Vostok.tar
dpkg -i /home/user/MyDocs/nitdroid-kernel-2.6.28-06_final1_armel.deb
</pre>
</li>
<li>
Edit the boot file:
<pre>leafpad /etc/multiboot.d/11</pre>
(then tap the tab button, .item file will show, hit enter to open it in Leafpad). Edit <code>ITEM_DEVICE</code> in the file according to this:
<ul>
<li>
If you have an MMC (micro SD card) plugged in your N900, change <code>ITEM_DEVICE</code> to this:
<pre>
ITEM_DEVICE=${INT_CARD}p2
</pre>
</li>
<li>
If you don't have an MMC plugged in your N900, change <code>ITEM_DEVICE</code> to this:
<pre>
ITEM_DEVICE=mmcblk0p2
</pre>
</li>
</ul>
</li>
<li>
Once editing is complete click the drop down menu on Leafpad and save then close Leafpad.
</li>
<li>
Close X Terminal, reboot N900 and type ‘2’ for NITDroid.
</li>
</ol>

==Fixes==

===APP Market Fix===

# Open the '''Market''' app (from the Home screen or app launcher)
# Leaving the Market app running, return to the Home screen and open the '''Settings''' app again
# Within Settings select '''Applications''' → '''Manage applications''' → '''Running''' (from Tab at top)
# Scroll to select the '''Market''' app → press the '''Clear Cache''' button → then press the '''Force Stop''' button (Do not press the '''Clear Data''' button)
# Press the back button (to go back to the list of running apps)
# Scroll to select '''Google Services Framework''' → press the '''Clear Data''' button → '''OK''' (to confirm) → then press the '''Force Stop''' button
# Return to the Home screen
# Launch the '''Market''' app again, which will give an error "Attention an error has occurred..." → '''OK''' button
# Shutdown by holding power button → '''Power Off''' → '''OK'''
# Restart, wait for wi-fi to reconnect, open '''Market''' again (You may have to reboot several times and check '''Market''')

The opening '''Market''' screen should no longer be blank, and many more apps (free & paid) should now be available. (Although apps can be downloaded, some may still fail to install or run properly)

===WIFI Fix (rare cases)===

Change the encryption from WPA2 to WPA from your Wireless Access Point. This is a compatibility issue hopefully going to be fixed in later releases.

===Airplane Mode Fix===

For people who enabled airplane mode, fixes are here:

<ol>
<li>
Enable the widget power control and turn airplane mode off
</li>
<li>
If this didn't work disable pin code in maemo
</li>
<li>
'''menu'''→'''devtools'''→'''terminal emulator'''
<pre>
su
rr
</pre>
</li>
<li>
The technical solution:
<pre>
cd /and/data
rm -rf *
mkdir logs
chmod 777 logs
cd /
umount /and
</pre>
</li>
</ol>

===Google account sign-in===

Skip google sign-up in the first tutorial instead, sign up/in google once in NITDroid.

==Overclocking Nitdroid==

#You can download ready GUI's from the market for OCing: http://talk.maemo.org/attachment.php?attachmentid=16607&d=1293643705
#Or use one of these profiles: http://forum.nitdroid.com/index.php?topic=116.0

==Kernel Power installation==

For kernel-power multiboot entry:
http://www.mediafire.com/?t3mdemq1hj7v5ur

1. Unrar this archive to ./MyDocs, then:
2. On Xterminal, execute:<pre>root
mount /home /and
dpkg -i /home/user/MyDocs/multiboot-0.2.11-kernel-power-46-Android-Kernel/*
</pre>
3. Reboot your device, you shall see a new multiboot entry for kernel-power.

==Custom EMMC's==

Just in case you fear to run out of memory, here are custom EMMC's if you want to reflash with:

5GB app memory 24GB /MyDocs: http://www.mediafire.com/?j6srnaxwr3notaf

and/or

8GB app memory 21GB /MyDocs: http://www.mediafire.com/?5o1hkuuwhn8hh1c

== Uninstalling Nitdroid ==
Open X Terminal and type the following commands:

If on your mmc:

<pre>
root
mount /dev/mmcblk1p2 /and -o noatime
nitdroid-uninstaller
</pre>

If on your emmc:
<pre>
root
mount /dev/mmcblk0p2 /and -o noatime
nitdroid-uninstaller
</pre>

After it completes, simply format your microSD card, then using filebox delete nitdroid's installation folders and files that were copied to home:
bin, data, dev, etc (symlink), initrd, lib (symlink), mnt, proc, sbin, sdcard, sys, system, tmp, usr,default.prop, init, init.nokia.rc, init.rc

==Videos of NITDroid running on EMMC==

My video: http://www.youtube.com/watch?v=l_9kG81m-S4

Mr.NokiaTecs' video: http://www.youtube.com/watch?v=z7MIGu2POzY

Nokiatolo: http://www.youtube.com/watch?v=KYmOpftdtqg

Warlord1994's video: http://www.youtube.com/watch?v=UCVAho3_rDM

[[Category:Power users]]
[[Category:N900]]