Kustomizer

From Openmoko

Revision as of 14:23, 2 February 2009 by Rhk (Talk | contribs)

Jump to: navigation, search


Contents

Description

Kustomizer is a GPLv2 -licensed script that converts your Openmoko phone with OM 2008.12 distribution into a usable phone/pda/toy/something. It installs apps from the default repositories as well as from opkg.org and some other sources across the Internet. Some would call the result a new distribution, to me it's just 2008.12 + some apps the script installs. You decide :)

Originally it was written to make it easy to try some apps after a clean installation for opkg.org application tests (review part one, review part two) and 'recover' easily after that but in the end it became a script that might be useful for others, too.

Any questions can be sent to Risto H. Kurppa ( risto at kurppa dot fi ) or at community list, see mailing lists.

Warnings

If you have some issues (WSOD / BSOD / wlan connecting only once / etc) with 2008.12 this will not fix those!

Make sure there's nothing too important on your memory card or flash memory!! - BACKUPS!!! Installing 2008.12 will wipe the rootfs partition (=all your data in the phone excl. memory card) but tries to leave you memory card alone.

It's more or less all the time under development and not very throughly tested so you might have to do some manual work after the installation to get everything up and running. Some packages fail to install for mysterious reasons (segfault, missing dependencies, md5sum mismatch, ...).

Usage

Script is available at http://www.kurppa.fi/freerunner/kustomizer

Here's the instructions what to do on your desktop to flash to 2008.12 and then what to do on Freerunner (over SSH!) to run the script.

#####################################################3
## ON DESKTOP COMPUTER (written for Ubuntu 8.10 and newer)
#####################################################3
sudo apt-get install dfu-util bind9 // dfu-util also available from http://downloads.openmoko.org/releases/Om2008.9/dfu-util
wget http://downloads.openmoko.org/releases/Om2008.12/Om2008.12-om-gta02.uImage.bin & wget http://downloads.openmoko.org/releases/Om2008.12/Om2008.12-om-gta02.rootfs.jffs2
#Connect your freerunner to the computer with the USB cable
#start your Freerunner holding the AUX button down to get to the NOR menu
#these two take about 8-12 minutes
sudo time dfu-util -a kernel -R -D Om2008.12-om-gta02.uImage.bin
sudo time dfu-util -a rootfs -R -D Om2008.12-om-gta02.rootfs.jffs2
#start & restart Freerunner to be able to log in over USB ssh
#connect over usb-ssh with shared internet connection
#YOU WANT TO DO THIS SO THAT YOU CAN SCROLL AND SAVE THE LOG TO CHECK FOR ERRORS!!
wget http://www.kurppa.fi/freerunner/fr_bind && chmod 755 fr_bind
 ./fr_bind
# First it asks for your Ubuntu -password to restart the interface & bind9
# After this it asks for Freerunner password - just hit Enter there, it's empty.
#####################################################
## ON FREERUNNER
#####################################################
In Settings -tool set 'Suspend' to 'off' or Freerunner will suspend and the installation will fail.
Now you should be able to run this script from the command line on Freerunner. DO IT OVER SSH so that you can see the installation log also after the installation has finished!
wget http://www.kurppa.fi/freerunner/kustomizer && chmod 755 kustomizer && ./kustomizer

Let the author ( risto at kurppa dot fi ) know how did it go! You might not receive any help but it helps to develope the script further. If possible, please attach the log.

What does it do?

Here are some things it does. It doesn't include all and some might be listed here that for some reason are not included at the moment.

Fixes & things

   * Prevents gpe from scanning your µSD card (this uses all CPU power..)
   * Illume-theme & Raster's keyboard with disabled dropshadow
   * Wrench & QWERTY buttons
   * Opkg.org repository added
   * Finnish/Swedish Illume keyboard layout and Finnish dictionary
   * GPRS settings
   * Fixed gsmhandset.state
   * Freerunner-optimized Navit config XML. Preconfigured to use the map or Europe in /media/card/Maps/navit/europe.navit.bin

Things that will be installed from your µSD card in /media/card. If these don't exist, it's okay, they'll just then not be available for you to use.

   * /m/c/scripts.tar.gz - your own scripts to /home/root/scripts. This will be added to the path (in /etc/profile)
   * /m/c/Maps will be symlinked from /home/root/Maps
   * /m/c/Maps/navit/europe.navit.bin preconfigured in Navit config
   * /m/c/Maps/navit/bookmarks.txt and destinations.txt copied to /home/root/.navit

