Neo FreeRunner FAQ

From Openmoko

(Difference between revisions)
Jump to: navigation, search
m (USB)
(removing top heading)
Line 1: Line 1:
 
{{Gta02menu}}
 
{{Gta02menu}}
  
== Frequently Asked Questions ==
+
== FreeRunner known hardware related issues ==
=== FreeRunner known hardware related issues ===
+
  
 
There is collection of FreeRunner hardware issue wiki page [[Freerunner_Hardware_Issues]] , could help you quickly know if you bump into same problem and the possible way to solve some of issues.
 
There is collection of FreeRunner hardware issue wiki page [[Freerunner_Hardware_Issues]] , could help you quickly know if you bump into same problem and the possible way to solve some of issues.
  
===Booting===
+
==Booting==
 
'''Q: I can't boot Neo with charger?'''   
 
'''Q: I can't boot Neo with charger?'''   
  
Line 55: Line 54:
 
3. u-boot using: grep  Bootloader /dev/mtdblock0
 
3. u-boot using: grep  Bootloader /dev/mtdblock0
  
=== Battery ===
+
== Battery ==
==== What is the expected battery life? ====
+
=== What is the expected battery life? ===
 
See [[Neo FreeRunner (GTA02) Battery#Notes_about_expected_battery_life]] and more battery information in [[Neo_FreeRunner_(GTA02)_Battery]]
 
See [[Neo FreeRunner (GTA02) Battery#Notes_about_expected_battery_life]] and more battery information in [[Neo_FreeRunner_(GTA02)_Battery]]
  
=== USB ===
+
== USB ==
 
'''Q:''' How do I connect an USB memory-stick etc?
 
'''Q:''' How do I connect an USB memory-stick etc?
  
Line 70: Line 69:
 
It should work if one Neo is set to Host mode and the other one set to Device mode. One Neo could give power to the USB-port it the other Neo's battery is low. ''(I have to verify this)''
 
It should work if one Neo is set to Host mode and the other one set to Device mode. One Neo could give power to the USB-port it the other Neo's battery is low. ''(I have to verify this)''
  
=== GSM ===
+
== GSM ==
  
==== SIM compatibility ====
+
=== SIM compatibility ===
 
'''Q:'''Sim card is not working, how do I run diagnostics?
 
'''Q:'''Sim card is not working, how do I run diagnostics?
  
Line 80: Line 79:
 
Follow [[Manually_using_GSM]] until you get an OK prompt. More detalied documenation please refer [[FreeRunner_unable_to_work_with_3G_SIM_cards]] and [[Carriers]].
 
Follow [[Manually_using_GSM]] until you get an OK prompt. More detalied documenation please refer [[FreeRunner_unable_to_work_with_3G_SIM_cards]] and [[Carriers]].
  
==== GSM/GPRS information ====
+
=== GSM/GPRS information ===
  
 
Following page contain very useful information:
 
Following page contain very useful information:
Line 92: Line 91:
 
* [http://freeyourphone.de/portal_v1/viewtopic.php?f=21&t=295#p2956 Useful script for GPRS]
 
* [http://freeyourphone.de/portal_v1/viewtopic.php?f=21&t=295#p2956 Useful script for GPRS]
  
=== GPS ===
+
== GPS ==
  
 
'''Q: How do I get the GPS working?'''  
 
'''Q: How do I get the GPS working?'''  
Line 102: Line 101:
 
'''A: '''See [[GPS Problems]].
 
'''A: '''See [[GPS Problems]].
  
=== Wi-Fi ===
+
== Wi-Fi ==
  
 
'''Q: How do I get the wlan working? '''
 
'''Q: How do I get the wlan working? '''
Line 108: Line 107:
 
'''A: ''' See [[GTA02 WLAN]]
 
'''A: ''' See [[GTA02 WLAN]]
  
=== Bluetooth ===
+
== Bluetooth ==
  
 
'''Q: How do I get the Bluetooth working? '''
 
'''Q: How do I get the Bluetooth working? '''
Line 114: Line 113:
 
'''A: ''' See [[Manually_using_Bluetooth]]
 
'''A: ''' See [[Manually_using_Bluetooth]]
  
=== Sysfs function===
+
== Sysfs function==
  
 
'''Q: How do I get low level hardware related function, like power up device, dump register? '''
 
'''Q: How do I get low level hardware related function, like power up device, dump register? '''
Line 120: Line 119:
 
'''A: ''' See [[GTA02_sysfs]]
 
'''A: ''' See [[GTA02_sysfs]]
  
=== Display ===
+
== Display ==
  
==== Can it play VGA video? ====
+
=== Can it play VGA video? ===
  
 
No, it can do about 20 fps QVGA with software, and something beetween QVGA and VGA playing MPEG-4 using hardware (at resonable fps). Scaling is also done with GPU hardware.
 
No, it can do about 20 fps QVGA with software, and something beetween QVGA and VGA playing MPEG-4 using hardware (at resonable fps). Scaling is also done with GPU hardware.
  
==== How to change the background picture of the root window? ====
+
=== How to change the background picture of the root window? ===
  
 
Look [http://wiki.openmoko.org/wiki/Today/2007.2#Adjust_UI_components_at_runtime here].
 
Look [http://wiki.openmoko.org/wiki/Today/2007.2#Adjust_UI_components_at_runtime here].
  
=== Software ===
+
== Software ==
  
==== Does it support Java? ====
+
=== Does it support Java? ===
 
There is a [https://wiki.evolvis.org/jalimo/index.php/OpenMoko port of Jalimo] for Openmoko.
 
There is a [https://wiki.evolvis.org/jalimo/index.php/OpenMoko port of Jalimo] for Openmoko.
  
==== Does it support Flash? So can I watch YouTube? ====
+
=== Does it support Flash? So can I watch YouTube? ===
  
==== Does it support Ruby ====
+
=== Does it support Ruby ===
  
 
Ruby 1.9 please refer http://blog.sparkymat.net/2008/08/10/ruby-19-on-openmoko/
 
Ruby 1.9 please refer http://blog.sparkymat.net/2008/08/10/ruby-19-on-openmoko/
 
Ruby 1.8.6 please refer http://blog.wolfman.com/articles/2008/08/10/ruby-1-8-6-on-openmoko-freerunner
 
Ruby 1.8.6 please refer http://blog.wolfman.com/articles/2008/08/10/ruby-1-8-6-on-openmoko-freerunner
  
==== How can I type a '/' in the software keyboard? ====
+
=== How can I type a '/' in the software keyboard? ===
  
 
See [[Switching Keyboards]]
 
See [[Switching Keyboards]]
  
==== How do I get a qwerty software keyboard?====
+
=== How do I get a qwerty software keyboard?===
  
 
See [[Switching Keyboards]]
 
See [[Switching Keyboards]]
  
====How to use an external USB or Bluetooth keyboard with ing FreeRunner ? ====
+
===How to use an external USB or Bluetooth keyboard with ing FreeRunner ? ===
  
 
just run:
 
just run:

Revision as of 14:14, 19 August 2008


Contents

FreeRunner known hardware related issues

There is collection of FreeRunner hardware issue wiki page Freerunner_Hardware_Issues , could help you quickly know if you bump into same problem and the possible way to solve some of issues.

Booting

Q: I can't boot Neo with charger?

A: 1. You can't boot GTA02 without a spare battery. You should boot Neo with spare battery and attach your charger, then you can boot into neo.

2. Once your phone is booted, remove the spare battery. Freerunner will remain running,

3. Insert dead battery and let it charge.

Q: Unable to flash FreeRunner after booting either into NAND or NOR. A:

NOTE: Please check Getting_Started_with_your_Neo_FreeRunner for more information about the flashing image.


Q: I can ssh into the phone via USB per the wiki instructions, but dfu-util does not find the phone.

A: This is what I need to run as root and the everything works fine:

root(eno,freerunner)# cat upom
#!/bin/sh
/sbin/ifconfig usb0 192.168.0.200 netmask 255.255.255.0
/sbin/route add -host 192.168.0.202/32 dev usb0
/bin/echo 1 > /proc/sys/net/ipv4/ip_forward
iptables -F
iptables -A INPUT -s 192.168.0.202 -i usb0  -d 192.168.0.200   -j ACCEPT
iptables -A INPUT  -s 192.168.0.200  -i eth+  -d 192.168.0.202  -j ACCEPT
iptables -A INPUT  -s 192.168.2.0/24  -i eth+  -d 192.168.0.202  -j ACCEPT
iptables -A INPUT  -s 192.168.2.0/24  -i eth+  -d 192.168.2.0/24  -j ACCEPT
iptables -A FORWARD -s 192.168.0.202 -i usb0 -d 192.168.2.0/24 -o eth+   -j 
ACCEPT
iptables -A FORWARD -s 192.168.2.0/24 -i eth+ -d 192.168.0.202 -o usb0  -j 
ACCEPT
iptables -A OUTPUT -d 192.168.2.0/24 -o eth+   -j ACCEPT
iptables -A OUTPUT -d 192.168.0.202 -o usb0  -j ACCEPT
iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24
root(eno,freerunner)#

Q: What image version is used?

A:

1. Kernel version using: uname -a

2. Root filesystem using: cat /etc/version or cat /etc/om-version

3. u-boot using: grep Bootloader /dev/mtdblock0

Battery

What is the expected battery life?

See Neo FreeRunner (GTA02) Battery#Notes_about_expected_battery_life and more battery information in Neo_FreeRunner_(GTA02)_Battery

USB

Q: How do I connect an USB memory-stick etc?

A: This requires an adapter Mini-B 5-pole => Type A jack or an adapter jack => jack. see here

Q: Once I have such an adapter, can I use it to connect 2 Neo to each other?

A: This question is equivalent to How to connect two [Unix/Linux] computers via USB cable and what sort of special cable is needed? -> http://www.linuxquestions.org/questions/linux-general-1/connecting-two-computers-with-a-usb-cable-data-cable-411073
It should work if one Neo is set to Host mode and the other one set to Device mode. One Neo could give power to the USB-port it the other Neo's battery is low. (I have to verify this)

GSM

SIM compatibility

Q:Sim card is not working, how do I run diagnostics?

A: Here is the "how to" check.

Follow Manually_using_GSM until you get an OK prompt. More detalied documenation please refer FreeRunner_unable_to_work_with_3G_SIM_cards and Carriers.

GSM/GPRS information

Following page contain very useful information:

GPS

Q: How do I get the GPS working?

A: See GTA02 GPS

Q: it takes a long time (10min+) before the Freerunner gets first GPS data

A: See GPS Problems.

Wi-Fi

Q: How do I get the wlan working?

A: See GTA02 WLAN

Bluetooth

Q: How do I get the Bluetooth working?

A: See Manually_using_Bluetooth

Sysfs function

Q: How do I get low level hardware related function, like power up device, dump register?

A: See GTA02_sysfs

Display

Can it play VGA video?

No, it can do about 20 fps QVGA with software, and something beetween QVGA and VGA playing MPEG-4 using hardware (at resonable fps). Scaling is also done with GPU hardware.

How to change the background picture of the root window?

Look here.

Software

Does it support Java?

There is a port of Jalimo for Openmoko.

Does it support Flash? So can I watch YouTube?

Does it support Ruby

Ruby 1.9 please refer http://blog.sparkymat.net/2008/08/10/ruby-19-on-openmoko/ Ruby 1.8.6 please refer http://blog.wolfman.com/articles/2008/08/10/ruby-1-8-6-on-openmoko-freerunner

How can I type a '/' in the software keyboard?

See Switching Keyboards

How do I get a qwerty software keyboard?

See Switching Keyboards

How to use an external USB or Bluetooth keyboard with ing FreeRunner ?

just run:

echo "host" > /sys/devices/platform/s3c2410-ohci/usb_mode
echo "1" > /sys/devices/platform/neo1973-pm-host.0/hostmode

This'll put the Freerunner in to powered USB host mode, then just plug in the keyboard and it'll work. Personally I've made a .desktop file to switch into and out of host mode. To switch back to unpowered device mode just run:

echo "device" > /sys/devices/platform/s3c2410-ohci/usb_mode
echo "0" > /sys/devices/platform/neo1973-pm-host.0/hostmode
Personal tools
Key pages on:
Neo FreeRunner


Frequently Asked Questions

FreeRunner known hardware related issues

There is collection of FreeRunner hardware issue wiki page Freerunner_Hardware_Issues , could help you quickly know if you bump into same problem and the possible way to solve some of issues.

Booting

Q: I can't boot Neo with charger?

A: 1. You can't boot GTA02 without a spare battery. You should boot Neo with spare battery and attach your charger, then you can boot into neo.

2. Once your phone is booted, remove the spare battery. Freerunner will remain running,

3. Insert dead battery and let it charge.

Q: Unable to flash FreeRunner after booting either into NAND or NOR. A:

NOTE: Please check Getting_Started_with_your_Neo_FreeRunner for more information about the flashing image.


Q: I can ssh into the phone via USB per the wiki instructions, but dfu-util does not find the phone.

A: This is what I need to run as root and the everything works fine:

root(eno,freerunner)# cat upom
#!/bin/sh
/sbin/ifconfig usb0 192.168.0.200 netmask 255.255.255.0
/sbin/route add -host 192.168.0.202/32 dev usb0
/bin/echo 1 > /proc/sys/net/ipv4/ip_forward
iptables -F
iptables -A INPUT -s 192.168.0.202 -i usb0  -d 192.168.0.200   -j ACCEPT
iptables -A INPUT  -s 192.168.0.200  -i eth+  -d 192.168.0.202  -j ACCEPT
iptables -A INPUT  -s 192.168.2.0/24  -i eth+  -d 192.168.0.202  -j ACCEPT
iptables -A INPUT  -s 192.168.2.0/24  -i eth+  -d 192.168.2.0/24  -j ACCEPT
iptables -A FORWARD -s 192.168.0.202 -i usb0 -d 192.168.2.0/24 -o eth+   -j 
ACCEPT
iptables -A FORWARD -s 192.168.2.0/24 -i eth+ -d 192.168.0.202 -o usb0  -j 
ACCEPT
iptables -A OUTPUT -d 192.168.2.0/24 -o eth+   -j ACCEPT
iptables -A OUTPUT -d 192.168.0.202 -o usb0  -j ACCEPT
iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24
root(eno,freerunner)#

Q: What image version is used?

A:

1. Kernel version using: uname -a

2. Root filesystem using: cat /etc/version or cat /etc/om-version

3. u-boot using: grep Bootloader /dev/mtdblock0

Battery

What is the expected battery life?

See Neo FreeRunner (GTA02) Battery#Notes_about_expected_battery_life and more battery information in Neo_FreeRunner_(GTA02)_Battery

USB

Q: How do I connect an USB memory-stick etc?

A: This requires an adapter Mini-B 5-pole => Type A jack or an adapter jack => jack. see here

Q: Once I have such an adapter, can I use it to connect 2 Neo to each other?

A: This question is equivalent to How to connect two [Unix/Linux] computers via USB cable and what sort of special cable is needed? -> http://www.linuxquestions.org/questions/linux-general-1/connecting-two-computers-with-a-usb-cable-data-cable-411073
It should work if one Neo is set to Host mode and the other one set to Device mode. One Neo could give power to the USB-port it the other Neo's battery is low. (I have to verify this)

GSM

SIM compatibility

Q:Sim card is not working, how do I run diagnostics?

A: Here is the "how to" check.

Follow Manually_using_GSM until you get an OK prompt. More detalied documenation please refer FreeRunner_unable_to_work_with_3G_SIM_cards and Carriers.

GSM/GPRS information

Following page contain very useful information:

GPS

Q: How do I get the GPS working?

A: See GTA02 GPS

Q: it takes a long time (10min+) before the Freerunner gets first GPS data

A: See GPS Problems.

Wi-Fi

Q: How do I get the wlan working?

A: See GTA02 WLAN

Bluetooth

Q: How do I get the Bluetooth working?

A: See Manually_using_Bluetooth

Sysfs function

Q: How do I get low level hardware related function, like power up device, dump register?

A: See GTA02_sysfs

Display

Can it play VGA video?

No, it can do about 20 fps QVGA with software, and something beetween QVGA and VGA playing MPEG-4 using hardware (at resonable fps). Scaling is also done with GPU hardware.

How to change the background picture of the root window?

Look here.

Software

Does it support Java?

There is a port of Jalimo for Openmoko.

Does it support Flash? So can I watch YouTube?

Does it support Ruby

Ruby 1.9 please refer http://blog.sparkymat.net/2008/08/10/ruby-19-on-openmoko/ Ruby 1.8.6 please refer http://blog.wolfman.com/articles/2008/08/10/ruby-1-8-6-on-openmoko-freerunner

How can I type a '/' in the software keyboard?

See Switching Keyboards

How do I get a qwerty software keyboard?

See Switching Keyboards

How to use an external USB or Bluetooth keyboard with ing FreeRunner ?

just run:

echo "host" > /sys/devices/platform/s3c2410-ohci/usb_mode
echo "1" > /sys/devices/platform/neo1973-pm-host.0/hostmode

This'll put the Freerunner in to powered USB host mode, then just plug in the keyboard and it'll work. Personally I've made a .desktop file to switch into and out of host mode. To switch back to unpowered device mode just run:

echo "device" > /sys/devices/platform/s3c2410-ohci/usb_mode
echo "0" > /sys/devices/platform/neo1973-pm-host.0/hostmode