Skip to the content
2 layers44 × 33 mmMmWave Presence Lighting Node, the printed circuit board in 3D

MmWave Presence Lighting Node

wkcollis1-eng/mmwave-presence-node

HLK-LD2410C 24 GHz presence sensor on a XIAO ESP32-C3, driving room lighting via Home Assistant. Design doc, KiCad carrier PCB, ESPHome firmware.

Size
44 × 33 mm
Copper layers
2
Thickness
1.6 mm
Parts
10
Nets
9
Pads
34
Tracks, vias
50, 68
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
8 Sep 2026
Updated
30 Oct 2026

Overview

MmWave Presence Lighting Node is an open-source printed circuit board by wkcollis1-eng, from the wkcollis1-eng/mmwave-presence-node repository on GitHub. It is a 2-layer board of 44 × 33 mm with 10 parts on 9 nets, routed with 50 tracks and 68 vias.

Its parts include 3 capacitors, 2 ICs and 1 resistor. It belongs with the lEDs and displays and home automation and IoT boards and the ESP32 and RISC-V boards of this library.

README

README.md

mmWave Presence Lighting Node

24 GHz Radar Presence Sensing for Room Lighting

Hardware: CERN-OHL-S v2 Code: MIT Docs: CC BY 4.0 PCB Status Sponsor

A 24 GHz radar presence sensor that turns a room's lamps on when someone walks in and off some minutes after they leave — including for a person sitting still, in the dark, reading, whom a PIR sensor cannot see.

An HLK-LD2410C radar and an Adafruit VEML7700 light sensor on a Seeed XIAO ESP32-C3 carrier board, running ESPHome, with the control logic in Home Assistant.

Assembled node: LD2410C radar on the carrier board, VEML7700 on its QT cable, in a clear-lid enclosure

Board, top Board, bottom Board, VEML7700


The problem this is built for

It is 23:00. The family room is dark and empty. A person walks in and sits down to read. The light comes on within one second, stays on for the next ninety minutes while they barely move, and goes off some minutes after they leave. Nobody touches a switch. Nobody is available to fix anything.

That is the acceptance test, not "99.9% uptime". A node that is powered and online but drops the still-target at minute forty has failed the moment of demand — and so has one that takes three seconds to notice someone walked in. The reasoning behind every threshold, and the measurements that set them, are in docs/mmwave-presence-node-design.md.

Status

