Booting from a flash card
(clarify that article is for N8x0 users)
 
(85 intermediate revisions not shown)
Line 1: Line 1:
-
Here are the links to older pages on which this one is based:
+
This article covers the steps you need to follow to boot from a flash card with an [[Nokia N800|N800]] on [[Nokia N810|N810]]. The process is somewhat involved, so some familiarity with the command line is recommended.
-
*[[How to Boot the root filesystem from MMC]]  
+
Advanced users may wish to read [[advanced booting]] as well, for more advanced booting-related configuration and setup information.
-
*BootMenu
+
-
*ExtendedRootFilesystem
+
-
*ModifyingRootImage
+
-
*HowTo_GetStartedWithSardine
+
-
=Why would we want to boot from MMC?=
+
== Why would we want to boot from a flash card? ==
-
*Because we'll have enough space to INSTALL as MANY applications as may fit in our (GB-size) MMC card.
+
-
*Because we'll have an INTACT COPY of the original system. So that if something goes wrong, we'll be able to BACKUP the system without reflashing the device.
+
-
*Because we'll still be able to mount our MMC on a Windows-based PC via USB.
+
-
*Because the whole system won't be based on a compressed and journalized filesystem (jffs2) so the result may be faster due to lower CPU usage (no (de)compression with each read/write operation) and faster SD/MMC speed (depends on card and may require custom kernel - 770, N800)
+
-
+
-
=Known working devices=
+
-
This procedure has been tested on the following configurations:
+
-
{|
+
-
| '''Hardware''' || '''Software'''
+
-
|-
+
-
| Nokia N770 ITOS 2006 || 3.2006.49-2
+
-
|-
+
-
| Nokia N800 ITOS 2007 || 2.2006.51-6 1
+
-
|-
+
-
| Nokia N800 ITOS 2007 || 4.2007.26-8
+
-
|}
+
-
1 The first time I tried this on my N800 it led to continuous reboots 30-90 seconds after booting. Trying it a second time on a clean install (directly after flashing and erasing everything already on the device) worked fine.
+
* For more space to install applications.
 +
* An easy-to-use bootable backup.
 +
* To improve performance (note, this is dependent on the quality of your flash card).
-
This procedure should work with any device listed at http://fanoush.wz.cz/maemo/#initfs
+
== Gain root access ==
-
It is supposed that without any previous knowledge you should be able to accomplish the whole procedure. Ask for help in case something goes wrong. I'll be happy to help you at the following e-mail address: sebastian.maemo{AT}gmail.com
+
First of all you need to be able to gain [[root access]].
-
=='''First of all''': you need to become root==
+
== Partition your card ==
-
First of all you need to be able to get ROOT access from an Xterm on your Tablet. If you don't know how to do it, please follow this link, and come back when ready: http://maemo.org/community/wiki/HowTo_EASILY_BecomeRoot/
+
-
=='''Second''': you need to partition your MMC! ==
+
Follow the instructions to [[partitioning a flash card|partition your card]].
-
Follow this link to find the instructions to partition the MMC card: http://maemo.org/community/wiki/HowTo_EASILY_Partition_your_MMC_card/
+
-
Once you've partitioned your MMC, come back to this page and go on with the process...
+
== Install the necessary tools ==
-
==How to install a dual boot menu? ==
+
First, we need to install wget, so open [[terminal|Xterm]] and, '''as root''', run:
-
Connect your device via the AC/DC power adaptor to the main power supply, or verify the battery is fully charged. It's important not to run out of battery in the middle of this operation.
+
-
From your own Tablet use the browser to download this file from Fanoush's webpage: http://fanoush.wz.cz/maemo/initfs_flasher.tgz
+
apt-get install wget
-
Supposing it's been downloaded to the fold named Documents, open an Xterm and type AS ROOT:
+
Then run:
-
  # cd /home/user/MyDocs/.documents/
+
  mkdir -p /home/user/bin
-
  # tar zxvf initfs_flasher.tgz
+
cd /home/user/bin
-
  # cd initfs_flasher/
+
  wget <nowiki>http://www.nmacleod.com/nokia/bin/nupgrade.sh</nowiki>
-
  # ./initfs_flash
+
  wget <nowiki>http://www.nmacleod.com/nokia/bin/tar</nowiki>
 +
  chmod +x nupgrade.sh tar
-
Just follow instructions.
+
Then, to install the proper filesystem tools, temporarily add [[Extras-devel]] and run:
-
Now it's time to clone the whole original system !<br>
+
apt-get install e2fsprogs
-
Connnect to Internet for apt-get to work below.
+
-
If you are working on an N770, SKIP THIS STEP. If you are working on an N800 running OS2007, you'll have to type as ROOT:
+
'''NOTE: Do not upgrade existing packages with Extras-devel enabled as this may break things in new and interesting ways.'''
-
# insmod /mnt/initfs/lib/modules/2.6.18-omap1/mbcache.ko
 
-
# insmod /mnt/initfs/lib/modules/2.6.18-omap1/ext2.ko
 
-
For Nokia 770 with IT2006 or hacker edition type this instead:
+
Remove Extras-devel when finished.
-
# insmod /mnt/initfs/lib/modules/current/ext2.ko
+
== Install bootmenu ==
-
NOW FOR ALL DEVICES, continue by typing as ROOT:
+
Now we need to download and install fanoush's [http://fanoush.wz.cz/maemo/#initfs initfs flasher], so, '''as root''', run:<br />
 +
<small>''Note, although putting initfs_flasher in the directory given is not required, it ''cannot'' be placed on a FAT partition (i.e., one of the cards).''</small>
-
  # mkdir /opt/
+
  cd /home/user/bin
-
  # mount /dev/mmcblk0p2 /opt
+
  wget <nowiki>http://fanoush.wz.cz/maemo/initfs_flasher.tgz</nowiki>
-
# mkdir /floppy/
+
  tar zxvf initfs_flasher.tgz
-
  # mount -t jffs2 -o ro /dev/mtdblock4 /floppy
+
cd /home/user/bin/initfs_flasher/
-
The following command will generate dire warnings and prompts, requiring you to type YES. However, -d tells apt-get to only download the package and not install it, so it's safe to ignore those warnings and type YES... You need to be connected to internet for apt-get to work.
+
=== Configuration ===
-
# apt-get -d install tar
+
This is an optional step, but if you want to customize the bootmenu to properly reflect your partitioning setup, change the partition labels, and a number of other options, then you'll need to rename the appropriate <code>bootmenu.conf.''device''.example</code> file to <code>bootmenu.conf</code> and edit it to your liking. The README included with flasher and the comments in the configuration file should be enough to tell you what everything is.
-
# cd /var/cache/apt/archives/
+
-
# mkdir /tar-temp/
+
-
# dpkg -x tar*.deb /tar-temp/
+
-
Before continuing it is better to close internet connection...
+
The [[flasher]] will ask you if you want to include your <code>bootmenu.conf</code> file if you renamed it properly.
-
# cd /tar-temp/bin/
+
=== Flash the initfs ===
-
# cp tar targnu
+
-
# ./targnu cf - -C /floppy . | ./targnu xvf - -C /opt
+
-
I have repeated this process many times in my little Nokia 770 without experiencing any problem... Nevertheless, here follow some warnings from other users: For Nokia 770 make sure you have installed bugfix for memory corruption bug, details also here. Also in newer ITOS releases, apt-get will simply say "selecting busybox instead of tar" and refuse to do anything. The tar program in the bora SDK is actually an x86 binary, so it will not work. You will have to download the tar package directly from http://repository.maemo.org/pool/maemo3.2/free/binary/tar_1.14-2.1osso_armel.deb, after which you can basically follow the instructions above, replacing /var/cache/apt/archives with wherever you put the .deb file.
+
cd /home/user/bin/initfs_flasher/
 +
./initfs_flash
 +
 
 +
Follow the onscreen instructions. You can answer yes to all of these questions if you don't understand what they mean.
 +
 
 +
=== Set the default boot device ===
 +
 
 +
Once the initfs is flashed, you may wish to change to default boot device so the tablet will boot into your preferred partition without intervention. To do this, '''as root''', run:
 +
 
 +
chroot /mnt/initfs cal-tool --set-root-device ask:mmc2
 +
 
 +
To set the default to partition 2 on the internal card. If you would like to set the default to something else, the device is <code>mmc''#''</code> (where # is the partition number) for the internal card, and <code>mmc1''#''</code> for the external card. To set it back the default behavior of booting from the built-in flash, use <code>flash</code>.
 +
 
 +
On the [[Nokia N810|N810]] with latest [[Open development/Maemo roadmap/Diablo|Diablo]] version (5.2008.43-7), the device name is slightly different: <code>immc''#''</code> for the internal card and <code>mmc''#''</code> for the external one. For details see inside bootmenu.conf (or bootmenu.sh). The name is customizable and corresponds to the MENU_x_ID="name" line of the item x you want to select.
 +
 
 +
== Clone to the card ==
 +
 
 +
<small>''Many thanks to milhouse for writing and maintaining this script.''</small>
 +
 
 +
Now it's time to clone your install over to partition 2 of the internal card. The script works in stages to allow better control and error detection, and should take about 10 minutes to complete:
 +
 
 +
* 0 - Create ext2 filesystem on partition 2 of the Internal memory card
 +
* 1 - Mount partition 2 as /opt
 +
* 2 - Mount rootfs as /floppy
 +
* 3 - Perform cloning process
 +
* 4 - Commit filesystem updates and unmount /floppy and /opt
 +
 
 +
So, '''as root''', run:
 +
 
 +
cd /home/user/bin
 +
./nupgrade.sh 0
 +
 
 +
If the following error occurs: "''Unable to locate mbcache.ko - aborting''"
 +
follow the instructions per this link:  [http://www.internettablettalk.com/forums/showpost.php?p=174911&postcount=336]
 +
 +
./nupgrade.sh 1
 +
If the following error occurs:
 +
<br>"Installing ext2.ko module and mounting Internal Flash card, second partition...
 +
insmod: can't open '/mnt/initfs/lib/modules/current/ext2.ko': No such file or directory
 +
mount: mounting /dev/mmcblk0p2 on /opt failed''"<br>
 +
do the following (similar to the above remedy during error of "./nupgrade.sh 0") <br>cp /mnt/initfs/lib/modules/$(uname -r)/ext2.ko /lib/modules/$(uname -r)/ <br>and repeat "./nupgrade.sh 1"
-
It will take a while to finish last command, but do not worry about it. In the end you may see tar warning about implausible time stamp which is OK. Then you will be ready to go on with the procedure:
+
./nupgrade.sh 2
 +
./nupgrade.sh 3
 +
./nupgrade.sh 4
 +
reboot
-
# umount /opt
+
Your device will reboot when done, and you can select the partition you want to boot from from the bootmenu.
-
# umount /floppy
+
-
# chroot /mnt/initfs cal-tool --set-root-device ask:mmc2
+
-
# shutdown -r now
+
-
And the process is complete. After rebooting the Tablet, you should be able to boot from the MMC card. You'll then be able to install as many applications as fit into the card. And if there's any problem in the future, you can always boot from the flash and recover the original system and start again ;)
+
== Remove the menu ==
-
==Removing the menu==
+
If you decide you do not wish to see the bootmenu any longer, you can uninstall it by either [[updating the firmware|reflashing the whole OS image]], or just flashing the initfs (in Linux and OS X) by running:
-
If you decide you do not wish to see the menu on each boot or you do not wish to boot from mmc anymore and go back to using internal flash only, type this (as root):
+
-
  # chroot /mnt/initfs cal-tool --set-root-device flash
+
  sudo ./flasher-3.0 -F <FIASCO image> --flash-only=initfs -R
-
To remove the (harmless) 'Press menu key ..." message early on boot you need to restore your initfs backup (if you decided to create one)
+
== Advanced booting ==
-
# cd /home/user/MyDocs/.documents/initfs_flasher/
+
For more advanced configuration and setup information for booting-related stuff, please see [[advanced booting]].
-
# ./initfs_flash initfs.orig.jffs2
+
-
or you can reflash whole firmware (Windows) or restore just initfs part (Linux). Both initfs restoration steps are a bit risky and can cause data loss if something goes wrong so it may be good idea to simply live with the message until you decide to upgrade to next firmware or want to reflash whole device anyway. It does not slow down device booting or do any other harm.
+
[[Category:Power users]]
-
[[Category:HowTos]]
+
[[Category:N8x0]]

Latest revision as of 13:40, 10 February 2011

This article covers the steps you need to follow to boot from a flash card with an N800 on N810. The process is somewhat involved, so some familiarity with the command line is recommended.

Advanced users may wish to read advanced booting as well, for more advanced booting-related configuration and setup information.

Contents

[edit] Why would we want to boot from a flash card?

  • For more space to install applications.
  • An easy-to-use bootable backup.
  • To improve performance (note, this is dependent on the quality of your flash card).

[edit] Gain root access

First of all you need to be able to gain root access.

[edit] Partition your card

Follow the instructions to partition your card.

[edit] Install the necessary tools

First, we need to install wget, so open Xterm and, as root, run: 

apt-get install wget

Then run: 

mkdir -p /home/user/bin
cd /home/user/bin
wget http://www.nmacleod.com/nokia/bin/nupgrade.sh
wget http://www.nmacleod.com/nokia/bin/tar
chmod +x nupgrade.sh tar

Then, to install the proper filesystem tools, temporarily add Extras-devel and run: 

apt-get install e2fsprogs

NOTE: Do not upgrade existing packages with Extras-devel enabled as this may break things in new and interesting ways.


Remove Extras-devel when finished.

[edit] Install bootmenu

Now we need to download and install fanoush's initfs flasher, so, as root, run:
Note, although putting initfs_flasher in the directory given is not required, it cannot be placed on a FAT partition (i.e., one of the cards). 

cd /home/user/bin
wget http://fanoush.wz.cz/maemo/initfs_flasher.tgz
tar zxvf initfs_flasher.tgz
cd /home/user/bin/initfs_flasher/

[edit] Configuration

This is an optional step, but if you want to customize the bootmenu to properly reflect your partitioning setup, change the partition labels, and a number of other options, then you'll need to rename the appropriate bootmenu.conf.device.example file to bootmenu.conf and edit it to your liking. The README included with flasher and the comments in the configuration file should be enough to tell you what everything is.

The flasher will ask you if you want to include your bootmenu.conf file if you renamed it properly.

[edit] Flash the initfs 

cd /home/user/bin/initfs_flasher/
./initfs_flash

Follow the onscreen instructions. You can answer yes to all of these questions if you don't understand what they mean.

[edit] Set the default boot device

Once the initfs is flashed, you may wish to change to default boot device so the tablet will boot into your preferred partition without intervention. To do this, as root, run: 

chroot /mnt/initfs cal-tool --set-root-device ask:mmc2

To set the default to partition 2 on the internal card. If you would like to set the default to something else, the device is mmc# (where # is the partition number) for the internal card, and mmc1# for the external card. To set it back the default behavior of booting from the built-in flash, use flash.

On the N810 with latest Diablo version (5.2008.43-7), the device name is slightly different: immc# for the internal card and mmc# for the external one. For details see inside bootmenu.conf (or bootmenu.sh). The name is customizable and corresponds to the MENU_x_ID="name" line of the item x you want to select.

[edit] Clone to the card

Many thanks to milhouse for writing and maintaining this script.

Now it's time to clone your install over to partition 2 of the internal card. The script works in stages to allow better control and error detection, and should take about 10 minutes to complete:

  • 0 - Create ext2 filesystem on partition 2 of the Internal memory card
  • 1 - Mount partition 2 as /opt
  • 2 - Mount rootfs as /floppy
  • 3 - Perform cloning process
  • 4 - Commit filesystem updates and unmount /floppy and /opt

So, as root, run: 

cd /home/user/bin
./nupgrade.sh 0

If the following error occurs: "Unable to locate mbcache.ko - aborting" follow the instructions per this link: [1] 

./nupgrade.sh 1

If the following error occurs:
"Installing ext2.ko module and mounting Internal Flash card, second partition... insmod: can't open '/mnt/initfs/lib/modules/current/ext2.ko': No such file or directory mount: mounting /dev/mmcblk0p2 on /opt failed"
 do the following (similar to the above remedy during error of "./nupgrade.sh 0")
cp /mnt/initfs/lib/modules/$(uname -r)/ext2.ko /lib/modules/$(uname -r)/
and repeat "./nupgrade.sh 1" 

./nupgrade.sh 2
./nupgrade.sh 3
./nupgrade.sh 4
reboot

Your device will reboot when done, and you can select the partition you want to boot from from the bootmenu.

[edit] Remove the menu

If you decide you do not wish to see the bootmenu any longer, you can uninstall it by either reflashing the whole OS image, or just flashing the initfs (in Linux and OS X) by running: 

sudo ./flasher-3.0 -F <FIASCO image> --flash-only=initfs -R

[edit] Advanced booting

For more advanced configuration and setup information for booting-related stuff, please see advanced booting.

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