Openmoko - User contributions [en]

Talk:Configure SHR for German-speaking use

2010-06-17T07:42:55Z

Zoff99: /* Feedback */

Talk:Configure SHR for German-speaking use

2010-06-17T07:42:19Z

Zoff99: /* Feedback */

Talk:Configure SHR for German-speaking use

2010-06-11T08:45:31Z

Zoff99: /* Feedback */

<H1>please sign your feedback, thanks !!!!!!!!!</H1>

== Feedback ==

great work. It would be nice if the script for downloading germany.bin can be added and the dictionary setting de_AT resp. de_DE be an option during installation, so that only one script for Germany Language use can be maintained instead of one for Austria (dictionary de_AT) and one for Germany (dictionary setting de_DE). Maybe the heading could be change to German Language Use later.

--[[User:Niebert|Niebert]] 07:40, 27 September 2009 (UTC)

i'll do that if 1 of 2 things happen:

a) many people use this (for 2 users its too much to do)

or

b) someone (you?) help me

--[[User:Zoff99|zoff99]] 12:04, 3 October 2009 (UTC)

* mdbus warnings
Yeah, great work! Thanks for doing this and writing this guide! It worked flawlessly for me. I guess the following warnings can be safely ignored?

after
mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy Display enabled
I got
Using **pending_return in dbus_connection_send_with_reply_setup() without pending_setup is deprecated and strongly discouraged
Using **pending_return in dbus_connection_send_with_reply_setup() without pending_setup is deprecated and strongly discouraged
Using **pending_return in dbus_connection_send_with_reply_setup() without pending_setup is deprecated and strongly discouraged
Using **pending_return in dbus_connection_send_with_reply_setup() without pending_setup is deprecated and strongly discouraged
Service name not found

Thanks again!

--[[User:Guido|Guido]] 22:09, 5 October 2009 (UTC)

yeah those warnings are normal, and can be ignored
but "Service name not found" should not normally happen. when did it occur?

--[[User:Zoff99|zoff99]] 10:06, 6 October 2009 (UTC)

In Section "Preselected country in Navit", if you want to set to 'de_DE', shouldn't you edit "/media/card/____shr_testing/navit/navit.sh" instead of "/usr/bin/navit.sh"? As far as I can see there's even no "/media/card/____shr_testing/usr/bin/navit.sh".

I got a lot of error messages when starting ./init_shr_testing.sh:
-./init_shr_testing.sh: line 45: mdbus: not found
- Installing eet (2:1.1.0+svnr41040-r2) to root...
Collected errors:
* check_data_file_clashes: Package eet wants to install file /usr/lib/libeet.so.1
But that file is already provided by package * check_data_file_clashes: libeet1
* opkg_install_cmd: Cannot install package eet.
* check_data_file_clashes: Package eet wants to install file /usr/lib/libeet.so.1
But that file is already provided by package * check_data_file_clashes: libeet1
* opkg_install_cmd: Cannot install package eet-tests.
- Configuring ecore-job.
Collected errors:
* check_data_file_clashes: Package eet wants to install file /usr/lib/libeet.so.1
But that file is already provided by package * check_data_file_clashes: libeet1
* opkg_install_cmd: Cannot install package bubble-keyboard.
- Configuring libimlib2-loaders.
Collected errors:
* check_data_file_clashes: Package bzip2 wants to install file /usr/lib/libbz2.so.1
But that file is already provided by package * check_data_file_clashes: libbz2-1
* check_data_file_clashes: Package bzip2 wants to install file /usr/lib/libbz2.so.1.0
But that file is already provided by package * check_data_file_clashes: libbz2-1
* opkg_install_cmd: Cannot install package qwo.
- ./init_shr_testing.sh: line 204: mdbus: not found
- ./init_shr_testing.sh: line 237: mdbus: not found
- Not downgrading package fsoraw on root from 1:1.0.0+gitr4+38d52c14a09dd7afc22048f2ed278e336f42a933-r2.0.4 to 0.01a+svn13-r1.
- Package mokomaze (0.5.5+git8-r2.4) installed in root is up to date.
Collected errors:
* print_dependents_warning: Package mokomaze is depended upon by packages:
* print_dependents_warning: task-shr-games
* print_dependents_warning: These might cease to work if package mokomaze is removed.

* print_dependents_warning: Force removal of this package with --force-depends.
* print_dependents_warning: Force removal of this package and its dependents
* print_dependents_warning: with --force-removal-of-dependent-packages.
- ./init_shr_testing.sh: line 296: mdbus: not found
- Configuring localedef.
Collected errors:
* opkg_install_cmd: Cannot install package espeak-locale.
* opkg_install_cmd: Cannot install package flite-locale.
* opkg_install_cmd: Cannot install package fso-sounds-locale.
* check_data_file_clashes: Package gconf-dbus wants to install file /usr/libexec/gconfd-2
But that file is already provided by package * check_data_file_clashes: gconf
* check_data_file_clashes: Package gconf-dbus wants to install file /usr/bin/gconftool-2
But that file is already provided by package * check_data_file_clashes: gconf
* check_data_file_clashes: Package gconf-dbus wants to install file /usr/bin/gconf-merge-tree
But that file is already provided by package * check_data_file_clashes: gconf
* check_data_file_clashes: Package gconf-dbus wants to install file /usr/lib/libgconf-2.so.4
But that file is already provided by package * check_data_file_clashes: gconf
* check_data_file_clashes: Package gconf-dbus wants to install file /etc/gconf/2/path
But that file is already provided by package * check_data_file_clashes: gconf
* opkg_install_cmd: Cannot install package gconf-dbus-locale-de.
* satisfy_dependencies_for: Cannot satisfy the following dependencies for glibc-locale-locale.alias:
* virtual-locale-locale.alias *
- Configuring libwebkit-1.0-2.
Collected errors:
* check_data_file_clashes: Package gst-plugins-base wants to install file /usr/lib/libgstpbutils-0.10.so.0
But that file is already provided by package * check_data_file_clashes: libgstpbutils-0.10-0
* check_data_file_clashes: Package gst-plugins-base wants to install file /usr/lib/libgstrtp-0.10.so.0
But that file is already provided by package * check_data_file_clashes: libgstrtp-0.10-0
* check_data_file_clashes: Package gst-plugins-base wants to install file /usr/lib/libgstnetbuffer-0.10.so.0
But that file is already provided by package * check_data_file_clashes: libgstnetbuffer-0.10-0
* check_data_file_clashes: Package gst-plugins-base wants to install file /usr/lib/libgstinterfaces-0.10.so.0
But that file is already provided by package * check_data_file_clashes: libgstinterfaces-0.10-0
* check_data_file_clashes: Package gst-plugins-base wants to install file /usr/lib/libgsttag-0.10.so.0
But that file is already provided by package * check_data_file_clashes: libgsttag-0.10-0
* check_data_file_clashes: Package gst-plugins-base wants to install file /usr/lib/libgstaudio-0.10.so.0
But that file is already provided by package * check_data_file_clashes: libgstaudio-0.10-0
* check_data_file_clashes: Package gst-plugins-base wants to install file /usr/lib/libgstvideo-0.10.so.0
But that file is already provided by package * check_data_file_clashes: libgstvideo-0.10-0
* opkg_install_cmd: Cannot install package midori.
- Configuring midori-locale-de.

cp: cannot stat '/media/card/____shr_testing//midori/config/speeddial.json': Path has non-directory component
- Configuring cellhunter.

cp: cannot stat '/media/card/____shr_testing//.cellhunter.conf': No such file or directory
- Configuring gnome-vfs.
Collected errors:
* check_data_file_clashes: Package gconf-dbus wants to install file /usr/libexec/gconfd-2
But that file is already provided by package * check_data_file_clashes: gconf
* check_data_file_clashes: Package gconf-dbus wants to install file /usr/bin/gconftool-2
But that file is already provided by package * check_data_file_clashes: gconf
* check_data_file_clashes: Package gconf-dbus wants to install file /usr/bin/gconf-merge-tree
But that file is already provided by package * check_data_file_clashes: gconf
* check_data_file_clashes: Package gconf-dbus wants to install file /usr/lib/libgconf-2.so.4
But that file is already provided by package * check_data_file_clashes: gconf
* check_data_file_clashes: Package gconf-dbus wants to install file /etc/gconf/2/path
But that file is already provided by package * check_data_file_clashes: gconf
* opkg_install_cmd: Cannot install package rsvg.
- Configuring ncurses-terminfo.
Collected errors:
* check_data_file_clashes: Package e2fsprogs-libs wants to install file /usr/bin/mk_cmds
But that file is already provided by package * check_data_file_clashes: e2fsprogs
* check_data_file_clashes: Package e2fsprogs-libs wants to install file /usr/bin/compile_et
But that file is already provided by package * check_data_file_clashes: e2fsprogs
* check_data_file_clashes: Package e2fsprogs-libs wants to install file /usr/lib/libuuid.so.1
But that file is already provided by package * check_data_file_clashes: libuuid1
* check_data_file_clashes: Package e2fsprogs-libs wants to install file /usr/lib/libcom_err.so.2
But that file is already provided by package * check_data_file_clashes: libcom-err2
* check_data_file_clashes: Package e2fsprogs-libs wants to install file /usr/lib/libblkid.so.1
But that file is already provided by package * check_data_file_clashes: libblkid1
* check_data_file_clashes: Package e2fsprogs-libs wants to install file /usr/lib/libss.so.2
But that file is already provided by package * check_data_file_clashes: libss2
* check_data_file_clashes: Package e2fsprogs-libs wants to install file /usr/lib/libcom_err.so.2.1
But that file is already provided by package * check_data_file_clashes: libcom-err2
* check_data_file_clashes: Package e2fsprogs-libs wants to install file /usr/lib/libss.so.2.0
But that file is already provided by package * check_data_file_clashes: libss2
* opkg_install_cmd: Cannot install package mc.
- cp: cannot stat '/media/card/____shr_testing//shr_settings/gprs.pickle': No such file or directory

cp: cannot stat '/media/card/____shr_testing//a-gps/etc_agps-online.conf': No such file or directory
- cp: cannot stat '/media/card/____shr_testing//etc_sms-sentry.conf': No such file or directory
- Configuring python-html.
Collected errors:
* check_data_file_clashes: Package python-misc wants to install file /usr/lib/python2.6/ssl.pyo
But that file is already provided by package * check_data_file_clashes: python-io
* check_data_file_clashes: Package python-misc wants to install file /usr/lib/python2.6/ssl.py
But that file is already provided by package * check_data_file_clashes: python-io
* opkg_install_cmd: Cannot install package advancedcaching.
rm: /home/root/Maps/OSM: is a directory
rmdir: '/home/root/Maps': Directory not empty

cp: cannot stat '/media/card/____shr_testing//geocaching/config': No such file or directory
cp: cannot stat '/media/card/____shr_testing/geocaching/simplegui.py': No such file or directory
cp: cannot stat '/media/card/____shr_testing/geocaching/geocaching.py': No such file or directory
- rm: cannot remove 'illume-shr': No such file or directory

May I ignore these messages? Or will I have a corrupted System?
btw: I'm running SHR-U (http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz - 09-Jun-2010 10:21, 76M) on uSD.

--ChrisPZV 10 June 2010 (UTC)

Hi Chris!

this will NOT work with current SHR distros!!!
if you really want to use this, download exactly those files which are listed on my page.
as far as new SHR distro, I can only say its so unstable and slow, i dont use it anymore.

cheers,
Zoff.

--[[User:Zoff99|zoff99]] 08:45, 11 June 2010 (UTC)

== Problem using settings ==

great work.
but i've 2 problems(?)
First:
Using Settings:
Using:
Settings => Power => Please wait... Loading 4 modules

That's all. No more action. It is only possible to kill the settings-process.
One time after the first update it works. But after the next reboot settings doesn't work any more.
Can anyone help me, to fix this problem ?

Second:
I got the error message:
Service name not found
too. (After using: mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy Display enabled)

Many thanks.
Andre

--[[User:Steigera|Steigera]] 09:47, 18 October 2009 (UTC)

did you do update & upgrade also? if not, do so

and did you start settings right after boot-up? because frameworkd is really really slow, and needs a couple of minutes to have everything loaded.

if that does not help start "shr-settings" on the ssh-console and put the output here

--[[User:Zoff99|zoff99]] 11:17, 18 October 2009 (UTC)

yes. I've tried to use settings very fast after boot-up.
Now after some minutes it works :-)).
Thanks for your fast response.
But another question: it is a little bit extensive to modify the power-settings after every boot-up.
e.g: Backlight
Is there a possibility to modify these settings so it will be used after next boot-up ?

--[[User:Steigera|Steigera]] 18 October 2009 (UTC)

'''PLEASE use the "sign" button when writing here!!'''

sure there is a way, write a script with "mdbus -s XXX YYY" and put it somewhere after system startup.

--[[User:Zoff99|zoff99]] 17:08, 18 October 2009 (UTC)

== What do you think about ==

#install German
opkg list_installed | cut -d " " -f1 | grep -v "kernel-module"> /tmp/opkgi.txt
opkg list | cut -d " " -f1 | grep -v "kernel-module"> /tmp/opkg.txt
grep locale-de /tmp/opkg.txt > /tmp/opkg_de.txt
grep i18n /tmp/opkg.txt >> /tmp/opkg_de.txt
for ip in $(cat /tmp/opkgi.txt)
do
prog=$(grep $ip /tmp/opkg_de.txt)
if [ $prog ]
then
echo found $prog
install="$install $prog"
fi
done
opkg install $install

this installs to all installed packed the locale-de package, if found

--[[User:Bertol|Bertol]] 14:40, 29 November 2009

i dont think its too good.
for example when you install german locale for "ls, cp" you get weird german messages from your shell commands. also the phone GUIs (call, messages, etc.) are really strange in german (and sometimes translation is just wrong)

--[[User:Zoff99|zoff99]] 14:10, 29 November 2009 (UTC)

Configure SHR for German-speaking use

2010-03-06T20:09:47Z

Zoff99: /* Download the Navit Maps */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|zoff99]] 17:04, 2 November 2009 (UTC)

== looking for the NEW SHR unstable ==
if u feel lucky go to this page
[[Configure_SHR_for_German-speaking_use_UPDATE_2]]

but beware, it could crash or worse (you have been warned)

--[[User:Zoff99|zoff99]] 16:24, 9 December 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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

on 1st boot, when asked choose (see images above):

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Download Customization Pack WITHOUT Maps for Navit===
* login as root an run
cd /media/card/____shr_testing
wget http://work.zoff.cc/openmoko/shr/de_at/customize_pack_shr_no_maps.tar.gz # 22 MBytes

===Unpack Customization Pack===
* 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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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/maps/
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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

=== Preselected country in [[Navit]] ===
With the current installation you will get Austria as a preselected country. If you want to change that for example to Germany, edit <tt>/usr/bin/navit.sh</tt> and change the following line
export LANG=de_AT.utf8
to the LANG export
export LANG=de_DE.utf8
so that Germany will be the preselected language.

===update package index info (this is important!!)===
* start (as root on your neo):
cd /etc/opkg/
unalias mv
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)
* wait at least 3 minutes after reboot (for frameworkd to settle down)
* '''[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-obsolete/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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|feedback]]

== Features ==

=== Installed Programs ===

==== German Keyboard ====
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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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

'''Remark:''' Backup this file, if you have to flash your freerunner you just have to copy it to the folder <tt>/etc/</tt>.

==== Htop ====
With Htop you can see the memory usage of CPU processes

==== Midori ====
small webbrowser, usable but not really the best

==== Mokonnect ====
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
==== [[Navit]] ====
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 ====
Terminal <tt>valaterm</tt> for working from shell, bash
==== 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 ====
The program zedlock provides no icon. It is used when you press the AUX button to lock the screen. To unlock the screen just draw a big "Z" on the screen within 1 second

==== Screenshots gpe-scap ====
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
==== Locate Freerunner: sms-sentry ====
sms-sentry has no icon, it will send an sms with its location on demand.
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 <tt>/etc/sms-sentry</tt>:
[config]
password=54321

[[Category:SHR]]

Configure SHR for German-speaking use

2010-02-09T11:17:37Z

Zoff99: /* zedlock */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|zoff99]] 17:04, 2 November 2009 (UTC)

== looking for the NEW SHR unstable ==
if u feel lucky go to this page
[[Configure_SHR_for_German-speaking_use_UPDATE_2]]

but beware, it could crash or worse (you have been warned)

--[[User:Zoff99|zoff99]] 16:24, 9 December 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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

on 1st boot, when asked choose (see images above):

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Download Customization Pack WITHOUT Maps for Navit===
* login as root an run
cd /media/card/____shr_testing
wget http://work.zoff.cc/openmoko/shr/de_at/customize_pack_shr_no_maps.tar.gz # 22 MBytes

===Unpack Customization Pack===
* 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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

=== Preselected country in [[Navit]] ===
With the current installation you will get Austria as a preselected country. If you want to change that for example to Germany, edit <tt>/usr/bin/navit.sh</tt> and change the following line
export LANG=de_AT.utf8
to the LANG export
export LANG=de_DE.utf8
so that Germany will be the preselected language.

===update package index info (this is important!!)===
* start (as root on your neo):
cd /etc/opkg/
unalias mv
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)
* wait at least 3 minutes after reboot (for frameworkd to settle down)
* '''[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-obsolete/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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|feedback]]

== Features ==

=== Installed Programs ===

==== German Keyboard ====
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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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

'''Remark:''' Backup this file, if you have to flash your freerunner you just have to copy it to the folder <tt>/etc/</tt>.

==== Htop ====
With Htop you can see the memory usage of CPU processes

==== Midori ====
small webbrowser, usable but not really the best

==== Mokonnect ====
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
==== [[Navit]] ====
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 ====
Terminal <tt>valaterm</tt> for working from shell, bash
==== 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 ====
The program zedlock provides no icon. It is used when you press the AUX button to lock the screen. To unlock the screen just draw a big "Z" on the screen within 1 second

==== Screenshots gpe-scap ====
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
==== Locate Freerunner: sms-sentry ====
sms-sentry has no icon, it will send an sms with its location on demand.
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 <tt>/etc/sms-sentry</tt>:
[config]
password=54321

