# davalav/d7065e architecture

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

- Interactive diagram: https://gitdiagram.com/davalav/d7065e
- Repository: https://github.com/davalav/d7065e

## Overview

D7065E simulates building-room conditions and controls heating and ventilation using room sensors, occupancy schedules, PID decisions, and actuators. Its main loop gathers readings, computes control commands, applies them to BuildSim, and advances room physics; a separate metrics path exposes simulation readings to Prometheus and Grafana. README documentation establishes the principal runtime relationships; some MQTT wiring and monitoring configuration are not shown in source excerpts, so those links are documented or marked unverified.

Main entry points: [`con-dec.py`](https://github.com/davalav/d7065e/blob/main/con-dec.py) (PID Controller), [`con-sim.py`](https://github.com/davalav/d7065e/blob/main/con-sim.py) (Room Physics), [`con-hvac.py`](https://github.com/davalav/d7065e/blob/main/con-hvac.py) (HVAC Actuator), [`con-vent.py`](https://github.com/davalav/d7065e/blob/main/con-vent.py) (Ventilation Actuator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Room Inputs"]
  node_occupancy["Occupancy Publisher<br/>[con-occ.py]"]
  node_sensors["Room Sensors<br/>[con-sensor.py]"]
  node_occupancysim["Occupancy Simulator"]
end

subgraph group_control["Control"]
  node_decision["PID Controller<br/>[con-dec.py]"]
  node_safety["Control Safety<br/>[control_safety.py]"]
  node_hvac["HVAC Actuator<br/>[con-hvac.py]"]
  node_ventilation["Ventilation Actuator<br/>[con-vent.py]"]
  node_mqtt["MQTT Broker"]
end

subgraph group_simulation["Building Simulation"]
  node_physics["Room Physics<br/>[con-sim.py]"]
  node_buildsim["BuildSim"]
end

subgraph group_monitoring["Monitoring"]
  node_exporter["Metrics Exporter"]
  node_prometheus["Prometheus"]
  node_grafana["Grafana Dashboard"]
end

subgraph group_configuration["Room Configuration"]
  node_roomconfig["Room Configuration<br/>[room_config.py]"]
end

node_operator(("Operator"))

node_operator -->|"starts simulation"| node_buildsim
node_occupancy -->|"publishes occupancy"| node_buildsim
node_occupancysim -->|"provides schedule"| node_occupancy
node_sensors -.->|"publishes readings"| node_mqtt
node_mqtt -.->|"delivers readings"| node_decision
node_decision -->|"checks sensor and actuator health"| node_safety
node_decision -.->|"publishes commands"| node_mqtt
node_mqtt -.->|"delivers commands"| node_hvac
node_mqtt -.->|"delivers commands"| node_ventilation
node_hvac -->|"applies heating"| node_buildsim
node_ventilation -->|"applies ventilation"| node_buildsim
node_hvac -->|"confirms applied output"| node_decision
node_ventilation -->|"confirms applied output"| node_decision
node_physics -->|"reads room state"| node_buildsim
node_physics -->|"updates room state"| node_buildsim
node_physics -.->|"publishes sensor readings"| node_mqtt
node_roomconfig -->|"selects simulated rooms"| node_decision
node_roomconfig -->|"selects simulated rooms"| node_physics
node_exporter -->|"reads equipment"| node_buildsim
node_exporter -->|"reads simulator clock"| node_occupancysim
node_prometheus -->|"scrapes metrics"| node_exporter
node_grafana -->|"queries metrics"| node_prometheus
node_operator -->|"views dashboard"| node_grafana

click node_occupancy "https://github.com/davalav/d7065e/blob/main/con-occ.py"
click node_sensors "https://github.com/davalav/d7065e/blob/main/con-sensor.py"
click node_decision "https://github.com/davalav/d7065e/blob/main/con-dec.py"
click node_safety "https://github.com/davalav/d7065e/blob/main/control_safety.py"
click node_hvac "https://github.com/davalav/d7065e/blob/main/con-hvac.py"
click node_ventilation "https://github.com/davalav/d7065e/blob/main/con-vent.py"
click node_physics "https://github.com/davalav/d7065e/blob/main/con-sim.py"
click node_roomconfig "https://github.com/davalav/d7065e/blob/main/room_config.py"
click node_exporter "https://github.com/davalav/d7065e/blob/main/metrics-exporter.py"

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_occupancy,node_sensors,node_occupancysim toneBlue
class node_decision,node_safety,node_hvac,node_ventilation,node_mqtt toneAmber
class node_physics,node_buildsim toneMint
class node_exporter,node_prometheus,node_grafana toneRose
class node_roomconfig,node_operator toneIndigo
```

## Components

### Room Inputs

- [Occupancy Publisher](https://github.com/davalav/d7065e/blob/main/con-occ.py): `con-occ.py`
- [Room Sensors](https://github.com/davalav/d7065e/blob/main/con-sensor.py): `con-sensor.py`
- **Occupancy Simulator**

### Control

- [PID Controller](https://github.com/davalav/d7065e/blob/main/con-dec.py): `con-dec.py`
- [Control Safety](https://github.com/davalav/d7065e/blob/main/control_safety.py): `control_safety.py`
- [HVAC Actuator](https://github.com/davalav/d7065e/blob/main/con-hvac.py): `con-hvac.py`
- [Ventilation Actuator](https://github.com/davalav/d7065e/blob/main/con-vent.py): `con-vent.py`
- **MQTT Broker**

### Building Simulation

- [Room Physics](https://github.com/davalav/d7065e/blob/main/con-sim.py): `con-sim.py`
- **BuildSim**

### Monitoring

- [Metrics Exporter](https://github.com/davalav/d7065e/blob/main/metrics-exporter.py): `metrics-exporter.py`
- **Prometheus**
- **Grafana Dashboard**

### Room Configuration

- [Room Configuration](https://github.com/davalav/d7065e/blob/main/room_config.py): `room_config.py`

### Other components

- **Operator**

## Connections

- Operator → BuildSim: starts simulation (evidence: `README.md`)
- Occupancy Publisher → BuildSim: publishes occupancy (evidence: `README.md`)
- Occupancy Simulator → Occupancy Publisher: provides schedule (evidence: `README.md`)
- Room Sensors → MQTT Broker: publishes readings
- MQTT Broker → PID Controller: delivers readings
- PID Controller → Control Safety: checks sensor and actuator health (evidence: `con-dec.py`)
- PID Controller → MQTT Broker: publishes commands
- MQTT Broker → HVAC Actuator: delivers commands
- MQTT Broker → Ventilation Actuator: delivers commands
- HVAC Actuator → BuildSim: applies heating (evidence: `README.md`)
- Ventilation Actuator → BuildSim: applies ventilation (evidence: `README.md`)
- HVAC Actuator → PID Controller: confirms applied output (evidence: `README.md`)
- Ventilation Actuator → PID Controller: confirms applied output (evidence: `README.md`)
- Room Physics → BuildSim: reads room state (evidence: `con-sim.py`)
- Room Physics → BuildSim: updates room state (evidence: `README.md`)
- Room Physics → MQTT Broker: publishes sensor readings
- Room Configuration → PID Controller: selects simulated rooms (evidence: `con-dec.py`)
- Room Configuration → Room Physics: selects simulated rooms (evidence: `con-sim.py`)
- Metrics Exporter → BuildSim: reads equipment (evidence: `metrics-exporter.py`)
- Metrics Exporter → Occupancy Simulator: reads simulator clock (evidence: `metrics-exporter.py`)
- Prometheus → Metrics Exporter: scrapes metrics (evidence: `README.md`)
- Grafana Dashboard → Prometheus: queries metrics (evidence: `README.md`)
- Operator → Grafana Dashboard: views dashboard (evidence: `README.md`)
