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 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 power stations. 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 (Exl C1000)
  • ⏰ AC/DC Timer value (Exl DC on C1000)
  • ⏲️ Time remaining to full/empty
  • ☀️ Solar Power In
  • 💻 USB Port Power
  • 📱 USB Port Status (Exl C1000)
  • ⚙️ Software version
  • 🩺 Battery health (Exl C300)
  • 🌡️ Battery temperature
  • ↔️ Expansion batteries (Charge, Temperature, Health, Firmware)
  • 💡 Light bar status (Exl C1000)
  • 🔂 Simple structure
  • ✔️ More emojis than strictly necessary

Supported Devices

  • C300(X)
  • C1000(X)
  • 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.1.0.tar.gz (12.5 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.1.0-py3-none-any.whl (12.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for solixble-3.1.0.tar.gz
Algorithm Hash digest
SHA256 24e87e5bdde4ad282f19863206cd52bf57639bd77d698a5692b2e19fe8ee66b3
MD5 216b9faa8b213804704c102bb2e794a3
BLAKE2b-256 deb4a3701b674407828df42689e2185f8250473d1650432cd7966bc124bac16f

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: solixble-3.1.0-py3-none-any.whl
  • Upload date:
  • Size: 12.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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ce5d9fcd7a1fa2af7d1fd1301890f639d3f23b45a6d278d147b6354ef25d9ea2
MD5 cb20007c427ef171935960a983e157c7
BLAKE2b-256 2cfad592bf12b97ee06712b6a14d6ba04a1275e5f7689bda6e883e7ca705f72b

See more details on using hashes here.

Provenance

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