Getting Started with your Neo FreeRunner

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(Log into U-Boot in NOR Flash)
(redirecting to FreeRunner manual)
 
(387 intermediate revisions by 93 users not shown)
Line 1: Line 1:
{{Languages|Getting Started with your Neo FreeRunner}}
+
#REDIRECT [[Manuals/Neo FreeRunner]]
 
+
{| class="wikitable" cellspacing="2" cellpadding="2" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #cccccc; background:#eeeeee; width:100%;floating="center"; "
+
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:75% " | 
+
<div align="left">
+
Thank you for purchasing this Developer release of Neo FreeRunner. The [[Neo FreeRunner]] phone is the second hardware platform to take advantage of Openmoko. This guide will help you get to know your Neo FreeRunner and how to start using your Neo FreeRunner.
+
! style="background:#fcfcfc;border-left:1px solid #9999cc;border-right:1px ; border-top:2px solid 75d806; border:1px solid #222222; width:25% " |
+
[[Image:Freerunner box.png|200px|thumb|Neo FreeRunner Package]]
+
|}
+
 
+
== The Package Contents ==
+
 
+
{| class="wikitable" cellspacing="2" cellpadding="2" style="padding: 0%; margin:0em 0em 1em 0em; border:1px solid #ffffff; background:#ffffff; width:80%; floating="center"; "
+
! style="background:#ffffff;border-left:1px solid #ffffff;border-right:1px ; border-top:2px solid ffffff; border:1px solid #ffffff; " | 
+
<div align="left">
+
[[Image:GTA02ALL.png|400px|thumb|Inside package]]
+
|
+
 
+
: [[Image:Circle2.gif|10px]]  Neo FreeRunner
+
: [[Image:Circle2.gif|10px]]  Stylus
+
: [[Image:Circle2.gif|10px]]  Battery
+
: [[Image:Circle2.gif|10px]]  Charger
+
: [[Image:Circle2.gif|10px]]  USB Cable
+
: [[Image:Circle2.gif|10px]]  microSD Card 512MB
+
|}
+
</div>
+
 
+
==Getting To Know the Neo FreeRunner==
+
 
+
<div align-center>
+
<table width="80%" style="clear: both; border: 1px solid #ffffff; border-collapse: collapse; padding: 0.2em; margin: 0; font-size: 100%; margin: 0 1px;">
+
<tr valign="top" style="background: #ffffff">
+
<td style="width: 25px; padding-left: 0.5em;">
+
</td>
+
<td style="width: 10px; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #ffffff;">[[Image:menu8.jpg|370px|thumb|AUX Button and phone jack(From left to right)|center]]</td><td style="padding: 1px 1em 0; background: #ffffff;">
+
[[Image:menu9.jpg|365px|thumb|Power Button, USB and external GPS Antenna (From left to right)|center]]</td></tr></table>
+
</div>
+
 
+
<div align-center>
+
<table width="80%" style="clear: both; border: 1px solid #ffffff; border-collapse: collapse; padding: 0.2em; margin: 0; font-size: 100%; margin: 0 1px;">
+
<tr valign="top" style="background: #ffffff">
+
<td style="width: 50%; padding-left: 0.5em;">
+
</td>
+
<td style="width: 50%; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #ffffff;">[[Image:menu12.jpg|233px|thumb|AUX Back side with battery|center]]</td><td style="padding: 1px 1em 0; background: #ffffff;">
+
[[Image:menu11.jpg|260px|thumb|Put the SIM card and SD card here|center]]</td></tr></table>
+
</div>
+
 
+
<div align-center>
+
<table width="80%" style="clear: both; border: 1px solid #ffffff; border-collapse: collapse; padding: 0.2em; margin: 0; font-size: 100%; margin: 0 1px;">
+
<tr valign="top" style="background: #ffffff">
+
<td style="width: 50%; padding-left: 0.5em;">
+
</td>
+
<td style="width: 50%; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #ffffff;">[[Image:menu13.jpg|233px|thumb|open case from this side |center]]</td><td style="padding: 1px 1em 0; background: #ffffff;">
+
[[Image:menu14.jpg|250px|thumb|Opened|center]]</td></tr></table>
+
</div>
+
 
