Om 2009

From Openmoko

(Difference between revisions)
Jump to: navigation, search
Line 14: Line 14:
 
==== bind-home ====
 
==== bind-home ====
  
You can add a bind-home directory to the first partition (must be ext2 or ext3 ) of your SD card. On the OM2009 boot it will be mounted as /home/root. This way you can reflash your phone without losing anything in your home directory ([[Paroli]] contacts and settings, maps, etc)
+
You can add a bind-home directory to the first partition (must be ext2 or ext3 ) of your SD card. On the Om 2009 boot it will be mounted as /home/root. This way you can reflash your phone without losing anything in your home directory ([[Paroli]] contacts and settings, maps, etc)
  
 
Make sure there isn't a bind-home directory first  
 
Make sure there isn't a bind-home directory first  
Line 27: Line 27:
 
The latest boot loader files are available at http://downloads.openmoko.org/distro/testing/
 
The latest boot loader files are available at http://downloads.openmoko.org/distro/testing/
  
=== OM2009 Installation on Flash ===
+
=== Om 2009 Installation on Flash ===
  
Installing OM2009 is simple as flashing an image. Well, that's what you need to do..
+
Installing Om 2009 is simple as flashing an image. Well, that's what you need to do..
  
 
# Download! You need the correct fso-paroli-image and uImage.bin files for your device. There are also rootfs tarballs for installing onto an SD card. [http://downloads.openmoko.org/distro/testing/NeoFreerunner Freerunner] or [http://downloads.openmoko.org/distro/testing/Neo1973 Neo1973]
 
# Download! You need the correct fso-paroli-image and uImage.bin files for your device. There are also rootfs tarballs for installing onto an SD card. [http://downloads.openmoko.org/distro/testing/NeoFreerunner Freerunner] or [http://downloads.openmoko.org/distro/testing/Neo1973 Neo1973]
Line 40: Line 40:
 
