Home

AmbiSense Wiki

AmbiSense is a radar-controlled LED system that lights up the strip nearest your position as you move. Think hallway / staircase / under-bed lighting that follows you, tunable to your taste through a phone-friendly web UI.

This wiki documents the v6.x line (single-sensor architecture). For the older Arduino-era v5 line and the dual-device v6.0 release, see Version History.

⚡ Latest release

v6.2.0-alpha.2 — SmartGhar HA integration contract (pre-release) — AmbiSense now auto-discovers in Home Assistant via the SmartGhar custom integration, alongside any other Techposts devices on the same network. Multiple AmbiSense units coexist as separate HA devices automatically. See Home Assistant Integration.

Earlier in the v6.x series: presence detection + LD2410(C) drivers (v6.2.0-alpha.1), Wi-Fi onboarding UX overhaul (v6.1.0-alpha.2/alpha.3), single-sensor architecture pivot (v6.1.0-alpha.1).

v6.0.0 (current main) remains the stable dual-device release until v6.2 stable ships and merges.

What's new in v6.x

• Single-sensor architecture. One ESP32-C3 + one HiLink LD2450 per install. No more pairing two devices, no ESP-NOW round-trip lag, no "which device is the master?" install friction. The LD2450's (x, y, speed) target stream from a single sensor at the inside corner of an L or centre-back of a U covers both arms inside its 60° cone.
• Six-screen web UI. Live · LEDs · Motion · Hardware · Network · System. The Mesh tab is gone; everything you need is local.
• Kalman motion smoother. Three intuitive knobs (Response, Look-ahead, Outlier rejection) replace v5's five cryptic gain values. Advanced PI gains still available.
• 20 Hz live telemetry over WebSocket — the distance graph on the Live tab updates smoothly instead of stair-stepping.
• OTA with rollback. Drag-drop a .bin in the System tab. If the new firmware doesn't boot cleanly, the bootloader reverts.

See full release notes →

Wiki navigation

Page	When to read
Getting Started	First time — buy parts, flash, first boot, web UI
Hardware Setup	Wiring details, board options, power supply
LD2450 Mounting Guide	Critical for v6.x — where to physically mount the sensor
Web UI Tour	Every screen and every control explained
LED Modes	All 11 light modes with use cases
Motion Smoothing	How to tune Kalman or PI smoother for your room
OTA and Updates	How to update firmware over Wi-Fi
Troubleshooting	Common issues and the fix ladder
FAQ	"Why is X gone?" / "Can it do Y?"
Migration from v6.0	If you were running the dual-device build
Architecture Overview	For tinkerers — how the firmware is structured
Version History	v3 → v4 → v5 → v6.0 → v6.x evolution
License and Credits	Open source license, third-party credits

Source code and developer docs

The wiki is for users. If you're building from source, modifying firmware, or proposing architectural changes, the developer-facing docs in the repo go deeper:

• docs/V6-ARCHITECTURE.md — locked architectural decisions
• docs/V6-ROADMAP.md — what's planned next
• docs/HARDWARE.md — exhaustive wiring + troubleshooting reference

Quick links

• Latest release
• All releases
• Issue tracker
• Repository
• v6-idf-rewrite branch — active development