Booting from a flash card

(Clone to the card)
(clarify that article is for N8x0 users)
 
(65 intermediate revisions not shown)
Line 1: Line 1:
-
{{Midgard article}}
+
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.
 +
 
 +
Advanced users may wish to read [[advanced booting]] as well, for more advanced booting-related configuration and setup information.
== Why would we want to boot from a flash card? ==
== Why would we want to boot from a flash card? ==
 +
* For more space to install applications.
* For more space to install applications.
-
* An easy-to-user bootable backup.
+
* An easy-to-use bootable backup.
* To improve performance (note, this is dependent on the quality of your flash card).
* To improve performance (note, this is dependent on the quality of your flash card).
-
 
-
== 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
 
-
|}
 
-
 
-
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.
 
-
 
-
This procedure should work with any device listed at http://fanoush.wz.cz/maemo/#initfs
 
-
 
-
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
 
== Gain root access ==
== Gain root access ==
Line 31: Line 15:
== Partition your card ==
== Partition your card ==
-
Follow the instructions to [[partitioning an MMC card|partition your card]].
+
Follow the instructions to [[partitioning a flash card|partition your card]].
-
== Install bootmenu ==
+
== Install the necessary tools ==
-
 
+
-
Connect your device to the charger, as running out of battery power during the flashing process could damage the device.
+
-
First, we need to install wget, so open Xterm and, '''as root''', run:
+
First, we need to install wget, so open [[terminal|Xterm]] and, '''as root''', run:
  apt-get install wget
  apt-get install wget
Line 43: Line 25:
Then run:
Then run:
-
  mkdir /home/user/local/bin
+
  mkdir -p /home/user/bin
-
  cd /home/user/local/bin
+
  cd /home/user/bin
  wget <nowiki>http://www.nmacleod.com/nokia/bin/nupgrade.sh</nowiki>
  wget <nowiki>http://www.nmacleod.com/nokia/bin/nupgrade.sh</nowiki>
  wget <nowiki>http://www.nmacleod.com/nokia/bin/tar</nowiki>
  wget <nowiki>http://www.nmacleod.com/nokia/bin/tar</nowiki>
  chmod +x nupgrade.sh tar
  chmod +x nupgrade.sh tar
-
Now we need to download and install fanoush's [http://fanoush.wz.cz/maemo/ initfs flasher], so, '''as root''', run:
+
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.
 +
 +
== Install bootmenu ==
 +
 +
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>
 +
 +
cd /home/user/bin
  wget <nowiki>http://fanoush.wz.cz/maemo/initfs_flasher.tgz</nowiki>
  wget <nowiki>http://fanoush.wz.cz/maemo/initfs_flasher.tgz</nowiki>
  tar zxvf initfs_flasher.tgz
  tar zxvf initfs_flasher.tgz
-
  cd initfs_flasher/
+
  cd /home/user/bin/initfs_flasher/
 +
 
 +
=== 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 <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.
 +
 
 +
The [[flasher]] will ask you if you want to include your <code>bootmenu.conf</code> file if you renamed it properly.
 +
 
 +
=== Flash the initfs ===
 +
 
 +
cd /home/user/bin/initfs_flasher/
  ./initfs_flash
  ./initfs_flash
Follow the onscreen instructions. You can answer yes to all of these questions if you don't understand what they mean.
Follow the onscreen instructions. You can answer yes to all of these questions if you don't understand what they mean.
-
Now we need to load the kernel modules for ext2, so, '''as root''', run:
+
=== Set the default boot device ===
-
  insmod /mnt/initfs/lib/modules/(uname -r)/mbcache.ko
+
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:
-
insmod /mnt/initfs/lib/modules/(uname -r)/ext2.ko
+
 
 +
  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 ==
== 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:
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
* 0 - Create ext2 filesystem on partition 2 of the Internal memory card
* 1 - Mount partition 2 as /opt
* 1 - Mount partition 2 as /opt
Line 74: Line 87:
So, '''as root''', run:
So, '''as root''', run:
-
  cd /home/user/local/bin
+
  cd /home/user/bin
  ./nupgrade.sh 0
  ./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
  ./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"
 +
  ./nupgrade.sh 2
  ./nupgrade.sh 2
  ./nupgrade.sh 3
  ./nupgrade.sh 3
Line 84: Line 107:
Your device will reboot when done, and you can select the partition you want to boot from from the bootmenu.
Your device will reboot when done, and you can select the partition you want to boot from from the bootmenu.
-
== Removing the menu ==
+
== Remove the menu ==
-
 
+
-
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
+
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:
-
To remove the (harmless) 'Press menu key ..." message early on boot you need to restore your initfs backup (if you decided to create one)
+
sudo ./flasher-3.0 -F <FIASCO image> --flash-only=initfs -R
-
# cd /home/user/MyDocs/.documents/initfs_flasher/
+
== 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.
+
For more advanced configuration and setup information for booting-related stuff, please see [[advanced booting]].
-
[[Category:Users]]
+
[[Category:Power users]]
-
[[Category:Midgard wiki]]
+
[[Category:N8x0]]
-
[[Category:Wiki page of the day]]
+

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.