Make sure you use ext2 or ext3 as your file system on uSD. Then check this here: [[Paroli-developer-setup#Upgrading_Paroli_on_a_uSD_card_installation_of_OM2009]] or [[Booting_from_SD#Prepare_the_SD_card]].
 
Make sure you use ext2 or ext3 as your file system on uSD. Then check this here: [[Paroli-developer-setup#Upgrading_Paroli_on_a_uSD_card_installation_of_OM2009]] or [[Booting_from_SD#Prepare_the_SD_card]].
  
== Using OM2009 ==
+
== Using Om 2009 ==
 
'''Write your best tips here!!'''
 
'''Write your best tips here!!'''
  
Line 56: Line 56:
 
* '''To prevent suspending when USB plugged in''': unplug usb until LED goes out, then plug usb in: you need to keep the device awake by touching the screen until the LED comes back on. (bug: http://trac.freesmartphone.org/ticket/381)
 
* '''To prevent suspending when USB plugged in''': unplug usb until LED goes out, then plug usb in: you need to keep the device awake by touching the screen until the LED comes back on. (bug: http://trac.freesmartphone.org/ticket/381)
  
'''Nytowl recommends against using the Angstrom feeds, if you want to mix feeds use the shr feeds as they are closer to the Om2009 distro'''
+
'''Nytowl recommends against using the Angstrom feeds, if you want to mix feeds use the shr feeds as they are closer to the Om 2009 distro'''
* '''Angstrom feeds''' Contain many useful packages including mplayer and ffmpeg. Run these commands to add the angstrom feeds '''NOTE:''' You will not be able to upgrade OM2009 after this, it will break!
+
* '''Angstrom feeds''' Contain many useful packages including mplayer and ffmpeg. Run these commands to add the angstrom feeds '''NOTE:''' You will not be able to upgrade Om 2009 after this, it will break!
 
  echo "arch base 50" > /etc/opkg/angstrom-feed.conf
 
  echo "arch base 50" > /etc/opkg/angstrom-feed.conf
 
  echo "src/gz base http://www.angstrom-distribution.org/feeds/2008/ipk/glibc/armv4t/base" >> /etc/opkg/angstrom-feed.conf
 
  echo "src/gz base http://www.angstrom-distribution.org/feeds/2008/ipk/glibc/armv4t/base" >> /etc/opkg/angstrom-feed.conf
Line 102: Line 102:
  
 
== Development ==
 
== Development ==
'' When we set the very limited goals of OM2009 we had two goals in mind:''
+
'' When we set the very limited goals of Om 2009 we had two goals in mind:''
 
   
 
   
 
''1. Give those members of the community who only wanted a daily phone, a distro they could use''<br>
 
''1. Give those members of the community who only wanted a daily phone, a distro they could use''<br>
 
''2. Introduce technology that would allow the community to come together and improve on these basics''  
 
''2. Introduce technology that would allow the community to come together and improve on these basics''  
 
   
 
   
''Community interaction, open development and user driven decision making are at the core of Om2009. Going forward this will be an effort with the community for the community. I invite you to join the effort to make om2009 with paroli the best Om-labeled distribution for the Freerunner. ''
+
''Community interaction, open development and user driven decision making are at the core of Om 2009. Going forward this will be an effort with the community for the community. I invite you to join the effort to make Om 2009 with paroli the best Om-labeled distribution for the Freerunner. ''
  
 
'''How can you help?'''
 
'''How can you help?'''
Line 113: Line 113:
 
''Test the distro, let us know about bugs you find, or even fix them and send us patches.''
 
''Test the distro, let us know about bugs you find, or even fix them and send us patches.''
 
   
 
   
''Tell us about your experiences using om2009, what should we change, where can we improve?''
+
''Tell us about your experiences using Om 2009, what should we change, where can we improve?''
 
   
 
   
 
''Paroli has come a long way but it still needs a lot of love and optimizing, so if you are into python or efl, check out the code from git.paroli.org, join #paroli on irc and let's get crackin'. There are lots of things to do, opimd needs to be integrated and improved, the UI needs polishing, overall speed can be increased etc etc''
 
''Paroli has come a long way but it still needs a lot of love and optimizing, so if you are into python or efl, check out the code from git.paroli.org, join #paroli on irc and let's get crackin'. There are lots of things to do, opimd needs to be integrated and improved, the UI needs polishing, overall speed can be increased etc etc''
Line 121: Line 121:
 
''So, get your Freerunner in shape again. Flash it with a nice current distro and let it do what it was meant to do :)''
 
''So, get your Freerunner in shape again. Flash it with a nice current distro and let it do what it was meant to do :)''
 
   
 
   
''Let's make Om2009 a community product, something all of us can be proud of and say "we did this".''
+
''Let's make Om 2009 a community product, something all of us can be proud of and say "we did this".''
  
 
Mirko/Openmoko at http://lists.openmoko.org/pipermail/community/2009-May/048061.html)
 
Mirko/Openmoko at http://lists.openmoko.org/pipermail/community/2009-May/048061.html)
Line 127: Line 127:
 
* [http://n2.nabble.com/Om2009-release-plan-tp2410042p2410042.html OM2009 release plan]
 
* [http://n2.nabble.com/Om2009-release-plan-tp2410042p2410042.html OM2009 release plan]
  
* [[Om_2009_get_active]]
+
* [[Om 2009 get active]]
 
* [[Paroli-issues]]
 
* [[Paroli-issues]]
  
Line 137: Line 137:
 
=== Reporting Bugs ===
 
=== Reporting Bugs ===
  
Please enable debugging as [[Om_2009#Using_OM2009|instructed above]]. Attaching frameworkd.log and paroli.log will aid in solving the bug.  
+
Please enable debugging as [[#Using Om 2009|instructed above]]. Attaching frameworkd.log and paroli.log will aid in solving the bug.  
  
 
Please search the bug list for you issue before adding it to trac. Some of these issues might be [[Paroli]] or FSO issue so you can also check their tracs for solutions or discussions.
 
Please search the bug list for you issue before adding it to trac. Some of these issues might be [[Paroli]] or FSO issue so you can also check their tracs for solutions or discussions.
  
* https://docs.openmoko.org/trac (Use the Om2009 tag so that we can track it against this release.)
+
* https://docs.openmoko.org/trac (Use the Om 2009 tag so that we can track it against this release.)
 
* http://trac.freesmartphone.org/wiki
 
* http://trac.freesmartphone.org/wiki
 
* http://www.paroli-project.org/trac
 
* http://www.paroli-project.org/trac
  
 
[[Category:Om 2009| ]]
 
[[Category:Om 2009| ]]

Revision as of 12:31, 18 August 2009

Screenshot of Paroli, the GSM app of OM2009

Om 2009 is the next version of the official Openmoko distribution. The latest release is testing5 from June 16th, 2009. It is currently under development. Om 2009 is based on FSO framework and uses Paroli as the telecommunication software.

Om 2009 testing5 already has all the features most people need for daily phone usage: SMS, calling, phone book, call log, charging, suspend&resume, wifi gui, audio profiles, etc.

Contents

Installing

Preparation

GSM firmware

If you don't have Moko11 as your GSM firmware yet, you should update it: See GSM/Flashing

bind-home

You can add a bind-home directory to the first partition (must be ext2 or ext3 ) of your SD card. On the Om 2009 boot it will be mounted as /home/root. This way you can reflash your phone without losing anything in your home directory (Paroli contacts and settings, maps, etc)

Make sure there isn't a bind-home directory first

ls /media/card/bind-home

If this exists you are already using bind-home, otherwise keep following the directions below and reboot after this

mv /home/root /media/card/bind-home
mkdir /home/root

Boot loader

Also update to the latest versions of qi or uboot bootloaders The latest boot loader files are available at http://downloads.openmoko.org/distro/testing/

Om 2009 Installation on Flash

Installing Om 2009 is simple as flashing an image. Well, that's what you need to do..

  1. Download! You need the correct fso-paroli-image and uImage.bin files for your device. There are also rootfs tarballs for installing onto an SD card. Freerunner or Neo1973
  2. Flash! Detailed instructions for Freerunner and Neo1973.
  3. Start! The image will boot into fullscreen Paroli and all of the features listed above will be available. To learn more about Paroli, see Paroli

Boot AND REBOOT! The first time it boots there some problems might occur but they're gone after the second boot.

Installation on uSD

Make sure you use ext2 or ext3 as your file system on uSD. Then check this here: Paroli-developer-setup#Upgrading_Paroli_on_a_uSD_card_installation_of_OM2009 or Booting_from_SD#Prepare_the_SD_card.

Using Om 2009

Write your best tips here!!

  • Change fullscreen paroli -> illume (settings->display->profile)
  • Enable wifi. (settings->wifi->power->active. settings->wifi->scan->'essid')
  • Allow ssh over wlan. (nano /etc/default/dropbear. =22)
  • If screen goes dim and phone suspends even all things are disabled, use this spell:
mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy Display enabled
  • To learn to use Paroli, the phone software, go to Paroli#FAQ
  • To have log directory that isn't cleared when you reboot, the /var/log symlink needs to be turned into a directory:
rm /var/log
mkdir /var/log
  • To import vcard -contacts to Paroli, check this
  • To change Paroli's background, check Paroli-background
  • To prevent suspending when USB plugged in: unplug usb until LED goes out, then plug usb in: you need to keep the device awake by touching the screen until the LED comes back on. (bug: http://trac.freesmartphone.org/ticket/381)

Nytowl recommends against using the Angstrom feeds, if you want to mix feeds use the shr feeds as they are closer to the Om 2009 distro

  • Angstrom feeds Contain many useful packages including mplayer and ffmpeg. Run these commands to add the angstrom feeds NOTE: You will not be able to upgrade Om 2009 after this, it will break!
echo "arch base 50" > /etc/opkg/angstrom-feed.conf
echo "src/gz base http://www.angstrom-distribution.org/feeds/2008/ipk/glibc/armv4t/base" >> /etc/opkg/angstrom-feed.conf

Localization

Audio quality during call

  • Audio quality is good by default for some Freerunners. Some units need a new audio profile:
wget http://docs.openmoko.org/trac/raw-attachment/ticket/2121/gsmhandset.state.new -O /usr/share/openmoko/scenarios/gsmhandset.state

Audio problems

  • If you have problems with audio, try this:
modprobe snd-pcm-oss
  • If audio works, load this module on boot:
echo "snd-pcm-oss" > /etc/modutils/snd-pcm-oss
update-modules
  • Problems:
    • Allowing the FR to suspend or having the screen blackout while using mplayer will sometimes crash the FR
    • Plugging in the headset will stop audio from playing out of the phone's speaker. Audio will not return until the phone is shut off or you receive or make a call

Bugs / missing features

  • Screen lock is missing
    • currently X screen saver is used during screen blank
  • (Paroli) GUI to change ring tones missing
  • (Paroli) GUI for Bluetooth missing
  • Led indication for missed calls or sms missing
  • Battery indicator support for GTA01 broken
  • Boot time needs to be reduced to less than 2 minutes
    • install udev-static-devices - caveat you lose bind-home
    • use readahead to cache python dirs before starting framework and paroli
    • use readahead to cache dirs for X
    • remove unneeded startup programs ( ie portmap )
    • prime GSM during init for paroli's use
  • gsm0710muxd: "Modem does not respond to AT commands" #2257
  • oeventsd rules ignored FSO #381
  • Disabling suspend does not work #2296

Development

When we set the very limited goals of Om 2009 we had two goals in mind:

1. Give those members of the community who only wanted a daily phone, a distro they could use
2. Introduce technology that would allow the community to come together and improve on these basics

Community interaction, open development and user driven decision making are at the core of Om 2009. Going forward this will be an effort with the community for the community. I invite you to join the effort to make Om 2009 with paroli the best Om-labeled distribution for the Freerunner.

How can you help?

Test the distro, let us know about bugs you find, or even fix them and send us patches.

Tell us about your experiences using Om 2009, what should we change, where can we improve?

Paroli has come a long way but it still needs a lot of love and optimizing, so if you are into python or efl, check out the code from git.paroli.org, join #paroli on irc and let's get crackin'. There are lots of things to do, opimd needs to be integrated and improved, the UI needs polishing, overall speed can be increased etc etc

More into Chat and email? Feel like writing a jabber/irc/xxx or email client that really fits the screen? Or do you know of one? Let's hear about it. This device has a lot of potential and we are so close to reaching the far corners, the kernel is in good shape, the framework is doing great and telephony apps such as paroli or the shr suite are steadily improving.

So, get your Freerunner in shape again. Flash it with a nice current distro and let it do what it was meant to do :)

Let's make Om 2009 a community product, something all of us can be proud of and say "we did this".

Mirko/Openmoko at http://lists.openmoko.org/pipermail/community/2009-May/048061.html)

Reporting Bugs

Please enable debugging as instructed above. Attaching frameworkd.log and paroli.log will aid in solving the bug.

Please search the bug list for you issue before adding it to trac. Some of these issues might be Paroli or FSO issue so you can also check their tracs for solutions or discussions.

Personal tools
Screenshot of Paroli, the GSM app of OM2009

Om 2009 is the next version of the official Openmoko distribution. The latest release is testing5 from June 16th, 2009. It is currently under development. Om 2009 is based on FSO framework and uses Paroli as the telecommunication software.

Om 2009 testing5 already has all the features most people need for daily phone usage: SMS, calling, phone book, call log, charging, suspend&resume, wifi gui, audio profiles, etc.

Installing

Preparation

GSM firmware

If you don't have Moko11 as your GSM firmware yet, you should update it: See GSM/Flashing

bind-home

You can add a bind-home directory to the first partition (must be ext2 or ext3 ) of your SD card. On the OM2009 boot it will be mounted as /home/root. This way you can reflash your phone without losing anything in your home directory (Paroli contacts and settings, maps, etc)

Make sure there isn't a bind-home directory first

ls /media/card/bind-home

If this exists you are already using bind-home, otherwise keep following the directions below and reboot after this

mv /home/root /media/card/bind-home
mkdir /home/root

Boot loader

Also update to the latest versions of qi or uboot bootloaders The latest boot loader files are available at http://downloads.openmoko.org/distro/testing/

OM2009 Installation on Flash

Installing OM2009 is simple as flashing an image. Well, that's what you need to do..

  1. Download! You need the correct fso-paroli-image and uImage.bin files for your device. There are also rootfs tarballs for installing onto an SD card. Freerunner or Neo1973
  2. Flash! Detailed instructions for Freerunner and Neo1973.
  3. Start! The image will boot into fullscreen Paroli and all of the features listed above will be available. To learn more about Paroli, see Paroli

Boot AND REBOOT! The first time it boots there some problems might occur but they're gone after the second boot.

Installation on uSD

Make sure you use ext2 or ext3 as your file system on uSD. Then check this here: Paroli-developer-setup#Upgrading_Paroli_on_a_uSD_card_installation_of_OM2009 or Booting_from_SD#Prepare_the_SD_card.

Using OM2009

Write your best tips here!!

  • Change fullscreen paroli -> illume (settings->display->profile)
  • Enable wifi. (settings->wifi->power->active. settings->wifi->scan->'essid')
  • Allow ssh over wlan. (nano /etc/default/dropbear. =22)
  • If screen goes dim and phone suspends even all things are disabled, use this spell:
mdbus -s org.freesmartphone.ousaged /org/freesmartphone/Usage org.freesmartphone.Usage.SetResourcePolicy Display enabled
  • To learn to use Paroli, the phone software, go to Paroli#FAQ
  • To have log directory that isn't cleared when you reboot, the /var/log symlink needs to be turned into a directory:
rm /var/log
mkdir /var/log
  • To import vcard -contacts to Paroli, check this
  • To change Paroli's background, check Paroli-background
  • To prevent suspending when USB plugged in: unplug usb until LED goes out, then plug usb in: you need to keep the device awake by touching the screen until the LED comes back on. (bug: http://trac.freesmartphone.org/ticket/381)

Nytowl recommends against using the Angstrom feeds, if you want to mix feeds use the shr feeds as they are closer to the Om2009 distro

  • Angstrom feeds Contain many useful packages including mplayer and ffmpeg. Run these commands to add the angstrom feeds NOTE: You will not be able to upgrade OM2009 after this, it will break!
echo "arch base 50" > /etc/opkg/angstrom-feed.conf
echo "src/gz base http://www.angstrom-distribution.org/feeds/2008/ipk/glibc/armv4t/base" >> /etc/opkg/angstrom-feed.conf

Localization

Audio quality during call

  • Audio quality is good by default for some Freerunners. Some units need a new audio profile:
wget http://docs.openmoko.org/trac/raw-attachment/ticket/2121/gsmhandset.state.new -O /usr/share/openmoko/scenarios/gsmhandset.state

Audio problems

  • If you have problems with audio, try this:
modprobe snd-pcm-oss
  • If audio works, load this module on boot:
echo "snd-pcm-oss" > /etc/modutils/snd-pcm-oss
update-modules
  • Problems:
    • Allowing the FR to suspend or having the screen blackout while using mplayer will sometimes crash the FR
    • Plugging in the headset will stop audio from playing out of the phone's speaker. Audio will not return until the phone is shut off or you receive or make a call

Bugs / missing features

  • Screen lock is missing
    • currently X screen saver is used during screen blank
  • (Paroli) GUI to change ring tones missing
  • (Paroli) GUI for Bluetooth missing
  • Led indication for missed calls or sms missing
  • Battery indicator support for GTA01 broken
  • Boot time needs to be reduced to less than 2 minutes
    • install udev-static-devices - caveat you lose bind-home
    • use readahead to cache python dirs before starting framework and paroli
    • use readahead to cache dirs for X
    • remove unneeded startup programs ( ie portmap )
    • prime GSM during init for paroli's use
  • gsm0710muxd: "Modem does not respond to AT commands" #2257
  • oeventsd rules ignored FSO #381
  • Disabling suspend does not work #2296

Development

When we set the very limited goals of OM2009 we had two goals in mind:

1. Give those members of the community who only wanted a daily phone, a distro they could use
2. Introduce technology that would allow the community to come together and improve on these basics

Community interaction, open development and user driven decision making are at the core of Om2009. Going forward this will be an effort with the community for the community. I invite you to join the effort to make om2009 with paroli the best Om-labeled distribution for the Freerunner.

How can you help?

Test the distro, let us know about bugs you find, or even fix them and send us patches.

Tell us about your experiences using om2009, what should we change, where can we improve?

Paroli has come a long way but it still needs a lot of love and optimizing, so if you are into python or efl, check out the code from git.paroli.org, join #paroli on irc and let's get crackin'. There are lots of things to do, opimd needs to be integrated and improved, the UI needs polishing, overall speed can be increased etc etc

More into Chat and email? Feel like writing a jabber/irc/xxx or email client that really fits the screen? Or do you know of one? Let's hear about it. This device has a lot of potential and we are so close to reaching the far corners, the kernel is in good shape, the framework is doing great and telephony apps such as paroli or the shr suite are steadily improving.

So, get your Freerunner in shape again. Flash it with a nice current distro and let it do what it was meant to do :)

Let's make Om2009 a community product, something all of us can be proud of and say "we did this".

Mirko/Openmoko at http://lists.openmoko.org/pipermail/community/2009-May/048061.html)

Reporting Bugs

Please enable debugging as instructed above. Attaching frameworkd.log and paroli.log will aid in solving the bug.

Please search the bug list for you issue before adding it to trac. Some of these issues might be Paroli or FSO issue so you can also check their tracs for solutions or discussions.