# pho3nix90/solis_modbus architecture

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

- Interactive diagram: https://gitdiagram.com/pho3nix90/solis_modbus
- Repository: https://github.com/pho3nix90/solis_modbus

## Overview

Solis Modbus is a Home Assistant custom integration for monitoring and controlling Solis inverters over Modbus TCP, serial RTU, or RTU-over-TCP. Users configure a connection and inverter; the integration creates entities, polls register groups, and exposes readings and controls in Home Assistant. The README also documents dispatch, scheduling, multiple poll profiles, dual meters, and inverter-specific telemetry. The graph reflects documented capabilities, but unsampled implementation details and some runtime wiring are represented only where the excerpts or source index support them.

Main entry points: [`custom_components/solis_modbus/modbus_controller.py`](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/modbus_controller.py) (Modbus controller), [`custom_components/solis_modbus/__init__.py`](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/__init__.py) (Integration lifecycle), [`custom_components/solis_modbus/sensors/solis_base_sensor.py`](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/sensors/solis_base_sensor.py) (Base sensor model), [`custom_components/solis_modbus/client_manager.py`](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/client_manager.py) (Client manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup and lifecycle"]
  node_config_flow["Connection setup<br/>[config_flow.py]"]
  node_config_model["Inverter options<br/>[solis_config.py]"]
  node_integration["Integration lifecycle<br/>[__init__.py]"]
  node_runtime["Polling runtime<br/>[runtime.py]"]
  node_diagnostics["Diagnostics<br/>[diagnostics.py]"]
end

subgraph group_communications["Modbus communications"]
  node_controller["Modbus controller"]
  node_clients["Client manager<br/>[client_manager.py]"]
  node_serial_proxy["Serial proxy client<br/>[serial_proxy.py]"]
  node_framer["RTU framing<br/>[rtu_framer.py]"]
end

subgraph group_telemetry["Telemetry and entities"]
  node_poller["Register polling<br/>[data_retrieval.py]"]
  node_definitions["Sensor definitions"]
  node_base_sensor["Base sensor model"]
  node_sensor_entities["Sensor entities<br/>[solis_sensor.py]"]
  node_derived["Derived telemetry"]
  node_status_map["Status mapping<br/>[status_mapping.py]"]
end

subgraph group_controls["Controls and services"]
  node_controls["Control entities"]
  node_time_entities["Time entities<br/>[time.py]"]
  node_services["Services and dispatch<br/>[__init__.py]"]
end

node_user(("Home Assistant user"))
node_ha["Home Assistant"]
node_inverter["Solis inverter"]

node_user -->|"configures"| node_config_flow
node_config_flow -->|"builds options"| node_config_model
node_ha -->|"loads integration"| node_integration
node_integration -->|"sets up controller"| node_controller
node_integration -->|"creates sensors"| node_base_sensor
node_integration -->|"uses definitions"| node_definitions
node_runtime -->|"starts polling"| node_poller
node_runtime -->|"uses controller"| node_controller
node_poller -->|"reads registers"| node_controller
node_controller -->|"gets client"| node_clients
node_clients -->|"creates proxy"| node_serial_proxy
node_clients -->|"uses framing"| node_framer
node_controller -->|"reads and writes"| node_inverter
node_poller -->|"publishes readings"| node_base_sensor
node_base_sensor -->|"backs entities"| node_sensor_entities
node_base_sensor -->|"feeds calculations"| node_derived
node_derived -->|"maps status"| node_status_map
node_controller -->|"writes controls"| node_controls
node_controller -->|"writes time"| node_time_entities
node_ha -->|"invokes services"| node_services
node_services -->|"dispatches writes"| node_controller
node_ha -.->|"requests diagnostics"| node_diagnostics

click node_config_flow "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/config_flow.py"
click node_config_model "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/data/solis_config.py"
click node_integration "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/__init__.py"
click node_runtime "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/runtime.py"
click node_poller "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/data_retrieval.py"
click node_controller "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/modbus_controller.py"
click node_clients "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/client_manager.py"
click node_serial_proxy "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/serial_proxy.py"
click node_framer "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/rtu_framer.py"
click node_definitions "https://github.com/pho3nix90/solis_modbus/tree/master/custom_components/solis_modbus/sensor_data"
click node_base_sensor "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/sensors/solis_base_sensor.py"
click node_sensor_entities "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/sensors/solis_sensor.py"
click node_derived "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/sensors/solis_derived_sensor.py"
click node_status_map "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/data/status_mapping.py"
click node_controls "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/sensors/solis_binary_sensor.py"
click node_time_entities "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/time.py"
click node_services "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/__init__.py"
click node_diagnostics "https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/diagnostics.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_config_flow,node_config_model,node_integration,node_runtime,node_diagnostics,node_user toneBlue
class node_controller,node_clients,node_serial_proxy,node_framer toneAmber
class node_poller,node_definitions,node_base_sensor,node_sensor_entities,node_derived,node_status_map toneMint
class node_controls,node_time_entities,node_services toneRose
class node_ha,node_inverter toneIndigo
```

## Components

### Setup and lifecycle

- [Connection setup](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/config_flow.py): `custom_components/solis_modbus/config_flow.py`
- [Inverter options](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/data/solis_config.py): `custom_components/solis_modbus/data/solis_config.py`
- [Integration lifecycle](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/__init__.py): `custom_components/solis_modbus/__init__.py`
- [Polling runtime](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/runtime.py): `custom_components/solis_modbus/runtime.py`
- [Diagnostics](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/diagnostics.py): `custom_components/solis_modbus/diagnostics.py`

### Modbus communications

- [Modbus controller](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/modbus_controller.py): `custom_components/solis_modbus/modbus_controller.py`
- [Client manager](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/client_manager.py): `custom_components/solis_modbus/client_manager.py`
- [Serial proxy client](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/serial_proxy.py): `custom_components/solis_modbus/serial_proxy.py`
- [RTU framing](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/rtu_framer.py): `custom_components/solis_modbus/rtu_framer.py`

### Telemetry and entities

- [Register polling](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/data_retrieval.py): `custom_components/solis_modbus/data_retrieval.py`
- [Sensor definitions](https://github.com/pho3nix90/solis_modbus/tree/master/custom_components/solis_modbus/sensor_data): `custom_components/solis_modbus/sensor_data`
- [Base sensor model](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/sensors/solis_base_sensor.py): `custom_components/solis_modbus/sensors/solis_base_sensor.py`
- [Sensor entities](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/sensors/solis_sensor.py): `custom_components/solis_modbus/sensors/solis_sensor.py`
- [Derived telemetry](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/sensors/solis_derived_sensor.py): `custom_components/solis_modbus/sensors/solis_derived_sensor.py`
- [Status mapping](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/data/status_mapping.py): `custom_components/solis_modbus/data/status_mapping.py`

### Controls and services

- [Control entities](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/sensors/solis_binary_sensor.py): `custom_components/solis_modbus/sensors/solis_binary_sensor.py`
- [Time entities](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/time.py): `custom_components/solis_modbus/time.py`
- [Services and dispatch](https://github.com/pho3nix90/solis_modbus/blob/master/custom_components/solis_modbus/__init__.py): `custom_components/solis_modbus/__init__.py`

### Other components

- **Home Assistant user**
- **Home Assistant**
- **Solis inverter**

## Connections

- Home Assistant user → Connection setup: configures (evidence: `README.md`)
- Connection setup → Inverter options: builds options (evidence: `custom_components/solis_modbus/config_flow.py`)
- Home Assistant → Integration lifecycle: loads integration (evidence: `README.md`)
- Integration lifecycle → Modbus controller: sets up controller (evidence: `custom_components/solis_modbus/__init__.py`)
- Integration lifecycle → Base sensor model: creates sensors (evidence: `custom_components/solis_modbus/__init__.py`)
- Integration lifecycle → Sensor definitions: uses definitions (evidence: `custom_components/solis_modbus/__init__.py`)
- Polling runtime → Register polling: starts polling (evidence: `custom_components/solis_modbus/runtime.py`)
- Polling runtime → Modbus controller: uses controller (evidence: `custom_components/solis_modbus/runtime.py`)
- Register polling → Modbus controller: reads registers (evidence: `custom_components/solis_modbus/data_retrieval.py`)
- Modbus controller → Client manager: gets client (evidence: `custom_components/solis_modbus/modbus_controller.py`)
- Client manager → Serial proxy client: creates proxy (evidence: `custom_components/solis_modbus/client_manager.py`)
- Client manager → RTU framing: uses framing (evidence: `custom_components/solis_modbus/client_manager.py`)
- Modbus controller → Solis inverter: reads and writes (evidence: `README.md`)
- Register polling → Base sensor model: publishes readings (evidence: `custom_components/solis_modbus/data_retrieval.py`)
- Base sensor model → Sensor entities: backs entities (evidence: `custom_components/solis_modbus/sensors/solis_sensor.py`)
- Base sensor model → Derived telemetry: feeds calculations (evidence: `custom_components/solis_modbus/sensors/solis_derived_sensor.py`)
- Derived telemetry → Status mapping: maps status (evidence: `custom_components/solis_modbus/sensors/solis_derived_sensor.py`)
- Modbus controller → Control entities: writes controls (evidence: `custom_components/solis_modbus/sensors/solis_binary_sensor.py`)
- Modbus controller → Time entities: writes time (evidence: `custom_components/solis_modbus/time.py`)
- Home Assistant → Services and dispatch: invokes services (evidence: `README.md`)
- Services and dispatch → Modbus controller: dispatches writes (evidence: `custom_components/solis_modbus/__init__.py`)
- Home Assistant → Diagnostics: requests diagnostics
