Stable Hybrid Release
From Openmoko
Languages: |
English • العربية • Български • Česky • Dansk • Deutsch • Esperanto • Eesti • Español • فارسی • Suomi • Français • עברית • Magyar • Italiano • 한국어 • Nederlands • Norsk (bokmål) • Polski • Português • Română • Русский • Svenska • Slovenčina • Українська • 中文(中国大陆) • 中文(台灣) • Euskara • Català |
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. Template:SHR
Contents |
Why SHR exists
The Stable Hybrid Release (SHR) is intended to be a community driven distribution composed of the FSO and some basic applications, that can be configured to use several different graphical toolkits, for example GTK or EFL. SHR is based on the FSO build. At first, SHR was introduced in order to use the Openmoko2007.2 GTK software in combination with the new FSO, but things have changed.
Why not just use plain FSO?
FSO is the initiative by Mickey Lauer and crew to create a good D-Bus infrastructure which runs on the neos, among other devices.
FSO is by far the most stable & usable release, if all you want is a phone. (I mean *all*. It just has a dialer, which is a demo application.)
FSO is never intended on its own to be a full image, it's just the infrastructure and a demo app.
Other people are supposed to put a front end on FSO. So that's what we're doing.
Feature overview
In the overview below are all the essential features and their status for the currect out of the box SHR testing distribution (2009-03-03+modules+updates). Green indicates that this part is well functioning, 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 | SHR ticket #314 |
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 | too big delay between selecting answer and stopping ring tone |
GSM | Dailer | Making Call | |
GSM | Phone Log | Overview Log (In, Out, Answered, All) | should be in SHR Illume theme and is very slow in startup |
GSM | Phone Log | Making reply Call from Log | |
GSM | Phone Log | Sending reply SMS from Log | |
GSM | SMS | Receiving SMS | |
GSM | SMS | Selecting SMS from Overview | |
GSM | SMS | Viewing SMS | |
GSM | SMS | Sending new SMS | |
GSM | SMS | Sending reply SMS | |
GSM | SMS | Making reply Call | |
GSM | SMS | Deleting SMS | |
GSM | GPRS | Configuring and Enabling TCP/IP | |
Shared | Contacts | Reading SIM contacts | |
Shared | Contacts | Selecting SIM contact from Overview | |
Shared | Contacts | Editing SIM contact | |
Shared | Contacts | Deleting SIM contact | does not stay at position in list |
Shared | Contacts | Quick lookup contact with keyboard | |
Shared | Contacts | Calling contact | |
Shared | Contacts | Sending SMS to contact | |
WiFi | Ethernet | Configuring and Enabling TCP/IP | 1) Settings->Internet->WiFi radio=On 2) Mofi |
WiFi | MoFi | Network Manager | SHR ticket #338 |
GPS | Service | Receiving GPS data | automatically turned on |
USB | Ethernet | Configuring and Enabling TCP/IP | done automatically with insecure password |
Audio | Headset | Handsfree calling | headphones work, microphone does not work |
Install
Installing SHR is very easy. I will explain how to install the testing version of SHR for GTA02 (Freerunner). It is stable enough for a daily use. Stable version will be available soon (Stable announcement), unstable (for the adventurous testers) is also available, but read this blog announcement on why this is currently not recommended.
I suppose that you know how to use NeoTool
- the Qi bootloader (optional, u-boot should work as well)
- the kernel
- the root filesystem (flash image or tarball)
You can view the sources here.
Connecting your FreeRunner to your computer
For the next configuration steps, you will need to type some commands. It is much easier to type on a real keyboard than on a touch screen. So you need to connect your FR to you computer, and make a bridge to internet. Use the USB Networking page for help about configuring your host computer. NOTE: On first boot after flashing, USB networking can not work. If it's happening, simply reboot and try again.
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
Changing root password
SHR is shipped without root password (just press enter)
This is dangerous if you connect using USB. You need to activate the root password:
passwd
and type your selected password (2 times)
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
Up to now, there is no graphical interface to control the sound
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/openmoko/scenarios/ - 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
Generic info to the Neo soundsystem:
Ringing
You can define a short ringtone, repeated many times, or a long one, repeated 1 time
File: /etc/freesmartphone/opreferences/conf/phone/default.yaml
Parameter: ring-volume # Ring Volume control 0 (mini) to ? maxi) Parameter: ring-length # min time for ringtone. Must be greater than the duration of you ringtone
File: /etc/freesmartphone/opreferences/schema/phone.yaml Parameter: ring-loop # define the number of loop of ringtone to play
Message alert
File: /etc/freesmartphone/opreferences/conf/phone/default.yaml Parameter: message-volume # Ring Volume control 0 (mini) to ? maxi) Parameter: message-length # min time for message alert. Must be greater than the duration of you message alert
File: /etc/freesmartphone/opreferences/schema/phone.yaml Parameter: message-loop # define the number of loop of incoming message music to play
Known Issues
Phone
GSM network is lost after one day of uptime: restart your FR once a day!
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.
More Information
Visit: