Manuals/Android

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(Suspend)
Line 9: Line 9:
 
This page is dedicated to the daily usage of Android on the [[Neo 1973]] and [[Neo FreeRunner]] handsets.
 
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 : [http://freerunner.android.koolu.com/release-files Koolu Beta2 Android release]. But should be the same for any not too old release.
+
The informations here have been updated for the following release : [http://freerunner.android.koolu.com/release-files 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]]
 
You can find general informations (porting/development and day to day usage) about Android and Neo phones here : [[Android]]
Line 18: Line 18:
  
 
== Accelerometers ==
 
== Accelerometers ==
Works, can be tested with simple game called [http://andappstore.com/AndroidPhoneApplications/apps/8872 Amazed]
+
Works, can be tested with simple game called [http://andappstore.com/AndroidPhoneApplications/apps/8872 Amazed] which is already installed on current Koolu images.
  
 
== Bluetooth ==
 
== Bluetooth ==
Line 24: Line 24:
  
 
== GPS ==
 
== GPS ==
Once it works, you can [[#Install new software|install]] [http://www.andnav.org AndNav2] to test it.
+
Works, you can [[#Install new software|install]] [http://www.andnav.org 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.
  
 
== GPRS ==
 
== GPRS ==
 
Does not work, GSM get's confused when you try to use it
 
Does not work, GSM get's confused when you try to use it
  
== GSM ==
+
== GSM / Calls ==
 
Sources for libmuxgsm-ril.so not released yet, latest images have binary from ML that works quite fine.
 
Sources for libmuxgsm-ril.so not released yet, latest images have binary from ML that works quite fine.
 +
 
The SIM's PIN code cannot be validated. For now disable the PIN code using another phone.
 
The SIM's PIN code cannot be validated. For now disable the PIN code using another phone.
 +
 
Registering on a Network seems to be slow and sometimes doesn't work.
 
Registering on a Network seems to be slow and sometimes doesn't work.
 +
 +
Sound volume of the caller is too low and cannot be changed using the software keyboard
 +
 +
It is not possible to hang up incomming calls
 +
  
 
== Wifi ==
 
== Wifi ==
Line 45: Line 53:
 
=== Importing ===
 
=== Importing ===
 
==== From Vcard ====
 
==== From Vcard ====
# [[#Install new software|install]] [http://www.dusystems.com/importContacts.html "Android Contacts Import"] (this applications is also available from AndAppStore)
+
# [[#Install new software|install]] [http://www.dusystems.com/importContacts.html "Android Contacts Import"] (this applications is also available from [[#AndAppStore|AndAppStore]])
 
# export your contact(s) as a vcard file from your contact application
 
# export your contact(s) as a vcard file from your contact application
 
# [[#Copy files|copy]] the file to your phone /sdcard/ directory
 
# [[#Copy files|copy]] the file to your phone /sdcard/ directory
Line 78: Line 86:
  
 
== Media ==
 
== Media ==
Can play OGG audio files, picture application crashes
+
Can play OGG audio files and view pictures with the default applications
  
 
== SMS ==
 
== SMS ==
 
Can't read long SMS messages.
 
Can't read long SMS messages.
 +
Some SMS are not readable (empty content)
  
 
= Others =
 
= Others =
Line 125: Line 134:
  
 
==== AndAppStore ====
 
==== AndAppStore ====
AndAppStore is an alternate source for Android software and works on the Neo Freerunner. Start by [[#Manual install|manually installing]] their [http://andappstore.com/AndroidPhoneApplications/apps/7661 client].
+
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 [[#Manual install|install manually]] their [http://andappstore.com/AndroidPhoneApplications/apps/7661 client].
  
 
== Update software (without reflashing) ==
 
== Update software (without reflashing) ==

Revision as of 08:56, 12 February 2009


Contents

Android.png

Introduction

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


Subsystems

Accelerometers

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

Bluetooth

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

GPS

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.

GPRS

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

GSM / Calls

Sources for libmuxgsm-ril.so not released yet, latest images have binary from ML that works quite fine.

The SIM's PIN code cannot be validated. For now disable the PIN code using another phone.

Registering on a Network seems to be slow and sometimes doesn't work.

Sound volume of the caller is too low and cannot be changed using the software keyboard

It is not possible to hang up incomming calls


Wifi

Works, but i have problems with scanning when just one AP is in range, it fails most of the time.


Data management

Contacts

Importing

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

From SIM

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

Synchronization

Calendar

Alarm

Works.

Importing

Synchronization

Files

Copying

You can copy files to your phone using either

or, from the command line using

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

Media

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

SMS

Can't read long SMS messages. Some SMS are not readable (empty content)

Others

Software keyboard

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

Suspend

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

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)

Troubleshooting

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

Links

Personal tools


Contents

Android.png

Introduction

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 Beta2 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


Subsystems

Accelerometers

Works, can be tested with simple game called Amazed

Bluetooth

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

GPS

Once it works, you can install AndNav2 to test it.

GPRS

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

GSM

Sources for libmuxgsm-ril.so not released yet, latest images have binary from ML that works quite fine. The SIM's PIN code cannot be validated. For now disable the PIN code using another phone. Registering on a Network seems to be slow and sometimes doesn't work.

Wifi

Works, but i have problems with scanning when just one AP is in range, it fails most of the time.


Data management

Contacts

Importing

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

From SIM

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

Synchronization

Calendar

Alarm

Works.

Importing

Synchronization

Files

Copying

You can copy files to your phone using either

or, from the command line using

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

Media

Can play OGG audio files, picture application crashes

SMS

Can't read long SMS messages.

Others

Software keyboard

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

Suspend

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

AndAppStore is an alternate source for Android software and works on the Neo Freerunner. Start by manually installing their client.

Update software (without reflashing)

Troubleshooting

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

Links