important things
================

write program to shutdown neo if battery is too low and the system is
not charging.

things that would be interesting but are not critical
=====================================================

* make it easy to add voice comments to gps logs

* figure out nice way to use right mouse button

* depends on above. work on power consumption, arm slow mode

* get time from GSM network, compare against gsm chip time, rtc
 'You can also get the time from the cell tower. It is called "Network Operator Time".'

dbus-monitor: how to see return values?

boring things that should eventually be done
============================================

* make backups anacron-style
* how to make syslog use proper hostname? adding it to /etc/hosts, how exactly?
* how to make usb keyboard events wake up backlight?
* how to unsuspend freerunner remotely if it's in suspend but connected to PC?
* suggest setting mic2 volume to 3 by default but check if it causes problems

done
====

* figure out why matchbox-keyboard repeats some keys (especially enter
  after typing "ps axuf"). FIXED: xorg seems to do the repeating, see
  bug report.


things that would be nice but are not important
===============================================

uboot: add energy percentage and charge rate display


urls
====

http://wiki.debian.org/DebianOnFreeRunner

http://wiki.openmoko.org/wiki/Debian

http://wiki.debian.org/pkg-fso

http://pkg-fso.alioth.debian.org/freerunner/install.txt.gismo

http://pkg-fso.alioth.debian.org/debian 

git.debian.org, under pkg-fso

http://pkg-fso.alioth.debian.org/xglamo-beta

http://lists.openmoko.org/pipermail/devel/2008-August/001176.html

pkg-fso-maint@lists.alioth.debian.org

http://trac.freesmartphone.org/query?reporter=%7Etimo.lindfors%40iki.fi&reporter=%7E&order=priority

http://pkg-fso.alioth.debian.org/freerunner/install.sh


things to do after install
==========================

* apmd (but kill the daemon?)
  wireless-tools dhcp3-client
  tangogps (for dbus?)
  rsync
  xglamo binary
   ln -s /usr/lib/libts-0.0.so.0 /usr/lib/libts-1.0.so.0
   ln -sf /root/Xglamo /etc/X11/X
   export TSLIB_TSDEVICE=/dev/input/event1 to /etc/init.d/zhone-session
  screen
  busybox
  triplane
  zile
  ppp
  strace
  fso-gpsd
  (was gpsd)
  reportbug
   X-Debbugs-Cc: pkg-fso-maint@lists.alioth.debian.org
  libfakekey-dev
  libgtk2.0-dev
  darcs
  gcc
  make
  tangogps
  mplayer

* dd if=/dev/mmcblk0 of=/root/mbr.backup bs=512 count=1

usb keyboard with xorg
======================

* apt-get install xserver-xorg-input-evdev

* add the following to /etc/X11/xorg.conf

Section "InputDevice"
        Identifier      "Generic Keyboard"
        Driver          "evdev"
        Option          "CoreKeyboard"
        Option          "Device"        "/dev/input/event5"
        Option          "XkbRules"      "xorg"
        Option          "XkbModel"      "pc104"
        Option          "XkbLayout"     "fi"
EndSection

* modprobe ohci-hcd

* use the followings script to switch to host mode

#!/bin/sh
ifconfig usb0 down
echo "host" > /sys/devices/platform/s3c2410-ohci/usb_mode
echo "1" > /sys/devices/platform/neo1973-pm-host.0/hostmode
echo "USB host mode. Hit enter to return to device mode."
read
echo "0" > /sys/devices/platform/neo1973-pm-host.0/hostmode
echo "device" > /sys/devices/platform/s3c2410-ohci/usb_mode
ifconfig usb0 up
ifconfig
ifconfig usb0 10.168.0.202

* restart X or it won't see the keyboard

Section "Device"
        Identifier      "Configured Video Device"
        Driver          "fbdev"
        Option          "Rotate"        "CW"
EndSection


debugging example: fbdev
=========================

