General Notes

Making a Keyboard

• For handwiring your keyboard you check out cribbit's guide.
• For manufacturing PCB's you can check out the ruiqimao's guide. Please note that the guide refers to Atmega32u4 based keyboard, make sure you properly understand the modifications required in order to use an ESP32.
• Reference for different ESP32 modules - For basic mostly plug and play modules check out the "Development Boards/Modules" section (I personally have experience with the Wemos modules.
• Keyswitch comparison

General resources

• HID descriptors
• The keyboard matrix
• r/MechanicalKeyboards

Notes

• On Linux, if you are modifying the HID descriptor, or any BLE related component (After the device has already been paired)- after re-flashing if you are having problems receiving reports or have, disconnections you can try to manually remove the keyboard from bluetooth devices: first navigate to /var/lib/bluetooth and see if you can find your devices mac address.
  after that do:
  cd /var/lib/bluetooth
$ rm -rf 00:12:AA:EE:01 <- replace with your keyboard's MAC address.
• If you are using an lolin32 lite clone from aliexpress, check if your board fails to terminate battery charging.
• If have updated your esp-idf, make sure to make clean before flashing your board.