Revision as of 16:57, 1 August 2008

JavaMO on the Nokia N73

UI1 with touchscreen on the P1

UI1 on the Nokia E65

Introduction

The JavaMO is a lightweight Mobile Orbiter client. It receives rendered pictures from the Bluetooth dongle Orbiter and sends keystrokes and pointer events back. The protocol used over Bluetooth is BD.

JavaMO is under active development. An alpha version can be found on the charonmedia svn tree or on http://vt100.at/javamo/.

Changelog

• 0.0.2 - Touchscreen support, fix unhandled exception on dcerouter reload
• 0.0.1 - Proof of concept, basic functionality

Installation

Phone

For most phones you need the jad and the jar file. Copy both to the phone and select the jad from the file or application manager.

Core/MD

You have to exchange the libBDCommon.so with the provided one on all 0710 cores or MD's with a Bluetooth_Dongle. Download the replacement libBDCommon.so from http://vt100.at/javamo/ . In /usr/pluto/lib rename libBDCommon.so to libBDCommon.so.old, then copy the new version you downloaded into this directory and reboot.

LMCE Plug and Play detection

When LMCE asks you for the type of phone select "Symbian S60". The application push will fail. Thats ok. Just answer no to the question if LMCE should resend it.

Screen Size, UI Variant

Go to the Orbiter in the pluto-admin web interface (select Orbiters in the Wizard on the left) Adapt the PK_UI, PK_Size and resolution values to match your phones display. If you have no touchscreen on the phone stick with symbian for PK_UI, otherwise choose the normal variant.

See also

Mobile Orbiter

LinuxMCE Orbiter Symbian Programmer's Guide

Links

Forum thread re JavaMO

JavaMO development guide

Preparations

Checkout

Checkout the source from the charonmedia.org svn tree:

svn co http://svn.charonmedia.org/svn/home/hari/javamo
cd javamo

Installing Java

First we install the Java SDK. I used version 6 update 6. Download it from the sun download center: http://java.sun.com/javase/downloads/index.jsp

chmod +x ./jdk-6u6-linux-i586.bin
./jdk-6u6-linux-i586.bin

That gives us the directory "jdk1.6.0_06".

Now install the wireless toolkit version 2.5.2: http://java.sun.com/products/sjwtoolkit/download.html

./sun_java_wireless_toolkit-2_5_2-linux.bin

Specify the _full_ path to the "jdk1.6.0_06/bin" directory (this example assumes javamo was checked out to "/home/hari/src/javamo"):

Enter a path to the Java 2 SDK: /home/hari/src/javamo/jdk1.6.0_06/bin

After the installation you should have the following subdirectories in the javamo directory:

• jdk1.6.0_06
• WTK2.5.2

Building the application

just run "make":

make

You will find the "JavaMO.jad" and "JavaMO.jar" file in the "output" directory if the compile succeeds.

Install the application on the phone

That strongly depends on the type of phone. For Nokia Symbian Series with a memory card you can use the "install" target in the "Makefile". Just adapt the Bluetooth address of the phone in the "Makefile" and run:

make install

Then go to the file browser on the phone, switch to the memory card and select the "JavaMO.jad" file. Make sure you have enabled the installation of unsigned applications in the application manager.

Developers in the United States

This depends strongly on the operator you have on your mobile.

If you are developing in the United States and have a Sprint or Nextel phone, you can install the MIDlet over the air using | Sprint ADP's OTA content uploader.

On a Nextel phone, you can also install it using a cable downloading the iDEN Java Application Loader. There are mechanisms for cable-loading an application onto a variety of Sprint CDMA phones, but these vary greatly in their reliability/ease of access.

If you are working with a Verizon phone, you will need to have a BREW developer license and toolkit to load an application onto the device. Chances are you don't have this.

If you are working with an AT&T or T-Mobile GSM phone, you should put the JAD and JAR files in a publicly accessible web server, then point the web browser of your phone to the JAD file -- it should begin the download automatically.

