xaal.tuya


Namexaal.tuya JSON
Version 0.1 PyPI version JSON
download
home_pageNone
SummaryxAAL support for Tuya protocol / Smart Life App
upload_time2024-07-16 12:08:47
maintainerNone
docs_urlNone
authorNone
requires_pythonNone
licenseGPL License
keywords xaal tuya
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            xaal.tuya
=========
This package provides a gateway to control Tuya devices from xAAL network.

Tuya protocol is the common protocol used in cheap chinese outlets, smart plugs,
and RGB lamps. It use the cloud base "Smart Life" mobile application (Android/IOS).

This protocol isn't really reliable. If you can, avoid the use of Smart Life APP
when this gateway is running. This should be ok, but attributes can be out of
sync. The gateway polls devices state every 45 seconds but due to socket error,
this can be a little longuer.


The complete guide to extract keys is there:
https://github.com/codetheweb/tuyapi/blob/master/docs/SETUP.md

Notes :
The main issue is that tuya devices close every connection after 10 seconds.

Supported devices
-----------------
The gateway supports: PowerRelays (from 1 to x relais), SmartPlugs (same as relais
but with a single power-meter), lamps and RGB lamps

Configuration samples
---------------------

- Dimmer Lamp / LSC Smart filament

.. code-block::

   [[device_id]]
    ip = 192.168.1.x
    key = xxxxxxxxxxxxxxxx
    type = lamp_dimmer
    white_temp = 1800, 2700  # for LSC
    addr = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

- RGB Lamp / LSC RGB1

.. code-block::

   [[device_id]]
    ip = 192.168.1.x
    key = xxxxxxxxxxxxxxxx
    type = lamp_rgb
    white_temp = 1800, 2700  # for LSC
    white_temp = 3000, 6500  # for Utorch LE7
    addr = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

- Alphawise dumb single outlet

.. code-block::

  [[device_id]]
    ip = 192.168.1.x
    key = xxxxxxxxxxxxxxxx
    type = powerrelay

- SmartPlug (single outlet) / BW-SHP6

.. code-block::

  [[device_id]]
    ip = 192.168.1.x
    key = xxxxxxxxxxxxxxxx
    type = smartplug

- SmartPlug (dual outlet) / BW-SHP7

.. code-block::

  [[device_id]]
    ip = 192.168.1.x
    key = xxxxxxxxxxxxxxxx
    type = smartplug
    dps = 1, 2               # <= 2 outlets
    pmeter_dps = 18, 19, 20  # <= dps for current / power / voltage

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "xaal.tuya",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "xaal, tuya",
    "author": null,
    "author_email": "Jerome Kerdreux <Jerome.Kerdreux@imt-atlantique.fr>",
    "download_url": "https://files.pythonhosted.org/packages/a3/ea/4e226a69272433344a57aab296e5d1812d661c2154ec399aee1753415f26/xaal_tuya-0.1.tar.gz",
    "platform": null,
    "description": "xaal.tuya\n=========\nThis package provides a gateway to control Tuya devices from xAAL network.\n\nTuya protocol is the common protocol used in cheap chinese outlets, smart plugs,\nand RGB lamps. It use the cloud base \"Smart Life\" mobile application (Android/IOS).\n\nThis protocol isn't really reliable. If you can, avoid the use of Smart Life APP\nwhen this gateway is running. This should be ok, but attributes can be out of\nsync. The gateway polls devices state every 45 seconds but due to socket error,\nthis can be a little longuer.\n\n\nThe complete guide to extract keys is there:\nhttps://github.com/codetheweb/tuyapi/blob/master/docs/SETUP.md\n\nNotes :\nThe main issue is that tuya devices close every connection after 10 seconds.\n\nSupported devices\n-----------------\nThe gateway supports: PowerRelays (from 1 to x relais), SmartPlugs (same as relais\nbut with a single power-meter), lamps and RGB lamps\n\nConfiguration samples\n---------------------\n\n- Dimmer Lamp / LSC Smart filament\n\n.. code-block::\n\n   [[device_id]]\n    ip = 192.168.1.x\n    key = xxxxxxxxxxxxxxxx\n    type = lamp_dimmer\n    white_temp = 1800, 2700  # for LSC\n    addr = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\n\n- RGB Lamp / LSC RGB1\n\n.. code-block::\n\n   [[device_id]]\n    ip = 192.168.1.x\n    key = xxxxxxxxxxxxxxxx\n    type = lamp_rgb\n    white_temp = 1800, 2700  # for LSC\n    white_temp = 3000, 6500  # for Utorch LE7\n    addr = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\n\n- Alphawise dumb single outlet\n\n.. code-block::\n\n  [[device_id]]\n    ip = 192.168.1.x\n    key = xxxxxxxxxxxxxxxx\n    type = powerrelay\n\n- SmartPlug (single outlet) / BW-SHP6\n\n.. code-block::\n\n  [[device_id]]\n    ip = 192.168.1.x\n    key = xxxxxxxxxxxxxxxx\n    type = smartplug\n\n- SmartPlug (dual outlet) / BW-SHP7\n\n.. code-block::\n\n  [[device_id]]\n    ip = 192.168.1.x\n    key = xxxxxxxxxxxxxxxx\n    type = smartplug\n    dps = 1, 2               # <= 2 outlets\n    pmeter_dps = 18, 19, 20  # <= dps for current / power / voltage\n",
    "bugtrack_url": null,
    "license": "GPL License",
    "summary": "xAAL support for Tuya protocol / Smart Life App",
    "version": "0.1",
    "project_urls": null,
    "split_keywords": [
        "xaal",
        " tuya"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d66db0945c6259932e171788680aac271966a2bbb1f7b2efd5dd119769bb91c2",
                "md5": "09bc660e4b698d4aedec8fcba84447fc",
                "sha256": "a56af66fb67d39dafbae9c78c36e910f6e8073c8fb3759b4b0b8adc29d2f0853"
            },
            "downloads": -1,
            "filename": "xaal.tuya-0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "09bc660e4b698d4aedec8fcba84447fc",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 9635,
            "upload_time": "2024-07-16T12:08:45",
            "upload_time_iso_8601": "2024-07-16T12:08:45.328204Z",
            "url": "https://files.pythonhosted.org/packages/d6/6d/b0945c6259932e171788680aac271966a2bbb1f7b2efd5dd119769bb91c2/xaal.tuya-0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a3ea4e226a69272433344a57aab296e5d1812d661c2154ec399aee1753415f26",
                "md5": "cda7550095561cf47333d664d6c8bad0",
                "sha256": "972666e34bfead808761d429b6200f352104cda96fc97e71df294735410a38c7"
            },
            "downloads": -1,
            "filename": "xaal_tuya-0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "cda7550095561cf47333d664d6c8bad0",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 10915,
            "upload_time": "2024-07-16T12:08:47",
            "upload_time_iso_8601": "2024-07-16T12:08:47.061876Z",
            "url": "https://files.pythonhosted.org/packages/a3/ea/4e226a69272433344a57aab296e5d1812d661c2154ec399aee1753415f26/xaal_tuya-0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-07-16 12:08:47",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "xaal.tuya"
}
        
Elapsed time: 1.71149s