2.6 KiB
2.6 KiB
Home Assistant - ESP Home - LilyGo Diabetes Display
A custom, open-source continuous glucose monitor (CGM) desktop display powered by a LilyGO T-Display-S3 running ESPHome, integrated directly with Home Assistant.
Features
- Real-Time Glucose Display:A CGM data source feeding into Home Assistant (e.g., Nightscout, xDrip+, or LibreLinkUp integr Shows current blood glucose readings (in mmol/L) with trend arrows.
- Data Freshness Warning: Automatically detects if CGM data becomes stale and displays an "OLD" warning with an animated alert icon.
- Clock & Seconds Counter: Displays current local time synchronized via Home Assistant.
Hardware Requirements
- LilyGO T-Display-S3 ESP32-S3 Display Board
- USB-C cable for power and flashing
Setup & Installation Instructions
1. Prerequisites
- A working Home Assistant instance with the ESPHome integration installed.
- A CGM data source feeding into Home Assistant (e.g., Nightscout, xDrip+, or LibreLinkUp integration) creating entities for your blood glucose value and trend icon.
- The following Home Assistant entities:
- Numeric sensor for you blood glucose levels (sensor.blood_sugar_mmol)
- Text/attribute sensor supplying the MDI trend icon (sensor.blood_sugar_trend_icon)
- Binary sensor that evaluates to on when data is fresh and off when stale.
2. Clone or Download the Repository
Clone this repository to your local machine or download it into your ESPHome configuration directory:
git clone https://git.unknownuniverse.uk/unkn/homeassistant-diabetes.git
3. Add Required Assets
Ensure all arrow PNG files and the warning.gif animation are placed inside an images/ directory relative to your ESPHome YAML configuration file, as referenced in the firmware config.
4. Configure Secrets
In your ESPHome secrets file (secrets.yaml), ensure you have defined your Wi-Fi credentials:
wifi_ssid: "Your_WiFi_SSID"
wifi_password: "Your_WiFi_Password"
5. Entity IDs
Open esphome/lilygo-glucose-display.yaml and verify that the Home Assistant entity IDs match your setup:
sensor.blood_sugar_mmol(Your blood glucose numeric sensor)sensor.blood_sugar_trend_icon(Your CGM trend icon sensor)binary_sensor.cgm_data_fresh(Binary sensor indicating whether data is fresh or stale)
6. Compile and Flash
Connect your LilyGO T-Display-S3 via USB and flash the configuration using ESPHome:
esphome run esphome/lilygo-glucose-display.yaml