Openmoko - User contributions [en]

Disassembling Neo 1973

2012-05-09T06:41:35Z

Myfanwy: /* Removing PCB from case frame */

{{Neo1973}}

{{note| The [[Disassembling Neo1973 | Disassembling the Neo1973 page]] shows how to open up the Neo 1973. Since the Neo FreeRunner shares the same case, this procedure applies to both. }}

== Back side of Neo1973 ==
The picture below is from the GTA01Bv3 model. The GTA01Bv4 has the Openmoko logo + OPENMOKO text below instead.

[[Image:Gta01b v3 case back white.jpg|700px]]

== Opening back cover ==

To remove the back cover, put your fingernail in the small recess on the top of the Neo, and pull gently.

{{note| the back is not hinged, as it may appear in this picture; lift both sides away equally to avoid breaking the small tabs.}}

[[Image:Gta01b v3 case back open white.jpg|700px]]

Please note the 27 x 9 x 6 mm space above the sim & memory cards after inserting the battery. This could maybe be of some use for 3rd party electronics.

[[Image:Gta01b v4 space next to battery.jpg|700px]]

{{note| In order to remove the front cover, you now need to remove the two Torx screws (T6x40)}}

== Carefully remove top cover ==
[[Image:Gta01b v3 case side opening white.jpg|700px]]

To remove the top cover, after removing the two Torx screws, ''carefully'' squeeze the end of the supplied guitar pick between the cover and the case at the bottom of the device, and then slide the pick up to the top on one side (do not twist the pick). As you slide the pick along, the case retaining clips should come apart with a snapping sound. Repeat the procedure for the other side of the device. To unclip the last remaining large retaining clip at the top, slide the pick all the way to the top (this can be difficult) and then press it in at the centre. By ''careful'' application of force the clip will detach and the cover can then be removed.

== Top case lid removed ==
[[Image:Gta01b v3 case top open white.jpg|700px]]

Visible in this image, from the right, going clockwise.

*The blocky device at the far right is the GPS antenna.
**To the left of this, there are two gold pads, which are where the earpiece speaker connects.
*The [[Debug Board]] connector.
*At the left, the black semicircular device is the GSM antenna.
**Immediately to its right, the small circular black/gold object is the microphone
*At the top right, the ''Aux button''
*Right below it seems to be a small battery. It can also be seen on the picture below.

In the middle is the touchscreen LCD, the touchscreen printed wire can be seen beginning at the bottom left of this, through the glass.

== Lifting the PCB on the left side ==
{{note|You have to bend the plastic case a bit outwards until the headphone jack on the left side of the device becomes loose}}
[[Image:Gta01b v3 case top open pcb lift white.jpg|700px]]

Its not shown in this picture, but I've found that it helps to slide the AUX button out of the case before trying to remove the PCB. This allows you to get a firm hold on the PCB while gently bending the case to free the headphone jack and plastic retaining clips.

The "official" method:<br>
I suggest to use your right hand thumb fingernail to bend the case outward exactly above hs-jack (index finger next to GSM-ant, middle finger in small recess next to GPS-ant) while holding the "USB-Side" of case in the inside of your four finger base knuckles of left hand and gently pushing battery compartment base with left middle finger. Board pops out easily, takes 1sec.

Please do not use screwdriver for a lever (or similar things), this might easily break components on mainboard

== Removing PCB from case frame ==
{{note|Since the PCB now is loose on one side, you can carefully pull the USB socket and GPS antenna connector out of the right side of the case, and then flip the PCB upwards}}
[[Image:Gta01b v3 case top open pcb lifted.jpg|700px]]

This shows:
*At the top on a green board, the bluetooth module, and the square bluetooth antenna.
*The headset jack is to the right of this.
**Immediately below the headset jack is the [[Neo1973 Battery]] connector.
**Below the [[Neo1973 Battery]] connector, the two gold pads feed the vibrator motor.
*To the right of the headset jack is the left speaker connector.

On the other side of the PCB, going from bottom-right corner down-left.

*The small circular connector is the GSM connector to which an external aerial can be connected with the back removed, or with an alternative back.

*To the left of this is the right speaker connector.
*One of the button switches.
*USB port.
*Micro-SD slot
*SIM slot - overlaying the Micro-SD slot when present.
*Golden GPS antenna connector.
**Immediately above this with the grey wire connection is the connection to the built in GPS antenna.

On the case picture below, you can see the left and right speakers under the translucent plastic, and the vibrator motor in the middle. Don't forget, there is only one speaker on the Neo Freerunner, not two.

== Empty case frame ==

[[Image:Gta01b v3 case empty white.jpg|700px]]

You can actually see the two stereo speakers beneath the translucent cover, and next to it the small vibrator motor.

Next to the top of the picture is a hole near the speaker.
The external GSM antenna connector is accessed through this hole.

== GSM Antenna ==

[[Image:Gta01b v3 gsm antenna.jpg|700px]]

== Display ==
It may be easiest to unplug the ribbon cable which connects the LCD module to the PCB, before attempting to remove the screen. To do so, unpeel the silver-grey fabric strip which passes over the ribbon conenctor and around the board edge, and then flip up the black clip which holds the ribbon in place. The clip is at the PCB end of the ribbon, and is approximately 2mm x 12mm. The ribbon can then easily be pulled out of the white socket on the PCB. When reinserting after replacing the screen, be sure the ribbon is central, square to the socket, and pushed all the way in, or the screen may not turn on.

The screen is fixed to the PCB by a strip of adhesive which extends the length of the module, down its centre. You will need to pry it off starting on the side opposite its connector cable. If care is taken removing it you can use it again (I used a blow dryer to heat the screen to make prying the screen from the board a little less likely to damage the unit).

There are also four silver-grey pads, one at each corner, which support the screen, and a ribbon to the bluetooth module which passes around the PCB midway along one side. Be careful not to damage the ribbon or the pads when removing the LCD module.

<span id="bottom"></span>
{{Languages|Disassembling_Neo1973}}

[[Category:Neo1973 Hardware]]
[[Category:Neo_FreeRunner_Hardware]]

Disassembling Neo 1973

2012-05-09T06:39:51Z

Myfanwy: /* Display */

{{Neo1973}}

{{note| The [[Disassembling Neo1973 | Disassembling the Neo1973 page]] shows how to open up the Neo 1973. Since the Neo FreeRunner shares the same case, this procedure applies to both. }}

== Back side of Neo1973 ==
The picture below is from the GTA01Bv3 model. The GTA01Bv4 has the Openmoko logo + OPENMOKO text below instead.

[[Image:Gta01b v3 case back white.jpg|700px]]

== Opening back cover ==

To remove the back cover, put your fingernail in the small recess on the top of the Neo, and pull gently.

{{note| the back is not hinged, as it may appear in this picture; lift both sides away equally to avoid breaking the small tabs.}}

[[Image:Gta01b v3 case back open white.jpg|700px]]

Please note the 27 x 9 x 6 mm space above the sim & memory cards after inserting the battery. This could maybe be of some use for 3rd party electronics.

[[Image:Gta01b v4 space next to battery.jpg|700px]]

{{note| In order to remove the front cover, you now need to remove the two Torx screws (T6x40)}}

== Carefully remove top cover ==
[[Image:Gta01b v3 case side opening white.jpg|700px]]

To remove the top cover, after removing the two Torx screws, ''carefully'' squeeze the end of the supplied guitar pick between the cover and the case at the bottom of the device, and then slide the pick up to the top on one side (do not twist the pick). As you slide the pick along, the case retaining clips should come apart with a snapping sound. Repeat the procedure for the other side of the device. To unclip the last remaining large retaining clip at the top, slide the pick all the way to the top (this can be difficult) and then press it in at the centre. By ''careful'' application of force the clip will detach and the cover can then be removed.

== Top case lid removed ==
[[Image:Gta01b v3 case top open white.jpg|700px]]

Visible in this image, from the right, going clockwise.

*The blocky device at the far right is the GPS antenna.
**To the left of this, there are two gold pads, which are where the earpiece speaker connects.
*The [[Debug Board]] connector.
*At the left, the black semicircular device is the GSM antenna.
**Immediately to its right, the small circular black/gold object is the microphone
*At the top right, the ''Aux button''
*Right below it seems to be a small battery. It can also be seen on the picture below.

In the middle is the touchscreen LCD, the touchscreen printed wire can be seen beginning at the bottom left of this, through the glass.

== Lifting the PCB on the left side ==
{{note|You have to bend the plastic case a bit outwards until the headphone jack on the left side of the device becomes loose}}
[[Image:Gta01b v3 case top open pcb lift white.jpg|700px]]

Its not shown in this picture, but I've found that it helps to slide the AUX button out of the case before trying to remove the PCB. This allows you to get a firm hold on the PCB while gently bending the case to free the headphone jack and plastic retaining clips.

The "official" method:<br>
I suggest to use your right hand thumb fingernail to bend the case outward exactly above hs-jack (index finger next to GSM-ant, middle finger in small recess next to GPS-ant) while holding the "USB-Side" of case in the inside of your four finger base knuckles of left hand and gently pushing battery compartment base with left middle finger. Board pops out easily, takes 1sec.

Please do not use screwdriver for a lever (or similar things), this might easily break components on mainboard

== Removing PCB from case frame ==
{{note|Since the PCB now is loose on one side, you can carefully pull the USB socket and GPS antenna connector out of the right side of the case, and then flip the PCB upwards}}
[[Image:Gta01b v3 case top open pcb lifted.jpg|700px]]

This shows:
*At the top on a green board, the bluetooth module, and the square bluetooth antenna.
*The headset jack is to the right of this.
**Immediately below the headset jack is the [[Neo1973 Battery]] connector.
**Below the [[Neo1973 Battery]] connector, the two gold pads feed the vibrator motor.
*To the right of the headset jack is the left speaker connector.

On the other side of the PCB, going from bottom-right corner down-left.

*The small circular connector is the GSM connector to which an external aerial can be connected with the back removed, or with an alternative back.

*To the left of this is the right speaker connector.
*One of the button switches.
*USB port.
*Micro-SD slot
*SIM slot - overlaying the Micro-SD slot when present.
*Gold GPS antenna connector.
**Immediately above this with the grey wire connection is the connection to the built in GPS antenna.

On the case picture below, you can see the left and right speakers under the translucent plastic, and the vibrator motor in the middle.

== Empty case frame ==

[[Image:Gta01b v3 case empty white.jpg|700px]]

You can actually see the two stereo speakers beneath the translucent cover, and next to it the small vibrator motor.

Next to the top of the picture is a hole near the speaker.
The external GSM antenna connector is accessed through this hole.

== GSM Antenna ==

[[Image:Gta01b v3 gsm antenna.jpg|700px]]

== Display ==
It may be easiest to unplug the ribbon cable which connects the LCD module to the PCB, before attempting to remove the screen. To do so, unpeel the silver-grey fabric strip which passes over the ribbon conenctor and around the board edge, and then flip up the black clip which holds the ribbon in place. The clip is at the PCB end of the ribbon, and is approximately 2mm x 12mm. The ribbon can then easily be pulled out of the white socket on the PCB. When reinserting after replacing the screen, be sure the ribbon is central, square to the socket, and pushed all the way in, or the screen may not turn on.

The screen is fixed to the PCB by a strip of adhesive which extends the length of the module, down its centre. You will need to pry it off starting on the side opposite its connector cable. If care is taken removing it you can use it again (I used a blow dryer to heat the screen to make prying the screen from the board a little less likely to damage the unit).

There are also four silver-grey pads, one at each corner, which support the screen, and a ribbon to the bluetooth module which passes around the PCB midway along one side. Be careful not to damage the ribbon or the pads when removing the LCD module.

<span id="bottom"></span>
{{Languages|Disassembling_Neo1973}}

[[Category:Neo1973 Hardware]]
[[Category:Neo_FreeRunner_Hardware]]

Specialized USB cables

2010-03-13T07:20:01Z

Myfanwy: /* USB hubs that can be used like a Y-cable without modifications */

{{note|work in progress}}

== Attaching the Neo (acting as a USB host) to a USB device ==

The USB port (5 position mini type B jack) on the Neo 1973 and Neo FreeRunner can be both a USB device or a USB host. The provided cable (5 position mini type B plug to type A plug) is used when attaching the Neo to a USB host.

A specialized cable is required when attaching the Neo to a USB device. (The device has a USB type A jack).

(picture)

Alternately, an adapter capable of connecting two type A plugs will allow attaching the provided USB cable to the USB cable that came with the USB device. This adapter is also known as a gender changer.

(picture)

=== Ready-made mini type A plug to a type A jack adapter ===

You can now purchase a proper [http://www.electronicproductonline.com/catalog/product_info.php?products_id=2043 custom-manufacturered mini-A to full-sized A USB adapter from here]. This adapter already has Pins 4 and 5 shorted together internally; the unique form factor also makes it very handy and eliminated the need for things like the double USB female adapter trick shown at the bottom of this page.

[[Image:USBOTGSwivel.jpg]]

=== Ready-made mini type B plug to a type A jack cable ===

You can buy [[http://www.jaykang.com/usbafetousbm1.html this]] ready-made USB A-Type Female to USB Mini-B Type 5 Pin Male Adapter.
[[Image:jaykang_usbafetousbm1.jpg|thumb|none]]

It is available in Europe from Openmoko distributor Goldelico: http://www.handheld-linux.com/wiki.php?page=Neo%20Freerunner%3AUSB%20Adapter

A Mini-B to Female-A cable is also available from [http://www.usbfirewire.com/Parts/rr-2mb-020.html www.usbfirewire.com].

Adapter $1.45 including worldwide shipping, http://www.dealextreme.com/details.dx/sku.26783 --[[User:Schorhr|Schorhr]] 05:24, 16 September 2009 (UTC)

=== How to make a mini type B plug to a type A jack cable ===

(picture, as soon as I build it)

Parts list:

* Mini type B plug: Digi-Key [[http://search.digikey.com/scripts/DkSearch/dksus.dll?Detail?name=H2958-ND H2958-ND]]
* type A jack: I have not yet been able to find a source for these. Meanwhile, use the jack from a standard USB extension cord
* Cable: Ideally, the data lines should be twisted and 28 AWG, the power lines should be 20 or 28 AWG, e.g. Hitachi Cable [[http://www.hcm.hitachi.com/electronic_round_cable/bulk-usb-cable.shtml 49248 ]]

Construction instructions:

(TBA)

=== Ready-made type A jack to a type A jack adapter (gender changer) ===

You can buy [[http://www.jaykang.com/usbtyfetotyf.html this]] ready-made USB Type A Female to Female Gender Changer.
[[Image:jaykang_usbtyfetotyf.jpg|thumb|none]]

=== How to make a type A jack to a type A jack adapter (gender changer) ===

This community provided instruction shows how to build an adapter from a USB socket salvaged from a computer motherboard.

Note that these instructions are provided in the hope that they are useful but without any warranty!

[[Image:2-usb-receptables.jpg|thumb|none]]

:#Find an old motherboard with a set of two USB receptacles as shown above.
:#Desolder this set of receptacles from the motherboard. This can be bit tricky but it is doable at least with a desoldering gun. Solder braid (available at electronic parts stores including Radio Shack) works better than even a professional desoldering gun and is a lot cheaper.
:#Each receptacle has four pins. Use a multimeter to verify that you have no short circuits between the pins or the shield.
:#Solder adjacent pins together (GND to GND, D- to D-, D+ to D+, VCC to VCC).
:#(Optional) Build a test cable. Cut an USB cable with A plug into half, connect it a receptacle and again measure that you have no short circuits. Then connect the test cable to PC and verify that you see
*black GND
*green 0V
*white 0V
*red +5V
:#FreeRunner is shipped with a mini-B-to-A-plug cable. Connect this to a receptacle.
:#(Optional)Connect test cable to the other receptacle and verify that you see
*black GND
*green 0V
*white 0V
*red 0V
when freerunner acts as a device and
*black GND
*green 0V
*white 0V
*red +5V
when it acts as a host.
:#At your own risk, switch freerunner to USB host mode and connect an USB device to the other receptacle of the adapter. Here's how the setup should look like:

<gallery>
Image:Usb-gender-changer1.jpg
Image:Usb-gender-changer2.jpg
</gallery>

=== How to make a type A jack to a type A jack adapter (gender changer) without soldering ===

:#Find a 2-port USB front-panel with a 9-pin connector. Usually you can get one from a PC motherboard package box.
:#Align it in a way so you see the connector pins as a 2 row 5 column matrix with one pin missing.
:#Use 4 staples to short the pins residing in a same column.
:#FreeRunner is shipped with a mini-B-to-A-plug cable. Use it to connect the first port of your panel with your FreeRunner.
:#At your own risk, switch freerunner to USB host mode and connect an USB device to the other receptacle of the adapter.

If you have a ASUS USB/MIR front panel, it is even easier - you can use jumpers to short the pins.

[[Image:asususb.jpg]]

=== Compatibility ===

The adapter works with kingston data traveller 4G memory stick and aiptec pencam webcam. However, for some reason (probably the missing 15k resistors at D+ and D-) it did not work with any of the tested USB keyboards or mice:
<pre>
usb 1-2: new full speed USB device using s3c2410-ohci and address 24
usb 1-2: device descriptor read/64, error -62
usb 1-2: device descriptor read/64, error -62
usb 1-2: new full speed USB device using s3c2410-ohci and address 25
usb 1-2: device descriptor read/64, error -62
usb 1-2: device descriptor read/64, error -62
usb 1-2: new full speed USB device using s3c2410-ohci and address 26
usb 1-2: device not accepting address 26, error -62
usb 1-2: new full speed USB device using s3c2410-ohci and address 27
usb 1-2: device not accepting address 27, error -62
</pre>
However, if I connect neo to small (unpowered) USB hub
<pre>
usb 1-2: new full speed USB device using s3c2410-ohci and address 61
usb 1-2: configuration #1 chosen from 1 choice
hub 1-2:1.0: USB hub found
hub 1-2:1.0: 4 ports detected
</pre>
and connect the keyboard to the hub then it is correctly recognized:
<pre>
usb 1-2.3: new low speed USB device using s3c2410-ohci and address 62
usb 1-2.3: configuration #1 chosen from 1 choice
input: USB Keyboard as /devices/platform/s3c2410-ohci/usb1/1-2/1-2.3/1-2.3:1.0/input/input13
input: USB HID v1.10 Keyboard [ USB Keyboard] on usb-s3c24xx-2.3
input: USB Keyboard as /devices/platform/s3c2410-ohci/usb1/1-2/1-2.3/1-2.3:1.1/input/input14
input: USB HID v1.10 Device [ USB Keyboard] on usb-s3c24xx-2.3
</pre>
With the hub I can also use both keyboard and usb memory stick at the same time.

==== Power consumption ====

When I unplug the USB hub (with only keyboard connected to it) the power consumption estimate at /sys/devices/platform/bq2700-battery.0/power_supply/bat/current_now decreases from 175000 to 145000 (are these microamperes?).

== Buy a USB Y cable for powering USB devices and charging the Freerunner while in host mode ==

You do not need to make a cable, you can just buy a "USB 2.0 Dual Power Cable, 2 x Type A to mini B" from [http://www.lindy.co.uk/1m-usb-2-dual-power-cable-2-x-type-a-50cm-apart-to-mini-b/31782.html lindy]. You then plug (via an adapter) the central plug of the Y cable into the upstream port (B socket or A plug) of your powered USB hub, the other A plug of the Y cable into one of the A sockets of your hub, and the mini-B plug of the Y cable into your Freerunner. Put your Freerunner into USB unpowered host mode. It will charge and you can plug a keyboard, a mouse, a disk, cable modem, etc, into the hub.

Adapters, [http://www.rueducommerce.fr/Accessoires-Consommables/Cables-USB/Adaptateurs-convertisseurs/-/MO-35F4EM2168156-Adaptateur-Usb-type-A-Femelle-type-B-Male.htm A female to B male] or [http://www.rueducommerce.fr/Accessoires-Consommables/Cables-USB/Adaptateurs-convertisseurs/-/MO-B7A48M2167837-Changeur-Usb-type-A-Femelle-Femelle.htm A female to A female], are easy to find on the net. You will need a "A female to B male" if your hub has a type B socket or a "A female to A female" if your hub has a type A plug.

== How to make a USB cable for powering attached USB devices and charging the Neo while in host mode (aka Y-Cable) ==

{{note|work in progress}}

This method was invented by [[User:JOERG|Joerg Reisenweber]], and was
since implemented practically by many community members. See
http://lists.openmoko.org/pipermail/community/2008-March/013978.html .

---
You can find some pictures (schematics, parts and part numbers
at http://om.quatrox.org/om/ but be careful!!!
Report any bugs to quatrox
(irc #openmoko, #openmoko-cdevel, #ocp at freenode.org)
---

This cable might be necessary for a number of reasons, e.g.

* The application requires that the Neo not become suspended
* The application requires long run time
* The attached USB device consumes a lot of power

(However, as there is a wide range[http://permalink.gmane.org/gmane.comp.handhelds.openmoko.hardware/415]
of USB hubs out there, one might find power (on a powered USB hub)
is available already on the hub's mini USB 5 pin socket already, so not need a specialized cable after all!
Check with a test meter.)

These instructions will show you how to make a cable with 3 ends:

* A mini-USB type B cable for the Neo itself
* A cable of whatever type to go to your USB device.
* A cable going to a +5V +/-10%(max!) power supply with enough power for your device and to charge the Neo. This could be a wall charger or even another USB plug.

You connect the Data+ and Data- wires of the Neo and the device, and connect all of the ground wires together and all of the +5V wires together. This powers the Neo and the device, while letting the neo talk to the device.
You have to connect 2 pcs 15k ohm resistors, one from D+ to ground, and one from D- to ground, to comply with USB-spec for hostmode, as Neo is switching off the internal resistors when you enable charging/powering over USB by asserting EN_USBHOST.
See schematics, LOCATION:49XX

Just for reference, the USB wires from left to right are:
*Black: Power -
*Green: Data -
*White: Data +
*Red: Power +

The Mini_USB-B connector has a fifth pin, the ID-pin.
This pin is supposed to be short to ground to signal FreeRunner to enter hostmode. For the Y-cable and enabling external power while in hostmode, you may connect a 47k ohm resistor from ID-pin to ground. This is the same trick the OM-wallcharger uses to signal to FreeRunner it can charge with 1A. Future kernels should switch to hostmode + external power when seeing this 47k resistor.

===Parts===
USB 2.0 Plug type A to mini 5 pin USB Plug type B that should include the ID signal, so that you can add the 47k ohm resistor to ID-pin to trigger fast charging

# [http://www.firefold.com/Products/6-Foot-USB-20-Plug-type-A-to-mini-USB-Plug-type-B-5-pin-Cable---Black__USB-5PMINI-6.aspx firefold]
# Belkin 5 pin (find reference)
#https://www.argentdata.com/catalog/product_info.php?products_id=111
#http://www.partsdata.de/USB_Mini-B-Verlaengerung_Kabel_1m_CU-XB05-10.html

== USB hubs that can be used like a Y-cable without modifications ==

[http://www.dealextreme.com/details.dx/sku.13526 Cable Style Dual-Power 1000mA USB 2.0 4-Port Hub]. Connect power source to the red upstream connector and openmoko to the black upstream connector. Then connect USB devices to the downstream ports. After settings usb_mode=host the openmoko will charge and will still be able to talk to the downstream ports.<br>
also available on ebay: [http://cgi.ebay.com/High-Speed-Smart-3-Ports-USB-Hub-5-Pin-Cable-for-PC_W0QQitemZ260567368077QQcmdZViewItemQQptZLH_DefaultDomain_0?hash=item3cab06818d]

[[Category:USB]]
[[Category:Neo FreeRunner Hardware]]
[[Category:Power]]

Specialized USB cables

2010-03-13T07:19:38Z

Myfanwy: /* USB hubs that can be used like a Y-cable without modifications */

{{note|work in progress}}

== Attaching the Neo (acting as a USB host) to a USB device ==

The USB port (5 position mini type B jack) on the Neo 1973 and Neo FreeRunner can be both a USB device or a USB host. The provided cable (5 position mini type B plug to type A plug) is used when attaching the Neo to a USB host.

A specialized cable is required when attaching the Neo to a USB device. (The device has a USB type A jack).

(picture)

Alternately, an adapter capable of connecting two type A plugs will allow attaching the provided USB cable to the USB cable that came with the USB device. This adapter is also known as a gender changer.

(picture)

=== Ready-made mini type A plug to a type A jack adapter ===

You can now purchase a proper [http://www.electronicproductonline.com/catalog/product_info.php?products_id=2043 custom-manufacturered mini-A to full-sized A USB adapter from here]. This adapter already has Pins 4 and 5 shorted together internally; the unique form factor also makes it very handy and eliminated the need for things like the double USB female adapter trick shown at the bottom of this page.

[[Image:USBOTGSwivel.jpg]]

=== Ready-made mini type B plug to a type A jack cable ===

You can buy [[http://www.jaykang.com/usbafetousbm1.html this]] ready-made USB A-Type Female to USB Mini-B Type 5 Pin Male Adapter.
[[Image:jaykang_usbafetousbm1.jpg|thumb|none]]

It is available in Europe from Openmoko distributor Goldelico: http://www.handheld-linux.com/wiki.php?page=Neo%20Freerunner%3AUSB%20Adapter

A Mini-B to Female-A cable is also available from [http://www.usbfirewire.com/Parts/rr-2mb-020.html www.usbfirewire.com].

Adapter $1.45 including worldwide shipping, http://www.dealextreme.com/details.dx/sku.26783 --[[User:Schorhr|Schorhr]] 05:24, 16 September 2009 (UTC)

=== How to make a mini type B plug to a type A jack cable ===

(picture, as soon as I build it)

Parts list:

* Mini type B plug: Digi-Key [[http://search.digikey.com/scripts/DkSearch/dksus.dll?Detail?name=H2958-ND H2958-ND]]
* type A jack: I have not yet been able to find a source for these. Meanwhile, use the jack from a standard USB extension cord
* Cable: Ideally, the data lines should be twisted and 28 AWG, the power lines should be 20 or 28 AWG, e.g. Hitachi Cable [[http://www.hcm.hitachi.com/electronic_round_cable/bulk-usb-cable.shtml 49248 ]]

Construction instructions:

(TBA)

=== Ready-made type A jack to a type A jack adapter (gender changer) ===

You can buy [[http://www.jaykang.com/usbtyfetotyf.html this]] ready-made USB Type A Female to Female Gender Changer.
[[Image:jaykang_usbtyfetotyf.jpg|thumb|none]]

=== How to make a type A jack to a type A jack adapter (gender changer) ===

This community provided instruction shows how to build an adapter from a USB socket salvaged from a computer motherboard.

Note that these instructions are provided in the hope that they are useful but without any warranty!

[[Image:2-usb-receptables.jpg|thumb|none]]

:#Find an old motherboard with a set of two USB receptacles as shown above.
:#Desolder this set of receptacles from the motherboard. This can be bit tricky but it is doable at least with a desoldering gun. Solder braid (available at electronic parts stores including Radio Shack) works better than even a professional desoldering gun and is a lot cheaper.
:#Each receptacle has four pins. Use a multimeter to verify that you have no short circuits between the pins or the shield.
:#Solder adjacent pins together (GND to GND, D- to D-, D+ to D+, VCC to VCC).
:#(Optional) Build a test cable. Cut an USB cable with A plug into half, connect it a receptacle and again measure that you have no short circuits. Then connect the test cable to PC and verify that you see
*black GND
*green 0V
*white 0V
*red +5V
:#FreeRunner is shipped with a mini-B-to-A-plug cable. Connect this to a receptacle.
:#(Optional)Connect test cable to the other receptacle and verify that you see
*black GND
*green 0V
*white 0V
*red 0V
when freerunner acts as a device and
*black GND
*green 0V
*white 0V
*red +5V
when it acts as a host.
:#At your own risk, switch freerunner to USB host mode and connect an USB device to the other receptacle of the adapter. Here's how the setup should look like:

<gallery>
Image:Usb-gender-changer1.jpg
Image:Usb-gender-changer2.jpg
</gallery>

=== How to make a type A jack to a type A jack adapter (gender changer) without soldering ===

:#Find a 2-port USB front-panel with a 9-pin connector. Usually you can get one from a PC motherboard package box.
:#Align it in a way so you see the connector pins as a 2 row 5 column matrix with one pin missing.
:#Use 4 staples to short the pins residing in a same column.
:#FreeRunner is shipped with a mini-B-to-A-plug cable. Use it to connect the first port of your panel with your FreeRunner.
:#At your own risk, switch freerunner to USB host mode and connect an USB device to the other receptacle of the adapter.

If you have a ASUS USB/MIR front panel, it is even easier - you can use jumpers to short the pins.

[[Image:asususb.jpg]]

=== Compatibility ===

The adapter works with kingston data traveller 4G memory stick and aiptec pencam webcam. However, for some reason (probably the missing 15k resistors at D+ and D-) it did not work with any of the tested USB keyboards or mice:
<pre>
usb 1-2: new full speed USB device using s3c2410-ohci and address 24
usb 1-2: device descriptor read/64, error -62
usb 1-2: device descriptor read/64, error -62
usb 1-2: new full speed USB device using s3c2410-ohci and address 25
usb 1-2: device descriptor read/64, error -62
usb 1-2: device descriptor read/64, error -62
usb 1-2: new full speed USB device using s3c2410-ohci and address 26
usb 1-2: device not accepting address 26, error -62
usb 1-2: new full speed USB device using s3c2410-ohci and address 27
usb 1-2: device not accepting address 27, error -62
</pre>
However, if I connect neo to small (unpowered) USB hub
<pre>
usb 1-2: new full speed USB device using s3c2410-ohci and address 61
usb 1-2: configuration #1 chosen from 1 choice
hub 1-2:1.0: USB hub found
hub 1-2:1.0: 4 ports detected
</pre>
and connect the keyboard to the hub then it is correctly recognized:
<pre>
usb 1-2.3: new low speed USB device using s3c2410-ohci and address 62
usb 1-2.3: configuration #1 chosen from 1 choice
input: USB Keyboard as /devices/platform/s3c2410-ohci/usb1/1-2/1-2.3/1-2.3:1.0/input/input13
input: USB HID v1.10 Keyboard [ USB Keyboard] on usb-s3c24xx-2.3
input: USB Keyboard as /devices/platform/s3c2410-ohci/usb1/1-2/1-2.3/1-2.3:1.1/input/input14
input: USB HID v1.10 Device [ USB Keyboard] on usb-s3c24xx-2.3
</pre>
With the hub I can also use both keyboard and usb memory stick at the same time.

==== Power consumption ====

When I unplug the USB hub (with only keyboard connected to it) the power consumption estimate at /sys/devices/platform/bq2700-battery.0/power_supply/bat/current_now decreases from 175000 to 145000 (are these microamperes?).

== Buy a USB Y cable for powering USB devices and charging the Freerunner while in host mode ==

You do not need to make a cable, you can just buy a "USB 2.0 Dual Power Cable, 2 x Type A to mini B" from [http://www.lindy.co.uk/1m-usb-2-dual-power-cable-2-x-type-a-50cm-apart-to-mini-b/31782.html lindy]. You then plug (via an adapter) the central plug of the Y cable into the upstream port (B socket or A plug) of your powered USB hub, the other A plug of the Y cable into one of the A sockets of your hub, and the mini-B plug of the Y cable into your Freerunner. Put your Freerunner into USB unpowered host mode. It will charge and you can plug a keyboard, a mouse, a disk, cable modem, etc, into the hub.

Adapters, [http://www.rueducommerce.fr/Accessoires-Consommables/Cables-USB/Adaptateurs-convertisseurs/-/MO-35F4EM2168156-Adaptateur-Usb-type-A-Femelle-type-B-Male.htm A female to B male] or [http://www.rueducommerce.fr/Accessoires-Consommables/Cables-USB/Adaptateurs-convertisseurs/-/MO-B7A48M2167837-Changeur-Usb-type-A-Femelle-Femelle.htm A female to A female], are easy to find on the net. You will need a "A female to B male" if your hub has a type B socket or a "A female to A female" if your hub has a type A plug.

== How to make a USB cable for powering attached USB devices and charging the Neo while in host mode (aka Y-Cable) ==

{{note|work in progress}}

This method was invented by [[User:JOERG|Joerg Reisenweber]], and was
since implemented practically by many community members. See
http://lists.openmoko.org/pipermail/community/2008-March/013978.html .

---
You can find some pictures (schematics, parts and part numbers
at http://om.quatrox.org/om/ but be careful!!!
Report any bugs to quatrox
(irc #openmoko, #openmoko-cdevel, #ocp at freenode.org)
---

This cable might be necessary for a number of reasons, e.g.

* The application requires that the Neo not become suspended
* The application requires long run time
* The attached USB device consumes a lot of power

(However, as there is a wide range[http://permalink.gmane.org/gmane.comp.handhelds.openmoko.hardware/415]
of USB hubs out there, one might find power (on a powered USB hub)
is available already on the hub's mini USB 5 pin socket already, so not need a specialized cable after all!
Check with a test meter.)

These instructions will show you how to make a cable with 3 ends:

* A mini-USB type B cable for the Neo itself
* A cable of whatever type to go to your USB device.
* A cable going to a +5V +/-10%(max!) power supply with enough power for your device and to charge the Neo. This could be a wall charger or even another USB plug.

You connect the Data+ and Data- wires of the Neo and the device, and connect all of the ground wires together and all of the +5V wires together. This powers the Neo and the device, while letting the neo talk to the device.
You have to connect 2 pcs 15k ohm resistors, one from D+ to ground, and one from D- to ground, to comply with USB-spec for hostmode, as Neo is switching off the internal resistors when you enable charging/powering over USB by asserting EN_USBHOST.
See schematics, LOCATION:49XX

Just for reference, the USB wires from left to right are:
*Black: Power -
*Green: Data -
*White: Data +
*Red: Power +

The Mini_USB-B connector has a fifth pin, the ID-pin.
This pin is supposed to be short to ground to signal FreeRunner to enter hostmode. For the Y-cable and enabling external power while in hostmode, you may connect a 47k ohm resistor from ID-pin to ground. This is the same trick the OM-wallcharger uses to signal to FreeRunner it can charge with 1A. Future kernels should switch to hostmode + external power when seeing this 47k resistor.

===Parts===
USB 2.0 Plug type A to mini 5 pin USB Plug type B that should include the ID signal, so that you can add the 47k ohm resistor to ID-pin to trigger fast charging

# [http://www.firefold.com/Products/6-Foot-USB-20-Plug-type-A-to-mini-USB-Plug-type-B-5-pin-Cable---Black__USB-5PMINI-6.aspx firefold]
# Belkin 5 pin (find reference)
#https://www.argentdata.com/catalog/product_info.php?products_id=111
#http://www.partsdata.de/USB_Mini-B-Verlaengerung_Kabel_1m_CU-XB05-10.html

== USB hubs that can be used like a Y-cable without modifications ==

[http://www.dealextreme.com/details.dx/sku.13526 Cable Style Dual-Power 1000mA USB 2.0 4-Port Hub]. Connect power source to the red upstream connector and openmoko to the black upstream connector. Then connect USB devices to the downstream ports. After settings usb_mode=host the openmoko will charge and will still be able to talk to the downstream ports.
also available on ebay: [http://cgi.ebay.com/High-Speed-Smart-3-Ports-USB-Hub-5-Pin-Cable-for-PC_W0QQitemZ260567368077QQcmdZViewItemQQptZLH_DefaultDomain_0?hash=item3cab06818d]

[[Category:USB]]
[[Category:Neo FreeRunner Hardware]]
[[Category:Power]]

Applications

2009-09-11T10:51:39Z

Myfanwy: /* Telephony */

{{Languages|Applications}}
This is the wiki's master application list for the Openmoko smartphones.

== How to register new applications ?==

This list can not be exhaustive, as new things are showing up every week. This page is here to help spreading awareness about applications. Here are instructions on how to add a specific application to this list. There are many ways to go

Method 1 (preferred):
* Register your application at http://opkg.org. You will get a package number there, for example 33.
* Notify the community mailing list.
* Come back here, click on "edit" next to the appropriate section title, then add a line like:
<pre>* {{opkg.org|33|Application name}} A short description</pre>

Method 2: Just link to wherever the application is hosted.
* Click on "edit" next to the appropriate section title, add a line like:
<pre>* [http://your.host.domain/the/path/to/app/page.html Application name] A short description</pre>

Method 3: Create a new page in this wiki.
* Click on "edit" next to the appropriate section title, then add a line like:
<pre>* [[Application name]] A short description</pre>
* The application name will appear in red, click on it to create and edit the new page.

== Audio ==

* [http://www.faltantornillos.net/proyectos/gnu/brightPlayer/brightPlayerGTK0.2.tar.gz Bright Player] - Fast, lightweight and easy random music player.
* [[Dictator]] - Record mic, incoming GSM-sound, or a whole Phonecall
* {{opkg.org|55|ePiano}} - epiano is going to be a virtual piano
* [[Fingertier]] - minimal and finger friendly music player
* [[Fourier]]- Realtime frequency analysis of sound data.
* [[Guitartune]] - Tune musical Instruments.
* [[GTick]] - GTick is a metronome application written for GNU/Linux
* [[Intone]] - Elementary based mplayer frontend (for audio files).
* [[Mokoko]]- Play music.
* {{opkg.org|151|MokoPod}} - Retrieve and listen to podcasts
* [[Neoqplayer]] - Renamed as GorshPlayer: a multimedia player written in Qt4: play and retreive podcasts feeds, more reactive interface, now able to play videos ( in svn ).
* [http://fisoft.eu/standa/openmoko/omshuffle_0.1_arm.ipk omShuffle] - Inspired by Bright Player with volume control. Needs mplayer to work.
* [[Openmoko-mediaplayer2]] - Play music and video (mp3...)
* [[Openmokast]] - Play audio stream and slideshow stream
* [[Pythm]] - Audio player GUI using mplayer and mpd as backend.
* [[PyRok]] - Audio player which uses Gstreamer for playback and Pygame for GUI.
* [[Satan]] - Create your own music!
* [[Streamtuner]] - Listen to Internet Radio Stations
* [[Streamripper]] - Record from Internet Radio Stations
* [[Voicenote]] - Voicenote is a script which allows to record any sound from the microphone into a wav file. It can play the created files too. It is intended to be an easy and quick way to do so.
* [http://rzr.online.fr/q/esd boxar] - Touchscreen as a finger friendly piano -- [[User:RzR]]
* {{opkg.org|271|JaMoko}} Jamoko is a Jamendo player for OpenMoko.
----

== BlueTooth ==
* [[Coypu]] - Utility for send file via BlueTooth
----

== Games ==

* [[Games/Om 2007.2]] - Many small games on Om 2007.2
* [[Om 2008.8 Sudoku]] - Number placement based puzzle game
* [[Moko-sudoku]] - Another sudoku puzzle game.
* {{opkg.org|60|ScummVM}} ([[Scummvm|Wiki]]) Virtual Machine for several classic graphical point-and-click adventure games
* [[Kobodeluxe]] - A top-view space shooter, available from 2008.8 repositories.
* [[Pingus]] - Pingus is a lemmings clone with penguins.
* [[Duke Nukem 3D]] - Legendary First Person Shooter.
* [[Numptyphysics]] - A drawing puzzle game.
* [[Gnuboy]] - An emulator for the handheld gaming all-time bestseller.
* [[XBill]] - Little action game to stop Bill from installing Windows(tm) on computers.
* [[Xlogical]]-A puzzle based game where you turn spinners to move balls around.
* [[Liquid War]]-Liquid War is a truly original multiplayer wargame.
* [http://unsyncopated.com/BrainSolvent/Doom%20Port DOOM]- Classic FPS. Freerunner/1973
* [[MBAC]]- MBAC is "Moko Bulls and Cows", a classic game for openmoko written in pygtk similar to mastermind.
* [[OpenVibe]] - The first opensource vibrator.
* [[OpenTTD]] - OpenTransportTycoonDeluxe, ported to openmoko, using only GPLed datafiles.
* [http://scalde.free.fr/index.php?option=com_content&view=article&id=93:pong-pogresses&catid=43:openmoko&Itemid=66 Pong progresses]- This is a little pong game for the openmoko freerunner. The screen is devided in halves, so you can touch the right half to move the paddle right and the left half to move it left.
* [[OpenMooCow]] - OpenMooCow reads information out of your accelerometers. Now, if you turn the phone upside down and back again, it "moos" like one of the little toys.
* [[Freerunner LightSaber]]-Application as iphone LightSaber.
* [[CellHunter]] - A game you earn points by collecting cells (in english now).
* [[XSkat]] - XSkat lets you play the card game Skat defined by the official Skat Order.
* {{opkg.org|136|OpenMiaoCat}} OpenMiaoCat, like OpenMooCow, makes your phone became a cat!
* {{opkg.org|149|I'm Rich}} I'm Rich application
* {{opkg.org|121|Mokomaze}} Ball-in-the-labyrinth game
* [[Acceleroids]] Shoot-the-asteroids game
* {{opkg.org|169|Black Sheep}} Fight insomnia!
----

== GPS ==
* {{opkg.org|268|Advanced Geocaching Tool for Linux}} - "Towards paperless geocaching" - [[Advanced Geocaching Tool for Linux|User Manual]]
* [[SGTL|Simple Geocaching Tool for Linux]] - A geocaching application which shows you the direction.
* [[GPS Sight]] - Display GPS information, location, tracks, etc, without maps.
* [[Gpsdrive]] - Car (bike, etc) navigation system
* [[Om 2008.8 Locations]] - (aka Splinter) - Location sharing based on GPS and SMS
* [[Navit]] - Car navigation system with routing engine
* [[TangoGPS]] - Display map (OSM..), record GPS tracks...
* [[Pyroute]] - Pyroute is a routing program written in Python. It features mobile phone GUI for maps, GPS, and routing.
* [http://www.mumpot.org/ mumpot] - Display map (OSM), routing, OSM editing, a bit of live editing
* [[QMapControl]] - Display maps (OSM..) and add points, lines...
* [[Qpegps]] - Display map with current position
* [[Idle Hands]] - Give a task to you based on your location
* [[Gtkaddpoi]] - Utility for add a POI to TangoGPS using address or coordinates and export to Navit or to .kml file.
* [[Gpsdcontrol]]-A simple python script for start or stop gpsd daemon with a button on the desktop.
* [[OpenBmap]]-a free and open map of wireless communicating objects (e.g. cellular antenna, Wi-Fi, Bluetooth). It provides tools to mutualize data, create and access this map.
* {{opkg.org|162|gvSIG Mobile}} - This is an unofficial port of gvSIG Mobile (http://www.gvsig.gva.es/) to the Openmoko platform. gvSIG Mobile for Openmoko is currently a GPS-enabled projection-aware map viewer. [http://gvsigmobileonopenmoko.wordpress.com/ Homepage].
* {{opkg.org|175|BikeAtor}} - Like TangoGPS BikeAtor can display OSM Maps. The Speedometer displays the most interesting values of the trip.
* {{opkg.org|178|bicirutas}} - This application looks for mtb routes in www.bicirutas.net (routes in Spain, Portugal, United Kingdom, France, Italy and Germany). It gets the current position from the gps system and downloads nearby routes. Then you can follow them with tangogps application.
* [http://code.google.com/p/omgps omgps] - High performance, UBX binary or ogpsd as GPS data provider, layered maps, AGPS online, track replay, scratch on map, ruler and lat/lon grid, basic sounding. etc.
* [[Travel Diary]] - a simple application to save little diary entries to a csv file and send this to a server (that can generate a .kml file or show a map or do whatever...)
* [[QNavitCtl]] - send coordinates to Navit via dbus (position, destination, map center)
* [[a-gps GUI]] - uses cellhunter data to locate you, then uses u-blox a-gps to initialize your GPS chip
* [[sms-sentry]] - locate a lost or stolen phone
* [[bicirutas]] - download bicycle routes

== Graphics ==

* [[Orrery]] - Displays the night sky
* [[OMView]] - Image viewer
* [[PyPenNotes]] - Write notes using pen and touchscreen
* [[Gpe-scap]] - Take screenshots
* [[Flash|Gnash]]-Play flash file on Neo
* [[Neon]] - Image viewer

----

== Internet ==
===Web browsers===
* [http://www.dillo.org/ Dillo] - Multiplatform fast and small web browser ([http://misc.andi.de1.cc/dillo/ .ipk]).
* fennec
* [[Midori]] - Webkit based web browser
* [[Minimo]] - Mozilla based web browser
* [http://www.netsurf-browser.org/ netsurf]-A new browser for Neo FreeRunner.
* [[Openmoko-browser2]] - The original Openmoko web browser
* [http://code.google.com/p/pyqt-browser/ pyqt-browser] - modified the sample code from python-pyqt4 and changed it to use webkit for web browsing.
* woosh

===VOIP===
* [[Twinkle]] - Voice over IP
* [[Linphone]] - Voice over IP

===Email clients===
* [[Openmoko Mail]] - E-mail client
* [http://www.claws-mail.org/ claws-mail] email client available in shr-unstable
* [[Qtmail]] - Default mail program on Om 2008.8

===Offline wikipedia===
* [[Mokopedia]] - Read small Wikipedia dumps offline
* [[Offline Wikipedia reader]] - store the entire content of wikipedia (single-language, excluding images), on a single 8GB microSD card
* evopedia

===IM===
* [[Pidgin]] - Instant messaging client (ICQ, MSN, Jabber, Yahoo and more.)
* [[CenterIM]] - Instant messaging client (terminal-based).

===other===
* [[Openmokast]] - Play audio stream and slideshow stream
* [[PyFeedRead]] - RSS feed reader
* [[TwitterMoko]] - A Twitter client for Openmoko
* [http://we.trekbeyond.org/~kd8ikt/moko/shr_pkgz/ ettercap-ng] DEAD LINK
* {{opkg.org|205|GPRSModem}} - Converts your neo in a GPRS modem.

== Office ==
* dates - a simple calendar
* [[e-tasks]] - An elementary task manager
* [[Epdfview]] - PDF reader.
* Evince - Document reader for PDF, PS, DJVU and more.
* [[FBReader]] - E-book reader program (TXT, FB2, HTML and more)
* [[GPE contacts]]
* [[Gutenflash]] - Fast text reader by scrolling text
* [[OMoney]] - A bookkeeping application
* {{opkg.org|191|PISI}} - PISI is synchronizing (PIM) information

== Settings ==

* [[Mofi]] - Wifi setup tool
* [[Mokonnect]] - Connection manager
* [[Lint-wifi]] - Wifi setup tool
* [[KnjMokoWifi]] - Wifi setup tool
* [[KnjMokoOPKG]] - A graphical frontend to OPKG.
* [[Om 2008.8 Installer]] - Graphical software installer
* [[Opkg]] - Command line software installer
* [[Sephora]] - Settings manager
* [[SettingsGUI]] - Edit various settings
* [[Wicd]] - Wifi setup tool
* [[ZOMG!]] - A graphical package manager (opkg frontend -> should work on any distro)
* [[Timezone|tzdata]]- Customise your time zone setting.
* [[momtools]] - an application to control Wifi, gprs and some other stuff
* [[Wlan]] - Wlan is an application to manage wireless connection on the Freerunner

== System ==
* [[Aphasia]] - A system built on Erlang and a vertical application for people with apahasia.
* [http://www.pierrox.net/auimd/ AUIMD] - AUIMD is a PyQt graphical user interface for mobile devices.
* [[Auxlaunch]] - Finger-friendly app launcher and window switcher
* [[Display Locker]] - Screen lock
* [[Gwaterpas]] - levelling tool using accelerometer
* [[Gestures]] - Detect movement and display information, rotate screen
* [[Keychain]] - SSH keys
* [[MokoFEM]] - Monitors GSM information
* [[Mokostat]] - Monitors battery
* [[Openmoko Bluetooth remote controller|ReMoko]] - Control stuff via BlueTooth
* [[Rotate]] - Rotate screen when phone is rotated
* [[Vala-terminal]] - Command prompt with tabs
* [[Ts calibrate]] - Calibrates touchscreen
* [[Zedlock]] - Screen locker
* [http://fso-control.projects.openmoko.org/ fso-control] - Popup Power menu to shutdown/suspend/reboot.
* [[omkeys_functions]] - Remap AUX key bindings
* [[Siglaunchd]] - A daemon that listens to dbus signals and launches appliactions upon arrival.
* [[Pexpect]]-a pure Python module for spawning child applications; controlling them; and responding to expected patterns in their output.
* {{opkg.org|253|libaxel}} - Library for easy use accelerometer.
----

== Telephony ==
* [[Dialer/2007.2]] - The dialer application in Om 2007.2
* [[Openmoko SMS Middleware]]- SMS middleware is a Openmoko middleware software for additional features related to SMS. Plugin architecture and Python based code gives this project lots of flexibility and enchancebility.
* [[Paroli]] -Paroli is an integrated phone application based on Tichy (and so also written in python).
* [[Litephone]] Easy to use, single window phone application written in Qt.
* Launcher

== Utility ==
* [[Unison]] - Unison is a file-synchronization tool for Unix and Windows. It determines all differences between two directory trees and lets the user decide, how to proceed with every differing file.
* [[HP48 Series RPN Calculator]] - Calculator with many functions
* [[qwo]]- An alternative input method.
* {{opkg.org|57|fido}} - [[fido]] is a todo list\note manager written with elementary
* [http://meuk.spritesserver.nl/lightsaber-0.1.tgz The Lightsaber]. Pre-alpha starwaresque orphanware.
* [[NeoTool]] NeoTool is a bash script for your desktop system to provide a friendly GUI frontend to some common management tasks.
* [[NeoCon]] - neocon is a handy serial console utility (not only) for u-boot. The main feature of neocon is actually that you can give it a list of devices and it will pick one that works.
* [http://techiem2.net/index.php?/archives/10-Freerunner-USB-Mode-Control-Program.html usbmode]-a quick pygtk program.
* [[Enotes]] - Enotes is the implementation of a TODOlist manager written with elementary to appear better with distribution that use illume, like SHR.
* [[LED clock]] - When an Openmoko is sitting unused at night, turn it into an alarm clock with large 7-segment digits on a black background in landscape mode.
* [[MokoGeocaching]] - Utility for add a POI to TangoGPS using geocaching.com
* [[Wrench]] - Modual used utility enlightenment_remote.
* [[Yaouh!]] - Yet Another OSM Updater H.
* [[ShortOm]] - Graphical launcher for shell or application, with editable config file, and log result page.
* [[Pimlico]]-Pimlico is a suite of lightweight Personal Information Management (PIM) applications designed primarily for handheld and mobile devices
* [http://projects.openmoko.org/projects/otp4neo/ OTP4Neo] One time password generator
* [http://projects.openmoko.org/projects/ffalarms/ FFAlarm] is a program to set multiple alarms a day using a finger friendly user interface
* [[OpenWrt]]-basic support for the Openmoko "Freerunner"! Kernel (2.6.28) is building and booting.
* [[Enscribi]]-a handwriting recognition input method for Linux. It's mainly developed for the Openmoko Freerunner smartphone.
* [[GridPad]]-GridPad is an alternative input method for entering text with your finger, a Simple Character Recognizer Software.
* [[sortdesk]] sort your om-desktop in categories
* [[Mokometeo]] is a widget which fetches the weather forecast from yahoo, for a list of cities
* {{opkg.org|176|CoovaChilli}} - It turns your phone's WiFi network into an Ad-Hoc Hotspot!
* [http://openmoko.huber-computer.de/ DWDWetter] Fetches weather information from dwd (First Register at dwd!)
* [[QSuunto-Lite]] display dive log information from Suunto Dive computers (that work with divetools-ab)
* [[Literki]] - alternative keyboard

==Setting Application==
* [[Wmiconfig]]- wmiconfig is a tool written by Atheros Communications Inc to configure the Ar6k WIFI chip used in the Neo Freerunner. This is a standalone C executable, released under GPL v2.
* [[GTA02 sysfs]]- sysfs is a filesystem that is mounted on /sys which contains various fake "files" that are actually filled by a variety of drivers and other kernel subsystems. You can use it to change settings and behaviours of the kernel and drivers dynamically.

== Video ==

* [[Video Player]] - Using Mplayer on Openmoko smartphones.
* [http://katastrophos.net/andre/blog/software/quasar-media-player/ Quasar] - a mplayer frontend for X11.

----

== daemon ==
* [[PyPhonelog]] - daemon uses the framework to track and log all the calls made to and from the moko.
* [[Lscd]] - LSC library/daemon on Linux System.

== An automatic list of application-related wiki pages ==

The pages linked above are all maintained manually. We also maintain an automatic categorization system by tagging wiki pages. Here is the list of application-related pages in this wiki. Normally, every page listed below should be also listed above in the same category. The converse is false: there are applications without a wiki page.

<div style="border: solid 1px black; padding: 1ex"><b>Applications in this Wiki:</b>
<categorytree mode=pages depth=2 hideroot=on>Applications</categorytree>
</div>

== Where to find more applications? ==

At [http://opkg.org opkg.org] !

Not all Openmoko apps are listed on this wiki - there are much more [http://projects.openmoko.org/softwaremap/ projects at the Openmoko GForge] than the wiki can list, not to mention self-hosted applications on their own websites. Actually the phones can run most Linux based Free Software, using for example the [[Debian]] distribution. The [http://handhelds.freshmeat.net/browse/1038/ mobile phones section of Freshmeat] may be a interesting place to look.

Note also that there are many packages in the repository that are not installed by default. If what you want is a classic, chances are that it is already packaged. Suppose you want to install Perl:
opkg list|grep perl
opkg install perl

More application download related pages:

* [[Community Repository]]
* [[Users Repositories]]

<div style="clear:both"> </div>

== Where to find full distributions ? ==

* [[Download]]: for complete system downloads

== The usual warnings ==
<small>
* Some of these software are developed by Openmoko Inc. and some are contributed by the community. Any problems with community contributed software should be reported to the individual software developer rather than the Openmoko core team.
* Most programs listed here are not mature/stable, but only useable/beta.
* Many programs listed here are not yet packaged for your distribution and integrated in its repositories. Whichever it is.
* Installing experimental software from the internet is certain to break things. Running it as root is a very insecure thing to do. Kown that you will be burned, have backups, and be ready to apologize to everybody in your phone contact list in case they receive strange SMSs...
</small>

See also [[Hall of Fame]]

[[Category:Applications| ]]
[[Category:Basic End User]]

Neoqplayer

2009-09-11T10:49:05Z

Myfanwy: /* Introduction */

This page is '''obsolete''', neoqplayer has been '''renamed to Gorsh Player'''.
Visit the author website for more informations : [http://think-free.homelinux.org/wordpress/?page_id=23 | GorshPlayer |]

Current version : 0.3.1 ( 24 march 2009 )

----

{{ApplicationBox|
Name=NeoQPlayer sunset (version 0.2)|
Description=NeoQPlayer is a finger friendly, light multimedia application ( only audio now ) written in Qt4 which wants to be as fast as possible|
Screenshot=Neoqplayer-Sunset.png|
Homepage=http://projects.openmoko.org/projects/neoqplayer/|
TestedOn=Debian|
PackageName=[http://projects.openmoko.org/frs/download.php/513/NeoQPlayer-0.2-src.tar.gz]
}}

==Introduction==
NeoQplayer is written in Qt4 and tries to use as little as possible cpu, removing cpu hungry items.
It has only been tested on Debian which provides needed packages (Qt4 dev libraries, phonon, ...) but thanks to Qt4 it can be ported easily to other distributions.

==Functionality==
* Audio playing through gstreamer, xine, ... with phonon
* Playlist creation on the fly, show the current playlist
* Show the cover of the current album

==Installing neoqplayer==
NeoQplayer can be installed on Debian with provided scripts in the source archive which downloads dependencies, compiles the code and copies needed files to the right place.

==Using cover functionality==
You can show the cover of the current album, song, artist, ...
For that you need to put a .cover.png file in the folder containing the played song
( There will be a utility to manage your songs and covers soon )

==Screenshots==
* [http://wiki.openmoko.org/images/1/18/NeoQPlayer-Sunset-fileSelection.png] FileSelection ( folder view )
* [http://wiki.openmoko.org/images/e/e0/NeoQPlayer-Sunset-fileSelection2.png] FileSelection ( file view )
* [http://wiki.openmoko.org/images/b/b6/NeoQPlayer-Sunset-playList.png] PlayListView

==Ideas, Feature Requests==
Here you can put your Feature-ideas.
* add an idea here
* (idea^^)motion-gesture features like shaking for a random song or swing right for next song

Or use the tracked ( better ) :
http://projects.openmoko.org/tracker/?group_id=231

==User feedback==
* add your feedback/comments here

==Known Problems==
* FIXED in svn : The gui is not as fast as it should be on the neo, it seems that this is a Xglamo issue as Xglamo use ~60-70% cpu on screen update

==Reporting Bugs==

http://projects.openmoko.org/tracker/?group_id=231

==News about the project==
http://projects.openmoko.org/news/?group_id=231

[[Category:Audio Applications]]

Applications

2009-09-11T10:09:10Z

Myfanwy: /* web browsers */

{{Languages|Applications}}
This is the wiki's master application list for the Openmoko smartphones.

== How to register new applications ?==

This list can not be exhaustive, as new things are showing up every week. This page is here to help spreading awareness about applications. Here are instructions on how to add a specific application to this list. There are many ways to go

Method 1 (preferred):
* Register your application at http://opkg.org. You will get a package number there, for example 33.
* Notify the community mailing list.
* Come back here, click on "edit" next to the appropriate section title, then add a line like:
<pre>* {{opkg.org|33|Application name}} A short description</pre>

Method 2: Just link to wherever the application is hosted.
* Click on "edit" next to the appropriate section title, add a line like:
<pre>* [http://your.host.domain/the/path/to/app/page.html Application name] A short description</pre>

Method 3: Create a new page in this wiki.
* Click on "edit" next to the appropriate section title, then add a line like:
<pre>* [[Application name]] A short description</pre>
* The application name will appear in red, click on it to create and edit the new page.

== Audio ==

* [http://www.faltantornillos.net/proyectos/gnu/brightPlayer/brightPlayerGTK0.2.tar.gz Bright Player] - Fast, lightweight and easy random music player.
* [[Dictator]] - Record mic, incoming GSM-sound, or a whole Phonecall
* {{opkg.org|55|ePiano}} - epiano is going to be a virtual piano
* [[Fingertier]] - minimal and finger friendly music player
* [[Fourier]]- Realtime frequency analysis of sound data.
* [[Guitartune]] - Tune musical Instruments.
* [[GTick]] - GTick is a metronome application written for GNU/Linux
* [[Intone]] - Elementary based mplayer frontend (for audio files).
* [[Mokoko]]- Play music.
* {{opkg.org|151|MokoPod}} - Retrieve and listen to podcasts
* [[Neoqplayer]] - Renamed as GorshPlayer: a multimedia player written in Qt4: play and retreive podcasts feeds, more reactive interface, now able to play videos ( in svn ).
* [http://fisoft.eu/standa/openmoko/omshuffle_0.1_arm.ipk omShuffle] - Inspired by Bright Player with volume control. Needs mplayer to work.
* [[Openmoko-mediaplayer2]] - Play music and video (mp3...)
* [[Openmokast]] - Play audio stream and slideshow stream
* [[Pythm]] - Audio player GUI using mplayer and mpd as backend.
* [[PyRok]] - Audio player which uses Gstreamer for playback and Pygame for GUI.
* [[Satan]] - Create your own music!
* [[Streamtuner]] - Listen to Internet Radio Stations
* [[Streamripper]] - Record from Internet Radio Stations
* [[Voicenote]] - Voicenote is a script which allows to record any sound from the microphone into a wav file. It can play the created files too. It is intended to be an easy and quick way to do so.
* [http://rzr.online.fr/q/esd boxar] - Touchscreen as a finger friendly piano -- [[User:RzR]]
* {{opkg.org|271|JaMoko}} Jamoko is a Jamendo player for OpenMoko.
----

== BlueTooth ==
* [[Coypu]] - Utility for send file via BlueTooth
----

== Games ==

* [[Games/Om 2007.2]] - Many small games on Om 2007.2
* [[Om 2008.8 Sudoku]] - Number placement based puzzle game
* [[Moko-sudoku]] - Another sudoku puzzle game.
* {{opkg.org|60|ScummVM}} ([[Scummvm|Wiki]]) Virtual Machine for several classic graphical point-and-click adventure games
* [[Kobodeluxe]] - A top-view space shooter, available from 2008.8 repositories.
* [[Pingus]] - Pingus is a lemmings clone with penguins.
* [[Duke Nukem 3D]] - Legendary First Person Shooter.
* [[Numptyphysics]] - A drawing puzzle game.
* [[Gnuboy]] - An emulator for the handheld gaming all-time bestseller.
* [[XBill]] - Little action game to stop Bill from installing Windows(tm) on computers.
* [[Xlogical]]-A puzzle based game where you turn spinners to move balls around.
* [[Liquid War]]-Liquid War is a truly original multiplayer wargame.
* [http://unsyncopated.com/BrainSolvent/Doom%20Port DOOM]- Classic FPS. Freerunner/1973
* [[MBAC]]- MBAC is "Moko Bulls and Cows", a classic game for openmoko written in pygtk similar to mastermind.
* [[OpenVibe]] - The first opensource vibrator.
* [[OpenTTD]] - OpenTransportTycoonDeluxe, ported to openmoko, using only GPLed datafiles.
* [http://scalde.free.fr/index.php?option=com_content&view=article&id=93:pong-pogresses&catid=43:openmoko&Itemid=66 Pong progresses]- This is a little pong game for the openmoko freerunner. The screen is devided in halves, so you can touch the right half to move the paddle right and the left half to move it left.
* [[OpenMooCow]] - OpenMooCow reads information out of your accelerometers. Now, if you turn the phone upside down and back again, it "moos" like one of the little toys.
* [[Freerunner LightSaber]]-Application as iphone LightSaber.
* [[CellHunter]] - A game you earn points by collecting cells (in english now).
* [[XSkat]] - XSkat lets you play the card game Skat defined by the official Skat Order.
* {{opkg.org|136|OpenMiaoCat}} OpenMiaoCat, like OpenMooCow, makes your phone became a cat!
* {{opkg.org|149|I'm Rich}} I'm Rich application
* {{opkg.org|121|Mokomaze}} Ball-in-the-labyrinth game
* [[Acceleroids]] Shoot-the-asteroids game
* {{opkg.org|169|Black Sheep}} Fight insomnia!
----

== GPS ==
* {{opkg.org|268|Advanced Geocaching Tool for Linux}} - "Towards paperless geocaching" - [[Advanced Geocaching Tool for Linux|User Manual]]
* [[SGTL|Simple Geocaching Tool for Linux]] - A geocaching application which shows you the direction.
* [[GPS Sight]] - Display GPS information, location, tracks, etc, without maps.
* [[Gpsdrive]] - Car (bike, etc) navigation system
* [[Om 2008.8 Locations]] - (aka Splinter) - Location sharing based on GPS and SMS
* [[Navit]] - Car navigation system with routing engine
* [[TangoGPS]] - Display map (OSM..), record GPS tracks...
* [[Pyroute]] - Pyroute is a routing program written in Python. It features mobile phone GUI for maps, GPS, and routing.
* [http://www.mumpot.org/ mumpot] - Display map (OSM), routing, OSM editing, a bit of live editing
* [[QMapControl]] - Display maps (OSM..) and add points, lines...
* [[Qpegps]] - Display map with current position
* [[Idle Hands]] - Give a task to you based on your location
* [[Gtkaddpoi]] - Utility for add a POI to TangoGPS using address or coordinates and export to Navit or to .kml file.
* [[Gpsdcontrol]]-A simple python script for start or stop gpsd daemon with a button on the desktop.
* [[OpenBmap]]-a free and open map of wireless communicating objects (e.g. cellular antenna, Wi-Fi, Bluetooth). It provides tools to mutualize data, create and access this map.
* {{opkg.org|162|gvSIG Mobile}} - This is an unofficial port of gvSIG Mobile (http://www.gvsig.gva.es/) to the Openmoko platform. gvSIG Mobile for Openmoko is currently a GPS-enabled projection-aware map viewer. [http://gvsigmobileonopenmoko.wordpress.com/ Homepage].
* {{opkg.org|175|BikeAtor}} - Like TangoGPS BikeAtor can display OSM Maps. The Speedometer displays the most interesting values of the trip.
* {{opkg.org|178|bicirutas}} - This application looks for mtb routes in www.bicirutas.net (routes in Spain, Portugal, United Kingdom, France, Italy and Germany). It gets the current position from the gps system and downloads nearby routes. Then you can follow them with tangogps application.
* [http://code.google.com/p/omgps omgps] - High performance, UBX binary or ogpsd as GPS data provider, layered maps, AGPS online, track replay, scratch on map, ruler and lat/lon grid, basic sounding. etc.
* [[Travel Diary]] - a simple application to save little diary entries to a csv file and send this to a server (that can generate a .kml file or show a map or do whatever...)
* [[QNavitCtl]] - send coordinates to Navit via dbus (position, destination, map center)
* [[a-gps GUI]] - uses cellhunter data to locate you, then uses u-blox a-gps to initialize your GPS chip
* [[sms-sentry]] - locate a lost or stolen phone
* [[bicirutas]] - download bicycle routes

== Graphics ==

* [[Orrery]] - Displays the night sky
* [[OMView]] - Image viewer
* [[PyPenNotes]] - Write notes using pen and touchscreen
* [[Gpe-scap]] - Take screenshots
* [[Flash|Gnash]]-Play flash file on Neo
* [[Neon]] - Image viewer

----

== Internet ==
===web browsers===
* [http://www.dillo.org/ Dillo] - Multiplatform fast and small web browser ([http://misc.andi.de1.cc/dillo/ .ipk]).
* fennec
* [[Midori]] - Webkit based web browser
* [[Minimo]] - Mozilla based web browser
* [http://www.netsurf-browser.org/ netsurf]-A new browser for Neo FreeRunner.
* [[Openmoko-browser2]] - The original Openmoko web browser
* [http://code.google.com/p/pyqt-browser/ pyqt-browser] - modified the sample code from python-pyqt4 and changed it to use webkit for web browsing.
* woosh

===VOIP===
* [[Twinkle]] - Voice over IP
* [[Linphone]] - Voice over IP

===email clients===
* [[Openmoko Mail]] - E-mail client
* [http://www.claws-mail.org/ claws-mail] email client available in shr-unstable
* [[Qtmail]] - Default mail program on Om 2008.8

===Offline wikipedia===
* [[Mokopedia]] - Read small Wikipedia dumps offline
* [[Offline Wikipedia reader]] - store the entire content of wikipedia (single-language, excluding images), on a single 8GB microSD card
* evopedia

===IM===
* [[Pidgin]] - Instant messaging client (ICQ, MSN, Jabber, Yahoo and more.)
* [[CenterIM]] - Instant messaging client (terminal-based).

===other===
* [[Openmokast]] - Play audio stream and slideshow stream
* [[PyFeedRead]] - RSS feed reader
* [[TwitterMoko]] - A Twitter client for Openmoko
* [http://we.trekbeyond.org/~kd8ikt/moko/shr_pkgz/ ettercap-ng] DEAD LINK
* {{opkg.org|205|GPRSModem}} - Converts your neo in a GPRS modem.

== Office ==
* dates - a simple calendar
* [[e-tasks]] - An elementary task manager
* [[Epdfview]] - PDF reader.
* Evince - Document reader for PDF, PS, DJVU and more.
* [[FBReader]] - E-book reader program (TXT, FB2, HTML and more)
* [[GPE contacts]]
* [[Gutenflash]] - Fast text reader by scrolling text
* [[OMoney]] - A bookkeeping application
* {{opkg.org|191|PISI}} - PISI is synchronizing (PIM) information

== Settings ==

* [[Mofi]] - Wifi setup tool
* [[Mokonnect]] - Connection manager
* [[Lint-wifi]] - Wifi setup tool
* [[KnjMokoWifi]] - Wifi setup tool
* [[KnjMokoOPKG]] - A graphical frontend to OPKG.
* [[Om 2008.8 Installer]] - Graphical software installer
* [[Opkg]] - Command line software installer
* [[Sephora]] - Settings manager
* [[SettingsGUI]] - Edit various settings
* [[Wicd]] - Wifi setup tool
* [[ZOMG!]] - A graphical package manager (opkg frontend -> should work on any distro)
* [[Timezone|tzdata]]- Customise your time zone setting.
* [[momtools]] - an application to control Wifi, gprs and some other stuff
* [[Wlan]] - Wlan is an application to manage wireless connection on the Freerunner

== System ==
* [[Aphasia]] - A system built on Erlang and a vertical application for people with apahasia.
* [http://www.pierrox.net/auimd/ AUIMD] - AUIMD is a PyQt graphical user interface for mobile devices.
* [[Auxlaunch]] - Finger-friendly app launcher and window switcher
* [[Display Locker]] - Screen lock
* [[Gwaterpas]] - levelling tool using accelerometer
* [[Gestures]] - Detect movement and display information, rotate screen
* [[Keychain]] - SSH keys
* [[MokoFEM]] - Monitors GSM information
* [[Mokostat]] - Monitors battery
* [[Openmoko Bluetooth remote controller|ReMoko]] - Control stuff via BlueTooth
* [[Rotate]] - Rotate screen when phone is rotated
* [[Vala-terminal]] - Command prompt with tabs
* [[Ts calibrate]] - Calibrates touchscreen
* [[Zedlock]] - Screen locker
* [http://fso-control.projects.openmoko.org/ fso-control] - Popup Power menu to shutdown/suspend/reboot.
* [[omkeys_functions]] - Remap AUX key bindings
* [[Siglaunchd]] - A daemon that listens to dbus signals and launches appliactions upon arrival.
* [[Pexpect]]-a pure Python module for spawning child applications; controlling them; and responding to expected patterns in their output.
* {{opkg.org|253|libaxel}} - Library for easy use accelerometer.
----

== Telephony ==
* [[Dialer/2007.2]] - The dialer application in Om 2007.2
* [[Openmoko SMS Middleware]]- SMS middleware is a Openmoko middleware software for additional features related to SMS. Plugin architecture and Python based code gives this project lots of flexibility and enchancebility.
* [[Paroli]] -Paroli is an integrated phone application based on Tichy (and so also written in python).
* [[Litephone]] Easy to use, single window phone application written in Qt.
----

== Utility ==
* [[Unison]] - Unison is a file-synchronization tool for Unix and Windows. It determines all differences between two directory trees and lets the user decide, how to proceed with every differing file.
* [[HP48 Series RPN Calculator]] - Calculator with many functions
* [[qwo]]- An alternative input method.
* {{opkg.org|57|fido}} - [[fido]] is a todo list\note manager written with elementary
* [http://meuk.spritesserver.nl/lightsaber-0.1.tgz The Lightsaber]. Pre-alpha starwaresque orphanware.
* [[NeoTool]] NeoTool is a bash script for your desktop system to provide a friendly GUI frontend to some common management tasks.
* [[NeoCon]] - neocon is a handy serial console utility (not only) for u-boot. The main feature of neocon is actually that you can give it a list of devices and it will pick one that works.
* [http://techiem2.net/index.php?/archives/10-Freerunner-USB-Mode-Control-Program.html usbmode]-a quick pygtk program.
* [[Enotes]] - Enotes is the implementation of a TODOlist manager written with elementary to appear better with distribution that use illume, like SHR.
* [[LED clock]] - When an Openmoko is sitting unused at night, turn it into an alarm clock with large 7-segment digits on a black background in landscape mode.
* [[MokoGeocaching]] - Utility for add a POI to TangoGPS using geocaching.com
* [[Wrench]] - Modual used utility enlightenment_remote.
* [[Yaouh!]] - Yet Another OSM Updater H.
* [[ShortOm]] - Graphical launcher for shell or application, with editable config file, and log result page.
* [[Pimlico]]-Pimlico is a suite of lightweight Personal Information Management (PIM) applications designed primarily for handheld and mobile devices
* [http://projects.openmoko.org/projects/otp4neo/ OTP4Neo] One time password generator
* [http://projects.openmoko.org/projects/ffalarms/ FFAlarm] is a program to set multiple alarms a day using a finger friendly user interface
* [[OpenWrt]]-basic support for the Openmoko "Freerunner"! Kernel (2.6.28) is building and booting.
* [[Enscribi]]-a handwriting recognition input method for Linux. It's mainly developed for the Openmoko Freerunner smartphone.
* [[GridPad]]-GridPad is an alternative input method for entering text with your finger, a Simple Character Recognizer Software.
* [[sortdesk]] sort your om-desktop in categories
* [[Mokometeo]] is a widget which fetches the weather forecast from yahoo, for a list of cities
* {{opkg.org|176|CoovaChilli}} - It turns your phone's WiFi network into an Ad-Hoc Hotspot!
* [http://openmoko.huber-computer.de/ DWDWetter] Fetches weather information from dwd (First Register at dwd!)
* [[QSuunto-Lite]] display dive log information from Suunto Dive computers (that work with divetools-ab)
* [[Literki]] - alternative keyboard

==Setting Application==
* [[Wmiconfig]]- wmiconfig is a tool written by Atheros Communications Inc to configure the Ar6k WIFI chip used in the Neo Freerunner. This is a standalone C executable, released under GPL v2.
* [[GTA02 sysfs]]- sysfs is a filesystem that is mounted on /sys which contains various fake "files" that are actually filled by a variety of drivers and other kernel subsystems. You can use it to change settings and behaviours of the kernel and drivers dynamically.

== Video ==

* [[Video Player]] - Using Mplayer on Openmoko smartphones.
* [http://katastrophos.net/andre/blog/software/quasar-media-player/ Quasar] - a mplayer frontend for X11.

----

== daemon ==
* [[PyPhonelog]] - daemon uses the framework to track and log all the calls made to and from the moko.
* [[Lscd]] - LSC library/daemon on Linux System.

== An automatic list of application-related wiki pages ==

The pages linked above are all maintained manually. We also maintain an automatic categorization system by tagging wiki pages. Here is the list of application-related pages in this wiki. Normally, every page listed below should be also listed above in the same category. The converse is false: there are applications without a wiki page.

<div style="border: solid 1px black; padding: 1ex"><b>Applications in this Wiki:</b>
<categorytree mode=pages depth=2 hideroot=on>Applications</categorytree>
</div>

== Where to find more applications? ==

At [http://opkg.org opkg.org] !

Not all Openmoko apps are listed on this wiki - there are much more [http://projects.openmoko.org/softwaremap/ projects at the Openmoko GForge] than the wiki can list, not to mention self-hosted applications on their own websites. Actually the phones can run most Linux based Free Software, using for example the [[Debian]] distribution. The [http://handhelds.freshmeat.net/browse/1038/ mobile phones section of Freshmeat] may be a interesting place to look.

Note also that there are many packages in the repository that are not installed by default. If what you want is a classic, chances are that it is already packaged. Suppose you want to install Perl:
opkg list|grep perl
opkg install perl

More application download related pages:

* [[Community Repository]]
* [[Users Repositories]]

<div style="clear:both"> </div>

== Where to find full distributions ? ==

* [[Download]]: for complete system downloads

== The usual warnings ==
<small>
* Some of these software are developed by Openmoko Inc. and some are contributed by the community. Any problems with community contributed software should be reported to the individual software developer rather than the Openmoko core team.
* Most programs listed here are not mature/stable, but only useable/beta.
* Many programs listed here are not yet packaged for your distribution and integrated in its repositories. Whichever it is.
* Installing experimental software from the internet is certain to break things. Running it as root is a very insecure thing to do. Kown that you will be burned, have backups, and be ready to apologize to everybody in your phone contact list in case they receive strange SMSs...
</small>

See also [[Hall of Fame]]

[[Category:Applications| ]]
[[Category:Basic End User]]

Applications

2009-09-11T10:02:12Z

Myfanwy: /* Internet */

{{Languages|Applications}}
This is the wiki's master application list for the Openmoko smartphones.

== How to register new applications ?==

This list can not be exhaustive, as new things are showing up every week. This page is here to help spreading awareness about applications. Here are instructions on how to add a specific application to this list. There are many ways to go

Method 1 (preferred):
* Register your application at http://opkg.org. You will get a package number there, for example 33.
* Notify the community mailing list.
* Come back here, click on "edit" next to the appropriate section title, then add a line like:
<pre>* {{opkg.org|33|Application name}} A short description</pre>

Method 2: Just link to wherever the application is hosted.
* Click on "edit" next to the appropriate section title, add a line like:
<pre>* [http://your.host.domain/the/path/to/app/page.html Application name] A short description</pre>

Method 3: Create a new page in this wiki.
* Click on "edit" next to the appropriate section title, then add a line like:
<pre>* [[Application name]] A short description</pre>
* The application name will appear in red, click on it to create and edit the new page.

== Audio ==

* [http://www.faltantornillos.net/proyectos/gnu/brightPlayer/brightPlayerGTK0.2.tar.gz Bright Player] - Fast, lightweight and easy random music player.
* [[Dictator]] - Record mic, incoming GSM-sound, or a whole Phonecall
* {{opkg.org|55|ePiano}} - epiano is going to be a virtual piano
* [[Fingertier]] - minimal and finger friendly music player
* [[Fourier]]- Realtime frequency analysis of sound data.
* [[Guitartune]] - Tune musical Instruments.
* [[GTick]] - GTick is a metronome application written for GNU/Linux
* [[Intone]] - Elementary based mplayer frontend (for audio files).
* [[Mokoko]]- Play music.
* {{opkg.org|151|MokoPod}} - Retrieve and listen to podcasts
* [[Neoqplayer]] - Renamed as GorshPlayer: a multimedia player written in Qt4: play and retreive podcasts feeds, more reactive interface, now able to play videos ( in svn ).
* [http://fisoft.eu/standa/openmoko/omshuffle_0.1_arm.ipk omShuffle] - Inspired by Bright Player with volume control. Needs mplayer to work.
* [[Openmoko-mediaplayer2]] - Play music and video (mp3...)
* [[Openmokast]] - Play audio stream and slideshow stream
* [[Pythm]] - Audio player GUI using mplayer and mpd as backend.
* [[PyRok]] - Audio player which uses Gstreamer for playback and Pygame for GUI.
* [[Satan]] - Create your own music!
* [[Streamtuner]] - Listen to Internet Radio Stations
* [[Streamripper]] - Record from Internet Radio Stations
* [[Voicenote]] - Voicenote is a script which allows to record any sound from the microphone into a wav file. It can play the created files too. It is intended to be an easy and quick way to do so.
* [http://rzr.online.fr/q/esd boxar] - Touchscreen as a finger friendly piano -- [[User:RzR]]
* {{opkg.org|271|JaMoko}} Jamoko is a Jamendo player for OpenMoko.
----

== BlueTooth ==
* [[Coypu]] - Utility for send file via BlueTooth
----

== Games ==

* [[Games/Om 2007.2]] - Many small games on Om 2007.2
* [[Om 2008.8 Sudoku]] - Number placement based puzzle game
* [[Moko-sudoku]] - Another sudoku puzzle game.
* {{opkg.org|60|ScummVM}} ([[Scummvm|Wiki]]) Virtual Machine for several classic graphical point-and-click adventure games
* [[Kobodeluxe]] - A top-view space shooter, available from 2008.8 repositories.
* [[Pingus]] - Pingus is a lemmings clone with penguins.
* [[Duke Nukem 3D]] - Legendary First Person Shooter.
* [[Numptyphysics]] - A drawing puzzle game.
* [[Gnuboy]] - An emulator for the handheld gaming all-time bestseller.
* [[XBill]] - Little action game to stop Bill from installing Windows(tm) on computers.
* [[Xlogical]]-A puzzle based game where you turn spinners to move balls around.
* [[Liquid War]]-Liquid War is a truly original multiplayer wargame.
* [http://unsyncopated.com/BrainSolvent/Doom%20Port DOOM]- Classic FPS. Freerunner/1973
* [[MBAC]]- MBAC is "Moko Bulls and Cows", a classic game for openmoko written in pygtk similar to mastermind.
* [[OpenVibe]] - The first opensource vibrator.
* [[OpenTTD]] - OpenTransportTycoonDeluxe, ported to openmoko, using only GPLed datafiles.
* [http://scalde.free.fr/index.php?option=com_content&view=article&id=93:pong-pogresses&catid=43:openmoko&Itemid=66 Pong progresses]- This is a little pong game for the openmoko freerunner. The screen is devided in halves, so you can touch the right half to move the paddle right and the left half to move it left.
* [[OpenMooCow]] - OpenMooCow reads information out of your accelerometers. Now, if you turn the phone upside down and back again, it "moos" like one of the little toys.
* [[Freerunner LightSaber]]-Application as iphone LightSaber.
* [[CellHunter]] - A game you earn points by collecting cells (in english now).
* [[XSkat]] - XSkat lets you play the card game Skat defined by the official Skat Order.
* {{opkg.org|136|OpenMiaoCat}} OpenMiaoCat, like OpenMooCow, makes your phone became a cat!
* {{opkg.org|149|I'm Rich}} I'm Rich application
* {{opkg.org|121|Mokomaze}} Ball-in-the-labyrinth game
* [[Acceleroids]] Shoot-the-asteroids game
* {{opkg.org|169|Black Sheep}} Fight insomnia!
----

== GPS ==
* {{opkg.org|268|Advanced Geocaching Tool for Linux}} - "Towards paperless geocaching" - [[Advanced Geocaching Tool for Linux|User Manual]]
* [[SGTL|Simple Geocaching Tool for Linux]] - A geocaching application which shows you the direction.
* [[GPS Sight]] - Display GPS information, location, tracks, etc, without maps.
* [[Gpsdrive]] - Car (bike, etc) navigation system
* [[Om 2008.8 Locations]] - (aka Splinter) - Location sharing based on GPS and SMS
* [[Navit]] - Car navigation system with routing engine
* [[TangoGPS]] - Display map (OSM..), record GPS tracks...
* [[Pyroute]] - Pyroute is a routing program written in Python. It features mobile phone GUI for maps, GPS, and routing.
* [http://www.mumpot.org/ mumpot] - Display map (OSM), routing, OSM editing, a bit of live editing
* [[QMapControl]] - Display maps (OSM..) and add points, lines...
* [[Qpegps]] - Display map with current position
* [[Idle Hands]] - Give a task to you based on your location
* [[Gtkaddpoi]] - Utility for add a POI to TangoGPS using address or coordinates and export to Navit or to .kml file.
* [[Gpsdcontrol]]-A simple python script for start or stop gpsd daemon with a button on the desktop.
* [[OpenBmap]]-a free and open map of wireless communicating objects (e.g. cellular antenna, Wi-Fi, Bluetooth). It provides tools to mutualize data, create and access this map.
* {{opkg.org|162|gvSIG Mobile}} - This is an unofficial port of gvSIG Mobile (http://www.gvsig.gva.es/) to the Openmoko platform. gvSIG Mobile for Openmoko is currently a GPS-enabled projection-aware map viewer. [http://gvsigmobileonopenmoko.wordpress.com/ Homepage].
* {{opkg.org|175|BikeAtor}} - Like TangoGPS BikeAtor can display OSM Maps. The Speedometer displays the most interesting values of the trip.
* {{opkg.org|178|bicirutas}} - This application looks for mtb routes in www.bicirutas.net (routes in Spain, Portugal, United Kingdom, France, Italy and Germany). It gets the current position from the gps system and downloads nearby routes. Then you can follow them with tangogps application.
* [http://code.google.com/p/omgps omgps] - High performance, UBX binary or ogpsd as GPS data provider, layered maps, AGPS online, track replay, scratch on map, ruler and lat/lon grid, basic sounding. etc.
* [[Travel Diary]] - a simple application to save little diary entries to a csv file and send this to a server (that can generate a .kml file or show a map or do whatever...)
* [[QNavitCtl]] - send coordinates to Navit via dbus (position, destination, map center)
* [[a-gps GUI]] - uses cellhunter data to locate you, then uses u-blox a-gps to initialize your GPS chip
* [[sms-sentry]] - locate a lost or stolen phone
* [[bicirutas]] - download bicycle routes

== Graphics ==

* [[Orrery]] - Displays the night sky
* [[OMView]] - Image viewer
* [[PyPenNotes]] - Write notes using pen and touchscreen
* [[Gpe-scap]] - Take screenshots
* [[Flash|Gnash]]-Play flash file on Neo
* [[Neon]] - Image viewer

----

== Internet ==
===web browsers===
* [[Midori]] - Webkit based web browser
* [[Minimo]] - Mozilla based web browser
* [http://www.dillo.org/ Dillo] - Multiplatform fast and small web browser ([http://misc.andi.de1.cc/dillo/ .ipk]).
* [http://code.google.com/p/pyqt-browser/ pyqt-browser] - modified the sample code from python-pyqt4 and changed it to use webkit for web browsing.
* [http://www.netsurf-browser.org/ netsurf]-A new browser for Neo FreeRunner.
* [[Openmoko-browser2]] - The original Openmoko web browser

===VOIP===
* [[Twinkle]] - Voice over IP
* [[Linphone]] - Voice over IP

===email clients===
* [[Openmoko Mail]] - E-mail client
* [http://www.claws-mail.org/ claws-mail] email client available in shr-unstable
* [[Qtmail]] - Default mail program on Om 2008.8

===Offline wikipedia===
* [[Mokopedia]] - Read small Wikipedia dumps offline
* [[Offline Wikipedia reader]] - store the entire content of wikipedia (single-language, excluding images), on a single 8GB microSD card
* evopedia

===IM===
* [[Pidgin]] - Instant messaging client (ICQ, MSN, Jabber, Yahoo and more.)
* [[CenterIM]] - Instant messaging client (terminal-based).

===other===
* [[Openmokast]] - Play audio stream and slideshow stream
* [[PyFeedRead]] - RSS feed reader
* [[TwitterMoko]] - A Twitter client for Openmoko
* [http://we.trekbeyond.org/~kd8ikt/moko/shr_pkgz/ ettercap-ng] DEAD LINK
* {{opkg.org|205|GPRSModem}} - Converts your neo in a GPRS modem.

== Office ==
* dates - a simple calendar
* [[e-tasks]] - An elementary task manager
* [[Epdfview]] - PDF reader.
* Evince - Document reader for PDF, PS, DJVU and more.
* [[FBReader]] - E-book reader program (TXT, FB2, HTML and more)
* [[GPE contacts]]
* [[Gutenflash]] - Fast text reader by scrolling text
* [[OMoney]] - A bookkeeping application
* {{opkg.org|191|PISI}} - PISI is synchronizing (PIM) information

== Settings ==

* [[Mofi]] - Wifi setup tool
* [[Mokonnect]] - Connection manager
* [[Lint-wifi]] - Wifi setup tool
* [[KnjMokoWifi]] - Wifi setup tool
* [[KnjMokoOPKG]] - A graphical frontend to OPKG.
* [[Om 2008.8 Installer]] - Graphical software installer
* [[Opkg]] - Command line software installer
* [[Sephora]] - Settings manager
* [[SettingsGUI]] - Edit various settings
* [[Wicd]] - Wifi setup tool
* [[ZOMG!]] - A graphical package manager (opkg frontend -> should work on any distro)
* [[Timezone|tzdata]]- Customise your time zone setting.
* [[momtools]] - an application to control Wifi, gprs and some other stuff
* [[Wlan]] - Wlan is an application to manage wireless connection on the Freerunner

== System ==
* [[Aphasia]] - A system built on Erlang and a vertical application for people with apahasia.
* [http://www.pierrox.net/auimd/ AUIMD] - AUIMD is a PyQt graphical user interface for mobile devices.
* [[Auxlaunch]] - Finger-friendly app launcher and window switcher
* [[Display Locker]] - Screen lock
* [[Gwaterpas]] - levelling tool using accelerometer
* [[Gestures]] - Detect movement and display information, rotate screen
* [[Keychain]] - SSH keys
* [[MokoFEM]] - Monitors GSM information
* [[Mokostat]] - Monitors battery
* [[Openmoko Bluetooth remote controller|ReMoko]] - Control stuff via BlueTooth
* [[Rotate]] - Rotate screen when phone is rotated
* [[Vala-terminal]] - Command prompt with tabs
* [[Ts calibrate]] - Calibrates touchscreen
* [[Zedlock]] - Screen locker
* [http://fso-control.projects.openmoko.org/ fso-control] - Popup Power menu to shutdown/suspend/reboot.
* [[omkeys_functions]] - Remap AUX key bindings
* [[Siglaunchd]] - A daemon that listens to dbus signals and launches appliactions upon arrival.
* [[Pexpect]]-a pure Python module for spawning child applications; controlling them; and responding to expected patterns in their output.
* {{opkg.org|253|libaxel}} - Library for easy use accelerometer.
----

== Telephony ==
* [[Dialer/2007.2]] - The dialer application in Om 2007.2
* [[Openmoko SMS Middleware]]- SMS middleware is a Openmoko middleware software for additional features related to SMS. Plugin architecture and Python based code gives this project lots of flexibility and enchancebility.
* [[Paroli]] -Paroli is an integrated phone application based on Tichy (and so also written in python).
* [[Litephone]] Easy to use, single window phone application written in Qt.
----

== Utility ==
* [[Unison]] - Unison is a file-synchronization tool for Unix and Windows. It determines all differences between two directory trees and lets the user decide, how to proceed with every differing file.
* [[HP48 Series RPN Calculator]] - Calculator with many functions
* [[qwo]]- An alternative input method.
* {{opkg.org|57|fido}} - [[fido]] is a todo list\note manager written with elementary
* [http://meuk.spritesserver.nl/lightsaber-0.1.tgz The Lightsaber]. Pre-alpha starwaresque orphanware.
* [[NeoTool]] NeoTool is a bash script for your desktop system to provide a friendly GUI frontend to some common management tasks.
* [[NeoCon]] - neocon is a handy serial console utility (not only) for u-boot. The main feature of neocon is actually that you can give it a list of devices and it will pick one that works.
* [http://techiem2.net/index.php?/archives/10-Freerunner-USB-Mode-Control-Program.html usbmode]-a quick pygtk program.
* [[Enotes]] - Enotes is the implementation of a TODOlist manager written with elementary to appear better with distribution that use illume, like SHR.
* [[LED clock]] - When an Openmoko is sitting unused at night, turn it into an alarm clock with large 7-segment digits on a black background in landscape mode.
* [[MokoGeocaching]] - Utility for add a POI to TangoGPS using geocaching.com
* [[Wrench]] - Modual used utility enlightenment_remote.
* [[Yaouh!]] - Yet Another OSM Updater H.
* [[ShortOm]] - Graphical launcher for shell or application, with editable config file, and log result page.
* [[Pimlico]]-Pimlico is a suite of lightweight Personal Information Management (PIM) applications designed primarily for handheld and mobile devices
* [http://projects.openmoko.org/projects/otp4neo/ OTP4Neo] One time password generator
* [http://projects.openmoko.org/projects/ffalarms/ FFAlarm] is a program to set multiple alarms a day using a finger friendly user interface
* [[OpenWrt]]-basic support for the Openmoko "Freerunner"! Kernel (2.6.28) is building and booting.
* [[Enscribi]]-a handwriting recognition input method for Linux. It's mainly developed for the Openmoko Freerunner smartphone.
* [[GridPad]]-GridPad is an alternative input method for entering text with your finger, a Simple Character Recognizer Software.
* [[sortdesk]] sort your om-desktop in categories
* [[Mokometeo]] is a widget which fetches the weather forecast from yahoo, for a list of cities
* {{opkg.org|176|CoovaChilli}} - It turns your phone's WiFi network into an Ad-Hoc Hotspot!
* [http://openmoko.huber-computer.de/ DWDWetter] Fetches weather information from dwd (First Register at dwd!)
* [[QSuunto-Lite]] display dive log information from Suunto Dive computers (that work with divetools-ab)
* [[Literki]] - alternative keyboard

==Setting Application==
* [[Wmiconfig]]- wmiconfig is a tool written by Atheros Communications Inc to configure the Ar6k WIFI chip used in the Neo Freerunner. This is a standalone C executable, released under GPL v2.
* [[GTA02 sysfs]]- sysfs is a filesystem that is mounted on /sys which contains various fake "files" that are actually filled by a variety of drivers and other kernel subsystems. You can use it to change settings and behaviours of the kernel and drivers dynamically.

== Video ==

* [[Video Player]] - Using Mplayer on Openmoko smartphones.
* [http://katastrophos.net/andre/blog/software/quasar-media-player/ Quasar] - a mplayer frontend for X11.

----

== daemon ==
* [[PyPhonelog]] - daemon uses the framework to track and log all the calls made to and from the moko.
* [[Lscd]] - LSC library/daemon on Linux System.

== An automatic list of application-related wiki pages ==

The pages linked above are all maintained manually. We also maintain an automatic categorization system by tagging wiki pages. Here is the list of application-related pages in this wiki. Normally, every page listed below should be also listed above in the same category. The converse is false: there are applications without a wiki page.

<div style="border: solid 1px black; padding: 1ex"><b>Applications in this Wiki:</b>
<categorytree mode=pages depth=2 hideroot=on>Applications</categorytree>
</div>

== Where to find more applications? ==

At [http://opkg.org opkg.org] !

Not all Openmoko apps are listed on this wiki - there are much more [http://projects.openmoko.org/softwaremap/ projects at the Openmoko GForge] than the wiki can list, not to mention self-hosted applications on their own websites. Actually the phones can run most Linux based Free Software, using for example the [[Debian]] distribution. The [http://handhelds.freshmeat.net/browse/1038/ mobile phones section of Freshmeat] may be a interesting place to look.

Note also that there are many packages in the repository that are not installed by default. If what you want is a classic, chances are that it is already packaged. Suppose you want to install Perl:
opkg list|grep perl
opkg install perl

More application download related pages:

* [[Community Repository]]
* [[Users Repositories]]

<div style="clear:both"> </div>

== Where to find full distributions ? ==

* [[Download]]: for complete system downloads

== The usual warnings ==
<small>
* Some of these software are developed by Openmoko Inc. and some are contributed by the community. Any problems with community contributed software should be reported to the individual software developer rather than the Openmoko core team.
* Most programs listed here are not mature/stable, but only useable/beta.
* Many programs listed here are not yet packaged for your distribution and integrated in its repositories. Whichever it is.
* Installing experimental software from the internet is certain to break things. Running it as root is a very insecure thing to do. Kown that you will be burned, have backups, and be ready to apologize to everybody in your phone contact list in case they receive strange SMSs...
</small>

See also [[Hall of Fame]]

[[Category:Applications| ]]
[[Category:Basic End User]]

Applications

2009-09-11T10:01:39Z

Myfanwy: /* email */

{{Languages|Applications}}
This is the wiki's master application list for the Openmoko smartphones.

== How to register new applications ?==

This list can not be exhaustive, as new things are showing up every week. This page is here to help spreading awareness about applications. Here are instructions on how to add a specific application to this list. There are many ways to go

Method 1 (preferred):
* Register your application at http://opkg.org. You will get a package number there, for example 33.
* Notify the community mailing list.
* Come back here, click on "edit" next to the appropriate section title, then add a line like:
<pre>* {{opkg.org|33|Application name}} A short description</pre>

Method 2: Just link to wherever the application is hosted.
* Click on "edit" next to the appropriate section title, add a line like:
<pre>* [http://your.host.domain/the/path/to/app/page.html Application name] A short description</pre>

Method 3: Create a new page in this wiki.
* Click on "edit" next to the appropriate section title, then add a line like:
<pre>* [[Application name]] A short description</pre>
* The application name will appear in red, click on it to create and edit the new page.

== Audio ==

* [http://www.faltantornillos.net/proyectos/gnu/brightPlayer/brightPlayerGTK0.2.tar.gz Bright Player] - Fast, lightweight and easy random music player.
* [[Dictator]] - Record mic, incoming GSM-sound, or a whole Phonecall
* {{opkg.org|55|ePiano}} - epiano is going to be a virtual piano
* [[Fingertier]] - minimal and finger friendly music player
* [[Fourier]]- Realtime frequency analysis of sound data.
* [[Guitartune]] - Tune musical Instruments.
* [[GTick]] - GTick is a metronome application written for GNU/Linux
* [[Intone]] - Elementary based mplayer frontend (for audio files).
* [[Mokoko]]- Play music.
* {{opkg.org|151|MokoPod}} - Retrieve and listen to podcasts
* [[Neoqplayer]] - Renamed as GorshPlayer: a multimedia player written in Qt4: play and retreive podcasts feeds, more reactive interface, now able to play videos ( in svn ).
* [http://fisoft.eu/standa/openmoko/omshuffle_0.1_arm.ipk omShuffle] - Inspired by Bright Player with volume control. Needs mplayer to work.
* [[Openmoko-mediaplayer2]] - Play music and video (mp3...)
* [[Openmokast]] - Play audio stream and slideshow stream
* [[Pythm]] - Audio player GUI using mplayer and mpd as backend.
* [[PyRok]] - Audio player which uses Gstreamer for playback and Pygame for GUI.
* [[Satan]] - Create your own music!
* [[Streamtuner]] - Listen to Internet Radio Stations
* [[Streamripper]] - Record from Internet Radio Stations
* [[Voicenote]] - Voicenote is a script which allows to record any sound from the microphone into a wav file. It can play the created files too. It is intended to be an easy and quick way to do so.
* [http://rzr.online.fr/q/esd boxar] - Touchscreen as a finger friendly piano -- [[User:RzR]]
* {{opkg.org|271|JaMoko}} Jamoko is a Jamendo player for OpenMoko.
----

== BlueTooth ==
* [[Coypu]] - Utility for send file via BlueTooth
----

== Games ==

* [[Games/Om 2007.2]] - Many small games on Om 2007.2
* [[Om 2008.8 Sudoku]] - Number placement based puzzle game
* [[Moko-sudoku]] - Another sudoku puzzle game.
* {{opkg.org|60|ScummVM}} ([[Scummvm|Wiki]]) Virtual Machine for several classic graphical point-and-click adventure games
* [[Kobodeluxe]] - A top-view space shooter, available from 2008.8 repositories.
* [[Pingus]] - Pingus is a lemmings clone with penguins.
* [[Duke Nukem 3D]] - Legendary First Person Shooter.
* [[Numptyphysics]] - A drawing puzzle game.
* [[Gnuboy]] - An emulator for the handheld gaming all-time bestseller.
* [[XBill]] - Little action game to stop Bill from installing Windows(tm) on computers.
* [[Xlogical]]-A puzzle based game where you turn spinners to move balls around.
* [[Liquid War]]-Liquid War is a truly original multiplayer wargame.
* [http://unsyncopated.com/BrainSolvent/Doom%20Port DOOM]- Classic FPS. Freerunner/1973
* [[MBAC]]- MBAC is "Moko Bulls and Cows", a classic game for openmoko written in pygtk similar to mastermind.
* [[OpenVibe]] - The first opensource vibrator.
* [[OpenTTD]] - OpenTransportTycoonDeluxe, ported to openmoko, using only GPLed datafiles.
* [http://scalde.free.fr/index.php?option=com_content&view=article&id=93:pong-pogresses&catid=43:openmoko&Itemid=66 Pong progresses]- This is a little pong game for the openmoko freerunner. The screen is devided in halves, so you can touch the right half to move the paddle right and the left half to move it left.
* [[OpenMooCow]] - OpenMooCow reads information out of your accelerometers. Now, if you turn the phone upside down and back again, it "moos" like one of the little toys.
* [[Freerunner LightSaber]]-Application as iphone LightSaber.
* [[CellHunter]] - A game you earn points by collecting cells (in english now).
* [[XSkat]] - XSkat lets you play the card game Skat defined by the official Skat Order.
* {{opkg.org|136|OpenMiaoCat}} OpenMiaoCat, like OpenMooCow, makes your phone became a cat!
* {{opkg.org|149|I'm Rich}} I'm Rich application
* {{opkg.org|121|Mokomaze}} Ball-in-the-labyrinth game
* [[Acceleroids]] Shoot-the-asteroids game
* {{opkg.org|169|Black Sheep}} Fight insomnia!
----

== GPS ==
* {{opkg.org|268|Advanced Geocaching Tool for Linux}} - "Towards paperless geocaching" - [[Advanced Geocaching Tool for Linux|User Manual]]
* [[SGTL|Simple Geocaching Tool for Linux]] - A geocaching application which shows you the direction.
* [[GPS Sight]] - Display GPS information, location, tracks, etc, without maps.
* [[Gpsdrive]] - Car (bike, etc) navigation system
* [[Om 2008.8 Locations]] - (aka Splinter) - Location sharing based on GPS and SMS
* [[Navit]] - Car navigation system with routing engine
* [[TangoGPS]] - Display map (OSM..), record GPS tracks...
* [[Pyroute]] - Pyroute is a routing program written in Python. It features mobile phone GUI for maps, GPS, and routing.
* [http://www.mumpot.org/ mumpot] - Display map (OSM), routing, OSM editing, a bit of live editing
* [[QMapControl]] - Display maps (OSM..) and add points, lines...
* [[Qpegps]] - Display map with current position
* [[Idle Hands]] - Give a task to you based on your location
* [[Gtkaddpoi]] - Utility for add a POI to TangoGPS using address or coordinates and export to Navit or to .kml file.
* [[Gpsdcontrol]]-A simple python script for start or stop gpsd daemon with a button on the desktop.
* [[OpenBmap]]-a free and open map of wireless communicating objects (e.g. cellular antenna, Wi-Fi, Bluetooth). It provides tools to mutualize data, create and access this map.
* {{opkg.org|162|gvSIG Mobile}} - This is an unofficial port of gvSIG Mobile (http://www.gvsig.gva.es/) to the Openmoko platform. gvSIG Mobile for Openmoko is currently a GPS-enabled projection-aware map viewer. [http://gvsigmobileonopenmoko.wordpress.com/ Homepage].
* {{opkg.org|175|BikeAtor}} - Like TangoGPS BikeAtor can display OSM Maps. The Speedometer displays the most interesting values of the trip.
* {{opkg.org|178|bicirutas}} - This application looks for mtb routes in www.bicirutas.net (routes in Spain, Portugal, United Kingdom, France, Italy and Germany). It gets the current position from the gps system and downloads nearby routes. Then you can follow them with tangogps application.
* [http://code.google.com/p/omgps omgps] - High performance, UBX binary or ogpsd as GPS data provider, layered maps, AGPS online, track replay, scratch on map, ruler and lat/lon grid, basic sounding. etc.
* [[Travel Diary]] - a simple application to save little diary entries to a csv file and send this to a server (that can generate a .kml file or show a map or do whatever...)
* [[QNavitCtl]] - send coordinates to Navit via dbus (position, destination, map center)
* [[a-gps GUI]] - uses cellhunter data to locate you, then uses u-blox a-gps to initialize your GPS chip
* [[sms-sentry]] - locate a lost or stolen phone
* [[bicirutas]] - download bicycle routes

== Graphics ==

* [[Orrery]] - Displays the night sky
* [[OMView]] - Image viewer
* [[PyPenNotes]] - Write notes using pen and touchscreen
* [[Gpe-scap]] - Take screenshots
* [[Flash|Gnash]]-Play flash file on Neo
* [[Neon]] - Image viewer

----

== Internet ==
===web browsers===
* [[Midori]] - Webkit based web browser
* [[Minimo]] - Mozilla based web browser
* [http://www.dillo.org/ Dillo] - Multiplatform fast and small web browser ([http://misc.andi.de1.cc/dillo/ .ipk]).
* [http://code.google.com/p/pyqt-browser/ pyqt-browser] - modified the sample code from python-pyqt4 and changed it to use webkit for web browsing.
* [http://www.netsurf-browser.org/ netsurf]-A new browser for Neo FreeRunner.
* [[Openmoko-browser2]] - The original Openmoko web browser

===VOIP===
* [[Twinkle]] - Voice over IP
* [[Linphone]] - Voice over IP

===email clients===
* [[Openmoko Mail]] - E-mail client
* [http://www.claws-mail.org/ claws-mail] email client available in shr-unstable
* [[Qtmail]] - Default mail program on Om 2008.8

===Offline wikipedia===
* [[Mokopedia]] - Read small Wikipedia dumps offline
* [[Offline Wikipedia reader]] - store the entire content of wikipedia (single-language, excluding images), on a single 8GB microSD card

===IM===
* [[Pidgin]] - Instant messaging client (ICQ, MSN, Jabber, Yahoo and more.)
* [[CenterIM]] - Instant messaging client (terminal-based).

===other===
* [[Openmokast]] - Play audio stream and slideshow stream
* [[PyFeedRead]] - RSS feed reader
* [[TwitterMoko]] - A Twitter client for Openmoko
* [http://we.trekbeyond.org/~kd8ikt/moko/shr_pkgz/ ettercap-ng] DEAD LINK
* {{opkg.org|205|GPRSModem}} - Converts your neo in a GPRS modem.

== Office ==
* dates - a simple calendar
* [[e-tasks]] - An elementary task manager
* [[Epdfview]] - PDF reader.
* Evince - Document reader for PDF, PS, DJVU and more.
* [[FBReader]] - E-book reader program (TXT, FB2, HTML and more)
* [[GPE contacts]]
* [[Gutenflash]] - Fast text reader by scrolling text
* [[OMoney]] - A bookkeeping application
* {{opkg.org|191|PISI}} - PISI is synchronizing (PIM) information

== Settings ==

* [[Mofi]] - Wifi setup tool
* [[Mokonnect]] - Connection manager
* [[Lint-wifi]] - Wifi setup tool
* [[KnjMokoWifi]] - Wifi setup tool
* [[KnjMokoOPKG]] - A graphical frontend to OPKG.
* [[Om 2008.8 Installer]] - Graphical software installer
* [[Opkg]] - Command line software installer
* [[Sephora]] - Settings manager
* [[SettingsGUI]] - Edit various settings
* [[Wicd]] - Wifi setup tool
* [[ZOMG!]] - A graphical package manager (opkg frontend -> should work on any distro)
* [[Timezone|tzdata]]- Customise your time zone setting.
* [[momtools]] - an application to control Wifi, gprs and some other stuff
* [[Wlan]] - Wlan is an application to manage wireless connection on the Freerunner

== System ==
* [[Aphasia]] - A system built on Erlang and a vertical application for people with apahasia.
* [http://www.pierrox.net/auimd/ AUIMD] - AUIMD is a PyQt graphical user interface for mobile devices.
* [[Auxlaunch]] - Finger-friendly app launcher and window switcher
* [[Display Locker]] - Screen lock
* [[Gwaterpas]] - levelling tool using accelerometer
* [[Gestures]] - Detect movement and display information, rotate screen
* [[Keychain]] - SSH keys
* [[MokoFEM]] - Monitors GSM information
* [[Mokostat]] - Monitors battery
* [[Openmoko Bluetooth remote controller|ReMoko]] - Control stuff via BlueTooth
* [[Rotate]] - Rotate screen when phone is rotated
* [[Vala-terminal]] - Command prompt with tabs
* [[Ts calibrate]] - Calibrates touchscreen
* [[Zedlock]] - Screen locker
* [http://fso-control.projects.openmoko.org/ fso-control] - Popup Power menu to shutdown/suspend/reboot.
* [[omkeys_functions]] - Remap AUX key bindings
* [[Siglaunchd]] - A daemon that listens to dbus signals and launches appliactions upon arrival.
* [[Pexpect]]-a pure Python module for spawning child applications; controlling them; and responding to expected patterns in their output.
* {{opkg.org|253|libaxel}} - Library for easy use accelerometer.
----

== Telephony ==
* [[Dialer/2007.2]] - The dialer application in Om 2007.2
* [[Openmoko SMS Middleware]]- SMS middleware is a Openmoko middleware software for additional features related to SMS. Plugin architecture and Python based code gives this project lots of flexibility and enchancebility.
* [[Paroli]] -Paroli is an integrated phone application based on Tichy (and so also written in python).
* [[Litephone]] Easy to use, single window phone application written in Qt.
----

== Utility ==
* [[Unison]] - Unison is a file-synchronization tool for Unix and Windows. It determines all differences between two directory trees and lets the user decide, how to proceed with every differing file.
* [[HP48 Series RPN Calculator]] - Calculator with many functions
* [[qwo]]- An alternative input method.
* {{opkg.org|57|fido}} - [[fido]] is a todo list\note manager written with elementary
* [http://meuk.spritesserver.nl/lightsaber-0.1.tgz The Lightsaber]. Pre-alpha starwaresque orphanware.
* [[NeoTool]] NeoTool is a bash script for your desktop system to provide a friendly GUI frontend to some common management tasks.
* [[NeoCon]] - neocon is a handy serial console utility (not only) for u-boot. The main feature of neocon is actually that you can give it a list of devices and it will pick one that works.
* [http://techiem2.net/index.php?/archives/10-Freerunner-USB-Mode-Control-Program.html usbmode]-a quick pygtk program.
* [[Enotes]] - Enotes is the implementation of a TODOlist manager written with elementary to appear better with distribution that use illume, like SHR.
* [[LED clock]] - When an Openmoko is sitting unused at night, turn it into an alarm clock with large 7-segment digits on a black background in landscape mode.
* [[MokoGeocaching]] - Utility for add a POI to TangoGPS using geocaching.com
* [[Wrench]] - Modual used utility enlightenment_remote.
* [[Yaouh!]] - Yet Another OSM Updater H.
* [[ShortOm]] - Graphical launcher for shell or application, with editable config file, and log result page.
* [[Pimlico]]-Pimlico is a suite of lightweight Personal Information Management (PIM) applications designed primarily for handheld and mobile devices
* [http://projects.openmoko.org/projects/otp4neo/ OTP4Neo] One time password generator
* [http://projects.openmoko.org/projects/ffalarms/ FFAlarm] is a program to set multiple alarms a day using a finger friendly user interface
* [[OpenWrt]]-basic support for the Openmoko "Freerunner"! Kernel (2.6.28) is building and booting.
* [[Enscribi]]-a handwriting recognition input method for Linux. It's mainly developed for the Openmoko Freerunner smartphone.
* [[GridPad]]-GridPad is an alternative input method for entering text with your finger, a Simple Character Recognizer Software.
* [[sortdesk]] sort your om-desktop in categories
* [[Mokometeo]] is a widget which fetches the weather forecast from yahoo, for a list of cities
* {{opkg.org|176|CoovaChilli}} - It turns your phone's WiFi network into an Ad-Hoc Hotspot!
* [http://openmoko.huber-computer.de/ DWDWetter] Fetches weather information from dwd (First Register at dwd!)
* [[QSuunto-Lite]] display dive log information from Suunto Dive computers (that work with divetools-ab)
* [[Literki]] - alternative keyboard

==Setting Application==
* [[Wmiconfig]]- wmiconfig is a tool written by Atheros Communications Inc to configure the Ar6k WIFI chip used in the Neo Freerunner. This is a standalone C executable, released under GPL v2.
* [[GTA02 sysfs]]- sysfs is a filesystem that is mounted on /sys which contains various fake "files" that are actually filled by a variety of drivers and other kernel subsystems. You can use it to change settings and behaviours of the kernel and drivers dynamically.

== Video ==

* [[Video Player]] - Using Mplayer on Openmoko smartphones.
* [http://katastrophos.net/andre/blog/software/quasar-media-player/ Quasar] - a mplayer frontend for X11.

----

== daemon ==
* [[PyPhonelog]] - daemon uses the framework to track and log all the calls made to and from the moko.
* [[Lscd]] - LSC library/daemon on Linux System.

== An automatic list of application-related wiki pages ==

The pages linked above are all maintained manually. We also maintain an automatic categorization system by tagging wiki pages. Here is the list of application-related pages in this wiki. Normally, every page listed below should be also listed above in the same category. The converse is false: there are applications without a wiki page.

<div style="border: solid 1px black; padding: 1ex"><b>Applications in this Wiki:</b>
<categorytree mode=pages depth=2 hideroot=on>Applications</categorytree>
</div>

== Where to find more applications? ==

At [http://opkg.org opkg.org] !

Not all Openmoko apps are listed on this wiki - there are much more [http://projects.openmoko.org/softwaremap/ projects at the Openmoko GForge] than the wiki can list, not to mention self-hosted applications on their own websites. Actually the phones can run most Linux based Free Software, using for example the [[Debian]] distribution. The [http://handhelds.freshmeat.net/browse/1038/ mobile phones section of Freshmeat] may be a interesting place to look.

Note also that there are many packages in the repository that are not installed by default. If what you want is a classic, chances are that it is already packaged. Suppose you want to install Perl:
opkg list|grep perl
opkg install perl

More application download related pages:

* [[Community Repository]]
* [[Users Repositories]]

<div style="clear:both"> </div>

== Where to find full distributions ? ==

* [[Download]]: for complete system downloads

== The usual warnings ==
<small>
* Some of these software are developed by Openmoko Inc. and some are contributed by the community. Any problems with community contributed software should be reported to the individual software developer rather than the Openmoko core team.
* Most programs listed here are not mature/stable, but only useable/beta.
* Many programs listed here are not yet packaged for your distribution and integrated in its repositories. Whichever it is.
* Installing experimental software from the internet is certain to break things. Running it as root is a very insecure thing to do. Kown that you will be burned, have backups, and be ready to apologize to everybody in your phone contact list in case they receive strange SMSs...
</small>

See also [[Hall of Fame]]

[[Category:Applications| ]]
[[Category:Basic End User]]

Applications

2009-09-11T10:01:14Z

Myfanwy: /* Internet */

{{Languages|Applications}}
This is the wiki's master application list for the Openmoko smartphones.

== How to register new applications ?==

This list can not be exhaustive, as new things are showing up every week. This page is here to help spreading awareness about applications. Here are instructions on how to add a specific application to this list. There are many ways to go

Method 1 (preferred):
* Register your application at http://opkg.org. You will get a package number there, for example 33.
* Notify the community mailing list.
* Come back here, click on "edit" next to the appropriate section title, then add a line like:
<pre>* {{opkg.org|33|Application name}} A short description</pre>

Method 2: Just link to wherever the application is hosted.
* Click on "edit" next to the appropriate section title, add a line like:
<pre>* [http://your.host.domain/the/path/to/app/page.html Application name] A short description</pre>

Method 3: Create a new page in this wiki.
* Click on "edit" next to the appropriate section title, then add a line like:
<pre>* [[Application name]] A short description</pre>
* The application name will appear in red, click on it to create and edit the new page.

== Audio ==

* [http://www.faltantornillos.net/proyectos/gnu/brightPlayer/brightPlayerGTK0.2.tar.gz Bright Player] - Fast, lightweight and easy random music player.
* [[Dictator]] - Record mic, incoming GSM-sound, or a whole Phonecall
* {{opkg.org|55|ePiano}} - epiano is going to be a virtual piano
* [[Fingertier]] - minimal and finger friendly music player
* [[Fourier]]- Realtime frequency analysis of sound data.
* [[Guitartune]] - Tune musical Instruments.
* [[GTick]] - GTick is a metronome application written for GNU/Linux
* [[Intone]] - Elementary based mplayer frontend (for audio files).
* [[Mokoko]]- Play music.
* {{opkg.org|151|MokoPod}} - Retrieve and listen to podcasts
* [[Neoqplayer]] - Renamed as GorshPlayer: a multimedia player written in Qt4: play and retreive podcasts feeds, more reactive interface, now able to play videos ( in svn ).
* [http://fisoft.eu/standa/openmoko/omshuffle_0.1_arm.ipk omShuffle] - Inspired by Bright Player with volume control. Needs mplayer to work.
* [[Openmoko-mediaplayer2]] - Play music and video (mp3...)
* [[Openmokast]] - Play audio stream and slideshow stream
* [[Pythm]] - Audio player GUI using mplayer and mpd as backend.
* [[PyRok]] - Audio player which uses Gstreamer for playback and Pygame for GUI.
* [[Satan]] - Create your own music!
* [[Streamtuner]] - Listen to Internet Radio Stations
* [[Streamripper]] - Record from Internet Radio Stations
* [[Voicenote]] - Voicenote is a script which allows to record any sound from the microphone into a wav file. It can play the created files too. It is intended to be an easy and quick way to do so.
* [http://rzr.online.fr/q/esd boxar] - Touchscreen as a finger friendly piano -- [[User:RzR]]
* {{opkg.org|271|JaMoko}} Jamoko is a Jamendo player for OpenMoko.
----

== BlueTooth ==
* [[Coypu]] - Utility for send file via BlueTooth
----

== Games ==

* [[Games/Om 2007.2]] - Many small games on Om 2007.2
* [[Om 2008.8 Sudoku]] - Number placement based puzzle game
* [[Moko-sudoku]] - Another sudoku puzzle game.
* {{opkg.org|60|ScummVM}} ([[Scummvm|Wiki]]) Virtual Machine for several classic graphical point-and-click adventure games
* [[Kobodeluxe]] - A top-view space shooter, available from 2008.8 repositories.
* [[Pingus]] - Pingus is a lemmings clone with penguins.
* [[Duke Nukem 3D]] - Legendary First Person Shooter.
* [[Numptyphysics]] - A drawing puzzle game.
* [[Gnuboy]] - An emulator for the handheld gaming all-time bestseller.
* [[XBill]] - Little action game to stop Bill from installing Windows(tm) on computers.
* [[Xlogical]]-A puzzle based game where you turn spinners to move balls around.
* [[Liquid War]]-Liquid War is a truly original multiplayer wargame.
* [http://unsyncopated.com/BrainSolvent/Doom%20Port DOOM]- Classic FPS. Freerunner/1973
* [[MBAC]]- MBAC is "Moko Bulls and Cows", a classic game for openmoko written in pygtk similar to mastermind.
* [[OpenVibe]] - The first opensource vibrator.
* [[OpenTTD]] - OpenTransportTycoonDeluxe, ported to openmoko, using only GPLed datafiles.
* [http://scalde.free.fr/index.php?option=com_content&view=article&id=93:pong-pogresses&catid=43:openmoko&Itemid=66 Pong progresses]- This is a little pong game for the openmoko freerunner. The screen is devided in halves, so you can touch the right half to move the paddle right and the left half to move it left.
* [[OpenMooCow]] - OpenMooCow reads information out of your accelerometers. Now, if you turn the phone upside down and back again, it "moos" like one of the little toys.
* [[Freerunner LightSaber]]-Application as iphone LightSaber.
* [[CellHunter]] - A game you earn points by collecting cells (in english now).
* [[XSkat]] - XSkat lets you play the card game Skat defined by the official Skat Order.
* {{opkg.org|136|OpenMiaoCat}} OpenMiaoCat, like OpenMooCow, makes your phone became a cat!
* {{opkg.org|149|I'm Rich}} I'm Rich application
* {{opkg.org|121|Mokomaze}} Ball-in-the-labyrinth game
* [[Acceleroids]] Shoot-the-asteroids game
* {{opkg.org|169|Black Sheep}} Fight insomnia!
----

== GPS ==
* {{opkg.org|268|Advanced Geocaching Tool for Linux}} - "Towards paperless geocaching" - [[Advanced Geocaching Tool for Linux|User Manual]]
* [[SGTL|Simple Geocaching Tool for Linux]] - A geocaching application which shows you the direction.
* [[GPS Sight]] - Display GPS information, location, tracks, etc, without maps.
* [[Gpsdrive]] - Car (bike, etc) navigation system
* [[Om 2008.8 Locations]] - (aka Splinter) - Location sharing based on GPS and SMS
* [[Navit]] - Car navigation system with routing engine
* [[TangoGPS]] - Display map (OSM..), record GPS tracks...
* [[Pyroute]] - Pyroute is a routing program written in Python. It features mobile phone GUI for maps, GPS, and routing.
* [http://www.mumpot.org/ mumpot] - Display map (OSM), routing, OSM editing, a bit of live editing
* [[QMapControl]] - Display maps (OSM..) and add points, lines...
* [[Qpegps]] - Display map with current position
* [[Idle Hands]] - Give a task to you based on your location
* [[Gtkaddpoi]] - Utility for add a POI to TangoGPS using address or coordinates and export to Navit or to .kml file.
* [[Gpsdcontrol]]-A simple python script for start or stop gpsd daemon with a button on the desktop.
* [[OpenBmap]]-a free and open map of wireless communicating objects (e.g. cellular antenna, Wi-Fi, Bluetooth). It provides tools to mutualize data, create and access this map.
* {{opkg.org|162|gvSIG Mobile}} - This is an unofficial port of gvSIG Mobile (http://www.gvsig.gva.es/) to the Openmoko platform. gvSIG Mobile for Openmoko is currently a GPS-enabled projection-aware map viewer. [http://gvsigmobileonopenmoko.wordpress.com/ Homepage].
* {{opkg.org|175|BikeAtor}} - Like TangoGPS BikeAtor can display OSM Maps. The Speedometer displays the most interesting values of the trip.
* {{opkg.org|178|bicirutas}} - This application looks for mtb routes in www.bicirutas.net (routes in Spain, Portugal, United Kingdom, France, Italy and Germany). It gets the current position from the gps system and downloads nearby routes. Then you can follow them with tangogps application.
* [http://code.google.com/p/omgps omgps] - High performance, UBX binary or ogpsd as GPS data provider, layered maps, AGPS online, track replay, scratch on map, ruler and lat/lon grid, basic sounding. etc.
* [[Travel Diary]] - a simple application to save little diary entries to a csv file and send this to a server (that can generate a .kml file or show a map or do whatever...)
* [[QNavitCtl]] - send coordinates to Navit via dbus (position, destination, map center)
* [[a-gps GUI]] - uses cellhunter data to locate you, then uses u-blox a-gps to initialize your GPS chip
* [[sms-sentry]] - locate a lost or stolen phone
* [[bicirutas]] - download bicycle routes

== Graphics ==

* [[Orrery]] - Displays the night sky
* [[OMView]] - Image viewer
* [[PyPenNotes]] - Write notes using pen and touchscreen
* [[Gpe-scap]] - Take screenshots
* [[Flash|Gnash]]-Play flash file on Neo
* [[Neon]] - Image viewer

----

== Internet ==
===web browsers===
* [[Midori]] - Webkit based web browser
* [[Minimo]] - Mozilla based web browser
* [http://www.dillo.org/ Dillo] - Multiplatform fast and small web browser ([http://misc.andi.de1.cc/dillo/ .ipk]).
* [http://code.google.com/p/pyqt-browser/ pyqt-browser] - modified the sample code from python-pyqt4 and changed it to use webkit for web browsing.
* [http://www.netsurf-browser.org/ netsurf]-A new browser for Neo FreeRunner.
* [[Openmoko-browser2]] - The original Openmoko web browser

===VOIP===
* [[Twinkle]] - Voice over IP
* [[Linphone]] - Voice over IP

===email===
* [[Openmoko Mail]] - E-mail client
* [http://www.claws-mail.org/ claws-mail] email client available in shr-unstable
* [[Qtmail]] - Default mail program on Om 2008.8

===Offline wikipedia===
* [[Mokopedia]] - Read small Wikipedia dumps offline
* [[Offline Wikipedia reader]] - store the entire content of wikipedia (single-language, excluding images), on a single 8GB microSD card

===IM===
* [[Pidgin]] - Instant messaging client (ICQ, MSN, Jabber, Yahoo and more.)
* [[CenterIM]] - Instant messaging client (terminal-based).

===other===
* [[Openmokast]] - Play audio stream and slideshow stream
* [[PyFeedRead]] - RSS feed reader
* [[TwitterMoko]] - A Twitter client for Openmoko
* [http://we.trekbeyond.org/~kd8ikt/moko/shr_pkgz/ ettercap-ng] DEAD LINK
* {{opkg.org|205|GPRSModem}} - Converts your neo in a GPRS modem.

== Office ==
* dates - a simple calendar
* [[e-tasks]] - An elementary task manager
* [[Epdfview]] - PDF reader.
* Evince - Document reader for PDF, PS, DJVU and more.
* [[FBReader]] - E-book reader program (TXT, FB2, HTML and more)
* [[GPE contacts]]
* [[Gutenflash]] - Fast text reader by scrolling text
* [[OMoney]] - A bookkeeping application
* {{opkg.org|191|PISI}} - PISI is synchronizing (PIM) information

== Settings ==

* [[Mofi]] - Wifi setup tool
* [[Mokonnect]] - Connection manager
* [[Lint-wifi]] - Wifi setup tool
* [[KnjMokoWifi]] - Wifi setup tool
* [[KnjMokoOPKG]] - A graphical frontend to OPKG.
* [[Om 2008.8 Installer]] - Graphical software installer
* [[Opkg]] - Command line software installer
* [[Sephora]] - Settings manager
* [[SettingsGUI]] - Edit various settings
* [[Wicd]] - Wifi setup tool
* [[ZOMG!]] - A graphical package manager (opkg frontend -> should work on any distro)
* [[Timezone|tzdata]]- Customise your time zone setting.
* [[momtools]] - an application to control Wifi, gprs and some other stuff
* [[Wlan]] - Wlan is an application to manage wireless connection on the Freerunner

== System ==
* [[Aphasia]] - A system built on Erlang and a vertical application for people with apahasia.
* [http://www.pierrox.net/auimd/ AUIMD] - AUIMD is a PyQt graphical user interface for mobile devices.
* [[Auxlaunch]] - Finger-friendly app launcher and window switcher
* [[Display Locker]] - Screen lock
* [[Gwaterpas]] - levelling tool using accelerometer
* [[Gestures]] - Detect movement and display information, rotate screen
* [[Keychain]] - SSH keys
* [[MokoFEM]] - Monitors GSM information
* [[Mokostat]] - Monitors battery
* [[Openmoko Bluetooth remote controller|ReMoko]] - Control stuff via BlueTooth
* [[Rotate]] - Rotate screen when phone is rotated
* [[Vala-terminal]] - Command prompt with tabs
* [[Ts calibrate]] - Calibrates touchscreen
* [[Zedlock]] - Screen locker
* [http://fso-control.projects.openmoko.org/ fso-control] - Popup Power menu to shutdown/suspend/reboot.
* [[omkeys_functions]] - Remap AUX key bindings
* [[Siglaunchd]] - A daemon that listens to dbus signals and launches appliactions upon arrival.
* [[Pexpect]]-a pure Python module for spawning child applications; controlling them; and responding to expected patterns in their output.
* {{opkg.org|253|libaxel}} - Library for easy use accelerometer.
----

== Telephony ==
* [[Dialer/2007.2]] - The dialer application in Om 2007.2
* [[Openmoko SMS Middleware]]- SMS middleware is a Openmoko middleware software for additional features related to SMS. Plugin architecture and Python based code gives this project lots of flexibility and enchancebility.
* [[Paroli]] -Paroli is an integrated phone application based on Tichy (and so also written in python).
* [[Litephone]] Easy to use, single window phone application written in Qt.
----

== Utility ==
* [[Unison]] - Unison is a file-synchronization tool for Unix and Windows. It determines all differences between two directory trees and lets the user decide, how to proceed with every differing file.
* [[HP48 Series RPN Calculator]] - Calculator with many functions
* [[qwo]]- An alternative input method.
* {{opkg.org|57|fido}} - [[fido]] is a todo list\note manager written with elementary
* [http://meuk.spritesserver.nl/lightsaber-0.1.tgz The Lightsaber]. Pre-alpha starwaresque orphanware.
* [[NeoTool]] NeoTool is a bash script for your desktop system to provide a friendly GUI frontend to some common management tasks.
* [[NeoCon]] - neocon is a handy serial console utility (not only) for u-boot. The main feature of neocon is actually that you can give it a list of devices and it will pick one that works.
* [http://techiem2.net/index.php?/archives/10-Freerunner-USB-Mode-Control-Program.html usbmode]-a quick pygtk program.
* [[Enotes]] - Enotes is the implementation of a TODOlist manager written with elementary to appear better with distribution that use illume, like SHR.
* [[LED clock]] - When an Openmoko is sitting unused at night, turn it into an alarm clock with large 7-segment digits on a black background in landscape mode.
* [[MokoGeocaching]] - Utility for add a POI to TangoGPS using geocaching.com
* [[Wrench]] - Modual used utility enlightenment_remote.
* [[Yaouh!]] - Yet Another OSM Updater H.
* [[ShortOm]] - Graphical launcher for shell or application, with editable config file, and log result page.
* [[Pimlico]]-Pimlico is a suite of lightweight Personal Information Management (PIM) applications designed primarily for handheld and mobile devices
* [http://projects.openmoko.org/projects/otp4neo/ OTP4Neo] One time password generator
* [http://projects.openmoko.org/projects/ffalarms/ FFAlarm] is a program to set multiple alarms a day using a finger friendly user interface
* [[OpenWrt]]-basic support for the Openmoko "Freerunner"! Kernel (2.6.28) is building and booting.
* [[Enscribi]]-a handwriting recognition input method for Linux. It's mainly developed for the Openmoko Freerunner smartphone.
* [[GridPad]]-GridPad is an alternative input method for entering text with your finger, a Simple Character Recognizer Software.
* [[sortdesk]] sort your om-desktop in categories
* [[Mokometeo]] is a widget which fetches the weather forecast from yahoo, for a list of cities
* {{opkg.org|176|CoovaChilli}} - It turns your phone's WiFi network into an Ad-Hoc Hotspot!
* [http://openmoko.huber-computer.de/ DWDWetter] Fetches weather information from dwd (First Register at dwd!)
* [[QSuunto-Lite]] display dive log information from Suunto Dive computers (that work with divetools-ab)
* [[Literki]] - alternative keyboard

==Setting Application==
* [[Wmiconfig]]- wmiconfig is a tool written by Atheros Communications Inc to configure the Ar6k WIFI chip used in the Neo Freerunner. This is a standalone C executable, released under GPL v2.
* [[GTA02 sysfs]]- sysfs is a filesystem that is mounted on /sys which contains various fake "files" that are actually filled by a variety of drivers and other kernel subsystems. You can use it to change settings and behaviours of the kernel and drivers dynamically.

== Video ==

* [[Video Player]] - Using Mplayer on Openmoko smartphones.
* [http://katastrophos.net/andre/blog/software/quasar-media-player/ Quasar] - a mplayer frontend for X11.

----

== daemon ==
* [[PyPhonelog]] - daemon uses the framework to track and log all the calls made to and from the moko.
* [[Lscd]] - LSC library/daemon on Linux System.

== An automatic list of application-related wiki pages ==

The pages linked above are all maintained manually. We also maintain an automatic categorization system by tagging wiki pages. Here is the list of application-related pages in this wiki. Normally, every page listed below should be also listed above in the same category. The converse is false: there are applications without a wiki page.

<div style="border: solid 1px black; padding: 1ex"><b>Applications in this Wiki:</b>
<categorytree mode=pages depth=2 hideroot=on>Applications</categorytree>
</div>

== Where to find more applications? ==

At [http://opkg.org opkg.org] !

Not all Openmoko apps are listed on this wiki - there are much more [http://projects.openmoko.org/softwaremap/ projects at the Openmoko GForge] than the wiki can list, not to mention self-hosted applications on their own websites. Actually the phones can run most Linux based Free Software, using for example the [[Debian]] distribution. The [http://handhelds.freshmeat.net/browse/1038/ mobile phones section of Freshmeat] may be a interesting place to look.

Note also that there are many packages in the repository that are not installed by default. If what you want is a classic, chances are that it is already packaged. Suppose you want to install Perl:
opkg list|grep perl
opkg install perl

More application download related pages:

* [[Community Repository]]
* [[Users Repositories]]

<div style="clear:both"> </div>

== Where to find full distributions ? ==

* [[Download]]: for complete system downloads

== The usual warnings ==
<small>
* Some of these software are developed by Openmoko Inc. and some are contributed by the community. Any problems with community contributed software should be reported to the individual software developer rather than the Openmoko core team.
* Most programs listed here are not mature/stable, but only useable/beta.
* Many programs listed here are not yet packaged for your distribution and integrated in its repositories. Whichever it is.
* Installing experimental software from the internet is certain to break things. Running it as root is a very insecure thing to do. Kown that you will be burned, have backups, and be ready to apologize to everybody in your phone contact list in case they receive strange SMSs...
</small>

See also [[Hall of Fame]]

[[Category:Applications| ]]
[[Category:Basic End User]]

Debian

2009-09-09T22:55:38Z

Myfanwy: spelling mistake

__NOTOC__
{{Languages|Debian}}

Debian is a ''universal operating system'' used on many other embedded devices, and also on home computers. Using Debian on the FreeRunner gives access to the Huge army of software packaged in the Debian repositories, already compiled for the Neo's arm(v4) processor. Moreover, one can build one's own source files for programs without having to learn the OpenEmbedded way. For example compiling natively is a snap with Debian, just apt-get gcc&libc-dev.

For an existing Debian/Ubuntu user, choosing Debian for Neo FreeRunner makes phone a very familiar place to be in.

'''The bulk of information related to running Debian on FreeRunner is supposed to be at [http://wiki.debian.org/ wiki.debian.org]. For all installation, support or bug reporting needs please see [http://wiki.debian.org/DebianOnFreeRunner DebianOnFreeRunner] in the Debian wiki.'''

''The current method of installation, install.sh, is not fail-proof. Work is progressing on a real debian-installer support.''

== Showcase: Desktop Environments And Applications ==
=== Illume ===
[[Image:Debian_illume_zhone.png|right|thumb|250px|Debian with illume, and Zhone running]]
[[Image:Debian_illume_zhone_kb.png|right|thumb|250px|Debian with illume, and Zhone running, with the on-screen keyboard visible]]
[[Illume]], the desktop environment used in recent openmoko distribution releases, is also available under Debian. It's part of the Enlightenment window manager version 17 (which is currently in the alpha stage of development), which the Debian FSO package maintainers have placed in their repository. If you have a Debian FSO system running, you can use the following commands to install illume.

apt-get install e17

Then use the following commands to ensure that it starts on boot.

apt-get remove zhone-session
apt-get install nodm

mv /root/.xsession /root/.xsession.backup
cat << END > /root/.xsession
#!/bin/sh
zhone &
enlightenment_start
END

<br style="clear:both" />

=== OpenOffice.org ===
[[Image:Freerunner_Debian_runs_openoffice3.jpg|right|thumb|300px|Debian running OpenOffice.org 3]]

Did we already mention you can install ''anything'' in Debian?

<br style="clear:both" />

=== Matchbox With fbpanel ===
It is not really a Desktop environment, but using fbpanel with Matchbox you can have a fast, lightweight, gtk2 desktop panel.
[[Image:Debian_fbpanel_zhone.png|right|thumb|300px|Debian with fbpanel, matchbox-window-manager and Zhone running]]
<ol><li>Install fbpanel:
<pre>sudo apt-get install fbpanel</pre></li>
<li>Customize the X startup process:
<pre>~/.xsession</pre>
<pre>
#!/bin/sh
export GTK_MODULES=libgtkstylus.so
zhone &
xsetroot -solid black
matchbox-keyboard-toggle &
matchbox-window-manager -use_titlebar yes &
# -use_titlebar yes to minimize & toggle between apps
# fbpanel's taskbar does not work with matchbox-window-manager
#~/bin/auxlaunch &
while true;
do
fbpanel;
sleep 1;
done;
</pre></li>

<li>Read http://fbpanel.sourceforge.net/docs.html#config
<pre>~/.fbpanel/default</pre>
<pre>
mkdir ~/.fbpanel
cp /etc/fbpanel/default ~/.fbpanel/default
nano ~/.fbpanel/default
</pre>
Remove section with 'taskbar' plugin - it's useless with matchbox-window-manager. You may add plugin 'cpu'
<pre>Plugin {
type = cpu
}</pre>
Also, plugin 'genmon' is useful:
<pre>Plugin {
type = genmon
config {
Command = echo -e $(grep "MemFree" /proc/meminfo | awk '{printf "%0.2f", $2 / 1024}') "|"\
$(cat /proc/loadavg | awk '{print $3}') "|" $(apm | awk '{print $5}')
PollingTime = 60
TextSize = small
TextColor = darkblue
}
}</pre>
After 'killall fbpanel' it will show: free mem in megabytes | loadavg | battery % left.</li>
<li>Default theme is ugly. You can change it and / or make fonts bigger:
<pre>~/.gtkrc-2.0</pre>
<pre>sudo apt-cache search gtk2-engines
sudo apt-get install gtk2-engines gtk-theme-switch
DISPLAY=:0 gtk-theme-switch2</pre>
Now choose your theme, font and save it. To see changes do 'killall fbpanel'.</li></ol>

In order to use killall, install the psmisc package:
apt-get install psmisc

Some of the icons rely on the hicolor-icon-theme:
apt-get install hicolor-icon-theme

=== LXDE ===

I you want a really nice desktop enviroment but you think XFCE is too fat, you can try to install [http://en.wikipedia.org/wiki/LXDE LXDE]. It give to you the GTK comfort, but use only a fraction of the ram needed by XFCE.
[[Image:Debian_lxde_zhone.png|right|thumb|300px|Debian with lxde and Zhone running]]
To install it:
<pre>apt-get install lxde</pre>

to launch it create a <code>/etc/init.d/lxde</code> script in the same way descripted for xfce4, replacing <code>startxfce4</code> occurrences with <code>startlxde</code>.
<div style="clear:right;"> </div>

=== XFCE ===
The debian installation script installs by default the matchbox window manager. It doesn't feature a desktop environment. '''xfce''' is a small and lightweight desktop environment and so is quite fast for the FreeRunner.

<pre>apt-get install xfce4</pre>

Edit your .xsession to launch xfce4 at X startup :

<pre>#!/bin/sh
xfce4-session</pre>

Edit section [Failsafe Session] of /etc/xdg/xfce4-session/xfce4-session.rc (or ~/.config/xfce4-session/xfce4-session.rc) to handle the auto-started apps. For example:
<pre>[Failsafe Session]
Count=3
Client0_Command=xfce4-panel
Client0_PerScreen=False
Client1_Command=xfdesktop
Client1_PerScreen=False
Client2_Command=zhone
Client2_PerScreen=True</pre>
Start XFCE !

<pre>/etc/init.d/nodm restart</pre>

The desktop takes a while to start but once up was snappy as can be expected.
I've not yet looked at the reason for the seemingly too slow start for the desktop.

zhone is available from the "Office" menu in xfce.
The matchbox keyboard is available in "Accessories".

If you want to display the screen on the long side (ie rotated, 4:3 aspect), add the following to the /etc/X11/xorg.conf in both the Device and InputDevice sections :

<pre>Option "Rotate" "CCW"</pre>

and then (re)start xfce.

If you want to be able to shutdown/restart the device, add the following line to ''/etc/sudoers'' (don't forget to replace ''username'' with your actual username):
<pre>username localhost = NOPASSWD: /usr/sbin/xfsm-shutdown-helper</pre>

==== Using matchbox-window-manager with XFCE ====

XFCE's window manager is poorly configured for use with the FreeRunner. Fortunately, matchbox's window manager is compatible with xfce. To use the matchbox window manager, modify ~/.xsession as follows:

<pre>#!/bin/sh
exec matchbox-window-manager -use_titlebar no -use_cursor no &
xfce4-session</pre>

== Derivative Distributions of Debian ==

Several distributions are sharing Debian's infrastructure - this is long known. For the Openmoko,
* [[Fyp]] extends the basic Debian installation while avoiding the need of an SD
* [[Hackable1]] focuses on GNOME Mobile integration
* [[Mer]] : based on [[Maemo]] ; see demo and download image at http://digg.com/linux_unix/mer_merge_of_maemo_debian_ubuntu_on_freerunner_mobile_ddl

[[Category:Debian| ]]

Opkg

2009-07-25T14:33:48Z

Myfanwy: /* FAQ */

{{Languages|Opkg}}

== About Opkg ==

Opkg is a lightweight [[package management]] system based on [[Ipkg]].

Mid December, 2008, the project moved to Google code: http://code.google.com/p/opkg/
* Group: http://groups.google.com/group/opkg-devel
* mailto: opkg-devel at googlegroups.com <opkg-devel at googlegroups.com>
* Checkout Code: http://code.google.com/p/opkg/source/checkout

Prior to that date, a mailing list for discussion was available here: http://lists.openmoko.org/mailman/listinfo/opkg-devel
Source code was available in the subversion repository: http://svn.openmoko.org/trunk/src/target/opkg/. The repository could also be [http://svnweb.openmoko.org/trunk/src/target/opkg/ viewed online].

You can learn how to create own [http://handhelds.org/moin/moin.cgi/BuildingIpkgs Opkg packages] on the Ipkg site.

Packages should install .desktops at the very end of the installation process. This ensures that the icons referenced in the .desktop file are available. [https://docs.openmoko.org/trac/ticket/1524 Reference]

== New Features ==

This is a list of features that have been completed. Mostly this is a list of changes from Ipkg.

* Use libcurl to download files
* Send download progress updates to libopkg clients
* Re-organize and clean up source code into sub directories
* Verify package lists with gpg detached signature
* Mark packages that were installed to satisfy dependencies (auto installed)
* Additional command line option to remove "auto installed" packages
* Support for faceted classification (similar to debtags). ''A "Tags" line has been added to the package information and opkg makes this available to clients, but does not process it in anyway. The command line client also does not use this features yet.''

=== Ipkg Patches ===

The following ipkg patches have been applied:

* "2-pkg-vec--Optimize-gross-inefficiency.patch" from OpenEmbedded
* "1-pkg-parse--Optimize-inefficient-parsing.patch" from OpenEmbedded

* [http://svn.o-hand.com/view/poky/trunk/meta/packages/ipkg/files/update_version_comparision.patch?rev=3827&view=auto update_version_comparision.patch] from Richard Purdie
* [http://svn.o-hand.com/view/poky/trunk/meta/packages/ipkg/files/enable_debversion.patch?rev=3827&view=auto enable_debversion.patch] from Richard Purdie

== Planned features ==

These are features either under development or planned for inclusion before the next release.

* improve/cleanup [[libopkg]] api
* locking system to prevent two simultaneous operations on the file system

=== Bug fixes ===

* Ipkg bug - Overflowing / crashes machine - [http://bugs.openembedded.net/show_bug.cgi?id=1028]
* ipkg tries to access ro SD card - [http://bugs.openembedded.net/show_bug.cgi?id=1029]

=== Lower priority features ===

* Simple user interactions during postinstall
* Improve command line options
* Restructure source code and make it more robust
* Store packages in database
* Check available space in /tmp prior to downloading
* Check available space in dest prior to unpacking

== Possible Issues ==

This is a list of possible issues or known bugs.

* http proxy works but authentication not tested yet (--[[User:cberger|cberger]] tested version 0.1.4, does not recognize proxy_username and proxy_password for authentication)
* autoremove feature only inspects "depends" and not "pre-depends"
* if you encounter fork failures, and/or segmentation fault, you probably need more memory. To do so, add temporarily swap by:
** Creating a file which will be used for swap:
***If you are using dd from coreutils:
dd if=/dev/zero of=/media/card/file.swap bs=1M count=512
***If you are using dd from busybox (Interrupt the process (ctrl+c) once the file is big enough. 128 MB should be enough):
dd if=/dev/zero of=/media/card/file.swap
**Turn the file into a swap
mkswap /media/card/file.swap
**Activate the swap through the file (until swapoff command is used, or reboot)
swapon /media/card/file.swap
**Upgrade
opkg upgrade
**Deactivate swap
swapoff or reboot

Next time you will simply need to reactivate the swap before upgrading.

== Error Codes ==

It looks like, in some cases, Opkg will return an error code if something goes wrong. Here's a list that I pulled from the error.h file:

* -1: Unknown Error
* 0: No Error (Success)

Configuration Errors:
* 1: Could not set default destination
* 2: Error parsing config file
* 3: Could not create temporary directory
* 4: Could not obtain administrative lock
** This could be cause by assassin not releasing the lock on the package management. It can be released by killing its manager:
killall packagekitd

Package Errors
* 5: Unsatisfied Dependencies
* 6: Is Essential
* 7: Has Dependents
* 8: Has No Candidate
* 9: PackageHas No Available Architecture

Install Errors
* 10: Not Trusted
* 11: Download Error
* 12: Conflicts
* 13: Already Installed
* 14: Dependencies
* 15: No Downgrade
* 16: Out Of Space
* 17: Bad Signature
* 18: MD5 Error
* 19: Internal Error

{{note|I had a problem where I was trying to manually install a package that had dependencies. The dependencies had a bad signature (actually, my signature files were bad). Instead of returning 17 because of the bad signature, it returned 14 because of a dependency problem. So if you get a 14, try installing that package by itself and see what you get. --[[User:Jtickle|Jtickle]] 18:16, 23 July 2008 (EST) }}

== FAQ ==

Q. What version of Ipkg is Opkg based on?

A. It is based on the [http://www.handhelds.org/download/packages/ipkg/ipkg-0.99.163.tar.gz ipkg-0.99.163] tarball

Q. Why "fork" and rename Ipkg?

A. Ipkg is no longer actively maintained upstream and there are potential trademark issues with using the Ipkg name

Q. Does opkg have a feature similar to APT pinning?

A. Yes you can define priorities on the architecture field (the second field in a feed definition) in /etc/opkg/arch.conf

Q. Does opkg have an auto completion system ?

A. Yes, it's a contribution script available at the [http://blog.upme.fr/?/Linux/28-Openmoko-Opkg-Autocompletion-With-Packages-Names upme blog]

Q. How similar is the ipk format, to the deb format? They look very similar; the data and control tar balls are identical as far as i can tell.

A. Very similar. ipk files are basically deb files with documentation removed, and ipkg is even supposedly able to handle deb files. Opkg can install .deb packages directly, with no change. There may be issues with some packages, concerning preinst and postinst scripts

{{Languages|Opkg}}

[[Category:Package management]]

Distributions

2009-07-09T08:35:13Z

Myfanwy: /* Applications */

{{Languages|Distributions}}

{|align=left
|__TOC__
|}

== About distributions ==
Openmoko distributions are designed to run on various mobile devices, with the primary aim of supporting Openmoko Inc.'s [[GTA01:Neo 1973|Neo 1973]] and [[Neo FreeRunner]] phones. They are GNU/Linux distributions -- complete operating systems including user applications. You can install any of them on your phone or even have a dualboot system with two distributions installed. For downloads see [[Download]], for installation instructions see [[Flashing the Neo FreeRunner]].

Besides, Openmoko distributions also run on [[Supported devices|other]] mobile devices and some other software distributions also run on the phones of Openmoko Inc.

=== Choosing a distribution ===
Currently the most used distributions are [[Om 2008]], which comes preinstalled on the Neo FreeRunner, and [[Stable Hybrid Release|SHR]].[http://spreadsheets.google.com/pub?key=p2ZQdcRSVg9XfYLwBVsZicg]

In the future [[Om 2009]] will be the default distribution. It is currently under development and should be released in june 2009. Like SHR it will be based on the [[freesmartphone.org]] framework.

Furthermore, there are many other distributions, like [[Qt Extended]] (for stable basic functions), Google's [[Android]], and some [[Debian]]-based distros.

{| class="wikitable" style="float:right;width:200px;background-color:#FF6600;text-align:center;border-collapse:collapse;font-weight:bold"
|<font color=white>Distributions</font>
|-
! style='background-color:#333333;color:#FFFFFF'|
<div align=left>
* <font color='#BBBBBB'>Openmoko (official)</font>
** [[Om 2009]]
** [[Om 2008]]
** [[Om 2007.2]]
* <font color='#BBBBBB'>Om Community</font>
** [[SHR]]
** [[FDOM]]
* <font color='#BBBBBB'>Other</font>
** [[Qt Extended Improved]]
** [[Debian]]
** [[Gentoo]]
** [[Android]]
** [[Hackable:1]]
** [[neovento]]
** [[Mer]]
</div>
|-
|}

=== Please note ===

* Stable in the FreeRunner world does not mean the same thing as stable in the Debian world.
* Most distributions use the same bootloader, kernel, drivers and hardware. Therefore, the same low level bugs are commonly found in all distributions. The latest and greatest software usually has most bug fixes, plus a whole set of new fresh bugs.
* Most of these distributions also have package repositories. It is a BAD idea to feed from another distribution's repository.
* Upgrade path between these distributions are mostly not tested, thus updating by changing the feeds will most likely end in broken packages or even an unbootable system. It is advisable to reflash the whole filesystem with [[dfu-util]] to switch between the different distributions, with the reminder that a dual-boot setup (e.g. via sdcard or NFS) can be used.

== Official Openmoko releases ==

'Release targets' offered by Openmoko Inc. are built out of different branches of the [[OpenEmbedded]] metadistribution source tree.

=== Om series ===

* '''[[Om 2009]]''' is intended to be the new distro; it is not a simple follow-on from [[Om 2008]]. It is based on the [http://freesmartphone.org freesmartphone.org] milestone 5.5 framework.

{{Main|Om2009}}

* '''[[Om 2008]]''' was released on August 8, 2008, to replace 2007.2. Prior to that, its codename was ASU (April/August Software Update). This is still the name of the branch in the version control system. This distribution integrates the [http://trolltech.com/products/qtopia Qtopia] phone stack with a set of new Openmoko applications based on the Enlightenment Foundation Libraries ([[EFL_Documentation|EFL]]). Qtopia being a more mature product than the GNOME Mobile stack, the standard phone applications (dialer, contacts, calculator, calendar) work better than in 2007.2. The Qtopia used in 2008.8 was ported to run on X11, contrary to standard Qtopia which uses the framebuffer. This allows non-Qt applications to safely share the screen with Qt applications.

{{Main|Om 2008}}

* '''[[Om 2007.2]]''' was the first distribution created by Openmoko. The interface was totally finger-oriented, optimized for 285ppi, and very orange. It used the GTK+ stack, which is part of the [http://www.gnome.org/mobile/ GNOME Mobile] platform. This distribution is now considered obsolete and not being worked on by Openmoko Inc or by OpenedHand.

{{Main|Om 2007.2}}

== Openmoko community releases ==

=== SHR ===

SHR is a community driven distribution. It contains some basic EFL based applications which make use of the FSO. There currently is an [[EFL_Documentation|EFL]] (with elementary) dialer, messages and contacts application programmed in C, as well as a nice Settings-GUI in Python. As of April 12th, 2009, there is no stable release of this distribution yet, as the SHR team doesn't feel it to be good enough. You can find images though on the [http://shr.bearstech.com/shr-testing SHR buildhost].

{{Main|SHR}}

=== FDOM (FAT and Dirty Openmoko) ===

[[FDOM]] is a distribution based on Openmoko's currently supported image, updated with many ready-to-use applications and with fixes posted in the mailing lists. A combination of applications (everything goes) and fixes to demonstrate the capabilities of the Freerunner and to have a functional phone (sort of). This all while retaining the ability to update through the official feeds.

{{Main|FDOM}}

=== Non-Openmoko distributions ===

These are not Openmoko (and OE) based distributions. These are alternatives you can run on your Openmoko phones.

==== Qt Extended Improved ====
Qt Extended has had several names. The current name is <b>Qt Extended Improved</b>. An Openmoko-based community develops Qt Extended Improved as a Free Software project. Qt Extended Improved builds on the foundation of Qt Extended/Qtopia/Qt by Qt Software/Trolltech. Qt Extended Improved provides a robust telephony stack, a webkit based browser and other smartphone features.

On 5th March 2009 Qt Software released Qt Extended 4.4.3. On 3rd March 2009 Qt Software announced that Qt Extended 4.4.3 would be the last release of the Qt Extended product. Prior to version 4.3, Qt Extended was known as Qtopia.

{{Main|Qt Extended Improved}}

==== Debian ====
Debian is "the universal operating system". It comes with thousands and thousands of packages (most of them designed for desktops or servers so far). So in the words of Joachim "nomeata" Breitner from the [http://wiki.debian.org/Teams/DebianFSO pkg-fso] team, this is not really a distribution in the Openmoko sense of the word, but rather a different underlying system for Openmoko distributions. At the moment, we ship the software from the FSO stack, but hopefully we’ll also have, for example, the SHR software in our archive. So for now, Debian is a different way of installing FSO, which takes more space and provides more programs :-)

{{Main|Debian}}

==== [[Gentoo ]]====
Gentoo is all about choices. When installing Gentoo, this is made clear to you several times -- you can choose how much you want to compile yourself, how to install Gentoo, what system logger you want, etc. Gentoo is a fast, modern metadistribution with a clean and flexible design. Gentoo is built around free software and doesn't hide from its users what is beneath the hood. Portage, the package maintenance system which Gentoo uses, is written in Python, meaning you can easily view and modify the source code. Gentoo's packaging system uses source code (although support for precompiled packages is included too) and configuring Gentoo happens through regular textfiles. In other words, openness everywhere.

{{Main|Gentoo}}

==== Android ====
[http://code.google.com/android/ Android] is a software stack for mobile devices developed by the [http://www.openhandsetalliance.com/ The Open Handset Alliance.] Openmoko is fully supporting Android running on the Freerunner.

Android has now reached a point where it is usable on the FreeRunner as an everyday phone, there are, however, still some caveats. Check out the main Android section of the wiki for more info.

{{Main|Android}}You can also visit the user web page for [http://wiki.openmoko.org/wiki/User:Seanmcneil3 Sean McNeil] for some more info.

====Slackware====
As of release 12.2, Slackware is now officially supported on the Neo Freerunner
[http://armedslack.org/]
--[[User:Djdas|djdas]] 15:54, 13 June 2009 (UTC)There aren't any confirmations of ArmedSlack running on Freerunner either on the website or the official ML, do you have any link pointing on that?

==== Hackable:1====
Hackable1 is a community distribution for hackable devices like the Neo Freerunner. It is based on Debian and 2007.2 userland which has been abandoned by Openmoko. It follows the GNOME mobile platform.
{{Main|Hackable:1}}

====[[neovento]]====
neovento (ex FYP) is a [[Debian|Debian on Freerunner]] based [[Distributions|distribution]] which uses [http://lxde.org/ LXDE] and [[Zhone]] on top. It is a [http://freeyourphone.de FreeYourPhone.de] community project.

{{Main|neovento}}

====OpenWrt====
[[OpenWrt]] is described as a Linux distribution for embedded devices.

Instead of trying to create a single, static firmware, [[OpenWrt]] provides a fully writable filesystem with package management. This frees you from the application selection and configuration provided by the vendor and allows you to customize the device through the use of packages to suit any application. For developer, [[OpenWrt]] is the framework to build an application without having to build a complete firmware around it; for users this means the ability for full customization, to use the device in ways never envisioned.

[[OpenWrt]] development trunk now supports s3c24xx, CPU used in [[Freerunner]].

Mainly due to the usage of uClibc instead of glibc as libc implementation, OpenWrt can boot from NAND with enlightenment window manager within 1 minute 7 seconds using u-boot (NOR) bootloader.

* [http://www.openwrt.org OpenWrt website]
* [http://dev.openwrt.org OpenWrt development site]

{{Main|OpenWrt}}

====Mer====
[[Mer]] is a distribution based on [[Maemo]].

==== Others / unreleased ====
* The [http://www.neopwn.com/software.php NeoPwn] network auditng system's core is a modified Linux 2.6.24 kernel, with cross-compiled module driver support for the numerous compatible addon devices running on a FULL Debian (ARMEL) operating system. The filesystem has been optimized for performance and size and includes the NeoPwn menu system and several GUI dialogs for hardware control and attack automation. ''Status: Unknown, the GPL requires source code to be distributed only to customers''.
* [http://runningbear.org/trac RunningBear] is an innovative, yet free and open-source Operating System for hackable devices driven by Bearstech. Lightweight, Portable, Secure, Friendly and Useful. ''Status: In development''.
* [http://pokylinux.org/ Poky] and Sato, by OpenedHand/Intel. An open source platform build tool derived from OE. It is a complete software development environment for the creation of Linux devices. It enables you to design, develop, build, debug, and test a complete, modern, software stack using Linux, the X Window System and GNOME Mobile based application frameworks for both ARM and x86 based platforms. ''Status: The "Nightly Build" Image works fine on Neo Freerunner, but phone functionality doesn't.''
* [http://pyneo.org/ PyNeo] pyneo is a stack for mobile devices excessivly using dbus, glib and evas. Pyneo is NO distribution but a middleware or framework like FSO which itself developed from a very early version of pyneo. Current pyneo images are entirely based on debian instead of oe. ''Status: still active and in development! ask around on #pyneo.org ''
* [http://www.quantum-step.com/ mySTEP] by Openmoko distributor Golden Delicious Computers is based on GNUstep and brings a Objective-C API to the Neo. Core GUI frameworks are "Foundation" & "AppKit". It has been shown on FOSDEM 2008, LinuxTag 2008 and SYSTEMS 2008 to run on the Neo 1973. If someone reengineers UIKit, (open) source code compatibility to iPhone apps appears achievable. ''Status: slow progress behind the scenes''
* [http://www.archmobile.org/ Archlinux] is a distribution that follows the KISS principle.

== Features by distribution/release target ==

Generally, distributions can differ on one or more of the following components:
* The bootsplash screen image. This is purely decorative.
* The bootloader. Theoretically, any version of ''uboot'' could be used with any distribution. In the future ''Qi'' will replace ''uboot''.
* The kernel. GNU/Linux kernels versions 2.6.24, 2.6.26 or 2.6.28 can be found. Some have modules compiled in, others have modules compiled separately. If compiled separately, modules can be distributed in the same package file as the kernel or separately.
* Middleware: daemons to handle GSM calls or GPS, sound system, personal information storage and so on. Qt and Android have their own subsystems, FreeSmartphone.Org (FSO) is working towards a standard-based Free Software one.
* Display driver. The original ''Qt Extended'' uses the framebuffer, most other distributions today use ''X11''.
* Libraries and application framework (widget toolkit and and graphical environment) : EFL, Qt, Gtk+ or Java ?
* Basic telephony applications: voice calls, SMS, alarm clock...
* Smartphone applications: GPS, media player, simple games, web browser...
* Open source applications: more games, scientific, you name it...

=== Hardware Support ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008]] !! width=8%|Om 2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| GTA01 || ?? || ?? || ?? || {{Yes}} || ?? || {{Yes}} || {{Yes}} || ?? || ??
|-
| GTA02 || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
|}

=== Connectivity ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008]] !! width=8%|Om 2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Telephony || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| SMS || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| [[GPRS]] || Not through UI || Not through UI|| Not through UI || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || Not through UI || {{Yes}}
|-
| [[WiFi]] || {{Yes}} (*) || {{Yes}} || Not through UI || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || Not through UI || {{Yes}}
|-
| VoIP || ?? || ?? || ?? || ?? || {{Yes}} || {{Yes}} (1) || {{Yes}} || ?? || {{no}}
|-
| Bluetooth || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{Yes}}
|-
| GPS (1) || {{Yes}} (1) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || {{Yes}} (1) || {{Yes}}
|-
|}

=== Power ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008]] !! width=8%|Om 2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Suspend || {{Yes}} || ?? || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Resumes on Event || ?? || ?? || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ??
|-
| Functions after Resume || {{Yes}} || ?? || ?? || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
|}

=== User Interaction ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|Om2008 !! width=8%|2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Stylus friendly || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Finger friendly || Partially || Partially || Partially || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Accelerometer || {{Yes}} [[Rotate|(1)]][[Gestures|(1)]] || {{No}} || {{No}} || {{yes}} (1) || {{Yes}} || {{No}} || {{Yes}} || ?? || {{Yes}}
|-
|}

=== Applications ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008]] !! width=8%|2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Terminal || {{Yes}} (1) || Basic (2) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || {{Yes}}
|-
| PIM || {{Yes}} || {{Yes}} || {{No}} || N/A || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || ??
|-
| Phonebook || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Dialer || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Web Browser || {{Yes}} (1) || {{Yes}} (1) || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Mail Client || {{Yes}} || ? || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| XMPP Client || {{Yes}} [[Instant Messaging|(1)]] || {{Yes}} (1) || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || || ??
|-
| Media Player || {{Yes}} (1) || {{Yes}} || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
|}

=== Toolkits / Runtimes ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0"
! width=10%| !! width=8%|[[Om 2008]] !! width=8%|2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| GTK+ || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || ??
|-
| Qt/Qt Extended || {{Yes}} || {{No}} || {{Yes}} ? || {{Yes}}? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ??
|-
| Middleware || qtopia-x11 || gsmd/neod || FSO || FSO || qtopia-x11 || Qt Extended || FSO || FSO || ??
|-
| [[Java]] || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes}} || ?? || {{Yes|CacaoVM, JamVM}} || ?? || ??
|-
| [[Python]] || {{Yes}} || {{Yes}} || {{Yes}} || {{yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ??
|-
| [[Mono]] || {{Yes}} (1) || {{Yes}} (1) || ?? || {{no}} || ?? || ?? || {{Yes}} (1) || ?? || ??
|-
| [[Ruby]] || {{Yes}} || ?? || ?? || ?? || ?? || ?? || {{Yes}} (1) || {{Yes}} (1) || ??
|}

=== Images ===
Latest and stable combinations for Neo FreeRunner gta02
{|class="wikitable" border="1" cellpadding="5" cellspacing="0"
| || OM || FDOM || Qt Extended || Android
|-
| current bootloader || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/distro/releases/Om2008.9/ OM daily] version [http://downloads.openmoko.org/] || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/repository/experimental/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/repository/experimental/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] ||
|-
| future bootloader || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu ||
|-
| splash || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz ||
|-
| kernel || [[Linux]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest uImage.bin || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest uImage-gta02-mwester-stable.bin or from [http://downloads.tuxfamily.org/3v1deb/openmoko/ treviño] latest uImage-gta02-stable-3v1n0.bin || [[Linux]] see [[Qt_Extended]] page for latest version || [[Linux]] from [http://koolu.org/releases/ koolu]
|-
| modules || ? || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest modules-min-gta02-mwester-stable.tgz or modules-all-gta02-mwester-stable.tgz || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest modules-min-gta02-mwester-stable.tgz or modules-all-gta02-mwester-stable.tgz ||
|-
| rootfs || [[Main_Page|OM]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest rootfs.jffs2 || [[FDOM]] from [ftp://ftp.tuxbrain.com/openmoko/fdom/releases/ TuxBrain] version [ftp://ftp.tuxbrain.com/openmoko/fdom/releases/Fat_and_Dirty_OM.200809_20081023.rootfs.jff2 200809_20081023] || See [[Qt_Extended]] for latest rootfs || [[Android]] from [http://koolu.org/releases/ koolu]
|}

Footnotes:

(1) works, but need additional software to be installed

(2) unusable due to lack of certain keyboard characters. [[Switching_Keyboards#Matchbox_keyboard|Various fixes available.]]

(*) unstable

==Quick download page==

[[Download]]

== See also ==

* Mickey Lauer's post "[http://www.vanille-media.de/site/index.php/2008/06/28/gtk-asu-fso-tmtla/ GTK, ASU, FSO, TMTLA!]" describes the differences between distributions 2007.2, ASU and FSO.

* Latest news and tips are in [[Community Updates]]

* [[Kustomizer]] is a script to change your 2008.12 to a usable phone

[[Category:Distributions| ]]

Navit

2009-07-04T09:14:40Z

Myfanwy: added missing space in navit feed command

{{Application|Navit}}

As described on the [http://navit.sourceforge.net/ Navit home page],

"Navit is a car navigation system with routing engine.

Its modular design is capable of using vector maps of various formats for routing and rendering of the displayed map. It's even possible to use multiple maps at a time.

The GTK+ or SDL user interfaces are designed to work well with touch screen displays. Points of Interest of various formats are displayed on the map.

The current vehicle position is either read from gpsd or directly from NMEA GPS sensors."

Some people say Navit is also a good choice for pedestrian and bicycle navigation.

[[Image:Navit-2241.png|thumb|Navit-r2241]]

== Acknowledgment ==

Thanks to [[User:Alessandro | Alessandro]], stefan_schmidt, cp15 and all Navit developers I have done a small ("not really working") preview of Navit on Neo1973 at [http://www.telemobilityforum.com/eng/ Telemobility Forum 2007]. Thanks to [http://gfoss.it GFoss] guys to invite me.
''[[User:Tyrael | Tyrael]]''

==Setting up Navit==

===Install Navit===
====OM2008.x====
You can now simply add a feed from there : http://download.navit-project.org/navit/openmoko/svn/

Essentially, to enable this directory as [[Om_2008.8_Installer#How to add a Repository ?|feed]] and install or update navit do:
* Only for the first time:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

* Always:
opkg install navit

Navit will be auto-updated when you run opkg upgrade later

====Debian====
Navit is now in [http://packages.debian.org/source/experimental/navit Debian experimental].

More recent releases of the very same packaging can be found in the Pini's repository:
deb http://pini.free.fr/debian unstable main
deb-src http://pini.free.fr/debian unstable main

The up-to-date source package is available through git at '''git://git.debian.org/git/collab-maint/navit.git''' ([http://git.debian.org/?p=collab-maint/navit.git;a=summary browse]).

====FSO====
I found that navit did not start fso-gpsd. I found the solution on the [http://lists.openmoko.org/nabble.html#nabble-td2473189 mailing list]. Starting navit from the command line produced the following output:

navit:plugin_load:can't load '/usr/lib/navit/vehicle/
libvehicle_gpsd.so', Error 'libgps.so.16: cannot open shared object
file: No such file or directory'
navit:vehicle_new:invalid type 'gpsd'

So I used the following workaround:

opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Set up the maps you want===

====The Easy Way====
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. Navigate to the region you want, and click select to select it, select the region you want, then click download

If you just want the entire planet (as of this writing, ~1.8 GB), it's [http://maps.navit-project.org/planet.bin here].

[http://downloads.cloudmade.com/ CloudMade] also has up-to-date maps from OpenStreetMap by country (by state in the US).

====From the command line====
'''OpenStreetMap''' - follow directions at http://wiki.navit-project.org/index.php/OpenStreetMaps
* There are some pre-processed, up-to-date maps that can be grabbed with wget:

<pre>wget -O germany.bin http://maps.navit-project.org/api/map/?bbox=5.185546875,46.845703125,15.46875,55.634765625</pre>

* Here's an example to get the maps for the area around Seattle, WA:
** Find the map coordinates using http://informationfreeway.org/?lat=47.520270037501454&lon=-122.20130713167327&zoom=9&layers=B000F000
** Download 4 regions from OpenStreetMaps ([[Navit#Script_to_download_OSM_maps|see below]] for a script to do this for you automatically for largish areas):

<pre>wget -O map1.osm http://www.openstreetmap.org/api/0.5/map?bbox=-122.2,47.5,-122,47.7
wget -O map2.osm http://www.openstreetmap.org/api/0.5/map?bbox=-122.4,47.5,-122.2,47.7
wget -O map3.osm http://www.openstreetmap.org/api/0.5/map?bbox=-122.4,47.3,-122.2,47.5
wget -O map4.osm http://www.openstreetmap.org/api/0.5/map?bbox=-122.2,47.3,-122,47.5</pre>

* A binary Navit map file needs to be created. The following uses osm2navit, and it's recommended that this command be used on something more powerful than the Neo:

<pre>cat *.osm | osm2navit --dedupe-ways mymap.bin</pre>

===Copy the map to the NEO===
To copy the map using scp (replace ''/directory'' as is appropriate in the following):
<pre>scp mymap.bin root@neo:/directory</pre>
Once it's somewhere on the NEO, Navit needs to know that it's there.
<pre>mkdir ~/.navit
cp /usr/share/navit/navit.xml ~/.navit/navit.xml
vi ~/.navit/navit.xml</pre>
In the navit.xml file, put the following into a new <mapset> section:
<pre><map type="binfile" enabled="yes" data="/directory" /></pre>
Disable unused mapset sections by setting enabled to false.

* Run navit
** Start gllin (for GTA01)
** Start gpsd ( gpsd /tmp/nmeaNP )
** Start navit

* The version of osm2navit with which you build the maps should match the version of navit you have. If in doubt, build the maps on the Openmoko.

===Tips and Tricks===
====Center on Vehicle====
Navit supports a "always center on vehicle" option.

To activate this add
follow="3"
to the vehicle tag in navit.xml. The "3" causes to give the gui time to do something between the repaints (drag the map or browse the menu). When its set to "1" navit does nothing more than repainting the map continuously.

== News ==

=== Getting the display right ===

If using SHR the keyboard in country/town/street search mode does not fit on the street, make sure your gui configuration is set to the following line:

<gui type="internal" font_size="350"/>

The example line provided for freerunners hides some important icons. Namely, instead of typing your city name first, you will first have to click the button on the top left, to go into country search mode. Enter your country name, then the city name, in order to enable the search function. This requires your map data to be searchable.

=== Street names ===
They are now displayed on Openmoko using the CVS version of Navit (20071217).

=== Point selection by pen ===
Easier using the CVS version (20071217).

=== Route > Destination ===
The Route > Destination menu item crashes the software (20071217 and 0.04, but fixed in 0.1.0+svnrev1255).

A workaround is to set the LANG variable before calling navit. For example:

LANG=fr_FR.UTF-8 navit

Note that a short syntax (e.g. LANG=fr) would not work.

If you put an "export LANG=fr_FR.UTF-8" into your /etc/profile file, it will automatically set this environment variable every time you boot up. This way, you can launch Navit from the Icon in Illume.

http://trac.navit-project.org/ticket/51

=== Speech ===
Navit can speak if you install eSpeak + speech-dispatcher and updates your navit.xml file.

For adventurous people, one way to do this:

* mokoTTS aims to integrate these packages in OM:
http://projects.openmoko.org/projects/mokotts/

install espeak, dotconf, and then speech-dispatcher.
note: running 2008.8 updating from zecke's "testing" repo does not require "dotconf"

* change the speech tag in navit.xml:
<speech type="cmdline" data="spd-say '%s'" />

or "spd-say -l fr '%s'" for using the French voice for example.

'''Note: Package speech-dispatcher broke my audio after suspend with current SHR (2009-04-13, though the problem's not shr, but speech-dispatcher itself).''' A solution is to disable starting of speech-dispatcher with:
update-rc.d -f speech-dispatcher remove
And then edit /usr/bin/navit, so that it starts speech-dispatcher before navit, and stops it afterwards. See http://lists.openmoko.org/nabble.html#nabble-td1088795

=== Maps ===
==== Downloadable Maps ====
Downloadable OSM maps for most areas of the world are available free in Navit format from Cloudmade at [http://downloads.cloudmade.com/ http://downloads.cloudmade.com/]. Simply navigate to the country or region you want and download the <code>.navit.bin.zip</code> version of the map. You'll have to exatract the <code>.bin</code> file from the ZIP archive before using it with Navit.
==== Planet extract ====
You can download pre-compiled (ready-to-use) maps using the OpenStreetMap-data from the [http://maps.navit-project.org/download/ the navit planet extractor] ;-)]™ which allows you to select a region of OpenStreetMap to extract. This will give you a binary file that can be used directly by Navit without further processing. The planet extractor's map data is updated daily.

==== Script to download OSM maps ====
[[User:Wurp|Wurp]] wrote a little python script to download all OSM maps within a lat/long rectangle. Just copy the script to a file called dlOSM.sh, chmod +x it, and run it like
dlOSM.sh <minimum latitude> <maximum latitude> <minimum longitude> <maximum longitude>

It takes a long time for large maps. I could optimize it some by having it try to get a big section at once, then if it fails, break it into smaller pieces and recurse. I'm not sure when/if I'll get around to that...

dlOSM.sh:
<pre>
#!/usr/bin/python

import os
import sys
#import math

def doIt(cmd):
os.system(cmd)

def getOsms(basename, minLat, maxLat, minLon, maxLon):
'''basename - base name of map, maps are named {basename}{count}.osm
minLat - latitude of the west side of the map
maxLat - latitude of the east side of the map
minLon - longitude of the north side of the map
maxLon - longitude of the south side of the map'''

wgetCmdTemplate = 'wget -O %s%s.osm http://api.openstreetmap.org/api/0.5/map?bbox=%s,%s,%s,%s'

currLat = minLat
mapCount = 0
while currLat < maxLat:
nextLat = min(currLat + 0.1, maxLat)

currLon = minLon
while currLon < maxLon:
nextLon = min(currLon + 0.1, maxLon)

doIt(wgetCmdTemplate % (basename, mapCount, currLon, currLat, nextLon, nextLat))

currLon = nextLon
mapCount = mapCount + 1

currLat = nextLat

(minLat, maxLat, minLon, maxLon) = map(float, sys.argv[1:])
getOsms('map', minLat, maxLat, minLon, maxLon)
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[Navit]]|
Description=Navit is a car navigation system with routing engine.|
Screenshot=Screenshot-3.png|
Homepage=http://navit.sourceforge.net|
TestedOn=|
PackageName=
}}
</onlyinclude>

[[Category:GPS Applications]]

Pimlico

2009-07-04T08:30:45Z

Myfanwy: /* Pimlico */

==Pimlico==

From the website: ''Pimlico is a suite of lightweight Personal Information Management (PIM)
applications designed primarily for handheld and mobile devices''

* Dates - calendar
* Contacts - address book
* Tasks - task list
* Sync - synchronization

This project uses the evolution-data-server.

Project Website: [http://www.pimlico-project.org/ pimlico]

Successfully imported a full address book vcf file created by saving an Evolution address book. Have not yet tried importing (or sharing) a calendar. Dates seems to support online web calendars.

According to the project website, Sync is not quite ready for release (other than svn).

===OM2008===

Dates and Tasks are in opkg:

<pre>
opkg install openmoko-dates2 openmoko-tasks2
</pre>

See the project website for screen shots.

(In OM2008.x Contacts uses other package from qtopia.)

NB: This packages do not correspond to the last version of pimlico ?

===Debian===

Dates and Contacts can be compiled relatively easily from source by installing
the necessary development packages. (''Packaging underway'').

Screenshots of running under the Matchbox WM:

====Dates====

[[Image:Dates-month.png|150px|Dates - Month View]] [[Image:Dates-week.png|150px|Dates - Week View]] [[Image:Dates-day.png|150px|Dates - Day View]] [[Image:Dates-details.png|150px|Dates - Details View]]

====Contacts====

[[Image:Contacts-view.png|150px|Contacts - View]] [[Image:Contacts-new.png|150px|Contacts - New]][[Image:Contacts-edit2.png|150px|Contacts - Edit]]

===SHR===
==== SHR testing (2009-03) ====
There is currently no package in the SHR repositories. You can add the [http://wiki.openmoko.org/wiki/Users_Repositories#Angstrom_Repository Angstrom repository] :

echo "arch base 50" > /etc/opkg/angstrom-feed.conf
echo "src/gz base http://www.angstrom-distribution.org/feeds/2008/ipk/glibc/armv4t/base" >> /etc/opkg/angstrom-feed.conf
opkg update
opkg install dates tasks

If you don't want to break your shr install with the next opkg upgrade, you must remove the angtrom feed after installing dates and tasks
rm /etc/opkg/angstrom-feed.conf
opkg update

==== SHR unstable (2009-04-10) ====
Since this date, "dates" and "tasks" from Pimlico are in the SHR unstable repository. So if you run SHR unstable, just do
opkg update
opkg install dates tasks
to install them.

TangoGPS

2009-06-30T03:51:00Z

Myfanwy: /* Importing Tracks into tangoGPS */

{{Languages|tangoGPS}}
{{Application|tangoGPS}}

__TOC__

tangoGPS is a map application which can utilize Neo's built-in GPS to show your current location.

[[Image:TangoGPS1.jpg]]

Website: http://www.tangogps.org

== Running tangoGPS ==
=== [[Om 2008.8]] ===

From the freerunner connected to the internet:
<pre>
opkg update
opkg install gpsd
</pre>
{{note|I experienced hangups if gpsd was not installed.}}
<pre>
opkg install http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk
</pre>
If opkg complains about not being able to acquire a lock, try:
<pre>pkill packagekit</pre>
To get gpsd working on the FreeRunner you have to change the configuration according to [[Gpsd#GPS_on_GTA02]].
Then start gpsd by:
<pre>
/etc/init.d/gpsd start
</pre>
If you get an error about no GPS device in /etc/default/gpsd execute:
<pre>
echo "GPS_DEV=\"/dev/ttySAC1\"" > /etc/default/gpsd
</pre>
Now you must power up the GPS-chip by opening the "Settings" application and setting the GPS entry to "on". Now you can run tangoGPS and wait until it get's a GPS fix. This can take up to a few minutes.

=== [[Debian]] ===

The latest version is available in [[Debian]].

It depends on gpsd which conflicts with frameworkd in fso-frameworkd, but there is a package available that provides
the gpsd interface to clients while using the services of the FSO frameworkd daemon, fso-gpsd. The install.sh script for the Debian distribution on the OpenMoko already installs it. To add tangogps run

# apt-get install tangogps

The gps device will be started automatically upon the invocation of tangogps or another gps application, e.g. like the one in [[Zhone]]. For the records, one can manually turn on the gps device using

# echo 1 >/sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron

The tangoGPS applications may appear as "GPS & Map" on various desktops.

'''Issues:'''
* Both gpsd and the framework publish GPS data through dbus, though with different interfaces. This suggests a number of possible solutions.
** gpsd or the framework could implement the other's interface (along with their own).
** a translator could read one interface and emulate the other. This is what fso-gpsd does.
** the framework could have an option to read data from gpsd.
** ogpsd/gypsy could be extended to be backwards compatible with the majority of gps applications.

=== FSO Milestone 3 ([[OpenmokoFramework]]) ===

There are two various GPS interfaces -- (1) one provided with default gpsd and (2) the other provided by ogpsd (part of the frameworkd). tangoGPS requires the ad 1 and it obtains information from gps from the dbus interface provided by gpsd.

On FSO milestone 3, there is tangoGPS pre-installed as well as both gpsd and ogpsd (see <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code>). As mentioned above, there also exists a fso-gpsd package, that converts from ad 2 to ad 1 (unfortunately fso-gpsd is not in default image and must be installed with <code>opkg install fso-gpsd</code>).

You cannot have both "providers" (ad 1 & ad 2) running, but you can have ad 2 (recommended for FSO) and "convertor" (fso-gpsd) providing the ad 1. To get usable tangoGPS on FreeRunner, one has to:

# check that <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code> reads GPS data from the right device (<code>/dev/ttySAC1</code>)
# if changes were made to configuration, one should restart the frameworkd -- <code>/etc/init.d/frameworkd stop && /etc/init.d/frameworkd start</code>
# check that gpsd is not running -- <code>/etc/init.d/gpsd stop</code>
# check that fso-gpsd is installed and running -- <code>opkg install fso-gpsd; fso-gpsd</code>
# check that gps chip is online (<code>echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron</code>)
# finally start up the tangoGPS and locate the gps signal; it should be up in a few minutes.

Note 1: handy application for testing the gps (and gps signal strength) is <code>openmoko-agpsui</code>, see general gps info at [[Gps]]

Note 2: You can automate the process -- (1) remove the startup script for gpsd (<code>update-rc.d -f gpsd remove</code>) and (2) create a simple startup scipt for fso-gpsd (you can use current script for gpsd as a skeleton)

== Downloading Maps ==
=== pre-load for offline use ===

tangoGPS can bunch-download the map images so you don't need an internet connection while walking around. By default tangoGPS stores downloaded maps to /tmp/. This folder is lost every time you reboot the device. But you can use the "Config" tab within tangoGPS to change the "Cache Dir" location to , for example, /osm/ . So downloaded maps will be kept in the Neos flash, also after reboot. Note that the map files can take up large amounts of space, so you may want to store them on your sd card, e.g. in /media/card/osm or /media/mmcblk0p2/data/maps.

If you find that TangoGPS does not remember configuration changes that you make to it, be sure to run it from the touchscreen, and not an SSH session. TangoGPS uses gconf to store its settings, and cannot access gconf when run via SSH.

An alternative way to setup the configuration is through the command line. having /media/mmcblk0p2/data/maps as your data directory you could do the follwing:
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|1]" \
--type list --list-type string
</pre>

Once you have set the location to a non-volatile path, you can connect your Neo to the internet by USB or WiFi at home and start downloading the maps of your area. Tap the map screen and select "map download". Now on-the-road tangoGPS will be able to show you maps in different zoom levels even though you are not connected to the internet.

=== Downloading Maps via GPRS ===
I think tangoGPS may have started working after I followed the instructions to get GPRS working with GSM multiplexing here: [[Manually_using_GPRS#Option_1:_With_GSM_multiplexing_and_with_a_GUI]]

There are steps included in those instructions to improve GPS performance. The great thing is that once you get GPRS working, you can roam with TangoGPS running and have it download maps as needed over the GPRS connection!

=== Updating pre-downloaded maps ===
If you have many maps already downloaded, [[Media:updateMaps.txt|updateMaps.pl]] is a perl script to bring you up-to-date. It's made to work for OSM maps only, but can be adapted to work with any map dataset. See also: [[Yaouh!]].

== Using tangoGPS for OpenStreetMap.org ==
=== creating tracks ===
tangoGPS works fine to create track for Openstreetmap. However, it records and stores a track in its native format, use [http://www.tangogps.org/downloads/convert2gpx.pl convert2gpx.pl] (see also: [http://psung.blogspot.com/2008/07/sharing-gps-tracks-from-tangogps-on.html tools])(you can also use [http://minucci.net/file/convert2gpx.py convert2gpx.py]) to convert the track to GPX (i.e to import into JOSM):

perl convert2gpx.pl 20080903_111508.log > 20080903_111508.gpx

==== tangoGPS logging format ====

<lat>,<lon>,<elevation>,<speed>,<course>,<hdop>,<datetime>

=== using OpenStreetBugs ===
[http://wiki.openstreetmap.org/wiki/TangoGPS#Using_together_with_OpenStreetBugs see OSM wiki]

== Importing Tracks into tangoGPS ==

tangoGPS does not support the import of tracks directly. However the following xslt style sheet can be used to convert gpx tracks - e.g from routing software such as maps.cloudmade.com - to tangogps log files, which can then be imported<br>
At present this style sheet will only convert tracks which make use of the 'wpt' (waypoint) tag. Some software uses the 'trkpt' (trackpoint) tag. This will be incorporated into the stylesheet at some point. In the meantime, it can be used on the latter type of gpx file by changing 'wpt' to 'trkpt' on line 6.

<pre>
<nowiki>
<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:g="http://www.topografix.com/GPX/1/1">
<xsl:output method="text" omit-xml-declaration="yes"/>
<xsl:template match="g:gpx" >
<xsl:for-each select="g:wpt">
<xsl:value-of select="@lat"/>,<xsl:value-of select="@lon"/>,11.8,1.1,346.0,1.4,2008-12-30T06:46:0<xsl:if test="position()!=last()"><xsl:text>1</xsl:text></xsl:if><xsl:if test="position()=last()"><xsl:text>2</xsl:text></xsl:if>Z
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</nowiki>
</pre>

save this into a file called 'gpx2log.xslt', then run

<pre>
$ xsltproc gpx2log.xslt input_file.gpx > output_file.log
</pre>

move output_file.log to the tangogps traces directory, and use the 'Load...' button on the 'Track' tab to overlay it on the map

Note: this stylesheet was thrown together in a short time, and makes at least one shortcut - namely, the use of 'dummy' variables for various details, such as the altitude, date, etc. Feel free to improve this if required, although it has no bearing on the display of the track

You may help yourself by using [http://relet.net/frog/archives/68 this tool] to import GPX trackpoints as a series of POIs directly into the sqlite database which tangoGPS uses to store POIs.

== Using the TangoGPS logs ==

You can convert the logfiles from TangoGPS to other formats using gpsbabel and this style-file:

<pre>
DESCRIPTION TangoGPS 0.92
EXTENSION log
DATATYPE TRACK

FIELD_DELIMITER COMMA
RECORD_DELIMITER NEWLINE

IFIELD LAT_DECIMAL,"","%f"
IFIELD LON_DECIMAL,"","%f"
IFIELD ALT_METERS,"","%f"
IFIELD PATH_SPEED,"","%f"
IFIELD PATH_COURSE,"","%f"
IFIELD GPS_HDOP,"","%f"
IFIELD ISO_TIME,"","%s"
</pre>

Save this as '''tangogps.style''' and you can use gpsbabel to for instance convert to google-earth files like this:

gpsbabel -i xcsv,style=tangogps.style -o kml -f file.log -F file.kml

== Add POI from address ==

You can use [[gtkaddpoi]] for searching the destination address and add it as a POI.

== Add POI from GeoRSS feed ==

If you would like to import GeoRSS feeds from Google maps or elsewhere as points of interest (POI), read this [http://bonedaddy.net/pabs3/log/2009/05/28/georss-tangogps/ blog post]. Hopefully TangoGPS upstream will include the script soon, but until then and if you aren't using Debian, download this [http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=georss-to-tangogps-poi.py;att=1;bug=530718 script] from the Debian bug tracker.

== Using Google Maps with tangoGPS ==

Go to Config and create a new repository.

Set the url for '''street-maps''' to:
<pre>http://mt1.google.com/mt?&x=%d&y=%d&z=%d</pre>
for '''satellite-maps''' to:
<pre>http://khm.google.com/kh?&x=%d&y=%d&zoom=%d</pre>
for '''topographic-maps''':
<pre>http://mt.google.com/mt?v=app.81&x=%d&y=%d&zoom=%d</pre>

Check the "Inverted Zoom" box. Press save Repository Configuration and you're ready to go.

'''Since TangoGPS 0.9.5''' the "Inverted Zoom" box is no longer available because Google changed the addressing scheme; instead, select "xyz instead of zxy" and use the following URLs:
<pre>
Maps:
http://mt3.google.com/mt/v=w2.89&hl=en&x=%d&y=%d&z=%d&s=Galileo

Sat:
http://khm3.google.com/kh/v=36&hl=en&x=%d&y=%d&z=%d&s=Galileo
</pre>

'''Generalization:''' The above 'Maps' URL isn't the current one anymore, also. Google changes the URL layout sometimes. To find out the current scheme open maps.google.com and view the page source. Search for http:// until you find sth similar to the above URL. This way I found
<pre>
http://mt1.google.com/mt/v=w2.92&hl=en&x=3&y=5&z=4&s=Galile
</pre>

Now you could tweak your configuration unsing the above link (delete the 'amp;' tokens and replace every number with '%d'), for example with
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|\
0,Google Maps (testing only)|http://mt1.google.com/mt/v=w2.92&hl=en&x=%d&y=%d&z=%d&s=Galile|/media/mmcblk0p2/data/maps/googlemaps|1]" \
--type list --list-type string
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[TangoGPS]]|
Description= TangoGPS is a map application which can utilize Neo's built-in GPS to show your current location. It automatically downloads maps from http://openstreetmap.com and you can download map tiles for offline use too.|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org|
TestedOn=Om 2008.8|
PackageName=tangogps
}}
</onlyinclude>

[[Category:GPS Applications]]

TangoGPS

2009-06-29T04:42:11Z

Myfanwy: /* Importing Tracks into tangoGPS */

{{Languages|tangoGPS}}
{{Application|tangoGPS}}

__TOC__

tangoGPS is a map application which can utilize Neo's built-in GPS to show your current location.

[[Image:TangoGPS1.jpg]]

Website: http://www.tangogps.org

== Running tangoGPS ==
=== [[Om 2008.8]] ===

From the freerunner connected to the internet:
<pre>
opkg update
opkg install gpsd
</pre>
{{note|I experienced hangups if gpsd was not installed.}}
<pre>
opkg install http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk
</pre>
If opkg complains about not being able to acquire a lock, try:
<pre>pkill packagekit</pre>
To get gpsd working on the FreeRunner you have to change the configuration according to [[Gpsd#GPS_on_GTA02]].
Then start gpsd by:
<pre>
/etc/init.d/gpsd start
</pre>
If you get an error about no GPS device in /etc/default/gpsd execute:
<pre>
echo "GPS_DEV=\"/dev/ttySAC1\"" > /etc/default/gpsd
</pre>
Now you must power up the GPS-chip by opening the "Settings" application and setting the GPS entry to "on". Now you can run tangoGPS and wait until it get's a GPS fix. This can take up to a few minutes.

=== [[Debian]] ===

The latest version is available in [[Debian]].

It depends on gpsd which conflicts with frameworkd in fso-frameworkd, but there is a package available that provides
the gpsd interface to clients while using the services of the FSO frameworkd daemon, fso-gpsd. The install.sh script for the Debian distribution on the OpenMoko already installs it. To add tangogps run

# apt-get install tangogps

The gps device will be started automatically upon the invocation of tangogps or another gps application, e.g. like the one in [[Zhone]]. For the records, one can manually turn on the gps device using

# echo 1 >/sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron

The tangoGPS applications may appear as "GPS & Map" on various desktops.

'''Issues:'''
* Both gpsd and the framework publish GPS data through dbus, though with different interfaces. This suggests a number of possible solutions.
** gpsd or the framework could implement the other's interface (along with their own).
** a translator could read one interface and emulate the other. This is what fso-gpsd does.
** the framework could have an option to read data from gpsd.
** ogpsd/gypsy could be extended to be backwards compatible with the majority of gps applications.

=== FSO Milestone 3 ([[OpenmokoFramework]]) ===

There are two various GPS interfaces -- (1) one provided with default gpsd and (2) the other provided by ogpsd (part of the frameworkd). tangoGPS requires the ad 1 and it obtains information from gps from the dbus interface provided by gpsd.

On FSO milestone 3, there is tangoGPS pre-installed as well as both gpsd and ogpsd (see <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code>). As mentioned above, there also exists a fso-gpsd package, that converts from ad 2 to ad 1 (unfortunately fso-gpsd is not in default image and must be installed with <code>opkg install fso-gpsd</code>).

You cannot have both "providers" (ad 1 & ad 2) running, but you can have ad 2 (recommended for FSO) and "convertor" (fso-gpsd) providing the ad 1. To get usable tangoGPS on FreeRunner, one has to:

# check that <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code> reads GPS data from the right device (<code>/dev/ttySAC1</code>)
# if changes were made to configuration, one should restart the frameworkd -- <code>/etc/init.d/frameworkd stop && /etc/init.d/frameworkd start</code>
# check that gpsd is not running -- <code>/etc/init.d/gpsd stop</code>
# check that fso-gpsd is installed and running -- <code>opkg install fso-gpsd; fso-gpsd</code>
# check that gps chip is online (<code>echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron</code>)
# finally start up the tangoGPS and locate the gps signal; it should be up in a few minutes.

Note 1: handy application for testing the gps (and gps signal strength) is <code>openmoko-agpsui</code>, see general gps info at [[Gps]]

Note 2: You can automate the process -- (1) remove the startup script for gpsd (<code>update-rc.d -f gpsd remove</code>) and (2) create a simple startup scipt for fso-gpsd (you can use current script for gpsd as a skeleton)

== Downloading Maps ==
=== pre-load for offline use ===

tangoGPS can bunch-download the map images so you don't need an internet connection while walking around. By default tangoGPS stores downloaded maps to /tmp/. This folder is lost every time you reboot the device. But you can use the "Config" tab within tangoGPS to change the "Cache Dir" location to , for example, /osm/ . So downloaded maps will be kept in the Neos flash, also after reboot. Note that the map files can take up large amounts of space, so you may want to store them on your sd card, e.g. in /media/card/osm or /media/mmcblk0p2/data/maps.

If you find that TangoGPS does not remember configuration changes that you make to it, be sure to run it from the touchscreen, and not an SSH session. TangoGPS uses gconf to store its settings, and cannot access gconf when run via SSH.

An alternative way to setup the configuration is through the command line. having /media/mmcblk0p2/data/maps as your data directory you could do the follwing:
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|1]" \
--type list --list-type string
</pre>

Once you have set the location to a non-volatile path, you can connect your Neo to the internet by USB or WiFi at home and start downloading the maps of your area. Tap the map screen and select "map download". Now on-the-road tangoGPS will be able to show you maps in different zoom levels even though you are not connected to the internet.

=== Downloading Maps via GPRS ===
I think tangoGPS may have started working after I followed the instructions to get GPRS working with GSM multiplexing here: [[Manually_using_GPRS#Option_1:_With_GSM_multiplexing_and_with_a_GUI]]

There are steps included in those instructions to improve GPS performance. The great thing is that once you get GPRS working, you can roam with TangoGPS running and have it download maps as needed over the GPRS connection!

=== Updating pre-downloaded maps ===
If you have many maps already downloaded, [[Media:updateMaps.txt|updateMaps.pl]] is a perl script to bring you up-to-date. It's made to work for OSM maps only, but can be adapted to work with any map dataset. See also: [[Yaouh!]].

== Using tangoGPS for OpenStreetMap.org ==
=== creating tracks ===
tangoGPS works fine to create track for Openstreetmap. However, it records and stores a track in its native format, use [http://www.tangogps.org/downloads/convert2gpx.pl convert2gpx.pl] (see also: [http://psung.blogspot.com/2008/07/sharing-gps-tracks-from-tangogps-on.html tools])(you can also use [http://minucci.net/file/convert2gpx.py convert2gpx.py]) to convert the track to GPX (i.e to import into JOSM):

perl convert2gpx.pl 20080903_111508.log > 20080903_111508.gpx

==== tangoGPS logging format ====

<lat>,<lon>,<elevation>,<speed>,<course>,<hdop>,<datetime>

=== using OpenStreetBugs ===
[http://wiki.openstreetmap.org/wiki/TangoGPS#Using_together_with_OpenStreetBugs see OSM wiki]

== Importing Tracks into tangoGPS ==

tangoGPS does not support the import of tracks directly. However the following xslt style sheet can be used to convert gpx tracks - e.g from routing software such as maps.cloudmade.com - to tangogps log files, which can then be imported<br>
At present this style sheet will only convert tracks which make use of the 'wpt' (waypoint) tag. Some software uses the 'trk' (trackpoint) tag. This will be incorporated into the stylesheet at some point. In the meantime, it can be used on the latter type of gpx file by changing 'wpt' to 'trkpt' on line 6.

<pre>
<nowiki>
<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:g="http://www.topografix.com/GPX/1/1">
<xsl:output method="text" omit-xml-declaration="yes"/>
<xsl:template match="g:gpx" >
<xsl:for-each select="g:wpt">
<xsl:value-of select="@lat"/>,<xsl:value-of select="@lon"/>,11.8,1.1,346.0,1.4,2008-12-30T06:46:0<xsl:if test="position()!=last()"><xsl:text>1</xsl:text></xsl:if><xsl:if test="position()=last()"><xsl:text>2</xsl:text></xsl:if>Z
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</nowiki>
</pre>

save this into a file called 'gpx2log.xslt', then run

<pre>
$ xsltproc gpx2log.xslt input_file.gpx > output_file.log
</pre>

move output_file.log to the tangogps traces directory, and use the 'Load...' button on the 'Track' tab to overlay it on the map

Note: this stylesheet was thrown together in a short time, and makes at least one shortcut - namely, the use of 'dummy' variables for various details, such as the altitude, date, etc. Feel free to improve this if required, although it has no bearing on the display of the track

You may help yourself by using [http://relet.net/frog/archives/68 this tool] to import GPX trackpoints as a series of POIs directly into the sqlite database which tangoGPS uses to store POIs.

== Using the TangoGPS logs ==

You can convert the logfiles from TangoGPS to other formats using gpsbabel and this style-file:

<pre>
DESCRIPTION TangoGPS 0.92
EXTENSION log
DATATYPE TRACK

FIELD_DELIMITER COMMA
RECORD_DELIMITER NEWLINE

IFIELD LAT_DECIMAL,"","%f"
IFIELD LON_DECIMAL,"","%f"
IFIELD ALT_METERS,"","%f"
IFIELD PATH_SPEED,"","%f"
IFIELD PATH_COURSE,"","%f"
IFIELD GPS_HDOP,"","%f"
IFIELD ISO_TIME,"","%s"
</pre>

Save this as '''tangogps.style''' and you can use gpsbabel to for instance convert to google-earth files like this:

gpsbabel -i xcsv,style=tangogps.style -o kml -f file.log -F file.kml

== Add POI from address ==

You can use [[gtkaddpoi]] for searching the destination address and add it as a POI.

== Add POI from GeoRSS feed ==

If you would like to import GeoRSS feeds from Google maps or elsewhere as points of interest (POI), read this [http://bonedaddy.net/pabs3/log/2009/05/28/georss-tangogps/ blog post]. Hopefully TangoGPS upstream will include the script soon, but until then and if you aren't using Debian, download this [http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=georss-to-tangogps-poi.py;att=1;bug=530718 script] from the Debian bug tracker.

== Using Google Maps with tangoGPS ==

Go to Config and create a new repository.

Set the url for '''street-maps''' to:
<pre>http://mt1.google.com/mt?&x=%d&y=%d&z=%d</pre>
for '''satellite-maps''' to:
<pre>http://khm.google.com/kh?&x=%d&y=%d&zoom=%d</pre>
for '''topographic-maps''':
<pre>http://mt.google.com/mt?v=app.81&x=%d&y=%d&zoom=%d</pre>

Check the "Inverted Zoom" box. Press save Repository Configuration and you're ready to go.

'''Since TangoGPS 0.9.5''' the "Inverted Zoom" box is no longer available because Google changed the addressing scheme; instead, select "xyz instead of zxy" and use the following URLs:
<pre>
Maps:
http://mt3.google.com/mt/v=w2.89&hl=en&x=%d&y=%d&z=%d&s=Galileo

Sat:
http://khm3.google.com/kh/v=36&hl=en&x=%d&y=%d&z=%d&s=Galileo
</pre>

'''Generalization:''' The above 'Maps' URL isn't the current one anymore, also. Google changes the URL layout sometimes. To find out the current scheme open maps.google.com and view the page source. Search for http:// until you find sth similar to the above URL. This way I found
<pre>
http://mt1.google.com/mt/v=w2.92&hl=en&x=3&y=5&z=4&s=Galile
</pre>

Now you could tweak your configuration unsing the above link (delete the 'amp;' tokens and replace every number with '%d'), for example with
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|\
0,Google Maps (testing only)|http://mt1.google.com/mt/v=w2.92&hl=en&x=%d&y=%d&z=%d&s=Galile|/media/mmcblk0p2/data/maps/googlemaps|1]" \
--type list --list-type string
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[TangoGPS]]|
Description= TangoGPS is a map application which can utilize Neo's built-in GPS to show your current location. It automatically downloads maps from http://openstreetmap.com and you can download map tiles for offline use too.|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org|
TestedOn=Om 2008.8|
PackageName=tangogps
}}
</onlyinclude>

[[Category:GPS Applications]]

TangoGPS

2009-06-28T07:14:26Z

Myfanwy: /* Importing Tracks into tangoGPS */

{{Languages|tangoGPS}}
{{Application|tangoGPS}}

__TOC__

tangoGPS is a map application which can utilize Neo's built-in GPS to show your current location.

[[Image:TangoGPS1.jpg]]

Website: http://www.tangogps.org

== Running tangoGPS ==
=== [[Om 2008.8]] ===

From the freerunner connected to the internet:
<pre>
opkg update
opkg install gpsd
</pre>
{{note|I experienced hangups if gpsd was not installed.}}
<pre>
opkg install http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk
</pre>
If opkg complains about not being able to acquire a lock, try:
<pre>pkill packagekit</pre>
To get gpsd working on the FreeRunner you have to change the configuration according to [[Gpsd#GPS_on_GTA02]].
Then start gpsd by:
<pre>
/etc/init.d/gpsd start
</pre>
If you get an error about no GPS device in /etc/default/gpsd execute:
<pre>
echo "GPS_DEV=\"/dev/ttySAC1\"" > /etc/default/gpsd
</pre>
Now you must power up the GPS-chip by opening the "Settings" application and setting the GPS entry to "on". Now you can run tangoGPS and wait until it get's a GPS fix. This can take up to a few minutes.

=== [[Debian]] ===

The latest version is available in [[Debian]].

It depends on gpsd which conflicts with frameworkd in fso-frameworkd, but there is a package available that provides
the gpsd interface to clients while using the services of the FSO frameworkd daemon, fso-gpsd. The install.sh script for the Debian distribution on the OpenMoko already installs it. To add tangogps run

# apt-get install tangogps

The gps device will be started automatically upon the invocation of tangogps or another gps application, e.g. like the one in [[Zhone]]. For the records, one can manually turn on the gps device using

# echo 1 >/sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron

The tangoGPS applications may appear as "GPS & Map" on various desktops.

'''Issues:'''
* Both gpsd and the framework publish GPS data through dbus, though with different interfaces. This suggests a number of possible solutions.
** gpsd or the framework could implement the other's interface (along with their own).
** a translator could read one interface and emulate the other. This is what fso-gpsd does.
** the framework could have an option to read data from gpsd.
** ogpsd/gypsy could be extended to be backwards compatible with the majority of gps applications.

=== FSO Milestone 3 ([[OpenmokoFramework]]) ===

There are two various GPS interfaces -- (1) one provided with default gpsd and (2) the other provided by ogpsd (part of the frameworkd). tangoGPS requires the ad 1 and it obtains information from gps from the dbus interface provided by gpsd.

On FSO milestone 3, there is tangoGPS pre-installed as well as both gpsd and ogpsd (see <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code>). As mentioned above, there also exists a fso-gpsd package, that converts from ad 2 to ad 1 (unfortunately fso-gpsd is not in default image and must be installed with <code>opkg install fso-gpsd</code>).

You cannot have both "providers" (ad 1 & ad 2) running, but you can have ad 2 (recommended for FSO) and "convertor" (fso-gpsd) providing the ad 1. To get usable tangoGPS on FreeRunner, one has to:

# check that <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code> reads GPS data from the right device (<code>/dev/ttySAC1</code>)
# if changes were made to configuration, one should restart the frameworkd -- <code>/etc/init.d/frameworkd stop && /etc/init.d/frameworkd start</code>
# check that gpsd is not running -- <code>/etc/init.d/gpsd stop</code>
# check that fso-gpsd is installed and running -- <code>opkg install fso-gpsd; fso-gpsd</code>
# check that gps chip is online (<code>echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron</code>)
# finally start up the tangoGPS and locate the gps signal; it should be up in a few minutes.

Note 1: handy application for testing the gps (and gps signal strength) is <code>openmoko-agpsui</code>, see general gps info at [[Gps]]

Note 2: You can automate the process -- (1) remove the startup script for gpsd (<code>update-rc.d -f gpsd remove</code>) and (2) create a simple startup scipt for fso-gpsd (you can use current script for gpsd as a skeleton)

== Downloading Maps ==
=== pre-load for offline use ===

tangoGPS can bunch-download the map images so you don't need an internet connection while walking around. By default tangoGPS stores downloaded maps to /tmp/. This folder is lost every time you reboot the device. But you can use the "Config" tab within tangoGPS to change the "Cache Dir" location to , for example, /osm/ . So downloaded maps will be kept in the Neos flash, also after reboot. Note that the map files can take up large amounts of space, so you may want to store them on your sd card, e.g. in /media/card/osm or /media/mmcblk0p2/data/maps.

If you find that TangoGPS does not remember configuration changes that you make to it, be sure to run it from the touchscreen, and not an SSH session. TangoGPS uses gconf to store its settings, and cannot access gconf when run via SSH.

An alternative way to setup the configuration is through the command line. having /media/mmcblk0p2/data/maps as your data directory you could do the follwing:
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|1]" \
--type list --list-type string
</pre>

Once you have set the location to a non-volatile path, you can connect your Neo to the internet by USB or WiFi at home and start downloading the maps of your area. Tap the map screen and select "map download". Now on-the-road tangoGPS will be able to show you maps in different zoom levels even though you are not connected to the internet.

=== Downloading Maps via GPRS ===
I think tangoGPS may have started working after I followed the instructions to get GPRS working with GSM multiplexing here: [[Manually_using_GPRS#Option_1:_With_GSM_multiplexing_and_with_a_GUI]]

There are steps included in those instructions to improve GPS performance. The great thing is that once you get GPRS working, you can roam with TangoGPS running and have it download maps as needed over the GPRS connection!

=== Updating pre-downloaded maps ===
If you have many maps already downloaded, [[Media:updateMaps.txt|updateMaps.pl]] is a perl script to bring you up-to-date. It's made to work for OSM maps only, but can be adapted to work with any map dataset. See also: [[Yaouh!]].

== Using tangoGPS for OpenStreetMap.org ==
=== creating tracks ===
tangoGPS works fine to create track for Openstreetmap. However, it records and stores a track in its native format, use [http://www.tangogps.org/downloads/convert2gpx.pl convert2gpx.pl] (see also: [http://psung.blogspot.com/2008/07/sharing-gps-tracks-from-tangogps-on.html tools])(you can also use [http://minucci.net/file/convert2gpx.py convert2gpx.py]) to convert the track to GPX (i.e to import into JOSM):

perl convert2gpx.pl 20080903_111508.log > 20080903_111508.gpx

==== tangoGPS logging format ====

<lat>,<lon>,<elevation>,<speed>,<course>,<hdop>,<datetime>

=== using OpenStreetBugs ===
[http://wiki.openstreetmap.org/wiki/TangoGPS#Using_together_with_OpenStreetBugs see OSM wiki]

== Importing Tracks into tangoGPS ==

tangoGPS does not support the import of tracks directly. However the following xslt style sheet can be used to convert gpx tracks - e.g from routing software such as maps.cloudmade.com - to tangogps log files, which can then be imported<br>

<pre>
<nowiki>
<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:g="http://www.topografix.com/GPX/1/1">
<xsl:output method="text" omit-xml-declaration="yes"/>
<xsl:template match="g:gpx" >
<xsl:for-each select="g:wpt">
<xsl:value-of select="@lat"/>,<xsl:value-of select="@lon"/>,11.8,1.1,346.0,1.4,2008-12-30T06:46:0<xsl:if test="position()!=last()"><xsl:text>1</xsl:text></xsl:if><xsl:if test="position()=last()"><xsl:text>2</xsl:text></xsl:if>Z
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</nowiki>
</pre>
save this into a file called 'gpx2log.xslt', then run

<pre>
$ xsltproc gpx2log.xslt input_file.gpx > output_file.log
</pre>

move save output_file.log to the traces

and use the 'Load...' button on the 'Track' tab of tangogps to overlay it on the map

Note: this stylesheet was thrown together in a short time, and makes at least one shortcut - namely, the use of 'dummy' variables for various details, such as the altitude, date, etc. feel free to improve

You may help yourself by using [http://relet.net/frog/archives/68 this tool] to import GPX trackpoints as a series of POIs directly into the sqlite database which tangoGPS uses to store POIs.

== Using the TangoGPS logs ==

You can convert the logfiles from TangoGPS to other formats using gpsbabel and this style-file:

<pre>
DESCRIPTION TangoGPS 0.92
EXTENSION log
DATATYPE TRACK

FIELD_DELIMITER COMMA
RECORD_DELIMITER NEWLINE

IFIELD LAT_DECIMAL,"","%f"
IFIELD LON_DECIMAL,"","%f"
IFIELD ALT_METERS,"","%f"
IFIELD PATH_SPEED,"","%f"
IFIELD PATH_COURSE,"","%f"
IFIELD GPS_HDOP,"","%f"
IFIELD ISO_TIME,"","%s"
</pre>

Save this as '''tangogps.style''' and you can use gpsbabel to for instance convert to google-earth files like this:

gpsbabel -i xcsv,style=tangogps.style -o kml -f file.log -F file.kml

== Add POI from address ==

You can use [[gtkaddpoi]] for searching the destination address and add it as a POI.

== Add POI from GeoRSS feed ==

If you would like to import GeoRSS feeds from Google maps or elsewhere as points of interest (POI), read this [http://bonedaddy.net/pabs3/log/2009/05/28/georss-tangogps/ blog post]. Hopefully TangoGPS upstream will include the script soon, but until then and if you aren't using Debian, download this [http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=georss-to-tangogps-poi.py;att=1;bug=530718 script] from the Debian bug tracker.

== Using Google Maps with tangoGPS ==

Go to Config and create a new repository.

Set the url for '''street-maps''' to:
<pre>http://mt1.google.com/mt?&x=%d&y=%d&z=%d</pre>
for '''satellite-maps''' to:
<pre>http://khm.google.com/kh?&x=%d&y=%d&zoom=%d</pre>
for '''topographic-maps''':
<pre>http://mt.google.com/mt?v=app.81&x=%d&y=%d&zoom=%d</pre>

Check the "Inverted Zoom" box. Press save Repository Configuration and you're ready to go.

'''Since TangoGPS 0.9.5''' the "Inverted Zoom" box is no longer available because Google changed the addressing scheme; instead, select "xyz instead of zxy" and use the following URLs:
<pre>
Maps:
http://mt3.google.com/mt/v=w2.89&hl=en&x=%d&y=%d&z=%d&s=Galileo

Sat:
http://khm3.google.com/kh/v=36&hl=en&x=%d&y=%d&z=%d&s=Galileo
</pre>

'''Generalization:''' The above 'Maps' URL isn't the current one anymore, also. Google changes the URL layout sometimes. To find out the current scheme open maps.google.com and view the page source. Search for http:// until you find sth similar to the above URL. This way I found
<pre>
http://mt1.google.com/mt/v=w2.92&hl=en&x=3&y=5&z=4&s=Galile
</pre>

Now you could tweak your configuration unsing the above link (delete the 'amp;' tokens and replace every number with '%d'), for example with
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|\
0,Google Maps (testing only)|http://mt1.google.com/mt/v=w2.92&hl=en&x=%d&y=%d&z=%d&s=Galile|/media/mmcblk0p2/data/maps/googlemaps|1]" \
--type list --list-type string
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[TangoGPS]]|
Description= TangoGPS is a map application which can utilize Neo's built-in GPS to show your current location. It automatically downloads maps from http://openstreetmap.com and you can download map tiles for offline use too.|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org|
TestedOn=Om 2008.8|
PackageName=tangogps
}}
</onlyinclude>

[[Category:GPS Applications]]

TangoGPS

2009-06-28T06:58:52Z

Myfanwy: /* Importing Tracks into tangoGPS */

{{Languages|tangoGPS}}
{{Application|tangoGPS}}

__TOC__

tangoGPS is a map application which can utilize Neo's built-in GPS to show your current location.

[[Image:TangoGPS1.jpg]]

Website: http://www.tangogps.org

== Running tangoGPS ==
=== [[Om 2008.8]] ===

From the freerunner connected to the internet:
<pre>
opkg update
opkg install gpsd
</pre>
{{note|I experienced hangups if gpsd was not installed.}}
<pre>
opkg install http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk
</pre>
If opkg complains about not being able to acquire a lock, try:
<pre>pkill packagekit</pre>
To get gpsd working on the FreeRunner you have to change the configuration according to [[Gpsd#GPS_on_GTA02]].
Then start gpsd by:
<pre>
/etc/init.d/gpsd start
</pre>
If you get an error about no GPS device in /etc/default/gpsd execute:
<pre>
echo "GPS_DEV=\"/dev/ttySAC1\"" > /etc/default/gpsd
</pre>
Now you must power up the GPS-chip by opening the "Settings" application and setting the GPS entry to "on". Now you can run tangoGPS and wait until it get's a GPS fix. This can take up to a few minutes.

=== [[Debian]] ===

The latest version is available in [[Debian]].

It depends on gpsd which conflicts with frameworkd in fso-frameworkd, but there is a package available that provides
the gpsd interface to clients while using the services of the FSO frameworkd daemon, fso-gpsd. The install.sh script for the Debian distribution on the OpenMoko already installs it. To add tangogps run

# apt-get install tangogps

The gps device will be started automatically upon the invocation of tangogps or another gps application, e.g. like the one in [[Zhone]]. For the records, one can manually turn on the gps device using

# echo 1 >/sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron

The tangoGPS applications may appear as "GPS & Map" on various desktops.

'''Issues:'''
* Both gpsd and the framework publish GPS data through dbus, though with different interfaces. This suggests a number of possible solutions.
** gpsd or the framework could implement the other's interface (along with their own).
** a translator could read one interface and emulate the other. This is what fso-gpsd does.
** the framework could have an option to read data from gpsd.
** ogpsd/gypsy could be extended to be backwards compatible with the majority of gps applications.

=== FSO Milestone 3 ([[OpenmokoFramework]]) ===

There are two various GPS interfaces -- (1) one provided with default gpsd and (2) the other provided by ogpsd (part of the frameworkd). tangoGPS requires the ad 1 and it obtains information from gps from the dbus interface provided by gpsd.

On FSO milestone 3, there is tangoGPS pre-installed as well as both gpsd and ogpsd (see <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code>). As mentioned above, there also exists a fso-gpsd package, that converts from ad 2 to ad 1 (unfortunately fso-gpsd is not in default image and must be installed with <code>opkg install fso-gpsd</code>).

You cannot have both "providers" (ad 1 & ad 2) running, but you can have ad 2 (recommended for FSO) and "convertor" (fso-gpsd) providing the ad 1. To get usable tangoGPS on FreeRunner, one has to:

# check that <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code> reads GPS data from the right device (<code>/dev/ttySAC1</code>)
# if changes were made to configuration, one should restart the frameworkd -- <code>/etc/init.d/frameworkd stop && /etc/init.d/frameworkd start</code>
# check that gpsd is not running -- <code>/etc/init.d/gpsd stop</code>
# check that fso-gpsd is installed and running -- <code>opkg install fso-gpsd; fso-gpsd</code>
# check that gps chip is online (<code>echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron</code>)
# finally start up the tangoGPS and locate the gps signal; it should be up in a few minutes.

Note 1: handy application for testing the gps (and gps signal strength) is <code>openmoko-agpsui</code>, see general gps info at [[Gps]]

Note 2: You can automate the process -- (1) remove the startup script for gpsd (<code>update-rc.d -f gpsd remove</code>) and (2) create a simple startup scipt for fso-gpsd (you can use current script for gpsd as a skeleton)

== Downloading Maps ==
=== pre-load for offline use ===

tangoGPS can bunch-download the map images so you don't need an internet connection while walking around. By default tangoGPS stores downloaded maps to /tmp/. This folder is lost every time you reboot the device. But you can use the "Config" tab within tangoGPS to change the "Cache Dir" location to , for example, /osm/ . So downloaded maps will be kept in the Neos flash, also after reboot. Note that the map files can take up large amounts of space, so you may want to store them on your sd card, e.g. in /media/card/osm or /media/mmcblk0p2/data/maps.

If you find that TangoGPS does not remember configuration changes that you make to it, be sure to run it from the touchscreen, and not an SSH session. TangoGPS uses gconf to store its settings, and cannot access gconf when run via SSH.

An alternative way to setup the configuration is through the command line. having /media/mmcblk0p2/data/maps as your data directory you could do the follwing:
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|1]" \
--type list --list-type string
</pre>

Once you have set the location to a non-volatile path, you can connect your Neo to the internet by USB or WiFi at home and start downloading the maps of your area. Tap the map screen and select "map download". Now on-the-road tangoGPS will be able to show you maps in different zoom levels even though you are not connected to the internet.

=== Downloading Maps via GPRS ===
I think tangoGPS may have started working after I followed the instructions to get GPRS working with GSM multiplexing here: [[Manually_using_GPRS#Option_1:_With_GSM_multiplexing_and_with_a_GUI]]

There are steps included in those instructions to improve GPS performance. The great thing is that once you get GPRS working, you can roam with TangoGPS running and have it download maps as needed over the GPRS connection!

=== Updating pre-downloaded maps ===
If you have many maps already downloaded, [[Media:updateMaps.txt|updateMaps.pl]] is a perl script to bring you up-to-date. It's made to work for OSM maps only, but can be adapted to work with any map dataset. See also: [[Yaouh!]].

== Using tangoGPS for OpenStreetMap.org ==
=== creating tracks ===
tangoGPS works fine to create track for Openstreetmap. However, it records and stores a track in its native format, use [http://www.tangogps.org/downloads/convert2gpx.pl convert2gpx.pl] (see also: [http://psung.blogspot.com/2008/07/sharing-gps-tracks-from-tangogps-on.html tools])(you can also use [http://minucci.net/file/convert2gpx.py convert2gpx.py]) to convert the track to GPX (i.e to import into JOSM):

perl convert2gpx.pl 20080903_111508.log > 20080903_111508.gpx

==== tangoGPS logging format ====

<lat>,<lon>,<elevation>,<speed>,<course>,<hdop>,<datetime>

=== using OpenStreetBugs ===
[http://wiki.openstreetmap.org/wiki/TangoGPS#Using_together_with_OpenStreetBugs see OSM wiki]

== Importing Tracks into tangoGPS ==

tangoGPS does not support the import of tracks directly. However the following xslt style sheet can be used to convert gpx tracks - e.g from routing software such as maps.cloudmade.com - to tangogps log files, which can then be imported<br>

<nowiki>

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:g="http://www.topografix.com/GPX/1/1">
<xsl:output method="text" omit-xml-declaration="yes"/>
<xsl:template match="g:gpx" >
<xsl:for-each select="g:wpt">
<xsl:value-of select="@lat"/>,<xsl:value-of select="@lon"/>,11.8,1.1,346.0,1.4,2008-12-30T06:46:0<xsl:if test="position()!=last()"><xsl:text>1</xsl:text></xsl:if><xsl:if test="position()=last()"><xsl:text>2</xsl:text></xsl:if>Z
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</nowiki>
<br>
<br>

save this into a file called 'gpx2log.xslt', then run

<pre>
$ xsltproc gpx2log.xslt input_file.gpx > output_file.log
</pre>

move save output_file.log to the traces

and use the 'Load...' button on the 'Track' tab of tangogps to overlay it on the map

Note: this stylesheet was thrown together in a short time, and makes at least one shortcut - namely, the use of 'dummy' variables for various details, such as the altitude, date, etc. feel free to improve

You may help yourself by using [http://relet.net/frog/archives/68 this tool] to import GPX trackpoints as a series of POIs directly into the sqlite database which tangoGPS uses to store POIs.

== Using the TangoGPS logs ==

You can convert the logfiles from TangoGPS to other formats using gpsbabel and this style-file:

<pre>
DESCRIPTION TangoGPS 0.92
EXTENSION log
DATATYPE TRACK

FIELD_DELIMITER COMMA
RECORD_DELIMITER NEWLINE

IFIELD LAT_DECIMAL,"","%f"
IFIELD LON_DECIMAL,"","%f"
IFIELD ALT_METERS,"","%f"
IFIELD PATH_SPEED,"","%f"
IFIELD PATH_COURSE,"","%f"
IFIELD GPS_HDOP,"","%f"
IFIELD ISO_TIME,"","%s"
</pre>

Save this as '''tangogps.style''' and you can use gpsbabel to for instance convert to google-earth files like this:

gpsbabel -i xcsv,style=tangogps.style -o kml -f file.log -F file.kml

== Add POI from address ==

You can use [[gtkaddpoi]] for searching the destination address and add it as a POI.

== Add POI from GeoRSS feed ==

If you would like to import GeoRSS feeds from Google maps or elsewhere as points of interest (POI), read this [http://bonedaddy.net/pabs3/log/2009/05/28/georss-tangogps/ blog post]. Hopefully TangoGPS upstream will include the script soon, but until then and if you aren't using Debian, download this [http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=georss-to-tangogps-poi.py;att=1;bug=530718 script] from the Debian bug tracker.

== Using Google Maps with tangoGPS ==

Go to Config and create a new repository.

Set the url for '''street-maps''' to:
<pre>http://mt1.google.com/mt?&x=%d&y=%d&z=%d</pre>
for '''satellite-maps''' to:
<pre>http://khm.google.com/kh?&x=%d&y=%d&zoom=%d</pre>
for '''topographic-maps''':
<pre>http://mt.google.com/mt?v=app.81&x=%d&y=%d&zoom=%d</pre>

Check the "Inverted Zoom" box. Press save Repository Configuration and you're ready to go.

'''Since TangoGPS 0.9.5''' the "Inverted Zoom" box is no longer available because Google changed the addressing scheme; instead, select "xyz instead of zxy" and use the following URLs:
<pre>
Maps:
http://mt3.google.com/mt/v=w2.89&hl=en&x=%d&y=%d&z=%d&s=Galileo

Sat:
http://khm3.google.com/kh/v=36&hl=en&x=%d&y=%d&z=%d&s=Galileo
</pre>

'''Generalization:''' The above 'Maps' URL isn't the current one anymore, also. Google changes the URL layout sometimes. To find out the current scheme open maps.google.com and view the page source. Search for http:// until you find sth similar to the above URL. This way I found
<pre>
http://mt1.google.com/mt/v=w2.92&hl=en&x=3&y=5&z=4&s=Galile
</pre>

Now you could tweak your configuration unsing the above link (delete the 'amp;' tokens and replace every number with '%d'), for example with
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|\
0,Google Maps (testing only)|http://mt1.google.com/mt/v=w2.92&hl=en&x=%d&y=%d&z=%d&s=Galile|/media/mmcblk0p2/data/maps/googlemaps|1]" \
--type list --list-type string
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[TangoGPS]]|
Description= TangoGPS is a map application which can utilize Neo's built-in GPS to show your current location. It automatically downloads maps from http://openstreetmap.com and you can download map tiles for offline use too.|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org|
TestedOn=Om 2008.8|
PackageName=tangogps
}}
</onlyinclude>

[[Category:GPS Applications]]

TangoGPS

2009-06-28T06:53:28Z

Myfanwy: /* Importing Tracks into tangoGPS */

{{Languages|tangoGPS}}
{{Application|tangoGPS}}

__TOC__

tangoGPS is a map application which can utilize Neo's built-in GPS to show your current location.

[[Image:TangoGPS1.jpg]]

Website: http://www.tangogps.org

== Running tangoGPS ==
=== [[Om 2008.8]] ===

From the freerunner connected to the internet:
<pre>
opkg update
opkg install gpsd
</pre>
{{note|I experienced hangups if gpsd was not installed.}}
<pre>
opkg install http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk
</pre>
If opkg complains about not being able to acquire a lock, try:
<pre>pkill packagekit</pre>
To get gpsd working on the FreeRunner you have to change the configuration according to [[Gpsd#GPS_on_GTA02]].
Then start gpsd by:
<pre>
/etc/init.d/gpsd start
</pre>
If you get an error about no GPS device in /etc/default/gpsd execute:
<pre>
echo "GPS_DEV=\"/dev/ttySAC1\"" > /etc/default/gpsd
</pre>
Now you must power up the GPS-chip by opening the "Settings" application and setting the GPS entry to "on". Now you can run tangoGPS and wait until it get's a GPS fix. This can take up to a few minutes.

=== [[Debian]] ===

The latest version is available in [[Debian]].

It depends on gpsd which conflicts with frameworkd in fso-frameworkd, but there is a package available that provides
the gpsd interface to clients while using the services of the FSO frameworkd daemon, fso-gpsd. The install.sh script for the Debian distribution on the OpenMoko already installs it. To add tangogps run

# apt-get install tangogps

The gps device will be started automatically upon the invocation of tangogps or another gps application, e.g. like the one in [[Zhone]]. For the records, one can manually turn on the gps device using

# echo 1 >/sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron

The tangoGPS applications may appear as "GPS & Map" on various desktops.

'''Issues:'''
* Both gpsd and the framework publish GPS data through dbus, though with different interfaces. This suggests a number of possible solutions.
** gpsd or the framework could implement the other's interface (along with their own).
** a translator could read one interface and emulate the other. This is what fso-gpsd does.
** the framework could have an option to read data from gpsd.
** ogpsd/gypsy could be extended to be backwards compatible with the majority of gps applications.

=== FSO Milestone 3 ([[OpenmokoFramework]]) ===

There are two various GPS interfaces -- (1) one provided with default gpsd and (2) the other provided by ogpsd (part of the frameworkd). tangoGPS requires the ad 1 and it obtains information from gps from the dbus interface provided by gpsd.

On FSO milestone 3, there is tangoGPS pre-installed as well as both gpsd and ogpsd (see <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code>). As mentioned above, there also exists a fso-gpsd package, that converts from ad 2 to ad 1 (unfortunately fso-gpsd is not in default image and must be installed with <code>opkg install fso-gpsd</code>).

You cannot have both "providers" (ad 1 & ad 2) running, but you can have ad 2 (recommended for FSO) and "convertor" (fso-gpsd) providing the ad 1. To get usable tangoGPS on FreeRunner, one has to:

# check that <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code> reads GPS data from the right device (<code>/dev/ttySAC1</code>)
# if changes were made to configuration, one should restart the frameworkd -- <code>/etc/init.d/frameworkd stop && /etc/init.d/frameworkd start</code>
# check that gpsd is not running -- <code>/etc/init.d/gpsd stop</code>
# check that fso-gpsd is installed and running -- <code>opkg install fso-gpsd; fso-gpsd</code>
# check that gps chip is online (<code>echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron</code>)
# finally start up the tangoGPS and locate the gps signal; it should be up in a few minutes.

Note 1: handy application for testing the gps (and gps signal strength) is <code>openmoko-agpsui</code>, see general gps info at [[Gps]]

Note 2: You can automate the process -- (1) remove the startup script for gpsd (<code>update-rc.d -f gpsd remove</code>) and (2) create a simple startup scipt for fso-gpsd (you can use current script for gpsd as a skeleton)

== Downloading Maps ==
=== pre-load for offline use ===

tangoGPS can bunch-download the map images so you don't need an internet connection while walking around. By default tangoGPS stores downloaded maps to /tmp/. This folder is lost every time you reboot the device. But you can use the "Config" tab within tangoGPS to change the "Cache Dir" location to , for example, /osm/ . So downloaded maps will be kept in the Neos flash, also after reboot. Note that the map files can take up large amounts of space, so you may want to store them on your sd card, e.g. in /media/card/osm or /media/mmcblk0p2/data/maps.

If you find that TangoGPS does not remember configuration changes that you make to it, be sure to run it from the touchscreen, and not an SSH session. TangoGPS uses gconf to store its settings, and cannot access gconf when run via SSH.

An alternative way to setup the configuration is through the command line. having /media/mmcblk0p2/data/maps as your data directory you could do the follwing:
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|1]" \
--type list --list-type string
</pre>

Once you have set the location to a non-volatile path, you can connect your Neo to the internet by USB or WiFi at home and start downloading the maps of your area. Tap the map screen and select "map download". Now on-the-road tangoGPS will be able to show you maps in different zoom levels even though you are not connected to the internet.

=== Downloading Maps via GPRS ===
I think tangoGPS may have started working after I followed the instructions to get GPRS working with GSM multiplexing here: [[Manually_using_GPRS#Option_1:_With_GSM_multiplexing_and_with_a_GUI]]

There are steps included in those instructions to improve GPS performance. The great thing is that once you get GPRS working, you can roam with TangoGPS running and have it download maps as needed over the GPRS connection!

=== Updating pre-downloaded maps ===
If you have many maps already downloaded, [[Media:updateMaps.txt|updateMaps.pl]] is a perl script to bring you up-to-date. It's made to work for OSM maps only, but can be adapted to work with any map dataset. See also: [[Yaouh!]].

== Using tangoGPS for OpenStreetMap.org ==
=== creating tracks ===
tangoGPS works fine to create track for Openstreetmap. However, it records and stores a track in its native format, use [http://www.tangogps.org/downloads/convert2gpx.pl convert2gpx.pl] (see also: [http://psung.blogspot.com/2008/07/sharing-gps-tracks-from-tangogps-on.html tools])(you can also use [http://minucci.net/file/convert2gpx.py convert2gpx.py]) to convert the track to GPX (i.e to import into JOSM):

perl convert2gpx.pl 20080903_111508.log > 20080903_111508.gpx

==== tangoGPS logging format ====

<lat>,<lon>,<elevation>,<speed>,<course>,<hdop>,<datetime>

=== using OpenStreetBugs ===
[http://wiki.openstreetmap.org/wiki/TangoGPS#Using_together_with_OpenStreetBugs see OSM wiki]

== Importing Tracks into tangoGPS ==

tangoGPS does not support the import of tracks directly. However the following xslt style sheet can be used to convert gpx tracks - e.g from routing software such as maps.cloudmade.com - to tangogps log files, which can then be imported<br>

<nowiki>

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:g="http://www.topografix.com/GPX/1/1">
<xsl:output method="text" omit-xml-declaration="yes"/>
<xsl:template match="g:gpx" >
<xsl:for-each select="g:wpt">
<xsl:value-of select="@lat"/>,<xsl:value-of select="@lon"/>,11.8,1.1,346.0,1.4,2008-12-30T06:46:0<xsl:if test="position()!=last()"><xsl:text>1</xsl:text></xsl:if><xsl:if test="position()=last()"><xsl:text>2</xsl:text></xsl:if>Z
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</nowiki>
<br>
<br>

save this into a file called 'gpx2log.xslt', then run

$ xsltproc gpx2log.xslt input_file.gpx > output_file.log

move save output_file.log to the traces

and use the 'Load...' button on the 'Track' tab of tangogps to overlay it on the map

Note: this stylesheet was thrown together in a short time, and makes at least one shortcut - namely, the use of 'dummy' variables for various details, such as the altitude, date, etc. feel free to improve

You may help yourself by using [http://relet.net/frog/archives/68 this tool] to import GPX trackpoints as a series of POIs directly into the sqlite database which tangoGPS uses to store POIs.

== Using the TangoGPS logs ==

You can convert the logfiles from TangoGPS to other formats using gpsbabel and this style-file:

<pre>
DESCRIPTION TangoGPS 0.92
EXTENSION log
DATATYPE TRACK

FIELD_DELIMITER COMMA
RECORD_DELIMITER NEWLINE

IFIELD LAT_DECIMAL,"","%f"
IFIELD LON_DECIMAL,"","%f"
IFIELD ALT_METERS,"","%f"
IFIELD PATH_SPEED,"","%f"
IFIELD PATH_COURSE,"","%f"
IFIELD GPS_HDOP,"","%f"
IFIELD ISO_TIME,"","%s"
</pre>

Save this as '''tangogps.style''' and you can use gpsbabel to for instance convert to google-earth files like this:

gpsbabel -i xcsv,style=tangogps.style -o kml -f file.log -F file.kml

== Add POI from address ==

You can use [[gtkaddpoi]] for searching the destination address and add it as a POI.

== Add POI from GeoRSS feed ==

If you would like to import GeoRSS feeds from Google maps or elsewhere as points of interest (POI), read this [http://bonedaddy.net/pabs3/log/2009/05/28/georss-tangogps/ blog post]. Hopefully TangoGPS upstream will include the script soon, but until then and if you aren't using Debian, download this [http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=georss-to-tangogps-poi.py;att=1;bug=530718 script] from the Debian bug tracker.

== Using Google Maps with tangoGPS ==

Go to Config and create a new repository.

Set the url for '''street-maps''' to:
<pre>http://mt1.google.com/mt?&x=%d&y=%d&z=%d</pre>
for '''satellite-maps''' to:
<pre>http://khm.google.com/kh?&x=%d&y=%d&zoom=%d</pre>
for '''topographic-maps''':
<pre>http://mt.google.com/mt?v=app.81&x=%d&y=%d&zoom=%d</pre>

Check the "Inverted Zoom" box. Press save Repository Configuration and you're ready to go.

'''Since TangoGPS 0.9.5''' the "Inverted Zoom" box is no longer available because Google changed the addressing scheme; instead, select "xyz instead of zxy" and use the following URLs:
<pre>
Maps:
http://mt3.google.com/mt/v=w2.89&hl=en&x=%d&y=%d&z=%d&s=Galileo

Sat:
http://khm3.google.com/kh/v=36&hl=en&x=%d&y=%d&z=%d&s=Galileo
</pre>

'''Generalization:''' The above 'Maps' URL isn't the current one anymore, also. Google changes the URL layout sometimes. To find out the current scheme open maps.google.com and view the page source. Search for http:// until you find sth similar to the above URL. This way I found
<pre>
http://mt1.google.com/mt/v=w2.92&hl=en&x=3&y=5&z=4&s=Galile
</pre>

Now you could tweak your configuration unsing the above link (delete the 'amp;' tokens and replace every number with '%d'), for example with
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|\
0,Google Maps (testing only)|http://mt1.google.com/mt/v=w2.92&hl=en&x=%d&y=%d&z=%d&s=Galile|/media/mmcblk0p2/data/maps/googlemaps|1]" \
--type list --list-type string
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[TangoGPS]]|
Description= TangoGPS is a map application which can utilize Neo's built-in GPS to show your current location. It automatically downloads maps from http://openstreetmap.com and you can download map tiles for offline use too.|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org|
TestedOn=Om 2008.8|
PackageName=tangogps
}}
</onlyinclude>

[[Category:GPS Applications]]

TangoGPS

2009-06-28T06:51:20Z

Myfanwy: /* Importing Tracks into tangoGPS */

{{Languages|tangoGPS}}
{{Application|tangoGPS}}

__TOC__

tangoGPS is a map application which can utilize Neo's built-in GPS to show your current location.

[[Image:TangoGPS1.jpg]]

Website: http://www.tangogps.org

== Running tangoGPS ==
=== [[Om 2008.8]] ===

From the freerunner connected to the internet:
<pre>
opkg update
opkg install gpsd
</pre>
{{note|I experienced hangups if gpsd was not installed.}}
<pre>
opkg install http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk
</pre>
If opkg complains about not being able to acquire a lock, try:
<pre>pkill packagekit</pre>
To get gpsd working on the FreeRunner you have to change the configuration according to [[Gpsd#GPS_on_GTA02]].
Then start gpsd by:
<pre>
/etc/init.d/gpsd start
</pre>
If you get an error about no GPS device in /etc/default/gpsd execute:
<pre>
echo "GPS_DEV=\"/dev/ttySAC1\"" > /etc/default/gpsd
</pre>
Now you must power up the GPS-chip by opening the "Settings" application and setting the GPS entry to "on". Now you can run tangoGPS and wait until it get's a GPS fix. This can take up to a few minutes.

=== [[Debian]] ===

The latest version is available in [[Debian]].

It depends on gpsd which conflicts with frameworkd in fso-frameworkd, but there is a package available that provides
the gpsd interface to clients while using the services of the FSO frameworkd daemon, fso-gpsd. The install.sh script for the Debian distribution on the OpenMoko already installs it. To add tangogps run

# apt-get install tangogps

The gps device will be started automatically upon the invocation of tangogps or another gps application, e.g. like the one in [[Zhone]]. For the records, one can manually turn on the gps device using

# echo 1 >/sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron

The tangoGPS applications may appear as "GPS & Map" on various desktops.

'''Issues:'''
* Both gpsd and the framework publish GPS data through dbus, though with different interfaces. This suggests a number of possible solutions.
** gpsd or the framework could implement the other's interface (along with their own).
** a translator could read one interface and emulate the other. This is what fso-gpsd does.
** the framework could have an option to read data from gpsd.
** ogpsd/gypsy could be extended to be backwards compatible with the majority of gps applications.

=== FSO Milestone 3 ([[OpenmokoFramework]]) ===

There are two various GPS interfaces -- (1) one provided with default gpsd and (2) the other provided by ogpsd (part of the frameworkd). tangoGPS requires the ad 1 and it obtains information from gps from the dbus interface provided by gpsd.

On FSO milestone 3, there is tangoGPS pre-installed as well as both gpsd and ogpsd (see <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code>). As mentioned above, there also exists a fso-gpsd package, that converts from ad 2 to ad 1 (unfortunately fso-gpsd is not in default image and must be installed with <code>opkg install fso-gpsd</code>).

You cannot have both "providers" (ad 1 & ad 2) running, but you can have ad 2 (recommended for FSO) and "convertor" (fso-gpsd) providing the ad 1. To get usable tangoGPS on FreeRunner, one has to:

# check that <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code> reads GPS data from the right device (<code>/dev/ttySAC1</code>)
# if changes were made to configuration, one should restart the frameworkd -- <code>/etc/init.d/frameworkd stop && /etc/init.d/frameworkd start</code>
# check that gpsd is not running -- <code>/etc/init.d/gpsd stop</code>
# check that fso-gpsd is installed and running -- <code>opkg install fso-gpsd; fso-gpsd</code>
# check that gps chip is online (<code>echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron</code>)
# finally start up the tangoGPS and locate the gps signal; it should be up in a few minutes.

Note 1: handy application for testing the gps (and gps signal strength) is <code>openmoko-agpsui</code>, see general gps info at [[Gps]]

Note 2: You can automate the process -- (1) remove the startup script for gpsd (<code>update-rc.d -f gpsd remove</code>) and (2) create a simple startup scipt for fso-gpsd (you can use current script for gpsd as a skeleton)

== Downloading Maps ==
=== pre-load for offline use ===

tangoGPS can bunch-download the map images so you don't need an internet connection while walking around. By default tangoGPS stores downloaded maps to /tmp/. This folder is lost every time you reboot the device. But you can use the "Config" tab within tangoGPS to change the "Cache Dir" location to , for example, /osm/ . So downloaded maps will be kept in the Neos flash, also after reboot. Note that the map files can take up large amounts of space, so you may want to store them on your sd card, e.g. in /media/card/osm or /media/mmcblk0p2/data/maps.

If you find that TangoGPS does not remember configuration changes that you make to it, be sure to run it from the touchscreen, and not an SSH session. TangoGPS uses gconf to store its settings, and cannot access gconf when run via SSH.

An alternative way to setup the configuration is through the command line. having /media/mmcblk0p2/data/maps as your data directory you could do the follwing:
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|1]" \
--type list --list-type string
</pre>

Once you have set the location to a non-volatile path, you can connect your Neo to the internet by USB or WiFi at home and start downloading the maps of your area. Tap the map screen and select "map download". Now on-the-road tangoGPS will be able to show you maps in different zoom levels even though you are not connected to the internet.

=== Downloading Maps via GPRS ===
I think tangoGPS may have started working after I followed the instructions to get GPRS working with GSM multiplexing here: [[Manually_using_GPRS#Option_1:_With_GSM_multiplexing_and_with_a_GUI]]

There are steps included in those instructions to improve GPS performance. The great thing is that once you get GPRS working, you can roam with TangoGPS running and have it download maps as needed over the GPRS connection!

=== Updating pre-downloaded maps ===
If you have many maps already downloaded, [[Media:updateMaps.txt|updateMaps.pl]] is a perl script to bring you up-to-date. It's made to work for OSM maps only, but can be adapted to work with any map dataset. See also: [[Yaouh!]].

== Using tangoGPS for OpenStreetMap.org ==
=== creating tracks ===
tangoGPS works fine to create track for Openstreetmap. However, it records and stores a track in its native format, use [http://www.tangogps.org/downloads/convert2gpx.pl convert2gpx.pl] (see also: [http://psung.blogspot.com/2008/07/sharing-gps-tracks-from-tangogps-on.html tools])(you can also use [http://minucci.net/file/convert2gpx.py convert2gpx.py]) to convert the track to GPX (i.e to import into JOSM):

perl convert2gpx.pl 20080903_111508.log > 20080903_111508.gpx

==== tangoGPS logging format ====

<lat>,<lon>,<elevation>,<speed>,<course>,<hdop>,<datetime>

=== using OpenStreetBugs ===
[http://wiki.openstreetmap.org/wiki/TangoGPS#Using_together_with_OpenStreetBugs see OSM wiki]

== Importing Tracks into tangoGPS ==

tangoGPS does not support the import of tracks directly, however the following xslt style sheet can be used to convert gpx tracks to tangogps log files, which can then be imported<br>

<nowiki>

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:g="http://www.topografix.com/GPX/1/1">
<xsl:output method="text" omit-xml-declaration="yes"/>
<xsl:template match="g:gpx" >
<xsl:for-each select="g:wpt">
<xsl:value-of select="@lat"/>,<xsl:value-of select="@lon"/>,11.8,1.1,346.0,1.4,2008-12-30T06:46:0<xsl:if test="position()!=last()"><xsl:text>1</xsl:text></xsl:if><xsl:if test="position()=last()"><xsl:text>2</xsl:text></xsl:if>Z
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</nowiki>
<br>
<br>

save this into a file called 'gpx2log.xslt', then run

$ xsltproc gpx2log.xslt input_file.gpx > output_file.log

move save output_file.log to the traces

and use the 'Load...' button on the 'Track' tab of tangogps to overlay it on the map

Note: this stylesheet was thrown together in a short time, and makes at least one shortcut - namely, the use of 'dummy' variables for various details, such as the altitude, date, etc. feel free to improve

You may help yourself by using [http://relet.net/frog/archives/68 this tool] to import GPX trackpoints as a series of POIs directly into the sqlite database which tangoGPS uses to store POIs.

== Using the TangoGPS logs ==

You can convert the logfiles from TangoGPS to other formats using gpsbabel and this style-file:

<pre>
DESCRIPTION TangoGPS 0.92
EXTENSION log
DATATYPE TRACK

FIELD_DELIMITER COMMA
RECORD_DELIMITER NEWLINE

IFIELD LAT_DECIMAL,"","%f"
IFIELD LON_DECIMAL,"","%f"
IFIELD ALT_METERS,"","%f"
IFIELD PATH_SPEED,"","%f"
IFIELD PATH_COURSE,"","%f"
IFIELD GPS_HDOP,"","%f"
IFIELD ISO_TIME,"","%s"
</pre>

Save this as '''tangogps.style''' and you can use gpsbabel to for instance convert to google-earth files like this:

gpsbabel -i xcsv,style=tangogps.style -o kml -f file.log -F file.kml

== Add POI from address ==

You can use [[gtkaddpoi]] for searching the destination address and add it as a POI.

== Add POI from GeoRSS feed ==

If you would like to import GeoRSS feeds from Google maps or elsewhere as points of interest (POI), read this [http://bonedaddy.net/pabs3/log/2009/05/28/georss-tangogps/ blog post]. Hopefully TangoGPS upstream will include the script soon, but until then and if you aren't using Debian, download this [http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=georss-to-tangogps-poi.py;att=1;bug=530718 script] from the Debian bug tracker.

== Using Google Maps with tangoGPS ==

Go to Config and create a new repository.

Set the url for '''street-maps''' to:
<pre>http://mt1.google.com/mt?&x=%d&y=%d&z=%d</pre>
for '''satellite-maps''' to:
<pre>http://khm.google.com/kh?&x=%d&y=%d&zoom=%d</pre>
for '''topographic-maps''':
<pre>http://mt.google.com/mt?v=app.81&x=%d&y=%d&zoom=%d</pre>

Check the "Inverted Zoom" box. Press save Repository Configuration and you're ready to go.

'''Since TangoGPS 0.9.5''' the "Inverted Zoom" box is no longer available because Google changed the addressing scheme; instead, select "xyz instead of zxy" and use the following URLs:
<pre>
Maps:
http://mt3.google.com/mt/v=w2.89&hl=en&x=%d&y=%d&z=%d&s=Galileo

Sat:
http://khm3.google.com/kh/v=36&hl=en&x=%d&y=%d&z=%d&s=Galileo
</pre>

'''Generalization:''' The above 'Maps' URL isn't the current one anymore, also. Google changes the URL layout sometimes. To find out the current scheme open maps.google.com and view the page source. Search for http:// until you find sth similar to the above URL. This way I found
<pre>
http://mt1.google.com/mt/v=w2.92&hl=en&x=3&y=5&z=4&s=Galile
</pre>

Now you could tweak your configuration unsing the above link (delete the 'amp;' tokens and replace every number with '%d'), for example with
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|\
0,Google Maps (testing only)|http://mt1.google.com/mt/v=w2.92&hl=en&x=%d&y=%d&z=%d&s=Galile|/media/mmcblk0p2/data/maps/googlemaps|1]" \
--type list --list-type string
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[TangoGPS]]|
Description= TangoGPS is a map application which can utilize Neo's built-in GPS to show your current location. It automatically downloads maps from http://openstreetmap.com and you can download map tiles for offline use too.|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org|
TestedOn=Om 2008.8|
PackageName=tangogps
}}
</onlyinclude>

[[Category:GPS Applications]]

TangoGPS

2009-06-28T06:46:03Z

Myfanwy: /* Importing Tracks into tangoGPS */

{{Languages|tangoGPS}}
{{Application|tangoGPS}}

__TOC__

tangoGPS is a map application which can utilize Neo's built-in GPS to show your current location.

[[Image:TangoGPS1.jpg]]

Website: http://www.tangogps.org

== Running tangoGPS ==
=== [[Om 2008.8]] ===

From the freerunner connected to the internet:
<pre>
opkg update
opkg install gpsd
</pre>
{{note|I experienced hangups if gpsd was not installed.}}
<pre>
opkg install http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk
</pre>
If opkg complains about not being able to acquire a lock, try:
<pre>pkill packagekit</pre>
To get gpsd working on the FreeRunner you have to change the configuration according to [[Gpsd#GPS_on_GTA02]].
Then start gpsd by:
<pre>
/etc/init.d/gpsd start
</pre>
If you get an error about no GPS device in /etc/default/gpsd execute:
<pre>
echo "GPS_DEV=\"/dev/ttySAC1\"" > /etc/default/gpsd
</pre>
Now you must power up the GPS-chip by opening the "Settings" application and setting the GPS entry to "on". Now you can run tangoGPS and wait until it get's a GPS fix. This can take up to a few minutes.

=== [[Debian]] ===

The latest version is available in [[Debian]].

It depends on gpsd which conflicts with frameworkd in fso-frameworkd, but there is a package available that provides
the gpsd interface to clients while using the services of the FSO frameworkd daemon, fso-gpsd. The install.sh script for the Debian distribution on the OpenMoko already installs it. To add tangogps run

# apt-get install tangogps

The gps device will be started automatically upon the invocation of tangogps or another gps application, e.g. like the one in [[Zhone]]. For the records, one can manually turn on the gps device using

# echo 1 >/sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron

The tangoGPS applications may appear as "GPS & Map" on various desktops.

'''Issues:'''
* Both gpsd and the framework publish GPS data through dbus, though with different interfaces. This suggests a number of possible solutions.
** gpsd or the framework could implement the other's interface (along with their own).
** a translator could read one interface and emulate the other. This is what fso-gpsd does.
** the framework could have an option to read data from gpsd.
** ogpsd/gypsy could be extended to be backwards compatible with the majority of gps applications.

=== FSO Milestone 3 ([[OpenmokoFramework]]) ===

There are two various GPS interfaces -- (1) one provided with default gpsd and (2) the other provided by ogpsd (part of the frameworkd). tangoGPS requires the ad 1 and it obtains information from gps from the dbus interface provided by gpsd.

On FSO milestone 3, there is tangoGPS pre-installed as well as both gpsd and ogpsd (see <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code>). As mentioned above, there also exists a fso-gpsd package, that converts from ad 2 to ad 1 (unfortunately fso-gpsd is not in default image and must be installed with <code>opkg install fso-gpsd</code>).

You cannot have both "providers" (ad 1 & ad 2) running, but you can have ad 2 (recommended for FSO) and "convertor" (fso-gpsd) providing the ad 1. To get usable tangoGPS on FreeRunner, one has to:

# check that <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code> reads GPS data from the right device (<code>/dev/ttySAC1</code>)
# if changes were made to configuration, one should restart the frameworkd -- <code>/etc/init.d/frameworkd stop && /etc/init.d/frameworkd start</code>
# check that gpsd is not running -- <code>/etc/init.d/gpsd stop</code>
# check that fso-gpsd is installed and running -- <code>opkg install fso-gpsd; fso-gpsd</code>
# check that gps chip is online (<code>echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron</code>)
# finally start up the tangoGPS and locate the gps signal; it should be up in a few minutes.

Note 1: handy application for testing the gps (and gps signal strength) is <code>openmoko-agpsui</code>, see general gps info at [[Gps]]

Note 2: You can automate the process -- (1) remove the startup script for gpsd (<code>update-rc.d -f gpsd remove</code>) and (2) create a simple startup scipt for fso-gpsd (you can use current script for gpsd as a skeleton)

== Downloading Maps ==
=== pre-load for offline use ===

tangoGPS can bunch-download the map images so you don't need an internet connection while walking around. By default tangoGPS stores downloaded maps to /tmp/. This folder is lost every time you reboot the device. But you can use the "Config" tab within tangoGPS to change the "Cache Dir" location to , for example, /osm/ . So downloaded maps will be kept in the Neos flash, also after reboot. Note that the map files can take up large amounts of space, so you may want to store them on your sd card, e.g. in /media/card/osm or /media/mmcblk0p2/data/maps.

If you find that TangoGPS does not remember configuration changes that you make to it, be sure to run it from the touchscreen, and not an SSH session. TangoGPS uses gconf to store its settings, and cannot access gconf when run via SSH.

An alternative way to setup the configuration is through the command line. having /media/mmcblk0p2/data/maps as your data directory you could do the follwing:
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|1]" \
--type list --list-type string
</pre>

Once you have set the location to a non-volatile path, you can connect your Neo to the internet by USB or WiFi at home and start downloading the maps of your area. Tap the map screen and select "map download". Now on-the-road tangoGPS will be able to show you maps in different zoom levels even though you are not connected to the internet.

=== Downloading Maps via GPRS ===
I think tangoGPS may have started working after I followed the instructions to get GPRS working with GSM multiplexing here: [[Manually_using_GPRS#Option_1:_With_GSM_multiplexing_and_with_a_GUI]]

There are steps included in those instructions to improve GPS performance. The great thing is that once you get GPRS working, you can roam with TangoGPS running and have it download maps as needed over the GPRS connection!

=== Updating pre-downloaded maps ===
If you have many maps already downloaded, [[Media:updateMaps.txt|updateMaps.pl]] is a perl script to bring you up-to-date. It's made to work for OSM maps only, but can be adapted to work with any map dataset. See also: [[Yaouh!]].

== Using tangoGPS for OpenStreetMap.org ==
=== creating tracks ===
tangoGPS works fine to create track for Openstreetmap. However, it records and stores a track in its native format, use [http://www.tangogps.org/downloads/convert2gpx.pl convert2gpx.pl] (see also: [http://psung.blogspot.com/2008/07/sharing-gps-tracks-from-tangogps-on.html tools])(you can also use [http://minucci.net/file/convert2gpx.py convert2gpx.py]) to convert the track to GPX (i.e to import into JOSM):

perl convert2gpx.pl 20080903_111508.log > 20080903_111508.gpx

==== tangoGPS logging format ====

<lat>,<lon>,<elevation>,<speed>,<course>,<hdop>,<datetime>

=== using OpenStreetBugs ===
[http://wiki.openstreetmap.org/wiki/TangoGPS#Using_together_with_OpenStreetBugs see OSM wiki]

== Importing Tracks into tangoGPS ==

tangoGPS does not support the import of tracks directly, however the following xslt style sheet can be used to convert gpx tracks to tangogps log files, which can then be imported<br>

<nowiki>

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:g="http://www.topografix.com/GPX/1/1">
<xsl:output method="text" omit-xml-declaration="yes"/>
<xsl:template match="g:gpx" >
<xsl:for-each select="g:wpt">
<xsl:value-of select="@lat"/>,<xsl:value-of select="@lon"/>,11.8,1.1,346.0,1.4,2008-12-30T06:46:0<xsl:if test="position()!=last()"><xsl:text>1</xsl:text></xsl:if><xsl:if test="position()=last()"><xsl:text>2</xsl:text></xsl:if>Z
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</nowiki>
<br>
save this into a file called 'gpx2log.xslt', then run

$ xsltproc gpx2log.xslt input_file.gpx > output_file.log

move save output_file.log to the traces

and use the 'Load...' button on the 'Track' tab of tangogps to overlay it on the map

Note: this stylesheet was thrown together in a short time, and makes at least one shortcut - namely, the use of 'dummy' variables for various details, such as the altitude, date, etc. feel free to improve

You may help yourself by using [http://relet.net/frog/archives/68 this tool] to import GPX trackpoints as a series of POIs directly into the sqlite database which tangoGPS uses to store POIs.

== Using the TangoGPS logs ==

You can convert the logfiles from TangoGPS to other formats using gpsbabel and this style-file:

<pre>
DESCRIPTION TangoGPS 0.92
EXTENSION log
DATATYPE TRACK

FIELD_DELIMITER COMMA
RECORD_DELIMITER NEWLINE

IFIELD LAT_DECIMAL,"","%f"
IFIELD LON_DECIMAL,"","%f"
IFIELD ALT_METERS,"","%f"
IFIELD PATH_SPEED,"","%f"
IFIELD PATH_COURSE,"","%f"
IFIELD GPS_HDOP,"","%f"
IFIELD ISO_TIME,"","%s"
</pre>

Save this as '''tangogps.style''' and you can use gpsbabel to for instance convert to google-earth files like this:

gpsbabel -i xcsv,style=tangogps.style -o kml -f file.log -F file.kml

== Add POI from address ==

You can use [[gtkaddpoi]] for searching the destination address and add it as a POI.

== Add POI from GeoRSS feed ==

If you would like to import GeoRSS feeds from Google maps or elsewhere as points of interest (POI), read this [http://bonedaddy.net/pabs3/log/2009/05/28/georss-tangogps/ blog post]. Hopefully TangoGPS upstream will include the script soon, but until then and if you aren't using Debian, download this [http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=georss-to-tangogps-poi.py;att=1;bug=530718 script] from the Debian bug tracker.

== Using Google Maps with tangoGPS ==

Go to Config and create a new repository.

Set the url for '''street-maps''' to:
<pre>http://mt1.google.com/mt?&x=%d&y=%d&z=%d</pre>
for '''satellite-maps''' to:
<pre>http://khm.google.com/kh?&x=%d&y=%d&zoom=%d</pre>
for '''topographic-maps''':
<pre>http://mt.google.com/mt?v=app.81&x=%d&y=%d&zoom=%d</pre>

Check the "Inverted Zoom" box. Press save Repository Configuration and you're ready to go.

'''Since TangoGPS 0.9.5''' the "Inverted Zoom" box is no longer available because Google changed the addressing scheme; instead, select "xyz instead of zxy" and use the following URLs:
<pre>
Maps:
http://mt3.google.com/mt/v=w2.89&hl=en&x=%d&y=%d&z=%d&s=Galileo

Sat:
http://khm3.google.com/kh/v=36&hl=en&x=%d&y=%d&z=%d&s=Galileo
</pre>

'''Generalization:''' The above 'Maps' URL isn't the current one anymore, also. Google changes the URL layout sometimes. To find out the current scheme open maps.google.com and view the page source. Search for http:// until you find sth similar to the above URL. This way I found
<pre>
http://mt1.google.com/mt/v=w2.92&hl=en&x=3&y=5&z=4&s=Galile
</pre>

Now you could tweak your configuration unsing the above link (delete the 'amp;' tokens and replace every number with '%d'), for example with
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|\
0,Google Maps (testing only)|http://mt1.google.com/mt/v=w2.92&hl=en&x=%d&y=%d&z=%d&s=Galile|/media/mmcblk0p2/data/maps/googlemaps|1]" \
--type list --list-type string
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[TangoGPS]]|
Description= TangoGPS is a map application which can utilize Neo's built-in GPS to show your current location. It automatically downloads maps from http://openstreetmap.com and you can download map tiles for offline use too.|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org|
TestedOn=Om 2008.8|
PackageName=tangogps
}}
</onlyinclude>

[[Category:GPS Applications]]

TangoGPS

2009-06-28T06:43:24Z

Myfanwy: /* Importing Tracks into tangoGPS */

{{Languages|tangoGPS}}
{{Application|tangoGPS}}

__TOC__

tangoGPS is a map application which can utilize Neo's built-in GPS to show your current location.

[[Image:TangoGPS1.jpg]]

Website: http://www.tangogps.org

== Running tangoGPS ==
=== [[Om 2008.8]] ===

From the freerunner connected to the internet:
<pre>
opkg update
opkg install gpsd
</pre>
{{note|I experienced hangups if gpsd was not installed.}}
<pre>
opkg install http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk
</pre>
If opkg complains about not being able to acquire a lock, try:
<pre>pkill packagekit</pre>
To get gpsd working on the FreeRunner you have to change the configuration according to [[Gpsd#GPS_on_GTA02]].
Then start gpsd by:
<pre>
/etc/init.d/gpsd start
</pre>
If you get an error about no GPS device in /etc/default/gpsd execute:
<pre>
echo "GPS_DEV=\"/dev/ttySAC1\"" > /etc/default/gpsd
</pre>
Now you must power up the GPS-chip by opening the "Settings" application and setting the GPS entry to "on". Now you can run tangoGPS and wait until it get's a GPS fix. This can take up to a few minutes.

=== [[Debian]] ===

The latest version is available in [[Debian]].

It depends on gpsd which conflicts with frameworkd in fso-frameworkd, but there is a package available that provides
the gpsd interface to clients while using the services of the FSO frameworkd daemon, fso-gpsd. The install.sh script for the Debian distribution on the OpenMoko already installs it. To add tangogps run

# apt-get install tangogps

The gps device will be started automatically upon the invocation of tangogps or another gps application, e.g. like the one in [[Zhone]]. For the records, one can manually turn on the gps device using

# echo 1 >/sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron

The tangoGPS applications may appear as "GPS & Map" on various desktops.

'''Issues:'''
* Both gpsd and the framework publish GPS data through dbus, though with different interfaces. This suggests a number of possible solutions.
** gpsd or the framework could implement the other's interface (along with their own).
** a translator could read one interface and emulate the other. This is what fso-gpsd does.
** the framework could have an option to read data from gpsd.
** ogpsd/gypsy could be extended to be backwards compatible with the majority of gps applications.

=== FSO Milestone 3 ([[OpenmokoFramework]]) ===

There are two various GPS interfaces -- (1) one provided with default gpsd and (2) the other provided by ogpsd (part of the frameworkd). tangoGPS requires the ad 1 and it obtains information from gps from the dbus interface provided by gpsd.

On FSO milestone 3, there is tangoGPS pre-installed as well as both gpsd and ogpsd (see <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code>). As mentioned above, there also exists a fso-gpsd package, that converts from ad 2 to ad 1 (unfortunately fso-gpsd is not in default image and must be installed with <code>opkg install fso-gpsd</code>).

You cannot have both "providers" (ad 1 & ad 2) running, but you can have ad 2 (recommended for FSO) and "convertor" (fso-gpsd) providing the ad 1. To get usable tangoGPS on FreeRunner, one has to:

# check that <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code> reads GPS data from the right device (<code>/dev/ttySAC1</code>)
# if changes were made to configuration, one should restart the frameworkd -- <code>/etc/init.d/frameworkd stop && /etc/init.d/frameworkd start</code>
# check that gpsd is not running -- <code>/etc/init.d/gpsd stop</code>
# check that fso-gpsd is installed and running -- <code>opkg install fso-gpsd; fso-gpsd</code>
# check that gps chip is online (<code>echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron</code>)
# finally start up the tangoGPS and locate the gps signal; it should be up in a few minutes.

Note 1: handy application for testing the gps (and gps signal strength) is <code>openmoko-agpsui</code>, see general gps info at [[Gps]]

Note 2: You can automate the process -- (1) remove the startup script for gpsd (<code>update-rc.d -f gpsd remove</code>) and (2) create a simple startup scipt for fso-gpsd (you can use current script for gpsd as a skeleton)

== Downloading Maps ==
=== pre-load for offline use ===

tangoGPS can bunch-download the map images so you don't need an internet connection while walking around. By default tangoGPS stores downloaded maps to /tmp/. This folder is lost every time you reboot the device. But you can use the "Config" tab within tangoGPS to change the "Cache Dir" location to , for example, /osm/ . So downloaded maps will be kept in the Neos flash, also after reboot. Note that the map files can take up large amounts of space, so you may want to store them on your sd card, e.g. in /media/card/osm or /media/mmcblk0p2/data/maps.

If you find that TangoGPS does not remember configuration changes that you make to it, be sure to run it from the touchscreen, and not an SSH session. TangoGPS uses gconf to store its settings, and cannot access gconf when run via SSH.

An alternative way to setup the configuration is through the command line. having /media/mmcblk0p2/data/maps as your data directory you could do the follwing:
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|1]" \
--type list --list-type string
</pre>

Once you have set the location to a non-volatile path, you can connect your Neo to the internet by USB or WiFi at home and start downloading the maps of your area. Tap the map screen and select "map download". Now on-the-road tangoGPS will be able to show you maps in different zoom levels even though you are not connected to the internet.

=== Downloading Maps via GPRS ===
I think tangoGPS may have started working after I followed the instructions to get GPRS working with GSM multiplexing here: [[Manually_using_GPRS#Option_1:_With_GSM_multiplexing_and_with_a_GUI]]

There are steps included in those instructions to improve GPS performance. The great thing is that once you get GPRS working, you can roam with TangoGPS running and have it download maps as needed over the GPRS connection!

=== Updating pre-downloaded maps ===
If you have many maps already downloaded, [[Media:updateMaps.txt|updateMaps.pl]] is a perl script to bring you up-to-date. It's made to work for OSM maps only, but can be adapted to work with any map dataset. See also: [[Yaouh!]].

== Using tangoGPS for OpenStreetMap.org ==
=== creating tracks ===
tangoGPS works fine to create track for Openstreetmap. However, it records and stores a track in its native format, use [http://www.tangogps.org/downloads/convert2gpx.pl convert2gpx.pl] (see also: [http://psung.blogspot.com/2008/07/sharing-gps-tracks-from-tangogps-on.html tools])(you can also use [http://minucci.net/file/convert2gpx.py convert2gpx.py]) to convert the track to GPX (i.e to import into JOSM):

perl convert2gpx.pl 20080903_111508.log > 20080903_111508.gpx

==== tangoGPS logging format ====

<lat>,<lon>,<elevation>,<speed>,<course>,<hdop>,<datetime>

=== using OpenStreetBugs ===
[http://wiki.openstreetmap.org/wiki/TangoGPS#Using_together_with_OpenStreetBugs see OSM wiki]

== Importing Tracks into tangoGPS ==

tangoGPS does not support the import of tracks directly, however the following xslt style sheet can be used to convert gpx tracks to tangogps log files, which can then be imported<br>

<nowiki>

<?xml version="1.0" encoding="ISO-8859-1"?>

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:g="http://www.topografix.com/GPX/1/1">

<xsl:output method="text" omit-xml-declaration="yes"/>

<xsl:template match="g:gpx" >

<xsl:for-each select="g:wpt">

<xsl:value-of select="@lat"/>,<xsl:value-of select="@lon"/>,11.8,1.1,346.0,1.4,2008-12-30T06:46:0<xsl:if test="position()!=last()"><xsl:text>1</xsl:text></xsl:if><xsl:if test="position()=last()"><xsl:text>2</xsl:text></xsl:if>Z

</xsl:for-each>

</xsl:template>

</xsl:stylesheet>
</nowiki>

<br>
save this into a file called 'gpx2log.xslt', then run

$ xsltproc gpx2log.xslt input_file.gpx > output_file.log

move save output_file.log to the traces

and use the 'Load...' button on the 'Track' tab of tangogps to overlay it on the map

Note: this stylesheet was thrown together in a short time, and makes at least one shortcut - namely, the use of 'dummy' variables for various details, such as the altitude, date, etc. feel free to improve

You may help yourself by using [http://relet.net/frog/archives/68 this tool] to import GPX trackpoints as a series of POIs directly into the sqlite database which tangoGPS uses to store POIs.

== Using the TangoGPS logs ==

You can convert the logfiles from TangoGPS to other formats using gpsbabel and this style-file:

<pre>
DESCRIPTION TangoGPS 0.92
EXTENSION log
DATATYPE TRACK

FIELD_DELIMITER COMMA
RECORD_DELIMITER NEWLINE

IFIELD LAT_DECIMAL,"","%f"
IFIELD LON_DECIMAL,"","%f"
IFIELD ALT_METERS,"","%f"
IFIELD PATH_SPEED,"","%f"
IFIELD PATH_COURSE,"","%f"
IFIELD GPS_HDOP,"","%f"
IFIELD ISO_TIME,"","%s"
</pre>

Save this as '''tangogps.style''' and you can use gpsbabel to for instance convert to google-earth files like this:

gpsbabel -i xcsv,style=tangogps.style -o kml -f file.log -F file.kml

== Add POI from address ==

You can use [[gtkaddpoi]] for searching the destination address and add it as a POI.

== Add POI from GeoRSS feed ==

If you would like to import GeoRSS feeds from Google maps or elsewhere as points of interest (POI), read this [http://bonedaddy.net/pabs3/log/2009/05/28/georss-tangogps/ blog post]. Hopefully TangoGPS upstream will include the script soon, but until then and if you aren't using Debian, download this [http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=georss-to-tangogps-poi.py;att=1;bug=530718 script] from the Debian bug tracker.

== Using Google Maps with tangoGPS ==

Go to Config and create a new repository.

Set the url for '''street-maps''' to:
<pre>http://mt1.google.com/mt?&x=%d&y=%d&z=%d</pre>
for '''satellite-maps''' to:
<pre>http://khm.google.com/kh?&x=%d&y=%d&zoom=%d</pre>
for '''topographic-maps''':
<pre>http://mt.google.com/mt?v=app.81&x=%d&y=%d&zoom=%d</pre>

Check the "Inverted Zoom" box. Press save Repository Configuration and you're ready to go.

'''Since TangoGPS 0.9.5''' the "Inverted Zoom" box is no longer available because Google changed the addressing scheme; instead, select "xyz instead of zxy" and use the following URLs:
<pre>
Maps:
http://mt3.google.com/mt/v=w2.89&hl=en&x=%d&y=%d&z=%d&s=Galileo

Sat:
http://khm3.google.com/kh/v=36&hl=en&x=%d&y=%d&z=%d&s=Galileo
</pre>

'''Generalization:''' The above 'Maps' URL isn't the current one anymore, also. Google changes the URL layout sometimes. To find out the current scheme open maps.google.com and view the page source. Search for http:// until you find sth similar to the above URL. This way I found
<pre>
http://mt1.google.com/mt/v=w2.92&hl=en&x=3&y=5&z=4&s=Galile
</pre>

Now you could tweak your configuration unsing the above link (delete the 'amp;' tokens and replace every number with '%d'), for example with
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|\
0,Google Maps (testing only)|http://mt1.google.com/mt/v=w2.92&hl=en&x=%d&y=%d&z=%d&s=Galile|/media/mmcblk0p2/data/maps/googlemaps|1]" \
--type list --list-type string
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[TangoGPS]]|
Description= TangoGPS is a map application which can utilize Neo's built-in GPS to show your current location. It automatically downloads maps from http://openstreetmap.com and you can download map tiles for offline use too.|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org|
TestedOn=Om 2008.8|
PackageName=tangogps
}}
</onlyinclude>

[[Category:GPS Applications]]

TangoGPS

2009-06-28T06:42:51Z

Myfanwy: /* Importing Tracks into tangoGPS */

{{Languages|tangoGPS}}
{{Application|tangoGPS}}

__TOC__

tangoGPS is a map application which can utilize Neo's built-in GPS to show your current location.

[[Image:TangoGPS1.jpg]]

Website: http://www.tangogps.org

== Running tangoGPS ==
=== [[Om 2008.8]] ===

From the freerunner connected to the internet:
<pre>
opkg update
opkg install gpsd
</pre>
{{note|I experienced hangups if gpsd was not installed.}}
<pre>
opkg install http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk
</pre>
If opkg complains about not being able to acquire a lock, try:
<pre>pkill packagekit</pre>
To get gpsd working on the FreeRunner you have to change the configuration according to [[Gpsd#GPS_on_GTA02]].
Then start gpsd by:
<pre>
/etc/init.d/gpsd start
</pre>
If you get an error about no GPS device in /etc/default/gpsd execute:
<pre>
echo "GPS_DEV=\"/dev/ttySAC1\"" > /etc/default/gpsd
</pre>
Now you must power up the GPS-chip by opening the "Settings" application and setting the GPS entry to "on". Now you can run tangoGPS and wait until it get's a GPS fix. This can take up to a few minutes.

=== [[Debian]] ===

The latest version is available in [[Debian]].

It depends on gpsd which conflicts with frameworkd in fso-frameworkd, but there is a package available that provides
the gpsd interface to clients while using the services of the FSO frameworkd daemon, fso-gpsd. The install.sh script for the Debian distribution on the OpenMoko already installs it. To add tangogps run

# apt-get install tangogps

The gps device will be started automatically upon the invocation of tangogps or another gps application, e.g. like the one in [[Zhone]]. For the records, one can manually turn on the gps device using

# echo 1 >/sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron

The tangoGPS applications may appear as "GPS & Map" on various desktops.

'''Issues:'''
* Both gpsd and the framework publish GPS data through dbus, though with different interfaces. This suggests a number of possible solutions.
** gpsd or the framework could implement the other's interface (along with their own).
** a translator could read one interface and emulate the other. This is what fso-gpsd does.
** the framework could have an option to read data from gpsd.
** ogpsd/gypsy could be extended to be backwards compatible with the majority of gps applications.

=== FSO Milestone 3 ([[OpenmokoFramework]]) ===

There are two various GPS interfaces -- (1) one provided with default gpsd and (2) the other provided by ogpsd (part of the frameworkd). tangoGPS requires the ad 1 and it obtains information from gps from the dbus interface provided by gpsd.

On FSO milestone 3, there is tangoGPS pre-installed as well as both gpsd and ogpsd (see <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code>). As mentioned above, there also exists a fso-gpsd package, that converts from ad 2 to ad 1 (unfortunately fso-gpsd is not in default image and must be installed with <code>opkg install fso-gpsd</code>).

You cannot have both "providers" (ad 1 & ad 2) running, but you can have ad 2 (recommended for FSO) and "convertor" (fso-gpsd) providing the ad 1. To get usable tangoGPS on FreeRunner, one has to:

# check that <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code> reads GPS data from the right device (<code>/dev/ttySAC1</code>)
# if changes were made to configuration, one should restart the frameworkd -- <code>/etc/init.d/frameworkd stop && /etc/init.d/frameworkd start</code>
# check that gpsd is not running -- <code>/etc/init.d/gpsd stop</code>
# check that fso-gpsd is installed and running -- <code>opkg install fso-gpsd; fso-gpsd</code>
# check that gps chip is online (<code>echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron</code>)
# finally start up the tangoGPS and locate the gps signal; it should be up in a few minutes.

Note 1: handy application for testing the gps (and gps signal strength) is <code>openmoko-agpsui</code>, see general gps info at [[Gps]]

Note 2: You can automate the process -- (1) remove the startup script for gpsd (<code>update-rc.d -f gpsd remove</code>) and (2) create a simple startup scipt for fso-gpsd (you can use current script for gpsd as a skeleton)

== Downloading Maps ==
=== pre-load for offline use ===

tangoGPS can bunch-download the map images so you don't need an internet connection while walking around. By default tangoGPS stores downloaded maps to /tmp/. This folder is lost every time you reboot the device. But you can use the "Config" tab within tangoGPS to change the "Cache Dir" location to , for example, /osm/ . So downloaded maps will be kept in the Neos flash, also after reboot. Note that the map files can take up large amounts of space, so you may want to store them on your sd card, e.g. in /media/card/osm or /media/mmcblk0p2/data/maps.

If you find that TangoGPS does not remember configuration changes that you make to it, be sure to run it from the touchscreen, and not an SSH session. TangoGPS uses gconf to store its settings, and cannot access gconf when run via SSH.

An alternative way to setup the configuration is through the command line. having /media/mmcblk0p2/data/maps as your data directory you could do the follwing:
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|1]" \
--type list --list-type string
</pre>

Once you have set the location to a non-volatile path, you can connect your Neo to the internet by USB or WiFi at home and start downloading the maps of your area. Tap the map screen and select "map download". Now on-the-road tangoGPS will be able to show you maps in different zoom levels even though you are not connected to the internet.

=== Downloading Maps via GPRS ===
I think tangoGPS may have started working after I followed the instructions to get GPRS working with GSM multiplexing here: [[Manually_using_GPRS#Option_1:_With_GSM_multiplexing_and_with_a_GUI]]

There are steps included in those instructions to improve GPS performance. The great thing is that once you get GPRS working, you can roam with TangoGPS running and have it download maps as needed over the GPRS connection!

=== Updating pre-downloaded maps ===
If you have many maps already downloaded, [[Media:updateMaps.txt|updateMaps.pl]] is a perl script to bring you up-to-date. It's made to work for OSM maps only, but can be adapted to work with any map dataset. See also: [[Yaouh!]].

== Using tangoGPS for OpenStreetMap.org ==
=== creating tracks ===
tangoGPS works fine to create track for Openstreetmap. However, it records and stores a track in its native format, use [http://www.tangogps.org/downloads/convert2gpx.pl convert2gpx.pl] (see also: [http://psung.blogspot.com/2008/07/sharing-gps-tracks-from-tangogps-on.html tools])(you can also use [http://minucci.net/file/convert2gpx.py convert2gpx.py]) to convert the track to GPX (i.e to import into JOSM):

perl convert2gpx.pl 20080903_111508.log > 20080903_111508.gpx

==== tangoGPS logging format ====

<lat>,<lon>,<elevation>,<speed>,<course>,<hdop>,<datetime>

=== using OpenStreetBugs ===
[http://wiki.openstreetmap.org/wiki/TangoGPS#Using_together_with_OpenStreetBugs see OSM wiki]

== Importing Tracks into tangoGPS ==

tangoGPS does not support the import of tracks directly, however the following xslt style sheet can be used to convert gpx tracks to tangogps log files, which can then be imported<br>

<nowiki>

<?xml version="1.0" encoding="ISO-8859-1"?><br>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:g="http://www.topografix.com/GPX/1/1">
<xsl:output method="text" omit-xml-declaration="yes"/>
<xsl:template match="g:gpx" >
<xsl:for-each select="g:wpt">
<xsl:value-of select="@lat"/>,<xsl:value-of select="@lon"/>,11.8,1.1,346.0,1.4,2008-12-30T06:46:0<xsl:if test="position()!=last()"><xsl:text>1</xsl:text></xsl:if><xsl:if test="position()=last()"><xsl:text>2</xsl:text></xsl:if>Z
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</nowiki>

<br>
save this into a file called 'gpx2log.xslt', then run

$ xsltproc gpx2log.xslt input_file.gpx > output_file.log

move save output_file.log to the traces

and use the 'Load...' button on the 'Track' tab of tangogps to overlay it on the map

Note: this stylesheet was thrown together in a short time, and makes at least one shortcut - namely, the use of 'dummy' variables for various details, such as the altitude, date, etc. feel free to improve

You may help yourself by using [http://relet.net/frog/archives/68 this tool] to import GPX trackpoints as a series of POIs directly into the sqlite database which tangoGPS uses to store POIs.

== Using the TangoGPS logs ==

You can convert the logfiles from TangoGPS to other formats using gpsbabel and this style-file:

<pre>
DESCRIPTION TangoGPS 0.92
EXTENSION log
DATATYPE TRACK

FIELD_DELIMITER COMMA
RECORD_DELIMITER NEWLINE

IFIELD LAT_DECIMAL,"","%f"
IFIELD LON_DECIMAL,"","%f"
IFIELD ALT_METERS,"","%f"
IFIELD PATH_SPEED,"","%f"
IFIELD PATH_COURSE,"","%f"
IFIELD GPS_HDOP,"","%f"
IFIELD ISO_TIME,"","%s"
</pre>

Save this as '''tangogps.style''' and you can use gpsbabel to for instance convert to google-earth files like this:

gpsbabel -i xcsv,style=tangogps.style -o kml -f file.log -F file.kml

== Add POI from address ==

You can use [[gtkaddpoi]] for searching the destination address and add it as a POI.

== Add POI from GeoRSS feed ==

If you would like to import GeoRSS feeds from Google maps or elsewhere as points of interest (POI), read this [http://bonedaddy.net/pabs3/log/2009/05/28/georss-tangogps/ blog post]. Hopefully TangoGPS upstream will include the script soon, but until then and if you aren't using Debian, download this [http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=georss-to-tangogps-poi.py;att=1;bug=530718 script] from the Debian bug tracker.

== Using Google Maps with tangoGPS ==

Go to Config and create a new repository.

Set the url for '''street-maps''' to:
<pre>http://mt1.google.com/mt?&x=%d&y=%d&z=%d</pre>
for '''satellite-maps''' to:
<pre>http://khm.google.com/kh?&x=%d&y=%d&zoom=%d</pre>
for '''topographic-maps''':
<pre>http://mt.google.com/mt?v=app.81&x=%d&y=%d&zoom=%d</pre>

Check the "Inverted Zoom" box. Press save Repository Configuration and you're ready to go.

'''Since TangoGPS 0.9.5''' the "Inverted Zoom" box is no longer available because Google changed the addressing scheme; instead, select "xyz instead of zxy" and use the following URLs:
<pre>
Maps:
http://mt3.google.com/mt/v=w2.89&hl=en&x=%d&y=%d&z=%d&s=Galileo

Sat:
http://khm3.google.com/kh/v=36&hl=en&x=%d&y=%d&z=%d&s=Galileo
</pre>

'''Generalization:''' The above 'Maps' URL isn't the current one anymore, also. Google changes the URL layout sometimes. To find out the current scheme open maps.google.com and view the page source. Search for http:// until you find sth similar to the above URL. This way I found
<pre>
http://mt1.google.com/mt/v=w2.92&hl=en&x=3&y=5&z=4&s=Galile
</pre>

Now you could tweak your configuration unsing the above link (delete the 'amp;' tokens and replace every number with '%d'), for example with
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|\
0,Google Maps (testing only)|http://mt1.google.com/mt/v=w2.92&hl=en&x=%d&y=%d&z=%d&s=Galile|/media/mmcblk0p2/data/maps/googlemaps|1]" \
--type list --list-type string
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[TangoGPS]]|
Description= TangoGPS is a map application which can utilize Neo's built-in GPS to show your current location. It automatically downloads maps from http://openstreetmap.com and you can download map tiles for offline use too.|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org|
TestedOn=Om 2008.8|
PackageName=tangogps
}}
</onlyinclude>

[[Category:GPS Applications]]

TangoGPS

2009-06-28T06:39:55Z

Myfanwy: /* Importing Tracks into tangoGPS */

{{Languages|tangoGPS}}
{{Application|tangoGPS}}

__TOC__

tangoGPS is a map application which can utilize Neo's built-in GPS to show your current location.

[[Image:TangoGPS1.jpg]]

Website: http://www.tangogps.org

== Running tangoGPS ==
=== [[Om 2008.8]] ===

From the freerunner connected to the internet:
<pre>
opkg update
opkg install gpsd
</pre>
{{note|I experienced hangups if gpsd was not installed.}}
<pre>
opkg install http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk
</pre>
If opkg complains about not being able to acquire a lock, try:
<pre>pkill packagekit</pre>
To get gpsd working on the FreeRunner you have to change the configuration according to [[Gpsd#GPS_on_GTA02]].
Then start gpsd by:
<pre>
/etc/init.d/gpsd start
</pre>
If you get an error about no GPS device in /etc/default/gpsd execute:
<pre>
echo "GPS_DEV=\"/dev/ttySAC1\"" > /etc/default/gpsd
</pre>
Now you must power up the GPS-chip by opening the "Settings" application and setting the GPS entry to "on". Now you can run tangoGPS and wait until it get's a GPS fix. This can take up to a few minutes.

=== [[Debian]] ===

The latest version is available in [[Debian]].

It depends on gpsd which conflicts with frameworkd in fso-frameworkd, but there is a package available that provides
the gpsd interface to clients while using the services of the FSO frameworkd daemon, fso-gpsd. The install.sh script for the Debian distribution on the OpenMoko already installs it. To add tangogps run

# apt-get install tangogps

The gps device will be started automatically upon the invocation of tangogps or another gps application, e.g. like the one in [[Zhone]]. For the records, one can manually turn on the gps device using

# echo 1 >/sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron

The tangoGPS applications may appear as "GPS & Map" on various desktops.

'''Issues:'''
* Both gpsd and the framework publish GPS data through dbus, though with different interfaces. This suggests a number of possible solutions.
** gpsd or the framework could implement the other's interface (along with their own).
** a translator could read one interface and emulate the other. This is what fso-gpsd does.
** the framework could have an option to read data from gpsd.
** ogpsd/gypsy could be extended to be backwards compatible with the majority of gps applications.

=== FSO Milestone 3 ([[OpenmokoFramework]]) ===

There are two various GPS interfaces -- (1) one provided with default gpsd and (2) the other provided by ogpsd (part of the frameworkd). tangoGPS requires the ad 1 and it obtains information from gps from the dbus interface provided by gpsd.

On FSO milestone 3, there is tangoGPS pre-installed as well as both gpsd and ogpsd (see <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code>). As mentioned above, there also exists a fso-gpsd package, that converts from ad 2 to ad 1 (unfortunately fso-gpsd is not in default image and must be installed with <code>opkg install fso-gpsd</code>).

You cannot have both "providers" (ad 1 & ad 2) running, but you can have ad 2 (recommended for FSO) and "convertor" (fso-gpsd) providing the ad 1. To get usable tangoGPS on FreeRunner, one has to:

# check that <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code> reads GPS data from the right device (<code>/dev/ttySAC1</code>)
# if changes were made to configuration, one should restart the frameworkd -- <code>/etc/init.d/frameworkd stop && /etc/init.d/frameworkd start</code>
# check that gpsd is not running -- <code>/etc/init.d/gpsd stop</code>
# check that fso-gpsd is installed and running -- <code>opkg install fso-gpsd; fso-gpsd</code>
# check that gps chip is online (<code>echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron</code>)
# finally start up the tangoGPS and locate the gps signal; it should be up in a few minutes.

Note 1: handy application for testing the gps (and gps signal strength) is <code>openmoko-agpsui</code>, see general gps info at [[Gps]]

Note 2: You can automate the process -- (1) remove the startup script for gpsd (<code>update-rc.d -f gpsd remove</code>) and (2) create a simple startup scipt for fso-gpsd (you can use current script for gpsd as a skeleton)

== Downloading Maps ==
=== pre-load for offline use ===

tangoGPS can bunch-download the map images so you don't need an internet connection while walking around. By default tangoGPS stores downloaded maps to /tmp/. This folder is lost every time you reboot the device. But you can use the "Config" tab within tangoGPS to change the "Cache Dir" location to , for example, /osm/ . So downloaded maps will be kept in the Neos flash, also after reboot. Note that the map files can take up large amounts of space, so you may want to store them on your sd card, e.g. in /media/card/osm or /media/mmcblk0p2/data/maps.

If you find that TangoGPS does not remember configuration changes that you make to it, be sure to run it from the touchscreen, and not an SSH session. TangoGPS uses gconf to store its settings, and cannot access gconf when run via SSH.

An alternative way to setup the configuration is through the command line. having /media/mmcblk0p2/data/maps as your data directory you could do the follwing:
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|1]" \
--type list --list-type string
</pre>

Once you have set the location to a non-volatile path, you can connect your Neo to the internet by USB or WiFi at home and start downloading the maps of your area. Tap the map screen and select "map download". Now on-the-road tangoGPS will be able to show you maps in different zoom levels even though you are not connected to the internet.

=== Downloading Maps via GPRS ===
I think tangoGPS may have started working after I followed the instructions to get GPRS working with GSM multiplexing here: [[Manually_using_GPRS#Option_1:_With_GSM_multiplexing_and_with_a_GUI]]

There are steps included in those instructions to improve GPS performance. The great thing is that once you get GPRS working, you can roam with TangoGPS running and have it download maps as needed over the GPRS connection!

=== Updating pre-downloaded maps ===
If you have many maps already downloaded, [[Media:updateMaps.txt|updateMaps.pl]] is a perl script to bring you up-to-date. It's made to work for OSM maps only, but can be adapted to work with any map dataset. See also: [[Yaouh!]].

== Using tangoGPS for OpenStreetMap.org ==
=== creating tracks ===
tangoGPS works fine to create track for Openstreetmap. However, it records and stores a track in its native format, use [http://www.tangogps.org/downloads/convert2gpx.pl convert2gpx.pl] (see also: [http://psung.blogspot.com/2008/07/sharing-gps-tracks-from-tangogps-on.html tools])(you can also use [http://minucci.net/file/convert2gpx.py convert2gpx.py]) to convert the track to GPX (i.e to import into JOSM):

perl convert2gpx.pl 20080903_111508.log > 20080903_111508.gpx

==== tangoGPS logging format ====

<lat>,<lon>,<elevation>,<speed>,<course>,<hdop>,<datetime>

=== using OpenStreetBugs ===
[http://wiki.openstreetmap.org/wiki/TangoGPS#Using_together_with_OpenStreetBugs see OSM wiki]

== Importing Tracks into tangoGPS ==

tangoGPS does not support the import of tracks directly, however the following xslt style sheet can be used to convert gpx tracks to tangogps log files, which can then be imported<br>

<nowiki>

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:g="http://www.topografix.com/GPX/1/1">
<xsl:output method="text" omit-xml-declaration="yes"/>
<xsl:template match="g:gpx" >
<xsl:for-each select="g:wpt">
<xsl:value-of select="@lat"/>,<xsl:value-of select="@lon"/>,11.8,1.1,346.0,1.4,2008-12-30T06:46:0<xsl:if test="position()!=last()"><xsl:text>1</xsl:text></xsl:if><xsl:if test="position()=last()"><xsl:text>2</xsl:text></xsl:if>Z
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>
</nowiki>

<br>
save this into a file called 'gpx2log.xslt', then run

$ xsltproc gpx2log.xslt input_file.gpx > output_file.log

move save output_file.log to the traces

and use the 'Load...' button on the 'Track' tab of tangogps to overlay it on the map

Note: this stylesheet was thrown together in a short time, and makes at least one shortcut - namely, the use of 'dummy' variables for various details, such as the altitude, date, etc. feel free to improve

You may help yourself by using [http://relet.net/frog/archives/68 this tool] to import GPX trackpoints as a series of POIs directly into the sqlite database which tangoGPS uses to store POIs.

== Using the TangoGPS logs ==

You can convert the logfiles from TangoGPS to other formats using gpsbabel and this style-file:

<pre>
DESCRIPTION TangoGPS 0.92
EXTENSION log
DATATYPE TRACK

FIELD_DELIMITER COMMA
RECORD_DELIMITER NEWLINE

IFIELD LAT_DECIMAL,"","%f"
IFIELD LON_DECIMAL,"","%f"
IFIELD ALT_METERS,"","%f"
IFIELD PATH_SPEED,"","%f"
IFIELD PATH_COURSE,"","%f"
IFIELD GPS_HDOP,"","%f"
IFIELD ISO_TIME,"","%s"
</pre>

Save this as '''tangogps.style''' and you can use gpsbabel to for instance convert to google-earth files like this:

gpsbabel -i xcsv,style=tangogps.style -o kml -f file.log -F file.kml

== Add POI from address ==

You can use [[gtkaddpoi]] for searching the destination address and add it as a POI.

== Add POI from GeoRSS feed ==

If you would like to import GeoRSS feeds from Google maps or elsewhere as points of interest (POI), read this [http://bonedaddy.net/pabs3/log/2009/05/28/georss-tangogps/ blog post]. Hopefully TangoGPS upstream will include the script soon, but until then and if you aren't using Debian, download this [http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=georss-to-tangogps-poi.py;att=1;bug=530718 script] from the Debian bug tracker.

== Using Google Maps with tangoGPS ==

Go to Config and create a new repository.

Set the url for '''street-maps''' to:
<pre>http://mt1.google.com/mt?&x=%d&y=%d&z=%d</pre>
for '''satellite-maps''' to:
<pre>http://khm.google.com/kh?&x=%d&y=%d&zoom=%d</pre>
for '''topographic-maps''':
<pre>http://mt.google.com/mt?v=app.81&x=%d&y=%d&zoom=%d</pre>

Check the "Inverted Zoom" box. Press save Repository Configuration and you're ready to go.

'''Since TangoGPS 0.9.5''' the "Inverted Zoom" box is no longer available because Google changed the addressing scheme; instead, select "xyz instead of zxy" and use the following URLs:
<pre>
Maps:
http://mt3.google.com/mt/v=w2.89&hl=en&x=%d&y=%d&z=%d&s=Galileo

Sat:
http://khm3.google.com/kh/v=36&hl=en&x=%d&y=%d&z=%d&s=Galileo
</pre>

'''Generalization:''' The above 'Maps' URL isn't the current one anymore, also. Google changes the URL layout sometimes. To find out the current scheme open maps.google.com and view the page source. Search for http:// until you find sth similar to the above URL. This way I found
<pre>
http://mt1.google.com/mt/v=w2.92&hl=en&x=3&y=5&z=4&s=Galile
</pre>

Now you could tweak your configuration unsing the above link (delete the 'amp;' tokens and replace every number with '%d'), for example with
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|\
0,Google Maps (testing only)|http://mt1.google.com/mt/v=w2.92&hl=en&x=%d&y=%d&z=%d&s=Galile|/media/mmcblk0p2/data/maps/googlemaps|1]" \
--type list --list-type string
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[TangoGPS]]|
Description= TangoGPS is a map application which can utilize Neo's built-in GPS to show your current location. It automatically downloads maps from http://openstreetmap.com and you can download map tiles for offline use too.|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org|
TestedOn=Om 2008.8|
PackageName=tangogps
}}
</onlyinclude>

[[Category:GPS Applications]]

TangoGPS

2009-06-28T06:39:11Z

Myfanwy: /* Importing Tracks into tangoGPS */

{{Languages|tangoGPS}}
{{Application|tangoGPS}}

__TOC__

tangoGPS is a map application which can utilize Neo's built-in GPS to show your current location.

[[Image:TangoGPS1.jpg]]

Website: http://www.tangogps.org

== Running tangoGPS ==
=== [[Om 2008.8]] ===

From the freerunner connected to the internet:
<pre>
opkg update
opkg install gpsd
</pre>
{{note|I experienced hangups if gpsd was not installed.}}
<pre>
opkg install http://www.tangogps.org/downloads/tangogps_0.9.5-r0_armv4t.opk
</pre>
If opkg complains about not being able to acquire a lock, try:
<pre>pkill packagekit</pre>
To get gpsd working on the FreeRunner you have to change the configuration according to [[Gpsd#GPS_on_GTA02]].
Then start gpsd by:
<pre>
/etc/init.d/gpsd start
</pre>
If you get an error about no GPS device in /etc/default/gpsd execute:
<pre>
echo "GPS_DEV=\"/dev/ttySAC1\"" > /etc/default/gpsd
</pre>
Now you must power up the GPS-chip by opening the "Settings" application and setting the GPS entry to "on". Now you can run tangoGPS and wait until it get's a GPS fix. This can take up to a few minutes.

=== [[Debian]] ===

The latest version is available in [[Debian]].

It depends on gpsd which conflicts with frameworkd in fso-frameworkd, but there is a package available that provides
the gpsd interface to clients while using the services of the FSO frameworkd daemon, fso-gpsd. The install.sh script for the Debian distribution on the OpenMoko already installs it. To add tangogps run

# apt-get install tangogps

The gps device will be started automatically upon the invocation of tangogps or another gps application, e.g. like the one in [[Zhone]]. For the records, one can manually turn on the gps device using

# echo 1 >/sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron

The tangoGPS applications may appear as "GPS & Map" on various desktops.

'''Issues:'''
* Both gpsd and the framework publish GPS data through dbus, though with different interfaces. This suggests a number of possible solutions.
** gpsd or the framework could implement the other's interface (along with their own).
** a translator could read one interface and emulate the other. This is what fso-gpsd does.
** the framework could have an option to read data from gpsd.
** ogpsd/gypsy could be extended to be backwards compatible with the majority of gps applications.

=== FSO Milestone 3 ([[OpenmokoFramework]]) ===

There are two various GPS interfaces -- (1) one provided with default gpsd and (2) the other provided by ogpsd (part of the frameworkd). tangoGPS requires the ad 1 and it obtains information from gps from the dbus interface provided by gpsd.

On FSO milestone 3, there is tangoGPS pre-installed as well as both gpsd and ogpsd (see <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code>). As mentioned above, there also exists a fso-gpsd package, that converts from ad 2 to ad 1 (unfortunately fso-gpsd is not in default image and must be installed with <code>opkg install fso-gpsd</code>).

You cannot have both "providers" (ad 1 & ad 2) running, but you can have ad 2 (recommended for FSO) and "convertor" (fso-gpsd) providing the ad 1. To get usable tangoGPS on FreeRunner, one has to:

# check that <code>/etc/frameworkd.conf</code>, section <code>ogpsd</code> reads GPS data from the right device (<code>/dev/ttySAC1</code>)
# if changes were made to configuration, one should restart the frameworkd -- <code>/etc/init.d/frameworkd stop && /etc/init.d/frameworkd start</code>
# check that gpsd is not running -- <code>/etc/init.d/gpsd stop</code>
# check that fso-gpsd is installed and running -- <code>opkg install fso-gpsd; fso-gpsd</code>
# check that gps chip is online (<code>echo 1 > /sys/devices/platform/s3c2440-i2c/i2c-adapter/i2c-0/0-0073/neo1973-pm-gps.0/pwron</code>)
# finally start up the tangoGPS and locate the gps signal; it should be up in a few minutes.

Note 1: handy application for testing the gps (and gps signal strength) is <code>openmoko-agpsui</code>, see general gps info at [[Gps]]

Note 2: You can automate the process -- (1) remove the startup script for gpsd (<code>update-rc.d -f gpsd remove</code>) and (2) create a simple startup scipt for fso-gpsd (you can use current script for gpsd as a skeleton)

== Downloading Maps ==
=== pre-load for offline use ===

tangoGPS can bunch-download the map images so you don't need an internet connection while walking around. By default tangoGPS stores downloaded maps to /tmp/. This folder is lost every time you reboot the device. But you can use the "Config" tab within tangoGPS to change the "Cache Dir" location to , for example, /osm/ . So downloaded maps will be kept in the Neos flash, also after reboot. Note that the map files can take up large amounts of space, so you may want to store them on your sd card, e.g. in /media/card/osm or /media/mmcblk0p2/data/maps.

If you find that TangoGPS does not remember configuration changes that you make to it, be sure to run it from the touchscreen, and not an SSH session. TangoGPS uses gconf to store its settings, and cannot access gconf when run via SSH.

An alternative way to setup the configuration is through the command line. having /media/mmcblk0p2/data/maps as your data directory you could do the follwing:
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|1]" \
--type list --list-type string
</pre>

Once you have set the location to a non-volatile path, you can connect your Neo to the internet by USB or WiFi at home and start downloading the maps of your area. Tap the map screen and select "map download". Now on-the-road tangoGPS will be able to show you maps in different zoom levels even though you are not connected to the internet.

=== Downloading Maps via GPRS ===
I think tangoGPS may have started working after I followed the instructions to get GPRS working with GSM multiplexing here: [[Manually_using_GPRS#Option_1:_With_GSM_multiplexing_and_with_a_GUI]]

There are steps included in those instructions to improve GPS performance. The great thing is that once you get GPRS working, you can roam with TangoGPS running and have it download maps as needed over the GPRS connection!

=== Updating pre-downloaded maps ===
If you have many maps already downloaded, [[Media:updateMaps.txt|updateMaps.pl]] is a perl script to bring you up-to-date. It's made to work for OSM maps only, but can be adapted to work with any map dataset. See also: [[Yaouh!]].

== Using tangoGPS for OpenStreetMap.org ==
=== creating tracks ===
tangoGPS works fine to create track for Openstreetmap. However, it records and stores a track in its native format, use [http://www.tangogps.org/downloads/convert2gpx.pl convert2gpx.pl] (see also: [http://psung.blogspot.com/2008/07/sharing-gps-tracks-from-tangogps-on.html tools])(you can also use [http://minucci.net/file/convert2gpx.py convert2gpx.py]) to convert the track to GPX (i.e to import into JOSM):

perl convert2gpx.pl 20080903_111508.log > 20080903_111508.gpx

==== tangoGPS logging format ====

<lat>,<lon>,<elevation>,<speed>,<course>,<hdop>,<datetime>

=== using OpenStreetBugs ===
[http://wiki.openstreetmap.org/wiki/TangoGPS#Using_together_with_OpenStreetBugs see OSM wiki]

== Importing Tracks into tangoGPS ==

tangoGPS does not support the import of tracks directly, however the following xslt style sheet can be used to convert gpx tracks to tangogps log files, which can then be imported
<nowiki>

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:g="http://www.topografix.com/GPX/1/1">
<xsl:output method="text" omit-xml-declaration="yes"/>
<xsl:template match="g:gpx" >
<xsl:for-each select="g:wpt">
<xsl:value-of select="@lat"/>,<xsl:value-of select="@lon"/>,11.8,1.1,346.0,1.4,2008-12-30T06:46:0<xsl:if test="position()!=last()"><xsl:text>1</xsl:text></xsl:if><xsl:if test="position()=last()"><xsl:text>2</xsl:text></xsl:if>Z
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>/nowiki>

save this into a file called 'gpx2log.xslt', then run

$ xsltproc gpx2log.xslt input_file.gpx > output_file.log

move save output_file.log to the traces

and use the 'Load...' button on the 'Track' tab of tangogps to overlay it on the map

Note: this stylesheet was thrown together in a short time, and makes at least one shortcut - namely, the use of 'dummy' variables for various details, such as the altitude, date, etc. feel free to improve

You may help yourself by using [http://relet.net/frog/archives/68 this tool] to import GPX trackpoints as a series of POIs directly into the sqlite database which tangoGPS uses to store POIs.

== Using the TangoGPS logs ==

You can convert the logfiles from TangoGPS to other formats using gpsbabel and this style-file:

<pre>
DESCRIPTION TangoGPS 0.92
EXTENSION log
DATATYPE TRACK

FIELD_DELIMITER COMMA
RECORD_DELIMITER NEWLINE

IFIELD LAT_DECIMAL,"","%f"
IFIELD LON_DECIMAL,"","%f"
IFIELD ALT_METERS,"","%f"
IFIELD PATH_SPEED,"","%f"
IFIELD PATH_COURSE,"","%f"
IFIELD GPS_HDOP,"","%f"
IFIELD ISO_TIME,"","%s"
</pre>

Save this as '''tangogps.style''' and you can use gpsbabel to for instance convert to google-earth files like this:

gpsbabel -i xcsv,style=tangogps.style -o kml -f file.log -F file.kml

== Add POI from address ==

You can use [[gtkaddpoi]] for searching the destination address and add it as a POI.

== Add POI from GeoRSS feed ==

If you would like to import GeoRSS feeds from Google maps or elsewhere as points of interest (POI), read this [http://bonedaddy.net/pabs3/log/2009/05/28/georss-tangogps/ blog post]. Hopefully TangoGPS upstream will include the script soon, but until then and if you aren't using Debian, download this [http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=5;filename=georss-to-tangogps-poi.py;att=1;bug=530718 script] from the Debian bug tracker.

== Using Google Maps with tangoGPS ==

Go to Config and create a new repository.

Set the url for '''street-maps''' to:
<pre>http://mt1.google.com/mt?&x=%d&y=%d&z=%d</pre>
for '''satellite-maps''' to:
<pre>http://khm.google.com/kh?&x=%d&y=%d&zoom=%d</pre>
for '''topographic-maps''':
<pre>http://mt.google.com/mt?v=app.81&x=%d&y=%d&zoom=%d</pre>

Check the "Inverted Zoom" box. Press save Repository Configuration and you're ready to go.

'''Since TangoGPS 0.9.5''' the "Inverted Zoom" box is no longer available because Google changed the addressing scheme; instead, select "xyz instead of zxy" and use the following URLs:
<pre>
Maps:
http://mt3.google.com/mt/v=w2.89&hl=en&x=%d&y=%d&z=%d&s=Galileo

Sat:
http://khm3.google.com/kh/v=36&hl=en&x=%d&y=%d&z=%d&s=Galileo
</pre>

'''Generalization:''' The above 'Maps' URL isn't the current one anymore, also. Google changes the URL layout sometimes. To find out the current scheme open maps.google.com and view the page source. Search for http:// until you find sth similar to the above URL. This way I found
<pre>
http://mt1.google.com/mt/v=w2.92&hl=en&x=3&y=5&z=4&s=Galile
</pre>

Now you could tweak your configuration unsing the above link (delete the 'amp;' tokens and replace every number with '%d'), for example with
<pre>
gconftool-2 -s /apps/tangogps/repos \
"[OSM|http://tile.openstreetmap.org/%d/%d/%d.png|/media/mmcblk0p2/data/maps/OSM|\
0,Topo|maps-for-free|/media/mmcblk0p2/data/maps/maps4free|\
0,Aerial|openaerial|/media/mmcblk0p2/data/maps/openaerial|\
0,Opencyclemap|http://a.andy.sandbox.cloudmade.com/tiles/cycle/%d/%d/%d.png|/media/mmcblk0p2/data/maps/opencyclemap|\
0,Google Sat (testing only)|http://khm1.google.com/kh?v=34&hl=en&x=%d&s=&y=%d&z=%d|/media/mmcblk0p2/data/maps/googlesat|\
0,Google Maps (testing only)|http://mt1.google.com/mt/v=w2.92&hl=en&x=%d&y=%d&z=%d&s=Galile|/media/mmcblk0p2/data/maps/googlemaps|1]" \
--type list --list-type string
</pre>

<onlyinclude>
{{ApplicationBox|
Name=[[TangoGPS]]|
Description= TangoGPS is a map application which can utilize Neo's built-in GPS to show your current location. It automatically downloads maps from http://openstreetmap.com and you can download map tiles for offline use too.|
Screenshot=TangoGPS1.jpg|
Homepage=http://www.tangogps.org|
TestedOn=Om 2008.8|
PackageName=tangogps
}}
</onlyinclude>

[[Category:GPS Applications]]

Opkg

2009-05-31T09:07:38Z

Myfanwy: /* FAQ */

{{Languages|Opkg}}

== About Opkg ==

Opkg is a lightweight package management system based on [http://handhelds.org/moin/moin.cgi/Ipkg Ipkg].

Mid December, 2008, the project moved to Google code: http://code.google.com/p/opkg/
* Group: http://groups.google.com/group/opkg-devel
* mailto: opkg-devel at googlegroups.com <opkg-devel at googlegroups.com>
* Checkout Code: http://code.google.com/p/opkg/source/checkout

Prior to that date, a mailing list for discussion was available here: http://lists.openmoko.org/mailman/listinfo/opkg-devel
Source code was available in the subversion repository: http://svn.openmoko.org/trunk/src/target/opkg/. The repository could also be [http://svnweb.openmoko.org/trunk/src/target/opkg/ viewed online].

You can learn how to create own [http://handhelds.org/moin/moin.cgi/BuildingIpkgs Opkg packages] on the Ipkg site.

Packages should install .desktops at the very end of the installation process. This ensures that the icons referenced in the .desktop file are available. [https://docs.openmoko.org/trac/ticket/1524 Reference]

== New Features ==

This is a list of features that have been completed. Mostly this is a list of changes from Ipkg.

* Use libcurl to download files
* Send download progress updates to libopkg clients
* Re-organize and clean up source code into sub directories
* Verify package lists with gpg detached signature
* Mark packages that were installed to satisfy dependencies (auto installed)
* Additional command line option to remove "auto installed" packages
* Support for faceted classification (similar to debtags). ''A "Tags" line has been added to the package information and opkg makes this available to clients, but does not process it in anyway. The command line client also does not use this features yet.''

=== Ipkg Patches ===

The following ipkg patches have been applied:

* "2-pkg-vec--Optimize-gross-inefficiency.patch" from OpenEmbedded
* "1-pkg-parse--Optimize-inefficient-parsing.patch" from OpenEmbedded

* [http://svn.o-hand.com/view/poky/trunk/meta/packages/ipkg/files/update_version_comparision.patch?rev=3827&view=auto update_version_comparision.patch] from Richard Purdie
* [http://svn.o-hand.com/view/poky/trunk/meta/packages/ipkg/files/enable_debversion.patch?rev=3827&view=auto enable_debversion.patch] from Richard Purdie

== Planned features ==

These are features either under development or planned for inclusion before the next release.

* improve/cleanup [[libopkg]] api
* locking system to prevent two simultaneous operations on the file system

=== Bug fixes ===

* Ipkg bug - Overflowing / crashes machine - [http://bugs.openembedded.net/show_bug.cgi?id=1028]
* ipkg tries to access ro SD card - [http://bugs.openembedded.net/show_bug.cgi?id=1029]

=== Lower priority features ===

* Simple user interactions during postinstall
* Improve command line options
* Restructure source code and make it more robust
* Store packages in database
* Check available space in /tmp prior to downloading
* Check available space in dest prior to unpacking

== Possible Issues ==

This is a list of possible issues or known bugs.

* http proxy works but authentication not tested yet (--[[User:cberger|cberger]] tested version 0.1.4, does not recognize proxy_username and proxy_password for authentication)
* autoremove feature only inspects "depends" and not "pre-depends"

== Error Codes ==

It looks like, in some cases, Opkg will return an error code if something goes wrong. Here's a list that I pulled from the error.h file:

* -1: Unknown Error
* 0: No Error (Success)

Configuration Errors:
* 1: Could not set default destination
* 2: Error parsing config file
* 3: Could not create temporary directory
* 4: Could not obtain administrative lock
** This could be cause by assassin not releasing the lock on the package management. It can be released by killing its manager:
killall packagekitd

Package Errors
* 5: Unsatisfied Dependencies
* 6: Is Essential
* 7: Has Dependents
* 8: Has No Candidate
* 9: PackageHas No Available Architecture

Install Errors
* 10: Not Trusted
* 11: Download Error
* 12: Conflicts
* 13: Already Installed
* 14: Dependencies
* 15: No Downgrade
* 16: Out Of Space
* 17: Bad Signature
* 18: MD5 Error
* 19: Internal Error

{{note|I had a problem where I was trying to manually install a package that had dependencies. The dependencies had a bad signature (actually, my signature files were bad). Instead of returning 17 because of the bad signature, it returned 14 because of a dependency problem. So if you get a 14, try installing that package by itself and see what you get. --[[User:Jtickle|Jtickle]] 18:16, 23 July 2008 (EST) }}

== FAQ ==

Q. What version of Ipkg is Opkg based on?

A. It is based on the [http://www.handhelds.org/download/packages/ipkg/ipkg-0.99.163.tar.gz ipkg-0.99.163] tarball

Q. Why "fork" and rename Ipkg?

A. Ipkg is no longer actively maintained upstream and there are potential trademark issues with using the Ipkg name

Q. Does opkg have a feature similar to APT pinning?

A. Yes you can define priorities on the architecture field (the second field in a feed definition) in /etc/opkg/arch.conf

Q. Does opkg have an auto completion system ?

A. Yes, it's a contribution script available at the [http://blog.upme.fr/?/Linux/28-Openmoko-Opkg-Autocompletion-With-Packages-Names upme blog]

Q: How similar is the ipk format, to the deb format? They look very similar; the data and control tar balls are identical as far as i can tell.

{{Languages|Opkg}}

[[Category:Settings Applications]]

Paroli

2009-05-20T03:02:37Z

Myfanwy: /* FAQ */

[[Image:Paroli.png|thumb|Paroli Screenshot]]
Paroli is a new approach to application development on the Openmoko phones. It is actually able, in combination with Om2009 distribution to make Freerunner work as a simple phone.
It's based on top of the [[OpenmokoFramework|FSO framework]] and enables the use of it via a core and several services.

For more information please visit [http://www.paroli-project.org/ Paroli website]

If you are interested in helping out with paroli, contribute code or test or or or ... Let us know! Send a mail to [mailto:mirko@openmoko.com Mirko] and/or visit #paroli IRC channel!

== Stuff that works ==

Paroli actually makes FR a simple, very working phone!!
* ability to turn off PIN check & change pin! (The first distro that does it ?)
* Connecting to WLAN (with WPA, WPA2, WEP)
* suspend & resume
* etc etc

==Installation / download ==

=== Full distro ===

To install the [[Om2009]] distribution download the uImage and fso-paroli-image from http://downloads.openmoko.org/distro/testing/NeoFreerunner/

=== Only the package ===
In order to get the package from unstable you'll need to adjust the configuration of opkg:

<nowiki>echo src/gz openmoko-unstable-armv4t http://downloads.openmoko.org/repository/unstable/armv4t > /etc/opkg/om-unstable.conf</nowiki>

Then do an opkg-update and opkg install paroli.

This should get you the newest version.

=== Download ===

Download paroli from
[http://downloads.freesmartphone.org/fso-milestone5/feeds//armv4t/paroli_0.2.1+gitr7a2fdc16174258e9276e7c2d80f500b4dd624442-r0_armv4t.ipk http://downloads.freesmartphone.org/fso-milestone5/feeds//armv4t/paroli_0.2.1+gitr7a2...442-r0_armv4t.ipk]

or from http://downloads.openmoko.org/distro/experimental/

=== Getting the sources ===

git clone http://git.paroli-project.org/paroli.git/

== FAQ ==

''' I/O... what's that..'''
* I/O is the phone log. It'll show your dialled, answered and missed calls.
** why do you name something so fundamentally necessary, with such an obscure name?
* Msgs is the place to send & read messages (SMS)
* Tele is the dialler
* People is the phone book

'''How do I get to settings?'''

Go to the home-screen (the one with the big clock) and hold the AUX-button pressed for 2 seconds.

'''How do I get Illume?'''

Open settings, click on "display" and then hit "profile" (once) and be patient, after some rumbling on the screen you will have the standard illume look with paroli in windowed mode.

''' How do I shut it down? '''

Hold the power button down for 10 seconds. It will not give you a visual feedback, it just starts shutting down.

''' How do I change the audio profile '''

* When not on call, short pressing of AUX changes between audio profiles (default / silent).
* When on call, it changes the speaker volume (20-40-60-80-100%). Using level over 80 might cause some echo.

''' Where are the messages folder? Drafts, sent etc.?

'''How do I lock the screen, without going to suspend?

''' How do i set the alarm?

''' How do I contribute? '''

See [[Om 2009 get active#Paroli phone software|Paroli section on Om2009 "get active" page]].

== Known issues ==
See wiki page [[paroli-issues]] for the list of known issues and vital feature requests.

Bug tracker is available at http://www.paroli-project.org/trac

[[Category:FSO]]

Distributions

2009-05-01T12:55:36Z

Myfanwy: /* Non-Openmoko distributions */

{{Languages|Distributions}}

{|align=left
|__TOC__
|}

== About distributions ==
Openmoko distributions are designed to run on various mobile devices, with the primary aim of supporting Openmoko Inc.'s [[GTA01:Neo 1973|Neo 1973]] and [[Neo FreeRunner]] phones. They are GNU/Linux distributions -- complete operating systems including user applications. You can install any of them on your phone or even have a dualboot system with two distributions installed. For downloads see [[Download]], for installation instructions see [[Flashing the Neo FreeRunner]].

Besides, Openmoko distributions also run on [[Supported devices|other]] mobile devices and some other software distributions also run on the phones of Openmoko Inc.

=== Choosing a distribution ===
* Official/current. As of December 2008, the phones ship with [[Om 2008.9]].The branch currently supported by Openmoko Inc. is [[Om 2008.12 Update]], which is the second minor upgrade of [[Om 2008.9]] (the version formerly named ''ASU'').
* Official/future. The current trunk tip is a "base image" on which the next major release should be based. This next release[http://wiki.openmoko.org/wiki/Om2009 (Om 2009)] can be previewed by installing milestones of the [[FSO]] - Free Smartphone.Org project. If you want to develop anything that last, your platform is [[FSO]] (and the choice between EFL, GTK+, Qt, Java, Python or whatever is open). The [[Debian]] packaging team also track that branch.
* Openmoko community. Based on [[Om 2008.8]], the community made the [[FDOM]] distribution by adding lots of fixes and applications to it. Most new users find [[FDOM]] the most comprehensive and functional distribution.
* Other community. The FreeRunner is also a reference platform for TrollTech's ''Qt Extended'' (formerly [[Qtopia]]) distribution. If you want "just a working phone", try [[Qtopia]].
* Other communities. [[Android]] work is in progress; [[Debian]] and [[Gentoo]] are for people who do not need to ask which distribution they should use.

{| class="wikitable" style="float:right;width:200px;background-color:#FF6600;text-align:center;border-collapse:collapse;font-weight:bold"
|<font color=white>Distributions</font>
|-
! style='background-color:#333333;color:#FFFFFF'|
<div align=left>
* <font color='#BBBBBB'>Openmoko (official)</font>
** [[Om2009]]
** [[Om 2008.12 Update]]
** [[Om 2008.9 Update]]
** [[Om 2008.8]]
** [[Om 2007.2]]
** [[OpenmokoFramework|FSO]]
* <font color='#BBBBBB'>Om Community</font>
** [[SHR]]
** [[FDOM]]
* <font color='#BBBBBB'>Other</font>
** [[Qtopia]]
** [[Debian]]
** [[Gentoo]]
** [[Android]]
** [[Hackable:1]]
** [[Fyp]]
</div>
|-
|}

=== Please note ===

* Stable in the FreeRunner world does not mean the same thing as stable in the Debian world.
* Most distributions use the same bootloader, kernel, drivers and hardware. Therefore, the same low level bugs are commonly found in all distributions. The latest and greatest software usually has most bug fixes, plus a whole set of new fresh bugs.
* Most of these distributions also have package repositories. It is a BAD idea to feed from another distribution's repository.
* Upgrade path between these distributions are mostly not tested, thus updating by changing the feeds will most likely end in broken packages or even an unbootable system. It is advisable to reflash the whole filesystem with [[dfu-util]] to switch between the different distributions, with the reminder that a dual-boot setup (e.g. via sdcard or NFS) can be used.

== Official Openmoko releases ==

'Release targets' offered by Openmoko Inc. are built out of different branches of the [[OpenEmbedded]] metadistribution source tree.

=== Om series ===

* '''[[Om2009]]''' is intended to be the new distro; it is not a simple follow-on from [[Om 2008.12 Update]]. '''It is still very much in development and by no means ready for production use''' and is based on the [http://freesmartphone.org freesmartphone.org] milestone 5.5 framework.

{{Main|Om2009}}

* '''[[Om 2008.12 Update]]''' is the second point release after the initial ''Om 2008.9'' release.

{{Main|Om 2008.12 Update}}

* '''[[Om 2008.9 Update]]''' is the first point release after the initial ''Om 2008.8'' release. Openmoko recommends that all existing installations of Om 2008.8 should be updated to that version. Quality-wise, we are still far from the goal, but this version includes general stability enhancing operating system improvements and a new splash screen. No applications were added or removed. Users with basic telephony needs will find it tolerable as an everyday phone.

{{Main|Om 2008.9 Update}}

* '''[[Om 2008.8]]''' was released on August 8, 2008, to replace 2007.2. Prior to that, its codename was ASU (April/August Software Update). This is still the name of the branch in the version control system. This distribution integrates the [http://trolltech.com/products/qtopia Qtopia] phone stack with a set of new Openmoko applications based on the Enlightenment Foundation Libraries ([[EFL_Documentation|EFL]]). Qtopia being a more mature product than the GNOME Mobile stack, the standard phone applications (dialer, contacts, calculator, calendar) work better than in 2007.2. The Qtopia used in 2008.8 was ported to run on X11, contrary to standard Qtopia which uses the framebuffer. This allows non-Qt applications to safely share the screen with Qt applications. This is a .0 release, many unresolved issues remain in the lower layers (kernel power management, sound, wifi drivers...).

{{Main|Om2008.8}}

* '''[[Om 2007.2]]''' is the base-system which is installed on FreeRunner when it leaves the factory. The interface was totally finger-oriented, optimized for 285ppi, and very orange. It used the GTK+ stack, which is part of the [http://www.gnome.org/mobile/ GNOME Mobile] platform. This distribution is now considered obsolete and not being worked on by Openmoko Inc or by OpenedHand. There is a community effort (see [[SHR]]) to port the GTK based telephony applications to the future middleware from [[FSO]].

{{Main|Om 2007.2}}

=== FSO series ===

'''FSO''' is an abbreviation for FreeSmartphone.Org. Openmoko is working on a stable system services back-end. Focus is on stable highlevel services that you can access from whatever language or UI that supports [http://dbus.freesmartphone.org/ dbus]. The framework will be used in forthcoming Openmoko distributions. FSO is all about middleware, but if one stacks a bootloader+kernel under it and telephony applications on top, one gets a functional distribution. These are made available as FSO-image milestones.

* '''FSO Milestone V''' was released and named 'Calling All Stations'. The telephony application on top of it is Zhone. This is a basic Python dialer/homescreen designed as scaffolding to test the FSO functionalities (even if Zhone is pretty, code path coverage is more critical to it than user-friendliness). More details at
[http://wiki.openmoko.org/wiki/OpenmokoFramework/Status_Update_6 Status Update 6]. You can grab it from http://downloads.freesmartphone.org/fso-stable/milestone5.1/ .

{{Main|FSO}}

== Openmoko community releases ==

=== SHR - Stable Hybrid Release ===

SHR is a community driven distribution. It contains some basic EFL based applications which make use of the FSO. There currently is an [[EFL_Documentation|EFL]] (with elementary) dialer, messages and contacts application programmed in C, as well as a nice Settings-GUI in Python. As of April 12th, 2009, there is no stable release of this distribution yet, as the SHR team doesn't feel it to be good enough. You can find images though on the [http://shr.bearstech.com/shr-testing SHR buildhost].

{{Main|Stable Hybrid Release}}

=== FDOM (FAT and Dirty Openmoko) ===

[[FDOM]] is a distribution based on Openmoko's currently supported image, updated with many ready-to-use applications and with fixes posted in the mailing lists. A combination of applications (everything goes) and fixes to demonstrate the capabilities of the Freerunner and to have a functional phone (sort of). This all while retaining the ability to update through the official feeds.

{{Main|FDOM}}

=== Non-Openmoko distributions ===

These are not Openmoko (and OE) based distributions. These are alternatives you can run on your Openmoko phones.

==== Qt Extended ====
Qt Extended has had several names. The current name is <b>Qt Extended Improved</b>. An Openmoko-based community develops Qt Extended Improved as a Free Software project. Qt Extended Improved builds on the foundation of Qt Extended/Qtopia/Qt by Qt Software/Trolltech. Qt Extended Improved provides a robust telephony stack, a webkit based browser and other smartphone features.

On 5th March 2009 Qt Software released Qt Extended 4.4.3. On 3rd March 2009 Qt Software announced that Qt Extended would 4.4.3 would be the last release of the Qt Extended product. Prior to version 4.3, Qt Extended was known as Qtopia.

{{Main|Qtopia / Qt Extended on FreeRunner}}

==== Debian ====
Debian is "the universal operating system". It comes with thousands and thousands of packages (most of them designed for desktops or servers so far). So in the words of Joachim "nomeata" Breitner from the [http://wiki.debian.org/Teams/DebianFSO pkg-fso] team, this is not really a distribution in the Openmoko sense of the word, but rather a different underlying system for Openmoko distributions. At the moment, we ship the software from the FSO stack, but hopefully we’ll also have, for example, the Stable Hybrid Release software in our archive. So for now, Debian is a different way of installing FSO, which takes more space and provides more programs :-)

{{Main|Debian}}

==== [[Gentoo ]]====
Gentoo is all about choices. When installing Gentoo, this is made clear to you several times -- you can choose how much you want to compile yourself, how to install Gentoo, what system logger you want, etc. Gentoo is a fast, modern metadistribution with a clean and flexible design. Gentoo is built around free software and doesn't hide from its users what is beneath the hood. Portage, the package maintenance system which Gentoo uses, is written in Python, meaning you can easily view and modify the source code. Gentoo's packaging system uses source code (although support for precompiled packages is included too) and configuring Gentoo happens through regular textfiles. In other words, openness everywhere.

{{Main|Gentoo}}

==== Android ====
[http://code.google.com/android/ Android] is a software stack for mobile devices developed by the [http://www.openhandsetalliance.com/ The Open Handset Alliance.] Openmoko is fully supporting Android running on the Freerunner.

Android has now reached a point where it is usable on the FreeRunner as an everyday phone, there are, however, still some caveats. Check out the main Android section of the wiki for more info.

{{Main|Android}}You can also visit the user web page for [http://wiki.openmoko.org/wiki/User:Seanmcneil3 Sean McNeil] for some more info.

====Slackware====
As of release 12.2, Slackware is now officially supported on the Neo Freerunner
[http://armedslack.org/]

==== Hackable:1====
Hackable1 is a community distribution for hackable devices like the Neo Freerunner. It is based on Debian and 2007.2 userland which has been abandoned by Openmoko. It follows the GNOME mobile platform.
{{Main|Hackable:1}}

====[[neovento]]====
neovento is a [[Debian|Debian for Freerunner]] based [[Distributions|distribution]] which uses [http://lxde.org/ LXDE] and [[Zhone]] on top. It is a [http://freeyourphone.de FreeYourPhone.de] community project.

{{Main|neovento}}

==== Others / unreleased ====
* The [http://www.neopwn.com/software.php NeoPwn] network auditng system's core is a modified Linux 2.6.24 kernel, with cross-compiled module driver support for the numerous compatible addon devices running on a FULL Debian (ARMEL) operating system. The filesystem has been optimized for performance and size and includes the NeoPwn menu system and several GUI dialogs for hardware control and attack automation. ''Status: Unknown, the GPL requires source code to be distributed only to customers''.
* [http://runningbear.org/trac RunningBear] is an innovative, yet free and open-source Operating System for hackable devices driven by Bearstech. Lightweight, Portable, Secure, Friendly and Useful. ''Status: In development''.
* [http://pokylinux.org/ Poky] and Sato, by OpenedHand/Intel. An open source platform build tool derived from OE. It is a complete software development environment for the creation of Linux devices. It enables you to design, develop, build, debug, and test a complete, modern, software stack using Linux, the X Window System and GNOME Mobile based application frameworks for both ARM and x86 based platforms. ''Status: The "Nightly Build" Image works fine on Neo Freerunner, but phone functionality doesn't.''
* [http://pyneo.org/ PyNeo] pyneo is a stack for mobile devices excessivly using dbus, glib and evas. pyneo can be considered FSO milestone 0. Afterwards, FSO evolved into an own project with different goals. ''Status: still active, ask around on #pyneo.org ''
* [http://www.quantum-step.com/ mySTEP] by Openmoko distributor Golden Delicious Computers is based on GNUstep and brings a Objective-C API to the Neo. Core GUI frameworks are "Foundation" & "AppKit". It has been shown on FOSDEM 2008, LinuxTag 2008 and SYSTEMS 2008 to run on the Neo 1973. If someone reengineers UIKit, (open) source code compatibility to iPhone apps appears achievable. ''Status: it does not have its own kernel so a Freerunner distribution waits for a solid basis and an arm-linux-gnueabi toolchain that runs natively on Mac OS X is currently lacking.''

== Features by distribution/release target ==

Generally, distributions can differ on one or more of the following components:
* The bootsplash screen image. This is purely decorative.
* The bootloader. Theoretically, any version of ''uboot'' could be used with any distribution. In the future ''Qi'' will replace ''uboot''.
* The kernel. GNU/Linux kernels versions 2.6.24, 2.6.26 or 2.6.28 can be found. Some have modules compiled in, others have modules compiled separately. If compiled separately, modules can be distributed in the same package file as the kernel or separately.
* Middleware: daemons to handle GSM calls or GPS, sound system, personal information storage and so on. Qt and Android have their own subsystems, FreeSmartphone.Org (FSO) is working towards a standard-based Free Software one.
* Display driver. The original ''Qt Extended'' uses the framebuffer, most other distributions today use ''X11''.
* Libraries and application framework (widget toolkit and and graphical environment) : EFL, Qt, Gtk+ or Java ?
* Basic telephony applications: voice calls, SMS, alarm clock...
* Smartphone applications: GPS, media player, simple games, web browser...
* Open source applications: more games, scientific, you name it...

=== Hardware Support ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|Om 2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| GTA01 || ?? || ?? || ?? || {{Yes}} || ?? || {{Yes}} || {{Yes}} || ?? || ??
|-
| GTA02 || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
|}

=== Connectivity ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|Om 2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Telephony || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| SMS || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| [[GPRS]] || Not through UI || Not through UI|| Not through UI || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || Not through UI || {{Yes}}
|-
| [[WiFi]] || {{Yes}} (*) || {{Yes}} || Not through UI || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || Not through UI || {{Yes}}
|-
| VoIP || ?? || ?? || ?? || ?? || {{Yes}} || {{Yes}} (1) || {{Yes}} || ?? || {{no}}
|-
| Bluetooth || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{Yes}}
|-
| GPS (1) || {{Yes}} (1) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || {{Yes}} (1) || {{Yes}}
|-
|}

=== Power ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|Om 2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Suspend || {{Yes}} || ?? || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Resumes on Event || ?? || ?? || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ??
|-
| Functions after Resume || {{Yes}} || ?? || ?? || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
|}

=== User Interaction ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|Om2008.8 !! width=8%|2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Stylus friendly || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Finger friendly || Partially || Partially || Partially || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Accelerometer || {{Yes}} [[Rotate|(1)]][[Gestures|(1)]] || {{No}} || {{No}} || {{yes}} (1) || {{Yes}} || {{No}} || {{Yes}} || ?? || {{Yes}}
|-
|}

=== Applications ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Terminal || {{Yes}} (1) || Basic (2) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || {{Yes}}
|-
| PIM || {{Yes}} || {{Yes}} || {{No}} || N/A || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || ??
|-
| Phonebook || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Dialer || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Web Browser || {{Yes}} (1) || {{Yes}} (1) || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Mail Client || {{Yes}} || ? || ? || ? || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| XMPP Client || {{Yes}} [[Instant Messaging|(1)]] || {{Yes}} (1) || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || || ??
|-
| Media Player || {{Yes}} (1) || {{Yes}} || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
|}

=== Toolkits / Runtimes ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0"
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| GTK+ || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || ??
|-
| Qt/Qt Extended || {{Yes}} || {{No}} || {{Yes}} ? || {{Yes}}? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ??
|-
| Middleware || qtopia-x11 || gsmd/neod || FSO || FSO || qtopia-x11 || Qt Extended || FSO || FSO || ??
|-
| [[Java]] || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes}} || ?? || {{Yes|CacaoVM, JamVM}} || ?? || ??
|-
| [[Python]] || {{Yes}} || {{Yes}} || {{Yes}} || {{yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ??
|-
| [[Mono]] || {{Yes}} (1) || {{Yes}} (1) || ?? || {{no}} || ?? || ?? || {{Yes}} (1) || ?? || ??
|-
| [[Ruby]] || {{Yes}} || ?? || ?? || ?? || ?? || ?? || {{Yes}} (1) || {{Yes}} (1) || ??
|}

=== Images ===
Latest and stable combinations for Neo FreeRunner gta02
{|class="wikitable" border="1" cellpadding="5" cellspacing="0"
| || OM || FDOM || Qt Extended || Android
|-
| current bootloader || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/distro/releases/Om2008.9/ OM daily] version [http://downloads.openmoko.org/] || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/repository/experimental/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/repository/experimental/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] ||
|-
| future bootloader || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu ||
|-
| splash || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz ||
|-
| kernel || [[Linux]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest uImage.bin || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest uImage-gta02-mwester-stable.bin or from [http://downloads.tuxfamily.org/3v1deb/openmoko/ treviño] latest uImage-gta02-stable-3v1n0.bin || [[Linux]] see [[Qt_Extended]] page for latest version || [[Linux]] from [http://koolu.org/releases/ koolu]
|-
| modules || ? || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest modules-min-gta02-mwester-stable.tgz or modules-all-gta02-mwester-stable.tgz || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest modules-min-gta02-mwester-stable.tgz or modules-all-gta02-mwester-stable.tgz ||
|-
| rootfs || [[Main_Page|OM]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest rootfs.jffs2 || [[FDOM]] from [ftp://ftp.tuxbrain.com/openmoko/fdom/releases/ TuxBrain] version [ftp://ftp.tuxbrain.com/openmoko/fdom/releases/Fat_and_Dirty_OM.200809_20081023.rootfs.jff2 200809_20081023] || See [[Qt_Extended]] for latest rootfs || [[Android]] from [http://koolu.org/releases/ koolu]
|}

Footnotes:

(1) works, but need additional software to be installed

(2) unusable due to lack of certain keyboard characters. [[Switching_Keyboards#Matchbox_keyboard|Various fixes available.]]

(*) unstable

==Quick download page==

[[Download]]

== See also ==

* Mickey Lauer's post "[http://www.vanille-media.de/site/index.php/2008/06/28/gtk-asu-fso-tmtla/ GTK, ASU, FSO, TMTLA!]" describes the differences between distributions 2007.2, ASU and FSO.

* Latest news and tips are in [[Community Updates]]

* [[Kustomizer]] is a script to change your 2008.12 to a usable phone

[[Category:Distributions| ]]

Distributions

2009-05-01T12:50:40Z

Myfanwy: /* Non-Openmoko distributions */

{{Languages|Distributions}}

{|align=left
|__TOC__
|}

== About distributions ==
Openmoko distributions are designed to run on various mobile devices, with the primary aim of supporting Openmoko Inc.'s [[GTA01:Neo 1973|Neo 1973]] and [[Neo FreeRunner]] phones. They are GNU/Linux distributions -- complete operating systems including user applications. You can install any of them on your phone or even have a dualboot system with two distributions installed. For downloads see [[Download]], for installation instructions see [[Flashing the Neo FreeRunner]].

Besides, Openmoko distributions also run on [[Supported devices|other]] mobile devices and some other software distributions also run on the phones of Openmoko Inc.

=== Choosing a distribution ===
* Official/current. As of December 2008, the phones ship with [[Om 2008.9]].The branch currently supported by Openmoko Inc. is [[Om 2008.12 Update]], which is the second minor upgrade of [[Om 2008.9]] (the version formerly named ''ASU'').
* Official/future. The current trunk tip is a "base image" on which the next major release should be based. This next release[http://wiki.openmoko.org/wiki/Om2009 (Om 2009)] can be previewed by installing milestones of the [[FSO]] - Free Smartphone.Org project. If you want to develop anything that last, your platform is [[FSO]] (and the choice between EFL, GTK+, Qt, Java, Python or whatever is open). The [[Debian]] packaging team also track that branch.
* Openmoko community. Based on [[Om 2008.8]], the community made the [[FDOM]] distribution by adding lots of fixes and applications to it. Most new users find [[FDOM]] the most comprehensive and functional distribution.
* Other community. The FreeRunner is also a reference platform for TrollTech's ''Qt Extended'' (formerly [[Qtopia]]) distribution. If you want "just a working phone", try [[Qtopia]].
* Other communities. [[Android]] work is in progress; [[Debian]] and [[Gentoo]] are for people who do not need to ask which distribution they should use.

{| class="wikitable" style="float:right;width:200px;background-color:#FF6600;text-align:center;border-collapse:collapse;font-weight:bold"
|<font color=white>Distributions</font>
|-
! style='background-color:#333333;color:#FFFFFF'|
<div align=left>
* <font color='#BBBBBB'>Openmoko (official)</font>
** [[Om2009]]
** [[Om 2008.12 Update]]
** [[Om 2008.9 Update]]
** [[Om 2008.8]]
** [[Om 2007.2]]
** [[OpenmokoFramework|FSO]]
* <font color='#BBBBBB'>Om Community</font>
** [[SHR]]
** [[FDOM]]
* <font color='#BBBBBB'>Other</font>
** [[Qtopia]]
** [[Debian]]
** [[Gentoo]]
** [[Android]]
** [[Hackable:1]]
** [[Fyp]]
</div>
|-
|}

=== Please note ===

* Stable in the FreeRunner world does not mean the same thing as stable in the Debian world.
* Most distributions use the same bootloader, kernel, drivers and hardware. Therefore, the same low level bugs are commonly found in all distributions. The latest and greatest software usually has most bug fixes, plus a whole set of new fresh bugs.
* Most of these distributions also have package repositories. It is a BAD idea to feed from another distribution's repository.
* Upgrade path between these distributions are mostly not tested, thus updating by changing the feeds will most likely end in broken packages or even an unbootable system. It is advisable to reflash the whole filesystem with [[dfu-util]] to switch between the different distributions, with the reminder that a dual-boot setup (e.g. via sdcard or NFS) can be used.

== Official Openmoko releases ==

'Release targets' offered by Openmoko Inc. are built out of different branches of the [[OpenEmbedded]] metadistribution source tree.

=== Om series ===

* '''[[Om2009]]''' is intended to be the new distro; it is not a simple follow-on from [[Om 2008.12 Update]]. '''It is still very much in development and by no means ready for production use''' and is based on the [http://freesmartphone.org freesmartphone.org] milestone 5.5 framework.

{{Main|Om2009}}

* '''[[Om 2008.12 Update]]''' is the second point release after the initial ''Om 2008.9'' release.

{{Main|Om 2008.12 Update}}

* '''[[Om 2008.9 Update]]''' is the first point release after the initial ''Om 2008.8'' release. Openmoko recommends that all existing installations of Om 2008.8 should be updated to that version. Quality-wise, we are still far from the goal, but this version includes general stability enhancing operating system improvements and a new splash screen. No applications were added or removed. Users with basic telephony needs will find it tolerable as an everyday phone.

{{Main|Om 2008.9 Update}}

* '''[[Om 2008.8]]''' was released on August 8, 2008, to replace 2007.2. Prior to that, its codename was ASU (April/August Software Update). This is still the name of the branch in the version control system. This distribution integrates the [http://trolltech.com/products/qtopia Qtopia] phone stack with a set of new Openmoko applications based on the Enlightenment Foundation Libraries ([[EFL_Documentation|EFL]]). Qtopia being a more mature product than the GNOME Mobile stack, the standard phone applications (dialer, contacts, calculator, calendar) work better than in 2007.2. The Qtopia used in 2008.8 was ported to run on X11, contrary to standard Qtopia which uses the framebuffer. This allows non-Qt applications to safely share the screen with Qt applications. This is a .0 release, many unresolved issues remain in the lower layers (kernel power management, sound, wifi drivers...).

{{Main|Om2008.8}}

* '''[[Om 2007.2]]''' is the base-system which is installed on FreeRunner when it leaves the factory. The interface was totally finger-oriented, optimized for 285ppi, and very orange. It used the GTK+ stack, which is part of the [http://www.gnome.org/mobile/ GNOME Mobile] platform. This distribution is now considered obsolete and not being worked on by Openmoko Inc or by OpenedHand. There is a community effort (see [[SHR]]) to port the GTK based telephony applications to the future middleware from [[FSO]].

{{Main|Om 2007.2}}

=== FSO series ===

'''FSO''' is an abbreviation for FreeSmartphone.Org. Openmoko is working on a stable system services back-end. Focus is on stable highlevel services that you can access from whatever language or UI that supports [http://dbus.freesmartphone.org/ dbus]. The framework will be used in forthcoming Openmoko distributions. FSO is all about middleware, but if one stacks a bootloader+kernel under it and telephony applications on top, one gets a functional distribution. These are made available as FSO-image milestones.

* '''FSO Milestone V''' was released and named 'Calling All Stations'. The telephony application on top of it is Zhone. This is a basic Python dialer/homescreen designed as scaffolding to test the FSO functionalities (even if Zhone is pretty, code path coverage is more critical to it than user-friendliness). More details at
[http://wiki.openmoko.org/wiki/OpenmokoFramework/Status_Update_6 Status Update 6]. You can grab it from http://downloads.freesmartphone.org/fso-stable/milestone5.1/ .

{{Main|FSO}}

== Openmoko community releases ==

=== SHR - Stable Hybrid Release ===

SHR is a community driven distribution. It contains some basic EFL based applications which make use of the FSO. There currently is an [[EFL_Documentation|EFL]] (with elementary) dialer, messages and contacts application programmed in C, as well as a nice Settings-GUI in Python. As of April 12th, 2009, there is no stable release of this distribution yet, as the SHR team doesn't feel it to be good enough. You can find images though on the [http://shr.bearstech.com/shr-testing SHR buildhost].

{{Main|Stable Hybrid Release}}

=== FDOM (FAT and Dirty Openmoko) ===

[[FDOM]] is a distribution based on Openmoko's currently supported image, updated with many ready-to-use applications and with fixes posted in the mailing lists. A combination of applications (everything goes) and fixes to demonstrate the capabilities of the Freerunner and to have a functional phone (sort of). This all while retaining the ability to update through the official feeds.

{{Main|FDOM}}

=== Non-Openmoko distributions ===

These are not Openmoko (and OE) based distributions. These are alternatives you can run on your Openmoko phones.

==== Qt Extended ====

Qt Extended has had several names. The current name is <b>Qt Extended Improved</b>. An Openmoko based community develops Qt Extended Improved as a Free Software project. Qt Extended Improved builds on the foundation of Qt Extended/Qtopia/Qt by Qt Software/Trolltech. Qt Extended Improved provides a robust telephony stack, a webkit based browser and other smartphone features.

On 5th March 2009 Qt Software released Qt Extended 4.4.3. On 3rd March 2009 Qt Software announced that Qt Extended would 4.4.3 would be the last release of the Qt Extended product. Prior to version 4.3, Qt Extended was known as Qtopia.

{{Main|Qtopia / Qt Extended on FreeRunner}}

==== Debian ====

Debian is "the universal operating system". It comes with thousands and thousands of packages (most of them designed for desktops or servers so far). So in the words of Joachim "nomeata" Breitner from the [http://wiki.debian.org/Teams/DebianFSO pkg-fso] team, this is not really a distribution in the Openmoko sense of the word, but rather a different underlying system for Openmoko distributions. At the moment, we ship the software from the FSO stack, but hopefully we’ll also have, for example, the Stable Hybrid Release software in our archive. So for now, Debian is a different way of installing FSO, which takes more space and provides more programs :-)

{{Main|Debian}}

==== [[Gentoo ]]====

Gentoo is all about choices. When installing Gentoo, this is made clear to you several times -- you can choose how much you want to compile yourself, how to install Gentoo, what system logger you want, etc. Gentoo is a fast, modern metadistribution with a clean and flexible design. Gentoo is built around free software and doesn't hide from its users what is beneath the hood. Portage, the package maintenance system which Gentoo uses, is written in Python, meaning you can easily view and modify the source code. Gentoo's packaging system uses source code (although support for precompiled packages is included too) and configuring Gentoo happens through regular textfiles. In other words, openness everywhere.

{{Main|Gentoo}}

==== Android ====

[http://code.google.com/android/ Android] is a software stack for mobile devices developed by the [http://www.openhandsetalliance.com/ The Open Handset Alliance.] Openmoko is fully supporting Android running on the Freerunner.

Android has now reached a point where it is usable on the FreeRunner as an everyday phone, there are, however, still some caveats. Check out the main Android section of the wiki for more info.

{{Main|Android}}You can also visit the user web page for [http://wiki.openmoko.org/wiki/User:Seanmcneil3 Sean McNeil] for some more info.

====Slackware====

As of release 12.2, Slackware is now officially supported on the Neo Freerunner
[http://armedslack.org/]

==== Hackable:1====
Hackable1 is a community distribution for hackable devices like the Neo Freerunner. It is based on Debian and 2007.2 userland which has been abandoned by Openmoko. It follows the GNOME mobile platform.
{{Main|Hackable:1}}

====[[neovento]]====
neovento is a [[Debian|Debian for Freerunner]] based [[Distributions|distribution]] which uses [http://lxde.org/ LXDE] and [[Zhone]] on top. It is a [http://freeyourphone.de FreeYourPhone.de] community project.

{{Main|neovento}}

==== Others / unreleased ====

* The [http://www.neopwn.com/software.php NeoPwn] network auditng system's core is a modified Linux 2.6.24 kernel, with cross-compiled module driver support for the numerous compatible addon devices running on a FULL Debian (ARMEL) operating system. The filesystem has been optimized for performance and size and includes the NeoPwn menu system and several GUI dialogs for hardware control and attack automation. ''Status: Unknown, the GPL requires source code to be distributed only to customers''.
* [http://runningbear.org/trac RunningBear] is an innovative, yet free and open-source Operating System for hackable devices driven by Bearstech. Lightweight, Portable, Secure, Friendly and Useful. ''Status: In development''.
* [http://pokylinux.org/ Poky] and Sato, by OpenedHand/Intel. An open source platform build tool derived from OE. It is a complete software development environment for the creation of Linux devices. It enables you to design, develop, build, debug, and test a complete, modern, software stack using Linux, the X Window System and GNOME Mobile based application frameworks for both ARM and x86 based platforms. ''Status: The "Nightly Build" Image works fine on Neo Freerunner, but phone functionality doesn't.''
* [http://pyneo.org/ PyNeo] pyneo is a stack for mobile devices excessivly using dbus, glib and evas. pyneo can be considered FSO milestone 0. Afterwards, FSO evolved into an own project with different goals. ''Status: still active, ask around on #pyneo.org ''
* [http://www.quantum-step.com/ mySTEP] by Openmoko distributor Golden Delicious Computers is based on GNUstep and brings a Objective-C API to the Neo. Core GUI frameworks are "Foundation" & "AppKit". It has been shown on FOSDEM 2008, LinuxTag 2008 and SYSTEMS 2008 to run on the Neo 1973. If someone reengineers UIKit, (open) source code compatibility to iPhone apps appears achievable. ''Status: it does not have its own kernel so a Freerunner distribution waits for a solid basis and an arm-linux-gnueabi toolchain that runs natively on Mac OS X is currently lacking.''

== Features by distribution/release target ==

Generally, distributions can differ on one or more of the following components:
* The bootsplash screen image. This is purely decorative.
* The bootloader. Theoretically, any version of ''uboot'' could be used with any distribution. In the future ''Qi'' will replace ''uboot''.
* The kernel. GNU/Linux kernels versions 2.6.24, 2.6.26 or 2.6.28 can be found. Some have modules compiled in, others have modules compiled separately. If compiled separately, modules can be distributed in the same package file as the kernel or separately.
* Middleware: daemons to handle GSM calls or GPS, sound system, personal information storage and so on. Qt and Android have their own subsystems, FreeSmartphone.Org (FSO) is working towards a standard-based Free Software one.
* Display driver. The original ''Qt Extended'' uses the framebuffer, most other distributions today use ''X11''.
* Libraries and application framework (widget toolkit and and graphical environment) : EFL, Qt, Gtk+ or Java ?
* Basic telephony applications: voice calls, SMS, alarm clock...
* Smartphone applications: GPS, media player, simple games, web browser...
* Open source applications: more games, scientific, you name it...

=== Hardware Support ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|Om 2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| GTA01 || ?? || ?? || ?? || {{Yes}} || ?? || {{Yes}} || {{Yes}} || ?? || ??
|-
| GTA02 || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
|}

=== Connectivity ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|Om 2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Telephony || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| SMS || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| [[GPRS]] || Not through UI || Not through UI|| Not through UI || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || Not through UI || {{Yes}}
|-
| [[WiFi]] || {{Yes}} (*) || {{Yes}} || Not through UI || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || Not through UI || {{Yes}}
|-
| VoIP || ?? || ?? || ?? || ?? || {{Yes}} || {{Yes}} (1) || {{Yes}} || ?? || {{no}}
|-
| Bluetooth || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ?? || {{Yes}}
|-
| GPS (1) || {{Yes}} (1) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || {{Yes}} (1) || {{Yes}}
|-
|}

=== Power ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|Om 2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Suspend || {{Yes}} || ?? || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Resumes on Event || ?? || ?? || ?? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ??
|-
| Functions after Resume || {{Yes}} || ?? || ?? || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
|}

=== User Interaction ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|Om2008.8 !! width=8%|2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Stylus friendly || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
| Finger friendly || Partially || Partially || Partially || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}}
|-
| Accelerometer || {{Yes}} [[Rotate|(1)]][[Gestures|(1)]] || {{No}} || {{No}} || {{yes}} (1) || {{Yes}} || {{No}} || {{Yes}} || ?? || {{Yes}}
|-
|}

=== Applications ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0" width=100%
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| Terminal || {{Yes}} (1) || Basic (2) || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || {{Yes}}
|-
| PIM || {{Yes}} || {{Yes}} || {{No}} || N/A || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || ??
|-
| Phonebook || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Dialer || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Web Browser || {{Yes}} (1) || {{Yes}} (1) || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| Mail Client || {{Yes}} || ? || ? || ? || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
| XMPP Client || {{Yes}} [[Instant Messaging|(1)]] || {{Yes}} (1) || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || || ??
|-
| Media Player || {{Yes}} (1) || {{Yes}} || ? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} (1) || ?? || {{Yes}}
|-
|}

=== Toolkits / Runtimes ===
{|class="wikitable" border="1" cellpadding="5" cellspacing="0"
! width=10%| !! width=8%|[[Om 2008.8]] !! width=8%|2007.2 !! width=8%|FSO !! width=8%|SHR !! width=8%|FDOM !! width=8%|Qt Extended !! width=8%|Debian !! width=8%|Gentoo !! width=8%|Android
|-
| GTK+ || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || ??
|-
| Qt/Qt Extended || {{Yes}} || {{No}} || {{Yes}} ? || {{Yes}}? || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ??
|-
| Middleware || qtopia-x11 || gsmd/neod || FSO || FSO || qtopia-x11 || Qt Extended || FSO || FSO || ??
|-
| [[Java]] || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes|Jalimo}} || {{Yes}} || ?? || {{Yes|CacaoVM, JamVM}} || ?? || ??
|-
| [[Python]] || {{Yes}} || {{Yes}} || {{Yes}} || {{yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || ??
|-
| [[Mono]] || {{Yes}} (1) || {{Yes}} (1) || ?? || {{no}} || ?? || ?? || {{Yes}} (1) || ?? || ??
|-
| [[Ruby]] || {{Yes}} || ?? || ?? || ?? || ?? || ?? || {{Yes}} (1) || {{Yes}} (1) || ??
|}

=== Images ===
Latest and stable combinations for Neo FreeRunner gta02
{|class="wikitable" border="1" cellpadding="5" cellspacing="0"
| || OM || FDOM || Qt Extended || Android
|-
| current bootloader || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/distro/releases/Om2008.9/ OM daily] version [http://downloads.openmoko.org/] || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/repository/experimental/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] || [[U-boot|U-Boot]] from [http://downloads.openmoko.org/repository/experimental/ OM daily] version [http://downloads.openmoko.org/daily/gta02v5_and_up-u-boot.bin gta02v5_and_up] ||
|-
| future bootloader || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu || [[Qi]] from [http://people.openmoko.org/andy/ Andy] latest qi-andy.udfu ||
|-
| splash || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz || [[Configuring_the_boot_splash_screens|U-Boot]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest splash.gz ||
|-
| kernel || [[Linux]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest uImage.bin || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest uImage-gta02-mwester-stable.bin or from [http://downloads.tuxfamily.org/3v1deb/openmoko/ treviño] latest uImage-gta02-stable-3v1n0.bin || [[Linux]] see [[Qt_Extended]] page for latest version || [[Linux]] from [http://koolu.org/releases/ koolu]
|-
| modules || ? || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest modules-min-gta02-mwester-stable.tgz or modules-all-gta02-mwester-stable.tgz || [[Linux]] from [http://moko.mwester.net/download/ mwester] latest modules-min-gta02-mwester-stable.tgz or modules-all-gta02-mwester-stable.tgz ||
|-
| rootfs || [[Main_Page|OM]] from [http://downloads.openmoko.org/releases/ OM releases] or [http://downloads.openmoko.org/daily/ OM daily] latest rootfs.jffs2 || [[FDOM]] from [ftp://ftp.tuxbrain.com/openmoko/fdom/releases/ TuxBrain] version [ftp://ftp.tuxbrain.com/openmoko/fdom/releases/Fat_and_Dirty_OM.200809_20081023.rootfs.jff2 200809_20081023] || See [[Qt_Extended]] for latest rootfs || [[Android]] from [http://koolu.org/releases/ koolu]
|}

Footnotes:

(1) works, but need additional software to be installed

(2) unusable due to lack of certain keyboard characters. [[Switching_Keyboards#Matchbox_keyboard|Various fixes available.]]

(*) unstable

==Quick download page==

[[Download]]

== See also ==

* Mickey Lauer's post "[http://www.vanille-media.de/site/index.php/2008/06/28/gtk-asu-fso-tmtla/ GTK, ASU, FSO, TMTLA!]" describes the differences between distributions 2007.2, ASU and FSO.

* Latest news and tips are in [[Community Updates]]

* [[Kustomizer]] is a script to change your 2008.12 to a usable phone

[[Category:Distributions| ]]

Kernel

2009-04-14T11:14:28Z

Myfanwy: spelling, grammar, general readability

{{Kernel}}

== Things changed ==

This page will be updated soon. Those are the current [[Kernel_Plans|Kernel plans]].

== Is this page meant for you? ==

This information is mostly useful for developers and power/curious users. If you are looking for a kernel to flash into your GTA01/GTA02 you might want to grab one from the daily builds (scroll down and you'll find it) or get one that ships with one of the [[Distributions]]. The good thing with daily builds is that the newest might be the better. The bad thing of daily builds might be that you can get a broken kernel. If you feel way too uncomfortable making decisions about which kernel to try first and you are not willing to spend the time finding out which one works for you, then this page is not meant for you and you should be looking for stable [[Distributions]] instead. The distributors make this easier for you. You might want to scroll down for the 'blessed' kernels in the daily builds.

== Introduction ==

Linux kernel developers from the community and [[Openmoko]] Linux kernel developers maintain a working kernel for the [[Freerunner]] (Also known as GTA02) and also for the [[Neo1973]] (Aka GTA01).

Right now there is an ongoing effort to reduce the difference between current Linux 2.6 (mainline) and the kernel in the Openmoko repository and thanks to this work we can run the most recent released version of Linux 2.6.

=== Sister pages ===

# [[Kernel branches]].

== Sources ==

The sources of the Openmoko Linux kernel live in a GIT repository. With the WEB interface you can peek at the contents of the repository:

http://git.openmoko.org/?p=kernel.git;a=summary

[http://git-scm.com GIT] is a fast version control system suited for the workflow that many kernel developers use. It is specially useful when you need to send patches for a project (who in turn might need to send them upstream). This is an over-simplification but it gives you the idea in case you did not know.

GIT might seem complicated at first but once it's usage is learned, you will find many ways for it to increase your productivity. For completeness in this page we include the GIT commands which you need in order to build a working kernel.

If you are very new to GIT you might want to read [http://git.or.cz/course/ the good manuals that already available].

If you would like to contribute code we also have a page with [[Hints_on_using_GIT_and_stgit]] where we all hope to share some cool tips and tricks that can help you. You do not need to learn stgit in order to send patches to the Kernel Mailing List but we have to tell you that once you know git, stgit will make you more productive when you need to send a few patch at once (patchsets).

=== Branches ===

GIT allow developers to use different [[branches that help speed up development (and even make it possible). You might have noticed we have a few branches if already you visited the WEB interface (http://git.openmoko.org/?p=kernel.git;a=summary).

The ''andy-tracking'' branch is the one where most of the action takes place these days.

We have [[Kernel_branches|branch policies]] that explain what each branch is for.

=== Daily builds ===

==== Automatic revisions ====

Think of a robot that takes whatever kernels are the most recent in GIT, builds them for you and then makes them available here:

http://downloads.openmoko.org/distro/experimental/

==== Blessed revisions ====

Another robot but this one only builds the versions picked by our friendly [[OpenEmbedded]] developers. Download from:

http://downloads.openmoko.org/distro/unstable/

If you understand OpenEmbedded you will get this: Those versions are tied to a specific GIT revision through conf/distro/include/sane-srcrevs.bb.

=== Building the andy-tracking branch ===

Those are the minimum survival commands:

$ git clone git://git.openmoko.org/git/kernel.git linux-2.6
$ cd linux-2.6
$ git-checkout --track -b andy-tracking origin/andy-tracking
$ mkdir GTA02
$ cp ./arch/arm/configs/gta02_moredrivers_defconfig GTA02/.config

Before building this kernel you need install a [http://wiki.openmoko.org/wiki/Toolchain#Downloading_and_installing Toolchain].

$ ./build GTA02

Once the script finishes you will get two files. The first is ''uImage-GTA02.bin'' and a second file with a longer name but same contents, for instance ''uImage-moredrivers-GTA02_andy-tracking_c16287685cb59f91.bin''. Please use the second file if you publish your kernel in some server or if you talk about it in public (specially in bugs reports) because it will allow others to know what kernel you were trying (in case you don't have local changes).

In order to build the modules you can:

$ ./build GTA02 dummy

This will create a file called modules-GTA02_andy-tracking-<git hash>.tar.gz. The contents of this file have to be copied to /lib/firmaware and /lib/modules and one way to do it is untarring the file on the root directory of the device.

If you want to update the local copy of the repository so that you get the latest changes, you can type:

$ git-pull

Before reporting that the new kernel does not build please first check for changes in the configuration file provided by Openmoko.

=== kernel building tips ===

If you are modifying Linux kernel code and building it quite often you really want to be using [http://ccache.samba.org ccache]. It will save you a lot of time.

TODO: submit a patch for the build script that makes ccache use easier. '''Note''': There is a [http://lists.openmoko.org/pipermail/openmoko-kernel/2009-March/009139.html patch being reviewed].

== Contributing ==

The development resources [[Openmoko]] offers are:

* Git repository: http://git.openmoko.org/?p=kernel.git;a=summary
* [http://lists.openmoko.org/mailman/listinfo/openmoko-kernel Mailing list] ([http://lists.openmoko.org/pipermail/openmoko-kernel/ Online Archive])

We appreciate your contributions. Check the Open Issues at the end of this page to check where we need more help.

If in doubt ask in the mailing list.

== FAQ ==

=== Why does Openmoko cares about sending code upstream instead of (insert your task here)? ===

There are two very different approaches and both of them would be doomed if we committed all our resources to only one of them.

The first approach is not to care about upstream kernel development efforts and stick to an old kernel while struggling to make it work, ignoring the fact that it is [http://www.kernel.org upstream] where the people who want to help us improve, maintain and support the code running in our devices, hang out.

The second is to care way '''too much''' about upstream to the point that we are not willing to ship a temporary dirty hack that makes users happy and able to better use their phones. We cannot afford that kind of purity.

As with many things in engineering (and life), we have to find a point in the middle that works well - we will try hard to do it.

=== Who's Andy and why is he sticking his name in the kernel? ===

He created the branch and maintained it for a while. It is an usual practice that in kernel development some branches are named after the person who is taking care of them

Check [[Kernel_branches]] if you care about the details.

=== Kernel developers are not polite! They do not even care to say "Hello" when they reply to my emails! ===

The long version is here: [[Kernel-developers-are-not-polite]].

To the point:

All these opensource programmers are nicer in person (if you don't interrupt them while they are programming). On the internet they might appear to be very rude, but in person things are very different specially over lunch or when sharing a beer.

They just tend to write very short text because they have to read and write a lot every day.

== Known issues ==

=== Sysfs paths ===

Unfortunately we had to update many sysfs paths (see [[GTA02_sysfs]]) and since we did it the kernel stopped working properly with some distributions. Unless the distribution is abandoned it will likely catch up with the newest kernel soon.

[[FSO]] developers realized that this problem could be prevented from from happening in the future and they decided to code a nice daemon called [http://www.freesmartphone.org/index.php/Implementations/OpenDeviceDaemon odeviced].

== Open Tickets ==

'''This
[http://docs.openmoko.org/trac/query?status=in_testing&status=reopened&status=assigned&status=new&status=accepted&group=status&milestone=stable-kernel-2009.1 report] will show the bugs that are a priority for us now'''.

'''Please read [https://docs.openmoko.org/trac/query?status=accepted&status=assigned&status=in_testing&status=new&status=reopened&component=System+Software&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component this report]''' if you wish to know what the current issues are.

If you can help us with one of those issues it would be a great way to help us move forward. If in doubt please write to the Openmoko Kernel Mailing List. Let us link some bugs here without overdoing it because trac is better than a normal wiki for this. If we have more than 10 bugs the following lists then we might be doing it wrong.

=== Easy bugs ===

Those are the bugs that active kernel developers believe can be fixed by new kernel programmers that might want to join us. Thus they are leaving them unfixed for some reasonable time while they work on the harder bugs.

TODO: list of bugs linking to trac.

=== Normal bugs ===

Those are the bugs that we have not fixed because they might be hard and/or because we have not found the time to fix them. They might end up being Easy Bugs or Evil bugs. We will use trac for them.

'''This is the complete [https://docs.openmoko.org/trac/query?status=accepted&status=assigned&status=in_testing&status=new&status=reopened&component=System+Software&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component report]''' with all the bugs (some of them might be invalid).

=== Hard bugs ===

Those are the evil bugs that we haven't fixed either because:

# We do not know how to do it in reasonable time
# The hardware vendor does not want to release documentation or to fix firmware (some of them do that unfortunately / even breaking promises they made to Openmoko about making things easier for developers)
# More testing is needed (perhaps a hard-to-reproduce bug)

Here is the list:

* [https://docs.openmoko.org/trac/ticket/2235 #2235 : Monochrome display on resume]

{{Languages|Kernel}}

[[Category:Kernel]]
[[Category:System Developers]]
[[Category:Application Developer]]

Kernel

2009-04-14T11:11:57Z

Myfanwy: /* Sources */

{{Kernel}}

== Things changed ==

This page will be updated soon. Those are the current [[Kernel_Plans|Kernel plans]].

== Is this page meant for you? ==

This information is mostly useful for developers and power/curious users. If you are looking for a kernel to flash into your GTA01/GTA02 you might want to grab one from the daily builds (scroll down and you'll find it) or get one that ships with one of the [[Distributions]]. The good thing with daily builds is that the newest might be the better. The bad thing of daily builds might be that you can get a broken kernel. If you feel way too uncomfortable making decisions about which kernel to try first and you are not willing to spend the time finding out which one works for you, then this page is not meant for you and you should be looking for stable [[Distributions]] instead. The distributors make this easier for you. You might want to scroll down for the 'blessed' kernels in the daily builds.

== Introduction ==

Linux kernel developers from the community and [[Openmoko]] Linux kernel developers maintain a working kernel for the [[Freerunner]] (Also known as GTA02) and also for the [[Neo1973]] (Aka GTA01).

Right now there is an ongoing effort to reduce the difference between current Linux 2.6 (mainline) and the kernel in the Openmoko repository and thanks to this work we can run the most recent released version of Linux 2.6.

=== Sister pages ===

# [[Kernel branches]].

== Sources ==

The sources of the Openmoko Linux kernel live in a GIT repository. With the WEB interface you can peek at the contents of the repository:

http://git.openmoko.org/?p=kernel.git;a=summary

[http://git-scm.com GIT] is a fast version control system suited for the workflow that many kernel developers use. It is specially useful when you need to send patches for a project (who in turn might need to send them upstream). This is an over-simplification but it gives you the idea in case you did not know.

GIT might seem complicated at first but once it's usage is learned, you will find many ways for it to increase your productivity. For completeness in this page we include the GIT commands which you need in order to build a working kernel.

If you are very new to GIT you might want to read [http://git.or.cz/course/ the good manuals that already available].

If you would like to contribute code we also have a page with [[Hints_on_using_GIT_and_stgit]] where we all hope to share some cool tips and tricks that can help you. You do not need to learn stgit in order to send patches to the Kernel Mailing List but we have to tell you that once you know git, stgit will make you more productive when you need to send a few patch at once (patchsets).

=== Branches ===

GIT allow developers to use different [[branches that help speed up development (and even make it possible). You might have noticed we have a few branches if already you visited the WEB interface (http://git.openmoko.org/?p=kernel.git;a=summary).

The ''andy-tracking'' branch is the one where most of the action takes place these days.

We have [[Kernel_branches|branch policies]] that explain what each branch is for.

=== Daily builds ===

==== Automatic revisions ====

Think of a robot that takes whatever kernels are the most recent in GIT, builds them for you and then makes them available here:

http://downloads.openmoko.org/distro/experimental/

==== Blessed revisions ====

Another robot but this one only builds the versions picked by our friendly [[OpenEmbedded]] developers. Download from:

http://downloads.openmoko.org/distro/unstable/

If you understand OpenEmbedded you will get this: Those versions are tied to a specific GIT revision through conf/distro/include/sane-srcrevs.bb.

=== Building the andy-tracking branch ===

Those are the minimum survival commands:

$ git clone git://git.openmoko.org/git/kernel.git linux-2.6
$ cd linux-2.6
$ git-checkout --track -b andy-tracking origin/andy-tracking
$ mkdir GTA02
$ cp ./arch/arm/configs/gta02_moredrivers_defconfig GTA02/.config

Before building this kernel you need install a [http://wiki.openmoko.org/wiki/Toolchain#Downloading_and_installing Toolchain].

$ ./build GTA02

Once the script finishes you will get two files. The first is ''uImage-GTA02.bin'' and a second file with a longer name but same contents, for instance ''uImage-moredrivers-GTA02_andy-tracking_c16287685cb59f91.bin''. Please use the second file if you publish your kernel in some server or if you talk about it in public (specially in bugs reports) because it will allow others to know what kernel you were trying (in case you don't have local changes).

In order to build the modules you can:

$ ./build GTA02 dummy

This will create a file called modules-GTA02_andy-tracking-<git hash>.tar.gz. The contents of this file have to be copied to /lib/firmaware and /lib/modules and one way to do it is untarring the file on the root directory of the device.

If you want to update the local copy of the repository so that you get the latest changes, you can type:

$ git-pull

Before reporting that the new kernel does not build please first check for changes in the configuration file provided by Openmoko.

=== kernel building tips ===

If you are modifying Linux kernel code and building it quite often you really want to be using [http://ccache.samba.org ccache]. It will save you a lot of time.

TODO: submit a patch for the build script that makes ccache use easier. '''Note''': There is a [http://lists.openmoko.org/pipermail/openmoko-kernel/2009-March/009139.html patch being reviewed].

== Contributing ==

The development resources [[Openmoko]] offers are:

* Git repository: http://git.openmoko.org/?p=kernel.git;a=summary
* [http://lists.openmoko.org/mailman/listinfo/openmoko-kernel Mailing list] ([http://lists.openmoko.org/pipermail/openmoko-kernel/ Online Archive])

We appreciate your contributions. Check the Open Issues at the end of this page to check where we need more help.

If in doubt ask in the mailing list.

== FAQ ==

=== Why does Openmoko cares about sending code upstream instead of (insert your task here)? ===

There are two very different approaches and both of them would be doomed if we stuck all our resources to only one of to them.

The first approach is not to care about upstream kernel development efforts and stick to an old kernel while struggling to make it work, ignoring the fact that it is [http://www.kernel.org upstream] where the people who want to help us improve, maintain and support the code running in our devices hang out.

The second is to care way '''too much''' about upstream to the point that we are not willing to ship a temporal dirty hack that make users happy and able to better use their phones. We cannot afford that kind of purity.

As many things in engineering we have to find a point in the middle that works well -- we will try hard to do it.

=== Who's Andy and why is he sticking his name in the kernel? ===

He created the branch and maintained it for a while. It is an usual practice that in kernel development some branches are named after the person who is taking care of them

Check [[Kernel_branches]] if you care about the details.

=== Kernel developers are not polite! They do not even care to say "Hello" when they reply to my emails! ===

The long version is here: [[Kernel-developers-are-not-polite]].

To the point:

All these opensource programmers are nicer in person (if you don't interrupt them while they are programming). On the internet they might appear to be very rude, but in person things are very different specially over lunch or when sharing a beer.

They just tend to write very short text because they have to read and write a lot every day.

== Known issues ==

=== Sysfs paths ===

Unfortunately we had to update many sysfs paths (see [[GTA02_sysfs]]) and since we did it the kernel stopped working properly with some distributions. Unless the distribution is abandoned it will likely catch up with the newest kernel soon.

[[FSO]] developers realized that this problem could be prevented from from happening in the future and they decided to code a nice daemon called [http://www.freesmartphone.org/index.php/Implementations/OpenDeviceDaemon odeviced].

== Open Tickets ==

'''This
[http://docs.openmoko.org/trac/query?status=in_testing&status=reopened&status=assigned&status=new&status=accepted&group=status&milestone=stable-kernel-2009.1 report] will show the bugs that are a priority for us now'''.

'''Please read [https://docs.openmoko.org/trac/query?status=accepted&status=assigned&status=in_testing&status=new&status=reopened&component=System+Software&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component this report]''' if you wish to know what the current issues are.

If you can help us with one of those issues it would be a great way to help us move forward. If in doubt please write to the Openmoko Kernel Mailing List. Let us link some bugs here without overdoing it because trac is better than a normal wiki for this. If we have more than 10 bugs the following lists then we might be doing it wrong.

=== Easy bugs ===

Those are the bugs that active kernel developers believe can be fixed by new kernel programmers that might want to join us. Thus they are leaving them unfixed for some reasonable time while they work on the harder bugs.

TODO: list of bugs linking to trac.

=== Normal bugs ===

Those are the bugs that we have not fixed because they might be hard and/or because we have not found the time to fix them. They might end up being Easy Bugs or Evil bugs. We will use trac for them.

'''This is the complete [https://docs.openmoko.org/trac/query?status=accepted&status=assigned&status=in_testing&status=new&status=reopened&component=System+Software&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component report]''' with all the bugs (some of them might be invalid).

=== Hard bugs ===

Those are the evil bugs that we haven't fixed either because:

# We do not know how to do it in reasonable time
# The hardware vendor does not want to release documentation or to fix firmware (some of them do that unfortunately / even breaking promises they made to Openmoko about making things easier for developers)
# More testing is needed (perhaps a hard-to-reproduce bug)

Here is the list:

* [https://docs.openmoko.org/trac/ticket/2235 #2235 : Monochrome display on resume]

{{Languages|Kernel}}

[[Category:Kernel]]
[[Category:System Developers]]
[[Category:Application Developer]]

Kernel

2009-04-14T11:10:15Z

Myfanwy: /* Sister pages */

{{Kernel}}

== Things changed ==

This page will be updated soon. Those are the current [[Kernel_Plans|Kernel plans]].

== Is this page meant for you? ==

This information is mostly useful for developers and power/curious users. If you are looking for a kernel to flash into your GTA01/GTA02 you might want to grab one from the daily builds (scroll down and you'll find it) or get one that ships with one of the [[Distributions]]. The good thing with daily builds is that the newest might be the better. The bad thing of daily builds might be that you can get a broken kernel. If you feel way too uncomfortable making decisions about which kernel to try first and you are not willing to spend the time finding out which one works for you, then this page is not meant for you and you should be looking for stable [[Distributions]] instead. The distributors make this easier for you. You might want to scroll down for the 'blessed' kernels in the daily builds.

== Introduction ==

Linux kernel developers from the community and [[Openmoko]] Linux kernel developers maintain a working kernel for the [[Freerunner]] (Also known as GTA02) and also for the [[Neo1973]] (Aka GTA01).

Right now there is an ongoing effort to reduce the difference between current Linux 2.6 (mainline) and the kernel in the Openmoko repository and thanks to this work we can run the most recent released version of Linux 2.6.

=== Sister pages ===

# [[Kernel branches]].

== Sources ==

The sources of the Openmoko Linux kernel live in a GIT repository. With the WEB interface you can peek at the contents of the repository:

http://git.openmoko.org/?p=kernel.git;a=summary

[http://git-scm.com GIT] is a fast version control system suited for the workflow that many kernel developers use. It is specially useful when you need to send patches for a project (who might in turn might need to send them upstream). This is an over-simplification but it gives you the idea in case you did not know.

GIT might seem complicated at first but once you learn to use it you will find many ways to increase your productivity by using it. For completeness in this page we include the GIT commands that you need in order to build a working kernel.

If you are very new to GIT you might want to read [http://git.or.cz/course/ the good manuals that already available].

If you would like to contribute code we also have a page with [[Hints_on_using_GIT_and_stgit]] where we all hope to share some cool tips and tricks that can help you. You do not need to learn stgit in order to send patches to the Kernel Mailing List but we have to tell you that once you know git, stgit will make you more productive when you need to send a few patch at once (patchsets).

=== Branches ===

GIT allow developers to use different [[branches that help speed up development (and even make it possible). You might have noticed we have a few branches if already you visited the WEB interface (http://git.openmoko.org/?p=kernel.git;a=summary).

The ''andy-tracking'' branch is the one where most of the action takes place these days.

We have [[Kernel_branches|branch policies]] that explain what each branch is for.

=== Daily builds ===

==== Automatic revisions ====

Think of a robot that takes whatever kernels are the most recent in GIT, builds them for you and then makes them available here:

http://downloads.openmoko.org/distro/experimental/

==== Blessed revisions ====

Another robot but this one only builds the versions picked by our friendly [[OpenEmbedded]] developers. Download from:

http://downloads.openmoko.org/distro/unstable/

If you understand OpenEmbedded you will get this: Those versions are tied to a specific GIT revision through conf/distro/include/sane-srcrevs.bb.

=== Building the andy-tracking branch ===

Those are the minimum survival commands:

$ git clone git://git.openmoko.org/git/kernel.git linux-2.6
$ cd linux-2.6
$ git-checkout --track -b andy-tracking origin/andy-tracking
$ mkdir GTA02
$ cp ./arch/arm/configs/gta02_moredrivers_defconfig GTA02/.config

Before building this kernel you need install a [http://wiki.openmoko.org/wiki/Toolchain#Downloading_and_installing Toolchain].

$ ./build GTA02

Once the script finishes you will get two files. The first is ''uImage-GTA02.bin'' and a second file with a longer name but same contents, for instance ''uImage-moredrivers-GTA02_andy-tracking_c16287685cb59f91.bin''. Please use the second file if you publish your kernel in some server or if you talk about it in public (specially in bugs reports) because it will allow others to know what kernel you were trying (in case you don't have local changes).

In order to build the modules you can:

$ ./build GTA02 dummy

This will create a file called modules-GTA02_andy-tracking-<git hash>.tar.gz. The contents of this file have to be copied to /lib/firmaware and /lib/modules and one way to do it is untarring the file on the root directory of the device.

If you want to update the local copy of the repository so that you get the latest changes, you can type:

$ git-pull

Before reporting that the new kernel does not build please first check for changes in the configuration file provided by Openmoko.

=== kernel building tips ===

If you are modifying Linux kernel code and building it quite often you really want to be using [http://ccache.samba.org ccache]. It will save you a lot of time.

TODO: submit a patch for the build script that makes ccache use easier. '''Note''': There is a [http://lists.openmoko.org/pipermail/openmoko-kernel/2009-March/009139.html patch being reviewed].

== Contributing ==

The development resources [[Openmoko]] offers are:

* Git repository: http://git.openmoko.org/?p=kernel.git;a=summary
* [http://lists.openmoko.org/mailman/listinfo/openmoko-kernel Mailing list] ([http://lists.openmoko.org/pipermail/openmoko-kernel/ Online Archive])

We appreciate your contributions. Check the Open Issues at the end of this page to check where we need more help.

If in doubt ask in the mailing list.

== FAQ ==

=== Why does Openmoko cares about sending code upstream instead of (insert your task here)? ===

There are two very different approaches and both of them would be doomed if we stuck all our resources to only one of to them.

The first approach is not to care about upstream kernel development efforts and stick to an old kernel while struggling to make it work, ignoring the fact that it is [http://www.kernel.org upstream] where the people who want to help us improve, maintain and support the code running in our devices hang out.

The second is to care way '''too much''' about upstream to the point that we are not willing to ship a temporal dirty hack that make users happy and able to better use their phones. We cannot afford that kind of purity.

As many things in engineering we have to find a point in the middle that works well -- we will try hard to do it.

=== Who's Andy and why is he sticking his name in the kernel? ===

He created the branch and maintained it for a while. It is an usual practice that in kernel development some branches are named after the person who is taking care of them

Check [[Kernel_branches]] if you care about the details.

=== Kernel developers are not polite! They do not even care to say "Hello" when they reply to my emails! ===

The long version is here: [[Kernel-developers-are-not-polite]].

To the point:

All these opensource programmers are nicer in person (if you don't interrupt them while they are programming). On the internet they might appear to be very rude, but in person things are very different specially over lunch or when sharing a beer.

They just tend to write very short text because they have to read and write a lot every day.

== Known issues ==

=== Sysfs paths ===

Unfortunately we had to update many sysfs paths (see [[GTA02_sysfs]]) and since we did it the kernel stopped working properly with some distributions. Unless the distribution is abandoned it will likely catch up with the newest kernel soon.

[[FSO]] developers realized that this problem could be prevented from from happening in the future and they decided to code a nice daemon called [http://www.freesmartphone.org/index.php/Implementations/OpenDeviceDaemon odeviced].

== Open Tickets ==

'''This
[http://docs.openmoko.org/trac/query?status=in_testing&status=reopened&status=assigned&status=new&status=accepted&group=status&milestone=stable-kernel-2009.1 report] will show the bugs that are a priority for us now'''.

'''Please read [https://docs.openmoko.org/trac/query?status=accepted&status=assigned&status=in_testing&status=new&status=reopened&component=System+Software&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component this report]''' if you wish to know what the current issues are.

If you can help us with one of those issues it would be a great way to help us move forward. If in doubt please write to the Openmoko Kernel Mailing List. Let us link some bugs here without overdoing it because trac is better than a normal wiki for this. If we have more than 10 bugs the following lists then we might be doing it wrong.

=== Easy bugs ===

Those are the bugs that active kernel developers believe can be fixed by new kernel programmers that might want to join us. Thus they are leaving them unfixed for some reasonable time while they work on the harder bugs.

TODO: list of bugs linking to trac.

=== Normal bugs ===

Those are the bugs that we have not fixed because they might be hard and/or because we have not found the time to fix them. They might end up being Easy Bugs or Evil bugs. We will use trac for them.

'''This is the complete [https://docs.openmoko.org/trac/query?status=accepted&status=assigned&status=in_testing&status=new&status=reopened&component=System+Software&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component report]''' with all the bugs (some of them might be invalid).

=== Hard bugs ===

Those are the evil bugs that we haven't fixed either because:

# We do not know how to do it in reasonable time
# The hardware vendor does not want to release documentation or to fix firmware (some of them do that unfortunately / even breaking promises they made to Openmoko about making things easier for developers)
# More testing is needed (perhaps a hard-to-reproduce bug)

Here is the list:

* [https://docs.openmoko.org/trac/ticket/2235 #2235 : Monochrome display on resume]

{{Languages|Kernel}}

[[Category:Kernel]]
[[Category:System Developers]]
[[Category:Application Developer]]

Kernel

2009-04-14T11:09:41Z

Myfanwy: /* Is this page meant for you? */

{{Kernel}}

== Things changed ==

This page will be updated soon. Those are the current [[Kernel_Plans|Kernel plans]].

== Is this page meant for you? ==

This information is mostly useful for developers and power/curious users. If you are looking for a kernel to flash into your GTA01/GTA02 you might want to grab one from the daily builds (scroll down and you'll find it) or get one that ships with one of the [[Distributions]]. The good thing with daily builds is that the newest might be the better. The bad thing of daily builds might be that you can get a broken kernel. If you feel way too uncomfortable making decisions about which kernel to try first and you are not willing to spend the time finding out which one works for you, then this page is not meant for you and you should be looking for stable [[Distributions]] instead. The distributors make this easier for you. You might want to scroll down for the 'blessed' kernels in the daily builds.

== Introduction ==

Linux kernel developers from the community and [[Openmoko]] Linux kernel developers maintain a working kernel for the [[Freerunner]] (Also known as GTA02) and also for the [[Neo1973]] (Aka GTA01).

Right now there is an ongoing effort to reduce the difference between current Linux 2.6 (mainline) and the kernel in the Openmoko repository and thanks to this work we can run the most recent released version of Linux 2.6.

=== Sister pages ===

# [[Kernel_branches]].

== Sources ==

The sources of the Openmoko Linux kernel live in a GIT repository. With the WEB interface you can peek at the contents of the repository:

http://git.openmoko.org/?p=kernel.git;a=summary

[http://git-scm.com GIT] is a fast version control system suited for the workflow that many kernel developers use. It is specially useful when you need to send patches for a project (who might in turn might need to send them upstream). This is an over-simplification but it gives you the idea in case you did not know.

GIT might seem complicated at first but once you learn to use it you will find many ways to increase your productivity by using it. For completeness in this page we include the GIT commands that you need in order to build a working kernel.

If you are very new to GIT you might want to read [http://git.or.cz/course/ the good manuals that already available].

If you would like to contribute code we also have a page with [[Hints_on_using_GIT_and_stgit]] where we all hope to share some cool tips and tricks that can help you. You do not need to learn stgit in order to send patches to the Kernel Mailing List but we have to tell you that once you know git, stgit will make you more productive when you need to send a few patch at once (patchsets).

=== Branches ===

GIT allow developers to use different [[branches that help speed up development (and even make it possible). You might have noticed we have a few branches if already you visited the WEB interface (http://git.openmoko.org/?p=kernel.git;a=summary).

The ''andy-tracking'' branch is the one where most of the action takes place these days.

We have [[Kernel_branches|branch policies]] that explain what each branch is for.

=== Daily builds ===

==== Automatic revisions ====

Think of a robot that takes whatever kernels are the most recent in GIT, builds them for you and then makes them available here:

http://downloads.openmoko.org/distro/experimental/

==== Blessed revisions ====

Another robot but this one only builds the versions picked by our friendly [[OpenEmbedded]] developers. Download from:

http://downloads.openmoko.org/distro/unstable/

If you understand OpenEmbedded you will get this: Those versions are tied to a specific GIT revision through conf/distro/include/sane-srcrevs.bb.

=== Building the andy-tracking branch ===

Those are the minimum survival commands:

$ git clone git://git.openmoko.org/git/kernel.git linux-2.6
$ cd linux-2.6
$ git-checkout --track -b andy-tracking origin/andy-tracking
$ mkdir GTA02
$ cp ./arch/arm/configs/gta02_moredrivers_defconfig GTA02/.config

Before building this kernel you need install a [http://wiki.openmoko.org/wiki/Toolchain#Downloading_and_installing Toolchain].

$ ./build GTA02

Once the script finishes you will get two files. The first is ''uImage-GTA02.bin'' and a second file with a longer name but same contents, for instance ''uImage-moredrivers-GTA02_andy-tracking_c16287685cb59f91.bin''. Please use the second file if you publish your kernel in some server or if you talk about it in public (specially in bugs reports) because it will allow others to know what kernel you were trying (in case you don't have local changes).

In order to build the modules you can:

$ ./build GTA02 dummy

This will create a file called modules-GTA02_andy-tracking-<git hash>.tar.gz. The contents of this file have to be copied to /lib/firmaware and /lib/modules and one way to do it is untarring the file on the root directory of the device.

If you want to update the local copy of the repository so that you get the latest changes, you can type:

$ git-pull

Before reporting that the new kernel does not build please first check for changes in the configuration file provided by Openmoko.

=== kernel building tips ===

If you are modifying Linux kernel code and building it quite often you really want to be using [http://ccache.samba.org ccache]. It will save you a lot of time.

TODO: submit a patch for the build script that makes ccache use easier. '''Note''': There is a [http://lists.openmoko.org/pipermail/openmoko-kernel/2009-March/009139.html patch being reviewed].

== Contributing ==

The development resources [[Openmoko]] offers are:

* Git repository: http://git.openmoko.org/?p=kernel.git;a=summary
* [http://lists.openmoko.org/mailman/listinfo/openmoko-kernel Mailing list] ([http://lists.openmoko.org/pipermail/openmoko-kernel/ Online Archive])

We appreciate your contributions. Check the Open Issues at the end of this page to check where we need more help.

If in doubt ask in the mailing list.

== FAQ ==

=== Why does Openmoko cares about sending code upstream instead of (insert your task here)? ===

There are two very different approaches and both of them would be doomed if we stuck all our resources to only one of to them.

The first approach is not to care about upstream kernel development efforts and stick to an old kernel while struggling to make it work, ignoring the fact that it is [http://www.kernel.org upstream] where the people who want to help us improve, maintain and support the code running in our devices hang out.

The second is to care way '''too much''' about upstream to the point that we are not willing to ship a temporal dirty hack that make users happy and able to better use their phones. We cannot afford that kind of purity.

As many things in engineering we have to find a point in the middle that works well -- we will try hard to do it.

=== Who's Andy and why is he sticking his name in the kernel? ===

He created the branch and maintained it for a while. It is an usual practice that in kernel development some branches are named after the person who is taking care of them

Check [[Kernel_branches]] if you care about the details.

=== Kernel developers are not polite! They do not even care to say "Hello" when they reply to my emails! ===

The long version is here: [[Kernel-developers-are-not-polite]].

To the point:

All these opensource programmers are nicer in person (if you don't interrupt them while they are programming). On the internet they might appear to be very rude, but in person things are very different specially over lunch or when sharing a beer.

They just tend to write very short text because they have to read and write a lot every day.

== Known issues ==

=== Sysfs paths ===

Unfortunately we had to update many sysfs paths (see [[GTA02_sysfs]]) and since we did it the kernel stopped working properly with some distributions. Unless the distribution is abandoned it will likely catch up with the newest kernel soon.

[[FSO]] developers realized that this problem could be prevented from from happening in the future and they decided to code a nice daemon called [http://www.freesmartphone.org/index.php/Implementations/OpenDeviceDaemon odeviced].

== Open Tickets ==

'''This
[http://docs.openmoko.org/trac/query?status=in_testing&status=reopened&status=assigned&status=new&status=accepted&group=status&milestone=stable-kernel-2009.1 report] will show the bugs that are a priority for us now'''.

'''Please read [https://docs.openmoko.org/trac/query?status=accepted&status=assigned&status=in_testing&status=new&status=reopened&component=System+Software&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component this report]''' if you wish to know what the current issues are.

If you can help us with one of those issues it would be a great way to help us move forward. If in doubt please write to the Openmoko Kernel Mailing List. Let us link some bugs here without overdoing it because trac is better than a normal wiki for this. If we have more than 10 bugs the following lists then we might be doing it wrong.

=== Easy bugs ===

Those are the bugs that active kernel developers believe can be fixed by new kernel programmers that might want to join us. Thus they are leaving them unfixed for some reasonable time while they work on the harder bugs.

TODO: list of bugs linking to trac.

=== Normal bugs ===

Those are the bugs that we have not fixed because they might be hard and/or because we have not found the time to fix them. They might end up being Easy Bugs or Evil bugs. We will use trac for them.

'''This is the complete [https://docs.openmoko.org/trac/query?status=accepted&status=assigned&status=in_testing&status=new&status=reopened&component=System+Software&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component report]''' with all the bugs (some of them might be invalid).

=== Hard bugs ===

Those are the evil bugs that we haven't fixed either because:

# We do not know how to do it in reasonable time
# The hardware vendor does not want to release documentation or to fix firmware (some of them do that unfortunately / even breaking promises they made to Openmoko about making things easier for developers)
# More testing is needed (perhaps a hard-to-reproduce bug)

Here is the list:

* [https://docs.openmoko.org/trac/ticket/2235 #2235 : Monochrome display on resume]

{{Languages|Kernel}}

[[Category:Kernel]]
[[Category:System Developers]]
[[Category:Application Developer]]

Kernel

2009-04-14T11:09:17Z

Myfanwy: /* Is this page meant for you? */

{{Kernel}}

== Things changed ==

This page will be updated soon. Those are the current [[Kernel_Plans|Kernel plans]].

== Is this page meant for you? ==

This information is mostly useful for developers and power/curious users. If you are looking for a kernel to flash into your GTA01/GTA02 you might want to grab one from the daily builds (scroll down and you'll find it) or get one that ships with one of the [[Distributions]]. The good thing with daily builds is that the newest might be the better. The bad thing of daily builds might be that you can get a broken kernel. If you feel way too uncomfortable making decisions about which kernel to try first and you are not willing to spend the time finding out which one works for you, then this page is not meant for you and you should be looking for stable [[Distributions]] instead. The distributors make this easier for you. You might want to scroll down for the for the blessed kernels in the daily builds.

== Introduction ==

Linux kernel developers from the community and [[Openmoko]] Linux kernel developers maintain a working kernel for the [[Freerunner]] (Also known as GTA02) and also for the [[Neo1973]] (Aka GTA01).

Right now there is an ongoing effort to reduce the difference between current Linux 2.6 (mainline) and the kernel in the Openmoko repository and thanks to this work we can run the most recent released version of Linux 2.6.

=== Sister pages ===

# [[Kernel_branches]].

== Sources ==

The sources of the Openmoko Linux kernel live in a GIT repository. With the WEB interface you can peek at the contents of the repository:

http://git.openmoko.org/?p=kernel.git;a=summary

[http://git-scm.com GIT] is a fast version control system suited for the workflow that many kernel developers use. It is specially useful when you need to send patches for a project (who might in turn might need to send them upstream). This is an over-simplification but it gives you the idea in case you did not know.

GIT might seem complicated at first but once you learn to use it you will find many ways to increase your productivity by using it. For completeness in this page we include the GIT commands that you need in order to build a working kernel.

If you are very new to GIT you might want to read [http://git.or.cz/course/ the good manuals that already available].

If you would like to contribute code we also have a page with [[Hints_on_using_GIT_and_stgit]] where we all hope to share some cool tips and tricks that can help you. You do not need to learn stgit in order to send patches to the Kernel Mailing List but we have to tell you that once you know git, stgit will make you more productive when you need to send a few patch at once (patchsets).

=== Branches ===

GIT allow developers to use different [[branches that help speed up development (and even make it possible). You might have noticed we have a few branches if already you visited the WEB interface (http://git.openmoko.org/?p=kernel.git;a=summary).

The ''andy-tracking'' branch is the one where most of the action takes place these days.

We have [[Kernel_branches|branch policies]] that explain what each branch is for.

=== Daily builds ===

==== Automatic revisions ====

Think of a robot that takes whatever kernels are the most recent in GIT, builds them for you and then makes them available here:

http://downloads.openmoko.org/distro/experimental/

==== Blessed revisions ====

Another robot but this one only builds the versions picked by our friendly [[OpenEmbedded]] developers. Download from:

http://downloads.openmoko.org/distro/unstable/

If you understand OpenEmbedded you will get this: Those versions are tied to a specific GIT revision through conf/distro/include/sane-srcrevs.bb.

=== Building the andy-tracking branch ===

Those are the minimum survival commands:

$ git clone git://git.openmoko.org/git/kernel.git linux-2.6
$ cd linux-2.6
$ git-checkout --track -b andy-tracking origin/andy-tracking
$ mkdir GTA02
$ cp ./arch/arm/configs/gta02_moredrivers_defconfig GTA02/.config

Before building this kernel you need install a [http://wiki.openmoko.org/wiki/Toolchain#Downloading_and_installing Toolchain].

$ ./build GTA02

Once the script finishes you will get two files. The first is ''uImage-GTA02.bin'' and a second file with a longer name but same contents, for instance ''uImage-moredrivers-GTA02_andy-tracking_c16287685cb59f91.bin''. Please use the second file if you publish your kernel in some server or if you talk about it in public (specially in bugs reports) because it will allow others to know what kernel you were trying (in case you don't have local changes).

In order to build the modules you can:

$ ./build GTA02 dummy

This will create a file called modules-GTA02_andy-tracking-<git hash>.tar.gz. The contents of this file have to be copied to /lib/firmaware and /lib/modules and one way to do it is untarring the file on the root directory of the device.

If you want to update the local copy of the repository so that you get the latest changes, you can type:

$ git-pull

Before reporting that the new kernel does not build please first check for changes in the configuration file provided by Openmoko.

=== kernel building tips ===

If you are modifying Linux kernel code and building it quite often you really want to be using [http://ccache.samba.org ccache]. It will save you a lot of time.

TODO: submit a patch for the build script that makes ccache use easier. '''Note''': There is a [http://lists.openmoko.org/pipermail/openmoko-kernel/2009-March/009139.html patch being reviewed].

== Contributing ==

The development resources [[Openmoko]] offers are:

* Git repository: http://git.openmoko.org/?p=kernel.git;a=summary
* [http://lists.openmoko.org/mailman/listinfo/openmoko-kernel Mailing list] ([http://lists.openmoko.org/pipermail/openmoko-kernel/ Online Archive])

We appreciate your contributions. Check the Open Issues at the end of this page to check where we need more help.

If in doubt ask in the mailing list.

== FAQ ==

=== Why does Openmoko cares about sending code upstream instead of (insert your task here)? ===

There are two very different approaches and both of them would be doomed if we stuck all our resources to only one of to them.

The first approach is not to care about upstream kernel development efforts and stick to an old kernel while struggling to make it work, ignoring the fact that it is [http://www.kernel.org upstream] where the people who want to help us improve, maintain and support the code running in our devices hang out.

The second is to care way '''too much''' about upstream to the point that we are not willing to ship a temporal dirty hack that make users happy and able to better use their phones. We cannot afford that kind of purity.

As many things in engineering we have to find a point in the middle that works well -- we will try hard to do it.

=== Who's Andy and why is he sticking his name in the kernel? ===

He created the branch and maintained it for a while. It is an usual practice that in kernel development some branches are named after the person who is taking care of them

Check [[Kernel_branches]] if you care about the details.

=== Kernel developers are not polite! They do not even care to say "Hello" when they reply to my emails! ===

The long version is here: [[Kernel-developers-are-not-polite]].

To the point:

All these opensource programmers are nicer in person (if you don't interrupt them while they are programming). On the internet they might appear to be very rude, but in person things are very different specially over lunch or when sharing a beer.

They just tend to write very short text because they have to read and write a lot every day.

== Known issues ==

=== Sysfs paths ===

Unfortunately we had to update many sysfs paths (see [[GTA02_sysfs]]) and since we did it the kernel stopped working properly with some distributions. Unless the distribution is abandoned it will likely catch up with the newest kernel soon.

[[FSO]] developers realized that this problem could be prevented from from happening in the future and they decided to code a nice daemon called [http://www.freesmartphone.org/index.php/Implementations/OpenDeviceDaemon odeviced].

== Open Tickets ==

'''This
[http://docs.openmoko.org/trac/query?status=in_testing&status=reopened&status=assigned&status=new&status=accepted&group=status&milestone=stable-kernel-2009.1 report] will show the bugs that are a priority for us now'''.

'''Please read [https://docs.openmoko.org/trac/query?status=accepted&status=assigned&status=in_testing&status=new&status=reopened&component=System+Software&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component this report]''' if you wish to know what the current issues are.

If you can help us with one of those issues it would be a great way to help us move forward. If in doubt please write to the Openmoko Kernel Mailing List. Let us link some bugs here without overdoing it because trac is better than a normal wiki for this. If we have more than 10 bugs the following lists then we might be doing it wrong.

=== Easy bugs ===

Those are the bugs that active kernel developers believe can be fixed by new kernel programmers that might want to join us. Thus they are leaving them unfixed for some reasonable time while they work on the harder bugs.

TODO: list of bugs linking to trac.

=== Normal bugs ===

Those are the bugs that we have not fixed because they might be hard and/or because we have not found the time to fix them. They might end up being Easy Bugs or Evil bugs. We will use trac for them.

'''This is the complete [https://docs.openmoko.org/trac/query?status=accepted&status=assigned&status=in_testing&status=new&status=reopened&component=System+Software&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component report]''' with all the bugs (some of them might be invalid).

=== Hard bugs ===

Those are the evil bugs that we haven't fixed either because:

# We do not know how to do it in reasonable time
# The hardware vendor does not want to release documentation or to fix firmware (some of them do that unfortunately / even breaking promises they made to Openmoko about making things easier for developers)
# More testing is needed (perhaps a hard-to-reproduce bug)

Here is the list:

* [https://docs.openmoko.org/trac/ticket/2235 #2235 : Monochrome display on resume]

{{Languages|Kernel}}

[[Category:Kernel]]
[[Category:System Developers]]
[[Category:Application Developer]]

Om 2009

2009-04-14T10:37:01Z

Myfanwy: wikify paroli link

'''Om2009''' is the next version of the official Openmoko distribution. It is currently under development and should be released in June 2009 to replace [[Om2008]]. It will be based on [[FSO|freesmartphone.org]] milestone 5.5 framework.

== Flashing ==

The latest images are under [http://downloads.openmoko.org/distro/testing/ testing].

Updating to the latest uboot or qi is also recommended.

===Fullscreen===

Download <b>fso-paroli-image</b> from [http://downloads.openmoko.org/distro/testing/NeoFreerunner/fso-paroli-image-om-gta02.jffs2 fso-paroli-image].<br>
Download <b>uImage.bin</b> from [http://downloads.openmoko.org/distro/testing/NeoFreerunner/uImage-2.6.28-stable+gitr0+f19f259d3c1afde8eae53983fd19f61831927413-r2-om-gta02.bin uImage.bin].<br>
Download <b>qi.udfu</b> from [http://downloads.openmoko.org/distro/testing/NeoFreerunner/qi-s3c2442-1.0.2+gitr3b8513d8b3d9615ebda605de4bda18371aa3f359.udfu qi.udfu].<br>

Detailed instructions for [[Flashing_the_Neo_Freerunner|flashing]].

The image will boot fullscreen into [[Paroli]] and all of the features below will be available<br>

== Development ==

Currently Om2009 is starting it's beta phase. Testing builds will be generated into the [http://downloads.openmoko.org/distro/testing/ testing] disto.<br>

The progress of FSO development is documented regularly in the Status updates at [[OpenmokoFramework]]. For the Om2009 release plan see [http://n2.nabble.com/Om2009-release-plan-tp2410042p2410042.html].

This page will be updated to reflect the status of Om2009<br>

== Features Status ==

Below is the feature list for Om2009. It's broken down into features that have been implemented and need testing, and features that still need to be finished

=== Implemented ===

phone calls incoming and outgoing<br>
sms incoming and outgoing<br>
simple phone book (no images)<br>
call log<br>
charging<br>
suspend and resume<br>
alarm clock<br>
resume speed < 2 seconds - this is close but waiting on a kernel bug<br>
battery indicator - works for gta02 battery<br>
gsm indicator<br>
switch to elementary<br>
scrolling in UI - fixed by migrating from etk to elementary<br>
switching profiles<br>
in-call volume adjustment<br>

=== Not Yet Implemented or Broken ===

boot time < 2 minutes - currently examining ways to speed this up<br>
screen lock<br>
battery indicator - doesn't work for gta01 battery<br>
gprs & edge - works from the command line<br>
user changeable ring tones - works via command line<br>
bluetooth - support in FSO milestone 5.5, needs GUI<br>
wifi - works from the command line, kernels bugs still present<br>
led indication for missed calls or sms<br>
settings tool (feature phone settings as well as advanced functions)<br>

=== Bug List and Known Issues ===

Power button does not shutdown device - quick fix copy /etc/freesmartphone/oevents/paroli_rules.yaml to /etc/freesmartphone/oevents/rules.yaml<br>
otimed sets timezone incorrectly in large countries [http://trac.freesmartphone.org/ticket/389 FSO 389]<br>
Power status events ignored [http://trac.freesmartphone.org/ticket/381 FSO 381]<br>
gsm0710muxd: "Modem does not respond to AT commands" [http://docs.openmoko.org/trac/ticket/2257 OM 2257]
feeds are incorrectly set to unstable<br>

[[Category:Om2009]]

Paroli

2009-04-14T10:14:03Z

Myfanwy: /* Only the package */

In a few words one could say: paroli is a new approach to application development on the Openmoko phones.
Paroli is based on top of the [[OpenmokoFramework|FSO framework]] and enables the use of it via a core and several services.

For more information please visit [http://www.paroli-project.org/ Paroli website]

== Getting the sources ==

git clone http://git.paroli-project.org/paroli.git/

==biggest changes:==
- a launcher was introduced allowing the launching of paroli-applications from within paroli itself.
- the dbus interface is optional and both modes should work.

- closing application windows from within the window-manager does not kill the process anymore

- introduction of a preliminary audio service allowing to mute calls (a test service for non-fso environments was also added).

- a reworked version of the dialer was added

- works on an error-message service have begun

- works on a service checking for changes in the fso have begun and many small fixes in the code

===[paroli] weekly update week 10 of 2009===
here an overview if the highlights of the things the paroli team has been working on in week 9 and the first part of week 10:

-the msgs application is in and being shipped in every build
you can view, send, receive, answer to and forward messages
also it will offer you to save any unknown number to your phonebook

-the people application is in and also being shipped every day
you can view, edit and directly call a contact

- the call logs i.e. the i/o application is also being shipped
you can view your call logs and directly return the call
also it will offer you to save any unknown number to your phonebook

- dtmf in tele

- ussd in tele
you can receive and send simple ussd messages. NOTE: a very ugly window
will open with the message written in very small letters, but it works.
We will have a look into this a bit later.

- small reworks on the lists we use

- gsm and battery icons

- muting ringtone when incoming call

- muting call (mutes microphone)

- Charlie did a complete rework of the service class so that there
should not be any errors due to services not waiting for one another anymore

and lots of other small things that would make this an endless list :)

what will we do next:
we will focus on some details that had been neglected so far such as
- finally getting some scrolling or paging to work in our lists
- getting some secondary actions associated with our list items
- look at how we can go about a settings application as discussed on
this list earlier
- make certain internal adjustments to classes and applications to allow
more flexibility
- getting an image that works out of the box again

===7 days update Feb 13 ~ Feb 20===

- gotten daily build unstable images which by now boot directly into paroli

http://downloads.openmoko.org/distro/unstable/NeoFreerunner/fso-paroli-image-om-gta02.jffs2

http://downloads.openmoko.org/distro/unstable/NeoFreerunner/uImage-2.6.28-oe1+gitr34240a1c06ae36180dee695aa25bbae869b2aa26-r3-om-gta02.bin

They do come with bugs and issues sometimes critical like today when paroli hangs because a resource in the framework is not available at paroli launch. This will be gone tomorrow.

- Fixed lots of bugs and issues such as:
-- unicode in message reading
-- loading messages from the SIM and saving incoming messages in the
phone automatically
-- made all our lists automatically react to changes in items etc
-- gui issues such as the PIN dialog
-- got rid of the green topbar ;)
-- muting ringtone on incoming call
-- muting call in call (also as of tomorrow again)

- moved most of the Milestone two tickets[1] to testing

and

- were feverishly working on the stuff for the next milestone[2]

What are we planning to do next?

- keep on fixing issues in MS2
- continue working towards MS3
- get the kbd to match paroli on the image
- get messaging and contacts up and running as soon as possible to allow
brave testers to use paroli daily ... any volnteers ? ;)

--if anyone is interested in helping out with paroli, contribute code or test or or or ... Let us know! [mailto:mirko@openmoko.com|Mirko]]

==Installation==

on its own image (FSO MS 5 based):

kernel:
[http://downloads.openmoko.org/distro/unstable/NeoFreerunner/uImage-2.6.28-oe1+gitr34240a1c06ae36180dee695aa25bbae869b2aa26-r3-om-gta02.bin kernel]

image:
[http://downloads.openmoko.org/distro/unstable/NeoFreerunner/fso-paroli-image-om-gta02.jffs2 paroli-image]

===Only the package===
In order to get the package from unstable you'll need to adjust the configuration of opkg:

<nowiki>echo src/gz openmoko-unstable-armv4t http://downloads.openmoko.org/repository/unstable/armv4t > /etc/opkg/om-unstable.conf</nowiki>

Then do an opkg-update and opkg install paroli.

This should get you the newest version.

==Downloads==

You can downloads paroli from :
[http://downloads.freesmartphone.org/fso-milestone5/feeds//armv4t/paroli_0.2.1+gitr7a2fdc16174258e9276e7c2d80f500b4dd624442-r0_armv4t.ipk http://downloads.freesmartphone.org/fso-milestone5/feeds//armv4t/paroli_0.2.1+gitr7a2...442-r0_armv4t.ipk]

or from:

http://downloads.openmoko.org/distro/experimental/

[[Category:FSO]]

Applications

2009-04-13T05:50:57Z

Myfanwy: /* Internet */

{{Languages|Applications}}
This is the wiki's master application list for the Openmoko smartphones.

== How to register new applications ?==

This list can not be exhaustive, as new things are showing up every week. This page is here to help spreading awareness about applications. Here are instructions on how to add a specific application to this list. There are many ways to go

Method 1 (preferred):
* Register your application at http://opkg.org. You will get a package number there, for example 33.
* Notify the community mailing list.
* Come back here, click on "edit" next to the appropriate section title, then add a line like:
<pre>* {{opkg.org|33|Application name}} A short description</pre>

Method 2: Just link to wherever the application is hosted.
* Click on "edit" next to the appropriate section title, add a line like:
<pre>* [http://your.host.domain/the/path/to/app/page.html Application name] A short description</pre>

Method 3: Create a new page in this wiki.
* Click on "edit" next to the appropriate section title, then add a line like:
<pre>* [[Application name]] A short description</pre>
* The application name will appear in red, click on it to create and edit the new page.

== Audio ==

* [[Openmoko-mediaplayer2]] - Play music and video (mp3...)
* [[Openmokast]] - Play audio stream and slideshow stream
* [[Pythm]] - Audio player GUI using mplayer and mpd as backend.
* [[Mokoko]]-Play music.
* [[Satan]] - Create your own music!
* [[Fourier]]- Realtime frequency analysis of sound data.
* [[Neoqplayer]] - Renamed as GorshPlayer : a multimedia player written in Qt4 : play and retreive podcasts feeds, more reactive interface, now able to play videos ( in svn ), check the official website for more informations
* {{opkg.org|55|ePiano}} - epiano is going to be a virtual piano
* [http://www.faltantornillos.net/proyectos/gnu/brightPlayer/brightPlayerOM2008v0.1.tar.gz Bright Player] - Fast, lightweight and easy random music player.
* [http://fisoft.eu/standa/openmoko/omshuffle_0.1_arm.ipk omShuffle] - Inspired by Bright Player with volume control. Needs mplayer to work.
* [[GTick]] - GTick is a metronome application written for GNU/Linux
* [[Guitartune]] - Tune musical Instruments.
* [[Voicenote]]-Voicenote is a script which allows to record any sound from the microphone into a wav file. It can play the created files too. It is intended to be an easy and quick way to do so.
* {{opkg.org|151|MokoPod}} - Retrieve and listen to podcasts
----

== Games ==

* [[Games/Om 2007.2]] - Many small games on Om 2007.2
* [[Om 2008.8 Sudoku]] - Number placement based puzzle game
* [[Moko-sudoku]] - Another sudoku puzzle game.
* {{opkg.org|60|ScummVM}} ([[Scummvm|Wiki]]) Virtual Machine for several classic graphical point-and-click adventure games
* [[Kobodeluxe]] - A top-view space shooter, available from 2008.8 repositories.
* [[Pingus]] - Pingus is a lemmings clone with penguins.
* [[Duke Nukem 3D]] - Legendary First Person Shooter.
* [[Numptyphysics]] - A drawing puzzle game.
* [[Gnuboy]] - An emulator for the handheld gaming all-time bestseller.
* [[XBill]] - Little action game to stop Bill from installing Windows(tm) on computers.
* [[Xlogical]]-A puzzle based game where you turn spinners to move balls around.
* [[Liquid War]]-Liquid War is a truly original multiplayer wargame.
* [http://unsyncopated.com/BrainSolvent/Doom%20Port DOOM]- Classic FPS. Freerunner/1973
* [[MBAC]]- MBAC is "Moko Bulls and Cows", a classic game for openmoko written in pygtk similar to mastermind.
* [[OpenVibe]] - The first opensource vibrator.
* [[OpenTTD]] - OpenTransportTycoonDeluxe, ported to openmoko, using only GPLed datafiles.
* [http://scalde.free.fr/index.php?option=com_content&view=article&id=93:pong-pogresses&catid=43:openmoko&Itemid=66 Pong progresses]- This is a little pong game for the openmoko freerunner. The screen is devided in halves, so you can touch the right half to move the paddle right and the left half to move it left.
* [[OpenMooCow]] - OpenMooCow reads information out of your accelerometers. Now, if you turn the phone upside down and back again, it "moos" like one of the little toys.
* [[Freerunner LightSaber]]-Application as iphone LightSaber.
* [[CellHunter]] - A game you earn points by collecting cells (in english now).
* [[XSkat]] - XSkat lets you play the card game Skat defined by the official Skat Order.
* {{opkg.org|136|OpenMiaoCat}} OpenMiaoCat, like OpenMooCow, makes your phone became a cat!
* {{opkg.org|149|I'm Rich}} I'm Rich application
* {{opkg.org|121|Mokomaze}} Ball-in-the-labyrinth game
* [[Acceleroids]] Shoot-the-asteroids game
* {{opkg.org|169|Black Sheep}} Fight insomnia!
----

== GPS ==

* [[GPS Sight]] - Display GPS information, location, tracks, etc, without maps.
* [[Gpsdrive]] - Car (bike, etc) navigation system
* [[Om 2008.8 Locations]] - (aka Splinter) - Location sharing based on GPS and SMS
* [[Navit]] - Car navigation system with routing engine
* [[TangoGPS]] - Display map (OSM..), record GPS tracks...
* [[Pyroute]] - Pyroute is a routing program written in Python. It features mobile phone GUI for maps, GPS, and routing.
* [http://www.mumpot.org/ mumpot] - Display map (OSM), routing, OSM editing, a bit of live editing
* [[QMapControl]] - Display maps (OSM..) and add points, lines...
* [[Qpegps]] - Display map with current position
* [[Idle Hands]] - Give a task to you based on your location
* [[Gtkaddpoi]] - Utility for add a POI to TangoGPS using address or coordinates and export to Navit or to .kml file.
* [[Gpsdcontrol]]-A simple python script for start or stop gpsd daemon with a button on the desktop.
* [[OpenBmap]]-a free and open map of wireless communicating objects (e.g. cellular antenna, Wi-Fi, Bluetooth). It provides tools to mutualize data, create and access this map.
* {{opkg.org|162|gvSIG Mobile}} - This is an unofficial port of gvSIG Mobile (http://www.gvsig.gva.es/) to the Openmoko platform. gvSIG Mobile for Openmoko is currently a GPS-enabled projection-aware map viewer. [http://gvsigmobileonopenmoko.wordpress.com/ Homepage].
* {{opkg.org|175|BikeAtor}} - Like TangoGPS BikeAtor can display OSM Maps. The Speedometer displays the most interesting values of the trip.
* {{opkg.org|178|bicirutas}} - This application looks for mtb routes in www.bicirutas.net (routes in Spain, Portugal, United Kingdom, France, Italy and Germany). It gets the current position from the gps system and downloads nearby routes. Then you can follow them with tangogps application.

== Graphics ==

* [[Orrery]] - Displays the night sky
* [[OMView]] - Image viewer
* [[PyPenNotes]] - Write notes using pen and touchscreen
* [[Gpe-scap]] - Take screenshots
* [[Flash|Gnash]]-Play flash file on Neo
* [[Neon]] - Image viewer

----

== Internet ==

* [[Twinkle]] - Voice over IP
* [[Linphone]] - Voice over IP
* [[Midori]] - Webkit based web browser
* [[Minimo]] - Mozilla based web browser
* [http://www.dillo.org/ Dillo] - Multiplatform fast and small web browser ([http://misc.andi.de1.cc/dillo/ .ipk]).
* [[Mokopedia]] - Read small Wikipedia dumps offline
* [[Offline Wikipedia reader]] - store the entire content of wikipedia (single-language, excluding images), on a single 8GB microSD card
* [[Openmoko-browser2]] - The original Openmoko web browser
* [[Openmokast]] - Play audio stream and slideshow stream
* [[Openmoko Mail]] - E-mail client
* [[Pidgin]] - Instant messaging client (ICQ, MSN, Jabber, Yahoo and more.)
* [[CenterIM]] - Instant messaging client (terminal-based).
* [[PyFeedRead]] - RSS feed reader
* [[Qtmail]] - Default mail program on Om 2008.8
* [[TwitterMoko]] - A Twitter client for Openmoko
* [http://code.google.com/p/pyqt-browser/ pyqt-browser] - modified the sample code from python-pyqt4 and changed it to use webkit for web browsing.
* [http://we.trekbeyond.org/~kd8ikt/moko/shr_pkgz/ ettercap-ng]
* [http://www.netsurf-browser.org/ netsurf]-A new browser for Neo FreeRunner.

== Office ==
* [[Epdfview]] - PDF reader.
* Evince - Document reader for PDF, PS, DJVU and more.
* [[FBReader]] - E-book reader program (TXT, FB2, HTML and more)
* [[Gutenflash]] - Fast text reader by scrolling text
* [[OMoney]] - A bookkeeping application
* {{opkg.org|191|PISI}} - PISI is synchronizing (PIM) information

== Settings ==

* [[Mofi]] - Wifi setup tool
* [[Lint-wifi]] - Wifi setup tool
* [[KnjMokoWifi]] - Wifi setup tool
* [[KnjMokoOPKG]] - A graphical frontend to OPKG.
* [[Om 2008.8 Installer]] - Graphical software installer
* [[Opkg]] - Command line software installer
* [[Sephora]] - Settings manager
* [[SettingsGUI]] - Edit various settings
* [[Wicd]] - Wifi setup tool
* [[ZOMG!]] - A graphical package manager (opkg frontend -> should work on any distro)
* [[Timezone|tzdata]]- Customise your time zone setting.
* [[momtools]] - an application to control Wifi, gprs and some other stuff
* [[Wlan]] - Wlan is an application to manage wireless connection on the Freerunner

== System ==
* [[Aphasia]] - A system built on Erlang and a vertical application for people with apahasia.
* [[Auxlaunch]] - Finger-friendly app launcher and window switcher
* [[Display Locker]] - Screen lock
* [[Gwaterpas]] - levelling tool using accelerometer
* [[Gestures]] - Detect movement and display information, rotate screen
* [[Keychain]] - SSH keys
* [[MokoFEM]] - Monitors GSM information
* [[Mokostat]] - Monitors battery
* [[Openmoko Bluetooth remote controller|ReMoko]] - Control stuff via BlueTooth
* [[Rotate]] - Rotate screen when phone is rotated
* [[Vala-terminal]] - Command prompt with tabs
* [[Ts calibrate]] - Calibrates touchscreen
* [[Zedlock]] - Screen locker
* [http://fso-control.projects.openmoko.org/ fso-control] - Popup Power menu to shutdown/suspend/reboot.
* [[omkeys_functions]] - Remap AUX key bindings
* [[Siglaunchd]] - A daemon that listens to dbus signals and launches appliactions upon arrival.
* [[Pexpect]]-a pure Python module for spawning child applications; controlling them; and responding to expected patterns in their output.

----

== Telephony ==
* [[Dialer/2007.2]] - The dialer application in Om 2007.2
* [[Openmoko SMS Middleware]]- SMS middleware is a Openmoko middleware software for additional features related to SMS. Plugin architecture and Python based code gives this project lots of flexibility and enchancebility.
* [[Paroli]] -Paroli is an integrated phone application based on Tichy (and so also written in python).

----

== Utility ==
* [[Unison]] - Unison is a file-synchronization tool for Unix and Windows. It determines all differences between two directory trees and lets the user decide, how to proceed with every differing file.
* [[HP48 Series RPN Calculator]] - Calculator with many functions
* [[qwo]]- An alternative input method.
* {{opkg.org|57|fido}} - [[fido]] is a todo list\note manager written with elementary
* [http://meuk.spritesserver.nl/lightsaber-0.1.tgz The Lightsaber]. Pre-alpha starwaresque orphanware.
* [[NeoTool]] NeoTool is a bash script for your desktop system to provide a friendly GUI frontend to some common management tasks.
* [[NeoCon]] - neocon is a handy serial console utility (not only) for u-boot. The main feature of neocon is actually that you can give it a list of devices and it will pick one that works.
* [http://techiem2.net/index.php?/archives/10-Freerunner-USB-Mode-Control-Program.html usbmode]-a quick pygtk program.
* [[Enotes]] - Enotes is the implementation of a TODOlist manager written with elementary to appear better with distribution that use illume, like SHR.
* [[LED clock]] - When an Openmoko is sitting unused at night, turn it into an alarm clock with large 7-segment digits on a black background in landscape mode.
* [[MokoGeocaching]] - Utility for add a POI to TangoGPS using geocaching.com
* [[Wrench]] - Modual used utility enlightenment_remote.
* [[Yaouh!]] - Yet Another OSM Updater H.
* [[ShortOm]] - Graphical launcher for shell or application, with editable config file, and log result page.
* [[Pimlico]]-Pimlico is a suite of lightweight Personal Information Management (PIM) applications designed primarily for handheld and mobile devices
* [http://projects.openmoko.org/projects/otp4neo/ OTP4Neo] One time password generator
* [http://projects.openmoko.org/projects/ffalarms/ FFAlarm] is a program to set multiple alarms a day using a finger friendly user interface
* [[OpenWrt]]-basic support for the Openmoko "Freerunner"! Kernel (2.6.28) is building and booting.
* [[Enscribi]]-a handwriting recognition input method for Linux. It's mainly developed for the Openmoko Freerunner smartphone.
* [[GridPad]]-GridPad is an alternative input method for entering text with your finger, a Simple Character Recognizer Software.
* [[sortdesk]] sort your om-desktop in categories
* [[Mokometeo]] is a widget which fetches the weather forecast from yahoo, for a list of cities
* {{opkg.org|176|CoovaChilli}} - It turns your phone's WiFi network into an Ad-Hoc Hotspot!

==Setting Application==
* [[Wmiconfig]]- wmiconfig is a tool written by Atheros Communications Inc to configure the Ar6k WIFI chip used in the Neo Freerunner. This is a standalone C executable, released under GPL v2.
* [[GTA02 sysfs]]- sysfs is a filesystem that is mounted on /sys which contains various fake "files" that are actually filled by a variety of drivers and other kernel subsystems. You can use it to change settings and behaviours of the kernel and drivers dynamically.

== Video ==

* [[Video Player]] - Using Mplayer on Openmoko smartphones.
* [http://katastrophos.net/andre/blog/software/quasar-media-player/ Quasar] - a mplayer frontend for X11.

----

== daemon ==
* [[PyPhonelog]] - daemon uses the framework to track and log all the calls made to and from the moko.
* [[Lscd]] - LSC library/daemon on Linux System.

== An automatic list of application-related wiki pages ==

The pages linked above are all maintained manually. We also maintain an automatic categorization system by tagging wiki pages. Here is the list of application-related pages in this wiki. Normally, every page listed below should be also listed above in the same category. The converse is false: there are applications without a wiki page.

<div style="border: solid 1px black; padding: 1ex"><b>Applications in this Wiki:</b>
<categorytree mode=pages depth=2 hideroot=on>Applications</categorytree>
</div>

== Where to find more applications? ==

At [http://opkg.org opkg.org] !

Not all Openmoko apps are listed on this wiki - there are much more [http://projects.openmoko.org/softwaremap/ projects at the Openmoko GForge] than the wiki can list, not to mention self-hosted applications on their own websites. Actually the phones can run most Linux based Free Software, using for example the [[Debian]] distribution. The [http://handhelds.freshmeat.net/browse/1038/ mobile phones section of Freshmeat] may be a interesting place to look.

Note also that there are many packages in the repository that are not installed by default. If what you want is a classic, chances are that it is already packaged. Suppose you want to install Perl:
opkg list|grep perl
opkg install perl

More application download related pages:

* [[Community Repository]]
* [[Users Repositories]]

<div style="clear:both"> </div>

== Where to find full distributions ? ==

* [[Download]]: for complete system downloads

== The usual warnings ==
<small>
* Some of these software are developed by Openmoko Inc. and some are contributed by the community. Any problems with community contributed software should be reported to the individual software developer rather than the Openmoko core team.
* Most programs listed here are not mature/stable, but only useable/beta.
* Many programs listed here are not yet packaged for your distribution and integrated in its repositories. Whichever it is.
* Installing experimental software from the internet is certain to break things. Running it as root is a very insecure thing to do. Kown that you will be burned, have backups, and be ready to apologize to everybody in your phone contact list in case they receive strange SMSs...
</small>

[[Category:Applications|Applications]]
[[Category:Basic End User]]

Knjrepository

2009-04-13T03:44:40Z

Myfanwy: /* How to use */

== Packages for development ==

The knjRepository includes the following interesting packages:

# '''php526''' - [[PHP]] 5.2.6 CLI support, which enables you to write CLI-scripts for your OpenMoko. It also includes PDO (SQLite3) support.
# '''php526-gtk2''' - [[PHP-GTK]] enables you to write GTK-applications in [[PHP]].
# '''ruby1.8''' - Enables you to use Ruby scripts on your OpenMoko.
# '''libgtk2-ruby1.8''' - Enables Ruby to use Gtk.
# '''libsqlite3-ruby1.8''' - Enables you to use SQLite3-databases in Ruby.
# '''libglade2-ruby1.8''' - Enables you to use Glade with Gtk-applications in Ruby.
# '''ruby1.8-icalendar''' - A Ruby-lib for parsing iCal-files.
# '''ruby1.8-googlecalendar''' - A Ruby-lib for working with a Google Calendar.

(and a lot of other Ruby-extensions like SOAP and WSDL)

A list of all the packages can be found [http://downloads.kaspernj.org/openmoko/repository/ here].

== Application packages ==
*'''[[KnjMokoWifi]]''' - An application for configuring the wireless interface in the OpenMoko-phone. It works with WPA, WEP and no-encryption. It supports profiles, so you dont have to remember passwords for each wireless access point used. It is written in PHP-GTK. Furthermore it can disable the routing-gateway on the USB-networking interface, making the default gateway WiFi. It can also start a DHCP-request to obtain an IP address and so on for the wireless interface.
*'''[[KnjMokoOPKG]]''' - A graphical frontend for [[Opkg]].
*'''[[knjMokoCalendar]]''' - An application for viewing your Google Calendar on your OpenMoko phone written in Ruby. This application is still kind of unstable, since there isn't implemented any error handling. It will also cache events for viewing where there is no network connection
*'''[[knjMokoSettings]]''' - An application which allows a user to carry out various administrative tasks on their phone, such as restarting the X-server, rebooting the phone, turning off/on the Wifi and more, via a graphical interface.
*'''[[knjMokoEmail]]''' - An application for reading email on openmoko phones

== How to use ==

You can configure your phone to use the repository by doing the following:

wget <nowiki>http://downloads.kaspernj.org/openmoko/repository/knjrepository.conf</nowiki> -O /etc/opkg/knjrepository.conf
opkg update

(ignore the signature errors)

Then if you want to install [[PHP-GTK]], you can do this:
opkg install php526 php526-gtk2

Or if you want Ruby with Gtk-support:
opkg install ruby1.8 libgtk2-ruby1.8 libglade2-ruby1.8 libsqlite3-ruby1.8

== Made by ==

The repository has been set up and is maintained by [mailto:k@spernj.org Kasper Johansen].

The [[PHP]]-packages has been packaged by Derick Rethans.

The Ruby-packages has been packaged by Kero van Gelder.
[[Category:Guides]]
[[Category:Applications]]

KnjMokoCalendar

2009-04-09T07:06:26Z

Myfanwy: /* About the application */

{{ApplicationBox|
Name=[[knjMokoCalendar]]|
Description=Google calendar client originally written for Om 2008.12|
Screenshot=No-screenshot.png|
Homepage=http://wordpress.kaspernj.org/?cat=15|
TestedOn=Om 2008.8|
PackageName=knjmokocalendar
}}

== About the application ==

knjMokoCalendar is an application for viewing and editing google calendar appointments

At the moment, it can only be used for viewing data stored in the calendar, but it is planned to allow editing later.

==Setup==
*Run the application, and click on the properties button at the bottom of the screen.
*Type your google calendar logon name and password in to the boxes provided.
*In the third box, you will need to add the private url to your calendar feed - this can be found in the 'settings' section of google calendar. As this is a long url, it may be best to do it either through screen-sharing, or by pasting the address directly into the sqlite address found in /opt/knjmokocalendar/database/knjmokocalendar.sqlite3 , by using 'sqlite database browser' or similar, on your desktop machine

==Suggestions==
knjmokocalendar is under heavy development - please post any suggestions for improvements/bug-fixes here:

Knjrepository

2009-04-09T06:57:39Z

Myfanwy: /* Application packages */

== Packages for development ==

The knjRepository includes the following interesting packages:

# '''php526''' - [[PHP]] 5.2.6 CLI support, which enables you to write CLI-scripts for your OpenMoko. It also includes PDO (SQLite3) support.
# '''php526-gtk2''' - [[PHP-GTK]] enables you to write GTK-applications in [[PHP]].
# '''ruby1.8''' - Enables you to use Ruby scripts on your OpenMoko.
# '''libgtk2-ruby1.8''' - Enables Ruby to use Gtk.
# '''libsqlite3-ruby1.8''' - Enables you to use SQLite3-databases in Ruby.
# '''libglade2-ruby1.8''' - Enables you to use Glade with Gtk-applications in Ruby.
# '''ruby1.8-icalendar''' - A Ruby-lib for parsing iCal-files.
# '''ruby1.8-googlecalendar''' - A Ruby-lib for working with a Google Calendar.

(and a lot of other Ruby-extensions like SOAP and WSDL)

A list of all the packages can be found [http://downloads.kaspernj.org/openmoko/repository/ here].

== Application packages ==
*'''[[KnjMokoWifi]]''' - An application for configuring the wireless interface in the OpenMoko-phone. It works with WPA, WEP and no-encryption. It supports profiles, so you dont have to remember passwords for each wireless access point used. It is written in PHP-GTK. Furthermore it can disable the routing-gateway on the USB-networking interface, making the default gateway WiFi. It can also start a DHCP-request to obtain an IP address and so on for the wireless interface.
*'''[[KnjMokoOPKG]]''' - A graphical frontend for [[Opkg]].
*'''[[knjMokoCalendar]]''' - An application for viewing your Google Calendar on your OpenMoko phone written in Ruby. This application is still kind of unstable, since there isn't implemented any error handling. It will also cache events for viewing where there is no network connection
*'''[[knjMokoSettings]]''' - An application which allows a user to carry out various administrative tasks on their phone, such as restarting the X-server, rebooting the phone, turning off/on the Wifi and more, via a graphical interface.
*'''[[knjMokoEmail]]''' - An application for reading email on openmoko phones

== How to use ==

You can configure your phone to use the repository by doing the following:

wget <nowiki>http://downloads.kaspernj.org/openmoko/repository/knjrepository.conf</nowiki> -O /etc/opkg/knjrepository.conf
opkg update

(ignore the signature errors)

Then if you want to install [[PHP-GTK]], you can do this:
opkg install php526 php526-gtk2

Or if you want Ruby with Gtk-support:
opkg install ruby1.8 libgtk2-ruby1.8 libglade2-ruby1.8 libsqlite3-ruby

== Made by ==

The repository has been set up and is maintained by [mailto:k@spernj.org Kasper Johansen].

The [[PHP]]-packages has been packaged by Derick Rethans.

The Ruby-packages has been packaged by Kero van Gelder.
[[Category:Guides]]
[[Category:Applications]]

USB Networking

2009-04-03T05:52:41Z

Myfanwy: /* Debian, Ubuntu and others */

= Openmoko Networking Setup =

In order to communicate via TCP/IP to your FreeRunner, a basic understanding of the networking expectations is required. Each end of the USB connection forms a LAN (local area network) segment, with the FreeRunner's USB networking device at one end (default 192.168.0.202) and your laptop or desktop at the other end (192.168.0.200 in this guide).

Normally, your desktop machine will know how to reach the Internet, having had its gateway (the IP address of the machine or device which knows how to send packets to machines beyond your subnet) configured via DHCP or statically (probably via a router). For the FreeRunner to reach the Internet, your desktop will have to be configured to route and masquerade (NAT) packets from it.

Normally, none of this is an issue, but problems can arise when the subnet between the FreeRunner and your desktop overlap with the desktop to the router (which forms a second LAN), since your desktop might not know how to route traffic properly.

In other words: if your existing router and desktop have addresses 192.168.0.(something) changing them to e.g. 192.168.1.(something) might save you a lot of troubleshooting later. A discussion of this is [http://lists.openmoko.org/pipermail/support/2008-August/thread.html#1277 here].

== Things to keep in mind ==

* When the FreeRunner suspends it disables its USB networking interface. Therefore it is a good idea to turn off the FreeRunners suspend function when using USB networking. You can do this manually or automatically. [https://wiki.muc.ccc.de/openmoko This] site has two scripts ([https://wiki.muc.ccc.de/openmoko#disable_suspend_if_on_external_power one for Om 2007] and [https://wiki.muc.ccc.de/openmoko#disable_suspend_if_on_external_power1 one for Om 2008]) which disable suspend if the FreeRunner is on external power.

Some scripts do a tail-grep on certain log file. If you have disabled syslog and/or klog, this might be a problem for detecting when the device is connected to your machine via USB.

= Simple Manual Linux Configuration =
Try this first (as root on your desktop, with FreeRunner attached via USB cable and booted properly, not at the Boot Menu). If it works, then you can add permanent configuration or use more sophisticated setups below.
=== The shortest way ===
This simple way has been tested with many Linux distributions (Fedora, SuSE, Red Hat, Debian and others) and network configurations. It was even successfully applied to connect another Linux based handhelds like TDS Nomad and surely can be recommended as the first attempt. The way assumes that you have the recent Linux distribution with USB networking enabled and also rather typical network setup.

With the device connected configure usb0 interface (as root):
<pre>
sudo ip address add 192.168.0.200/24 dev usb0
</pre>
or (deprecated)
<pre>
sudo ifconfig usb0 192.168.0.200 netmask 255.255.255.0
</pre>
If your eth0 interface is also in the same 'range' (e.g. 192.168.0.105) then you can do the following:

1. ping the Neo with
# ping -I usb0 192.168.0.202
2. log in to the Neo (you do not need to be a root on the desktop host just to log in).
# ssh root@192.168.0.202
The default password is blank.

Do not forget to allow ssh (open the port 22) on your firewall so that you can connect to the device. If you suspect any firewall issues, the simplest way is to unplug the main Internet cable leaving only Neo connected and then temporary turn the firewall off.

Also, some old or narrowly configured Linux distributions may not have USB networking support. For such cases the simple way might be just to upgrade.

=== The more advanced way ===
If the previously described simple approach does not work, you may try the more complex one.

<pre>iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24
sysctl -w net.ipv4.ip_forward=1
ip addr add 192.168.0.200/24 dev usb0</pre>

If your Internet connection is also in the range 192.168.0.x then instead you might want to use only:

<pre>ip addr add 192.168.0.200/28 dev usb0</pre>

(This will just map the net from 192.168.0.192 to 192.168.0.207 onto usb0. If you get the error 'Cannot find device "usb0"', double-check that your FreeRunner is turned on and connected by USB. If that doesn't work, try unplugging and replugging the USB cable.)

And in this case you should enable ARP proxy on internet facing interface INSTEAD of using iptables:

<pre>sysctl net.ipv4.conf.eth2.proxy_arp=1</pre>

This assuming that eth2 is connected to ISP.

Then
<pre>ip link set usb0 up</pre>
or (deprecated)
<pre>ifconfig usb0 up</pre>

Then (ideally, not as root):

<pre>ssh root@192.168.0.202</pre>

The default password is blank.

Due to the fact that in most cases your Neo will use the same dns servers as your computer uses, you can automate the process of writing dns servers to your phone:

<pre>#!/bin/sh
/sbin/route add -host 192.168.0.202/32 dev usb0
iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24
iptables -P FORWARD ACCEPT
sysctl -w net.ipv4.ip_forward=1
su `whoami` -c "scp /etc/resolv.conf root@192.168.0.202:/etc/resolv.conf"</pre>

Again if your net already is 192.168.0.0, replace the POSTROUTING statement with
<pre>iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/28</pre>

This simple script will set up routing for your Freerunner and than copy resolv.conf with dns addresses straight to the phone.
All you have to do is connect phone to the computer, run the script and enjoy internet connection from your phone.

=== Changing the Neo IP address ===

Like mentioned above, if the default Neo subnet 192.168.0.X is already used, it might be necessary to change the
Neo [http://en.wikipedia.org/wiki/IP_address IP adress] and subnet.
To achieve this, edit /etc/network/interfaces on the Neo (and reboot it).
In the following example the Neo will use the IP address 192.168.100.1 (instead of the default 192.168.0.202)
within the network 192.168.100.X (instead of 192.168.0.X),
another [http://en.wikipedia.org/wiki/Private_network private] class C network.
(The [http://en.wikipedia.org/wiki/Subnetwork#Binary_subnet_masks netmask] indicates that the first 3 bytes (all bits set) are used to determine the subnet
and the last byte (no bits set) to determine the machine.)
The gateway (the computer, the Neo is attached to) also has to be part of the subnet and is expected to be 192.168.100.254 (instead of 192.168.0.200) here.

Modifications for /etc/network/interfaces:

<pre>
auto usb0
iface usb0 inet static
address 192.168.100.1
netmask 255.255.255.0
network 192.168.100.0
gateway 192.168.100.254
</pre>

(The network entry seems to be redundant information, since it can be derived from address and netmask?)
Note that wiki articles usually expect default settings and you have to adjust the IP adress, gateway, etc entries according to your changes.

= Linux Kernel Support =

Your Linux desktop/laptop needs to have suitable support. In particular you will need to have enabled USB networking and masquerading support in the kernel. For default kernels in many Linux distributions this will already be the case.

== USB Networking support ==

The following options need to be enabled:

* CONFIG_USB_USBNET (''Multi-purpose USB Networking Framework''. Module will be called <tt>usbnet</tt>)
* CONFIG_USB_NET_CDCETHER (''CDC Ethernet support''. Module will be called <tt>cdc_ether</tt>)

These options are available in ''Device Drivers -> USB support -> USB Network Adapters'' or ''Device Drivers -> Network Device Support -> USB Network Adapters.

In order for USB networking to work you need to load the <tt>cdc_ether</tt> module (when loading <tt>cdc_ether</tt> the module <tt>usbnet</tt> will be loaded automatically). For more info see the [http://www.linux-usb.org/usbnet/ usbnet driver homepage].

== Masquerading support ==

Masquerading options are found in ''Networking ---> Networking options --->'' (tested on Linux 2.6.26.3).

To enable the needed options you first have to enable:

* CONFIG_NETFILTER (''Network packet filtering framework (Netfilter)'')

Then, from

''Networking --->
Networking options --->
[*] Network packet filtering framework (Netfilter) --->
Core Netfilter Configuration --->''

You need at least following options enabled as modules:

* CONFIG_NF_CONNTRACK (''Netfilter connection tracking support'')
* CONFIG_NF_CONNTRACK_FTP (''FTP protocol support'')
* CONFIG_NETFILTER_XTABLES (''Netfilter Xtables support'')

Rest of the needed options are found from

''Networking --->
Networking options --->
[*] Network packet filtering framework (Netfilter) --->
IP: Netfilter Configuration --->''

You need to enable (again, as modules is fine):

* CONFIG_NF_CONNTRACK_IPV4 (''IPv4 connection tracking support (required for NAT)'')
* CONFIG_IP_NF_IPTABLES (''IP tables support (required for filtering/masq/NAT)'')
* CONFIG_NF_NAT (''Full NAT'')
* CONFIG_IP_NF_TARGET_MASQUERADE (''MASQUERADE target support'')

= Firewall Issues =

On some systems, you may have firewall rules which prevent this working - such as added by the iptables service on Fedora. You may care to stop these, and/or review any rules or policies you think might cause issues.

The most relevant table is the nat table, which controls translation of addresses:

iptables -L -t nat -v -n

Unless you have a special setup, you'll want to see only the MASQUERADE rule that you apply below, and ACCEPT as the default policy. Also look at the filter table:

iptables -L -t filter -v -n

If this contains anything in the FORWARD chain, then this may prevent passing packets. It can be flushed with:

iptables -t filter -F FORWARD

= DNS =

In addition to routing issues, to be practical, DNS will need to work. In some cases, you might already be running a DNS server on your desktop such as dnsmasq or bind9, which is the default assumption the FreeRunner makes. In other cases, you'll need to configure DNS to that of your router, or a DNS server further out on the internet such as that provided by your ISP.

== Configure Default Neo DNS ==

DNS is configured in /etc/resolv.conf on your FreeRunner.

You should add the IP address of the DNS servers as provided by your ISP. Check your router's or PC's network status for the nameserver IP addresses.

<pre>echo nameserver xxx.xxx.xxx.xxx > /etc/resolv.conf</pre>

You can also add the public DNS server called openDNS:
<pre>echo nameserver 208.67.222.222 > /etc/resolv.conf
echo nameserver 208.67.220.220 >> /etc/resolv.conf</pre>

These settings will be lost on reboot. You can set the DNS for the next connect, by adding the following to the end of the usb0 setting in /etc/network/interfaces, right above the bluetooth networking section:
<pre>up echo nameserver 208.67.222.222 > /etc/resolv.conf
up echo nameserver 208.67.220.220 >> /etc/resolv.conf</pre>

== Proxying DNS from Desktop/Laptop ==

If you move about, making assumptions about the network may not be convenient, and it is possible to proxy DNS requests via your host laptop (which you are also taking with you), without running or installing a DNS server. There are a number of ways to do this:

=== Proxying with dnrd ===

The script is designed to use [http://dnrd.sourceforge.net/ dnrd] as the DNS proxy. The [http://buildhost.automated.it/gta01 script] and a copy of [http://buildhost.automated.it/dnrd-2.20.3.tar.gz dnrd] are available. The script also performs the initial setup of the connection as per the [[USB_Networking#Manual_method]] above.

=== Proxying with a UDP forwarder ===

Another easy setup is using a UDP forwarder like the one from http://www.tapor.com/udpf/ - use it with the command"

<pre>udpf-elf -p=53-f=`awk '$1 == "nameserver"{print $2; exit(0);}' /etc/resolv.conf`:53</pre>

=== Proxying with iptables ===

It is possible to forward DNS requests with iptables using the DNAT target:

<pre>iptables -t nat -A PREROUTING -p tcp -s 192.168.0.202 -d 192.168.0.200 --dport domain -j DNAT --to-destination 192.168.0.1
iptables -t nat -A PREROUTING -p udp -s 192.168.0.202 -d 192.168.0.200 --dport domain -j DNAT --to-destination 192.168.0.1</pre>

Where <tt>192.168.0.1</tt> is the IP of your router.

Test if it works:
<pre>ping www.google.com</pre>

If so, then this is sufficient for most internet access. But manual changes to resolv.conf are usually lost later if for example one uses DHCP, especially for WiFi, and so may not be convenient to configure manually.

= Testing Your Connection =
You should be able to connect to your Neo! Make sure you can ping your Neo to be sure.
ping 192.168.0.202

Then log into your Neo using ssh:
ssh root@192.168.0.202
The default password is blank (press enter).

You can also [[scp]] files back and forth. You can telnet, SSH, SMB or do whatever you want if you install software that enables you to set up TCP/IP network over your USB connection.

Now, make sure you can ping back to your desktop
ping 192.168.0.200
(Note that some systems like Vista, don't respond to ICMP ping by default)

Try pinging the outside world (a Google IP address)
ping 74.125.19.147
This demonstrates that masquerading is working - your desktop is sending/receiving packets to the wider internet.

Lastly, verify that DNS is correctly configured between the Neo & Network:
ping www.google.com

= OS or Distro Specific & Automatic Configuration =

Based on [http://blog.haerwu.biz/2007/03/22/hotpluging-usbnet/ Hotplugging usbnet] by Marcin 'Hrw' Juszkiewicz.
These instructions should keep you from having to run the Simple Manual Linux Configuration every time you plug in and want to connect to an Openmoko device. One run and then you're done!

If the Simple Manual Linux Configuration does not work for your OS or Distro (MacOS X, MS Windows, etc) there may be instructions here that work for you.

== MacOS X ==
See [[MacOS_X#USB_Networking|MacOS X USB Networking]].

== Windows ==
See [[Neo1973_and_Windows#USB_Ethernet_emulation|Windows USB Ethernet emulation for Neo1973]].

There is also a very helpful tutorial for connecting with Vista at [http://sam.curren.ws/index.cfm/2008/7/14/Using-the-Neo-FreeRunner-with-Windows-XPVista].

== FreeBSD ==
You need to load the cdce kernel module (if it is not already linked into your kernel). As root do:

# kldload cdce

The Neo should then show up as cdce0 interface and you can handle the cdce0 interface just like the usb0 device under Linux. For more information see the cdce manpage. An easy way to assign the IP address to the cdce0 interface is using the devd(8) daemon. Create the following two files,

<tt>/usr/local/etc/devd/cdce.conf</tt> as:

<pre>
notify 1 {
match "system" "IFNET";
match "subsystem" "cdce0";
match "type" "ATTACH";
action "/usr/local/etc/devd/cdce.sh $subsystem $type";
};
</pre>

and <tt>/usr/local/etc/devd/cdce.sh</tt> as:

<pre>
#!/bin/sh
case $2 in
'ATTACH')
ifconfig cdce0 192.168.0.200 netmask 255.255.255.0
exit 0 ;
;;
esac
exit 0
</pre>

Then restart the devd(8) daemon with:

# /etc/rc.d/devd restart

If you now plugin the FreeRunner into the USB port the cdce0 interface gets created and the IP addr will be assigned.

== Debian, Ubuntu and others ==

Edit /etc/network/interfaces and add:

<pre>
# freerunner
allow-hotplug usb0
iface usb0 inet static
address 192.168.0.200
netmask 255.255.255.0
up iptables -A POSTROUTING -t nat -s 192.168.0.0/24 -j MASQUERADE
up echo 1 > /proc/sys/net/ipv4/ip_forward
down iptables -D POSTROUTING -t nat -s 192.168.0.0/24 -j MASQUERADE
</pre>

This is more sophisticated than the manual setup. The 'auto usb' stanza ties into the Linux hotplug system so that when the device appears and vanishes, as happens when the FreeRunner is connected via USB, this is run.

In addition, the desktop-side netmask is limited to a much smaller range, so that overlapping subnets are less of a problem - Linux will use more specific routes first when deciding where to send packets.

Another possible configuration that adds DNS forward and removes
the iptables changes after unplugging:

in /etc/network/interfaces add
<pre>
# freerunner
allow-hotplug usb0
iface usb0 inet static
address 192.168.0.200
netmask 255.255.255.192
post-up /etc/network/freerunner start
pre-down /etc/network/freerunner stop
</pre>

create file /etc/network/freerunner
<pre>
#!/bin/sh
#
# configures the freerunner for internet
#
#

DEVICE=usb0
IPADDR=192.168.0.200
REMOTE_IPADDR=192.168.0.202
NETMASK=255.255.255.0

# get first ip for dns
DNSIP=$(awk '$1 == "nameserver"{print $2; exit(0);}' /etc/resolv.conf)

case "$1" in
start)
iptables -A POSTROUTING -t nat -j MASQUERADE -s $REMOTE_IPADDR
iptables -A PREROUTING -t nat -p tcp -s $REMOTE_IPADDR -d $IPADDR --dport domain -j DNAT --to-destination $DNSIP
iptables -A PREROUTING -t nat -p udp -s $REMOTE_IPADDR -d $IPADDR --dport domain -j DNAT --to-destination $DNSIP

if [ "$(cat /proc/sys/net/ipv4/ip_forward)" = "0" ]; then
echo "temoprarely allow ip_forward for openmoko" > /var/run/openmoko.ip_forward
echo 1 > /proc/sys/net/ipv4/ip_forward
fi
;;
stop)
iptables -D POSTROUTING -t nat -j MASQUERADE -s $REMOTE_IPADDR
iptables -D PREROUTING -t nat -p tcp -s $REMOTE_IPADDR -d $IPADDR --dport domain -j DNAT --to-destination $DNSIP
iptables -D PREROUTING -t nat -p udp -s $REMOTE_IPADDR -d $IPADDR --dport domain -j DNAT --to-destination $DNSIP

if [ -f /var/run/openmoko.ip_forward ]; then
rm /var/run/openmoko.ip_forward
echo 0 > /proc/sys/net/ipv4/ip_forward
fi
;;
esac
</pre>

Make /etc/network/freerunner executable with
chmod +x /etc/network/freerunner

It is possible to use network-manager to automatically connect to the Freerunner using udev. The process uses udev to run a script when the Freerunner is plugged in. The script uses the ip command to set the mac address of the usb network interface. To begin, create /etc/udev/rules.d/80-freerunner.rules :

<pre>
# This file causes programs to be run on device insertion.
# See udev(7) for syntax.
# rule to assign a fixed mac address specified in /
KERNEL=="usb[0-9]*", DRIVERS=="cdc_ether", ACTION=="add", RUN+="/usr/local/sbin/freerunner-usb-add.sh %k"
</pre>

Next, create the /usr/local/sbin/freerunner-usb-add.sh :

<pre>
#!/bin/sh
(
busNum=$( printf %.2d $( expr match "$1" "usb$[0-9]*$") )
ip link set "$1" address 00:00:22:55:bb:$busNum &> /dev/null
) &
exit 0
</pre>

Finally run "chmod +x /usr/local/sbin/freerunner-usb-add.sh" to make it executable. Now you can use network-manager with mac-address specific settings and get it to automatically connect.

=== Ubuntu 8.10 - Easy Way ===

1. Connect Neo to PC and wait about a minute when NetworkManager stops scanning usb for dhcp (wait when icon in the tray switches to normal).

2. Open "nm-connection-editor", select "Auto usb0", click "Edit", then "IPv4 Settings". Set "Method" - "Manual", click "Add". In the "Address" field write "192.168.0.200", "Netmask" - "255.255.255.0", leave "Gateway" field empty. Click "OK", then "Close".

3. Now you can connect via ssh to 192.168.0.202

Then, based on [http://sebastian-bergmann.de/index.php?url=archives/801-OpenMoko-Freerunner-and-Ubuntu.html#feedback these instructions], you should be able to setup masquerading by running the following commands on your Ubuntu PC:

<pre>sudo iptables -I INPUT 1 -s 192.168.0.202 -j ACCEPT
sudo iptables -I OUTPUT 1 -s 192.168.0.200 -j ACCEPT
sudo iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24
sudo bash -c 'echo 1 > /proc/sys/net/ipv4/ip_forward'</pre>

=== Ubuntu Issues ===

Ubuntu 8.10 doesn't work as expected if you used /etc/network/interfaces to automate the connection.<br>
Network manager likes to latch onto the network device and add a default route through 192.168.0.202, breaking your network connection.
Network manager also says you can't edit or remove this connection from its list. I'm going back to making the connection manually.<br>
Using the /usr/local/sbin/freerunner-usb-add.sh script for some automatism can be a workaround:
<pre>
#!/bin/sh
(
ip address add 192.168.0.200/26 netmask dev usb0 > /dev/null
ip link set usb0 up > /dev/null
/etc/network/freerunner start
) &
exit 0
</pre>

Ubuntu Feisty, Gutsy and Hardy reportedly have a bug where ifdown is not run when the interface is unplugged, meaning this only works once after the system is booted. This is mentioned at https://bugs.launchpad.net/ubuntu/+source/ifupdown/+bug/130437

One can patch /etc/udev/rules.d/85-ifupdown.rules. Moving the DRIVERS=="*?" out of the top GOTO, to ACTION=="add" line fixes the problem.

<pre>
SUBSYSTEM=="net", GOTO="net_start"
GOTO="net_end"

LABEL="net_start"

# Bring devices up and down only if they're marked auto.
# Use start-stop-daemon so we don't wait on dhcp
ACTION=="add", DRIVERS=="?*", RUN+="/sbin/start-stop-daemon --start --background --pidfile /var/run/network/bogus --startas /sbin/ifup -- --allow auto $env{INTERFACE}"
ck
ACTION=="remove", RUN+="/sbin/start-stop-daemon --start --background --pidfile /var/run/network/bogus --startas /sbin/ifdown -- --allow auto $env{INTERFACE}"

LABEL="net_end"
</pre>

The bug is that the DRIVERS variable isn't set at all when the device is unplugged.

This appears to be fixed in Ubuntu 8.04 [[User:Mattt|Mattt]] 11:38, 30 July 2008 (UTC)
:Actually it appears that it's not fixed, but patching that file and disconnecting and reconnecting the phone works perfectly. --[[User:Johndoesacc|Johndoesacc]] 18:37, 20 August 2008 (UTC)
:Well, yes, it must be fixed because it worked for me out-of-the-box without tweaking the udev rule on 8.04 --[[User:EtienneG|EtienneG]] November 26th, 2008
:It wasn't solved in my case, as of 3. February 2009 in 8.04 (AMD64), the patch above solved my problem thou. --[[User:VilleWitt|VilleWitt]] February 3td, 2009.

Iptables Configuration with GUI:

Firestarter can be used to allow the freerunner to connect to the internet without manually running iptables commands. Firestarter is in the ubuntu repositories and can be installed with a
<pre>sudo aptitude install firestarter</pre>
Once installed, the firestarter preferences dialog has a network section, under which a drop-down box appeasr which is labeled "Local network connected device." Select the freerunner, generally "Unknown device(usb0)" and check the "Enable internet connection sharing" box. Uncheck local network DHCP and the freerunner should be able to access the internet.
-Tested in ubuntu 8.10--[[User:makito|Makito]] February 26, 2009

=== Ubuntu Workaround ===
Use [http://wicd.sourceforge.net/ wicd] instead of networkmanager:
It is much further in development than networkmanager yet and doesn't make any problems with USB networking. You can use the "normal" settings in /network/interfaces.
;Note: Because of it's dependencies it deinstalls networkmanager.

== Mandriva ==

This first file configures the network system for the usb0 interface. Any time you plug in the FreeRunner the interface will be configured.

<tt>/etc/sysconfig/network-scripts/ifcfg-usb0</tt>:

<pre>
DEVICE=usb0
BOOTPROTO=static
IPADDR=192.168.0.200
NETMASK=255.255.255.0
NETWORK=192.168.0.0
BROADCAST=192.168.0.255
ONBOOT=yes
METRIC=10
MII_NOT_SUPPORTED=no
USERCTL=yes
</pre>

This next file configures the static routes that we need to communicate to the subnet. Since it has "usb0" in the name, the system will automatically apply these static routes any time that the usb0 interface is configured. (i.e. when you connect the FreeRunner)

<tt>/etc/sysconfig/network-scripts/usb0-routes</tt>:

<pre>
ADDRESS0=192.168.0.200
NETMASK0=255.255.255.0
</pre>

Now we need to restart the network system to pick up the changes.

service network restart

This didn't work for me (Mandriva 2008.1), giving errors from Shorewall. However, simply using MCC, Network->Sharing Internet Access worked fine. You need to connect Neo when starting it. --[[User:Alih|Alih]] 18:50, 22 September 2008 (UTC)

== SuSE ==

/etc/sysconfig/network/ifcfg-usb0:

# USB configuration for PDAs (openmoko)
IPADDR=192.168.0.200
NETMASK=255.255.255.0
STARTMODE=onboot

For more information on getting USB networking up using YaST, see [[USB Networking with openSUSE]].

== Fedora ==

=== Option A - Tested with FC9, FC8 & FC5 ===

edit file <tt>/etc/sysconfig/network-scripts/ifcfg-usb0</tt> to look like this:

# USB configuration for PDAs (openmoko)
# from <nowiki>http://www.handhelds.org/moin/moin.cgi/UsbNet</nowiki>
DEVICE=usb0
BOOTPROTO=none
IPADDR=192.168.0.200
NETMASK=255.255.255.0
ONBOOT=yes

and restart networking service by typing:

service network restart

if your '''openmoko''' is connected when you restart network you should see system message:

<code>Bringing up interface usb0 [OK]</code>

=== Option B ===

This setup is probably over-complex:

/etc/sysconfig/network-scripts/ifcfg-usb0:

DEVICE=usb0
IPADDR=192.168.0.200
NETMASK=255.255.255.0

/etc/sysconfig/network-scripts/ifup-usb:

#!/bin/bash
./etc/init.d/functions
cd /etc/sysconfig/network-scripts
../network-functions
[ -f ../network ] && . ../network
CONFIG=${1}
need_config ${CONFIG}
source_config
NETBITS=`ipcalc -p ${IPADDR} ${NETMASK} | awk -F'=' '{print $2;}'`
/sbin/ip addr flush dev ${DEVICE} 2>/dev/null
/sbin/ip link set dev ${DEVICE} up
/sbin/ip addr add dev ${DEVICE} ${IPADDR}/${NETBITS}
/sbin/iptables -I POSTROUTING -t nat -j MASQUERADE -s ${IPADDR}/${NETBITS}
/sbin/sysctl net.ipv4.ip_forward=1
/sbin/iptables -I FORWARD -s ${IPADDR}/${NETBITS} -j ACCEPT
/sbin/iptables -I FORWARD -d ${IPADDR}/${NETBITS} -j ACCEPT

Set /etc/sysconfig/network-scripts/ifdown-usb:

#!/bin/bash
./etc/init.d/functions
cd /etc/sysconfig/network-scripts
../network-functions
[ -f ../network ] && . ../network
CONFIG=${1}
need_config ${CONFIG}
source_config
NETBITS=`ipcalc -p ${IPADDR} ${NETMASK} | awk -F'=' '{print $2;}'`
/sbin/iptables -D FORWARD -d ${IPADDR}/${NETBITS} -j ACCEPT
/sbin/iptables -D FORWARD -s ${IPADDR}/${NETBITS} -j ACCEPT
/sbin/sysctl net.ipv4.ip_forward=0
/sbin/iptables -D POSTROUTING -t nat -j MASQUERADE -s ${IPADDR}/${NETBITS}
/sbin/ip link set dev ${DEVICE} down
/sbin/ip addr flush dev ${DEVICE} 2>/dev/null

If you are using NetworkManager, restart it and enable the usb device from its menu, otherwise it will disable your connection shortly after you enable it.

/sbin/service NetworkManager restart

=== Option C - tested on FC8, FC9 and F10 ===

Plug in the usb cable. NetworkManager should detect the phone automatically but you should ignore it.
Open Network Configuration tool (System -> Administration -> Network) and perform following steps:
# Click '''New''' button on top bar
# Click '''Forward'''
# Select OpenMoko from device list
# Click '''Forward'''
# Select 'Statically set IP address:' and enter address: 192.168.0.200, netmask 255.255.255.0 (or use 255.255.255.240 if you want only route ip range 192.168.0.192-192.168.0.207). Leave gateway empty.
# Click '''Forward'''
# Click '''Apply''' to close add dialog
# Select newly added usb0 device from the device list.
# Click '''Edit''' button on top bar
# You might want to remove a tick from 'Activate device when computer starts' check box.
# Click '''Ok''' to close window dialog.
Save settings and close the window.

Open Firewall Configuration (System -> Administration -> Firewall) and enable masquerading:
# Select '''Masquerading''' from left panel
# Check device(s) which you'd like to share internet connection. Typically eth0 or wlan0.
# Click '''Apply''' and close application

Open terminal and perform (as root user):
# ifdown usb0
# ifup usb0
The first command will remove any existing settings given by the NetworkManager and second command brings the device up with appropriate settings.

Now you should be able to ping e.g. 74.125.39.99 [www.google.com] from OpenMoko. Configure /etc/resolv.conf and you should have full a internet access.

==== Troubleshooting ====
If Network Configuration tool cannot see the the usb0 try to unplug the usb cable for a few seconds and wait until the NetworkManager finds it again.

NetworkManager will assign a new ip address for the OpenMoko if link goes down for a while. You can fix this by issuing '''ifup usb0''' again.

== Red Hat or Similar (tested with Workstation 5) ==

Edit /etc/sysconfig/network-scripts/net.hotplug:

After this command:

<pre>
case $INTERFACE in
# interfaces that are registered after being "up" (?)
</pre>

add

<pre>
usb0)
ifconfig usb0 192.168.0.200 netmask 255.255.255.0
route add 192.168.0.202 usb0
iptables -I INPUT 1 -s 192.168.0.202 -j ACCEPT
iptables -I OUTPUT 1 -s 192.168.0.200 -j ACCEPT
iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24
echo 1 > /proc/sys/net/ipv4/ip_forward
exit 0
;;
</pre>

== Gentoo ==

Open /etc/conf.d/net and add:

<pre>
# Neo
config_usb0=( "192.168.0.200 netmask 255.255.255.0" )
routes_usb0=( "192.168.0.202/32 via 192.168.0.200" )
</pre>

Create a new init script:

<pre>
cd /etc/init.d
ln -s net.lo net.usb0
</pre>

=== Manual Configuration ===

Put iptables into use:

<pre>
iptables -I INPUT 1 -s 192.168.0.202 -j ACCEPT
iptables -I OUTPUT 1 -s 192.168.0.200 -j ACCEPT
iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24
</pre>

Store them:

/etc/init.d/iptables save

If you want the routing by default:

rc-update add iptables default

You must also inform the kernel, to start forwarding.

echo 1 > /proc/sys/net/ipv4/ip_forward

=== Automatic Configuration ===
One way to automate all this is to create /etc/conf.d/net.usb0 as follows. It sets IP forwarding and the iptables rules all in one go. It removes the iptables rules and disables ip forwarding when the FreeRunner is unplugged.
Therefore the net.usb0 service must be hotpluggable (/etc/rc.conf).

<pre>
preup() {
echo 1 > /proc/sys/net/ipv4/ip_forward
iptables -I INPUT 1 -s 192.168.0.202 -j ACCEPT
iptables -I OUTPUT 1 -s 192.168.0.200 -j ACCEPT
iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24
return 0
}

postdown() {
echo 0 > /proc/sys/net/ipv4/ip_forward
iptables -D INPUT -s 192.168.0.202 -j ACCEPT
iptables -D OUTPUT -s 192.168.0.200 -j ACCEPT
iptables -D POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24
return 0
}
</pre>

== Slackware (tested with 12.1) ==

Following is based on [http://www.enricozini.org/2008/tips/autodock-freerunner.html Enrico Zini's solution].

Create a new udev rules file <tt>/etc/udev/rules.d/91-openmoko.rules</tt>:

<pre>
SUBSYSTEM=="net", ACTION=="add", ATTRS{idVendor}=="1457", ATTRS{idProduct}=="5122", RUN+="/sbin/om-usb $env{INTERFACE} start"
SUBSYSTEM=="net", ACTION=="remove", ENV{INTERFACE}=="usb[0-9]", RUN+="/sbin/om-usb $env{INTERFACE} stop"
</pre>

Then create the script <tt>/sbin/om-usb</tt>:

<pre>
#!/bin/sh
INTERFACE=$1
ACTION=$2

# udev fails silently when the script fails, e.g. due to commands not
# being found
PATH=/usr/sbin:/sbin:/usr/bin:/bin

case $ACTION in
'start')
# Put all your setup here
;;
'stop')
# Put all your tear down here
;;
*)
echo "Usage: $0 {start|stop}"
exit 1
;;
esac
</pre>

The <tt>INTERFACE</tt> will be <tt>usb0</tt> in most cases.

== Archlinux ==
Following is based on [http://xenos.altervista.org/blogs/index.php?blog=3&title=openmoko-usb-networking-su-archlinux furester's solution].

Install package [http://aur.archlinux.org/packages.php?ID=20220 openmoko-usb-networking] from AUR:

$ yaourt -S openmoko-usb-networking

= SSH Extras =

Reportedly, the ssh daemon (dropbear 0.49) on the FreeRunner appears to have a bug when sending the exit status back to the client. From time to time you receive an exit status of 255.

To avoid ssh adding a new line for every ssh host-key to your known_hosts you can add the following to the phone section in ~/.ssh/config (or see the snippet at : [[USB Networking#Changing_host_keys]] bellow)

UserKnownHostsFile /dev/null

You might want to use keys to bypass the login prompt too.

== SSH Keys ==

== From desktop to FreeRunner ==

To generate ssh keys for use as a login mechanism type:

user@host$ ssh-keygen -t rsa

When prompted for a password either hit enter for no password (''not really a good idea'') or enter a password for this key. ssh into the phone and create ~/.ssh:

root@phone# mkdir ~/.ssh

Then from your desktop copy the '''.pub''' file to the phone.

user@host$ scp ~/.ssh/id_rsa.pub root@phone:~/.ssh/authorized_keys

You should now be able to ssh directly into the phone without a password prompt using a command like 'ssh root@phone' from the account user@host because the public key in the file user@host:~/.ssh/id_rsa.pub is contained in the list of keys which have access in the file root@phone:~/.ssh/authorized_keys (since scp is used, only one key exists, but you can grant access to the phone from more than one account, for example user@host, user@laptop).

To make ssh login as root by default, add the following lines to ~/.ssh/config:

Host phone
User root

Replace ''phone'' with the hostname or ip of your phone. You should now be able to ssh into the phone without having to type ''root@'' every time.

To disable password logins ('''after setting up key access''') edit /etc/init.d/dropbear and change the following line:

DROPBEAR_EXTRA_ARGS=

to

DROPBEAR_EXTRA_ARGS="-s"

You will need to restart dropbear for this to take effect.

=== From FreeRunner to Desktop ===

Generate the key:

dropbearkey -t rsa -f id_rsa

The output will look something like this:

Will output 1024 bit rsa secret key to 'id_rsa'
Generating key, this may take a while...
Public key portion is:
ssh-rsa AAAAB3Nza[...]
Fingerprint: md5 ca:e8:f0:b7:f6:7b:c2:b6:b9:71:e4:45:86:a9:ff:b8

Copy and paste the one line (in this example, starting with 'ssh-rsa' onto the end of the host's authorized_keys file (often in ~/.ssh/).

From the phone, ssh with -i:

ssh -i id_rsa user@host

=== Changing host keys ===

If you reflash, your hosts keys will change. Try this ~/.ssh/config snippet:

Host moko
HostName 192.168.0.202
StrictHostKeyChecking no
UserKnownHostsFile /dev/null
User root

This is suggested because ssh on your desktop may complain if the key matching a certain IP changes (stored in .ssh/known_hosts). Now you have set this, you can issue the following command to connect to your moko :

ssh root@moko

== GUI on desktop through SSH ==

To get the GUI on the FreeRunner onto the desktop via USB, you can use ssh as follows (execute on desktop):

xhost +
ssh -l root -X -v 192.168.0.202

Using this, run openmoko-finger-demo for example, and it will open up on the desktop. To get landscape view, just resize the GUI window on the desktop.

If you get an error like this:

<tt>
dbus.exceptions.DBusException: org.freedesktop.DBus.Error.Spawn.ExecFailed: dbus-launch failed to
autolaunch D-Bus session: Autolaunch requested, but X11 support not compiled in.
</tt>

you need to set the DBUS_SESSION_BUS_ADDRESS environment variable to the value on the FreeRunner before launching the process from your desktop. You can find the value of this variable by using a command such as

ps auxwwwwe | grep -m 1 DBUS_SESSION_BUS_ADDRESS

Note that you must run that command on the FreeRunner. Back on your desktop, run the process you want with the ''env'' command like this:

env DBUS_SESSION_BUS_ADDRESS=''dbus_address'' ''process'' #(isn't the "env" redundant here?)

==Display Remote Applications on FreeRunner==

To get desktop apps to show up on your FreeRunner, first log in:

ssh -l root 192.168.0.202

Then run:

DISPLAY=:0 xhost +192.168.0.200

After this you can close the ssh session. Back on the desktop computer, run:

DISPLAY=openmoko:0 xclock

Note that the xhost command will allow remote applications on 192.168.0.200 to access the X server. It will allow anyone on the desktop machine to access the X server of the neo, including snooping anything you type on it. To disallow remote applications again, run this in the neo:

DISPLAY=:0 xhost -192.168.0.200

== sftp ==
After you get the SSH connection working, it is possible to use Konqueror, Nautilus or another sftp - enabled tool to browse the phone filesystem and deploy the test applications. Just enter sftp://root@192.168.0.202 into address bar.

== sshfs ==
You can use sshfs to mount the phones filesystem into the hosts filesystem. Make sure that fuse-sshfs is installed and that you are allowed to use fuse. Now run:

sshfs 192.168.0.202:REMOTE_PATH LOCAL_MOUNT_POINT

REMOTE_PATH can now be accessed through LOCAL_PATH.

==Automated setup network and mounting partitions==

See [https://bugs.launchpad.net/ubuntu/+bug/289548 Ubuntu bug report in launchpad].

<span id="bottom"></span>
{{Languages|USB Networking}}

[[Category:USB]]
[[Category:Implemented]]
[[Category:Networking]]

Kustomizer

2009-03-25T05:33:17Z

Myfanwy:

{{Languages|Kustomizer}}

''If you want to use Freerunner with OM2008.12 as a usable phone and music player and internet device and gps device then there's so many things you have to install and configure before it's usable. It took me a lot of time to get everything installed and configured (and there's still some things to do). But now there's the Kustomizer, maybe this can make life a little easier.'' [http://lists.openmoko.org/pipermail/community/2009-February/041648.html M.K@community]

* '''2009-03-15''' [http://kurppa.fi/freerunner/kustomizer_0.4 Kustomizer 0.4] released check [[Kustomizer#Changelog|Changelog]]
* '''2009-03-11''' Mailing list launched. To subscribe send a mail to [mailto:kustomizer+subscribe@googlegroups.com]
* '''2009-02-20''' [http://www.kurppa.fi/freerunner/kustomizer_0.35 0.35 released] "I tried your version 0.35 and that is a lot better than 0.3" ([http://risto.kurppa.fi/blog/kustomizer-03-for-openmoko-200812/comment-page-1/#comment-407 Lars])
* '''2009-02-20''' [http://www.kurppa.fi/freerunner/kustomizer_0.35 0.35 pre-release] - give it a try, more packages should now install, the bug was finally found.. Let me know if it works for you!
* '''2009-02-19''' [http://risto.kurppa.fi/blog/kustomizer-03-for-openmoko-200812/ version 0.3 released]. Again many fixes and new apps included, for example agps support.
* '''2009-02-06''' [http://risto.kurppa.fi/blog/kustomizer-02-for-200812/ version 0.2 released]. GSM works again. Many fixes done - now Kustomizer can give you two different configurations, see [[Kustomizer#What_does_it_do.3F|here]]. [[Kustomizer#Changelog|Changelog]] and [http://kurppa.fi/freerunner/kustomizer_files/kustomizer_0.2_log_20090206.txt test run log]
* '''2009-02-02''' [http://risto.kurppa.fi/blog/kustomizer-for-openmoko-200812/ First release]. In this release GSM didn't work :(

=== Description ===
[[Image:Kustomizer-home.png|thumb|Home view]]Kustomizer is a script that converts your clean OM 2008.12 installation on Openmoko Freerunner into a usable phone/pda/toy/something.

The script is licensed with GPLv2 licence. The applications that it installs around the Net might have other licenses, check the original sites for more information.

Originally it was written to make it easy to try some apps after a clean installation for opkg.org application tests ([http://risto.kurppa.fi/blog/opkgorg-software-test-part-i/ review part one], [http://risto.kurppa.fi/blog/opkgorg-software-review-part-2/ review part two]) and 'recover' easily after that but in the end it became a script that might be useful for others, too.

Send questions and comments to [http://risto.kurppa.fi/blog Risto H. Kurppa] ( risto at kurppa dot fi ) or to the [[Development_resources#Mailing_Lists|Community mailing list]].

=== Warnings ===
[[Image:Kustomizer-install.png|thumb|Screenshot of the installation screen]]
* Kustomizer will not fix your WSOD / BSOD / wlan connecting only once / etc issues
* Flashing 2008.12 will wipe your rootfs
* Backup all your important data - just to be sure!
* Kustomizer is more or less under development

=== What does it do? ===
You can run Kustomizer once or twice. Here's an explanation what happens:

==== First run ====
The first time you run Kustomizer, it installes opkg.org repository, Illume-theme and terminal keyboard, files for better call audio quality, xterm. Also a CPU resource bug is fixed (qpe). A restart is required for this to take effect and Kustomizer will do this for you.

* illume-theme
* terminal keyboard
* wrench & qwerty buttons
* opkg.org repository added
* qpe eating CPU resources -bug fix
* new gsmhandset.state for improved audio quality
* Restart to apply the new settings

==== Second run ====
The second run will install the rest: applications, GPRS, link map direcories from µSD card, mokoservices and tap/untap etc. You don't have to make the second run if you don't want.

* Navit repository added
* Linking /home/root/Maps to /media/card/Maps
* Loads of coolest applications & libraries
* GPRS settings
* Freerunner-optimized Navit config XML. Preconfigured to use the map or Europe in /media/card/Maps/navit/europe.navit.bin
* Your custom script from /media/card/customscript will be run, if found. See [http://kurppa.fi/freerunner/config_files/customscript example]
* loads of various small fixes
* Restart to apply the new settings

After the second installation, about 150MB of the 256MB rootfs is used.

==== Applications ====
Here's a list of applications installed. All might not be included.

Applications / Internet

* Midori
* Minimo
* Dillo-ssl
* CenterIM
* Wireshark

Applications / GPS

* Navit
* GPSsight
* GPSdcontrol
* Orrery
* TangoGPS

Applications / Config

* Mokoservices
* Modified .Tap/Untap
* ShortOM
* Battery
* Sortdesk

Applications / Games

* OpenTTD
* Duke3D
* Numptyphysics
* OpenMooCow
* Pong
* XScat
* Liquidwar
* Moko-eightball
* Ko-Dice

Applications / Misc

* Tons of required libraries
* MokoConv
* Openmiaocat
* Gwaterpas
* Neon
* Meooem
* Mokox48 calculator
* Ledclock
* Qwo -keyboard
* Mtpaint
* Vala-terminal
* Fbreader
* Openmoko-mediaplayer
* Ffalarms

=== Running the script ===
Script is available at http://www.kurppa.fi/freerunner/kustomizer

Here's the instructions what to do on your desktop to flash to 2008.12 and then what to do on Freerunner (over SSH!) to run the script.

## ON DESKTOP COMPUTER (written for Ubuntu 8.10 and newer)

## Prepare your memory card
Here are some things you can put on your µSD card that will be mounted to /media/card. If you don't have these, it's OK.
* /m/c/customscript - your own script that will be run in the end. You can write here all your custom requirements, I added the Finnish keyboard and some handy scripts, see http://kurppa.fi/freerunner/config_files/customscript
* /m/c/Maps will be symlinked from /home/root/Maps. You can put your Openstreetmap map tiles there: TangoGPS uses this
* /m/c/Maps/navit/europe.navit.bin will be used by Navit, preconfigured to do so
* /m/c/Maps/navit/bookmarks.txt and destinations.txt will be copied to /home/root/.navit. These are the bookmarks and destinations for Navit

## REQUIRED PACKAGES
# install required packages:
# a) run: sudo apt-get install dfu-util bind9
# dfu-util is also available from http://downloads.openmoko.org/distro/releases/Om2008.9/dfu-util

## FLASH
# for more details, see http://wiki.openmoko.org/wiki/Flashing_the_Neo_Freerunner
# download the required image files
# b) run: wget http://downloads.openmoko.org/distro/releases/Om2008.12/Om2008.12-om-gta02.uImage.bin & wget http://downloads.openmoko.org/distro/releases/Om2008.12/Om2008.12-om-gta02.rootfs.jffs2
# c) Connect your freerunner to the computer with the USB cable
# d) start your Freerunner holding the AUX button down to get to the NOR menu
# e) run: sudo time dfu-util -a kernel -R -D Om2008.12-om-gta02.uImage.bin
# f) run: sudo time dfu-util -a rootfs -R -D Om2008.12-om-gta02.rootfs.jffs2
# g) Start & restart Freerunner to be able to log in over USB ssh
# h) Go to 'Settings' and change 'Suspend' to 'off' or Freerunner will suspend and the installation will fail.

## CONNECT
# Connect over usb-ssh with shared internet connection
# Don't run the script on Freerunner's screen! It can be done but not recommended if you don't know what you're doing.
# Download a script to help you & change the permission
# i) run: wget http://www.kurppa.fi/freerunner/fr_bind && chmod 755 fr_bind
# j) run: ./fr_bind
# k) First it asks for your Ubuntu -password to restart the interface & bind9 - type it in
# l) After this it asks for Freerunner password - it's empty, just hit Enter
# For more details check http://wiki.openmoko.org/wiki/Usb_networking#Ubuntu_8.10_-_Easy_Way

## ON FREERUNNER

# 1) Make sure you've turned 'Suspend' to 'off' in the Settings.
# 2) Make sure you can SSH in over USB so that Freerunner has Internet connection (ping google.com?)
# 3) run: wget http://www.kurppa.fi/freerunner/kustomizer_VERSION -O kustomizer && chmod 755 kustomizer
# 4) run: ./kustomizer
# On the first run it will install some stuff and then restart (to stop the qpe-bug). Then you need to repeat 2) and 4) and it'll install the rest

Let the [http://risto.kurppa.fi/blog author] ( risto at kurppa dot fi ) know how did it go! You might not receive any help but it helps to develop the script further. If possible, please attach the log.

=== Good to know ===
* Rerunning a newer version of Kustomizer will most likely break something -> Don't try to update, only run on clean 2008.12
* During the second run many packages will fail with segfault/md5sum mismatch/missing dependencies/package not found. No harm done but also no app installed. It's because of bad packaging and we just have to wait for someone to fix it.
* Services -> gprs usually says 'FAILED' when you try to start GPRS but when you restart the app, it says 'GPRS ON' and shows the traffic counter.
* Enlightenment crashes sometimes, just click 'Recover' and you're fine again.
* For instructions how to manage icon folders and icons of apps you install later, check http://www.opkg.org/package_95.html

=== Development ===
If you have some ideas of improvements please let the author know (see above). I'm not planning to create rootfs images or anything huge but there are some things that I'd like to see kustomizer do. Check the script for the current TODO.

* Mailing list at http://groups.google.com/group/kustomizer
* '''Development version''': http://kurppa.fi/freerunner/kustomizer_devel - please also test this and let me know what you think!!
* Some log files: http://kurppa.fi/freerunner/kustomizer_files/
* Also check the talk page: http://wiki.openmoko.org/wiki/Talk:Kustomizer

If someone is interested and willing to work on this please contact [http://risto.kurppa.fi/blog Risto H. Kurppa] ( risto at kurppa dot fi ). Moving to projects.openmoko is possible.

=== Changelog ===

# Version 0.4 - 2009-03-15

# (new) Kustomizer mailing list started: joing by mailing kustomizer+subscribe@googlegroups.com
# (new) wlan
# (new) install log stored to a file!
# (new) enter key added to the default keyboard
# (new) Finger keyboard http://lists.openmoko.org/nabble.html#nabble-td2217821
# (new) browse keyboard http://www.opkg.org/package_144.html
# (new) Voicenote http://www.opkg.org/package_140.html
# (new) qtopia calendar
# (new) Mokomodes http://users.jyu.fi/~hejajama/openmoko/mokomode_0.1_arm.ipk
# (new) pipes http://www.opkg.org/package_155.html
# (new) OMnewrotateMOD http://www.opkg.org/package_148.html
# (new) leafpad http://www.opkg.org/package_152.html
# (new) perpendicular http://www.opkg.org/package_150.html
# (new) voicenote http://www.opkg.org/package_140.html
# (new) acceleroids http://www.opkg.org/package_154.html
# (new) qtopia notes/text edit
# (new) findutils
# (new) qtopia ringtone/profile settings tool (check wrench -> profiles)
# (new) netsurf - another not-working web-browser for you to play with (http://cc.oulu.fi/~rantalai/freerunner/netsurf/)
# (new) openmoko-browser2
# (fix) changed the following to point from repositories to original url: centerim, openttd, numpty, xlogical
# (fix) Password now asked already in the first stage
# (fix) ntpclient installed & time updated in the first stage
# (fix) gpsd doesn't ask for autostart anymore -> one interaction less required during the installation
# (fix) added libexif to make tangogps 0.9.6 work
# (fix) sortdesk now installed from projects.openmoko.org to make sure it's installed
# (fix) pythm-fix by yebo gogo (=some packages from SHR & then custom pythm .tar.gz..)
# (fix) typo when installing enca - but enca still fails in md5sum mismatch..
# (fix) gwaterpas icon
# (fix) Another try with dillo-ssl
# (removed) tapuntap(aatap) - installed omnewrotatemod instead
# (removed) openmoko-mediaplayer2 - pythm does ~the same
# (removed) wireshark - not often needed..
# (removed) tangogps sample config - new yaouh version has fixed this?
# (removed) xmahjongg - it never installed..
# (removed) gpssight - installation fails
# (removed) liquidwar - package segfaults opkg..

# Version 0.35 - 2009-02-20

# (new) pymixer from http://wiki.openmoko.org/wiki/Neo_Freerunner_audio_subsystem#Alsamixer_channel_controls
# (new) Bytestore settiong builder: http://lists.openmoko.org/nabble.html#nabble-td2353361
# (new) - Dillo SSL works!
# (new) - Not suspending when USB connected
# (new) - Improved Mokoservices
# (new) - Tangogps configuration file (for yaouh)
# (new) yaouh map tile updater
# (new) AppManager package installer GUI
# (update) fbreader now installed from http://www.mikeasoft.com/~mike/openmoko/fbreader_0.8.2a-r7+elleopatches_om-gta02.ipk
# (fix) often-not-available enca package doesn't prevent any more other libraries from being installed -> more ok installs :)
# (fix) pythm icon
# (fix) more pythm fixes & required packages..
# (fix) openmoko-agps icon
# (fix) navit icon
# (removed) btgps (bluetooth-gps - not working, broken bluez-utils :(
# (removed) xskat (card game)
# (removed) moko-eightball (toy)

# Version 0.3 - 2009-02-19

# KNOWN ISSUES
# Many opkg.org packages fail to install because of bad packaging. They're still in there in case the packages are fixed at some stage.
# /dev/dsp is sometimes reserved (by speech-dispatcher?) so other apps can't use it
# GSM registration takes a long time

# CHANGELIST
# (fix) all possible packages installed using default & opkg.org & navit repositories
# (new) tried to fix speech-dispatcher -bug, see http://lists.openmoko.org/nabble.html#nabble-td2175057
# (new) password required for the root user during installation
# (new) ssh-over-wlan allowed
# (new) navit repository added -> updates from svn 1793 to 2051+ :)
# (new) Backups copies of some changed files stored to /home/root/backup
# (new) ntp to set clock in time
# (new) Sortdesk icons (thanks Yoann - http://lists.openmoko.org/pipermail/community/2009-February/041915.html)
# (new) opentts -> navit speech guidance works more or less
# (new) Sample book for fbreader included: http://www.gutenberg.org/etext/24948
# (new) linball
# (new) gtick http://wiki.openmoko.org/wiki/GTick
# (new) guitartune http://www.opkg.org/package_115.html
# (new) pythm http://www.opkg.org/package_1.html
# (new) fourier - sounds work -> returned
# (new) pypennotes
# (new) openmiaocat
# (new) agps
# (new) pythm & a fix to make it work w. python 2.5.
# (removed) mofi - doesn't work :(
# (removed) pidgin - segfaults
# (removed) scummvm - useless..
# (removed) yaouh - doesn't co-operate with latest tangogps versions without some hacking :(

# Version 0.2 - 2008-02-06
# CHANGELOG IN THIS VERSION
# (new) two run system:
# 1st run: illume-theme, wrench, qwerty are installed, opkg.org, storage.conf/qpe-bug fixed. Then restarted
# 2nd run: user needs to start Kustomizer again (and switch suspend/dim off!!) -> the rest is installed
# Rewriting the instructions
# General cleaning
# (new) ntpclient
# (new) http://www.opkg.org/package_121.html - MokoMaze
# (new) ttf-liberation-mono (vala-terminal uses this)
# (new) battery http://wiki.openmoko.org/wiki/Forcing_fast_charge_mode
# (new) runs /media/card/customscript - the user can add his own stuff there
# (new) automatic prevention of suspend & dimming
# (update) yaouh - version update
# (update) neon - version update
# (remove) Finnish keyboard layout & dictionary
# (remove) custom scripts from card
# (remove) cellhunter - on FSO-based only?
# (remove) Guitartune - on FSO-based only and libfft fails to install
# (remove) fourier - libfft fails to install
# (remove) zomg and appmanager - less used..
# (remove) pingus - doesn't install
# (remove) mumpot - useless for most
# (remove) usbmode - battery replaces most of this
# (fix) watch checkrate changed from 1s to 2s
# (fix) libglade-2.0 -> libglade-2.0-0

=== Roadmap ===
* Try to abandon the Openmoko distributions and move to SHR/FSO/Debian...

Knjrepository

2009-03-24T07:52:45Z

Myfanwy: /* Application packages */

== Packages for development ==

The knjRepository includes the following interesting packages:

# '''php526''' - PHP 5.2.6 CLI support, which enables you to write CLI-scripts for your OpenMoko. It also includes PDO (SQLite3) support.
# '''php526-gtk2''' - [[PHP-GTK]] enables you to write GTK-applications in PHP.
# '''ruby1.8''' - Enables you to use Ruby scripts on your OpenMoko.
# '''libgtk2-ruby1.8''' - Enables Ruby to use Gtk.
# '''libsqlite3-ruby1.8''' - Enables you to use SQLite3-databases in Ruby.
# '''libglade2-ruby1.8''' - Enables you to use Glade with Gtk-applications in Ruby.
# '''ruby1.8-icalendar''' - A Ruby-lib for parsing iCal-files.
# '''ruby1.8-googlecalendar''' - A Ruby-lib for working with a Google Calendar.

(and a lot of other Ruby-extensions like SOAP and WSDL)

A list of all the packages can be found [http://downloads.kaspernj.org/openmoko/repository/ here].

== Application packages ==
*'''[[KnjMokoWifi]]''' - An application for configuring the wireless interface in the OpenMoko-phone. It works with WPA, WEP and no-encryption. It supports profiles, so you dont have to remember passwords for each wireless access point used. It is written in PHP-GTK. Furthermore it can disable the routing-gateway on the USB-networking interface, making the default gateway WiFi. It can also start a DHCP-request to obtain an IP address and so on for the wireless interface.
*'''[[KnjMokoOPKG]]''' - A graphical frontend for OPKG.
*'''[[knjMokoCalendar]]''' - An application for viewing your Google Calendar on your OpenMoko phone written in Ruby. This application is still kind of unstable, since there isn't implemented any error handling.
*'''[[knjMokoSettings]]''' - An application which allows a user to carry out various administrative tasks on their phone, such as restarting the X-server, rebooting the phone, turning off/on the Wifi and more, via a graphical interface.
*'''[[knjMokoEmail]]''' - An application for reading email on openmoko phones

== How to use ==

You can configure your phone to use the repository by doing the following:

wget <nowiki>http://downloads.kaspernj.org/openmoko/repository/knjrepository.conf</nowiki> -O /etc/opkg/knjrepository.conf
opkg update

(ignore the signature errors)

Then if you want to install PHP-GTK, you can do this:
opkg install php526 php526-gtk2

Or if you want Ruby with Gtk-support:
opkg install ruby1.8 libgtk2-ruby1.8 libglade2-ruby1.8 libsqlite3-ruby

== Made by ==

The repository has been set up and is maintained by [mailto:k@spernj.org Kasper Johansen].

The PHP-packages has been packaged by Derick Rethans.

The Ruby-packages has been packaged by Kero van Gelder.
[[Category:Guides]]
[[Category:Applications]]

KnjMokoCalendar

2009-03-23T03:04:19Z

Myfanwy: New page: {{ApplicationBox| Name=knjMokoCalendar| Description=Google calendar client originally written for Om 2008.12| Screenshot=No-screenshot.png| Homepage=http://wordpress.kaspernj.org/?cat=...

KnjMokoWifi

2009-03-23T03:02:11Z

Myfanwy:

{{ApplicationBox|
Name=[[knjMokoWifi]]|
Description=Media player originally written for Om 2008.12|
Screenshot=No-screenshot.png|
Homepage=http://wordpress.kaspernj.org/?cat=15|
TestedOn=Om 2008.8|
PackageName=knjmokowifi
}}

== About the application ==

knjMokoWifi is an application for managing the wireless interface in the OpenMoko. The first version of the application was released 2009 in february, but the development began in December 2008. It has been written by [[User:Kaspernj|Kaspernj]] and can be downloaded through the [[Knjrepository]].

The newest version is stable and useable. It supports no-encryption, WEP Key, WEP String and WPA through wpa-supplicant. It works be generating working configs for wpa-supplicant and executing commands like udhcp (the DHCP-tool on the OpenMoko), iwconfig and such.

Further more it supports profiles, where you can save essid's and key's, so you dont have to enter all that stuff over and over.

The application is written in [http://www.php.net PHP] and uses the [http://gtk.php.net PHP-GTK] extension.

== Screenshots ==

[[Image:knjMokoWifi - Main Window.png]]

[[Image:knjMokoWifi - Connecting to an AP.png]]

[[Image:knjMokoWifi - Status Window.png]]

Knjrepository

2009-03-23T02:54:13Z

Myfanwy: /* Application packages */

== Packages for development ==

The knjRepository includes the following interesting packages:

# '''php526''' - PHP 5.2.6 CLI support, which enables you to write CLI-scripts for your OpenMoko. It also includes PDO (SQLite3) support.
# '''php526-gtk2''' - [[PHP-GTK]] enables you to write GTK-applications in PHP.
# '''ruby1.8''' - Enables you to use Ruby scripts on your OpenMoko.
# '''libgtk2-ruby1.8''' - Enables Ruby to use Gtk.
# '''libsqlite3-ruby1.8''' - Enables you to use SQLite3-databases in Ruby.
# '''libglade2-ruby1.8''' - Enables you to use Glade with Gtk-applications in Ruby.
# '''ruby1.8-icalendar''' - A Ruby-lib for parsing iCal-files.
# '''ruby1.8-googlecalendar''' - A Ruby-lib for working with a Google Calendar.

(and a lot of other Ruby-extensions like SOAP and WSDL)

A list of all the packages can be found [http://downloads.kaspernj.org/openmoko/repository/ here].

== Application packages ==
# '''[[KnjMokoWifi]]''' - An application for configuring the wireless interface in the OpenMoko-phone. It works with WPA, WEP and no-encryption. It supports profiles, so you dont have to remember passwords for each wireless access point used. It is written in PHP-GTK. Furthermore it can disable the routing-gateway on the USB-networking interface, making the default gateway WiFi. It can also start a DHCP-request to obtain an IP address and so on for the wireless interface.
# '''[[KnjMokoOPKG]]''' - A graphical frontend for OPKG.
# '''[[knjMokoCalendar]]''' - An application for viewing your Google Calendar on your OpenMoko phone written in Ruby. This application is still kind of unstable, since there isn't implemented any error handling.
# '''[[knjMokoSettings]]''' - An application which allows a user to carry out various administrative tasks on their phone, such as restarting the X-server, rebooting the phone, turning off/on the Wifi and more, via a graphical interface.

== How to use ==

You can configure your phone to use the repository by doing the following:

wget http://downloads.kaspernj.org/openmoko/repository/knjrepository.conf -O /etc/opkg/knjrepository.conf
opkg update

(ignore the signature errors)

Then if you want to install PHP-GTK, you can do this:
opkg install php526 php526-gtk2

Or if you want Ruby with Gtk-support:
opkg install ruby1.8 libgtk2-ruby1.8 libglade2-ruby1.8 libsqlite3-ruby

== Made by ==

The repository has been set up and is maintained by [mailto:k@spernj.org Kasper Johansen].

The PHP-packages has been packaged by Derick Rethans.

The Ruby-packages has been packaged by Kero van Gelder.
[[Category:Guides]]
[[Category:Applications]]

Setting Date and Time

2009-03-22T23:15:06Z

Myfanwy: /* Syncing the hardware clock */

Linux systems (such as the FreeRunner) prefer that the system clock be set to universal time (UTC). Then, you will need to configure the timezone to display the time adjusted to local time.

See [[Timezone]] for instructions on changing the time zone.

For more information on Linux timekeeping, see [http://www.linuxsa.org.au/tips/time.html Linux, Clocks, and Time]. (But ignore mentions of ''/etc/sysconfig/clock''. That doesn't apply to the Openmoko environment.)

== Setting the date/time using "date" ==

To change the date on your FreeRunner, issue one of the following commands:

date -s ''MMDDhhmm''
date -s ''MMDDhhmmYYYY''
date -s ''MMDDhhmmYYYY.ss''

where ''MM'' is the month, 01-12; ''DD'' is the day, 01-31; ''hhmm'' is the time, 0000-2359; ''YYYY'' is the optional year, and ''.ss'' is the optional seconds.

== Setting date/time from your linux box ==

<pre>
ssh root@openmoko "date -u -s `date -u +%m%d%H%M%Y.%S`"
</pre>

To also copy your timezone file, add an echo command:
ssh root@openmoko "date -u -s `date -u +%m%d%H%M%Y.%S`; echo `cat /etc/timezone` > /etc/timezone"

== Setting date/time with a python GUI ==

Tested on Neo1973 (OM2007.2), the 'time-man' tool is at

http://free-opensource.qvantel.net/mediawiki//index.php/Time-tool

== Setting your local timezone ==

To have your FreeRunner display time appropriate to your local timezone, update the /etc/localtime symlink to point to the file in /usr/share/zoneinfo that represents your timezone. For example, in an SSH session to the phone, or in a terminal running on the phone:

# ls -l /etc/localtime
lrwxrwxrwx 1 root root 27 Jul 10 23:05 /etc/localtime -> /usr/share/zoneinfo/PST8PDT
# ln -s /usr/share/zoneinfo/CST6CDT /etc/localtime

(Based on [http://n2.nabble.com/Date-%2B-NTP-tp675145p675163.html this post on the support mailing list])

You may want to try this if the above returns something like "file exists".
# ln -sf /usr/share/zoneinfo/CST6CDT /etc/localtime
the -f (--force) removes existing destination files. (CQ).

== Setting the date/time automatically with NTP ==

If your FreeRunner is connected to the internet, you can instead set the time automatically:

<code>
opkg install ntpclient<br/>
ntpclient -s -h pool.ntp.org
</code>

If your FreeRunner is connecting to the internet through a USB host, make sure you allow UDP traffic to pass through on port 123 (NTP) on your host machine or you may get a "no route to host" error from ntpclient.

Have a look over [https://wiki.muc.ccc.de/openmoko#freerunner1 over here] where this process is automated whilst udhcpc is started, which happens automatically for wifi connections initiated by Mofi and friends.

== Syncing the hardware clock ==

No matter which method you used above, sync the hardware clock with the system time to make your change persist over reboots:

hwclock --systohc

Note:
If you run the [[ASU]] or [[Qtopia]] image, hwclock will not work. The missing /dev/misc/rtc could be establish with

mkdir /dev/misc
ln -s /dev/rtc /dev/misc/rtc

but the device is usually busy due to the atd daemon.
Instead you can use this command causing atd to write the current time into the rtc:

echo -e "W\n" > /var/spool/at/trigger

Here is a link from the community mailing list for using hwclock with the [[ASU]] image:
:http://lists.openmoko.org/nabble.html#nabble-td584362

== Setting the date/time automatically with gps ==

[http://projects.openmoko.org/projects/gpv/ GPS Sight] has a button to sync the hardware clock to the gps clock.

First you have to make sure gps works on you neo. You can do that by following the steps in the [[Getting_Started_with_your_Neo_FreeRunner#Use_the_GPS]].

The second step is to install GPS Sight:

# opkg install http://projects.openmoko.org/frs/download.php/228/gpssight_0.8.4_armv4t.ipk

The last step is the actual syncing of the clock. For this, simply run the GPS Sight program from the main menu, wait for it to find the gps time and click the button labeled "Sync clock".

== Future Work ==

Presumably it might also be possible to use gpspipe (or something else) to set the date once you have a gps fix automatically? In addition, the phone stack should set the date, time, and timezone once connected to a network.

[[Category:Settings]]
[[Category:Advanced End User]]

The Bicycle Motion Information Displayer

2009-03-15T04:53:08Z

Myfanwy:

'''Project Title''': The Bicycle Motion Information Displayer

'''Project team members''':
*郭育廷
*曾惠卉

'''Contact email''': m9603034@isu.edu.tw

'''University''': Dept. of CSIE, I-Shou University (義守大學資工系)

'''Short description''':

The purpose of this project is to allow the Freerunner user to display the information of bicycle motion.

It can display the location of the cyclist and the distance travelled.

This project can increase the added value of the mobile phone and make the bicycle journey more enjoyable.

'''Links to project resources''': Not yet available

[[Category:Applications]]

Applications

2009-03-15T04:51:31Z

Myfanwy: /* Utility */

{{Languages|Applications}}
This is the wiki's master application list for the Openmoko smartphones.

== How to register new applications ?==

This list can not be exhaustive, as new things are showing up every week. This page is here to help spreading awareness about applications. Here are instructions on how to add a specific application to this list. There are many ways to go

Method 1 (preferred):
* Register your application at http://opkg.org. You will get a package number there, for example 33.
* Notify the community mailing list.
* Come back here, click on "edit" next to the appropriate section title, then add a line like:
<pre>* {{opkg.org|33|Application name}} A short description</pre>

Method 2: Just link to wherever the application is hosted.
* Click on "edit" next to the appropriate section title, add a line like:
<pre>* [http://your.host.domain/the/path/to/app/page.html Application name] A short description</pre>

Method 3: Create a new page in this wiki.
* Click on "edit" next to the appropriate section title, then add a line like:
<pre>* [[Application name]] A short description</pre>
* The application name will appear in red, click on it to create and edit the new page.

== Audio ==

* [[Openmoko-mediaplayer2]] - Play music and video (mp3...)
* [[Openmokast]] - Play audio stream and slideshow stream
* [[Pythm]] - Audio player GUI using mplayer and mpd as backend.
* [[Mokoko]]-Play music.
* [[Satan]] - Create your own music!
* [[Fourier]]- Realtime frequency analysis of sound data.
* [[Neoqplayer]] - a multimedia player written in Qt4
* {{opkg.org|55|ePiano}} - epiano is going to be a virtual piano
* [http://www.faltantornillos.net/proyectos/gnu/brightPlayer/brightPlayerOM2008v0.1.tar.gz Bright Player] - Fast, lightweight and easy random music player.
* [http://fisoft.eu/standa/openmoko/omshuffle_0.1_arm.ipk omShuffle] - Inspired by Bright Player with volume control.
* [[GTick]] - GTick is a metronome application written for GNU/Linux
* [[Guitartune]] - Tune musical Instruments.
* [[Voicenote]]-Voicenote is a script which allows to record any sound from the microphone into a wav file. It can play the created files too. It is intended to be an easy and quick way to do so.
* {{opkg.org|151|MokoPod}} - Retrieve and listen to podcasts
----

== Games ==

* [[Games/Om 2007.2]] - Many small games on Om 2007.2
* [[Om 2008.8 Sudoku]] - Number placement based puzzle game
* [[Moko-sudoku]] - Another sudoku puzzle game.
* {{opkg.org|60|ScummVM}} ([[Scummvm|Wiki]]) Virtual Machine for several classic graphical point-and-click adventure games
* [[Kobodeluxe]] - A top-view space shooter, available from 2008.8 repositories.
* [[Pingus]] - Pingus is a lemmings clone with penguins.
* [[Duke Nukem 3D]] - Legendary First Person Shooter.
* [[Numptyphysics]] - A drawing puzzle game.
* [[Gnuboy]] - An emulator for the handheld gaming all-time bestseller.
* [[XBill]] - Little action game to stop Bill from installing Windows(tm) on computers.
* [[Xlogical]]-A puzzle based game where you turn spinners to move balls around.
* [[Liquid War]]-Liquid War is a truly original multiplayer wargame.
* [http://unsyncopated.com/BrainSolvent/Doom%20Port DOOM]- Classic FPS. Freerunner/1973
* [[MBAC]]- MBAC is "Moko Bulls and Cows", a classic game for openmoko written in pygtk similar to mastermind.
* [[OpenVibe]] - The first opensource vibrator.
* [[OpenTTD]] - OpenTransportTycoonDeluxe, ported to openmoko, using only GPLed datafiles.
* [http://scalde.free.fr/index.php?option=com_content&view=article&id=93:pong-pogresses&catid=43:openmoko&Itemid=66 Pong progresses]- This is a little pong game for the openmoko freerunner. The screen is devided in halves, so you can touch the right half to move the paddle right and the left half to move it left.
* [[OpenMooCow]] - OpenMooCow reads information out of your accelerometers. Now, if you turn the phone upside down and back again, it "moos" like one of the little toys.
* [[Freerunner LightSaber]]-Application as iphone LightSaber.
* [[CellHunter]] - A game you earn points by collecting cells (in english now).
* [[XSkat]] - XSkat lets you play the card game Skat defined by the official Skat Order.
* {{opkg.org|136|OpenMiaoCat}} OpenMiaoCat, like OpenMooCow, makes your phone became a cat!
* {{opkg.org|149|I'm Rich}} I'm Rich application
* {{opkg.org|121|Mokomaze}} Ball-in-the-labyrinth game
* [[Acceleroids]] Shoot-the-asteroids game
----

== GPS ==

* [[GPS Sight]] - Display GPS information, location, tracks, etc, without maps.
* [[Gpsdrive]] - Car (bike, etc) navigation system
* [[Om 2008.8 Locations]] - (aka Splinter) - Location sharing based on GPS and SMS
* [[Navit]] - Car navigation system with routing engine
* [[TangoGPS]] - Display map (OSM..), record GPS tracks...
* [[Pyroute]] - Pyroute is a routing program written in Python. It features mobile phone GUI for maps, GPS, and routing.
* [http://www.mumpot.org/ mumpot] - Display map (OSM), routing, OSM editing, a bit of live editing
* [[QMapControl]] - Display maps (OSM..) and add points, lines...
* [[Qpegps]] - Display map with current position
* [[Idle Hands]] - Give a task to you based on your location
* [[Gtkaddpoi]] - Utility for add a POI to TangoGPS using address or coordinates
* [[Gpsdcontrol]]-A simple python script for start or stop gpsd daemon with a button on the desktop.
* [[OpenBmap]]-a free and open map of wireless communicating objects (e.g. cellular antenna, Wi-Fi, Bluetooth). It provides tools to mutualize data, create and access this map.

== Graphics ==

* [[Orrery]] - Displays the night sky
* [[OMView]] - Image viewer
* [[PyPenNotes]] - Write notes using pen and touchscreen
* [[Gpe-scap]] - Take screenshots
* [[Flash|Gnash]]-Play flash file on Neo
* [[Neon]] - Image viewer

----

== Internet ==

* [[Twinkle]] - Voice over IP
* [[Linphone]] - Voice over IP
* [[Midori]] - Webkit based web browser
* [[Minimo]] - Mozilla based web browser
* [http://www.dillo.org/ Dillo] - Multiplatform fast and small web browser ([http://misc.andi.de1.cc/dillo/ .ipk]).
* [[Mokopedia]] - Read small Wikipedia dumps offline
* [[Offline Wikipedia reader]] - store the entire content of wikipedia (except iamges), on a single 8GB microSD card
* [[Openmoko-browser2]] - The original Openmoko web browser
* [[Openmokast]] - Play audio stream and slideshow stream
* [[Openmoko Mail]] - E-mail client
* [[Pidgin]] - Instant messaging client (ICQ, MSN, Jabber, Yahoo and more.)
* [[CenterIM]] - Instant messaging client (terminal-based).
* [[PyFeedRead]] - RSS feed reader
* [[Qtmail]] - Default mail program on Om 2008.8
* [[TwitterMoko]] - A Twitter client for Openmoko
* [http://code.google.com/p/pyqt-browser/ pyqt-browser] - modified the sample code from python-pyqt4 and changed it to use webkit for web browsing.
* [http://we.trekbeyond.org/~kd8ikt/moko/shr_pkgz/ ettercap-ng]
* [http://www.netsurf-browser.org/ netsurf]-A new browser for Neo FreeRunner.

== Office ==
* [[Epdfview]] - PDF reader.
* Evince - Document reader for PDF, PS, DJVU and more.
* [[FBReader]] - E-book reader program (TXT, FB2, HTML and more)
* [[Gutenflash]] - Fast text reader by scrolling text
* [[OMoney]] - A bookkeeping application

== Settings ==

* [[Mofi]] - Wifi setup tool
* [[Lint-wifi]] - Wifi setup tool
* [[Om 2008.8 Installer]] - Graphical software installer
* [[Opkg]] - Command line software installer
* [[Sephora]] - Settings manager
* [[SettingsGUI]] - Edit various settings
* [[Wicd]] - Wifi setup tool
* [[ZOMG!]] - A graphical package manager (opkg frontend -> should work on any distro)
* [[Timezone|tzdata]]- Customise your time zone setting.
* [[momtools]] - an application to control Wifi, gprs and some other stuff
* [[Wlan]] - Wlan is an application to manage wireless connection on the Freerunner

== System ==
* [[Aphasia]] - A system built on Erlang and a vertical application for people with apahasia.
* [[Auxlaunch]] - Finger-friendly app launcher and window switcher
* [[Display Locker]] - Screen lock
* [[Gwaterpas]] - levelling tool using accelerometer
* [[Gestures]] - Detect movement and display information, rotate screen
* [[Keychain]] - SSH keys
* [[MokoFEM]] - Monitors GSM information
* [[Mokostat]] - Monitors battery
* [[Openmoko Bluetooth remote controller|ReMoko]] - Control stuff via BlueTooth
* [[Rotate]] - Rotate screen when phone is rotated
* [[Vala-terminal]] - Command prompt with tabs
* [[Ts calibrate]] - Calibrates touchscreen
* [[Zedlock]] - Screen locker
* [http://fso-control.projects.openmoko.org/ fso-control] - Popup Power menu to shutdown/suspend/reboot.
* [[omkeys_functions]] - Remap AUX key bindings
* [[Siglaunchd]] - A daemon that listens to dbus signals and launches appliactions upon arrival.
* [[Pexpect]]-a pure Python module for spawning child applications; controlling them; and responding to expected patterns in their output.

----

== Telephony ==
* [[Dialer/2007.2]] - The dialer application in Om 2007.2
* [[Openmoko SMS Middleware]]- SMS middleware is a Openmoko middleware software for additional features related to SMS. Plugin architecture and Python based code gives this project lots of flexibility and enchancebility.
* [[Paroli]] -Paroli is an integrated phone application based on Tichy (and so also written in python).

----

== Utility ==
* [[Unison]] - Unison is a file-synchronization tool for Unix and Windows. It determines all differences between two directory trees and lets the user decide, how to proceed with every differing file.
* [[HP48 Series RPN Calculator]] - Calculator with many functions
* [[qwo]]- An alternative input method.
* {{opkg.org|57|fido}} - [[fido]] is a todo list\note manager written with elementary
* [http://meuk.spritesserver.nl/lightsaber-0.1.tgz The Lightsaber]. Pre-alpha starwaresque orphanware.
* [[NeoTool]] NeoTool is a bash script for your desktop system to provide a friendly GUI frontend to some common management tasks.
* [[NeoCon]] - neocon is a handy serial console utility (not only) for u-boot. The main feature of neocon is actually that you can give it a list of devices and it will pick one that works.
* [http://techiem2.net/index.php?/archives/10-Freerunner-USB-Mode-Control-Program.html usbmode]-a quick pygtk program.
* [[Enotes]] - Enotes is the implementation of a TODOlist manager written with elementary to appear better with distribution that use illume, like SHR.
* [[LED clock]] - When an Openmoko is sitting unused at night, turn it into an alarm clock with large 7-segment digits on a black background in landscape mode.
* [[MokoGeocaching]] - Utility for add a POI to TangoGPS using geocaching.com
* [[Wrench]] - Modual used utility enlightenment_remote.
* [[Yaouh!]] - Yet Another OSM Updater H.
* [[ShortOm]] - Graphical launcher for shell or application, with editable config file, and log result page.
* [[Pimlico]]-Pimlico is a suite of lightweight Personal Information Management (PIM) applications designed primarily for handheld and mobile devices
* [http://projects.openmoko.org/projects/otp4neo/ OTP4Neo] One time password generator
* [http://projects.openmoko.org/projects/ffalarms/ FFAlarm] is a program to set multiple alarms a day using a finger friendly user interface
* [[OpenWrt]]-basic support for the Openmoko "Freerunner"! Kernel (2.6.28) is building and booting.
* [[Enscribi]]-a handwriting recognition input method for Linux. It's mainly developed for the Openmoko Freerunner smartphone.
* [[GridPad]]-GridPad is an alternative input method for entering text with your finger, a Simple Character Recognizer Software.
* [http://sortdesk.projects.openmoko.org/ sortdesk] sort your om-desktop in categories
* [[Mokometeo]] is a widget which fetches the weather forecast from yahoo, for a list of cities

==Setting Application==
* [[Wmiconfig]]- wmiconfig is a tool written by Atheros Communications Inc to configure the Ar6k WIFI chip used in the Neo Freerunner. This is a standalone C executable, released under GPL v2.
* [[GTA02 sysfs]]- sysfs is a filesystem that is mounted on /sys which contains various fake "files" that are actually filled by a variety of drivers and other kernel subsystems. You can use it to change settings and behaviours of the kernel and drivers dynamically.

== Video ==

* [[Video Player]] - Using Mplayer on Openmoko smartphones.
* [http://katastrophos.net/andre/blog/software/quasar-media-player/ Quasar] - a mplayer frontend for X11.

----

== daemon ==
* [[PyPhonelog]] - daemon uses the framework to track and log all the calls made to and from the moko.
* [[Lscd]] - LSC library/daemon on Linux System.

== An automatic list of application-related wiki pages ==

The pages linked above are all maintained manually. We also maintain an automatic categorization system by tagging wiki pages. Here is the list of application-related pages in this wiki. Normally, every page listed below should be also listed above in the same category. The converse is false: there are applications without a wiki page.

<div style="border: solid 1px black; padding: 1ex"><b>Applications in this Wiki:</b>
<categorytree mode=pages depth=2 hideroot=on>Applications</categorytree>
</div>

== Where to find more applications? ==

At [http://opkg.org opkg.org] !

Not all Openmoko apps are listed on this wiki - there are much more [http://projects.openmoko.org/softwaremap/ projects at the Openmoko GForge] than the wiki can list, not to mention self-hosted applications on their own websites. Actually the phones can run most Linux based Free Software, using for example the [[Debian]] distribution. The [http://handhelds.freshmeat.net/browse/1038/ mobile phones section of Freshmeat] may be a interesting place to look.

Note also that there are many packages in the repository that are not installed by default. If what you want is a classic, chances are that it is already packaged. Suppose you want to install Perl:
opkg list|grep perl
opkg install perl

More application download related pages:

* [[Community Repository]]
* [[Users Repositories]]

<div style="clear:both"> </div>

== Where to find full distributions ? ==

* [[Download]]: for complete system downloads

== The usual warnings ==
<small>
* Some of these software are developed by Openmoko Inc. and some are contributed by the community. Any problems with community contributed software should be reported to the individual software developer rather than the Openmoko core team.
* Most programs listed here are not mature/stable, but only useable/beta.
* Many programs listed here are not yet packaged for your distribution and integrated in its repositories. Whichever it is.
* Installing experimental software from the internet is certain to break things. Running it as root is a very insecure thing to do. Kown that you will be burned, have backups, and be ready to apologize to everybody in your phone contact list in case they receive strange SMSs...
</small>

[[Category:Applications|Applications]]
[[Category:Basic End User]]

Applications

2009-03-15T04:50:17Z

Myfanwy: /* Settings */

{{Languages|Applications}}
This is the wiki's master application list for the Openmoko smartphones.

== How to register new applications ?==

This list can not be exhaustive, as new things are showing up every week. This page is here to help spreading awareness about applications. Here are instructions on how to add a specific application to this list. There are many ways to go

Method 1 (preferred):
* Register your application at http://opkg.org. You will get a package number there, for example 33.
* Notify the community mailing list.
* Come back here, click on "edit" next to the appropriate section title, then add a line like:
<pre>* {{opkg.org|33|Application name}} A short description</pre>

Method 2: Just link to wherever the application is hosted.
* Click on "edit" next to the appropriate section title, add a line like:
<pre>* [http://your.host.domain/the/path/to/app/page.html Application name] A short description</pre>

Method 3: Create a new page in this wiki.
* Click on "edit" next to the appropriate section title, then add a line like:
<pre>* [[Application name]] A short description</pre>
* The application name will appear in red, click on it to create and edit the new page.

== Audio ==

* [[Openmoko-mediaplayer2]] - Play music and video (mp3...)
* [[Openmokast]] - Play audio stream and slideshow stream
* [[Pythm]] - Audio player GUI using mplayer and mpd as backend.
* [[Mokoko]]-Play music.
* [[Satan]] - Create your own music!
* [[Fourier]]- Realtime frequency analysis of sound data.
* [[Neoqplayer]] - a multimedia player written in Qt4
* {{opkg.org|55|ePiano}} - epiano is going to be a virtual piano
* [http://www.faltantornillos.net/proyectos/gnu/brightPlayer/brightPlayerOM2008v0.1.tar.gz Bright Player] - Fast, lightweight and easy random music player.
* [http://fisoft.eu/standa/openmoko/omshuffle_0.1_arm.ipk omShuffle] - Inspired by Bright Player with volume control.
* [[GTick]] - GTick is a metronome application written for GNU/Linux
* [[Guitartune]] - Tune musical Instruments.
* [[Voicenote]]-Voicenote is a script which allows to record any sound from the microphone into a wav file. It can play the created files too. It is intended to be an easy and quick way to do so.
* {{opkg.org|151|MokoPod}} - Retrieve and listen to podcasts
----

== Games ==

* [[Games/Om 2007.2]] - Many small games on Om 2007.2
* [[Om 2008.8 Sudoku]] - Number placement based puzzle game
* [[Moko-sudoku]] - Another sudoku puzzle game.
* {{opkg.org|60|ScummVM}} ([[Scummvm|Wiki]]) Virtual Machine for several classic graphical point-and-click adventure games
* [[Kobodeluxe]] - A top-view space shooter, available from 2008.8 repositories.
* [[Pingus]] - Pingus is a lemmings clone with penguins.
* [[Duke Nukem 3D]] - Legendary First Person Shooter.
* [[Numptyphysics]] - A drawing puzzle game.
* [[Gnuboy]] - An emulator for the handheld gaming all-time bestseller.
* [[XBill]] - Little action game to stop Bill from installing Windows(tm) on computers.
* [[Xlogical]]-A puzzle based game where you turn spinners to move balls around.
* [[Liquid War]]-Liquid War is a truly original multiplayer wargame.
* [http://unsyncopated.com/BrainSolvent/Doom%20Port DOOM]- Classic FPS. Freerunner/1973
* [[MBAC]]- MBAC is "Moko Bulls and Cows", a classic game for openmoko written in pygtk similar to mastermind.
* [[OpenVibe]] - The first opensource vibrator.
* [[OpenTTD]] - OpenTransportTycoonDeluxe, ported to openmoko, using only GPLed datafiles.
* [http://scalde.free.fr/index.php?option=com_content&view=article&id=93:pong-pogresses&catid=43:openmoko&Itemid=66 Pong progresses]- This is a little pong game for the openmoko freerunner. The screen is devided in halves, so you can touch the right half to move the paddle right and the left half to move it left.
* [[OpenMooCow]] - OpenMooCow reads information out of your accelerometers. Now, if you turn the phone upside down and back again, it "moos" like one of the little toys.
* [[Freerunner LightSaber]]-Application as iphone LightSaber.
* [[CellHunter]] - A game you earn points by collecting cells (in english now).
* [[XSkat]] - XSkat lets you play the card game Skat defined by the official Skat Order.
* {{opkg.org|136|OpenMiaoCat}} OpenMiaoCat, like OpenMooCow, makes your phone became a cat!
* {{opkg.org|149|I'm Rich}} I'm Rich application
* {{opkg.org|121|Mokomaze}} Ball-in-the-labyrinth game
* [[Acceleroids]] Shoot-the-asteroids game
----

== GPS ==

* [[GPS Sight]] - Display GPS information, location, tracks, etc, without maps.
* [[Gpsdrive]] - Car (bike, etc) navigation system
* [[Om 2008.8 Locations]] - (aka Splinter) - Location sharing based on GPS and SMS
* [[Navit]] - Car navigation system with routing engine
* [[TangoGPS]] - Display map (OSM..), record GPS tracks...
* [[Pyroute]] - Pyroute is a routing program written in Python. It features mobile phone GUI for maps, GPS, and routing.
* [http://www.mumpot.org/ mumpot] - Display map (OSM), routing, OSM editing, a bit of live editing
* [[QMapControl]] - Display maps (OSM..) and add points, lines...
* [[Qpegps]] - Display map with current position
* [[Idle Hands]] - Give a task to you based on your location
* [[Gtkaddpoi]] - Utility for add a POI to TangoGPS using address or coordinates
* [[Gpsdcontrol]]-A simple python script for start or stop gpsd daemon with a button on the desktop.
* [[OpenBmap]]-a free and open map of wireless communicating objects (e.g. cellular antenna, Wi-Fi, Bluetooth). It provides tools to mutualize data, create and access this map.

== Graphics ==

* [[Orrery]] - Displays the night sky
* [[OMView]] - Image viewer
* [[PyPenNotes]] - Write notes using pen and touchscreen
* [[Gpe-scap]] - Take screenshots
* [[Flash|Gnash]]-Play flash file on Neo
* [[Neon]] - Image viewer

----

== Internet ==

* [[Twinkle]] - Voice over IP
* [[Linphone]] - Voice over IP
* [[Midori]] - Webkit based web browser
* [[Minimo]] - Mozilla based web browser
* [http://www.dillo.org/ Dillo] - Multiplatform fast and small web browser ([http://misc.andi.de1.cc/dillo/ .ipk]).
* [[Mokopedia]] - Read small Wikipedia dumps offline
* [[Offline Wikipedia reader]] - store the entire content of wikipedia (except iamges), on a single 8GB microSD card
* [[Openmoko-browser2]] - The original Openmoko web browser
* [[Openmokast]] - Play audio stream and slideshow stream
* [[Openmoko Mail]] - E-mail client
* [[Pidgin]] - Instant messaging client (ICQ, MSN, Jabber, Yahoo and more.)
* [[CenterIM]] - Instant messaging client (terminal-based).
* [[PyFeedRead]] - RSS feed reader
* [[Qtmail]] - Default mail program on Om 2008.8
* [[TwitterMoko]] - A Twitter client for Openmoko
* [http://code.google.com/p/pyqt-browser/ pyqt-browser] - modified the sample code from python-pyqt4 and changed it to use webkit for web browsing.
* [http://we.trekbeyond.org/~kd8ikt/moko/shr_pkgz/ ettercap-ng]
* [http://www.netsurf-browser.org/ netsurf]-A new browser for Neo FreeRunner.

== Office ==
* [[Epdfview]] - PDF reader.
* Evince - Document reader for PDF, PS, DJVU and more.
* [[FBReader]] - E-book reader program (TXT, FB2, HTML and more)
* [[Gutenflash]] - Fast text reader by scrolling text
* [[OMoney]] - A bookkeeping application

== Settings ==

* [[Mofi]] - Wifi setup tool
* [[Lint-wifi]] - Wifi setup tool
* [[Om 2008.8 Installer]] - Graphical software installer
* [[Opkg]] - Command line software installer
* [[Sephora]] - Settings manager
* [[SettingsGUI]] - Edit various settings
* [[Wicd]] - Wifi setup tool
* [[ZOMG!]] - A graphical package manager (opkg frontend -> should work on any distro)
* [[Timezone|tzdata]]- Customise your time zone setting.
* [[momtools]] - an application to control Wifi, gprs and some other stuff
* [[Wlan]] - Wlan is an application to manage wireless connection on the Freerunner

== System ==
* [[Aphasia]] - A system built on Erlang and a vertical application for people with apahasia.
* [[Auxlaunch]] - Finger-friendly app launcher and window switcher
* [[Display Locker]] - Screen lock
* [[Gwaterpas]] - levelling tool using accelerometer
* [[Gestures]] - Detect movement and display information, rotate screen
* [[Keychain]] - SSH keys
* [[MokoFEM]] - Monitors GSM information
* [[Mokostat]] - Monitors battery
* [[Openmoko Bluetooth remote controller|ReMoko]] - Control stuff via BlueTooth
* [[Rotate]] - Rotate screen when phone is rotated
* [[Vala-terminal]] - Command prompt with tabs
* [[Ts calibrate]] - Calibrates touchscreen
* [[Zedlock]] - Screen locker
* [http://fso-control.projects.openmoko.org/ fso-control] - Popup Power menu to shutdown/suspend/reboot.
* [[omkeys_functions]] - Remap AUX key bindings
* [[Siglaunchd]] - A daemon that listens to dbus signals and launches appliactions upon arrival.
* [[Pexpect]]-a pure Python module for spawning child applications; controlling them; and responding to expected patterns in their output.

----

== Telephony ==
* [[Dialer/2007.2]] - The dialer application in Om 2007.2
* [[Openmoko SMS Middleware]]- SMS middleware is a Openmoko middleware software for additional features related to SMS. Plugin architecture and Python based code gives this project lots of flexibility and enchancebility.
* [[Paroli]] -Paroli is an integrated phone application based on Tichy (and so also written in python).

----

== Utility ==
* [[Unison]] - Unison is a file-synchronization tool for Unix and Windows. It determines all differences between two directory trees and lets the user decide, how to proceed with every differing file.
* [[HP48 Series RPN Calculator]] - Calculator with many functions
* [[qwo]]- An alternative input method.
* {{opkg.org|57|fido}} - [[fido]] is a todo list\note manager written with elementary
* [http://meuk.spritesserver.nl/lightsaber-0.1.tgz The Lightsaber]. Pre-alpha starwaresque orphanware.
* [[NeoTool]] NeoTool is a bash script for your desktop system to provide a friendly GUI frontend to some common management tasks.
* [[NeoCon]] - neocon is a handy serial console utility (not only) for u-boot. The main feature of neocon is actually that you can give it a list of devices and it will pick one that works.
* [http://techiem2.net/index.php?/archives/10-Freerunner-USB-Mode-Control-Program.html usbmode]-a quick pygtk program.
* [[Enotes]] - Enotes is the implementation of a TODOlist manager written with elementary to appear better with distribution that use illume, like SHR.
* [[LED clock]] - When an Openmoko is sitting unused at night, turn it into an alarm clock with large 7-segment digits on a black background in landscape mode.
* [[MokoGeocaching]] - Utility for add a POI to TangoGPS using geocaching.com
* [[Wrench]] - Modual used utility enlightenment_remote.
* [[Yaouh!]] - Yet Another OSM Updater H.
* [[ShortOm]] - Graphical launcher for shell or application, with editable config file, and log result page.
* [[Pimlico]]-Pimlico is a suite of lightweight Personal Information Management (PIM) applications designed primarily for handheld and mobile devices
* [http://projects.openmoko.org/projects/otp4neo/ OTP4Neo] One time password generator
* [http://projects.openmoko.org/projects/ffalarms/ FFAlarm] is a program to set multiple alarms a day using a finger friendly user interface
* [[OpenWrt]]-basic support for the Openmoko "Freerunner"! Kernel (2.6.28) is building and booting.
* [[Enscribi]]-a handwriting recognition input method for Linux. It's mainly developed for the Openmoko Freerunner smartphone.
* [[GridPad]]-GridPad is an alternative input method for entering text with your finger, a Simple Character Recognizer Software.
* [http://sortdesk.projects.openmoko.org/ sortdesk] sort your om-desktop in categories
* [[Mokometeo]] it is a wiget fetching the weather forecast from yahoo for a list of cities

==Setting Application==
* [[Wmiconfig]]- wmiconfig is a tool written by Atheros Communications Inc to configure the Ar6k WIFI chip used in the Neo Freerunner. This is a standalone C executable, released under GPL v2.
* [[GTA02 sysfs]]- sysfs is a filesystem that is mounted on /sys which contains various fake "files" that are actually filled by a variety of drivers and other kernel subsystems. You can use it to change settings and behaviours of the kernel and drivers dynamically.

== Video ==

* [[Video Player]] - Using Mplayer on Openmoko smartphones.
* [http://katastrophos.net/andre/blog/software/quasar-media-player/ Quasar] - a mplayer frontend for X11.

----

== daemon ==
* [[PyPhonelog]] - daemon uses the framework to track and log all the calls made to and from the moko.
* [[Lscd]] - LSC library/daemon on Linux System.

== An automatic list of application-related wiki pages ==

The pages linked above are all maintained manually. We also maintain an automatic categorization system by tagging wiki pages. Here is the list of application-related pages in this wiki. Normally, every page listed below should be also listed above in the same category. The converse is false: there are applications without a wiki page.

<div style="border: solid 1px black; padding: 1ex"><b>Applications in this Wiki:</b>
<categorytree mode=pages depth=2 hideroot=on>Applications</categorytree>
</div>

== Where to find more applications? ==

At [http://opkg.org opkg.org] !

Not all Openmoko apps are listed on this wiki - there are much more [http://projects.openmoko.org/softwaremap/ projects at the Openmoko GForge] than the wiki can list, not to mention self-hosted applications on their own websites. Actually the phones can run most Linux based Free Software, using for example the [[Debian]] distribution. The [http://handhelds.freshmeat.net/browse/1038/ mobile phones section of Freshmeat] may be a interesting place to look.

Note also that there are many packages in the repository that are not installed by default. If what you want is a classic, chances are that it is already packaged. Suppose you want to install Perl:
opkg list|grep perl
opkg install perl

More application download related pages:

* [[Community Repository]]
* [[Users Repositories]]

<div style="clear:both"> </div>

== Where to find full distributions ? ==

* [[Download]]: for complete system downloads

== The usual warnings ==
<small>
* Some of these software are developed by Openmoko Inc. and some are contributed by the community. Any problems with community contributed software should be reported to the individual software developer rather than the Openmoko core team.
* Most programs listed here are not mature/stable, but only useable/beta.
* Many programs listed here are not yet packaged for your distribution and integrated in its repositories. Whichever it is.
* Installing experimental software from the internet is certain to break things. Running it as root is a very insecure thing to do. Kown that you will be burned, have backups, and be ready to apologize to everybody in your phone contact list in case they receive strange SMSs...
</small>

[[Category:Applications|Applications]]
[[Category:Basic End User]]