A Python library for controlling Terncy home automation system.
Project description
python-terncy
A python library for control Terncy devices.
Installation
pip install terncy
Introduction
Before use this library, developer need to get a client id from terncy. The client id is a string that uniquely identifies the client app connectes to Terncy system. For istance, Home Assistant integration has its own client id. By presenting a valid client id to Terncy, it allows access to the system.
In addition, an access credential is also needed to make sure the owner of the Terncy system is aware of, and permit the client access. The approval of the access credential is done in Terncy app.
Example:
import asyncio
import terncy
def event_hander(t, msg):
print("got event", msg)
async def main():
terncy_homecenters_in_lan = await t.discover()
t = terncy.Terncy(
"client_id",
"192.168.1.187",
443,
"homeassistant_user",
"",
)
token_id, token = await t.request_token("homeassistant_user", "HA User")
# approve the token request in Terncy app, the client should store the
# allocated token and token id for later usage
# create a new Terncy object with approved token
t_with_token = terncy.Terncy(
"client_id",
"192.168.1.187",
443,
"homeassistant_user",
token,
)
t_with_token.register_event_handler(event_hander)
await t_with_token.start()
t_with_token.set_onoff("uuid_of_device", 1)
loop = asyncio.get_event_loop()
loop.run_until_complete(main())
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
terncy-0.3.1.tar.gz
(7.2 kB
view hashes)
Built Distribution
terncy-0.3.1-py3-none-any.whl
(8.1 kB
view hashes)