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.1.tar.gz (17.2 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.1-py3-none-any.whl (17.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: solixble-3.1.1.tar.gz
  • Upload date:
  • Size: 17.2 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.1.tar.gz
Algorithm Hash digest
SHA256 12a87f64b6a2dace7152b242ba83a1c76c4a017856447581cdd13a5685112c3a
MD5 c510df28ec104c3469a06f972a04afde
BLAKE2b-256 9da87c9e9b597a8a8227da878be1f2fec9e0dec263742c59ec51973e7d63fdf2

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: solixble-3.1.1-py3-none-any.whl
  • Upload date:
  • Size: 17.1 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 815f0206caa293732b3b5a1a43f6d376bf16063dbca900014ff144ce0a9606ee
MD5 8fcee06b42d0b692763a6af01447b149
BLAKE2b-256 2dcf4b5e24c99f0e60bf8610fbdd39b87b2cf08b5e8dd2bde1eb2bc5e7fea645

See more details on using hashes here.

Provenance

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