Revision as of 21:52, 20 March 2012

Generic Notes

These instructions should guide you through installing Nemo Mobile on your desired device.

Images

The first thing you should do is visit our repository and download the latest image for your platform.

The First Boot

The first boot of Nemo on your N900/N950 is likely to be quite slow, so be patient for it to load completely, once loaded, reboot the phone and Nemo should be far more responsive.

Root Password

By default, the root password for Nemo is "nemo" (it used to be "meego" in the older images). Password can also be found in the .ks file, in the same directory you downloaded the image from.

Raw Image Write

Some devices use raw images that are written to SD card and then device is booted by incerting the sd card to the device. Here is instructions how to write raw disk images to the sdcards on different host OS.

Linux Host

The process of installing the Nemo image to your MicroSD card is quite straight forward. Firstly, decompress the raw image file you have downloaded and put it somewhere easy to remember, if you do not have enough room to decompress the image, used the alternative last command. Insert the card into the card reader, your distribution will probably automatically mount it, so we must first find where it is mounted with:

sudo mount

NOTE: Below /dev/sdX is used as an example and may vary, so use the mount point listed from the mount output, can be also /dev/mmcblkX when using some build-in card readers

Then, unmount it with:

sudo umount /dev/sdX

Once you have confirmed which device it is, and unmounted it it is time to copy the image to the MicroSD card using. The command contains two parts first bzcat that uncompresses the image after which the output is redirected to dd which writes it to the card:

bzcat directory/file_goes_here.bz2 | sudo dd bs=4096 of=/dev/sdX

NOTE: "of=" is the output file/location, since we are copying it to the MicroSD card, we put its location here, and since it contains a partition table, we don't specify which partition it is written to. e.g. /dev/sdX, not /dev/sdX1

DD will not show any output until the image has been completely written, so please be patient. (You can, however, press Ctrl+t or pipe trough 'pv' [1] to get information about the progress.)

Example:

bzcat directory/file_goes_here.bz2 | dd bs=4096 | pv -s 3816M | sudo dd bs=4096 of=/dev/sdX

Windows Host

The process of installing the Nemo image to your MicroSD card on windows is also quite straight forward.

• First, extract the .bz2 image, if you don't have any software to do so, you can use Bzip2 for Windows.
  • Download Bzip2 for Windows from here, choosing the first option, to download the setup without the sources.
  • Install Bzip2 for Windows
  • Open run by pressing 'Windows Key + R' and type cmd, press enter to open the command prompt.
  • Navigate to where bzip2.exe was installed and run the command 'bzip2.exe directory/file_goes_here.bz2 '
• The extracted image file will have the extension .raw, but the program we use to write the image doesn't associate with this extension, so right click the file and choose rename, and replace the .raw with .img
• Download the image writer from here, choosing the latest release of the binary [the first download link].
• Extract the contents of the .zip to a known directory.
• Run the .exe labled 'W32DiskImager.exe'
• Select the Nemo Image file
• Select the drive letter/mount point for the MicroSD card [please verify this is the correct device]
• Click 'Write' to begin writing the image to the MicroSD card.

Nokia N900

IT IS RECOMMENDED YOU READ THIS THOROUGHLY BEFORE YOU FLASH YOUR DEVICE

Installing Nemo Mobile on the N900 is relatively simple, in nearly all cases it is installed on the external MicroSD card, so that will be what this guide will be focusing on.

• What you will need:
  • A Nokia N900, updated to PR 1.3.
  • A MicroSD card with a capacity of at least 4GiB (more notes on this below)
  • U-Boot (installed on the phone[more on this below])
  • Either a Windows or Linux PC
  • And the image, for N900, the filename of the file you will want will look like:

 nemo-handset-armv7hl-n900-X.XXXXXXXX.X.NEMO.XXXX-XX-XX.X-mmcblk0p.raw.bz2

