Getting Started with your Neo FreeRunner

From Openmoko

(Difference between revisions)
Jump to: navigation, search
m
(redirecting to FreeRunner manual)
 
(423 intermediate revisions by more than 100 users not shown)
Line 1: Line 1:
{{Languages|Getting Started with your Neo FreeRunner}}
+
#REDIRECT [[Manuals/Neo FreeRunner]]
__NOTOC__
+
__NOEDITSECTION__
+
 
+
{| 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]]
+
|}
+
 
+
 
+
=Contents =
+
 
+
: [[Image:Circle2.gif|10px]]  What Is In The Box
+
 
+
: [[Image:Circle2.gif|10px]]  Getting To Know Neo FreeRunner
+
 
+
: [[Image:Circle2.gif|10px]]  Turning On Neo FreeRunner
+
 
+
: [[Image:Circle2.gif|10px]]  Flashing Neo FreeRunner
+
 
+
: [[Image:Circle2.gif|10px]]  Connect To Neo FreeRunner By USB Networking.
+
 
+
 
+
== What Is In The Box==
+
 
+
{| 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 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, 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>
+
 
+
===Turning On Neo FreeRunner===
+
 
+
You can boot your Neo FreeRunner in following ways:
+
 
+
: [[Image:Circle2.gif|10px]]    You can power up into an Openmoko image directly.
+
 
+
: [[Image:Circle2.gif|10px]]    Boot into [[Bootloader|U-Boot]] via [[NAND Flash]].
+
 
+
: [[Image:Circle2.gif|10px]]    Boot into U-Boot via NOR Flash.
+
 
+
These ways allows you to update the kernel and root filesystem.
+
 
+
====Log in 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 (about 8 seconds) until Openmoko splash screen turns up. You may now release the Power button, and Neo FreeRunner will continue to boot into Openmoko Image.
+
 
+
</td></tr></table>
+
</div>
+
 
+
 
+
====Log in 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 (about 5~8 seconds ). You can see BOOT MENU for NAND Flash.  Press AUX to select the options, Power to execute.
+
</td></tr></table>
+
</div>
+
====Log in U-Boot in 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 AUX button, then press and hold Power button. Release AUX button. You can see BOOT MENU for NOR Flash. ( This options usually used for developer. If you can't log in NAND , you can log in U-Boot in NOR Flash. )
+
</td></tr></table>
+
</div>
+
 
+
{{note| There are six options you can choose when you log in 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
+
 
+
}}
+
 
+
==Flashing 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|Openmoko software team build images daily. If you want to use the newest image, you can download image from daily build.  But we recommend you download the most stable image from http://downloads.openmoko.org/releases/Freerunner/. Images here has been tested by test team.}}
+
 
+
===Step1. Download DFU-until===
+
 
+
You can download the flashing tool from:
+
http://downloads.openmoko.org/releases/Freerunner/dfu-util
+
 
+
On the GNU/Linux host, you you can use folloing command download U-Boot utility.
+
wget http://downloads.openmoko.org/releases/Freerunner/dfu-util
+
+
===Step 2. Flashing Kernel===
+
 
+
You can download kernel from
+
http://downloads.openmoko.org/releases/Freerunner/
+
 
+
Type in the following command in the terminal of a GNU/Linux host.
+
./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 in Neo FressRunner in NOR Flash, connect your Neo with Linux Host via USB cable]]
+
Before you execute the command , please log in Neo FreeRunner 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 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.
+
 
+
./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
+
 
+
Restart the networking service 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
+
 
+
====Appendex====
+
If you want to know more about FreeRunner, you can get more information in following topics:
+
* [[GTA02 Openness]]
+
* [[Neo FreeRunner]]
+
* [[Neo FreeRunner GTA02 Hardware]]
+
* [[FreeRunner/Buttons and LEDs]]
+
 
+
[[Category:Hardware Support]]
+
[[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


Contents

Circle2.gif What Is In The Box
Circle2.gif Getting To Know Neo FreeRunner
Circle2.gif Turning On Neo FreeRunner
Circle2.gif Flashing Neo FreeRunner
Circle2.gif Connect To Neo FreeRunner By USB Networking.


What Is In The Box

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 Neo FreeRunner

AUX Button and phone jack(From left to right)
Power, 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

Turning On Neo FreeRunner

You can boot your Neo FreeRunner in following ways:

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

These ways allows you to update the kernel and root filesystem.

Log in Openmoko Image

Menu2.jpg

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


Log in U-Boot in NAND Flash

Menu7.jpg

Press and hold Power button, then press and hold AUX button (about 5~8 seconds ). You can see BOOT MENU for NAND Flash. Press AUX to select the options, Power to execute.

Log in U-Boot in NOR Flash

Menu6.jpg

Press and hold AUX button, then press and hold Power button. Release AUX button. You can see BOOT MENU for NOR Flash. ( This options usually used for developer. If you can't log in NAND , you can log in U-Boot in NOR Flash. )

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

1. Boot

2. Boot from MicroSD

3. Set console to USB

4. Set console to Serial

5. Reset

6. Power off



Flashing 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: Openmoko software team build images daily. If you want to use the newest image, you can download image from daily build. But we recommend you download the most stable image from http://downloads.openmoko.org/releases/Freerunner/. Images here has been tested by test team.


Step1. Download DFU-until

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

On the GNU/Linux host, you you can use folloing command download U-Boot utility.

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

Step 2. Flashing Kernel

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

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

./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 in Neo FressRunner in NOR Flash, connect your Neo with Linux Host via USB cable

Before you execute the command , please log in Neo FreeRunner 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 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.

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

Restart the networking service 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

Appendex

If you want to know more about FreeRunner, you can get more information in following topics:

Tools