Building the documentation

make javadoc

Direct your browser to the file "doc/index.html"

On device debugging with a Nokia N and E series phone and Linux

To get the output from the application running on the phone on a computer screen, do the following:

• Register with Nokia and get the Symbian SDK
• Transfer the "EcmtAgent_MIDP.SIS" application on the phone and run it, uses bluetooth per default
• Go to system - application manager on the phone and install the "RedMIDlet.jar" (shows "not installed")
• Go to the application folder and run the "Sdt.out.redir" application
• do a "sdptool browse" on your notebook with a supported bluetooth dongle (hci device must be up) to find out the rfcomm port. You should see something like this:

Service Name: EcmtAgent
Service Description: Bluetooth bearer for EcmtAgent
Service RecHandle: 0x10043
Service Class ID List:
  "Serial Port" (0x1101)
Protocol Descriptor List:
  "L2CAP" (0x0100)
    PSM: 3
  "RFCOMM" (0x0003)
    Channel: 3
Language Base Attr List:
  code_ISO639: 0x656e
  encoding:    0x6a
  base_offset: 0x100

• run a command like the following after substitution of the Bluetooth address and the rfcomm channel:

while $a; do rfcomm release /dev/rfcomm0 ; rfcomm bind /dev/rfcomm0 00:17:C4:C3:36:24 3 ; cat /dev/rfcomm0 ; done

Example output (process list, system info and the javamo console output):

0x000004380x10204578CPU 191985135 1 DRIVES C 46539776 23182336;D 5629952 5627904;E 2030960640 30343168;Z 20971520 0; RAM 5627904 46137344 20971520 APPLICATIONS JavaMO 692 -1 -1 -1 2654876;EiksrvBackdrop 97 -1 -1 -1 106830749;Menü 163 -1 -1 -1 5559722;EcmtAgent 601 -1 -1 -1 1263824;Standby-Modus 150 -1 -1 -1 16982482;Sdt.out_redir 648 -1 -1 -1 243194;Telefon 146 -1 -1 -1 11353271;Protokoll 394 -1 -1 -1 1592987;Kontakte 330 -1 -1 -1 1927398;MultimediaList 161 -1 -1 -1 510864;SysAp 122 -1 -1 -1 4535278; 77 -1 -1 -1 9002;Anykey 148 -1 -1 -1 290618;blinkingled 240 -1 -1 -1 266265;Player 266 -1 -1 -1 331695;Autolock 238 -1 -1 -1 103759;Galerie 310 -1 -1 -1 1241149;screensaver 154 -1 -1 -1 16530914;akncapserver 97 -1 -1 -1 106830749;btnotifappserver 108 -1 -1 -1 684661;Securitynotifierappserver 106 -1 -1 -1 311309;VolumePopup 266 -1 -1 -1 331695;MPlayerInfoPopup 266 -1 -1 -1 331695;VolumePopup 150 -1 -1 -1 16982482;CTSecDlgAppServer 110 -1 -1 -1 63354;SyncMLNotifierAppServer 114 -1 -1 -1 59234;cconndlgappserver 116 -1 -1 -1 62744;locnotifierappserver 104 -1 -1 -1 63476;0x000000780x1020456c
ReceiveLong: long result: 102
Got BD_CP_SHOW_IMAGE

Java J2ME simulator with real bluetooth hardware access over bluez

• Get the mpowerplayer SDK: http://mpowerplayer.com/?cat=6
• Install it
• Either buy (http://www.avetana-gmbh.de) or compile (http://sourceforge.net/projects/avetanabt/) the avetana bluetooth stack
• put the "AvetanaBluetooth.jar" file in the mpp-sdk top level directory
• adapt the path to the mpp installation in the javamo Makefile
• run "make bluezsim" to run JavaMO in the sim with bluez access over JSR082

Phone Specifics

Nokia E61

The Nokia E61 has a full keyboard. To select the numbers you have to hold down the blue function key, and press the number together with it.