# rigor64/iot_esp_sleepsense architecture

> Architecture diagram of the GitHub repository rigor64/iot_esp_sleepsense, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rigor64/iot_esp_sleepsense
- Repository: https://github.com/rigor64/iot_esp_sleepsense

## Overview

SleepSense is an ESP32 sleep-monitoring prototype: its documented workflow is multimodal sensing, local preprocessing, transmission and storage, then sleep-quality analysis. The tree contains sensor/display libraries and an InfluxDB client, but no evident integrated SleepSense application entry point or classifier. The graph therefore distinguishes available library components from README-described stages; documented but unverified integration links are dashed. Source excerpts are partial, so internal wiring beyond the shown references is not asserted.

Main entry points: [`EPS`](https://github.com/rigor64/iot_esp_sleepsense/tree/main/EPS) (Sensor acquisition), [`EPS/libraries/ESP8266_Influxdb/src/InfluxDbClient.cpp`](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/ESP8266_Influxdb/src/InfluxDbClient.cpp) (InfluxDB client), [`EPS/libraries/Adafruit_SSD1306/Adafruit_SSD1306.cpp`](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/Adafruit_SSD1306/Adafruit_SSD1306.cpp) (SSD1306 display), [`EPS/libraries/Adafruit_GFX_Library/Adafruit_GFX.cpp`](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/Adafruit_GFX_Library/Adafruit_GFX.cpp) (Graphics rendering)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_acquisition["Sensor acquisition"]
  node_sensor_stage["Sensor acquisition"]
  node_dht_driver["DHT11 reader<br/>[esp32-dht11.c]"]
  node_dht_library["DHT sensor library<br/>[DHT.cpp]"]
  node_light_sensor["BH1750 light<br/>[BH1750.cpp]"]
  node_motion_sensor["MPU6050 motion<br/>[MPU6050_light.cpp]"]
  node_mpu_library["Adafruit MPU6050"]
end

subgraph group_edge["ESP32 presentation"]
  node_local_processing["Local preprocessing"]
  node_display_driver["SSD1306 display"]
  node_graphics["Graphics rendering<br/>[Adafruit_GFX.cpp]"]
  node_spi_display["SPI display transport"]
  node_bus_io["Bus I/O"]
end

subgraph group_storage["InfluxDB persistence"]
  node_influx_client["InfluxDB client<br/>[InfluxDbClient.cpp]"]
  node_point_data["Point data<br/>[Point.cpp]"]
  node_http_service["HTTP service<br/>[HTTPService.cpp]"]
  node_influx_server[("InfluxDB server")]
  node_query_parser["Flux result parser<br/>[FluxParser.cpp]"]
end

subgraph group_analysis["Sleep analysis"]
  node_classification["Sleep classification"]
  node_future_ml["Future ML analysis"]
  node_dashboard["Future dashboard"]
end

node_environment(("Sleep environment"))

node_environment -.->|"provides readings"| node_sensor_stage
node_sensor_stage -.->|"reads DHT11"| node_dht_driver
node_sensor_stage -.->|"reads humidity"| node_dht_library
node_sensor_stage -.->|"reads light"| node_light_sensor
node_sensor_stage -.->|"reads movement"| node_motion_sensor
node_sensor_stage -.->|"reads movement"| node_mpu_library
node_sensor_stage -.->|"sends readings"| node_local_processing
node_local_processing -.->|"presents locally"| node_display_driver
node_display_driver -.->|"renders graphics"| node_graphics
node_graphics -.->|"draws via"| node_spi_display
node_spi_display -.->|"transfers data"| node_bus_io
node_local_processing -.->|"transmits readings"| node_influx_client
node_influx_client -.->|"serializes points"| node_point_data
node_influx_client -->|"sends requests"| node_http_service
node_http_service -.->|"writes data"| node_influx_server
node_influx_server -.->|"returns query results"| node_query_parser
node_influx_server -.->|"supplies stored data"| node_classification
node_classification -.->|"may extend to"| node_future_ml
node_influx_server -.->|"may visualize data"| node_dashboard

click node_sensor_stage "https://github.com/rigor64/iot_esp_sleepsense/tree/main/EPS"
click node_dht_driver "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/progetti_iot/dht11_test/main/esp32-dht11.c"
click node_dht_library "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/DHT_sensor_library/DHT.cpp"
click node_light_sensor "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/BH1750/src/BH1750.cpp"
click node_motion_sensor "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/MPU6050_light/src/MPU6050_light.cpp"
click node_mpu_library "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/Adafruit_MPU6050/Adafruit_MPU6050.cpp"
click node_local_processing "https://github.com/rigor64/iot_esp_sleepsense/tree/main/EPS"
click node_display_driver "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/Adafruit_SSD1306/Adafruit_SSD1306.cpp"
click node_graphics "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/Adafruit_GFX_Library/Adafruit_GFX.cpp"
click node_spi_display "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/Adafruit_GFX_Library/Adafruit_SPITFT.cpp"
click node_bus_io "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/Adafruit_BusIO/Adafruit_SPIDevice.cpp"
click node_influx_client "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/ESP8266_Influxdb/src/InfluxDbClient.cpp"
click node_point_data "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/ESP8266_Influxdb/src/Point.cpp"
click node_http_service "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/ESP8266_Influxdb/src/HTTPService.cpp"
click node_query_parser "https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/ESP8266_Influxdb/src/query/FluxParser.cpp"
click node_classification "https://github.com/rigor64/iot_esp_sleepsense/tree/main/EPS"
click node_future_ml "https://github.com/rigor64/iot_esp_sleepsense/tree/main/EPS"
click node_dashboard "https://github.com/rigor64/iot_esp_sleepsense/tree/main/EPS"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_sensor_stage,node_dht_driver,node_dht_library,node_light_sensor,node_motion_sensor,node_mpu_library toneBlue
class node_local_processing,node_display_driver,node_graphics,node_spi_display,node_bus_io toneAmber
class node_influx_client,node_point_data,node_http_service,node_influx_server,node_query_parser toneMint
class node_classification,node_future_ml,node_dashboard toneRose
class node_environment toneIndigo
```

## Components

### Sensor acquisition

- [Sensor acquisition](https://github.com/rigor64/iot_esp_sleepsense/tree/main/EPS): `EPS`
- [DHT11 reader](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/progetti_iot/dht11_test/main/esp32-dht11.c): `EPS/progetti_iot/dht11_test/main/esp32-dht11.c`
- [DHT sensor library](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/DHT_sensor_library/DHT.cpp): `EPS/libraries/DHT_sensor_library/DHT.cpp`
- [BH1750 light](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/BH1750/src/BH1750.cpp): `EPS/libraries/BH1750/src/BH1750.cpp`
- [MPU6050 motion](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/MPU6050_light/src/MPU6050_light.cpp): `EPS/libraries/MPU6050_light/src/MPU6050_light.cpp`
- [Adafruit MPU6050](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/Adafruit_MPU6050/Adafruit_MPU6050.cpp): `EPS/libraries/Adafruit_MPU6050/Adafruit_MPU6050.cpp`

### ESP32 presentation

- [Local preprocessing](https://github.com/rigor64/iot_esp_sleepsense/tree/main/EPS): `EPS`
- [SSD1306 display](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/Adafruit_SSD1306/Adafruit_SSD1306.cpp): `EPS/libraries/Adafruit_SSD1306/Adafruit_SSD1306.cpp`
- [Graphics rendering](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/Adafruit_GFX_Library/Adafruit_GFX.cpp): `EPS/libraries/Adafruit_GFX_Library/Adafruit_GFX.cpp`
- [SPI display transport](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/Adafruit_GFX_Library/Adafruit_SPITFT.cpp): `EPS/libraries/Adafruit_GFX_Library/Adafruit_SPITFT.cpp`
- [Bus I/O](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/Adafruit_BusIO/Adafruit_SPIDevice.cpp): `EPS/libraries/Adafruit_BusIO/Adafruit_SPIDevice.cpp`

### InfluxDB persistence

- [InfluxDB client](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/ESP8266_Influxdb/src/InfluxDbClient.cpp): `EPS/libraries/ESP8266_Influxdb/src/InfluxDbClient.cpp`
- [Point data](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/ESP8266_Influxdb/src/Point.cpp): `EPS/libraries/ESP8266_Influxdb/src/Point.cpp`
- [HTTP service](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/ESP8266_Influxdb/src/HTTPService.cpp): `EPS/libraries/ESP8266_Influxdb/src/HTTPService.cpp`
- **InfluxDB server**
- [Flux result parser](https://github.com/rigor64/iot_esp_sleepsense/blob/main/EPS/libraries/ESP8266_Influxdb/src/query/FluxParser.cpp): `EPS/libraries/ESP8266_Influxdb/src/query/FluxParser.cpp`

### Sleep analysis

- [Sleep classification](https://github.com/rigor64/iot_esp_sleepsense/tree/main/EPS): `EPS`
- [Future ML analysis](https://github.com/rigor64/iot_esp_sleepsense/tree/main/EPS): `EPS`
- [Future dashboard](https://github.com/rigor64/iot_esp_sleepsense/tree/main/EPS): `EPS`

### Other components

- **Sleep environment**

## Connections

- Sleep environment → Sensor acquisition: provides readings
- Sensor acquisition → DHT11 reader: reads DHT11 (evidence: `EPS/progetti_iot/dht11_test/main/esp32-dht11.c`)
- Sensor acquisition → DHT sensor library: reads humidity (evidence: `EPS/libraries/DHT_sensor_library/DHT.cpp`)
- Sensor acquisition → BH1750 light: reads light (evidence: `EPS/libraries/BH1750/src/BH1750.cpp`)
- Sensor acquisition → MPU6050 motion: reads movement (evidence: `EPS/libraries/MPU6050_light/src/MPU6050_light.cpp`)
- Sensor acquisition → Adafruit MPU6050: reads movement
- Sensor acquisition → Local preprocessing: sends readings
- Local preprocessing → SSD1306 display: presents locally (evidence: `EPS/libraries/Adafruit_SSD1306/Adafruit_SSD1306.cpp`)
- SSD1306 display → Graphics rendering: renders graphics (evidence: `EPS/libraries/Adafruit_SSD1306/Adafruit_SSD1306.cpp`)
- Graphics rendering → SPI display transport: draws via
- SPI display transport → Bus I/O: transfers data (evidence: `EPS/libraries/Adafruit_GFX_Library/Adafruit_SPITFT.cpp`)
- Local preprocessing → InfluxDB client: transmits readings (evidence: `EPS/libraries/ESP8266_Influxdb/src/InfluxDbClient.cpp`)
- InfluxDB client → Point data: serializes points
- InfluxDB client → HTTP service: sends requests
- HTTP service → InfluxDB server: writes data
- InfluxDB server → Flux result parser: returns query results
- InfluxDB server → Sleep classification: supplies stored data
- Sleep classification → Future ML analysis: may extend to
- InfluxDB server → Future dashboard: may visualize data
