Motorcycle Remote Controller for OsmAnd and Rally Roadbook Reader

The German version is here.

Introduction

This tutorial and the code is based on NordicRally's tutorial. The 3D-printed case for the buttons was replaced by a combined switch from Aliexpress and the code was modified sligthly.

The author did not use the linked Aliexpress switch unit and 5V converter because he was not aware of it. Instead, an own switch unit was built from a piece of plastic and hot glue.

As 5V converter, an old cigarette lighter to USB converter was opened and used. If there is a problem, please open a GitHub issue.

OsmAnd supports keyboard control, see here.

Rally Roadbook Reader supports audio buttons as remote control. Therefore, we just have to simulate a Bluetooth keyboard for both apps.

With a switch the user can selected if arrow keys for OsmAnd or audio keys for Rally Roadbook Reader are sent.

For other apps like Drive Mode Dashboard 2 or Google Maps which don't support keys, one would had to create an Android app which uses AccessibilityService or writes on a rooted device to "/dev/input/eventXX" to simulate touchscreen interactions on key presses.

For OsmAnd, seven buttons (4 arrow keys, 2 zoom keys, recenter location) and a switch (audio- oder arrow key mode) are needed. Such a switch can be bought e.g. from Aliexpress.

Parts

Part	Price	Link
switch unit	$ 16.60	https://www.aliexpress.com/item/1005002915264527.html
ESP32 38 pins	$ 5.00
converter 5V	$ 1.80	https://www.aliexpress.com/item/1005003803774587.html
case for ESP32 and converter 5V e.g. 80x38x22mm	$ 1.50
ethernet cabel 2m	$ 4.20
coupler RJ45 to connect ethernet cable	$ 3.00	https://www.aliexpress.com/item/1005002554550894.html
power cable with fuse and plug	$ 3.80	https://www.aliexpress.com/item/4000920357198.html
plug with cable to connect converter	$ 2.70	https://www.aliexpress.com/item/1005004300282231.html
fuse 1A medium	$ 1.20
shrinking tubes	$ 3.00
insulating tape
cable ties

Additional parts for solder-free connections

Part	Price	Link
converter 5V with cable (instead converter above)	$ 3.50	https://www.aliexpress.com/item/32805864042.html
screwed connection adapter ESP32	$ 6.70	https://www.aliexpress.com/item/1005004438768602.html
heat shrink connectors	$ 6.10	https://www.aliexpress.com/item/1005002538906794.html
case e.g. 125x80x32mm (instead case above)	$ 3.00
T connector	$ 2.00	https://www.aliexpress.com/item/1005001792678305.html

Configure ESP32

Install driver for USB/serial converter chip of the ESP32 board. Sometimes Windows installs the driver automatically. Else if it is an CP2102, see here. If it is an CH9102X-Chip, see here.
Open device manager and check which COM port is used by the ESP32:
Install Arduino IDE: https://www.arduino.cc/en/software
Add ESP32 to Arduino IDE: open "File" - "Preferences" and add https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json as URL:
At "Tools" - "Board" select "ESP32 Dev Module":
At "Tools" - "Port" selected the correct COM port from device manager:
Install the BLE keyboard library: open this link, download "ESP32-BLE-Keyboard.zip" from "Assets" and open the ZIP file at "Sketch" -> "Include Library" -> "Add .ZIP Library...":
Install the der Bounce2 library: open "Tools" - "Manage Libraries...", search for "bounce2" and install it:
Copy the code from rally.ino in the editor window and save it
Upload the code with the right arrow symbol:
Open the serial console:
Select "115200 baud" as speed: . The console output should contain "Starting BLE work!", if not, disconnect ESP32, connect again and open the serial console
You should be able to connect now to the virtual Bluetooth keyboard with your phone/tablet

Connect ESP32

A few connections needs to be soldered. If you don't have any experience with soldering, you can try to ask in the nearest hackerspace how to do it or buy a screw connectr adapter (see table above).

One side of every button/switch must be connected to ground (–), the other side to a pin of the ESP32. According to https://randomnerdtutorials.com/esp32-pinout-reference-gpios/, the pins 13-33 and 4, 5 are suitable for our purpose.

The ESP32 needs 3.3V, but has a built-in converter, The built-in converter converts higher voltage to heat and 3.3V. Therefore, more than 5V is not recommended. The input of the converter is the pin "VIN". VIN should not be connected directly to motor vehicle + because the voltage can sometimes be much higher than expected. Electronis for cars/motorcycles should be protected against this. Therefore, we use a car USB converter to generate 5V. Ground –) must be connected to one of the "GND" pins. The ground side od the buttons/switches, of the 5V converter and GND of ESP32 must all be connected to the motorcycle's ground, e.g. with a ring connector to the battery or frame.

Drill a hole big enough for the ethernet cable
Cut around 20cm of the ethernet cable, remove a few millimeters of the insulation and pull it through the hole into the case
Tin-coat the wires, and if the ESP32 has pins soldered, tin-coat the needed pins
Solder the wires to the pins. I recommend to use the brown or blue wire for ground. The other colours do not matterm, just use pins between 13-33 or 4 or 5, e.g.
Shorten the other part of the ethernet cabel to the desired length and solder it to the switch unit. Heat shrinking connectors are very convenient for this.

In the Arduino code make sure the following lines contains pin numbers connected to the buttons/switches:

int switch_mode_btn = 18;

int c_play_pause_btn = 24;
int up_volume_up_btn = 30;
int down_volume_down_btn = 29;
int left_btn = 26;
int right_btn = 25;
int plus_next_track_btn = 10;
int minus_previous_track_btn = 13;