Skip to main content

Python library and CLI to control Prana recuperators via BLE connection (https://prana.org.ua/)

Project description

Prana RC

Prana device picture

DISCLAIMER: This library is under active development now. There are no any stable release yet, so please do not use it in your installation unless you are developer who would like to contribute into module

Python library and CLI to manage Prana recuperators (https://prana.org.ua/) via BLE interface. It provides access to the device API and provides functionality similar to functionality of the official mobile application with some limitations (see limitation section below).

ATTENTION: Manufacturer doesn’t provide any technical documentation describing protocol and also officially doesn’t provide an ability to interact with the devices programmatically. This library is based on reverse engineering of the closed proprietary protocol. Used it on your own risk.

Features:

  • Read current prana state

  • Control everything which could be managed via official app with a few exceptions (see limitations section)

  • Discover not connected devices around

  • Client-server architecture (allows distributed setup)

  • CLI interface available for quick tinkering

Installation

Install regular server component with Http API:

pip install prana-rc[server-tornado]

If you prefer dockerized setup you could run it like this:

docker run --rm prana-rc:latest -d  --network=host --restart=unless-stopped

For more details see readme.

Disclaimer

This module is licensed under GPL v3. This means you are free to use in non-commercial projects.

The GPL license clearly explains that there is no warranty for this free software. Please see the included LICENSE file for details.

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

prana_rc-0.3.11.tar.gz (15.4 kB view details)

Uploaded Source

Built Distribution

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

prana_rc-0.3.11-py3-none-any.whl (25.1 kB view details)

Uploaded Python 3

File details

Details for the file prana_rc-0.3.11.tar.gz.

File metadata

  • Download URL: prana_rc-0.3.11.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.6.1 requests/2.25.1 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.7.9

File hashes

Hashes for prana_rc-0.3.11.tar.gz
Algorithm Hash digest
SHA256 01906dbccadd378eacf55aef7a72b9d31eb4f24bab7371cdf8c886ccdaa78d8d
MD5 d9d5573459ab441d3a6ff264bf726c35
BLAKE2b-256 0e2d08a50324d00208fb17982fa24647c75a534ce9b5d88fb494c60fee4ba5ac

See more details on using hashes here.

File details

Details for the file prana_rc-0.3.11-py3-none-any.whl.

File metadata

  • Download URL: prana_rc-0.3.11-py3-none-any.whl
  • Upload date:
  • Size: 25.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.6.1 requests/2.25.1 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.7.9

File hashes

Hashes for prana_rc-0.3.11-py3-none-any.whl
Algorithm Hash digest
SHA256 fa014f76cd1b6237a850c24cfb6b836613f1942c2fb2e97d280043552ddd7978
MD5 72fac0384f75d40a74f3a3aee75989c3
BLAKE2b-256 40282b6f7031b6cbaf5b054d795d54e5db10c97f6d126ea0a17f0a9d87112772

See more details on using hashes here.

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