Openmoko - User contributions [en]

Manual Debian

2009-06-26T12:09:15Z

JoSch: /* Disable Framebuffer Blanking */

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd stable /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* curl - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)
* iputils-ping - ping
* mtd-utils (flash_eraseall, nandwrite, mkfs.jffs2)

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
cat > /media/card/etc/apt/apt.conf.d/99no-install-recommends << __END__
APT::Install-Recommends "0";
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

or calibrate it yourself until you are happy with the result:
apt-get install libts-bin
TSLIB_CALIBFILE=/etc/pointercal TSLIB_TSDEVICE=/dev/input/event1 TSLIB_CONSOLEDEVICE=none ts_calibrate

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
cat > /etc/modules << __END__
hci_usb
hidp
ohci-hcd
rfcomm
snd-mixer-oss
snd-pcm-oss
snd-soc-neo1973-wm8753
__END__

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]

== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base alsa-utils gstreamer0.10-alsa
cat > /etc/asound.conf << __END__
pcm.!default {
type plug
slave.pcm "dmixer"
}
pcm.dmixer {
type dmix
ipc_key 1024
slave {
pcm "hw:0,0"
period_time 0
period_size 1024
buffer_size 4096
rate 44100
}
bindings {
0 0
1 1
}
}
ctl.dmixer {
type hw
card 0
}
__END__
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Disable Framebuffer Blanking ==

the obfuscated way:
echo -e '\033[9;0]' > /dev/tty0

the sys-path way:
echo -n 0 > /sys/devices/platform/s3c2410-lcd/graphics\:fb0/blank

the debian way:
apt-get install console-tools
sed -i 's/\(BLANK_TIME\)=30/\1=0/' /etc/console-tools/config

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

To enter the debian chroot environment you could use the following script:

<pre>
#!/bin/sh
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /bin/sh
</pre>

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-06-23T22:21:07Z

JoSch: corrected fb blanking

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd stable /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* curl - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)
* iputils-ping - ping
* mtd-utils (flash_eraseall, nandwrite, mkfs.jffs2)

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
cat > /media/card/etc/apt/apt.conf.d/99no-install-recommends << __END__
APT::Install-Recommends "0";
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

or calibrate it yourself until you are happy with the result:
apt-get install libts-bin
TSLIB_CALIBFILE=/etc/pointercal TSLIB_TSDEVICE=/dev/input/event1 TSLIB_CONSOLEDEVICE=none ts_calibrate

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
cat > /etc/modules << __END__
hci_usb
hidp
ohci-hcd
rfcomm
snd-mixer-oss
snd-pcm-oss
snd-soc-neo1973-wm8753
__END__

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]

== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base alsa-utils gstreamer0.10-alsa
cat > /etc/asound.conf << __END__
pcm.!default {
type plug
slave.pcm "dmixer"
}
pcm.dmixer {
type dmix
ipc_key 1024
slave {
pcm "hw:0,0"
period_time 0
period_size 1024
buffer_size 4096
rate 44100
}
bindings {
0 0
1 1
}
}
ctl.dmixer {
type hw
card 0
}
__END__
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Disable Framebuffer Blanking ==

the obfuscated way:
echo -e '\033[9;0]' > /dev/tty0

the sys-path way:
echo -n 1 > /sys/devices/platform/s3c2410-lcd/graphics\:fb0/blank

the debian way:
apt-get install console-tools
sed -i 's/\(BLANK_TIME\)=30/\1=0/' /etc/console-tools/config

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

To enter the debian chroot environment you could use the following script:

<pre>
#!/bin/sh
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /bin/sh
</pre>

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Neo1973 Robustness

2009-06-22T12:30:56Z

JoSch: /* Drops */

This is a list of stuff you've done to your neo.

== Drops ==

{|border="1" cellpadding="2" cellspacing="0"
!User||Height fell || Horizontal velocity || Surface it hit || Damage?
|-
|josch||3m||bumped off the steps||stairs - fell 14 steps until it reached the basement||battery fell off - completely working afterwards
|-
|Speedevil||1m||0||carpet||none
|-
|rwhitby||1.3m||0.25m/s||pavement||Front of case separated from middle around the BT antenna (the screws inside had been previously removed), AUX button dislodged (but could be replaced easily), scratches on silver on front top and rear right.
|-
|Johan||1.2m||0||tiled floor || none
|-
|Pavel||~1m||0||carpet IIRC || Case opened where it should not open, but "repair" was as easy as clicking it back together
|}

== Liquid Exposure ==

{|border="1" cellpadding="2" cellspacing="0"
!User||Amount of liquid || Type of liquid || Damage?
|-
|bradpitcher||total immersion||water||No apparent damage. I immediately opened the case and removed the battery, tried to shake off excess water, and let sit to dry for a day before restarting it. NOTE: this does not mean the Neo is waterproof. Do NOT try this at home!
|}

== Other ==

{|border="1" cellpadding="2" cellspacing="0"
!User||Symptom || Circumstances || Damage?
|-
|freelock||AUX button broke||One day it just quit clicking, no tactile feedback||Took apart the front of the Neo, and the little contact had popped off the circuit board. Now I need to find a soldering iron and remember how to do this kind of thing!
|}

[[Category:Neo1973 Hardware]]

Manual Debian

2009-06-06T09:56:07Z

JoSch: added alsa-utils

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd stable /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* curl - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)
* iputils-ping - ping
* mtd-utils (flash_eraseall, nandwrite, mkfs.jffs2)

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
cat > /media/card/etc/apt/apt.conf.d/99no-install-recommends << __END__
APT::Install-Recommends "0";
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

or calibrate it yourself until you are happy with the result:
apt-get install libts-bin
TSLIB_CALIBFILE=/etc/pointercal TSLIB_TSDEVICE=/dev/input/event1 TSLIB_CONSOLEDEVICE=none ts_calibrate

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
cat > /etc/modules << __END__
hci_usb
hidp
ohci-hcd
rfcomm
snd-mixer-oss
snd-pcm-oss
snd-soc-neo1973-wm8753
__END__

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]

== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base alsa-utils gstreamer0.10-alsa
cat > /etc/asound.conf << __END__
pcm.!default {
type plug
slave.pcm "dmixer"
}
pcm.dmixer {
type dmix
ipc_key 1024
slave {
pcm "hw:0,0"
period_time 0
period_size 1024
buffer_size 4096
rate 44100
}
bindings {
0 0
1 1
}
}
ctl.dmixer {
type hw
card 0
}
__END__
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Disable Framebuffer Blanking ==

the obfuscated way:
echo -e '\033[9;0]' > /dev/tty0

the sys-path way:
echo -n 0 > /sys/devices/platform/s3c2410-lcd/graphics/fb0/blank

the debian way:
apt-get install console-tools
sed -i 's/\(BLANK_TIME\)=30/\1=0/' /etc/console-tools/config

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

To enter the debian chroot environment you could use the following script:

<pre>
#!/bin/sh
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /bin/sh
</pre>

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Distributions

2009-06-05T12:43:44Z

JoSch: corrected information about pyneo

{{Languages|Distributions}}

{|align=left
|__TOC__
|}

== About distributions ==
Openmoko distributions are designed to run on various mobile devices, with the primary aim of supporting Openmoko Inc.'s [[GTA01:Neo 1973|Neo 1973]] and [[Neo FreeRunner]] phones. They are GNU/Linux distributions -- complete operating systems including user applications. You can install any of them on your phone or even have a dualboot system with two distributions installed. For downloads see [[Download]], for installation instructions see [[Flashing the Neo FreeRunner]].

Besides, Openmoko distributions also run on [[Supported devices|other]] mobile devices and some other software distributions also run on the phones of Openmoko Inc.