[[Category:SHR]]

Configure SHR for German-speaking use UPDATE 2

2010-01-25T08:31:20Z

Zoff99:

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|2009-11-21
|this page will be localization for SHR-unstable new
|-
|2009-12-09
|ok now its almost landed. but this time it will ONLY work with rootfs on SDcard!!
|-
|2010-01-07
|there is still no usable and stable SHR to use as basis, sorry. so we keep on waiting ...
|-
|2010-01-10
|i have the first usable version ready, will upload next week
|-
|2010-01-25
|for the moment i have stopped working on this. no stability is possible. and i have a new toy: Satio U1 :-)
|}

== WARNING!! WARNING!! WARNING!! ==
{{Note|use at your own risk, the image is changed by me. so if it blows up or transfers all your money to some guy in nigeria, not my fault.
you have been warned!!}}

== looking for a stable release that just works, now called shr-obsolete?? ==
ok go to this page
[[Configure_SHR_for_German-speaking_use]]

== Now whats this page all about??? ==
its all about localization of the SHR unstable image for german/austrian use.
and fixing some annoying bugs.

== Startup Times ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|0:00
|press button to boot neo
|-
|0:12
|splash logo visible
|-
|1:39
|illume desktop icons visible
|-
|2:41
|GSM logged in
|}

Configure SHR for German-speaking use UPDATE 2

2010-01-10T15:08:11Z

Zoff99: /* Now whats that all about??? */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|2009-11-21
|this page will be localization for SHR-unstable new
|-
|2009-12-09
|ok now its almost landed. but this time it will ONLY work with rootfs on SDcard!!
|-
|2010-01-07
|there is still no usable and stable SHR to use as basis, sorry. so we keep on waiting ...
|-
|2010-01-10
|i have the first usable version ready, will upload next week
|}

== WARNING!! WARNING!! WARNING!! ==
{{Note|use at your own risk, the image is changed by me. so if it blows up or transfers all your money to some guy in nigeria, not my fault.
you have been warned!!}}

== looking for a stable release that just works, now called shr-obsolete?? ==
ok go to this page
[[Configure_SHR_for_German-speaking_use]]

== Now whats this page all about??? ==
its all about localization of the SHR unstable image for german/austrian use.
and fixing some annoying bugs.

== Startup Times ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|0:00
|press button to boot neo
|-
|0:12
|splash logo visible
|-
|1:39
|illume desktop icons visible
|-
|2:41
|GSM logged in
|}

Configure SHR for German-speaking use UPDATE 2

2010-01-10T15:07:43Z

Zoff99:

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|2009-11-21
|this page will be localization for SHR-unstable new
|-
|2009-12-09
|ok now its almost landed. but this time it will ONLY work with rootfs on SDcard!!
|-
|2010-01-07
|there is still no usable and stable SHR to use as basis, sorry. so we keep on waiting ...
|-
|2010-01-10
|i have the first usable version ready, will upload next week
|}

== WARNING!! WARNING!! WARNING!! ==
{{Note|use at your own risk, the image is changed by me. so if it blows up or transfers all your money to some guy in nigeria, not my fault.
you have been warned!!}}

== looking for a stable release that just works, now called shr-obsolete?? ==
ok go to this page
[[Configure_SHR_for_German-speaking_use]]

== Now whats that all about??? ==
its all about localization of the SHR unstable image for german/austrian use.
and fixing some annoying bugs.

== Startup Times ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|0:00
|press button to boot neo
|-
|0:12
|splash logo visible
|-
|1:39
|illume desktop icons visible
|-
|2:41
|GSM logged in
|}

Configure SHR for German-speaking use UPDATE 2

2010-01-10T15:05:35Z

Zoff99: /* News */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|2009-11-21
|this page will be localization for SHR-unstable new
|-
|2009-12-09
|ok now its almost landed. but this time it will ONLY work with rootfs on SDcard!!
|-
|2010-01-07
|there is still no usable and stable SHR to use as basis, sorry. so we keep on waiting ...
|-
|2010-01-10
|i have the first usable version ready, will upload next week
|}

== looking for a stable release that just works, now called shr-obsolete?? ==
ok go to this page
[[Configure_SHR_for_German-speaking_use]]

== Now whats that all about??? ==
its all about localization of the SHR unstable image for german/austrian use.
and fixing some annoying bugs.

== Startup Times ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|0:00
|press button to boot neo
|-
|0:12
|splash logo visible
|-
|1:39
|illume desktop icons visible
|-
|2:41
|GSM logged in
|}

Configure SHR for German-speaking use UPDATE 2

2010-01-10T15:04:25Z

Zoff99:

Navit

2010-01-07T20:48:17Z

Zoff99: /* Enable Maps in Navit */

{{Application|Navit}}

