# autosteve/acmqtt architecture

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

- Interactive diagram: https://gitdiagram.com/autosteve/acmqtt
- Repository: https://github.com/autosteve/acmqtt

## Overview

acMqtt is a Lua integration for C-Bus Automation Controllers: configured C-Bus objects are exposed to Home Assistant through MQTT, while optional scripts integrate Hue and other devices. The main documented workflow is keyword-based C-Bus discovery and control; a separate resident script can monitor and restart the integration scripts. Source excerpts were unavailable, so relationships below rely on README statements and do not describe unsampled implementation details.

Main entry points: [`MQTT send receive.lua`](https://github.com/autosteve/acmqtt/blob/master/MQTT%20send%20receive.lua) (MQTT bridge), [`HUE send receive.lua`](https://github.com/autosteve/acmqtt/blob/master/HUE%20send%20receive.lua) (Hue bridge), [`Heartbeat.lua`](https://github.com/autosteve/acmqtt/blob/master/Heartbeat.lua) (Heartbeat monitor), [`outsideenv.yaml`](https://github.com/autosteve/acmqtt/blob/master/outsideenv.yaml) (Environment examples)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cbus["C-Bus runtime"]
  node_controller["C-Bus controller"]
  node_keywords["Object keywords"]
  node_cbus_apps["C-Bus applications"]
  node_mqtt_script["MQTT bridge"]
end

subgraph group_ha["Home Assistant and MQTT"]
  node_ha["Home Assistant"]
  node_broker["MQTT broker"]
  node_discovery["MQTT discovery"]
  node_ha_entities["HA entities"]
end

subgraph group_integrations["Optional integrations"]
  node_hue_script["Hue bridge"]
  node_hue_hub["Philips Hue hub"]
  node_esphome["ESPHome devices"]
  node_environment_examples["Environment examples<br/>[outsideenv.yaml]"]
  node_store_example["Store example<br/>[storeac.yaml]"]
  node_panasonic["Panasonic A/C"]
  node_airtopia["Airtopia I/R"]
end

subgraph group_operations["Script operations"]
  node_heartbeat["Heartbeat monitor<br/>[Heartbeat.lua]"]
end

node_keywords -->|"configures discovery"| node_mqtt_script
node_mqtt_script -->|"monitors objects"| node_controller
node_mqtt_script -->|"supports applications"| node_cbus_apps
node_mqtt_script -->|"uses MQTT"| node_broker
node_mqtt_script -->|"publishes discovery"| node_discovery
node_discovery -->|"enables discovery"| node_ha
node_ha -->|"uses MQTT"| node_broker
node_ha -->|"sends commands"| node_mqtt_script
node_mqtt_script -->|"exposes entities"| node_ha_entities
node_hue_script -->|"integrates devices"| node_hue_hub
node_hue_script -->|"adds Hue to scenes"| node_controller
node_mqtt_script -->|"supports sensors"| node_esphome
node_environment_examples -->|"configures examples"| node_esphome
node_mqtt_script -->|"supports A/C"| node_panasonic
node_panasonic -->|"integrates via"| node_esphome
node_mqtt_script -->|"supports blasters"| node_airtopia
node_heartbeat -->|"monitors and restarts"| node_mqtt_script
node_heartbeat -->|"monitors and restarts"| node_hue_script

click node_mqtt_script "https://github.com/autosteve/acmqtt/blob/master/MQTT%20send%20receive.lua"
click node_discovery "https://github.com/autosteve/acmqtt/blob/master/MQTT%20send%20receive.lua"
click node_ha_entities "https://github.com/autosteve/acmqtt/blob/master/MQTT%20send%20receive.lua"
click node_hue_script "https://github.com/autosteve/acmqtt/blob/master/HUE%20send%20receive.lua"
click node_environment_examples "https://github.com/autosteve/acmqtt/blob/master/outsideenv.yaml"
click node_store_example "https://github.com/autosteve/acmqtt/blob/master/storeac.yaml"
click node_heartbeat "https://github.com/autosteve/acmqtt/blob/master/Heartbeat.lua"

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_controller,node_keywords,node_cbus_apps,node_mqtt_script toneBlue
class node_ha,node_broker,node_discovery,node_ha_entities toneAmber
class node_hue_script,node_hue_hub,node_esphome,node_environment_examples,node_store_example,node_panasonic,node_airtopia toneMint
class node_heartbeat toneRose
```

## Components

### C-Bus runtime

- **C-Bus controller**
- **Object keywords**
- **C-Bus applications**
- [MQTT bridge](https://github.com/autosteve/acmqtt/blob/master/MQTT%20send%20receive.lua): `MQTT send receive.lua`

### Home Assistant and MQTT

- **Home Assistant**
- **MQTT broker**
- [MQTT discovery](https://github.com/autosteve/acmqtt/blob/master/MQTT%20send%20receive.lua): `MQTT send receive.lua`
- [HA entities](https://github.com/autosteve/acmqtt/blob/master/MQTT%20send%20receive.lua): `MQTT send receive.lua`

### Optional integrations

- [Hue bridge](https://github.com/autosteve/acmqtt/blob/master/HUE%20send%20receive.lua): `HUE send receive.lua`
- **Philips Hue hub**
- **ESPHome devices**
- [Environment examples](https://github.com/autosteve/acmqtt/blob/master/outsideenv.yaml): `outsideenv.yaml`
- [Store example](https://github.com/autosteve/acmqtt/blob/master/storeac.yaml): `storeac.yaml`
- **Panasonic A/C**
- **Airtopia I/R**

### Script operations

- [Heartbeat monitor](https://github.com/autosteve/acmqtt/blob/master/Heartbeat.lua): `Heartbeat.lua`

## Connections

- Object keywords → MQTT bridge: configures discovery (evidence: `README.md`)
- MQTT bridge → C-Bus controller: monitors objects (evidence: `README.md`)
- MQTT bridge → C-Bus applications: supports applications (evidence: `README.md`)
- MQTT bridge → MQTT broker: uses MQTT (evidence: `README.md`)
- MQTT bridge → MQTT discovery: publishes discovery (evidence: `README.md`)
- MQTT discovery → Home Assistant: enables discovery (evidence: `README.md`)
- Home Assistant → MQTT broker: uses MQTT (evidence: `README.md`)
- Home Assistant → MQTT bridge: sends commands (evidence: `README.md`)
- MQTT bridge → HA entities: exposes entities (evidence: `README.md`)
- Hue bridge → Philips Hue hub: integrates devices (evidence: `README.md`)
- Hue bridge → C-Bus controller: adds Hue to scenes (evidence: `README.md`)
- MQTT bridge → ESPHome devices: supports sensors (evidence: `README.md`)
- Environment examples → ESPHome devices: configures examples (evidence: `README.md`)
- MQTT bridge → Panasonic A/C: supports A/C (evidence: `README.md`)
- Panasonic A/C → ESPHome devices: integrates via (evidence: `README.md`)
- MQTT bridge → Airtopia I/R: supports blasters (evidence: `README.md`)
- Heartbeat monitor → MQTT bridge: monitors and restarts (evidence: `README.md`)
- Heartbeat monitor → Hue bridge: monitors and restarts (evidence: `README.md`)
