Stable Hybrid Release

From Openmoko

(Difference between revisions)
Jump to: navigation, search
m (Feature overview)
m (Undo revision 68277 by Pander (Talk))
Line 24: Line 24:
 
! Name
 
! Name
 
! Functionality
 
! Functionality
! Performance
 
 
! Comments
 
! Comments
 
|-
 
|-
Line 30: Line 29:
 
| Power Management
 
| Power Management
 
| style="background:#88FF88;"| Suspend
 
| style="background:#88FF88;"| Suspend
|
 
 
| when slow, use [[Qi]]
 
| when slow, use [[Qi]]
 
|-
 
|-
Line 36: Line 34:
 
| Package manager
 
| Package manager
 
| style="background:#FFDD88;"| Installing and upgrading packages
 
| style="background:#FFDD88;"| Installing and upgrading packages
|
 
 
| style="background:#FFDD88;"| [http://trac.shr-project.org/trac/ticket/314 SHR ticket #314]
 
| style="background:#FFDD88;"| [http://trac.shr-project.org/trac/ticket/314 SHR ticket #314]
 
|-
 
|-
Line 42: Line 39:
 
| Keyboard
 
| Keyboard
 
| style="background:#FFDD88;"| Offer stylus and finger friendly keyboards
 
| style="background:#FFDD88;"| Offer stylus and finger friendly keyboards
|
 
 
| style="background:#FFDD88;"| install alternative keyboards [http://trac.shr-project.org/trac/ticket/200 SHR ticket #200]
 
| style="background:#FFDD88;"| install alternative keyboards [http://trac.shr-project.org/trac/ticket/200 SHR ticket #200]
 
|-
 
|-
Line 48: Line 44:
 
| Network
 
| Network
 
| style="background:#88FF88;"| Connect via SIM and PIN
 
| style="background:#88FF88;"| Connect via SIM and PIN
|
 
 
|
 
|
 
|-
 
|-
Line 54: Line 49:
 
| Network
 
| Network
 
| style="background:#FF8888;"| Flight mode
 
| style="background:#FF8888;"| Flight mode
|
 
 
| style="background:#FF8888;"| [http://trac.shr-project.org/trac/ticket/333 SHR ticket #333]
 
| style="background:#FF8888;"| [http://trac.shr-project.org/trac/ticket/333 SHR ticket #333]
 
|-
 
|-
Line 60: Line 54:
 
| Dailer
 
| Dailer
 
| style="background:#88FF88;"| Receiving Call
 
| style="background:#88FF88;"| Receiving Call
| style="background:#FF8888;"| Slow pick up
+
| too big delay between selecting answer and stopping ring tone
|
+
 
|-
 
|-
 
| GSM
 
| GSM
 
| Dailer
 
| Dailer
 
| style="background:#88FF88;"| Making Call
 
| style="background:#88FF88;"| Making Call
|
 
 
|
 
|
 
|-
 
|-
Line 72: Line 64:
 
| Phone Log
 
| Phone Log
 
| style="background:#88FF88;"| Overview Log (In, Out, Answered, All)
 
| style="background:#88FF88;"| Overview Log (In, Out, Answered, All)
|
+
| style="background:#FF8888;"| should be in SHR Illume theme and is very slow in startup
| style="background:#FF8888;"| should be in SHR Illume theme
+
 
|-
 
|-
 
| GSM
 
| GSM
 
| Phone Log
 
| Phone Log
 
| style="background:#88FF88;"| Making reply Call from Log
 
| style="background:#88FF88;"| Making reply Call from Log
|
 
 
|
 
|
 
|-
 
|-
Line 84: Line 74:
 
| Phone Log
 
| Phone Log
 
| style="background:#FF8888;"| Sending reply SMS from Log
 
| style="background:#FF8888;"| Sending reply SMS from Log
| style="background:#FF8888;"| Slow
 
 
|
 
|
 
|-
 
|-
Line 90: Line 79:
 
| SMS
 
| SMS
 
| style="background:#88FF88;"| Receiving SMS
 
| style="background:#88FF88;"| Receiving SMS
|
 
 
|
 
|
 
|-
 
|-
Line 96: Line 84:
 
| SMS
 
| SMS
 
| style="background:#88FF88;"| Selecting SMS from Overview
 
| style="background:#88FF88;"| Selecting SMS from Overview
|
 
 
|
 
|
 
|-
 
|-
Line 102: Line 89:
 
| SMS
 
| SMS
 
| style="background:#88FF88;"| Viewing SMS
 
| style="background:#88FF88;"| Viewing SMS
|
 
 
|
 
|
 
|-
 
|-
Line 108: Line 94:
 
| SMS
 
| SMS
 
| style="background:#88FF88;"| Sending new SMS
 
| style="background:#88FF88;"| Sending new SMS
|
 
 
|
 
|
 
|-
 
|-
Line 114: Line 99:
 
| SMS
 
| SMS
 
| style="background:#88FF88;"| Sending reply SMS
 
| style="background:#88FF88;"| Sending reply SMS
|
 
 
|
 
|
 
|-
 
|-
Line 120: Line 104:
 
| SMS
 
| SMS
 
| style="background:#FF8888;"| Making reply Call
 
| style="background:#FF8888;"| Making reply Call
|
 
 
|
 
|
 
|-
 
|-
Line 126: Line 109:
 
| SMS
 
| SMS
 
| style="background:#88FF88;"| Deleting SMS
 
| style="background:#88FF88;"| Deleting SMS
|
 
 
|
 
|
 
|-
 
|-
Line 132: Line 114:
 
| GPRS
 
| GPRS
 
| style="background:#FF8888;"| Configuring and Enabling TCP/IP
 
| style="background:#FF8888;"| Configuring and Enabling TCP/IP
|
 
 
|
 
|
 
|-
 
|-
Line 138: Line 119:
 
| Contacts
 
| Contacts
 
| style="background:#88FF88;"| Reading SIM contacts
 
| style="background:#88FF88;"| Reading SIM contacts
|
 
 
|
 
|
 
|-
 
|-
Line 144: Line 124:
 
| Contacts
 
| Contacts
 
| style="background:#88FF88;"| Selecting SIM contact from Overview
 
| style="background:#88FF88;"| Selecting SIM contact from Overview
|
 
 
|
 
|
 
|-
 
|-
Line 150: Line 129:
 
| Contacts
 
| Contacts
 
| style="background:#88FF88;"| Editing SIM contact
 
| style="background:#88FF88;"| Editing SIM contact
|
 
 
|
 
|
 
|-
 
|-
Line 156: Line 134:
 
| Contacts
 
| Contacts
 
| style="background:#88FF88;"| Deleting SIM contact
 
| style="background:#88FF88;"| Deleting SIM contact
|
 
 
| does not stay at position in list
 
| does not stay at position in list
 
|-
 
|-
Line 162: Line 139:
 
| Contacts
 
| Contacts
 
| style="background:#FF8888;"| Quick lookup contact with keyboard
 
| style="background:#FF8888;"| Quick lookup contact with keyboard
|
 
 
|
 
|
 
|-
 
|-
Line 168: Line 144:
 
| Contacts
 
| Contacts
 
| style="background:#88FF88;"| Calling contact
 
| style="background:#88FF88;"| Calling contact
|
 
 
|
 
|
 
|-
 
|-
Line 174: Line 149:
 
| Contacts
 
| Contacts
 
| style="background:#88FF88;"| Sending SMS to contact
 
| style="background:#88FF88;"| Sending SMS to contact
|
 
 
|
 
|
 
|-
 
|-
Line 180: Line 154:
 
| Ethernet
 
| Ethernet
 
| style="background:#88FF88;"| Configuring and Enabling TCP/IP
 
| style="background:#88FF88;"| Configuring and Enabling TCP/IP
|
 
 
| 1) Settings->Internet->WiFi radio=On 2) Mofi
 
| 1) Settings->Internet->WiFi radio=On 2) Mofi
 
|-
 
|-
Line 186: Line 159:
 
| MoFi
 
| MoFi
 
| style="background:#FFDD88;"| Network Manager
 
| style="background:#FFDD88;"| Network Manager
|
 
 
| style="background:#FFDD88;"| [http://trac.shr-project.org/trac/ticket/338 SHR ticket #338]
 
| style="background:#FFDD88;"| [http://trac.shr-project.org/trac/ticket/338 SHR ticket #338]
 
|-
 
|-
Line 192: Line 164:
 
| Service
 
| Service
 
| style="background:#88FF88;"| Receiving GPS data
 
| style="background:#88FF88;"| Receiving GPS data
|
 
 
| automatically turned on
 
| automatically turned on
 
|-
 
|-
Line 198: Line 169:
 
| Ethernet
 
| Ethernet
 
| style="background:#88FF88;"| Configuring and Enabling TCP/IP
 
| style="background:#88FF88;"| Configuring and Enabling TCP/IP
|
 
 
| style="background:#FF8888;"| done automatically with insecure password
 
| style="background:#FF8888;"| done automatically with insecure password
 
|-
 
|-
Line 204: Line 174:
 
| Headset
 
| Headset
 
| style="background:#FF8888;"| Handsfree calling
 
| style="background:#FF8888;"| Handsfree calling
|
 
 
| headphones work, microphone does not work
 
| headphones work, microphone does not work
 
|-
 
|-

Revision as of 12:09, 31 March 2009

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.
  • It is not possible to import a Vcard file.
    • It seems to be possible with this script written by Zem.

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. Template:SHR

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 Performance 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 Slow pick up
GSM Dailer Making Call
GSM Phone Log Overview Log (In, Out, Answered, All) should be in SHR Illume theme
GSM Phone Log Making reply Call from Log
GSM Phone Log Sending reply SMS from Log Slow
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.
  • It is not possible to import a Vcard file.
    • It seems to be possible with this script written by Zem.

More Information

Visit: