search

houkanshan / arduino-bt-hid-proxy

Bluetooth HID proxy is implemented using Arduino. Make a Bluetooth keyboard or mouse (WIP) work in BIOS or device without BT stack (e.g. TMK USB to USB Converter)
96 stars 4 forks source link
arduino bluetooth-arduino bluetooth-hid usb-hid

readme

Arduino Bluetooth HID Proxy

Bridge Bluetooth keyboard to wired USB. (i.e. Bluetooth HID Proxy Mode). Works like a Logitech Unifying Receiver but for bluetooth devices.

(Image idea from pihidproxy)

[!NOTE] If you are looking for a project that turns a wired keyboard into a wireless keyboard. This is not the right project. This project does the reverse.

It can be useful in two scenarios:

  1. You have a bluetooth keyboard, but it doesn't work in BIOS, Bootloader or TV.
  2. You have a bluetooth keyboard and you want turn it into a programmable keyboard (with TMK USB to USB Converter)

Previously, I used MikerR's pihidproxy but it's not transparency enough and I don't like the start-up time of RPi. So I made this one with Arduino.

Guide

Hardware

Shopping List

Assembling

Follow this guide to connect Micro Pro and USB Host Shield. Or tl;dr:

  1. Cut the line between VBUS and 2k2 to get 5.0V
  2. Two Jump wires on VCC and RST, VBUS and RAW
  3. Put Micro Pro on USB Host shield, align, and connect: (Top) INT, GND, (Bottom) SS, MOSI, MISO, SCK, VCC, GND, RAW

Programming

[!NOTE] if you are NOT using an Apple Magic Keyboard, make sure to finish step 5

  1. Open in Arduino IDE
  2. In Tools -> Manage Libraries, search and install USB Host Shield Library 2.0, HID-Project
  3. Let's test if USB Host shield is working: File -> Examples -> USB Host Shield Library 2.0 -> board_qc
    1. Upload
    2. Tools -> Serial Monitor
    3. There'll be a GPIO error, ignore it and send any key in the serial monitor.
    4. Wait until All tests passed.
    5. This article could be helpful if you meet any issue.
  4. git clone https://github.com/houkanshan/arduino-bt-hid-proxy.git
  5. In KeyboardParser.h, comment #define APPLE_MAGIC_KBD (adding // to the beginning) if you're not using an Apple Magic Keyboard.

Uploading for the first pairing

  1. Upload the project, open Tools -> Serial Monitor
  2. Turn on your bluetooth device and start pairing
  3. Wait for bluetooth scanning
  4. Follow the guide in the Serial Monitor and finish the pairing
  5. Now the paired address is remembered by arduino.

Uploading for paired

The current code will try to re-pair every time after power on. Let's stop it.

  1. In BTHID.ino, comment BTHID bthid(&Btd, PAIR, "0000"); and uncomment BTHID bthid(&Btd);
  2. Upload
  3. Press any button on the device, then it should be connected.

Debug

USB Host Library

  1. In Documents/Arduino/libraries/USB_Host_Shield_2.0/settings.h, change #define ENABLE_UHS_DEBUGGING 0 to 1. It will display detailed log in serial monitor
  2. For more detailed log, uncomment #define EXTRADEBUG in *.cpp file you want to inspect.

Thanks to