

Macro keyboard
macro keyboard esp32 s3
- Size
- 80 × 100 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 74
- Nets
- 94
- Pads
- 385
- Tracks, vias
- 728, 153
- Pours
- 2
- Routed
- Yes
- KiCad
- KiCad 8.0 (file 20240108)
- Created
- 1 Sep 2024
- Updated
- 26 Jan 2026
Overview
Macro keyboard is an open-source printed circuit board by drfhaust, from the drfhaust/Macro-keyboard repository on GitHub. It is a 2-layer board of 80 × 100 mm with 74 parts on 94 nets, routed with 728 tracks and 153 vias.
It is built around the ESP32-S3-WROOM-1-N8R8, CH343P and GT-TF003-H0185-02, with the AP2112K-3.3, CPG135001S30 and XL-2020RGBC-WS2812B among its other parts. Its parts include 27 capacitors, 15 connectors, 13 diodes, 10 resistors and 4 ICs. It belongs with the keyboards and input boards and the ESP32 boards of this library.
Main components
9ESP32-S3-WROOM-1-N8R8
SMD,25.5x18mm-104.5dBm -40℃~+65℃ 2.4GHz 20.5dBm 330mA 3V~3.6V 97mA Bluetooth5.0 ESP32-S3R8 On-board PCB Antenna UART、SPI、I2C、GPIO、I2S、USB SMD,25.5x18mm WiFi Modules ROHSEspressif SystemsWiFi ModulesCH343P
TQFN-16-EP(3x3)-40℃~+85℃ 3.3V、5V 3mA 6Mbps 90uA USB 2.0 USB to UART TQFN-16-EP(3x3) USB Converters ROHSWCH (Nanjing Qinheng Microelectronics)USB ConvertersGT-TF003-H0185-02
SMD-40℃~+90℃ 1.85mm Connector and Ejector MicroSD Card (TF Card) Push-Push SMD SD Card / Memory Card Connector ROHSG-SwitchSD Card / Memory Card ConnectorAP2112K-3.3
SOT253.3V 600mA CMOS Low Dropout Linear Regulator with EnableDiodes IncorporatedUncategorisedCPG135001S30
SMDSMD Mechanical Keyboard Shaft ROHSKailhMechanical Keyboard ShaftXL-2020RGBC-WS2812B
SMD- LCDH ROHSXINGLIGHTUncategorisedS8050
SOT-23-55℃~+150℃ 1 NPN 100MHz 100nA 120 25V 300mW 500mA 5V 600mV NPN SOT-23 Bipolar (BJT) ROHShongjiachengBipolar (BJT)B5819WS-TP
SOD-323-65℃~+125℃ 1 Independent 10A 1A 40V 40uA@40V 600mV@1A SOD-323 Schottky Diodes ROHSMicro Commercial ComponentsSchottky DiodesMC-126D-DG10
SMD-40℃~+85℃ 1 10,000 cycles 16P 20V 5A Female Surface Mount, Right Angle Type-C USB 3.1 SMD USB Connectors ROHSHanbo ElectronicUSB Connectors
README
README.mdMacro Keyboard
Macro Keyboard with ESP32-S3
This repository contains the design and code for building a custom macro keyboard powered by the ESP32-S3 microcontroller.
Overview
- Design: A macro keyboard with customizable keys and LEDs for different functionalities.
- Microcontroller: Powered by the ESP32-S3 with a built-in touch screen and additional hardware components.
- Customization: Supports custom key mappings and macros via a JSON configuration.
- Hardware Design: The keyboard's hardware is modular, making it adaptable for various input needs.
Hardware Specifications
- Microcontroller: ESP32-S3 with built-in wireless connectivity.
- Key Components: Uses Cherry MX-compatible key switches.
- LEDs: Individually addressable RGB LEDs for customizable lighting.
- Screen: Touch-enabled screen for additional control and feedback.
- Battery: Supports external power, and can be adapted for battery-powered use.
- Charging: USB Type-C port for charging and data transfer.
- Connection: Supports both wired and wireless communication with a host device.
Software Features
- Macro Management: The macros can be configured through the
button.jsonfile, where each button is assigned a specific action or macro. - LED Control: RGB LEDs can be customized for each button based on the configuration.
- Key Mapping: Easily programmable for various applications, from simple shortcuts to complex multi-step macros.
- Python Integration: Python scripts are provided to manage macro configurations and interface with the hardware.
Power Details
- Power Input: Powered through USB Type-C or battery.
- Power Consumption: Optimized for low power consumption during idle states.
Repository Structure
-
Arduino code: Contains the LVGL porting for the ESP32-S3 along with the Arduino source code for the project.
lvgl_Porting: Core source files for integrating LVGL (LittlevGL) with the ESP32-S3.
-
Macro keyboard: Includes hardware designs, PCB schematics, and component configurations.
GERBER: Files for manufacturing the PCB.custom components: KiCad components for custom parts used in the keyboard.backups: Backup files for the PCB designs.
-
python code: Python scripts to manage macros and configure button functionalities.
macro_manager_v4.py: Python script for managing the macro functions of the keyboard.
-
solidwork 3d: 3D models of the keyboard parts, including key switches and case designs.
-
button.json: Configuration file where button mappings and LED colors are stored.
Getting Started
-
Clone this repository:
bash git clone <repository-url> -
Hardware Setup:
- Flash the ESP32-S3 with the code in
Arduino code/lvgl_Porting. - Assemble the PCB and components according to the schematics in the
Macro keyboardfolder.
- Flash the ESP32-S3 with the code in
-
Software Setup:
- Install the required Python libraries by running:
bash pip install -r requirements.txt
- Install the required Python libraries by running:
-
Macro Management:
- Configure macros by editing
button.json. - Run the macro manager script to apply your changes:
bash python python code/v4/macro_manager_v4.py
- Configure macros by editing
Contributing
Please read the contribution guidelines before making any changes.
License
This project is licensed under the MIT License.
Parts
74| Qty | Value | Footprint | References |
|---|---|---|---|
| 12 | 100n | Capacitor_SMD:C_0603_1608Metric | C13, C14, C15, C16, C17, C18, C19, C20, C21, C22, C23, C24 |
| 12 | CPG135001S30 | footprints:Connector_Keyswitch_Socket_KAILH_CPG135001S30 | J2, J3, J4, J5, J6, J7, J8, J9, J10, J11, J12, J13 |
| 12 | RGB | footprints:LED_SMD_XINGLIGHT_XL-2020RGBC-WS2812B | D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13 |
| 4 | 10uf | Capacitor_SMD:C_0603_1608Metric | C6, C12, C25, C26 |
| 3 | 100nf | Capacitor_SMD:C_0603_1608Metric | C3, C4, C5 |
| 3 | 1UF | Capacitor_SMD:C_0603_1608Metric | C7, C8, C11 |
| 2 | 0R | Resistor_SMD:R_0603_1608Metric | R5, R6 |
| 2 | 10k | Resistor_SMD:R_0603_1608Metric | R11, R12 |
| 2 | 12k | Resistor_SMD:R_0603_1608Metric | R1, R2 |
| 2 | 15pf | Capacitor_SMD:C_0603_1608Metric | C9, C10 |
| 2 | 1uf | Capacitor_SMD:C_0603_1608Metric | C1, C27 |
| 2 | 5k1 | Resistor_SMD:R_0603_1608Metric | R7, R8 |
| 2 | S8050 | Package_TO_SOT_SMD:SOT-23 | Q1, Q2 |
| 2 | SW_Push | Button_Switch_SMD:SW_SPST_B3U-1000P | SW1, SW2 |
| 1 | 100K | Resistor_SMD:R_0603_1608Metric | R3 |
| 1 | 1k | Resistor_SMD:R_0603_1608Metric | R10 |
| 1 | 4.7uf | Capacitor_SMD:C_0603_1608Metric | C2 |
| 1 | AP2112K-3.3 | Package_TO_SOT_SMD:SOT-23-5 | U3 |
| 1 | B5819WS-TP | custom components:SOD2512X115N | D1 |
| 1 | CH343P | custom components:QFN50P300X300X80-17N | U2 |
| 1 | Conn_01x04_Pin | Connector_JST:JST_XA_B04B-XASK-1_1x04_P2.50mm_Vertical | J16 |
| 1 | Crystal_GND24 | Crystal:Crystal_SMD_2016-4Pin_2.0x1.6mm | Y1 |
| 1 | ESP32-S3-WROOM-1-N8R8 | custom components:XCVR_ESP32S3WROOM1N8R8 | U1 |
| 1 | GT-TF003-H0185-02 | footprints:Connector_MicroSD_G-SWITCH_GT-TF003-H0185-02 | J15 |
| 1 | MC-126D-DG10 | footprints:Connector_USB-C_HANBO-ELECTRONIC_MC-126D-DG10 | J1 |
| 1 | ~ | Package_DFN_QFN:QFN-24-1EP_4x4mm_P0.5mm_EP2.75x2.75mm_ThermalVias | U4 |
More from drfhaust/Macro-keyboard
1- 2 layers80 × 73.1 mm

Similar boards
- 2 layers60 × 50 mm

- 4 layers97.1 × 26 mm

- 6 layers167.5 × 79 mm

- 2 layers48 × 48 mm

- 4 layers93.2 × 35 mm

Mk2 routed
Woz4tetra/auto-battlebot
This project brings aim-assist and autonomous control to combat robots.
75 parts3 - 4 layers76.9 × 67.3 mm

- 4 layers52.1 × 40.7 mm

- 4 layers90 × 40 mm

Linear act controller
Talw3g/linear_act_controller
Controller for 24V linear actuator with potentiometer position control and feedback.
80 parts
Questions
How big is the Macro keyboard PCB?
It measures 80 × 100 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Macro keyboard use?
74 parts, built around the ESP32-S3-WROOM-1-N8R8, CH343P, GT-TF003-H0185-02 and AP2112K-3.3. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the Macro keyboard KiCad files?
From the drfhaust/Macro-keyboard repository on GitHub, at the commit this page was made from: the board is Macro keyboard/Macro keyboard.kicad_pcb and its schematic Macro keyboard/Macro keyboard.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Macro keyboard design in my own project?
Its repository states no licence, so its author keeps all rights: ask drfhaust before reusing the design.