Update README.md
This commit is contained in:
1 parent
bed5d29c4d
commit
45ef5680e4
1 file changed
+4
-38
@@ -6,59 +6,25 @@ A custom, open-source continuous glucose monitor (CGM) desktop display and alarm
|
|||||||
|
|
||||||
- **Real-Time Glucose Display:** Shows current blood glucose readings (in mmol/L) with trend arrows.
|
- **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.
|
- **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.
|
- **Clock & Seconds Counter:** Displays current local time synchronized via Home Assistant.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Hardware Requirements
|
## Hardware Requirements
|
||||||
|
|
||||||
- LilyGO T-Display-S3 ESP32-S3 Display Board
|
- 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
|
- 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
|
|
||||||
|
|
||||||
```text
|
|
||||||
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
|
## Setup & Installation Instructions
|
||||||
|
|
||||||
### 1. Prerequisites
|
### 1. Prerequisites
|
||||||
- A working **Home Assistant** instance with the **ESPHome** integration installed.
|
- 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.
|
- 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
|
### 2. Clone or Download the Repository
|
||||||
Clone this repository to your local machine or download it into your ESPHome configuration directory:
|
Clone this repository to your local machine or download it into your ESPHome configuration directory:
|
||||||
|
|||||||
Reference in new issue
Block a user