Openmoko - User contributions [en]

Battery Questions and Answers

2010-03-06T17:52:46Z

OlivierBerger: /* Special features */

NB: Some of the described behaviour depends on the kernel, the
relevant code was pushed on 2009-08-02 to andy-tracking. Some older kernel versions may have quite nasty hacks ('reenabling MBC though battery reports full') that seriously wreck your battery within months.

== Battery care and safety guidelines ==

=== How can I break my battery? ===
To successfully kill your LiIon battery without applying brute force, you simply may disobey any of the following advices:

==== Temperature ====
Never expose or let warm up battery to high temperatures. 70°C might be a limit for safe operation, and >100°C most likely is a killer for the cell. This is especially true during charge/discharge.

==== Drop ====
Never let the battery drop on a hard surface or by any other means expose to hard impact.

==== Wrong storage ====
LiIon cells don't like to be kept at any extreme for a prolonged time. So *never* store away your device with battery inserted, for a period longer than a few days. Charge battery to a reasonable level prior to extended periods of no usage.
Do not store battery in charger, as this may cause a permanent charging level of 100% which is as deteriorating to the LiIon cell chemistry as is storage at 0%. Keeping battery in Neo which is powered by external source is safe though, even for months, as the Neo's PMU charger circuit takes care to treat the battery nicely.

