Skip to main content

Python middleware for Tuya WiFi smart devices to MQTT

Project description

TuyaGateway logo

We've made a library that communicates locally with your Tuya devices (no internet connection needed), called TuyaFace. The library is open-source and can be used in your own software if you choose to do so. But we did the heavylifting already for you. TuyaGateway implements the library and communitates over an open protocol (MQTT) with your home automation software. All relevant home automation software packages (e.g. Home Assistant) are able to work with MQTT.

Great! But what about GismoCaster? GismoCaster is the control-center for TuyaGateway. In a webinterface you can add your devices, set names for them, etc. So, no programming required and no dabbling around in obscure text files which will break when you add a tab to many.

Network

A bit more technical

TuyaGateway listens on MQTT topics and routes requests to your Tuya devices. In earlier versions the configuration was based on a one to one topic translation in e.g. Home-Assistant config-files. 1:1 topic translation is limited to simple tasks (like switching ON/OFF); only boolean values.

From v1.1 onwards Tuya device configuration can be done with GismoCaster. In which you can set discovery messages for both TuyaGateway and Home Assistant and opens up the ability to set boolean/integer/float/string types.

The goal for version v2.0 is to add input/output processing functions and to improve on HA message values. Next to structural improvements to the code. The topic configuration option will be removed.

Docs

https://github.com/TradeFace/tuyagateway/wiki

Get involved!

Anyone who is willing to test, write code, add documentation, etc. is welcome to make a contribution.

Acknowledgements

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tuyagateway-2.0.3.tar.gz (13.0 kB view hashes)

Uploaded Source

Built Distribution

tuyagateway-2.0.3-py3-none-any.whl (14.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page