View source for Manuals/Android
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:
Templates used on this page:
Return to Manuals/Android.
You do not have permission to edit this page, for the following reasons:
You can view and copy the source of this page:
Templates used on this page:
Return to Manuals/Android.
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à |
|
The Android for FreeRunner development can be found on http://code.google.com/p/android-on-freerunner/.
This page is dedicated to the daily usage of Android on the Neo 1973 and Neo FreeRunner handsets.
One can find general information (porting/development) about Android on Neo phones here : Android.
If you need some support for this Android Manual see Using Android Manual.
If you have Android already installed on your Freerunner (FR), you should backup your data before install Android again. For backup process see Installing Android on Openmoko Freerunner for further information.
On Linux Machine backup current data on Micro SD-Card with adapter. If SD-Card is located in /dev/sde use the following commands (replace /dev/sde by appropriate device name,
sudo df
will help you to identify the device name and size of SD card: Create two partitions in the ratio 3 to 1 (e.g. 4000000 blocks):
Use fdisk to create partitions:
sudo fdisk /dev/sde
After fdisk operations, format both partitionss. If SD-Card is located in /dev/sde use the following commands (replace /dev/sde by appropriate device name:
# mkfs.vfat -v -n and-media -F 32 /dev/sde1 # mkfs.ext3 -v -L and-data /dev/sde2
If you are root you can remove sudo from the command.
You need the Android SDK on your PC/Laptop for executing commands on your Android, taking screenshots and uploading/downloading files to/from your Freerunner.
Instruction for installing Android SDK can be found on http://developer.android.com/sdk/installing.html.
Edit the line that sets the PATH environment variable and append the full path to the SDK directory tools/ separated with ":" at the end. If you don't see a line, that exports the PATH variable just add the following line:
export PATH=${PATH}:<your_sdk_dir>/tools
The Android debug bridge ADB provides an Computer-Freerunner interface. You mainly need adb, that is part of the Android SDK. You can download ADB by installing the Android-SDK. You will find information regarding Android-SDK on http://developer.android.com/sdk/index.html.
The homepage of Android on Freerunner can be found on http://code.google.com/p/android-on-freerunner/. The code.google-wiki guides you in preparing an SD-Card on your PC/Laptop, that will be inserted in your freerunner. After that you have reassembled your Freerunner and boot from MircoSD:
To improve the user guide screenshots are very helpful. Independent of your operating system on your PC (Linux, Mac, Windows) you can make screenshots with the SDK on triggered from your PC. Connect your Freerunner with Android via USB and enable USB-Debugging
You can make screenshots to enhance this guide by using ddms.
There are application for making a screenshot directly on your Freerunner, but you need a rooted Android for this.
If you have prepared your SD-Card with as mentioned above in this article, you have to do just two more steps:
If you have Android already installed on your Freerunner (FR), you should backup your data before See Installing Android on Openmoko Freerunner for further information.
Establish USB Connection, e.g.
# ifconfig usb0 192.168.0.200 netmask 255.255.255.0
Add the following As root kill adb server and add device on 192.168.0.202
# adb kill-server # ADBHOST=192.168.0.202 adb devices
or on Ubuntu start an xterm window with
sudo xterm
and execute the commands mentioned above in that window.
The aux button is configured as the back button. If the application recognizes the back action, like the browser, it goes a page or action back. If not recognized, one leaves the application to the previous situation. Note the application is not killed. It stays active.
Pressing the AUX button for more than 3sec than all active application can be selected.
The G1 and G2 Android phones have a home button, a long press on this button creates a window with all the running applications.
There is no clear key now, to show the running applications. Sometimes by chance a window with icons of the running applications appears, and then one can jump to a different running application.
I suggest to create this button from a two second press on the aux button. A window with the icons of the running applications will appear. By tapping on the wanted application we can than jump to the running application.
The keyboard appears when you select a field for input text or numbers.
Once the phone has started you will see a 'Dialer' icon on the desktop. Tap it and you will be presented with a dialing 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.
Caveats
Start SMS Application in Main Window.
Android has a copy and paste feature built in to it. By touching and holding on a text entry box for about 2 seconds the copy & paste menu will appear.
Works, can be tested with a simple game called Amazed. This can be installed on the current AoF images.
Android Eclair makes use of the accelerometers.
Works, latest kernels need permissions for second rfkill interface in init.rc to turn it on.
Works, you can install AndNav2 to test it. AndNav2 is e beta version and the useable period is over.
Proper working of GPS can observed with YGPS Satellites. It shows signal strength and location of each satellite.
To set up GPRS you need to enter the correct settings for your network: Tap the Application tab followed by Settings > Wireless controls > Mobile networks > Access Point Names. Now if you press the power button, a menu will appear allowing you to add a 'New APN'. Touch this then add your network's GPRS & MMS settings.
Once you have entered your APN details it maybe necessary to follow this procedure to start GPRS (you will only need to do this once):
Turn on Airplane mode, reboot, turn off Airplane mode
You may also have to carry out the DNS fix described below.
You can find most networks 'mcc' and 'mnc' numbers here
Enter these details to set up GPRS:
carrier="o2-UK-PAYG" (Name - can be anything) mcc="234" mnc="10" apn="payandgo.o2.co.uk" user="payandgo" server="Not set" password="password" type="default"
These details are also correct o2 settings but don't enter them, they stop GPRS from working properly at the moment.
mmsc="http://mmsc.mms.02.co.uk:8002" proxy="193.113.200.195" port="9201" mmsproxy="193.113.200.195" mmsport="9201"
Enter these details to set up GPRS:
carrier="T-Mobile-UK" (Name - can be anything) mcc="234" mnc="30" apn="general.t-mobile.uk" user="user" server="149.254.1.10" # server="149.254.201.132" (alternate server) password="wap" type="default"
Source : French Network parameter
GPRS settings (work):
apn="orange" user="orange" password="orange" mcc="208" mnc="01" type="default"
MMS settings (untested) :
apn="orange.acte" proxy="192.168.10.200" port="8080" user="orange" password : "orange" mmsc="http://mms.orange.fr" mms port="8080" mcc="208" mnc"01" type="mms"
Force use of Orange DNS in the ip-up script located in /system/etc/ppp :
/system/bin/setprop "net.gprs.dns1" "194.051.003.056"
apn="wap.cingular" username="wap@cingulargprs.com" pass="cingular1" mmsc="mmsc.cingular.com" mms proxy="wireless.cingular.com" mms port = 80 mcc= 310 mnc= 410
Wifi works on current distribution of Android, it switches off, when Display goes black. When you use SipDroid SIP-Client for VoIP over Wifi, you will loose network connection.
You can find a list of Android applications recommended by users of Android on Freerunner (AoF).
NOTE: In current Verion 19.08.2010 Navit starts without GPS daemon. Trying to install TTS crashes Navit. Without installing TTS (Text to Speech) Navit starts without GPS "on". If you start the GPS daemon before, Navit will crash. |
sip:123456789@myhomebox.dyndns.com
{{Note|(Error) Unfortunately the current version does not work.}
That's it if you don't see your contacts, make sure you selected "view all contacts" in the contacts application options (contacts > power button > Display group > All contacts)
It imports only names and telephone numbers, everything else is not imported.
Works, Contacts->menu->Settings->SIM contacts importer.
You can copy files to your phone using either
This option is not (yet) available in Koolu beta 7
or, from the command line using
ADBHOST=192.168.0.202 ./adb push file.txt /sdcard/
Can play OGG audio files and view pictures with the default applications
Waking up your phone might be a little bit tricky at the moment, there are several recipe/hints submitted by different people :
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.
echo 1 > /sys/class/i2c-adapter/i2c-0/0-0073/neo1973-pm-host.0/hostmode echo host > /sys/devices/platform/s3c-ohci/usb_mode
TODO: If you know how to change the USB mode with Android, please explain it here. (See: To-Do List) |
I bought a mini USB keyboard that for my Neo, if someone has simple directions to use it with android, please explain it here.
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 persistent 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) |
For initial Android flashing, take a look at: Android on Freerunner
You can find a list of Android applications recommended by users of Android on Freerunner (AoF).
Please be careful which software you install on your system.
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
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.
To assist in debugging and to gain shell access to the phone with Android, you can use the instructions found here: Android debug bridge
Type in the the Android Terminal emulator (under Development Tools)
setprop EXTERNAL_STORAGE_STATE mounted
or run
adb shell setprop EXTERNAL_STORAGE_STATE mounted
with the freerunner connected to a computer which has the Android SDK.