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 Code style: black PyPlumIO CI Maintainability Test Coverage stability-beta


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


  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


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


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.4.2.post1.tar.gz (244.3 kB view hashes)

Uploaded source

Built Distribution

PyPlumIO-0.4.2.post1-py3-none-any.whl (60.9 kB view hashes)

Uploaded py3

Supported by

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