Konnected Python library
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
konnected update to allow for dht and ds18b20 sensor settings Feb 18, 2019
LICENSE.txt initial commit; settings endpoint Mar 7, 2018
README.md update to allow for dht and ds18b20 sensor settings Feb 18, 2019
requirements.txt initial commit; settings endpoint Mar 7, 2018
setup.cfg add more documentation; update return value from put_device() Mar 7, 2018


Konnected Python library

This is a simple Python library to talk to a Konnected device. Konnected is an open-source software for ESP8266 devices that enables simple wired binary sensors and actuators to talk to home automation frameworks such as Home Assistant and SmartThings. The most popular use case for Konnected is to connected a wired home alarm system to your Smart Home hub.

This library was written to support Home Assistant integration.

For more information see konnected.io


>>> import konnected

# Initialize the Konnected client with a host and port.
# Every Konnected module uses a different HTTP port

>>> k = konnected.Client('', '17000')

# Sync settings to the device

>>> k.put_settings(sensors=[{"pin":1}], actuators=[], auth_token='secureToken', endpoint='http://example.com')

# Get status of each input pin
>>> k.get_device()
[{'state': 0, 'pin': 1}, {'state': 1, 'pin': 2}]

# Get status of a single input pin

>>> k.get_device(2)
[{'state': 1, 'pin': 2}]

# Actuate an output pin

>>> k.put_device(pin=8, state=1)
{'state': 1, 'pin': 8}

# Get device status

>>> k.get_status()
{'mac': '2c:3a:e8:43:8a:38', 'gw': '', 'hwVersion': '2.0.5', 'rssi': -31, 'nm': '', 'ip': '', 'actuators': [{'trigger': 1, 'pin': 8}], 'port': 12426, 'uptime': 2349, 'heap': 23904, 'swVersion': '2.1.3', 'sensors': [{'state': 0, 'pin': 1}]}


Python version

This library was designed to work with Python 3. Parts may work with Python 2.7, but if it does it's totally accidental.