+
===Installing the Micro-SD card, the SIM card, and the Battery ===
+
 
+
# Remove the rear cover of the Neo FreeRunner by first holding the Neo FreeRunner on the side and then use your fingernail to prise off the rear cover at the slot on top of the device.
+
# Now you should be able to locate the combined SIM and Micro-SD card holder at the bottom of the battery compartment.
+
# Unlock the SIM card holder by sliding the metal clip down, towards the USB socket, with your fingernail. Use caution, as these parts are delicate and could be damaged by forcing them in the wrong direction.
+
# Lift up on the SIM card holder.
+
# The Micro-SD card holder is held in place by a latch on either side.  It is easiest to open the Micro-SD card holder by releasing these latches one at a time rather than by lifting from the middle, as lifting from the middle tends to increase the latching pressure.  A small screwdriver or knife can be used for this.
+
# Insert the Micro-SD card into the Micro-SD card holder.  Note that the electrical contacts should face down and towards the edge of the Neo Freerunner.
+
# Close the Micro-SD card holder, making sure that both latches are securely fastened.
+
# Insert the SIM card into the SIM card holder, taking care to slide inside the two metal tabs in the cover.  Please note that the electrical contacts should face down and that the cut corner should be closest to the external GPS Antenna Socket.
+
# Close the SIM card holder and lock it by sliding the metal clip towards the external GPS Antenna Socket on the FreeRunner.
+
# Insert the battery into the battery compartment, aligning the electrical contacts on the battery with the electrical contacts in the battery compartment.  Insert the side with the electrical contacts first.
+
# Replace the rear cover on the FreeRunner.
+
 
+
===Turning on the Neo Freerunner===
+
 
+
====Charging the Neo Freerunner====
+
 
+
When using the Neo Freerunner for the first time, you should charge the battery completely. The battery can be charged using the provided charger or from a powered USB port capable of providing 500mA worth of power.  Most computers will be able to charge the FreeRunner without any problems.
+
 
