debian/0000755000000000000000000000000011657711254007177 5ustar debian/qi.80000644000000000000000000000555111657711254007707 0ustar .TH "QI" "8" .SH "NAME" Qi \- lightweight bootloader for OpenMoko Freerunner .SH "DESCRIPTION" .PP \fBQi\fP is a lightweight bootloader for OpenMoko Freerunner phones. It can be installed to the beginning of the NAND flash to load a kernel and an initramfs from either an SD card or NAND flash. .SH "STORAGE ORGANIZATION" .PP Freerunner has three types of non-volatile storage: NOR flash, NAND flash and an SD card. NOR flash is read-only and holds a copy of the U-boot bootloader: $ sudo strings /dev/mtd0 | grep Bootloader U-Boot 1.3.2-moko12 (May 9 2008 - 10:28:48) Code in NOR flash is executed only if AUX button is held when you hit POWER button to boot the system. You can use U-boot to flash NAND partitions using the DFU protocol. Qi does not support DFU. .PP NAND flash is divided into several partitions. This mapping is passed as a commandline argument to Linux so you can view it simply by reading /proc/mtd: $ cat /proc/mtd dev: size erasesize name mtd0: 00200000 00010000 "physmap-flash.0" mtd1: 00040000 00020000 "qi" mtd2: 00040000 00020000 "depr-ub-env" mtd3: 00820000 00020000 "kernel" mtd4: 000a0000 00020000 "depr" mtd5: 00040000 00020000 "identity-ext2" mtd6: 0f680000 00020000 "rootfs" You can check what bootloader exists in the begining of the NAND flash by running e.g.: $ sudo strings /dev/mtd1 | grep Bootloader Qi Bootloader s3c2442 ginger debian_20100107-1 Qi support both uSD and uSDHC cards. It can parse a regular MSDOS partition table and has a read-only ext2 filesystem driver which seems to work also with ext3 (with or without journaling) and ext4 without extents. .SH "BOOT ORDER" .PP Qi tries to boot from five different locations. It moves to the next entry in the list below if it fails to load a kernel or if you hit AUX while Qi is reading the kernel or the initramfs: \fBBoot option 1\fP Kernel: /boot/uImage-GTA02.bin from SD partition 1 Initramfs: /boot/initrd-GTA02.bin from SD partition 1 Extra arguments: /boot/append-GTA02.bin from SD partition 1 \fBBoot option 2\fP Kernel: /boot/uImage-GTA02.bin.2 from SD partition 1 Initramfs: /boot/initrd-GTA02.bin.2 from SD partition 1 Extra arguments: /boot/append-GTA02.bin.2 from SD partition 1 \fBBoot option 3\fP Kernel: /boot/uImage-GTA02.bin from SD partition 2 Initramfs: /boot/initrd-GTA02.bin from SD partition 2 Extra arguments: /boot/append-GTA02.bin from SD partition 2 \fBBoot option 4\fP Kernel: /boot/uImage-GTA02.bin from SD partition 3 Initramfs: /boot/initrd-GTA02.bin from SD partition 3 Extra arguments: /boot/append-GTA02.bin from SD partition 3 \fBBoot option 5\fP Kernel: kernel partition from NAND flash (/dev/mtd3) Initramfs: not supported Extra arguments: not supported .PP The kernel can be either in uImage or zImage format. Qi understands symlinks. .SH "SEE ALSO" .PP Additional documentation is available in the README file and OpenMoko wiki. debian/source/0000755000000000000000000000000011657574312010501 5ustar debian/source/format0000644000000000000000000000001411657574312011707 0ustar 3.0 (quilt) debian/docs0000644000000000000000000000000711657574312010051 0ustar README debian/rules0000755000000000000000000000231111657574312010256 0ustar #!/usr/bin/make -f VERSION := $(shell dpkg-parsechangelog | sed -ne 's,^Version: *\(.*\)$$,\1,p') UPSTREAM_VERSION := $(shell echo $(VERSION) | cut -d - -f1) UPSTREAM_VERSION_UNIXDATE := $(shell date -u -d $(UPSTREAM_VERSION) +%s) %: dh $@ override_dh_auto_build: $(MAKE) CPU=s3c2442 CROSS_COMPILE="" BUILD_BRANCH=debian BUILD_HEAD=$(VERSION) override_dh_auto_install: mkdir -p $(CURDIR)/debian/qi/usr/lib/qi/gta02/ install -m 644 image/qi-s3c2442-debian_$(VERSION) $(CURDIR)/debian/qi/usr/lib/qi/gta02/qi install -m 644 image/qi-s3c2442-debian_$(VERSION).udfu $(CURDIR)/debian/qi/usr/lib/qi/gta02/qi.udfu mkdir -p $(CURDIR)/debian/qi/usr/share/man/man8 install -m 644 debian/qi.8 $(CURDIR)/debian/qi/usr/share/man/man8/qi.8 get-orig-source: @echo version $(VERSION) @echo upstream version $(UPSTREAM_VERSION) @echo unixdate $(UPSTREAM_VERSION_UNIXDATE) git clone git://git.openmoko.org/git/qi qi-$(UPSTREAM_VERSION) cd qi-$(UPSTREAM_VERSION) && git reset --hard `git rev-list --all -n 1 --before=$(UPSTREAM_VERSION_UNIXDATE)` cd qi-$(UPSTREAM_VERSION) && git archive --format=tar --prefix=qi-$(UPSTREAM_VERSION)/ master | gzip -9 --no-name > ../qi_$(UPSTREAM_VERSION).orig.tar.gz rm -fr qi-$(UPSTREAM_VERSION) debian/control0000644000000000000000000000125011657574312010602 0ustar Source: qi Section: admin Priority: optional Maintainer: Timo Juhani Lindfors Build-Depends: debhelper (>= 8) Standards-Version: 3.9.2 Homepage: http://wiki.openmoko.org/wiki/Qi Vcs-Git: git://git.debian.org/pkg-fso/qi.git Vcs-Browser: http://git.debian.org/?p=pkg-fso/qi.git;a=summary Package: qi Architecture: armel Depends: ${misc:Depends} Description: lightweight bootloader for OpenMoko Freerunner Qi (named by Alan Cox on Openmoko kernel list) is a minimal bootloader that "breathes life" into Linux. Its goal is to stay close to the minimum needed to "load" and then "boot" Linux -- no boot menus, additional peripheral init or private states. debian/copyright0000644000000000000000000001267611657574312011150 0ustar Format: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=file&rev=166 Source: http://git.openmoko.org/?p=qi.git;a=summary Comment: At least some of the OpenMoko employees have assigned their copyright to OpenMoko Inc. so some of the copyright holders listed here might not in fact hold copyrights anymore. Files: * Copyright: 2008 Openmoko, Inc. 2008, 2009 Andy Green 2008, 2009 Christopher Hall 2008 Micael Henriksson 2009, 2010 Paul Fertser 2011 Timo Juhani Lindfors 2009 Werner Almesberger 2008 Xiangfu Liu License: GPL-2+ Files: debian/* Copyright: 2011 Timo Juhani Lindfors License: GPL-2+ Files: include/* Copyright: 2000, 2001 Free Software Foundation, Inc. 2003 Sysgo Real-Time Solutions, AG 1970 Marcus Sundberg 2002 rjones@nexus-tech.net 2003 kharris@nexus-tech.net 2006, 2007, 2008 OpenMoko, Inc. 2008 Semihalf 2000, 2001, 2003, 2004, 2005 DENX Software Engineering 2002 Hewlett-Packard Company 2007 Byungjae Lee, Samsung Erectronics 2008, 2009 Andy Green 2008 Micael Henriksson 2009, 2010 Paul Fertser 2008 Xiangfu Liu Liu License: GPL-2+ Files: include/mmc.h include/s3c24xx-regs-sdi.h include/setup.h Copyright: 2002 MontaVista Software Inc. 2004 Simtec Electronics 1997, 1998, 1999 Russell King 2008 Andy Green License: GPL-2 Files: src/* Copyright: 2006, 2007 OpenMoko, Inc. 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 DENX Software Engineering 2002 Samsung Electronics SW.LEE 2003, 2004 Sysgo AG 2004 esd gmbh 2003, 2004 Free Software Foundation, Inc. 2008, 2009 Andy Green 2008, 2009 Matt Hsu 2008 Micael Henriksson 2009 Nelson Castillo 2009, 2010, 2011 Paul Fertser 2009 Robert Piasek 2009 Sebastian Krzyszkowiak 2011 Timo Juhani Lindfors 2009 Werner Almesberger 2008 Xiangfu Liu License: GPL-2+ Files: src/cpu/s3c2410/nand_read.c src/cpu/s3c2410/nand_read.h src/cpu/s3c2442/nand_read.c src/cpu/s3c2442/nand_read.h Copyright: 2002 MIZI Research, Inc. 2008, 2009 Andy Green 2009 Dmitry Kurochkin 2008 Micael Henriksson License: GPL-2+ Comment: Taken from vivi bootloader which does not specify the GPL version so we can pick any version we like. Files: src/cpu/s3c2410/s3c24xx-mci.c src/cpu/s3c2442/s3c24xx-mci.c Copyright: 2006 OpenMoko, Inc. 2005, 2005 Thomas Kleffel 2008 Andy Green 2010 Paul Fertser 2011 Timo Juhani Lindfors License: GPL-2 Comment: Header says GPL-2+ but this is based on Linux code which is GPL-2. Files: src/cpu/crc32.c Copyright: 1995, 1996, 1997, 1998 Mark Adler 1995, 1996, 1997, 1998 Jean-loup Gailly License: Zlib Files: src/drivers/glamo-mmc.c Copyright: 2004, 2005, 2006 maintech GmbH 2005 Thomas Kleffel 2006, 2007 OpenMoko, Inc. 2008, 2009 Andy Green 2008, 2010 Paul Fertser 2011 Timo Juhani Lindfors License: GPL-2 Files: src/io.h Copyright: 1996, 1997, 1998, 1999, 2000 Russell King 2008 Xiangfu Liu License: GPL-2 Files: tools/* Copyright: 2007 OpenMoko, Inc. 2000, 2001, 2003, 2004 DENX Software Engineering 2008 Xiangfu Liu License: GPL-2+ License: GPL-2+ This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. . This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. . On Debian systems, the complete text of the GNU General Public License can be found in `/usr/share/common-licenses/GPL-2'. License: GPL-2 This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation. . On Debian systems, the complete text of the GNU General Public License can be found in `/usr/share/common-licenses/GPL-2'. License: Zlib This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software. . Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: . 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required. 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software. 3. This notice may not be removed or altered from any source distribution. debian/changelog0000644000000000000000000000166711657705757011076 0ustar qi (20111113-1) unstable; urgency=low * New upstream release - Add support for two boot options even when there is only one partition - Add support for initrd (/boot/initrd-GTA02.bin) - Change NAND kernel boot parameters to use rootfstype=ubifs instead of jffs2. It is now possible to dualboot SHR and Debian. Tested with http://shr.bearstech.com/shr-core/images/om-gta02/uImage-2.6.39-r6-oe13-om-gta02-20111031080338.bin http://shr.bearstech.com/shr-core/images/om-gta02/shr-full-20111109-om-gta02.rootfs.ubi * Remove upstreamed patch fix-build-with-gcc-4.6.diff * Document how qi can be installed using old versions of mtd-utils * Write a man page -- Timo Juhani Lindfors Sat, 12 Nov 2011 18:18:51 +0200 qi (20100107-1) unstable; urgency=low * Initial release (Closes: #629404) -- Timo Juhani Lindfors Sun, 05 Jun 2011 22:43:21 +0300 debian/watch0000644000000000000000000000016611657574312010235 0ustar # Upstream does not make releases so there are no releases to watch, # we just need to package git snapshots for now. debian/compat0000644000000000000000000000000211657574312010377 0ustar 8 debian/README.Debian0000644000000000000000000000445411657574312011251 0ustar Qi for Debian ============= Currently there are two ways to install Qi to your OpenMoko Freerunner. Installing using DFU from another computer ------------------------------------------ 1) Connect your phone to a PC with a USB cable and shutdown the phone. 2) Hold down the AUX button 3) Press the POWER button for one second. Release the AUX button and verify that you see the following on the screen: U-Boot 1.3.2-moko12 (May 9 2008 - 10:28:48) *** BOOT MENU (NOR) *** Boot Boot from microSD (FAT+ext2) Set console to USB Set console to serial Reboot Power off Press [AUX] to select, [POWER] to execute. If you do not see the text "NOR" on the screen, do not continue! This can happen if your AUX button is broken. 4) (optional) Run dfu-util -a u-boot -R -U backup.udfu on your PC to make a backup of your current boot loader. 5) Get a copy of "qi.udfu" to your PC. If your phone already runs Debian you can install qi and copy /usr/lib/qi/gta02/qi.udfu to your PC. If you are not running Debian you can 5.1) Download the latest file named "qi_*_armel.deb" from http://ftp.debian.org/debian/pool/main/q/ to a temporary directory. 5.2) Run "ar x qi_*_armel.deb" to "tar xzvf data.tar.gz" to manually extract all files from the package. You should now have a file named ./usr/lib/qi/gta02/qi.udfu 6) Run dfu-util -a u-boot -R -D qi.udfu on your PC to install Qi to your phone. 7) Press AUX six times so that "Power off" is highlighted and then press POWER to shutdown the phone. 8) Press the POWER button for one second to boot your system. Installing using nandwrite from a running system ------------------------------------------------ If you don't have a PC or don't want to use it, you can still install Qi from a running system. 1) Run sudo flash_erase /dev/mtd1 0 0 on your phone to erase your previous boot loader. The output should be "Erasing 128 Kibyte @ 20000 -- 100 % complete". Note that if you use mtd-utils 20090606-1 or older you need to use sudo flash_eraseall /dev/mtd1 instead. 2) Run sudo nandwrite -p /dev/mtd1 /usr/lib/qi/gta02/qi to install Qi. The output should be "Writing data to block 0 at offset 0x0". -- Timo Juhani Lindfors , Mon, 6 Jun 2011 10:52:28 +0300