LD2410 Tool Download: Bluetooth App, PC Configurator and Firmware

No microcontroller is needed for this step. A USB charger and three jumper wires to VCC and GND are enough, because the Bluetooth radio lives on the module itself.

• Live target state: moving, still or nobody.
• Distance to the moving and still target.
• Energy per gate, drawn as bars, once you switch to the engineering view.
• Settings pages for gates, sensitivity and timeout.
• Firmware version and the update function.

The app may ask for a Bluetooth password. The factory default is commonly HiLink; if you or an ESPHome config have changed it, use the new six-character value. Set a password of your own once the sensor is in place, since anyone nearby with the app can otherwise connect.

If the module does not show up, check that another phone or Home Assistant's LD2410 BLE integration is not already connected. The module accepts one Bluetooth connection at a time.

1. Set the maximum moving and still gates. Each gate adds about 0.75m, so a maximum of 4 stops detection at roughly 3–3.75m; walk the edge to confirm.
2. Leave the room empty for a minute and note which gates show energy with nobody there.
3. Raise those gates' thresholds above the empty-room level.
4. Sit in your usual spot and hold still; check the still energy of that gate clears its threshold.
5. Set the no-one timeout, then save.

Values go into the module's memory, not the phone. Unplug it, move it to your ESP32 build, and the tuning comes along. ESPHome reads the stored values back and shows them as number entities.

• Fan or curtain in gate 2: raise gate 2's move threshold, leave still alone.
• Next room through a thin wall: lower the maximum gates.
• Dropping out while reading: lower the still threshold of your chair's gate.

For the geometry behind the gate numbers, and how shielding narrows the beam, see the range and field-of-view guide.

Tune in the conditions the room normally has. If the heating fan or a ceiling fan runs in winter, switch it on during the empty-room check, or its gate will trip the sensor later. Doors that stay open, curtains near a draughty window and pets all belong in that test too.

Download the tool and the module manual from Hi-Link's own website, where each radar model has its own resource folder. Then wire the adapter:

• Adapter 5V to sensor VCC, GND to GND.
• Adapter TX to sensor RX, adapter RX to sensor TX.
• Leave OUT unconnected.

In the tool, pick the adapter's COM port and set 256000 baud. Select engineering mode if you want per-gate energy, then connect. Hi-Link's manual notes one quirk: while the live display runs after pressing Start, parameters cannot be read or written. Press Stop, change settings, then start again.

The PC view is handy for a first look at a module before it goes into an enclosure. A test kit with its own cable removes even the adapter wiring. For pin order on each board, keep the pinout reference open next to the tool.

Before you update, ask whether you need to. A sensor that detects reliably gains nothing from new firmware, and ESPHome's documentation ties some entities to specific firmware versions, which cuts both ways.

1. Note the current version in the app or from ESPHome's version text sensor.
2. Power the module from a stable 5V supply, not a sagging USB hub.
3. Keep the phone close and the screen awake for the whole update.
4. Do not interrupt or power-cycle until the app confirms success.
5. Recheck your settings afterwards; restore them if they reset.

The main risk is an interrupted update, whether from a dropped Bluetooth link or a power blip. The original LD2410 has no Bluetooth, so app updates do not apply; check Hi-Link's files for your module before assuming a serial update path exists.

If the update adds 0.2m resolution, remember that gate numbers change meaning. All nine gates then fit inside about 2m, so retune the maximum gates before relying on it.

• ESPHome: every threshold, gate and timeout is a number entity. Change them from the ESPHome dashboard or Home Assistant, from any operating system.
• HLKRadarTool on a phone: for B, B-P and C boards the app covers all tuning, and your desktop OS does not matter.
• Serial scripts: the protocol is documented, so a short Python script with pyserial can send the enable-configuration, set and end-configuration commands at 256000 baud.

Community developers have also built browser-based configurators that use Web Serial or Web Bluetooth in Chromium browsers. They can be handy on Linux and ChromeOS, but they are unofficial; confirm the project supports your firmware and read settings back after writing them.

Once tuned, the ESPHome YAML walkthrough shows how to switch the module's Bluetooth off from Home Assistant.

A Python script is also the quickest way to configure a batch. Wire each module to the same adapter in turn, run the script, and every sensor in a multi-room pack leaves the bench with identical gates and timeout.