Openmoko - User contributions [en]

Talk:Opimd redesign

2009-10-18T07:35:57Z

Catholicon: Some use cases I would like to get working

The current redesign(as I understand from the page right now) would mostly help in:
* sane api for picking/comparing stored data
* some speed-up on part of opimd

As I understand, the basic workflows would still remain the same (except that of sending SMS...where-in the IRC logs suggests that opimd would now take care of sending messages as well - including split-SMS). What I mean is that opimd has following kind of storage:
<record>-><fields> where field has strict type like Name, Phone, Default-SMS, etc, etc

What I was wondering was can we have a field-type of record itself? That should help solve some use-cases like
* sending 1 message to multiple contacts (with delivery report on). So, there should be just one entry of the message with multiple recepients (multiple fields of struct{phone, message-record}recepient; type with name recepient). And as and when the delivery report arrives, opimd adds a new message (as it does even today without redesign)...and updates the original message's corresponding recepient struct as well with the latest delivery report's record.
* have a field spouse of type contact-record to establish relation between my friend's contact entry and his/her spouse

Basically a means of specifying relation between field of one record to another record. I might have missed something altogether so there might be a better more elegant way of solving the mentioned use-cases.

--Catholicon

PS: I think the first use case would be served best if opimd's send message api accepts multiple contacts

Community Updates/2009-09-30

2009-09-17T03:08:47Z

Catholicon: Shuffle some text

{{Improve}}
{{Note|
*Take a moment and look at Discussion page to get a clue on how to contribute to Community Updates while following OM wiki editing guidelines please.
*I you are planning longer edition, please use <nowiki>{{Editing|your_username_here|date_here|editing_summary_here}}tag. Remember to remove/comment out it right after you save your work.</nowiki>
*Please fill in everything you think the community should know.
*On 2009-09-30 this content will be _moved_ to http://wiki.openmoko.org/wiki/Community_Updates/2009-09-30, feel free to do it.
*Post a note about CU release on the community mailing list.
}}


====='''Period 2009-09-17 to 2009-09-30'''=====

