How arselzer/solix-link works
SOLIX Link provides local station monitoring and controls through Bluetooth, native MQTT over an isolated AP, a Python CLI/TUI, an optional HTTP/SSE gateway and browser dashboard, and Home Assistant. The main workflow connects to stations, normalizes telemetry, exposes guarded controls, and optionally records history or derives energy estimates; policy previews and fleet/AP management are separate capabilities. A separate Web Bluetooth app explores supported station protocols. Edges are limited to README statements and source-index references; several subsystem implementations were not sampled, so uncertain links are omitted.
Main entry points: server.py HTTP gateway · ap_service.py AP service · connection.ts Browser BLE protocol · manager.py Station manager
Components 27
Station connectivity
- Bluetooth client
python/solix_link/client.py - Station protocol
python/solix_link/protocol.py - AP service
python/solix_link/ap_service.py - MQTT interception
python/solix_link/mqtt_intercept.py - Browser BLE protocol
src/protocol/connection.ts - Telemetry parser
src/protocol/telemetry.ts
Python services
- Station manager
python/solix_link/manager.py - HTTP gateway
python/solix_link/server.py - Scoped access
python/solix_link/access.py - Write coordination
python/solix_link/command_coordination.py - UPS activity
python/solix_link/activity.py - Saved history
python/solix_link/history.py
Controls and energy
- Device commands
python/solix_link/commands.py - Energy estimates
python/solix_link/energy_values.py - Time-of-use plans
python/solix_link/tou.py - Charging policies
python/solix_link/charging_policy.py - Policy controller
python/solix_link/charging_controller.py
User interfaces
- CLI and TUI
python/solix_link/cli.py - Gateway dashboard
dashboard/src/App.vue - Gateway client
dashboard/src/useGateway.ts - Web Bluetooth explorer
src/App.vue
Home Assistant
- HA integration API
custom_components/solix_link/api.py - HA entities
custom_components/solix_link/sensor.py - Native energy entities
custom_components/solix_link/native_energy.py
Other components
- Operator
- SOLIX station
- Isolated AP
Connections 29
- Operator → CLI and TUI: runs
- CLI and TUI → Station manager: manages stations
- Station manager → Bluetooth client: connects over BLE
python/solix_link/manager.py - Bluetooth client → Station protocol: uses protocol
python/solix_link/client.py - Station manager → Device commands: dispatches controls
python/solix_link/manager.py - SOLIX station → Isolated AP: joins locally
- AP service → MQTT interception: uses interception
python/solix_link/ap_service.py - AP service → Station protocol: uses protocol
python/solix_link/ap_service.py - AP service → Time-of-use plans: uses schedules
python/solix_link/ap_service.py - AP service → Device commands: uses commands
python/solix_link/ap_service.py - Operator → HTTP gateway: requests dashboard
- HTTP gateway → Scoped access: authenticates requests
python/solix_link/server.py - HTTP gateway → Write coordination: coordinates writes
python/solix_link/server.py - HTTP gateway → UPS activity: exposes observations
python/solix_link/server.py - HTTP gateway → Saved history: records readings
python/solix_link/server.py - HTTP gateway → Energy estimates: exposes estimates
python/solix_link/server.py - HTTP gateway → Time-of-use plans: serves plans
python/solix_link/server.py - HTTP gateway → Charging policies: serves previews
python/solix_link/server.py - HTTP gateway → Policy controller: serves previews
python/solix_link/server.py - Operator → Gateway dashboard: reviews stations
dashboard/src/App.vue - Gateway dashboard → Gateway client: uses gateway client
dashboard/src/App.vue - Gateway client → HTTP gateway: fetches gateway data
- Operator → HA integration API: configures integration
- HA integration API → Native energy entities: provides native energy
custom_components/solix_link/api.py - HA integration API → HA entities: provides telemetry
- Operator → Web Bluetooth explorer: uses browser app
- Web Bluetooth explorer → Browser BLE protocol: connects to station
src/App.vue - Browser BLE protocol → Telemetry parser: parses telemetry
src/protocol/connection.ts - Browser BLE protocol → SOLIX station: communicates by Bluetooth