View source for Getting Started with your Neo FreeRunner
From Openmoko
You do not have permission to edit this page, for the following reasons:
You can view and copy the source of this page:
Return to Getting Started with your Neo FreeRunner.
You do not have permission to edit this page, for the following reasons:
You can view and copy the source of this page:
Return to Getting Started with your Neo FreeRunner.
Languages: |
English • العربية • Български • Česky • Dansk • Deutsch • Esperanto • Eesti • Español • فارسی • Suomi • Français • עברית • Magyar • Italiano • 한국어 • Nederlands • Norsk (bokmål) • Polski • Português • Română • Русский • Svenska • Slovenčina • Українська • 中文(中国大陆) • 中文(台灣) • Euskara • Català |
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. |
---|
When using the Neo Freerunner for the first time, you should charge the battery completely. The battery can be charged using the provided charger (at 1000mA) 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.
Charging at 100mA takes 6-12 hours and at 500mA takes 1-2 hours. (from openmoko.togaware.com)
Holding the power button brings up a menu allowing you to power on and off the gps, wifi, gsm, and bluetooth antennae, and also to shutdown the device.
Holding the aux button for a second brings up a menu allowing you
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.
Mounted at /media/card
If you can export your contacts to VCard format, either multiple files or single file containing all of them, you may use the script on Import Vcf Contacts page to bring them to Neo.
Connect the Neo FreeRunner to a GNU/Linux host with the USB cable. For Mac OS X please refer to MacOS_X. For Windows XP and Vista please refer to Neo1973_and_Windows (which also works for the FreeRunner). After booting into the Openmoko image there will be a new interface, usb0, on your GNU/Linux host.
Type in the following commands 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 get by the password.
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 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.
NOTE:
If your network device is using the ip range 192.168.0.x you may have to use the following command before you are able to connect route add -host 192.168.0.202 dev usb0 |
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.
In Ubuntu:
Within /etc/network/interfaces, change your interface setup to this:
auto usb0 iface usb0 inet static address 192.168.0.200 netmask 255.255.255.0 network 192.168.0.0 up iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24 & up echo 1 > /proc/sys/net/ipv4/ip_forward & up iptables -P FORWARD ACCEPT & down iptables -D POSTROUTING -t nat -j MASQUERADE -s 192.168.0.0/24 &
In Fedora:
Set /etc/sysconfig/network-scripts/ifcfg-usb0 to this:
DEVICE=usb0 IPADDR=192.168.0.200 NETMASK=255.255.255.0
Set /etc/sysconfig/network-scripts/ifup-usb to this:
#!/bin/bash . /etc/init.d/functions cd /etc/sysconfig/network-scripts . ./network-functions [ -f ../network ] && . ../network CONFIG=${1} need_config ${CONFIG} source_config NETBITS=`ipcalc -p ${IPADDR} ${NETMASK} | awk -F'=' '{print $2;}'` /sbin/ip addr flush dev ${DEVICE} 2>/dev/null /sbin/ip link set dev ${DEVICE} up /sbin/ip addr add dev ${DEVICE} ${IPADDR}/${NETBITS} /sbin/iptables -I POSTROUTING -t nat -j MASQUERADE -s ${IPADDR}/${NETBITS} /sbin/sysctl net.ipv4.ip_forward=1 /sbin/iptables -I FORWARD -s ${IPADDR}/${NETBITS} -j ACCEPT /sbin/iptables -I FORWARD -d ${IPADDR}/${NETBITS} -j ACCEPT
Set /etc/sysconfig/network-scripts/ifdown-usb to this:
#!/bin/bash . /etc/init.d/functions cd /etc/sysconfig/network-scripts . ./network-functions [ -f ../network ] && . ../network CONFIG=${1} need_config ${CONFIG} source_config NETBITS=`ipcalc -p ${IPADDR} ${NETMASK} | awk -F'=' '{print $2;}'` /sbin/iptables -D FORWARD -d ${IPADDR}/${NETBITS} -j ACCEPT /sbin/iptables -D FORWARD -s ${IPADDR}/${NETBITS} -j ACCEPT /sbin/sysctl net.ipv4.ip_forward=0 /sbin/iptables -D POSTROUTING -t nat -j MASQUERADE -s ${IPADDR}/${NETBITS} /sbin/ip link set dev ${DEVICE} down /sbin/ip addr flush dev ${DEVICE} 2>/dev/null
If you are using NetworkManager, restart it and enable the usb device from its menu, otherwise it will disable your connection shortly after you enable it.
/sbin/service NetworkManager restart
Once your PC is setup, then edit /etc/network/interfaces on your FreeRunner and modify the code from this:
iface usb0 inet static address 192.168.0.202 netmask 255.255.255.0 network 192.168.0.0 gateway 192.168.0.200 up echo nameserver 192.168.0.200 > /etc/resolv.conf
to something that points to a real name server, like a public DNS system from OpenDNS, like this:
iface usb0 inet static address 192.168.0.202 netmask 255.255.255.0 network 192.168.0.0 gateway 192.168.0.200 up echo nameserver 208.67.222.222 > /etc/resolv.conf up echo nameserver 208.67.220.220 >> /etc/resolv.conf
Note: vi appears to be the only text editor available by default. See basic vi commands for help.
On the factory loaded OM2007.2 image, run the following to restart networking for the DNS changes to take effect:
/etc/rc0.d/K40networking restart
If you are still unable to get the freerunner access to the internet, and are using Mandriva and/or happen to have your LAN on 192.168.0.0/24, this page may help you.
The stock Openmoko2007.2 image flashed onto the Neo FreeRunner 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:
# dbus-launch gconftool-2 -t boolean -s /desktop/poky/interface/reduced false # /etc/init.d/xserver-nodm restart
If you rather have a regular clock instead of the digital one, do this instead:
# dbus-launch gconftool-2 -t boolean -s /desktop/poky/interface/reduced false # dbus-launch gconftool-2 -t boolean -s /desktop/poky/interface/digital_clock false # /etc/init.d/xserver-nodm restart
With either clock, you may wish to set the correct Timezone.
Also, if you prefer having a full keyboard, see these instructions.
Finally, you might want to update your package list to know about the most recent versions:
# opkg update
Simple guide to get going with GPS:
# opkg install gpsd
On the FreeRunner,
# echo "GPS_DEV=\"/dev/ttySAC1\"" > /etc/default/gpsd
and restart gpsd, the gps daemon, with
# /etc/init.d/gpsd restart
To test GPS, you can use agpsui:
# opkg install openmoko-agpsui
For a nice map, try tangoGPS:
# opkg install tangogps
More information on GPS page.
See Manually using GPRS. According to some posts, GPRS might be broken currently (2007.2), though. Any updates welcome.
See GTA02 WLAN.
For a Media Player:
# opkg install openmoko-mediaplayer2 # wget http://abraxa.dyndns.org:81/random/openmoko-mediaplayer-theme.tar.bz2 # tar xjf openmoko-mediaplayer-theme.tar.bz2 -C /usr/share/themes/Moko/gtk-2.0 # rm openmoko-mediaplayer-theme.tar.bz2
If you want a basic image viewer, have a look at the one from the gpe suite:
# opkg install gpe-icons gpe-gallery
To obtain the standard web browser, use:
# opkg install openmoko-browser2
An alternative browser, minimo, offers many more features. First download and unpack it on your GNU/Linux host:
# wget http://www.ginguppin.de/files/minimo.tar.bz2 # tar jvxf minimo.tar.bz2
Copy it over to the FreeRunner:
# scp minimo_* root@openmoko:/tmp
Then on the FreeRunner:
# opkg install /tmp/minimo_0.02\+cvs20070626-r0_armv4t.ipk
There are tons more apps you can install - check out the Repositories for a list of packages.
You can boot your Neo FreeRunner in the following ways:
Booting the device into NAND and NOR Flash allows you to update the kernel and root filesystem.
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. |
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. |
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 3. Set console to USB 4. Set console to Serial 5. Reset 6. Power off |
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. |
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 |
You can download the flashing tool from: http://downloads.openmoko.org/releases/Freerunner/dfu-util
On the GNU/Linux host you can use the following command to download the dfu-util:
wget http://downloads.openmoko.org/releases/Freerunner/dfu-util
Afterwards you have to change the rights on the file:
chmod a+x dfu-util
Before you execute the following command, please log into U-Boot in the NOR Flash. The Neo FreeRunner needs to be booted into U-Boot for flashing. You will then need to connect your Neo with the GNU/Linux host via USB cable. You can download the kernel from http://downloads.openmoko.org/releases/Freerunner/ Type in the following command in the terminal on a GNU/Linux host. On some systems you need to be root before this will work and on Ubuntu you must preface the command with "sudo" or you will get the following error: "Cannot claim interface: could not claim interface 2: Operation not permitted" ./dfu-util -a (partion name) -R -D (download image file name) ex: ./dfu-util -a kernel -R -D uImage-2.6.24+git20080424-om-gta02.bin Press Enter to execute the command. When flashing succeeds the following will be shown: status(0) = No error condition is present |
---|
NOTE: The meaning of the parameters you specified:
-a --alt alt Specify the altsetting of the DFU interface by name or by number |
You can download the root filesystem from: http://downloads.openmoko.org/releases/Freerunner/
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!
If you want to know more about the Neo FreeRunner then you can get more information in the following topics:
To search this wiki with Google, use the following search term:
<search term> site:http://wiki.openmoko.org/wiki/
An excellent tool for searching all the openmoko mailing lists is http://openmoko.markmail.org/