Kustomizer

Revision as of 02:08, 6 February 2009

Languages:

English • العربية • Български • Česky • Dansk • Deutsch • Esperanto • Eesti • Español • فارسی • Suomi • Français • עברית • Magyar • Italiano • 한국어 • Nederlands • ‪Norsk (bokmål)‬ • Polski • Português • Română • Русский • Svenska • Slovenčina • Українська • ‪中文(中国大陆)‬ • ‪中文(台灣)‬ • Euskara • Català

2009-02-06 version 0.2 released. GSM works again. Many fixes done - now Kustomizer can give you two different configurations, see here. Changelog and test run log
2009-02-02 First release. In this release GSM didn't work :(

The first time you run Kustomizer, it installes opkg.org repository, Illume-theme and terminal keyboard, files for better call audio quality, xterm. Also a CPU resource bug is fixed (qpe). A restart is required for this to take effect and Kustomizer will do this for you. The second run will install the rest: applications, GPRS, link map direcories from µSD card, mokoservices and tap/untap etc. You don't have to make the second run if you don't want.

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.

Questions and comments can be sent to Risto H. Kurppa ( risto at kurppa dot fi ) or to the community list, see mailing lists.

Warnings

Screenshot of the installation screen

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 - don't forget to backup.. 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.

## ON DESKTOP COMPUTER (written for Ubuntu 8.10 and newer)

## Prepare your memory card

Here are some things you can put on your µSD card that will be mounted to /media/card. If you don't have these, it's OK.

 * /m/c/customscript - your own script that will be run in the end. You can write here all your custom requirements, I added the Finnish keyboard and some handy scripts, see http://kurppa.fi/freerunner/customscript
 * /m/c/Maps will be symlinked from /home/root/Maps. You can put your Openstreetmap map tiles there: TangoGPS uses this
 * /m/c/Maps/navit/europe.navit.bin will be used by Navit, preconfigured to do so
 * /m/c/Maps/navit/bookmarks.txt and destinations.txt will be copied to /home/root/.navit. These are the bookmarks and destinations for Navit

## REQUIRED PACKAGES
# install required packages:
# a) run: sudo apt-get install dfu-util bind9 
# dfu-util is also available from http://downloads.openmoko.org/releases/Om2008.9/dfu-util

## FLASH
# for more details, see http://wiki.openmoko.org/wiki/Flashing_the_Neo_Freerunner
# download the required image files
# b) run: 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
# c) Connect your freerunner to the computer with the USB cable
# d) start your Freerunner holding the AUX button down to get to the NOR menu
# e) run: sudo time dfu-util -a kernel -R -D Om2008.12-om-gta02.uImage.bin
# f) run: sudo time dfu-util -a rootfs -R -D Om2008.12-om-gta02.rootfs.jffs2
# g) Start & restart Freerunner to be able to log in over USB ssh
# h) Go to 'Settings' and change 'Suspend' to 'off' or Freerunner will suspend and the installation will fail.

## CONNECT
# Connect over usb-ssh with shared internet connection
# Don't run the script on Freerunner's screen! It can be done but not recommended if you don't know what you're doing.
# Download a script to help you & change the permission
# i) run: wget http://www.kurppa.fi/freerunner/fr_bind && chmod 755 fr_bind
# j) run: ./fr_bind
# k) First it asks for your Ubuntu -password to restart the interface & bind9 - type it in
# l) After this it asks for Freerunner password - it's empty, just hit Enter 
# For more details check http://wiki.openmoko.org/wiki/Usb_networking#Ubuntu_8.10_-_Easy_Way

## FREERUNNER
# 1) Make sure you've turned 'Suspend' to 'off' in the Settings.
# 2) Make sure you can SSH in over USB so that Freerunner has Internet connection (ping google.com?)
# 3) run: http://www.kurppa.fi/freerunner/kustomizer && chmod 755 kustomizer
# 4) run: ./kustomizer
# On the first run it will install some stuff and then restart (to stop the qpe-bug). Then you need to repeat 2) and 4) and  it'll install the rest

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

What does it do?

You can run Kustomizer once or twice. Here's an explanation what happens:

First run

   * illume-theme
   * terminal keyboard
   * wrench & qwerty buttons
   * opkg.org repository added
   * qpe eating CPU resources -bug fix
   * new gsmhandset.state for improved audio quality
   * Restart to apply the new settings

Second run

   * Linking /home/root/Maps to /media/card/Maps
   * Loads of coolest applications & libraries
   * GPRS settings
   * Freerunner-optimized Navit config XML. Preconfigured to use the map or Europe in /media/card/Maps/navit/europe.navit.bin
   * Your custom script from /media/card/customscript will be run, if found. See example
   * Restart to apply the new settings

Applications

Here's a list of applications installed. All might not be included.

Applications / Internet

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

Applications / GPS

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

Applications / Config

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

Applications / Games

   * OpenTTD
   * Duke3D
   * Numptyphysics
   * OpenMooCow
   * ScummVM
   * Pong
   * XScat
   * Liquidwar
   * Moko-eightball
   * Ko-Dice

