Qi
From Openmoko
Deep-Thought (Talk | contribs) (Clearifiying boot procedure on freerunner and neo) |
(restructured) |
||
Line 1: | Line 1: | ||
− | Qi is a | + | Qi is a replacement for the [[Uboot|uBoot]] bootloader reduced to the core bootloader functions. |
− | == | + | ==About Qi== |
− | + | ===Requirements=== | |
+ | [[Freerunner|GTA02 Hardware]] is recommended over [[Neo1973|GTA01]], since GTA02 does have a fallback u-boot in nor that provides DFU-Mode. Qi does NOT provide DFU-Mode so GTA01-Users will have no (easy) way to flash their device! | ||
− | + | ===Features=== | |
+ | * booting from SD partitions (1st, 2nd or 3rd) | ||
+ | * booting from NAND | ||
+ | * configuration by files in /boot | ||
+ | * automatically choose correct kernel for device hardware | ||
+ | * ext2/3 are supported | ||
− | + | ===Limitations=== | |
+ | * no DFU-Mode | ||
+ | * no boot menu | ||
+ | * FAT partitions are ignored | ||
− | == | + | ===Files=== |
− | + | ; /boot/uImage-GTA0[123].bin | |
− | + | : Kernel images, Qi will look for | |
− | + | ; /boot/append-GTA0[123] | |
− | + | : Kernel arguments | |
− | + | ; /boot/noboot-GTA0[123] | |
+ | : make Qi skip this partition | ||
− | + | ===Boot Order=== | |
− | + | # SD Partition 1 | |
+ | # SD Partition 2 | ||
+ | # SD Partition 3 | ||
+ | # NAND | ||
+ | # Memory Test | ||
− | == Download and installation == | + | ===LED and Vibrator Signals=== |
+ | * One Blue shine every ~10 second: did not found any valid kernel to boot | ||
+ | * About four RED shines per second: kernel panic. | ||
+ | |||
+ | ===Boot Menu=== | ||
+ | Qi's concept is to leave everything possible to Linux, that includes even the video init. Therefore Qi does NOT provide a boot menu. This should rather be implemented by a minimal Kernel, initramfs and menu system. It may be more comfortable for some users and may get them to switch from uboot to Qi. This does not exist yet. | ||
+ | |||
+ | ===Choosing a Kernel=== | ||
+ | Pressing AUX after powering the device skips the current boot device. Acknowledged by vibrator. | ||
+ | TBD properly. | ||
+ | |||
+ | ===Download and installation=== | ||
The daily download is a ''qi-s3cXXXX-andy_somenumber.udfu'' file at http://people.openmoko.org/andy/ . | The daily download is a ''qi-s3cXXXX-andy_somenumber.udfu'' file at http://people.openmoko.org/andy/ . | ||
Use the file appropriate to your device: | Use the file appropriate to your device: | ||
Line 32: | Line 57: | ||
One can also just use strings(1) on the .udfu file to get an idea of where Qi currently looks for files. | One can also just use strings(1) on the .udfu file to get an idea of where Qi currently looks for files. | ||
− | ==Enabling console messages== | + | ===README=== |
+ | The latest README file can be found in the git as well:http://git.openmoko.org/?p=qi.git;a=blob;f=README;hb=HEAD | ||
+ | |||
+ | ==Tips, Tricks, Tweaks== | ||
+ | ===Enabling console messages=== | ||
[http://lists.openmoko.org/pipermail/openmoko-kernel/2008-November/006812.html] | [http://lists.openmoko.org/pipermail/openmoko-kernel/2008-November/006812.html] | ||
If it's SD Card boot, just create a text file, e.g., for a [[GTA02]] use | If it's SD Card boot, just create a text file, e.g., for a [[GTA02]] use | ||
Line 40: | Line 69: | ||
and you'll see the messages on boot. If it's NAND right now you need to edit the default commandline in Qi for gta02. | and you'll see the messages on boot. If it's NAND right now you need to edit the default commandline in Qi for gta02. | ||
− | ==SD Initialisation== | + | ===SD Initialisation=== |
If you don't specify loglevel=8 in append-GTAXX, and booting fails with a "VFS: Cannot open root device "mmcblk0p1" or unknown-block(2,0)", the SD card needs a little bit more time to initialise. | If you don't specify loglevel=8 in append-GTAXX, and booting fails with a "VFS: Cannot open root device "mmcblk0p1" or unknown-block(2,0)", the SD card needs a little bit more time to initialise. | ||
Revision as of 15:51, 18 January 2009
Qi is a replacement for the uBoot bootloader reduced to the core bootloader functions.
Contents |
About Qi
Requirements
GTA02 Hardware is recommended over GTA01, since GTA02 does have a fallback u-boot in nor that provides DFU-Mode. Qi does NOT provide DFU-Mode so GTA01-Users will have no (easy) way to flash their device!
Features
- booting from SD partitions (1st, 2nd or 3rd)
- booting from NAND
- configuration by files in /boot
- automatically choose correct kernel for device hardware
- ext2/3 are supported
Limitations
- no DFU-Mode
- no boot menu
- FAT partitions are ignored
Files
- /boot/uImage-GTA0[123].bin
- Kernel images, Qi will look for
- /boot/append-GTA0[123]
- Kernel arguments
- /boot/noboot-GTA0[123]
- make Qi skip this partition
Boot Order
# SD Partition 1 # SD Partition 2 # SD Partition 3 # NAND # Memory Test
LED and Vibrator Signals
- One Blue shine every ~10 second: did not found any valid kernel to boot
- About four RED shines per second: kernel panic.
Boot Menu
Qi's concept is to leave everything possible to Linux, that includes even the video init. Therefore Qi does NOT provide a boot menu. This should rather be implemented by a minimal Kernel, initramfs and menu system. It may be more comfortable for some users and may get them to switch from uboot to Qi. This does not exist yet.
Choosing a Kernel
Pressing AUX after powering the device skips the current boot device. Acknowledged by vibrator. TBD properly.
Download and installation
The daily download is a qi-s3cXXXX-andy_somenumber.udfu file at http://people.openmoko.org/andy/ . Use the file appropriate to your device:
- GTA01 -> qi-s3c2410
- GTA02 -> qi-s3c2442
- GTA03 -> qi-s3c6410
The installation should be flashing like;
# dfu-util -a u-boot -R -D qi-s3c6410-andy_8589b40295653557.udfu
Source code
git://git.openmoko.org/git/qi.git , http://git.openmoko.org/?p=qi.git;a=summary . One can also just use strings(1) on the .udfu file to get an idea of where Qi currently looks for files.
README
The latest README file can be found in the git as well:http://git.openmoko.org/?p=qi.git;a=blob;f=README;hb=HEAD
Tips, Tricks, Tweaks
Enabling console messages
[1] If it's SD Card boot, just create a text file, e.g., for a GTA02 use
/boot/append-GTA02
on the rootfs in question, put in there
console=tty0 loglevel=8
and you'll see the messages on boot. If it's NAND right now you need to edit the default commandline in Qi for gta02.
SD Initialisation
If you don't specify loglevel=8 in append-GTAXX, and booting fails with a "VFS: Cannot open root device "mmcblk0p1" or unknown-block(2,0)", the SD card needs a little bit more time to initialise.
Put a "rootdelay=" in append-GTAXX like so:
rootdelay=1
Testing speed improvements
Stopwatch results on Qi (error is approx ±1/2 second):
Booting SHR image with uBoot:
- 0:00 power button held down
- 0:07 splash screen appears
- 0:15 drops to console showing kernel messages scrolling by for ~1 minute
- 1:18 Openmoko 'please wait' splash
- 1:31 desktop animated splash
- 2:38 finished booting
Booting identical setup with Qi flashed over uBoot:
- 0:00 power button held down
- 0:06 backlit black
- 0:13 please wait booting... (only this text on console for next 38 seconds)
- 0:51 Angstrom console message (at the end of kernel output with uBoot, but ONLY text display to appear throughout this stage with Qi)
- 0:54 Openmoko 'please wait' splash
- 1:05 desktop animated splash
- 1:54 finished booting
So for this particular configuration, it reduced time-to-desktop by about 28%, about 44 seconds. Surprisingly, the later segments of booting (desktop) were also noticeably faster than with uBoot - One would have expected just the fist stages up until init (kernel finished establishing itself) to be faster.
Bugs
- Qi won't boot the 'first try' after power restored - the tester didn't count that first 10 seconds for Qi to be fair to its booting speed, not penalize it for what appears to be a bug that bears no relation to actual boot speed).
- The current (Oct. 12, 2008) 2.6.27 kernel does not boot from the build-in flash NAND. It only works from the uSD boot on ext3. If one tries to boot it from the flash, then AUX red LED blinks ~4/sec. This means kernel panic... It's panicking because it has no rootfs because it can't mount the jffs2 because of the CRC errors because there is a bug that the mtd are not done properly.
- Qi often doesn't want to resume after suspend.
- Qi is able to load kernels larger than 2MB correctly, uBoot has a bug.
LED codes summary
- One Blue shine every ~10 second: did not found any valid kernel to boot
- About four RED shines per second: kernel panic.