View source for Manuals/Android

From Openmoko

Jump to: navigation, search

You do not have permission to edit this page, for the following reasons:

  • The action you have requested is limited to users in the group: Administrators.
  • You must confirm your email address before editing pages. Please set and validate your email address through your user preferences.

You can view and copy the source of this page:

Return to Manuals/Android.

Personal tools




This page is dedicated to the daily usage of Android on the Neo 1973 and Neo FreeRunner handsets.

The informations here have been updated for the following release : Koolu Beta3 Android release. But should be the same for any not too old release.

You can find general informations (porting/development and day to day usage) about Android and Neo phones here : Android

Getting started

The power button

  • To turn the phone on, press and hold the power button for about 5 seconds
  • To wake the phone from sleep, tap the power button twice then once more to unlock the screen
  • To turn the phone off, wake it from sleep then hold the power button for about 4-5 seconds. Choose 'Power off' in the menu that appears then click 'OK'

Making a call

Once the phone has started you will see a 'Dialer' icon on the desktop, touch it and you will be presented with a dialling keypad. Enter the number you wish to dial and then touch the bar containing the number to call. If you make a mistake entering the number you can touch the backspace arrow to the right of the bar.


  • The volume level when in a voice call is very low



Works, can be tested with simple game called Amazed which is already installed on current Koolu images.


Works, latest kernels need permissions for second rfkill interface in init.rc to turn it on.


Works, you can install AndNav2 (AndNav2 is already installed on current Koolu images) to test it. It is currently not possible to disable the GPS from the UI once activated.


Does not work, GSM get's confused when you try to use it

Network settings



Although wifi works, there are two problems; one, you can't bring up a keyboard to enter your encryption key and two, Android does not obtain the DNS settings properly from the router. Both can be worked around.

Solution one

Install aKeyUI this app allows you to enter text and copy it to a clipboard, which you can then paste into any test field:

Change directory to where you downloaded the app then install:

# adb install aKeyUI.apk

Touch the Application tab to display your installed apps, aKeyUI should be one of them. Load it up, enter the key for your wireless network and click copy.

Now go to 'Settings' > 'Wireless controls' > 'Wi-Fi settings' and you should see your wireless network listed there. Touch it and when it asks you for the key, long-touch the key field and select paste.

Now you are connected but you need to add a DNS server to android. Connect to Android using adb and pull your init.rc:

# ifconfig usb0 netmask
# adb kill-server
# ADBHOST= adb devices
# adb pull /init.rc init.rc
# chown YOUR_USER:YOUR_GROUP init.rc

Now edit your init.rc, placing this line at the end, replacing x.x.x.x with a DNS server

setprop net.dns1 x.x.x.x

Change the ownership back to root and push it back to your FreeRunner:

# chown root:root init.rc
# adb shell mount -o remount,rw /dev/root /
# adb push init.rc /init.rc
# adb shell sync
# adb shell reboot

Solution two

Boot your FreeRunner while connected to USB then run these commands:

# ifconfig usb0 netmask
# adb kill-server
# ADBHOST= adb devices
# adb shell mount -o remount,rw /dev/root /
# adb pull /etc/wifi/wpa_supplicant.conf wpa_supplicant.conf

You will now have the wpa_supplicant.conf file in your working directory, change it's ownership so you can edit it:

# chown YOUR_USER:YOUR_GROUP wpa_supplicant.conf 

Now you can edit it to contain your wireless details, then push it back to the FreeRunner. For example add an uncommented section like this:

pairwise=CCMP TKIP
group=CCMP TKIP WEP104 WEP40

Save your changes, change the owner back to root and push it back to the FreeRunner:

# chown root:root wpa_supplicant.conf
# adb push wpa_supplicant.conf /etc/wifi

Reboot the FreeRunner:

# adb shell sync
# adb shell reboot

"setprop net.dns1 $YOUR_DNS_IP"

Data management



From Vcard

  1. install "Android Contacts Import" (this applications is also available from AndAppStore)
  2. export your contact(s) as a vcard file from your contact application
  3. copy the file to your phone /sdcard/ directory
  4. on your phone run the ImportContacts application, choose the file you copied and select import. Wait until the phone says x vcards imported

That's it if you don't see your contacts, make sure you selected "view all contacts" in the contacts applications options (contacts > powerbutton > Display group > All contacts)

From SIM

Works, Contacts->menu->Settings->SIM contacts importer.









You can copy files to your phone using either

or, from the command line using

ADBHOST= ./adb push file.txt /sdcard/


Can play OGG audio files and view pictures with the default applications



Software keyboard

Works, can be brought up with short press to power button.


Waking up your phone might be a little bit tricky at the moment, there are several recipe/hints submitted by different people :

  • 1-2s press of power button goes to sleep, wake up with long power button press, don't use screen timeouts, disable it in Settings->Sound & display->Screen timeout->Never timeout.
  • Michael Trimarchi's images allow resume from suspend after two short presses. However, sometimes it takes a few tries for the phone to wake up.
  • For me resume works best if i long press power until the main screen appears and the short power press that unlocks screen.
  • During suspend the phone seems to wake up make an audible click and go back to sleep.

USB networking

The general USB Networking guide should help you talk to your FreeRunner using IP over USB. However, please note that Android doesn't come with an ssh server installed by default. In order to gain shell access without an additional ssh server you can follow the instructions on the Android debug bridge page.

USB Host mode

TODO: If you know how to change the USB mode with Android, please explain it here. (See: To-Do List)

USB keyboard

I bought a mini USB keyboard that for my Neo, if someone has simple directions to use it with android, please explain it here.

USB mass storage

This setting is named "Enable USB mass storage". If you don't find it on Settings -> SD card & phone storage, you have to unhide it with Anycut. Install it then make a new shortcut Activity -> SD Card. Use this new shortcut to activate the option. This is not persistant after a reboot. See also [1]

TODO: This doesn't seem to work with the Neo FreeRunner and current Android images. (See: To-Do List)

Software installation and updates

For initial Android flashing, take a look at: Android on Freerunner

Install new software

Manual install

Applications are packaged in .apk packages, to install a package (downloaded on your computer) do

   ./adb install app.apk

After making sure you can talk to your phone using the Android debug bridge

Package managers

Android Market Place

Currently it is not possible to use the Android Market Place with the Neo Freerunner.


AndAppStore is an alternate source for Android software and works on the Neo Freerunner. It is installed by default in current Koolu images but you can install manually their client.

Update software (without reflashing)


Android Debug Bridge

To assist in debugging and to gain shell access to the phone with Android, you can use the instructions found here: Android debug bridge