Skip to main content

PyPlumIO is a native ecoNET library for Plum ecoMAX controllers.

Project description

PyPlumIO is a native ecoNET library for Plum ecoMAX controllers

PyPI version PyPI Supported Python Versions PyPlumIO CI Maintainability Code Coverage stability-release-candidate Ruff

Overview

This package aims to provide complete and easy to use solution for communicating with climate devices by Plum Sp. z o.o.

ecoMAX controllers

Currently it supports reading and writing parameters of ecoMAX controllers by Plum Sp. z o.o., getting service password and sending network information to show on controller's display.

Devices can be connected directly via RS-485 to USB adapter or through network by using RS-485 to Ethernet/WiFi converter.

RS-485 converters

Table of contents

Quickstart

  1. To use PyPlumIO, first install it using pip:
pip install pyplumio
  1. Connect to the ecoMAX controller:
>>> connection = pyplumio.open_serial_connection("/dev/ttyUSB0")
>>> await connection.connect()
>>> ecomax = await connection.get("ecomax")
  1. Print some values:
>>> print(await ecomax.get("heating_temp"))
  1. Don’t forget to close the connection:
>>> await connection.close()

Home Assistant Integration

There is companion Home Assistant integration that is being co-developed with this package and depends on it. Click button below to check it out.

Plum ecoMAX for Home Assistant

Attribution

Special thanks to econetanalyze project by twkrol for initial information about protocol.

License

This product is distributed under MIT license.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

pyplumio-0.5.53.tar.gz (284.3 kB view details)

Uploaded Source

Built Distribution

pyplumio-0.5.53-py3-none-any.whl (78.1 kB view details)

Uploaded Python 3

File details

Details for the file pyplumio-0.5.53.tar.gz.

File metadata

  • Download URL: pyplumio-0.5.53.tar.gz
  • Upload date:
  • Size: 284.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pyplumio-0.5.53.tar.gz
Algorithm Hash digest
SHA256 03ca0c48a051d13ed074ebb814d51c5eaf10918c5563d66fc240129c7069d5a3
MD5 621b631837b266c559ad5b80b3d8c4e7
BLAKE2b-256 b1a5b63bef820adceb01a0cd8bdeb006584788cdc3751ef35bffba3694114f65

See more details on using hashes here.

File details

Details for the file pyplumio-0.5.53-py3-none-any.whl.

File metadata

  • Download URL: pyplumio-0.5.53-py3-none-any.whl
  • Upload date:
  • Size: 78.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pyplumio-0.5.53-py3-none-any.whl
Algorithm Hash digest
SHA256 0e47a904ec4d8ae5b5833fae1a8978c2fb5fcde7a4d179041736a25adef85f6e
MD5 5ad6603fc8b71897c721ca475858afeb
BLAKE2b-256 a1ca1bdbfe77cdb2291f240bc33401126fb4ce403b2c3a852132ac730ecbb5ac

See more details on using hashes here.

Supported by

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