Skip to content

Latest commit

 

History

History
87 lines (62 loc) · 3.85 KB

README.md

File metadata and controls

87 lines (62 loc) · 3.85 KB

USBKWA -- USB Keyboard Web App

USBKWA (USB Keyboard Web App) turns a large tablet or any device with a Web browser into a USB keyboard. Anyone having difficulties using a regular keyboard may find a touch keyboard easier to use. More than one browser can be connected at the same time. A co-pilot can connect using a different computer or tablet to help the pilot (primary user) fly the computer.

The first version used an Espressif ESP32-S2 Saola board which requires wiring a USB connector break out board. The latest version use an "Adafruit QT Py ESP32-S3 WiFi Dev Board with STEMMA QT - 8 MB Flash / No PSRAM" board. Using the QT Py board means there is no need to wire in a USB connector. The built-in USB Type C connector is all that is required.

System Block Diagram

Screen capture of keyboard in browser window

The keyboard web app displays a 17x6 grid in the browser window. The locations of touch or mouse events are sent via a web socket back to the ESP32 web server. The server translates locations to USB HID keycodes and sends them out the USB HID keyboard interface.

The QT Py ESP32 S3 board is programmed using the Arduino IDE. No soldering or wiring is required.

The ESP32 S2 Saola board is programmed using the Arduino IDE. No soldering is required but a USB connector break out board must be wired to the Saola board.

The browser communicates to the ESP32 using WiFi. The ESP32 communicates with the other computer using USB HID.

Hardware

The QT Py ESP32-S3 is easier to use and has the option of supporting BLE HID keyboard. The S3 has BLE (Bluetooth Low Energy) but the S2 does not.

Adafruit QT Py ESP32-S3 board

No soldering or wiring is required. Just plug the board into the computer using an appropriate USB cable.

QT Py ESPS2 S3 with USB cable

Espressif ESP32-S2 Saola board

On the Espressif Saola board, the USB micro connector is connected to a CP2102 USB Serial chip. The USB HID data is on pin 19 and 20. A separate USB connector or cable must be connected to pins 19, 20, GND, and 5V. Do not use both connectors at the same time. If there is no protection diode on the 5V pin, board may be damaged. Connect to the built-in USB micro connector to program the ESP32. Disconnect the cable then plug it into the other USB micro connector to test the USB feature.

ESP32 S2 Saola USB micro connector
GND GND
5V VBUS
19 (USB D-) D-
20 (USB D+) D+
not connected ID

In the following photo, the USB connector is a SparkFun micro USB breakout board connected to the ESP32 S2 Saola board using Dupont wires.

ESPS2 S2 with second USB connector

This should work on any ESP32 S2 board but has only been tested on the Espressif Saola board. Regular ESP32 boards do not have native USB hardware so will not work. The not yet released ESP32 S3 should also work.

Software

The following libraries can be installed using the IDE Library Manager.

The library manager installs WiFiManager 2.0.14-beta which includes support for Arduino-esp32 2.0.x and works on ESP32 S2 and S3 boards.