+
Charging at 100mA takes 6-12 hours and at 500mA takes 1-2 hours. (from [http://openmoko.togaware.com/survivor/Charging.html openmoko.togaware.com])
+
 
+
You can boot your Neo FreeRunner in the following ways:
+
 
+
: [[Image:Circle2.gif|10px]]    You can power it up into an Openmoko image directly.
+
 
+
: [[Image:Circle2.gif|10px]]    You can boot it into [[Bootloader|U-Boot]] via [[NAND Flash]].
+
 
+
: [[Image:Circle2.gif|10px]]    You can boot it into U-Boot via NOR Flash.
+
 
+
Booting the device into NAND and NOR Flash allows you to update the kernel and root filesystem.
+
 
+
====Start the Openmoko Image====
+
 
+
<div align-center>
+
<table width="100%" style="clear: both; border: 1px solid #ffffff; border-collapse: collapse; padding: 0.2em; margin: 0; font-size: 100%; margin: 0 1px;">
+
<tr valign="top" style="background: #ffffff">
+
<td style="width: 25px; padding-left: 0.5em;">
+
 
+
</td>
+
<td style="width: 10px; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #ffffff;">[[Image:Menu2.jpg|200px|right|thumb]]</td><td style="padding: 1px 1em 0; background: #eeeeee;">
+
Press and hold Power button for about 8 seconds, until the Openmoko splash screen turns up.  You may now release the Power button and the Neo FreeRunner will continue to boot into the Openmoko Image.
+
 
+
</td></tr></table>
+
</div>
+
 
+
====Log into U-Boot in NAND Flash====
+
 
+
<div align-center>
+
<table width="100%" style="clear: both; border: 1px solid #ffffff; border-collapse: collapse; padding: 0.2em; margin: 0; font-size: 100%; margin: 0 1px;">
+
<tr valign="top" style="background: #ffffff">
+
<td style="width: 25px; padding-left: 0.5em;">
+
 
+
</td>
+
<td style="width: 10px; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #ffffff;">[[Image:Menu7.jpg|200px|right|thumb]]</td><td style="padding: 1px 1em 0; background: #eeeeee;">
+
Press and hold Power button, then press and hold AUX button for about 5 to 8 seconds. You should see the boot menu for the NAND Flash.  Press the AUX button to select one of the options and then press the Power button to execute.
+
</td></tr></table>
+
</div>
+
 
+
====Log into U-Boot in the NOR Flash====
+
 
+
<div align-center>
+
<table width="100%" style="clear: both; border: 1px solid #ffffff; border-collapse: collapse; padding: 0.2em; margin: 0; font-size: 100%; margin: 0 1px;">
+
<tr valign="top" style="background: #ffffff">
+
<td style="width: 25px; padding-left: 0.5em;">
+
 
+
</td>
+
<td style="width: 10px; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #ffffff;">[[Image:Menu6.jpg|200px|right|thumb]]</td><td style="padding: 1px 1em 0; background: #eeeeee;">
+
 
+
Press and hold the AUX button, then press and hold the Power button. Then, release the AUX button. You should see the boot menu for the NOR Flash.  This option is usually used by developers or when flashing the FreeRunner.  If you cannot log into U-Boot in NAND then you can log into U-Boot in the NOR Flash either.
+
</td></tr></table>
+
</div>
+
 
+
{{note| There are six options you can choose when you log into the NOR Flash.
+
1. Boot
+
 
+
2. [[Boot from sd card|Boot from MicroSD]]
+
 
+
3. Set console to USB
+
 
+
4. Set console to Serial
+
 
+
5. Reset
+
 
+
6. Power off
+
 
+
}}
+
 
+
===Unlocking the screen===
+
 
+
When the screen is locked, you should see a Matrix-style green graphic with the Openmoko symbol in the middle of the bottom of the screen along with lock and unlock symbols.  If you drag the Openmoko symbol to the unlock symbol at the top then the screen will become unlocked.
+
 
+
==Flashing the Neo FreeRunner==
+
As Openmoko development continues, Openmoko regularly releases updated versions of the Openmoko root filesystem, the kernel, and the[[Bootloader| U-Boot]]. These may be programmed into the Flash memory of Neo FreeRunner. You can use the USB cable and Openmoko provided tool to flash Neo FreeRunner.
+
 
+
{{note|The Openmoko software team builds images daily. If you want to use the latest images, you can download the image from the daily build, but we recommend you download the most stable image from http://downloads.openmoko.org/releases/Freerunner/. Images here have been tested by the test team.
+
 
+
More about current Images: http://wiki.openmoko.org/wiki/Latest_Images}}
+
 
+
===Step1. Download the DFU-util===
+
 
+
You can download the flashing tool from:
+
http://downloads.openmoko.org/releases/Freerunner/dfu-util
+
 
+
On the GNU/Linux host, you you can use following command to download dfu-util:
+
wget http://downloads.openmoko.org/releases/Freerunner/dfu-util
+
 
+
Afterwards you have to change the rights:
+
chmod a+x dfu-util
+
 
+
===Step 2. Flashing the Kernel===
+
 
+
You can download the kernel from
+
http://downloads.openmoko.org/releases/Freerunner/
+
 
+
Type in the following command in the terminal of a GNU/Linux host. On some systems you need to be root.
+
./dfu-util -a (partion name) -R -D (download image file name)
+
 
+
 
+
ex:
+
 
+
./dfu-util -a kernel -R -D uImage-2.6.24+svnr4082-r4055-r3-neo1973.bin
+
 
+
{| class="wikitable" cellspacing="2" cellpadding="2" style="padding: 0%; margin:0em 0em 1em 0em; border:0px solid #ffffff; background:#ffffff; width:100%;floating="center"; "
+
! style="background:#ffffff;border-left:1px solid #ffffff;border-right:1px ; border-top:2px solid ffffff; border:1px solid #ffffff; width:75% " | 
+
<div align="left">
+
[[Image:menu15.jpg|thumb|Log into U-Boot in NOR Flash, connect your Neo with Linux Host via USB cable]]
+
Before you execute the command , please log into U-Boot in NOR Flash. Neo FreeRunner needs to boot into U-Boot when flashing.
+
 
+
Then connect your Neo with Linux Host via USB cable. Press Enter to execute the command. When flashing succeeds
+
 
+
status(0) = No error condition is present<br>
+
Done!
+
</div>
+
|}
+
 
+
{{note| The meaning of  parameter you spcified:
+
-a  --alt alt Specify the altsetting of the DFU interface by name or by number<br>
+
-R  --reset Issue USB Reset signalling once we're finished<br>
+
-D  --download file Write firmware from<file> into device <br>
+
}}
+
 
+
===Step 3. Flashing Root Filesystem ===
+
You can download the root filesystem from :
+
http://downloads.openmoko.org/releases/Freerunner/
+
 
+
Type in the following command in the terminal of a GNU/Linux host. On some systems you need to be root.
+
 
+
./dfu-util -a rootfs -R -D openmoko-devel-image-fic-gta02.jffs2
+
 
+
When flashing succeeds
+
 
+
status(0) = No error condition is present<br>
+
Done!
+
 
+
==Connect To Neo FreeRunner By USB Networking==
+
 
+
Connect Neo FreeRunner to Linux host with USB cable. For OS X please refer to [[MacOS_X]]. After booting into Openmoko image, there will be a new interface, usb0, in your Linux host.
+
 
+
=====Manual Method=====
+
Type in the following command in the terminal of a GNU/Linux host.
+
 
+
ifconfig usb0 192.168.0.200 netmask 255.255.255.0
+
ssh root@192.168.0.202
+
 
+
Press Enter to pass the password.
+
 
+
=====Automatic Method=====
+
*Debian and derivatives (Ubuntu, Sidux etc.)
+
Edit /etc/network/interfaces
+
 
+
auto usb0
+
iface usb0 inet static
+
address 192.168.0.200
+
netmask 255.255.255.0
+
 
+
*Gentoo
+
Edit /etc/conf.d/net
+
 
+
config_usb0="192.168.0.200/24"
+
 
+
Restart the networking service (/etc/init.d/networking restart for Debian-based) and type in the following command in the terminal of GNU/Linux host.
+
 
+
ssh root@192.168.0.202
+
 
+
Press Enter to pass the password.
+
 
+
=====Making things even more automatic=====
+
If you don't want to remember the IP number of your phone you can create an alias by adding the following line to your /etc/hosts:
+
 
+
192.168.0.202  openmoko
+
 
+
Now it should immediately be possible to connect your phone using the following command line:
+
 
+
ssh root@openmoko
+
 
+
The above only gets you a ssh on the Openmoko, it does not allow the Openmoko to connect to the Internet. To do this, follow the instructions in the [[USB_Networking]] section.
+
 
+
==Appendix==
+
If you want to know more about the Neo FreeRunner then you can get more information in the following topics:
+
* [[GTA02 Openness]]
+
* [[Neo FreeRunner]]
+
* [[Neo FreeRunner GTA02 Hardware]]
+
* [[FreeRunner/Buttons and LEDs]]
+
* [[Latest_Images]]
+
 
+
[[Category:GTA02 Hardware]]
+

Latest revision as of 23:25, 27 August 2009

  1. REDIRECT Manuals/Neo FreeRunner
Personal tools


Thank you for purchasing this Developer release of Neo FreeRunner. The Neo FreeRunner phone is the second hardware platform to take advantage of Openmoko. This guide will help you get to know your Neo FreeRunner and how to start using your Neo FreeRunner.

Neo FreeRunner Package

The Package Contents

Inside package
Circle2.gif Neo FreeRunner
Circle2.gif Stylus
Circle2.gif Battery
Circle2.gif Charger
Circle2.gif USB Cable
Circle2.gif microSD Card 512MB

Getting To Know the Neo FreeRunner

AUX Button and phone jack(From left to right)
Power Button, USB and external GPS Antenna (From left to right)
AUX Back side with battery
Put the SIM card and SD card here
open case from this side
Opened

Installing the Micro-SD card, the SIM card, and the Battery

  1. Remove the rear cover of the Neo FreeRunner by first holding the Neo FreeRunner on the side and then use your fingernail to prise off the rear cover at the slot on top of the device.
  2. Now you should be able to locate the combined SIM and Micro-SD card holder at the bottom of the battery compartment.
  3. Unlock the SIM card holder by sliding the metal clip down, towards the USB socket, with your fingernail. Use caution, as these parts are delicate and could be damaged by forcing them in the wrong direction.
  4. Lift up on the SIM card holder.
  5. The Micro-SD card holder is held in place by a latch on either side. It is easiest to open the Micro-SD card holder by releasing these latches one at a time rather than by lifting from the middle, as lifting from the middle tends to increase the latching pressure. A small screwdriver or knife can be used for this.
  6. Insert the Micro-SD card into the Micro-SD card holder. Note that the electrical contacts should face down and towards the edge of the Neo Freerunner.
  7. Close the Micro-SD card holder, making sure that both latches are securely fastened.
  8. Insert the SIM card into the SIM card holder, taking care to slide inside the two metal tabs in the cover. Please note that the electrical contacts should face down and that the cut corner should be closest to the external GPS Antenna Socket.
  9. Close the SIM card holder and lock it by sliding the metal clip towards the external GPS Antenna Socket on the FreeRunner.
  10. Insert the battery into the battery compartment, aligning the electrical contacts on the battery with the electrical contacts in the battery compartment. Insert the side with the electrical contacts first.
  11. Replace the rear cover on the FreeRunner.

Turning on the Neo Freerunner

Charging the Neo Freerunner

When using the Neo Freerunner for the first time, you should charge the battery completely. The battery can be charged using the provided charger or from a powered USB port capable of providing 500mA worth of power. Most computers will be able to charge the FreeRunner without any problems.

Charging at 100mA takes 6-12 hours and at 500mA takes 1-2 hours. (from openmoko.togaware.com)

You can boot your Neo FreeRunner in the following ways:

Circle2.gif You can power it up into an Openmoko image directly.
Circle2.gif You can boot it into U-Boot via NAND Flash.
Circle2.gif You can boot it into U-Boot via NOR Flash.

Booting the device into NAND and NOR Flash allows you to update the kernel and root filesystem.

Start the Openmoko Image

Menu2.jpg

Press and hold Power button for about 8 seconds, until the Openmoko splash screen turns up. You may now release the Power button and the Neo FreeRunner will continue to boot into the Openmoko Image.

Log into U-Boot in NAND Flash

Menu7.jpg

Press and hold Power button, then press and hold AUX button for about 5 to 8 seconds. You should see the boot menu for the NAND Flash. Press the AUX button to select one of the options and then press the Power button to execute.

Log into U-Boot in the NOR Flash

Menu6.jpg

Press and hold the AUX button, then press and hold the Power button. Then, release the AUX button. You should see the boot menu for the NOR Flash. This option is usually used by developers or when flashing the FreeRunner. If you cannot log into U-Boot in NAND then you can log into U-Boot in the NOR Flash either.

NOTE: There are six options you can choose when you log into the NOR Flash.

1. Boot

2. Boot from MicroSD

3. Set console to USB

4. Set console to Serial

5. Reset

6. Power off



Unlocking the screen

When the screen is locked, you should see a Matrix-style green graphic with the Openmoko symbol in the middle of the bottom of the screen along with lock and unlock symbols. If you drag the Openmoko symbol to the unlock symbol at the top then the screen will become unlocked.

Flashing the Neo FreeRunner

As Openmoko development continues, Openmoko regularly releases updated versions of the Openmoko root filesystem, the kernel, and the U-Boot. These may be programmed into the Flash memory of Neo FreeRunner. You can use the USB cable and Openmoko provided tool to flash Neo FreeRunner.

NOTE: The Openmoko software team builds images daily. If you want to use the latest images, you can download the image from the daily build, but we recommend you download the most stable image from http://downloads.openmoko.org/releases/Freerunner/. Images here have been tested by the test team.

More about current Images: http://wiki.openmoko.org/wiki/Latest_Images


Step1. Download the DFU-util

You can download the flashing tool from: http://downloads.openmoko.org/releases/Freerunner/dfu-util

On the GNU/Linux host, you you can use following command to download dfu-util:

wget http://downloads.openmoko.org/releases/Freerunner/dfu-util

Afterwards you have to change the rights:

chmod a+x dfu-util

Step 2. Flashing the Kernel

You can download the kernel from http://downloads.openmoko.org/releases/Freerunner/

Type in the following command in the terminal of a GNU/Linux host. On some systems you need to be root.

./dfu-util -a (partion name) -R -D (download image file name)


ex:

./dfu-util -a kernel -R -D uImage-2.6.24+svnr4082-r4055-r3-neo1973.bin
Log into U-Boot in NOR Flash, connect your Neo with Linux Host via USB cable

Before you execute the command , please log into U-Boot in NOR Flash. Neo FreeRunner needs to boot into U-Boot when flashing.

Then connect your Neo with Linux Host via USB cable. Press Enter to execute the command. When flashing succeeds

status(0) = No error condition is present
Done!

NOTE: The meaning of parameter you spcified:

-a --alt alt Specify the altsetting of the DFU interface by name or by number
-R --reset Issue USB Reset signalling once we're finished
-D --download file Write firmware from<file> into device


Step 3. Flashing Root Filesystem

You can download the root filesystem from : http://downloads.openmoko.org/releases/Freerunner/

Type in the following command in the terminal of a GNU/Linux host. On some systems you need to be root.

./dfu-util -a rootfs -R -D openmoko-devel-image-fic-gta02.jffs2

When flashing succeeds

status(0) = No error condition is present
Done!

Connect To Neo FreeRunner By USB Networking

Connect Neo FreeRunner to Linux host with USB cable. For OS X please refer to MacOS_X. After booting into Openmoko image, there will be a new interface, usb0, in your Linux host.

Manual Method

Type in the following command in the terminal of a GNU/Linux host.

ifconfig usb0 192.168.0.200 netmask 255.255.255.0
ssh root@192.168.0.202

Press Enter to pass the password.

Automatic Method

Edit /etc/network/interfaces

auto usb0
iface usb0 inet static
address 192.168.0.200
netmask 255.255.255.0

Edit /etc/conf.d/net

config_usb0="192.168.0.200/24"

Restart the networking service (/etc/init.d/networking restart for Debian-based) and type in the following command in the terminal of GNU/Linux host.

ssh root@192.168.0.202

Press Enter to pass the password.

Making things even more automatic

If you don't want to remember the IP number of your phone you can create an alias by adding the following line to your /etc/hosts:

192.168.0.202   openmoko

Now it should immediately be possible to connect your phone using the following command line:

ssh root@openmoko

The above only gets you a ssh on the Openmoko, it does not allow the Openmoko to connect to the Internet. To do this, follow the instructions in the USB_Networking section.

Appendix

If you want to know more about the Neo FreeRunner then you can get more information in the following topics:

Tools