==Distributions==
{{DistributionBox|
Name=ExampleDistro|
Description=This is where you talk about the distro and what you did/will do etc etc. Changes from previous version:
* cool stuff
* more cool stuff|
Screenshot=System_boot.png|
Codename=V0.0.1|
Homepage=http://somewhere.com|
Image=[http://also.somewhere.com/stuff images]|
TestedOnHardware=?| 
Neo1973={{unknown}}| 
FreeRunner={{yes}}|
HTC-Dream={{unknown}}|
Other={{unknown}}
}}

==Applications==
===New Applications===
{{ApplicationBox|
Name=Exampleapp 0.0.1|
Description=Exampleapp 0.0.1 is an application to do some stuff..|
Screenshot=System_boot.png|
Homepage=http://wiki.openmoko.org/|
TestedOn=Om2009T5,Om2008.8,SHR|
PackageName=[http:// www.some.srv/path_to/Exampleapp.ipk Exampleapp]
}}

===Application Updates===
{{ApplicationBox|
Name=OpenTTD 0.7.2|
Description=Opentransport tycoon deluxe is game about trains.
* Stylus controllable
* Open graphics
* Open sounds
* Works portrait or landscaped
* Lots of languages|
Screenshot=Openttd_snap3.png|
Homepage=http://wiki.openmoko.org/wiki/OpenTTD|
PackageName=[http://www.opkg.org/packages/openttd_0.7.2-r0.3_armv4t.ipk]|
TestedOn=SHR
}}

{{ApplicationBox|
Name=Exampleapp 0.0.1|
Description=Exampleapp 0.0.1 is an application to do some stuff...
* new example feature 1
* new example feature 2|
Screenshot=System_boot.png|
Homepage=http://wiki.openmoko.org/|
PackageName=Exampleapp|
TestedOn=Om2009T5,Om2008.8,SHR
}}

==Community==
Most important and change making mails on the mailing lists, blogs etc.. Coolest hacks, screenshots, themes etc..
* '''2009-mm-dd''' stuff happens...

==Event News==
* '''2009-mm-dd''' [http://example.url.xom Example event] | add your event here
* '''2009-09-16''' [http://lists.openmoko.org/pipermail/community/2009-September/055398.html Buzz fix in India] | 2 phones get buzz and 1024 fix in Delhi.

[[Category:Community Update]]

Community Updates/2009-09-30

2009-09-17T03:06:49Z

Catholicon: Delhi buzz fix

{{Improve}}
{{Note|
*Take a moment and look at Discussion page to get a clue on how to contribute to Community Updates while following OM wiki editing guidelines please.
*I you are planning longer edition, please use <nowiki>{{Editing|your_username_here|date_here|editing_summary_here}}tag. Remember to remove/comment out it right after you save your work.</nowiki>
*Please fill in everything you think the community should know.
*On 2009-09-30 this content will be _moved_ to http://wiki.openmoko.org/wiki/Community_Updates/2009-09-30, feel free to do it.
*Post a note about CU release on the community mailing list.
}}


====='''Period 2009-09-17 to 2009-09-30'''=====

==Distributions==
{{DistributionBox|
Name=ExampleDistro|
Description=This is where you talk about the distro and what you did/will do etc etc. Changes from previous version:
* cool stuff
* more cool stuff|
Screenshot=System_boot.png|
Codename=V0.0.1|
Homepage=http://somewhere.com|
Image=[http://also.somewhere.com/stuff images]|
TestedOnHardware=?| 
Neo1973={{unknown}}| 
FreeRunner={{yes}}|
HTC-Dream={{unknown}}|
Other={{unknown}}
}}

==Applications==
===New Applications===
{{ApplicationBox|
Name=Exampleapp 0.0.1|
Description=Exampleapp 0.0.1 is an application to do some stuff..|
Screenshot=System_boot.png|
Homepage=http://wiki.openmoko.org/|
TestedOn=Om2009T5,Om2008.8,SHR|
PackageName=[http:// www.some.srv/path_to/Exampleapp.ipk Exampleapp]
}}

===Application Updates===
{{ApplicationBox|
Name=OpenTTD 0.7.2|
Description=Opentransport tycoon deluxe is game about trains.
* Stylus controllable
* Open graphics
* Open sounds
* Works portrait or landscaped
* Lots of languages|
Screenshot=Openttd_snap3.png|
Homepage=http://wiki.openmoko.org/wiki/OpenTTD|
PackageName=[http://www.opkg.org/packages/openttd_0.7.2-r0.3_armv4t.ipk]|
TestedOn=SHR
}}

{{ApplicationBox|
Name=Exampleapp 0.0.1|
Description=Exampleapp 0.0.1 is an application to do some stuff...
* new example feature 1
* new example feature 2|
Screenshot=System_boot.png|
Homepage=http://wiki.openmoko.org/|
PackageName=Exampleapp|
TestedOn=Om2009T5,Om2008.8,SHR
}}

==Community==
Most important and change making mails on the mailing lists, blogs etc.. Coolest hacks, screenshots, themes etc..
* '''2009-mm-dd''' stuff happens...

==Event News==
* '''2009-mm-dd''' [http://example.url.xom Example event] | add your event here
* '''2009-09-16''' 2 phones get buzz and 1024 fix in Delhi. More details at http://lists.openmoko.org/pipermail/community/2009-September/055398.html

[[Category:Community Update]]

Community Updates/2009-09-30

2009-09-17T03:06:26Z

Catholicon: Undo revision 75911 by Catholicon (Talk)

Community Updates/2009-09-30

2009-09-17T03:05:07Z

Catholicon: Delhi buzz fix

{{Improve}}
{{Note|
*Take a moment and look at Discussion page to get a clue on how to contribute to Community Updates while following OM wiki editing guidelines please.
*I you are planning longer edition, please use <nowiki>{{Editing|your_username_here|date_here|editing_summary_here}}tag. Remember to remove/comment out it right after you save your work.</nowiki>
*Please fill in everything you think the community should know.
*On 2009-09-30 this content will be _moved_ to http://wiki.openmoko.org/wiki/Community_Updates/2009-09-30, feel free to do it.
*Post a note about CU release on the community mailing list.
}}


====='''Period 2009-09-17 to 2009-09-30'''=====

==Distributions==
{{DistributionBox|
Name=ExampleDistro|
Description=This is where you talk about the distro and what you did/will do etc etc. Changes from previous version:
* cool stuff
* more cool stuff|
Screenshot=System_boot.png|
Codename=V0.0.1|
Homepage=http://somewhere.com|
Image=[http://also.somewhere.com/stuff images]|
TestedOnHardware=?| 
Neo1973={{unknown}}| 
FreeRunner={{yes}}|
HTC-Dream={{unknown}}|
Other={{unknown}}
}}

==Applications==
===New Applications===
{{ApplicationBox|
Name=Exampleapp 0.0.1|
Description=Exampleapp 0.0.1 is an application to do some stuff..|
Screenshot=System_boot.png|
Homepage=http://wiki.openmoko.org/|
TestedOn=Om2009T5,Om2008.8,SHR|
PackageName=[http:// www.some.srv/path_to/Exampleapp.ipk Exampleapp]
}}

===Application Updates===
{{ApplicationBox|
Name=OpenTTD 0.7.2|
Description=Opentransport tycoon deluxe is game about trains.
* Stylus controllable
* Open graphics
* Open sounds
* Works portrait or landscaped
* Lots of languages|
Screenshot=Openttd_snap3.png|
Homepage=http://wiki.openmoko.org/wiki/OpenTTD|
PackageName=[http://www.opkg.org/packages/openttd_0.7.2-r0.3_armv4t.ipk]|
TestedOn=SHR
}}

{{ApplicationBox|
Name=Exampleapp 0.0.1|
Description=Exampleapp 0.0.1 is an application to do some stuff...
* new example feature 1
* new example feature 2|
Screenshot=System_boot.png|
Homepage=http://wiki.openmoko.org/|
PackageName=Exampleapp|
TestedOn=Om2009T5,Om2008.8,SHR
}}

==Community==
Most important and change making mails on the mailing lists, blogs etc.. Coolest hacks, screenshots, themes etc..
* '''2009-09-16''' 2 phones get buzz and 1024 fix in Delhi. More details at http://lists.openmoko.org/pipermail/community/2009-September/055398.html

==Event News==
* '''2009-mm-dd''' [http://example.url.xom Example event] | add your event here

[[Category:Community Update]]

Community Updates/2009-09-02

2009-09-02T16:43:27Z

Catholicon: Resolving ambiguous statement regarding buzz-fix date for Indian customers

{{Improve}}
{{Note|
*Use Disscuss page for discussion.
*I you are planning longer edition, please use <nowiki>{{Editing|your_username_here|date_here|editing_summary_here}}tag. Remember to remove it (or put between <nowiki> tags ) right after you save your work.</nowiki>
*Take a moment and look at Discussion page to get a clue on how to contribute to Community Updates while following OM wiki editing guidelines please.
*Please fill in everything you think the community should know.
*On 2009-09-02 this content will be _moved_ to http://wiki.openmoko.org/wiki/Community_Updates/2009-09-02, feel free to do it.
*Post a note about CU release on the community mailing list.
}}


====='''Period 2009-08-19 to 2009-09-02'''=====

==Distributions==
{{DistributionBox|
Name=[[QT Moko]]|
Description=QT moko is debian distribution for Openmoko Freerunner phone. Phone and user interface is based on QT Extendeded formerly known as Qtopia. As for the speed, this image is finally fast and responsive and i think it's very usable. This time I will leave testing on you - hopefully nothing nasty crept in. If you wonder where are V7 images - they do not exist. Credits to everybody who helped with this release. Changes from previous version:
* UI is much faster (by fixing bug with opened accelerators.)
* Bluetooth works again (thanks to Bartłomiej Zimoń)
* Upgraded kernel to latest andy-tracking
* Fixed small font size in X
* Fixed AUX to work again when QX ends up
* Fixed compiling on newer gcc
* Added support of uploading screenshots to scap.linuxtogo.org
* QtMaze - updated to version 1.1 (various fixes, new level added)
* Fixes in package manager
* Howto for building debian based rootfs is now in GIT [1]|
Screenshot=Qtmokomain.png|
Codename='V8'|
Homepage=http://activationrecord.net/radekp/qtmoko/|
Image=[http://activationrecord.net/radekp/qtmoko/download/ images]|
TestedOnHardware=Neo,FreeRunner|
Neo1973={{unknown}}|
FreeRunner={{yes}}|
HTC-Dream={{unknown}}|
Other={{unknown}}
}}

==Applications==
===New Applications===
{{ApplicationBox|
Name=[[Advanced Geocaching Tool for Linux]] 0.1.2|
Description=AGTL makes geocaching paperless! It downloads cache locations in the area visible on the map including their description, hints, difficulty levels and images. Searching for caches in your local db is a matter of seconds. The currently selected cache is shown on the map (and also all the others if you want) and there's a traditional compass-like view that always points at the cache. A manual exists [http://wiki.openmoko.org/wiki/Advanced_Geocaching_Tool_for_Linux on the wiki].|
Screenshot=System_boot.png|
Homepage=http://www.opkg.org/package_268.html|
TestedOn=OM2009T5, SHR|
PackageName=[http://www.opkg.org/package_268.html advancedcaching]
}}

{{ApplicationBox|
Name=appraw|
Description=appraw is a small C tool for patching .desktop files to make apps be launched via fsoraw (to prevent automatic screen dimming and suspending). It can be used in various distribution enhancing scripts or just to make freshly installed app fsoraw-enabled. Changes can be easyly reverted.|
Screenshot=System_boot.png|
Homepage=http://github.com/Sektor/appraw/|
TestedOn=SHR|
PackageName=[http://github.com/Sektor/appraw/downloads/ appraw]
}}

{{ApplicationBox|
Name=shr-today|
Description=SHR-Today is a screen-locking application for SHR. It’s wirtten using python, elementary and the opimd subsystem. It notifies about missed and incoming calls, unread messages, the GSM connectivity and about the battery status. It locks the screen by AUX-press, by the FSO “lock” signal and by going to suspend. Configure it's options in /etc/shr-today.conf.|
Screenshot=Shr-today.png|
Homepage=http://wiki.github.com/slyon/today|
TestedOn=SHR-U|
PackageName=[http://build.shr-project.org/shr-unstable/ipk/armv4t/ shr-today]
}}

{{ApplicationBox|
Name=SpojeGUI|
Description=SpojeGUI is GUI program which use CLI program/modul [http://code.google.com/p/spoje/ spoje.py] which is used mainly for Czech and Slovak transport.|
Screenshot=spojegui.png|
Homepage=http://www.opkg.org/package_263.html|
TestedOn=SHR|
PackageName=[http://www.opkg.org/package_263.html spoje]
}}

{{ApplicationBox|
Name=[[QNavitCtl]]|
Description=QNavitCtl is a Qt application to send destination or position to Navit via dbus or center the map.|
Screenshot=Qnavitctl1.png|
Homepage=http://git.senfdax.de/?p=qnavitctl;a=summary|
TestedOn=SHR|
PackageName=[http://openmoko.senfdax.de/shr-unstable/ qnavitctl]
}}

===Application Updates===
{{ApplicationBox|
Name=Exampleapp 0.0.1|
Description=Exampleapp 0.0.1 is an application to do some stuff...
* new example feature 1
* new example feature 2|
Screenshot=System_boot.png|
Homepage=http://wiki.openmoko.org/|
TestedOn=Om2009T5,Om2008.8,SHR|
PackageName=Exampleapp
}}

{{ApplicationBox|
Name=Evopedia 0.2.2|
Description=Evopedia is a Wikipedia reader for offline use. Features include:
* live title search
* images are included when there is a connection to the internet
* articles can be shown on map using tiles from TangoGPS (NEW)|
Screenshot=Evopedia_map.png|
Homepage=http://www.reitwiessner.de/openmoko/evopedia.html|
TestedOn=?|
PackageName=[http://www.reitwiessner.de/openmoko/evopedia_0.2.2_any.ipk evopedia]}}

{{ApplicationBox|
Name=[[launcher]]|
Description=Launcher is a homepage / launcher app (written in c, using elementary and sqlite) that has the following main features
* In built contacts, sms, phonelog app
* Categorises your applications (personalised categories and grouping)
* Notifications for new sms/ missed calls on home page
* cell broadcast / location info on home page
* ability to set your own wallpaper
* uses opim backend|
Screenshot=launcher.png|
Homepage=http://wiki.openmoko.org/wiki/Launcher|
TestedOn=OM2009, SHR-U|
PackageName=[http://www.opkg.org/package_220.html launcher]
}}

{{ApplicationBox|
Name=PyRadio|
Description=PyRadio is TUI program in python for receiver stream of internet radio.
* created ipk package|
Screenshot=System_boot.png|
Homepage=http://www.coderholic.com/pyradio/|
TestedOn=SHR|
PackageName=[http://www.opkg.org/package_265.html pyradio]
}}

==Community==
* After some deliberation and input from the [http://thread.gmane.org/gmane.comp.handhelds.openmoko.community/48620 community] '''Angus Ainslie decided to stop maintaining Om2009 and start work on getting Paroli to co-exist in SHR'''. General instructions on how to run Paroli in SHR are on the [http://wiki.openmoko.org/wiki/Paroli#Paroli_on_SHR_unstable Paroli wiki page].
* '''There was a poll''' about the [http://doodle.com/sd2c8d8snr23eeqq distro people use] and [http://www.doodle.com/svvsubwnyn4zaxd3 what boot loader people use]. '''The most popular distro is SHR''' (over 6 times the users of the Openmoko distributions, followed by Debian Hackable:1 and Android) & bootloader is QI (over 2 times the users of uBoot) amongst the people who read the mailing lists etc and answered the poll. Most likely this is not reality amongst all users but shows where the majority of the community-active people are.
* '''Qalee''' started new website on http://www.qalee.org/.
* On Apr 20th, IDA Systems had announced buzz fix for Indian customers. Exact date of buzz fix is not known yet... These days there has been some activity regarding the same. Currently, the situation is totally unplanned. Please follow '''[http://lists.openmoko.org/pipermail/community/2009-September/054310.html this mail]''' to get more information. We think there would be more users of FR that want this fix done in India. Please reply on the mentioned email thread as well(avoid using nabble).
* '''Czech Openmoko''' community portal http://www.openmoko.cz is in preparation. Suggestions, volunteers and editors are welcome. Czech and Slovak community members please help open this newcomers website, information and collaboration place. Feel free to join to our [http://www.jabber.cz Jabber] [http://www.jabber.cz/wiki/Konference conference] at [http://muc.unart.cz/ ''openmoko@muc.openmoko.cz''].

==Event News==
* '''2009-mm-dd''' [http://example.url.xom Example event] | add your event here

[[Category:Community Update]]

Community Updates/2009-09-02

2009-09-01T21:35:18Z

Catholicon: minor edit to Bugfix in India

Community Updates/2009-09-02

2009-09-01T21:32:54Z

Catholicon: Announce bug fix in India

SHR User Manual

2009-08-31T18:57:33Z

Catholicon: Replacing js-crapped-nabble link with rather liked one :)

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

{{Note|As SHR doesn't provide testing images at the moment this manual was based on unstable images available on the beginning of August 2009. The unstable images get changed very often - the download location changes, default applications change, bugs get hunted and fixed, meaning that some parts of this manual are already outdated.}}

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your phone to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* Notes (opimd based)
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||

|-

| Internet ||
* Pidgin
* Midori (Browser)
||

|-

| Games ||
* Numptyphysics
||
|-
| Settings ||
* SHR Settings
* Mokonnect (Network Manager)
||
* SHR Settings

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links below for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

===Booting===
Press the power button until you feel a soft vibration to start the phone. The booting splash screen will appear. The first boot after a new installation always takes a bit longer. It is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| 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]]

|}

==Running SHR==

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is the default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the top shelf or by using the '''<''' left or right '''>''' arrows in the top shelf.

The Illume desktop can be easily customized - slide the top shelf down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' (the wrench) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the top shelf (for example Battery, GSM, Bluetooth etc.) are called '''shelf gadgets''' and you can configure whether they are visible (on the front part of the top shelf) or hidden (you can access them by sliding the top shelf) through Illume Settings -> Display -> Shelf gadget.

Some screens are not resized properly to fit the phone's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.

{| 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-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| 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-Mesages.png|200px|thumb|Messages]]

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

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

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

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

|}

{| 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-Mesages-Options.png|200px|thumb|Message options]]

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

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

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

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelf cross.

===Post-Installation Script===
After flashing your phone you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your phone via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on your phone with:
neo# sh /home/root/SHRpostinstallation.sh

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your phone. The <tt>root</tt> account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in <tt>/usr/share/shr/scenarii/</tt> . To customize speaker volume edit <tt>/usr/share/shr/scenarii/gsmhandset.state</tt> and change <tt>control 4</tt>. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

Another example:
5667
0-179-5667
00-49-179-5667
+49-179-5667
are equivalent numbers for German O2 service number ("-" for clarity only). So
international_prefix = 00
national_prefix = 0
country_code = 49 (without any leading "00" or "+"!)
for area code it seems wise to use "179" here, though that's the GSM-network code, not the code of your geographical area.
area_code = 179

====Initializing the opkg database====
''Initialize the opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

In the 20090808 Image, opkg update does not work you will get: -sh: opkg: not found.

There is a missing opkg symlink to opkg-cl. this is fixed in the SHR repositories.

To update:

opkg-cl update

And to upgrade

opkg-cl upgrade

opkg should work fine now.

====SwapSpace====
{{Main|SwapSpace}}
When the RAM is used up applications get killed. This is particularly bad while doing opkg upgrade. Therefore you might want to create a swap partition.

WARNING: this mights kill your SD card, since there might be a lot of read/writes to the same spot. (all recent tests failed to harm SD cards by torture write tests, so probably you just shouldn't worry)

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so 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

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

A much more convenient way might be to install your public-key to ~/.ssh/authorized_keys. For running
cmd | ssh root@neo anycommand
from your host this might be even mandatory, e.g if you want to pipe anything to the ssh.

====Locate lost phone by GPS====
To locate your phone in case of loss or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an SMS with the text sentry:location to your phone, the phone will turn on GPS, wait for a fix and send back an SMS with the current location.

[[openBmap]] and [[Cellhunter]] are projects with the objective to collect GPS location of GSM network cells. If this project is finished then SMS-sentry could send the a rough location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in the Illume top shelf go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

The local timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI contact synchronization]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI calendar synchronization]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

<pre>
opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk \\
http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 \\
python-pygtk python-pygobject python-pycairo python-netserver python-netclient \\
http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc \\
http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk \\
http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk \\
http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk \\
http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk
</pre>

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. If you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If not, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your phone you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your phone. Because of the size of the maps you copy map to the Micro-SD card on your phone. Create a directory for the maps and copy the files from desktop to phone:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
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>

===Start Navit===
Start <tt>Navit</tt> on your phone for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the phone does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

Please refer to [http://wiki.openmoko.org/wiki/FSO_Resources#Automatic_way this wiki page] about a better way to manage preventing screen dim or suspend.

While some settings are persistent over reboots, others are not.

===Main Screen===
The main screen is divided into eight categories, which contain several modules. Every SHR Settings module has a specified task - for example controlling the GSM antenna power, setting the time etc.

===Settings: Phone===
Here you can set if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After a while, a list of operators should pop up.

You can't connect to operators marked [forbidden]. After a connection failure, a message is displayed.

Selecting an operator from the list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| 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:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

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

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select the current profile, which the device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of the currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change the ring tone, click the "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting a sid tune as the ring tone, there are available controls to select tune number from the file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| 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:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

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

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| 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:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

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

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With the "WiFi radio" toggle you can set, if the wifi module is powered. WiFi radio has to be turned on before trying to connect to a WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on the actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your GPRS connection}}

To connect to the GPRS network, just click the "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, switch the "Bluetooth radio" toggle to "On". After that, the "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| 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:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

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

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting a fix. To do that, click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set the time. By default, the time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click the "OK" button.

'''Date'''

This module displays the current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update the data, click the "Update" button.

Here you can also force enable 500mA charging.

'''Display'''

With this slider you can easily set the backlight brightness.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| 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:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

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

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by the device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| 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:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

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

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on one, you can either start, restart or stop the service and view the result.

===Settings: Others===

{| 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:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

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

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select the theme used by shr-splash at boot and shutdown. After clicking "Preview", the selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store its data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about the installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called ''resources''. If the software wanting to use the device is capable of requesting this resource via <tt>d-bus</tt>, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through ''SHR Setting'' or you can use <tt>fsoraw</tt> command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

See [[FSO Resources]] for more details on using the following resources:

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in <tt>/etc/network/interfaces</tt>.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

The <tt>connmand</tt> daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. The Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable it after use.

{| 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:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

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

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

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

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better than for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR uses bluez4 which is completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for a list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) does not exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your phone. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phone calls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on a µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your phone. If new keys are generated or if you flash your phone with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your phone from the file. Otherwise you might not be able to login in again until the former key is removed from <tt>known_hosts</tt>. If several distributions are alternately used on the same particular phone, it may be more convenient to copy the key files from one phone distribution to the rest. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding your phone to your hosts===

You can add your phone to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your phone is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your phone like this:

ssh root@neo

Which is shorter than this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only a few preinstalled applications but its repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is an elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.30_arm.ipk

A newer version is announced at http://lists.openmoko.org/pipermail/community/2009-August/054207.html

If you don't see some icons, copy all icons from /usr/share/icons/shr/86x86/apps/* to /usr/share/pixmaps.

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

'''Paroli''' is available in SHR images, you can install it:

opkg install paroli

fix the conf files that the paroli installer messes with (might get fixed in the next couple of days.)

cp /etc/old_frameworkd.conf /etc/frameworkd.conf
cp /etc/freesmartphone/oevents/old_rules.yaml /etc/freesmartphone/oevents/rules.yaml

now if you want to disable the shr phone apps without removing them comment all of the lines out in

/etc/X11/Xsession.d/89notifier and /etc/X11/Xsession.d/80ophonekitd

if you want the bind-home to ease upgrades add this line to fstab.

/media/card/bind-home /home/root none bind 0 0

You should now have a functional paroli on SHR setup. Once you have a working setup I would advise against doing opkg upgrades and only upgrade specific packages when needed.

''GPE contacts'' saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is a new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). Its main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| 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:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
C
[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

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

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

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is a full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

SHR User Manual

2009-08-31T18:41:34Z

Catholicon: Undo revision 75374 by Catholicon (Talk)

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

{{Note|As SHR doesn't provide testing images at the moment this manual was based on unstable images available on the beginning of August 2009. The unstable images get changed very often - the download location changes, default applications change, bugs get hunted and fixed, meaning that some parts of this manual are already outdated.}}

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your phone to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* Notes (opimd based)
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||

|-

| Internet ||
* Pidgin
* Midori (Browser)
||

|-

| Games ||
* Numptyphysics
||
|-
| Settings ||
* SHR Settings
* Mokonnect (Network Manager)
||
* SHR Settings

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links below for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

===Booting===
Press the power button until you feel a soft vibration to start the phone. The booting splash screen will appear. The first boot after a new installation always takes a bit longer. It is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| 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]]

|}

==Running SHR==

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is the default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the top shelf or by using the '''<''' left or right '''>''' arrows in the top shelf.

The Illume desktop can be easily customized - slide the top shelf down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' (the wrench) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the top shelf (for example Battery, GSM, Bluetooth etc.) are called '''shelf gadgets''' and you can configure whether they are visible (on the front part of the top shelf) or hidden (you can access them by sliding the top shelf) through Illume Settings -> Display -> Shelf gadget.

Some screens are not resized properly to fit the phone's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.

{| 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-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| 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-Mesages.png|200px|thumb|Messages]]

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

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

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

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

|}

{| 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-Mesages-Options.png|200px|thumb|Message options]]

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

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

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

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelf cross.

===Post-Installation Script===
After flashing your phone you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your phone via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on your phone with:
neo# sh /home/root/SHRpostinstallation.sh

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your phone. The <tt>root</tt> account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in <tt>/usr/share/shr/scenarii/</tt> . To customize speaker volume edit <tt>/usr/share/shr/scenarii/gsmhandset.state</tt> and change <tt>control 4</tt>. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

Another example:
5667
0-179-5667
00-49-179-5667
+49-179-5667
are equivalent numbers for German O2 service number ("-" for clarity only). So
international_prefix = 00
national_prefix = 0
country_code = 49 (without any leading "00" or "+"!)
for area code it seems wise to use "179" here, though that's the GSM-network code, not the code of your geographical area.
area_code = 179

====Initializing the opkg database====
''Initialize the opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

In the 20090808 Image, opkg update does not work you will get: -sh: opkg: not found.

There is a missing opkg symlink to opkg-cl. this is fixed in the SHR repositories.

To update:

opkg-cl update

And to upgrade

opkg-cl upgrade

opkg should work fine now.

====SwapSpace====
{{Main|SwapSpace}}
When the RAM is used up applications get killed. This is particularly bad while doing opkg upgrade. Therefore you might want to create a swap partition.

WARNING: this mights kill your SD card, since there might be a lot of read/writes to the same spot. (all recent tests failed to harm SD cards by torture write tests, so probably you just shouldn't worry)

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so 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

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

A much more convenient way might be to install your public-key to ~/.ssh/authorized_keys. For running
cmd | ssh root@neo anycommand
from your host this might be even mandatory, e.g if you want to pipe anything to the ssh.

====Locate lost phone by GPS====
To locate your phone in case of loss or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an SMS with the text sentry:location to your phone, the phone will turn on GPS, wait for a fix and send back an SMS with the current location.

[[openBmap]] and [[Cellhunter]] are projects with the objective to collect GPS location of GSM network cells. If this project is finished then SMS-sentry could send the a rough location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in the Illume top shelf go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

The local timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI contact synchronization]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI calendar synchronization]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

<pre>
opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk \\
http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 \\
python-pygtk python-pygobject python-pycairo python-netserver python-netclient \\
http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc \\
http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk \\
http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk \\
http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk \\
http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk
</pre>

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. If you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If not, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your phone you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your phone. Because of the size of the maps you copy map to the Micro-SD card on your phone. Create a directory for the maps and copy the files from desktop to phone:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
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>

===Start Navit===
Start <tt>Navit</tt> on your phone for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the phone does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

Please refer to [http://wiki.openmoko.org/wiki/FSO_Resources#Automatic_way this wiki page] about a better way to manage preventing screen dim or suspend.

While some settings are persistent over reboots, others are not.

===Main Screen===
The main screen is divided into eight categories, which contain several modules. Every SHR Settings module has a specified task - for example controlling the GSM antenna power, setting the time etc.

===Settings: Phone===
Here you can set if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After a while, a list of operators should pop up.

You can't connect to operators marked [forbidden]. After a connection failure, a message is displayed.

Selecting an operator from the list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| 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:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

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

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select the current profile, which the device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of the currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change the ring tone, click the "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting a sid tune as the ring tone, there are available controls to select tune number from the file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| 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:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

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

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| 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:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

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

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With the "WiFi radio" toggle you can set, if the wifi module is powered. WiFi radio has to be turned on before trying to connect to a WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on the actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your GPRS connection}}

To connect to the GPRS network, just click the "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, switch the "Bluetooth radio" toggle to "On". After that, the "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| 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:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

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

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting a fix. To do that, click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set the time. By default, the time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click the "OK" button.

'''Date'''

This module displays the current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update the data, click the "Update" button.

Here you can also force enable 500mA charging.

'''Display'''

With this slider you can easily set the backlight brightness.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| 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:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

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

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by the device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| 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:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

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

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on one, you can either start, restart or stop the service and view the result.

===Settings: Others===

{| 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:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

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

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select the theme used by shr-splash at boot and shutdown. After clicking "Preview", the selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store its data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about the installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called ''resources''. If the software wanting to use the device is capable of requesting this resource via <tt>d-bus</tt>, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through ''SHR Setting'' or you can use <tt>fsoraw</tt> command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

See [[FSO Resources]] for more details on using the following resources:

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in <tt>/etc/network/interfaces</tt>.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

The <tt>connmand</tt> daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. The Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable it after use.

{| 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:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

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

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

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

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better than for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR uses bluez4 which is completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for a list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) does not exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your phone. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phone calls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on a µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your phone. If new keys are generated or if you flash your phone with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your phone from the file. Otherwise you might not be able to login in again until the former key is removed from <tt>known_hosts</tt>. If several distributions are alternately used on the same particular phone, it may be more convenient to copy the key files from one phone distribution to the rest. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding your phone to your hosts===

You can add your phone to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your phone is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your phone like this:

ssh root@neo

Which is shorter than this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only a few preinstalled applications but its repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is an elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.30_arm.ipk

A newer version is announced at http://n2.nabble.com/Launcher-v-0-35-Release-inbuilt-contacts-sms-and-phonelog-td3552019.html#a3552019

If you don't see some icons, copy all icons from /usr/share/icons/shr/86x86/apps/* to /usr/share/pixmaps.

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

'''Paroli''' is available in SHR images, you can install it:

opkg install paroli

fix the conf files that the paroli installer messes with (might get fixed in the next couple of days.)

cp /etc/old_frameworkd.conf /etc/frameworkd.conf
cp /etc/freesmartphone/oevents/old_rules.yaml /etc/freesmartphone/oevents/rules.yaml

now if you want to disable the shr phone apps without removing them comment all of the lines out in

/etc/X11/Xsession.d/89notifier and /etc/X11/Xsession.d/80ophonekitd

if you want the bind-home to ease upgrades add this line to fstab.

/media/card/bind-home /home/root none bind 0 0

You should now have a functional paroli on SHR setup. Once you have a working setup I would advise against doing opkg upgrades and only upgrade specific packages when needed.

''GPE contacts'' saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is a new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). Its main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| 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:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
C
[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

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

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

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is a full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

SHR User Manual

2009-08-31T11:10:26Z

Catholicon: Updating link to latest shr launcher

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

{{Note|As SHR doesn't provide testing images at the moment this manual was based on unstable images available on the beginning of August 2009. The unstable images get changed very often - the download location changes, default applications change, bugs get hunted and fixed, meaning that some parts of this manual are already outdated.}}

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your phone to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* Notes (opimd based)
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||

|-

| Internet ||
* Pidgin
* Midori (Browser)
||

|-

| Games ||
* Numptyphysics
||
|-
| Settings ||
* SHR Settings
* Mokonnect (Network Manager)
||
* SHR Settings

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links below for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

===Booting===
Press the power button until you feel a soft vibration to start the phone. The booting splash screen will appear. The first boot after a new installation always takes a bit longer. It is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| 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]]

|}

==Running SHR==

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is the default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the top shelf or by using the '''<''' left or right '''>''' arrows in the top shelf.

The Illume desktop can be easily customized - slide the top shelf down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' (the wrench) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the top shelf (for example Battery, GSM, Bluetooth etc.) are called '''shelf gadgets''' and you can configure whether they are visible (on the front part of the top shelf) or hidden (you can access them by sliding the top shelf) through Illume Settings -> Display -> Shelf gadget.

Some screens are not resized properly to fit the phone's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.

{| 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-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| 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-Mesages.png|200px|thumb|Messages]]

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

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

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

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

|}

{| 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-Mesages-Options.png|200px|thumb|Message options]]

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

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

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

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelf cross.

===Post-Installation Script===
After flashing your phone you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your phone via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on your phone with:
neo# sh /home/root/SHRpostinstallation.sh

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your phone. The <tt>root</tt> account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in <tt>/usr/share/shr/scenarii/</tt> . To customize speaker volume edit <tt>/usr/share/shr/scenarii/gsmhandset.state</tt> and change <tt>control 4</tt>. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

Another example:
5667
0-179-5667
00-49-179-5667
+49-179-5667
are equivalent numbers for German O2 service number ("-" for clarity only). So
international_prefix = 00
national_prefix = 0
country_code = 49 (without any leading "00" or "+"!)
for area code it seems wise to use "179" here, though that's the GSM-network code, not the code of your geographical area.
area_code = 179

====Initializing the opkg database====
''Initialize the opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

In the 20090808 Image, opkg update does not work you will get: -sh: opkg: not found.

There is a missing opkg symlink to opkg-cl. this is fixed in the SHR repositories.

To update:

opkg-cl update

And to upgrade

opkg-cl upgrade

opkg should work fine now.

====SwapSpace====
{{Main|SwapSpace}}
When the RAM is used up applications get killed. This is particularly bad while doing opkg upgrade. Therefore you might want to create a swap partition.

WARNING: this mights kill your SD card, since there might be a lot of read/writes to the same spot. (all recent tests failed to harm SD cards by torture write tests, so probably you just shouldn't worry)

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so 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

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

A much more convenient way might be to install your public-key to ~/.ssh/authorized_keys. For running
cmd | ssh root@neo anycommand
from your host this might be even mandatory, e.g if you want to pipe anything to the ssh.

====Locate lost phone by GPS====
To locate your phone in case of loss or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an SMS with the text sentry:location to your phone, the phone will turn on GPS, wait for a fix and send back an SMS with the current location.

[[openBmap]] and [[Cellhunter]] are projects with the objective to collect GPS location of GSM network cells. If this project is finished then SMS-sentry could send the a rough location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in the Illume top shelf go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

The local timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI contact synchronization]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI calendar synchronization]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

<pre>
opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk \\
http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 \\
python-pygtk python-pygobject python-pycairo python-netserver python-netclient \\
http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc \\
http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk \\
http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk \\
http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk \\
http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk
</pre>

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. If you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If not, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your phone you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your phone. Because of the size of the maps you copy map to the Micro-SD card on your phone. Create a directory for the maps and copy the files from desktop to phone:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
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>

===Start Navit===
Start <tt>Navit</tt> on your phone for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the phone does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

Please refer to [http://wiki.openmoko.org/wiki/FSO_Resources#Automatic_way this wiki page] about a better way to manage preventing screen dim or suspend.

While some settings are persistent over reboots, others are not.

===Main Screen===
The main screen is divided into eight categories, which contain several modules. Every SHR Settings module has a specified task - for example controlling the GSM antenna power, setting the time etc.

===Settings: Phone===
Here you can set if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After a while, a list of operators should pop up.

You can't connect to operators marked [forbidden]. After a connection failure, a message is displayed.

Selecting an operator from the list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| 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:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

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

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select the current profile, which the device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of the currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change the ring tone, click the "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting a sid tune as the ring tone, there are available controls to select tune number from the file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| 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:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

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

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| 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:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

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

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With the "WiFi radio" toggle you can set, if the wifi module is powered. WiFi radio has to be turned on before trying to connect to a WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on the actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your GPRS connection}}

To connect to the GPRS network, just click the "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, switch the "Bluetooth radio" toggle to "On". After that, the "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| 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:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

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

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting a fix. To do that, click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set the time. By default, the time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click the "OK" button.

'''Date'''

This module displays the current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update the data, click the "Update" button.

Here you can also force enable 500mA charging.

'''Display'''

With this slider you can easily set the backlight brightness.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| 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:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

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

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by the device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| 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:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

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

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on one, you can either start, restart or stop the service and view the result.

===Settings: Others===

{| 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:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

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

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select the theme used by shr-splash at boot and shutdown. After clicking "Preview", the selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store its data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about the installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called ''resources''. If the software wanting to use the device is capable of requesting this resource via <tt>d-bus</tt>, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through ''SHR Setting'' or you can use <tt>fsoraw</tt> command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

See [[FSO Resources]] for more details on using the following resources:

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in <tt>/etc/network/interfaces</tt>.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

The <tt>connmand</tt> daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. The Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable it after use.

{| 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:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

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

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

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

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better than for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR uses bluez4 which is completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for a list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) does not exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your phone. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phone calls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on a µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your phone. If new keys are generated or if you flash your phone with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your phone from the file. Otherwise you might not be able to login in again until the former key is removed from <tt>known_hosts</tt>. If several distributions are alternately used on the same particular phone, it may be more convenient to copy the key files from one phone distribution to the rest. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding your phone to your hosts===

You can add your phone to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your phone is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your phone like this:

ssh root@neo

Which is shorter than this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only a few preinstalled applications but its repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is an elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://n2.nabble.com/file/n3552019/launcher_0.35_arm.ipk

If you don't see some icons, copy all icons from /usr/share/icons/shr/86x86/apps/* to /usr/share/pixmaps.

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

'''Paroli''' is available in SHR images, you can install it:

opkg install paroli

fix the conf files that the paroli installer messes with (might get fixed in the next couple of days.)

cp /etc/old_frameworkd.conf /etc/frameworkd.conf
cp /etc/freesmartphone/oevents/old_rules.yaml /etc/freesmartphone/oevents/rules.yaml

now if you want to disable the shr phone apps without removing them comment all of the lines out in

/etc/X11/Xsession.d/89notifier and /etc/X11/Xsession.d/80ophonekitd

if you want the bind-home to ease upgrades add this line to fstab.

/media/card/bind-home /home/root none bind 0 0

You should now have a functional paroli on SHR setup. Once you have a working setup I would advise against doing opkg upgrades and only upgrade specific packages when needed.

''GPE contacts'' saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is a new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). Its main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| 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:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
C
[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

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

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

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is a full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

Alsa state a7

2009-07-31T07:52:21Z

Catholicon:

Here it is - the alsa state to A7 version and Buzz fixed A5/A6
http://docs.openmoko.org/trac/raw-attachment/ticket/2121/gsmhandset-a7.state

just do in the neo

mv /usr/share/openmoko/scenarios/gsmhandset.state /usr/share/openmoko/scenarios/gsmhandset.state.old
wget http://docs.openmoko.org/trac/raw-attachment/ticket/2121/gsmhandset-a7.state -O /usr/share/openmoko/scenarios/gsmhandset.state
''If the distro is using fso then check /etc/frameworkd.conf to check which directory contains the scenario files. For SHR this directory is /usr/share/shr/scenarii -- Vikas''

'''Troubleshooting:'''

Altough this statefile is supposed to be "the one" it seems it doesn't work perfectly for all models. Here are some hints you can try if you still have problems with audio during phonecalls:

* In case the other end complains about a rustling noise (like a flee would sit in the mic and move around) try correcting the "Mono Playback Volume" down. I have changed the value in the file to 89 and the phonecalls are now clear as they should be (On buzz-fixed A5).

* Some people reported it helps to set the Playbackvolume in FSO down a bit:
This will set the volume to 68%:
mdbus -s org.freesmartphone.ogsmd /org/freesmartphone/GSM/Device org.freesmartphone.GSM.Device.SetSpeakerVolume 68
To read the current value:
mdbus -s org.freesmartphone.ogsmd /org/freesmartphone/GSM/Device org.freesmartphone.GSM.Device.GetSpeakerVolume

* If it still doesn't work try fiddling around with the "Speaker Volume" in your statefile.

''I recommend the other way round: fiddle with the Speaker Playback Volume and leave the calypso control alone! -- PaulFertser''

[[Category:Audio]]

GPRS FSO

2009-07-19T19:56:32Z

Catholicon: Setting up on-demand GPRS on boot

{{FSO}}
This page documents the GSM networking solutions (commonly known as GPRS) using the [[OpenmokoFramework|FreeSmartphone.Org]] framework (FSO).

There are other ways to enable wireless communications on the smartphone, including [[Bluetooth]] and [[Wireless_Networking|WLAN]].

== Current state ==

Since milestone 2 the system dbus has been extended with methods that enables connectivity using GPRS. The functionality is available under <code>org.freesmartphone.ogsmd</code> at <code>/org/freesmartphone/GSM/Device</code>.

The implementation should not interfere with other phone functionality, such as placing calls. In other words: you can use GPRS while talking on the phone without hanging up. Note though that depending on hardware and networking, simultaneous data transmission and voice call alerting (let alone performing calls) might not be possible.

Since FSO is a middleware it offers no GUI, however it's fairly easy to use the methods available using any dbus tool.

The methods available:
[METHOD] org.freesmartphone.GSM.PDP.ActivateContext( s:apn, s:user, s:password )
[METHOD] org.freesmartphone.GSM.PDP.DeactivateContext()
[METHOD] org.freesmartphone.GSM.PDP.GetCurrentGprsClass()
[METHOD] org.freesmartphone.GSM.PDP.ListAvailableGprsClasses()
[METHOD] org.freesmartphone.GSM.PDP.SetCurrentGprsClass( s:class_ )
[SIGNAL] org.freesmartphone.GSM.PDP.ContextStatus( i:index, s:status, a{sv}:properties )

Use ''mdbus -s -l'' to monitor the emitted signals. Signals will look roughly like this:

:ActivateContext( s:apn, s:user, s:password )
<pre>
[SIGNAL] org.freesmartphone.GSM.PDP.ContextStatus
from :1.3 /org/freesmartphone/GSM/Device
(dbus.Int32(1), dbus.String(u'outgoing'),
dbus.Dictionary({}, signature=dbus.Signature('sv')))
</pre>
:Once the connection is established (takes 3-4 seconds for me) a new signal is emitted
<pre>
[SIGNAL] org.freesmartphone.GSM.PDP.ContextStatus
from :1.3 /org/freesmartphone/GSM/Device
(dbus.Int32(1), dbus.String(u'active'),
dbus.Dictionary({}, signature=dbus.Signature('sv')))
</pre>
:DeactivateContext
<pre>
[SIGNAL] org.freesmartphone.GSM.PDP.ContextStatus
from :1.3 /org/freesmartphone/GSM/Device
(dbus.Int32(1), dbus.String(u'release'),
dbus.Dictionary({}, signature=dbus.Signature('sv')))
</pre>

== Using scripts ==

While we wait for the preferences part of FSO to be completed (and a GUI), we can use two shell scripts. You need to know three things to successfully connect via GPRS (your carrier should provide this information to you):
* the APN to use,
* the username, and
* the password.
If your APN has no username or password, you must still provide a string to satisfy the framework's input requirements. Entering bogus data, such as the "x" above, will suffice.

To connect, put the following in a file and make it executable (<code>chmod +x gprs-on.sh</code>):
<pre>
#!/bin/sh
APN="internet.parlino.se"
USERNAME="x"
PASSWORD="x"
BUSNAME="org.freesmartphone.ogsmd"
OBJECTPATH="/org/freesmartphone/GSM/Device"
METHODNAME="org.freesmartphone.GSM.PDP.ActivateContext"
mdbus -s $BUSNAME $OBJECTPATH $METHODNAME $APN "$USERNAME" "$PASSWORD"
</pre>
To disconnect, use the following method instead (<code>chmod +x gprs-off.sh</code>):
<pre>
#!/bin/sh
BUSNAME="org.freesmartphone.ogsmd"
OBJECTPATH="/org/freesmartphone/GSM/Device"
METHODNAME="org.freesmartphone.GSM.PDP.DeactivateContext"
mdbus -s $BUSNAME $OBJECTPATH $METHODNAME
</pre>
The ''on'' script, using the ActivateContext method, will:
* setup a ppp interface (normally ppp0) (and assign IP address)
* setup (replace) the default route
* setup DNS
with settings received from the ISP.

For a list of known APN:s, see the [[GPRS#Some_APN_names_for_reference|main GPRS page]].

== Troubleshooting ==

* When a something like '''org.freedesktop.DBus.Error.UnknownMethod''' appears make sure that:
** frameworkd is started of course
** That the method did not hide in an other place than expected follow the white [[D-Bus|Rabbit]]
* Online script runs without error but pppd did not start
** use '''logread''' to debug....
** Maybe the kernel module ppp-generic is not loaded, try modprobe. ( you can do '''echo ppp-generic > /etc/modutils/ppp-generic''' and then '''update-modules''' to load the module at boot time )
** Maybe you have to do a '''mknod /dev/ppp c 108 0'''
* No MUX Channels available
** Means that the frameworkd has no free channel available to connect to the GSM Modem.
** Restart the frameworkd and the phone Application (aka ophoned or zhone). Works fine for me.
* MISC Troubleshooting
** Switch the frameworkd loglevel to DEBUG (/etc/frameworkd.conf)
** use the source!

== Using a GUI ==
[[Framework-settings]]

== SHR (Unstable??) ==
SHR is based on FSO, so I think its GPRS settings should be found here. Shr has its native setting manager which has Connectivity sub-panel which in turn has settings for GPRS. Its very intutive and your GPRS/FR should be up and running in no time.

To enable gprs on-demand you need to do some manual changes in framework code.
Alter, /usr/lib/python2.6/site-packages/framework/subsystems/ogsmd/modems/abstract/modem.py
as:
--- orig.modem.py Sat Jul 18 02:13:29 2009
+++ modem.py Sat Jul 18 02:13:06 2009
@@ -76,6 +76,8 @@
'proxyarp',
'replacedefaultroute',
'usepeerdns',
+ 'demand',
+ 'idle', '20',
]

self._data["pppd-does-setup-and-teardown"] = True # default
is using connect and disconnect scripts

Alter, /usr/lib/python2.6/site-packages/framework/subsystems/ogsmd/modems/abstract/pdp.py
as:
--- orig.pdp.py Sat Jul 18 04:20:13 2009
+++ pdp.py Sat Jul 18 04:19:03 2009
@@ -219,7 +219,8 @@
"""

PPP_DAEMON_SETUP["/etc/ppp/ip-down.d/92removedns"] = """#!/bin/sh -e
-echo nameserver 127.0.0.1 > /etc/resolv.conf
+echo nameserver 208.67.222.222 > /etc/resolv.conf
+echo nameserver 208.67.220.220 >> /etc/resolv.conf
"""

PPP_DAEMON_SETUP[PPP_PAP_SECRETS_FILENAME] = '* * "%s" *\n' % ''

modem.py needs to be updated to setup idle timeout and auto reconnect. While pdp.py needs to be updated so ppp idle timeout resets /etc/resolv.conf to OpenDNS servers

Now, just fire up settings panel (need to be done once per boot) and in connectivity click connect for Gprs...for me it doesn't show connected anymore...but then I don't really care about that as long as the connection works :). To do this on bootup automatically check out the next section.
=== Enable on-demand GPRS at boot ===
* Put init-gprs.py and kill-init-gprs.py in /usr/bin and make them executable.
* Put bootup-gprs in /etc/init.d and make that executable too.
* Next execute 'update-rc.d bootup-gprs defaults 99 01' to install the init script on bootup and shutdown

init-gprs.py
#!/usr/bin/env python
import dbus
from dbus.exceptions import DBusException

from dbus.mainloop.glib import DBusGMainLoop
import gobject
DBusGMainLoop(set_as_default=True)
loop = gobject.MainLoop()

bus = dbus.SystemBus()

def activate_gprs():
print "Activating GPRS"
local_gsm_obj = bus.get_object("org.freesmartphone.ogsmd", "/org/freesmartphone/GSM/Device")
pdpIFace = dbus.Interface(local_gsm_obj, "org.freesmartphone.GSM.PDP");
pdpIFace.ActivateContext("airtelgprs.com", "x", "x")

def on_sim_ready(ready):
print "On ready received: " + str(ready)
if not ready:
print "Waiting for SIM to get ready...its still not up"
return
if loop.is_running():
loop.quit()
activate_gprs()

needLoop = True
try:
gsm_device_obj = bus.get_object("org.freesmartphone.ogsmd", "/org/freesmartphone/GSM/Device")
simIFace = dbus.Interface(gsm_device_obj, "org.freesmartphone.GSM.SIM")

if simIFace.GetSimReady():
print "Sim was already up"
needLoop = False
activate_gprs()
else:
print "Sim is not ready...need to wait"
simIFace.connect_to_signal("ReadyStatus", on_sim_ready)
except DBusException:
print "caught the exception->"
bus.add_signal_receiver(on_sim_ready, signal_name='ReadyStatus', \
dbus_interface='org.freesmartphone.GSM.SIM', \
bus_name='org.freesmartphone.ogsmd')

if needLoop:
loop.run()

kill-init-gprs.py
#!/usr/bin/env python
import dbus

bus = dbus.SystemBus()
gsm_device_obj = bus.get_object("org.freesmartphone.ogsmd", "/org/freesmartphone/GSM/Device")
pdpIFace = dbus.Interface(gsm_device_obj, "org.freesmartphone.GSM.PDP")
pdpIFace.DeactivateContext()

bootup-gprs
#! /bin/sh

NAME=bootup-gprs
PATH=/bin:/usr/bin:/sbin:/usr/sbin

echo "1::$1::/var/run/${NAME}"
case "$1" in
start)
if [ -f /var/run/${NAME} ]; then
echo "Initial gprs connection is already running. If you think its not then delete /var/run/${NAME}"
else
echo "Starting initial gprs connection"
init-gprs.py > /var/run/${NAME} &
fi
;;
stop)
echo "Stopping initial gprs connection"
kill-init-gprs.py
rm -f /var/run/${NAME}
;;
restart|force-reload)
$0 stop
$0 start
;;
*)
echo "Usage: /etc/init.d/bootup-gprs {start|stop|restart|force-reload}"
exit 1
;;
esac

exit 0

Note: We are updating the framework file which can be updated by any of the frameword update and one need to repeat the update (well..until a nifty setting comes into setting panel somewhere :)

== See also ==
* [[GPRS]]
* [[OpenmokoFramework/mdbus]]

[[Category:FSO]]
[[Category:GPRS]]

GPRS FSO

2009-07-17T23:08:38Z

Catholicon:

{{FSO}}
This page documents the GSM networking solutions (commonly known as GPRS) using the [[OpenmokoFramework|FreeSmartphone.Org]] framework (FSO).

There are other ways to enable wireless communications on the smartphone, including [[Bluetooth]] and [[Wireless_Networking|WLAN]].

== Current state ==

Since milestone 2 the system dbus has been extended with methods that enables connectivity using GPRS. The functionality is available under <code>org.freesmartphone.ogsmd</code> at <code>/org/freesmartphone/GSM/Device</code>.

The implementation should not interfere with other phone functionality, such as placing calls. In other words: you can use GPRS while talking on the phone without hanging up. Note though that depending on hardware and networking, simultaneous data transmission and voice call alerting (let alone performing calls) might not be possible.

Since FSO is a middleware it offers no GUI, however it's fairly easy to use the methods available using any dbus tool.

The methods available:
[METHOD] org.freesmartphone.GSM.PDP.ActivateContext( s:apn, s:user, s:password )
[METHOD] org.freesmartphone.GSM.PDP.DeactivateContext()
[METHOD] org.freesmartphone.GSM.PDP.GetCurrentGprsClass()
[METHOD] org.freesmartphone.GSM.PDP.ListAvailableGprsClasses()
[METHOD] org.freesmartphone.GSM.PDP.SetCurrentGprsClass( s:class_ )
[SIGNAL] org.freesmartphone.GSM.PDP.ContextStatus( i:index, s:status, a{sv}:properties )

Use ''mdbus -s -l'' to monitor the emitted signals. Signals will look roughly like this:

:ActivateContext( s:apn, s:user, s:password )
<pre>
[SIGNAL] org.freesmartphone.GSM.PDP.ContextStatus
from :1.3 /org/freesmartphone/GSM/Device
(dbus.Int32(1), dbus.String(u'outgoing'),
dbus.Dictionary({}, signature=dbus.Signature('sv')))
</pre>
:Once the connection is established (takes 3-4 seconds for me) a new signal is emitted
<pre>
[SIGNAL] org.freesmartphone.GSM.PDP.ContextStatus
from :1.3 /org/freesmartphone/GSM/Device
(dbus.Int32(1), dbus.String(u'active'),
dbus.Dictionary({}, signature=dbus.Signature('sv')))
</pre>
:DeactivateContext
<pre>
[SIGNAL] org.freesmartphone.GSM.PDP.ContextStatus
from :1.3 /org/freesmartphone/GSM/Device
(dbus.Int32(1), dbus.String(u'release'),
dbus.Dictionary({}, signature=dbus.Signature('sv')))
</pre>

== Using scripts ==

While we wait for the preferences part of FSO to be completed (and a GUI), we can use two shell scripts. You need to know three things to successfully connect via GPRS (your carrier should provide this information to you):
* the APN to use,
* the username, and
* the password.
If your APN has no username or password, you must still provide a string to satisfy the framework's input requirements. Entering bogus data, such as the "x" above, will suffice.

To connect, put the following in a file and make it executable (<code>chmod +x gprs-on.sh</code>):
<pre>
#!/bin/sh
APN="internet.parlino.se"
USERNAME="x"
PASSWORD="x"
BUSNAME="org.freesmartphone.ogsmd"
OBJECTPATH="/org/freesmartphone/GSM/Device"
METHODNAME="org.freesmartphone.GSM.PDP.ActivateContext"
mdbus -s $BUSNAME $OBJECTPATH $METHODNAME $APN "$USERNAME" "$PASSWORD"
</pre>
To disconnect, use the following method instead (<code>chmod +x gprs-off.sh</code>):
<pre>
#!/bin/sh
BUSNAME="org.freesmartphone.ogsmd"
OBJECTPATH="/org/freesmartphone/GSM/Device"
METHODNAME="org.freesmartphone.GSM.PDP.DeactivateContext"
mdbus -s $BUSNAME $OBJECTPATH $METHODNAME
</pre>
The ''on'' script, using the ActivateContext method, will:
* setup a ppp interface (normally ppp0) (and assign IP address)
* setup (replace) the default route
* setup DNS
with settings received from the ISP.

For a list of known APN:s, see the [[GPRS#Some_APN_names_for_reference|main GPRS page]].

== Troubleshooting ==

* When a something like '''org.freedesktop.DBus.Error.UnknownMethod''' appears make sure that:
** frameworkd is started of course
** That the method did not hide in an other place than expected follow the white [[D-Bus|Rabbit]]
* Online script runs without error but pppd did not start
** use '''logread''' to debug....
** Maybe the kernel module ppp-generic is not loaded, try modprobe. ( you can do '''echo ppp-generic > /etc/modutils/ppp-generic''' and then '''update-modules''' to load the module at boot time )
** Maybe you have to do a '''mknod /dev/ppp c 108 0'''
* No MUX Channels available
** Means that the frameworkd has no free channel available to connect to the GSM Modem.
** Restart the frameworkd and the phone Application (aka ophoned or zhone). Works fine for me.
* MISC Troubleshooting
** Switch the frameworkd loglevel to DEBUG (/etc/frameworkd.conf)
** use the source!

== Using a GUI ==
[[Framework-settings]]

== SHR (Unstable??) ==
SHR is based on FSO, so I think its GPRS settings should be found here. Shr has its native setting manager which has Connectivity sub-panel which in turn has settings for GPRS. Its very intutive and your GPRS/FR should be up and running in no time.

To enable gprs on-demand you need to do some manual changes in framework code.
Alter, /usr/lib/python2.6/site-packages/framework/subsystems/ogsmd/modems/abstract/modem.py
as:
--- orig.modem.py Sat Jul 18 02:13:29 2009
+++ modem.py Sat Jul 18 02:13:06 2009
@@ -76,6 +76,8 @@
'proxyarp',
'replacedefaultroute',
'usepeerdns',
+ 'demand',
+ 'idle', '20',
]

self._data["pppd-does-setup-and-teardown"] = True # default
is using connect and disconnect scripts

Alter, /usr/lib/python2.6/site-packages/framework/subsystems/ogsmd/modems/abstract/pdp.py
as:
--- orig.pdp.py Sat Jul 18 04:20:13 2009
+++ pdp.py Sat Jul 18 04:19:03 2009
@@ -219,7 +219,8 @@
"""

PPP_DAEMON_SETUP["/etc/ppp/ip-down.d/92removedns"] = """#!/bin/sh -e
-echo nameserver 127.0.0.1 > /etc/resolv.conf
+echo nameserver 208.67.222.222 > /etc/resolv.conf
+echo nameserver 208.67.220.220 >> /etc/resolv.conf
"""

PPP_DAEMON_SETUP[PPP_PAP_SECRETS_FILENAME] = '* * "%s" *\n' % ''

modem.py needs to be updated to setup idle timeout and auto reconnect. While pdp.py needs to be updated so ppp idle timeout resets /etc/resolv.conf to OpenDNS servers

Now, just fire up settings panel (need to be done once per boot) and in connectivity click connect for Gprs...for me it doesn't show connected anymore...but then I don't really care about that as long as the connection works :) --Todo: write a python app to wait for SIM-ready and then fire ActivateContext automatically at bootup

Note: We are updating the framework file which can be updated by any of the frameword update and one need to repeat the update (well..until a nifty setting comes into setting panel somewhere :)

== See also ==
* [[GPRS]]
* [[OpenmokoFramework/mdbus]]

[[Category:FSO]]
[[Category:Networking]]
[[Category:Advanced End User]]

GPRS FSO

2009-07-17T23:03:27Z

Catholicon: GPRS for SHR

{{FSO}}
This page documents the GSM networking solutions (commonly known as GPRS) using the [[OpenmokoFramework|FreeSmartphone.Org]] framework (FSO).

There are other ways to enable wireless communications on the smartphone, including [[Bluetooth]] and [[Wireless_Networking|WLAN]].

== Current state ==

Since milestone 2 the system dbus has been extended with methods that enables connectivity using GPRS. The functionality is available under <code>org.freesmartphone.ogsmd</code> at <code>/org/freesmartphone/GSM/Device</code>.

The implementation should not interfere with other phone functionality, such as placing calls. In other words: you can use GPRS while talking on the phone without hanging up. Note though that depending on hardware and networking, simultaneous data transmission and voice call alerting (let alone performing calls) might not be possible.

Since FSO is a middleware it offers no GUI, however it's fairly easy to use the methods available using any dbus tool.

The methods available:
[METHOD] org.freesmartphone.GSM.PDP.ActivateContext( s:apn, s:user, s:password )
[METHOD] org.freesmartphone.GSM.PDP.DeactivateContext()
[METHOD] org.freesmartphone.GSM.PDP.GetCurrentGprsClass()
[METHOD] org.freesmartphone.GSM.PDP.ListAvailableGprsClasses()
[METHOD] org.freesmartphone.GSM.PDP.SetCurrentGprsClass( s:class_ )
[SIGNAL] org.freesmartphone.GSM.PDP.ContextStatus( i:index, s:status, a{sv}:properties )

Use ''mdbus -s -l'' to monitor the emitted signals. Signals will look roughly like this:

:ActivateContext( s:apn, s:user, s:password )
<pre>
[SIGNAL] org.freesmartphone.GSM.PDP.ContextStatus
from :1.3 /org/freesmartphone/GSM/Device
(dbus.Int32(1), dbus.String(u'outgoing'),
dbus.Dictionary({}, signature=dbus.Signature('sv')))
</pre>
:Once the connection is established (takes 3-4 seconds for me) a new signal is emitted
<pre>
[SIGNAL] org.freesmartphone.GSM.PDP.ContextStatus
from :1.3 /org/freesmartphone/GSM/Device
(dbus.Int32(1), dbus.String(u'active'),
dbus.Dictionary({}, signature=dbus.Signature('sv')))
</pre>
:DeactivateContext
<pre>
[SIGNAL] org.freesmartphone.GSM.PDP.ContextStatus
from :1.3 /org/freesmartphone/GSM/Device
(dbus.Int32(1), dbus.String(u'release'),
dbus.Dictionary({}, signature=dbus.Signature('sv')))
</pre>

== Using scripts ==

While we wait for the preferences part of FSO to be completed (and a GUI), we can use two shell scripts. You need to know three things to successfully connect via GPRS (your carrier should provide this information to you):
* the APN to use,
* the username, and
* the password.
If your APN has no username or password, you must still provide a string to satisfy the framework's input requirements. Entering bogus data, such as the "x" above, will suffice.

To connect, put the following in a file and make it executable (<code>chmod +x gprs-on.sh</code>):
<pre>
#!/bin/sh
APN="internet.parlino.se"
USERNAME="x"
PASSWORD="x"
BUSNAME="org.freesmartphone.ogsmd"
OBJECTPATH="/org/freesmartphone/GSM/Device"
METHODNAME="org.freesmartphone.GSM.PDP.ActivateContext"
mdbus -s $BUSNAME $OBJECTPATH $METHODNAME $APN "$USERNAME" "$PASSWORD"
</pre>
To disconnect, use the following method instead (<code>chmod +x gprs-off.sh</code>):
<pre>
#!/bin/sh
BUSNAME="org.freesmartphone.ogsmd"
OBJECTPATH="/org/freesmartphone/GSM/Device"
METHODNAME="org.freesmartphone.GSM.PDP.DeactivateContext"
mdbus -s $BUSNAME $OBJECTPATH $METHODNAME
</pre>
The ''on'' script, using the ActivateContext method, will:
* setup a ppp interface (normally ppp0) (and assign IP address)
* setup (replace) the default route
* setup DNS
with settings received from the ISP.

For a list of known APN:s, see the [[GPRS#Some_APN_names_for_reference|main GPRS page]].

== Troubleshooting ==

* When a something like '''org.freedesktop.DBus.Error.UnknownMethod''' appears make sure that:
** frameworkd is started of course
** That the method did not hide in an other place than expected follow the white [[D-Bus|Rabbit]]
* Online script runs without error but pppd did not start
** use '''logread''' to debug....
** Maybe the kernel module ppp-generic is not loaded, try modprobe. ( you can do '''echo ppp-generic > /etc/modutils/ppp-generic''' and then '''update-modules''' to load the module at boot time )
** Maybe you have to do a '''mknod /dev/ppp c 108 0'''
* No MUX Channels available
** Means that the frameworkd has no free channel available to connect to the GSM Modem.
** Restart the frameworkd and the phone Application (aka ophoned or zhone). Works fine for me.
* MISC Troubleshooting
** Switch the frameworkd loglevel to DEBUG (/etc/frameworkd.conf)
** use the source!

== Using a GUI ==
[[Framework-settings]]

== SHR (Unstable??) ==
SHR is based on FSO, so I think its GPRS settings should be found here. Shr has its native setting manager which has Connectivity sub-panel which in turn has settings for GPRS. Its very intutive and your GPRS/FR should be up and running in no time.

To enable gprs on-demand you need to do some manual changes in framework code.
Alter, /usr/lib/python2.6/site-packages/framework/subsystems/ogsmd/modems/abstract/modem.py
as:
--- orig.modem.py Sat Jul 18 02:13:29 2009
+++ modem.py Sat Jul 18 02:13:06 2009
@@ -76,6 +76,8 @@
'proxyarp',
'replacedefaultroute',
'usepeerdns',
+ 'demand',
+ 'idle', '20',
]

self._data["pppd-does-setup-and-teardown"] = True # default
is using connect and disconnect scripts

Alter, /usr/lib/python2.6/site-packages/framework/subsystems/ogsmd/modems/abstract/pdp.py
as:
--- orig.pdp.py Sat Jul 18 04:20:13 2009
+++ pdp.py Sat Jul 18 04:19:03 2009
@@ -219,7 +219,8 @@
"""

PPP_DAEMON_SETUP["/etc/ppp/ip-down.d/92removedns"] = """#!/bin/sh -e
-echo nameserver 127.0.0.1 > /etc/resolv.conf
+echo nameserver 208.67.222.222 > /etc/resolv.conf
+echo nameserver 208.67.220.220 >> /etc/resolv.conf
"""

PPP_DAEMON_SETUP[PPP_PAP_SECRETS_FILENAME] = '* * "%s" *\n' % ''

modem.py needs to be updated to setup idle timeout and auto reconnect. While pdp.py needs to be updated so ppp idle timeout resets /etc/resolv.conf to OpenDNS servers

Now, just fire up settings panel (need to be done once per boot) and
in connectivity click connect for Gprs...for me it doesn't show
connected anymore...but then I don't really care about that as long as
the connection works :)

Note: We are updating the framework file which can be updated by any
of the frameword update and one need to repeat the update (well..until
a nifty setting comes into setting panel somewhere :)

== See also ==
* [[GPRS]]
* [[OpenmokoFramework/mdbus]]

[[Category:FSO]]
[[Category:Networking]]
[[Category:Advanced End User]]

Openmoko Local Groups: Delhi

2009-01-07T17:37:06Z

Catholicon:

Welcome to the Delhi Openmoko page!

This group is for anyone in Delhi.

{|border=1
!Name
!Skills
!Level of Interest
!Location
!Other
|-
| [[User:Sublime|Deepank Gupta]]
| C Programming
| Developing on GTA01Bv4 phone
| New Delhi
| Nothing in particular
|-
| [[User:Sublime|Phani Kumar]]
| C Programming
| Developing on GTA01
| Hyderabad
| Nothing in particular
|-
| [[User:khoonirobo|Vibhav Sharma]]
| C / C++ / Java Programming
| User GTA02, Developer if get an itch
| Gurgaon
| Nothing in particular
|-
| [[User:catholicon|Vikas Saurabh]]
| C++ / Actionscript
| User of GTA02
| Noida
| Sleep and Bakarr (Indian Lingo)
|}

[[Category:Openmoko Local Groups]]

Manually using GPRS

2008-08-09T21:41:22Z

Catholicon: Correcting the sort order

The GPRS connection is made using the PPP protocol to a server identified by an "APN" at the network operator.

The program that implements PPP on Linux is [[pppd]], which we need to configure and run to get a connection. When that is working, we can configure pppd to wait until it's needed before it connects, and to disconnect if the connection becomes idle. Further, we can start pppd in the background during the boot process.

== Configuring pppd for manual connections ==

You'll need /etc/ppp/peers/gprs:
<pre>
# Uncomment the following if you want some debug.
#debug
#logfile /var/volatile/log/pppd.log
lock
/dev/ttySAC0 115200
crtscts
connect /etc/ppp/gprs-connect-chat
disconnect /etc/ppp/gprs-disconnect-chat
hide-password
usepeerdns
ipcp-accept-local
noauth
noipdefault
novj
novjccomp
defaultroute
replacedefaultroute
# Reopen the connection if it fails, pausing for a while.
persist
holdoff 15
# Check the line every 20 seconds and presume
# the peer is gone if no replay for 4 times.
lcp-echo-interval 20
lcp-echo-failure 4
</pre>

Depending on the APN, you may need password authentication using CHAP or PAP. In /etc/ppp/pap-secrets you can add the following default line for "password-less" connections:

<pre>
# client server secret IP addresses
* * "" *
</pre>

For CHAP, lines in /etc/ppp/chap-secrets are used. For PAP, the lines are in /etc/ppp/pap-secrets. The client should match the "user" option in pppd the config file (below). You can use * to mean any here, but the option user "" doesn't mean empty!

For example:

<pre>
# Secrets for authentication using CHAP
# client server secret IP addresses
"user" * "password" *
</pre>

For this you need the following options in /etc/ppp/peers/gprs:

<pre>
# username to use for authentication, should match "client" in /etc/ppp/{chap,pap}-secrets
user "user"
</pre>

== gprs-connect-chat, version 1 ==

You'll also need /etc/ppp/gprs-connect-chat (needs "chmod +x"):

<pre>
#!/bin/sh -e
exec chat -v -S -s\
TIMEOUT 15\
"" "\K\K\K\d+++ATH"\
OK-AT-OK ATZ\
OK ATE1\
ABORT BUSY\
ABORT DELAYED\
ABORT "NO ANSWER"\
ABORT "NO DIALTONE"\
ABORT VOICE\
ABORT ERROR\
ABORT RINGING\
TIMEOUT 60\
OK AT+CFUN=1\
OK AT+COPS\
OK AT+CGDCONT=1,\"IP\",\"internet\"\
OK ATD*99#\
CONNECT /n/d
</pre>

== gprs-connect-chat, version 2 ==

Update: On my freerunner the first AT+CFUN=1 always generated ERROR. I managed to get gprs work by using the following script from http://lists.openmoko.org/pipermail/community/2008-July/023246.html:

<pre>
#!/bin/sh -e
exec /usr/sbin/chat -v \
TIMEOUT 10 \
OK-AT-'' ''\
ABORT BUSY\
ABORT DELAYED\
ABORT "NO ANSWER"\
ABORT "NO DIALTONE"\
ABORT VOICE\
ABORT ERROR\
ABORT RINGING\
TIMEOUT 30 \
'' ATZ\
OK ATE1\
OK AT+CFUN=1\
ERROR AT+CPIN=\"XXXX\"\ << USE YOUR OWN
OK AT+COPS\
OK AT+CGDCONT=1,\"IP\",\"internet\"\
OK 'ATDT*99***1#'\
CONNECT ''
</pre>

The error seems to vary a bit, sometimes it's before AT+COPS, sometimes as above. I have two versions of the gprs-connect-chat, which I vary between depending on which is needed. Or is there a way to specify two acceptable answers like {OK,ERROR}?

You will need to adjust the APN name "internet" in at+cgdcont line and possibly the phone number in the ATD line to match what your network operator provides. See below in the table "Some APN names for reference" for the right settings for your operator.

== gprs-disconnect-chat ==

Also good to have is /etc/ppp/gprs-disconnect-chat (needs "chmod +x"):

<pre>
#!/bin/sh -e
/usr/sbin/chat -v\
ABORT OK\
ABORT BUSY\
ABORT DELAYED\
ABORT "NO ANSWER"\
ABORT "NO CARRIER"\
ABORT "NO DIALTONE"\
ABORT VOICE\
ABORT ERROR\
ABORT RINGING\
TIMEOUT 12\
"" "\K\K\K\d+++ATH"\
"NO CARRIER-AT-OK" "\c"
</pre>

== Starting PPP connection ==

The following script can be used to start the ppp connection. First it stops gsmd because gsmd may put the phone in a unknown state. It then turns on the power to the phone, modifies the ownership, and then creates a tty connection. Finally it starts [[pppd]] with the gprs settings.

<pre>
/etc/init.d/gsmd stop
echo "1" > /sys/bus/platform/devices/neo1973-pm-gsm.0/power_on
chown uucp.uucp /dev/ttySAC0
stty -F /dev/ttySAC0 crtscts
pppd call gprs
</pre>

If you are having problems connecting ensure you have a good GSM signal and replace the last line with the below line. This will allow you to see the details of the connection on the console.

<pre>
pppd debug nodetach call gprs
</pre>

The config above will establish a persistant link over gprs. The battery will run low in less than an hour. See an example for an on-demand config below.

=== Resolve.conf issues ===

The latest build seems to have solved the following issue, it should be automatically updated by pppd.

If you expeience DNS issues after connecting to DNS you may need a proper /etc/resolv.conf:

<pre>
ln -sf /var/run/resolv.conf /etc
</pre>

If needed put your nameserver for usb-net into /var/run/resolv.conf, not in /etc.

The image does not set a correct resolv.conf. i do so with an

<pre>
echo nameserver 192.168.0.201 > /var/run/resolv.conf
</pre>

in the right place. because a post-up in /etc/network/interfaces is not supported i do that in /etc/network/if-up.d/08setupdns

another problem is pppd's /etc/ppp/ip-down.d/92removedns which does not properly remove the link when shuting down ppp. my fix is this script:

<pre>
#!/bin/sh
ACTUALCONF=/var/run/resolv.conf
PPPCONF=/var/run/ppp/resolv.conf
if [ -f $PPPCONF ] ; then
if [ -f $ACTUALCONF ] ; then
if [ ! -h $ACTUALCONF -o ! "`readlink $ACTUALCONF 2>&1`" = "$PPPCONF" ] ; then
mv $ACTUALCONF $ACTUALCONF.ppporig
fi
fi

ln -sf $PPPCONF $ACTUALCONF
fi
</pre>

=== Some APN names for reference ===

{| border="1"
! Country
! Carrier
! Plan
! APN/Phone
! user/password if required
! Working pppd scripts
|-
| Canada || Fido || Any, behind NAT || internet.fido.ca || fido/fido || mdbus -s org.freesmartphone.frameworkd /org/freesmartphone/GSM/Device
org.freesmartphone.GSM.PDP.ActivateContext internet.fido.ca fido
fido
|-
| Canada || Rogers || Any, behind NAT || internet.com || ||
|-
| Estonia || Elisa || Any, behind NAT || internet || ||
|-
| Estonia || EMT || Any, behind NAT || internet.emt.ee || ||
|-
| Finland || Saunalahti || Any || internet.saunalahti || ||
|-
| Finland || Sonera || Any, behind NAT || internet || ||
|-
| Finland || Sonera || Any, public IP || prointernet || ||
|-
| France || SFR || 10.x.x.x? || websfr || || under tests
|-
| France || SFR || 10.x.x.x? || wapsfr<sup>[1]</sup>|| || under tests
|-
| France || Orange || ??? || orange.fr || || under tests
|-
| Germany || E-Plus || BASE (and others?) || internet.eplus.de || eplus gprs || [[Base pppd scripts]]
|-
| Germany || E-Plus || Simyo || internet.eplus.de || || [[simyo pppd scripts]]
|-
| Germany || T-Mobile || || internet.t-mobile || ||
|-
| Germany || Vodafone || Any, behind NAT || web.vodafone.de || ||
|-
| India || AirTel || MobileOffice || airtelgprs.com || ||
|-
| Italy || Wind || Superinternet, public IP || internet.wind / *99# || wind/wind (any string) || [[Wind pppd scripts]]
|-
| Netherlands || Vodafone || Any || live.vodafone.com / *99***1#|| || [[Vodafone pppd scripts]]
|-
| New Zealand || Vodafone || Any || live.vodafone.com / *99***2#|| ||
|-
| Norway || Netcom || Any || internet.netcom.no || ||
|-
| Norway || Telenor || Any || telenor || ||
|-
| Sweden || Parlino || || internet.parlino.se || || [[GPRS_FSO|Works with FSO]]
|-
| Switzerland || Swisscom || e.g. Natel Basic Liberty, behind NAT || gprs.swisscom.ch || ||
|-
| UK || T-Mobile|| || general.t-mobile.uk || ||
|-
| UK || Virgin || || goto.virginmobile.uk || user ||
|-
| UK || [http://www.filesaveas.com/gprs.html other providers] || || || ||
|-
| USA || AT&T || Unlimited data plan (attached to pay-as-you-go voice plan) || wap.cingular / *99***1# || WAP@CINGULARGPRS.COM/CINGULAR1 ||
|-
| USA || Cingular (AT&T) || Less than full internet || wap.cingular / may require *99***1# || ||
|-
| USA || T-mobile || Anything less than full internet || wap.voicestream.com || ||
|-
| USA || T-mobile || Regular internet plan || internet2.voicestream.com || || [[T-Mobile pppd scripts]]
|-
| USA || T-mobile || "VPN" internet plan || internet3.voicestream.com || ||
|-
| Venezuela || Digitel || Pre- y post-pago || gprsweb.digitel.ve || ||
|-
|}

[1] connected through a WAP proxy (slower, but the only way to access Vodafone live! and SFR portal)

[2] Unless stated otherwise the phone number to call is "*99#"

Also see Ross Barkman's page for a detailed list of more [http://www.taniwha.org.uk/gprs.html global GPRS providers APN details]

== Starting pppd automatically ==

Once you have finished debugging your gprs-connect-chat and gprs options files, you may wish to automatically connect whenever needed and hang up when finished. Make sure you understand the impact of this change to your carrier plan billing. This is not recommended unless you have a large-use or unlimited data plan. These scripts do NOT prompt you before connecting.

=== On-demand connection settings ===

Additional settings are needed if you want the actual connection to be up only while there is traffic. In the 'gprs' file above, insert the following, making sure 'nodetach' is commented out. If 'nodetach' is on, the boot process will stop when it starts pppd. Also remove the option 'persist' mentioned above.

<pre>

# Wait until needed before connecting
demand

# Disconnect if idle for given amount of seconds
idle 20

</pre>

=== Start on boot (method 1) ===

Add the following definition to /etc/network/interfaces:
<pre>
auto ppp0
iface ppp0 inet ppp
provider gprs
</pre>

That should be it. Now you can use 'ifup ppp0' and 'ifdown ppp0' manually too.

=== Start on boot (method 2) ===

Create the following file as /etc/ppp/ppp_on_boot (needs chmod +x). The /etc/init.d/ppp script will call it to set up the daemon.
<pre>
#!/bin/sh
#
# Rename this file to ppp_on_boot and pppd will be fired up as
# soon as the system comes up, connecting to `provider'.
#
# If you also make this file executable, and replace the first line
# with just "#!/bin/sh", the commands below will be executed instead.
#

# The location of the ppp daemon itself (shouldn't need to be changed)
PPPD=/usr/sbin/pppd

# The default provider to connect to
$PPPD call gprs

# Additional connections, which would just use settings from
# /etc/ppp/options.<tty>
#$PPPD ttyS0
#$PPPD ttyS1
#$PPPD ttyS2
#$PPPD ttyS3
</pre>

Finally, you need to add the /etc/init.d/ppp script to the init process by creating symbolic links from the appropriate directories. I chose the following:

<pre>
/etc/rc0.d/K25ppp
/etc/rc1.d/K45ppp
/etc/rc2.d/S45ppp
/etc/rc3.d/S45ppp
/etc/rc4.d/S45ppp
/etc/rc5.d/S45ppp
/etc/rc6.d/K25ppp
</pre>

== See also ==
* [[pppd]]
* [[Manually using GSM]]
* [[Manually using Bluetooth]]

{{Languages|Manually_using_GPRS}}
[[Category:Documentation]]
[[Category:Application Developer]]

[[Category:Guides]]

Openmoko Local Groups: Delhi

2008-08-09T21:01:23Z

Catholicon:

Welcome to the Delhi OpenMoko page!

This group is for anyone in Delhi.

{|border=1
!Name
!Skills
!Level of Interest
!Location
!Other
|-
| [[User:Sublime|Deepank Gupta]]
| C Programming
| Developing on GTA01Bv4 phone
| New Delhi
| Nothing in particular
|-
| [[User:Sublime|Phani Kumar]]
| C Programming
| Developing on GTA01
| Hyderabad
| Nothing in particular
|-
| [[User:Sublime|Vibhav Sharma]]
| C / C++ / Java Programming
| User / Developer
| Gurgaon
| Nothing in particular
|-
| [[User:catholicon|Vikas Saurabh]]
| C++ / Actionscript
| User of GTA02 (...would jump to dev soon)
| Noida
| Sleep and Bakarr (Indian Lingo)
|}

[[Category:Openmoko Local Groups]]

Openmoko Local Groups: Delhi

2008-08-09T21:01:08Z

Catholicon: Adding myself to the list :)

User:Catholicon

2008-08-09T20:58:07Z

Catholicon: Introduction

This is Vikas. Have just got a GTA02 and am currently trying to converge on one OS. I would then probably jump into development.

My current complaints (guide to what I would probably end up doing):
* Not enough s/w for this classy h/w (FSO, it seems has taken a corrent route though...bring everything on userland with DBus)
** Why aren't there many apps (yet) using accelerometer...I guess a very small but flauntable one could be a daemon that reads accelerometer (preferably use DBus as well) and simply use xrandr to orient xserver
* How is that even a realeased version has glitches (I am damn frustrated with OM2008.8 as I can't make call....c'mon its a phone and I can't make calls)

Professionally, I currently work in Adobe Systems.

Talk:Om2008.8

2008-08-07T15:23:05Z

Catholicon:

"Think of our products as museums. We're building the environment. Each one different from the next. You'll get all the free art supplies you could imagine because we want you to add your own meaning. You choose: consume, create, or both. "

It's a small point but the use of the term museum is not right.
If the art supplies are free, then an Artists Workshop might be better, at best a Gallery.

slozano: This update/distibution IS NOT for the faint of heart. There still a lot of work to be done. Among the frustrating issues is the options and back buttons at the bottom of many screen disappear at the moment they are touch!

[[User:Catholicon|catholicon]]: I also have the same issue that the options and back button go away as soon as you touch them. It seems like some kind of window stacking bug. As it is most prevalent when one window leads to open another (e.g. Exposure-->Clock)
Also, I can't find a program to lock the screen, nor am I able to use the power and aux button (can I cofigure them?). There is now way I can shutdown/restart the device without launching the terminal.

Backup

2008-08-05T23:21:21Z

Catholicon: failed rootfs backup can be mounted and read

== Backing up just /home/root ==

To backup the home folder (all your files personal files in theory).

From the desktop pc run:

ssh root@phone 'tar -cpz /home/root' > moko-home-`date +%Y%m%d-%H%M%S`.tar.gz

Where phone is the ip address of your phone (192.168.0.202).

Personally I added an entry to /etc/hosts so the above works for me. I also added the desktop key to /home/root.ssh/authorized_keys on the phone as per the instructions in [[USB_Networking#SSH_Keys]].

If you want to check what is in the backup, run the following, replacing the filename with what was just created.

tar -tzf moko-home-20080802-203108.tar.gz | less

[http://timwise.wikispaces.com/my+neo+freerunner reference]

== Backing up everything ==

You will need the [[Dfu-util]] to make a backup of your existing image.

As when [[Flashing_the_Neo_FreeRunner|flashing]], you will need to be in [[Booting_the_Neo_FreeRunner#Log_into_U-Boot_in_the_NOR_Flash|U-Boot in the NOR Flash]]. Log into the NOR uBoot menu and select ''Set console to USB'' (for NRF just stay in NOR uBoot menu, do not select or enter anything). Now you will be able to flash, make backups of your Freerunner or query the Freerunner with [[Dfu-util|dfu-util]].

{{note|On a Windows host, omit the "./" or "sudo ./" that precedes the commands listed on this page}}

THIS WILL TAKE AWHILE. The rootfs will take significantly longer than the kernel.

<pre>
./dfu-util -a kernel -R -U good-kernel.bin
./dfu-util -a rootfs -R -U good-rootfs.jffs2
./dfu-util -a u-boot_env -R -U good-u-boot_env.bin
./dfu-util -a splash -R -U good-splash.bin
./dfu-util -a u-boot -R -U good-u-boot.bin

</pre>

Here is what my successful output looked like...

on the host PC:
<pre>
$ sudo ./dfu-util -a kernel -R -U good-kernel.img
dfu-util - (C) 2007 by OpenMoko Inc.
This program is Free Software and has ABSOLUTELY NO WARRANTY

Opening USB Device 0x0000:0x0000...
Claiming USB DFU Runtime Interface...
Determining device status: state = appIDLE, status = 0
Device really in Runtime Mode, send DFU detach request...
Resetting USB...
Opening USB Device...
Found Runtime: [0x1d50:0x5119] devnum=12, cfg=0, intf=0, alt=3, name="kernel"
Claiming USB DFU Interface...
Setting Alternate Setting ...
Determining device status: state = dfuIDLE, status = 0
dfuIDLE, continuing
Transfer Size = 0x1000
Resetting USB to switch back to runtime mode
$ sudo ./dfu-util -a rootfs -R -U good-rootfs.jffs2
dfu-util - (C) 2007 by OpenMoko Inc.
This program is Free Software and has ABSOLUTELY NO WARRANTY

Opening USB Device 0x0000:0x0000...
Found Runtime: [0x1d50:0x5119] devnum=16, cfg=0, intf=0, alt=6, name="rootfs"
Claiming USB DFU Interface...
Setting Alternate Setting ...
Determining device status: state = dfuERROR, status = 14
dfuERROR, clearing status
Determining device status: state = dfuIDLE, status = 0
dfuIDLE, continuing
Transfer Size = 0x1000
Resetting USB to switch back to runtime mode
</pre>

Despite the fact that there was a device status with state=dfuERROR, everything seems to have worked.

on the FreeRunner:
<pre>
DFU: Switching to DFU Mode
DEVICE_CONFIGURED: 1
Starting DFU Upload of partition 'kernel'
DEVICE_CONFIGURED: 1
Starting DFU Upload of partition 'rootfs'
</pre>

I could backup the kernel of my GTA02 but trying to use this method to backup the rootfs failed several times....
dfu-util - (C) 2007 by OpenMoko Inc.
This program is Free Software and has ABSOLUTELY NO WARRANTY

Opening USB Device 0x0000:0x0000...
Claiming USB DFU Runtime Interface...
Determining device status: state = appIDLE, status = 0
Device really in Runtime Mode, send DFU detach request...
Resetting USB...
Opening USB Device...
Found Runtime: [0x1d50:0x5119] devnum=20, cfg=0, intf=0, alt=6, name="rootfs"
Claiming USB DFU Interface...
Setting Alternate Setting ...
Determining device status: state = dfuIDLE, status = 0
dfuIDLE, continuing
Transfer Size = 0x1000
dfu_upload error -110

I have not been able to backup rootfs using this method.

In demsg I get this error
usb 5-2: usbfs: USBDEVFS_CONTROL failed cmd dfu-util rqt 161 rq 2 len 4096 ret -110

Failed for me as well with (I didn't have patience to do it multiple times)
usb 5-2: reset full speed USB device using uhci_hcd and address 81
usb 5-2: usbfs: USBDEVFS_CONTROL failed cmd dfu-util rqt 161 rq 2 len 4096 ret -71
...and the last line from dfu_util was <pre>dfu_upload error -71</pre>
But, I can mount the jffs2 image and things that I want are alright. So, I guess it can be ignored.

[[category:Guides]]
[[category:Technical]]

Backup

2008-08-05T23:06:43Z

Catholicon: Can't backup rootsfs

== Backing up just /home/root ==

To backup the home folder (all your files personal files in theory).

From the desktop pc run:

ssh root@phone 'tar -cpz /home/root' > moko-home-`date +%Y%m%d-%H%M%S`.tar.gz

Where phone is the ip address of your phone (192.168.0.202).

Personally I added an entry to /etc/hosts so the above works for me. I also added the desktop key to /home/root.ssh/authorized_keys on the phone as per the instructions in [[USB_Networking#SSH_Keys]].

If you want to check what is in the backup, run the following, replacing the filename with what was just created.

tar -tzf moko-home-20080802-203108.tar.gz | less

[http://timwise.wikispaces.com/my+neo+freerunner reference]

== Backing up everything ==

You will need the [[Dfu-util]] to make a backup of your existing image.

As when [[Flashing_the_Neo_FreeRunner|flashing]], you will need to be in [[Booting_the_Neo_FreeRunner#Log_into_U-Boot_in_the_NOR_Flash|U-Boot in the NOR Flash]]. Log into the NOR uBoot menu and select ''Set console to USB'' (for NRF just stay in NOR uBoot menu, do not select or enter anything). Now you will be able to flash, make backups of your Freerunner or query the Freerunner with [[Dfu-util|dfu-util]].

{{note|On a Windows host, omit the "./" or "sudo ./" that precedes the commands listed on this page}}

THIS WILL TAKE AWHILE. The rootfs will take significantly longer than the kernel.

<pre>
./dfu-util -a kernel -R -U good-kernel.bin
./dfu-util -a rootfs -R -U good-rootfs.jffs2
./dfu-util -a u-boot_env -R -U good-u-boot_env.bin
./dfu-util -a splash -R -U good-splash.bin
./dfu-util -a u-boot -R -U good-u-boot.bin

</pre>

Here is what my successful output looked like...

on the host PC:
<pre>
$ sudo ./dfu-util -a kernel -R -U good-kernel.img
dfu-util - (C) 2007 by OpenMoko Inc.
This program is Free Software and has ABSOLUTELY NO WARRANTY

Opening USB Device 0x0000:0x0000...
Claiming USB DFU Runtime Interface...
Determining device status: state = appIDLE, status = 0
Device really in Runtime Mode, send DFU detach request...
Resetting USB...
Opening USB Device...
Found Runtime: [0x1d50:0x5119] devnum=12, cfg=0, intf=0, alt=3, name="kernel"
Claiming USB DFU Interface...
Setting Alternate Setting ...
Determining device status: state = dfuIDLE, status = 0
dfuIDLE, continuing
Transfer Size = 0x1000
Resetting USB to switch back to runtime mode
$ sudo ./dfu-util -a rootfs -R -U good-rootfs.jffs2
dfu-util - (C) 2007 by OpenMoko Inc.
This program is Free Software and has ABSOLUTELY NO WARRANTY

Opening USB Device 0x0000:0x0000...
Found Runtime: [0x1d50:0x5119] devnum=16, cfg=0, intf=0, alt=6, name="rootfs"
Claiming USB DFU Interface...
Setting Alternate Setting ...
Determining device status: state = dfuERROR, status = 14
dfuERROR, clearing status
Determining device status: state = dfuIDLE, status = 0
dfuIDLE, continuing
Transfer Size = 0x1000
Resetting USB to switch back to runtime mode
</pre>

Despite the fact that there was a device status with state=dfuERROR, everything seems to have worked.

on the FreeRunner:
<pre>
DFU: Switching to DFU Mode
DEVICE_CONFIGURED: 1
Starting DFU Upload of partition 'kernel'
DEVICE_CONFIGURED: 1
Starting DFU Upload of partition 'rootfs'
</pre>

I could backup the kernel of my GTA02 but trying to use this method to backup the rootfs failed several times....
dfu-util - (C) 2007 by OpenMoko Inc.
This program is Free Software and has ABSOLUTELY NO WARRANTY

Opening USB Device 0x0000:0x0000...
Claiming USB DFU Runtime Interface...
Determining device status: state = appIDLE, status = 0
Device really in Runtime Mode, send DFU detach request...
Resetting USB...
Opening USB Device...
Found Runtime: [0x1d50:0x5119] devnum=20, cfg=0, intf=0, alt=6, name="rootfs"
Claiming USB DFU Interface...
Setting Alternate Setting ...
Determining device status: state = dfuIDLE, status = 0
dfuIDLE, continuing
Transfer Size = 0x1000
dfu_upload error -110

In demsg I get this error
usb 5-2: usbfs: USBDEVFS_CONTROL failed cmd dfu-util rqt 161 rq 2 len 4096 ret -110

Failed for me as well with (I didn't have patience to do it multiple times)
usb 5-2: reset full speed USB device using uhci_hcd and address 81
usb 5-2: usbfs: USBDEVFS_CONTROL failed cmd dfu-util rqt 161 rq 2 len 4096 ret -71
...and the last line from dfu_util was <pre>dfu_upload error -71</pre>

I have not been able to backup rootfs using this method.

[[category:Guides]]
[[category:Technical]]

Manually using GPRS

2008-08-03T23:28:17Z

Catholicon: Airtel(MobileOffice) India

The GPRS connection is made using the PPP protocol to a server identified by an "APN" at the network operator.

The program that implements PPP on Linux is [[pppd]], which we need to configure and run to get a connection. When that is working, we can configure pppd to wait until it's needed before it connects, and to disconnect if the connection becomes idle. Further, we can start pppd in the background during the boot process.

== Configuring pppd for manual connections ==

You'll need /etc/ppp/peers/gprs:
<pre>
/dev/ttySAC0 115200
connect /etc/ppp/gprs-connect-chat
crtscts
lock
hide-password
defaultroute
usepeerdns
disconnect /etc/ppp/gprs-disconnect-chat
holdoff 3
ipcp-accept-local
lcp-echo-failure 8
lcp-echo-interval 3
noauth
noipdefault
novj
novjccomp
replacedefaultroute
persist
lcp-echo-interval 3
lcp-echo-failure 12
</pre>

These options were mentioned before with this strange comment. Mine worked fine for me without them.

<pre>
# very long timeouts (unwise?)
lcp-echo-interval 300
lcp-echo-failure 40000
</pre>

Depending on the APN, you may need password authentication using CHAP or PAP. In /etc/ppp/pap-secrets you can add the following default line for "password-less" connections:

<pre>
# client server secret IP addresses
* * "" *
</pre>

For CHAP, lines in /etc/ppp/chap-secrets are used. For PAP, the lines are in /etc/ppp/pap-secrets. The client should match the "user" option in pppd the config file (below). You can use * to mean any here, but the option user "" doesn't mean empty!

For example:

<pre>
# Secrets for authentication using CHAP
# client server secret IP addresses
"user" * "password" *
</pre>

For this you need the following options in /etc/ppp/peers/gprs:

<pre>
# username to use for authentication, should match "client" in /etc/ppp/{chap,pap}-secrets
user "user"
</pre>

And you'll need /etc/ppp/gprs-connect-chat (needs "chmod +x"):

<pre>
#!/bin/sh -e
exec chat -v\
ABORT BUSY\
ABORT DELAYED\
ABORT "NO ANSWER"\
ABORT "NO DIALTONE"\
ABORT VOICE\
ABORT ERROR\
ABORT RINGING\
TIMEOUT 60\
"" +++\
OK ATZ\
OK ATE1\
OK AT+CFUN=1\
OK AT+COPS\
OK AT+CGDCONT=1,\"IP\",\"internet\"\
OK ATD*99#\
CONNECT /n/d
</pre>

Update: On my freerunner the first AT+CFUN=1 always generated ERROR. I managed to get gprs work by using the following script from http://lists.openmoko.org/pipermail/community/2008-July/023246.html:

<pre>
#!/bin/sh -e
exec /usr/sbin/chat -v \
TIMEOUT 10 \
OK-AT-'' ''\
ABORT BUSY\
ABORT DELAYED\
ABORT "NO ANSWER"\
ABORT "NO DIALTONE"\
ABORT VOICE\
ABORT ERROR\
ABORT RINGING\
TIMEOUT 30 \
'' ATZ\
OK ATE1\
OK AT+CFUN=1\
ERROR AT+CPIN=\"XXXX\"\ << USE YOUR OWN
OK AT+COPS\
OK AT+CGDCONT=1,\"IP\",\"internet\"\
OK 'ATDT*99***1#'\
CONNECT ''
</pre>

You will need to adjust the APN name "internet" in at+cgdcont line and possibly the phone number in the ATD line to match what your network operator provides. See below in the table "Some APN names for reference" for the right settings for your operator.

Also good to have is /etc/ppp/gprs-disconnect-chat (needs "chmod +x"):

<pre>
#!/bin/sh -e
/usr/sbin/chat -v\
ABORT OK\
ABORT BUSY\
ABORT DELAYED\
ABORT "NO ANSWER"\
ABORT "NO CARRIER"\
ABORT "NO DIALTONE"\
ABORT VOICE\
ABORT ERROR\
ABORT RINGING\
TIMEOUT 12\
"" \\k\\k\\k\\d+++ATH\
"NO CARRIER-AT-OK" ""
</pre>

The following script can be used to start the ppp connection. First it stops gsmd because gsmd may put the phone in a unknown state. It then turns on the power to the phone, modifies the ownership, and then creates a tty connection. Finally it starts [[pppd]] with the gprs settings.

<pre>
/etc/init.d/gsmd stop
echo "1" > /sys/bus/platform/devices/neo1973-pm-gsm.0/power_on
chown uucp.uucp /dev/ttySAC0
stty -F /dev/ttySAC0 crtscts
pppd call gprs
</pre>

If you are having problems connecting ensure you have a good GSM signal and replace the last line with the below line. This will allow you to see the details of the connection on the console.

<pre>
pppd debug nodetach call gprs
</pre>

The config above will establish a persistant link over gprs. The battery will run low in less than an hour. See an example for an on-demand config below.

=== Resolve.conf issues ===

The latest build seems to have solved the following issue, it should be automatically updated by pppd.

If you expeience DNS issues after connecting to DNS you may need a proper /etc/resolv.conf:

<pre>
ln -sf /var/run/resolv.conf /etc
</pre>

If needed put your nameserver for usb-net into /var/run/resolv.conf, not in /etc.

The image does not set a correct resolv.conf. i do so with an

<pre>
echo nameserver 192.168.0.201 > /var/run/resolv.conf
</pre>

in the right place. because a post-up in /etc/network/interfaces is not supported i do that in /etc/network/if-up.d/08setupdns

another problem is pppd's /etc/ppp/ip-down.d/92removedns which does not properly remove the link when shuting down ppp. my fix is this script:

<pre>
#!/bin/sh
ACTUALCONF=/var/run/resolv.conf
PPPCONF=/var/run/ppp/resolv.conf
if [ -f $PPPCONF ] ; then
if [ -f $ACTUALCONF ] ; then
if [ ! -h $ACTUALCONF -o ! "`readlink $ACTUALCONF 2>&1`" = "$PPPCONF" ] ; then
mv $ACTUALCONF $ACTUALCONF.ppporig
fi
fi

ln -sf $PPPCONF $ACTUALCONF
fi
</pre>

=== Some APN names for reference ===

{| border="1"
! Country
! Carrier
! Plan
! APN/Phone
! user/password if required
! Working pppd scripts
|-
| Canada || Rogers || Any, behind NAT || internet.com || ||
|-
| Estonia || Elisa || Any, behind NAT || internet || ||
|-
| Estonia || EMT || Any, behind NAT || internet.emt.ee || ||
|-
| Finland || Saunalahti || Any || internet.saunalahti || ||
|-
| Finland || Sonera || Any, behind NAT || internet || ||
|-
| Finland || Sonera || Any, public IP || prointernet || ||
|-
| France || SFR || 10.x.x.x? || websfr || || under tests
|-
| France || SFR || 10.x.x.x? || wapsfr<sup>[1]</sup>|| || under tests
|-
| France || Orange || ??? || orange.fr || || under tests
|-
| Germany || E-Plus || BASE (and others?) || internet.eplus.de || eplus gprs || [[Base pppd scripts]]
|-
| Germany || T-Mobile || || internet.t-mobile || ||
|-
| Germany || Vodafone || Any, behind NAT || web.vodafone.de || ||
|-
| Netherlands || Vodafone || Any || live.vodafone.com / *99***1#|| || [[Vodafone pppd scripts]]
|-
| New Zealand || Vodafone || Any || live.vodafone.com / *99***2#|| ||
|-
| Norway || Netcom || Any || internet.netcom.no || ||
|-
| Norway || Telenor || Any || telenor || ||
|-
| Switzerland || Swisscom || e.g. Natel Basic Liberty, behind NAT || gprs.swisscom.ch || ||
|-
| UK || T-Mobile|| || general.t-mobile.uk || ||
|-
| UK || Virgin || || goto.virginmobile.uk || user ||
|-
| UK || [http://www.filesaveas.com/gprs.html other providers] || || || ||
|-
| USA || AT&T || Unlimited data plan (attached to pay-as-you-go voice plan) || wap.cingular / *99***1# || WAP@CINGULARGPRS.COM/CINGULAR1 ||
|-
| USA || Cingular (AT&T) || Less than full internet || wap.cingular / may require *99***1# || ||
|-
| USA || T-mobile || Anything less than full internet || wap.voicestream.com || ||
|-
| USA || T-mobile || Regular internet plan || internet2.voicestream.com || || [[T-Mobile pppd scripts]]
|-
| USA || T-mobile || "VPN" internet plan || internet3.voicestream.com || ||
|-
| Venezuela || Digitel || Pre- y post-pago || gprsweb.digitel.ve || ||
|-
| India || AirTel || MobileOffice || airtelgprs.com || ||
|-
|}

[1] connected through a WAP proxy (slower, but the only way to access Vodafone live! and SFR portal)

[2] Unless stated otherwise the phone number to call is "*99#"

== Starting pppd automatically ==

Once you have finished debugging your gprs-connect-chat and gprs options files, you may wish to automatically connect whenever needed and hang up when finished. Make sure you understand the impact of this change to your carrier plan billing. This is not recommended unless you have a large-use or unlimited data plan. These scripts do NOT prompt you before connecting.

=== On-demand connection settings ===

Additional settings are needed if you want the actual connection to be up only while there is traffic. In the 'gprs' file above, insert the following, making sure 'nodetach' is commented out. If 'nodetach' is on, the boot process will stop when it starts pppd. Also remove the option 'persist' mentioned above.

<pre>

# Wait until needed before connecting
demand

# Disconnect if idle for given amount of seconds
idle 20

</pre>

=== Start on boot (method 1) ===

Add the following definition to /etc/network/interfaces:
<pre>
auto ppp0
iface ppp0 inet ppp
provider gprs
</pre>

That should be it. Now you can use 'ifup ppp0' and 'ifdown ppp0' manually too.

=== Start on boot (method 2) ===

Create the following file as /etc/ppp/ppp_on_boot (needs chmod +x). The /etc/init.d/ppp script will call it to set up the daemon.
<pre>
#!/bin/sh
#
# Rename this file to ppp_on_boot and pppd will be fired up as
# soon as the system comes up, connecting to `provider'.
#
# If you also make this file executable, and replace the first line
# with just "#!/bin/sh", the commands below will be executed instead.
#

# The location of the ppp daemon itself (shouldn't need to be changed)
PPPD=/usr/sbin/pppd

# The default provider to connect to
$PPPD call gprs

# Additional connections, which would just use settings from
# /etc/ppp/options.<tty>
#$PPPD ttyS0
#$PPPD ttyS1
#$PPPD ttyS2
#$PPPD ttyS3
</pre>

Finally, you need to add the /etc/init.d/ppp script to the init process by creating symbolic links from the appropriate directories. I chose the following:

<pre>
/etc/rc0.d/K25ppp
/etc/rc1.d/K45ppp
/etc/rc2.d/S45ppp
/etc/rc3.d/S45ppp
/etc/rc4.d/S45ppp
/etc/rc5.d/S45ppp
/etc/rc6.d/K25ppp
</pre>

== See also ==
* [[pppd]]
* [[Manually using GSM]]
* [[Manually using Bluetooth]]

{{Languages|Manually_using_GPRS}}
[[Category:Documentation]]
[[Category:Application Developer]]

[[Category:Guides]]

Talk:SettingsGUI

2008-08-03T00:29:35Z

Catholicon:

This application is a great idea. Keep up the good work.--[[User:Denis std|denis_std]] 08:36, 20 August 2007 (CEST)

----
I couldn't get GPRS working from inside the settingGUI. Although, the work-around was very simple. I just had to add the default line to chap-sectrets file (as mentioned in [[Manually using GPRS]].

BTW, thanks a lot for this tool. I don't know why is it not there in the mainline -- [[User:Catholicon|Catholicon]] 00:29, 3 August 2008 (UTC)

Talk:SettingsGUI

2008-08-03T00:26:04Z

Catholicon: GPRS settings required chap-secrets