esp32-HLK-LD2410C-example
Project Information
Test an HLK-LD2410C motion & presence sensor over WiFi via a captive portal
Flash to Device
Login required: You need to login or create an account to flash this project.
Source Files (3)
Download AllREADME
ESP32 LD2410C Radar Tester — Captive Portal
Verify an HLK-LD2410C 24 GHz presence radar over WiFi with a captive portal
This project turns an ESP32 Dev Board into a small WiFi-based tester for the HLK-LD2410C 24 GHz radar module. When powered, the ESP32 creates an open WiFi Access Point and a captive portal. As soon as a device connects to the AP, a live dashboard appears that shows whether the radar is working correctly — connection status, human presence/motion detection, target distances and signal energy.
⭐ Features
- Open WiFi Access Point (no password)
- SSID:
ESP32-LD2410C
- SSID:
- Captive portal
- Any URL request (e.g.
google.com) is redirected to the tester page - Works with Android / iOS / Windows / Linux
- Any URL request (e.g.
- Live radar dashboard (auto-refreshes every 500 ms, no page reload)
- Module health — green dot = the module is streaming valid UART data (= healthy)
- Presence detection — shows if a person is detected (motion or micro-motion)
- Moving target — distance + signal energy (with bar graph)
- Stationary target — distance + signal energy for a motionless person
- Detection distance — overall measured distance
- On-board LED lights up whenever presence is detected (extra at-a-glance indicator)
- No external network or internet required
📦 Hardware requirements
- ESP32 Dev Board (e.g. ESP32-DevKitC)
- HLK-LD2410C 24 GHz presence radar module
- Jumper wires
The LD2410C output logic level is 3.3 V, so it connects directly to the ESP32 without a level shifter.
Wiring
| LD2410C | ESP32 (DevKitC) | Notes |
|---|---|---|
| VCC | 5V / VIN | Module runs on 5–12 V DC |
| GND | GND | Common ground (required!) |
| TX | GPIO16 (RX2) | Radar → ESP (hardware UART2) |
| RX | GPIO17 (TX2) | ESP → Radar (hardware UART2) |
| OUT | (optional) GPIO | Hardware presence signal (not required) |
⚙️ Key configuration in the code
#define RADAR_SERIAL Serial2 // hardware UART2
#define RADAR_BAUD 256000 // LD2410C default baud rate (8N1)
#define RADAR_RX_PIN 16 // ESP32 RX2 <- LD2410C TX
#define RADAR_TX_PIN 17 // ESP32 TX2 -> LD2410C RX
#define LED_PIN 2 // on-board LED (GPIO2), active HIGH
const char* ap_ssid = "ESP32-LD2410C"; // open AP, no password
🚀 How to use
- Wire the LD2410C to the ESP32 as shown above.
- Connect the board to your computer.
- Click Flash to Device.
- Select the appropriate port in the popup window.
- Click Install main.
- Power the board. On your phone/laptop, connect to the WiFi network
ESP32-LD2410C(open, no password). - A captive portal page opens automatically (or browse to
http://192.168.4.1). - Watch the dashboard:
- Green dot + "Module HEALTHY" → the module is alive and streaming data.
- Walk in front of the sensor → presence / moving target updates.
- Stand still → after a moment the stationary (micro-motion) target reacts.
🧪 What "working" looks like
| Indicator | Healthy result |
|---|---|
| Connection dot | Green — UART frames received continuously |
| Presence | Toggles between "Presence detected" and "No presence" |
| Moving distance | Changes as you move (up to ~5 m, ±60°) |
| Stationary distance | Non-zero when a motionless person is nearby |
| On-board LED | Lights up while presence is detected |
If the dot stays red ("No data from module"), check the wiring (TX↔RX swapped?),
the 5 V supply, the common ground, and that the baud rate is 256000
(some LD2410C units ship at 115200).
📝 Notes
- Detection: up to 5 m, configurable in 0.75 m range gates, ±60° coverage.
- The LD2410C also supports BLE and a configuration protocol; this sketch only reads the default cyclic reporting frames, which is enough to confirm the module is functional.
- This is the ESP32 twin of the ESP8266 version. The only real differences are the
WiFi/WebServer libraries and the UART: the ESP32 uses a dedicated UART2 (GPIO16/17),
so no
Serial.swap()trick is needed.