jrc / pi_homeeasy

Python port of https://github.com/nbogojevic/piHomeEasy

pi_homeeasy

This is a Python port of piHomeEasy. It lets you use a Raspberry Pi with a low-cost 433 MHz transmitter to send on/off control codes to RF-controlled power outlets that use the HomeEasy self-learning protocol.

Compatible devices have been sold in Europe under the following brands:

• Bye Bye Standby / Domia Lite (UK)
• Chacon (Belgium)
• Düwi (Germany)
• HomeEasy / Byron / Smartwares (Netherlands)
• Intertechno (Austria)
• KlikAanKlikUit (Netherlands)
• Anslut / Proove / Nexa / Telldus (Sweden)
• etc.

This package is designed to work with Home Assistant. See homeassistant/README.md for info.

Protocol

• http://tech.jolowe.se/home-automation-rf-protocols/
• https://homeeasyhacking.fandom.com/wiki/Advanced_Protocol

Wiring

Raspberry Pi	433 MHz transmitter module
5V Power	VCC
Ground	GND
GPIO/BCM 17	DATA

For diagrams, see https://pinout.xyz/ and https://tutorials-raspberrypi.com/control-raspberry-pi-wireless-sockets-433mhz-tutorial/. (The square module is the 433 MHz transmitter; the rectangular module is the 433 MHz receiver, not used here.)

Installation

$ pip install pi-homeeasy

Usage

Command Line

Run pi-homeeasy -h for usage help.

Example:

$ pi-homeeasy 12345678 1 on

Python API

Example:

$ python
>>> import pi_homeeasy
>>> pi_homeeasy.send(12345678, 1, True, 17)