=== Choosing a distribution ===
Currently the most used distributions are [[Om 2008]], which comes preinstalled on the Neo FreeRunner, and [[Stable Hybrid Release|SHR]].[http://spreadsheets.google.com/pub?key=p2ZQdcRSVg9XfYLwBVsZicg]

In the future [[Om 2009]] will be the default distribution. It is currently under development and should be released in june 2009. Like SHR it will be based on the [[freesmartphone.org]] framework.

Furthermore, there are many other distributions, like [[Qt Extended]] (for stable basic functions), Google's [[Android]], and some [[Debian]]-based distros.

{| class="wikitable" style="float:right;width:200px;background-color:#FF6600;text-align:center;border-collapse:collapse;font-weight:bold"
|<font color=white>Distributions</font>
|-
! style='background-color:#333333;color:#FFFFFF'|
<div align=left>
* <font color='#BBBBBB'>Openmoko (official)</font>
** [[Om2009]]
** [[Om 2008.12 Update]]
** [[Om 2008.9 Update]]
** [[Om 2008.8]]
** [[Om 2007.2]]
** [[OpenmokoFramework|FSO]]
* <font color='#BBBBBB'>Om Community</font>
** [[SHR]]
** [[FDOM]]
* <font color='#BBBBBB'>Other</font>
** [[Qtopia]]
** [[Debian]]
** [[Gentoo]]
** [[Android]]
** [[Hackable:1]]
** [[neovento]]
</div>
|-
|}

=== Please note ===

* Stable in the FreeRunner world does not mean the same thing as stable in the Debian world.
* Most distributions use the same bootloader, kernel, drivers and hardware. Therefore, the same low level bugs are commonly found in all distributions. The latest and greatest software usually has most bug fixes, plus a whole set of new fresh bugs.
* Most of these distributions also have package repositories. It is a BAD idea to feed from another distribution's repository.
* Upgrade path between these distributions are mostly not tested, thus updating by changing the feeds will most likely end in broken packages or even an unbootable system. It is advisable to reflash the whole filesystem with [[dfu-util]] to switch between the different distributions, with the reminder that a dual-boot setup (e.g. via sdcard or NFS) can be used.

== Official Openmoko releases ==

'Release targets' offered by Openmoko Inc. are built out of different branches of the [[OpenEmbedded]] metadistribution source tree.

=== Om series ===

* '''[[Om2009]]''' is intended to be the new distro; it is not a simple follow-on from [[Om 2008.12 Update]]. '''It is still very much in development and by no means ready for production use''' and is based on the [http://freesmartphone.org freesmartphone.org] milestone 5.5 framework.

{{Main|Om2009}}

* '''[[Om 2008.12 Update]]''' is the second point release after the initial ''Om 2008.9'' release.

{{Main|Om 2008.12 Update}}

* '''[[Om 2008.9 Update]]''' is the first point release after the initial ''Om 2008.8'' release. Openmoko recommends that all existing installations of Om 2008.8 should be updated to that version. Quality-wise, we are still far from the goal, but this version includes general stability enhancing operating system improvements and a new splash screen. No applications were added or removed. Users with basic telephony needs will find it tolerable as an everyday phone.

{{Main|Om 2008.9 Update}}

* '''[[Om 2008.8]]''' was released on August 8, 2008, to replace 2007.2. Prior to that, its codename was ASU (April/August Software Update). This is still the name of the branch in the version control system. This distribution integrates the [http://trolltech.com/products/qtopia Qtopia] phone stack with a set of new Openmoko applications based on the Enlightenment Foundation Libraries ([[EFL_Documentation|EFL]]). Qtopia being a more mature product than the GNOME Mobile stack, the standard phone applications (dialer, contacts, calculator, calendar) work better than in 2007.2. The Qtopia used in 2008.8 was ported to run on X11, contrary to standard Qtopia which uses the framebuffer. This allows non-Qt applications to safely share the screen with Qt applications. This is a .0 release, many unresolved issues remain in the lower layers (kernel power management, sound, wifi drivers...).

{{Main|Om 2008.8}}

* '''[[Om 2007.2]]''' was the first distribution created by Openmoko. The interface was totally finger-oriented, optimized for 285ppi, and very orange. It used the GTK+ stack, which is part of the [http://www.gnome.org/mobile/ GNOME Mobile] platform. This distribution is now considered obsolete and not being worked on by Openmoko Inc or by OpenedHand.

{{Main|Om 2007.2}}

=== FSO series ===

'''FSO''' is an abbreviation for FreeSmartphone.Org. Openmoko is working on a stable system services back-end. Focus is on stable highlevel services that you can access from whatever language or UI that supports [http://dbus.freesmartphone.org/ dbus]. The framework will be used in forthcoming Openmoko distributions. FSO is all about middleware, but if one stacks a bootloader+kernel under it and telephony applications on top, one gets a functional distribution. These are made available as FSO-image milestones.

* '''FSO Milestone V''' was released and named 'Calling All Stations'. The telephony application on top of it is Zhone. This is a basic Python dialer/homescreen designed as scaffolding to test the FSO functionalities (even if Zhone is pretty, code path coverage is more critical to it than user-friendliness). More details at
[http://wiki.openmoko.org/wiki/OpenmokoFramework/Status_Update_6 Status Update 6]. You can grab it from http://downloads.freesmartphone.org/fso-stable/milestone5.1/ .

{{Main|FSO}}

== Openmoko community releases ==

=== SHR - Stable Hybrid Release ===

SHR is a community driven distribution. It contains some basic EFL based applications which make use of the FSO. There currently is an [[EFL_Documentation|EFL]] (with elementary) dialer, messages and contacts application programmed in C, as well as a nice Settings-GUI in Python. As of April 12th, 2009, there is no stable release of this distribution yet, as the SHR team doesn't feel it to be good enough. You can find images though on the [http://shr.bearstech.com/shr-testing SHR buildhost].

{{Main|Stable Hybrid Release}}

=== FDOM (FAT and Dirty Openmoko) ===

[[FDOM]] is a distribution based on Openmoko's currently supported image, updated with many ready-to-use applications and with fixes posted in the mailing lists. A combination of applications (everything goes) and fixes to demonstrate the capabilities of the Freerunner and to have a functional phone (sort of). This all while retaining the ability to update through the official feeds.

{{Main|FDOM}}

=== Non-Openmoko distributions ===

These are not Openmoko (and OE) based distributions. These are alternatives you can run on your Openmoko phones.

==== Qt Extended ====
Qt Extended has had several names. The current name is <b>Qt Extended Improved</b>. An Openmoko-based community develops Qt Extended Improved as a Free Software project. Qt Extended Improved builds on the foundation of Qt Extended/Qtopia/Qt by Qt Software/Trolltech. Qt Extended Improved provides a robust telephony stack, a webkit based browser and other smartphone features.

On 5th March 2009 Qt Software released Qt Extended 4.4.3. On 3rd March 2009 Qt Software announced that Qt Extended would 4.4.3 would be the last release of the Qt Extended product. Prior to version 4.3, Qt Extended was known as Qtopia.

{{Main|Qtopia / Qt Extended on FreeRunner}}

==== Debian ====
Debian is "the universal operating system". It comes with thousands and thousands of packages (most of them designed for desktops or servers so far). So in the words of Joachim "nomeata" Breitner from the [http://wiki.debian.org/Teams/DebianFSO pkg-fso] team, this is not really a distribution in the Openmoko sense of the word, but rather a different underlying system for Openmoko distributions. At the moment, we ship the software from the FSO stack, but hopefully we’ll also have, for example, the Stable Hybrid Release software in our archive. So for now, Debian is a different way of installing FSO, which takes more space and provides more programs :-)

{{Main|Debian}}

==== [[Gentoo ]]====
Gentoo is all about choices. When installing Gentoo, this is made clear to you several times -- you can choose how much you want to compile yourself, how to install Gentoo, what system logger you want, etc. Gentoo is a fast, modern metadistribution with a clean and flexible design. Gentoo is built around free software and doesn't hide from its users what is beneath the hood. Portage, the package maintenance system which Gentoo uses, is written in Python, meaning you can easily view and modify the source code. Gentoo's packaging system uses source code (although support for precompiled packages is included too) and configuring Gentoo happens through regular textfiles. In other words, openness everywhere.

{{Main|Gentoo}}

==== Android ====
[http://code.google.com/android/ Android] is a software stack for mobile devices developed by the [http://www.openhandsetalliance.com/ The Open Handset Alliance.] Openmoko is fully supporting Android running on the Freerunner.

Android has now reached a point where it is usable on the FreeRunner as an everyday phone, there are, however, still some caveats. Check out the main Android section of the wiki for more info.

{{Main|Android}}You can also visit the user web page for [http://wiki.openmoko.org/wiki/User:Seanmcneil3 Sean McNeil] for some more info.

====Slackware====
As of release 12.2, Slackware is now officially supported on the Neo Freerunner
[http://armedslack.org/]

==== Hackable:1====
Hackable1 is a community distribution for hackable devices like the Neo Freerunner. It is based on Debian and 2007.2 userland which has been abandoned by Openmoko. It follows the GNOME mobile platform.
{{Main|Hackable:1}}

====[[neovento]]====
neovento (ex FYP) is a [[Debian|Debian on Freerunner]] based [[Distributions|distribution]] which uses [http://lxde.org/ LXDE] and [[Zhone]] on top. It is a [http://freeyourphone.de FreeYourPhone.de] community project.

{{Main|neovento}}

====[[OpenWRT]]====
The OpenWRT Development Trunk supports Freerunner, too. [http://www.openwrt.org/]

==== Others / unreleased ====
* The [http://www.neopwn.com/software.php NeoPwn] network auditng system's core is a modified Linux 2.6.24 kernel, with cross-compiled module driver support for the numerous compatible addon devices running on a FULL Debian (ARMEL) operating system. The filesystem has been optimized for performance and size and includes the NeoPwn menu system and several GUI dialogs for hardware control and attack automation. ''Status: Unknown, the GPL requires source code to be distributed only to customers''.
* [http://runningbear.org/trac RunningBear] is an innovative, yet free and open-source Operating System for hackable devices driven by Bearstech. Lightweight, Portable, Secure, Friendly and Useful. ''Status: In development''.
* [http://pokylinux.org/ Poky] and Sato, by OpenedHand/Intel. An open source platform build tool derived from OE. It is a complete software development environment for the creation of Linux devices. It enables you to design, develop, build, debug, and test a complete, modern, software stack using Linux, the X Window System and GNOME Mobile based application frameworks for both ARM and x86 based platforms. ''Status: The "Nightly Build" Image works fine on Neo Freerunner, but phone functionality doesn't.''
* [http://pyneo.org/ PyNeo] pyneo is a stack for mobile devices excessivly using dbus, glib and evas. Pyneo is NO distribution but a middleware or framework like FSO which itself developed from a very early version of pyneo. Current pyneo images are entirely based on debian instead of oe. ''Status: still active and in development! ask around on #pyneo.org ''
* [http://www.quantum-step.com/ mySTEP] by Openmoko distributor Golden Delicious Computers is based on GNUstep and brings a Objective-C API to the Neo. Core GUI frameworks are "Foundation" & "AppKit". It has been shown on FOSDEM 2008, LinuxTag 2008 and SYSTEMS 2008 to run on the Neo 1973. If someone reengineers UIKit, (open) source code compatibility to iPhone apps appears achievable. ''Status: it does not have its own kernel so a Freerunner distribution waits for a solid basis and an arm-linux-gnueabi toolchain that runs natively on Mac OS X is currently lacking.''

== Features by distribution/release target ==

Generally, distributions can differ on one or more of the following components:
* The bootsplash screen image. This is purely decorative.
* The bootloader. Theoretically, any version of ''uboot'' could be used with any distribution. In the future ''Qi'' will replace ''uboot''.
* The kernel. GNU/Linux kernels versions 2.6.24, 2.6.26 or 2.6.28 can be found. Some have modules compiled in, others have modules compiled separately. If compiled separately, modules can be distributed in the same package file as the kernel or separately.
* Middleware: daemons to handle GSM calls or GPS, sound system, personal information storage and so on. Qt and Android have their own subsystems, FreeSmartphone.Org (FSO) is working towards a standard-based Free Software one.
* Display driver. The original ''Qt Extended'' uses the framebuffer, most other distributions today use ''X11''.
* Libraries and application framework (widget toolkit and and graphical environment) : EFL, Qt, Gtk+ or Java ?
* Basic telephony applications: voice calls, SMS, alarm clock...
* Smartphone applications: GPS, media player, simple games, web browser...
* Open source applications: more games, scientific, you name it...

=== Hardware Support ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|Om 2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| GTA01 || ?? || ?? || ?? || {{Yes}} || ?? || {{Yes}} || {{Yes}} || ?? || ??
|-
| GTA02 || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
|}

=== Connectivity ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|Om 2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Telephony || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| SMS || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| [[GPRS]] || Not through UI || Not through UI|| Not through UI || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || Not through UI || {{Yes}}
|-
| [[WiFi]] || {{Yes}} (*) || {{Yes}} || Not through UI || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || Not through UI || {{Yes}}
|-
| VoIP || ?? || ?? || ?? || ?? || {{Yes}} || {{Yes}} (1) || {{Yes}} || ?? || {{no}}
|-
| Bluetooth || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{Yes}}
|-
| GPS (1) || {{Yes}} (1) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || {{Yes}} (1) || {{Yes}}
|-
|}

=== Power ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|Om 2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Suspend || {{Yes}} || ?? || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Resumes on Event || ?? || ?? || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ??
|-
| Functions after Resume || {{Yes}} || ?? || ?? || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
|}

=== User Interaction ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|Om2008.8 !! width=8%|2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Stylus friendly || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Finger friendly || Partially || Partially || Partially || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Accelerometer || {{Yes}} [[Rotate|(1)]][[Gestures|(1)]] || {{No}} || {{No}} || {{yes}} (1) || {{Yes}} || {{No}} || {{Yes}} || ?? || {{Yes}}
|-
|}

=== Applications ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Terminal || {{Yes}} (1) || Basic (2) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || {{Yes}}
|-
| PIM || {{Yes}} || {{Yes}} || {{No}} || N/A || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || ??
|-
| Phonebook || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Dialer || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Web Browser || {{Yes}} (1) || {{Yes}} (1) || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Mail Client || {{Yes}} || ? || ? || ? || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| XMPP Client || {{Yes}} [[Instant Messaging|(1)]] || {{Yes}} (1) || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || || ??
|-
| Media Player || {{Yes}} (1) || {{Yes}} || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
|}

=== Toolkits / Runtimes ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0"
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| GTK+ || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || ??
|-
| Qt/Qt Extended || {{Yes}} || {{No}} || {{Yes}} ? || {{Yes}}? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ??
|-
| Middleware || qtopia-x11 || gsmd/neod || FSO || FSO || qtopia-x11 || Qt Extended || FSO || FSO || ??
|-
| [[Java]] || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes}} || ?? || {{Yes|CacaoVM, JamVM}} || ?? || ??
|-
| [[Python]] || {{Yes}} || {{Yes}} || {{Yes}} || {{yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ??
|-
| [[Mono]] || {{Yes}} (1) || {{Yes}} (1) || ?? || {{no}} || ?? || ?? || {{Yes}} (1) || ?? || ??
|-
| [[Ruby]] || {{Yes}} || ?? || ?? || ?? || ?? || ?? || {{Yes}} (1) || {{Yes}} (1) || ??
|}

=== Images ===
Latest and stable combinations for Neo FreeRunner gta02
{|class="wikitable" border="1" cellpadding="5" cellspacing="0"
| || OM || FDOM || Qt Extended || Android
|-
| current bootloader || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/distro/releases/Om2008.9/ OM daily] version [http://downloads.openmoko.org/] || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/repository/experimental/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/repository/experimental/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] ||
|-
| future bootloader || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu ||
|-
| splash || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz ||
|-
| kernel || [[Linux]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest uImage.bin || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest uImage-gta02-mwester-stable.bin or from [http://downloads.tuxfamily.org/3v1deb/openmoko/ treviño] latest uImage-gta02-stable-3v1n0.bin || [[Linux]] see [[Qt_Extended]] page for latest version || [[Linux]] from [http://koolu.org/releases/ koolu]
|-
| modules || ? || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest modules-min-gta02-mwester-stable.tgz or modules-all-gta02-mwester-stable.tgz || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest modules-min-gta02-mwester-stable.tgz or modules-all-gta02-mwester-stable.tgz ||
|-
| rootfs || [[Main_Page|OM]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest rootfs.jffs2 || [[FDOM]] from [ftp://ftp.tuxbrain.com/openmoko/fdom/releases/ TuxBrain] version [ftp://ftp.tuxbrain.com/openmoko/fdom/releases/Fat_and_Dirty_OM.200809_20081023.rootfs.jff2 200809_20081023] || See [[Qt_Extended]] for latest rootfs || [[Android]] from [http://koolu.org/releases/ koolu]
|}

Footnotes:

(1) works, but need additional software to be installed

(2) unusable due to lack of certain keyboard characters. [[Switching_Keyboards#Matchbox_keyboard|Various fixes available.]]

(*) unstable

==Quick download page==

[[Download]]

== See also ==

* Mickey Lauer's post "[http://www.vanille-media.de/site/index.php/2008/06/28/gtk-asu-fso-tmtla/ GTK, ASU, FSO, TMTLA!]" describes the differences between distributions 2007.2, ASU and FSO.

* Latest news and tips are in [[Community Updates]]

* [[Kustomizer]] is a script to change your 2008.12 to a usable phone

[[Category:Distributions| ]]

Manual Debian

2009-03-21T11:34:13Z

JoSch: added gstreamer0.10-alsa dependency

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd stable /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* curl - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)
* iputils-ping - ping
* mtd-utils (flash_eraseall, nandwrite, mkfs.jffs2)

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
cat > /media/card/etc/apt/apt.conf.d/99no-install-recommends << __END__
APT::Install-Recommends "0";
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

or calibrate it yourself until you are happy with the result:
apt-get install libts-bin
TSLIB_CALIBFILE=/etc/pointercal TSLIB_TSDEVICE=/dev/input/event1 TSLIB_CONSOLEDEVICE=none ts_calibrate

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
cat > /etc/modules << __END__
hci_usb
hidp
ohci-hcd
rfcomm
snd-mixer-oss
snd-pcm-oss
snd-soc-neo1973-wm8753
__END__

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]

== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base gstreamer0.10-alsa
cat > /etc/asound.conf << __END__
pcm.!default {
type plug
slave.pcm "dmixer"
}
pcm.dmixer {
type dmix
ipc_key 1024
slave {
pcm "hw:0,0"
period_time 0
period_size 1024
buffer_size 4096
rate 44100
}
bindings {
0 0
1 1
}
}
ctl.dmixer {
type hw
card 0
}
__END__
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Disable Framebuffer Blanking ==

the obfuscated way:
echo -e '\033[9;0]' > /dev/tty0

the sys-path way:
echo -n 0 > /sys/devices/platform/s3c2410-lcd/graphics/fb0/blank

the debian way:
apt-get install console-tools
sed -i 's/\(BLANK_TIME\)=30/\1=0/' /etc/console-tools/config

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

To enter the debian chroot environment you could use the following script:

<pre>
#!/bin/sh
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /bin/sh
</pre>

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-03-21T11:16:21Z

JoSch: added dmix as default device

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd stable /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* curl - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)
* iputils-ping - ping
* mtd-utils (flash_eraseall, nandwrite, mkfs.jffs2)

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
cat > /media/card/etc/apt/apt.conf.d/99no-install-recommends << __END__
APT::Install-Recommends "0";
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

or calibrate it yourself until you are happy with the result:
apt-get install libts-bin
TSLIB_CALIBFILE=/etc/pointercal TSLIB_TSDEVICE=/dev/input/event1 TSLIB_CONSOLEDEVICE=none ts_calibrate

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
cat > /etc/modules << __END__
hci_usb
hidp
ohci-hcd
rfcomm
snd-mixer-oss
snd-pcm-oss
snd-soc-neo1973-wm8753
__END__

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]

== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
cat > /etc/asound.conf << __END__
pcm.!default {
type plug
slave.pcm "dmixer"
}
pcm.dmixer {
type dmix
ipc_key 1024
slave {
pcm "hw:1,0"
period_time 0
period_size 1024
buffer_size 4096
rate 44100
}
bindings {
0 0
1 1
}
}
ctl.dmixer {
type hw
card 0
}
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Disable Framebuffer Blanking ==

the obfuscated way:
echo -e '\033[9;0]' > /dev/tty0

the sys-path way:
echo -n 0 > /sys/devices/platform/s3c2410-lcd/graphics/fb0/blank

the debian way:
apt-get install console-tools
sed -i 's/\(BLANK_TIME\)=30/\1=0/' /etc/console-tools/config

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

To enter the debian chroot environment you could use the following script:

<pre>
#!/bin/sh
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /bin/sh
</pre>

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-27T22:09:13Z

JoSch: framebuffer blanking

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd stable /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* curl - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)
* iputils-ping - ping
* mtd-utils (flash_eraseall, nandwrite, mkfs.jffs2)

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
cat > /media/card/etc/apt/apt.conf.d/99no-install-recommends << __END__
APT::Install-Recommends "0";
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

or calibrate it yourself until you are happy with the result:
apt-get install libts-bin
TSLIB_CALIBFILE=/etc/pointercal TSLIB_TSDEVICE=/dev/input/event1 TSLIB_CONSOLEDEVICE=none ts_calibrate

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
cat > /etc/modules << __END__
hci_usb
hidp
ohci-hcd
rfcomm
snd-mixer-oss
snd-pcm-oss
snd-soc-neo1973-wm8753
__END__

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]

== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Disable Framebuffer Blanking ==

the obfuscated way:
echo -e '\033[9;0]' > /dev/tty0

the sys-path way:
echo -n 0 > /sys/devices/platform/s3c2410-lcd/graphics/fb0/blank

the debian way:
apt-get install console-tools
sed -i 's/\(BLANK_TIME\)=30/\1=0/' /etc/console-tools/config

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-27T20:46:28Z

JoSch: added manual calibration

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd stable /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* curl - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)
* iputils-ping - ping
* mtd-utils (flash_eraseall, nandwrite, mkfs.jffs2)

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
cat > /media/card/etc/apt/apt.conf.d/99no-install-recommends << __END__
APT::Install-Recommends "0";
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

or calibrate it yourself until you are happy with the result:
apt-get install libts-bin
TSLIB_CALIBFILE=/etc/pointercal TSLIB_TSDEVICE=/dev/input/event1 TSLIB_CONSOLEDEVICE=none ts_calibrate

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
cat > /etc/modules << __END__
hci_usb
hidp
ohci-hcd
rfcomm
snd-mixer-oss
snd-pcm-oss
snd-soc-neo1973-wm8753
__END__

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]

== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-27T20:22:16Z

JoSch: added mtd-utils

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd stable /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* curl - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)
* iputils-ping - ping
* mtd-utils (flash_eraseall, nandwrite, mkfs.jffs2)

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
cat > /media/card/etc/apt/apt.conf.d/99no-install-recommends << __END__
APT::Install-Recommends "0";
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
cat > /etc/modules << __END__
hci_usb
hidp
ohci-hcd
rfcomm
snd-mixer-oss
snd-pcm-oss
snd-soc-neo1973-wm8753
__END__

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]

== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-27T19:40:47Z

JoSch: now pully "stable" yeah! updated package list

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd stable /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* curl - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)
* iputils-ping - ping

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
cat > /media/card/etc/apt/apt.conf.d/99no-install-recommends << __END__
APT::Install-Recommends "0";
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
cat > /etc/modules << __END__
hci_usb
hidp
ohci-hcd
rfcomm
snd-mixer-oss
snd-pcm-oss
snd-soc-neo1973-wm8753
__END__

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]

== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-27T19:32:32Z

JoSch: no-install-recommends

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd lenny /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* curl - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s
* iputils-ping - ping

additionally interesting packages:
* vim (instead of vim-tiny)
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* curl (instead of wget)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
cat > /media/card/etc/apt/apt.conf.d/99no-install-recommends << __END__
APT::Install-Recommends "0";
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
cat > /etc/modules << __END__
hci_usb
hidp
ohci-hcd
rfcomm
snd-mixer-oss
snd-pcm-oss
snd-soc-neo1973-wm8753
__END__

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]

== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-25T20:11:09Z

JoSch: added ping, curl

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd lenny /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* curl - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s
* iputils-ping - ping

additionally interesting packages:
* vim (instead of vim-tiny)
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* curl (instead of wget)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
cat > /etc/modules << __END__
hci_usb
hidp
ohci-hcd
rfcomm
snd-mixer-oss
snd-pcm-oss
snd-soc-neo1973-wm8753
__END__

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]

== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-25T17:01:08Z

JoSch: /* Load Additional Kernel Modules */

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd lenny /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* wget - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* vim (instead of vim-tiny)
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* curl (instead of wget)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
cat > /etc/modules << __END__
hci_usb
hidp
ohci-hcd
rfcomm
snd-mixer-oss
snd-pcm-oss
snd-soc-neo1973-wm8753
__END__

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]

== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-19T21:57:04Z

JoSch: added console-tools

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd lenny /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* wget - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* vim (instead of vim-tiny)
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* curl (instead of wget)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync
* console-tools (chvt)

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-19T20:50:35Z

JoSch: added a few useful packages for everyday use

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd lenny /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* wget - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* vim (instead of vim-tiny)
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* curl (instead of wget)
* man-db
* rsyslog
* psmisc (killall, fuser)
* rsync

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-18T19:30:27Z

JoSch: removed apt-get update

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd lenny /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* wget - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* vim (instead of vim-tiny)
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* curl (instead of wget)
* man-db
* rsyslog

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get --yes --purge remove cdebootstrap-helper-rc.d
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-18T17:33:14Z

JoSch: bullet points

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd lenny /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime... (otherwise this is a openssh-server dependency)
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod (otherwise this is a apmd dependency)
* wget - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* vim (instead of vim-tiny)
* locale (use dpkg-reconfigure afterwards)
* less (better than more)
* curl (instead of wget)
* man-db
* rsyslog

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get update
apt-get --yes --purge remove cdebootstrap-helper-rc.d
apt-get clean
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-18T17:14:26Z

JoSch: explained choice of base packages

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,vim-tiny,module-init-tools,wget,openssh-server,screen,apmd lenny /media/card/ http://ftp.de.debian.org/debian/

justifying the included packages
* ifupdown - contains ifup, ifdown
* udev - necessary to fill /dev
* procps - contains watch, ps, kill, free, top, uptime...
* netbase - /etc/init.d/networking
* vim-tiny - we want to edit files
* module-init-tools - modprobe, lsmod, rmmod, depmod
* wget - we want to download stuff
* openssh-server - we want to connect to our device and we have enough power to not need to use dropbear
* screen - we want to operate within screen sessions so that we can disconnect or detach without problems
* apmd - suspending via apm -s

additionally interesting packages:
* nano (instead of vim-tiny) or vim
* locale (use dpkg-reconfigure afterwards)
* less
* curl (instead of wget)
* man-db
* rsyslog, hal, pm-utils

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get update
apt-get --yes --purge remove cdebootstrap-helper-rc.d
apt-get clean
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-02-17T21:53:16Z

JoSch: updated package versions

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/distro/releases/Om2008.9/Om2008.9-gta02-20081106.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.4_armel.deb
ar -x cdebootstrap-static_0.5.4_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.4_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2009.01.31_all.deb
ar -x debian-archive-keyring_2009.01.31_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2009.01.31_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get update
apt-get --yes --purge remove cdebootstrap-helper-rc.d
apt-get clean
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2009-01-30T09:24:08Z

JoSch: reverted stupid long tar arguments by Christz

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2008.04.16+nmu1_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get update
apt-get --yes --purge remove cdebootstrap-helper-rc.d
apt-get clean
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

On desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar czf sid.tar.gz sid
nc -w 10 -l -p 1234 < sid.tar.gz

On neo:

cd /media/card
nc 192.168.0.200 1234 | tar xzf -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/debootstrap --second-stage
cp /etc/resolv.conf /media/card/sid/etc

On neo edit the file <tt>/media/card/sid/etc/apt/sources.list</tt> and add the following line:

deb http://ftp.de.debian.org/debian/ sid main non-free contrib

On neo:

chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

User talk:Christz

2009-01-30T09:16:11Z

JoSch: rant about your edit

Before you edit things like: 'tar xzf' to 'tar --extract --gzip --file' in [[Manual_Debian]] use your head and think how often you rather want to type 27 letters instead of 7 in your terminal....
it is absolutely useless to write these arguments out because '''EVERYBODY''' knows what the tar arguments xzf and czf mean - oh and btw in recent versions of tar you can leave out the f parameter.
--[[User:JoSch|JoSch]] 09:16, 30 January 2009 (UTC)

Manual Debian

2008-12-29T09:33:10Z

JoSch: remove temporary files

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz debian-archive-keyring_2008.04.16+nmu1_all.deb
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get update
apt-get --yes --purge remove cdebootstrap-helper-rc.d
apt-get clean
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-28T10:10:25Z

JoSch: fixed flavour

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static --flavour=minimal --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get update
apt-get --yes --purge remove cdebootstrap-helper-rc.d
apt-get clean
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Talk:Manual Debian

2008-12-28T09:51:19Z

JoSch: cleaned and answered

== Booting ==

=== Partitions ===

Why don't we boot from NAND?
:I do - works fine--[[User:JoSch|JoSch]] 09:51, 28 December 2008 (UTC)

What's the reason for two partitions? Is it because ext2load was broken? Can we just upgrade u-boot and use one partition?
:yes, it's a uboot thingy and only valid for gta02 - just use what works for you--[[User:JoSch|JoSch]] 09:51, 28 December 2008 (UTC)

Is there any need for a swap partition?

--[[User:Brian 252|Brian 252]] 15:22, 8 August 2008 (UTC)
: [http://lists.openmoko.org/pipermail/community/2008-September/031106.html Some say] it helped. [[User:Jidanni|Jidanni]] 02:38, 3 December 2008 (UTC)

== Touch screen calibration ==

Few days ago there was added calibration for gta02. It doesn't work correctly on my freerunnuer (the mouse pointer doesn't move where I click ant the touchscreen area is about 1/3 smaller then the screen). I tried /etc/pointercal from qtopia and openmoko but it is the same as with parameters from this wiki. Has somebody a tip how to fix this?

--[[User:Jakubzeman|Jakubzeman]] 07:42, 8 August 2008 (UTC)
:works with tslib from experimental--[[User:JoSch|JoSch]] 09:51, 28 December 2008 (UTC)

== Sound ==

http://tehinterweb.com/freerunner/alsa.state.tgz --[[User:Dbmoodb|Dbmoodb]] 13:55, 21 August 2008 (UTC) (if it doesn't work for you... try these alsa states or the ones posted below from openmoko.org...)

If the sound card is configured properly but there's no sound coming out of the Freerunner, it most likely helps to restore an appropriate statefile from the tgz above which are also available on the [[Openmoko svn]] (/trunk/src/target/audio/om-gta0*).

For simple sound output to the internal stereo speakers, do:
alsactl -f /path/to/statefiles/stereoout.state restore
--[[User:Tanuva|Tanuva]] 12:59, 21 August 2008 (UTC)

== Problems Making This Work ==

I tried the instructions for loading Debian on my Freerunning and was disappointed to find it didnt work for me. I tried it twice, once with an Ext2 partition on the SDCARD and once with out, about a week ago, both gave exactly the same result. Its a very slow process too. The result when booting is that the phone brings up the openmoko logo , then a completly white screen and then goes back to the openmoko logo, it continues doing this ad-infinitum. It seems like the uboot image is wrong (=invalid) but I cant see how to fix this. Its still possible to boot original OS but via NOR screen. (Boot from card is the default now.)

Is there no chance of a binary debian image or starter image that can go into flash? I have flashed my phone many times with kernel and jffs2 images and although described as a "major" thing to do, it has always worked so far. Ive looked everywhere for a Debian image and cannot find.

Any comments appreciated.

== The above problem can be resolved as follows ==

I had the same problem, and got the hint from Julian Köpke, who suggested the following and it works.

Your uboot version is too old. You can get the newest
[http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin uboot image]
and then follow [http://wiki.openmoko.org/wiki/Flashing_the_Neo_FreeRunner#Flashing_the_boot_loader_to_the_NAND these instructions]
--[[User:Nagarjuna|Nagarjuna]] 10:14, 13 September 2008 (UTC)

Manual Debian

2008-12-28T09:04:11Z

JoSch: the content of this page is now up to date

{{Languages|Debian}}
[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static --variant=minbase --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get update
apt-get --yes --purge remove cdebootstrap-helper-rc.d
apt-get clean
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-28T08:55:24Z

JoSch: cleaned up touchscreen config with cat

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static --variant=minbase --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get update
apt-get --yes --purge remove cdebootstrap-helper-rc.d
apt-get clean
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

cat >> /etc/X11/xorg.conf << __END__
Section "InputDevice"
Identifier "Configured Touchscreen"
Driver "tslib"
Option "CorePointer" "true"
Option "SendCoreEvents" "true"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
__END__
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-28T08:50:40Z

JoSch: minimal xorg.conf

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static --variant=minbase --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get update
apt-get --yes --purge remove cdebootstrap-helper-rc.d
apt-get clean
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

cat > /etc/X11/xorg.conf << __END__
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
__END__
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-28T08:48:14Z

JoSch: cleaned up with cat

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static --variant=minbase --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
cat > /media/card/etc/network/interfaces <<__END__
auto lo
iface lo inet loopback
auto usb0
iface usb0 inet static
address 192.168.0.202
netmask 255.255.255.0
network 192.168.0.0
gateway 192.168.0.200
up echo nameserver 192.168.0.200 >/etc/resolv.conf
__END__
cat > /media/card/etc/fstab << __END__
rootfs / ext2 defaults,errors=remount-ro,noatime 0 1
proc /proc proc defaults 0 0
tmpfs /etc/network/run tmpfs defaults,noatime 0 0
tmpfs /tmp tmpfs defaults,noatime 0 0
tmpfs /var/lock tmpfs defaults,noatime 0 0
tmpfs /var/run tmpfs defaults,noatime 0 0
tmpfs /var/tmp tmpfs defaults,noatime 0 0
__END__
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config
chroot /media/card /bin/sh -e <<__END_CHROOT__
echo root: | chpasswd
apt-get update
apt-get --yes --purge remove cdebootstrap-helper-rc.d
apt-get clean
__END_CHROOT__

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-28T08:21:33Z

JoSch: make thumb

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static --variant=minbase --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext2 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
echo root: | chroot /media/card/ chpasswd
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|thumb|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-28T08:13:24Z

JoSch: permit empty passwords

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static --variant=minbase --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext2 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
echo root: | chroot /media/card/ chpasswd
sed -i 's/\(PermitEmptyPasswords\) no/\1 yes/' /media/card/etc/ssh/sshd_config

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-28T07:39:09Z

JoSch: dont forget apt-get update....

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static --variant=minbase --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext2 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
echo 'root:openmoko' | chroot /media/card/ chpasswd
== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get update
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-28T07:37:11Z

JoSch: finally touchscreen working!! \o/

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

Consider a swap partition [http://lists.openmoko.org/pipermail/community/2008-September/031106.html]
[http://lists.openmoko.org/pipermail/community/2008-October/032964.html]
mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static --variant=minbase --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext2 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
echo 'root:openmoko' | chroot /media/card/ chpasswd
== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver from debian experimental:

echo "deb http://ftp.de.debian.org/debian experimental main" >> /etc/apt/sources.list
apt-get install xserver-xorg-input-tslib/experimental

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "Device" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen

for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

for gta02:
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T15:34:54Z

JoSch: pointercal

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static --variant=minbase --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext2 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
echo 'root:openmoko' | chroot /media/card/ chpasswd
== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

apt-get install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

same goes for gta01. these parameters work at least better then nothing - plz help improving these by doing your own tests:

0 80000 -8000000 -78000 0 72000000 65536

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T15:28:41Z

JoSch: added empirical pointercal for gta01

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static --variant=minbase --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext2 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
echo 'root:openmoko' | chroot /media/card/ chpasswd
== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

apt-get install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

same goes for gta01. these parameters work at least better then nothing - plz help improving these by doing your own tests:

0 76000 -3700000 -78000 0 72000000 65536

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T14:54:50Z

JoSch: simplify install with cdebootstrap-static

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

== debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static.

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static --variant=minbase --include=ifupdown,udev,procps,netbase,nano,module-init-tools,wget,openssh-server lenny /media/card/ http://ftp.de.debian.org/debian/

== Complete debootstrap Process ==

execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext2 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
echo 'root:openmoko' | chroot /media/card/ chpasswd
== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

apt-get install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T14:20:00Z

JoSch: changed ext3 to ext2

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02, but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== (option 3) debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static. just do the "prepare sd card" steps beforehand and make sure your sd card is mounted in /media/card/. you also dont have to execute the second stage after doing cdebootstrap

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static sid /media/card/ http://ftp.de.debian.org/debian/

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: On the Freerunner one also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner) partition on which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext2 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

if you build the first stage on your host, finish the install with the second stage on the device
chroot /media/card /debootstrap/debootstrap --second-stage
execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext2 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
echo 'root:openmoko' | chroot /media/card/ chpasswd
make sure your internal clock is set to the correct date because apt-get and tar will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
apt-get install openssh-server
install and configure locales
apt-get install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
apt-get install udev

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

apt-get install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T14:13:06Z

JoSch: clean up

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2/ext3 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols and build-in ext3 support.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02 (just my expirience, it didn't detect ext3), but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== (option 3) debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static. just do the "prepare sd card" steps beforehand and make sure your sd card is mounted in /media/card/. you also dont have to execute the second stage after doing cdebootstrap

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static sid /media/card/ http://ftp.de.debian.org/debian/

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: it might be a good idea not to use ext3. This is because ext3 is a heavily journalising file system and on the freerunner (sd card) might cause premature death of the card. It is recommened you use ext2 or another similar file system. One also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner. On which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext3 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

if you build the first stage on your host, finish the install with the second stage on the device
chroot /media/card /debootstrap/debootstrap --second-stage
execute the following commands (just copypaste everything below)
echo "neo1973-debian" > /media/card/etc/hostname
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext3 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
echo 'root:openmoko' | chroot /media/card/ chpasswd
make sure your internal clock is set to the correct date because apt-get and tar will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
apt-get install openssh-server
install and configure locales
apt-get install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
apt-get install udev

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

apt-get install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T11:59:15Z

JoSch: fixed chroot

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2/ext3 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols and build-in ext3 support.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02 (just my expirience, it didn't detect ext3), but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== (option 3) debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static. just do the "prepare sd card" steps beforehand and make sure your sd card is mounted in /media/card/. you also dont have to execute the second stage after doing cdebootstrap

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static sid /media/card/ http://ftp.de.debian.org/debian/

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: it might be a good idea not to use ext3. This is because ext3 is a heavily journalising file system and on the freerunner (sd card) might cause premature death of the card. It is recommened you use ext2 or another similar file system. One also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner. On which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext3 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

if you build the first stage on your host, finish the install with the second stage on the device
chroot /media/card /debootstrap/debootstrap --second-stage
execute the following commands (just copypaste everything below)
echo "nameserver 192.168.0.200" > /media/card/etc/resolv.conf
echo "neo1973-debian" > /media/card/etc/hostname
echo "127.0.0.1 localhost.localdomain localhost neo1973-debian" > /media/card/etc/hosts
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext3 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
echo 'root:' | chroot /media/card/ chpasswd
echo "deb http://ftp.de.debian.org/debian sid main" > /media/card/etc/apt/sources.list
chroot /media/card apt-get update
chroot /media/card apt-get -y upgrade
make sure your internal clock is set to the correct date because apt-get and tar will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
apt-get install openssh-server
install and configure locales
apt-get install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
apt-get install udev

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

apt-get install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T11:44:50Z

JoSch: changed aptitude to apt-get to comply with debian lenny minimal

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2/ext3 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols and build-in ext3 support.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02 (just my expirience, it didn't detect ext3), but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== (option 3) debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static. just do the "prepare sd card" steps beforehand and make sure your sd card is mounted in /media/card/. you also dont have to execute the second stage after doing cdebootstrap

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static sid /media/card/ http://ftp.de.debian.org/debian/

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: it might be a good idea not to use ext3. This is because ext3 is a heavily journalising file system and on the freerunner (sd card) might cause premature death of the card. It is recommened you use ext2 or another similar file system. One also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner. On which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext3 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

if you build the first stage on your host, finish the install with the second stage on the device
chroot /media/card /debootstrap/debootstrap --second-stage
execute the following commands (just copypaste everything below)
echo "nameserver 192.168.0.200" > /media/card/etc/resolv.conf
echo "neo1973-debian" > /media/card/etc/hostname
echo "127.0.0.1 localhost.localdomain localhost neo1973-debian" > /media/card/etc/hosts
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext3 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
echo 'root:' | chroot /media/card/ chpasswd
echo "deb http://ftp.de.debian.org/debian sid main" > /etc/apt/sources.list
apt-get update
apt-get -y upgrade
make sure your internal clock is set to the correct date because apt-get and tar will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
apt-get install openssh-server
install and configure locales
apt-get install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
apt-get install udev

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

apt-get install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

apt-get install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

apt-get install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
apt-get clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

apt-get install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T11:42:05Z

JoSch: set root password, rearrange setup steps

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2/ext3 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols and build-in ext3 support.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02 (just my expirience, it didn't detect ext3), but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== (option 3) debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static. just do the "prepare sd card" steps beforehand and make sure your sd card is mounted in /media/card/. you also dont have to execute the second stage after doing cdebootstrap

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static sid /media/card/ http://ftp.de.debian.org/debian/

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: it might be a good idea not to use ext3. This is because ext3 is a heavily journalising file system and on the freerunner (sd card) might cause premature death of the card. It is recommened you use ext2 or another similar file system. One also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner. On which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext3 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

if you build the first stage on your host, finish the install with the second stage on the device
chroot /media/card /debootstrap/debootstrap --second-stage
execute the following commands (just copypaste everything below)
echo "nameserver 192.168.0.200" > /media/card/etc/resolv.conf
echo "neo1973-debian" > /media/card/etc/hostname
echo "127.0.0.1 localhost.localdomain localhost neo1973-debian" > /media/card/etc/hosts
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext3 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
echo 'root:' | chroot /media/card/ chpasswd
echo "deb http://ftp.de.debian.org/debian sid main" > /etc/apt/sources.list
aptitude update
aptitude -y upgrade
make sure your internal clock is set to the correct date because aptitude will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
aptitude install openssh-server
install and configure locales
aptitude install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
aptitude install udev

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

aptitude install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

aptitude install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

aptitude install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
aptitude clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

aptitude install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T11:06:18Z

JoSch: /* (option 3) debootstrap on the neo */

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2/ext3 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols and build-in ext3 support.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02 (just my expirience, it didn't detect ext3), but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== (option 3) debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static. just do the "prepare sd card" steps beforehand and make sure your sd card is mounted in /media/card/. you also dont have to execute the second stage after doing cdebootstrap

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
wget http://ftp.de.debian.org/debian/pool/main/d/debian-archive-keyring/debian-archive-keyring_2008.04.16+nmu1_all.deb
ar -x debian-archive-keyring_2008.04.16+nmu1_all.deb data.tar.gz
tar -xz -C / -f data.tar.gz
cdebootstrap-static sid /media/card/ http://ftp.de.debian.org/debian/

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: it might be a good idea not to use ext3. This is because ext3 is a heavily journalising file system and on the freerunner (sd card) might cause premature death of the card. It is recommened you use ext2 or another similar file system. One also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner. On which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext3 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

ssh to your device and execute the following commands (just copypaste everything below)

echo "nameserver 192.168.0.200" > /media/card/etc/resolv.conf
echo "neo1973-debian" > /media/card/etc/hostname
echo "127.0.0.1 localhost.localdomain localhost neo1973-debian" > /media/card/etc/hosts
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext3 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
now chroot into your armel rootfs and finish the install
chroot /media/card
/debootstrap/debootstrap --second-stage
make sure your internal clock is set to the correct date because aptitude will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
echo "deb http://ftp.de.debian.org/debian sid main" > /etc/apt/sources.list
aptitude update
aptitude upgrade
aptitude install openssh-server
install and configure locales
aptitude install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
aptitude install udev
set a root password
passwd
create a normal user
adduser <yournamehere>

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

aptitude install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

aptitude install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

aptitude install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
aptitude clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

aptitude install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T10:03:35Z

JoSch: changed hostname

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2/ext3 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols and build-in ext3 support.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02 (just my expirience, it didn't detect ext3), but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== (option 3) debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static. just do the "prepare sd card" steps beforehand and make sure your sd card is mounted in /media/card/. you also dont have to execute the second stage after doing cdebootstrap

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
cdebootstrap-static --flavour minimal sid /media/card/ http://ftp.de.debian.org/debian/

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: it might be a good idea not to use ext3. This is because ext3 is a heavily journalising file system and on the freerunner (sd card) might cause premature death of the card. It is recommened you use ext2 or another similar file system. One also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner. On which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext3 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

ssh to your device and execute the following commands (just copypaste everything below)

echo "nameserver 192.168.0.200" > /media/card/etc/resolv.conf
echo "neo1973-debian" > /media/card/etc/hostname
echo "127.0.0.1 localhost.localdomain localhost neo1973-debian" > /media/card/etc/hosts
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext3 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
now chroot into your armel rootfs and finish the install
chroot /media/card
/debootstrap/debootstrap --second-stage
make sure your internal clock is set to the correct date because aptitude will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
echo "deb http://ftp.de.debian.org/debian sid main" > /etc/apt/sources.list
aptitude update
aptitude upgrade
aptitude install openssh-server
install and configure locales
aptitude install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
aptitude install udev
set a root password
passwd
create a normal user
adduser <yournamehere>

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

aptitude install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

aptitude install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

aptitude install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
aptitude clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

aptitude install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T09:55:07Z

JoSch: /* (option 3) debootstrap on the neo */

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2/ext3 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols and build-in ext3 support.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02 (just my expirience, it didn't detect ext3), but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== (option 3) debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static. just do the "prepare sd card" steps beforehand and make sure your sd card is mounted in /media/card/. you also dont have to execute the second stage after doing cdebootstrap

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb
cdebootstrap-static --flavour minimal sid /media/card/ http://ftp.de.debian.org/debian/

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: it might be a good idea not to use ext3. This is because ext3 is a heavily journalising file system and on the freerunner (sd card) might cause premature death of the card. It is recommened you use ext2 or another similar file system. One also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner. On which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext3 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

ssh to your device and execute the following commands (just copypaste everything below)

echo "nameserver 192.168.0.200" > /media/card/etc/resolv.conf
echo "fic-gta01" > /media/card/etc/hostname
echo "127.0.0.1 localhost.localdomain localhost fic-gta01" > /media/card/etc/hosts
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext3 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
now chroot into your armel rootfs and finish the install
chroot /media/card
/debootstrap/debootstrap --second-stage
make sure your internal clock is set to the correct date because aptitude will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
echo "deb http://ftp.de.debian.org/debian sid main" > /etc/apt/sources.list
aptitude update
aptitude upgrade
aptitude install openssh-server
install and configure locales
aptitude install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
aptitude install udev
set a root password
passwd
create a normal user
adduser <yournamehere>

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

aptitude install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

aptitude install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

aptitude install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
aptitude clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

aptitude install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T09:54:47Z

JoSch: /* (option 3) debootstrap on the neo */

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2/ext3 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols and build-in ext3 support.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02 (just my expirience, it didn't detect ext3), but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== (option 3) debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static. just do the "prepare sd card" steps beforehand and make sure your sd card is mounted in /media/card/. you also dont have to execute the second stage after doing cdebootstrap

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb

cdebootstrap-static --flavour minimal sid /media/card/ http://ftp.de.debian.org/debian/

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: it might be a good idea not to use ext3. This is because ext3 is a heavily journalising file system and on the freerunner (sd card) might cause premature death of the card. It is recommened you use ext2 or another similar file system. One also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner. On which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext3 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

ssh to your device and execute the following commands (just copypaste everything below)

echo "nameserver 192.168.0.200" > /media/card/etc/resolv.conf
echo "fic-gta01" > /media/card/etc/hostname
echo "127.0.0.1 localhost.localdomain localhost fic-gta01" > /media/card/etc/hosts
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext3 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
now chroot into your armel rootfs and finish the install
chroot /media/card
/debootstrap/debootstrap --second-stage
make sure your internal clock is set to the correct date because aptitude will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
echo "deb http://ftp.de.debian.org/debian sid main" > /etc/apt/sources.list
aptitude update
aptitude upgrade
aptitude install openssh-server
install and configure locales
aptitude install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
aptitude install udev
set a root password
passwd
create a normal user
adduser <yournamehere>

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

aptitude install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

aptitude install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

aptitude install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
aptitude clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

aptitude install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T09:54:25Z

JoSch: /* (Optional) Install Known Good Kernel */

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2/ext3 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols and build-in ext3 support.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02 (just my expirience, it didn't detect ext3), but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== (option 3) debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static. just do the "prepare sd card" steps beforehand and make sure your sd card is mounted in /media/card/. you also dont have to execute the second stage after doing cdebootstrap

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb

cdebootstrap-static --flavour minimal sid /media/card/ http://ftp.de.debian.org/debian/

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: it might be a good idea not to use ext3. This is because ext3 is a heavily journalising file system and on the freerunner (sd card) might cause premature death of the card. It is recommened you use ext2 or another similar file system. One also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner. On which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext3 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

ssh to your device and execute the following commands (just copypaste everything below)

echo "nameserver 192.168.0.200" > /media/card/etc/resolv.conf
echo "fic-gta01" > /media/card/etc/hostname
echo "127.0.0.1 localhost.localdomain localhost fic-gta01" > /media/card/etc/hosts
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext3 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
now chroot into your armel rootfs and finish the install
chroot /media/card
/debootstrap/debootstrap --second-stage
make sure your internal clock is set to the correct date because aptitude will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
echo "deb http://ftp.de.debian.org/debian sid main" > /etc/apt/sources.list
aptitude update
aptitude upgrade
aptitude install openssh-server
install and configure locales
aptitude install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
aptitude install udev
set a root password
passwd
create a normal user
adduser <yournamehere>

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

aptitude install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

aptitude install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

aptitude install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
aptitude clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

aptitude install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-25T09:51:58Z

JoSch: added cdebootstrap-static instructions

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2/ext3 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols and build-in ext3 support.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02 (just my expirience, it didn't detect ext3), but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== (option 3) debootstrap on the neo ==

you can download and debootstrap natively on the neo by downloading cdebootstrap-static. just do the "prepare sd card" steps beforehand and make sure your sd card is mounted in /media/card/. you also dont have to execute the second stage after doing cdebootstrap

wget http://ftp.de.debian.org/debian/pool/main/c/cdebootstrap/cdebootstrap-static_0.5.3_armel.deb
ar -x cdebootstrap-static_0.5.3_armel.deb data.tar.gz
tar -xz -C / -f data.tar.gz
rm data.tar.gz cdebootstrap-static_0.5.3_armel.deb

cdebootstrap-static --flavour minimal sid /media/card/ http://ftp.de.debian.org/debian/

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: it might be a good idea not to use ext3. This is because ext3 is a heavily journalising file system and on the freerunner (sd card) might cause premature death of the card. It is recommened you use ext2 or another similar file system. One also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner. On which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext3 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

ssh to your device and execute the following commands (just copypaste everything below)

echo "nameserver 192.168.0.200" > /media/card/etc/resolv.conf
echo "fic-gta01" > /media/card/etc/hostname
echo "127.0.0.1 localhost.localdomain localhost fic-gta01" > /media/card/etc/hosts
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext3 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
now chroot into your armel rootfs and finish the install
chroot /media/card
/debootstrap/debootstrap --second-stage
make sure your internal clock is set to the correct date because aptitude will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
echo "deb http://ftp.de.debian.org/debian sid main" > /etc/apt/sources.list
aptitude update
aptitude upgrade
aptitude install openssh-server
install and configure locales
aptitude install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
aptitude install udev
set a root password
passwd
create a normal user
adduser <yournamehere>

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

aptitude install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

aptitude install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

aptitude install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
aptitude clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

aptitude install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-12T01:27:05Z

JoSch: added serial modem

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2/ext3 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols and build-in ext3 support.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02 (just my expirience, it didn't detect ext3), but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: it might be a good idea not to use ext3. This is because ext3 is a heavily journalising file system and on the freerunner (sd card) might cause premature death of the card. It is recommened you use ext2 or another similar file system. One also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner. On which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext3 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

ssh to your device and execute the following commands (just copypaste everything below)

echo "nameserver 192.168.0.200" > /media/card/etc/resolv.conf
echo "fic-gta01" > /media/card/etc/hostname
echo "127.0.0.1 localhost.localdomain localhost fic-gta01" > /media/card/etc/hosts
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext3 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
now chroot into your armel rootfs and finish the install
chroot /media/card
/debootstrap/debootstrap --second-stage
make sure your internal clock is set to the correct date because aptitude will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
echo "deb http://ftp.de.debian.org/debian sid main" > /etc/apt/sources.list
aptitude update
aptitude upgrade
aptitude install openssh-server
install and configure locales
aptitude install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
aptitude install udev
set a root password
passwd
create a normal user
adduser <yournamehere>

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

aptitude install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

aptitude install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

aptitude install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
aptitude clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

aptitude install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

== Enable Modem ==

Here comes the phone functionality - just add this line into the "serial devices" section in your /etc/udev/rules.d/50-udev.rules

# serial devices
KERNEL=="s3c2410_serial[0-9]", NAME="ttySAC%n"

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Manual Debian

2008-12-11T00:45:34Z

JoSch: added rotation and cursor hiding

{{Languages|Debian}}

''Contents of this page is probably old and superceded by this new pae : [[Debian]].''

[[Image:Debian.png|thumb|480px|''Debian on neo1973'']]
This page is to explain how to run Debian armel port on Openmoko devices. You can do this from scratch, or download a prebuilt file system.
The former will take some time, perhaps 2 hours, depending on your internet connection

= Prebuilt Filesystem =

Download and extract to an ext2/ext3 formatted filesystem on your SD card:

wget http://rabenfrost.net/debian/debian-armel-xfce.tar.bz2

Note that the above is just a bit too big to fit on a 512MB SD card. A smaller image will soon be provided.

Access via SSH is much the same as under other images using [[USB Networking]], with the user accounts below:

* root password: openmoko
* First user and password: openmoko

Note: If you upgrade your your debian and your touchscreen doesn't work any more, you most likely have to adjust /etc/udev/rules.d/50-udev.rules by applying the settings described later in this document for /etc/udev/udev.rules

== (Optional) Install Known Good Kernel ==

This kernel was build by Marcel_M and has some important patches in it such as removed sd debug symbols and build-in ext3 support.

wget http://rabenfrost.net/celtune/uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin
./dfu-util -d 0x1457:0x5119 -a kernel -R -D ./uImage-2.6.24+svnr4194-r4165-r3-neo1973.bin

This kernel doesn't work for gta02 (just my expirience, it didn't detect ext3), but the kernel from Om 2008.9 works good.
http://downloads.openmoko.org/releases/Om2008.9/Om2008.9-gta02-20080916.uImage.bin

== (Optional) Recompiling Kernel to Add Drivers ==
(Based on http://lists.openmoko.org/pipermail/support/2008-August/001240.html)

Steps to build the kernel standalone with the "moredrivers" config (to get additional drivers, such as the usb tether drivers that were moved out as kernel modules, compiled directly into the kernel).

~ - git clone git://git.openmoko.org/git/kernel.git linux-2.6
~ - cd linux-2.6
~ - git checkout origin/stable
~ - edit ./build to point to your compiler path
~ - cp defconfig-2.6.24 .config
~ - ./build

That gets you a uImage.bin you can DFU or copy into your SD Card filesystem.

== Configure booting from SD/SDHC ==

Do as proposed here: [[Booting_from_SD]]

Note that these instructions are in need a rewrite.

= Build your own armel filesystem =

== (Option 1) debootstrap your rootfs on Debian or Ubuntu host ==

debootstrap --verbose --arch armel --foreign sid ./armel-chroot http://ftp.de.debian.org/debian/

== (option 2) download ready to use armel rootfs ==

If you don't have debootstrap on your system you can download the results here:

wget http://rabenfrost.net/debian/armel-chroot-first-stage.tar.gz

== Prepare SD card ==

ssh to your neo and format your sd card appropriately. I'm using an 8GB SDHC card here.

:''NOTE: it might be a good idea not to use ext3. This is because ext3 is a heavily journalising file system and on the freerunner (sd card) might cause premature death of the card. It is recommened you use ext2 or another similar file system. One also will need a vfat or ext2 (only vfat worked for me with the stock u-boot for the freerunner. On which to place the kernel to boot off. See the [[Booting_from_SD]] If you have not done so already.''

fdisk /dev/mmcblk0
We will now create a 8 mb partition for our kernel and another one for the rootfs which will take up all the
remaining space.
Command (m for help): d
Selected partition 1
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 1
First cylinder (1-983, default 1):
Using default value 1
Last cylinder or +size or +sizeM or +sizeK (1-983, default 983): +8M
Command (m for help): n
Command action
e extended
p primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (18-983, default 18):
Using default value 18
Last cylinder or +size or +sizeM or +sizeK (18-983, default 983):
Using default value 983
Command (m for help): w
The partition table has been altered!
Calling ioctl() to re-read partition table.
Syncing disks.

[http://lists.openmoko.org/pipermail/community/2008-September/031106.html Consider a swap partition].

mkfs.vfat /dev/mmcblk0p1

mkfs.ext3 /dev/mmcblk0p2
mount /dev/mmcblk0p2 /media/card

copy the armel chroot to your device by tar'ing it to circumvent symbolic link cycles (https://bugzilla.mindrot.org/show_bug.cgi?id=1059 <= WONTFIX)

tar -C ./armel-chroot/ -c . | ssh root@192.168.0.202 tar -C /media/card -xv
or if you downloaded the archive

cat armel-chroot-first-stage.tar.gz | ssh root@192.168.0.202 tar -C /media/card -xzvf -

== Complete debootstrap Process ==

ssh to your device and execute the following commands (just copypaste everything below)

echo "nameserver 192.168.0.200" > /media/card/etc/resolv.conf
echo "fic-gta01" > /media/card/etc/hostname
echo "127.0.0.1 localhost.localdomain localhost fic-gta01" > /media/card/etc/hosts
echo -e "auto lo\n\
iface lo inet loopback\n\
auto usb0\n\
iface usb0 inet static\n\
address 192.168.0.202\n\
netmask 255.255.255.0\n\
network 192.168.0.0\n\
gateway 192.168.0.200\n\
up echo nameserver 192.168.0.200 >/etc/resolv.conf" > /media/card/etc/network/interfaces
echo -e "rootfs / ext3 defaults,errors=remount-ro,noatime 0 1\n\
proc /proc proc defaults 0 0\n\
tmpfs /etc/network/run tmpfs defaults,noatime 0 0\n\
tmpfs /tmp tmpfs defaults,noatime 0 0\n\
tmpfs /var/lock tmpfs defaults,noatime 0 0\n\
tmpfs /var/run tmpfs defaults,noatime 0 0\n\
tmpfs /var/tmp tmpfs defaults,noatime 0 0" > /media/card/etc/fstab
now chroot into your armel rootfs and finish the install
chroot /media/card
/debootstrap/debootstrap --second-stage
make sure your internal clock is set to the correct date because aptitude will complain if otherwise (does not work on the gta02 at the moment: "Cannot access the Hardware Clock via any known method.")
hwclock --set --date="MM/DD/YY hh:mm:ss"
install openssh so you can login remotely
echo "deb http://ftp.de.debian.org/debian sid main" > /etc/apt/sources.list
aptitude update
aptitude upgrade
aptitude install openssh-server
install and configure locales
aptitude install locales
dpkg-reconfigure locales
install udev to dynamically create /dev
aptitude install udev
set a root password
passwd
create a normal user
adduser <yournamehere>

== Get X Running ==
Now reboot and start Debian. Login with ssh and start configuring xorg:

aptitude install xorg

configure /etc/X11/xorg.conf so that it looks like this:

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
Section "Device"
Identifier "Configured Video Device"
Driver "fbdev"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
EndSection
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "Configured Mouse"
EndSection
Start X in the first vt:
startx -- vt1

== Get touchscreen working ==
Install the tslib driver:

aptitude install xserver-xorg-input-tslib

and edit the InputDevice section in your xorg.conf

Section "InputDevice"
Identifier "Configured Mouse"
Driver "tslib"
Option "CorePointer"
Option "TslibDevice" "/dev/input/event1"
Option "Protocol" "Auto"
EndSection
calibrate your touchscreen
for gta01:
echo -67 36365 -2733100 -48253 -310 45219816 65536 > /etc/pointercal

calibration for the gta02
echo -67 38667 -4954632 -51172 121 46965312 65536 > /etc/pointercal

Note from Tkrahn:

First the above calibration for gta02 worked fine for me, but after a
apt-get update && apt-get upgrade the pointer didn't follow the stylo
anymore. I needed to overwrite /etc/udev/rules.d/50-udev.rules with
/etc/udev/udev.rules.dpkg-bak and a restart of the X server to get it
moving again. But then the pointer was very far off from the tip of
the stylo. Obviously the mode how the calculation of the position worked
has changed with the upgrade. I changed the calibration empirically.
The following /etc/pointercal parameters worked for me:

0 80000 -8000000 -80500 0 74500000 65536

(On GATA02v5 after the upgrade!)

Start X and enjoy!
startx -- vt1

== Install GDM and xfce4 ==

aptitude install gdm xfce4 xvkbd

Configure gdm so xkvbd will allow you to put in your username and password. simply add this to the end of /etc/gdm/Init/Default before exit 0 so that the three last lines look like this:

fi
sleep 20 && /usr/bin/xvkbd -xdm -compact -geometry 480x210+0+0 &
exit 0

Simply click on the focus button of xvkbd and then on the input box of GDM to input your user name and password there. On each boot gdm should start automatically now.

If you like you can also download a correctly sized Debian wallpaper I generated from the SVG source for 480x640:

wget <nowiki>http://rabenfrost.net/debian/debian-blueish-wallpaper-480x640.png</nowiki> -O /usr/share/images/desktop-base/desktop-background

== Clean Up ==
aptitude clean

== Load Additional Kernel Modules ==

These are for sound, bluetooth and USB. Use the modules archive that fits to your kernel.

wget http://rabenfrost.net/celtune/modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz
tar -xf modules-2.6.24+svnr4194-r4165-r3-neo1973.tgz -C /
depmod -a
echo -e "hci_usb\n\
hidp\n\
ohci-hcd\n\
rfcomm\n\
snd-mixer-oss\n\
snd-pcm-oss\n\
snd-soc-neo1973-wm8753" > /etc/modules

Note: On the FreeRunner, the sound module (on the last line) is called snd-soc-neo1973-gta02-wm8753
[[Image:Sonata.png|480px|''Sonata on neo1973'']]
== Enable Sound ==

Now we turn our Debian into a jukebox!

aptitude install alsa-base
wget http://rabenfrost.net/celtune/alsa_state_files-working.tar.gz
tar -xf alsa_state_files-working.tar.gz -C /etc
alsactl -f /etc/alsa_state_files-working/stereoout.state restore
addgroup openmoko audio

I currently use mpd+sonata - let me know if you know another nice lightweight gtk player. Unfortunately RhythmBox is way too much for the Neo to handle - the MP3 playing stops after 20secs.

= Miscellaneous =

== Chroot installation ==

If you just want to run random debian programs without completely booting to debian you can use the following minimal steps:

on desktop:

sudo debootstrap --arch armel --foreign sid sid
sudo tar cjf sid.tar.bz2 sid
nc -w3 -lp1234 < sid-arm.tar.bz2

on neo:

cd /media/card
nc 192.168.0.200 1234 | tar -x -j -f -
mount -t none -o bind /dev /media/card/sid/dev
mount -t none -o bind /proc /media/card/sid/proc
mount -t none -o bind /sys /media/card/sid/sys
mount -t none -o bind /tmp /media/card/sid/tmp
chroot /media/card/sid /deboostrap/deboostrap --second-stage
cp /etc/resolv.conf /media/card/sid
chroot /media/card/sid apt-get update
chroot /media/card/sid apt-get install mplayer
chroot /media/card/sid mplayer http://relay.slayradio.org:8000/

== Using Xglamo on the FreeRunner ==

Copy /usr/bin/Xglamo (and /usr/bin/Xfbdev) to /usr/bin in Debian from FSO/ASU/2007.2/2008.8.

Add this to your .bashrc (to tell tslib to use the correct input device):
export TSLIB_TSDEVICE=/dev/input/event1

The X server binaries are linked against version 1 of tslib, for some reason Debian calls its version 0, even though it actually is version 1. Symlink the library to the alternative name by running (as root):
ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0

We also need to change the symlink for the X server to either Xfbdev or Xglamo (this should better be handled by update-alternatives!):
cd /usr/bin && mv X X.orig && ln -s Xfbdev X
(replace Xfbdev by Xglamo if you want to use that, Xglamo is faster, but rotation still does not work correctly as of 2008-08-12).

== Rotating screen to landscape ==

add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections to get landscape mode

Option "Rotate" "CCW"

== Hiding the cursor ==

To make the cursor invisible create a file called empty.cursor with this content:

#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

add
xsetroot -cursor empty.cursor empty.cursor

to your ~/.xinitrc

=Official Debian Port=

An official Debian port based on the FSO image is being created. First information can be found at http://wiki.debian.org/DebianOnFreeRunner. Early adopters are welcome.

[[Category:Debian]]

Distributions

2008-08-13T10:13:26Z

JoSch: Updated Debian Info

{{Languages|Distributions}}

{| class="wikitable" style="float:right;width:200px;background-color:#FF6600;text-align:center;border-collapse:collapse;font-weight:bold"
|<font color=white>Distributions</font>
|-
! style='background-color:#333333;color:#FFFFFF'|
<div align=left>
* <font color='#BBBBBB'>Openmoko (official)</font>
** [[Om 2008.8]]
** [[Om 2007.2]]
** [[Om 2007.1]]
** [[OpenmokoFramework|FSO]]
* <font color='#BBBBBB'>Community</font>
** [[SHR]]
* <font color='#BBBBBB'>Other</font>
** [[Qtopia]]
** [[Debian]]
</div>
|-
|}<noinclude>[[Category:Templates]]</noinclude>

Openmoko distributions are designed to run on various mobile devices, with the primary aim of Openmoko Inc.'s [[Neo 1973]] and [[Neo FreeRunner]] phones. They are similar to Linux distributions; complete operating systems with user applications. You can install any of them on your phone or even have a multiboot system with two distributions installed.

While the Openmoko distributions will run on [[Supported devices|other mobile devices]] too, some other software distributions will also run on the Openmoko Inc. phones (see below).

For downloads see [[Latest Images]], for installation instructions see [[Flashing the Neo FreeRunner]].

== About distributions ==

To be technically precise, 2007.2, 2008.8, FSO and SHR of these are not directly independent distributions, but different 'release targets'. They are built out of different branches of the [[OpenEmbedded]] metadistribution source tree, e.g. 2007.2 and 2008.8 are to each other like Ubuntu Gutsy is to Kubuntu Hardy.

One should only use feeds from packages of the same source-branch, else 'stuff will break', similar to like using .debs from Hardy on a Gutsy base system. Also note that there is NO supported upgrade path between these at the moment, thus updating by changing the feeds will most likely end in broken packages or even a unbootable system. Thus please always use [[dfu-util]] to switch between the different 'distributions' for now or install them in a dual-boot setup (e.g. via sdcard or NFS).

== Openmoko Inc. driven release targets ==

=== Om 2007.2 (GTK) ===

[[Om 2007.2]] is for people who are familiar with the [http://www.gnome.org/mobile/ GNOME Mobile] initiative and who want to write applications that run on multiple devices running (parts of) GNOME Mobile. This includes Maemo, which runs on the Nokia Internet Tablets. The strength of the GTK+ stack is a UI and programming environment similar to what you run on your Linux desktop, if you’re into GNOME. The GTK+ has PIM applications based on the Evolution Data Server and runs the gsmd phone server. Although you can use them, the applications are still pretty rough und unfinished. Some people have problems with the stability of the phone server.

* [[Om 2007.2]]
* Availabilty: [http://buildhost.openmoko.org/daily/ Official Buildhost] and [[MokoMakefile]] support for development builds
* Download: [http://buildhost.openmoko.org/daily/freerunner/ Releases are labeled "openmoko-devel-image" ]
* Several videos of this stack by [http://uk.youtube.com/user/freeyourphone Youtube user freeyourphone] and [http://uk.youtube.com/watch?v=U05kZfURPig&NR=1 video review by BVB Tech]
This is the base-system which is installed on Freerunner when it leaves the factory.

2007.2 development driven by openmoko inc. has basically stopped and resources are allocated in favor of 2008.8, while the community currently does the effort to 'rescue' the 2007.2 telephony apps and pull them to the future middleware from FSO (see SHR).
thus patches are still welcome, especially if they help development of SHR.

=== Om 2008.8 (ASU, April/August Software Update) ===

Om 2008.8 has been started to integrate the [http://trolltech.com/products/qtopia Qtopia] stack - on X11 - with a new set of graphically pleasing applications based on the Enlightenment Foundation Libraries. ASU is the internal name and is known as Om 2008.8 upon its release on August 8, 2008. Qtopia is a more mature product than the GNOME Mobile stack and you can expect all the standard feature phone applications to work in a solid way. It uses the Qtopia phone server. Since - contrary to standard Qtopia - it does not directly use the framebuffer, non-Qt applications can safely share the screen with Qt applications.

* [[Om2008.8|Om 2008.8]]
* Download: [http://downloads.openmoko.org/releases/Om2008.8/ Releases are labeled "Om2008.8" ]

=== FSO - freesmartphone.org ===

FSO has been started to overcome the deficiencies both of the 2007.2 and the 2008.8 stack, namely to come up with an extensible framework that gives developers the infrastructure they need to create solid and exciting software products based on the Openmoko platform. An infrastructure that supports competing UIs while we can collaborate on developing services, making the framework strong . Here, the focus is on stable highlevel services that you can access from whatever language or UI that supports [http://dbus.freesmartphone.org/ dbus]. People report that despite its infancy, e.g. the phone server part in FSO is already more solid than anywhere else.

It is not really intended as future release-target, but used as a 'vessel' or 'container' for the development and testing of the new, future middleware.<br>
The applications installed are intended as test-tools for the new middleware and not as fully featured, end user oriented applications. (even if it looks that way sometimes)

* [[FSO]]
* [http://trac.freesmartphone.org:8000/trac-example Development tracker]
* [http://downloads.openmoko.org/framework/milestone2/ Download milestone 2]
* [http://freesmartphone.org freesmartphone.org]

== Openmoko Community driven release targets ==

=== SHR - Stable Hybrid Release ===

Stable Hybrid Release is a combination of the middleware from FSO, some of the 2007.2 GTK software (telephony-ui, pim), and Om2008.8 that provides all of the functionality of the 2007.2 software, but with the stability of the FSO.

* [[Stable Hybrid Release]]

== Non-Openmoko distributions ==

These are not Openmoko (and OE) based distributions. These are an alternatives you can run on your Openmoko phones.

=== Qtopia ===

The Qtopia distribution from [http://www.trolltech.com Trolltech], it aims to provide a ready-to use image for Openmoko devices.

* [[Qtopia]]
* Download: [http://www.qtopia.net/modules/mydownloads/viewcat.php?cid=6 Qtopia.net]

=== Debian ===

Debian Linux, the whole distribution, on a mobile phone.

* [[Debian]]

== Features by distribution/release target ==

=== Connectivity ===

{| border=1 width=100% |
| width=14%| || width=14%|2007.2 || width=14%|FSO || width=14%|Om2008.8 || width=14%|SHR || width=14%|Qtopia || Debian
|-
| Telephony || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || N/A || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes
|-
| SMS || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || N/A || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes
|-
| GPRS || Not through UI || Not through UI || Not through UI || N/A || No (3) || style="background:lightgreen;" | Yes
|-
| WiFi || style="background:lightgreen;" | Yes || Not through UI || style="background:lightgreen;" | Yes (*) || N/A || style="background:lightgreen;" | Yes ||style="background:lightgreen;" | Yes
|-
| VoIP || ?? || ?? || ?? || ?? || ?? || style="background:lightgreen;" | Yes
|-
| Bluetooth || style="background:lightgreen;" | Yes || No || style="background:lightgreen;" | Yes || N/A || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes
|-
| GPS || style="background:lightgreen;" | Yes (1) || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes (1) || N/A || No || style="background:lightgreen;" | Yes
|-
|}

=== User Interaction ===

{| border=1 width=100% |
| width=14%| || width=14%|2007.2 || width=14%|FSO || width=14%|Om2008.8 || width=14%|SHR || width=14%|Qtopia || Debian
|-
| Stylus friendly || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || N/A || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes
|-
| Finger friendly || Partially || Partially || Partially || N/A || style="background:lightgreen;" | Yes || No
|-
| Accelerometer || No || No || No || N/A || No || No
|-
|}

=== Applications ===

{| border=1 width=100% |
| width=14%| || width=14%|2007.2 || width=14%|FSO || width=14%|Om2008.8 || width=14%|SHR || width=14%|Qtopia || Debian
|-
| Terminal || Basic (2) || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes (1) || N/A || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes
|-
| PIM || style="background:lightgreen;" | Yes || No || style="background:lightgreen;" | Yes || N/A || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes
|-
| Phonebook || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || N/A || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes
|-
| Dialer || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || N/A || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes
|-
| Web Browser || style="background:lightgreen;" | Yes (1) || ? || style="background:lightgreen;" | Yes (1) || ? || No || style="background:lightgreen;" | Yes
|-
| Mail Client || ? || ? || ? || ? || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes
|-
| XMPP Client || style="background:lightgreen;" | Yes (1) || ? || ? || ? || No || style="background:lightgreen;" | Yes
|-
|}

=== Toolkits / Runtimes ===
{| border=1 width=100% |
| width=14%| || width=14%|2007.2 || width=14%|FSO || width=14%|Om2008.8 || width=14%|SHR || width=14%|Qtopia || Debian
|-
| GTK+ || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || No || style="background:lightgreen;" | Yes
|-
| QT/Qtopia || No || style="background:lightgreen;" | Yes? || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes? || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes
|-
| Middleware || gsmd/neod || freesmartphone.org || qtopia-x11 || freesmartphone.org || qtopia || freesmartphone.org
|-
| [[Java]] || Jalimo || ? || ? || ? || ? || style="background:lightgreen;" | Yes
|-
| [[Python]] || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes || ? || style="background:lightgreen;" | Yes || style="background:lightgreen;" | Yes
|-
|}

Footnotes:

(1) works, but need additional software to be installed

(2) unusable due to lack of certain keyboard characters (unless you [[Switching_Keyboards#Matchbox_keyboard|install matchbox-keyboard]])

(3) there is a UI but it crashes the device when used.

(*) unstable
== External links ==

Original distribution descriptions are from Mickey Lauer's [http://www.vanille-media.de/site/index.php/2008/06/28/gtk-asu-fso-tmtla/ GTK, ASU, FSO, TMTLA!].

[[Category:Distributions| ]]
[[Category:Documentation]]

Mokopedia

2008-07-25T16:44:15Z

JoSch: heavy update

[[Image:Mokopedia_main.png|thumb|480px|''Mokopedia running on Openmoko'']]

for more info visit the official website: http://mokopedia.mister-muffin.de/

join our irc channel on freenode: #mokopedia

This project aims to provide software to create and use small size wikipedia dumps for embedded Linux devices.

All Wikipedia pages will be stripped down html files compressed in a squashfs lzma image.

It's the goal to make ALL the articles (except images) of Wikipedia (including formatting, linking, tables, formulas) fit on very little space.

Tests show that the German Wikipedia will be around 1.3GB and the English Wikipedia around 4GB so with flash storage prices dropping I will not bother removing certain articles - the dumps will include everything.

= development status =

some people are already running the new mokopedia on their freerunners but i wont announce any official info until enwiki isnt done so up to now there are only dewiki and others that are possible to use.

I you are interested to get it running on you freerunner join our irc channel and i will explain the few steps you have to take.

In the near feature there will be ipkgs for everything.

= to everybody thas was familiar with the old implementation =

There is no lighty needed anymore - i now implement the server in a simple python script.

Now we have FULLTEXT search - yeah you hear right. a fulltext search through 6.8 GB of dewiki is possible in mere 20 seconds on the neo1973.

Now there are also a lot of things already implemented as ipkg - only the server is left but will follow soon.

[[Category:Applications]]