• Nemo generally runs well off the MicroSD card, probably better than from the internal eMMC, depending on some of the following factors:
  • Speed/Class of the MicroSD card; a class 10 card should provide adequate performance, though note that the classes aren't a guarantee of performance.
  • Quality/brand of the card; some cards have issues with the N900 and offer slow performance due to I/O errors.
  • If reading reviews/benchmarks of cards before buying, look at the ones with the highest random read/write, not sequential.

Update with the current latest Nemo kernel (Jan 26 2012) there are issues with proper initialization of the SD card due to a potential kernel bug (race condition) together with the Pali version of u-boot. This has been confirmed on at least Samsung cards (8 GB class 6 and CLass 10 by Netweaver and Flocke000), also on others (unknown brand, by Pali and plipp). Bug report is entered. [2]

• U-boot is installed on the N900 through the Hildon Application Manager
  • Enable the extras-devel repository.
  • In the Hildon Application Manager, install the U-Boot package, found in "System" category. (The package is 'uboot-pr13' at the time of writing)
  • Verify the package has been installed correctly by rebooting your N900, at start-up there will be mention of U-Boot and possibly a penguin logo.
  • Once verified installed, disable the extras-devel repository to prevent applications being updated to development versions.

Next thing is to write a image to sd card. For this follow the Raw image write guide.

Once it has been copied to the MicroSD card, you can remove it from your card reader and put it in your N900. Booting the N900 with the card present, the rear cover in place, the MicroSD card inserted and U-Boot correctly installed should result in Nemo Mobile booting.

Nokia N950

IT IS RECOMMENDED YOU READ THIS THOROUGHLY BEFORE YOU FLASH YOUR DEVICE

• You will need:
  • Nokia Harmattan Flash Tool from here.
  • The MOSLO bootloader rootfs available here.
  • An N950 that can flash the MOSLO, 34 and 39 work.
  • Adequate knowledge/skills for what you are doing as THESE INSTRUCTIONS ARE OFFERED WITHOUT WARRANTY.
  • A Linux OS
  • The Nemo image for the N950, the filename of the file you will want will look like:

nemo-handset-armv7hl-n950-X.XXXXXXXX.X.NEMO.XXXX-XX-XX.X.tar.bz2

On Linux Host

If you want to keep your Harmattan installation, you should check the dual-booth method below.

NOTE: Before you begin, assure that the device lock is disabled on the Harmattan installation (Settings>Security>Device Lock>Autolock)

NOTE: Additionally, before installing the bootloader, boot into Harmattan at least once and wait for it to fully load (2-4 mins).

• Make sure your device is fully charged before beginning.
  • Power off your N950, disconnecting the USB/Charger cable.
  • Run the flasher, pointing it at your MOSLO image:

sudo flasher -F moslo-rootfs-X.XXXX.XX-X_RM680-OEM1-XX_X.X.XX-XX.X.bin -f

The flasher will now be ready to program your device, waiting for it to be connected.

• Connect your N950, it should begin flashing, wait for it to finish flashing. DO NOT DISCONNECT WHILE FLASHING
• Do not disconnect. Read next steps.
• After flashing MOSLO, boot the device by disconnecting, then immediately re-connecting the USB cable. You will see a warning, then the MOSLO welcome screen (green text). Wait for the text "Rootfs now exported via USB"
  • If your device doesn't proceed to the MOSLO screen after flashing MOSLO, let it proceed into Harmattan then power down the device, waiting a short time before reconnecting it to the USB.
• Your OS may automount the drive, unmount it [do not 'eject' it from the OS] with cmd:

sudo umount mount_point_here_eg_/dev/sdX

After this reformat the device (Here we say device because moslo export partition in such way that host os sees it as a full device node):

sudo mkfs.ext4 /dev/sdX

• You will see a warning about it being the entire device, not just one partition, check you have the correct device, then proceed, this is expected.
• Now mount your newly formatted partition with the following cmds:

sudo mkdir -p /media/_choose_your_mountpoint_here_
sudo mount /dev/sdX /media/_above_chosen_mountpoint_here_