Applications / Internet

   * Midori
   * Minimo
   * Dillo-ssl
   * CenterIM
   * Pidgin
   * Wireshark

Applications / GPS

   * Navit
   * GPSsight
   * Yaouh
   * GPSdcontrol
   * Orrery
   * Mumpot
   * TangoGPS

Applications / Config

   * Mokoservices
   * Modified .Tap/Untap
   * ZOMG
   * ShortOM
   * Usbmode
   * AppManager
   * Sortdesk

Applications / Games

   * OpenTTD
   * Duke3D
   * Numptyphysics
   * OpenMooCow
   * ScummVM
   * XMahjongg
   * Pingus
   * Pong
   * XScat
   * Liquidwar
   * Cellhunter
   * Xlogical
   * Moko-eightball
   * Ko-Dice

Applications / Misc

   * Bunch of required libraries
   * Fourier
   * Remoko
   * Guitartune
   * MokoConv
   * Gwaterpas
   * Neon
   * Meooem
   * Mokox48 calculator
   * Ledclock
   * Qwo -keyboard
   * Mtpaint
   * Vala-terminal
   * Fbreader
   * Openmoko-mediaplayer
   * Omoney
   * Ffalarms

Development

If you have some ideas of improvements please let the author know (see above). I'm not planning to create rootfs images or anything huge but there are some things that I'd like to see kustomizer do. Check the script for the current TODO.

At the moment the most important things to fix are:

  1. Disable suspend in the beginning of the installation!!! (HOW TO DO THIS??!!!)
  2. Sortdesk forces meooem and gpsdcontrol icons to be global or they don't work -> FAIL
  3. Problems with some random packages - install fails.. segfault, md5sum mismatch, not found..
  4. Get rid of qpe without an error message on Freerunner screen

If someone is interested and willing to work on this please contact Risto H. Kurppa ( risto at kurppa dot fi ). Moving to projects.openmoko is possible.

Changelog

At the moment there isn't one, you better check the file itself. I should start using bazaar..

Roadmap

  • copy all the cool features from other distros and best apps from opkg.org :) No.. There's no roadmap. Fix things when they break or something.
Personal tools


Description

Kustomizer is a GPLv2 -licensed script that converts your Openmoko phone with OM 2008.12 distribution into a usable phone/pda/toy/something. It installs apps from the default repositories as well as from opkg.org and some other sources across the Internet. Some would call the result a new distribution, to me it's just 2008.12 + some apps the script installs. You decide :)

Originally it was written to make it easy to try some apps after a clean installation for opkg.org application tests (review part one, review part two) and 'recover' easily after that but in the end it became a script that might be useful for others, too.

Any questions can be sent to Risto H. Kurppa ( risto at kurppa dot fi ) or at community list, see mailing lists.

Warnings

If you have some issues (WSOD / BSOD / wlan connecting only once / etc) with 2008.12 this will not fix those!

Make sure there's nothing too important on your memory card or flash memory!! - BACKUPS!!! Installing 2008.12 will wipe the rootfs partition (=all your data in the phone excl. memory card) but tries to leave you memory card alone.

It's more or less all the time under development and not very throughly tested so you might have to do some manual work after the installation to get everything up and running. Some packages fail to install for mysterious reasons (segfault, missing dependencies, md5sum mismatch, ...).

Usage

Script is available at http://www.kurppa.fi/freerunner/kustomizer

Here's the instructions what to do on your desktop to flash to 2008.12 and then what to do on Freerunner (over SSH!) to run the script.

#####################################################3
## ON DESKTOP COMPUTER (written for Ubuntu 8.10 and newer)
#####################################################3
sudo apt-get install dfu-util bind9 // dfu-util also available from http://downloads.openmoko.org/releases/Om2008.9/dfu-util
wget http://downloads.openmoko.org/releases/Om2008.12/Om2008.12-om-gta02.uImage.bin & wget http://downloads.openmoko.org/releases/Om2008.12/Om2008.12-om-gta02.rootfs.jffs2
#Connect your freerunner to the computer with the USB cable
#start your Freerunner holding the AUX button down to get to the NOR menu
#these two take about 8-12 minutes
sudo time dfu-util -a kernel -R -D Om2008.12-om-gta02.uImage.bin
sudo time dfu-util -a rootfs -R -D Om2008.12-om-gta02.rootfs.jffs2
#start & restart Freerunner to be able to log in over USB ssh
#connect over usb-ssh with shared internet connection
#YOU WANT TO DO THIS SO THAT YOU CAN SCROLL AND SAVE THE LOG TO CHECK FOR ERRORS!!
wget http://www.kurppa.fi/freerunner/fr_bind && chmod 755 fr_bind
 ./fr_bind
