This is a Subproject of the GTA04 and Openmoko Beagle Hybrid
Features
- full base install of Debian
- upgrade to base install by X11, LXDE, i2c tools, libertas, alsa, etc. so that LXDE starts out of the box
- compatible to the Linux kernel from the GTA04 Kernel project - and includes the matching modules
- can be installed on a two-partition SD card to boot Debian from a SD card; or on devices with u-boot in NAND, a single partition is sufficient
- drivers for built-in WiFi, Bluetooth, CDC Ethernet, touch screen etc. already configured
- can be easily extended and adapted by apt-get (locate packages through Debian Projects)
Installation
Please use the new gta04-makesd tool.
Download binaries
Latest binary downloads are available here.
Please use either unstable or the latest "stable" (subdirectory with date/description).
Install on SD card
The SD card needs to have a special format as described here.
IMPORTANT: the first file you copy to the FAT partition must be the MLO (machine loader).
Extract the Debian Rootfs to the ext partition of a 2-partition SD card which already includes MLO, U-Boot and the Kernel.
You may find the "makesd" script convenient. Please adapt to your raw device file name!
Boot the GTA04 with the new SD card
After you have powered on, the device should boot into Linux and show LXDE. Connect the device through USB to a host (that is capable of running the ethernet gadget protocol).
ssh root@192.168.0.202
Run these commands on the GTA04
depmod -a # to update the modules database
ts_calibrate # to calibrate the touch screen
./useful # this installs nice additional packages
apt-get upgrade # upgrade to the latest Debian stable
reboot
This takes a while and also charges the GTA04 battery.
Install X-Loader and U-Boot in NAND flash
- connect the board to RS232
- copy all required files (MLO, x-loader.ift, splash.rgb16z, boot.scr etc.) to a SD card as described in the previous section.
- install the SD card and boot from peripheral (press User/AUX button if required).
- break into the U-Boot console
- flash=yes
- run bootcmd
Install Kernel and Linux-System in NAND flash (as jffs)
- copy all required files (MLO, x-loader.ift, splash.rgb16z, boot.scr etc.) to a SD card as described in the previous section.
- install the SD card and boot from peripheral (press User/AUX button if required).
- connect through ssh
- ./flash-nand
Adaptations
On the Beagleboard XM you can use the Ethernet interface. You will have to manually do some ifconfig to set the network address and route add default so that all outgoing traffic is routed to usb0.
E.g. (depending on your network)
route add default gw 192.168.2.1 usb0
ifconfig usb0 192.168.2.114
The reason is that the default config is intended for the USB-OTG port which happens to be called usb0 as well. And that one has a default IP address of 192.168.0.202 to be compatible with Angstrom/Openmoko.
So to make it permanently work, you also should edit /etc/network/interfaces - but after running the postinst script (it will be overwriten by the script).
Bugs
Please report bugs in the Issue Tracking section. If you have developed patches (git format-patch), please send them through e-mail for review.
Build your own Debian from scratch
on some Linux machine
tar tvjf bootstrap-lenny.tbz # loads base rootfs
tar tvzf modules.tbz # installs kernel modules
tar tvzf config.tbz # installs our specific config
completion on Beagle Board or GTA04
- insert SD into device
- boot and login as 'root' (console or through ssh over USB). The console login is 'root' with no password.
- run (to upgrade and install some important packages) ./postinst
- install additional packages with apt-get install or any packet manager you like.