Applications / Misc

   * Bunch of required libraries
   * MokoConv
   * Gwaterpas
   * Neon
   * Meooem
   * Mokox48 calculator
   * Ledclock
   * Qwo -keyboard
   * Mtpaint
   * Vala-terminal
   * Fbreader
   * Openmoko-mediaplayer
   * 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.

Development version: http://kurppa.fi/freerunner/kustomizer_devel Development install log: http://kurppa.fi/freerunner/kustomizer_devel_log_20090202.txt

Bug tracker can be found in the talk page: http://wiki.openmoko.org/wiki/Talk:Kustomizer

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

# Version 0.2 - 2008-02-06
# CHANGELOG IN THIS VERSION
# (new) two run system:
# 1st run: illume-theme, wrench, qwerty are installed, opkg.org, storage.conf/qpe-bug fixed. Then restarted
# 2nd run: user needs to start Kustomizer again (and switch suspend/dim off!!) -> the rest is installed
# Rewriting the instructions
# General cleaning
# (new) ntpclient 
# (new) http://www.opkg.org/package_121.html - MokoMaze
# (new) ttf-liberation-mono (vala-terminal uses this)
# (new) battery http://wiki.openmoko.org/wiki/Forcing_fast_charge_mode
# (new) runs /media/card/customscript - the user can add his own stuff there
# (new) automatic prevention of suspend & dimming
# (update) yaouh - version update
# (update) neon - version update
# (remove) Finnish keyboard layout & dictionary
# (remove) custom scripts from card
# (remove) cellhunter - on FSO-based only?
# (remove) Guitartune - on FSO-based only and libfft fails to install
# (remove) fourier - libfft fails to install
# (remove) zomg and appmanager - less used..
# (remove) pingus - doesn't install
# (remove) mumpot - useless for most
# (remove) usbmode - battery replaces most of this
# (fix) watch checkrate changed from 1s to 2s
# (fix) libglade-2.0 -> libglade-2.0-0

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. TODO is in the file itself

@@ Line 1: / Line 1: @@
 {{Languages|Kustomizer}}
-Released 2009-02-02 and for sure has some bugs and could be done better so be careful when running - but it still might make your life a little easier :)!
+* '''2009-02-06''' [http://risto.kurppa.fi/blog/kustomizer-02-for-200812/ version 0.2 released]. GSM works again. Many fixes done - now Kustomizer can give you two different configurations, see [[Kustomizer#What_does_it_do.3F|here]]. [[Kustomizer#Changelog|Changelog]] and [http://kurppa.fi/freerunner/kustomizer_files/kustomizer_0.2_log_20090206.txt test run log]
+* '''2009-02-02''' [http://risto.kurppa.fi/blog/kustomizer-for-openmoko-200812/ First release]. In this release GSM didn't work :(
-''You've been warned!''
 === Description ===
-[[Image:Kustomizer-home.png|thumb|Home view]]Kustomizer is a script that converts your clean OM 2008.12 installation on Openmoko Freerunner into a usable pda/toy/something. '''At the moment there's something wrong with the GSM that doesn't connect at all!'''
+[[Image:Kustomizer-home.png|thumb|Home view]]Kustomizer is a script that converts your clean OM 2008.12 installation on Openmoko Freerunner into a usable phone/pda/toy/something.
-The script is licensed with GPLv2 licence. The applications that it installs around the Net might have other licences, check the original sites for more information.
+The script is licensed with GPLv2 licence. The applications that it installs around the Net might have other licenses, check the original sites for more information.
-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 :)
+The first time you run Kustomizer, it installes opkg.org repository, Illume-theme and terminal keyboard, files for better call audio quality, xterm. Also a CPU resource bug is fixed (qpe). A restart is required for this to take effect and Kustomizer will do this for you.
+The second run will install the rest: applications, GPRS, link map direcories from µSD card, mokoservices and tap/untap etc. You don't have to make the second run if you don't want.
 Originally it was written to make it easy to try some apps after a clean installation for opkg.org application tests ([http://risto.kurppa.fi/blog/opkgorg-software-test-part-i/ review part one], [http://risto.kurppa.fi/blog/opkgorg-software-review-part-2/ 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 [http://risto.kurppa.fi/blog Risto H. Kurppa] ( risto at kurppa dot fi ) or at community list, see [[Development_resources#Mailing_Lists|mailing lists]].
+Questions and comments can be sent to [http://risto.kurppa.fi/blog Risto H. Kurppa] ( risto at kurppa dot fi ) or to the community list, see [[Development_resources#Mailing_Lists|mailing lists]].
-Kustomizer also released in [http://lists.openmoko.org/pipermail/community/2009-February/041167.html Community mailing list] and at the [http://risto.kurppa.fi/blog/kustomizer-for-openmoko-200812 author's blog]
 === Warnings ===
@@ Line 22: / Line 21: @@
 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!!!
+Make sure there's nothing too important on your memory card or flash memory - don't forget to backup..
 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.
@@ Line 34: / Line 33: @@
   ## ON DESKTOP COMPUTER (written for Ubuntu 8.10 and newer)
-  ## PREPARE
+  ## Prepare your memory card
+Here are some things you can put on your µSD card that will be mounted to /media/card. If you don't have these, it's OK.
+  * /m/c/customscript - your own script that will be run in the end. You can write here all your custom requirements, I added the Finnish keyboard and some handy scripts, see http://kurppa.fi/freerunner/customscript
+  * /m/c/Maps will be symlinked from /home/root/Maps. You can put your Openstreetmap map tiles there: TangoGPS uses this
+  * /m/c/Maps/navit/europe.navit.bin will be used by Navit, preconfigured to do so
+  * /m/c/Maps/navit/bookmarks.txt and destinations.txt will be copied to /home/root/.navit. These are the bookmarks and destinations for Navit
+ ## REQUIRED PACKAGES
   # install required packages:
   # a) run: sudo apt-get install dfu-util bind9
@@ Line 70: / Line 76: @@
 === 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.
+You can run Kustomizer once or twice. Here's an explanation what happens:
-Fixes & things
+==== First run ====
-     * Prevents gpe from scanning your µSD card (this uses all CPU power..)
+     * illume-theme
-     * Illume-theme & Raster's keyboard with disabled dropshadow
+     * terminal keyboard
-     * Wrench & QWERTY buttons
+     * wrench & qwerty buttons
-     * Opkg.org repository added
+     * opkg.org repository added
-     * Finnish/Swedish Illume keyboard layout and Finnish dictionary
+     * qpe eating CPU resources -bug fix
+    * new gsmhandset.state for improved audio quality
+    * Restart to apply the new settings
+==== Second run ====
+    * Linking /home/root/Maps to /media/card/Maps
+    * Loads of coolest applications & libraries
      * 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
+    * Your custom script from /media/card/customscript will be run, if found. See [http://kurppa.fi/freerunner/customscript example]
+    * Restart to apply the new settings
-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.
+==== Applications ====
+Here's a list of applications installed. All might not be included.
-    * /m/c/scripts.tar.gz - your own scripts that will be extracted to /home/root/scripts. This will directory 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
@@ Line 106: / Line 116: @@
      * GPSdcontrol
      * Orrery
-    * Mumpot
      * TangoGPS
@@ Line 113: / Line 122: @@
      * Mokoservices
      * Modified .Tap/Untap
-    * ZOMG
      * ShortOM
      * Usbmode
-    * AppManager
      * Sortdesk
@@ Line 126: / Line 133: @@
      * OpenMooCow
      * ScummVM
-    * XMahjongg
-    * Pingus
      * Pong
      * XScat
      * Liquidwar
-    * Cellhunter
-    * Xlogical
      * Moko-eightball
      * Ko-Dice
@@ Line 139: / Line 142: @@
      * Bunch of required libraries
-    * Fourier
-    * Remoko
-    * Guitartune
      * MokoConv
      * Gwaterpas
@@ Line 153: / Line 153: @@
      * Fbreader
      * Openmoko-mediaplayer
-    * Omoney
      * Ffalarms
@@ Line 167: / Line 166: @@
 === Changelog ===
-Check the script file itself.
+ # Version 0.2 - 2008-02-06
+ # CHANGELOG IN THIS VERSION
+ # (new) two run system:
+ # 1st run: illume-theme, wrench, qwerty are installed, opkg.org, storage.conf/qpe-bug fixed. Then restarted
+ # 2nd run: user needs to start Kustomizer again (and switch suspend/dim off!!) -> the rest is installed
+ # Rewriting the instructions
+ # General cleaning
+ # (new) ntpclient
+ # (new) http://www.opkg.org/package_121.html - MokoMaze
+ # (new) ttf-liberation-mono (vala-terminal uses this)
+ # (new) battery http://wiki.openmoko.org/wiki/Forcing_fast_charge_mode
+ # (new) runs /media/card/customscript - the user can add his own stuff there
+ # (new) automatic prevention of suspend & dimming
+ # (update) yaouh - version update
+ # (update) neon - version update
+ # (remove) Finnish keyboard layout & dictionary
+ # (remove) custom scripts from card
+ # (remove) cellhunter - on FSO-based only?
+ # (remove) Guitartune - on FSO-based only and libfft fails to install
+ # (remove) fourier - libfft fails to install
+ # (remove) zomg and appmanager - less used..
+ # (remove) pingus - doesn't install
+ # (remove) mumpot - useless for most
+ # (remove) usbmode - battery replaces most of this
+ # (fix) watch checkrate changed from 1s to 2s
+ # (fix) libglade-2.0 -> libglade-2.0-0
 === 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. TODO is in the file itself

Kustomizer

From Openmoko

Revision as of 02:08, 6 February 2009

Contents

Description

Warnings

Usage

What does it do?

First run

Second run

Applications

Development

Changelog

Roadmap

Views

Personal tools

Description

Warnings

Usage

What does it do?

Development

Changelog

Roadmap

Search

Tools