This repository contains an ESPHome component uwb that allows using Makerfabs ESP32 UWB DW3000 devices and setup for real-time precise localization of a device.
For practical use, a minimum of four DW3000 devices are needed:
-
1x DW3000 as
tag: Moving device to be located, -
3x DW3000 as
anchor: Fixed device with known location.
Using UWB distance/range measurements between the tag with (at least) 3 anchors, the location of the tag can be calculated. The tag reports its calculated location to a Home Assistant instance.
|
Note
|
Apple AirTags are not supported! |
For a quick introduction to the essence of ESPHome and Home Assistant configuration, refer to Quick start
For detailed discussion on how tag and anchor communicate to each other and also to Home Assistant, refer to How it works
For detailed documentation of all configuration possibilities in uwb component, for both tag and anchor, refer to Full documentation
For a description on how to perform antenna delay calibration using a tag and an anchor, and how this works in detail, see Antenna delay calibration
An overview about the C++ classes and their purpose is given in Source code documentation
The author’s sources are provided under Apache-2.0 license.
This repository contains a copy of Makerfabs-ESP32-UWB-DW3000 folder Dw3000 licensed under Apache-2.0.