Bluez IME with support to Wamo Pro (Android APK)

Update 18/08/2013: Added remap and profile function, just as in the other drivers.

In this post I will talk a little about the app Bluez IME and also about what I did to make it support Wamo Pro natively. Those who are having problems with the officials apps from SZ Wamo should read this post and try this custom app (it may not work too...).

After having some connectivity issues between my HTC Desire HD 4.0.4 (ViperDHD v2.2.0 ROM) and Wamo Pro Bluetooth controller, I decide to test alternative solutions. For my lucky, I found the source-code of the custom Bluez IME that supports IPEGA PG-9017 in joystick/gamepad mode (credits to DiegoBaeza). So, I got that source-code and added Wamo Pro driver to Bluez IME.

Unfortunally, I could only test this new Bluez IME in my HTC Desire HD, but I hope it helps anyone having problems to connect/play with Wamo Pro using official apps (although I didn't heard about anyone else).

How to connect Wamo Pro using Bluez IME

Before anything, you should download and install (Android only) the following apps:

• "BluezIME-HIDEnabler.apk" (required to enable HID drivers in Bluez IME).
• Bluez IME with support to Wamo Pro and IPEGA PG-9017 (both in GAMEPAD mode).

If you have any previous Bluez IME already installed, you may need uninstall it before installing this new one to avoid conflicts.

Now, with the apps installed, do the following steps to connect Wamo Pro using Bluez IME:

Step 1: Open Bluez IME app.
Step 2: Click on "Activate Bluetooth" to turn it ON in case it is OFF (see image 1).

Image 1

Step 3: Turn ON the Wamo Pro device (case it is OFF).
Step 4: Hold down X + HOME buttons in your Wamo Pro. Lights will start blinking (see note 1).
Step 5: Click on "Select device" and choose WamoPro (see image 2 and 3). If it is not in the list, click on "Scan..." to search and select it.

 
Image 2 and 3

Step 6: Click on "Select device driver" and choose "Wamo Pro - X mode (HID)" (see image 4 and 5).

 
Image 4 and 5

Step 7: Click on "Select IME" (remember which one is currenctly selected) and choose "Bluez IME" (see image 6 and 7). If it is not in the list, click on "Configure input methods", enable "Bluez IME" (see image 8), go back and select it now.

  
Image 6, 7 and 8

After those steps the Bluez IME app will try to connect to Wamo Pro automatically. If success, a message saying "Connected to ..." will pop up, where "..." is the MAC address of your Wamo Pro. After that, you now are able to map buttons in your emulators and games (buttons should response as shown in the table on the next section).

In case you still have doubts on how to use Bluez IME, the video below showing the same steps described above.

After finish using Bluez IME, don't forget to turn it OFF and reselect your original IME (that one I told you to remember) in "Settings"->"Language & keyboard" menu.

Where can I buy this Wamo Pro?

The Wamo Pro Bluetooth controller is for sale at Dealextreme for about $30.

Technical Details

The Wamo Pro driver added to Bluez IME should only works with GAMEPAD mode (button X) and recognizes all buttons and pads according to Android API, which should output the following keycodes:

Button	Constant	Keycode
A	KEYCODE_BUTTON_A	96
B	KEYCODE_BUTTON_B	97
X	KEYCODE_BUTTON_X	99
Y	KEYCODE_BUTTON_Y	100
Select	KEYCODE_BUTTON_SELECT	109
Start	KEYCODE_BUTTON_START	108
L3	KEYCODE_BUTTON_THUMBL	106
R3	KEYCODE_BUTTON_THUMBR	107
LB	KEYCODE_BUTTON_L1	102
LT	KEYCODE_BUTTON_L2	104
RB	KEYCODE_BUTTON_R1	103
RT	KEYCODE_BUTTON_R2	105
Dpad: Down	KEYCODE_DPAD_DOWN	20
Dpad: Left	KEYCODE_DPAD_LEFT	21
Dpad: Right	KEYCODE_DPAD_RIGHT	22
Dpad: Up	KEYCODE_DPAD_UP	19
Left Analog: Left	KEYCODE_A	29
Left Analog: Down	KEYCODE_S	47
Left Analog: Right	KEYCODE_D	32
Left Analog: Up	KEYCODE_W	51
Right Analog: Left	KEYCODE_4	11
Right Analog: Down	KEYCODE_5	12
Right Analog: Right	KEYCODE_6	13
Right Analog: Up	KEYCODE_8	15

Note that, although analogs are show as digital output, Bluez IME also sends analogs signals too, so if one emulator/game is capable of interface with Bluez IME (like N64oid), then analog sticks will work as they should (non-digital). I don't know other apps that support Bluez IME interface, but I heard that GameKeyboard app also support analogs from Bluez IME.

Optionally, you can use the option "Configure key mapping" to map the buttons in a way different than the default (table above). This may be useful if a game (or emulator) doesn't support (or partially) Wamo Pro keycodes, but it supports keyboards or another gamepads (you can save custom mapping as profiles).

The APK was build with the following properties:

• versionCode: 18.
• versionName: 1.17.
• debuggable: true.
• testOnly: false.

Note 1: Make sure to hold X button first or else Wamo Pro may start without any mode selected (lights will blink slower).