pyown 0.5.0

Python wrapper for OpenWebNet protocol

OpenWebNet parser for Python

This is a Python library to connect and parse OpenWebNet messages from Bticino/Legrand gateways.

Currently, it is a WIP, but it is already able to connect to the gateway and manages lighting or automation devices.

PyPI page

What is OpenWebNet?

OpenWebNet is a home automation protocol developed by Bticino (now part of Legrand) to control domotic devices like lights, shutters, heating, etc. It was developed around 2000, and it's still used today in many installations. It does not implement any encryption, so it is not secure to use it over the internet. Also, many devices implement only the old password algorithm, which is easily bruteforceable. So, when using OpenWebNet, be sure to use it only in a trusted network and taking security measures, like vlan separation.

Project structure

• pyown contains the library code
• examples contains some examples on how to use the library
• tests contains the tests for the library

Library structure

• items contains the code for the various types of devices that can be controlled
• client used to connect to the gateway, manages the various types of sessions
• auth implementation of the authentication algorithms
• protocol manages the sending and receive of the messages and the initial parsing
• messages defines the various types of messages allowed by the protocol
• tags defines the tags that compose a message

License

This project is licensed under the GNU GPL v3 license—see the LICENSE file for details.

Acknowledgments

• old openwebnet documentation
• openwebnet documentation
• another openwebnet documentation page
• old password algorithm
• java implementation used in OpenHab developed by mvalla
• another python implementation developed by karel1980

Disclaimer

• This library is not associated by any means with BTicino or Legrand companies
• The Open Web Net protocol is maintained and Copyright by BTicino/Legrand. The documentation of the protocol if freely accessible for developers on the Legrand developer website
• "Open Web Net", "SCS", "MyHOME_Up", "MyHOME", "MyHOME_Play" and "Living Now" are registered trademarks by BTicino/Legrand