Pychonet

Project Maintenance

A library for interfacing with the ECHONETlite protocol as commonly used in Japan. Useful for interfacing to many interesting devices such as HVACs, light systems, electric car chargers, rice cookers (not joking), and solar systems that support ECHONETLite.

The current functionality is limited to a few ECHONETLite classes, notably HVAC but it can easily be extended to any ECHONETlite classes required.

The basic boilerplate EchoNetInstance class can be used to provide raw connectivity to any compatible device but it is up to the developer to create useful classes. Any ECHONETlite class additions to the library are welcome.

Version 2.0.0 of this library was rebuilt to use asyncio for better compatability with home assistant.

It is designed to work with Python 3.9.5+

Instructions

Simplest way to install is to use pip:

pip install pychonet

Basic usage

Create the ECHONETLite listener service on port 3610:

from pychonet.lib.udpserver import UDPServer
from pychonet import Factory
from pychonet import ECHONETAPIClient as api
from pychonet import HomeAirConditioner
from pychonet import EchonetInstance
udp = UDPServer()
loop = asyncio.get_event_loop()
udp.run("0.0.0.0", 3610, loop=loop)
server = api(server=udp)

Discover a list of ECHONETlite instances on a particular server:

await server.discover('192.168.1.6')

Populate the propertymap for a particular ECHONETLite instance:

await server.getAllPropertyMaps('192.168.1.6', 1, 48, 1)

Create a ECHONETLite device using the Factory:

Paramaters include the port listener, and EOJGC, EOJCC, and EOJCI codes.

aircon = Factory("192.168.1.6",server, 1, 48, 1)

OR, create a specific ECHONETLite instance using built in objects:

aircon = HomeAirConditioner("192.168.1.6", server)

Turn HVAC on or off:

await aircon.on()
await aircon.off()
await aircon.getOperationalStatus()
{'status': 'off'}

Set or Get a HVACs target temperature:

await aircon.setOperationalTemperature(25)
await aircon.getOperationalTemperature()
{'set_temperature': 25}

Set or Get a HVACs mode of operation:

supported modes =  'auto', 'cool', 'heat', 'dry', 'fan_only', 'other'

await aircon.setMode('cool')
await aircon.getMode()
{'mode': 'cool'}

Set or Get a HVACs fan speed:

Note - your HVAC may not support all fan speeds.

supported modes = 'auto', 'minimum', 'low', 'medium-Low', 'medium', 'medium-high', 'high', 'very high', 'max'

await aircon.setFanSpeed('medium-high')
await aircon.getFanSpeed()
{'fan_speed': 'medium-high'}

Get HVAC attributes at once (Note, the property map must be populated):

await aircon.update()
{'status': 'On', 'set_temperature': 25, 'fan_speed': 'medium-high', 'room_temperature': 25, 'mode': 'cooling'}

OR grab a specific attribute at once (Note, the property map must be populated):

await aircon.update(0x80)

Using this library with Home Assistant

NOTE: For Home Assistant users there is a dedicated repo that can be installed via HACS that can provide custom components for discovered ECHONETlite devices such as Mitsubishi airconditioners: (https://github.com/scottyphillips/echonetlite_homeassistant)

'example_async.py' gives you a boilerplate asyncio program that will discover your ECHONETLite instance and return information about supported services.

Hall of Fame

Big Thanks to Naoki Sawada for many excellent updates to enable push notifications via multicast. どうもありがとうございます !

Thanks to Jason Nader for all the quality of life updates to the codebase and doco.

Thanks to khcnz (Karl Chaffey) and gvs for helping refector the old code and contributing to testing.

Thanks to Dick Swart, Masaki Tagawa, Paul, khcnz, Kolodnerd, Leonunix, and Alfie Gerner for each contributing code updates to this library.

Thanks to Jeffro Carr who inspired me to write my own native Python ECHONET library for Home Assistant.

Thanks to Futomi Hatano for open sourcing a well-documented ECHONET Lite library in Node JS. (https://github.com/futomi/node-echonet-lite)

References for ECHONET specifications

License

This application is licensed under an MIT license, refer to LICENSE-MIT for details.

Слава Україні! 🇺🇦

Metadata

Release files for pychonet 2.7.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pychonet 2.7.13
File	Size	Uploaded
pychonet-2.7.13.tar.gz	129.5 kB	Jun 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pychonet 2.7.13
File	Interpreter	ABI	Platform	Reset
pychonet-2.7.13-py3-none-any.whl 124.9 kB Jun 23, 2026	Python 3	none	any	Details

Total release size: 254.4 kB

Release files / pychonet-2.7.13.tar.gz

Download URL	pychonet-2.7.13.tar.gz
Size	129.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`1bc1365a1904dc636d137f732d435bf166cdadacb9149220d69f5e3cf34406ad`
BLAKE2b-256 checksum How to use checksums	`c92f11270ab7e8cd9b20fee08928c375d43eba0512b3a30e09432cbb19bb8649`
Upload date	Jun 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.5`

Release files / pychonet-2.7.13-py3-none-any.whl

Download URL	pychonet-2.7.13-py3-none-any.whl
Size	124.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ee37c88012de165a7d05f8a0674d5e794d8b0662d848b0e877baa2c1473715a4`
BLAKE2b-256 checksum How to use checksums	`eb9b3b57bf306d5ee6ea3b85b1a0b2104cbd9f1354efdfe0e5dd5867ff5d2d16`
Upload date	Jun 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.5`