* see http://wiki.debian.org/DebianOnFreeRunner for qemubuilder setup
  but use ~/.pbuilderrc instead of "armel-rc" for shorter commands

* sudo qemubuilder --login --save-after-login

echo deb-src http://apt-proxy.kurp.hut.fi:9999/debian/ unstable main >> /etc/apt/sources.list
apt-get update
apt-get build-dep xserver-xorg-video-fbdev
DEB_BUILD_OPTIONS="nostrip debug noopt" apt-get --build source xserver-xorg-video-fbdev
netcat the binary to freerunner

* on freerunner start

gdb --args X :0 vt4

* "break FBDevPointerMoved":

Function "FBDevPointerMoved" not defined.
Make breakpoint pending on future shared library load? (y or [n]) y

* "continue"

debugging example: python zhone
===============================

debian-gta02:~# DISPLAY=:0 python -m pdb /usr/bin/zhone
--Return--
> /usr/lib/python2.5/encodings/__init__.py(68)normalize_encoding()->'utf8'
-> return '_'.join(encoding.translate(_norm_encoding_map).split())
(Pdb) cont
Traceback (most recent call last):
  File "/var/lib/python-support/python2.5/dbus/connection.py", line 578, in msg_reply_handler
    reply_handler(*message.get_args_list(**get_args_opts))
  File "/usr/bin/zhone", line 396, in cbMessagebookReply
    self.updateList()
  File "/usr/bin/zhone", line 453, in updateList
    main_text = self.main.groups["contacts"].tryNumberToName( self.current[i][2] )
  File "/usr/bin/zhone", line 677, in tryNumberToName
    if self.comparePhoneNumber(self.phonebook[i][2], number):
  File "/usr/bin/zhone", line 670, in comparePhoneNumber
    if number1[0] == number2[0] == '+':
IndexError: string index out of range

The program finished and will be restarted
--Return--
> /usr/lib/python2.5/codecs.py(366)__init__()->None
-> self.linebuffer = None
(Pdb) import pdb
(Pdb) pdb.pm()
> /usr/bin/zhone(670)comparePhoneNumber()
-> if number1[0] == number2[0] == '+':
(Pdb) p number1
u'+XXXXXXXXXXXX'
(Pdb) p number2
u''
(Pdb)


good to know
============

* test number 0800770215

dbus
====

* talk AT:

$ cli-framework
>>> gsmdebug.DebugCommand("at+clir?\r\n")
dbus.Array([dbus.String(u'+CLIR: 0,4'), dbus.String(u'OK')], signature=dbus.Signature('s'))

* command GSM from cli:

$ cli-framework
sim = bus.get_object("org.freesmartphone.ogsmd", "/org/freesmartphone/GSM/Device");
sim.SendAuthCode("..") 
sim.Register()
>>> gsm.GetAuthStatus()
dbus.String(u'SIM PIN')

* sniff the bus: append to /etc/dbus-1/system-local.conf

<!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
 "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
<busconfig>
  <policy user="bin">
    <allow eavesdrop="true"/>
  </policy>
</busconfig>

  and use

su bin -c "dbus-monitor --system"

* see battery status

mdbus -s org.freesmartphone.frameworkd /org/freesmartphone/Device/PowerSupply/bat org.freesmartphone.Device.PowerSupply.GetEnergyPercentage





uboot
=====

git clone git://git.openmoko.org/git/u-boot

ringtone
========

http://iki.fi/lindi/openmoko/ringtone/

accessories
===========

http://www.dealextreme.com/details.dx/sku.688
USB Car Adapter $2.58

http://www.dealextreme.com/details.dx/sku.3060
Rechargeable USB Emergency Power Backup Pack 2400mAh $14.43

http://www.dealextreme.com/details.dx/sku.733
2.5mm to 3.5mm Audio Cable

xf86-video-glamo
================

git clone git://git.openmoko.org/git/xf86-video-glamo.git
cd xf86-video-glamo
autoreconf -i
./configure
make

contact: Lars-Peter Clausen <lars@metafoo.de>