Now it is time to extract your Nemo image to your N950 with:

sudo tar --numeric-owner -xf directory/nemo-handset-armv7hl-n950-testing-X.XXXXXXXX.X.NEMO.XXXX-XX-XX.X.tar.bz2 -C /media/_above_chosen_mountpoint_here_

After extraction is complete, safely unmount/eject the partition before removing the USB cable:

sudo umount /media/_above_chosen_mountpoint_here_

The device should automatically boot to Nemo after removing the USB cable, however, if it doesn't, hold the power button and turn it on. You will be shown a disclaimer, then briefly the MOSLO screen, after this, wait until the desktop appears.

Dual-boot method

This method allows you to keep both Harmattan and alternative OS such as Nemo on the device, and select which OS to boot when powering the device up.

It's highly adviced to have the latest available Harmattan release for N950. OCF (one-click-flasher) installers can be found here: http://harmattan-dev.nokia.com/release/N950/firmware/.

Get modified MOSLO

wget http://repo.pub.meego.com/home:/marquiz:/n950/CE_Adaptation_N950-armv7hl/armv7hl/moslo-0.0.13.1-7.1.Nemo.Adaptation.N950.N9.armv7hl.rpm

and extract the contents

rpm2cpio moslo-*.armv7hl.rpm | cpio -vidu

