SHR

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(Install PIM Software: section removed, see user manual)
m (Feature overview)
 
(44 intermediate revisions by 17 users not shown)
Line 1: Line 1:
 
{{Languages|SHR}}
 
{{Languages|SHR}}
 +
[[Image:SHR-Logo.png|right|thumb|300px|SHR ]]
 
{{Distributions|SHR}}
 
{{Distributions|SHR}}
  
'''SHR''' (Stable Hybrid Release) is a community driven distribution based on the [[FSO]] framework. SHR can use several different graphical toolkits, for example GTK or EFL. At first, SHR was introduced in order to use the [[Om 2007.2]] GTK software in combination with the new FSO, but things have changed.
+
'''SHR''' (Stable Hybrid Release) is a community driven distribution based on the [[FSO]] framework. SHR can use several different graphical toolkits, for example GTK or EFL. At first, SHR was introduced in order to use the [[Om 2007.2]] GTK software in combination with the new FSO, but things have changed, now SHR comes with a full [[SHR User Manual]] in the OpenMoko-Wiki, that supports novice users in their first steps and SHR moves forward to a distribution for every day use.
[[Image:Shr-tnc01.jpg|right|thumb|300px|Full Image with custom Background]]
+
 
 +
SHR is based on Linux kernel and [http://www.openembedded.org/ Openembedded]. <tt>X.org</tt> is providing X server environment and [[Illume2]] (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is [[FSO]] middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR <tt>phoneuid</tt> daemon is run with X server start-up and it communicates with FSO via <tt>phonefsod</tt> using <tt>DBus</tt>. SHR phone applications talk to both <tt>phonefsod</tt> and <tt>phoneuid</tt> and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. ''Dialer'', ''Contacts'' and ''Messages'' applications are part of the SHR internal <tt>libphone-ui-shr</tt> library, ''Phonelog'' is an extra application written in python-gtk.
 +
 
 +
SHR wiki with more instructions, descriptions and informations is available on http://wiki.shr-project.org/
  
 
==Feature overview==
 
==Feature overview==
Line 27: Line 31:
 
| System
 
| System
 
| Keyboard
 
| Keyboard
| style="background:#FFDD88;"| Offer stylus and finger friendly keyboards
+
| style="background:#88FF88;"| Offer stylus and finger friendly keyboards
| style="background:#FFDD88;"| install alternative keyboards [http://trac.shr-project.org/trac/ticket/200 SHR ticket #200]
+
| Alternative keyboards are now available in repositories.
 
|-
 
|-
 
| GSM
 
| GSM
Line 43: Line 47:
 
| Dailer
 
| Dailer
 
| style="background:#88FF88;"| Receiving Call
 
| style="background:#88FF88;"| Receiving Call
| no way to adjust (double) audio in and audio out
+
|  
 
|-
 
|-
 
| GSM
 
| GSM
 
| Dailer
 
| Dailer
 
| style="background:#88FF88;"| Making Call
 
| style="background:#88FF88;"| Making Call
| no way to adjust (double) audio in and audio out
+
|  
 +
|-
 +
| GSM
 +
| Dailer
 +
| style="background:#FF8888;"| Speed dial voice mail
 +
| style="background:#FF8888;"| Not available. Should by default have keypad enabled.
 
|-
 
|-
 
| GSM
 
| GSM
Line 78: Line 87:
 
| SMS
 
| SMS
 
| style="background:#88FF88;"| Receiving SMS
 
| style="background:#88FF88;"| Receiving SMS
| style="background:#FFDD88;"| multipart SMS not concatenated [http://trac.shr-project.org/trac/ticket/121 SHR ticket #121]
+
|  
 
|-
 
|-
 
| GSM
 
| GSM
Line 89: Line 98:
 
| style="background:#88FF88;"| View overview of received SMS
 
| style="background:#88FF88;"| View overview of received SMS
 
|
 
|
 +
|-
 +
| GSM
 +
| SMS
 +
| style="background:#88FF88;"| View overview of sent SMS|
 +
| Sent SMS are now stored. They share folder with received SMS
 +
|-
 +
| GSM
 +
| SMS
 +
| style="background:#FF8888;"| Request SMS delivery receipt
 +
| style="background:#FF8888;"| [http://trac.shr-project.org/trac/ticket/295 SHR ticket #295]
 
|-
 
|-
 
| GSM
 
| GSM
Line 107: Line 126:
 
| GSM
 
| GSM
 
| SMS
 
| SMS
| style="background:#FFDD88;"| Sending new SMS
+
| style="background:#88FF88;"| Sending new SMS
| style="background:#FF8888;"| multipart SMS not being sent [http://trac.shr-project.org/trac/ticket/121 SHR ticket #121]
+
|  
 
|-
 
|-
 
| GSM
 
| GSM
 
| SMS
 
| SMS
| style="background:#FFDD88;"| Sending reply SMS
+
| style="background:#88FF88;"| Sending reply SMS
| style="background:#FF8888;"| multipart SMS not being sent [http://trac.shr-project.org/trac/ticket/121 SHR ticket #121]
+
|  
 
|-
 
|-
 +
 +
| GSM
 +
| SMS
 +
| style="background:#88FF88;"| Forwarding SMS
 +
|
 +
|-
 +
 
| GSM
 
| GSM
 
| SMS
 
| SMS
Line 162: Line 188:
 
| Shared
 
| Shared
 
| Contacts
 
| Contacts
| style="background:#FF8888;"| Quick lookup contact with keyboard
+
| style="background:#88FF88;"| Quick lookup contact with keyboard
|
+
| Tap and hold (or drag) near right side of the screen
 
|-
 
|-
 
| Shared
 
| Shared
Line 182: Line 208:
 
| WiFi
 
| WiFi
 
| Ethernet
 
| Ethernet
| style="background:#88FF88;"| Configuring and Enabling TCP/IP
+
| style="background:#FF8888;"| Configuring and Enabling WiFi connection
| 1) Settings->Connectivity->WiFi radio=On 2) Mokonnect
+
| [http://www.shr-project.org/trac/ticket/1074 SHR ticket #1084]
 
|-
 
|-
 
| GPS
 
| GPS
 
| Service
 
| Service
| style="background:#88FF88;"| Receiving GPS data
+
| style="background:#FFFF00;"| Receiving GPS data - works with [[Qi]] not with [[U-boot]]
| automatically turning on
+
| [http://www.shr-project.org/trac/ticket/1085 SHR ticket #1085] partially solved with Qi
 
|-
 
|-
 
| USB
 
| USB
 
| Ethernet
 
| Ethernet
| style="background:#88FF88;"| Configuring and Enabling TCP/IP
+
| style="background:#88FF88;"| Configuring and Enabling USB connection
| done automatically with insecure password
+
| done automatically
 
|-
 
|-
 
| Audio
 
| Audio
 
| Headset
 
| Headset
| style="background:#FF8888;"| Handsfree calling
+
| style="background:#88FF88;"| Handsfree calling
| headphones work, microphone does not work (needs checking!)
+
|
 +
|-
 +
|-
 +
| Bluetooth
 +
| Headset
 +
| style="background:#FF8888;"| Handsfree calling with bluetooth
 +
|
 
|-
 
|-
 
|}
 
|}
  
 +
==Image content==
  
== Setting local time ==
+
These applications are included in the full and lite SHR images:
As any linux system, the UTC time is used by the system. First of all, adjust this time:
+
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%
date -u -s 010220052009
+
Fri Jan  2 20:05:00 UTC 2009
+
  
Then, you need to "localise" your system.  
+
! width=16%| !! width=42%|Full image content !! width=42%|Lite image content
Search for the appropriate country with:
+
|-
  opkg list | grep tzdata
+
| Window Manager ||
 +
* illume
 +
||
 +
* illume
 +
|-
 +
| Engine      ||
 +
* frameworkd
 +
||
 +
* frameworkd
 +
|-
 +
| Telephony  ||
 +
* Dialer (Call/Receive, DTMF, Speaker mode)
 +
* Contacts (Call/Modify/Create/...)
 +
* Messages (Receive/Compose/Answer/...)
 +
* Pyphonelog (received/emitted/missed calls logging)
 +
  ||
 +
* Dialer (Call/Receive, DTMF, Speaker mode)
 +
* Contacts (Call/Modify/Create/...)
 +
* Messages (Receive/Compose/Answer/...)
 +
* Pyphonelog (received/emitted/missed calls logging)
 +
|-
 +
| GPS ||
 +
* TangoGPS
 +
||
 +
* TangoGPS
 +
|-
 +
| Utilities ||
 +
* Calculator
 +
* Alarm
 +
* Notes (opimd based)
 +
* GPE Scap (Take screenshot)
 +
* GPE Sketchbook
 +
* vala-terminal
 +
||
 +
* Calculator
 +
* Alarm
 +
* vala-terminal
  
then install the one corresponding to your area.
+
|-
opkg install tzdata-europe
+
  
Then select your city (search the city available in /usr/share/zoneinfo/your-country, example Paris)
+
| Media ||
ln -sf /usr/share/zoneinfo/Europe/Paris /etc/localtime
+
  
You can fully localise your system by installing the glibc-binary-localedata correponding to your langage. Search the ones available with:
+
* Vagalume (Last.fm client)
opkg list | grep glibc-binary-localedata
+
* Intone (audio player)
 +
||
  
install with (example for France)
+
|-
opkg install glibc-binary-localedata-fr-fr
+
  
 +
| Internet ||
 +
* Pidgin (Instant Messenger)
 +
* Ventura (Browser)
 +
||
 +
|-
  
 +
| VoIP ||
  
== Customize the RingTone ==
+
||
You need to have a file containing the RingTone you want for your FR. You can find some at [http://wiki.openmoko.org/wiki/Ringtones#svn.openmoko.org_ringtones RingTone]
+
  
Then transfer it to your FR :
+
|-
scp file root@192.168.0.202:/usr/share/sounds/
+
  
Now you can select ringtone in SHR Settings.
+
| Games ||
 
+
* Numptyphysics
 
+
* Mokomaze
 
+
||
== Sound Control ==
+
|-
 
+
| Settings ||
=== Mic and HP ===
+
* SHR Settings
The first idea is to use alsamixer; bad idea! There are 94 controls, and your modifications will be lost at the next reboot.Finding documentation is not easy. Here is my understanding:
+
* iliwi WiFi Manager)  
Scenari are used for each case. They are located in /usr/share/shr/scenarii/
+
||
- capturehandset.state 
+
* SHR Settings
- gsmheadset.state
+
|-
- headset.state       
+
|}
- voip-handset.state
+
- gsmhandset.state
+
- gsmspeakerout.state
+
- stereoout.state
+
 
+
Each file is a set of value for the 94 parameters. I have identified some:
+
 
+
- 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
+
 
+
NOTE: every Neo seems to be different regarding audio. Probably you have to tweak your own audio config.
+
 
+
Generic info to the Neo soundsystem:
+
 
+
* [[Neo 1973 audio subsystem]]
+
* [[Neo alsamixer#Settings_Descriptions|Neo alsamixer - Settings Descriptions]]
+
* [[Neo Freerunner audio subsystem]]
+
 
+
== Known Issues ==
+
 
+
=== Address Book ===
+
 
+
SHR is not implementing a PIM (Personal Information Manager) yet. Work is in progress, but to included in SHR testing this has some consequences on daily use:
+
 
+
* Only contacts on the SIM card are available.
+
 
+
* It is not possible to import a Vcard file.
+
** It seems to be possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].
+
 
+
=== No ringing ===
+
 
+
After a suspend, the FR does not ringing anymore for incoming calls, it only vibrates. This is due to navit. To correct this :
+
  opkg remove -force-depends speech-dispatcher
+
 
+
=== opkg upgrade "fork failed" ===
+
 
+
http://trac.shr-project.org/trac/ticket/531
+
 
+
Beware that a failed opkg upgrade can result in a non-booting phone :-(
+
 
+
Workaround:
+
 
+
opkg update
+
cd /media/card
+
dd if=/dev/zero of=swapfile.swp bs=1k count=128000
+
mkswap swapfile.swp
+
swapon swapfile.swp
+
opkg upgrade
+
swapoff swapfile.swp
+
  
Note that using your card for swap could potentially wear it out faster, though probably no need to worry just for the above workaround.
+
==User Manual==
 +
SHR has a full [[SHR User Manual|User Manual]].
  
 
== More Information ==
 
== More Information ==
  
 
Visit:
 
Visit:
* [http://wiki.openmoko.org/wiki/SHR_User_Manual SHR User Manual (On the Wiki)]
 
 
* [http://blog.shr-project.org Blog]
 
* [http://blog.shr-project.org Blog]
* [http://trac.shr-project.org Trac (Bugtracker)]
+
* [http://trac.shr-project.org Project Homepage/Trac (Bugtracker)]
 
* [http://git.shr-project.org Git (Sourcecode-repository)]
 
* [http://git.shr-project.org Git (Sourcecode-repository)]
 
* [http://build.shr-project.org Buildhost (Downloads)]
 
* [http://build.shr-project.org Buildhost (Downloads)]

Latest revision as of 17:03, 30 September 2010

SHR

SHR is one of the many distributions that currently work on the Openmoko phones. You can compare a distribution with an Operating System on normal computers. It gives the phone all the software needed for operating. For more information about the different flavors, see distributions.

SHR (Stable Hybrid Release) is a community driven distribution based on the FSO framework. SHR can use several different graphical toolkits, for example GTK or EFL. At first, SHR was introduced in order to use the Om 2007.2 GTK software in combination with the new FSO, but things have changed, now SHR comes with a full SHR User Manual in the OpenMoko-Wiki, that supports novice users in their first steps and SHR moves forward to a distribution for every day use.

SHR is based on Linux kernel and Openembedded. X.org is providing X server environment and Illume2 (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is FSO middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR phoneuid daemon is run with X server start-up and it communicates with FSO via phonefsod using DBus. SHR phone applications talk to both phonefsod and phoneuid and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. Dialer, Contacts and Messages applications are part of the SHR internal libphone-ui-shr library, Phonelog is an extra application written in python-gtk.

SHR wiki with more instructions, descriptions and informations is available on http://wiki.shr-project.org/

Contents

[edit] Feature overview

In the overview below are all the essential features and their status for the current out of the box SHR unstable distribution (latest+modules+updates). Green indicates that this part is functioning well, red indicates a known requirement which will be implemented later on and orange indicates functionality that can (and should) be fixed easily in the distribution for known fixes are available.

Category Name Functionality Comments
System Power Management Suspend when slow, use Qi
System Package manager Installing and upgrading packages Works well. For packages not in the repository, just ask for them to be added via the trac
System Keyboard Offer stylus and finger friendly keyboards Alternative keyboards are now available in repositories.
GSM Network Connect via SIM and PIN
GSM Network Flight mode SHR ticket #333
GSM Dailer Receiving Call
GSM Dailer Making Call
GSM Dailer Speed dial voice mail Not available. Should by default have keypad enabled.
GSM Phone Log Overview Log (In, Out, Answered, All)
GSM Phone Log Display Missed Calls
GSM Phone Log Making reply Call from Log
GSM Phone Log Sending reply SMS from Log
Shared Phone Log Creating new SIM contact from Log
GSM SMS Receiving SMS
GSM SMS SIM phonebook lookup for SMS
GSM SMS View overview of received SMS
GSM SMS View overview of sent SMS| Sent SMS are now stored. They share folder with received SMS
GSM SMS Request SMS delivery receipt SHR ticket #295
GSM SMS Selecting SMS from Overview
GSM SMS Viewing SMS
GSM SMS Writing SMS
GSM SMS Sending new SMS
GSM SMS Sending reply SMS
GSM SMS Forwarding SMS
GSM SMS Making reply Call
GSM SMS Deleting SMS
GSM SMS Storing received contact in contacts
GSM GPRS Configuring and Enabling GPRS Settings->Connectivity: GPRS connect
Shared Contacts Reading SIM contacts
Shared Contacts Selecting SIM contact from Overview
Shared Contacts Creating new SIM contact
Shared Contacts Editing SIM contact
Shared Contacts Deleting SIM contact
Shared Contacts Quick lookup contact with keyboard Tap and hold (or drag) near right side of the screen
Shared Contacts Calling contact
Shared Contacts Sending SMS to contact
Shared Contacts Sending contact via SMS to contact
WiFi Ethernet Configuring and Enabling WiFi connection SHR ticket #1084
GPS Service Receiving GPS data - works with Qi not with U-boot SHR ticket #1085 partially solved with Qi
USB Ethernet Configuring and Enabling USB connection done automatically
Audio Headset Handsfree calling
Bluetooth Headset Handsfree calling with bluetooth

[edit] Image content

These applications are included in the full and lite SHR images:

Full image content Lite image content
Window Manager
  • illume
  • illume
Engine
  • frameworkd
  • frameworkd
Telephony
  • Dialer (Call/Receive, DTMF, Speaker mode)
  • Contacts (Call/Modify/Create/...)
  • Messages (Receive/Compose/Answer/...)
  • Pyphonelog (received/emitted/missed calls logging)
  • Dialer (Call/Receive, DTMF, Speaker mode)
  • Contacts (Call/Modify/Create/...)
  • Messages (Receive/Compose/Answer/...)
  • Pyphonelog (received/emitted/missed calls logging)
GPS
  • TangoGPS
  • TangoGPS
Utilities
  • Calculator
  • Alarm
  • Notes (opimd based)
  • GPE Scap (Take screenshot)
  • GPE Sketchbook
  • vala-terminal
  • Calculator
  • Alarm
  • vala-terminal
Media
  • Vagalume (Last.fm client)
  • Intone (audio player)
Internet
  • Pidgin (Instant Messenger)
  • Ventura (Browser)
VoIP
Games
  • Numptyphysics
  • Mokomaze
Settings
  • SHR Settings
  • iliwi WiFi Manager)
  • SHR Settings

[edit] User Manual

SHR has a full User Manual.

[edit] More Information

Visit:

Personal tools

SHR is one of the many distributions that currently work on the Openmoko phones. You can compare a distribution with an Operating System on normal computers. It gives the phone all the software needed for operating. For more information about the different flavors, see distributions.

SHR (Stable Hybrid Release) is a community driven distribution based on the FSO framework. SHR can use several different graphical toolkits, for example GTK or EFL. At first, SHR was introduced in order to use the Om 2007.2 GTK software in combination with the new FSO, but things have changed.

Full Image with custom Background

Feature overview

In the overview below are all the essential features and their status for the current out of the box SHR unstable distribution (latest+modules+updates). Green indicates that this part is functioning well, red indicates a known requirement which will be implemented later on and orange indicates functionality that can (and should) be fixed easily in the distribution for known fixes are available.

Category Name Functionality Comments
System Power Management Suspend when slow, use Qi
System Package manager Installing and upgrading packages Works well. For packages not in the repository, just ask for them to be added via the trac
System Keyboard Offer stylus and finger friendly keyboards install alternative keyboards SHR ticket #200
GSM Network Connect via SIM and PIN
GSM Network Flight mode SHR ticket #333
GSM Dailer Receiving Call no way to adjust (double) audio in and audio out
GSM Dailer Making Call no way to adjust (double) audio in and audio out
GSM Phone Log Overview Log (In, Out, Answered, All)
GSM Phone Log Display Missed Calls
GSM Phone Log Making reply Call from Log
GSM Phone Log Sending reply SMS from Log
Shared Phone Log Creating new SIM contact from Log
GSM SMS Receiving SMS multipart SMS not concatenated SHR ticket #121
GSM SMS SIM phonebook lookup for SMS
GSM SMS View overview of received SMS
GSM SMS Selecting SMS from Overview
GSM SMS Viewing SMS
GSM SMS Writing SMS
GSM SMS Sending new SMS multipart SMS not being sent SHR ticket #121
GSM SMS Sending reply SMS multipart SMS not being sent SHR ticket #121
GSM SMS Making reply Call
GSM SMS Deleting SMS
GSM SMS Storing received contact in contacts
GSM GPRS Configuring and Enabling GPRS Settings->Connectivity: GPRS connect
Shared Contacts Reading SIM contacts
Shared Contacts Selecting SIM contact from Overview
Shared Contacts Creating new SIM contact
Shared Contacts Editing SIM contact
Shared Contacts Deleting SIM contact
Shared Contacts Quick lookup contact with keyboard
Shared Contacts Calling contact
Shared Contacts Sending SMS to contact
Shared Contacts Sending contact via SMS to contact
WiFi Ethernet Configuring and Enabling TCP/IP 1) Settings->Connectivity->WiFi radio=On 2) Mokonnect
GPS Service Receiving GPS data automatically turning on
USB Ethernet Configuring and Enabling TCP/IP done automatically with insecure password
Audio Headset Handsfree calling headphones work, microphone does not work (needs checking!)


Setting local time

As any linux system, the UTC time is used by the system. First of all, adjust this time:

date -u -s 010220052009
Fri Jan  2 20:05:00 UTC 2009

Then, you need to "localise" your system. Search for the appropriate country with:

opkg list | grep tzdata

then install the one corresponding to your area.

opkg install tzdata-europe

Then select your city (search the city available in /usr/share/zoneinfo/your-country, example Paris)

ln -sf /usr/share/zoneinfo/Europe/Paris /etc/localtime

You can fully localise your system by installing the glibc-binary-localedata correponding to your langage. Search the ones available with:

opkg list | grep glibc-binary-localedata

install with (example for France)

opkg install glibc-binary-localedata-fr-fr


Customize the RingTone

You need to have a file containing the RingTone you want for your FR. You can find some at RingTone

Then transfer it to your FR :

scp file root@192.168.0.202:/usr/share/sounds/

Now you can select ringtone in SHR Settings.


Sound Control

Mic and HP

The first idea is to use alsamixer; bad idea! There are 94 controls, and your modifications will be lost at the next reboot.Finding documentation is not easy. Here is my understanding: Scenari are used for each case. They are located in /usr/share/shr/scenarii/ - capturehandset.state - gsmheadset.state - headset.state - voip-handset.state - gsmhandset.state - gsmspeakerout.state - stereoout.state

Each file is a set of value for the 94 parameters. I have identified some:

- 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

NOTE: every Neo seems to be different regarding audio. Probably you have to tweak your own audio config.

Generic info to the Neo soundsystem:

Known Issues

Address Book

SHR is not implementing a PIM (Personal Information Manager) yet. Work is in progress, but to included in SHR testing this has some consequences on daily use:

  • Only contacts on the SIM card are available.
  • It is not possible to import a Vcard file.
    • It seems to be possible with this script written by Zem.

No ringing

After a suspend, the FR does not ringing anymore for incoming calls, it only vibrates. This is due to navit. To correct this :

 opkg remove -force-depends speech-dispatcher

opkg upgrade "fork failed"

http://trac.shr-project.org/trac/ticket/531

Beware that a failed opkg upgrade can result in a non-booting phone :-(

Workaround:

opkg update
cd /media/card
dd if=/dev/zero of=swapfile.swp bs=1k count=128000
mkswap swapfile.swp
swapon swapfile.swp
opkg upgrade
swapoff swapfile.swp

Note that using your card for swap could potentially wear it out faster, though probably no need to worry just for the above workaround.

More Information

Visit: