

Esphome xiao base
XIAO base board PCB & configuration for ESPHome based sensors.
- Size
- 40 × 30 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 10
- Nets
- 14
- Pads
- 59
- Tracks, vias
- 81, 3
- Pours
- 1
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 26 Mar 2025
- Updated
- 19 May 2025
Overview
Esphome xiao base is an open-source printed circuit board by 0rax, from the 0rax/esphome-xiao-base repository on GitHub, published under the CERN-OHL-S-2.0 licence. It is a 2-layer board of 40 × 30 mm with 10 parts on 14 nets, routed with 81 tracks and 3 vias.
It is built around the XIAO ESP32C3. Its parts include 3 switches, 2 connectors and 1 IC. It belongs with the home automation and IoT and sensors and measurement boards and the ESP32 and RISC-V boards of this library.
Main components
1README
README.mdESPHome XIAO Base
The ESPHome XIAO Base is a custom PCB designed to be used with the ESPHome firmware as a base for creating new sensors.
It was made as a carrier board for the XIAO series of microcontrollers with an OLED display and three switches while providing an easy-to-access header on the back for standard communication protocols (I²C, UART and SPI).
A cutout has also been left for the underside of the XIAO to allow access to the battery pads available on the underside of some modules (such as the XIAO ESP32C6).
PCB
The PCB has been designed in KiCad EDA 9.0.
You can preview the project files using KiCanvas directly in your browser, the exported schematic is also available under output/schematics.
PCB Order
The necessary Gerber files to order the PCB are available in the output/fabrication/jlcpcb directory. They have been generated specifically for JLCPCB using KiBot. They should be compatible with other PCB manufacturers too.
Here is the list of parameters to use for the PCB order:
| Parameters | Value | Parameters | Value |
|---|---|---|---|
| Base Material | FR4 | Copper Weight | 1 oz |
| Layers | 2 | Via Covering | Tented |
| Dimensions | 40 × 30 mm | Min Via Hole Size | 0.3 mm |
| PCB Thickness | 1.2 or 1.6 mm | Board Outline Tolerance | ± 0.2 mm |
| PCB Color 1 | Black | Mark on PCB 2 | 2D Barcode (Serial Number) |
| Silkscreen | White | > Printing: Number Only | |
| Surface Finish 3 | Lead Free HASL or ENIG | > Position: Specify Position |
BOM
| Part | Ref. | Quantity | Remarks |
|---|---|---|---|
| PCB | ESPHome XIAO Base PCB | 1 | See the previous section on how to order it. |
| XIAO Controller | XIAO ESP32C3, XIAO ESP32C6 or XIAO ESP32S3 | 1 | Any ESPHome compatible XIAO controller should work. |
| Tactile Switch | SCHURTER 1301.9303 | 3 | Any 6 × 6 mm thru-hole tactile switch should work. We recommend a model with a stem length of 3 mm or more. |
| OLED Display | SSD1306 0.91" OLED Display or SSD1107 0.96" OLED Display | 1 | Any SSD1306 or SSD1106 I²C based display should work. The PCB was designed to accommodate both 0.91" (128 × 32) and 0.96" (64 × 128) modules. |
ESPHome
Example ESPHome configuration files can be found in the esphome directory.
Two are provided for the XIAO ESP32C6 and XIAO ESP32S3 with two different type of OLED display. They should be easily modifiable to fit any ESPHome compatible XIAO microcontrollers and displays.
Notes
Potential Modifications
- The XIAO microcontroller is currently soldered at the front of the PCB making the OLED display require a double stacked header for clearance as well as force the use of switches with extended stem. Moving it to the back of the PCB would allow for everything in the front to be made smaller but would make access to the battery pads on the back of the XIAO more difficult.
- Adding some sort of STEMMA QT / Qwiic connector to the back of the PCB would make it easier to integration some sensors.
License
This design is licensed under the CERN Open Hardware Licence Version 2 – Strongly Reciprocal (CERN-OHL-S-2.0).
You are free to use, modify, and distribute this design for any purpose, provided that:
- Attribution: Appropriate credit is given, a link to the license is provided, and any modifications are clearly indicated.
- Reciprocity: Any derivative works must be released under the same license.
If you are a retailer or business interested in producing or selling this design or related products, I’d love to discuss it! Please feel free to reach out so we can explore potential arrangements.
Footnotes
-
You can select any PCB color you want but some manufacturers such as JLCPCB may charge you more for uncommon combos (such as Blue PCB + ENIG Surface Finish). ↩
-
JLCPCB specific option, a pre-configured footprint has been added for a serial number to be printed on the back of the PCB. ↩
-
The "HASL (with lead)" option is extremely discouraged due to the risk of lead poisoning. We strongly recommend paying the premium for the "Lead Free HASL" option. ↩
Parts
10| Qty | Value | Footprint | References |
|---|---|---|---|
| 3 | MountingHole_2.2mm_M2_ISO14580_Pad | MountingHole:MountingHole_2.2mm_M2_ISO14580_Pad | H1, H2, H3 |
| 3 | SW_Push | Button_Switch_THT:SW_PUSH_6mm | SW1, SW2, SW3 |
| 1 | Conn_02x06_Odd_Even | Connector_PinHeader_2.54mm:PinHeader_2x06_P2.54mm_Vertical | J2 |
| 1 | JLCPCB_SerialNumber_2x10mm | LKBD_PCBFab:JLCPCB_SerialNumber_2x10mm | REF1 |
| 1 | PINHD_1x4_Male | LKBD_OLED:OLED_SSD1306_128x32_0.91inch_I2C | J1 |
| 1 | XIAO-ESP32 | LKBD_MCU:MCU_XIAO-RP2040 | U1 |
Similar boards
- 2 layers148 × 61 mm

- 2 layers82.7 × 51.9 mm

- 2 layers22 × 77.4 mm

- 2 layers55.5 × 38 mm

- 2 layers34.9 × 56.5 mm

Home Automation v1
aayu0-0/SEEED-RS485-Extension-Board-reverse-engineering-project
SEEED RS485 Extension Board reverse-engineering project
64 parts - 2 layers150 × 100 mm

Memento
AID-IOT/IOT-Memento-Design
A keepsake PCB built at the AICTE IDEA Lab, Poornima College of Engineering. It is a working board as well as a memento: a Seeed XIAO ESP32C3 drives four WS2812B LEDs and reads a BMP280 pressure/temperature sensor, and…
13 partsMIT - 2 layers48.5 × 48.6 mm

- 2 layers58.9 × 43.6 mm

Questions
How big is the Esphome xiao base PCB?
It measures 40 × 30 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Esphome xiao base use?
10 parts, built around the XIAO ESP32C3. 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 Esphome xiao base KiCad files?
From the 0rax/esphome-xiao-base repository on GitHub, at the commit this page was made from: the board is pcb/pcb.kicad_pcb and its schematic pcb/pcb.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Esphome xiao base design in my own project?
Its repository publishes it under the CERN-OHL-S-2.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).