Flash modified MOSLO to NAND. (You need to grab the original MOSLO binary from http://tablets-dev.nokia.com/moslo.php, in order to be able to flash.)

sudo flasher -a moslo-rootfs-1.2011.34-2_RM680-OEM1-916_0.0.13-12.1.bin -L usr/share/moslo/moslo.img -f -R

The device is flashed and rebooted to the modified MOSLO. Now it is time to extract your Nemo image to your N950 with:

sudo tar --numeric-owner -xf directory/nemo-handset-armv7hl-n950-testing-X.XXXXXXXX.X.NEMO.XXXX-XX-XX.X.tar.bz2 -C /media/_above_chosen_mountpoint_here_

After extraction is complete, safely unmount/eject the partition before removing the USB cable:

sudo umount /media/_above_chosen_mountpoint_here_

After removing the USB cable, you will be shown a selection to boot Harmattan or the alternative OS (Nemo). NOTE: if Harmattan fails to boot, plug in charger/USB cable right after selecting Harmattan in MOSLO screen and keep it connected.

Uninstalling the dual boot

Create empty file

$ touch empty.img

Flash the empty file

$ flasher -a moslo-rootfs-1.2011.34-2_RM680-OEM1-916_0.0.13-12.1.bin -L empty.img -f -R

If the flashing succeeds, MOSLO is removed and the device should boot to Harmattan.

(Source for this information: http://wiki.meego.com/User:Marquiz/N950)

Nokia N9

DISCLAIMER: These instructions are provided without any warranty what so ever and will break the warranty of your device. Following these instructions is done totally on your own risk. Because of the previously mentioned the instructions are only targetted for hackers/developers only.

By following these instructions you are being aware of following facts:

• You may brick your device to state where it can't be returned to usage
• You may not be able to reinstall harmattan to your device
• You may loose all the data from your device
• You loose your device warranty

YOU HAVE BEEN WARNED!

Guide below is WIP

wget http://repo.pub.meego.com/home:/marquiz:/n950/CE_Adaptation_N950-armv7hl/armv7hl/moslo-n9-0.0.13.1-7.2.Nemo.Adaptation.N950.N9.armv7hl.rpm

rpm2cpio moslo-n9-*.armv7hl.rpm | cpio -vidu

sudo flasher -k usr/share/moslo-n9/zImage-moslo -n usr/share/moslo-n9/initrd-moslo -l -b

After this the N9 is booted with moslo and you see warning about warranty, after which green text comes up that says the N9 is beign repartitioned for AlternateOS. This takes a moment after which the newly created fs is exported via USB.

You should see now /media/Alt_OS if your Linux Host OS has automatic mount enabled. Now next thing is to download the latest nemo release and extract it to the newly created rootfs.

sudo tar --numeric-owner -xf nemo-handset-armv7hl-n950-*.tar.bz2 -C /media/Alt_OS/

When the extract is ready you should umount the device

sudo umount /media/Alt_OS

After this is done disconnect the USB cable and press volumedown key when asked wether to boot to Alternate OS or to Harmattan. In subsequent boots, device will boot directly to Harmattan. To get Alternate OS booting you need to run the above flasher command again.

Recovering your N9 firmware

There is script available that can be used to download the firmware image for your N9 at https://gist.github.com/1636192. For Windows you could use http://www.symbian-toys.com/navifirm.aspx.

git clone git://gist.github.com/1636192.git
cd 1636192

You need to download couple of perl packages to get it working for F16 following command was needed:

yum install perl-LWP-Protocol-https perl-SOAP-Lite

After this execute the script

perl naviperl.pl

And answer to the questions based on your need and device. Last question is about which files you want to download where you should pick at least file that looks similar to DFL61_HARMATTAN_30.2012.07-1_PR_LEGACY_001-OEM1-958_ARM.bin depending of the software version you are about to download.

Detach the USB cable from your device before starting the flasher.

After the file has been downloaded you can reflash your device.

sudo flasher -F DFL61_HARMATTAN_30.2012.07-1_PR_LEGACY_001-OEM1-958_ARM.bin -f --no-preserve 

When following text appears

Suitable USB interface (bootloader/phonet) not found, waiting...

Attach the USB cable between your N9 and host PC and the flashing begins.

When the flasher outputs Success you can detach the USB cable from your PC and your N9 should reboot to Harmattan.

PandaBoard

The installation for PandaBoard is very simple.

Download the nemo image with name handset-armv7l-pandaboard-*.raw and follow the Raw image write guide to put the image to the sd card. After the image is written put the sdcard to PandaBoard and turn on the power.

i586 (e.g., Lenovo Ideapad, ExoPC)

• Get the nemo-handset-i586-*.img from http://repository.maemo.org/meego/Nemo/.
• Write to a USB stick, using your favourite tool(eg. mic-image-writer).
• Insert USB stick, and boot the machine from there (you might need to configure your BIOS settings to do that.)
• After booting the image start Terminal from the application menu (should be on the second page).
• When in terminal change user to root with su cmd (password is nemo by default)

su

Next it is time to start installer:

installer-shell

Next answer to the questions in a way that suits your needs best. When the installation is done type

halt -p

Now when the device powers off you can remove the usb stick and restart the device.

i586 Virtual Machine

VirtualBox

First install the VirtualBox for your host OS, https://www.virtualbox.org/.

Then download the latest image from nemo repository that is named nemo-handset-i586-vm-*.img

After downloading change the extension of the image from .img to .iso and start VirtualBox.

In VirtualBox click New and set following values:

Name: Nemo Mobile
Operating System: Linux
Version: Linux 2.6
Base Memory Size: 512MB

Next comes Startup disk, you can either leave it out, create e.g. 4G disk for the image or use existing disk.

Start-up Disk: Create new disk
File type: VDI (VirtualBox Disk Image)
Storage details: Dynamically allocated or Fixed size
Location: Where you want it
Size: 4G is recommended

After this the basic settings are there, but we need to edit some of them a bit more, so select the "Nemo Mobile" VM and click settings.

System->Processor->Extended Features: Check 'Enable PAE/NX'
Storage->IDE Controller->Empty and then "Setup Virtual CD/DVD drive": Select the .iso file that was renamed earlier

Now you are ready to boot the image. This is done by selecting the "Nemo Mobile" VM and clicking Start

From this point forward the rest of the installation goes like the #i586 (e.g., Lenovo Ideapad, ExoPC) guide.

FAQ

If you have installation problems, you can post them here. More help on IRC Chatroom @ irc.freenode.net ~ #mer and #nemomobile and on our Mailing lists.