Ubiboot

Revision as of 18:27, 31 August 2013

Introduction

Ubiboot is a boot manager for N9(50) devices. Using the example configuration it is fairly easy to triple-boot the device between Harmattan/Nitdroid/Nemo Operating Systems, and change kernels at will.

Ubiboot is mainly aimed at developers and advanced users, so be warned. The procedures in this guide require understanding of the structure of an *nix filesystem and knowledge to work on a shell prompt (i.e. Terminal/Command Line).

Benefits of Ubiboot N9

You can have multiple boot Operating Systems, each with multiple optional kernels on the device.
Selecting the boot kernel is quick and easy with the graphical touchscreen menus.
You will not need to flash the device to install and test a new kernel, just copying the kernel and modules to the device is enough.
You have integrated repair/maintanance mode on the device, where you can export all partitions for backup/restore to a PC automatically.
You can telnet to the device in maintanance mode, to do any desired repair operations.

Prerequisites

To ensure that most of your efforts are focused on actual Ubiboot installation/setting up of a Triple Boot system, please make sure to fulfill the following prerequisites:

Flash the device (for a fresh start/clean state)

It is assumed that you have backed up your important files (messages, contacts, pictures, videos, music, etc.) before flashing the device.

TIP: The sequence of flashing commands below combines the usual flashing steps found in the N9 Flashing Wiki, plus actual flashing of the Open-Mode Kernel so that upon first boot, the device will already be in "Open-Mode". If you follow this style of flashing the device, you will no longer need to delete some folders (.accounts/, ./aegis, and ./activesync) as well as no longer needing to issue the command for disabling the "Scary Warranty Warning".

Flash your device with rootfs, omit the parameter "-R" (which means "reboot")

sudo flasher -F <yourmainfirmware.bin> -f

sudo flasher -F <yourmainfirmware.bin> -F <youremmc.bin> -f

or "Zeroize Method" of flashing, which "wipes" user data and EMMC. Note that this command flashes the eMMC twice and takes many hours to complete the process. You will see a notification/warning of eMMC "unnecessarily being flashed twice") in the Terminal when flashing via this method.

sudo flasher -f -F <yourmainfirmware.bin> --erase-user-data=secure -F <youremmc.bin> --erase-mmc=secure

Next, take care to directly flash the open mode kernel (do NOT boot up, nor pull USB cable, do not wait too long) with

sudo flasher -a <yourmainfirmware.bin> -k zImage_2.6.32.54-openmode_l2fix --flash-only=kernel -f -R

(All credits to jonni/rainisto)

--peterleinchen 16:27, 25 June 2013 (UTC)

When Not Starting From A Fresh Flash

Open Terminal on the device.
Type the following commands and press Enter after typing each command (NOTE: this will delete all configured Accounts):

disclaimer-cal remove View-openmode
rm -rf /home/user/.accounts/
rm -rf /home/user/.aegis/
rm -rf /home/user/.activesync/

Shut down the device, plug to a USB cable and to a computer, and proceed with flashing the Open-Mode kernel as mentioned above:

sudo flasher -a <yourmainfirmware.bin> -k zImage_2.6.32.54-openmode_l2fix --flash-only=kernel -f -R

Upon first boot, you may set up your Accounts (email, social media accounts, i.e. Facebook etc.) once again.

REMINDERS:

In MS Windows, just omit the word “sudo” from the command.
In MS Windows, the “zImage_2.6.32.54-openmode_l2fix” file needs to be in the same location as the Flasher Application, FIASCO, and eMMC images. Usually you would have installed the Flasher Application to C:\Program Files\Nokia\Flasher.
For Linux users, usual “best practice” is to save the FIASCO, eMMC, and whatever Kernels at the main directory (/home/yourusername).
"PIN Code Request" should be disabled when you are using Open-Mode.

Download Needed Files

Ubiboot Files

Find the latest versions at http://www.swagman.org/juice/ubiboot/. Files are also mirrored at http://juiceme.cloud-7.de/ubiboot/

preinits.tar: this is a compressed file, like Zip (Windows users: use 7zip application). We will extract this later on once this is copied to the device.
zImage_2.6.32.54-openmode_l2fix: this is used for flashing your device to “Open-Mode” (Windows users: save this in the same location as your flasher application and files...usually C:\Program Files\Nokia\Flasher).
zImage-2.6.32.54-dfl61-20121301 from http://maemo.cloud-7.de/HARM/N9/1.3/openmode-kernel/: this is the “default” or “plain Open-Mode” kernel. Including this to your ubiboot-02 setup is optional.
zImage_2.6.32.54-ubiboot-02_040613: this is used for flashing ubiboot to your device (Windows users: save this in the same location as your flasher application and files, usually C:\Program Files\Nokia\Flasher).
ubiboot-02_040613.tar: this is a compressed file, like Zip. After downloading, extract the contents of this file (Windows users: use 7zip application). This compressed file contains 2 files that you will need to extract and copy to the “/home/user/MyDocs/boot” folder of your device (you should create the boot folder inside MyDocs before):
- ubiboot.conf
- ubiboot-02.menus.cpio

