2 layers59.8 × 20 mm
Bailabox power board
dr-harvey/BailaBox
BailaBox - RFID enabled, ESP32-based music toy for kids that works with Home Assistant and network speakers.
30 parts29
2 layers168.6 × 70 mm
Bailabox main board v2
dr-harvey/BailaBox29BailaBox - RFID enabled, ESP32-based music toy for kids that works with Home Assistant and network speakers.
- Size
- 168.6 × 70 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 87
- Nets
- 80
- Pads
- 354
- Tracks, vias
- 616, 152
- Pours
- 11
- Routed
- Yes
- KiCad
- KiCad 10.0 (file 20260206)
- Created
- 4 Aug 2026
- Updated
- 6 Aug 2026
Overview
Bailabox main board v2 is an open-source printed circuit board by dr-harvey, from the dr-harvey/BailaBox repository on GitHub. It is a 2-layer board of 168.6 × 70 mm with 87 parts on 80 nets, routed with 616 tracks and 152 vias.
It is built around the ESP32-S3-WROOM-1-N8, MFRC522 and SK6812. Its parts include 25 resistors, 21 capacitors, 13 diodes, 5 switches and 4 connectors. It belongs with the home automation and IoT and radio and wireless boards and the ESP32 boards of this library.
Main components
3
ESP32-S3-WROOM-1-N8
SMD,25.5x18mm-40℃~+85℃ -98.2dBm 2.4GHz 20.5dBm 355mA 3V~3.6V 95mA Bluetooth5.0 ESP32-S3 Chip On-board PCB Antenna UART、SPI、I2C、I2S、USB SMD,25.5x18mm WiFi Modules ROHSEspressif SystemsWiFi Modules
MFRC522
QFN-32-EP(5x5)10uA 13.56MHz 2.5V~4V Data verification、Low power wake-up I2C,SPI,UART ISO 14443A,ISO 14443B QFN-32-EP(5x5) RFID ICs ROHSJSMSEMIRFID ICs
SK6812
SMD-4P,5.4x5mm-40℃~+85℃ 0.6mA 1.6mm 120° 160mcd~320mcd 1kHz 2000V 280mcd~515mcd 3.7V~5.5V 460nm~470nm 520nm~530nm 620nm~625nm 800Kbit/s 815mcd~1275mcd Built-in power-on reset circuit Semi-transparent lens SMD-4P,5.4x5mm RGB LEDs(Built-in IC) ROHSOPSCO OptoelectronicsRGB LEDs(Built-In IC)
README
README.mdBailaBox
BailaBox is an open-source, token-controlled music player interface built around an ESP32-S3, ESPHome and Home Assistant. Place a printed RFID token on the reader to start its assigned song or playlist, remove it to pause, and use the physical buttons and rotary encoder for playback and volume control.
This is a personal hobby project shared for other makers to study, modify and build. It is not a finished commercial product or a certified children's toy.
Features
- RFID/NFC tokens mapped to songs or playlists in Home Assistant
- Play/pause, next and previous controls
- Rotary volume control with configurable limits
- ESP32-S3 running ESPHome
- Rechargeable single-cell LiPo battery and USB-C charging
- Custom main and power PCBs
- 3D-printable enclosure, controls and tokens
- Editable KiCad and Fusion 360 source files
How it works
- The main board reads the UID of a token placed over its RFID antenna.
- ESPHome sends the scan or removal event to Home Assistant.
- The supplied Home Assistant package maps that UID to a song or playlist.
- Home Assistant controls the configured media player.
The media itself is not stored on BailaBox. Available media services and players depend on your Home Assistant setup.
Repository contents
| Path | Contents |
|---|---|
hardware/main-board/ | Main-board KiCad source, manufacturing files and mechanical reference |
hardware/power-board/ | Power-board KiCad source, manufacturing files and mechanical reference |
enclosure/ | Fusion 360 source and printable 3MF files |
firmware/esphome/ | ESPHome configuration and secrets example |
home-assistant/ | Home Assistant package and RFID/media mapping instructions |
docs/assembly.md | Parts list, flashing, testing and assembly guide |
photos/ | Product, assembly and exploded-view images |
Building BailaBox
This project requires PCB assembly, soldering, ESPHome firmware setup, access to Home Assistant, and either a 3D printer or an online printing service.
- Read the complete assembly guide and parts list first.
- Manufacture or order the main board and power board.
- Print the enclosure parts from
enclosure/print-files/. For the easiest setup, the author recommends the ready-to-print BailaBox print profile on MakerWorld. - Configure and flash the ESPHome firmware.
- Install and configure the Home Assistant package.
- Complete the pre-enclosure tests and final assembly described in the guide.
Project status
The repository describes BailaBox hardware revision 2. It is a tested personal hobby project shared so other makers can build, study and modify it.
Safety
BailaBox contains a rechargeable LiPo battery, strong neodymium magnets and small parts. Incorrect battery polarity, damaged cells or wiring faults can cause fire or equipment damage. Magnets can be dangerous if swallowed. Assembly and use should be supervised by an adult familiar with basic electronics safety, and the finished device should be inspected before being given to a child.
Licensing
- Hardware, enclosure files and documentation: CC BY-SA 4.0
- ESPHome firmware and Home Assistant configuration: MIT
See LICENSE.md for the full licensing breakdown, third-party notices
and PiicoDev attribution.
Acknowledgements
Portions of the RFID schematic and PCB design are adapted from the PiicoDev RFID Module by Core Electronics, licensed under CC BY-SA 4.0. The design was modified and integrated into the BailaBox main board. BailaBox is not affiliated with or endorsed by Core Electronics.
Parts
87| Qty | Value | Footprint | References |
|---|---|---|---|
| 12 | SK6812 | Custom Kuba:SK6812_5050 | D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12 |
| 8 | 10k | Resistor_SMD:R_0603_1608Metric | R1, R2, R5, R8, R9, R10, R11, R12 |
| 6 | 10k | Resistor_SMD:R_0402_1005Metric | R13, R14, R15, R16, R17, R18 |
| 5 | 0R | Resistor_SMD:R_0603_1608Metric | R22, R23, R24, R25, R26 |
| 5 | NetTie_2 | PiicoDev RFID MFRC522:NetTie-2_SMD_Pad0.80mm | NT1, NT2, NT3, NT4, NT5 |
| 4 | 100n | Capacitor_SMD:C_0402_1005Metric | C4, C5, C6, C7 |
| 4 | 270p NP0 2% | Capacitor_SMD:C_0603_1608Metric | C18, C19, C20, C21 |
| 4 | M3 | MountingHole:MountingHole_3.2mm_M3_Pad_Via | MH1, MH2, MH3, MH4 |
| 3 | 0.1 µF | Capacitor_SMD:C_0603_1608Metric | C2, C3, C10 |
| 3 | Fiducial | Fiducial:Fiducial_1mm_Mask2mm | FID1, FID2, FID3 |
| 2 | 100k | Resistor_SMD:R_0603_1608Metric | R3, R4 |
| 2 | 1uH | Inductor_SMD:L_0603_1608Metric | L1, L2 |
| 2 | 22p NP0 | Capacitor_SMD:C_0402_1005Metric | C8, C15 |
| 2 | 56p | Capacitor_SMD:C_0603_1608Metric | C16, C17 |
| 2 | 62p NP0 2% | Capacitor_SMD:C_0603_1608Metric | C13, C14 |
| 2 | Btn nxt | Button_Switch_THT:SW_TH_Tactile_Omron_B3F-100x | SW3, SW4 |
| 1 | 10 µF | Capacitor_SMD:C_0603_1608Metric | C1 |
| 1 | 100n X7R 10% | Capacitor_SMD:C_0402_1005Metric | C12 |
| 1 | 120R | Resistor_SMD:R_0402_1005Metric | R19 |
| 1 | 1k | Resistor_SMD:R_0603_1608Metric | R21 |
| 1 | 1n NP0 10% | Capacitor_SMD:C_0603_1608Metric | C11 |
| 1 | 220 uF | Capacitor_SMD:CP_Elec_6.3x5.4 | C9 |
| 1 | 27.12MHz 12pF | Crystal:Crystal_SMD_TXC_7M-4Pin_3.2x2.5mm | Y1 |
| 1 | 330R | Resistor_SMD:R_0603_1608Metric | R7 |
| 1 | 820R | Resistor_SMD:R_0603_1608Metric | R20 |
| 1 | Boot | Custom Kuba:TS-1187A-B-A-B | SW2 |
| 1 | Conn_01x04 | Connector_JST:JST_PH_B4B-PH-K_1x04_P2.00mm_Vertical | J4 |
| 1 | Conn_01x06 | Connector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_Vertical | J5 |
| 1 | Conn_01x07_Pin | Connector_PinHeader_2.54mm:PinHeader_1x07_P2.54mm_Vertical | J3 |
| 1 | ESP32-S3-WROOM-1 | RF_Module:ESP32-S3-WROOM-1 | U1 |
| 1 | LED | LED_SMD:LED_0603_1608Metric | D13 |
| 1 | LED_Data | TestPoint:TestPoint_Pad_1.5x1.5mm | J6 |
| 1 | MFRC522 | Package_DFN_QFN:VQFN-32-1EP_5x5mm_P0.5mm_EP3.1x3.1mm_ThermalVias | U2 |
| 1 | Reset | Custom Kuba:TS-1187A-B-A-B | SW1 |
| 1 | RotaryEncoder_Switch | Custom Kuba:PEC11R-4xxxF-Sxxxx | SW6 |
| 1 | SolderJumper_2_Bridged | CoreElectronics_Components:SolderJumper-2_P1.3mm_Bridged_RoundedPad1.0x1.5mm | JP1 |
| 1 | SolderJumper_3_Bridged123 | CoreElectronics_Components:SolderJumper-3_P1.3mm_Closed_RoundedPad1.0x1.5mm_NumberLabels | JP2 |
More from dr-harvey/BailaBox
1Similar boards
- 2 layers25.4 × 52 mm
CE PiicoDev RFID Reader Writer
CoreElectronics/CE-PiicoDev-RFID-Module
CE PiicoDev RFID Reader Writer
59 parts7 - 2 layers39.3 × 59.9 mm
- 4 layers71.2 × 66.1 mm
Maxbox
ios-cv/maxbox
An in car telemetry and access management box consisting of PCB design, firmware and case.
110 parts1AGPL-3.0 - 2 layers99.6 × 72 mm
- 2 layers120 × 50 mm
- 2 layers74 × 74 mm
Labpass RFID Reader
psu-epl/epl-badge-access
OLD Repo for v2 of the EPL Badge Access System
64 partsGPL-3.0 - 2 layers93.5 × 58.7 mm
- 2 layers
Questions
How big is the Bailabox main board v2 PCB?
It measures 168.6 × 70 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Bailabox main board v2 use?
87 parts, built around the ESP32-S3-WROOM-1-N8, MFRC522 and SK6812. 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 Bailabox main board v2 KiCad files?
From the dr-harvey/BailaBox repository on GitHub, at the commit this page was made from: the board is hardware/main-board/kicad/bailabox_main_board_v2.kicad_pcb and its schematic hardware/main-board/kicad/RFID PCB/CE-PiicoDev-RFID-Reader-Writer.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Bailabox main board v2 design in my own project?
Its repository states no licence, so its author keeps all rights: ask dr-harvey before reusing the design.