Skip to the content
2 layers40 × 30 mmEsphome xiao base, the printed circuit board in 3D

Esphome xiao base

0rax/esphome-xiao-base5

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

1

README

README.md

ESPHome XIAO Base

Release License KiCad

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

RenderFrontBack
PCB RenderPCB FrontPCB Back

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:

ParametersValueParametersValue
Base MaterialFR4Copper Weight1 oz
Layers2Via CoveringTented
Dimensions40 × 30 mmMin Via Hole Size0.3 mm
PCB Thickness1.2 or 1.6 mmBoard Outline Tolerance± 0.2 mm
PCB Color 1BlackMark on PCB 22D Barcode (Serial Number)
SilkscreenWhite> Printing: Number Only
Surface Finish 3Lead Free HASL or ENIG> Position: Specify Position

BOM

PartRef.QuantityRemarks
PCBESPHome XIAO Base PCB1See the previous section on how to order it.
XIAO ControllerXIAO ESP32C3, XIAO ESP32C6 or XIAO ESP32S31Any ESPHome compatible XIAO controller should work.
Tactile SwitchSCHURTER 1301.93033Any 6 × 6 mm thru-hole tactile switch should work. We recommend a model with a stem length of 3 mm or more.
OLED DisplaySSD1306 0.91" OLED Display or SSD1107 0.96" OLED Display1Any 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

  1. 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). ↩

  2. JLCPCB specific option, a pre-configured footprint has been added for a serial number to be printed on the back of the PCB. ↩

  3. 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
QtyValueFootprintReferences
3MountingHole_2.2mm_M2_ISO14580_PadMountingHole:MountingHole_2.2mm_M2_ISO14580_PadH1, H2, H3
3SW_PushButton_Switch_THT:SW_PUSH_6mmSW1, SW2, SW3
1Conn_02x06_Odd_EvenConnector_PinHeader_2.54mm:PinHeader_2x06_P2.54mm_VerticalJ2
1JLCPCB_SerialNumber_2x10mmLKBD_PCBFab:JLCPCB_SerialNumber_2x10mmREF1
1PINHD_1x4_MaleLKBD_OLED:OLED_SSD1306_128x32_0.91inch_I2CJ1
1XIAO-ESP32LKBD_MCU:MCU_XIAO-RP2040U1

Similar boards

  • 2 layers148 × 61 mmIrrigation controller, the printed circuit board in 3D

    Irrigation controller

    adriencarbonaro/irrigation-controller

    Irrigation System Controller

    40 parts2
  • 2 layers82.7 × 51.9 mmHollow Alarm, the printed circuit board in 3D

    Hollow Alarm

    NLEVEL-GIT/Hollow-Alarm

    An Alarm with Hollow Knight features

    11 parts1
  • 2 layers22 × 77.4 mmNB001, the printed circuit board in 3D

    NB001

    uwrov/nanofloat

    18 parts1
  • 2 layers55.5 × 38 mmExiFlexBoard, the printed circuit board in 3D

    ExiFlexBoard

    2525mura/ExiFlex

    15 parts
  • 2 layers34.9 × 56.5 mmHome Automation v1, the printed circuit board in 3D

    Home Automation v1

    aayu0-0/SEEED-RS485-Extension-Board-reverse-engineering-project

    SEEED RS485 Extension Board reverse-engineering project

    64 parts
  • 2 layers150 × 100 mmMemento, the printed circuit board in 3D

    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 mmHandle bar, the printed circuit board in 3D

    Handle bar

    basic-bitch-foundation/Traffic

    18 parts
  • 2 layers58.9 × 43.6 mmMyProSole, the printed circuit board in 3D

    MyProSole

    Crankzz/myprosole-pcb

    37 parts

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).