NITDroid Files

Find the latest versions at http://downloads.nitdroid.com/e-yes/n9/

nitdroid_n9_jellybean_alpha5.tar.bz2: latest “Jelly Bean” version available as of this writing.
apps2sd_fix_alpha5.tar.bz2: this fix allow apps to install into the SD Card.
zImage: (recommended) this is the “new version” of zImage.pr13, which is tailored for use with ubiboot. IMPORTANT: Rename this to “zImage_e-yes_nitdroid+l2fix” (without the quotes).
zImage.pr13: (not recommended) before Ubiboot was published, this was the latest zImage being used for dual-booting or multi-booting NITDroid.

Nemo Files

Find the latest versions at http://releases.nemomobile.org/snapshots/images/

nemo-armv7hl-n950-0.20130620.0.1.tar.bz2: this contains the actual Nemo OS image as of this writing.
moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm: this is the MOSLO file needed for flashing when installing Nemo. You may alternatively download this file via the "wget" Terminal Command in Linux, as outlined in the official Nemo Wiki:

wget -r -l1 -nd --no-parent -Amoslo-0.*.rpm http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/

Using command lines

If you have no idea what are those lines, then skip this chapter and do using the GUI as explained later

you need to install wget (ie: from RzR shared repo)

   sudo flasher-3.12 -a ${bin_file} -k "zImage_2.6.32.54-openmode_l2fix" --flash-only=kernel -f -R

   ssh user@tel # devel-su # /sbin/halt

  ssh user@tel

   mkdir -p  '/home/user/MyDocs/boot'
   wget http://www.swagman.org/juice/ubiboot/ubiboot-02/ubiboot-02_040613.tar | tar xf -C '/home/user/MyDocs/boot' -

 md5sum /home/user/MyDocs/boot/*
 #5176490dc2184bb5869824c29b1be244  /home/user/MyDocs/boot/ubiboot-02.menus.cpio
 #a1fcf98f77fbd38ef5ad456aee7cc235  /home/user/MyDocs/boot/ubiboot.conf

   devel-su # gain root

 cd /boot
   wget -c http://www.swagman.org/juice/ubiboot/other/zImage_2.6.32.54-openmode_l2fix
   wget -c http://maemo.cloud-7.de/HARM/N9/1.3/openmode-kernel/zImage-2.6.32.54-dfl61-20121301
   wget -c http://www.swagman.org/juice/ubiboot/ubiboot-02/zImage_2.6.32.54-ubiboot-02_040613
   wget -c http://downloads.nitdroid.com/e-yes/n9/ubiboot/zImage -O 'zImage_e-yes_nitdroid+l2fix'
   wget -c http://downloads.nitdroid.com/e-yes/n9/zImage.pr13

 md5sum /boot/* | sort
 # 22114bd3cbaa88ee8c49c022f53080a1  /boot/zImage_e-yes_nitdroid+l2fix
 # 35da7f3dc5218be835487d6ec6b9b71e  /boot/zImage-2.6.32.54-dfl61-20121301
 # 3f354a2b48a0b571ca32d6082391108a  /boot/zImage.pr13
 # a4d9c7ad4a7721b1aac3130d530644a4  /boot/zImage_2.6.32.54-ubiboot-02_040613
 # b64bc24b96faf6763f5e403eb5c7f528  /boot/zImage_2.6.32.54-openmode_l2fix

 wget -O- http://www.swagman.org/juice/ubiboot/other/preinits.tar  | tar xfv - -C /
 md5sum /sbin/preinit_harmattan /sbin/preinit_nitdroid 
 # 659af796bb8e33977abbfdabd92c11b0  /sbin/preinit_harmattan
 # 2e28b1905ebdc3feb1062a4cb940e25c  /sbin/preinit_nitdroid

devel-su

 mv  /home/nitdroid /home/nitdroid.tmp
 mkdir -p /home/nitdroid
 wget -O- http://downloads.nitdroid.com/e-yes/n9/nitdroid_n9_jellybean_alpha5.tar.bz2  | tar xfj - -C /home/nitdroid 
 echo $?

 wget -O- http://downloads.nitdroid.com/e-yes/n9/apps2sd_fix_alpha5.tar.bz2  | tar xfj - -C /home/nitdroid 
 echo $?

Later :

http://releases.nemomobile.org/snapshots/images/0.20130411.1.NEMO.2013-04-26.1/nemo-armv7hl-n950/nemo-armv7hl-n950-0.20130411.1.NEMO.2013-04-26.1.tar.bz2 # wget -c http://releases.nemomobile.org/releases/0.20130620.0.1/images/nemo-armv7hl-n950/nemo-armv7hl-n950-0.20130620.0.1.tar.bz2

  # wget -c http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm

Prepare the Device

Enable Developer Mode and Installation of non-store sources

Enable “Allow installations from non-store sources (Settings → Applications → Installations).
Enable “Developer Mode” (Setitngs → Security → Developer mode)...your device will restart. Upon restart, you will now see Terminal being available for use.

Install and Prepare Filebox and Filebox Root

Install Filebox from Nokia Store on your device.
Install N9 Quick Tweak. Upon installation, run N9 Quick Tweak and enable “Root Filebox” (as of the latest version, this is under Tweak H.
You should now have Filebox Root. Open Filebox Root and navigate to “MyDocs” (usually at first use of Filebox, you are already at “MyDocs”) and create a new folder called “boot” (without the quotes).
In the “Settings” (the gear icon at the lower-right), enable the following:
- Show root filesystem
- Show hidden filesystem
- Show thumbnails

Moving files using Filebox Root

This section guides you on where to move/copy the files that were downloaded in the Download Needed Files section above.

Place/move/copy the following files inside the newly-created “boot” folder under “MyDocs”:

ubiboot.conf
ubiboot-02.menus.cpio

Next is to move the "zImage..." files.

Go up three (3) levels by pressing the “up” arrow (found at the lower-left of Filebox Root) . You should be at the “root” folder (you can confirm this when you see that the blue banner at the top of Filebox Root shows only a forward-slash “/”).
Find the “/boot” folder...we are looking for the "/boot" under root directory, not the “/home/user/MyDocs/boot” folder (i.e. that we created inside “MyDocs”) and go inside that folder.
Paste the three (or four) "zImage..." files:

zImage_2.6.32.54-openmode_l2fix
zImage.pr13
zImage
zImage-2.6.32.54-dfl61-20121301 (Optional)

REVIEW/RECAP: These are the locations where the "needed files" are to be moved/pasted/located.

/home/user/MyDocs should contain:

preinits.tar
nitdroid_n9_jellybean_alpha5.tar.bz2
apps2sd_fix_alpha5.tar.bz2

/home/user/MyDocs/boot should contain:

ubiboot.conf
ubiboot-02.menus.cpio

/boot should contain:

zImage_2.6.32.54-openmode_l2fix
zImage.pr13
zImage (which by now, has been renamed to “zImage_e-yes_nitdroid+l2fix”, without the quotes)
zImage-2.6.32.54-dfl61-20121301 (Optional)

Extract preinits.tar and the NITDroid files

NOTE: Terminal should still be open at this point.

Type the following commands in the Terminal and press Enter after typing each command (NOTE: do not change the order of the commands):

devel-su (default password is "rootme", without quotes)
mkdir /home/nitroid (creates the “nitdroid” directory under the /home directory)
cd /home/user/MyDocs (navigates to the directory where the NITDroid image is located)
tar -xvf preinits.tar -C / (extracts preinits to /sbin directory of the device)
tar xjvf nitdroid_n9_jellybean_alpha5.tar.bz2 -C /home/nitdroid (extracts the NITDroid image to /home/nitdroid)
tar xjvf apps2sd_fix_alpha5.tar.bz2 -C /home/nitdroid (extracts the Apps2SD fix to /home/nitdroid)

Install Nemo Mobile OS

At this point, it is highly recommended that you are using a Linux-based Operating System (Ubuntu will work fine). It is still okay to continue using MS Windows, however in order to use the "maintenance mode" feature of Ubiboot, such as viewing the contents of partitions via a File Manager you will need to install a 3rd party application that allows you to view the contents of Linux-based Filesystems. Note that for installing Nemo, this guide focuses on using Linux to ensure conformity of a default, fool-proof procedure of a triple-boot system with Harmattan, NITDroid, and Nemo.

In Linux, enter the following commands as per the Nemo Wiki Page:

wget -r -l1 -nd --no-parent -Amoslo-0.*.rpm http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/
rpm2cpio moslo-*.armv7hl.rpm | cpio -vidu
sudo flasher -k usr/share/moslo/zImage-moslo -n usr/share/moslo/initrd-moslo -l -b

Alternative: for the "wget" command above, you may download the MOSLO directly as I have mentioned in the “Download Needed Files” section above. Then you may proceed with the second and third commands.

MS Windows users: you can install 7-Zip and use that to go inside the moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm file. Keep going one directory deeper until you find two files:

initrd-moslo
zImage-moslo

Next, extract those files and place them in the same directory as the Flasher application. Once done, the command will be now modified as follows:

flasher.exe -k zImage-moslo -n initrd-moslo -l -b

The Terminal will give you a message that it is waiting for a suitable USB device. Make sure your device is turned off and plug it to your computer via the USB cable. The flashing procedure should finish in a few seconds.
Keep the device plugged. What happens next is that the N9 is being repartitioned for Nemo (on the device, you will see some green text/writing on the screen; just wait for it to finish).
You will also notice that the File Manager of your Linux Distribution will open and will show a folder named “Alt_OS”. This is the newly-created partition.
Next, we will extract the Nemo image into the newly-created partition. Enter this command in the Terminal (for Linux only):

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

Now, unplug the device from the USB Cable. The screen should tell you to "push Volume Up" to boot into Harmattan, or "push Volume Down" to boot into Nemo.

TIPS:

Sometimes, the name of the partition is Alt_OS_, with a single underline/underscores after “S” instead of the default Alt_OS (without underscore). Sometimes it has two (2) underlines/underscores. In my case, it had three (3) underlines/underscores.
Sometimes, the path of the Alt_OS partition is /media/yourusername/Alt_OS.
To be sure, before extracting the Nemo image, you may want to check the correct name by entering the Linux command of “lsblk” (without the quotes).
As a matter of “best practice” it is recommended to have a File Manager open and navigating to "Alt_OS" during the extraction command to verify that the files are being extracted to the correct location.
By experience, booting the device at this stage will result to either a reboot loop or the device not turning on at all. Sometimes, upon unplugging of the USB cable as mentioned above and selecting "Volume Down" to boot into Nemo, nothing happens (device is unresponsive and stays black). It is highly recommend not to turn on the device until you complete the setup/process from this point onward.

Flash the Device with Ubiboot-02

NOTE: for this step, the device should be turned off.

Flash the ubiboot-02 Kernel with the command below. Replace <yourmainfirmware.bin> with the filename of your N9 FIASCO image if you have renamed it differently.

sudo flasher -a <yourmainfirmware.bin> -k zImage_2.6.32.54-ubiboot-02_040613 --flash-only=kernel -f -R

Once the device reboots, keep the USB cable plugged in to enter “maintenance mode”. You will notice that the File Manager of your Linux Distribution will open and will mount/show all the partitions:

Nokia N9 (this is the “MyDocs” directory)
rootfs (this is the “/” directory or partition of the Nokia N9's Harmattan OS)
another partition with a long series of alpha-numeric (this is the /home/nitdroid directory/partition)
Alt_OS (this is the Nemo directory/partition)

Double-check that the files we have moved earlier are in their correct places. Once confirmed, you can "eject" all the partitions from your File Manager. Unplug the USB Cable and the device will restart. When it restarts, you should now see the Ubiboot menu.

Congratulations, you now have Ubiboot completely set up with a Triple-Boot configuration of Harmattan, NITDroid, and Nemo!

Known Issues

This section attempts to document some user-reported issues and solutions with respect to Ubiboot usage, installation, etc.

Charging

Ubiboot handles rtc and usb events to boot up device from power off state:

a) to Ubiboot telnet console (when connected to PC USB), device will not be charged.

b) to configured default kernel (harmattan) to charge (when connected to wall charger).

c) to configured default kernel (harmattan) to trigger alarm.

"Case a" works flawlessly.

"Case b" sometimes does not work, but reboots and then starts up Ubiboot console/screen (not charging).

"Case c" needs some precondition. Make sure you have shutdown your device from Harmattan. Otherwise the alarm may not be triggered in NITDroid or will not be triggered in Nemo.

Alarm Clocks

http://talk.maemo.org/showpost.php?p=1355247&postcount=374 http://talk.maemo.org/showpost.php?p=1355278&postcount=377

The default behavior of the device, particularly with the default OS (Harmattan), is that clock alarms can be triggered even when the device is turned off. The posts above suggest that you need to ensure that the "last OS booted" should be Harmattan prior to turning the device off, because between Harmattan, NITDroid, and Nemo, the alarm clock system behavior of Harmattan is most stable. Based on the above posts linked, alarms of NITDroid and Nemo (when the device is turned off) don't behave as good as Harmattan does.

References

Tutorials

PDF and Document
YouTube (to follow/in progress)

Retrieved from "http://wiki.maemo.org/Ubiboot"

Categories: N9 | HowTo | Power users

Personal tools

Navigation

Views