# veasnacambo/atoms-smart-switch architecture

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

- Interactive diagram: https://gitdiagram.com/veasnacambo/atoms-smart-switch
- Repository: https://github.com/veasnacambo/atoms-smart-switch

## Overview

Atoms Smart Switch is an ESP-IDF retrofit-switch firmware with a stated goal of manual input, relay output, and local wireless control. The visible startup workflow initializes the relay, switch input, app logic, and Wi-Fi manager, then starts the web server; the sampled component implementations are stubs, so their runtime coordination is not established. The graph preserves the documented physical I/O capabilities, but does not infer connections between them and app logic or networking. Hardware is represented only by the repository’s hardware notes; no circuit implementation was sampled.

Main entry points: [`firmware/main/main.c`](https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/main/main.c) (Firmware startup), [`firmware/components/relay/relay.c`](https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/relay/relay.c) (Relay output), [`firmware/components/switch_input/switch_input.c`](https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/switch_input/switch_input.c) (Switch input), [`firmware/components/app_logic/app_logic.c`](https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/app_logic/app_logic.c) (App logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Firmware runtime"]
  node_main["Firmware startup<br/>[main.c]"]
  node_logic["App logic<br/>[app_logic.c]"]
end

subgraph group_connectivity["Local connectivity"]
  node_wifi["Wi-Fi manager<br/>[wifi_manager.c]"]
  node_web["Web server<br/>[web_server.c]"]
end

subgraph group_io["Physical I/O"]
  node_switch["Switch input<br/>[switch_input.c]"]
  node_relay["Relay output<br/>[relay.c]"]
end

node_manual(("Manual switch"))
node_load(("Switched load"))

node_main -->|"initializes"| node_relay
node_main -->|"initializes"| node_switch
node_main -->|"initializes"| node_logic
node_main -->|"initializes"| node_wifi
node_main -->|"starts"| node_web
node_manual -->|"provides input"| node_switch
node_relay -->|"switches"| node_load

click node_main "https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/main/main.c"
click node_logic "https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/app_logic/app_logic.c"
click node_wifi "https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/wifi_manager/wifi_manager.c"
click node_web "https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/web_server/web_server.c"
click node_switch "https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/switch_input/switch_input.c"
click node_relay "https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/relay/relay.c"

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_main,node_logic toneBlue
class node_wifi,node_web toneAmber
class node_switch,node_relay toneMint
class node_manual,node_load toneIndigo
```

## Components

### Firmware runtime

- [Firmware startup](https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/main/main.c): `firmware/main/main.c`
- [App logic](https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/app_logic/app_logic.c): `firmware/components/app_logic/app_logic.c`

### Local connectivity

- [Wi-Fi manager](https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/wifi_manager/wifi_manager.c): `firmware/components/wifi_manager/wifi_manager.c`
- [Web server](https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/web_server/web_server.c): `firmware/components/web_server/web_server.c`

### Physical I/O

- [Switch input](https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/switch_input/switch_input.c): `firmware/components/switch_input/switch_input.c`
- [Relay output](https://github.com/veasnacambo/atoms-smart-switch/blob/main/firmware/components/relay/relay.c): `firmware/components/relay/relay.c`

### Other components

- **Manual switch**
- **Switched load**

## Connections

- Firmware startup → Relay output: initializes (evidence: `firmware/main/main.c`)
- Firmware startup → Switch input: initializes (evidence: `firmware/main/main.c`)
- Firmware startup → App logic: initializes (evidence: `firmware/main/main.c`)
- Firmware startup → Wi-Fi manager: initializes (evidence: `firmware/main/main.c`)
- Firmware startup → Web server: starts (evidence: `firmware/main/main.c`)
- Manual switch → Switch input: provides input (evidence: `README.md`)
- Relay output → Switched load: switches (evidence: `README.md`)
