https://github.com/usimd/milight-hub
Custom PCB to run Milight Hub for integrating Milight hardware into Homeassistant
https://github.com/usimd/milight-hub
homeassistant kicad milight-bridge
Last synced: 1 day ago
JSON representation
Custom PCB to run Milight Hub for integrating Milight hardware into Homeassistant
- Host: GitHub
- URL: https://github.com/usimd/milight-hub
- Owner: usimd
- License: cern-ohl-s-2.0
- Created: 2026-05-03T18:16:14.000Z (29 days ago)
- Default Branch: main
- Last Pushed: 2026-05-25T08:14:26.000Z (8 days ago)
- Last Synced: 2026-05-25T10:16:29.807Z (8 days ago)
- Topics: homeassistant, kicad, milight-bridge
- Homepage:
- Size: 1.51 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MiLight Hub base PCB
[](https://aisler.net/p/new?url=https://raw.githubusercontent.com/usimd/milight-hub/refs/heads/main/milight-hub-base.kicad_pcb&ref=github)
Compact ESP32-C3 and nRF24L01+ based hardware for running a MiLight hub.
## Overview
This repository contains a KiCad hardware design for a small standalone MiLight bridge board.
The design is built around:
- `ESP32-C3-WROOM-02`
- an `nRF24L01+` compatible radio module (castellated SMD version)
- an on-board buck regulator for `3.3 V`
- a Molex PicoBlade power input (because it's tiny and I had it in stock)
- a pogo-pad programming header for external flashing
The goal is a compact dedicated board for MiLight integration rather than a generic development board or Home Assistant add-on.
## Firmware
This board is designed to run [ESPHome](https://esphome.io/) with the [hencou/mi](https://github.com/hencou/esphome_components) external component for MiLight protocol handling (including FUT022 CCT support). An ESPHome configuration is included in the `esphome/` directory.
The firmware provides bidirectional MiLight RF communication and integrates with Home Assistant natively via the ESPHome API.
## Repository Contents
- `milight-hub-base.kicad_pro`: KiCad project
- `milight-hub-base.kicad_sch`: schematic
- `milight-hub-base.kicad_pcb`: PCB layout
- `milight-hub-base.kicad_dru`: board design rules
- `fp-lib-table`: project footprint library table
- `lib/`: local project footprints and 3D assets
- `esphome/`: ESPHome firmware configuration
- `enclosure/`: FreeCAD enclosure design and 3MF export for printing
## Tooling
- KiCad project files are stored in this repository
- local footprint data is included in `lib/`
- generated local review artifacts are intentionally not tracked
## License
The hardware design files in this repository are licensed under the CERN Open Hardware Licence Version 2 - Strongly Reciprocal (`CERN-OHL-S-2.0`). See [`LICENSE`](LICENSE).