This repository contains custom components for ESPHome, a system to control ESP32 devices with simple YAML configuration files.
- HLK-LD2413 - 24GHz mmWave radar liquid level detection sensor
- Notecard - Blues Wireless Notecard IoT modules
- VL53L1X - Time-of-Flight distance sensor
A high-precision liquid level detection sensor using 24GHz millimeter wave radar technology with a detection range of 0.25m to 10.5m and accuracy of ±3mm under optimal conditions. Note that the datasheet says 150mm minimum range, but in reality it's 250mm (under that and it provides nothing back).
This UART component provides support for this advanced mmWave distance sensing product. I developed it specifically for measuring water levels in an underground cistern where traditional ultrasonic sensors struggled with winter temperature variations, darkness, and humidity. The mmWave technology offers superior reliability in challenging environments.
Note that LD2413 is very picky about surroundings and reflections. Enclosures or electronics too close to it can cause it to not provide any readings (or provide inaccurate ones). Always test it solo first to help narrow down any issues.
external_components:
- source: github://Averyy/esphome-custom-components
components: [hlk_ld2413]Resources:
Integration with Blues Wireless Notecard (both cellular and WiFi variants) for IoT connectivity. Features include configurable data collection and sync intervals, automatic data batching, and access to Notecard temperature and battery voltage.
This UART component was developed to transmit magnetic dial gauge readings from a propane tank in a location without WiFi access. The implementation focuses specifically on using the Notecard for data transmission to Notehub, while the ESP32 handles sleep cycles and data filtering for optimal power efficiency.
external_components:
- source: github://Averyy/esphome-custom-components
components: [notecard]Resources:
Integration with the VL53L1X/VL53L4CD Time-of-Flight (ToF) distance sensor. Supports both VL53L1X and VL53L4CD sensors with configurable distance modes and range status reporting.
This I2C component was forked from an existing open source repository after updates caused compatibility issues with my setup. I created this stable version primarily for water level monitoring applications, though I discovered that lens condensation in humid environments could affect reading stability - an important consideration for similar implementations.
external_components:
- source: github://Averyy/esphome-custom-components
components: [vl53l1x]Resources:
- Easy Integration: Simple YAML configuration for complex sensors
- Fully Documented: Comprehensive documentation for each component
- Example Configurations: Ready-to-use example files for quick setup
Using the GitHub repository version means you'll automatically get updates, but it could change at any moment. If stability is critical for your project, consider using the local installation method described in each component's documentation.
This project is licensed under the MIT License with Attribution - see the LICENSE file for details.