How pho3nix90/solis_modbus works
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: modbus_controller.py Modbus controller · __init__.py Integration lifecycle · solis_base_sensor.py Base sensor model · client_manager.py Client manager
Components 21
Setup and lifecycle
- Connection setup
custom_components/solis_modbus/config_flow.py - Inverter options
custom_components/solis_modbus/data/solis_config.py - Integration lifecycle
custom_components/solis_modbus/__init__.py - Polling runtime
custom_components/solis_modbus/runtime.py - Diagnostics
custom_components/solis_modbus/diagnostics.py
Modbus communications
- Modbus controller
custom_components/solis_modbus/modbus_controller.py - Client manager
custom_components/solis_modbus/client_manager.py - Serial proxy client
custom_components/solis_modbus/serial_proxy.py - RTU framing
custom_components/solis_modbus/rtu_framer.py
Telemetry and entities
- Register polling
custom_components/solis_modbus/data_retrieval.py - Sensor definitions
custom_components/solis_modbus/sensor_data - Base sensor model
custom_components/solis_modbus/sensors/solis_base_sensor.py - Sensor entities
custom_components/solis_modbus/sensors/solis_sensor.py - Derived telemetry
custom_components/solis_modbus/sensors/solis_derived_sensor.py - Status mapping
custom_components/solis_modbus/data/status_mapping.py
Controls and services
- Control entities
custom_components/solis_modbus/sensors/solis_binary_sensor.py - Time entities
custom_components/solis_modbus/time.py - Services and dispatch
custom_components/solis_modbus/__init__.py
Other components
- Home Assistant user
- Home Assistant
- Solis inverter
Connections 22
- Home Assistant user → Connection setup: configures
README.md - Connection setup → Inverter options: builds options
custom_components/solis_modbus/config_flow.py - Home Assistant → Integration lifecycle: loads integration
README.md - Integration lifecycle → Modbus controller: sets up controller
custom_components/solis_modbus/__init__.py - Integration lifecycle → Base sensor model: creates sensors
custom_components/solis_modbus/__init__.py - Integration lifecycle → Sensor definitions: uses definitions
custom_components/solis_modbus/__init__.py - Polling runtime → Register polling: starts polling
custom_components/solis_modbus/runtime.py - Polling runtime → Modbus controller: uses controller
custom_components/solis_modbus/runtime.py - Register polling → Modbus controller: reads registers
custom_components/solis_modbus/data_retrieval.py - Modbus controller → Client manager: gets client
custom_components/solis_modbus/modbus_controller.py - Client manager → Serial proxy client: creates proxy
custom_components/solis_modbus/client_manager.py - Client manager → RTU framing: uses framing
custom_components/solis_modbus/client_manager.py - Modbus controller → Solis inverter: reads and writes
README.md - Register polling → Base sensor model: publishes readings
custom_components/solis_modbus/data_retrieval.py - Base sensor model → Sensor entities: backs entities
custom_components/solis_modbus/sensors/solis_sensor.py - Base sensor model → Derived telemetry: feeds calculations
custom_components/solis_modbus/sensors/solis_derived_sensor.py - Derived telemetry → Status mapping: maps status
custom_components/solis_modbus/sensors/solis_derived_sensor.py - Modbus controller → Control entities: writes controls
custom_components/solis_modbus/sensors/solis_binary_sensor.py - Modbus controller → Time entities: writes time
custom_components/solis_modbus/time.py - Home Assistant → Services and dispatch: invokes services
README.md - Services and dispatch → Modbus controller: dispatches writes
custom_components/solis_modbus/__init__.py - Home Assistant → Diagnostics: requests diagnostics