Skip to main content

Python module for monitoring Bluetooth Anker Solix devices

Project description

SolixBLE

PyPI Status Black

Python module for monitoring Anker Solix power stations and other devices over Bluetooth.

This Python module enables you to monitor Anker Solix devices directly from your computer, without the need for any cloud services or Anker app. It leverages the Bleak library to interact with Bluetooth Anker Solix devices. No pairing is required in order to receive telemetry data.

Features

  • 🔋 Battery percentage
  • ⚡ Total Power In/Out
  • 🔌 AC Power In/Out
  • 🚗 DC Power In/Out
  • ⏰ AC/DC Timer value
  • ⏲️ Time remaining to full/empty
  • ☀️ Solar Power In
  • 💻 USB Port Power
  • 📱 USB Port Status
  • ⚙️ Firmware version
  • 🩺 Battery health
  • 🌡️ Battery temperature
  • ↔️ Expansion batteries (Charge, Temperature, Health, Firmware)
  • 💡 Light bar status
  • 🔂 Simple structure
  • ✔️ More emojis than strictly necessary

Supported Devices

See the support table in the documentation for feature support for particular devices.

  • C300(X)
  • C300(X) DC
  • C1000(X)
  • C1000 Gen 2
  • F2000 (767 PowerHouse)
  • F3800
  • Solarbank 2
  • Solarbank 3
  • Prime Charger 250w
  • Maybe more? IDK

Requirements

  • 🐍 Python 3.11+
  • 📶 Bleak 0.19.0+
  • 📶 bleak-retry-connector

Supported Operating Systems

  • 🐧 Linux (BlueZ)
    • Ubuntu Desktop
    • Arch (HomeAssistant OS)
  • 🏢 Windows
    • Windows 10
  • 💾 Mac OSX
    • Maybe?

Installation

PIP

pip install SolixBLE

Manual

SolixBLE consists of a single file (SolixBLE.py) which you can simply put in the same directory as your program. If you are using manual installation make sure the dependencies are installed as well.

pip install bleak bleak-retry-connector cryptography pycryptodome

Adding support for new devices

See the Generic class inside SolixBLE.py for guidance on how to add support for new devices.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

solixble-3.2.0.tar.gz (21.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

solixble-3.2.0-py3-none-any.whl (28.9 kB view details)

Uploaded Python 3

File details

Details for the file solixble-3.2.0.tar.gz.

File metadata

  • Download URL: solixble-3.2.0.tar.gz
  • Upload date:
  • Size: 21.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for solixble-3.2.0.tar.gz
Algorithm Hash digest
SHA256 22c7d02605e96ffe3627c0a7c46feb9970484165ca6a684ca1c80118e1510189
MD5 def42c23076c6929acf5320dadd74b1b
BLAKE2b-256 265f5f3dc7b1387d187f1de088b4a4fcae3272be1755a021bc1bbf385fc14167

See more details on using hashes here.

Provenance

The following attestation bundles were made for solixble-3.2.0.tar.gz:

Publisher: publish-to-pypi.yml on flip-dots/SolixBLE

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file solixble-3.2.0-py3-none-any.whl.

File metadata

  • Download URL: solixble-3.2.0-py3-none-any.whl
  • Upload date:
  • Size: 28.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for solixble-3.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3bad039552839e3b26623ba8b657568dca1dca675256ff2a5ce11127aed997c0
MD5 956fb1178538f444d4736ff438f20796
BLAKE2b-256 bc13cb7e57596993160b5a3b06f224df71eec57ac922f76bfa737ee3fadcabd1

See more details on using hashes here.

Provenance

The following attestation bundles were made for solixble-3.2.0-py3-none-any.whl:

Publisher: publish-to-pypi.yml on flip-dots/SolixBLE

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page