Openmoko - User contributions [en]

SHR

2009-10-22T17:42:37Z

Tanuva: /* Feature overview */ Forgot to change color

{{Languages|SHR}}
[[Image:Shr-tnc01.jpg|right|thumb|300px|Full Image with [[Edje|custom Background]] ]]
{{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, 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 [http://www.openembedded.org/ Openembedded]. <tt>XGlamo</tt> is providing X server environment and [[Illume]] (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>ophonekitd</tt> daemon is run with X server start-up and it communicates with FSO via <tt>d-bus</tt>. SHR phone applications talk to <tt>ophonekitd</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>libframeworkd-phonegui-efl</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==
In the overview below are all the essential features and their status for the current '''out of the box''' SHR unstable distribution (latest+[http://en.wikipedia.org/wiki/Module_(Linux) 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.

{| cellspacing="0" class="sortable wikitable" border="1" style="font-size: 85%; text-align: left; width: auto;"
|-
! Category
! Name
! Functionality
! Comments
|-
| System
| Power Management
| style="background:#88FF88;"| Suspend
| when slow, use [[Qi]]
|-
| System
| Package manager
| style="background:#88FF88;"| Installing and upgrading packages
| Works well. For packages not in the repository, just ask for them to be added via the trac
|-
| System
| Keyboard
| style="background:#88FF88;"| Offer stylus and finger friendly keyboards
| Alternative keyboards are now available in repositories.
|-
| GSM
| Network
| style="background:#88FF88;"| Connect via SIM and PIN
|
|-
| GSM
| Network
| style="background:#FF8888;"| Flight mode
| style="background:#FF8888;"| [http://trac.shr-project.org/trac/ticket/333 SHR ticket #333]
|-
| GSM
| Dailer
| style="background:#88FF88;"| Receiving Call
| no way to adjust (double) audio in and audio out
|-
| GSM
| Dailer
| 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
| Phone Log
| style="background:#88FF88;"| Overview Log (In, Out, Answered, All)
|
|-
| GSM
| Phone Log
| style="background:#88FF88;"| Display Missed Calls
|
|-
| GSM
| Phone Log
| style="background:#88FF88;"| Making reply Call from Log
|
|-
| GSM
| Phone Log
| style="background:#88FF88;"| Sending reply SMS from Log
|
|-
| Shared
| Phone Log
| style="background:#88FF88;"| Creating new SIM contact from Log
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Receiving SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| SIM phonebook lookup for SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| View overview of received SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Selecting SMS from Overview
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Viewing SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Writing SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Sending new SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Sending reply SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Making reply Call
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Deleting SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Storing received contact in contacts
|
|-
| GSM
| GPRS
| style="background:#88FF88;"| Configuring and Enabling GPRS
| Settings->Connectivity: GPRS connect
|-
| Shared
| Contacts
| style="background:#88FF88;"| Reading SIM contacts
|
|-
| Shared
| Contacts
| style="background:#88FF88;"| Selecting SIM contact from Overview
|
|-
| Shared
| Contacts
| style="background:#88FF88;"| Creating new SIM contact
|
|-
| Shared
| Contacts
| style="background:#88FF88;"| Editing SIM contact
|
|-
| Shared
| Contacts
| style="background:#88FF88;"| Deleting SIM contact
|
|-
| Shared
| Contacts
| style="background:#FF8888;"| Quick lookup contact with keyboard
|
|-
| Shared
| Contacts
| style="background:#88FF88;"| Calling contact
|
|-
| Shared
| Contacts
| style="background:#88FF88;"| Sending SMS to contact
|
|-
| Shared
| Contacts
| style="background:#FF8888;"| Sending contact via SMS to contact
|
|-
| WiFi
| Ethernet
| style="background:#88FF88;"| Configuring and Enabling WiFi connection
| 1) Settings->Connectivity->WiFi radio=On 2) Mokonnect
|-
| GPS
| Service
| style="background:#88FF88;"| Receiving GPS data
| automatically turning on when needed
|-
| USB
| Ethernet
| style="background:#88FF88;"| Configuring and Enabling USB connection
| done automatically with insecure password
|-
| Audio
| Headset
| style="background:#FF8888;"| Handsfree calling
| headphones work, microphone does not work (needs checking if it's true!)
|-
|}

==Image content==

These applications are included in the full and lite SHR images:
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|Lite image 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 (Last.fm client)
* Intone (audio player)
||

|-

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

|-

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

==User Manual==
SHR has a full [[SHR User Manual|user manual]].

== More Information ==

Visit:
* [http://blog.shr-project.org Blog]
* [http://trac.shr-project.org Project Homepage/Trac (Bugtracker)]
* [http://git.shr-project.org Git (Sourcecode-repository)]
* [http://build.shr-project.org Buildhost (Downloads)]
* [http://shr-project.org/trac/wiki/Tweaks Tweaks (On the Wiki)]
* [http://lists.shr-project.org SHR User and Development Mailing Lists]

[[Category:SHR| ]]

SHR

2009-10-22T17:41:50Z

Tanuva: /* Feature overview */ Multipart sms is working according to TAsn (#openmoko-cdevel)

{{Languages|SHR}}
[[Image:Shr-tnc01.jpg|right|thumb|300px|Full Image with [[Edje|custom Background]] ]]
{{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, 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 [http://www.openembedded.org/ Openembedded]. <tt>XGlamo</tt> is providing X server environment and [[Illume]] (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>ophonekitd</tt> daemon is run with X server start-up and it communicates with FSO via <tt>d-bus</tt>. SHR phone applications talk to <tt>ophonekitd</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>libframeworkd-phonegui-efl</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==
In the overview below are all the essential features and their status for the current '''out of the box''' SHR unstable distribution (latest+[http://en.wikipedia.org/wiki/Module_(Linux) 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.

{| cellspacing="0" class="sortable wikitable" border="1" style="font-size: 85%; text-align: left; width: auto;"
|-
! Category
! Name
! Functionality
! Comments
|-
| System
| Power Management
| style="background:#88FF88;"| Suspend
| when slow, use [[Qi]]
|-
| System
| Package manager
| style="background:#88FF88;"| Installing and upgrading packages
| Works well. For packages not in the repository, just ask for them to be added via the trac
|-
| System
| Keyboard
| style="background:#88FF88;"| Offer stylus and finger friendly keyboards
| Alternative keyboards are now available in repositories.
|-
| GSM
| Network
| style="background:#88FF88;"| Connect via SIM and PIN
|
|-
| GSM
| Network
| style="background:#FF8888;"| Flight mode
| style="background:#FF8888;"| [http://trac.shr-project.org/trac/ticket/333 SHR ticket #333]
|-
| GSM
| Dailer
| style="background:#88FF88;"| Receiving Call
| no way to adjust (double) audio in and audio out
|-
| GSM
| Dailer
| 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
| Phone Log
| style="background:#88FF88;"| Overview Log (In, Out, Answered, All)
|
|-
| GSM
| Phone Log
| style="background:#88FF88;"| Display Missed Calls
|
|-
| GSM
| Phone Log
| style="background:#88FF88;"| Making reply Call from Log
|
|-
| GSM
| Phone Log
| style="background:#88FF88;"| Sending reply SMS from Log
|
|-
| Shared
| Phone Log
| style="background:#88FF88;"| Creating new SIM contact from Log
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Receiving SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| SIM phonebook lookup for SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| View overview of received SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Selecting SMS from Overview
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Viewing SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Writing SMS
|
|-
| GSM
| SMS
| style="background:#FFDD88;"| Sending new SMS
|
|-
| GSM
| SMS
| style="background:#FFDD88;"| Sending reply SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Making reply Call
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Deleting SMS
|
|-
| GSM
| SMS
| style="background:#88FF88;"| Storing received contact in contacts
|
|-
| GSM
| GPRS
| style="background:#88FF88;"| Configuring and Enabling GPRS
| Settings->Connectivity: GPRS connect
|-
| Shared
| Contacts
| style="background:#88FF88;"| Reading SIM contacts
|
|-
| Shared
| Contacts
| style="background:#88FF88;"| Selecting SIM contact from Overview
|
|-
| Shared
| Contacts
| style="background:#88FF88;"| Creating new SIM contact
|
|-
| Shared
| Contacts
| style="background:#88FF88;"| Editing SIM contact
|
|-
| Shared
| Contacts
| style="background:#88FF88;"| Deleting SIM contact
|
|-
| Shared
| Contacts
| style="background:#FF8888;"| Quick lookup contact with keyboard
|
|-
| Shared
| Contacts
| style="background:#88FF88;"| Calling contact
|
|-
| Shared
| Contacts
| style="background:#88FF88;"| Sending SMS to contact
|
|-
| Shared
| Contacts
| style="background:#FF8888;"| Sending contact via SMS to contact
|
|-
| WiFi
| Ethernet
| style="background:#88FF88;"| Configuring and Enabling WiFi connection
| 1) Settings->Connectivity->WiFi radio=On 2) Mokonnect
|-
| GPS
| Service
| style="background:#88FF88;"| Receiving GPS data
| automatically turning on when needed
|-
| USB
| Ethernet
| style="background:#88FF88;"| Configuring and Enabling USB connection
| done automatically with insecure password
|-
| Audio
| Headset
| style="background:#FF8888;"| Handsfree calling
| headphones work, microphone does not work (needs checking if it's true!)
|-
|}

==Image content==

These applications are included in the full and lite SHR images:
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|Lite image 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 (Last.fm client)
* Intone (audio player)
||

|-

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

|-

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

==User Manual==
SHR has a full [[SHR User Manual|user manual]].

== More Information ==

Visit:
* [http://blog.shr-project.org Blog]
* [http://trac.shr-project.org Project Homepage/Trac (Bugtracker)]
* [http://git.shr-project.org Git (Sourcecode-repository)]
* [http://build.shr-project.org Buildhost (Downloads)]
* [http://shr-project.org/trac/wiki/Tweaks Tweaks (On the Wiki)]
* [http://lists.shr-project.org SHR User and Development Mailing Lists]

[[Category:SHR| ]]

Illume keyboard

2009-10-01T11:26:37Z

Tanuva: /* List of layouts */ Added basic Neo 2.0

'''[[Illume]] keyboard''' (aka '''Raster's Keyboard''', as it has been made by user:Rasterman) is a non-predictive, optionally corrective virtual [http://en.wikipedia.org/wiki/Keyboard_%28computing%29#Touchscreens touchscreen keyboard].

The Illume keyboard is the default touchscreen keyboard in [[Om 2009]].

== How to use ==

The Illume keyboard has been thought to guess the word you want to type and suggest it to you before you end typing, but to take into account the fact that since the keyboard space is little, you might have pressed a wrong key while typing.

It is intended to work with a dictionary for your language, any dictionary taken from the /usr/share/dict directory of your linux distro is ok. After you have the dictionary, the keyboard learns new words as you type them. (090809: Hopefully not my passwords and other sensitive phrases?)

Illume keyboard has three modes you can use:
*Default
*Number
*Terminal
You can switch with the button on top right.

Number and Terminal are quite self-explaining, the only interesting thing is that if you feel like changing their layout to something more comfortable to you, then read [[#Localization]].

Default mode works like this:
* you type a sequence of letters
* for each letter you type the keyboard takes into consideration the distance from the point you pressed and ANY letter in the neighborhood, not only the one you pressed. This is because you might have missed the letter you wanted to type.
* while you type, the keyboard makes a combination of all the words that you could have typed, looks for them in the dictionary and presents them in an order that depends both on their frequency use and the distance from coordinates from where you touch the screen.

Now tips and usage tricks:
* if you want to enter a word that it's not in the keyboard, you simply enter it, then push the button on top left. That button shows the complete list of the possible words, and on top of it the one you really entered.
* if you push a letter and keep it pushed for a couple seconds, you enter exactly that letter.
* to backspace or whitespace you slide with your finger on any place in the keyboard from right to left or from left to right.

You do not need to erase that much, keep in mind that the keyboard is done to correct your errors, so if you realize you pushed the wrong letter, go on typing instead of erasing.

Raster explained this in a long and detailed post, [http://lists.openmoko.org/nabble.html#nabble-td2115715 here]

How to use gestures:
* Sliding down over any keyboard sends Enter
* Sliding up over any keyboard switches to the next keyboard
* Tapping the upper-right key ("a", "1" or "q") lists the available keyboards
* Tapping the upper-left key "Abc" lists the available dictionaries
 
* With "a" keyboard:
* Sliding left over the keyboard deletes the last entered key
* Sliding right over the keyboard sends the composed word
* Tapping the upper-left key "Abc" during the composition of a word
lists all possible words in order to choose the right one
 
* With "q" keyboard:
* Sliding left over the keyboard sends a backspace
* Sliding right over the keyboard sends a space

== How to install ==
{{Note|This install section might not be up to date for Om 2009}}
Make sure you have installed illume-config (qwerty button) and illume-config-illume
<pre>
opkg install illume-config illume-config-illume
</pre>

Turn off built-in qtopia keyboard:

Edit /etc/X11/Xsession.d/89qtopia and set
<pre>
export QTOPIA_NO_VIRTUAL_KEYBOARD=1
</pre>
Add it if it is not there.

Purge E's cache
<pre>
rm -rf ~/.e/e/config/illume
</pre>

Restart X
<pre>
/etc/init.d/xserver-nodm restart
</pre>

Then switch keyboard from "None" to "Default" in Illume's preferences.

*Troubleshoting
If this does not work for your installation: See [[Keyboard Toggle]] or change /etc/enlightenment/default_profile to point to the illume profile instead of asu.

== Localization ==
===Adding layout via an opkg package===
To install another layout from the list in the next section. Copy the package link and insert it instead of <layoutpackage> or via the SHR's repositories (illume-keyboard-LANG) and hopefully will be available in other repositories soon (where? Which prefix http-link?):
opkg install <layoutpackage>
E.g.:
opkg install http://www.aitel.hist.no/~helgehaf/openmoko/illume-keyboards-norwegian-no_0.1_all.ipk

===List of layouts===
{| class="wikitable sortable" border="1" cellpadding="5" cellspacing="0"
! icon !! type (mode) !! package !! comments
|-
| [[Image:Arabic.png]] || alphanumeric || [http://www.opkg.org/packages/illume-keyboards-arabic_0.1_armv4t.ipk Arabic QWERTY layout] || optimized for arabic alphanumeric layout.
|-
| [[Image:Qwerty.png]] || terminal || [http://trac.enlightenment.org/e/browser/trunk/e/src/modules/illume/keyboards/Terminal.kbd English QWERTY layout] || Installed by default.
|-
| [[Image:Qwerty-dutch-nl.png]] || terminal || [http://www.opkg.org/package_179.html Dutch QWERTY layout] || Based upon QWERTY terminal layout, optimised for Dutch, usable for most north-western European languages.
|-
| [[Image:Azerty-french-fr.png]] || terminal || [http://depot.tuxgasy.fr/download/openmoko/azerty/Azerty.kbd French AZERTY layout] || Based upon QWERTY terminal layout. TODO: Icon needs AZERTY overlay.
|-
| [[Image:Qwerty-norwegian-no.png]] || terminal || [http://www.aitel.hist.no/~helgehaf/openmoko/ Norwegian QWERTY layout] || Based upon QWERTY terminal layout.
|-
| [[Image:Terminal-russian-ru.png]] || terminal || [http://kyllene.net/openmoko Russian ЙЦУКЕН layout] || Based upon QWERTY terminal layout.
|-
| [[Image:Dvorak.png]] || terminal || [http://tg.x-net.hu/openmoko/keyboards/ Dvorak layout ] || Based upon QWERTY terminal layout.
|-
| [[Image:Alpha.png]] || alphanumeric || [http://trac.enlightenment.org/e/browser/trunk/e/src/modules/illume/keyboards/Default.kbd English QWERTY layout] || Installed by default.
|-
| [[Image:Alpha.png]] || alphanumeric || [http://www.opkg.org/package_180.html English finger friendly QWERTY layout] || Based upon QWERTY alphanumeric layout.
|-
| [[Image:Alpha-hebrew-il.png]] || alphanumeric || [http://www.stosb.com/openmoko/illume-keyboards-hebrew_0.4_armv4t.ipk Hebrew פםןךטא layout] || In case there are squares instead of Hebrew letters, change illume's font.
|-
| [[Image:Alpha-danish-dk.png]] || alphanumeric || [http://projects.openmoko.org/projects/danish-illume/ Danish QWERTY layout] || Based upon QWERTY alphanumeric layout.
|-
| [[Image:Alpha-german-de.png]] || alphanumeric || [http://www.hackenberger.at/openmoko/German.kbd German QWERTZ layout] || Based upon QWERTY alphanumeric layout.
|-
| [[Image:Alpha-german-de.png]] || alphanumeric || [http://d-a300.selfip.net/files/Neo%202.0.kbd Basic Neo 2.0 layout] || Based upon German QWERTZ layout. Only first layer (letters).
|-
| [[Image:Alpha.png]] || alphanumeric || [http://milad.rastian.com/tmp/Persian.kbd Perisan QWERTZ layout] || Based upon QWERTY alphanumeric layout. TODO: Create new icon for the Persian alphabet of پﺏﺍ like the transparent ABC.
|-
| [[Image:numeric.png]] || numeric || [http://trac.enlightenment.org/e/browser/trunk/e/src/modules/illume/keyboards/Numbers.kbd Numeric layout] || Installed by default.
|-
| [[Image:numeric-alt.png]] || numeric || [http://www.opkg.org/package_106.html Alternative finger friendly numeric layout] || Major improvement on numeric layout.
|-
| [[Image:browse.png]] || numeric || [http://www.opkg.org/package_144.html Finger friendly browse layout] || Derived from numeric layout.
|}

'''NOTE:''' They are all available from SHR's repositories (illume-keyboard-LANG) and hopefully will be available in other repos soon.

Icons are created by hand in a 25x25 PNG with the GIMP according to color picker values of flags in Wikipedia. The reason for this is, that no rescaling or ant-alias artifacts will emerge in this small raster. Subsequently, import this in Inkscape and type the characters. Note that for keyboard layout that are not connected to a single particular country, like Persian, no flag backgrouns is needed. Each character is typed twice in Arial Black or bold Arial. For alphanumeric, use the ABC of that language, for 'QWERTY' use the 6 first characters on the top row, note that for languages that read from richt to left is to use 'first'/last 6 characters on the right side. One characters is white with a black border of 0.5 and one is black without border but with a blur of 15 (see CTRL+SHIFT+F slider at the bottom). Reposition the whole lot and put everything in the correct layer. Export a 25x25 PNG with the background bitmap, which is also the selected export area, and you are done. [http://www.youtube.com/watch?v=F6QNL1mvXdI Here] is a video of this procedure.

'''TODO''': Rasterman, can you verify this and improve this procedure where needed? Especially improve details on which font to use and which Gaussian blur to use.

=== How to install a new layout ===
{{Note|This install section might not be up to date for Om 2009}}

* copy or download the kbd File to <pre>/usr/lib/enlightenment/modules/illume/keyboards</pre>
* issue the command: <pre>killall -HUP enlightenment</pre>
* if that didn't work do: now restart the XServer with the following command <pre>/etc/init.d/xserver-nodm restart</pre>
* you should now be able to select the newly installed keyboard

=== How to make your own layout (illustration)===

<pre>
##KBDCONF-1.0
kbd 450 150

# keyboard type e.g. TERMINAL, ALPHA (this one shows up when writing an sms), NUMERIC, SYMBOL
type TERMINAL
# an icon for the keyboard so you know which one you have
icon qwerty.png

#key x-coordinate y-coordinate width-of-key height-of-key
#columns:
#state symbol(shown on the key) keysym(output of the key)
key 0 0 30 30
normal ` grave
shift ~ asciitilde
capslock ` grave
</pre>

a list of keysyms can be found [http://www.in-ulm.de/~mascheck/X11/keysyms.txt here]

=== How to import dictionaries ===
If you want to use illume's predictive keyboard in a language other than US English, you should import your own dictionary. You can find a .dic file that works with illume in [http://en.wikipedia.org/wiki/MySpell myspell] or [http://en.wikipedia.org/wiki/Hunspell hunspell]. If you have it installed on your linux machine, you should find the dictionary file in <pre>/usr/share/myspell/dicts</pre> Just copy it over to <pre>/usr/lib/enlightenment/modules/illume/dicts/</pre> on your phone. Now you should be able to select it via the dictionary selector on the illume keyboard. The drawback is that they don't come with predefined frequency values though, so predictions won't be very good at first until illume has learned by usage. Still a "dumb" dictionary in your own language should work much better than a smart English one for non-english texts.

The Terminal layout has an empty dictionary. The words you type are entered automatically in the dictionary.

To add another language you have to do the following steps:
* Get a dictionary file from your computer.
On Debian/Ubuntu systems, it is located in /usr/share/dict
Here is a [http://blog.1407.org/2008/10/13/portuguese-dictionary-for-openmokos-illume-keyboard/ Portuguese dictionary for OpenMoko’s Illume keyboard].

To add a dictionary you can find them by typing :
apt-cache search wordlist|grep ^w|sort
and install it on your computer with :
apt-get install wfrench # (replace french with your language)
* Copy the dictionary to your freerunner in /usr/lib/enlightenment/modules/illume/dicts/
for example do :
scp /usr/share/dict/french root@192.168.0.202:/usr/lib/enlightenment/modules/illume/dicts/French.dic
* Now you can choose your language in the upper left corner of the keyboard !

[[Category:Touchscreen keyboards| ]]

Community Updates/2009-09-30

2009-09-30T18:47:14Z

Tanuva: /* New Applications */

{{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=Debian|
Description=SHR has been added to the Debian pkg-fso repository. In particular the following packages have been added:
* ophonekitd
* shr-messages, shr-dialer, shr-contacts
* intone
* neon|
Screenshot=Debian.png|
Codename=unstable|
Homepage=http://debian.org|
Image=[http://wiki.debian.org/DebianOnFreeRunner HowTo Install]|
TestedOnHardware=?|
Neo1973={{yes}}|
FreeRunner={{yes}}|
HTC-Dream={{yes}}|
Other={{yes}}
}}

{{DistributionBox|
Name=Android Cupcake|
Description=The community has released its first version of Android Cupcake for the Freerunner. This project is continuing the work started by Koolu and includes additional code contributed by the community. In addition to the patches, separate artwork is being developed.
* Suspend during call issue is now fixed
* Alpha release of logo is available (see your left)
* [http://code.google.com/p/android-on-freerunner/ Join the Project]
 ''NOTE: The install process overwrites everything on the NAND, including the bootloader.''|
Screenshot=Android-on-Freerunner-Splash.png|
Codename=Android Cupcake on Freerunner v0.1.1|
Homepage=http://code.google.com/p/android-on-freerunner|
Image=[http://code.google.com/p/android-on-freerunner/wiki/GetIt How to install]|
TestedOnHardware=?| 
Neo1973={{unknown}}| 
FreeRunner={{yes}}|
HTC-Dream={{unknown}}|
Other={{unknown}}
}}

{{DistributionBox|
Name=QtMoko|
Description=QtMoko is a Debian-based distribution for the Openmoko Freerunner phone. Phone and user interface are based on QT Extended, formerly known as Qtopia. We have all Freerunner hardware working and also as a phone it should be very usable. Now we have a growing number of packages in the qtmoko-apps repository and also it is possible to access endless packages from Debian. Changes from previous version:
* fixed broken battery indicator after suspend (Jim Morris)
* fixed swap and memory problems (Jim Morris)
* fixed ogg in media player and as ringtone (Radek Polak)
* installable mp3 support (Radek Polak)
* virtual keyboard and window manager in X applications (Anton Olkhovik)
* finger keyboard supports skins (Anton Olkhovik)
* wlan script is now posix compliant (Torfinn Ingolfsen)
* latest andy-tracking kernel
 So enjoy, thanks to everyone who helped with this release and let Radek Polak know how you like it.|
Screenshot=Qtmokomain.png|
Codename='V12'|
Homepage=http://activationrecord.net/radekp/qtmoko/|
Image=[http://activationrecord.net/radekp/qtmoko/download/ images]|
Neo1973={{unknown}}|
FreeRunner={{yes}}|
HTC-Dream={{unknown}}|
Other={{unknown}}
}}

==Applications==
===New Applications===
{{ApplicationBox|
Name=Babiloo 2.0.9|
Description=Babiloo is a offline dictionaries reader.
* Supports dictionaries in SDictionary and StarDict formats.
* Voice capability.|
Screenshot=Babiloo.png|
Homepage=http://www.babiloo-project.org/wiki/index.php/Babiloo:Neo|
TestedOn=SHR|
PackageName=[http://www.opkg.org/packages/babiloo_2.0.9-1_neo.ipk Babiloo]
}}

{{ApplicationBox|
Name=Offline SHR Manager 0.1|
Description=Offline SHR Manager is a tool for you Desktop machine to support managing your Freerunner with tasks such as:
* making backups; restoring files
* comfortable editing configuration files
* manage GPS informations (tracks)
Please note: This app runs on your Desktop machine, NOT on your Freerunner.|
Screenshot=Oshyreman.png|
Homepage=https://projects.openmoko.org/projects/oshyreman/|
TestedOn=Ubuntu 9.04 with SHR-U on Freerunner|
PackageName=[http://projects.openmoko.org/frs/download.php/909/oshyreman-0.1.deb oshyreman]
}}

{{ApplicationBox|
Name=Arora git4|
Description=First release of Arora web browser for QtMoko is online! Check the package feed (Main menu->Settings->Software Packages). Discussion is [http://n2.nabble.com/QtMoko-Arora-web-browser-tp3731747p3731747.html here]. The port is based on Arora 0.4. This is an old version, but its functionality (together with additional improvements) is more than enough for a smartphone:
* tabs and windows
* downloads
* history
* bookmarks
* finger-scrolling
* finger-friendly toolbar and menus
* mobile user-agent (fake iPhone)
* many minor tweaks|
Screenshot=Arora_1.png|
Homepage=http://code.google.com/p/arora/|
TestedOn=QtMoko|
PackageName=[http://github.com/Sektor/arora-neo arora]
}}

{{ApplicationBox|
Name=Eieruhr|
Description=Eieruhr, german for egg-timer, is a simple countdown application. Right now, it supports one countdown at a time and counting down up to several hours, but is rather intended for helping hackers not to forget their pizza. :) Reaching zero, an arbitrary shell command, f.e. mplayer, can be executed. Eieruhr will appear in SHR's package feed when their build problems are resolved. Till then, the package should be available from the link underneath this text when I've got it from matzehuber.|
Screenshot=Eieruhr-screen.png|
Homepage=http://d-a300.selfip.net/eieruhr/eieruhr.html|
TestedOn=SHR|
PackageName=[http://d-a300.selfip.net/eieruhr/eieruhr-0.3.1.ipk eieruhr]
}}

{{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=ffalarms 0.2.4|
Description=ffalarms is a finger friendly alarms application.
* now looks like other Elementary programs
* add configuration option to change color of LED digits|
Screenshot=Ffalarms_0.2.4_add.png|
Homepage=http://projects.openmoko.org/projects/ffalarms/|
TestedOn=|
PackageName=[http://projects.openmoko.org/frs/download.php/905/ffalarms_0.2.4-r0_armv4t.ipk ffalarms]
}}

{{ApplicationBox|
Name=tangogps 0.9.7|
Description=tangogps is an easy to use, fast and lightweight mapping application for use with or without GPS. The new features include:
* overzoom until level 20
* upscaling of missing tiles
* a map scale indicator
* overhauled "this point" function
* friend function simplified and you can now add a message to your position|
Screenshot=SHR-TangoGPS-OSM.png|
Homepage=http://www.tangogps.org/gps/cat/About|
PackageName=[http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk tangogps]|
TestedOn=Om2009T5,Om2008.8,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-15''' September Openmoko "Stammtisch" in Munich (informal meeting) - 7 attendants from Germany and 1 from Canada: a lot of hardware and software projects were represended and discussed
* '''2009-09-19''' Christoph Mair posted about his working prototype of a Freerunner with HMC5843 three-axis magnetometer. It is part of a project which will include two gyros (XY, Z), the magnetometer and a MSP430 microcontroller which allows to add other features. [http://lists.openmoko.org/pipermail/devel/2009-September/006262.html Link to original mail].
* '''2009-09-20''' [http://gta02-core-news.blogspot.com/2009/09/weekly-news-for-20th-september.html gta02-core-news 3rd edition] released. Good news from University of São Paulo in Brasil.
* '''2009-09-22''' Tom Yates and Tom White held a small but perfectly-formed OM meeting in the Granta pub in Cambridge, UK, and talked about many things including X on the FreeRunner.

* '''2009-mm-dd''' stuff happens...

==Event News==
* '''2009-mm-dd''' [http://example.url.xom Example event] | add your event here
* '''2009-10-01''' Open World Forum Paris. Bearstech and Hackable:1 giving presentations on the morning of the first day
* '''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-30T18:46:21Z

Tanuva: /* New Applications */ Added Eieruhr

{{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=Debian|
Description=SHR has been added to the Debian pkg-fso repository. In particular the following packages have been added:
* ophonekitd
* shr-messages, shr-dialer, shr-contacts
* intone
* neon|
Screenshot=Debian.png|
Codename=unstable|
Homepage=http://debian.org|
Image=[http://wiki.debian.org/DebianOnFreeRunner HowTo Install]|
TestedOnHardware=?|
Neo1973={{yes}}|
FreeRunner={{yes}}|
HTC-Dream={{yes}}|
Other={{yes}}
}}

{{DistributionBox|
Name=Android Cupcake|
Description=The community has released its first version of Android Cupcake for the Freerunner. This project is continuing the work started by Koolu and includes additional code contributed by the community. In addition to the patches, separate artwork is being developed.
* Suspend during call issue is now fixed
* Alpha release of logo is available (see your left)
* [http://code.google.com/p/android-on-freerunner/ Join the Project]
 ''NOTE: The install process overwrites everything on the NAND, including the bootloader.''|
Screenshot=Android-on-Freerunner-Splash.png|
Codename=Android Cupcake on Freerunner v0.1.1|
Homepage=http://code.google.com/p/android-on-freerunner|
Image=[http://code.google.com/p/android-on-freerunner/wiki/GetIt How to install]|
TestedOnHardware=?| 
Neo1973={{unknown}}| 
FreeRunner={{yes}}|
HTC-Dream={{unknown}}|
Other={{unknown}}
}}

{{DistributionBox|
Name=QtMoko|
Description=QtMoko is a Debian-based distribution for the Openmoko Freerunner phone. Phone and user interface are based on QT Extended, formerly known as Qtopia. We have all Freerunner hardware working and also as a phone it should be very usable. Now we have a growing number of packages in the qtmoko-apps repository and also it is possible to access endless packages from Debian. Changes from previous version:
* fixed broken battery indicator after suspend (Jim Morris)
* fixed swap and memory problems (Jim Morris)
* fixed ogg in media player and as ringtone (Radek Polak)
* installable mp3 support (Radek Polak)
* virtual keyboard and window manager in X applications (Anton Olkhovik)
* finger keyboard supports skins (Anton Olkhovik)
* wlan script is now posix compliant (Torfinn Ingolfsen)
* latest andy-tracking kernel
 So enjoy, thanks to everyone who helped with this release and let Radek Polak know how you like it.|
Screenshot=Qtmokomain.png|
Codename='V12'|
Homepage=http://activationrecord.net/radekp/qtmoko/|
Image=[http://activationrecord.net/radekp/qtmoko/download/ images]|
Neo1973={{unknown}}|
FreeRunner={{yes}}|
HTC-Dream={{unknown}}|
Other={{unknown}}
}}

==Applications==
===New Applications===
{{ApplicationBox|
Name=Babiloo 2.0.9|
Description=Babiloo is a offline dictionaries reader.
* Supports dictionaries in SDictionary and StarDict formats.
* Voice capability.|
Screenshot=Babiloo.png|
Homepage=http://www.babiloo-project.org/wiki/index.php/Babiloo:Neo|
TestedOn=SHR|
PackageName=[http://www.opkg.org/packages/babiloo_2.0.9-1_neo.ipk Babiloo]
}}

{{ApplicationBox|
Name=Offline SHR Manager 0.1|
Description=Offline SHR Manager is a tool for you Desktop machine to support managing your Freerunner with tasks such as:
* making backups; restoring files
* comfortable editing configuration files
* manage GPS informations (tracks)
Please note: This app runs on your Desktop machine, NOT on your Freerunner.|
Screenshot=Oshyreman.png|
Homepage=https://projects.openmoko.org/projects/oshyreman/|
TestedOn=Ubuntu 9.04 with SHR-U on Freerunner|
PackageName=[http://projects.openmoko.org/frs/download.php/909/oshyreman-0.1.deb oshyreman]
}}

{{ApplicationBox|
Name=Arora git4|
Description=First release of Arora web browser for QtMoko is online! Check the package feed (Main menu->Settings->Software Packages). Discussion is [http://n2.nabble.com/QtMoko-Arora-web-browser-tp3731747p3731747.html here]. The port is based on Arora 0.4. This is an old version, but its functionality (together with additional improvements) is more than enough for a smartphone:
* tabs and windows
* downloads
* history
* bookmarks
* finger-scrolling
* finger-friendly toolbar and menus
* mobile user-agent (fake iPhone)
* many minor tweaks|
Screenshot=Arora_1.png|
Homepage=http://code.google.com/p/arora/|
TestedOn=QtMoko|
PackageName=[http://github.com/Sektor/arora-neo arora]
}}

{{ApplicationBox|
Name=Eieruhr|
Description=Eieruhr, german for egg-timer, is a simple countdown application. Right now, it supports one countdown at a time and counting down up to several hours, but is rather intended for helping hackers not to forget their pizza. :) Reaching zero, an arbitrary shell command, f.e. mplayer, can be executed. Eieruhr will appear in SHR's package feed when their build problems are resolved. Till then, the package should be available from the link underneath this text when I've got it from matzehuber.|
Screenshot=Eieruhr-screen.png|
Homepage=http://d-a300.selfip.net/eieruhr.html|
TestedOn=SHR|
PackageName=eieruhr [http://d-a300.selfip.net/eieruhr/eieruhr-0.3.1.ipk]
}}

{{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=ffalarms 0.2.4|
Description=ffalarms is a finger friendly alarms application.
* now looks like other Elementary programs
* add configuration option to change color of LED digits|
Screenshot=Ffalarms_0.2.4_add.png|
Homepage=http://projects.openmoko.org/projects/ffalarms/|
TestedOn=|
PackageName=[http://projects.openmoko.org/frs/download.php/905/ffalarms_0.2.4-r0_armv4t.ipk ffalarms]
}}

{{ApplicationBox|
Name=tangogps 0.9.7|
Description=tangogps is an easy to use, fast and lightweight mapping application for use with or without GPS. The new features include:
* overzoom until level 20
* upscaling of missing tiles
* a map scale indicator
* overhauled "this point" function
* friend function simplified and you can now add a message to your position|
Screenshot=SHR-TangoGPS-OSM.png|
Homepage=http://www.tangogps.org/gps/cat/About|
PackageName=[http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk tangogps]|
TestedOn=Om2009T5,Om2008.8,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-15''' September Openmoko "Stammtisch" in Munich (informal meeting) - 7 attendants from Germany and 1 from Canada: a lot of hardware and software projects were represended and discussed
* '''2009-09-19''' Christoph Mair posted about his working prototype of a Freerunner with HMC5843 three-axis magnetometer. It is part of a project which will include two gyros (XY, Z), the magnetometer and a MSP430 microcontroller which allows to add other features. [http://lists.openmoko.org/pipermail/devel/2009-September/006262.html Link to original mail].
* '''2009-09-20''' [http://gta02-core-news.blogspot.com/2009/09/weekly-news-for-20th-september.html gta02-core-news 3rd edition] released. Good news from University of São Paulo in Brasil.
* '''2009-09-22''' Tom Yates and Tom White held a small but perfectly-formed OM meeting in the Granta pub in Cambridge, UK, and talked about many things including X on the FreeRunner.

* '''2009-mm-dd''' stuff happens...

==Event News==
* '''2009-mm-dd''' [http://example.url.xom Example event] | add your event here
* '''2009-10-01''' Open World Forum Paris. Bearstech and Hackable:1 giving presentations on the morning of the first day
* '''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]]

File:Eieruhr-screen.png

2009-09-30T18:24:54Z

Tanuva:

Community Updates/2009-09-02

2009-09-02T09:11:22Z

Tanuva: /* New Applications */ According to the alphabet, AGTL belongs above appraw.

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

===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=shr-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/.
* IDA Systems had announced buzz fix for Indian customers on Apr 20th. These days there has been some activities regarding the same. Currently, the situation is totally unplanned. Please follow this mail http://lists.openmoko.org/pipermail/community/2009-September/054310.html to get more idea. We think there would more users of FR that want this fix done in India. Please do reply on the mentioned email thread as well.
* '''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-02T09:10:29Z

Tanuva: /* New Applications */

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

===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=shr-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/.
* IDA Systems had announced buzz fix for Indian customers on Apr 20th. These days there has been some activities regarding the same. Currently, the situation is totally unplanned. Please follow this mail http://lists.openmoko.org/pipermail/community/2009-September/054310.html to get more idea. We think there would more users of FR that want this fix done in India. Please do reply on the mentioned email thread as well.
* '''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-01T09:50:54Z

Tanuva: /* New Applications */

Community Updates/2009-09-02

2009-09-01T09:25:09Z

Tanuva: /* Applications */ Added AGTL

Hall of Fame

2009-08-14T08:42:57Z

Tanuva:

There are some well polished, shiny applications out there that do what they should and are reliable for actually ''using'' them, not only playing with them.

Current polls for new apps take place on the discussion page.

{{ApplicationBox|
Name=Intone|
Description=Mplayer frontend
* Plays everything mplayer eats
* Makes use of bluetooth headsets and their control buttons|
Screenshot=Intone-1.png|
Homepage=http://code.google.com/p/intone/|
Author=[mailto:cchandel@yahoo.com CChandel alias c_c]|
TestedOn=Om2009T5, SHR|
PackageName=intone
}}

{{ApplicationBox|
Name=Mokomaze|
Description=You know that game where you have a metal ball on a tiltable wooden board and have to get it to the finish avoiding holes? Here you are. Addictive!
* 48 levels included
* Online level editor|
Screenshot=Mokomaze.png|
Homepage=http://mokomaze.projects.openmoko.org/|
Author=[mailto:ant007h@nospam@gmail.com Anton Olhovik]|
TestedOn=Om2009T5, SHR, Debian|
PackageName=mokomaze
}}

{{ApplicationBox|
Name=Neon|
Description=Image viewer
* Displays various images
* Can do automatic diashows
* Intuitive UI|
Screenshot=Neon viewer.png|
Homepage=http://neon.projects.openmoko.org/|
Author=[mailto:vfebvre@easter-eggs.com Valéry Febvre]|
TestedOn=Om2009T5, SHR|
PackageName=neon
}}

{{ApplicationBox|
Name=Numptyphysics|
Description=A physics sandbox
* Contains several levels of type "get the ball to the yellow star, regardless of ''how'' you do it"
* also has a sandbox mode|
Screenshot=Numpty_physics.png|
Homepage=http://numptyphysics.garage.maemo.org/|
Author=[mailto:numptyphysics@gmail.com Tim Edmonds]|
TestedOn=Om2009T5, SHR|
PackageName=numptyphysics
}}

{{ApplicationBox|
Name=Orrery|
Description=Pocket Planetarium
* Displays the night sky
* Moon phase calendars
* Rise/Set times
* Meteor shower info
* Can use GPS|
Screenshot=OrreryFullScreenConstellations.png|
Homepage=http://projects.openmoko.org/projects/orrery/|
Author=[mailto:orrery.moko@gmail.com Ken Young]|
TestedOn=Om2009T5, SHR, OM2007.x, OM2008.x, Debian|
PackageName=orrery
}}

{{ApplicationBox|
Name=TangoGPS|
Description=Displays [http://openstreetmap.org Openstreetmap.org] maps
* Downloads tiles automatically if an internet connection is available
* Shows POIs
* Tracks your movement and displays current speed
* Good for Geocaching|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org/gps/cat/About|
Author=[mailto:marcus.bauer+tangogps@gmail.com Marcus Bauer]|
TestedOn=Om2009T5, SHR|
PackageName=tangogps
}}

Hall of Fame

2009-08-14T08:42:23Z

Tanuva: Added numptyphysics

There are some well polished, shiny applications out there that do what they should and are reliable for actually ''using'' them, not only playing with them.

Current polls for new apps take place on the discussion page.

{{ApplicationBox|
Name=Intone|
Description=Mplayer frontend
* Plays everything mplayer eats
* Makes use of bluetooth headsets and their control buttons|
Screenshot=Intone-1.png|
Homepage=http://code.google.com/p/intone/|
Author=[mailto:cchandel@yahoo.com CChandel alias c_c]|
TestedOn=Om2009T5, SHR|
PackageName=intone
}}

{{ApplicationBox|
Name=Mokomaze|
Description=You know that game where you have a metal ball on a tiltable wooden board and have to get it to the finish avoiding holes? Here you are. Addictive!
* 48 levels included
* Online level editor|
Screenshot=Mokomaze.png|
Homepage=http://mokomaze.projects.openmoko.org/|
Author=[mailto:ant007h@nospam@gmail.com Anton Olhovik]|
TestedOn=Om2009T5, SHR, Debian|
PackageName=mokomaze
}}

{{ApplicationBox|
Name=Neon|
Description=Image viewer
* Displays various images
* Can do automatic diashows
* Intuitive UI|
Screenshot=Neon viewer.png|
Homepage=http://neon.projects.openmoko.org/|
Author=[mailto:vfebvre@easter-eggs.com Valéry Febvre]|
TestedOn=Om2009T5, SHR|
PackageName=neon
}}

{{ApplicationBox|
Name=Numptyphysics|
Description=A physics sandbox
* Contains several levels of type "get the Ball to the yellow star, regardless of ''how'' you do it"
* also has a sandbox mode|
Screenshot=Numpty_physics.png|
Homepage=http://numptyphysics.garage.maemo.org/|
Author=[mailto:numptyphysics@gmail.com Tim Edmonds]|
TestedOn=Om2009T5, SHR|
PackageName=numptyphysics
}}

{{ApplicationBox|
Name=Orrery|
Description=Pocket Planetarium
* Displays the night sky
* Moon phase calendars
* Rise/Set times
* Meteor shower info
* Can use GPS|
Screenshot=OrreryFullScreenConstellations.png|
Homepage=http://projects.openmoko.org/projects/orrery/|
Author=[mailto:orrery.moko@gmail.com Ken Young]|
TestedOn=Om2009T5, SHR, OM2007.x, OM2008.x, Debian|
PackageName=orrery
}}

{{ApplicationBox|
Name=TangoGPS|
Description=Displays [http://openstreetmap.org Openstreetmap.org] maps
* Downloads tiles automatically if an internet connection is available
* Shows POIs
* Tracks your movement and displays current speed
* Good for Geocaching|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org/gps/cat/About|
Author=[mailto:marcus.bauer+tangogps@gmail.com Marcus Bauer]|
TestedOn=Om2009T5, SHR|
PackageName=tangogps
}}

Talk:Hall of Fame

2009-08-13T22:32:06Z

Tanuva: Orrery is in, so the poll can get outta here

Quoting Adolph Vogel:

If you think this application deserves a place in the Hall of Fame please
vote(vouch) for it using the provided urls. Once we get 10 votes the app will
go into the Hall of Fame.

If you think that its not ready yet, vote "not yet" and please provide a
reason so that the developer knows and can focus on it.

And the nominees...

== Numptyphysics ==
* Wiki : http://wiki.openmoko.org/wiki/Numptyphysics
* Poll : http://www.doodle.com/p7t3qcxuz7zzn7ib

== sms-sentry ==
* Wiki : ?? http://wiki.openmoko.org/wiki/Anti-Theft_Mode
* Poll : http://www.doodle.com/rme4byc4dq6y4afn

== Navit ==
* Wiki : http://wiki.openmoko.org/wiki/Navit
* Poll : http://www.doodle.com/s34ws2ncfk8b6irz

== Elmdentica ==
* Wiki : http://code.google.com/p/elmdentica/
* Poll : http://www.doodle.com/v5pr79kqm2pkst4s

Talk:Hall of Fame

2009-08-13T10:06:33Z

Tanuva: First polls

Quoting Adolph Vogel:

If you think this application deserves a place in the Hall of Fame please
vote(vouch) for it using the provided urls. Once we get 10 votes the app will
go into the Hall of Fame.

If you think that its not ready yet, vote "not yet" and please provide a
reason so that the developer knows and can focus on it.

And the nominees...

== Orrery ==
* Wiki : http://wiki.openmoko.org/wiki/Orrery
* Poll : http://www.doodle.com/784mhduurew39fes

== Numptyphysics ==
* Wiki : http://wiki.openmoko.org/wiki/Numptyphysics
* Poll : http://www.doodle.com/p7t3qcxuz7zzn7ib

== sms-sentry ==
* Wiki : ?? http://wiki.openmoko.org/wiki/Anti-Theft_Mode
* Poll : http://www.doodle.com/rme4byc4dq6y4afn

== Navit ==
* Wiki : http://wiki.openmoko.org/wiki/Navit
* Poll : http://www.doodle.com/s34ws2ncfk8b6irz

== Elmdentica ==
* Wiki : http://code.google.com/p/elmdentica/
* Poll : http://www.doodle.com/v5pr79kqm2pkst4s

Hall of Fame

2009-08-13T10:04:25Z

Tanuva:

Hall of Fame

2009-08-13T09:12:33Z

Tanuva: Added neon

Hall of Fame

2009-08-12T10:19:01Z

Tanuva: Placed mokomaze above tangogps for the sake of an alphabetic order...

There are some well polished, shiny applications out there that do what they should and are reliable for actually ''using'' them, not only playing with them.

If you think an application should be added to this list, please open a thread on the om-community mailinglist first to discuss the app so that this list's quality stays high.
(''At least my opinion.'' [[User:Tanuva|Tanuva]])

{{ApplicationBox|
Name=Intone|
Description=Mplayer frontend
* Plays everything mplayer eats
* Makes use of bluetooth headsets and their control buttons|
Screenshot=System_boot.png|
Homepage=http://code.google.com/p/intone/|
Author=[mailto:cchandel@yahoo.com CChandel alias c_c]|
TestedOn=Om2009T5, SHR|
PackageName=intone
}}

{{ApplicationBox|
Name=Mokomaze|
Description=You know that game where you have a metal ball on a tiltable wooden board and have to get it to the finish avoiding holes? Here you are. Addictive!
* 14 levels included
* Online level editor|
Screenshot=System_boot.png|
Homepage=http://projects.openmoko.org/projects/mokomaze/|
Author=[mailto:ant007h@nospam@gmail.com Anton Olhovik]|
TestedOn=Om2009T5, SHR|
PackageName=mokomaze
}}

{{ApplicationBox|
Name=TangoGPS|
Description=Displays [http://openstreetmap.org Openstreetmap.org] maps
* Downloads tiles automatically if an internet connection is available
* Shows POIs
* Tracks your movement and displays current speed
* Good for Geocaching|
Screenshot=System_boot.png|
Homepage=http://www.tangogps.org/gps/cat/About|
Author=[mailto:marcus.bauer+tangogps@gmail.com Marcus Bauer]|
TestedOn=Om2009T5, SHR|
PackageName=tangogps
}}

Hall of Fame

2009-08-12T10:16:05Z

Tanuva:

There are some well polished, shiny applications out there that do what they should and are reliable for actually ''using'' them, not only playing with them.

If you think an application should be added to this list, please open a thread on the om-community mailinglist first to discuss the app so that this list's quality stays high.
(''At least my opinion.'' [[User:Tanuva|Tanuva]])

{{ApplicationBox|
Name=Intone|
Description=Mplayer frontend
* Plays everything mplayer eats
* Makes use of bluetooth headsets and their control buttons|
Screenshot=System_boot.png|
Homepage=http://code.google.com/p/intone/|
Author=[mailto:cchandel@yahoo.com CChandel alias c_c]|
TestedOn=Om2009T5, SHR|
PackageName=intone
}}

{{ApplicationBox|
Name=TangoGPS|
Description=Displays [http://openstreetmap.org Openstreetmap.org] maps
* Downloads tiles automatically if an internet connection is available
* Shows POIs
* Tracks your movement and displays current speed
* Good for Geocaching|
Screenshot=System_boot.png|
Homepage=http://www.tangogps.org/gps/cat/About|
Author=[mailto:marcus.bauer+tangogps@gmail.com Marcus Bauer]|
TestedOn=Om2009T5, SHR|
PackageName=tangogps
}}

{{ApplicationBox|
Name=Mokomaze|
Description=You know that game where you have a metal ball on a tiltable wooden board and have to get it to the finish avoiding holes? Here you are. Addictive!
* 14 levels included
* Online level editor|
Screenshot=System_boot.png|
Homepage=http://projects.openmoko.org/projects/mokomaze/|
Author=[mailto:ant007h@nospam@gmail.com Anton Olhovik]|
TestedOn=Om2009T5, SHR|
PackageName=mokomaze
}}

Hall of Fame

2009-08-12T10:05:44Z

Tanuva: Switched to application box like in community updates

There are some well polished, shiny applications out there that do what they should and are reliable for actually ''using'' them, not only playing with them.

If you think an application should be added to this list, please open a thread on the om-community mailinglist first to discuss the app so that this list's quality stays high.
(''At least my opinion.'' [[User:Tanuva|Tanuva]])

{{ApplicationBox|
Name=Intone|
Description=Mplayer frontend
* Plays everything mplayer eats
* Makes use of bluetooth headsets and their control buttons|
Screenshot=System_boot.png|
Homepage=http://code.google.com/p/intone/|
TestedOn=Om2009T5, SHR|
PackageName=intone
}}

{{ApplicationBox|
Name=TangoGPS|
Description=Displays [http://openstreetmap.org Openstreetmap.org] maps
* Downloads tiles automatically if an internet connection is available
* Shows POIs
* Tracks your movement and displays current speed
* Good for Geocaching|
Screenshot=System_boot.png|
Homepage=http://www.tangogps.org/gps/cat/About|
TestedOn=Om2009T5, SHR|
PackageName=tangogps
}}

{{ApplicationBox|
Name=Mokomaze|
Description=You know that game where you have a metal ball on a tiltable wooden board and have to get it to the finish avoiding holes? Here you are. Addictive!
* 14 levels included
* Online level editor|
Screenshot=System_boot.png|
Homepage=http://projects.openmoko.org/projects/mokomaze/|
TestedOn=Om2009T5, SHR|
PackageName=mokomaze
}}

Hall of Fame

2009-08-12T09:39:47Z

Tanuva: Added mokomaze

Hall of Fame

2009-08-12T09:28:08Z

Tanuva:

Hall of Fame

2009-08-12T09:27:00Z

Tanuva: Linked Openstreetmap.org

Hall of Fame

2009-08-12T09:25:47Z

Tanuva: Created initial list and descriptive text

EFL Documentation

2008-10-26T09:40:43Z

Tanuva: New page: This is a collection of links to possibly useful EFL documentation. <ul> <li>Example apps for the Python bindings in E17 svn https://svn.enlightenment.org/svn/e/trunk/BINDINGS/pytho...

This is a collection of links to possibly useful EFL documentation.

<ul>
<li>Example apps for the Python bindings in E17 svn 
https://svn.enlightenment.org/svn/e/trunk/BINDINGS/python/</li>
<li>Python EFL API documentation 
http://staff.get-e.org/~barbieri/python-efl-api/</li>
<li>"Introduction To The EFL" 
http://homepages.pathfinder.gr/kazanaki/contrib/</li>
<li>"Building Interfaces With Edje" 
http://www.cuddletech.com/edje/docs/html/edje_book.html</li>
<li>And, of course, the E17 wiki 
http://wiki.enlightenment.org/index.php/Main_Page</li>
</ul>

[[Category:EFL, documentation]]

User:Tanuva

2008-08-31T11:38:05Z

Tanuva: New page: Huh? What're you doing on *my* page? :) If you're bored, take a look at [http://d-etch.homelinux.net].

Huh? What're you doing on *my* page? :)

If you're bored, take a look at [http://d-etch.homelinux.net].

Talk:Debian

2008-08-31T11:35:28Z

Tanuva: Confirmed morlac's suspend fix

What's the purpose of this page's content wrt http://wiki.debian.org/DebianOnFreeRunner ? Which one should be modified in priority ? -- [[User:OlivierBerger|OlivierBerger]] 10:57, 31 August 2008 (UTC)

morlac's suspend fix works perfectly here.
--[[User:Tanuva|Tanuva]] 11:35, 31 August 2008 (UTC)

You may also see : [[Talk:Manual Debian]]

Talk:Manual Debian

2008-08-21T13:06:30Z

Tanuva: /* Sound */

Can we get some community / more official debian help. If some one wants to get the stylus / touch screen calibrated on the gta02 that would be great. Oh and lenny works nicely if you don't want to use sid. :) --[[User:Dbmoodb|Dbmoodb]] 16:54, 3 August 2008 (UTC)

== Booting ==

=== Umount ===

I remember seeing a umount /media/card command on this page which i don't see anymore. That's needed or you will get
/dev/mmcblk0p1 is mounted; will not make a filesystem here!
Fdisk will also complain
WARNING: rereading partition table failed, kernel still uses old table: Device or resource busy
I needed to umount and rewrite the partition table in order for /dev/mmcblk0p2 to appear.

=== Partitions ===

Why don't we boot from NAND?

What's the reason for two partitions? Is it because ext2load was broken? Can we just upgrade u-boot and use one partition?

Is there any need for a swap partition?

--[[User:Brian 252|Brian 252]] 15:22, 8 August 2008 (UTC)

== Touch screen calibration ==

Few days ago there was added calibration for gta02. It doesn't work correctly on my freerunnuer (the mouse pointer doesn't move where I click ant the touchscreen area is about 1/3 smaller then the screen). I tried /etc/pointercal from qtopia and openmoko but it is the same as with parameters from this wiki. Has somebody a tip how to fix this?

--[[User:Jakubzeman|Jakubzeman]] 07:42, 8 August 2008 (UTC)

Yeah i know what you mean Jakubzeman, it was suggested to me on irc to copy the X server from the 2007.2 distro / other distro to the debian installation... that fixes the pointer but you have to then set it up to work for gdm.... / autologin. NO SID IS NOT REQUIRED I'm using lenny. Oh and if some one wants to see if they can get a debian based kernel / merge / get some more modules from debian / general modules into a kernel for other hardware (such as a rt73 chipset wireless card that would be great :) ) [[User:Dbmoodb|Dbmoodb]] 08:09, 8 August 2008 (UTC)

Thanks for suggestion. I'll try it (and I'll report if I'm successful or not).
--[[User:Jakubzeman|Jakubzeman]] 08:56, 8 August 2008 (UTC)

== Sound ==

http://tehinterweb.com/freerunner/alsa.state.tgz [by dbmoodb]

If the sound card is configured properly but there's no sound coming out of the Freerunner, it most likely helps to restore an appropriate statefile from the tgz above which are also available on the [[Openmoko svn]] (/trunk/src/target/audio/om-gta0*).

For simple sound output to the internal stereo speakers, do:
alsactl -f /path/to/statefiles/stereoout.state restore
--[[User:Tanuva|Tanuva]] 12:59, 21 August 2008 (UTC)

Talk:Manual Debian

2008-08-21T13:05:55Z

Tanuva: /* Sound */

Can we get some community / more official debian help. If some one wants to get the stylus / touch screen calibrated on the gta02 that would be great. Oh and lenny works nicely if you don't want to use sid. :) --[[User:Dbmoodb|Dbmoodb]] 16:54, 3 August 2008 (UTC)

== Booting ==

=== Umount ===

I remember seeing a umount /media/card command on this page which i don't see anymore. That's needed or you will get
/dev/mmcblk0p1 is mounted; will not make a filesystem here!
Fdisk will also complain
WARNING: rereading partition table failed, kernel still uses old table: Device or resource busy
I needed to umount and rewrite the partition table in order for /dev/mmcblk0p2 to appear.

=== Partitions ===

Why don't we boot from NAND?

What's the reason for two partitions? Is it because ext2load was broken? Can we just upgrade u-boot and use one partition?

Is there any need for a swap partition?

--[[User:Brian 252|Brian 252]] 15:22, 8 August 2008 (UTC)

== Touch screen calibration ==

Few days ago there was added calibration for gta02. It doesn't work correctly on my freerunnuer (the mouse pointer doesn't move where I click ant the touchscreen area is about 1/3 smaller then the screen). I tried /etc/pointercal from qtopia and openmoko but it is the same as with parameters from this wiki. Has somebody a tip how to fix this?

--[[User:Jakubzeman|Jakubzeman]] 07:42, 8 August 2008 (UTC)

Yeah i know what you mean Jakubzeman, it was suggested to me on irc to copy the X server from the 2007.2 distro / other distro to the debian installation... that fixes the pointer but you have to then set it up to work for gdm.... / autologin. NO SID IS NOT REQUIRED I'm using lenny. Oh and if some one wants to see if they can get a debian based kernel / merge / get some more modules from debian / general modules into a kernel for other hardware (such as a rt73 chipset wireless card that would be great :) ) [[User:Dbmoodb|Dbmoodb]] 08:09, 8 August 2008 (UTC)

Thanks for suggestion. I'll try it (and I'll report if I'm successful or not).
--[[User:Jakubzeman|Jakubzeman]] 08:56, 8 August 2008 (UTC)

== Sound ==

http://tehinterweb.com/freerunner/alsa.state.tgz [by dbmoodb]

If the sound card is configured properly but there's no sound coming out of the Freerunner, it most likely helps to restore an appropriate statefile from the tgz above which are also available on the [[Openmoko SVN]] (/trunk/src/target/audio/om-gta0*).

For simple sound output to the internal stereo speakers, do:
alsactl -f /path/to/statefiles/stereoout.state restore
--[[User:Tanuva|Tanuva]] 12:59, 21 August 2008 (UTC)

Talk:Manual Debian

2008-08-21T12:59:14Z

Tanuva: /* sound */ added comment on statefiles if no sound output

Can we get some community / more official debian help. If some one wants to get the stylus / touch screen calibrated on the gta02 that would be great. Oh and lenny works nicely if you don't want to use sid. :) --[[User:Dbmoodb|Dbmoodb]] 16:54, 3 August 2008 (UTC)

== Booting ==

=== Umount ===

I remember seeing a umount /media/card command on this page which i don't see anymore. That's needed or you will get
/dev/mmcblk0p1 is mounted; will not make a filesystem here!
Fdisk will also complain
WARNING: rereading partition table failed, kernel still uses old table: Device or resource busy
I needed to umount and rewrite the partition table in order for /dev/mmcblk0p2 to appear.

=== Partitions ===

Why don't we boot from NAND?

What's the reason for two partitions? Is it because ext2load was broken? Can we just upgrade u-boot and use one partition?

Is there any need for a swap partition?

--[[User:Brian 252|Brian 252]] 15:22, 8 August 2008 (UTC)

== Touch screen calibration ==

Few days ago there was added calibration for gta02. It doesn't work correctly on my freerunnuer (the mouse pointer doesn't move where I click ant the touchscreen area is about 1/3 smaller then the screen). I tried /etc/pointercal from qtopia and openmoko but it is the same as with parameters from this wiki. Has somebody a tip how to fix this?

--[[User:Jakubzeman|Jakubzeman]] 07:42, 8 August 2008 (UTC)

Yeah i know what you mean Jakubzeman, it was suggested to me on irc to copy the X server from the 2007.2 distro / other distro to the debian installation... that fixes the pointer but you have to then set it up to work for gdm.... / autologin. NO SID IS NOT REQUIRED I'm using lenny. Oh and if some one wants to see if they can get a debian based kernel / merge / get some more modules from debian / general modules into a kernel for other hardware (such as a rt73 chipset wireless card that would be great :) ) [[User:Dbmoodb|Dbmoodb]] 08:09, 8 August 2008 (UTC)

Thanks for suggestion. I'll try it (and I'll report if I'm successful or not).
--[[User:Jakubzeman|Jakubzeman]] 08:56, 8 August 2008 (UTC)

== Sound ==

http://tehinterweb.com/freerunner/alsa.state.tgz [by dbmoodb]

If the sound card is configured properly but there's no sound coming out of the Freerunner, it most likely helps to restore an appropriate statefile from the tgz above which are also available on the OM SVN (/trunk/src/target/audio/om-gta0*).

For simple sound output to the internal stereo speakers, do:
alsactl -f /path/to/statefiles/stereoout.state restore
--[[User:Tanuva|Tanuva]] 12:59, 21 August 2008 (UTC)

Building OpenMoko 2007.1 from scratch

2008-03-21T23:27:42Z

Tanuva: changed "abpout" to "about" in the warning box.

{|align=right
|__TOC__
|}

{{warning|This is still about 2007.1. You most likely want to read [[OpenMoko2007.2#How_to_build]] these days!}}

This is a guide describing how to set up a running OpenMoko
system from scratch.

If you just want to run OpenMoko applications on your PC, just perform the
"Obtaining OpenMoko SVN tree" step below and then go to
[[How to run OpenMoko Apps on PC]]. If you want to autoinstall all required tools and resources, consider using [[MokoMakefile]] -- script developed by Rod Whitby.

MokoMakefile is an automated front end for the commands which we execute manually here, so when using MokoMakefile, the end result will be the same, but you do not have do the download, extraction and setup [[OpenEmbedded]] by hand as described here, which can save quite some time because each step takes a while before you can check that it worked and run the next command.

Do not treat this as a linear script! There are various configuration items you
need to set (or skip, as it may be), operations that depend on how your
host(s) is/are set up, and also on the hardware revision of the target platform
(i.e., the phone).

Instead, look at each step, read the instructions, copy and paste what
makes sense for you, and adapt what you disagree with. Links to original and
background material in the Wiki are included wherever useful.

== Preparation ==

=== Roles ===

The build process may spread over multiple machines. They have the following
roles:

;'''BUILD''': build host, with quick access to the files and CPU power. Must have Internet access.
;'''LAB''': lab machine connected to the debug board (serial and JTAG) and to USB on the Neo (since this will probably be just a single machine, the roles are not further divided)
;'''CARD''': machine with a USB-attached SD/MMC card reader

All machines are assumed to share the same filesystem layout. At the beginning of
each of the sections below, the respective role is indicated. "('''all''')" is for
settings that apply to all machines, or that - for simplicity - can be
applied to all of them.

{{warning|To build OpenMoko, the build host needs to have at least 512 MB physical RAM and some swap space. Some gcc instances will well grow beyond 300MB of size (e.g. while compiling many files at once, e.g. for busybox). If even a part of the data which gcc allocates is in swap, about 99.9% of CPU time is wasted to wait for the memory be paged in and out RAM which means that the compilation time will be unreasonably long with only 256 MB of RAM. To reduce the RAM requirements for building busybox, you could disable CONFIG_BUILD_AT_ONCE. Busybox may be less optimized as a result, but it should not be a big issue}}

=== Directory layout ===
'''(Roles: all)'''

<pre>
$OMDIR (/home/moko) base directory for the whole tree
openmoko/ files from OpenMoko subversion (SVN) repository
openembedded/ files from OpenEmbedded (OE) Monotone repository
sources/ cached downloads of OE
build/ OE build directory
</pre>

=== Environment variables ===
'''(Roles: all)'''

For simplicity, we just set these environment variables on all hosts
involved. If you're not comfortable with this, feel free to weed out the ones
you don't need.

Our base directory (configure this for local arrangements):

export OMDIR=/home/moko

The search path for BitBake files. Note that the order is of vital
importance.

export BBPATH=$OMDIR/build:$OMDIR/openmoko/trunk/oe:$OMDIR/openembedded

=== Build host prerequisites ===
'''(Role: BUILD)'''

There must be at least 7 GB of free space on $OMDIR.

In addition to the traditional development tools (gcc, patch, etc.), the
following packages must be installed on the build host:

;subversion: version control system used by OpenMoko and others.
;quilt: patch management system used by the Linux kernel and others
;monotone: version control system used by OpenEmbedded. Use version 0.31/0.32 or newer. Monotone is not available pre-built for all Linux distributions. Get the statically linked binary from http://monotone.ca - building from source is difficult and even release tarballs (e.g. 0.36) may have C++ build issues with GNU C++ version 4.1 or newer ("no matching function call") which may be non-trivial to fix.
;diffstat: the OE build process wants this
;texi2html: this too
;git: version control system used by the Linux kernel and others. Do not confuse this with the "GNU Interactive Tools"

Furthermore, the following package can be installed optionally:
;psyco: Python just-in-time compiler. Speeds up OpenEmbedded builds (with BitBake) considerably. Strongly recommended.

==== Distro Specific Software Installation ====
;Gentoo: Gentoo users can obtain all this with (note that, at the time of writing, Monotone 0.32 isn't available without setting the ~x86 keyword):
<pre>
echo 'dev-util/monotone ~'`readlink /etc/make.profile | awk -F / '{print $6}'`\
>>/etc/portage/package.keywords
emerge -u subversion quilt monotone diffstat texi2html dev-util/git psyco
</pre>
;Other Distos: [http://www.openembedded.org/wiki/OEandYourDistro Instructions for installing prerequisites in other distributions]

=== Lab host prerequisites ===
'''(Role: LAB)'''

The following package must be installed on the lab host:
;xc: a simple communications program for the serial port

Gentoo users can obtain this with:
emerge -u xc

Note that similar communications programs, such as "cu" or "minicom", may be used as well.

=== Assumptions ===
'''(Roles: LAB, CARD)'''

We make the following assumptions about hardware setup and devices:

* the serial console of the Neo phone is connected to /dev/ttyS0 on '''LAB''' (see [[Debug_Board]])
* the JTAG [[wiggler]] is connected to /dev/parport0 on '''LAB'''. See [[Debug Board]] and [[Connecting_GTA01Bv2_with_Debug_Board]]
* cards inserted in the SD/MMC card reader appear as /dev/uba on '''CARD''' and can be mounted on /mnt/tmp (we'll specify the mount point explicitly, so the directory has to be there, but we don't need to specify the mount point in /etc/fstab). If in doubt,
mkdir -p /mnt/tmp

== Obtaining Sources and build system ==

=== OpenEmbedded build: initial downloads ===

First, we obtain a snapshot of the OpenEmbedded-based tree used by OpenMoko, plus the OE build tool called BitBake.

==== Obtaining OpenMoko SVN tree ====
'''(Role: BUILD)'''

Obtain the latest revision of the OpenMoko tree. Unfortunately, at some places, "current" versions of upstream packages may get included, thus the build may still fail. If it does, you may wish to inform the authorities.

The checkout should take about 45 minutes over an Internet connection with a round-trip time to svn.openmoko.org of 350 ms, given a data transfer rate of around 100kB/s.. It downloads about 370MB of data:

<pre>
cd $OMDIR
svn co http://svn.openmoko.org/ openmoko
</pre>

==== Installing BitBake ====
'''(Role: BUILD)'''
BitBake is the build tool of OE. (This is quick.)

{| style="background:yellow; color:green"
|-
| WARNING: If you run with root privileges, these instructions will cause bitbake to install itself under /usr in the area usually reserved for package managers. If run as user, it needs write permisson to /usr/local/{bin,lib} and it needs to create /usr/share{,doc)/bitbaker (the latter also are under /usr). There is no uninstall command either.
|-
|}
Note: If you use [[MokoMakefile]], the Makefile automatically selects the correct bitbake version and it does not install it, it is only used locally: It creates ./setup-env, which can be sourced to manually use the local bitbake. Note: BitBake 1.8.8 requires sqlite-3.3 or later.

If building 2007.1 (old version), get version 1.6:
svn co http://svn.berlios.de/svnroot/repos/bitbake/branches/bitbake-1.6 bitbake

If building 2007.2 (new, current version), version 1.8.8 is recommended:
svn co http://svn.berlios.de/svnroot/repos/bitbake/tags/bitbake-1.8.8 bitbake

and install it:
<pre>
cd bitbake
./setup.py install
cd ..
</pre>

==== Obtaining OpenEmbedded snapshot ====
'''(Role: BUILD)'''

Obtain a snapshot of the Monotone repository of OpenEmbedded, then update it
to the latest version, and finally check out our "known to be good" revision.
We extract things into $OMDIR/openembedded. OE.mtn.bz2 is about 140 MB.

<pre>
wget http://www.openembedded.org/snapshots/OE.mtn.bz2
bunzip2 OE.mtn.bz2
mtn --db=OE.mtn pull monotone.openembedded.org org.openembedded.dev
mtn --db=OE.mtn checkout --branch=org.openembedded.dev \
-r e2dbb52fe39df7ef786b6068f6178f29508dfded openembedded
</pre>

{{note|For advanced users: if you ever want to update to the latest version of the repository, you would do a "pull" (see above), followed by:
cd $OMDIR/openembedded && mtn update}}

{{note|For users of newer versions of monotone: you may need to migrate the database you downloaded with the wget command. You will know that this is necessary because the first mtn command shown above will fail with a warning indicating that you need to migrate the database. To do so, type:
<pre>mtn --db=OE.mtn db migrate</pre>}}

Set up the directories for the cache of upstream files and all material
related to local builds, then put our configuration file there (see also
[[OpenMoko#Setting_up_an_OpenMoko_SDK]]):

<pre>
mkdir -p sources build/conf
cat <<EOF >build/conf/local.conf
MACHINE = "fic-gta01"
DISTRO = "openmoko"
BUILD_ARCH = "`uname -m`"
EOF
</pre>

=== OpenEmbedded build: fixes ===
'''(Role: BUILD)'''

There are unfortunately some problems in the build process.
The following fixes work around them:

cd $OMDIR/sources
mkdir -p ../build/tmp/stamps/armv4t-linux

* upstream moves old packages away, gratuitously breaking downstreams

wget http://ftp.mozilla.org/pub/mozilla.org/js/older-packages/js-1.5.tar.gz
touch ../build/tmp/stamps/armv4t-linux/js-1.5-r0.do_fetch

* us2.samba.org mirror has vanished

wget http://us4.samba.org/samba/ftp/stable/samba-3.0.14a.tar.gz
touch ../build/tmp/stamps/armv4t-linux/samba-3.0.14a-r15.do_fetch

* ghastly patch with CRLF and trailing blanks

perl -pi.orig -e 's/ *$//;s/\r//g' \
../openembedded/packages/gcc/gcc-4.1.1/gcc-4.1.1-pr13685-1.patch

== Building ==

=== OpenEmbedded build ===
'''(Role: BUILD)'''

openmoko/trunk/oe/conf/site.conf expects the OpenMoko-specific OE packages in $OMDIR/oe

cd $OMDIR
ln -s openmoko/trunk/oe ./oe

We're now ready to run the build. This will take a while.

cd $OMDIR/build
bitbake openmoko-devel-image

Note that the build will stop several times to ask for SVN access and whether
to accept certificates. If you're not quick enough to respond, the underlying
session may time out. In this case, just restart "bitbake
openmoko-devel-image" and it will pick up from where it left off.

{{Note|As of 16 September 2007, subversion updates of uboot and the kernel are attempted on each rebuild attempt, even if both were already successfully built in the previous built attempt. Even if no changes are found during svn update, uboot and kernel are recompiled, which increases the time per respin.}}

The whole build process involves numerous downloads, takes about 7 hours
on an Athlon 64 3200+ (about 1.5h of delays were caused by ftp.debian.org not
working properly during this test run), and ends with a message like this:

Build statistics:
Attempted builds: 4

== Installation ==

=== Flash boot loader into NAND ===
'''(Role: LAB)'''

As a first step, we transfer the u-boot bootloader into NAND Flash, through
the JTAG interface. We use JTAG, since this is the most basic way for doing
this, ensuring that we only depend on as little to work on the Neo as
possible.

For this, the u-boot image for the right board version and the desired
build date must be chosen. E.g., an image built for a gta01bv2 board on
February 3, 2007 at 13:40:41 would be called
u-boot_nand-gta01bv2-20070203134041.bin

The name is composed as follows:
;u-boot: the name of the component
;nand: it is it be loaded from NAND (not directly from RAM, see also [[Bootloader#Using_JTAG_to_boot_from_RAM]])
;gta01bv2: the hardware revision of the board
;20070203134041: the build date and time
;.bin: this is a binary suitable for flashing/loading

If this is the first build, there will only be one image for each board
version, thus we can use wildcards. Change the gta01bv2 below to gta01v3 or
gta01v4, if necessary.

See also: [[Sjf2410-linux]]

<pre>
cd $OMDIR/build/tmp/deploy/images

( echo 0; echo 0; echo 0; echo 3; ) |
./sjf2410 -b -f `echo u-boot_nand-gta01bv2-*.bin`
</pre>

This will take approximately 12 minutes.

=== Copy kernel and root FS to microSD card ===
'''(Role: CARD)'''

There are several ways to provide the Neo with its kernel and the root file
system. (See [[Bootloader]] for some of them.)
The most self-contained way is to put everything into NAND Flash.
To transfer the files to the Neo, we first place them on the microSD card.

Memory cards, including microSD, usually come pre-formatted with VFAT. We
prefer ext2 (e.g., because we may want to store a real Linux file system on the
card as well). The following steps are needed to convert the card from VFAT to
ext2:
<pre>
sfdisk -c /dev/uba 1 83
mke2fs -m0 /dev/uba1
tune2fs -c0 -i0 /dev/uba1
</pre>

Next, we copy the kernel uImage and the root file system image to the card.
As discussed in the previous section, we can use wildcards if this is our
first build.
<pre>
cd $OMDIR/build/tmp/deploy/images
mount /dev/uba1 /mnt/tmp
cp uImage-2.6-moko7-r1-fic-gta01-*.bin /mnt/tmp/uImage
cp openmoko-devel-image-fic-gta01-*.rootfs.jffs2 /mnt/tmp/rootfs.jffs2
umount /mnt/tmp
</pre>

Now, insert the microSD card into the Neo, but don't power it on yet.
(If you did anyway, don't worry. We'll power cycle it later.)

=== Serial console ===
'''(Role: LAB)'''

We use a serial console connecting through the debug board. This example uses
"xc", which is a small and simple communications program. Many people prefer
"cu" or the considerably more bloated "minicom", which will work as well.

* Prepare xc configuration
<pre>
cat <<EOF >$HOME/xc.init
set bps 115200
terminal
EOF
</pre>

* Connect to the target
xc -l /dev/ttyS0 -t

=== Start the Neo and enter the boot prompt ===
'''(Role: LAB)'''

Our first interaction with the target. If this doesn't work, please check
that the debug board is connected properly to the serial port.

Disconnect power and USB from the phone, wait a couple of minutes, then connect power.
You may have to press and hold the power button on the Neo for a few seconds to turn it on.
The power button is located next to the USB port.

Some people have observed stability issues if the device was reset without
power cycling or if USB was not disconnected when power cycling, yet details of what is really happening aren't very clear yet.

On the serial console, a message like this should appear:
<pre>
U-Boot 1.2.0 (Feb 3 2007 - 13:07:21)
Press any key to enter the boot prompt:
GTA01Bv2 #
</pre>

Note that the boot prompt changes with the hardware revision you have. If the
message does not appear after a few seconds, try power cycling again.

If xc responds to pressing a button with
"Verify that you are trying to use a valid and operational tty port."
the port may be stuck, waiting for DCD to be asserted. The quickest way to
get out of this situation is to disconnect the serial cable from the debug
board, run the following command
while ! stty -F /dev/ttyS0 clocal; do : ; done

stick something metallic, e.g., a paper clip or a screwdriver, into the plug on the cable,
and keep on fumbling with
it until DCD gets set and the loop above stops spitting out error messages.

=== Flash kernel and root FS into NAND ===
'''(Role: LAB)'''

We now load the kernel and the root FS from the microSD card into memory and
subsequently transfer them to NAND Flash. All this is done by entering
commands at the boot prompt.

Each time we want to write new data to the NAND Flash, we first have to erase
the previous content. We do this individually for each [[partition]]. While it would
also be possible to erase some or all relevant partitions in one step, this would
require the user to look up addresses from the partition table and to perform
calculations which are inconvenient at best.

See also: [[U-boot]]

* Initialize the SD/MMC interface. The "Product Name" shown will be just binary garbage. This is expected behaviour.

GTA01Bv2 # mmc

* Load the uImage file into memory. "ext2load" stores the number of bytes read as a hexadecimal number in the environment variable "filesize".

GTA01Bv2 # ext2load mmc 0 0x32000000 uImage

* Erase the kernel partition and write the uImage from memory to NAND Flash

GTA01Bv2 # nand erase kernel
GTA01Bv2 # nand write.e 0x32000000 kernel ${filesize}

* The root file system is next. We need to specify the correct size, which is shown at the end of "ext2load", e.g., "0x1608000)" in this case:

GTA01Bv2 # ext2load mmc 0 0x32000000 rootfs.jffs2
23101440 (0x1608000) bytes read
GTA01Bv2 # nand erase rootfs
GTA01Bv2 # nand write.e 0x32000000 rootfs ${filesize}

=== Configure the boot loader ===
'''(Role: LAB)'''

Last but not least, we have to set up the boot loader to automatically boot
from Flash. For this, we use the default environment settings, which we obtain
by erasing the old content of the environment, and letting u-boot restore the
settings after a restart.

Before touching the environment, you may have to update the environment offset.
Please see [[Migration_to_bad_block_tolerant_builds#Partition_sizing]] for details.
(We may simplify this particularly awkward and error-prone procedure in the
future.)

* First, remove erase the old environment:
GTA01Bv2 # nand erase env

* We reset to force the boot loader to use the default settings.
GTA01Bv2 # reset

Wait until the "U-Boot [...]" message, then hit a key. It will display
*** Warning - bad CRC or NAND, using default environment

* Re-generate the [[partition]] information in the environment variable "mtdparts":

GTA01Bv2 # dynpart

* Save the restored settings in NAND
GTA01Bv2 # saveenv

* Power cycle to boot the Neo (see remarks above)

== END ==

'''Congratulations !''' You've just completed level 1 of the OpenMoko adventure.

{{Languages|Building_OpenMoko_from_scratch}}
[[Category:Technical ]]
[[Category:Software]]
[[Category:Documentation]]
[[Category:Openmoko]]