Configure SHR for German-speaking use
From Openmoko
Contents |
News
2009-09-01 | first version with austrian stuff, and focus on everyday usability |
2009-09-12 | based on SHR unstable, and with opkg upgrade support |
2009-10-03 | Cannot satisfy the following dependencies ... libfso-glib0, that is an SHR issue, i hope it will be fixed soon |
2009-10-03 | moved name of page to "German", lots of docu updates, new images uploaded |
2009-10-14 | now with brand new SHR logo (I think I am the first to use it) |
2009-10-18 | geocaching added, it doesn't work too good, so don't expect too much :-) |
2009-10-25 | geocaching now sets route-target in agtl and also in navit, and you can drive with navit to the cache |
2009-11-15 | in a few days i will switch to new (mrmoku)-unstable, with lots of fixes. watch for it here. work has already startet |
2009-11-19 | As of TODAY!!! there is a new version of SHR-unstable out, but this package is still working |
Reminder
Please dont just edit away things without discussion. thanks. --zoff99 17:04, 2 November 2009 (UTC)
Overview, what is this page???
This article focuses on configuring SHR(-unstable) image for a daily use in a german speaking area. the author is Austrian so the main focus is on Austrian use. with help of other users it is also useable for germany, switzerland.
to-do:
- get more feedback from people !!!
- get some of this stuff into main SHR branch
focus points (some are not provided by out-of-the-box SHR):
- GTA02 (sorry i dont have a GTA01)
- stable use as daily phone (calls, sms)
- keep install and use as simple as possbile
- keep reboot and crash frequency at 1/per day maximum (meaning only have to reboot once a day at most!)
- stable use as navigation device in german-speaking area, with understandable german speech
- only need to recharge once a day (meaning battery should hold 1 day in normal use)
- prevent neo usage from driving you crazy, because some litte things just don't work
- have all show-off and games stuff removed (it's fun for a while, but just a waste for everyday use)
Installing
- have at least 1,5 hours of time ready, for the whole procedure
- have fast internet, you need to download lots of stuff
Downloading Bootloader, Kernel, Root Image
- download exactly these versions of SHR from z0ph
1. [1] qi boot loader (~30 KB)
2. [2] kernel (kernöl ~2 MB)
3. [3] root image (~70 MB)
These are the original names of the files:
qi-s3c2442-1.0.2+gitr3b8513d8b3d9615ebda605de4bda18371aa3f359.udfu # 09-May-2009 13:23 28K
shr-lite-glibc-ipk--20090906-om-gta02.rootfs.jffs2 # 06-Sep-2009 14:08 67M
uImage-2.6.29-oe11+gitr119844+a3587e4ed77974adfb057af261aaeea4022018e8-r3.5-om-gta02.bin # 01-Sep-2009 23:13 1.7M
Flashing Neo
- flash qi, kernel and root image to your neo (i tested this on GTA02v6). Detailed instructions for Freerunner
The installation should be flashing like (do it in DFU mode of NOR u-boot):
dfu-util -a u-boot -R -D qi.udfu dfu-util -a kernel -R -D uImage.bin dfu-util -a rootfs -R -D rootfs.jffs2
NOTE:
i have found that (against what others say!) using the NAND for root-fs is the fastest and most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt. |
if you have an SD-card with ext2/ext3 partitions (this step is optional)
You can also use an ext2 / ext3 partition for this customization, so this step should not be neccessary.
Maybe you installed other Distributions on your OpenMoko before and you have EXT2 or EXT3 partition on you SD card and want FAT partition, then install dosfstools on your Neo to have mkfs.vfat available.
opkg install dosfstools
Format SD card (resp. partition) if and only if the format is not FAT and you want a FAT partition on your SD card.
mkfs.vfat -v -n maps-data /dev/mmcblk0p1
Startup
- boot up your neo, and let it run until you are logged in to your GSM net
on 1st boot, when asked choose:
<== put nice screenshots here ==>
Language --> choose: english --> press next Profile --> choose: Illume SHR --> pres next Menus --> choose: System Default --> pres next Quick Launch --> check NO box !! --> pres next Ok :-)
- then shutdown the neo (press and hold power button for a few seconds)
- boot up your neo again, and let the neo log in to your GSM network again.
Customization Package
Preparing your SD card (you need to do this!)
login to your neo as root and make the base dir
cd /media/card mkdir "____shr_testing"
download customize pack without navit maps and transfer this file to your Freerunner via sftp.
customize pack without maps (17 MBytes)
Or use wget from your neo if you have internet connection (e.g. via USB established)
cd /media/card/____shr_testing wget http://work.zoff.cc/openmoko/shr/de_at/customize_pack_shr_no_maps.tar.gz # 17 MBytes
Unpack Customization Pack
transfer the customize pack to your SD-Card (to /media/card/____shr_testing/) then login to your neo as root
cd /media/card/____shr_testing/ gzip -d customize_pack_shr_no_maps.tar.gz tar -xf customize_pack_shr_no_maps.tar
login to your neo as root to download (or update!!) the austrian map file do (you need fast internet on your neo):
cd /media/card/____shr_testing/navit/ ./get_austria.map.sh # this will download about 350 MBytes!!
for germany:
cd /media/card/____shr_testing/navit/ ./get_germany.map.sh # this will download about 380 MBytes!!
for switzerland:
cd /media/card/____shr_testing/navit/ ./get_germany.map.sh # this will download about 80 MBytes!!
or to download your map manually, visit:
http://maps.navit-project.org/download/
and put the bin-file in this directory /media/card/____shr_testing/navit/ and navit will use it automatically
or have a look at some preconfigured downloads:
http://maps.navit-project.org/api/map/
at the moment you can have ONLY 1 .bin map file in that directory. so if you already have the german map file and want the austrian map file, you have to delete one of them. it's a navit bug.
If you want to use other types of maps you must edit the navit.xml file. For further information see http://wiki.navit-project.org/index.php/Configuring_Navit
_privat-Folder in Customization Pack (this step is optional)
The privat folder can contain privat data with an addressbook that you want to copy to
/home/root/.evolution/addressbook/local/system (not implemented yet)
or calendar data to
/home/root/.evolution/calendar/local/system/calendar.ics (not implemented yet)
or an modified navit-files (e.g. navit.xml or bookmark.txt, destinations.txt) that you want to replace with the existing files in:
/home/root/.navit/
or the AGPS-account details. So that you can use and restore these files after flashing your phone or checking other distributions and going back to SHR. View the init_shr_testing.sh and search for _PRIVATE_ in the script for further details. For copying files that are not used in the script, write your own small script as a post-installation script that copies all the relevant data from _privat to the correct location on your FR.
Localize it
upadate package index info (this is important!!)
- start (as root on your neo):
cd /etc/opkg/ for i in *.conf ; do cat $i|sed -e 's#shr-unstable#shr-obsolete#g' > ${i}_X ; mv ${i}_X ${i} ;done
Run init_shr_testing.sh script
- you NEED internet on your neo for this, otherwise dependent packages can't be downloaded
- start (as root on your neo):
cd /media/card/____shr_testing/ ./init_shr_testing.sh
- this will take some time !! have coffee ready :-)
- wait for the customize script to finish
- now at least reboot 1 time (better 2 times)
- [UG1] now start (also as root on your neo):
mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy Display enabled opkg update opkg remove -force-depends libfso-glib0 mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy Display enabled opkg install http://build.shr-project.org/shr-unstable/ipk/armv4t/libfso-glib0_0.2.1+gitr47+7608c8d98bb65bb5beca6621eb86920b71df1bc9-r0_armv4t.ipk mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy Display enabled opkg upgrade -force-defaults
- [UG2] when finished start as root:
cd /media/card/____shr_testing/ ./do_upgrade_shr.sh
- hopefully no errors have occured
Test it
- reboot your neo, and let the neo login to your GSM network
- now navit should have austrian maps, and speak in german to you :-)
- you can suspend/resume anytime! even when navit is speaking! yeah really, it works
- date and time should also be correct
- press AUX button quick and zedlock should come up, draw a big "Z" to unlock again
- hold POWER button for 2 seconds, and neo will shutdown
- if shutdown with POWER button fails, go to illume home screen, pull down the menu and press the big red "X", a menu should appear
Test it (german)
- Navit sollte alles in deutsch anzeigen, österreichkarten laden und vor allem der Neo sollte beim Laufen von Navit nicht blanken oder suspenden.
Startup Times
0:00 | press button to boot neo |
0:17 | splash logo visible |
1:29 | enlightenment splash screen visible |
2:02 | illume topshelf visible |
2:28 | illume desktop icons visible |
3:34 | GSM logged in |
those times seem pretty catastrophic in comparison to a normal mobile phone
yet for the neo they are really not so bad :-)
Screenshots
Feedback
- please give some feedback
Features
Installed Programs
- German keyboard, with German dictionary (word list)
- Gridpad keyboard, bubble-keyboard, literki-keyboard, qwo-keyboard (if you want this you can set it in the enlightenment config "wrench" under Keyboard section)
- Cellhunter
on first start choose language (german i guess), then enter name and password. can be anything, and you really don't need to remember it later. if you can't get AGPS working where you are, just wait for a GPS fix and upload that data to cellhunter. now you can instantly use it for AGPS, isn't that nice ...
- GPSagps
refresh agps data from u-blox.com (and cellhunter), you need an account there (its free)
you can configure it in /etc/agps-online.conf
sample /etc/agps-online.conf:
[config] user=XX@YY.com password=mypassword
- Htop
- Midori
small webbrowser, usable but not really the best
-
Moko...
mokomaze, you might know it from some mobile phones
- Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
Navit version from SVN. it shows full austria,german und switzerland map. speaks to you in german. it takes almost all CPU you have, so don't push it too far. otherwise it works very well.
- Settings
shr-settings from SHR. runs really fine. I just made some small changes
- Terminal
valaterm
- Water
Water level
- agpsUI
use this great program ONLY as a last resort. it does NOT play well together with FSO and frameworkd
- Intone...
Intone music player. put your music files in /media/card/music/ directory
- zedlock (no icon, use AUX button)
great screen locker. draw a big "Z" on the screen in 1 second to unlock screen
- gpe-scap (no icons, only command line)
login via ssh to your neo. start
export DISPLAY=:0 ; gpe-scap
on commandline to make a screenshot.
- sms-sentry (no icon, send sms)
Send sms with text "sentry<passwd>:location" to your neo, and get an sms with current position back. default passwd is '12345'. you can confiure it in /etc/sms-sentry
sample /etc/sms-sentry:
[config] password=54321