Also see [http://wiki.openmoko.org/wiki/Battery_Questions_and_Answers#I_have_several_compatible_batteries._What_are_the_storage_requirements_for_them.3F Storage]

== Hardware capabilities ==

=== What batteries can be used with gta01 and gta02? ===
Original OM gta01, [[Neo FreeRunner Battery|gta02]], Nokia [http://europe.nokia.com/find-products/accessories/all-accessories/power/batteries/nokia-battery-bl-5c BL-5C], [http://europe.nokia.com/find-products/accessories/all-accessories/power/batteries/nokia-battery-bl-6c BL-6C] and compatibles.

=== Do other BL-5/6C compatible batteries fit? ===
If the battery is thicker than BL-6C, you won't be able to close
the back cover. Nokia's BL-4C is a bit thinner than the BL-5C so it also fits, but has noticeably shorter battery life.

=== What is the difference between all those types? ===

==== Capacity ====
{|border="1" cellspacing="0" cellpadding="5"
| gta01, gta02 || 1200 mAh
|-
| BL-4C old (new) || 720 (860) mAh
|-
| BL-5C old (newer/new) || 850 (970/1020) mAh
|-
| BL-6C || 1150 mAh
|}

==== Temperature control ====
{|border="1" cellspacing="0" cellpadding="5"
| gta01, BL-5C, BL-6C || thermistor
|-
| gta02 || bq27000
|}

==== Special features ====

gta02 - accurate and sophisticated reporting of capacity,
time_to_full, time_to_empty, temperature and battery current during
both charge and discharge thanks to bq27000 (aka Coloumb Counter). More details at [[Neo FreeRunner Battery]].

=== What are hardware capabilities of gta01 and gta02 with regard to battery management? ===

gta01: charging all battery types, measuring temperature with
battery-integrated thermistor (currently charging and measuring
temperature for non-gta01 batteries doesn't work due to the kernel
driver issues but it's software limitation), measuring battery output
voltage, very inaccurate and noisy measuring of battery current

gta02: charging all battery types, measuring battery output voltage,
communicating with bq27000

=== Can nokia phones use/charge gta01/gta02 batteries? ===

gta01 and gta02 batteries will fit wherever BL-6C fits but they
can't be charged in nokia phones unless you isolate the middle pin
from the battery and connect a resistor of ~50k (actual measured value
on a cold (25C) battery is 75k, on a slightly warm battery - 82k) from
it to the ground (to fake a thermistor presence).

=== Can third-party chargers charge gta01/gta02 batteries? ===

The "good" ones will most probably require the same trick needed
for nokia phones. More cheaper ones are more likely to ignore
thermistor absence.

=== I have several compatible batteries. What are the storage requirements for them? ===

Keep in a dry cool place charged to no more than 75%.

=== That bq27000 chip seems to be pretty cool, how can i read and understand its raw registers? ===

[[User:jOERG|DocScrutinizer]] to the rescue! Here's his magic script to do that: [http://people.openmoko.org/joerg/battery/bq27k-detail].

== Safety considerations in detail ==

=== Do OM devices control temperature to stop charging if the battery gets too hot? ===

GTA02 Neo FreeRunner:No; GTA01 Neo 1973:Yes (if PMU PCF50606 Main battery charger is configured correctly)

=== Isn't it dangerous? ===

No, since all batteries (not raw cells!) have an integrated
protection circuits.

=== Can i use that fancy 2800 mAh BL-5C-compatible battery i saw on ebay? ===

Unless you want an explosion in your pocket i wouldn't recommend
using any battery that is not produced by a reputable vendor and
widely tested. And even reputable vendors make mistakes, nokia once
had to recall 46 million batteries manufactured by Matsushita ([http://batteryreplacement.nokia.com/batteryreplacement/en/advisory-2007.html]).

=== You say that BL-5C is compatible with my gta02. Does that mean i can use that BL-5C-compatible bat i bought for a buck from a bum? ===

You bet, go ahead.

== Charging ==

=== My battery charges to 100% but then charging stops and the battery keeps discharging, wtf? ===

LiIon batteries don't like to be kept fully charged, so the charger
stops as soon as charging current becomes less than threshold. If you
have GSM on it will discharge the battery.

=== But why doesn't it ever stop charging on my device? ===

The GSM modem is connected directly to the battery terminals so if
it's active, charger will think it's still charging the battery and
won't turn off unless GSM becomes inactive. The default threshold setting of PMU charger is
about 16mA, the latest [[Qi]] increases the threshold to ~32mA.

Depending on various factors (GPRS activated, number of cells to observe, band...) the modem may consume an average standby current of 4mA up to >30mA while registered to a network. For normal (AT%SLEEP=2) situation the standby current is ~15mA. So *usually* the charge end detection should work.

Anyway even if the above mentioned charge end threshold never is reached, the PMU stops charging of bat after expire of some emergency cutoff timer (some hours)

=== Does it mean if i leave my phone plugged it will eventually fully discharge the battery? ===

On gta02 the charger will restart the charge automatically once the
battery voltage reaches ~4V which corresponds to ~76% (If PMU MBC is configured by kernel to enable auto-resume). Not sure about
gta01, requires more investigation. :-/

=== Ok, how to make sure my battery is fully charged before a long trip? ===

Replug the charger at least 90 minutes before you need full battery, it will trigger charging no matter what the
current capacity is.

=== My power/aux LED indicates charging/discharging/whatever, what does that mean (aka why it's still blue even after i unplugged the charger)? ===

Ask FSO guys about it, some of them think that the user shouldn't
really know what's happening and therefore they do some special
mangling of "status" sysfs node before presenting it to the user. If
you want to make a decent bugreport please add clear steps to
reproduce and
<code>
cat /sys/class/power_supply/battery/uevent
cat /sys/class/i2c-adapter/i2c-0/0-0073/gta01_battery/uevent
</code>
contents for all
relevant states.

== Using compatible batteries with gta02 ==

=== So, how do i use "dumb" batteries with my freerunner? ===

First you need to unbind bq27000 driver:
echo bq27000-battery.0 > /sys/bus/platform/drivers/bq27000-battery/unbind

Then you load the dumb battery driver:
modprobe gta01_battery

If you need to use bq27000 driver again, do:
rmmod gta01_battery
echo bq27000-battery.0 > /sys/bus/platform/drivers/bq27000-battery/bind

If you use Enlightment you might need to restart it after that.

=== Is capacity reported for dumb batteries accurate? ===

During discharge it should be pretty (+-10%) accurate, during
charge the capacity reported is ~20% more than real.

=== Why does /sys/class/power_supply/battery/charge_full says i have a 850 mAh battery no matter what i use? ===

It's a workaround to make popular battery gadgets work with this
driver.

== This Q&A were prepared by ==

[[User:PaulFertser|Paul Fertser]]

[[User:jOERG|Joerg Reisenweber]]

[[Category:Battery]]
[[Category:Neo_FreeRunner_Hardware]]
[[Category:Neo1973_Hardware]]

Battery Questions and Answers

2010-03-06T17:51:39Z

OlivierBerger: /* What batteries can be used with gta01 and gta02? */

NB: Some of the described behaviour depends on the kernel, the
relevant code was pushed on 2009-08-02 to andy-tracking. Some older kernel versions may have quite nasty hacks ('reenabling MBC though battery reports full') that seriously wreck your battery within months.

== Battery care and safety guidelines ==

=== How can I break my battery? ===
To successfully kill your LiIon battery without applying brute force, you simply may disobey any of the following advices:

==== Temperature ====
Never expose or let warm up battery to high temperatures. 70°C might be a limit for safe operation, and >100°C most likely is a killer for the cell. This is especially true during charge/discharge.

==== Drop ====
Never let the battery drop on a hard surface or by any other means expose to hard impact.

==== Wrong storage ====
LiIon cells don't like to be kept at any extreme for a prolonged time. So *never* store away your device with battery inserted, for a period longer than a few days. Charge battery to a reasonable level prior to extended periods of no usage.
Do not store battery in charger, as this may cause a permanent charging level of 100% which is as deteriorating to the LiIon cell chemistry as is storage at 0%. Keeping battery in Neo which is powered by external source is safe though, even for months, as the Neo's PMU charger circuit takes care to treat the battery nicely.

Also see [http://wiki.openmoko.org/wiki/Battery_Questions_and_Answers#I_have_several_compatible_batteries._What_are_the_storage_requirements_for_them.3F Storage]

== Hardware capabilities ==

=== What batteries can be used with gta01 and gta02? ===
Original OM gta01, [[Neo FreeRunner Battery|gta02]], Nokia [http://europe.nokia.com/find-products/accessories/all-accessories/power/batteries/nokia-battery-bl-5c BL-5C], [http://europe.nokia.com/find-products/accessories/all-accessories/power/batteries/nokia-battery-bl-6c BL-6C] and compatibles.

=== Do other BL-5/6C compatible batteries fit? ===
If the battery is thicker than BL-6C, you won't be able to close
the back cover. Nokia's BL-4C is a bit thinner than the BL-5C so it also fits, but has noticeably shorter battery life.

=== What is the difference between all those types? ===

==== Capacity ====
{|border="1" cellspacing="0" cellpadding="5"
| gta01, gta02 || 1200 mAh
|-
| BL-4C old (new) || 720 (860) mAh
|-
| BL-5C old (newer/new) || 850 (970/1020) mAh
|-
| BL-6C || 1150 mAh
|}

==== Temperature control ====
{|border="1" cellspacing="0" cellpadding="5"
| gta01, BL-5C, BL-6C || thermistor
|-
| gta02 || bq27000
|}

==== Special features ====

gta02 - accurate and sophisticated reporting of capacity,
time_to_full, time_to_empty, temperature and battery current during
both charge and discharge thanks to bq27000 (aka Coloumb Counter)

=== What are hardware capabilities of gta01 and gta02 with regard to battery management? ===

gta01: charging all battery types, measuring temperature with
battery-integrated thermistor (currently charging and measuring
temperature for non-gta01 batteries doesn't work due to the kernel
driver issues but it's software limitation), measuring battery output
voltage, very inaccurate and noisy measuring of battery current

gta02: charging all battery types, measuring battery output voltage,
communicating with bq27000

=== Can nokia phones use/charge gta01/gta02 batteries? ===

gta01 and gta02 batteries will fit wherever BL-6C fits but they
can't be charged in nokia phones unless you isolate the middle pin
from the battery and connect a resistor of ~50k (actual measured value
on a cold (25C) battery is 75k, on a slightly warm battery - 82k) from
it to the ground (to fake a thermistor presence).

=== Can third-party chargers charge gta01/gta02 batteries? ===

The "good" ones will most probably require the same trick needed
for nokia phones. More cheaper ones are more likely to ignore
thermistor absence.

=== I have several compatible batteries. What are the storage requirements for them? ===

Keep in a dry cool place charged to no more than 75%.

=== That bq27000 chip seems to be pretty cool, how can i read and understand its raw registers? ===

[[User:jOERG|DocScrutinizer]] to the rescue! Here's his magic script to do that: [http://people.openmoko.org/joerg/battery/bq27k-detail].

== Safety considerations in detail ==

=== Do OM devices control temperature to stop charging if the battery gets too hot? ===

GTA02 Neo FreeRunner:No; GTA01 Neo 1973:Yes (if PMU PCF50606 Main battery charger is configured correctly)

=== Isn't it dangerous? ===

No, since all batteries (not raw cells!) have an integrated
protection circuits.

=== Can i use that fancy 2800 mAh BL-5C-compatible battery i saw on ebay? ===

Unless you want an explosion in your pocket i wouldn't recommend
using any battery that is not produced by a reputable vendor and
widely tested. And even reputable vendors make mistakes, nokia once
had to recall 46 million batteries manufactured by Matsushita ([http://batteryreplacement.nokia.com/batteryreplacement/en/advisory-2007.html]).

=== You say that BL-5C is compatible with my gta02. Does that mean i can use that BL-5C-compatible bat i bought for a buck from a bum? ===

You bet, go ahead.

== Charging ==

=== My battery charges to 100% but then charging stops and the battery keeps discharging, wtf? ===

LiIon batteries don't like to be kept fully charged, so the charger
stops as soon as charging current becomes less than threshold. If you
have GSM on it will discharge the battery.

=== But why doesn't it ever stop charging on my device? ===

The GSM modem is connected directly to the battery terminals so if
it's active, charger will think it's still charging the battery and
won't turn off unless GSM becomes inactive. The default threshold setting of PMU charger is
about 16mA, the latest [[Qi]] increases the threshold to ~32mA.

Depending on various factors (GPRS activated, number of cells to observe, band...) the modem may consume an average standby current of 4mA up to >30mA while registered to a network. For normal (AT%SLEEP=2) situation the standby current is ~15mA. So *usually* the charge end detection should work.

Anyway even if the above mentioned charge end threshold never is reached, the PMU stops charging of bat after expire of some emergency cutoff timer (some hours)

=== Does it mean if i leave my phone plugged it will eventually fully discharge the battery? ===

On gta02 the charger will restart the charge automatically once the
battery voltage reaches ~4V which corresponds to ~76% (If PMU MBC is configured by kernel to enable auto-resume). Not sure about
gta01, requires more investigation. :-/

=== Ok, how to make sure my battery is fully charged before a long trip? ===

Replug the charger at least 90 minutes before you need full battery, it will trigger charging no matter what the
current capacity is.

=== My power/aux LED indicates charging/discharging/whatever, what does that mean (aka why it's still blue even after i unplugged the charger)? ===

Ask FSO guys about it, some of them think that the user shouldn't
really know what's happening and therefore they do some special
mangling of "status" sysfs node before presenting it to the user. If
you want to make a decent bugreport please add clear steps to
reproduce and
<code>
cat /sys/class/power_supply/battery/uevent
cat /sys/class/i2c-adapter/i2c-0/0-0073/gta01_battery/uevent
</code>
contents for all
relevant states.

== Using compatible batteries with gta02 ==

=== So, how do i use "dumb" batteries with my freerunner? ===

First you need to unbind bq27000 driver:
echo bq27000-battery.0 > /sys/bus/platform/drivers/bq27000-battery/unbind

Then you load the dumb battery driver:
modprobe gta01_battery

If you need to use bq27000 driver again, do:
rmmod gta01_battery
echo bq27000-battery.0 > /sys/bus/platform/drivers/bq27000-battery/bind

If you use Enlightment you might need to restart it after that.

=== Is capacity reported for dumb batteries accurate? ===

During discharge it should be pretty (+-10%) accurate, during
charge the capacity reported is ~20% more than real.

=== Why does /sys/class/power_supply/battery/charge_full says i have a 850 mAh battery no matter what i use? ===

It's a workaround to make popular battery gadgets work with this
driver.

== This Q&A were prepared by ==

[[User:PaulFertser|Paul Fertser]]

[[User:jOERG|Joerg Reisenweber]]

[[Category:Battery]]
[[Category:Neo_FreeRunner_Hardware]]
[[Category:Neo1973_Hardware]]

StandbyLifetime

2010-03-06T17:47:13Z

OlivierBerger: Adding pointer to scripts

Standby lifetime test with my FreeRunner running FSO MS5.
No usage except keeping GSM listening for incoming calls and occasionally waking it up to measure.

<pre>
00h Tuesday, 03:00 100%
10h Tuesday, 13:00 85%
15h Tuesday, 18:00 78%
20h Tuesday, 23:00 71%
25h Wednesday, 04:00 64%
34h Wednesday, 13:00 51%
39h Wednesday, 18:00 44%
45h Thursday, 00:00 35%
49h Thursday, 04:00 29%
55h Thursday, 10:00 21%
60h Thursday, 15:00 13%
63h Thursday, 18:00 10%
65h Thursday, 20:00 5%
68h Thursday, 23:00 empty
</pre>

This might be measured with a script like : http://neil.brown.name/blog/20090224195326 (or http://www.olivierberger.com/weblog/index.php?post/2010/03/03/Measuring-OpenMoko-FreeRunner-battery-life-with-SHR-T if you're running SHR-T)

[[category:FSO]]

Neo FreeRunner Battery

2010-03-06T17:45:09Z

OlivierBerger: /* GTA02 1200 mAh Smart Battery */

{{Languages|Neo FreeRunner Battery}}

{{Neo FreeRunner Menu}}

For the latest information about batteries and battery compatibility please see [[Battery_Questions_and_Answers]].

=== GTA02 1200 mAh Smart Battery ===

*Internally, uses the SANYO 1200mAh cell (note that the Sanyo cell by itself does not have the Coulomb-counter and thus can not be used as a replacement for the Neo FreeRunner battery)
*Battery Technical information: [http://people.openmoko.org/tony_tu/GTA02/hardware/GTA02/CT-GTA02.pdf Detailed Battery Information]

* 1200mAh Smart Battery with Coulomb-counter and protection circuit
* The Smart Battery keeps track of maximum and current capacity for precise prediction of remaining battery power and time until shutdown, based on actual power dissipation.
* Battery could be identified with part # HF084, ... (add others)

For more information, see the GTA01 battery info at [[Neo1973 Battery]]

=== Notes about expected battery life ===
Battery life depends on your usage pattern. The maximum you can get is ~70h [[StandbyLifetime]], mostly in suspend, with multiple short wakeups.

== Known Issues ==

=== Make sure your battery never discharges completely. ===

This is an issue for older FreeRunner [[GTA02_revisions]] because the internal charging circuitry cannot be turned on until the FreeRunner has booted, and booting through USB power alone does not work on A5 and early A6 devices.
If your FreeRunner boots to the point of showing something on screen when it is connected to the OM-wallcharger or a PC's USB port with no battery installed, your device isn't affected by this issue.

Depending on NAND bootloader version there might also be a red light on AUX indicating postponed boot while charging battery to a required minimum - just keep your [[FR]] hooked up to the charger then until it boots. Or [[Booting_the_Neo_FreeRunner#Log_into_U-Boot_in_the_NOR_Flash|boot to NOR]] if it doesn't recover during some ten minutes.

==== What to do if your battery has become completely discharged ====

On more recent FreeRunners, this problem has been fixed and nothing special need be done. On older revisions, you can boot using a workaround listed
[[Neo_FreeRunner_Hardware_Issues#Can.27t_boot_with_discharged_or_missing_battery_.28FIXED.29|here]].

==== More tricks ====

A trick to get a Freerunner with a flat battery up and running which seems to work for most people is to remove the battery and the charger plug, press and hold AUX, put in the battery and then plug in the wall charger while still holding the AUX button. Suggested by joerg, confirmed to work by user [http://wiki.openmoko.org/wiki/User:Azmodie azmodie], user [http://wiki.openmoko.org/wiki/User:Jhenkins jhenkins], user [[User:Aragorn|aragorn]] (worked even without battery).

''Q: Does anyone know WHY it don't charge when it is off? My logic says that it is very important to have the option charge the battery when it is flat.''

A: I can't give you a simple answer. Charging is controlled by the PCF50633
chip, based on configuration values that are written to it by u-boot,
Linux, and userspace programs. Some of these settings are preserved
across a power-cycle (the PCF50633 has a small backup battery that's
also used to keep the RTC running) so the behavior at startup depends on
the software that you used during your last session.

Another complication is that some Freerunners (later A6) are capable of starting up
without a battery while others (A5 and early A6) are not. This was fixed during the A6 release by changing the Vsys capacitor to 100uF.

I can give a few hints:
* The current (Sep. 2nd, 2008) u-boot has a bug that means it will not properly charge from the wall charger. Try a USB cable into a PC instead.
** Feb. 2009 -- Is the preceding comment still correct? Bug number?
* Try booting through NOR u-boot instead (hold aux and then power) with both the wall charger or a 500mA USB connection, then try booting Linux.
* Try to boot into the NAND u-boot menu (hold power and then aux) and then select "power off". This may leave the device in a state were it will charge. Wait 15 minutes and then try to boot Linux.
* If the device shuts off during one of the above attempts, let it sit for a few minutes and then try that same item once again

Kudos to Mike Montour on the
[http://lists.openmoko.org/pipermail/community/2008-September/029243.html Community mailing list].

== Compatible Replacement Batteries ==

Other known FreeRunner-compatible batteries include the BL-series (BL-4X, BL-5X) from Nokia, and their third-party equivalents.
These may not work to revive a device and may not report charge information.
It is probably a good idea to check that your battery is not greater than the stock battery's voltage of 3.7V (the above suggests that 4.5VDC should be fine) unless you know what you are doing.

{| border="1" cellpadding="4" cellspacing="0"
!Battery Model
!Capacity (mAh)
!Charge info reported
!Notes
|-
|NOKIA BL-4
|
|no
|
|-
|NOKIA BL-4C
|750
|no
|Slightly thinner than original.
|-
|NOKIA BL-5B
|760/890
|
|
|-
|NOKIA BL-5C
|950
|no
|
|-
|NOKIA BL-6C
|1070
|no
|
|-
|NOKIA BR-6C
|?
|no
|
|-
|Garmin GPS 10x
|1100
|no
|
|}

Also see [[Battery_Questions_and_Answers#Hardware_capabilities|Battery FAQ]] for a more up-to-date info

== Alien Charging of Battery ==

Nokia devices (phones and stand-alone chargers) usually will not charge
non-Nokia batteries, most likely because they can't be sure they have
the correct charging parameters (and of course Nokia isn't interested in supporting use of alien batteries with their phones).

Most after-market or no-name brands of Nokia-compatible chargers don't
test the make of the battery, most likely because adding the capability
to perform this test would add to the cost of the charger and limit it's universal character (that's not the interest of second source manufacturers).

Thus:
* You can use a Nokia or Nokia-compatible BL-4C, BL-5C, or BL-6C in the Neo
* You can charge the Neo battery in a Nokia-compatible charger that is not Nokia branded
* You can NOT charge the Neo battery in a Nokia branded phone or charger

Alternatively, the Garmin GPS 10X, a Bluetooth GPS device, uses a compatible battery to the OpenMoko FreeRunner. The device can be used to charge FreeRunner batteries at 100mA, 500mA or 1A over miniUSB (including deep-discharged batteries).

For more information about USB battery chargers that can be used with the Neo FreeRunner see
{{main|USB charger}}

== DIY external battery pack from a Minty case ==

'''Mintyboost:'''

Charge from a couple of AA batteries: [http://www.ladyada.net/make/mintyboost/ Minty Boost!], [http://www.millions.ca/~stacy/mintyboost/ report on a Neo FreeRunner application].

Adding the 47k resistor to the minty boost so that the Freerunner fast charges at 1A is a poor idea for a couple reasons, the biggest one being that the minty boost can't supply 1A the max is 600mA. as far as I know, there is no magic resistor to identify a 500mA charger to the Freerunner, it depends on USB host telling it that it can provide 500mA. Second, the ID pin is in the USB micro connector, so you would either need to put a micro connector on your minty boost (with the correct resistor installed) or use a hacked cable.

Even if the Linear Technology step up voltage converter is supposed to be able to do 600mA, the AA cells seem to have a problem with supplying 500mA. They get a little toasty :-). One powerpack built using D cells doesn't seem to have any issues with supplying 500mA.

[[Category:Battery]]
[[Category:Neo FreeRunner Hardware]]

NeoTool

2009-11-20T21:45:06Z

OlivierBerger: /* Download / Releases */

NeoTool is a bash script for your desktop system to provide a friendly GUI frontend to some common management tasks, like for example flashing Openmoko smartphones. It is aimed at being very intuitive and easy to use, and flexible enough to make it useful in a wide variety of circumstances.

== Features ==

The main features of NeoTool are:
* Ability to [[Flashing the Neo Freerunner|flash]] your Neo via a GUI for the following image types:
**rootfs
**kernel
**[[Uboot]]/[[Qi]] bootloader
**splash screen
* Ability to flash multiple images at once (for example, flash rootfs and the kernel at the same time)
* Ability to backup your Neo via a GUI
* Ability to backup Multiple images at once
* rootfs can be backed up to either a flashable image or a tar archive
* most / all configuration can be done via the GUI

== Screenshots ==
[[Image:NeoTool.png|NeoTool opening screen]]

== Download / Releases ==

The most recent version of NeoTool is available for download at http://users.on.net/~antisol/neotool

When a new version is released it will be announced on the community mailing list, and on this page.

[https://bugs.launchpad.net/ubuntu/+bug/288747 Here] is the packaging request of NeoTool for '''Ubuntu'''; [http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504131 here] for '''Debian''' (which will probably not succeed).

=== openSuSE ===
[http://software.opensuse.org/ymp/home:worldcitizen/SLE_10/NeoTool.ymp 1-Click Install for SLE 10]

[http://software.opensuse.org/ymp/home:worldcitizen/SLE_11/NeoTool.ymp 1-Click Install for SLE 11]

[http://software.opensuse.org/ymp/home:worldcitizen/openSUSE_10.3/NeoTool.ymp 1-Click Install for openSuSE 10.3]

[http://software.opensuse.org/ymp/home:worldcitizen/openSUSE_11.0/NeoTool.ymp 1-Click Install for openSuSE 11.0]

[http://software.opensuse.org/ymp/home:worldcitizen/openSUSE_11.1/NeoTool.ymp 1-Click Install for openSuSE 11.1]

[http://software.opensuse.org/ymp/home:worldcitizen/openSUSE_Factory/NeoTool.ymp 1-Click Install for openSuSE Factory]

=== CentOS ===
[http://download.opensuse.org/repositories/home:/worldcitizen/CentOS_5/noarch/ Centos 5]

=== Fedora ===
[http://download.opensuse.org/repositories/home:/worldcitizen/Fedora_10/noarch/ Fedora 9]

[http://download.opensuse.org/repositories/home:/worldcitizen/Fedora_10/noarch/ Fedora 10]

=== Mandriva ===
[http://download.opensuse.org/repositories/home:/worldcitizen/Mandriva_2008/noarch/ Mandriva 2008]

[http://download.opensuse.org/repositories/home:/worldcitizen/Mandriva_2009/noarch/ Mandriva 2009]

=== RHEL ===
[http://download.opensuse.org/repositories/home:/worldcitizen/RHEL_5/noarch/ RHEL 5]

== Requirements ==

You will have to install [[dfu-util]] in order to be able to use NeoTool.

Other prerequisites for NeoTool should be installed on most modern linux systems by default:
* bash
* zenity
* which
* awk

=== Optional ===

* pipe viewer (pv), shows display while backing up rootfs

* to backup rootfs, you need to have a [[USB_Networking|USB networking]] configured and working

* mkfs-jffs2 needs to be installed on your neo to backup rootfs to a flashable image (type 'opkg install mkfs-jffs2' in ssh)

* While not a requirement, backing up rootfs is much less painful if you set up an authorized_keys entry for your host on your Neo. To do this, run 'ssh-keygen' (preferrably as root) on your host, and then copy the contents of ~/.ssh/id_rsa.pub on your host into /home/root/.ssh/authorized_keys on your freerunner

<pre>
user@host# su

root@host# ssh-keygen

root@host# scp ~/.ssh/id_rsa.pub root@<Neo IP Address>:/home/root

root@host# ssh root@<Neo IP Address>
root@om-gta02:~# cat id_rsa.pub >> /home/root/.ssh/authorized_keys

</pre>

This will prevent you from having to enter the password for your Neo when you use ssh and scp.

If you don't do this, you will need to enter your password repeatedly in order to backup rootfs.

== Usage ==

NeoTool should usually be run as root, although this is not required if you only want to backup rootfs and/or the kernel via scp.

<pre>sudo ./neotool</pre>

You will initially be presented with the main menu. Most of the functions should be relatively self-explanatory

(thorough documentation on usage goes here)

== Revision History ==

See [http://lists.openmoko.org/pipermail/community/2008-September/029731.html this thread] and [http://lists.openmoko.org/pipermail/community/2008-September/030257.html that update] for discussions on the community list.

=== 09-Sep-2008 ===

- ability to flash more than one image at once - the 'what do you wanna
flash' now has checkboxes instead of radio buttons, and all your
selections are flashed one after the other. (which i find very handy,
stops the FR powering down while you're typing the next dfu-util
command, or locating the next image - works great for flashing a new
distro & kernel). if an error occurs, subsequent files will not be flashed.

- more confirmation / idiot-proofing - it now tells you what you're
doing much more clearly (i.e: "about to flash Kernel with /foo/bar.bin,
rootfs with /foo/bar.jffs". allows you to confirm that you chose the
right images). also the 'choose file' dialogs tell you what you're
browsing for

- ability for users to press 'cancel' at the various dialogs and exit
gracefully.

- checks that dfu-util exists and is executable. I moved my dfu-util to
/usr/local/bin, so it looks there first, but it will also check the
current directory and prompt if it can't find it

- I wasn't a fan of patching dfu-util, and the pulsating zenity progress
dialog drags my (prehistoric) PC to a crawl, so I disabled the progress
bar and use the text output of dfu-util instead.

=== 12-Sep-2008 (v1.0) ===

- Utility now has the ability to flash the splash image as per request

- Utility can now also backup your device to flashable rootfs / kernel images (david might like this for building FDOM images)

- Configurification is loaded on startup and saved in /etc/frutil (you can only modify settings if you run it as root)

- more idiot proofing - uses 'which' to find dfu-util, checks to ensure it's being run as root, checks that zenity is installed on the host, checks that you have mkfs.jffs2 installed before backing up, checks that you have pv installed and acts accordingly (by either using it or not during the backup [this is not properly tested because I don't have pv, please report]), and possibly other stuff I've forgotten about.

- new name (frutil) to reflect the new abilities

=== 17-Sep-2008 (v1.1) ===

- Added ChangeLog

- Added ability to handle multiple DFU-capable devices

- Changed references to 'freerunner' to 'neo'

- name changed to NeoTool (despite implied connection with Keanu Reeves' crotch)

- Added 'Reset to defaults' option

- Added warning that flashing uboot on neo1973 may result in a paperweight

- several small bugfixes

- made backup functionality much more versatile:

- made backup filenames configurable

- Added ability to choose what to backup

- Added rootfs backup type option (jffs2 or tar)

- Added kernel backup method option (scp or dfu)

- Added ability to backup uboot and splash

=== 31-Oct-2008 (v1.2) ===
- Changed information at pre-flash prompt to include instructions for how to get to the NOR menu. eliminated any mention of NAND, as everything can be flashed from NOR.

- bugfix - when user selects a filename under 'customize backup filenames' and then presses cancel, the selected filename was set to nothing.

- NeoTool now checks that the path of backup files exist, and attempts to create it if it doesn't. This allows you to organise your backups in a folder hierarchy, i.e set the backup filename to: /data/openmoko/backups/{date}/{image}_backup and the {date} directory will be created by NeoTool, assuming /data/openmoko/backups exists and you have permission.

== Support ==

Suggestions? comments? feedback? problems?
* Are all welcome
* Email the Community list,
* or, email antisol (at) internode (dot) on (dot) net

<strike>NeoTool is perfect in every respect - if it breaks it's because you did something wrong.</strike>

[[Category:Flashing Openmoko]]
[[Category:Host OSes]]

Hall of Fame

2009-08-23T16:30:04Z

OlivierBerger: Adding category application

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

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

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

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

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

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

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

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

Applications

2009-08-23T15:48:06Z

OlivierBerger: Adding pointer to Hall of Fame

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

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

* [[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...)

== 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] DEAD LINK
* [http://www.netsurf-browser.org/ netsurf]-A new browser for Neo FreeRunner.
* {{opkg.org|205|GPRSModem}} - Converts your neo in a GPRS modem.
* [http://www.claws-mail.org/ claws-mail] email client available in shr-unstable

== 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
* [[e-tasks]] - An elementary task manager

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

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

Navit

2009-08-21T09:32:41Z

OlivierBerger: typesetting

{{Application|Navit}}

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

<i>"'''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."</i>

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===
==== FSO (OM2008.x,SHR,...) ====

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

Navit might not be able to use gpsd at startup:
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'

to solve this issue (necessary for SHR):

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

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

Add the following line to <tt>/etc/apt/sources.list</tt> with e.g. editor <tt>vi</tt> or <tt>nano</tt>:

deb http://ftp.de.debian.org/debian unstable main

Then update with apt-get:

apt-get update

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

===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. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]

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>

You can put a shell script into <tt>/usr/local/bin/update-maps</tt>
#!/bin/sh
echo "Update OpenstreetMaps"
echo "---------------------"
echo " download and store OSM maps on /media/card/maps"
wget -O /media/card/germany.bin http://maps.navit-project.org/api/map/?bbox=5.185546875,46.845703125,15.46875,55.634765625
echo "update germany.bin finished"
You have to make the script executable with:
chmod u+x /usr/local/bin/update-maps
Then you can update with this script all your maps on the SD-card if you have internet connection:
update-maps

* 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>
If you copy the map <tt>germany.bin</tt> to the SD card on the Neo use e.g.
<pre>scp germany.bin root@neo:/media/card</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 (and disable the default <mapset> just above - or else it will not work):
<pre><map type="binfile" enabled="yes" data="/directory" /></pre>
For example with a <tt>germany.bin</tt> on the SD-card you use:
<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/germany.bin" />
</mapset>
or if you store all downloaded maps in the directory <tt>/media/card/maps</tt> then add the following lines to <tt>navit.xml</tt>.
<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
Note that the bin-file and the map set both have to be enabled.

Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

* 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 <tt>vehicle</tt> tag in navit.xml.
<vehicle name="Local GPS" profilename="car" enabled="yes" active="1" follow="3"
source="gpsd://localhost" gpsd_query="w+xj" color="#0000ff">
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.

==Routing==
[[Image:navit_main_menu.png|100px|thumb|Navit Main Menu]]
[[Image:navit_action_menu.png|100px|thumb|Navit Action Menu]]
The main menu has 4 submenus
* Action
* Settings
* Tools
* Route
Normally you would assume the entering a town can be found under the submenu Route, but Town is hidden under submenu Action. Route will provide the description of the route as text and a height profile of your trip. Tools was not working on 08/2009 Version of navit on SHR (see [[SHR User Manual]]).

===Select Destination===
[[Image:navit_select_country.png|100px|thumb|Select Country]]

When you click in the main menu on <i>Action</i> the <i>Action</i> menu appears with 4 subitems.
* Bookmarks of previous locations (stored in <tt>/home/root/.navit/destinations.txt</tt>
* a globe showing a location as destination,
* a vehicle that shows the current GPS position of the vehicle. If the freerunner receives no GPS signal the locations of the vehicle is set to 0.0.0N and 0.0.0E.
* Town is the action to enter a destination.
* Quit navit is the last action in this submenu.

Select the icon <i>Town</i>.

====Select Country====
[[Image:navit_country_selected.png|100px|thumb|Country Options]]
[[Image:navit_destination_details.png|100px|thumb|Enter Bookmark Details]]

Before you can search for City you have to select a Country. To do that, click on the icon in the left upper corner of the search field (could look like a white square with blue top-left quadrant).

Just type in the first letter of the country (e.g. "G") and Navit makes suggestions (e.g. Gabon, Germany).

====Enter Town====

When you have selected the country (e.g. Germany) the flag appears and you can select the town.
Then you can save the town as bookmark and enter more details like streets to the selected town.

The search is still a little buggy.

====Enter Street====
You can enter the street and streetnumber and save it as bookmark when you use the destination often.

====Bookmarks====
Navigation and planning of routes with Navit can be organized with bookmarks.
* set a bookmark as current position
* set a bookmark as destination
Then you can see the suggested route in blue on the map.

The GPS-location (if GPS-signal is available) will be highlighted with a small blue circle:
* a dot in the blue circle is indicating that your are not moving,
* an arrowhead is indicating the direction, when you are moving.
Then routing can start and in the map the route is highlighted.

====Screenshots in Navit Documentation====
The screenshots are made with <tt>gpe-scap</tt>, that can be installed by:
opkg install gpe-scap
if not installed already. Navigation through your installed application navit and login via ssh on your Freerunner
ssh -l root 192.168.0.202
assuming that your Freerunner has the IP 192.168.0.202.
Any time you want to make a screenshot just start via your desktop computer
gpe-scap
and save the screenshot to you freerunner.
Download the screenshot to your desktop computer with
desktop# sftp://root@192.168.0.202

== News ==
A deeper look into configuring Navit can be found in the [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Wiki].

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

You can start in fullscreen mode with fullscreen="1"

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

If you want to enable "+" and "-" as Zoom-In and Zoom-Out buttons on the bottom of the map enable the button with the following xml-tags:
<osd enabled="yes" type="button" x="-96" y="-96" command="zoom_in()" src="zoom_in.xpm"/>
<osd enabled="yes" type="button" x="0" y="-96" command="zoom_out()" src="zoom_out.xpm"/>

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

=== Speech ===
Navit can speak if you install eSpeak + speech-dispatcher and updates your navit.xml file.
For adventurous people, one way to do this (in SHR starting <tt>navit</tt> did not work anymore after this procedure):

* 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

'''Alternatively''', you can make speech-dispatcher restart on resume, see http://trac.shr-project.org/trac/ticket/494

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

=== Improvements of GPS daemon by GSM network profiles ===
[[Cellhunter]] is game to map GPS locations to a GSM network cell profile of available GSM network cells the freerunner can connected to. The strength of the signal and the currectly used GSM network cell and its neigbours can be used to improve GPS daemon in areas where no GPS satellites are available (e.g. in building or in narrow road with high buildings or bad weather conditions).

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

Neo FreeRunner Wifi

2009-08-20T22:08:22Z

OlivierBerger: /* Sample wpa_supplicant.conf */

{{Languages|Neo FreeRunner Menu}}

This page documents the [http://en.wikipedia.org/wiki/Wireless_networking wireless networking] solutions commonly known as [http://en.wikipedia.org/wiki/Wireless_LAN WLAN] or WiFi.

There are other ways to enable wireless communications on the Neo, including [[Bluetooth]]. For Bluetooth solutions, see [[How to use bluetooth to transfer data between Neo and Desk-top]] and [[Manually using Bluetooth]].

== How can I tell what Access Points (APs) are visible to me? ==

You can connect to wireless networks through wireless [http://en.wikipedia.org/wiki/Access_point| access points]. If you want to know the names of all the access points that are currently visible to you, you can perform a scan with this command:

root@om-gta02:~# '''iwlist eth0 scan'''

If anything is visible you will get a list that looks something like this:

eth0 Scan completed :
Cell 01 - Address: 00:16:B6:DE:77:58
ESSID:"StarvinMarvin"
Mode:Master
Frequency:2.437 GHz (Channel 6)
Quality=9/94 Signal level=-86 dBm Noise level=-95 dBm
Encryption key:on
Extra:bcn_int=100
Extra:wpa_ie=dd180050f20101000050f20201000050f20201000050f2020000
Cell 02 - Address: 00:21:29:AA:10:97
ESSID:"CandT Network"
Mode:Master
Frequency:2.437 GHz (Channel 6)
Quality=39/94 Signal level=-56 dBm Noise level=-95 dBm
Encryption key:on
Extra:bcn_int=100
Extra:wpa_ie=dd1c0050f20101000050f20202000050f2040050f20201000050f2020000
Extra:rsn_ie=30180100000fac020200000fac04000fac020100000fac020000
Cell 03 - Address: 00:14:95:1B:8E:B9
ESSID:"2WIRE852"
Mode:Master
Frequency:2.437 GHz (Channel 6)
Quality=5/94 Signal level=-90 dBm Noise level=-95 dBm
Encryption key:on
Extra:bcn_int=100
Cell 04 - Address: 00:E0:98:52:3D:78
ESSID:"smith"
Mode:Master
Frequency:2.437 GHz (Channel 6)
Quality=36/94 Signal level=-59 dBm Noise level=-95 dBm
Encryption key:on
Extra:bcn_int=100

If you want to connect to an unsecured network run:

udhcpc

== WPA ==

[http://en.wikipedia.org/wiki/Wi-Fi_Protected_Access WPA] is an encryption method for securing your wireless network.

=== Using wpa_supplicant manually ===

Create and edit a suitable [[GTA02_WLAN#Sample_wpa_supplicant.conf|/etc/wpa_supplicant/wpa_supplicant.conf (see below)]].

Bring up your wireless connection:

root@om-gta02:~# ifconfig eth0 up
root@om-gta02:~# wpa_supplicant -i eth0 -c /etc/wpa_supplicant/wpa_supplicant.conf -B
root@om-gta02:~# udhcpc eth0

=== Using WPA and /etc/network/interfaces ===

Once you have a [[GTA02_WLAN#Sample_wpa_supplicant.conf|/etc/wpa_supplicant/wpa_supplicant.conf (see below)]] file, add a line under the eth0 entry in /etc/network/interfaces:

iface eth0 inet dhcp
wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf

Save your changes and run:
# ifdown eth0 && ifup eth0

You'll get a lot of messages, like <tt>ioctl[SIOCSIWENCODEEXT]: Operation not supported</tt> and <tt>sed: unrecognized option `--quiet'</tt>, they appear to be harmless. The "--quiet" error message can be avoided by replacing "sed --quiet" with "sed -n" in /etc/wpa_supplicant/*.sh ([http://docs.openmoko.org/trac/ticket/2189 bug #2189])

=== wpa_supplicant.conf ===
<tt>wpa-supplicant</tt>'s conf file typically found at <tt>/etc/wpa_supplicant/wpa_supplicant.conf</tt>.

==== wpa_supplicant.conf explained ====
The highest priority is tried first then falls back to the next highest number.

priority=100 1st <br>
then<br>
priority=99 <br>
<pre>

# Simple case: WPA-PSK, PSK as an ASCII passphrase, allow all valid ciphers
network={
ssid="AP_ESSID"
psk="presharedkey"
priority=5
}

#try open AP regardless of its SSID.
# change root password before you go roaming around it could prove dangerous
network={
key_mgmt=NONE
priority=1 #try any open AP last
}
</pre>

A more in depth explanation can be found here:<br>
http://hostap.epitest.fi/gitweb/gitweb.cgi?p=hostap.git;a=blob_plain;f=wpa_supplicant/wpa_supplicant.conf

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

Sample <tt>/etc/wpa_supplicant/wpa_supplicant.conf</tt> :

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=1
ap_scan=1
fast_reauth=1
# WPA2:
network={
ssid="your ssid"
scan_ssid=1
proto=RSN
key_mgmt=WPA-PSK
pairwise=CCMP TKIP
group=TKIP CCMP
psk="secret key"
priority=50
}

# WPA:
network={
ssid="your_ssid"
proto=WPA
key_mgmt=WPA-PSK
pairwise=TKIP
group=TKIP
scan_ssid=1
psk="secret key"
priority=10
}

# WEP:
network={
ssid="your_ssid"
scan_ssid=1
key_mgmt=NONE
wep_tx_keyidx=0
wep_key0=your_hex_key
priority=8
}

# Open:
network={
ssid="your ssid"
key_mgmt=NONE
priority=5
}

==== Other working sample wpa_supplicant.conf files ====

Tom Yates documents his success [http://www.teaparty.net/technotes/openmoko-2.html#Wifi here]

Matthias Apitz documents his success here: [http://www.unixarea.de/openmoko.txt http://www.unixarea.de/openmoko.txt] (see chapter 6.).

==== Roaming ====
* Connecting to a local network with usb networking enabled, may get you into trouble. The default /etc/network/interfaces will configure the usb endpoint as a default gateway (for 2008.12). If you connect to another 192.168.0.0/24 network your phone will try the usb, timeout and then go for the other: remove the route with 'route del default gw 192.168.0.200'. Optionally remove the route from <tt>interfaces</tt> if you never intend to use your desktop as a router.
* You can have wpa_supplicant roam for you by setting the inet method to manual and using wpa_roam instead of wpa_conf in your /etc/network/interfaces.
* After bringing up the interface with wpa_supplicant, you can run wpa_cli and issue the command 'status' to see if and to which AP you are connected.

==== Using with fsoraw ====
wpa_supplicant can be invoked through fsoraw by running,

fsoraw -r WiFi -- wpa_supplicant -ieth0 -Dwext -c /etc/wpa_supplicant/wpa_supplicant.conf

* Remember there is no need to enable WiFi radio in Settings>Connectivity as fsoraw will enable it.
* The above command shall not return back to the shell, it can be sent to background using &
* To terminate the connection, kill wpa_supplicant

== WEP ==

[http://en.wikipedia.org/wiki/Wired_Equivalent_Privacy WEP] is an encryption method for securing your wireless network. WEP is generally considered to be weak, you should use WPA instead if possible.

=== Using iwconfig manually ===

Note that for WEP our iwconfig requires a more specific format than generic iwconfig.

The canonical way of running iwconfig for WEP would be something like this:

# iwconfig eth0 key A4BEB3B8EC essid xyz

Two things are important here:

* the key must be in HEX. iwconfig will not do anything useful if the key is given as a string. [http://www.powerdog.com/wepkey.cgi Here] is a handy ASCII string to HEX converter.

* the ESSID must follow the key.

If an incorrect key was set, please stop all activity on the interface for at least two minutes (i.e., killall udhcpc and ifconfig eth0 down), then issue the correct iwconfig command and retry.

=== Using WEP and /etc/network/interfaces ===
iface eth0 inet dhcp
wireless-key my_wep_key
wireless-essid my_essid

iface eth0 inet dhcp
wpa-wep-key0 my_wep_key
wpa-key-mgmt NONE
wpa-ssid my_essid

Save your changes and run:
# ifdown eth0 && ifup eth0
Idea : You can use [http://www.opkg.org/package_28.html ShortOm] to lauch this command on futur boot to activate wifi without having to use terminal

== Known Issues ==

=== iwconfig doesn't work in all cases ===

Note that for some reason our iwconfig requires a more constrained format than the generic iwconfig. See
[[Neo_FreeRunner_Wifi#Using_iwconfig_manually| using iwconfig manually]].

=== Anecdotal solutions ===

These solutions worked for some people:

==== Disable power management ====

Some APs apparently get upset by power managed devices, and the Freerunner enables power management of the wifi by default to preserve battery. One user's wrt54g certainly gets upset from time to time if he connect with the FreeRunner, sometimes refusing to talk to _anything_ over wifi afterwards until rebooted.

<pre>
iwconfig eth0 power off
</pre>

==== Modified script ====

"I changed the script a little:

Exec=xterm -e "ifconfig eth0 down \
iwconfig eth0 txpower off channel 0 \
while killall wpa_supplicant; do echo 'Killing wpa_sup'; done \
killall udhcpc \
wpa_supplicant -i eth0 -c /etc/wpa_supplicant/wpa_supplicant.conf -D wext -B \
sleep 10; udhcpc"

Now it is working every time.
I am using 2008.latest (081004) and a linksys WAP54G accesspoint,

==== Use a different channel ====

"Could not get it to work properly on channel 11, so I set my accesspoint to channel 1."

==== Make your WIFI more reliable ====
After boot or before connecting do:
wmiconfig -i eth0 --power maxperf
of course you need to find [[wmiconfig]] or to compile it

==== eth0 doesn't show up ====
If a "config -a" or "lshw -c network" doesn't show the wlan interface (eth0) you might need to bind it first:

<pre>
echo s3c2440-sdi > /sys/bus/platform/drivers/s3c2440-sdi/bind
</pre>

== Wake up from wireless (wow)==

Wi-Fi module constantly drain currents after module power up, for wi-fi SIP phone or some application need long standby time, will need wake up from wireless function for power saving. There is a sleep mode that Ar6k supported for wake up from wireless.

http://svn.openmoko.org/trunk/src/target/AR6kSDK.build_sw.18/host/tools/wmiconfig

export ATH_CROSS_COMPILE_TYPE=arm-angstrom-linux-gnueabi-
make

Debian package:

wget http://meshy.org/~ato/debian/pool/main/w/wmiconfig/wmiconfig_0.0.18-1_armel.deb
dpkg -i wmiconfig_0.0.18-1_armel.deb

Basically, it's achieved via wmiconfig tool to issue IOCTL if we want
ar6k wifi module to generate interrupt to host controller. The procedure
to enable wakeup-on-wireless(wow) is listed here:

1. wmiconfig --sethostmode asleep /* to tell ar6k what host's current is */
2. wmiconfig --setwowmode enable /* enable wow function */
3. wmiconfig --addwowpattern 0 1 33 01 ff /* add packet filter pattern, this is the ICMP filter pattern */
4. apm -s
5. ping IP_of_Neo
6. The GPIO1 pin would be pulled up. The system would resume then.
7. wmiconfig --sethostmode awake /* The firmware of ar6k will pull low the GPIO1 pin */

--addwowpattern <list-id> <pattern-size> <pattern-offset> <pattern> <pattern-mask>

Here are some addwowpattern commands:

Protocol type=IP=0800
Protocol type in IP header=ICMP=01

- To filter for IP packets(offset 22)
wmiconfig --addwowpattern 0 2 22 0800 ffff
- To filter for ICMP packets (offset 33)
wmiconfig --addwowpattern 0 1 33 01 ff

== A very ugly /etc/init.d/wlan startscript ==
#!/bin/sh
#
# wlan This shell script starts and stops wlan.
#
# processname: wlan

# Source function library.
#. /etc/rc.d/init.d/functions
# "written" by HdR

RETVAL=0
prog="wlan"

# test -f /etc/default/$prog && . /etc/default/$prog

start() {
echo -n "Starting $prog: "
ifconfig eth0 up
wpa_supplicant -ieth0 -c/etc/wpa_supplicant/wpa_supplicant.conf -B
sleep 10
udhcpc eth0
RETVAL=$?
return $RETVAL
}

stop() {
# Stop daemons.
echo -n "Shutting down $prog: "
killall wpa_supplicant
ifconfig eth0 down
# killproc gpsd
RETVAL=$?
return $RETVAL
}

# See how we were called.
case "$1" in
start)
start
;;
stop)
stop
;;
restart|reload)
stop
start
RETVAL=$?
;;
*)
echo "Usage: $0 {start|stop|restart}"
exit 1
esac

exit $RETVAL

Note: Don't forget to make this script executable with "chmod +x <filename>"

== Route internet connection through Wifi rather than USB ==

Wifi is faster than USB, so it is a good idea to tell the FreeRunner to connect through it. Put the following in /etc/network/interfaces under eth0:

up route del default gw 192.168.0.200

This will remove your computer as the default gateway and use the wireless one when the interface is brought up. User nickd reports that sometimes it fails so he has had to put it in twice.

== ssh into FR over Other Network Interfaces ==
dropbear, the ssh server, is configured to listen on the USB interface only. Wireless interfaces like wlan or bluetooth are disabled for security reasons (empty root password). Therefore:

* Be careful with this config file since it can close the only door into your phone.

* '''Set a root password!'''

==== ssh into FR over WiFi Only ====

Change the /etc/default/dropbear from:

DROPBEAR_PORT=`ip addr list usb0 | awk 'BEGIN { FS="[ /]+" } /inet / { print $3 }'`:22

(which actually only prepends the usb0 ip address before the :22)

into:

DROPBEAR_PORT=`ip addr list eth0 | awk 'BEGIN { FS="[ /]+" } /inet / { print $3 }'`:22

(which now prepends the eth0 (WLAN interface) ip address before the :22)

==== ssh into FR over Any Network Interface ====

Change the /etc/default/dropbear from:

DROPBEAR_PORT=`ip addr list usb0 | awk 'BEGIN { FS="[ /]+" } /inet / { print $3 }'`:22

(which actually only prepends the usb0 ip address before the :22)

into:

DROPBEAR_PORT=*:22

== See also ==

* [[KnjMokoWifi]] GUI interface to administer WiFi connections
* [[wmiconfig]] Atheros utility to config the wifi chip used in Neo FreeRunner
* [[Lint-wifi]] GUI interface to administer WiFi connections
* [[Mofi]] GUI interface to administer WiFi connections
* [[Camp-Wifi]] GUI interface to administer WiFi connections

== External links ==

* [http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/ WiFi on Linux]

[[Category:Neo FreeRunner Hardware]]
[[Category:Wlan software| ]]

SHR User Manual

2009-08-20T21:46:08Z

OlivierBerger: /* Network manager */

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your Freerunner to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

'''SHR''' has been evolving from a simple release of customized software into a full distribution. Therefore, in SHR you can choose from several different graphical toolkits (for example GTK or EFL), different phone managers (SHR or Zhone), web browsers and other programs.

The SHR Team is busy with system maintenance and software building so you can concentrate on programming, using and [http://shr-project.org/trac/report reporting bugs].

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==SHR Specific==

At this point, there are some applications and procedures that are purely specific to SHR and would not run on another distribution. For example the phone applications (Dialer, Messages and Contacts) and SHR Settings depend heavily on the ophonekitd daemon.

As SHR is based on [[FSO]], basically any application using FSO has a chance to run, should all required libraries be available.

==Stability==

While many people use SHR as their daily phone, there are still occasional glitches and issues. This hurts the most when GSM stops working but this happens less and less. We wish you to have the best experiences with SHR.

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Source code===

View the sources at http://git.shr-project.org/git/

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* GPE File Manager
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||
* pythm

|-

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

|-

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

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links bellow for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

==Running SHR==
===Booting===
Press the power button shortly once to start the Freerunner. Booting splash screen will appear. First boot after new installation takes always a bit longer. Sometimes, it is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelve or by using the '''<''' left or right '''>''' arrows in the Top Shelve.

The Illume desktop can be easily customized - slide the Top Shelve down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' (the wrench) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the Top Shelve (for example Battery, GSM, Bluetooth etc.) are called '''Shelve gadgets''' and you can configure whether they are visible (on the front part of the top shelve) or hidden (you can access them by sliding the top shelve) through Illume Settings -> Display -> Shelve gadget.

Some screens are not resized properly to fit the Freerunner's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages.png|200px|thumb|Messages]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View.png|200px|thumb|View message]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View-chars.png|200px|thumb|Unicode support]]

|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages-Options.png|200px|thumb|Message options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Phonelog.png|200px|thumb|Phonelog]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a Notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelve cross.

===Post-Installation Script===
After flashing your Openmoko Freerunner you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your Freerunner via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on you Freerunner with:
neo# sh /home/root/SHRpostinstallation.sh

===Under the hood===

SHR is based on linux kernel and [http://www.openembedded.org/ Openembedded]. <tt>XGlamo</tt> is providing X server environment and [[Illume]] (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is [[FSO]] middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR <tt>ophonekitd</tt> daemon is run with X server start-up and it communicates with FSO via <tt>d-bus</tt>. SHR phone applications talk to <tt>ophonekitd</tt> and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. ''Dialer'', ''Contacts'' and ''Messages'' applications are part of the SHR internal <tt>libframeworkd-phonegui-efl</tt> library, ''Phonelog'' is an extra application written in python-gtk.

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your Freerunner. The <tt>root</tt> account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in <tt>/usr/share/shr/scenarii/</tt> . To customize speaker volume edit <tt>/usr/share/shr/scenarii/gsmhandset.state</tt> and change <tt>control 4</tt>. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

====Alarm====
The default alarm clock application <tt>elementary-alarm</tt> is not working properly. You may want to remove it and install working alarm application called <tt>ffalarms</tt>:

opkg remove -force-depends elementary-alarm
opkg install ffalarms

====Init opkg database====
''Initialize opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

====SwapSpace====
The Freerunner has only 128mb ram, when this is used up applications get killed. This is particularly bad while doing opkg upgrade.

WARNING: this mights kill your sd card, since there might be a lot of read/writes to the same spot.

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so next time you boot there will be swap

echo "/swapfile swap swap defaults 0 0">> /etc/fstab

Make swap

mkswap /swapfile

Make the swap file work now:

swapon /swapfile

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

====Locate lost phone by GPS====
To locate your freerunner in case of lost or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an sms with text sentry:location to your Freerunner, the phone will turn on GPS, wait for a fix and send back sms with current location.

[[Cellhunter]] is a project with the objective to collect GPS location of GSM network cells. If this project is finished then sms-sentry could send the a rough GPS location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in Illume Top Shelve go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

Timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI Contact Sync]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI Calendar Sync]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="left";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:80%; text-align:left " |

opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 python-pygtk python-pygobject python-pycairo python-netserver python-netclient http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk

|

|}

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. Should you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If no, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your freerunner you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your freerunner. Because of the size of the maps you copy map to the Micro-SD card on your freerunner. Create a directory for the maps and copy the files from desktop to freerunner:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

===Start Navit===
Start <tt>Navit</tt> on your Freerunner for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the freerunner does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. In the background it uses [[FSO]] specific dbus calls as well as low level commands. The graphical interface is Elementary-Python based. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

While some settings are persistent over reboots, other are not.

===Main Screen===
Main screen is divided into few categories, which contain modules. Every SHR Settings module has specified task - control GSM antenna power, set actual time etc.

===Settings: Phone===
Here you can check if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After while, list of operators should pop up.

You can't connect to operators marked [forbidden]. After failed connect, message is displayed.

Selecting operator from list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select current profile, which device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change ring tone, click on "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting sid tune as ring tone, there are available controls to select tune number from file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With "WiFi radio" toggle you can set, if wifi module should be powered. WiFi radio has to be turned on before trying to connect to WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your Gprs connection}}

To connect to GPRS network, just click "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, swith "Bluetooth radio" toggle to "On". After that, "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting fix. To do that, just click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set actual time. By default, time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click "OK" button.

'''Date'''

This module displays current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update data, click "Update" button.

Here you also force enable 500mA charging.

'''Display'''

With this slider you can easily tweak backlight power.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on some, you can either start, restart or stop service and view result.

===Settings: Others===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select theme used by shr-splash at boot and shutdown. After clicking "Preview", selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store it's data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called ''resources''. If the software wanting to use the device is capable of requesting this resource via <tt>d-bus</tt>, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through ''SHR Setting'' or you can use <tt>fsoraw</tt> command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

See [[FSO Resources]] for more details on using the following resources:

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in <tt>/etc/network/interfaces</tt>.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

The <tt>connmand</tt> daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable after use.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better then for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR user bluez4 which completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) doesn exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your Freerunner. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phone calls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Install functional alarm application===
The pre-installed alarm clock ''elementary-alarm'' does not work properly on SHR. so replace it by ''ffalarm'':
opkg remove -force-depends elementary-alarm; opkg install ffalarms

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your freerunner. If new keys are generated or if you flash your Freerunner with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your Freerunner from the file. Otherwise you might be able to login in again. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding freerunner to your hosts===

You can add freerunner to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your freerunner is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your freerunner like this:

ssh root@neo

Which is shorter then this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only few preinstalled applications but it's repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.23_arm.ipk

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

GPE contacts saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). It's main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an excelent eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokomaze.png|200px|thumb|Mokomaze]]

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

SHR User Manual

2009-08-20T21:42:05Z

OlivierBerger: /* FSO Resources */ Adding pointer to FSO_resources

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your Freerunner to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

'''SHR''' has been evolving from a simple release of customized software into a full distribution. Therefore, in SHR you can choose from several different graphical toolkits (for example GTK or EFL), different phone managers (SHR or Zhone), web browsers and other programs.

The SHR Team is busy with system maintenance and software building so you can concentrate on programming, using and [http://shr-project.org/trac/report reporting bugs].

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==SHR Specific==

At this point, there are some applications and procedures that are purely specific to SHR and would not run on another distribution. For example the phone applications (Dialer, Messages and Contacts) and SHR Settings depend heavily on the ophonekitd daemon.

As SHR is based on [[FSO]], basically any application using FSO has a chance to run, should all required libraries be available.

==Stability==

While many people use SHR as their daily phone, there are still occasional glitches and issues. This hurts the most when GSM stops working but this happens less and less. We wish you to have the best experiences with SHR.

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Source code===

View the sources at http://git.shr-project.org/git/

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* GPE File Manager
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||
* pythm

|-

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

|-

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

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links bellow for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

==Running SHR==
===Booting===
Press the power button shortly once to start the Freerunner. Booting splash screen will appear. First boot after new installation takes always a bit longer. Sometimes, it is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelve or by using the '''<''' left or right '''>''' arrows in the Top Shelve.

The Illume desktop can be easily customized - slide the Top Shelve down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' (the wrench) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the Top Shelve (for example Battery, GSM, Bluetooth etc.) are called '''Shelve gadgets''' and you can configure whether they are visible (on the front part of the top shelve) or hidden (you can access them by sliding the top shelve) through Illume Settings -> Display -> Shelve gadget.

Some screens are not resized properly to fit the Freerunner's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages.png|200px|thumb|Messages]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View.png|200px|thumb|View message]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View-chars.png|200px|thumb|Unicode support]]

|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages-Options.png|200px|thumb|Message options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Phonelog.png|200px|thumb|Phonelog]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a Notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelve cross.

===Post-Installation Script===
After flashing your Openmoko Freerunner you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your Freerunner via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on you Freerunner with:
neo# sh /home/root/SHRpostinstallation.sh

===Under the hood===

SHR is based on linux kernel and [http://www.openembedded.org/ Openembedded]. <tt>XGlamo</tt> is providing X server environment and [[Illume]] (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is [[FSO]] middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR <tt>ophonekitd</tt> daemon is run with X server start-up and it communicates with FSO via <tt>d-bus</tt>. SHR phone applications talk to <tt>ophonekitd</tt> and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. ''Dialer'', ''Contacts'' and ''Messages'' applications are part of the SHR internal <tt>libframeworkd-phonegui-efl</tt> library, ''Phonelog'' is an extra application written in python-gtk.

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your Freerunner. The <tt>root</tt> account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in <tt>/usr/share/shr/scenarii/</tt> . To customize speaker volume edit <tt>/usr/share/shr/scenarii/gsmhandset.state</tt> and change <tt>control 4</tt>. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

====Alarm====
The default alarm clock application <tt>elementary-alarm</tt> is not working properly. You may want to remove it and install working alarm application called <tt>ffalarms</tt>:

opkg remove -force-depends elementary-alarm
opkg install ffalarms

====Init opkg database====
''Initialize opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

====SwapSpace====
The Freerunner has only 128mb ram, when this is used up applications get killed. This is particularly bad while doing opkg upgrade.

WARNING: this mights kill your sd card, since there might be a lot of read/writes to the same spot.

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so next time you boot there will be swap

echo "/swapfile swap swap defaults 0 0">> /etc/fstab

Make swap

mkswap /swapfile

Make the swap file work now:

swapon /swapfile

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

====Locate lost phone by GPS====
To locate your freerunner in case of lost or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an sms with text sentry:location to your Freerunner, the phone will turn on GPS, wait for a fix and send back sms with current location.

[[Cellhunter]] is a project with the objective to collect GPS location of GSM network cells. If this project is finished then sms-sentry could send the a rough GPS location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in Illume Top Shelve go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

Timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI Contact Sync]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI Calendar Sync]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="left";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:80%; text-align:left " |

opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 python-pygtk python-pygobject python-pycairo python-netserver python-netclient http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk

|

|}

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. Should you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If no, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your freerunner you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your freerunner. Because of the size of the maps you copy map to the Micro-SD card on your freerunner. Create a directory for the maps and copy the files from desktop to freerunner:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

===Start Navit===
Start <tt>Navit</tt> on your Freerunner for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the freerunner does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. In the background it uses [[FSO]] specific dbus calls as well as low level commands. The graphical interface is Elementary-Python based. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

While some settings are persistent over reboots, other are not.

===Main Screen===
Main screen is divided into few categories, which contain modules. Every SHR Settings module has specified task - control GSM antenna power, set actual time etc.

===Settings: Phone===
Here you can check if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After while, list of operators should pop up.

You can't connect to operators marked [forbidden]. After failed connect, message is displayed.

Selecting operator from list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select current profile, which device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change ring tone, click on "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting sid tune as ring tone, there are available controls to select tune number from file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With "WiFi radio" toggle you can set, if wifi module should be powered. WiFi radio has to be turned on before trying to connect to WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your Gprs connection}}

To connect to GPRS network, just click "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, swith "Bluetooth radio" toggle to "On". After that, "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting fix. To do that, just click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set actual time. By default, time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click "OK" button.

'''Date'''

This module displays current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update data, click "Update" button.

Here you also force enable 500mA charging.

'''Display'''

With this slider you can easily tweak backlight power.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on some, you can either start, restart or stop service and view result.

===Settings: Others===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select theme used by shr-splash at boot and shutdown. After clicking "Preview", selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store it's data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called ''resources''. If the software wanting to use the device is capable of requesting this resource via <tt>d-bus</tt>, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through ''SHR Setting'' or you can use <tt>fsoraw</tt> command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

See [[FSO Resources]] for more details on using the following resources:

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in <tt>/etc/network/interfaces</tt>.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

Connmand daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable after use.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better then for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR user bluez4 which completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) doesn exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your Freerunner. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phone calls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Install functional alarm application===
The pre-installed alarm clock ''elementary-alarm'' does not work properly on SHR. so replace it by ''ffalarm'':
opkg remove -force-depends elementary-alarm; opkg install ffalarms

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your freerunner. If new keys are generated or if you flash your Freerunner with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your Freerunner from the file. Otherwise you might be able to login in again. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding freerunner to your hosts===

You can add freerunner to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your freerunner is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your freerunner like this:

ssh root@neo

Which is shorter then this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only few preinstalled applications but it's repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.23_arm.ipk

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

GPE contacts saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). It's main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an excelent eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokomaze.png|200px|thumb|Mokomaze]]

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

SHR User Manual

2009-08-20T21:34:11Z

OlivierBerger: /* Network manager */

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your Freerunner to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

'''SHR''' has been evolving from a simple release of customized software into a full distribution. Therefore, in SHR you can choose from several different graphical toolkits (for example GTK or EFL), different phone managers (SHR or Zhone), web browsers and other programs.

The SHR Team is busy with system maintenance and software building so you can concentrate on programming, using and [http://shr-project.org/trac/report reporting bugs].

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==SHR Specific==

At this point, there are some applications and procedures that are purely specific to SHR and would not run on another distribution. For example the phone applications (Dialer, Messages and Contacts) and SHR Settings depend heavily on the ophonekitd daemon.

As SHR is based on [[FSO]], basically any application using FSO has a chance to run, should all required libraries be available.

==Stability==

While many people use SHR as their daily phone, there are still occasional glitches and issues. This hurts the most when GSM stops working but this happens less and less. We wish you to have the best experiences with SHR.

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Source code===

View the sources at http://git.shr-project.org/git/

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* GPE File Manager
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||
* pythm

|-

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

|-

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

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links bellow for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

==Running SHR==
===Booting===
Press the power button shortly once to start the Freerunner. Booting splash screen will appear. First boot after new installation takes always a bit longer. Sometimes, it is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelve or by using the '''<''' left or right '''>''' arrows in the Top Shelve.

The Illume desktop can be easily customized - slide the Top Shelve down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' (the wrench) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the Top Shelve (for example Battery, GSM, Bluetooth etc.) are called '''Shelve gadgets''' and you can configure whether they are visible (on the front part of the top shelve) or hidden (you can access them by sliding the top shelve) through Illume Settings -> Display -> Shelve gadget.

Some screens are not resized properly to fit the Freerunner's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages.png|200px|thumb|Messages]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View.png|200px|thumb|View message]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View-chars.png|200px|thumb|Unicode support]]

|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages-Options.png|200px|thumb|Message options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Phonelog.png|200px|thumb|Phonelog]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a Notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelve cross.

===Post-Installation Script===
After flashing your Openmoko Freerunner you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your Freerunner via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on you Freerunner with:
neo# sh /home/root/SHRpostinstallation.sh

===Under the hood===

SHR is based on linux kernel and [http://www.openembedded.org/ Openembedded]. <tt>XGlamo</tt> is providing X server environment and [[Illume]] (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is [[FSO]] middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR <tt>ophonekitd</tt> daemon is run with X server start-up and it communicates with FSO via <tt>d-bus</tt>. SHR phone applications talk to <tt>ophonekitd</tt> and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. ''Dialer'', ''Contacts'' and ''Messages'' applications are part of the SHR internal <tt>libframeworkd-phonegui-efl</tt> library, ''Phonelog'' is an extra application written in python-gtk.

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your Freerunner. The <tt>root</tt> account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in <tt>/usr/share/shr/scenarii/</tt> . To customize speaker volume edit <tt>/usr/share/shr/scenarii/gsmhandset.state</tt> and change <tt>control 4</tt>. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

====Alarm====
The default alarm clock application <tt>elementary-alarm</tt> is not working properly. You may want to remove it and install working alarm application called <tt>ffalarms</tt>:

opkg remove -force-depends elementary-alarm
opkg install ffalarms

====Init opkg database====
''Initialize opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

====SwapSpace====
The Freerunner has only 128mb ram, when this is used up applications get killed. This is particularly bad while doing opkg upgrade.

WARNING: this mights kill your sd card, since there might be a lot of read/writes to the same spot.

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so next time you boot there will be swap

echo "/swapfile swap swap defaults 0 0">> /etc/fstab

Make swap

mkswap /swapfile

Make the swap file work now:

swapon /swapfile

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

====Locate lost phone by GPS====
To locate your freerunner in case of lost or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an sms with text sentry:location to your Freerunner, the phone will turn on GPS, wait for a fix and send back sms with current location.

[[Cellhunter]] is a project with the objective to collect GPS location of GSM network cells. If this project is finished then sms-sentry could send the a rough GPS location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in Illume Top Shelve go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

Timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI Contact Sync]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI Calendar Sync]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="left";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:80%; text-align:left " |

opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 python-pygtk python-pygobject python-pycairo python-netserver python-netclient http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk

|

|}

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. Should you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If no, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your freerunner you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your freerunner. Because of the size of the maps you copy map to the Micro-SD card on your freerunner. Create a directory for the maps and copy the files from desktop to freerunner:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

===Start Navit===
Start <tt>Navit</tt> on your Freerunner for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the freerunner does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. In the background it uses [[FSO]] specific dbus calls as well as low level commands. The graphical interface is Elementary-Python based. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

While some settings are persistent over reboots, other are not.

===Main Screen===
Main screen is divided into few categories, which contain modules. Every SHR Settings module has specified task - control GSM antenna power, set actual time etc.

===Settings: Phone===
Here you can check if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After while, list of operators should pop up.

You can't connect to operators marked [forbidden]. After failed connect, message is displayed.

Selecting operator from list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select current profile, which device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change ring tone, click on "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting sid tune as ring tone, there are available controls to select tune number from file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With "WiFi radio" toggle you can set, if wifi module should be powered. WiFi radio has to be turned on before trying to connect to WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your Gprs connection}}

To connect to GPRS network, just click "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, swith "Bluetooth radio" toggle to "On". After that, "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting fix. To do that, just click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set actual time. By default, time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click "OK" button.

'''Date'''

This module displays current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update data, click "Update" button.

Here you also force enable 500mA charging.

'''Display'''

With this slider you can easily tweak backlight power.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on some, you can either start, restart or stop service and view result.

===Settings: Others===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select theme used by shr-splash at boot and shutdown. After clicking "Preview", selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store it's data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called ''resources''. If the software wanting to use the device is capable of requesting this resource via <tt>d-bus</tt>, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through ''SHR Setting'' or you can use <tt>fsoraw</tt> command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in <tt>/etc/network/interfaces</tt>.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

Connmand daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable after use.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better then for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR user bluez4 which completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) doesn exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your Freerunner. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phone calls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Install functional alarm application===
The pre-installed alarm clock ''elementary-alarm'' does not work properly on SHR. so replace it by ''ffalarm'':
opkg remove -force-depends elementary-alarm; opkg install ffalarms

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your freerunner. If new keys are generated or if you flash your Freerunner with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your Freerunner from the file. Otherwise you might be able to login in again. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding freerunner to your hosts===

You can add freerunner to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your freerunner is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your freerunner like this:

ssh root@neo

Which is shorter then this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only few preinstalled applications but it's repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.23_arm.ipk

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

GPE contacts saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). It's main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an excelent eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokomaze.png|200px|thumb|Mokomaze]]

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

SHR User Manual

2009-08-20T21:31:34Z

OlivierBerger: /* FSO Resources */

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your Freerunner to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

'''SHR''' has been evolving from a simple release of customized software into a full distribution. Therefore, in SHR you can choose from several different graphical toolkits (for example GTK or EFL), different phone managers (SHR or Zhone), web browsers and other programs.

The SHR Team is busy with system maintenance and software building so you can concentrate on programming, using and [http://shr-project.org/trac/report reporting bugs].

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==SHR Specific==

At this point, there are some applications and procedures that are purely specific to SHR and would not run on another distribution. For example the phone applications (Dialer, Messages and Contacts) and SHR Settings depend heavily on the ophonekitd daemon.

As SHR is based on [[FSO]], basically any application using FSO has a chance to run, should all required libraries be available.

==Stability==

While many people use SHR as their daily phone, there are still occasional glitches and issues. This hurts the most when GSM stops working but this happens less and less. We wish you to have the best experiences with SHR.

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Source code===

View the sources at http://git.shr-project.org/git/

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* GPE File Manager
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||
* pythm

|-

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

|-

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

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links bellow for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

==Running SHR==
===Booting===
Press the power button shortly once to start the Freerunner. Booting splash screen will appear. First boot after new installation takes always a bit longer. Sometimes, it is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelve or by using the '''<''' left or right '''>''' arrows in the Top Shelve.

The Illume desktop can be easily customized - slide the Top Shelve down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' (the wrench) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the Top Shelve (for example Battery, GSM, Bluetooth etc.) are called '''Shelve gadgets''' and you can configure whether they are visible (on the front part of the top shelve) or hidden (you can access them by sliding the top shelve) through Illume Settings -> Display -> Shelve gadget.

Some screens are not resized properly to fit the Freerunner's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages.png|200px|thumb|Messages]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View.png|200px|thumb|View message]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View-chars.png|200px|thumb|Unicode support]]

|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages-Options.png|200px|thumb|Message options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Phonelog.png|200px|thumb|Phonelog]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a Notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelve cross.

===Post-Installation Script===
After flashing your Openmoko Freerunner you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your Freerunner via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on you Freerunner with:
neo# sh /home/root/SHRpostinstallation.sh

===Under the hood===

SHR is based on linux kernel and [http://www.openembedded.org/ Openembedded]. <tt>XGlamo</tt> is providing X server environment and [[Illume]] (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is [[FSO]] middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR <tt>ophonekitd</tt> daemon is run with X server start-up and it communicates with FSO via <tt>d-bus</tt>. SHR phone applications talk to <tt>ophonekitd</tt> and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. ''Dialer'', ''Contacts'' and ''Messages'' applications are part of the SHR internal <tt>libframeworkd-phonegui-efl</tt> library, ''Phonelog'' is an extra application written in python-gtk.

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your Freerunner. The <tt>root</tt> account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in <tt>/usr/share/shr/scenarii/</tt> . To customize speaker volume edit <tt>/usr/share/shr/scenarii/gsmhandset.state</tt> and change <tt>control 4</tt>. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

====Alarm====
The default alarm clock application <tt>elementary-alarm</tt> is not working properly. You may want to remove it and install working alarm application called <tt>ffalarms</tt>:

opkg remove -force-depends elementary-alarm
opkg install ffalarms

====Init opkg database====
''Initialize opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

====SwapSpace====
The Freerunner has only 128mb ram, when this is used up applications get killed. This is particularly bad while doing opkg upgrade.

WARNING: this mights kill your sd card, since there might be a lot of read/writes to the same spot.

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so next time you boot there will be swap

echo "/swapfile swap swap defaults 0 0">> /etc/fstab

Make swap

mkswap /swapfile

Make the swap file work now:

swapon /swapfile

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

====Locate lost phone by GPS====
To locate your freerunner in case of lost or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an sms with text sentry:location to your Freerunner, the phone will turn on GPS, wait for a fix and send back sms with current location.

[[Cellhunter]] is a project with the objective to collect GPS location of GSM network cells. If this project is finished then sms-sentry could send the a rough GPS location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in Illume Top Shelve go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

Timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI Contact Sync]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI Calendar Sync]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="left";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:80%; text-align:left " |

opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 python-pygtk python-pygobject python-pycairo python-netserver python-netclient http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk

|

|}

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. Should you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If no, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your freerunner you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your freerunner. Because of the size of the maps you copy map to the Micro-SD card on your freerunner. Create a directory for the maps and copy the files from desktop to freerunner:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

===Start Navit===
Start <tt>Navit</tt> on your Freerunner for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the freerunner does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. In the background it uses [[FSO]] specific dbus calls as well as low level commands. The graphical interface is Elementary-Python based. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

While some settings are persistent over reboots, other are not.

===Main Screen===
Main screen is divided into few categories, which contain modules. Every SHR Settings module has specified task - control GSM antenna power, set actual time etc.

===Settings: Phone===
Here you can check if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After while, list of operators should pop up.

You can't connect to operators marked [forbidden]. After failed connect, message is displayed.

Selecting operator from list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select current profile, which device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change ring tone, click on "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting sid tune as ring tone, there are available controls to select tune number from file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With "WiFi radio" toggle you can set, if wifi module should be powered. WiFi radio has to be turned on before trying to connect to WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your Gprs connection}}

To connect to GPRS network, just click "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, swith "Bluetooth radio" toggle to "On". After that, "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting fix. To do that, just click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set actual time. By default, time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click "OK" button.

'''Date'''

This module displays current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update data, click "Update" button.

Here you also force enable 500mA charging.

'''Display'''

With this slider you can easily tweak backlight power.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on some, you can either start, restart or stop service and view result.

===Settings: Others===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select theme used by shr-splash at boot and shutdown. After clicking "Preview", selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store it's data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called ''resources''. If the software wanting to use the device is capable of requesting this resource via <tt>d-bus</tt>, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through ''SHR Setting'' or you can use <tt>fsoraw</tt> command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in /etc/network/interfaces.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

Connmand daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable after use.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better then for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR user bluez4 which completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) doesn exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your Freerunner. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phone calls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Install functional alarm application===
The pre-installed alarm clock ''elementary-alarm'' does not work properly on SHR. so replace it by ''ffalarm'':
opkg remove -force-depends elementary-alarm; opkg install ffalarms

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your freerunner. If new keys are generated or if you flash your Freerunner with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your Freerunner from the file. Otherwise you might be able to login in again. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding freerunner to your hosts===

You can add freerunner to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your freerunner is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your freerunner like this:

ssh root@neo

Which is shorter then this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only few preinstalled applications but it's repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.23_arm.ipk

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

GPE contacts saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). It's main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an excelent eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokomaze.png|200px|thumb|Mokomaze]]

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

SHR User Manual

2009-08-20T21:02:22Z

OlivierBerger: /* GSM phonealls with bluetooth headset */ Fix typo

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your Freerunner to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

'''SHR''' has been evolving from a simple release of customized software into a full distribution. Therefore, in SHR you can choose from several different graphical toolkits (for example GTK or EFL), different phone managers (SHR or Zhone), web browsers and other programs.

The SHR Team is busy with system maintenance and software building so you can concentrate on programming, using and [http://shr-project.org/trac/report reporting bugs].

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==SHR Specific==

At this point, there are some applications and procedures that are purely specific to SHR and would not run on another distribution. For example the phone applications (Dialer, Messages and Contacts) and SHR Settings depend heavily on the ophonekitd daemon.

As SHR is based on [[FSO]], basically any application using FSO has a chance to run, should all required libraries be available.

==Stability==

While many people use SHR as their daily phone, there are still occasional glitches and issues. This hurts the most when GSM stops working but this happens less and less. We wish you to have the best experiences with SHR.

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Source code===

View the sources at http://git.shr-project.org/git/

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* GPE File Manager
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||
* pythm

|-

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

|-

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

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links bellow for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

==Running SHR==
===Booting===
Press the power button shortly once to start the Freerunner. Booting splash screen will appear. First boot after new installation takes always a bit longer. Sometimes, it is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelve or by using the '''<''' left or right '''>''' arrows in the Top Shelve.

The Illume desktop can be easily customized - slide the Top Shelve down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' (the wrench) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the Top Shelve (for example Battery, GSM, Bluetooth etc.) are called '''Shelve gadgets''' and you can configure whether they are visible (on the front part of the top shelve) or hidden (you can access them by sliding the top shelve) through Illume Settings -> Display -> Shelve gadget.

Some screens are not resized properly to fit the Freerunner's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages.png|200px|thumb|Messages]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View.png|200px|thumb|View message]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View-chars.png|200px|thumb|Unicode support]]

|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages-Options.png|200px|thumb|Message options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Phonelog.png|200px|thumb|Phonelog]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a Notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelve cross.

===Post-Installation Script===
After flashing your Openmoko Freerunner you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your Freerunner via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on you Freerunner with:
neo# sh /home/root/SHRpostinstallation.sh

===Under the hood===

SHR is based on linux kernel and [http://www.openembedded.org/ Openembedded]. <tt>XGlamo</tt> is providing X server environment and [[Illume]] (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is [[FSO]] middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR <tt>ophonekitd</tt> daemon is run with X server start-up and it communicates with FSO via <tt>d-bus</tt>. SHR phone applications talk to <tt>ophonekitd</tt> and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. ''Dialer'', ''Contacts'' and ''Messages'' applications are part of the SHR internal <tt>libframeworkd-phonegui-efl</tt> library, ''Phonelog'' is an extra application written in python-gtk.

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your Freerunner. The <tt>root</tt> account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in <tt>/usr/share/shr/scenarii/</tt> . To customize speaker volume edit <tt>/usr/share/shr/scenarii/gsmhandset.state</tt> and change <tt>control 4</tt>. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

====Alarm====
The default alarm clock application <tt>elementary-alarm</tt> is not working properly. You may want to remove it and install working alarm application called <tt>ffalarms</tt>:

opkg remove -force-depends elementary-alarm
opkg install ffalarms

====Init opkg database====
''Initialize opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

====SwapSpace====
The Freerunner has only 128mb ram, when this is used up applications get killed. This is particularly bad while doing opkg upgrade.

WARNING: this mights kill your sd card, since there might be a lot of read/writes to the same spot.

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so next time you boot there will be swap

echo "/swapfile swap swap defaults 0 0">> /etc/fstab

Make swap

mkswap /swapfile

Make the swap file work now:

swapon /swapfile

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

====Locate lost phone by GPS====
To locate your freerunner in case of lost or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an sms with text sentry:location to your Freerunner, the phone will turn on GPS, wait for a fix and send back sms with current location.

[[Cellhunter]] is a project with the objective to collect GPS location of GSM network cells. If this project is finished then sms-sentry could send the a rough GPS location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in Illume Top Shelve go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

Timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI Contact Sync]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI Calendar Sync]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="left";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:80%; text-align:left " |

opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 python-pygtk python-pygobject python-pycairo python-netserver python-netclient http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk

|

|}

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. Should you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If no, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your freerunner you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your freerunner. Because of the size of the maps you copy map to the Micro-SD card on your freerunner. Create a directory for the maps and copy the files from desktop to freerunner:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

===Start Navit===
Start <tt>Navit</tt> on your Freerunner for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the freerunner does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. In the background it uses [[FSO]] specific dbus calls as well as low level commands. The graphical interface is Elementary-Python based. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

While some settings are persistent over reboots, other are not.

===Main Screen===
Main screen is divided into few categories, which contain modules. Every SHR Settings module has specified task - control GSM antenna power, set actual time etc.

===Settings: Phone===
Here you can check if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After while, list of operators should pop up.

You can't connect to operators marked [forbidden]. After failed connect, message is displayed.

Selecting operator from list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select current profile, which device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change ring tone, click on "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting sid tune as ring tone, there are available controls to select tune number from file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With "WiFi radio" toggle you can set, if wifi module should be powered. WiFi radio has to be turned on before trying to connect to WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your Gprs connection}}

To connect to GPRS network, just click "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, swith "Bluetooth radio" toggle to "On". After that, "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting fix. To do that, just click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set actual time. By default, time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click "OK" button.

'''Date'''

This module displays current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update data, click "Update" button.

Here you also force enable 500mA charging.

'''Display'''

With this slider you can easily tweak backlight power.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on some, you can either start, restart or stop service and view result.

===Settings: Others===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select theme used by shr-splash at boot and shutdown. After clicking "Preview", selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store it's data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called resources. If the software wanting to use the device is capable of requesting this resource via d-bus, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through SHR Setting or you can use fsoraw command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in /etc/network/interfaces.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

Connmand daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable after use.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better then for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR user bluez4 which completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) doesn exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your Freerunner. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phone calls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Install functional alarm application===
The pre-installed alarm clock ''elementary-alarm'' does not work properly on SHR. so replace it by ''ffalarm'':
opkg remove -force-depends elementary-alarm; opkg install ffalarms

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your freerunner. If new keys are generated or if you flash your Freerunner with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your Freerunner from the file. Otherwise you might be able to login in again. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding freerunner to your hosts===

You can add freerunner to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your freerunner is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your freerunner like this:

ssh root@neo

Which is shorter then this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only few preinstalled applications but it's repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.23_arm.ipk

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

GPE contacts saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). It's main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an excelent eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokomaze.png|200px|thumb|Mokomaze]]

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

SHR User Manual

2009-08-20T20:09:49Z

OlivierBerger: /* Audio: Volume */

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your Freerunner to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

'''SHR''' has been evolving from a simple release of customized software into a full distribution. Therefore, in SHR you can choose from several different graphical toolkits (for example GTK or EFL), different phone managers (SHR or Zhone), web browsers and other programs.

The SHR Team is busy with system maintenance and software building so you can concentrate on programming, using and [http://shr-project.org/trac/report reporting bugs].

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==SHR Specific==

At this point, there are some applications and procedures that are purely specific to SHR and would not run on another distribution. For example the phone applications (Dialer, Messages and Contacts) and SHR Settings depend heavily on the ophonekitd daemon.

As SHR is based on [[FSO]], basically any application using FSO has a chance to run, should all required libraries be available.

==Stability==

While many people use SHR as their daily phone, there are still occasional glitches and issues. This hurts the most when GSM stops working but this happens less and less. We wish you to have the best experiences with SHR.

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Source code===

View the sources at http://git.shr-project.org/git/

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* GPE File Manager
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||
* pythm

|-

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

|-

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

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links bellow for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

==Running SHR==
===Booting===
Press the power button shortly once to start the Freerunner. Booting splash screen will appear. First boot after new installation takes always a bit longer. Sometimes, it is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelve or by using the '''<''' left or right '''>''' arrows in the Top Shelve.

The Illume desktop can be easily customized - slide the Top Shelve down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' (the wrench) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the Top Shelve (for example Battery, GSM, Bluetooth etc.) are called '''Shelve gadgets''' and you can configure whether they are visible (on the front part of the top shelve) or hidden (you can access them by sliding the top shelve) through Illume Settings -> Display -> Shelve gadget.

Some screens are not resized properly to fit the Freerunner's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages.png|200px|thumb|Messages]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View.png|200px|thumb|View message]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View-chars.png|200px|thumb|Unicode support]]

|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages-Options.png|200px|thumb|Message options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Phonelog.png|200px|thumb|Phonelog]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a Notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelve cross.

===Post-Installation Script===
After flashing your Openmoko Freerunner you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your Freerunner via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on you Freerunner with:
neo# sh /home/root/SHRpostinstallation.sh

===Under the hood===

SHR is based on linux kernel and [http://www.openembedded.org/ Openembedded]. <tt>XGlamo</tt> is providing X server environment and [[Illume]] (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is [[FSO]] middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR <tt>ophonekitd</tt> daemon is run with X server start-up and it communicates with FSO via <tt>d-bus</tt>. SHR phone applications talk to <tt>ophonekitd</tt> and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. ''Dialer'', ''Contacts'' and ''Messages'' applications are part of the SHR internal <tt>libframeworkd-phonegui-efl</tt> library, ''Phonelog'' is an extra application written in python-gtk.

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your Freerunner. The <tt>root</tt> account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in <tt>/usr/share/shr/scenarii/</tt> . To customize speaker volume edit <tt>/usr/share/shr/scenarii/gsmhandset.state</tt> and change <tt>control 4</tt>. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

====Alarm====
The default alarm clock application <tt>elementary-alarm</tt> is not working properly. You may want to remove it and install working alarm application called <tt>ffalarms</tt>:

opkg remove -force-depends elementary-alarm
opkg install ffalarms

====Init opkg database====
''Initialize opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

====SwapSpace====
The Freerunner has only 128mb ram, when this is used up applications get killed. This is particularly bad while doing opkg upgrade.

WARNING: this mights kill your sd card, since there might be a lot of read/writes to the same spot.

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so next time you boot there will be swap

echo "/swapfile swap swap defaults 0 0">> /etc/fstab

Make swap

mkswap /swapfile

Make the swap file work now:

swapon /swapfile

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

====Locate lost phone by GPS====
To locate your freerunner in case of lost or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an sms with text sentry:location to your Freerunner, the phone will turn on GPS, wait for a fix and send back sms with current location.

[[Cellhunter]] is a project with the objective to collect GPS location of GSM network cells. If this project is finished then sms-sentry could send the a rough GPS location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in Illume Top Shelve go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

Timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI Contact Sync]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI Calendar Sync]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="left";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:80%; text-align:left " |

opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 python-pygtk python-pygobject python-pycairo python-netserver python-netclient http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk

|

|}

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. Should you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If no, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your freerunner you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your freerunner. Because of the size of the maps you copy map to the Micro-SD card on your freerunner. Create a directory for the maps and copy the files from desktop to freerunner:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

===Start Navit===
Start <tt>Navit</tt> on your Freerunner for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the freerunner does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. In the background it uses [[FSO]] specific dbus calls as well as low level commands. The graphical interface is Elementary-Python based. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

While some settings are persistent over reboots, other are not.

===Main Screen===
Main screen is divided into few categories, which contain modules. Every SHR Settings module has specified task - control GSM antenna power, set actual time etc.

===Settings: Phone===
Here you can check if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After while, list of operators should pop up.

You can't connect to operators marked [forbidden]. After failed connect, message is displayed.

Selecting operator from list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select current profile, which device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change ring tone, click on "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting sid tune as ring tone, there are available controls to select tune number from file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With "WiFi radio" toggle you can set, if wifi module should be powered. WiFi radio has to be turned on before trying to connect to WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your Gprs connection}}

To connect to GPRS network, just click "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, swith "Bluetooth radio" toggle to "On". After that, "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting fix. To do that, just click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set actual time. By default, time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click "OK" button.

'''Date'''

This module displays current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update data, click "Update" button.

Here you also force enable 500mA charging.

'''Display'''

With this slider you can easily tweak backlight power.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on some, you can either start, restart or stop service and view result.

===Settings: Others===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select theme used by shr-splash at boot and shutdown. After clicking "Preview", selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store it's data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called resources. If the software wanting to use the device is capable of requesting this resource via d-bus, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through SHR Setting or you can use fsoraw command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in /etc/network/interfaces.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

Connmand daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable after use.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better then for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR user bluez4 which completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) doesn exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your Freerunner. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phonealls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Install functional alarm application===
The pre-installed alarm clock ''elementary-alarm'' does not work properly on SHR. so replace it by ''ffalarm'':
opkg remove -force-depends elementary-alarm; opkg install ffalarms

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your freerunner. If new keys are generated or if you flash your Freerunner with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your Freerunner from the file. Otherwise you might be able to login in again. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding freerunner to your hosts===

You can add freerunner to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your freerunner is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your freerunner like this:

ssh root@neo

Which is shorter then this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only few preinstalled applications but it's repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.23_arm.ipk

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

GPE contacts saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). It's main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an excelent eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokomaze.png|200px|thumb|Mokomaze]]

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

SHR User Manual

2009-08-20T20:08:35Z

OlivierBerger: /* Network Connection */

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your Freerunner to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

'''SHR''' has been evolving from a simple release of customized software into a full distribution. Therefore, in SHR you can choose from several different graphical toolkits (for example GTK or EFL), different phone managers (SHR or Zhone), web browsers and other programs.

The SHR Team is busy with system maintenance and software building so you can concentrate on programming, using and [http://shr-project.org/trac/report reporting bugs].

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==SHR Specific==

At this point, there are some applications and procedures that are purely specific to SHR and would not run on another distribution. For example the phone applications (Dialer, Messages and Contacts) and SHR Settings depend heavily on the ophonekitd daemon.

As SHR is based on [[FSO]], basically any application using FSO has a chance to run, should all required libraries be available.

==Stability==

While many people use SHR as their daily phone, there are still occasional glitches and issues. This hurts the most when GSM stops working but this happens less and less. We wish you to have the best experiences with SHR.

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Source code===

View the sources at http://git.shr-project.org/git/

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* GPE File Manager
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||
* pythm

|-

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

|-

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

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links bellow for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

==Running SHR==
===Booting===
Press the power button shortly once to start the Freerunner. Booting splash screen will appear. First boot after new installation takes always a bit longer. Sometimes, it is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelve or by using the '''<''' left or right '''>''' arrows in the Top Shelve.

The Illume desktop can be easily customized - slide the Top Shelve down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' (the wrench) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the Top Shelve (for example Battery, GSM, Bluetooth etc.) are called '''Shelve gadgets''' and you can configure whether they are visible (on the front part of the top shelve) or hidden (you can access them by sliding the top shelve) through Illume Settings -> Display -> Shelve gadget.

Some screens are not resized properly to fit the Freerunner's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages.png|200px|thumb|Messages]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View.png|200px|thumb|View message]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View-chars.png|200px|thumb|Unicode support]]

|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages-Options.png|200px|thumb|Message options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Phonelog.png|200px|thumb|Phonelog]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a Notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelve cross.

===Post-Installation Script===
After flashing your Openmoko Freerunner you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your Freerunner via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on you Freerunner with:
neo# sh /home/root/SHRpostinstallation.sh

===Under the hood===

SHR is based on linux kernel and [http://www.openembedded.org/ Openembedded]. <tt>XGlamo</tt> is providing X server environment and [[Illume]] (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is [[FSO]] middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR <tt>ophonekitd</tt> daemon is run with X server start-up and it communicates with FSO via <tt>d-bus</tt>. SHR phone applications talk to <tt>ophonekitd</tt> and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. ''Dialer'', ''Contacts'' and ''Messages'' applications are part of the SHR internal <tt>libframeworkd-phonegui-efl</tt> library, ''Phonelog'' is an extra application written in python-gtk.

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your Freerunner. The <tt>root</tt> account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in /usr/share/shr/scenarii/ . To customize speaker volume edit /usr/share/shr/scenarii/gsmhandset.state and change control 4. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

====Alarm====
The default alarm clock application <tt>elementary-alarm</tt> is not working properly. You may want to remove it and install working alarm application called <tt>ffalarms</tt>:

opkg remove -force-depends elementary-alarm
opkg install ffalarms

====Init opkg database====
''Initialize opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

====SwapSpace====
The Freerunner has only 128mb ram, when this is used up applications get killed. This is particularly bad while doing opkg upgrade.

WARNING: this mights kill your sd card, since there might be a lot of read/writes to the same spot.

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so next time you boot there will be swap

echo "/swapfile swap swap defaults 0 0">> /etc/fstab

Make swap

mkswap /swapfile

Make the swap file work now:

swapon /swapfile

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

====Locate lost phone by GPS====
To locate your freerunner in case of lost or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an sms with text sentry:location to your Freerunner, the phone will turn on GPS, wait for a fix and send back sms with current location.

[[Cellhunter]] is a project with the objective to collect GPS location of GSM network cells. If this project is finished then sms-sentry could send the a rough GPS location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in Illume Top Shelve go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

Timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI Contact Sync]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI Calendar Sync]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="left";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:80%; text-align:left " |

opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 python-pygtk python-pygobject python-pycairo python-netserver python-netclient http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk

|

|}

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. Should you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If no, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your freerunner you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your freerunner. Because of the size of the maps you copy map to the Micro-SD card on your freerunner. Create a directory for the maps and copy the files from desktop to freerunner:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

===Start Navit===
Start <tt>Navit</tt> on your Freerunner for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the freerunner does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. In the background it uses [[FSO]] specific dbus calls as well as low level commands. The graphical interface is Elementary-Python based. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

While some settings are persistent over reboots, other are not.

===Main Screen===
Main screen is divided into few categories, which contain modules. Every SHR Settings module has specified task - control GSM antenna power, set actual time etc.

===Settings: Phone===
Here you can check if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After while, list of operators should pop up.

You can't connect to operators marked [forbidden]. After failed connect, message is displayed.

Selecting operator from list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select current profile, which device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change ring tone, click on "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting sid tune as ring tone, there are available controls to select tune number from file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With "WiFi radio" toggle you can set, if wifi module should be powered. WiFi radio has to be turned on before trying to connect to WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your Gprs connection}}

To connect to GPRS network, just click "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, swith "Bluetooth radio" toggle to "On". After that, "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting fix. To do that, just click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set actual time. By default, time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click "OK" button.

'''Date'''

This module displays current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update data, click "Update" button.

Here you also force enable 500mA charging.

'''Display'''

With this slider you can easily tweak backlight power.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on some, you can either start, restart or stop service and view result.

===Settings: Others===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select theme used by shr-splash at boot and shutdown. After clicking "Preview", selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store it's data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called resources. If the software wanting to use the device is capable of requesting this resource via d-bus, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through SHR Setting or you can use fsoraw command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in /etc/network/interfaces.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

Connmand daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable after use.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better then for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR user bluez4 which completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) doesn exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your Freerunner. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phonealls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Install functional alarm application===
The pre-installed alarm clock ''elementary-alarm'' does not work properly on SHR. so replace it by ''ffalarm'':
opkg remove -force-depends elementary-alarm; opkg install ffalarms

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your freerunner. If new keys are generated or if you flash your Freerunner with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your Freerunner from the file. Otherwise you might be able to login in again. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding freerunner to your hosts===

You can add freerunner to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your freerunner is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your freerunner like this:

ssh root@neo

Which is shorter then this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only few preinstalled applications but it's repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.23_arm.ipk

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

GPE contacts saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). It's main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an excelent eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokomaze.png|200px|thumb|Mokomaze]]

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

SHR User Manual

2009-08-20T20:02:38Z

OlivierBerger: /* Phone applications */

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your Freerunner to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

'''SHR''' has been evolving from a simple release of customized software into a full distribution. Therefore, in SHR you can choose from several different graphical toolkits (for example GTK or EFL), different phone managers (SHR or Zhone), web browsers and other programs.

The SHR Team is busy with system maintenance and software building so you can concentrate on programming, using and [http://shr-project.org/trac/report reporting bugs].

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==SHR Specific==

At this point, there are some applications and procedures that are purely specific to SHR and would not run on another distribution. For example the phone applications (Dialer, Messages and Contacts) and SHR Settings depend heavily on the ophonekitd daemon.

As SHR is based on [[FSO]], basically any application using FSO has a chance to run, should all required libraries be available.

==Stability==

While many people use SHR as their daily phone, there are still occasional glitches and issues. This hurts the most when GSM stops working but this happens less and less. We wish you to have the best experiences with SHR.

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Source code===

View the sources at http://git.shr-project.org/git/

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* GPE File Manager
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||
* pythm

|-

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

|-

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

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links bellow for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

==Running SHR==
===Booting===
Press the power button shortly once to start the Freerunner. Booting splash screen will appear. First boot after new installation takes always a bit longer. Sometimes, it is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelve or by using the '''<''' left or right '''>''' arrows in the Top Shelve.

The Illume desktop can be easily customized - slide the Top Shelve down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' (the wrench) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the Top Shelve (for example Battery, GSM, Bluetooth etc.) are called '''Shelve gadgets''' and you can configure whether they are visible (on the front part of the top shelve) or hidden (you can access them by sliding the top shelve) through Illume Settings -> Display -> Shelve gadget.

Some screens are not resized properly to fit the Freerunner's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: ''Dialer'', ''Contacts'', ''Messages'' and ''Phone log''.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages.png|200px|thumb|Messages]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View.png|200px|thumb|View message]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View-chars.png|200px|thumb|Unicode support]]

|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages-Options.png|200px|thumb|Message options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Phonelog.png|200px|thumb|Phonelog]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a Notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelve cross.

===Post-Installation Script===
After flashing your Openmoko Freerunner you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your Freerunner via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on you Freerunner with:
neo# sh /home/root/SHRpostinstallation.sh

===Under the hood===

SHR is based on linux kernel and [http://www.openembedded.org/ Openembedded]. <tt>XGlamo</tt> is providing X server environment and [[Illume]] (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is [[FSO]] middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR <tt>ophonekitd</tt> daemon is run with X server start-up and it communicates with FSO via <tt>d-bus</tt>. SHR phone applications talk to <tt>ophonekitd</tt> and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. ''Dialer'', ''Contacts'' and ''Messages'' applications are part of the SHR internal <tt>libframeworkd-phonegui-efl</tt> library, ''Phonelog'' is an extra application written in python-gtk.

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your Freerunner. The root account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in /usr/share/shr/scenarii/ . To customize speaker volume edit /usr/share/shr/scenarii/gsmhandset.state and change control 4. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

====Alarm====
The default alarm clock application <tt>elementary-alarm</tt> is not working properly. You may want to remove it and install working alarm application called <tt>ffalarms</tt>:

opkg remove -force-depends elementary-alarm
opkg install ffalarms

====Init opkg database====
''Initialize opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

====SwapSpace====
The Freerunner has only 128mb ram, when this is used up applications get killed. This is particularly bad while doing opkg upgrade.

WARNING: this mights kill your sd card, since there might be a lot of read/writes to the same spot.

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so next time you boot there will be swap

echo "/swapfile swap swap defaults 0 0">> /etc/fstab

Make swap

mkswap /swapfile

Make the swap file work now:

swapon /swapfile

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

====Locate lost phone by GPS====
To locate your freerunner in case of lost or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an sms with text sentry:location to your Freerunner, the phone will turn on GPS, wait for a fix and send back sms with current location.

[[Cellhunter]] is a project with the objective to collect GPS location of GSM network cells. If this project is finished then sms-sentry could send the a rough GPS location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in Illume Top Shelve go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

Timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI Contact Sync]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI Calendar Sync]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="left";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:80%; text-align:left " |

opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 python-pygtk python-pygobject python-pycairo python-netserver python-netclient http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk

|

|}

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. Should you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If no, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your freerunner you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your freerunner. Because of the size of the maps you copy map to the Micro-SD card on your freerunner. Create a directory for the maps and copy the files from desktop to freerunner:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

===Start Navit===
Start <tt>Navit</tt> on your Freerunner for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the freerunner does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. In the background it uses [[FSO]] specific dbus calls as well as low level commands. The graphical interface is Elementary-Python based. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

While some settings are persistent over reboots, other are not.

===Main Screen===
Main screen is divided into few categories, which contain modules. Every SHR Settings module has specified task - control GSM antenna power, set actual time etc.

===Settings: Phone===
Here you can check if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After while, list of operators should pop up.

You can't connect to operators marked [forbidden]. After failed connect, message is displayed.

Selecting operator from list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select current profile, which device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change ring tone, click on "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting sid tune as ring tone, there are available controls to select tune number from file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With "WiFi radio" toggle you can set, if wifi module should be powered. WiFi radio has to be turned on before trying to connect to WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your Gprs connection}}

To connect to GPRS network, just click "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, swith "Bluetooth radio" toggle to "On". After that, "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting fix. To do that, just click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set actual time. By default, time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click "OK" button.

'''Date'''

This module displays current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update data, click "Update" button.

Here you also force enable 500mA charging.

'''Display'''

With this slider you can easily tweak backlight power.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on some, you can either start, restart or stop service and view result.

===Settings: Others===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select theme used by shr-splash at boot and shutdown. After clicking "Preview", selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store it's data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called resources. If the software wanting to use the device is capable of requesting this resource via d-bus, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through SHR Setting or you can use fsoraw command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in /etc/network/interfaces.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

Connmand daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable after use.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better then for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR user bluez4 which completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) doesn exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your Freerunner. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phonealls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Install functional alarm application===
The pre-installed alarm clock ''elementary-alarm'' does not work properly on SHR. so replace it by ''ffalarm'':
opkg remove -force-depends elementary-alarm; opkg install ffalarms

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your freerunner. If new keys are generated or if you flash your Freerunner with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your Freerunner from the file. Otherwise you might be able to login in again. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding freerunner to your hosts===

You can add freerunner to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your freerunner is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your freerunner like this:

ssh root@neo

Which is shorter then this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only few preinstalled applications but it's repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.23_arm.ipk

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

GPE contacts saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). It's main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an excelent eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokomaze.png|200px|thumb|Mokomaze]]

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

SHR User Manual

2009-08-20T20:00:35Z

OlivierBerger: /* First look */

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your Freerunner to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

'''SHR''' has been evolving from a simple release of customized software into a full distribution. Therefore, in SHR you can choose from several different graphical toolkits (for example GTK or EFL), different phone managers (SHR or Zhone), web browsers and other programs.

The SHR Team is busy with system maintenance and software building so you can concentrate on programming, using and [http://shr-project.org/trac/report reporting bugs].

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==SHR Specific==

At this point, there are some applications and procedures that are purely specific to SHR and would not run on another distribution. For example the phone applications (Dialer, Messages and Contacts) and SHR Settings depend heavily on the ophonekitd daemon.

As SHR is based on [[FSO]], basically any application using FSO has a chance to run, should all required libraries be available.

==Stability==

While many people use SHR as their daily phone, there are still occasional glitches and issues. This hurts the most when GSM stops working but this happens less and less. We wish you to have the best experiences with SHR.

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Source code===

View the sources at http://git.shr-project.org/git/

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* GPE File Manager
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||
* pythm

|-

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

|-

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

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links bellow for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

==Running SHR==
===Booting===
Press the power button shortly once to start the Freerunner. Booting splash screen will appear. First boot after new installation takes always a bit longer. Sometimes, it is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelve or by using the '''<''' left or right '''>''' arrows in the Top Shelve.

The Illume desktop can be easily customized - slide the Top Shelve down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' (the wrench) provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the Top Shelve (for example Battery, GSM, Bluetooth etc.) are called '''Shelve gadgets''' and you can configure whether they are visible (on the front part of the top shelve) or hidden (you can access them by sliding the top shelve) through Illume Settings -> Display -> Shelve gadget.

Some screens are not resized properly to fit the Freerunner's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: Dialer, Contacts, Messages and Phone log.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages.png|200px|thumb|Messages]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View.png|200px|thumb|View message]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View-chars.png|200px|thumb|Unicode support]]

|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages-Options.png|200px|thumb|Message options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Phonelog.png|200px|thumb|Phonelog]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a Notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelve cross.

===Post-Installation Script===
After flashing your Openmoko Freerunner you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your Freerunner via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on you Freerunner with:
neo# sh /home/root/SHRpostinstallation.sh

===Under the hood===

SHR is based on linux kernel and [http://www.openembedded.org/ Openembedded]. <tt>XGlamo</tt> is providing X server environment and [[Illume]] (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is [[FSO]] middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR <tt>ophonekitd</tt> daemon is run with X server start-up and it communicates with FSO via <tt>d-bus</tt>. SHR phone applications talk to <tt>ophonekitd</tt> and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. ''Dialer'', ''Contacts'' and ''Messages'' applications are part of the SHR internal <tt>libframeworkd-phonegui-efl</tt> library, ''Phonelog'' is an extra application written in python-gtk.

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your Freerunner. The root account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in /usr/share/shr/scenarii/ . To customize speaker volume edit /usr/share/shr/scenarii/gsmhandset.state and change control 4. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

====Alarm====
The default alarm clock application <tt>elementary-alarm</tt> is not working properly. You may want to remove it and install working alarm application called <tt>ffalarms</tt>:

opkg remove -force-depends elementary-alarm
opkg install ffalarms

====Init opkg database====
''Initialize opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

====SwapSpace====
The Freerunner has only 128mb ram, when this is used up applications get killed. This is particularly bad while doing opkg upgrade.

WARNING: this mights kill your sd card, since there might be a lot of read/writes to the same spot.

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so next time you boot there will be swap

echo "/swapfile swap swap defaults 0 0">> /etc/fstab

Make swap

mkswap /swapfile

Make the swap file work now:

swapon /swapfile

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

====Locate lost phone by GPS====
To locate your freerunner in case of lost or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an sms with text sentry:location to your Freerunner, the phone will turn on GPS, wait for a fix and send back sms with current location.

[[Cellhunter]] is a project with the objective to collect GPS location of GSM network cells. If this project is finished then sms-sentry could send the a rough GPS location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in Illume Top Shelve go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

Timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI Contact Sync]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI Calendar Sync]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="left";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:80%; text-align:left " |

opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 python-pygtk python-pygobject python-pycairo python-netserver python-netclient http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk

|

|}

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. Should you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If no, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your freerunner you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your freerunner. Because of the size of the maps you copy map to the Micro-SD card on your freerunner. Create a directory for the maps and copy the files from desktop to freerunner:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

===Start Navit===
Start <tt>Navit</tt> on your Freerunner for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the freerunner does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. In the background it uses [[FSO]] specific dbus calls as well as low level commands. The graphical interface is Elementary-Python based. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

While some settings are persistent over reboots, other are not.

===Main Screen===
Main screen is divided into few categories, which contain modules. Every SHR Settings module has specified task - control GSM antenna power, set actual time etc.

===Settings: Phone===
Here you can check if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After while, list of operators should pop up.

You can't connect to operators marked [forbidden]. After failed connect, message is displayed.

Selecting operator from list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select current profile, which device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change ring tone, click on "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting sid tune as ring tone, there are available controls to select tune number from file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With "WiFi radio" toggle you can set, if wifi module should be powered. WiFi radio has to be turned on before trying to connect to WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your Gprs connection}}

To connect to GPRS network, just click "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, swith "Bluetooth radio" toggle to "On". After that, "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting fix. To do that, just click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set actual time. By default, time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click "OK" button.

'''Date'''

This module displays current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update data, click "Update" button.

Here you also force enable 500mA charging.

'''Display'''

With this slider you can easily tweak backlight power.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on some, you can either start, restart or stop service and view result.

===Settings: Others===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select theme used by shr-splash at boot and shutdown. After clicking "Preview", selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store it's data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called resources. If the software wanting to use the device is capable of requesting this resource via d-bus, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through SHR Setting or you can use fsoraw command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in /etc/network/interfaces.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

Connmand daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable after use.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better then for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR user bluez4 which completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) doesn exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your Freerunner. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phonealls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Install functional alarm application===
The pre-installed alarm clock ''elementary-alarm'' does not work properly on SHR. so replace it by ''ffalarm'':
opkg remove -force-depends elementary-alarm; opkg install ffalarms

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your freerunner. If new keys are generated or if you flash your Freerunner with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your Freerunner from the file. Otherwise you might be able to login in again. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding freerunner to your hosts===

You can add freerunner to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your freerunner is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your freerunner like this:

ssh root@neo

Which is shorter then this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only few preinstalled applications but it's repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.23_arm.ipk

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

GPE contacts saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). It's main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an excelent eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokomaze.png|200px|thumb|Mokomaze]]

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

SHR User Manual

2009-08-20T17:28:34Z

OlivierBerger: /* Under the hood */ nicer typesetting

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your Freerunner to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

'''SHR''' has been evolving from a simple release of customized software into a full distribution. Therefore, in SHR you can choose from several different graphical toolkits (for example GTK or EFL), different phone managers (SHR or Zhone), web browsers and other programs.

The SHR Team is busy with system maintenance and software building so you can concentrate on programming, using and [http://shr-project.org/trac/report reporting bugs].

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==SHR Specific==

At this point, there are some applications and procedures that are purely specific to SHR and would not run on another distribution. For example the phone applications (Dialer, Messages and Contacts) and SHR Settings depend heavily on the ophonekitd daemon.

As SHR is based on [[FSO]], basically any application using FSO has a chance to run, should all required libraries be available.

==Stability==

While many people use SHR as their daily phone, there are still occasional glitches and issues. This hurts the most when GSM stops working but this happens less and less. We wish you to have the best experiences with SHR.

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Source code===

View the sources at http://git.shr-project.org/git/

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* GPE File Manager
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||
* pythm

|-

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

|-

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

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links bellow for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

==Running SHR==
===Booting===
Press the power button shortly once to start the Freerunner. Booting splash screen will appear. First boot after new installation takes always a bit longer. Sometimes, it is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelve or by using the '''<''' left or right '''>''' arrows in the Top Shelve.

The Illume desktop can be easily customized - slide the Top Shelve down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the Top Shelve (for example Battery, GSM, Bluetooth etc.) are called '''Shelve gadgets''' and you can configure whether they are visible (on the front part of the top shelve) or hidden (you can access them by sliding the top shelve) through Illume Settings -> Display -> Shelve gadget.

Some screens are not resized properly to fit the Freerunner's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: Dialer, Contacts, Messages and Phone log.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages.png|200px|thumb|Messages]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View.png|200px|thumb|View message]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View-chars.png|200px|thumb|Unicode support]]

|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages-Options.png|200px|thumb|Message options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Phonelog.png|200px|thumb|Phonelog]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a Notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelve cross.

===Post-Installation Script===
After flashing your Openmoko Freerunner you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your Freerunner via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on you Freerunner with:
neo# sh /home/root/SHRpostinstallation.sh

===Under the hood===

SHR is based on linux kernel and [http://www.openembedded.org/ Openembedded]. <tt>XGlamo</tt> is providing X server environment and [[Illume]] (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is [[FSO]] middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR <tt>ophonekitd</tt> daemon is run with X server start-up and it communicates with FSO via <tt>d-bus</tt>. SHR phone applications talk to <tt>ophonekitd</tt> and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. ''Dialer'', ''Contacts'' and ''Messages'' applications are part of the SHR internal <tt>libframeworkd-phonegui-efl</tt> library, ''Phonelog'' is an extra application written in python-gtk.

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your Freerunner. The root account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in /usr/share/shr/scenarii/ . To customize speaker volume edit /usr/share/shr/scenarii/gsmhandset.state and change control 4. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

====Alarm====
The default alarm clock application <tt>elementary-alarm</tt> is not working properly. You may want to remove it and install working alarm application called <tt>ffalarms</tt>:

opkg remove -force-depends elementary-alarm
opkg install ffalarms

====Init opkg database====
''Initialize opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

====SwapSpace====
The Freerunner has only 128mb ram, when this is used up applications get killed. This is particularly bad while doing opkg upgrade.

WARNING: this mights kill your sd card, since there might be a lot of read/writes to the same spot.

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so next time you boot there will be swap

echo "/swapfile swap swap defaults 0 0">> /etc/fstab

Make swap

mkswap /swapfile

Make the swap file work now:

swapon /swapfile

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

====Locate lost phone by GPS====
To locate your freerunner in case of lost or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an sms with text sentry:location to your Freerunner, the phone will turn on GPS, wait for a fix and send back sms with current location.

[[Cellhunter]] is a project with the objective to collect GPS location of GSM network cells. If this project is finished then sms-sentry could send the a rough GPS location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in Illume Top Shelve go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

Timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI Contact Sync]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI Calendar Sync]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="left";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:80%; text-align:left " |

opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 python-pygtk python-pygobject python-pycairo python-netserver python-netclient http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk

|

|}

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. Should you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If no, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your freerunner you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your freerunner. Because of the size of the maps you copy map to the Micro-SD card on your freerunner. Create a directory for the maps and copy the files from desktop to freerunner:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

===Start Navit===
Start <tt>Navit</tt> on your Freerunner for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the freerunner does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. In the background it uses [[FSO]] specific dbus calls as well as low level commands. The graphical interface is Elementary-Python based. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

While some settings are persistent over reboots, other are not.

===Main Screen===
Main screen is divided into few categories, which contain modules. Every SHR Settings module has specified task - control GSM antenna power, set actual time etc.

===Settings: Phone===
Here you can check if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After while, list of operators should pop up.

You can't connect to operators marked [forbidden]. After failed connect, message is displayed.

Selecting operator from list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select current profile, which device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change ring tone, click on "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting sid tune as ring tone, there are available controls to select tune number from file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With "WiFi radio" toggle you can set, if wifi module should be powered. WiFi radio has to be turned on before trying to connect to WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your Gprs connection}}

To connect to GPRS network, just click "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, swith "Bluetooth radio" toggle to "On". After that, "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting fix. To do that, just click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set actual time. By default, time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click "OK" button.

'''Date'''

This module displays current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update data, click "Update" button.

Here you also force enable 500mA charging.

'''Display'''

With this slider you can easily tweak backlight power.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on some, you can either start, restart or stop service and view result.

===Settings: Others===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select theme used by shr-splash at boot and shutdown. After clicking "Preview", selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store it's data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called resources. If the software wanting to use the device is capable of requesting this resource via d-bus, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through SHR Setting or you can use fsoraw command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in /etc/network/interfaces.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

Connmand daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable after use.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better then for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR user bluez4 which completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) doesn exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your Freerunner. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phonealls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Install functional alarm application===
The pre-installed alarm clock ''elementary-alarm'' does not work properly on SHR. so replace it by ''ffalarm'':
opkg remove -force-depends elementary-alarm; opkg install ffalarms

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your freerunner. If new keys are generated or if you flash your Freerunner with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your Freerunner from the file. Otherwise you might be able to login in again. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding freerunner to your hosts===

You can add freerunner to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your freerunner is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your freerunner like this:

ssh root@neo

Which is shorter then this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only few preinstalled applications but it's repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.23_arm.ipk

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

GPE contacts saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). It's main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an excelent eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokomaze.png|200px|thumb|Mokomaze]]

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]

SHR User Manual

2009-08-20T17:26:19Z

OlivierBerger: /* First look */

{{Languages|SHR User Manual}}
{| align="right"
| __TOC__
|}

==SHR Introduction==

Welcome to '''[[SHR]]''', the world of community driven distribution for (not only) OpenmokoNeo phones.

'''SHR''' (Stable Hybrid Release) is here to provide you with Root FileSystem images that you can easily install onto your Freerunner to use as a daily phone. It's filled with prepackaged software that can be installed upon demand by users, it can also be used by developers as a base image for customized and flavored distribution or release. SHR unstable is a testing environment before software get stabilized and it is the main testing ground for [[FSO]] releases. SHR testing images (currently not available) provide as much stability as possible for day-to-day usage.

'''SHR''' has been evolving from a simple release of customized software into a full distribution. Therefore, in SHR you can choose from several different graphical toolkits (for example GTK or EFL), different phone managers (SHR or Zhone), web browsers and other programs.

The SHR Team is busy with system maintenance and software building so you can concentrate on programming, using and [http://shr-project.org/trac/report reporting bugs].

SHR users, readers of this manual, please report improvements, discrepancies or missing features on this page to <tt>vanous @ penguin . cz</tt>. Thank you.

[http://shr-project.org SHR Project page]

==SHR Specific==

At this point, there are some applications and procedures that are purely specific to SHR and would not run on another distribution. For example the phone applications (Dialer, Messages and Contacts) and SHR Settings depend heavily on the ophonekitd daemon.

As SHR is based on [[FSO]], basically any application using FSO has a chance to run, should all required libraries be available.

==Stability==

While many people use SHR as their daily phone, there are still occasional glitches and issues. This hurts the most when GSM stops working but this happens less and less. We wish you to have the best experiences with SHR.

==Installation==

===Getting SHR===

First, determine which model of phone you have, the GTA01(neo1973) or the GTA02(FreeRunner).

You need to download two files for your version as above, kernel and root filesystem. Depending whether you will be installing into the internal NAND memory or on µSD card, you need to either get .jffs2 file for nand or .tar.gz file for µSD.

At this point, there are no recent testing images so for the GTA02 Freerunner you need to download the images of unstable release from http://build.shr-project.org/shr-unstable/images/om-gta02/

- Get the latest kernel: [http://build.shr-project.org/shr-unstable/images/om-gta02/uImage-om-gta02-latest.bin uImage-om-gta02-latest.bin]

- Get the root filesystem, for nand: [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.jffs2 full-om-gta02.jffs2], (for µSD): [http://build.shr-project.org/shr-unstable/images/om-gta02/full-om-gta02.tar.gz full-om-gta02.tar.gz]

These are full images. You can also choose image with less packages, marked as '''lite''' which can be upgraded to the full image by running

opkg update
opkg install task-shr-apps task-shr-games task-shr-gtk

===Source code===

View the sources at http://git.shr-project.org/git/

===Image content===
{|class="wikitable" border="1" cellpadding="0" cellspacing="0" width=100%

! width=16%| !! width=42%|Full image content !! width=42%|SHR-Image LITE Content
|-
| Window Manager ||
* illume
||
* illume
|-
| Engine ||
* frameworkd
||
* frameworkd
|-
| Telephony ||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
||
* Dialer (Call/Receive, DTMF, Speaker mode)
* SIM Contacts (Call/Modify/Create/...)
* SIM Messages (Receive/Compose/Answer/...)
* Pyphonelog (received/emitted/missed calls logging)
|-
| GPS ||
* TangoGPS
||
* TangoGPS
|-
| Utilities ||
* Calculator
* Alarm
* GPE Scap (Take screenshot)
* GPE File Manager
* GPE Sketchbook
* vala-terminal
||
* Calculator
* Alarm
* GPE File Manager
* vala-terminal

|-

| Media ||

* Vagalume
* Intone
||
* pythm

|-

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

|-

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

|-
|}

===Installation on Flash===

In order to install your SHR distribution directly to your Freerunner Flash memory (NAND), you need to get the desired filesystem file ( <tt>.jffs2</tt> ) as described above and flash your device using the <tt>dfu-util</tt> tool.

Please visit [[Flashing the Neo FreeRunner]] for more details about flashing and see [[Dfu-util]] for detailed information about the dfu-util.

Command to flash the filesystem and the kernel

dfu-util -a rootfs -R -D shr-image-om-gta02.jffs2
dfu-util -a kernel -R -D uImage-om-gta02-latest.bin

===Installation on µSD Card===

Installing SHR on your µSD Card depends on the Bootloader you are using, ''uBoot'' or ''Qi''.

In simply words, difference between both systems resides on how you must prepare your µSD Card and files you use to fill them:

* If you use ''uBoot'', you need to create two partitions. First partition, not so big, in FAT16 where you have to place the kernel file (<tt>uImage-om-gta02-latest.bin</tt>) and second partition in ext2 or ext3 where you have to uncompress the filesystem file (<tt>shr-image-om-gta02.tar.gz</tt>).

* If you use ''Qi'', you only need an ext2 partition into your µSD Card where you uncompress the filesystem image file (<tt>shr-image-om-gta02.tar.gz</tt>). In this case Qi Bootloader is going to look for the kernel image into the <tt>/boot</tt> directory for file named <tt>uImage-GTA02.bin</tt> .

Please visit links bellow for detailed information and tips:

For [[Booting from SD | uBoot]] and for [[Qi]].

===SHR version===

Should you ever later wonder what version of SHR you have actually installed, please run

cat /etc/shr-version

or check SHR Settings -> Other -> Image information

==Running SHR==
===Booting===
Press the power button shortly once to start the Freerunner. Booting splash screen will appear. First boot after new installation takes always a bit longer. Sometimes, it is recommended to reboot after this first boot, to make sure all packages got initialized properly.

[[Image:Shr-boot-preview.png|200px|thumb|center|SHR Boot Splash screen]]

===Initial Setup===

[[Image:SHR-Setup-Language.png|200px|thumb|Initial setup]]
On the first boot, Setup is automatically initiated to walk the user through basic setup of the Enlightenment desktop environment. You are able to choose preferred language of the desktop environment, Illume SHR themed profile or select default menu (only one at the moment).

On the Add icon screen you can add icons for some application. If you add a terminal based application like mplayer, you will see an icon but no application running upon click, as it will run in the background.
Last screen allow settin up quick launch applications.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Setup-Profile.png|200px|thumb|Theme profile]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Menu.png|200px|thumb|Menu]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Add-Icons.png|200px|thumb|Add icons]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Setup-Quick-Launch.png|200px|thumb|Quick launch]]

|}

===SIM Auth===

[[Image:SHR-SIM-Auth.png|200px|thumb|center|SIM Auth]]
SIM Pin is asked for upon start up.

===First look===
[[Image:SHR-First-Look.png|200px|thumb|Desktop screen]]
'''Illume desktop''' is default home screen of the SHR desktop. Application files located in /usr/share/applications are displayed here. All applications are ran fullscreen and you can switch between them by using the Task switcher in the Top Shelve or by using the '''<''' left or right '''>''' arrows in the Top Shelve.

The Illume desktop can be easily customized - slide the Top Shelve down and tap the Settings icon (Wrench).

{{Note|TIP: for better access of the Settings icon, tap and hold the Settings icon, then drag it to the right.}}

'''Illume settings''' provides various options to alter the desktop environment. You can change sizes of elements, single or double click, wallpaper. To access all the various options, open Illume Settings and slide the visible icons to the left, to preview more options on the right hand side.

The little applets in the Top Shelve (for example Battery, GSM, Bluetooth etc.) are called '''Shelve gadgets''' and you can configure whether they are visible (on the front part of the top shelve) or hidden (you can access them by sliding the top shelve) through Illume Settings -> Display -> Shelve gadget.

Some screens are not resized properly to fit the Freerunner's display - for example the Wallpapper setting. This is a known bug already reported upstream.



===Phone applications===

Besides other software, SHR comes with 4 main phone applications: Dialer, Contacts, Messages and Phone log.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Dialer.png|200px|thumb|Dialer]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts.png|200px|thumb|Contacts]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contacts-Options.png|200px|thumb|Contact options]]
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Contact-Add.png|200px|thumb|Add new contact]]
|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages.png|200px|thumb|Messages]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Messages-Options.png|200px|thumb|Messages options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View.png|200px|thumb|View message]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Message-View-chars.png|200px|thumb|Unicode support]]

|}

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |
[[Image:SHR-Mesages-Options.png|200px|thumb|Message options]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Phonelog.png|200px|thumb|Phonelog]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:25% " |

[[Image:SHR-Dialer-Active.png|200px|thumb|Active call]]

|}

Upon a missed call or an unread message there is a Notifier that presents a screen with button to run Messages or Phonelog application, or you can simply close the Notifier with the Top Shelve cross.

===Post-Installation Script===
After flashing your Openmoko Freerunner you can do some modification mentioned below in this manual. The shell commands are collected in a [[SHR post-installation]] that you can transfer to your Freerunner via ''scp'' and execute it with ''sh''.
Please go through the script and check if the applications to be installed is that want you want. If do not understand, what is going on in the script, proceed with this manual and select every step manually. If understand the script it might save you some time:
desktop#
scp SHRpostinstallation.sh root@192.168.0.202/home/root/SHRpostinstallation.sh
Start the shell script on you Freerunner with:
neo# sh /home/root/SHRpostinstallation.sh

===Under the hood===

SHR is based on linux kernel and [http://www.openembedded.org/ Openembedded]. XGlamo is providing X server environment and [[Illume]] (Enlightment window manager module for small devices) is providing comfortable finger controlled desktop environment. Under the hood of the pretty desktop there is [[FSO]] middleware talking to the GSM modem, GPS module as well as to the other bits of hardware. SHR ophonekitd daemon is run with X server start up and it communicates with FSO via d-bus. SHR phone applications talk to ophonekitd and also to FSO so for example when you receive a phone call, the dialer is launched to provide a way of answering it. Dialer, Contacts and Messages applications are part of the SHR internal libframeworkd-phonegui-efl library, Phonelog is an extra application written in python-gtk.

===First steps===

Right after installation and first boot you might want to do a few initial steps:
====Network Connection====
''Establish network connection'' and SSH into your Freerunner. The root account uses no password by default. You can establish connection either via USB to your desktop and enable NAT or you can connect through Wifi. If you use USB, some setup is required on the desktop side, please read [[USB_Networking]]. For Wifi, you can use [[#Network manager|Network Manager]]

====GSM Network====
''Check if GSM is working correctly'' - observe the GSM gadget in the Top Shelve and see reported signal of your GSM operator. If GSM Gadget seems not be running, click ''Settings'' and later on ''Phone''. Move ''GSM Antenna'' to ''On''.

====Audio: Volume====
''Check and set call volume'' - this is handled by alsa state files in /usr/share/shr/scenarii/ . To customize speaker volume edit /usr/share/shr/scenarii/gsmhandset.state and change control 4. Values between from 105 to 120 might be sufficient:

vi /usr/share/shr/scenarii/gsmhandset.state

control.4 {
comment.access 'read write'
comment.type INTEGER
comment.count 2
comment.range '0 - 127'
iface MIXER
name 'Speaker Playback Volume'
value.0 116
value.1 116
}

Should you want to alter more parameters be aware that each file is a set of value for the 94 parameters. Some of the important ones are:

Control 48: internal mic of the tel (set to 2 or 3)
Control 4 : internal speaker (set from 110 to 120)
Control 49: headset mic
Control 3 : headset speaker

====Set Regional Codes====
For the default SHR phone applications to be able to correctly parse incoming calls/messages and match them with your contacts, you will need to edit the following file:

vi /etc/phone-utils.conf

And change the file to reflect your country and area, example for Czech republic:

[local]
international_prefix = 00
national_prefix = 0
#for the cz
country_code = 42
area_code = 0

====Alarm====
The default alarm clock application <tt>elementary-alarm</tt> is not working properly. You may want to remove it and install working alarm application called <tt>ffalarms</tt>:

opkg remove -force-depends elementary-alarm
opkg install ffalarms

====Init opkg database====
''Initialize opkg database'' in order to install some applications from SHR repositories or from other sources, for example [[http://opkg.org opkg.org]]. While still being online, you need to first run

opkg update

Searching in the opkg database can take a long time. You can speed things up by dumping the database into a file and grepping it through.

Do this only once or after every opkg update:

opkg list > packages.txt

Then you can search quickly for package name, for example for navit:

grep navit packages.txt

====SwapSpace====
The Freerunner has only 128mb ram, when this is used up applications get killed. This is particularly bad while doing opkg upgrade.

WARNING: this mights kill your sd card, since there might be a lot of read/writes to the same spot.

dd if=/dev/zero of=/swapfile bs=1024 count=65536

Add a line to fstab so next time you boot there will be swap

echo "/swapfile swap swap defaults 0 0">> /etc/fstab

Make swap

mkswap /swapfile

Make the swap file work now:

swapon /swapfile

====Changing root password====

SHR is shipped without root password (just press enter)

This is very dangerous if you connect using wifi, or USB. You need to activate the root password:

passwd

then type your selected password (2 times)

====Locate lost phone by GPS====
To locate your freerunner in case of lost or theft by getting SMS with GPS location install '''sms-sentry''':

opkg install sms-sentry

Then, upon sending an sms with text sentry:location to your Freerunner, the phone will turn on GPS, wait for a fix and send back sms with current location.

[[Cellhunter]] is a project with the objective to collect GPS location of GSM network cells. If this project is finished then sms-sentry could send the a rough GPS location just by identifying the current distances (strength of signal) to the available GSM network cells, even when the GPS satellites are not available (e.g. in a house).

===Localization===
[[Image:SHR-Illume-Settings-Languages.png|200px|thumb|Setting Language]]

You can change the language of the SHR desktop environment by using the Settings of Illume. For Example, for Czech language: in Illume Top Shelve go to Wrench (Settings) -> Language -> Language Settings -> and choose: Čeština. If your language is not in the menu you can install by using opkg.

You can list all available languages by running:

opkg list | grep glibc-locale-

And install the language of your choice (for example czech):

opkg install glibc-locale-cs

After this, the Language Settings of Illume will offer Czech.

This will localize the Illume environment and will also set correct lang environment variable. If you wish to have translations for other applications, you need to install them again (presuming they are available):

This will install czech localisation for SHR phone applications, SHR Settings and TangoGps:

opkg install libframeworkd-phonegui-efl-locale-cs shr-settings-locale-cs tangogps-locale-cs

For localized terminal environment (ssh login) set lang variables set /etc/profile, example for Czech language:

export LANG=cs_CZ
export LC_ALL=cs_CZ

The Illume keyboard offers english dictionary correction by default. You can list all the dictionaries available for installation:

opkg list | grep illume-dic

If your language is not available and english is bothering you, you can set an empty dictionary:

echo "" > /usr/lib/enlightenment/modules/illume/dicts/None.dic

By using it, it will get filled by the words you use and after time will start helping and correcting your typing.

===Date and time===

Timezone is automatically retrieved from the GSM network. Date and time are automatically set from GPS or Network. The easiest way of setting the time for the first time is to run TangoGps (GPS & Map icon) and obtaining GPS fix. Time will then be set automatically after several minutes.

Time can set time also manually.

Via SHR-Settings -> Date/time -> Set time

From linux based desktop:

ssh root@192.168.0.202 "date -u -s `date -u +%m%d%H%M%Y.%S`"

You can also set the hardware clock to the system time:

hwclock --systohc

It is possible to instruct framework on how to set the time and timezone in /etc/frameworkd.conf :

[otimed]
# a list of time/zone sources to use or NONE
timesources = GPS,NTP
zonesources = GSM
# use an ip address here, otherwise DNS resolution will block
ntpserver = 134.169.172.1

To disable automatic date/zone settings, simply create an empty [otimed] section in /etc/frameworkd.conf

===File transfer===

After you have established network connection, it is very easy to access and transfer files. The easiest solution is to use Konqueror or Nautilus on your desktop computer and type the following on your location bar. This should provide you with a view of the client's file system on Konqueror or Nautilus and you can easily drag-drop and copy-paste files.

sftp://root@192.168.0.202

===Data synchronization===
[[Image:SHR-PISI.png|200px|thumb|PISI Contact Sync]]
[[Image:SHR-PISI-dates.png|200px|thumb|PISI Calendar Sync]]

You can synchronize your contacts and appointments data with various sources. The sync can by done by program called [http://pisi.projects.openmoko.org/ PISI] . SIM contacts and calendar entries are currently possible to sync on SHR. You can also synchronize OPIMD contacts, these data are however so far no used in the current shr phone applications, but are used by for example Litephone.

For calendar install dates

opkg install dates

Supported Contacts data sources:
* SIM via DBUS (e.g. SHR)
* QTopia address book (e.g. OM 2008.12)
* LDAP (read only)
* VCF files (local / webdav)
* Google contacts
* OPIMD

Supported Calendar data sources:
* Google calendars
* ICalendar files (local / webdav)

To install PISI, run

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="left";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:80%; text-align:left " |

opkg install http://www.opkg.org/packages/1_python-vobject_0.8.1_armv4t.ipk http://www.opkg.org/packages/0_python-webdav_0.1.2_armv4t.ipk python-sqlite3 python-pygtk python-pygobject python-pycairo python-netserver python-netclient http://www.opkg.org/packages/1_python-gdata_1.3.0_armv4t.ipk python-misc http://www.opkg.org/packages/0_python-ldap_2.3.6_armv4t.ipk http://www.opkg.org/packages/1_python-dateutil_1.4.1_armv4t.ipk http://www.opkg.org/packages/openldap_2.3.43_armv4t.ipk http://projects.openmoko.org/frs/download.php/891/pisi_0.4.5_armv4t.ipk

|

|}

Configuration example, .pisi/conf to sync contacts and calendar with google calendar and contacts with google mail:

[googleCalendar]
description=My Google Calendar
module=calendar_google
user=user@gmail.com
password=secret
calendarid=user@gmail.com

[pimlicodates]
description= Pimlico Dates
module=calendar_ics
path=/home/root/.evolution/calendar/local/system/calendar.ics
postprocess=killall e-calendar-factory

[googlecontacts]
description=Google Contacts Account
module=contacts_google
user=user@gmail.com
password=secret

[remoteIcs]
description= Remote ICS on Webdav
module=calendar_remoteics
url=http://webdav.davserver.net/private/pim/
file=remotecalendar.ics
username=<LOGIN>
password=<PASSWORD>

[shrsim]
description=SHR SIM Card Contacts
module=contacts_dbussim
max_simentries = 250
simentry_name_maxlength=18

Another way of importing contacts via Vcard file is possible with [gopher://gopher.fnordpol.de/9/data/DbusAccessScripts_0.0.0.tar.gz this] script written by [[User:Zem#DBus_Access_Scripts|Zem]].

===Reporting bugs===

SHR is a work in progress. Should you experience issues, please report them back to SHR. With your report provide logs from

/var/log/ophonekitd
/var/log/frameworkd

To report a bug, please go to http://shr-project.org/trac/report

Check if the bug is already reported. If no, add a ticket, be as much precise as you can in the title and the description, in what circumstances the issue happened and so on.

==Car Navigation==
''Navit'' is a car navigation system with routing engine. It can calculate a route and do on screen and voice road navigation. Maps need to be downloaded beforehand, please check [http://wiki.navit-project.org/index.php/Main_Page#Maps Navit website]. You can get Openstreetmaps through [http://maps.navit-project.org/download/ Navit map extractor], after you download the map it needs to be specified in the .navit/navit.xml file.

===Add opkg feed===
To install <tt>navit</tt> as a car navigation system on your freerunner you have to add the feed for the installer <tt>opkg</tt>
http://download.navit-project.org/navit/openmoko/svn/
You can do this by:
echo src navit http://download.navit-project.org/navit/openmoko/svn > /etc/opkg/navit-feed.conf
opkg update

===Install Navit===
Install [[Navit]]: [[Image:navit1.png|200px|thumb|Navit on SHR with OpenStreetMaps]]
opkg install navit
Navit will be auto-updated when you run <tt>opkg upgrade</tt> later.

===Workaround libgps for Navit===
Navit on SHR has in the currently available version (08/2009) a <tt>libgps</tt> problem. You solve this by:
opkg install libgps17
ln -s /usr/lib/libgps.so.17 /usr/lib/libgps.so.16

===Install Maps===
Use [http://maps.navit-project.org/download/ Navit pre-processed OSM maps]. With your browser on desktop:
* Navigate to the region you want,
* mark a rectangle for your map (e.g. for Germany) and click select the rectanglular map. [[Image:osmdownload.jpg|200px|thumb|Download OpenStreetMaps]]
* then click on download and save the file to <tt>country.bin</tt> (e.g. <tt>germany.bin</tt>) on your desktop computer.
* copy the file to on your freerunner. Because of the size of the maps you copy map to the Micro-SD card on your freerunner. Create a directory for the maps and copy the files from desktop to freerunner:
mkdir /media/card/maps
scp germany.bin root@192.168.0.202:/media/card/maps
* Create a directory <tt>.navit</tt> and copy the <tt>navit.xml</tt> to this directory:
mkdir /home/root/.navit
cp /usr/share/navit/navit.xml /home/root/.navit/navit.xml
* Add and enable the map for the application in navit by changing the lines (at approx line number 370)

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/*.bin"/>
</mapset>
You can explicitly mention the downloaded maps in the mapset, e.g.:

<mapset enabled="yes">
<map type="binfile" enabled="yes" data="/media/card/maps/germany.bin"/>
<map type="binfile" enabled="no" data="/media/card/maps/france.bin"/>
</mapset>
Disable unused mapset sections by setting enabled to <tt>no</tt>, e.g. the pre-installed sample maps at line 370 in <tt>navit.xml</tt>.
<mapset enabled="no">
<xi:include href="$NAVIT_SHAREDIR/maps/*.xml"/>
</mapset>

===Start Navit===
Start <tt>Navit</tt> on your Freerunner for your first test. For further configuration details see [http://wiki.openmoko.org/index.php?title=Navit OpenMoko Article for Navit] or the project website of [http://wiki.navit-project.org/index.php/Configuring_Navit Navit-Project].

===No sound after installing Navit===

Navit tends to depend on speech-dispatcher and after a suspend, the freerunner does not ring anymore for incoming calls or messages, it only vibrates. To correct this remove speech-dispatcher:

opkg remove -force-depends speech-dispatcher

==SHR Settings==
[[Image:SHR-Settings-main.png|200px|thumb|SHR Settings]]

SHR Settings is the main setting application of SHR. In the background it uses [[FSO]] specific dbus calls as well as low level commands. The graphical interface is Elementary-Python based. It provides an easy way of setting up your phone to your liking - from phone related settings, to requesting resources in order to prevent screen dim or suspend (for example while using GPS).

While some settings are persistent over reboots, other are not.

===Main Screen===
Main screen is divided into few categories, which contain modules. Every SHR Settings module has specified task - control GSM antenna power, set actual time etc.

===Settings: Phone===
Here you can check if the GSM antenna is on and if your phone number is shown when you call someone.

'''GSM'''
In GSM settings you can turn off and on GSM module. After turning off antenna, whole GSM modem is turned off.

To list available providers, click on Operators button. Scanning can take some time. After while, list of operators should pop up.

You can't connect to operators marked [forbidden]. After failed connect, message is displayed.

Selecting operator from list also changes modem registration mode to manual. It won't register to other network, even if some is available and has better signal strengh. To return to automatic mode, click "Automatic" button in operator list.

'''Call'''
{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Phone.png|200px|thumb|Phone settings]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-List-providers.png|200px|thumb|List providers]]

|}

You can set if your phone number should be displayed to other party. You can either depend on network decision ("By network") or force it manually ("Manual")

'''SIM'''

Here you can view some informations about your SIM card and clean phone and messagebooks.

'''Others'''

'''Profile'''

Here you can select current profile, which device should use to determine ring tone etc.

'''Current profile'''

Here you can adjust properties of currently used profile. Available settings: ring tone, ring volume, ring vibration, ring loop, ring length, message tone, message volume, message vibration, message loop, message length.

To change ring tone, click on "Change" button.

To use your own ring tone, place it in /usr/share/sounds directory.

After selecting sid tune as ring tone, there are available controls to select tune number from file.

This is changing settings in /etc/freesmartphone/opreferences/conf/phone/default.yaml

ring-volume # Ring Volume control 0 (mini) to ? maxi)
ring-length # min time for ringtone. Must be greater than the duration of you ringtone
ring-loop # define the number of loop of ringtone to play
ring-tone: "ringtone_ringnroll.ogg" # .ogg example
ring-tone: "Arkanoid_PSID.sid" # .sid example, use default tune
ring-tone: "Arkanoid_PSID.sid;tune=2" # .sid example, plays the second tune of that

If you like to test a .sid you can play it using this command on the FR:

gst-launch filesrc location=Arkanoid_PSID.sid ! siddec tune=2 ! alsasink

Note that it's a ! used and not a | to construct the gstreamer pipe command.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles.png|200px|thumb|Profiles]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Profiles-Ringtones.png|200px|thumb|Ringtones]]

|}

===Settings: Connectivity===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity.png |200px|thumb|Connectivity top]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Connectivity2.png |200px|thumb|Connectivity bottom]]
|}

'''WiFi'''

With "WiFi radio" toggle you can set, if wifi module should be powered. WiFi radio has to be turned on before trying to connect to WiFi network, unless you try to connect through Mokonnect which is capable of powering it up.

'''GPRS'''

To enter APN, login and password fields, just click on actual value (default: "internet"). Keyboard will pop up.
If you don't know APN, login and passwork, ask your provider.}}

{{Note|You can also use Mokonnect to manage your Gprs connection}}

To connect to GPRS network, just click "Connect" button. Entered values will be saved after successful connection.

'''USB'''

With this toggle you can switch USB port between device (Neo to PC) or host (device to Neo) modes.

'''Bluetooth'''

To power up Bluetooth module, swith "Bluetooth radio" toggle to "On". After that, "Visibility" toggle should arrive - set it to "On" if you want your FR to be visible by other Bluetooth devices on scanning.

===Settings: GPS===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS.png |200px|thumb|center|GPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-GPS-Satelites.png |200px|thumb|GPS Satelite details]]
|}

'''GPS'''

By default, GPS is turned on only when requested (when you turn on TangoGPS, Navit, omgps or other GPS app). That state corresponds to "Auto" setting. After changing to "Manual", you can force set it to on or off.

'''GPS information'''

This page can be used to monitor GPS status. If some value isn't known, then "unknown" is displayed.

You can also view information about every visible satellite and check, which are used for getting fix. To do that, just click "Satellite details".

If you experience problems with GPS, turn it off, click "Remove AGPS data" and reboot your Neo.

===Settings: Date/time===

[[Image:SHR-Settings-Date-Time.png |200px|thumb|Date & Time]]

'''Time'''

Here you can view and set actual time. By default, time is just displayed, To adjust it, click on "Set time".

After finishing adjusting, click "OK" button.

'''Date'''

This module displays current date.

===Settings: Power===

'''Battery'''

This module displays informations about battery state - charge, voltage, remaining time etc. To update data, click "Update" button.

Here you also force enable 500mA charging.

'''Display'''

With this slider you can easily tweak backlight power.

{{Note|This setting isn't permanent over sessions. At boot backlight is set back to 100%.}}

'''Power'''

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Power.png |200px|thumb|Power]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Timeouts.png |200px|thumb|Timeouts]]
|}

Here you can turn on or off automatic dimming or suspend after idle timeout (see: Timeouts module)

'''Timeouts'''

Here you can set up values of idle timeouts used by device. Timeouts are reached in this order: idle -> idle dim -> idle prelock -> lock -> suspend. Idle, idle prelock and lock aren't used by default in SHR at the moment. This setting changes parameters in /etc/frameworkd.conf :

[odeviced.idlenotifier]
suspend = 20
lock = 2
idle_prelock = 12
idle = 10
idle_dim = 20

===Settings: Services===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Services.png |200px|thumb|center|Services]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Service-restart.png |200px|thumb|Services debug screen]]
|}

Here is listed every interesting script from /etc/init.d/ directory.

After clicking on some, you can either start, restart or stop service and view result.

===Settings: Others===

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Others.png |200px|thumb|Others]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:50% " |

[[Image:SHR-Settings-Splash-Preview.png |200px|thumb|Splash preview]]
|}

'''Splash'''

With this selector you can select theme used by shr-splash at boot and shutdown. After clicking "Preview", selected boot image will be displayed for 5 seconds.

'''PIM'''

Module used by opimd developers. Doesn't have influence on behaviour of default SHR image.

Every opimd domain has different backends to store it's data. The domain reads data from every backend and writes data to the default backend. So with the selector in shr-settings you can choose the backend that stores newly generated data, it doesn't copy or move existing data to a different backend.

'''Userspace backups'''

Here you can either archive or restore your files and configurations.

'''Image information'''

This module contains basic information about installed image - name of buildhost, used revision, branch and time of build.

'''Theming'''
[[Image:SHR-Neo-Theme.png|200px|thumb|Neo theme]]
Find available themes by running

opkg list | grep theme-illume

install it by

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

http://opkg.org has a very fast theme called nEo

opkg install http://www.opkg.org/packages/e-wm-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/elementary-theme-neo_0.2_armv4t.ipk
opkg install http://www.opkg.org/packages/etk-theme-neo_0.2_armv4t.ipk
opkg install -force-overwrite http://www.opkg.org/packages/libframeworkd-phonegui-efl-theme-neo_0.2_armv4t.ipk

If you also want the GTK+ Applications to fit in with the rest of the Systems look execute

opkg install http://www.opkg.org/packages/gtk-theme-neo_0.1_armv4t.ipk

For a completely monolithic look additionally execute

opkg install -force-overwrite http://www.opkg.org/packages/gpe-theme-neo_0.1_armv4t.ipk
opkg install http://www.opkg.org/packages/icon-theme-neo_0.2_armv4t.ipk

Please observe the command line output when installing these themes, since it will tell you how to activate the themes.

{{Note|some of the theme packages have to be reinstalled after an opkg upgrade.}}

Reverting back can be done by

opkg install e-wm-theme-illume-sixteen shr-theme-gtk-e17lookalike -force-reinstall
opkg install libframeworkd-phonegui-efl0 e-wm-theme-default etk-theme-shr shr-theme -force-reinstall

==FSO Resources==

FSO is in control of each device. These are called resources. If the software wanting to use the device is capable of requesting this resource via d-bus, FSO will do this, otherwise you might need to power the device manually. After the requested resource is released, FSO will power it down. Manual resource request can be done through SHR Setting or you can use fsoraw command. (Using fsoraw is faster and better then running dbus commands)

opkg install fsoraw

Example of usage fsoraw:

fsoraw -r Display mokomaze

'''Wifi'''

Unless this resource is enabled you've no eth0 and wifi module is completely un-powered. Use the network manager to set up networks, Mokonnect will power Wifi up automatically when needed.

'''Bluetooth'''

You need to have this resource requested to have bluetooth module powered.

'''GPS'''

The fso-gpsd is a daemon waiting for gsmd connections, automatically powering the device on and off. When a connection exists, it powers up the GSM. In SHR Settings you can switch GPS completely off SHR Settings -> GPS -> Manual > Off

'''GSM'''

You need to have this resource requested to have GSM module powered.

'''Display'''

While this resource is requested the display won't be blanked and suspend is disabled.

'''CPU'''

Default rules.yaml checks for this resource to disable automatic suspend when it's requested. While this resource is kept suspend is disabled (but screen can be blanked).

'''Test'''

A test resource

==Network manager==

While there are several ways of networking - Wifi, USB, Bluetooth and Gprs - By default, USB networking is enabled in /etc/network/interfaces.

Enhanced configuration is possible through direct editing of /etc/network/interfaces or through Mokonnect.

Connmand daemon with Mokonnect are the recommended user level applications for setting up networking. At the moment, Mokonnect can manage USB, Wifi and Gprs connections, as well as routing and NAT. Wifi device is not required to be manually turned on via SHR-Settings as Mokonnect will automatically enable the device when needed and disable after use.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-Mokonnect.png|200px|thumb|Mokonnect]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi.png|200px|thumb|Mokonnect Wifi]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokonnect-Wifi-Scan.png|200px|thumb|Mokonnect Wifi Scan]]

|}

==Bluetooth==

Bluetooth can be used for several different applications - file transfer, networking, HIDD, music playing (A2DP), calling etc. In some occasions, the devices need to be authorized - paired. At the moment, support for some bluetooth functions is better then for others - it is possible to do all mentioned above with the notice that phone calls with bluetooth headset are always routed to the bluetooth even if it is not around, making it quite difficult to use.

Don't forget you need to turn the bluetooth radio on in SHR Settings -> Connectivity -> Bluetooth Radio: On, where you can also make the bluetooth device visible.

SHR user bluez4 which completely different from bluez3. The bluetoothd is taking care of most of the bluetooth now. Please see [[Manually using Bluetooth]] for detailed information about using bluetooth and also for list of supported devices.

===OBEX file transfer===

There are several obex programs allowing file transfer, all in console at the moment. Obexpush installs obextool, and opd daemon:

opkg install obexpush

Default receiving path (editable in /etc/default/opd_args ) doesn exist, so create it

mkdir /var/obexpush

Files are then received automatically, no notice, no confirmation... they just silently appear in /var/obexpush

To send some files, first scan for devices:

hcitool scan
Scanning ...
00:16:41:F5:A5:BC laptop

Then send it onto bt address found in the scan:

obextool push image.jpg 00:16:41:F5:A5:BC 10

===Connect Bluetooth keyboard===

hidd --search

===Pairing===

This comes from [[Manually_using_Bluetooth#Once_Again.2C_Bluetooth_Headset_on_Freerunner]]

Now, you must pair the bluetooth headset with your Freerunner. Make sure the bluetooth chip is powered up (can be done through the Connectivity section in the SHR-Unstable settings manager) and that bluetoothd is running:
/etc/init.d/bluetooth start
Now, to actually pair the bluetooth headset, you will need the simple-agent script. If you already have it, excellent. If you, like me, do not, then you can get it here: http://dl.getdropbox.com/u/453116/simple-agent

Put it in /usr/bin/ and run ===chmod a+x /usr/bin/simple-agent===

Now put your headset into pairing mode and run

hcitool scan

Find your headset and use its address in the command

simple-agent hci0 XX:XX:XX:XX:XX:XX

If you give a third parameter (what it is doesn't matter) to simple-agent, it will disconnect then reconnect to the headset (reset pairing).

===GSM phonealls with bluetooth headset===

Your bluetooth headset device must be paired first.

====Configuring bluez====

Older SHR releases you need to uncomment <tt>SCORouting=PCM</tt> setting in <tt>[General]</tt> section of

/etc/bluetooth/audio.conf

like this:

# SCO routing. Either PCM or HCI (in which case audio is routed to/from ALSA)
# Defaults to HCI
SCORouting=PCM

do not forget to restart bluetoothd after that.

/etc/init.d/bluetooth stop
/etc/init.d/bluetooth start

====Configuring FSO====

Now we must tell frameworkd that you have a bluetooth headset. Headset parameters should be set in

/etc/freesmartphone/opreferences/conf/phone/default.yaml

Parameters bt-headset-enabled and bt-headset-address (see opreferences/schema/phone.yaml for semantics).

You need to restart FSO for the changes to take effect.

/etc/init.d/frameworkd restart

example of my /etc/freesmartphone/opreferences/conf/phone/default.yaml:

message-length: 7
message-tone: notify_message.wav
message-vibration: 1
message-volume: 10
ring-loop: 1
ring-tone: ringtone_ringnroll.wav
ring-vibration: 1
ring-volume: 10
bt-headset-enabled: 1
bt-headset-address: 00:09:DD:31:92:98

====Re-Connecting the bt device====

You might need to get the bluetooth headset connected manually on the beginning and also after suspend:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_xx_xx_xx_xx_xx_xx org.bluez.Headset.Connect

where xx_xx_xx_xx_xx_xx is address of the device, for example:

mdbus -s org.bluez /org/bluez/`pidof bluetoothd`/hci0/dev_00_09_DD_31_92_98 org.bluez.Headset.Connect

Hopefully, your bluetooth headset now works. Good luck!

==System Customizing==

===Changing the splash screen===

list available splash screen themes

opkg list | grep splash-theme

and install one of the available themes

opkg install shr-splash-theme-dontpanic

Then go to SHR Settings -> Others -> Themes. Here you can preview installed themes and change the default one.

===Install functional alarm application===
The pre-installed alarm clock ''elementary-alarm'' does not work properly on SHR. so replace it by ''ffalarm'':
opkg remove -force-depends elementary-alarm; opkg install ffalarms

===Enable mouse cursor===

edit line 121 of /etc/X11/Xinit and erase -hide-cursor

ARGS="$ARGS -dpi ${DPI} -screen ${SCREEN_SIZE} -mouse tslib -root-ppm /usr/share/pixmaps/xsplash-vga.ppm vt1"

===Improve speed of Elementary applications===

Set the Elementary rendering engine used for Evas to x11-16 (Software X11 16bpp engine, may have bugs and will be lower quality, but faster):
echo -e "#!/bin/sh\n\nexport ELM_ENGINE=x11-16" > /etc/profile.d/set-elm-engine.sh

Additionally in the SHR-Unstable repositories there are theme packages optimized for 16bpp color. Both packages can be installed with the following command:

opkg install e-wm-theme-illume-sixteen elementary-theme-sixteen

You can then append the /etc/profile.d/set-elm-engine.sh with:

# Set Optimized theme
export ELM_THEME=sixteen

You can also then change Illume to use the sixteen theme by clicking the wrench->Look->Theme-illume-sixteen->OK. Then switch Illume to use the 16bpp Engine by clicking the wrench->Advanced(you will need to drag and slide the top menu)->Engine->Software_16->OK. This should give you a much faster interface without the low quality look the default SHR themes have at this lower color depth.

Read http://trac.enlightenment.org/e/wiki/Elementary

If you try to change Wallpaper or Theme and Illume keeps on crashing, it might be caused by the whole Illume running in Software_16 mode. Go to Illume Settings, slide the icon bar and select Advanced. There tap on Engine and select Software. After this, you can change your Wallpaper or Theme. Selecting Software_16 later on again will speed up the desktop's response (though causing it to be a bit uglier).

===Speedup of suspend and wake up===

I you are using Qi and installation on µSD card, you can change the kernel parameter loglevel=1 1 in /boot/append-GTA02 . For u-boot and installation in nand just type

klogd -c 1

into the console. This saves you from 3 seconds worth of console output on every resume.

If you like the effect of this command and want it to be executed at every startup, you just have to log into your phone and type the following:

cat > /etc/init.d/resumespeedup << EOF
#!/bin/sh
/sbin/klogd -c 1
EOF
chmod +x /etc/init.d/resumespeedup
ln -s ../init.d/resumespeedup /etc/rc1.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc2.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc3.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc4.d/S06resumespeedup
ln -s ../init.d/resumespeedup /etc/rc5.d/S06resumespeedup

===Opimd utils===

Opimd utils is a set of several testing scripts to play with the new opimd backends. It also provides opimd-messages program and mainly new opimd-notifier that is much better then the standard one.

opkg install opimd-utils

===opkg upgrade issues===

As '''opkg''' had some '''issues''' recently, installation might get broken due to that. You can fix it or prevent by using the following scripts

Safe update packages:

#!/bin/sh

opkg list_upgradable | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

Force reinstall all installed packages

#!/bin/sh

opkg list_installed | awk '!/(kernel|Multiple)/ {print $1}' | \
while read line; do
echo "installing pack $line"
opkg install $line -force-reinstall
done

===Random errors===
No icons, no GSM functions etc. - this is mostly due to '''errors on your µSD''' card. Remove your card and fix it in card reader or by booting to another partition (nand) or by reboot and mount read only, then run fsck.

For reboot into nand and fix 1st partition of ext2 on your card

fsck.ext2 /dev/mmcblk0p1

===Replace dropbear with openssh===

Set password
passwd

Install ssh server (and sftp)
opkg install openssh-sshd openssh-sftp-server openssh-scp -force-depends

Remove dropbear and start openssh

screen
opkg remove dropbear -force-depends; /etc/init.d/sshd start

You will get disconnected from the ssh session, wait until keys get generated and log in again.
{{Note|'''Remove old SSH Key from <tt>.ssh/known_hosts</tt>:''' On your Linux box you will find a file <tt>known_host</tt> in the subdirectory <tt>.ssh/</tt> in you home directory. This contains a ssh key for the connection to your freerunner. If new keys are generated or if you flash your Freerunner with SHR then you have to remove the line with <tt>openmoko</tt> or the IP-address of your Freerunner from the file. Otherwise you might be able to login in again. }}

===Video playback===

Install intone-video

opkg install elementary libsqlite3-0 http://www.opkg.org/packages/intone-video_0.11_arm.ipk

If intone complaints about missing libraries, please run
#!/bin/sh
cd /usr/lib
ls *ver-svn-02*|while read nombre
do
final="`echo $nombre | sed s/-ver-svn-02/-ver-pre-svn-01/`"
ln -s /usr/lib/$nombre /usr/lib/$final
done

On your desktop, encode your video:

mencoder video-file -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=300 -vf scale=320:240,eq2=1.2:0.5:-.025,rotate=2 -oac mp3lame -lameopts br=64:cbr -o video-file-FR.avi

===Adding freerunner to your hosts===

You can add freerunner to your hosts file for a name resolving:

You can use the name <tt>neo</tt> if you added the host <tt>neo</tt> in <tt>/etc/hosts</tt> on your desktop computer (add the following line for host <tt>neo</tt> assuming that the IP-address of your freerunner is <tt>192.168.0.202</tt>.
echo "192.168.0.202 neo neo" >> /etc/hosts

You can then access your freerunner like this:

ssh root@neo

Which is shorter then this:

ssh root@192.168.0.202

==Installing Software==

You can use opkg for installing software packages or you can try SHR Installer from http://git.shr-project.org/git/?p=shr-installer.git;a=summary . It requires packagekitd

opkg install packagekitd

If you wan to use opkg after you used the installer, make sure packagekitd is not running

killall packagekitd

'''Cool applications'''

SHR comes with only few preinstalled applications but it's repository provides more cool stuff. Also, there are applications that are not in SHR repos at the moment but can still be installed. The following few examples are here just to spark your interest:

'''SHR Launcher'''

[[Image:Launcher.png|200px|thumb|SHR Launcher]]
Launcher is elementary based alternative home screen application and event notifier for SHR. It displays current time, has a user tweak-able launcher with categories and features missed calls and messages applets.

opkg install libsqlite3-0 http://www.opkg.org/packages/launcher_0.23_arm.ipk

For '''PIM''' applications you can get dates for calendar, tasks for todos, neote for notes:

opkg install dates tasks

opkg install http://neote.googlecode.com/files/neote_0.2.0-r0_all.ipk

GPE contacts saves the contacts in a SQLite database that can be synchronized with VCard files. Gpe-contacts don't allow you to dial directly via shr-dialer. Install gpe-contacts:

opkg install gpe-contacts

After installation you'll find to icons with ''MyVCard''. If you want to remove it, delete the file <tt>/usr/share/applications/edit-vcard.desktop</tt>

'''Litephone'''

[[Image:SHR-Litephone.png|200px|left|thumb|Litephone]]

Litephone is new alternative set of phone applications written in Qt. In it's single application interface it provides basic phone functionality (contacts, calls, messages, phone log, settings). It's main advantage is that it uses opimd for storage of the user data.

opkg install http://pvtrace.com/litephone/libqtcore4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtxml4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtdbus4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/libqtgui4_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/qt4-x11-free_4.4.3-r3_armv4t.ipk
opkg install http://pvtrace.com/litephone/litephone_0.0.1-r3_armv4t.ipk

'''Mokomaze''' is an excelent eye-candy game using accelerators embedded in your device.

opkg install mokomaze

If you tweak the exec procedure in /usr/share/applications/mokomaze.desktop into this:
fsoraw -r Display mokomaze
the screen will not blank while playing.

'''[[Cellhunter]]''' is a game to collect information about mobile phone cells. This information can later be used to roughly determine your position without powering on the GPS chip. [http://78.47.116.33/~hole/cellhunter/ CellHunter homepage]

opkg install cellhunter

'''OMGps''' and '''TangoGPS''' are GPS application showing you your position on a map (Openstreetmap, Google maps etc.). You can track your position, save it and use later, save and view points of interest, images or measure your trip. OMGps allows you to overlay different maps on top of each other, set GPS into different modes (walking, car, flying). Maps are downloaded online and used even in offline.

{| class="wikitable" cellspacing="0" cellpadding="0" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #c0c0c0; background:#eeeeee; floating="center";width:100%; "

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |
[[Image:SHR-TangoGPS-OSM.png|200px|thumb|TangoGPS]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-OMGPS-GM.png |200px|thumb|OMGps]]

! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:0px solid #222222; width:33% " |

[[Image:SHR-Mokomaze.png|200px|thumb|Mokomaze]]

|}

'''Screenshots''' can be made with ''gpe-scap'' (available by default in SHR full image). To take a screenshot, run gpe-scan from shell while connected in via ssh.

'''Literki''' is full qwerty keyboard with configurable layout, always transparent, therefore applications don't need to redraw screens and popup is therefore very fast. The keys are big enough for everyday use with your fat fingers. To pop up the keyboard: slide your finger upwards from the bottom right corner. To hide the keyboard: slide your finger down on the keyboard. [http://www.opkg.org/package_232.html Opkg page]

opkg install http://pvtrace.com/literki_0.0.2-r3_armv4t.ipk

[[Category:SHR]]