Openmoko - User contributions [en]

Template:Distros

2010-10-16T14:26:08Z

Blat:

{| style="clear:left; float:left; width:200px; background-color:#333333; color:#FFFFFF; border-collapse:collapse; font-weight:bold" class="toccolours"
|-
| style="background:#F60;" align="center" | '''popular'''
|-
|
* [[SHR]]
* [[Debian]]
* [[QtMoko]]
* [[Android]]
* [[Hackable:1]]
* [[Qt Extended Improved]]
|-
| style="background:#F60;" align="center" | '''others'''
|-
|
* [[Om 2009]]
* [[Om 2008]]
* [[Om 2007.2]]
* [[GameRunner]]
* [[Gentoo]]
* [[Mer]]
* [[Neovento]]
* [[OpenWrt]]
* [[Qalee]]
|}<noinclude>
[[Category:Templates]]
</noinclude>

LuckyGPS

2010-10-01T15:43:21Z

Blat: New page: {{Languages|luckyGPS}} {{Application|luckyGPS}} {{ApplicationBox| Name=luckyGPS| Description=| Screenshot=| Homepage=http://www.luckygps.com/| TestedOn=| PackageName= }} __TOC__ Lu...

{{Languages|luckyGPS}}
{{Application|luckyGPS}}

{{ApplicationBox|
Name=[[luckyGPS]]|
Description=|
Screenshot=|
Homepage=http://www.luckygps.com/|
TestedOn=|
PackageName=
}}

__TOC__

LuckyGPS is an offline routing, navigation, mapping and tracking application all in one, coded primarily for Linux/Qt platforms.

See http://wiki.openstreetmap.org/wiki/LuckyGPS and http://www.luckygps.com/ for further details.

[[Category:GPS Applications]]

Community Updates/2010-07-01

2010-06-20T21:28:51Z

Blat: /* New Applications */

{{Improve}}
{{Note|
*Take a moment and look at Discussion page to get a clue on how to contribute to Community Updates while following OM wiki editing guidelines please.
*I you are planning longer edition, please use <nowiki>{{Editing|your_username_here|date_here|editing_summary_here}}tag. Remember to remove/comment out it right after you save your work.</nowiki>
*Please fill in everything you think the community should know.
*On 2010-07-01 this content will be _moved_ to http://wiki.openmoko.org/wiki/Community_Updates/2010-07-01, feel free to do it.
*Post a note about CU release on the community mailing list.
}}



====='''Period 2010-06-01 to 2010-06-30'''=====

==Distributions==
{{DistributionBox|
Name=Distro Name [version]|
Description=Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.|
Screenshot=System_boot.png|
Codename='codename'|
Homepage=http://www.homepage.org|
Image=[http://www.homepage.org/path/to/ images]|
Works={{Works}}
}}

==Applications==
===New Applications===
{{ApplicationBox|
Name=Exampleapp 0.0.1|
Description=Exampleapp 0.0.1 is an application to do some stuff..|
Screenshot=System_boot.png|
Homepage=http://wiki.openmoko.org/|
TestedOn=SHR-Unstable,Om2009T5|
PackageName=[http:// www.some.srv/path_to/Exampleapp.ipk Exampleapp]
}}

{{ApplicationBox|
Name=[[DWDWetter]] 0.2.8|
Description=DWDwetter 0.2.8 is an application to get free (only registration), available worldwide Weather information from DWD and view this in a Viewer Window. Possibility for automatically update files delivered on ftp-server of DWD.|
Screenshot=Dwdwetter-Screenshot-2.png|
Homepage=http://www.huber-computer.de/openmoko|
TestedOn=SHR|
PackageName=[http://www.huber-computer.de/openmoko/dwdwetter_0.2.8_all.ipk]
}}

{{ApplicationBox|
Name=FoxtrotGPS 0.99.4|
Description=FoxtrotGPS is a tangoGPS fork adding multiple improvements (see changelog)|
Screenshot=System_boot.png|
Homepage=http://www.foxtrotgps.org/|
TestedOn=|
PackageName=[]
}}

===Application Updates===
{{ApplicationBox|
Name=Exampleapp 0.0.1|
Description=Exampleapp 0.0.1 is an application to do some stuff...
* new example feature 1
* new example feature 2|
Screenshot=System_boot.png|
Homepage=http://wiki.openmoko.org/|
TestedOn=SHR-Unstable,Om2009T5|
PackageName=[http:// www.some.srv/path_to/Exampleapp.ipk Exampleapp]
}}

==Community==
Most important and change making mails on the mailing lists, blogs etc.. Coolest hacks, screenshots, themes etc..

==Event News==
* '''2010-mm-dd''' [http://example.url.xom Example event] | add your event here

[[Category:Community Update]]

Community Updates/2010-07-01

2010-06-20T21:26:10Z

Blat: /* New Applications */

{{Improve}}
{{Note|
*Take a moment and look at Discussion page to get a clue on how to contribute to Community Updates while following OM wiki editing guidelines please.
*I you are planning longer edition, please use <nowiki>{{Editing|your_username_here|date_here|editing_summary_here}}tag. Remember to remove/comment out it right after you save your work.</nowiki>
*Please fill in everything you think the community should know.
*On 2010-07-01 this content will be _moved_ to http://wiki.openmoko.org/wiki/Community_Updates/2010-07-01, feel free to do it.
*Post a note about CU release on the community mailing list.
}}



====='''Period 2010-06-01 to 2010-06-30'''=====

==Distributions==
{{DistributionBox|
Name=Distro Name [version]|
Description=Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.Here comes some additional text to show you guys, how Template:DistributionBox will behave under heavy load of text. It is copied several times on purpose. This way you can see how layout would looke like if description of distribution is very complex or expanded.|
Screenshot=System_boot.png|
Codename='codename'|
Homepage=http://www.homepage.org|
Image=[http://www.homepage.org/path/to/ images]|
Works={{Works}}
}}

==Applications==
===New Applications===
{{ApplicationBox|
Name=Exampleapp 0.0.1|
Description=Exampleapp 0.0.1 is an application to do some stuff..|
Screenshot=System_boot.png|
Homepage=http://wiki.openmoko.org/|
TestedOn=SHR-Unstable,Om2009T5|
PackageName=[http:// www.some.srv/path_to/Exampleapp.ipk Exampleapp]
}}

{{ApplicationBox|
Name=[[DWDWetter]] 0.2.8|
Description=DWDwetter 0.2.8 is an application to get free (only registration), available worldwide Weather information from DWD and view this in a Viewer Window. Possibility for automatically update files delivered on ftp-server of DWD.|
Screenshot=Dwdwetter-Screenshot-2.png|
Homepage=http://www.huber-computer.de/openmoko|
TestedOn=SHR|
PackageName=[http://www.huber-computer.de/openmoko/dwdwetter_0.2.8_all.ipk]
}}

{{ApplicationBox|
Name=FoxtrotGPS 0.99.4|
Description=FoxtrotGPS is a tangoGPS fork adding multiple improvements (see changelog)|
Screenshot=System_boot.png|
Homepage=http://foxtrotgps.org/|
TestedOn=|
PackageName=[]
}}

===Application Updates===
{{ApplicationBox|
Name=Exampleapp 0.0.1|
Description=Exampleapp 0.0.1 is an application to do some stuff...
* new example feature 1
* new example feature 2|
Screenshot=System_boot.png|
Homepage=http://wiki.openmoko.org/|
TestedOn=SHR-Unstable,Om2009T5|
PackageName=[http:// www.some.srv/path_to/Exampleapp.ipk Exampleapp]
}}

==Community==
Most important and change making mails on the mailing lists, blogs etc.. Coolest hacks, screenshots, themes etc..

==Event News==
* '''2010-mm-dd''' [http://example.url.xom Example event] | add your event here

[[Category:Community Update]]

Talk:TangoGPS

2009-05-04T06:18:02Z

Blat: /* = */ batch processing tracklogs

==subproject==
===navicache poi import===
(geocaching) work in progress HELPHELPHELP kd8ikt@fuse.net 

import navicache.com geocache waypoints via their downloadable gpx (xml) into tangogps's ~/.tangogps/poi.db (sqlitedb)

example navicache.com gpx file 
<PRE>
<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>

<gpx

version="1.0"

creator="NaviCache Cache Download 1.0.0 - http://www.navicache.com"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns="http://www.topografix.com/GPX/1/0"

xsi:schemaLocation="http://www.topografix.com/GPX/1/0 http://www.topografix.com/GPX/1/0/gpx.xsd ">

<name>acountnames's GPX download</name>

<author>NaviCache.com</author>

<email>support@navicache.com</email>

<url>http://www.navicache.com</url>

<urlname>NaviCache</urlname>

<time>2009-02-06T21:35:30Z</time>

<wpt lat="39.3173666666667" lon="-84.54635">

<name>N00BD5</name>

<desc>A Chip Off the Old Block by Web_ling</desc>

<url>http://www.navicache.com/cgi-bin/db/displaycache2.pl?CacheID=3029</url>

<urlname>Cache Details</urlname>

<sym>Default</sym>

<type>Geocache</type>

</wpt>

<wpt lat="39.32035" lon="-84.5737333333333">

<name>N0114D</name>

<desc>Cache Hopper by Web_ling</desc>

<url>http://www.navicache.com/cgi-bin/db/displaycache2.pl?CacheID=4429</url>

<urlname>Cache Details</urlname>

<sym>Default</sym>

<type>Geocache</type>

</wpt>

</PRE>

poi.db format/schema? 

example poi.db with one poi entry 
http://we.trekbeyond.org/~kd8ikt/moko/poi.db tangogps raw sqlite poi.db
 CSV dump
<PRE>

kd8ikt@kd8ikt:~/mokoloco$ cat poidb.cvs
"idmd5","lat","lon","visibility","cat","subcat","keywords","desc","price_range","extended_open","creator","bookmarked","user_rating","rating","user_comment"
"109496141722186324","39.283409","-84.317535","0.0","14.0","0.0","home","home duh","3.0","0.0","","","","",""

</PRE>

conclusion 
i'm looking into python for importing/parsing the lat lon name and desc inside each waypoint heading then export those into the tangogps sqlite poi.db

 GPSBABEL?

 
Progress 
<PRE>

#!/usr/bin/env python
#
# NaviCacheGPX2TangogpsPOIdb.py
#
# licensing stuff yada yada
#
#kd8ikt

import sys

from xml.dom import minidom
xmldoc = minidom.parse('gpx.gpx') #ugh wrong its hardcoded

if len(sys.argv) <3:
print "usage:"
print "INCOMPLETE"
print "NaviCacheGPX2TangogpsPOIdb.py poi.db navicache.gpx"
sys.exit(1)

</PRE>

== batch processing tracklogs ==
is there anyway to batch process a folder with convert2gpx? manually running it on 40 some odd traces is a pain.--[[User:Jerjozwik|Jerjozwik]] 20:23, 2 May 2009 (UTC)

<pre>
for file in *.log; do convert2gpx $file > `basename $file .log`.gpx; done
</pre>
--[[User:Blat|blat]] 06:18, 4 May 2009 (UTC)

TangoGPS

2009-02-12T17:22:42Z

Blat: added OpenStreetBugs, reordered topics

{{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 install gpsd
</pre>
{{note|I experienced hangups if gpsd was not installed.}}
<pre>opkg install http://www.tangogps.org/downloads/tangogps_0.9.3-r1_armv4t.ipk</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]] ===

tangoGPS is a very nice GPS mapping application. 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. To install tangogps run

# apt-get install fso-gpsd tangogps

To turn the gps on, you have two options.
You can start the gps application in [[Zhone]], this will turn on the gps device for you or you 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

Now you should be able to start tangoGPS from the X-mouse start menu (must have XFCE installed) :
Start > other > GPS & Map

'''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, in /media/card/osm.

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.

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!

== 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. 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.

== Add POI from address ==

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

== 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&zoom=%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.

<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]]

User:Blat/Debian

2008-12-26T13:12:28Z

Blat: outdated

Biking

2008-10-18T16:14:15Z

Blat: link to Zzing

The collection of information useful for biking with a Neo.

== Bike Mounts ==

* André Gaul [http://andre.web-yard.de/blog/2008/08/03/neo-freerunner-rocks-hard-rides-free/ documented a complete mounting kit]
* It's just a prototype :) but with some foam around the handlebar and careful positioning to avoid bumps, a [http://www.xmission.com/~bmidgley/neobike.jpg basic attachment] like this might work and makes it easy to "pinch" the screen when you need to finger tap something.
* [http://www.rabenfrost.net/openmoko/bikemount/ Images of an interesting bike mount]
* Another mount: [http://comiles.eu/~natanael/wordpress/2008/09/10/fahrradhalterung-fur-den-freerunner/ Description/Parts list (in German)] and [http://comiles.eu/~natanael/wordpress/2008/09/10/bilder-vom-fahrrad-freerunner/ Pictures]
* And [http://blog.printf.net/articles/2008/08/11/an-openmoko-bike-ride another one] "which I don't recommend very highly; I've had the phone come off it (without major damage, which is good) twice now while riding over rough road."

== Power Supply ==
If you want to keep the GPS running and have the screen always on or staying on with a long timeout, you'll need a way to supplement power.

=== Charging via hub ===
Connecting a hub ([http://nabendynamo.de/ Nabendynamo]) like the [http://www.peterwhitecycles.com/schmidt.asp SON] to a self-made or prebuilt charger can supply your device while biking.

The FreeRunner has three different [[Forcing_fast_charge_mode|charging modes]]: 100mA, 500mA and 1A. 100mA seems to be too low, as it is said, that the FreeRunner draws 100mA current even when it is switched off. A hub dynamo provides 500mA. If you want to use your lights while charging you need to connect the lights in series to the charger. At least the SON will increase the voltage and still delivers the same current. But you need a bypass circuit in case of less current draw of the charger when the battery is full.

==== Commercial Chargers ====
* [[Zzing]]
* [http://www.jawetec.de/index.php?content=bikecharger&framing=radsport JaWeTec Bike Charger]
* There is a prototype of a hub featuring built-in USB-out which will hopefully be ready for mass market soon.

==== self-made chargers ====
* [http://www.heise.de/kiosk/archiv/ct/07/23/190 Article (German) in c't 23/2007, page 190]
* maybe 6V [http://www.forumslader.de/6V-Version-des-Rad-Forum-Ladegeraets.125.0.html Forumslader] (You need at least one diode in series to be within the maximum ratings of the power managment IC and the FET switches in FreeRunner.)
* [http://www.iki.fi/~msmakela/electronics/dynamo5v/ Makela]

Linear regulator above might be replaced by [http://www.dimensionengineering.com/DE-SW050.htm DE-SW050].

=== Alternatives ===
If you decide to try solar, it's recommended to get a flexible panel and attach it to your backpack or something like that. One nice advantage here is it might also charge even when you're not moving. It's unlikely anything below 7 watts will keep things running. (5v * 1A = 5W).

It might work with an dynamo outside the hub like the one on the [http://www.reelight.com reelight], but it looks like their coil produces only 3vAC so it makes sense to use a custom coil.

== Software for biking ==

* [[TangoGPS]] + [http://blogs.thehumanjourney.net/finds/entry/20080826 OSM Cycle data]
* [[Navit]]
* [http://wiki.openstreetmap.org/index.php/Rana Rana] (uses [[Installing Pyroute|Pyroute]])
* [http://www.neo1973-germany.de/wiki/pylgrim pylgrim] bitmap map viewer. Dead.

=== See also ===
* [[GPS applications]]

== Heart Rate Monitor ==

According to [http://www.mail-archive.com/community@lists.openmoko.org/msg11248.html mailing list discussions] some heart rate monitors use [http://thisisant.com/index.php?section=5 ANT]. Due to the modern chip cases building a reliable homemade receiver seems to be difficult.

=== HRM Links ===
* [http://www.mikrocontroller.net/articles/Pulsuhrempf%C3%A4nger_mit_AVR_Butterfly German Microcontroller Wiki], Circuit diagram and DSP Simulation.

== Other Hardware ==
* [http://www.obico.de oBiCo] - An open bicycle linux computer - seems to be alive, but nothing there yet.

User:Blat/Zzing

2008-10-18T16:13:12Z

Blat: User:Blat/Zzing moved to Zzing: finished article

#REDIRECT [[Zzing]]

Zzing

2008-10-18T16:13:12Z

Blat: User:Blat/Zzing moved to Zzing: finished article

The [http://zzing.de/English_Zzing/ Zzing] is a USB charger for hub generators.
[[Image:Zzing_bike-overview.jpg|thumb|bike with hub and mounts for FR+Zzing]]
It contains 5 AA batteries and can be connected to your bike's hub and to any USB device which needs power.
By default the current model only supplies 100mA, but forcing 500mA by software worked fine. The batteries can be pre-charged at home by connecting a power supply charging at max. 300mA. Accessories like the power supply or a bike mount which looks like the one described below are available in the [http://zzing.de/New-Shop/catalog/index.php?language=en&Itemid=9 Zzing Shop].

[[Image:Zzing_bike-mounts.jpg|thumb|mount for Zzing (left) and FR (right)]]
The default set ([http://itchy-wheels.exploder.org/images/main.php?g2_itemId=3029 images of unpacking the Zzing]) contains a bike mount for the Zzing and everything else you need. The device itself feels quite heavy which is caused by the 5 AA batteries inside. The bike mount is very stable.

Connect the cable from the bike's hub to the Zzing before you start.
Never connect the cable while biking, that may destroy the device!
[[Image:Zzing_cabling.jpg|thumb|USB cable and 3.5mm power connector, LED on]]
When the internal batteries are charged, the blue LED on top is glowing. If you want to charge any USB device, attach it to the USB plug an turn on the switch on the bottom. You can see that it is turned on by the white LED on front. This can also be used as flashlight. It is always on as an indicator that your device is on. If you are not charging anything and do not need the light, switch it off!

When you are biking and charging at 100mA, your FR will slowly decharge. The internal batteries of the Zzing are still charged at this low current output. When you are charging at 500mA the internal batteries are decharged. You should charge the FR only up to approximately 80% because the last percents seemed to take more energy and I am not sure if there is something to avoid overcharge.
There is no way to find out how much charge is left in the Zzing.

== bike mount for the Freerunner ==
I am using a bike mount [http://www.pearl.de/a-PX2065-4044.shtml sold by PEARL] as [http://andre.web-yard.de/blog/2008/08/03/neo-freerunner-rocks-hard-rides-free/ described by André Gaul].

It is cheap, made of plastic only (even the parts to attach it to the bike, just the spring for opening is metal).

This bike mount is not buffered, I had it jump out of the lower part once on a very bumpy road. You could attach the lower part to the upper part with a cord as a backup solution. Luckily in my situation my Freerunner (and upper mount part) was still held by the USB cable.
You will have to attach it very strong in order to avoid that the whole thing is moving around on bumpy roads!

[[Image:Bike-mount_connectors.jpg|thumb|connectors are still accessible]]
I should also mention that the part which is actually holding your Freerunner is kind of soft (foamy?), but will keep it's shape made by the FR after some time. The spring to open the side holding parts is also working worse after a week or so.

Overall you get what you pay for and it is quite usable.

It is even waterproof if you put a transparent plastic bag with a zipper on top (which is available in stores here for deep-freezing food).

[[Image:Zzing_devices.jpg|thumb|view from above]]

Zzing

2008-10-18T16:12:35Z

Blat: replaced highres image by thumb

Zzing

2008-10-17T20:20:06Z

Blat: added images

File:Zzing bike-overview.jpg

2008-10-17T20:01:35Z

Blat: Photo showing bike with mounts and hub

Photo showing bike with mounts and hub

File:Zzing bike-mounts.jpg

2008-10-17T20:00:45Z

Blat: Photo showing two bike mounts

Photo showing two bike mounts

File:Bike-mount connectors.jpg

2008-10-17T19:59:39Z

Blat: Photo showing the connectors at the side of the FR while inside a bike mount

Photo showing the connectors at the side of the FR while inside a bike mount

File:Zzing devices.jpg

2008-10-17T19:58:32Z

Blat: Photo showing the FR and the Zzing mounted to the bike

Photo showing the FR and the Zzing mounted to the bike

Zzing

2008-10-17T19:57:13Z

Blat: added image

The [http://zzing.de/English_Zzing/ Zzing] is a USB charger for hub generators.
It contains 5 AA batteries and can be connected to your bike's hub and to any USB device which needs power.
By default the current model only supplies 100mA, but forcing 500mA by software worked fine. The batteries can be pre-charged at home by connecting a power supply loading at max. 300mA. Accessories like the power supply or a bike mount which looks like the one described below are available in the [http://zzing.de/New-Shop/catalog/index.php?language=en&Itemid=9 Zzing Shop].

The default set ([http://itchy-wheels.exploder.org/images/main.php?g2_itemId=3029 images of unpacking the Zzing]) contains a bike mount for the Zzing and everything else you need. The device itself feels quite heavy which is caused by the 5 AA batteries inside. The bike mount is very stable.

Connect the cable from the bike's hub to the Zzing before you start.
Never connect the cable while biking, that may destroy the device!
[[Image:Zzing_cabling.jpg|thumb|USB cable and 3.5mm power connector, LED on]]
When the internal batteries are charged, the blue LED on top is glowing. If you want to charge any USB device, attach it to the USB plug an turn on the switch on the bottom. You can see that it is turned on by the white LED on front. This can also be used as flashlight. It is always on as an indicator that your device is on. If you are not charging anything and do not need the light, switch it off!

When you are biking and charging at 100mA, your FR will slowly decharge. The internal batteries of the Zzing are still charged at this low current output. When you are charging at 500mA the internal batteries are decharged. You should charge the FR only up to approximately 80% because the last percents seemed to take more energy and I am not sure if there is something to avoid overcharge.
There is no way to find out how much charge is left in the Zzing.

== bike mount for the Freerunner ==
I am using a bike mount [http://www.pearl.de/a-PX2065-4044.shtml sold by PEARL] as [http://andre.web-yard.de/blog/2008/08/03/neo-freerunner-rocks-hard-rides-free/ described by André Gaul].

It is cheap, made of plastic only (even the parts to attach it to the bike, just the spring for opening is metal).

This bike mount is not buffered, I had it jump out of the lower part once on a very bumpy road. You could attach the lower part to the upper part with a cord as a backup solution. Luckily in my situation my Freerunner (and upper mount part) was still held by the USB cable.
You will have to attach it very strong in order to avoid that the whole thing is moving around on bumpy roads!

I should also mention that the part which is actually holding your Freerunner is kind of soft (foamy?), but will keep it's shape made by the FR after some time. The spring to open the side holding parts is also working worse after a week or so.

Overall you get what you pay for and it is quite usable.

It is even waterproof if you put a transparent plastic bag with a zipper on top (which is available in stores here for deep-freezing food).

File:Zzing cabling.jpg

2008-10-17T19:52:39Z

Blat: Photo showing the FR connected to the Zzing bike charger

Photo showing the FR connected to the Zzing bike charger

Zzing

2008-10-17T19:48:01Z

Blat:

The [http://zzing.de/English_Zzing/ Zzing] is a USB charger for hub generators.
It contains 5 AA batteries and can be connected to your bike's hub and to any USB device which needs power.
By default the current model only supplies 100mA, but forcing 500mA by software worked fine. The batteries can be pre-charged at home by connecting a power supply loading at max. 300mA. Accessories like the power supply or a bike mount which looks like the one described below are available in the [http://zzing.de/New-Shop/catalog/index.php?language=en&Itemid=9 Zzing Shop].

The default set ([http://itchy-wheels.exploder.org/images/main.php?g2_itemId=3029 images of unpacking the Zzing]) contains a bike mount for the Zzing and everything else you need. The device itself feels quite heavy which is caused by the 5 AA batteries inside. The bike mount is very stable.

Connect the cable from the bike's hub to the Zzing before you start.
Never connect the cable while biking, that may destroy the device!
When the internal batteries are charged, the blue LED on top is glowing. If you want to charge any USB device, attach it to the USB plug an turn on the switch on the bottom. You can see that it is turned on by the white LED on front. This can also be used as flashlight. It is always on as an indicator that your device is on. If you are not charging anything and do not need the light, switch it off!

When you are biking and charging at 100mA, your FR will slowly decharge. The internal batteries of the Zzing are still charged at this low current output. When you are charging at 500mA the internal batteries are decharged. You should charge the FR only up to approximately 80% because the last percents seemed to take more energy and I am not sure if there is something to avoid overcharge.
There is no way to find out how much charge is left in the Zzing.

== bike mount for the Freerunner ==
I am using a bike mount [http://www.pearl.de/a-PX2065-4044.shtml sold by PEARL] as [http://andre.web-yard.de/blog/2008/08/03/neo-freerunner-rocks-hard-rides-free/ described by André Gaul].

It is cheap, made of plastic only (even the parts to attach it to the bike, just the spring for opening is metal).

This bike mount is not buffered, I had it jump out of the lower part once on a very bumpy road. You could attach the lower part to the upper part with a cord as a backup solution. Luckily in my situation my Freerunner (and upper mount part) was still held by the USB cable.
You will have to attach it very strong in order to avoid that the whole thing is moving around on bumpy roads!

I should also mention that the part which is actually holding your Freerunner is kind of soft (foamy?), but will keep it's shape made by the FR after some time. The spring to open the side holding parts is also working worse after a week or so.

Overall you get what you pay for and it is quite usable.

It is even waterproof if you put a transparent plastic bag with a zipper on top (which is available in stores here for deep-freezing food).

Biking

2008-10-17T18:27:02Z

Blat: last cleanup

The collection of information useful for biking with a Neo.

== Bike Mounts ==

* André Gaul [http://andre.web-yard.de/blog/2008/08/03/neo-freerunner-rocks-hard-rides-free/ documented a complete mounting kit]
* It's just a prototype :) but with some foam around the handlebar and careful positioning to avoid bumps, a [http://www.xmission.com/~bmidgley/neobike.jpg basic attachment] like this might work and makes it easy to "pinch" the screen when you need to finger tap something.
* [http://www.rabenfrost.net/openmoko/bikemount/ Images of an interesting bike mount]
* Another mount: [http://comiles.eu/~natanael/wordpress/2008/09/10/fahrradhalterung-fur-den-freerunner/ Description/Parts list (in German)] and [http://comiles.eu/~natanael/wordpress/2008/09/10/bilder-vom-fahrrad-freerunner/ Pictures]
* And [http://blog.printf.net/articles/2008/08/11/an-openmoko-bike-ride another one] "which I don't recommend very highly; I've had the phone come off it (without major damage, which is good) twice now while riding over rough road."

== Power Supply ==
If you want to keep the GPS running and have the screen always on or staying on with a long timeout, you'll need a way to supplement power.

=== Charging via hub ===
Connecting a hub ([http://nabendynamo.de/ Nabendynamo]) like the [http://www.peterwhitecycles.com/schmidt.asp SON] to a self-made or prebuilt charger can supply your device while biking.

The FreeRunner has three different [[Forcing_fast_charge_mode|charging modes]]: 100mA, 500mA and 1A. 100mA seems to be too low, as it is said, that the FreeRunner draws 100mA current even when it is switched off. A hub dynamo provides 500mA. If you want to use your lights while charging you need to connect the lights in series to the charger. At least the SON will increase the voltage and still delivers the same current. But you need a bypass circuit in case of less current draw of the charger when the battery is full.

==== Commercial Chargers ====
* [http://zzing.de/English_Zzing/ Zzing]
* [http://www.jawetec.de/index.php?content=bikecharger&framing=radsport JaWeTec Bike Charger]
* There is a prototype of a hub featuring built-in USB-out which will hopefully be ready for mass market soon.

==== self-made chargers ====
* [http://www.heise.de/kiosk/archiv/ct/07/23/190 Article (German) in c't 23/2007, page 190]
* maybe 6V [http://www.forumslader.de/6V-Version-des-Rad-Forum-Ladegeraets.125.0.html Forumslader] (You need at least one diode in series to be within the maximum ratings of the power managment IC and the FET switches in FreeRunner.)
* [http://www.iki.fi/~msmakela/electronics/dynamo5v/ Makela]

Linear regulator above might be replaced by [http://www.dimensionengineering.com/DE-SW050.htm DE-SW050].

=== Alternatives ===
If you decide to try solar, it's recommended to get a flexible panel and attach it to your backpack or something like that. One nice advantage here is it might also charge even when you're not moving. It's unlikely anything below 7 watts will keep things running. (5v * 1A = 5W).

It might work with an dynamo outside the hub like the one on the [http://www.reelight.com reelight], but it looks like their coil produces only 3vAC so it makes sense to use a custom coil.

== Software for biking ==

* [[TangoGPS]] + [http://blogs.thehumanjourney.net/finds/entry/20080826 OSM Cycle data]
* [[Navit]]
* [http://wiki.openstreetmap.org/index.php/Rana Rana] (uses [[Installing Pyroute|Pyroute]])
* [http://www.neo1973-germany.de/wiki/pylgrim pylgrim] bitmap map viewer. Dead.

=== See also ===
* [[GPS applications]]

== Heart Rate Monitor ==

According to [http://www.mail-archive.com/community@lists.openmoko.org/msg11248.html mailing list discussions] some heart rate monitors use [http://thisisant.com/index.php?section=5 ANT]. Due to the modern chip cases building a reliable homemade receiver seems to be difficult.

=== HRM Links ===
* [http://www.mikrocontroller.net/articles/Pulsuhrempf%C3%A4nger_mit_AVR_Butterfly German Microcontroller Wiki], Circuit diagram and DSP Simulation.

== Other Hardware ==
* [http://www.obico.de oBiCo] - An open bicycle linux computer - seems to be alive, but nothing there yet.

Biking

2008-10-17T18:22:33Z

Blat:

The collection of information useful for biking with a Neo.

== Bike Mounts ==

* André Gaul [http://andre.web-yard.de/blog/2008/08/03/neo-freerunner-rocks-hard-rides-free/ documented a complete mounting kit]
* It's just a prototype :) but with some foam around the handlebar and careful positioning to avoid bumps, a [http://www.xmission.com/~bmidgley/neobike.jpg basic attachment] like this might work and makes it easy to "pinch" the screen when you need to finger tap something.
* [http://www.rabenfrost.net/openmoko/bikemount/ Images of an interesting bike mount]
* Another mount: [http://comiles.eu/~natanael/wordpress/2008/09/10/fahrradhalterung-fur-den-freerunner/ Description/Parts list (in German)] and [http://comiles.eu/~natanael/wordpress/2008/09/10/bilder-vom-fahrrad-freerunner/ Pictures]
* And [http://blog.printf.net/articles/2008/08/11/an-openmoko-bike-ride another one] "which I don't recommend very highly; I've had the phone come off it (without major damage, which is good) twice now while riding over rough road."

== Power Supply ==
If you want to keep the GPS running and have the screen always on or staying on with a long timeout, you'll need a way to supplement power.

=== Charging via hub ===
Connecting a hub ([http://nabendynamo.de/ Nabendynamo]) like the [http://www.peterwhitecycles.com/schmidt.asp SON] to a self-made or prebuilt charger can supply your device while biking.

The FreeRunner has three different [[Forcing_fast_charge_mode|charging modes]]: 100mA, 500mA and 1A. 100mA seems to be too low, as it is said, that the FreeRunner draws 100mA current even when it is switched off. A hub dynamo provides 500mA. If you want to use your lights while charging you need to connect the lights in series to the charger. At least the SON will increase the voltage and still delivers the same current. But you need a bypass circuit in case of less current draw of the charger when the battery is full.

==== pre-built chargers ====
* [http://zzing.de/English_Zzing/ Zzing]
* [http://www.jawetec.de/index.php?content=bikecharger&framing=radsport JaWeTec Bike Charger]

==== self-made chargers ====
* [http://www.heise.de/kiosk/archiv/ct/07/23/190 Article (German) in c't 23/2007, page 190]
* maybe 6V [http://www.forumslader.de/6V-Version-des-Rad-Forum-Ladegeraets.125.0.html Forumslader] (You need at least one diode in series to be within the maximum ratings of the power managment IC and the FET switches in FreeRunner.)
* [http://www.iki.fi/~msmakela/electronics/dynamo5v/ Makela]

Linear regulator above might be replaced by [http://www.dimensionengineering.com/DE-SW050.htm DE-SW050].

There is a prototype of a hub featuring built-in USB-out which will hopefully be ready for mass market soon.

=== Alternatives ===
If you decide to try solar, it's recommended to get a flexible panel and attach it to your backpack or something like that. One nice advantage here is it might also charge even when you're not moving. It's unlikely anything below 7 watts will keep things running. (5v * 1A = 5W).

It might work with an dynamo outside the hub like the one on the reelight [http://www.reelight.com], but it looks like their coil produces only 3vAC so it makes sense to use a custom coil.

== Software for biking ==

* [[TangoGPS]] + [http://blogs.thehumanjourney.net/finds/entry/20080826 OSM Cycle data]
* [[Navit]]
* [http://wiki.openstreetmap.org/index.php/Rana Rana] (uses [[Installing Pyroute|Pyroute]])
* [http://www.neo1973-germany.de/wiki/pylgrim pylgrim] bitmap map viewer. Dead.

=== See also ===
* [[GPS applications]]

== Heart Rate Monitor ==

According to [http://www.mail-archive.com/community@lists.openmoko.org/msg11248.html mailing list discussions] some heart rate monitors use [http://thisisant.com/index.php?section=5 ANT]. Due to the modern chip cases building a reliable homemade receiver seems to be difficult.

=== HRM Links ===
* http://www.mikrocontroller.net/articles/Pulsuhrempf%C3%A4nger_mit_AVR_Butterfly German Microcontroller Wiki. Circuit diagram and DSP Simulation.

== Other Hardware ==
* [http://www.obico.de oBiCo] - An open bicycle linux computer - seems to be alive, but nothing there yet.

Biking

2008-10-17T18:14:04Z

Blat: cleaning up

The collection of information useful for biking with a Neo.

== Bike Mounts ==

* André Gaul documented a complete mounting kit [http://andre.web-yard.de/blog/2008/08/03/neo-freerunner-rocks-hard-rides-free/]
* It's just a prototype :) but with some foam around the handlebar and careful positioning to avoid bumps, a basic attachment like this might work [http://www.xmission.com/~bmidgley/neobike.jpg] and makes it easy to "pinch" the screen when you need to finger tap something.
* [http://www.rabenfrost.net/openmoko/bikemount/ Images of an interesting bike mount]
* Another mount: [http://comiles.eu/~natanael/wordpress/2008/09/10/fahrradhalterung-fur-den-freerunner/ Description/Parts list (in German)] and [http://comiles.eu/~natanael/wordpress/2008/09/10/bilder-vom-fahrrad-freerunner/ Pictures]
* And another one [http://blog.printf.net/articles/2008/08/11/an-openmoko-bike-ride] "which I don't recommend very highly; I've had the phone come off it (without major damage, which is good) twice now while riding over rough road."

== Power Supply ==
If you want to keep the GPS running and have the screen always on or staying on with a long timeout, you'll need a way to supplement power.

=== Charging via hub ===
Connecting a hub ("Nabendynamo" [http://nabendynamo.de/]) like the SON [http://www.peterwhitecycles.com/schmidt.asp] to a self-made or prebuilt charger could supply your device while biking.

The FreeRunner has three different [[Forcing_fast_charge_mode|charging modes]]: 100mA, 500mA and 1A. 100mA seems to be too low, as it is said, that the FreeRunner draws 100mA current even when it is switched off. A hub dynamo provides 500mA. If you want to use your lights while charging you need to connect the lights in series to the charger. At least the SON will increase the voltage and still delivers the same current. But you need a bypass circuit in case of less current draw of the charger when the battery is full.

==== pre-built chargers ====
* [http://zzing.de/English_Zzing/ Zzing]
* [http://www.jawetec.de/index.php?content=bikecharger&framing=radsport JaWeTec Bike Charger]

==== self-made chargers ====
* [http://www.heise.de/kiosk/archiv/ct/07/23/190 Article (German) in c't 23/2007, page 190]
* maybe 6V [http://www.forumslader.de/6V-Version-des-Rad-Forum-Ladegeraets.125.0.html Forumslader] (You need at least one diode in series to be within the maximum ratings of the power managment IC and the FET switches in FreeRunner.)
* Makela [http://www.iki.fi/~msmakela/electronics/dynamo5v/]

Linear regulator above might be replaced with [http://www.dimensionengineering.com/DE-SW050.htm]

There is a prototype of a hub with built-in USB-out which will hopefully be ready for mass market soon.

=== Alternatives ===
If you decide to try solar, it's recommended to get a flexible panel and attach it to your backpack or something like that. One nice advantage here is it might also charge even when you're not moving. It's unlikely anything below 7 watts will keep things running. (5v * 1A = 5W).

It might work with an dynamo outside the hub like the one on the reelight [http://www.reelight.com], but it looks like their coil produces only 3vAC so it makes sense to use a custom coil.

== Software for biking ==

* [[TangoGPS]], + [http://blogs.thehumanjourney.net/finds/entry/20080826 OSM Cycle data]
* [[Navit]]
* [http://wiki.openstreetmap.org/index.php/Rana Rana] uses [[Installing Pyroute|Pyroute]]
* [http://www.neo1973-germany.de/wiki/pylgrim pylgrim] bitmap map viewer. Dead.

== Heart Rate Monitor ==

According to [http://www.mail-archive.com/community@lists.openmoko.org/msg11248.html mailing list discussions] some heart rate monitors use [http://thisisant.com/index.php?section=5 ANT]. Due to the modern chip cases building a reliable homemade receiver seems to be difficult.

=== HRM Links ===
* http://www.mikrocontroller.net/articles/Pulsuhrempf%C3%A4nger_mit_AVR_Butterfly German Microcontroller Wiki. Circuit diagram and DSP Simulation.

== See also ==
* [[GPS applications]]

== External links ==
* [http://www.obico.de oBiCo] - An open bicycle linux computer - seems to be alive, but nothing there yet.

Zzing

2008-10-17T18:00:45Z

Blat: bike mount description

[http://itchy-wheels.exploder.org/images/main.php?g2_itemId=3029 images of unpacking the Zzing]

== bike mount for the Freerunner ==
I am using a bike mount [http://www.pearl.de/a-PX2065-4044.shtml sold by PEARL] as [http://andre.web-yard.de/blog/2008/08/03/neo-freerunner-rocks-hard-rides-free/ described by André Gaul].

It is cheap, made of plastic only (even the parts to attach it to the bike, just the spring for opening is metal).

This bike mount is not buffered, I had it jump out of the lower part once on a very bumpy road. You could attach the lower part to the upper part with a cord as a backup solution. Luckily in my situation my Freerunner (and upper mount part) was still held by the USB cable.
You will have to attach it very strong in order to avoid that the whole thing is moving around on bumpy roads!

I should also mention that the part which is actually holding your Freerunner is kind of soft (foamy?), but will keep it's shape made by the FR after some time. The spring to open the side holding parts is also working worse after a week or so.

Overall you get what you pay for and it is quite usable.

It is even waterproof if you put a transparent plastic bag with a zipper on top (which is available in stores here for deep-freezing food).

User:Blat/Debian

2008-10-02T15:05:26Z

Blat: matchbox-keyboard-toggle missing?

[[Sephora]]

== useful packages ==
* [http://www.ohli.de/download/openmoko-panel-plugin_0.1-1_all.deb Panel plugin] (battery, wifi, bt, gps)
* [http://www.ohli.de/download/xserver-xorg-input-tslib_0.0.5-1+fso1_armel.deb right click]
Option "EmulateRightButton" "1"

== matchbox-keyboard-toggle missing? ==
apt-get install matchbox-window-manager matchbox-keyboard
wget http://pkg-fso.alioth.debian.org/freerunner/matchbox-keyboard-toggle.gismo -O /usr/bin/matchbox-keyboard-toggle
chmod +x /usr/bin/matchbox-keyboard-toggle

Zzing

2008-09-25T14:14:31Z

Blat: New page: http://itchy-wheels.exploder.org/images/main.php?g2_itemId=3029 images of unpacking the Zzing

[[http://itchy-wheels.exploder.org/images/main.php?g2_itemId=3029 images of unpacking the Zzing]]

User:Blat/Debian

2008-09-25T13:55:15Z

Blat:

User:Blat

2008-09-25T11:07:09Z

Blat: New page: * /Debian

* [[/Debian]]

User:Blat/Debian

2008-09-25T11:06:18Z

Blat: New page: == useful packages == * [http://www.ohli.de/download/openmoko-panel-plugin_0.1-1_all.deb Panel plugin] (battery, wifi, bt, gps) * [http://www.ohli.de/download/xserver-xorg-input-tslib_0.0....

== useful packages ==
* [http://www.ohli.de/download/openmoko-panel-plugin_0.1-1_all.deb Panel plugin] (battery, wifi, bt, gps)
* [http://www.ohli.de/download/xserver-xorg-input-tslib_0.0.5-1+fso1_armel.deb right click]
Option "EmulateRightButton" "1"

Debian

2008-09-22T19:01:21Z

Blat: howto run X apps on your desktop

= Installation =
There are "official" instructions on how to install [http://wiki.debian.org/DebianOnFreeRunner Debian on FreeRunner] or [http://wiki.debian.org/DebianOnNeo1973 Debian on Neo1973] (see the [http://lists.linuxtogo.org/pipermail/smartphones-standards/2008-August/000232.html original announcement]).

Previous information (partly outdated, now) on how to install Debian manually has been moved to [[Manual Debian]].

See also : http://www.debian.org/ to know more about Debian.

= System =
== Password ==

The default root password is blank. You should change that as soon as you can:
# passwd
If entering a blank password does not work at first, try rebooting. If still no success, boot to 2008.08/2007.02, chroot to the micro SD card and set a new password.

== Speeding up booting ==
'''Note''': By default, Debian is already configured to write limited messages to the console during boot. Does this actually speed things up anymore?

What's good for every linux booting is also good for our debian on the freerunner: booting in quiet mode. To do so by default just boot your Neo FreeRunner in NOR-Flash and execute this configure-script: [http://paste.ubuntuusers.de/391456/ configure-uboot.sh].

It changes default booting to quiet-mode and adds another boot-option to boot without quiet-mode for debugging purpose.

== Suspend ==

'''Note''': As of Sep. 15 2008, suspend works 'out-of-the-box'; installing apm and the idle clock configuration changes do not seem to be necessary any more. Press the power button for two seconds or run 'apm -s' to suspend.

To make suspend available you have to install apmd:
apt-get install apmd
After that you can suspend your phone with:
apm -s
and make it wake up again with pressing the power button.

Issues:
* [[User:Wuth|Wuth]] 06:28, 17 August 2008 (UTC): I found that apmd was already installed by using the official debian installation procedure, but that the kernel didn't support apm. I haven't yet resolved this issue. [[User:Wuth|Wuth]] 05:31, 7 September 2008 (UTC): Worked fine on second install. Perhaps this is no longer a problem.

* [[User:Phyce|Phyce]] 21:33, 20 August 2008 (UTC) installed apm without problems; apm -s shutdowns the freerunner but I couldn't wake it up with power button... I had to remove the battery to boot again. suspend/resume was working quite reliably with latest kernels on ASU.

To wake up successfully, the idle-clock of the SD card needs to be enabled right before suspend. It can be disabled again right after resume (this reduces GPS interference). Write into /etc/apm/suspend.d/00sd_idleclk
#!/bin/sh
echo 1 > /sys/module/glamo_mci/parameters/sd_idleclk
touch /home/root/.profile
and into /etc/apm/resume.d/00sd_idleclk
#!/bin/sh
echo 0 > /sys/module/glamo_mci/parameters/sd_idleclk
These are from -stacy on the community list.

And anotherone from [[User:Morlac|Morlac]]: (more debianish i think ;) 
etc/apm/scripts.d/sd_idleclk and corresponding link in /etc/apm/event.d 
(don't forget to chmod +x /etc/apm/scripts.d/sd_idleclk)

#!/bin/sh
SD_IDLECLK="/sys/module/glamo_mci/parameters/sd_idleclk"
[ -e "${SD_IDLECLK}" ] || exit 0

case "${1},${2}" in
(suspend,*)
echo 1 > ${SD_IDLECLK}
touch /etc
;;
(resume,suspend)
echo 0 > ${SD_IDLECLK}
;;
esac

exit 0

== Time ==

The default time zone is UTC. Reconfigure it by running

# dpkg-reconfigure tzdata

To set the clock manually do something like

# date -s 00:33

If you have a network connection, do something like

# apt-get install ntpdate
# ntpdate-debian

Issues:
* That's probably not sufficient to keep the clock accurate. It might be worth configuring some form of NTP.
** Setting the clock could be done via GPS: [[Getting_GPS_console_output_with_gllin#GPRMC_message]]

== WLAN ==

=== Installing prerequisites ===

Make sure the following packages are installed
apt-get install wireless-tools wpasupplicant dhcp3-client

=== Example configurations ===

==== Single network configuration ====

Assuming your wireless router uses WPA security and DHCP,
edit <code>/etc/network/interfaces</code> to include a section like this:
<pre>
auto eth0
iface eth0 inet dhcp
wpa-driver wext
wpa-ssid "MyWirelessName"
wpa-psk "MyWirelessPassword"
</pre>
Where, of course, you're using the name of your wireless network and it's password
instead of ''MyWirelessName'' and ''MyWirelessPassword''.

You can test by running
# ifup eth0

You can determine your IP address by running
# ifconfig eth0

Issues:
* only works if in presence of wireless network on boot, or when manually running <code>ifup eth0</code>
* booting away from wireless network is slower because waits for DHCP to time out
* does not reestablish connection when leaving wireless area and then returning
* does not support multiple wireless networks or open hotspots that you may travel between

Once wpa_supplicant has begun managing your wifi interface, you should type "wpa_action eth0 stop" instead of "ifdown eth0".

==== Roaming configuration ====

'''Todo''': Which of the issues that single network configurations suffer from are addressed by WPA roaming mode? Would ifplugd / guessnet help, or just make things more complicated?

* Roaming from network to network is not automatic. Instead, you need to manually run "wpa_action eth0 stop; ifup eth0" to switch networks

===== wpa_supplicant.conf =====

To configure WPA to roam between wireless networks, you will need to create a new configuration file:

/etc/wpa_supplicant/wpa_supplicant.conf

a template for this file (and more documentation) is available in:

/usr/share/doc/wpasupplicant/examples/wpa-roam.conf

You'll need to add networks to this file. Examples:

WEP:

network={
ssid="MySSID"
key_mgmt=NONE
wep_key0="abcdefghijklm"
# wep_key0=6162636465 # <- no quotes, so hex number
wep_tx_keyidx=0
id_str="MySSID"
}

No key:

network={
ssid="SomeNetwork"
key_mgmt=NONE
}

WPA:

network={
ssid="Example WPA Network"
psk="mysecretpassphrase"
id_str="home"
}

===== /etc/network/interfaces =====

Next, you'll need to edit /etc/network/interfaces. This lets you configure your wireless networks to use dhcp, or other appropriate TCP/IP settings:

auto eth0
iface eth0 inet manual
wpa-driver wext
wpa-roam /etc/wpa_supplicant/wpa_supplicant.conf

# MySSID comes from an id_str above.
iface MySSID inet dhcp

# default is what's used if there is no id_str setting.
# so the 'SomeNetwork' network will use DHCP.
iface default inet dhcp

iface home inet static
# static interface settings, or whatever...

Finally, if you want attempts to access the internet to default to eth0 (and not usb0), then comment out this line under usb0 adapter configuration:

gateway 192.168.0.200

For some reason, I had to reboot for the id_str settings to take effect. However, you should now be able to use "ifup eth0" to associate with the access point and "wpa_action eth0 stop" to down the wifi adapter.

=== Further reading ===

To use all the possibilities of <code>wpasupplicant</code> like roaming and automatic connection to different networks,
you should read <code>/usr/share/doc/wpasupplicant/README.Debian.gz</code>

== Bluetooth ==

The FreeRunner uses the standard Linux bluez stack, installed with
# apt-get install bluez-utils

There is also a module missing from /etc/modules, which is critical to getting your device recognized. (kudos to johnsu01 on irc.freenode.net:#openmoko-debian for the find)
# echo ohci-hcd >> /etc/modules

The first time you try this, you can also
# modprobe ohci-hcd

The only atypical part of using bluetooth on the FreeRunner is turning it on, which can be done with
# echo 1 > /sys/bus/platform/devices/neo1973-pm-bt.0/power_on
# echo 0 > /sys/bus/platform/devices/neo1973-pm-bt.0/reset

Then the device should be visible using
# hcitool dev

== Running X as normal user ==

First you need to create a user
<pre>
# useradd -m -G audio,dialout,floppy,video username
# passwd username
</pre>
Then you need to stop zhone-session and disable it on boot
<pre>
# /etc/init.d/zhone-session stop
# update-rc.d -f zhone-session remove
</pre>

Now you need to setup autologin and startup of X for the user you created. There are several ways of doing this, one
method is using <code>rungetty</code>
<pre>
# apt-get install rungetty
# cp /usr/bin/zhone-session ~username/.xinitrc
# chown username. ~username/.xinitrc /tmp/zhone.log
</pre>
Then edit <code>/etc/inittab</code> and change
1:2345:respawn:/sbin/getty 38400 tty1
to
1:2345:respawn:/sbin/rungetty -u username -g username tty1 /usr/bin/xinit /etc/X11/Xsession /home/username/.xinitrc
To activate the change and start up X
<pre>
# init q
# pkill getty
</pre>
The above hack works, but you lose the ability to put FR in suspend mode by pressing power button for 2secs. I think the better way is using this [http://git.debian.org/?p=pkg-fso/zhone-session.git;a=blob;f=zhone-session.init;h=402d2f8d063fc4797967eefe5433d2a3932927dd;hb=78ecbe5f763ded6345d96dde9b01941415c1e357 zhone-session scripts] and change USER=root to USER=username in it, then install sudo package, put username in sudo group and uncomment the line "%sudo ALL=NOPASSWD: ALL" in /etc/sudoers. Finally change the the line os.system( "apm -s" ) in /usr/bin/zhone to os.system( "sudo apm -s" ).

== Sound ==
Make sure to put your user in the audio group ("adduser <username> audio").

If there is no error but no sound, try these state files:
[[Talk:Manual_Debian#Sound]]

== How to replace the default kernel with a recent openmoko kernel ==

If you would like to update to a new kernel, here is a short summary of what to do to update the kernel to an actual OM kernel. But only do this if you know what you are doing.
At the moment there is a little problem in the question which kernel to use. Hopefully it will be solved in the near future.

The original openmoko kernel works fine except for the fact that suspending with zhone doesn't work. But this kernel supports different really nice usb gadgets. :) 
download stable: http://downloads.openmoko.org/releases/Om2008.8-update/ 
download testing: http://downloads.openmoko.org/daily/

The new FSO3 kernel works fine and suspend/resume with zhone is also possible. But this kernel still has no loadable usb gadget modules (17-Sep-2008 01:39). :/ 
download testing: http://downloads.freesmartphone.org/fso-testing/images/ 
download unstable: http://downloads.freesmartphone.org/fso-unstable/images/

# Download a recent'' kernel'' and ''rootfs'' (tar.gz) from one of the above mentioned sources. It's your decision if you want suspend or usb gadget modules at the moment.
# Backup your running kernel like <code>mv /boot/uImage.bin /boot/uImage.bin.old</code>, then copy the downloaded uImage file to the freerunner as <tt>/boot/uImage.bin</tt>.
# Backup your actual modules like <code>mv /lib/modules/2.6.24 /lib/modules/2.6.24.old</code>, then extract the downloaded rootfs tar.gz to a temporary directory and copy <tt>lib/modules/2.6.24</tt> from the temp directory to <tt>/lib/modules/2.6.24</tt> on the FreeRunner.
# Run a <code>depmod -a</code>.
# Do a <code>chown -R root.root /lib/modules/2.6.24</code> because the owner from the tar.gz is something else.
# This step is only needed for the OM kernel but it doesn't harm the FSO kernel setup. Add "g_ether" Module to /etc/modules like <code>echo g_ether >> /etc/modules</code>. I read in an email, that the module "ohci-hcd" is also needed for some bluetooth functions, but i don't know this for real. I inserted it to my modules file to be on the safe side.
# Reboot and hope everything works as expected. :)

= Software =
You can install <tt>[http://packages.debian.org/search?keywords=dselect dselect]</tt>(~2.2MB) or <tt>[http://packages.debian.org/search?keywords=aptitude aptitude]</tt>(~12MB) to visually inspect the available debian packages using the desktop's console. 
Also the gtk-based package-manager <tt>[http://packages.debian.org/search?keywords=synaptic synaptic]</tt>(~15.7MB) is probably working. 
Finally, on constrained systems, just issue the command:
grep -e Package: -e Description /var/lib/dpkg/available|more
== Web Browser ==
[http://lists.openmoko.org/nabble.html#nabble-td781547 Arne Anka suggested] trying the light-weight webkit-based [http://en.wikipedia.org/wiki/Midori_(browser) midori] browser:
apt-get install midori

== TangoGPS ==
{{main|TangoGPS}}
== e-book reader ==
{{main|FBReader}}

== XFCE ==

xfce is small and lightweight and so is quite fast for the FreeRunner.

apt-get install xfce4
cp /etc/init.d/zhone-session /etc/init.d/xfce

Then you may hack /etc/init.d/xfce making

PROG_FSO=/usr/bin/startxfce4

Customize the boot process (this may have to be redone when zhone-session is updated):

update-rc.d -f zhone-session remove
update-rc.d -f xfce defaults

edit your /etc/hosts to have :

127.0.0.1 localhost debian-gta02

Start XFCE !

/etc/init.d/zhone-session stop
/etc/init.d/xfce start

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 :

Option "Rotate" "CCW"

and then (re)start xfce.

=== 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:

apt-get remove xfwm4

then arrange to run the following commands at X startup. If you followed the instructions above to run X as a normal user, put this in ~/.xinitrc:

#!/bin/sh

zhone &
matchbox-keyboard-toggle &
exec matchbox-window-manager -use_titlebar no -use_cursor no &
xfce4-session

= Miscellaneous =
== Making the cursor invisible ==

=== Using matchbox ===

Matchbox has an option, <code>use_cursor</code>, that can be used to control whether to show the cursor.
For the default setup, edit <code>/usr/bin/zhone-session</code> and change the matchbox command to
matchbox-window-manager -use_titlebar no -use_cursor no

=== Using unclutter ===

Unclutter is a program that hides the cursor after a period of inactivity. To use unclutter, install it
#apt-get install unclutter
and choose ''Yes'' to the question <code>Start unclutter automatically?</code>. To change settings edit
<code>/etc/default/unclutter</code>.

=== Changing the cursor ===
To make the cursor invisible create a file called empty.cursor with this content:
#define empty.cursor_width 16
#define empty.cursor_height 16
static unsigned char empty.cursor_bits[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
Now you can execute:
xsetroot -cursor empty.cursor empty.cursor
and the cursor will be invisible. To make this permanent you have to invent something ;) It must be executed after zhone has finished starting up.

== Running X applications on your desktop in nested X server ==
Sometimes it is helpful to have a big screen, keyboard and mouse. You can run X applications in a nested X server window.
On your desktop install the nested X server application Xephyr (better that Xnest)
apt-get install xserver-xephyr
Run a nested X server as display :1
Xephyr :1 -ac -br -screen 480x640 -reset -terminate &
Now you are able to run apps on your Neo which will display on your desktop PC. Make sure to set the display, for example if "mydesktop" is your desktop hostname
DISPLAY=mydesktop:1 xfce4-session &

== Using the mouse and keyboard from your desktop on the OM device ==
If you are running Linux (or a similar xorg capable operating system) on your Desktop, you can export your xsession to the openmoko device and use your mouse and keyboard on the Neo screen. A little program called x2x makes it even possible to do this simultaneously on the fly. When activated you just move your mouse to the edge of your monitor and then the mouse cursor continues on the screen of your openmoko device. If you select a window on the OM, the input of your keyboard is automatically entered in that window. You can even use the clipboard to copy data from tour desktop to OM and in the reverse direction.

Configure your desktop computer to export your xsession:
On your desktop (with root permissions):
Make sure that sshd is installed and in /etc/ssh/sshd_config you have set
X11Forwarding yes

In K/Ubuntu sshd is in the package openssh-server.

On your OM device install x2x (with root permissions)
apt-get install xauth x2x
Now open a new X terminal on your desktop computer. You MUST be the same user that is running the xsession on your desktop (i.e. do not su to root or another user in your x terminal!). Use the same username that is running an xsession on your OM device. Assuming that you have a usb networking connection to OM (with standard configuration) on the user prompt of your desktop type:
user@desktop:~$ ssh -X openmoko@192.168.0.202 "/usr/bin/x2x -east -to :0.0"
Hit return and enter your password. The xterm window will be unresponsive after that, but keep it open until you disconnect your OM device.

Now move your mouse cursor across the right edge of your monitor. It should enter the screen of your OM device from the left. Of course you can also use -west, -north or -south, depending on your preference where you place your OM.

If computer says:
sh: /usr/X11R6/bin/xauth: No such file or directory
X11 connection rejected because of wrong authentication.
x2x - error: can not open display localhost:11.0

It means you haven't installed xauth on your OM. So on your OM (with root permissions)
apt-get install xauth

= Support =

Debian is supported on the linux to go
[http://lists.linuxtogo.org/cgi-bin/mailman/listinfo/smartphones-userland smartphone mailing list]

= Known Issues =

TBA

= Why use debian =

The point of debian on the freerunner is that you get a huge army of software in a repository, all compiled for the arm processor.

Debian is used on many other embedded devices too and so there's a much larger repository of software already available than in the 2008.8 opkg archives.

You can build your own things without need to play with openembedded.

For example compiling natively is a snap w/ debian, just apt-get gcc&libc-dev (on gentoo too) and not so easy w/ om images :) (borked compiler, borked headers).

[[Category:Debian]]

FSO ringtones

2008-08-21T19:23:23Z

Blat:

{{FSO}}

The ringtone in milestone 2 is stored here:

/usr/share/sounds/Arkanoid_PSID.sid

Now to change it is a little bit of fun.

first change directory to

/usr/lib/python2.5/site-packages/framework/subsystems/oeventd/

and open the file receiver.py

#this will be /var/lib/python-support/python2.5/framework/subsystems/oeventd/receiver.py if you are using FSO under Debian

Change the line that reads:

decoder = gst.element_factory_make( "siddec", "decoder" )

to

decoder = gst.element_factory_make( "mad", "decoder" )

and change the line that reads:

filesrc.set_property( "location", "/usr/share/sounds/Arkanoid_PSID.sid" )

to

filesrc.set_property( "location", "/usr/share/sounds/ringtone" )

Then

mv receiver.pyo /home/root
#receiver.pyo will be receiver.pyc in FSO under Debian

python
>>> import py_compile
>>> py_compile.compile("receiver.py")
>>> quit()
#You may not have the py_compile module. You can install them like this:
opkg install python-compile

/etc/init.d/fso-frameworkd restart && /etc/init.d/zhone-session stop && sleep 2 && /etc/init.d/zhone-session start
#I've only run the above restart commands in Debian so I'm not sure if they are the same in the default FSO image
#the default zhone-session file doesn't have a working restart command, hence the stop->sleep 2->start

Now you can link /usr/share/sounds/ringtone to any mp3 and that will be your ringtone

[[Category:Add-on data]]

Biking

2008-08-16T19:10:33Z

Blat: added bike chargers

The collection of information useful for biking with a Neo

== Secure it to the bike ==

André Gaul documented a complete mounting kit [http://andre.web-yard.de/blog/2008/08/03/neo-freerunner-rocks-hard-rides-free/]

It's just a prototype :) but with some foam around the handlebar and careful positioning to avoid bumps, a basic attachment like this might work [http://www.xmission.com/~bmidgley/neobike.jpg] and makes it easy to "pinch" the screen when you need to finger tap something.

== Crank up the charge ==

If you want to keep the GPS running and have the screen always on or staying on with a long timeout, you'll need a way to supplement power.

If you decide to try solar, it's recommended to get a flexible panel and attach it to your backback or something like that. It's unlikely anything below 10 watts will keep things running. (todo: add some data points). One nice advantage here is it might also charge even when you're not moving.

The alternative is to steal energy from the crank. You can do this with a hub dynamo or possibly with an induction generator like the one on the reelight [http://www.reelight.com] (warning... overuse of flash)

The regulator will have to be a do-it-yourself project regardless of the power source. See [http://www.iki.fi/~msmakela/electronics/dynamo5v/] for one approach. If you do want to try this with a switching regulator, there's a nice little pre-built module in the form factor of a linear regulator that should pop right in: [http://www.dimensionengineering.com/DE-SW050.htm]

== Charging via hub ==
Connecting a hub ("Nabendynamo" [http://nabendynamo.de/]) like the SON [http://www.peterwhitecycles.com/schmidt.asp] to a self-made or prebuilt charger could supply your device while biking.

=== pre-built chargers ===
* Zzing [http://zzing.de/English_Zzing/]
* JaWeTec Bike Charger [http://www.jawetec.de/index.php?content=bikecharger&framing=radsport]

=== self-made chargers ===
* Article (German) in c't 23/2007, page 190 [http://www.heise.de/kiosk/archiv/ct/07/23/190]
* maybe 6V "Forumslader" [http://www.forumslader.de/6V-Version-des-Rad-Forum-Ladegeraets.125.0.html]

== Software for biking ==

* [[TangoGPS]]

[[Category:Technical]]