Design documentRev 1.11, October 2026
PCBFabricated and populated. 44.0 × 33.0 mm, 2-layer, three built
Bench validationFirst session against real hardware 2026-09-07 — seven corrections and one retraction folded back into Rev 1.6. 14.5 days of bench data reviewed 2026-09-22 — folded into Rev 1.7
Firmware / HA configDeployed. Both nodes run firmware 0.4. The whole package (office and family room) is live in Home Assistant, derived from packages/mmwave_presence.yaml
DeploymentOffice live since 2026-09-26, family room since 2026-10-02. First production review 2026-10-16, folded into Rev 1.8. A lamp lit into an empty room goes off after 5 min, from Rev 1.9 (2026-10-16). Family lamps the package lit go off on a bright morning, sunrise to noon, from Rev 1.10 (2026-10-19). Family lamps hold while the TV is on, from Rev 1.11 (2026-10-23)
Latency (R2)Family room: median 0.386 s, P95 0.409 s, n=103 [M] (HA's timestamps, presence edge → lamp relay on; not photons). Office: median 2.404 s, P95 6.769 s, n=68 [M]. That is not met by design: the office lamp waits until the person is inside the approach limit, so a walk from the doorway is in the figure. Before that filter it was median 0.387 s, n=25 [M] — design doc §8
Known faultThe office node loses power every night, about 23:30 to 07:00 [M: 13 nights, 09-29 → 10-12], and was dark for 79.66 h on 10-12 → 10-15 [M]. Under the §7 "lamp stays on while the node is offline" rule, the lamp stayed lit through 6 of those nights, 47.06 h in all [M]. Cause (owner, 2026-10-16): the node's outlet strip is fed by the Kasa computer outlet, which goes off overnight; the outlet's off-spans match all 14 dark gaps [M]. The remedy is the owner's call — design doc §9 item 16

The design document's §0 recorded what was its most consequential open question: the 5.6 m detection target and the gate-2 (7.4 ft) cap needed to reject a person in the next room cannot both hold. It is closed (owner-confirmed 2026-10-23), and neither is kept for the office. The 5.6 m target is a family-room requirement only (design doc §3.6); that node runs max gate 8. The office rejects the bathroom next door in Home Assistant instead: occupancy starts only on a target reported inside 82 in (owner, 2026-10-16), live since 2026-09-27 as the P24 filter in packages/mmwave_presence.yaml. A gate-2 cap was rejected because the doorway reads at gate 3 too, so it would read a person standing there as empty. The office radar still runs placeholder gates (move 4, still 4) until they are measured at the mount (design doc §9 item 11).

Repository layout

text
docs/          Design document, draft notes, the LD2410C documentation review,
               and the Hi-Link / Adafruit primary sources they cite
hardware/      KiCad 10 board, 3D models, gerbers, enclosure DXF, BOM
esphome/       Node firmware — common config plus per-node overlays
packages/      Home Assistant package: the control logic and its helpers
dashboards/    Home Assistant views for commissioning and monitoring
scripts/       Calibration and config-checking tools
assets/        Photos of the built node

esphome/, packages/, dashboards/ and scripts/ deliberately mirror the layout under Home Assistant's /config, so a path named in the notes means the same thing here and on the target.

Hardware

Board44.0 × 33.0 mm, 2-layer, 1 oz copper, 1.6 mm FR4
Front copperPads and vias only, no traces — unbroken ground plane under the radar
Back copperAll routing. 1 mm power, 0.25 mm signal, 0.2 mm clearance
Mounting3 × M3 NPTH; H2 and H3 sit under U2's courtyard by design — use nylon fasteners
Vias67 total, 16 under the module, largest gap 5.39 mm (below λg = 5.96 mm)

1 oz / 1.6 mm, not 2 oz / 0.8 mm. At 24.125 GHz the skin depth is 0.425 µm, so 1 oz is already 82 skin depths and 2 oz buys nothing electrically. 0.8 mm has 1/8 the flexural rigidity, which is the wrong direction for a vertically mounted board carrying a cantilevered radar where flex changes the antenna-to-window distance.

Radar interconnect

Module pin order, printed on the antenna face: TX RX OUT GND VCC.

LD2410CSignalDirectionXIAOGPIO
1UART_Txmodule → ESPD3GPIO5
2UART_RxESP → moduleD2GPIO4
3OUTmodule → ESPD10GPIO10 (via R1)
4GND—GND—
5VCC5 V inVBUS, not 3V3—

Identify every pin by its silkscreen label, never by position or number. VCC and TX sit at opposite ends of a five-pin header, so counting from the wrong end puts 5 V on TX. That is the one wiring error on this module that destroys something.

PH1 — light sensor header

padlabelXIAOGPIO
13V3 (RED)3V3—
2GND (BLACK)GND—
3SCL (YELLOW)D5GPIO7
4SDA (BLUE)D4GPIO6

The colours match the Qwiic/STEMMA QT convention. The pin order deliberately does not — it was chosen for cleaner routing, and the silkscreen colour labels are the interface instead.

Build constraint: only a flying-lead QT cable works

Adafruit 4397 terminates in four independent female sockets, so each wire is placed by colour. A molded 4-pin housing cable connects power backwards and destroys the sensor. The board tells you the colours but not why.

Cut the VEML7700's power-LED jumper before the sensor goes near the enclosure. The Adafruit 4162 carries a green power LED on the same face as the photodiode. This is a sealed box: an ambient-light sensor locked in the dark with its own light source is partly measuring that source, and because the offset is constant it presents as a calibration rather than a fault.

The light sensor is off-board on a 150 mm cable, by design. On-carrier it sat 3.41 mm from the module edge — a near-field problem — and it could not be aimed independently of the radar.

Working on the board

Open hardware/mmWave Presence Lighting Node.kicad_pro in KiCad 10. All in-repo 3D models resolve through ${KIPRJMOD}/3d/, so a fresh clone renders the full assembly with no path fixing.

Two things to know before you file a bug against the board:

  1. There is no schematic. The project is board-only, so KiCad cannot run connectivity or clearance DRC against a netlist — every error across seven revisions was found by reading coordinates. Building the schematic is open item §9.5 and is the one gate still running on human attention. Corrected 2026-09-22: too strong. The pads carry net assignments, so DRC's connectivity check does run against the board's own nets — that is the "0 unconnected items" below. What is missing is an independent schematic to check those nets against.

  2. kicad-cli pcb drc reports 16 violations, and that is the expected baseline — 3 errors, 13 warnings, 0 unconnected items. Compare against this baseline rather than expecting zero. It breaks down as:

    nseverityrulewhy it is accepted
    2errorcourtyards_overlapH2 and H3 sit under U2's courtyard by design — see §3.1 and the nylon-fastener note in §3.9
    1errornpth_inside_courtyardsame cause: a mounting hole inside the module's courtyard
    4warningsilk_over_coppercosmetic, reviewed
    2warningsilk_edge_clearancecosmetic, reviewed
    6warninglib_footprint_mismatchstock footprints deliberately modified in place (C1 relocated for U.FL clearance, 3D models attached)
    1warninglib_footprint_issuesU2 — its footprint is stored inline in the board with no library behind it

Third-party assets

Full detail, including the terms that apply to each, is in THIRD_PARTY_NOTICES.md. These files are not covered by this repository's own licences.

One file is non-commercial. The LD2410C radar mesh (hardware/3d/LD2410C mmWave Sensor.step and its snapshot directory) is CC BY-NC 4.0. It is a 3D viewer mesh only — it is not in the gerbers, so it does not restrict manufacturing this board. For commercial use, delete those paths and render U2 with the Hi-Link model instead.

AssetOriginNote
hardware/3d/LD2410C mmWave Sensor.stepBen Cooney, via GrabCADCC BY-NC 4.0 — non-commercial; licence image ships in ld2410c-mmwave-sensor-1.snapshot.2/
hardware/3d/HLK-LD2410C-3D图/Hi-LinkManufacturer 3D model
hardware/3d/Adafruit VEML7700.zipSnapMagicPart models remain SnapMagic's intellectual property
docs/LD2410C Docs/*.pdfHi-Link, AdafruitDatasheet, serial protocol V1.07, VEML7700 guide
hardware/3d/Seeed-Studio-XIAO-ESP32-C3.stepSeeed Studio

Where the Hi-Link datasheet and the serial protocol document disagree, the protocol document wins: it is two years newer and it documents the commands the module obeys.

Credentials

Every credential in this repository resolves through ESPHome !secret, and the secrets.yaml those resolve against lives in the Home Assistant config, not here. Git history has been scanned and contains no plaintext SSID, PSK, API encryption key or OTA password in any commit.


License

Three licences, because this repository holds three different kinds of work:

ContentPathsLicence
Hardware designhardware/CERN-OHL-S v2
Codeesphome/, packages/, dashboards/, scripts/MIT
Documentationdocs/, this READMECC BY 4.0

See LICENSE for the full breakdown and attribution examples, and THIRD_PARTY_NOTICES.md for the vendor files that none of the above covers.

CERN-OHL-S is strongly reciprocal: build the board, sell it, modify it — but if you convey a modified design or a product made from it, the modified source has to be available under the same terms.

text
Copyright (C) 2026 William K. Collis

This source describes Open Hardware and is licensed under the CERN-OHL-S v2.

You may redistribute and modify this source and make products using it under
the terms of the CERN-OHL-S v2 (https://ohwr.org/cern_ohl_s_v2.txt).

This source is distributed WITHOUT ANY EXPRESS OR IMPLIED WARRANTY, INCLUDING
OF MERCHANTABILITY, SATISFACTORY QUALITY AND FITNESS FOR A PARTICULAR PURPOSE.
Please see the CERN-OHL-S v2 for applicable conditions.

Source location: https://github.com/wkcollis1-eng/mmwave-presence-node

💝 Support This Project

Sponsor on GitHub Buy Me A Coffee

If this design document or the commissioning method saved you time on your own presence-sensing build, sponsorship funds continued instrumentation, hardware and documentation.

Parts

10
QtyValueFootprintReferences
3MountingHole_3.5mmMountingHole:MountingHole_3.5mmH1, H2, H3
2C_Disc_D3.8mm_W2.6mm_P2.50mmCapacitor_THT:C_Disc_D3.8mm_W2.6mm_P2.50mmC2, C3
1C_Disc_D5.0mm_W2.5mm_P2.50mmCapacitor_THT:C_Disc_D5.0mm_W2.5mm_P2.50mmC1
1LD2410C Sensor ModuleAdafruit INA260:SeeedStudio_24gHz_mmWaveU2
1PinHeader_1x04_P2.54mm_HorizontalConnector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_HorizontalPH1
1R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR1
1SeeedStudio_XIAO_ESP32C3PCM_fab:SeeedStudio_XIAO_ESP32C3U1

Similar boards

  • 2 layers57 × 55.2 mmLogicAnalyzer, the printed circuit board in 3D

    LogicAnalyzer

    gusmanb/logicanalyzer

    24 channel, 100Msps logic analyzer hardware and software

    10 parts5.1kGPL-3.0
  • 2 layers32.2 × 15.4 mmProtector, the printed circuit board in 3D

    Protector

    byrantech/laptop

    anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.

    10 parts4.3kMIT
  • 2 layers26 × 18 mmConn, the printed circuit board in 3D

    Conn

    yaqwsx/KiKit

    Automation tools for KiCAD

    10 parts2.1kMIT
  • 2 layers44.3 × 30.5 mmLime2-SATA RevA, the printed circuit board in 3D

    Lime2-SATA RevA

    OLIMEX/OLINUXINO

    OLINUXINO is Open Source / Open Hardware, low cost from EUR 24 Linux Industrial grade Single Board Computer capable to operate -25+85C

    10 parts1.5k
  • 2 layers17.8 × 43.2 mmNano Adapter, the printed circuit board in 3D

    Nano Adapter

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    10 parts1.1kGPL-3.0
  • 2 layers53.9 × 23.2 mmBuffer, the printed circuit board in 3D

    Buffer

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    10 parts1kGPL-3.0

Questions

How big is the MmWave Presence Lighting Node PCB?

It measures 44 × 33 mm and has 2 copper layers, 1.6 mm thick.

What parts does the MmWave Presence Lighting Node use?

10 parts. 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 MmWave Presence Lighting Node KiCad files?

From the wkcollis1-eng/mmwave-presence-node repository on GitHub, at the commit this page was made from: the board is hardware/mmWave Presence Lighting Node.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the MmWave Presence Lighting Node design in my own project?

Its repository states no licence, so its author keeps all rights: ask wkcollis1-eng before reusing the design.