# First it asks for your Ubuntu -password to restart the interface & bind9
# After this it asks for Freerunner password - just hit Enter there, it's empty.
#####################################################
## ON FREERUNNER
#####################################################
In Settings -tool set 'Suspend' to 'off' or Freerunner will suspend and the installation will fail.
Now you should be able to run this script from the command line on Freerunner. DO IT OVER SSH so that you can see the installation log also after the installation has finished!
wget http://www.kurppa.fi/freerunner/kustomizer && chmod 755 kustomizer && ./kustomizer

Let the author ( risto at kurppa dot fi ) know how did it go! You might not receive any help but it helps to develope the script further. If possible, please attach the log.

What does it do?

Here are some things it does. It doesn't include all and some might be listed here that for some reason are not included at the moment.

Fixes & things

   * Prevents gpe from scanning your µSD card (this uses all CPU power..)
   * Illume-theme & Raster's keyboard with disabled dropshadow
   * Wrench & QWERTY buttons
   * Opkg.org repository added
   * Finnish/Swedish Illume keyboard layout and Finnish dictionary
   * GPRS settings
   * Fixed gsmhandset.state
   * Freerunner-optimized Navit config XML. Preconfigured to use the map or Europe in /media/card/Maps/navit/europe.navit.bin

Things that will be installed from your µSD card in /media/card. If these don't exist, it's okay, they'll just then not be available for you to use.

   * /m/c/scripts.tar.gz - your own scripts to /home/root/scripts. This will be added to the path (in /etc/profile)
   * /m/c/Maps will be symlinked from /home/root/Maps
   * /m/c/Maps/navit/europe.navit.bin preconfigured in Navit config
   * /m/c/Maps/navit/bookmarks.txt and destinations.txt copied to /home/root/.navit

Applications / Internet

   * Midori
   * Minimo
   * Dillo-ssl
   * CenterIM
   * Pidgin
   * Wireshark

Applications / GPS

   * Navit
   * GPSsight
   * Yaouh
   * GPSdcontrol
   * Orrery
   * Mumpot
   * TangoGPS

Applications / Config

   * Mokoservices
   * Modified .Tap/Untap
   * ZOMG
   * ShortOM
   * Usbmode
   * AppManager
   * Sortdesk

Applications / Games

   * OpenTTD
   * Duke3D
   * Numptyphysics
   * OpenMooCow
   * ScummVM
   * XMahjongg
   * Pingus
   * Pong
   * XScat
   * Liquidwar
   * Cellhunter
   * Xlogical
   * Moko-eightball
   * Ko-Dice

Applications / Misc

   * Bunch of required libraries
   * Fourier
   * Remoko
   * Guitartune
   * MokoConv
   * Gwaterpas
   * Neon
   * Meooem
   * Mokox48 calculator
   * Ledclock
   * Qwo -keyboard
   * Mtpaint
   * Vala-terminal
   * Fbreader
   * Openmoko-mediaplayer
   * Omoney
   * Ffalarms

Development

If you have some ideas of improvements please let the author know (see above). I'm not planning to create rootfs images or anything huge but there are some things that I'd like to see kustomizer do. Check the script for the current TODO.

At the moment the most important things to fix are:

  1. Disable suspend in the beginning of the installation!!! (HOW TO DO THIS??!!!)
  2. Sortdesk forces meooem and gpsdcontrol icons to be global or they don't work -> FAIL
  3. Problems with some random packages - install fails.. segfault, md5sum mismatch, not found..
  4. Get rid of qpe without an error message on Freerunner screen

If someone is interested and willing to work on this please contact Risto H. Kurppa ( risto at kurppa dot fi ). Moving to projects.openmoko is possible.

Changelog

At the moment there isn't one, you better check the file itself. I should start using bazaar..

Roadmap

  • copy all the cool features from other distros and best apps from opkg.org :) No.. There's no roadmap. Fix things when they break or something.