esp-idf-ssd1306/KeyboardDemo/README.md
2024-09-07 08:07:24 +09:00

2.1 KiB

KeyboardDemo for SSD1306

Demo that displays input from the keyboard.
I used this as a reference.

usb-keyboard-1

Hardware requirements

  • ESP32S2/S3
    These have USB-HOST functionality.

  • USB Connector
    I used this:
    usb-conector-3

  • USB keyboard

USB wiring

To stabilize the power supply, I placed a 100uF electrolytic capacitor between 5V and GND.

ESP32-S2/S3 BOARD           USB CONNECTOR
                            +--+
    [  5V   ]  +--------->  | || VCC
    [GPIO 19]  |--------->  | || D-
    [GPIO 20]  |--------->  | || D+
    [  GND  ]  |--------+>  | || GND
               |        |   +--+
               +---||---+
                  100uF

USB hot socket

There are times when it works correctly and times when it doesn't.
It works more stably if you connect before starting the firmware.
When it works correctly, a log like this will be displayed.

I (796) usb_hid: hid_host_device_callback
I (796) usb_hid: HID Device, protocol 'KEYBOARD' CONNECTED
I (806) usb_hid: hid_host_device_callback
I (816) usb_hid: HID Device, protocol 'NONE' CONNECTED

Using USB-HUB

I tried it, but it doesn't work properly via USB-HUB.

Transfer failed error

For some reason, the following error may occur in rare cases.
This error occurs within this component.
It is unclear whether it is a component bug or an effect of electrical noise.
Some kind of stabilization circuitry may be required.
It may come back to life if you unplugging the keyboard and plugging it again.
I would like to hear the opinion of someone who is familiar with USB electrical circuits.

E (12287696) hid-host: Transfer failed, status 1
E (12287696) usb_hid: HID Device, protocol 'KEYBOARD' TRANSFER_ERROR
E (15953516) USBH: Device 1 gone