# jul1an-s/solixble architecture

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

- Interactive diagram: https://gitdiagram.com/jul1an-s/solixble
- Repository: https://github.com/jul1an-s/solixble

## Overview

SolixBLE is a Python library for monitoring and controlling Anker Solix and Prime devices directly over Bluetooth, without cloud services. A user connects to a device; the shared device runtime handles BLE connection, negotiation, packet processing, telemetry, and commands, while model classes interpret device-specific data and expose controls. Prime devices add a specialized protocol layer. The README documents telemetry and control capabilities across power stations, Solarbanks, chargers, and accessories. Unexcerpted model implementations are represented by their exact files, but their internal behavior is not inferred.

Main entry points: [`SolixBLE/device.py`](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/device.py) (Device runtime), [`SolixBLE/prime_device.py`](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/prime_device.py) (Prime protocol), [`SolixBLE/devices`](https://github.com/jul1an-s/solixble/tree/main/SolixBLE/devices) (Power stations), [`SolixBLE/devices/solarbank2.py`](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/solarbank2.py) (Solarbank 2)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public API"]
  node_solixble["SolixBLE API<br/>[__init__.py]"]
end

subgraph group_runtime["BLE Runtime"]
  node_device["Device runtime<br/>[device.py]"]
end

subgraph group_models["Device Models"]
  node_powerstations["Power stations"]
  node_solarbank2["Solarbank 2<br/>[solarbank2.py]"]
  node_solarbank3["Solarbank 3<br/>[solarbank3.py]"]
  node_primechargers["Prime chargers"]
  node_primecharger250["250W charger"]
  node_powerbank["Prime power bank"]
  node_maggo["MagGo accessory<br/>[maggo_3in1.py]"]
  node_generic["Generic model<br/>[generic.py]"]
end

subgraph group_protocol["Protocol Support"]
  node_primebase["Prime protocol<br/>[prime_device.py]"]
  node_states["State enums<br/>[states.py]"]
  node_constants["BLE constants<br/>[const.py]"]
end

node_user(("Library user"))
node_bleak["Bleak BLE"]
node_physical["Solix devices"]

node_user -->|"uses"| node_solixble
node_solixble -->|"exports"| node_device
node_device -->|"uses BLE"| node_bleak
node_bleak -->|"communicates"| node_physical
node_device -->|"reads telemetry"| node_physical
node_device -->|"sends commands"| node_physical
node_powerstations -->|"calls commands"| node_device
node_solarbank2 -->|"extends"| node_device
node_solarbank3 -.->|"extends"| node_device
node_primebase -->|"extends"| node_device
node_primechargers -->|"uses protocol"| node_primebase
node_primecharger250 -->|"uses protocol"| node_primebase
node_powerbank -->|"uses protocol"| node_primebase
node_maggo -->|"uses protocol"| node_primebase
node_generic -->|"extends"| node_device
node_powerstations -->|"uses enums"| node_states
node_solarbank2 -->|"uses enums"| node_states
node_device -->|"uses settings"| node_constants

click node_solixble "https://github.com/jul1an-s/solixble/blob/main/SolixBLE/__init__.py"
click node_device "https://github.com/jul1an-s/solixble/blob/main/SolixBLE/device.py"
click node_powerstations "https://github.com/jul1an-s/solixble/tree/main/SolixBLE/devices"
click node_solarbank2 "https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/solarbank2.py"
click node_solarbank3 "https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/solarbank3.py"
click node_primebase "https://github.com/jul1an-s/solixble/blob/main/SolixBLE/prime_device.py"
click node_primechargers "https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/prime_charger_160w.py"
click node_primecharger250 "https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/prime_charger_250w.py"
click node_powerbank "https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/prime_power_bank_20k.py"
click node_maggo "https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/maggo_3in1.py"
click node_generic "https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/generic.py"
click node_states "https://github.com/jul1an-s/solixble/blob/main/SolixBLE/states.py"
click node_constants "https://github.com/jul1an-s/solixble/blob/main/SolixBLE/const.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_solixble,node_user toneBlue
class node_device toneAmber
class node_powerstations,node_solarbank2,node_solarbank3,node_primechargers,node_primecharger250,node_powerbank,node_maggo,node_generic toneMint
class node_primebase,node_states,node_constants toneRose
class node_bleak,node_physical toneIndigo
```

## Components

### Public API

- [SolixBLE API](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/__init__.py): `SolixBLE/__init__.py`

### BLE Runtime

- [Device runtime](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/device.py): `SolixBLE/device.py`

### Device Models

- [Power stations](https://github.com/jul1an-s/solixble/tree/main/SolixBLE/devices): `SolixBLE/devices`
- [Solarbank 2](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/solarbank2.py): `SolixBLE/devices/solarbank2.py`
- [Solarbank 3](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/solarbank3.py): `SolixBLE/devices/solarbank3.py`
- [Prime chargers](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/prime_charger_160w.py): `SolixBLE/devices/prime_charger_160w.py`
- [250W charger](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/prime_charger_250w.py): `SolixBLE/devices/prime_charger_250w.py`
- [Prime power bank](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/prime_power_bank_20k.py): `SolixBLE/devices/prime_power_bank_20k.py`
- [MagGo accessory](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/maggo_3in1.py): `SolixBLE/devices/maggo_3in1.py`
- [Generic model](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/devices/generic.py): `SolixBLE/devices/generic.py`

### Protocol Support

- [Prime protocol](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/prime_device.py): `SolixBLE/prime_device.py`
- [State enums](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/states.py): `SolixBLE/states.py`
- [BLE constants](https://github.com/jul1an-s/solixble/blob/main/SolixBLE/const.py): `SolixBLE/const.py`

### Other components

- **Library user**
- **Bleak BLE**
- **Solix devices**

## Connections

- Library user → SolixBLE API: uses (evidence: `README.md`)
- SolixBLE API → Device runtime: exports (evidence: `SolixBLE/__init__.py`)
- Device runtime → Bleak BLE: uses BLE (evidence: `README.md`)
- Bleak BLE → Solix devices: communicates (evidence: `README.md`)
- Device runtime → Solix devices: reads telemetry (evidence: `SolixBLE/device.py`)
- Device runtime → Solix devices: sends commands (evidence: `SolixBLE/device.py`)
- Power stations → Device runtime: calls commands (evidence: `SolixBLE/devices/c300.py`)
- Solarbank 2 → Device runtime: extends (evidence: `SolixBLE/devices/solarbank2.py`)
- Solarbank 3 → Device runtime: extends (evidence: `SolixBLE/devices/solarbank3.py`)
- Prime protocol → Device runtime: extends (evidence: `SolixBLE/prime_device.py`)
- Prime chargers → Prime protocol: uses protocol (evidence: `SolixBLE/devices/prime_charger_160w.py`)
- 250W charger → Prime protocol: uses protocol (evidence: `SolixBLE/devices/prime_charger_250w.py`)
- Prime power bank → Prime protocol: uses protocol (evidence: `SolixBLE/devices/prime_power_bank_20k.py`)
- MagGo accessory → Prime protocol: uses protocol (evidence: `SolixBLE/devices/maggo_3in1.py`)
- Generic model → Device runtime: extends (evidence: `SolixBLE/devices/generic.py`)
- Power stations → State enums: uses enums (evidence: `SolixBLE/devices/c300.py`)
- Solarbank 2 → State enums: uses enums (evidence: `SolixBLE/devices/solarbank2.py`)
- Device runtime → BLE constants: uses settings (evidence: `SolixBLE/device.py`)
