Skip to main content

Python module for monitoring & controlling Bluetooth Anker Solix devices

Project description

SolixBLE

PyPI Status Black

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

This Python module enables you to monitor and control (some) 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 or control the device.

Features

  • 🔋 Battery percentage
  • ⚡ Total Power In/Out
  • 🎛️ AC/DC output control
  • 🔌 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 & control
  • 🖥️ Display status & control
  • 🔂 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
  • C800(X)
  • C1000(X)
  • C1000 Gen 2
  • F2000 (767 PowerHouse)
  • F3800
  • Solarbank 2
  • Solarbank 3
  • Prime Charger 160w
  • Prime Charger 250w
  • Potentially more!

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
    • 15.7

Installation

PIP

pip install SolixBLE

Adding support for new devices

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

Disclaimer

SolixBLE is a software library designed to work with Anker Solix/Prime devices. ANKER is a registered trademark of Anker Innovations Limited. This project is not affiliated with, endorsed by, or sponsored by Anker Innovations Limited (Though I wouldn't mind being sponsored 😉). All other trademarks cited herein are the property of their respective owners.

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.8.0.tar.gz (50.6 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.8.0-py3-none-any.whl (48.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for solixble-3.8.0.tar.gz
Algorithm Hash digest
SHA256 8a4fe6b0649317ef7101d9570e0437eb31e9b489dfa3d9d6d5595c8a5da4a985
MD5 1d0fa545a712c5a5221b8755db9779f4
BLAKE2b-256 38f28e2b8e98392325162d49b80d91955ed9a9aa5085f21d88849a832486c162

See more details on using hashes here.

Provenance

The following attestation bundles were made for solixble-3.8.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.8.0-py3-none-any.whl.

File metadata

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

File hashes

Hashes for solixble-3.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5cd0d3b97ac494c87012ada497eb7eb671a9d53391e65b987eecd69c5468d051
MD5 3c904eae94e48ed66e7596dc7012f602
BLAKE2b-256 6e26ac4fed118571e29179018e9bc4b13aa781242d9d36bb3f94e4311749a183

See more details on using hashes here.

Provenance

The following attestation bundles were made for solixble-3.8.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