As described on the [http://navit.sourceforge.net/ Navit home page],

<i>"'''Navit''' is a car navigation system with routing engine.

Its modular design is capable of using vector maps of various formats for routing and rendering of the displayed map. It's even possible to use multiple maps at a time.

The GTK+ or SDL user interfaces are designed to work well with touch screen displays. Points of Interest of various formats are displayed on the map.

The current vehicle position is either read from gpsd or directly from NMEA GPS sensors."</i>

Some people say Navit is also a good choice for pedestrian and bicycle navigation.

[[Image:Navit-2241.png|thumb|Navit-r2241]]

== Acknowledgment ==

Thanks to [[User:Alessandro | Alessandro]], stefan_schmidt, cp15 and all Navit developers I have done a small ("not really working") preview of Navit on Neo1973 at [http://www.telemobilityforum.com/eng/ Telemobility Forum 2007]. Thanks to [http://gfoss.it GFoss] guys to invite me.
''[[User:Tyrael | Tyrael]]''

==Setting up Navit==

===Install Navit===
==== FSO (OM2008.x,SHR,...) ====

You can now simply add a feed from there : http://download.navit-project.org/navit/openmoko/svn/

Essentially, to enable this directory as [[Om_2008.8_Installer#How to add a Repository ?|feed]] and install or update navit do:
* Only for the first time:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

* Always:
opkg install navit

Navit will be auto-updated when you run opkg upgrade later

Navit might not be able to use gpsd at startup:
navit:plugin_load:can't load '/usr/lib/navit/vehicle/
libvehicle_gpsd.so', Error 'libgps.so.16: cannot open shared object
file: No such file or directory'
navit:vehicle_new:invalid type 'gpsd'

to solve this issue (necessary for SHR):

opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

====Debian====
Navit is now in Debian [http://packages.debian.org/source/testing/navit testing] and [http://packages.debian.org/source/unstable/navit unstable].

Add the following line to <tt>/etc/apt/sources.list</tt> with e.g. editor <tt>vi</tt> or <tt>nano</tt>:

deb http://ftp.de.debian.org/debian unstable main

Then update with apt-get:

apt-get update

The up-to-date source package is available through git at '''git://git.debian.org/git/collab-maint/navit.git''' ([http://git.debian.org/?p=collab-maint/navit.git;a=summary browse]).

===Set up the maps you want===

====The Easy Way====
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. Navigate to the region you want, and click "select" to select region, select the area you want, then click download. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]

If you just want the entire planet (as of this writing, ~1.8 GB), it's [http://maps.navit-project.org/planet.bin here].

[http://downloads.cloudmade.com/ CloudMade] also has up-to-date maps from OpenStreetMap by country (by state in the US).

====From the command line====
'''OpenStreetMap''' - follow directions at http://wiki.navit-project.org/index.php/OpenStreetMaps
* There are some pre-processed, up-to-date maps that can be grabbed with wget:

<pre>wget -O germany.bin http://maps.navit-project.org/api/map/?bbox=5.185546875,46.845703125,15.46875,55.634765625</pre>

You can put a shell script into <tt>/usr/local/bin/update-maps</tt>
#!/bin/sh
echo "Update OpenstreetMaps"
echo "---------------------"
echo " download and store OSM maps on /media/card/maps"
wget -O /media/card/maps/germany.bin http://maps.navit-project.org/api/map/?bbox=5.185546875,46.845703125,15.46875,55.634765625
echo "update germany.bin finished"
You have to make the script executable with:
chmod u+x /usr/local/bin/update-maps
Then you can update with this script all your maps on the SD-card if you have internet connection:
update-maps

* Here's an example to get the maps for the area around Seattle, WA:
** Find the map coordinates using http://informationfreeway.org/?lat=47.520270037501454&lon=-122.20130713167327&zoom=9&layers=B000F000
** Download 4 regions from OpenStreetMaps ([[Navit#Script_to_download_OSM_maps|see below]] for a script to do this for you automatically for largish areas):

<pre>wget -O map1.osm http://www.openstreetmap.org/api/0.5/map?bbox=-122.2,47.5,-122,47.7
wget -O map2.osm http://www.openstreetmap.org/api/0.5/map?bbox=-122.4,47.5,-122.2,47.7
wget -O map3.osm http://www.openstreetmap.org/api/0.5/map?bbox=-122.4,47.3,-122.2,47.5
wget -O map4.osm http://www.openstreetmap.org/api/0.5/map?bbox=-122.2,47.3,-122,47.5</pre>

* A binary Navit map file needs to be created. The following uses osm2navit, and it's recommended that this command be used on something more powerful than the Neo:

<pre>cat *.osm | osm2navit --dedupe-ways mymap.bin</pre>

===Copy the map to the NEO===
To copy the map using scp (replace ''/directory'' as is appropriate in the following):
<pre>scp mymap.bin root@neo:/directory</pre>
If you copy the map <tt>germany.bin</tt> to the SD card on the Neo use e.g.
<pre>scp germany.bin root@neo:/media/card</pre>

Once it's somewhere on the NEO, Navit needs to know that it's there.
<pre>mkdir ~/.navit
cp /usr/share/navit/navit.xml ~/.navit/navit.xml
vi ~/.navit/navit.xml</pre>

note that in some version navit includes other xml files from /usr/share/navit, for instance mapsets are now defined in maps.xml.

===Enable Maps in Navit ===
Now you must let Navit know the maps you want to use. Several disabled mapset-tags are predefined.
In the navit.xml file, put the following into a new <mapset> section (and disable the default <mapset> just above - or else it will not work):
<pre><map type="binfile" enabled="yes" data="/directory" /></pre>
For example with a <tt>germany.bin</tt> on the SD-card you use:
<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/germany.bin" />
</mapset>
or if you store all downloaded maps in the directory <tt>/media/card/maps</tt> then add the following lines to <tt>navit.xml</tt>.
<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
{{Note|this will only load the first map that machtes *.bin (its a bug/feature)!}}
{{Note|that the bin-file and the map set both have to be enabled}}

Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

* Run navit
** Start [[gllin]] (for GTA01)
** Start [[gpsd]] ( gpsd /tmp/nmeaNP )
** Start navit

* The version of osm2navit with which you build the maps should match the version of navit you have. If in doubt, build the maps on the Openmoko.

===Tips and Tricks===
====Center on Vehicle====
Navit supports a "always center on vehicle" option.

To activate this add
follow="3"
to the <tt>vehicle</tt> tag in navit.xml.
<vehicle name="Local GPS" profilename="car" enabled="yes" active="1" follow="3"
source="gpsd://localhost" gpsd_query="w+xj" color="#0000ff">
The "3" causes to give the gui time to do something between the repaints (drag the map or browse the menu). When its set to "1" navit does nothing more than repainting the map continuously.

==Routing==
[[Image:navit_main_menu.png|100px|thumb|Navit Main Menu]]
[[Image:navit_action_menu.png|100px|thumb|Navit Action Menu]]
The main menu has 4 submenus
* Action
* Settings
* Tools
* Route
Normally you would assume the entering a town can be found under the submenu Route, but Town is hidden under submenu Action. Route will provide the description of the route as text and a height profile of your trip. Tools was not working on 08/2009 Version of navit on SHR (see [[SHR User Manual]]).

===Preselect Country of Destination===
Normally you have to select the the country first before choosing the town and street name. It might be more convenient for you if you preselect the country already with your settings.
The article [[Configure SHR for German-speaking use]] had a preselection of the country "Austria" in Navit. Adapt the localization for your country and maps in Navit, so that do not need to select the country anymore.

Actually Navit derives the preselected country from the calling environments's locale (see [[Localization]]). Make sure, that LC_ALL ist '''not''' set though. Otherwise navit fails to interprete gpsd output and you end up with strange gps coordinates. When starting from gui (e.g. illume) you can achieve this by supplying an executable script /usr/local/bin/navit which might look like this:
<pre>
#!/bin/bash
#export LANG=xx_YY.UTF-8 # Uncomment this line and replace xx_YY, if
# your gui's locale is not setup accordingly.
unset LC_ALL
/usr/bin/navit
</pre>
So a valid locale environment preselecting search for German cities would look like this:
<pre>
root@om-gta02 ~ $ locale
LANG=de_DE.UTF-8
LC_CTYPE="de_DE.UTF-8"
LC_NUMERIC="de_DE.UTF-8"
...
LC_MEASUREMENT="de_DE.UTF-8"
LC_IDENTIFICATION="de_DE.UTF-8"
LC_ALL=
</pre>
Note that there's a limited number of [http://wiki.navit-project.org/index.php/OpenStreetMaps#Known_countries_by_osm2navit countries supported by osm2navit] and Navit's search function.

===Select Destination===
[[Image:navit_select_country.png|100px|thumb|Select Country]]

You can the select your destination in the main menu:
* via '''Bookmarks''', if you saved the previous location or
* via '''Town''', if you want to enter a new destination. If you use a destination more frequently, just save the location as bookmark.

When you click in the main menu on <i>Action</i> the <i>Action</i> menu appears with 4 subitems.
* Bookmarks of previous locations (stored in <tt>/home/root/.navit/destinations.txt</tt>
* a globe showing a location as destination,
* a vehicle that shows the current GPS position of the vehicle. If the freerunner receives no GPS signal the locations of the vehicle is set to 0.0.0N and 0.0.0E.
* Town is the action to enter a destination.
* Quit navit is the last action in this submenu.

Select the icon <i>Town</i> in the main menu (if you see the map, you can get to the main menu just by clicking on the map).

====Select Country====
[[Image:navit_country_selected.png|100px|thumb|Country Options]]
[[Image:navit_destination_details.png|100px|thumb|Enter Bookmark Details]]

Before you can search for City you have to select a Country. To do that, click on the icon in the left upper corner of the search field (could look like a white square with blue top-left quadrant).

Just type in the first letter of the country (e.g. "G") and Navit makes suggestions (e.g. Gabon, Germany).

====Enter Town====

When you have selected the country (e.g. Germany) the flag appears and you can select the town.
Then you can save the town as bookmark and enter more details like streets to the selected town.

The search is still a little buggy.

====Enter Street====
You can enter the street and streetnumber and save it as bookmark when you use the destination often.

====Bookmarks====
Navigation and planning of routes with Navit can be organized with bookmarks.
* set a bookmark as current position
* set a bookmark as destination
Then you can see the suggested route in blue on the map.

Bookmarks are stored in:
/home/root/.navit/bookmark.txt

The GPS-location (if GPS-signal is available) will be highlighted with a small blue circle. The color of the circle can be defined via editing the <tt>navit.xml</tt> (see [http://wiki.openmoko.org/wiki/Navit#Set_Cursor_Color select cursor color]).
* a dot in the blue circle is indicating that your are not moving,
* an arrowhead is indicating the direction, when you are moving.
Then routing can start and in the map the route is highlighted.

====Screenshots in Navit Documentation====
The screenshots are made with <tt>gpe-scap</tt>, that can be installed by:
opkg install gpe-scap
if not installed already. Navigation through your installed application navit and login via ssh on your Freerunner
ssh -l root 192.168.0.202
assuming that your Freerunner has the IP 192.168.0.202.
Any time you want to make a screenshot just start via your desktop computer
gpe-scap
and save the screenshot to you freerunner.
Download the screenshot to your desktop computer with
desktop# sftp://root@192.168.0.202

== News ==
A deeper look into configuring Navit can be found in the [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Wiki].

=== Getting the display right ===

If using SHR the keyboard in country/town/street search mode does not fit on the street, make sure your gui configuration is set to the following line:

<gui type="internal" font_size="350"/>

The example line provided for freerunners hides some important icons. Namely, instead of typing your city name first, you will first have to click the button on the top left, to go into country search mode. Enter your country name, then the city name, in order to enable the search function. This requires your map data to be searchable.

You can start in fullscreen mode with fullscreen="1"

<gui type="internal" font_size="350" fullscreen="1"/>

If you want to enable "+" and "-" as Zoom-In and Zoom-Out buttons on the bottom of the map enable the button with the following xml-tags:
<osd enabled="yes" type="button" x="-96" y="-96" command="zoom_in()" src="zoom_in.xpm"/>
<osd enabled="yes" type="button" x="0" y="-96" command="zoom_out()" src="zoom_out.xpm"/>

You can find sample Layouts here:
[http://wiki.navit-project.org/index.php/OSD_Layouts Sample Layouts from navit-wiki]

=== Set Cursor Color ===
[[Image:red_cursor.png|90px|thumb|Red Cursor]]
If you navigate, the route is marked in blue color on the map. The current position of the vehicle is displayed by a blue circle. The circle is sometimes difficult to see on the blue track. If you want to change the color, size of the vehicle cursor edit the vehicle XML-environment in navit.xml (e.g. replace blue color #0000FF with red color #FF0000 -- for details of [http://html-color-codes.info Color Codes] select color, copy and paste code in <tt>navit.xml</tt>)

<vehicle name="Local GPS" profilename="car" enabled="yes" active="1" source="gpsd://localhost" gpsd_query="w+xj" color="#0000ff">


<cursor w="56" h="56">

<itemgra>
<circle color="#ff0000" radius="42" width="6">
<coord x="0" y="0"/>
</circle>
<circle color="#ffffff" radius="48" width="2">
<coord x="0" y="0"/>
</circle>
</itemgra>

<itemgra speed_range="-2">
<polyline color="#ff0000" width="6">
<coord x="1" y="1"/>
<coord x="1" y="-1"/>
<coord x="-1" y="-1"/>
<coord x="-1" y="-1"/>
</polyline>
<circle color="#ffffff" radius="9" width="2">
<coord x="0" y="0"/>
</circle>
</itemgra>

<itemgra speed_range="3-">
<polyline color="#ff0000" width="6">
<coord x="-7" y="-10"/>
<coord x="0" y="12"/>
<coord x="7" y="-10"/>
</polyline>
<polyline color="#ffffff" width="2">
<coord x="+10" y="-10"/>
<coord x="3" y="15"/>
</polyline>
<polyline color="#ffffff" width="2">
<coord x="-10" y="-10"/>
<coord x="-3" y="15"/>
</polyline>
</itemgra>
</cursor>
</vehicle>
The following screenshot show Navit with a red cursor on a blue track:

[[Image:navit_color_cursor.png|200px|thumb|Red Cursor Color on blue track - vehicle not moving]]

=== Speech ===
Navit can speak if you install [http://espeak.sourceforge.net/ eSpeak] + [http://www.freebsoft.org/speechd speech-dispatcher] and updates your navit.xml file.

If you want navit using your language, and setting LC_MESSAGES fails due to missing glibc locale, set the enviroment variable LANGUAGE. For instance running
LANGUAGE=de navit
will set the ui and output to german.

For SHR there is a big german localization patch see [[Configure SHR for German-speaking use]].

One way to configure speech output:

* mokoTTS aims to integrate these packages in OM:
http://projects.openmoko.org/projects/mokotts/

install espeak, dotconf, and then speech-dispatcher.
note: running 2008.8 updating from zecke's "testing" repo does not require "dotconf"

* change the speech tag in navit.xml:
<speech type="cmdline" data="spd-say '%s'" />

or "spd-say -l fr '%s'" for using the French voice for example.

The speech-dispatcher is blocking the audio after suspend. So after a suspend you will hear no ringtone, when a phone call is coming in and you cannot listen do audio files.
A solution is to disable starting of speech-dispatcher with:
update-rc.d -f speech-dispatcher remove
Then the speech-dispatcher should be started if and only if navit is running and shut down when navit is closed.

Furthermore navit should be started indirect with a script <tt>navit.sh</tt> instead of a direct start with the binary located in <tt>/usr/bin/navit</tt>. The script <tt>navit.sh</tt> listed below starts speech-dispatcher before navit, and stops it afterwards. See http://lists.openmoko.org/nabble.html#nabble-td1088795

The following script is doing the suggested procedure. This script includes a language fix for Austria (see [[Configure SHR for German-speaking use]]).
export LANG=de_AT.utf8
Replace '''<tt>de_AT</tt>''' in this line with the appropriate language variable in the following script <tt>navit.sh</tt>.
<pre>
#! /bin/sh
#
# Copyright Matthias Hentges <devel@hentges.net> (c) 2008
# License: GPL (see http://www.gnu.org/licenses/gpl.txt for a copy of the license)
#
# Filename: navit.sh
# Date: 20080105 (YMD)
#
#################################################################################
#
# 20080105 - v0.0.1 - Initial release
# 20090818 - - Zoff <zoff@zoff.cc> addons and fixes
#
#
#################################################################################

#################################################################################
#
# On devices with low memory (< 512Mb?) Navit will segfault on start.
# This can be worked around by doing
# "echo 1 > /proc/sys/vm/overcommit_memory"
#
#################################################################################

. /etc/profile

set|grep LC

#### Stop the speech dispatcher ####
/etc/init.d/speech-dispatcher stop

#### Language Fix #################
set|grep LC

export LC_ALL=''
unset LC_ALL
export LANG=de_AT.utf8

set|grep LC

#### Start the speech dispatcher ####
/etc/init.d/speech-dispatcher start &

set|grep LC

# need cpu and display
mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy Display enabled

if test "`cat /proc/meminfo | grep ^MemTotal | awk '{print $2}'`" -lt "500000"
then
if test "$USER" = "root"
then
echo "Enabling low-mem workaround..."
echo 1 > /proc/sys/vm/overcommit_memory
else
echo "I need root-privs to enable the low-mem workaround!"
fi
fi

######### Start NAVIT NOW ############

navit $*

#### Stop the speech dispatcher ####

/etc/init.d/speech-dispatcher stop

# release cpu and display
mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy Display auto

</pre>
Save the <tt>navit.sh</tt> script in:
/usr/bin/navit.sh
Make the script executable:
chmod u+x /usr/bin/navit.sh
Now you have to edit the desktop icon, so that it starts this script <tt>navit.sh</tt> instead of the binary <tt>/usr/bin/navit</tt>.
nano /usr/share/applications/navit.desktop
Edit the line with <tt>Exec=...</tt>, so that it starts the script <tt>navit.sh</tt> instead of the navit binary.
<pre>
[Desktop Entry]
Version=1.0
Name=Navit
Name[de]=Navit
Name[fr]=Navit
Comment=The open source vector based navigation program with routing engine
Comment[de]=Ein vektorbasiertes Navigationsprogramm
Comment[fr]=Le logiciel opensource de navigation vectorielle
Exec=/usr/bin/navit.sh
Icon=navit
StartupNotify=true
Terminal=false
Type=Application
Categories=GTK;Utility;Geography;
GenericName=Navit
GenericName[de]=Navit

</pre>

'''Alternatively''', you can make speech-dispatcher restart on resume, see http://trac.shr-project.org/trac/ticket/494

=== Script to download OSM maps ===
[[User:Wurp|Wurp]] wrote a little python script to download all OSM maps within a lat/long rectangle. Just copy the script to a file called dlOSM.sh, chmod +x it, and run it like
dlOSM.sh <minimum latitude> <maximum latitude> <minimum longitude> <maximum longitude>

It takes a long time for large maps. I could optimize it some by having it try to get a big section at once, then if it fails, break it into smaller pieces and recurse. I'm not sure when/if I'll get around to that...

dlOSM.sh:
<pre>
#!/usr/bin/python

import os
import sys
#import math

def doIt(cmd):
os.system(cmd)

def getOsms(basename, minLat, maxLat, minLon, maxLon):
'''basename - base name of map, maps are named {basename}{count}.osm
minLat - latitude of the west side of the map
maxLat - latitude of the east side of the map
minLon - longitude of the north side of the map
maxLon - longitude of the south side of the map'''

wgetCmdTemplate = 'wget -O %s%s.osm http://api.openstreetmap.org/api/0.6/map?bbox=%s,%s,%s,%s'

currLat = minLat
mapCount = 0
while currLat < maxLat:
nextLat = min(currLat + 0.1, maxLat)

currLon = minLon
while currLon < maxLon:
nextLon = min(currLon + 0.1, maxLon)

doIt(wgetCmdTemplate % (basename, mapCount, currLon, currLat, nextLon, nextLat))

currLon = nextLon
mapCount = mapCount + 1

currLat = nextLat

(minLat, maxLat, minLon, maxLon) = map(float, sys.argv[1:])
getOsms('map', minLat, maxLat, minLon, maxLon)
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[Navit]]|
Description=Navit is a car navigation system with routing engine.|
Screenshot=Screenshot-3.png|
Homepage=http://navit.sourceforge.net|
TestedOn=|
PackageName=
}}
</onlyinclude>

[[Category:GPS Applications]]

Configure SHR for German-speaking use UPDATE 2

2010-01-07T15:22:26Z

Zoff99: /* News */

Talk:Configure SHR for German-speaking use UPDATE 2

2009-12-29T19:23:06Z

Zoff99:

== Please leave Feedback (and use the "sign"-button please) ==

--[[User:Zoff99|zoff99]] 16:19, 9 December 2009 (UTC)

== Feedback ==

Will this merge into one SHR for German-speaking use?

--[[User:Niebert|Niebert]] 10:50, 28 December 2009

i guess the old page will stay as long as its valid and working.
the new shr-u carshes all the time, with my neo. so i an still waiting until i can put something usefull on the new page aswell :-)

--[[User:Zoff99|zoff99]] 19:22, 29 December 2009 (UTC)

Talk:Configure SHR for German-speaking use UPDATE 2

2009-12-29T19:22:36Z

Zoff99: /* Please leave Feedback (and use the "sign"-button please) */

== Please leave Feedback (and use the "sign"-button please) ==

--[[User:Zoff99|zoff99]] 16:19, 9 December 2009 (UTC)

Will this merge into one SHR for German-speaking use?

--[[User:Niebert|Niebert]] 10:50, 28 December 2009

i guess the old page will stay as long as its valid and working.
the new shr-u carshes all the time, with my neo. so i an still waiting until i can put something usefull on the new page aswell :-)

--[[User:Zoff99|zoff99]] 19:22, 29 December 2009 (UTC)

Talk:Configure SHR for German-speaking use UPDATE 2

2009-12-29T19:21:28Z

Zoff99: /* Please leave Feedback (and use the "sign"-button please) */

Configure SHR for German-speaking use

2009-12-10T08:45:51Z

Zoff99: /* looking for the NEW SHR unstable */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|zoff99]] 17:04, 2 November 2009 (UTC)

== looking for the NEW SHR unstable ==
if u feel lucky go to this page
[[Configure_SHR_for_German-speaking_use_UPDATE_2]]

but beware, it could crash or worse (you have been warned)

--[[User:Zoff99|zoff99]] 16:24, 9 December 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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

on 1st boot, when asked choose (see images above):

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Download Customization Pack WITHOUT Maps for Navit===
* login as root an run
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===
* 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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

===update package index info (this is important!!)===
* start (as root on your neo):
cd /etc/opkg/
unalias mv
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)
* wait at least 3 minutes after reboot (for frameworkd to settle down)
* '''[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-obsolete/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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use UPDATE 2

2009-12-10T08:44:44Z

Zoff99: /* looking for the old SHR, now called obsolete?? */

Talk:Configure SHR for German-speaking use UPDATE 2

2009-12-09T16:25:03Z

Zoff99:

== Please leave Feedback (and use the "sign"-button please) ==

--[[User:Zoff99|zoff99]] 16:19, 9 December 2009 (UTC)

Configure SHR for German-speaking use

2009-12-09T16:24:02Z

Zoff99:

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|zoff99]] 17:04, 2 November 2009 (UTC)

== looking for the NEW SHR unstable ==
ok go to this page
[[Configure_SHR_for_German-speaking_use_UPDATE_2]]

--[[User:Zoff99|zoff99]] 16:24, 9 December 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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

on 1st boot, when asked choose (see images above):

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Download Customization Pack WITHOUT Maps for Navit===
* login as root an run
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===
* 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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

===update package index info (this is important!!)===
* start (as root on your neo):
cd /etc/opkg/
unalias mv
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)
* wait at least 3 minutes after reboot (for frameworkd to settle down)
* '''[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-obsolete/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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use UPDATE 2

2009-12-09T16:22:24Z

Zoff99:

Configure SHR for German-speaking use UPDATE 2

2009-12-09T16:22:01Z

Zoff99:

Configure SHR for German-speaking use UPDATE 2

2009-12-09T16:20:47Z

Zoff99:

Talk:Configure SHR for German-speaking use UPDATE 2

2009-12-09T16:19:49Z

Zoff99: New page: = Please leave Feedback (and use the "sign"-button please) = --~~~~

= Please leave Feedback (and use the "sign"-button please) =

--[[User:Zoff99|zoff99]] 16:19, 9 December 2009 (UTC)

Configure SHR for German-speaking use UPDATE 2

2009-12-09T16:19:00Z

Zoff99:

SwapSpace

2009-12-09T16:02:54Z

Zoff99: /* Make swap when microSD card is in a card reader */

WARNING: THIS MIGHT KILL YOUR SD CARD, since there might be alot of read/writes on the same spot.
The Freerunner has only 128mb ram, when this is used up applications get killed.

Please note that the above warning do not apply to [[microSD]] (including microSDHC) card with wear-levelling algorithms/microcontrollers. (See [[#References]])

Please note that you can change the ''swappiness setting'' (low value, default 60) so the swap partition or swap file will be used as little as possible. (See [[#References]])

=Make swap when you are connected to your openmoko with ssh=
64M byte of swap just as an example
dd if=/dev/zero of=/swapfile bs=1024 count=65536
Next time you boot there will be swap
echo "/swapfile swap swap defaults 0 0">> /etc/fstab
Make swap
mkswap /swapfile
Make the swap file work now:
swapon /swapfile

=Make swap when microSD card is in a card reader=
The uSD card is booted on /boot. To use this, we need to make sure that the microsd card is booted, and the Swap can be turned on.

Create the swapfile on the uSD card.
# dd if=/dev/zero of=/boot/swapfile bs=1024k count=128
# mkswap /boot/swapfile

Now, we can put in an init script for [[Fyp]] which does this for us everytime we boot.

# touch /etc/init.d/extswap.sh
# chmod +x /etc/init.d/extswap.sh
# cat > /etc/init.d/extswap.sh
#! /bin/sh
### BEGIN INIT INFO
# Provides: extswap
# Required-Start: mountall
# Required-Stop:
# Default-Start: S
# Default-Stop:
# Short-Description: Uses Additional Swap If Available. works on SHR distro
# Description:
### END INIT INFO

PATH=/sbin:/bin

do_start() {
modprobe loop
echo 10 > /proc/sys/vm/swappiness
if [ -e /boot/swapfile ] ; then
for loopdev in `ls /dev/loop* 2>/dev/null` ; do
losetup $loopdev /boot/swapfile && swapon $loopdev && echo $loopdev > /var/extswapfile && break
done
fi
}

do_stop() {
loopdev=`cat /var/extswapfile 2>/dev/null`
swapoff $loopdev 2>/dev/null && rm -f /var/extswapfile && losetup -d $loopdev
}

case "$1" in
start|"")
do_start
;;
restart|reload|force-reload)
do_stop
do_start
;;
stop)
do_stop
;;
*)
echo "Usage: extswap.sh [start|stop|restart]" >&2
exit 3
;;
esac
# update-rc.d extswap.sh defaults

==References==
*[http://www.notebookreview.com/default.asp?newsID=4258 2/17/2008, notebookreview.com: SDHC Cards vs Hard Drive vs SSD] Quote: "...That sounds like an absolutely manditory thing to have in flash storage ... and luckily "high-performance" SDHC cards such as the 16GB A-DATA SDHC card and many other class 6 cards from other manufacturers incorportate wear-leveling [Please check before you buy!]..."
*[[MicroSD]](HC) cards are a sort of a SSD: [http://robert.penz.name/137/no-swap-partition-journaling-filesystem-on-a-ssd/ December 7, 2008, robert.penz.name: No SWAP Partition, Journaling Filesystems, … on a SSD?] Quote: "...They assume perfect wear leveling...We stay also with the 2 million cycles and assume a 16GB SSD *With 50 MByte/sec we get 20 years! *With 2 MByte/sec we get 519 years! *And even if we reduce the write cycles to 100.000 and write with 2 MByte/sec all the time we’re at 26 years!!...1. Never choose to use a journaling file system on the SSD partitions: Bullshit, you’re just risking data security. Stay with ext3...7. One more thing to consider is that flash-devices handle their space in blocks. The blocksize typically varies between 16KB and 512 KB. Therefore writing one byte may cause erase and rewrite of up to 512KB..."
*[http://fosswire.com/post/2009/2/sysctl-swappiness/ fosswire.com: Speed up your system by avoiding the swap file] Quote: "...the Linux kernel provides a tweakable setting that controls how often the swap file is used, called swappiness. A swappiness setting of zero means that the disk will be avoided unless absolutely necessary (you run out of memory), while a swappiness setting of 100 means that programs will be swapped to disk almost instantly..."

==Links==
*http://www.google.dk/search?q=linux+swap+partition+vs+file+speed

[[Category:MicroSD]]
[[Category:Application Developer]]

SwapSpace

2009-12-09T15:17:01Z

Zoff99: /* Make swap when microSD card is in a card reader */

WARNING: THIS MIGHT KILL YOUR SD CARD, since there might be alot of read/writes on the same spot.
The Freerunner has only 128mb ram, when this is used up applications get killed.

Please note that the above warning do not apply to [[microSD]] (including microSDHC) card with wear-levelling algorithms/microcontrollers. (See [[#References]])

Please note that you can change the ''swappiness setting'' (low value, default 60) so the swap partition or swap file will be used as little as possible. (See [[#References]])

=Make swap when you are connected to your openmoko with ssh=
64M byte of swap just as an example
dd if=/dev/zero of=/swapfile bs=1024 count=65536
Next time you boot there will be swap
echo "/swapfile swap swap defaults 0 0">> /etc/fstab
Make swap
mkswap /swapfile
Make the swap file work now:
swapon /swapfile

=Make swap when microSD card is in a card reader=
The uSD card is booted on /boot. To use this, we need to make sure that the microsd card is booted, and the Swap can be turned on.

Create the swapfile on the uSD card.
# dd if=/dev/zero of=/boot/swapfile bs=1024k count=128
# mkswap /boot/swapfile

Now, we can put in an init script for [[Fyp]] which does this for us everytime we boot.

# touch /etc/init.d/extswap.sh
# chmod +x /etc/init.d/extswap.sh
# cat > /etc/init.d/extswap.sh
#! /bin/sh
### BEGIN INIT INFO
# Provides: extswap
# Required-Start: mountall
# Required-Stop:
# Default-Start: S
# Default-Stop:
# Short-Description: Uses Additional Swap If Available. works on SHR distro
# Description:
### END INIT INFO

PATH=/sbin:/bin

do_start() {
echo 10 > /proc/sys/vm/swappiness
if [ -e /boot/swapfile ] ; then
for loopdev in `ls /dev/loop/* 2>/dev/null` ; do
losetup $loopdev /boot/swapfile && swapon $loopdev && echo $loopdev > /var/extswapfile && break
done
fi
}

do_stop() {
loopdev=`cat /var/extswapfile 2>/dev/null`
swapoff $loopdev 2>/dev/null && rm -f /var/extswapfile && losetup -d $loopdev
}

case "$1" in
start|"")
do_start
;;
restart|reload|force-reload)
do_stop
do_start
;;
stop)
do_stop
;;
*)
echo "Usage: extswap.sh [start|stop|restart]" >&2
exit 3
;;
esac
# update-rc.d extswap.sh defaults

==References==
*[http://www.notebookreview.com/default.asp?newsID=4258 2/17/2008, notebookreview.com: SDHC Cards vs Hard Drive vs SSD] Quote: "...That sounds like an absolutely manditory thing to have in flash storage ... and luckily "high-performance" SDHC cards such as the 16GB A-DATA SDHC card and many other class 6 cards from other manufacturers incorportate wear-leveling [Please check before you buy!]..."
*[[MicroSD]](HC) cards are a sort of a SSD: [http://robert.penz.name/137/no-swap-partition-journaling-filesystem-on-a-ssd/ December 7, 2008, robert.penz.name: No SWAP Partition, Journaling Filesystems, … on a SSD?] Quote: "...They assume perfect wear leveling...We stay also with the 2 million cycles and assume a 16GB SSD *With 50 MByte/sec we get 20 years! *With 2 MByte/sec we get 519 years! *And even if we reduce the write cycles to 100.000 and write with 2 MByte/sec all the time we’re at 26 years!!...1. Never choose to use a journaling file system on the SSD partitions: Bullshit, you’re just risking data security. Stay with ext3...7. One more thing to consider is that flash-devices handle their space in blocks. The blocksize typically varies between 16KB and 512 KB. Therefore writing one byte may cause erase and rewrite of up to 512KB..."
*[http://fosswire.com/post/2009/2/sysctl-swappiness/ fosswire.com: Speed up your system by avoiding the swap file] Quote: "...the Linux kernel provides a tweakable setting that controls how often the swap file is used, called swappiness. A swappiness setting of zero means that the disk will be avoided unless absolutely necessary (you run out of memory), while a swappiness setting of 100 means that programs will be swapped to disk almost instantly..."

==Links==
*http://www.google.dk/search?q=linux+swap+partition+vs+file+speed

[[Category:MicroSD]]
[[Category:Application Developer]]

SwapSpace

2009-12-09T15:13:16Z

Zoff99: /* Make swap when microSD card is in a card reader */

WARNING: THIS MIGHT KILL YOUR SD CARD, since there might be alot of read/writes on the same spot.
The Freerunner has only 128mb ram, when this is used up applications get killed.

Please note that the above warning do not apply to [[microSD]] (including microSDHC) card with wear-levelling algorithms/microcontrollers. (See [[#References]])

Please note that you can change the ''swappiness setting'' (low value, default 60) so the swap partition or swap file will be used as little as possible. (See [[#References]])

=Make swap when you are connected to your openmoko with ssh=
64M byte of swap just as an example
dd if=/dev/zero of=/swapfile bs=1024 count=65536
Next time you boot there will be swap
echo "/swapfile swap swap defaults 0 0">> /etc/fstab
Make swap
mkswap /swapfile
Make the swap file work now:
swapon /swapfile

=Make swap when microSD card is in a card reader=
The uSD card is booted on /boot. To use this, we need to make sure that the microsd card is booted, and the Swap can be turned on.

Create the swapfile on the uSD card.
# dd if=/dev/zero of=/boot/swapfile bs=1024k count=128
# mkswap /boot/swapfile

Now, we can put in an init script for [[Fyp]] which does this for us everytime we boot.

# touch /etc/init.d/extswap.sh
# chmod +x /etc/init.d/extswap.sh
# cat > /etc/init.d/extswap.sh
#! /bin/sh
### BEGIN INIT INFO
# Provides: extswap
# Required-Start: mountall
# Required-Stop:
# Default-Start: S
# Default-Stop:
# Short-Description: Uses Additional Swap If Available. works on SHR distro
# Description:
### END INIT INFO

PATH=/sbin:/bin

do_start() {
if [ -e /boot/swapfile ] ; then
for loopdev in `ls /dev/loop/* 2>/dev/null` ; do
losetup $loopdev /boot/swapfile && swapon $loopdev && echo $loopdev > /var/extswapfile && break
done
fi
}

do_stop() {
loopdev=`cat /var/extswapfile 2>/dev/null`
swapoff -v $loopdev 2>/dev/null && rm -f /var/extswapfile && losetup -d $loopdev
}

case "$1" in
start|"")
do_start
;;
restart|reload|force-reload)
do_stop
do_start
;;
stop)
do_stop
;;
*)
echo "Usage: extswap.sh [start|stop|restart]" >&2
exit 3
;;
esac
# update-rc.d extswap.sh defaults

==References==
*[http://www.notebookreview.com/default.asp?newsID=4258 2/17/2008, notebookreview.com: SDHC Cards vs Hard Drive vs SSD] Quote: "...That sounds like an absolutely manditory thing to have in flash storage ... and luckily "high-performance" SDHC cards such as the 16GB A-DATA SDHC card and many other class 6 cards from other manufacturers incorportate wear-leveling [Please check before you buy!]..."
*[[MicroSD]](HC) cards are a sort of a SSD: [http://robert.penz.name/137/no-swap-partition-journaling-filesystem-on-a-ssd/ December 7, 2008, robert.penz.name: No SWAP Partition, Journaling Filesystems, … on a SSD?] Quote: "...They assume perfect wear leveling...We stay also with the 2 million cycles and assume a 16GB SSD *With 50 MByte/sec we get 20 years! *With 2 MByte/sec we get 519 years! *And even if we reduce the write cycles to 100.000 and write with 2 MByte/sec all the time we’re at 26 years!!...1. Never choose to use a journaling file system on the SSD partitions: Bullshit, you’re just risking data security. Stay with ext3...7. One more thing to consider is that flash-devices handle their space in blocks. The blocksize typically varies between 16KB and 512 KB. Therefore writing one byte may cause erase and rewrite of up to 512KB..."
*[http://fosswire.com/post/2009/2/sysctl-swappiness/ fosswire.com: Speed up your system by avoiding the swap file] Quote: "...the Linux kernel provides a tweakable setting that controls how often the swap file is used, called swappiness. A swappiness setting of zero means that the disk will be avoided unless absolutely necessary (you run out of memory), while a swappiness setting of 100 means that programs will be swapped to disk almost instantly..."

==Links==
*http://www.google.dk/search?q=linux+swap+partition+vs+file+speed

[[Category:MicroSD]]
[[Category:Application Developer]]

Configure SHR for German-speaking use

2009-11-30T19:58:10Z

Zoff99: /* Run init_shr_testing.sh script */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

on 1st boot, when asked choose (see images above):

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Download Customization Pack WITHOUT Maps for Navit===
* login as root an run
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===
* 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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

===update package index info (this is important!!)===
* start (as root on your neo):
cd /etc/opkg/
unalias mv
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)
* wait at least 3 minutes after reboot (for frameworkd to settle down)
* '''[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-obsolete/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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Talk:Configure SHR for German-speaking use

2009-11-29T14:11:26Z

Zoff99: /* What do you think about */

Talk:Configure SHR for German-speaking use

2009-11-29T14:10:59Z

Zoff99: /* What do you think about */

Talk:Configure SHR for German-speaking use

2009-11-29T14:08:58Z

Zoff99:

Talk:Configure SHR for German-speaking use

2009-11-29T14:08:09Z

Zoff99:

(please sign your feedback, thanks)

== Feedback ==

great work. It would be nice if the script for downloading germany.bin can be added and the dictionary setting de_AT resp. de_DE be an option during installation, so that only one script for Germany Language use can be maintained instead of one for Austria (dictionary de_AT) and one for Germany (dictionary setting de_DE). Maybe the heading could be change to German Language Use later.

--[[User:Niebert|Niebert]] 07:40, 27 September 2009 (UTC)

i'll do that if 1 of 2 things happen:

a) many people use this (for 2 users its too much to do)

or

b) someone (you?) help me

--[[User:Zoff99|zoff99]] 12:04, 3 October 2009 (UTC)

* mdbus warnings
Yeah, great work! Thanks for doing this and writing this guide! It worked flawlessly for me. I guess the following warnings can be safely ignored?

after
mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy Display enabled
I got
Using **pending_return in dbus_connection_send_with_reply_setup() without pending_setup is deprecated and strongly discouraged
Using **pending_return in dbus_connection_send_with_reply_setup() without pending_setup is deprecated and strongly discouraged
Using **pending_return in dbus_connection_send_with_reply_setup() without pending_setup is deprecated and strongly discouraged
Using **pending_return in dbus_connection_send_with_reply_setup() without pending_setup is deprecated and strongly discouraged
Service name not found

Thanks again!

--[[User:Guido|Guido]] 22:09, 5 October 2009 (UTC)

yeah those warnings are normal, and can be ignored
but "Service name not found" should not normally happen. when did it occur?

--[[User:Zoff99|zoff99]] 10:06, 6 October 2009 (UTC)

== Problem using settings ==

great work.
but i've 2 problems(?)
First:
Using Settings:
Using:
Settings => Power => Please wait... Loading 4 modules

That's all. No more action. It is only possible to kill the settings-process.
One time after the first update it works. But after the next reboot settings doesn't work any more.
Can anyone help me, to fix this problem ?

Second:
I got the error message:
Service name not found
too. (After using: mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy Display enabled)

Many thanks.
Andre

--[[User:Steigera|Steigera]] 09:47, 18 October 2009 (UTC)

did you do update & upgrade also? if not, do so

and did you start settings right after boot-up? because frameworkd is really really slow, and needs a couple of minutes to have everything loaded.

if that does not help start "shr-settings" on the ssh-console and put the output here

--[[User:Zoff99|zoff99]] 11:17, 18 October 2009 (UTC)

yes. I've tried to use settings very fast after boot-up.
Now after some minutes it works :-)).
Thanks for your fast response.
But another question: it is a little bit extensive to modify the power-settings after every boot-up.
e.g: Backlight
Is there a possibility to modify these settings so it will be used after next boot-up ?

--[[User:Steigera|Steigera]] 18 October 2009 (UTC)

'''PLEASE use the "sign" button when writing here!!'''

sure there is a way, write a script with "mdbus -s XXX YYY" and put it somewhere after system startup.

--[[User:Zoff99|zoff99]] 17:08, 18 October 2009 (UTC)

== What do you think about ==

#install German
opkg list_installed | cut -d " " -f1 | grep -v "kernel-module"> /tmp/opkgi.txt
opkg list | cut -d " " -f1 | grep -v "kernel-module"> /tmp/opkg.txt
grep locale-de /tmp/opkg.txt > /tmp/opkg_de.txt
grep i18n /tmp/opkg.txt >> /tmp/opkg_de.txt
for ip in $(cat /tmp/opkgi.txt)
do
prog=$(grep $ip /tmp/opkg_de.txt)
if [ $prog ]
then
echo found $prog
install="$install $prog"
fi
done
opkg install $install

this installs to all installed packed the locale-de package, if found

--[[User:Bertol|Bertol]] 14:40, 29 November 2009

Configure SHR for German-speaking use

2009-11-29T10:34:53Z

Zoff99: /* update package index info (this is important!!) */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

on 1st boot, when asked choose (see images above):

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Download Customization Pack WITHOUT Maps for Navit===
* login as root an run
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===
* 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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

===update package index info (this is important!!)===
* start (as root on your neo):
cd /etc/opkg/
unalias mv
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-obsolete/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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-28T18:32:11Z

Zoff99: /* Run init_shr_testing.sh script */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

on 1st boot, when asked choose (see images above):

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Download Customization Pack WITHOUT Maps for Navit===
* login as root an run
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===
* 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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

===update 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-obsolete/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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use UPDATE 2

2009-11-21T20:10:23Z

Zoff99:

Configure SHR for German-speaking use UPDATE 2

2009-11-21T20:09:50Z

Zoff99: New page: == News == {| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0" |2009-11-21 |this page will be localization for SHR-untable new |} == Now whats ...

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|2009-11-21
|this page will be localization for SHR-untable new
|}

== Now whats that all about??? ==
this page will be localization for SHR-untable new

Configure SHR for German-speaking use

2009-11-19T18:50:36Z

Zoff99: /* Startup */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

on 1st boot, when asked choose (see images above):

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Download Customization Pack WITHOUT Maps for Navit===
* login as root an run
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===
* 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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

===update 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:41:27Z

Zoff99: /* Localize it */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Download Customization Pack WITHOUT Maps for Navit===
* login as root an run
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===
* 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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

===update 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:41:01Z

Zoff99: /* download Customization Pack WITHOUT Maps for Navit */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Download Customization Pack WITHOUT Maps for Navit===
* login as root an run
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===
* 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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:40:52Z

Zoff99: /* Customization Pack WITHOUT Maps for Navit */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===download Customization Pack WITHOUT Maps for Navit===
* login as root an run
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===
* 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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:40:33Z

Zoff99: /* Unpack Customization Pack */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Customization Pack WITHOUT Maps for Navit===
* login as root an run
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===
* 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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:39:38Z

Zoff99: /* Download the Navit Maps */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Customization Pack WITHOUT Maps for Navit===
* login as root an run
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

===Download the Navit Maps===
* login to your neo as root
* to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:39:20Z

Zoff99: /* Download the Navit Maps */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Customization Pack WITHOUT Maps for Navit===
* login as root an run
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

===Download the Navit Maps===
* login to your neo as root

to download (or update!!) the austrian map file run (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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:38:35Z

Zoff99: /* Customization Pack WITHOUT Maps for Navit */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Customization Pack WITHOUT Maps for Navit===
* login as root an run
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

===Download the Navit Maps===
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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:37:27Z

Zoff99: /* Preparing your SD card (you need to do this!) */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

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"

{{Note|
for this step you must have a working SD-card in your freerunner with at least 1 partition. it can be FAT or ext2 or ext3}}

===Customization Pack WITHOUT Maps for Navit===
download customize pack without navit maps and transfer this file to your Freerunner via sftp.
[http://work.zoff.cc/openmoko/shr/de_at/customize_pack_shr_no_maps.tar.gz 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

===Download the Navit Maps===
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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:35:08Z

Zoff99: /* Startup */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== Startup ==
* boot up your neo, and let it run until you are logged in to your GSM net

{{Note|
it is recommended to use a working SIM card, and disable PIN number verification. but it will work without SIM card also.}}

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"

===Customization Pack WITHOUT Maps for Navit===
download customize pack without navit maps and transfer this file to your Freerunner via sftp.
[http://work.zoff.cc/openmoko/shr/de_at/customize_pack_shr_no_maps.tar.gz 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

===Download the Navit Maps===
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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:33:05Z

Zoff99: /* Installing */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the most relyable way. having the root-fs on the SD-card is slower and also files get suddenly lost or corrupt.}}

== 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"

===Customization Pack WITHOUT Maps for Navit===
download customize pack without navit maps and transfer this file to your Freerunner via sftp.
[http://work.zoff.cc/openmoko/shr/de_at/customize_pack_shr_no_maps.tar.gz 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

===Download the Navit Maps===
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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:32:07Z

Zoff99: /* Flashing Neo */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 using the NAND for root-fs is the 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 <tt>dosfstools</tt> on your Neo to have <tt>mkfs.vfat</tt> 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"

===Customization Pack WITHOUT Maps for Navit===
download customize pack without navit maps and transfer this file to your Freerunner via sftp.
[http://work.zoff.cc/openmoko/shr/de_at/customize_pack_shr_no_maps.tar.gz 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

===Download the Navit Maps===
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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:31:26Z

Zoff99: /* Reminder */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.

--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 <tt>dosfstools</tt> on your Neo to have <tt>mkfs.vfat</tt> 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"

===Customization Pack WITHOUT Maps for Navit===
download customize pack without navit maps and transfer this file to your Freerunner via sftp.
[http://work.zoff.cc/openmoko/shr/de_at/customize_pack_shr_no_maps.tar.gz 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

===Download the Navit Maps===
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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:31:00Z

Zoff99: /* Localize it */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.
--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 <tt>dosfstools</tt> on your Neo to have <tt>mkfs.vfat</tt> 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"

===Customization Pack WITHOUT Maps for Navit===
download customize pack without navit maps and transfer this file to your Freerunner via sftp.
[http://work.zoff.cc/openmoko/shr/de_at/customize_pack_shr_no_maps.tar.gz 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

===Download the Navit Maps===
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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]

Configure SHR for German-speaking use

2009-11-19T18:29:54Z

Zoff99: /* Localize it */

== News ==
{| style="color:#AA2222; background-color:#FAFAFA;" cellpadding="2" cellspacing="10" border="0"
|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.
--[[User:Zoff99|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.''' [http://work.zoff.cc/openmoko/shr/de_at/qi.udfu] qi boot loader (~30 KB)

'''2.''' [http://work.zoff.cc/openmoko/shr/de_at/uImage.bin] kernel (kernöl ~2 MB)

'''3.''' [http://work.zoff.cc/openmoko/shr/de_at/rootfs.jffs2] 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 '''[[GTA02]]'''v6). Detailed instructions for [[Flashing_the_Neo_Freerunner|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 <tt>dosfstools</tt> on your Neo to have <tt>mkfs.vfat</tt> 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"

===Customization Pack WITHOUT Maps for Navit===
download customize pack without navit maps and transfer this file to your Freerunner via sftp.
[http://work.zoff.cc/openmoko/shr/de_at/customize_pack_shr_no_maps.tar.gz 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

===Download the Navit Maps===
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 <tt>init_shr_testing.sh</tt> and search for <tt>_PRIVATE_</tt> 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 ==
* you '''NEED internet on your neo''' for this, otherwise dependent packages can't be downloaded

===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===
* 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 ==

{| style="color:#FCFCFC; cellpadding="4" cellspacing="0" border="1"
|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 ==

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_01.png|illume home screen
Image:z0ph_shr_screen_03.png|illume home screen (menu open)
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_02.png|dialer
Image:z0ph_shr_screen_04.png|german keyboard
</gallery>

<gallery widths="300px" heights="400px">
Image:z0ph_shr_screen_05.png|german dictionary
</gallery>

== Feedback ==
* please give some [[Talk:Configure_SHR_for_Austrian_use|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
[[GTA02_GPS#u-blox_Assist_Now_account_application|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
* <del>Moko...</del>
<del>mokomaze, you might know it from some mobile phones</del>
* Mokon...
Mokonnect, scans for WLAN networks, and does some other stuff (i have NOT yet successfully connected to any WLAN networks)
* [[Navit]]
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

[[Category:SHR]]