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.

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 current. Most computers will be able to charge the FreeRunner without any problems.

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

Start the Openmoko Image

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 the NAND Flash

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

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.

NOTE: The term Logging in used in this context means to turn on the device using the described method, and leaving it at the U-Boot menu. To avoid the device automatically booting, tap the AUX key to move the selector bar. Note also that the device will not automatically turn off while flashing is in progress.

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.

Step 3. Flashing the Root Filesystem

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

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

When flashing succeeds the following will be shown:

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

Connect to the Neo FreeRunner By USB Networking

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

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

ssh root@192.168.0.202

Press Enter to get by the password.

Making things even more automatic

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

192.168.0.202 openmoko

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

ssh root@openmoko

The above only gets you a Secure Shell connection to the Openmoko device, it does not allow the Openmoko device to connect to the Internet. If you are interested in connecting the device to the internet then check out the USB_Networking section.

Un-crippling the 2007.2 image

The stock 2007.2 image flashed onto the Neo FreeRunner after its production is really just the bare bones. For example, you don't have the clock and the quick-launch icons showing. Here's how you can change that:

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

Neo FreeRunner

Stylus

Battery

Charger

USB Cable

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

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 current. Most computers will be able to charge the FreeRunner without any problems.

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

Start the Openmoko Image

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 the NAND Flash

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

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.

NOTE: The term Logging in used in this context means to turn on the device using the described method, and leaving it at the U-Boot menu. To avoid the device automatically booting, tap the AUX key to move the selector bar. Note also that the device will not automatically turn off while flashing is in progress.

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.

Step 3. Flashing the Root Filesystem

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

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

When flashing succeeds the following will be shown:

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

Connect to the Neo FreeRunner By USB Networking

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

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

ssh root@192.168.0.202

Press Enter to get by the password.

Making things even more automatic

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

192.168.0.202 openmoko

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

ssh root@openmoko

The above only gets you a Secure Shell connection to the Openmoko device, it does not allow the Openmoko device to connect to the Internet. If you are interested in connecting the device to the internet then check out the USB_Networking section.

Un-crippling the 2007.2 image

The stock 2007.2 image flashed onto the Neo FreeRunner after its production is really just the bare bones. For example, you don't have the clock and the quick-launch icons showing. Here's how you can change that: