2026-10-19 10:31:35 +01:00
2026-10-19 10:15:32 +01:00
2026-10-19 10:35:48 +01:00

Home Assistant Diabetes Display

A custom, open-source continuous glucose monitor (CGM) desktop display and alarm hub powered by a LilyGO T-Display-S3 running ESPHome, integrated directly with Home Assistant.

Features

  • Real-Time Glucose Display: 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.
  • Smart Power Saving: Integrated PIR motion sensor wakes the display when movement is detected.
  • Adaptive Lighting: BH1750 ambient light sensor automatically adjusts display backlight levels based on room lighting.
  • Clock & Seconds Counter: Displays current local time synchronized via Home Assistant.

Hardware Requirements

  • LilyGO T-Display-S3 ESP32-S3 Display Board
  • BH1750 Ambient Light Sensor (I2C)
  • PIR Motion Sensor (GPIO 44)
  • USB-C cable for power and flashing

Wiring Pinout

Component Pin / Connection
I2C SDA (BH1750) GPIO 21
I2C SCL (BH1750) GPIO 16
PIR Motion Sensor GPIO 44
Backlight Control GPIO 38

Repository Structure

homeassistant-diabetes/
├── README.md
├── esphome/
│   └── lilygo-glucose-display.yaml    # ESPHome device configuration
├── images/                            # Required icons, arrows, and warning animations
│   ├── arrow-bottom-right-thick.png
│   ├── arrow-down-thick.png
│   ├── arrow-right-thick.png
│   ├── arrow-top-right-thick.png
│   ├── arrow-up-thick.png
│   ├── chevron-down.png
│   ├── chevron-up.png
│   └── warning.gif
└── docs/
    └── wiring.md                      # Detailed wiring and assembly notes

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.

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. Update 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

License

Distributed under the MIT License. See LICENSE for more information.


Ko-fi

https://unknownuniverse.uk/

S
Description
ESPHome and Home Assistant configuration for a LilyGO blood glucose display with PIR motion sensor and ambient light sensor.
https://unknownuniverse.uk
Readme MIT
61 KiB
0 Stars 1 Watchers 0 Forks