Package: pychonet
PychonetA 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+InstructionsSimplest way to install is to use pip:pip install pychonetBasic usageCreate the ECHONETLite listener service on port 3610:frompychonet.lib.udpserverimportUDPServerfrompychonetimportFactoryfrompychonetimportECHONETAPIClientasapifrompychonetimportHomeAirConditionerfrompychonetimportEchonetInstanceudp=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:awaitserver.discover('192.168.1.6')Populate the propertymap for a particular ECHONETLite instance:awaitserver.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:awaitaircon.on()awaitaircon.off()awaitaircon.getOperationalStatus(){'status':'off'}Set or Get a HVACs target temperature:awaitaircon.setOperationalTemperature(25)awaitaircon.getOperationalTemperature(){'set_temperature':25}Set or Get a HVACs mode of operation:supportedmodes='auto','cool','heat','dry','fan_only','other'awaitaircon.setMode('cool')awaitaircon.getMode(){'mode':'cool'}Set or Get a HVACs fan speed:Note - your HVAC may not support all fan speeds.supportedmodes='auto','minimum','low','medium-Low','medium','medium-high','high','very high','max'awaitaircon.setFanSpeed('medium-high')awaitaircon.getFanSpeed(){'fan_speed':'medium-high'}Get HVAC attributes at once (Note, the property map must be populated):awaitaircon.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):awaitaircon.update(0x80)Using this library with Home AssistantNOTE: 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 FameBig 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 specificationsECHONET Lite Specification, Version 1.13Part 2 ECHONET Lite Communications Middleware SpecificationsAPPENDIX, Detailed Requirements for ECHONET Device objects, Release QLicenseThis application is licensed under an MIT license, refer to LICENSE-MIT for details.Portions of 'ECHONET Lite Device Emulator' (Copyright 2020 Kanagawa Institute of Technology)
have been used in this application. This code was licensed under the MIT licence.The UDP code is based on 'aio-udp-server' (Copyright 2021 Dmitriy Bashkirtsev)
This code is licenced under the GPL licence.
(https://github.com/bashkirtsevich-llc/aioudp)Слава Україні! 🇺🇦