homebridge-tuya-platform-talrhvfork 1.5.1

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,106 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+
+**Device info (please complete the following information, which can be found in [log](https://github.com/tuya/tuya-homebridge/wiki/How-To-Get-Logs)):**
+**request path = /v1.0/iot-01/associated-users/devices**
+
+like this:
+{
+      "active_time": 1623229189,
+      "biz_type": 18,
+      "category": "cz",
+      "create_time": 1560491945,
+      "icon": "smart/product_icon/cz.png",
+      "id": "aaaaaaaaaaa",
+      "ip": "xxxxxxxxxxxxxxxx",
+      "lat": "30.30286857361191",
+      "local_key": "xxxxxxxxxxxxx",
+      "lon": "120.0639743842656",
+      "model": "",
+      "name": "Living Room Socket",
+      "online": false,
+      "owner_id": "34794909",
+      "product_id": "yfemiswbgjhddhcf",
+      "product_name": "Switch Product",
+      "status": [
+        {
+          "code": "switch",
+          "value": false
+        },
+        {
+          "code": "countdown_1",
+          "value": 0
+        },
+        {
+          "code": "cur_current",
+          "value": 0
+        },
+        {
+          "code": "cur_power",
+          "value": 0
+        },
+        {
+          "code": "cur_voltage",
+          "value": 2343
+        }
+      ],
+      "sub": false,
+      "time_zone": "+08:00",
+      "uid": "xxxxxxxxxxxxxxxxxxx",
+      "update_time": 1625101929,
+      "uuid": "xxxxxxxxxxxxxxxxxx"
+    }
+
+**Device functions (please complete the following information, which can be found in [log](https://github.com/tuya/tuya-homebridge/wiki/How-To-Get-Logs)):**
+**request path = /v1.0/devices/functions**
+Same **device Id**, like this:
+{
+    "category":"cl",
+    "devices":[
+        "aaaaaaaaaaa"
+    ],
+    "functions":[
+        {
+            "code":"control",
+            "desc":"control",
+            "name":"control",
+            "type":"Enum",
+            "values":"{\"range\":[\"open\",\"stop\",\"close\"]}"
+        },
+        {
+            "code":"percent_control",
+            "desc":"percent control",
+            "name":"percent control",
+            "type":"Integer",
+            "values":"{\"unit\":\"%\",\"min\":0,\"max\":100,\"scale\":0,\"step\":1}"
+        },
+        {
+            "code":"control_back",
+            "desc":"control back",
+            "name":"control back",
+            "type":"Boolean",
+            "values":"{}"
+        }
+    ],
+    "product_id":"xaabybja"
+}
+
+
+**Additional context**
+Add any other context or logs about the problem here.

package/.github/ISSUE_TEMPLATE/login_error_code.md

@@ -0,0 +1,28 @@
+---
+name: Error Code
+about: Create a report to help us improve
+title: ''
+labels: code XXX
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+
+**Login request (please complete the following information, which can be found in [log](https://github.com/tuya/tuya-homebridge/wiki/How-To-Get-Logs)):**
+**request path = /v1.0/iot-01/associated-users/actions/authorized-login**
+
+like this:
+
+TuyaOpenAPI request: method = post, endpoint = https://openapi.tuyacn.com, path = /v1.0/iot-01/associated-users/actions/authorized-login, params = null, body = {"country_code":86,"username":"XXXXXXXXXXXXX","password":"c44755c3379313db173e53c3e8fb6701","schema":"tuyaSmart"}, headers = {"t":"1626082406842","client_id":"XXXXXXXXXXXXX","nonce":"33341140-e2f4-11eb-abd9-491eaffd7d33","Signature-Headers":"client_id","sign":"2E250AB9256B14F6EAD94DEA9EE0EA8413E7939E7DEAB0B60D8D786B296A7AF8","sign_method":"HMAC-SHA256","access_token":"","lang":"en","dev_lang":"javascript","dev_channel":"homebridge","devVersion":"1.2.1"}
+
+**Login response (please complete the following information, which can be found in [log](https://github.com/tuya/tuya-homebridge/wiki/How-To-Get-Logs)):**
+**request path = /v1.0/devices/functions**
+TuyaOpenAPI response: {"code":1106,"msg":"permission deny","success":false,"t":1626082407259} path = /v1.0/iot-01/associated-users/actions/authorized-login
+
+

package/.github/ISSUE_TEMPLATE/new-device-support.md

@@ -0,0 +1,94 @@
+---
+name: New Device Support
+about: New device that wants to be supported
+title: ''
+labels: enhancement, help wanted
+assignees: ''
+
+---
+
+
+**Device info (please complete the following information, which can be found in [log](https://github.com/tuya/tuya-homebridge/wiki/How-To-Get-Logs)):**
+**request path = /v1.0/iot-01/associated-users/devices**
+
+like this:
+{
+      "active_time": 1623229189,
+      "biz_type": 18,
+      "category": "cz",
+      "create_time": 1560491945,
+      "icon": "smart/product_icon/cz.png",
+      "id": "aaaaaaaaaaa",
+      "ip": "xxxxxxxxxxxxxxxx",
+      "lat": "30.30286857361191",
+      "local_key": "xxxxxxxxxxxxx",
+      "lon": "120.0639743842656",
+      "model": "",
+      "name": "Living Room Socket",
+      "online": false,
+      "owner_id": "34794909",
+      "product_id": "yfemiswbgjhddhcf",
+      "product_name": "Switch Product",
+      "status": [
+        {
+          "code": "switch",
+          "value": false
+        },
+        {
+          "code": "countdown_1",
+          "value": 0
+        },
+        {
+          "code": "cur_current",
+          "value": 0
+        },
+        {
+          "code": "cur_power",
+          "value": 0
+        },
+        {
+          "code": "cur_voltage",
+          "value": 2343
+        }
+      ],
+      "sub": false,
+      "time_zone": "+08:00",
+      "uid": "xxxxxxxxxxxxxxxxxxx",
+      "update_time": 1625101929,
+      "uuid": "xxxxxxxxxxxxxxxxxx"
+    }
+
+**Device functions (please complete the following information, which can be found in [log](https://github.com/tuya/tuya-homebridge/wiki/How-To-Get-Logs)):**
+**request path = /v1.0/devices/functions**
+
+Same **device Id**, like this:
+{
+    "category":"cl",
+    "devices":[
+        "aaaaaaaaaaa"
+    ],
+    "functions":[
+        {
+            "code":"control",
+            "desc":"control",
+            "name":"control",
+            "type":"Enum",
+            "values":"{\"range\":[\"open\",\"stop\",\"close\"]}"
+        },
+        {
+            "code":"percent_control",
+            "desc":"percent control",
+            "name":"percent control",
+            "type":"Integer",
+            "values":"{\"unit\":\"%\",\"min\":0,\"max\":100,\"scale\":0,\"step\":1}"
+        },
+        {
+            "code":"control_back",
+            "desc":"control back",
+            "name":"control back",
+            "type":"Boolean",
+            "values":"{}"
+        }
+    ],
+    "product_id":"xaabybja"
+}

package/.github/workflows/greetings.yml

@@ -0,0 +1,16 @@
+name: Greetings
+
+on: [pull_request, issues]
+
+jobs:
+  greeting:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+    - uses: actions/first-interaction@v1
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        issue-message: 'Thank you for your feedback, we will solve this issue soon'
+        pr-message: 'Thank you for your PR, we will review it soon.'

package/.github/workflows/stale.yml

@@ -0,0 +1,21 @@
+name: Mark stale issues and pull requests
+
+on:
+  schedule:
+  - cron: '27 9 * * *'
+
+jobs:
+  stale:
+
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+
+    steps:
+    - uses: actions/stale@v3
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-issue-message: 'Stale issue. we will close the issue soon. If this issue has not been resolved, please update the issue and contact us in time.'
+        stale-issue-label: 'no-issue-activity'
+        stale-pr-label: 'no-pr-activity'

package/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014-2021 Tuya Inc.
+Permission is hereby granted, free of charge, to any person obtaining a copy 
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is 
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in 
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
+DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,89 @@
+This Fork adds more device support for the fantastaic Homebridge-Tuya plugin!
+
+* Valve accessory support for switches! - turn your regular switch (kg category) to a valve accessory! what it means? it means that you 
+  set a countdown timer for the switch to turn off automatically directly from the home app! (great for boiler switches). 
+* Notion sensor support - thanks to MeesMaas.
+* Zigbee curtain switch support with percentage control.
+* Push accessory support - currently only Fingerbot is supported.
+
+Tuya Homebridge Plugin
+========================
+
+<p align="center">
+    <img src="https://images.tuyacn.com/app/hass/hb_tuya.png" width="70%"><br>
+</p>
+
+<span align="center">
+    
+[![npm](https://img.shields.io/npm/v/homebridge-tuya-platform.svg)](https://www.npmjs.com/package/homebridge-tuya-platform)
+[![npm](https://img.shields.io/npm/dt/homebridge-tuya-platform.svg)](https://www.npmjs.com/package/homebridge-tuya-platform)
+[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
+    
+[![GitHub watchers](https://img.shields.io/github/watchers/tuya/tuya-homebridge.svg?style=social&label=Watch)](https://GitHub.com/tuya/tuya-homebridge/watchers/)
+[![GitHub stars](https://img.shields.io/github/stars/tuya/tuya-homebridge.svg?style=social&label=Star)](https://GitHub.com/tuya/tuya-homebridge/stargazers/)
+[![GitHub forks](https://img.shields.io/github/forks/tuya/tuya-homebridge.svg?style=social&label=Fork)](https://GitHub.com/tuya/tuya-homebridge/network/)
+
+If you like Tuya Homebridge Plugin - give it a star, or fork it and contribute!
+
+</span>
+
+Homebridge custom plugin for controlling Powered by Tuya (PBT) devices in HomeKit, it's based on [Tuya Open API](https://developer.tuya.com/en/docs/cloud/?_source=2e646f88eae60b7eb595e94fc3866975). The plugin is officially maintained by the Tuya Developer Team.
+
+✌️✌️✌️ [Supported Tuya Device Types](https://github.com/tuya/tuya-homebridge/wiki/Supported-Tuya-Device-Types?_source=6a1b8046224626e798190c06532c8be2) ✌️✌️✌️
+
+ :tada: :tada: :tada: [Vote for Tuya Homebridge Plugin New Device Driver Support!](https://github.com/tuya/tuya-homebridge/discussions/58) :tada::tada::tada:
+
+## [Tuya Beta Test Program](https://pages.tuya.com/develop/Homebridgebetainvitation?_source=ea61b9486f59eb89a3ee74b43140b9f3#form)
+Welcome to join the [Tuya Beta Test Program](https://pages.tuya.com/develop/Homebridgebetainvitation?_source=ea61b9486f59eb89a3ee74b43140b9f3#form) to get your development gifts and make the contribution to the plugin.Your feedback is valuable to the whole community.
+
+## Important Note
+
+If you cannot login successfully, please update to v1.5.0 as the previous version has security issues on the login feature of the plugin.
+
+### Youtube Tutorial:
+
+[![Youtube](https://img.youtube.com/vi/YH6d-2VJMaU/0.jpg)](https://www.youtube.com/watch?v=YH6d-2VJMaU)
+
+
+## Preparation
+  1. [Tuya IoT Platform Configuration](https://github.com/tuya/tuya-homebridge/wiki/Tuya-IoT-Platform-Configuration-Guide-Using-Smart-Home-PaaS?_source=d8fba44feeef4757f7f22a14c2295f3f)
+  2. [Use the Tuya Homebridge Plugin](https://github.com/tuya/tuya-homebridge/wiki/How-to-Use-Tuya-Homebridge-Plugin?_source=6a2b624bdb6dce83dd246e014ccd0bcf)
+  3. [Develop a New Driver](https://github.com/tuya/tuya-homebridge/wiki/How-to-Develop-a-New-Driver?_source=44108482f4dfcf47095e53dcf7dbba95)
+  4. [How to Get Logs](https://github.com/tuya/tuya-homebridge/wiki/How-To-Get-Logs)
+
+## Set up the development environment
+
+```
+—-VSCode
+—-engines
+    "node": “>=0.12.0”
+    "homebridge": ">=0.2.0"
+—-dependencies
+    "axios": “^0.21.1",
+    "crypto-js": “^4.0.0”, 
+    "mqtt": “^4.2.6",
+    "uuid": "^8.3.2"
+```
+
+## Tuya OpenApi Login Error Code
+
+| Error code | Error message | Troubleshooting |
+|:----|:----|:----|
+| 1004 | sign invalid | <ul><li> Incorrect `accessId` or `accessKey`. To fix the error, see [Edit config.json](https://developer.tuya.com/en/docs/iot/Tuya_Homebridge_Plugin?id=Kamcldj76lhzt#config) file.</li><li> Due to the new signature verification mode, the server will have the cache of the old mode. Please create a Github Issue to inform us. |
+| 1106 | permission deny | <ul><li> Your app account is not linked with your cloud project: Link devices by using the Tuya Smart or Smart Life app with your cloud project on the [Tuya IoT Platform](https://iot.tuya.com/cloud/). For more information, see [Link devices by app account](https://developer.tuya.com/en/docs/iot/Platform_Configuration_smarthome?id=Kamcgamwoevrx#title-3-Link%20devices%20by%20app%20account).</li><li>The **TuyaSmart** or **SmartLife** app account which registered using **Google** or **Apple ID** email need to link your phone number and use the linked phone number as **username** to login. </li><li> Incorrect username or password: Enter the correct account and password of the Tuya Smart or Smart Life app in the **Account** and **Password** fields. Note that the app account must be the one you used to link devices with your cloud project on the [Tuya IoT Platform](https://iot.tuya.com/cloud/).</li><li>Incorrect endpoint: See [Endpoint](https://developer.tuya.com/en/docs/iot/Tuya_Homebridge_Plugin?id=Kamcldj76lhzt#endpoint) and enter the correct endpoint.</li><li>Incorrect countryCode: Enter the [code of the country](https://countrycode.org/) you select on logging in to the Tuya Smart or Smart Life app.</li><li>Incorrect **schema** (case insensitive). Currently only **tuyaSmart** and **smartlife** are supported.</li></ul> |
+| 1100 | param is empty | `username` or `appSchema` is empty: See [Edit config.json](https://developer.tuya.com/en/docs/iot/Tuya_Homebridge_Plugin?id=Kamcldj76lhzt#config) file and enter the correct parameter. |
+| 2017 | schema does not exist | Incorrect `appSchema` in `config.json`: See [Edit config.json](https://developer.tuya.com/en/docs/iot/Tuya_Homebridge_Plugin?id=Kamcldj76lhzt#config) file and enter the correct parameter. |
+| 2406 | skill id invalid | <ul><li>Make sure you use the Tuya Smart or SmartLife app account to log in. Also, choose the right data center endpoint related to your country region. For more details, please check [Countries/Regions and Data Center](https://github.com/tuya/tuya-home-assistant/blob/master/docs/regions_dataCenters.md).</li><li>Your cloud project on the [Tuya IoT Development Platform](https://iot.tuya.com/?_source=a4c65f56395e05cf64cc8d4abb7396b6) should be created after May 25, 2021. Otherwise, you need to create a new project. </li></ul> |
+| 28841105 | No permissions. This project is not authorized to call this API | You have not authorized your cloud project to use the required APIs. Subscribe to the following required [API products](https://developer.tuya.com/en/docs/iot/applying-for-api-group-permissions?id=Ka6vf012u6q76#title-2-Subscribe%20to%20cloud%20products) and [authorize your project to use them](https://developer.tuya.com/en/docs/iot/applying-for-api-group-permissions?id=Ka6vf012u6q76#title-3-Authorize%20projects%20to%20call%20the%20cloud%20product).   <ul><li>Authorization</li><li>Smart Home Devices Management</li><li>Smart Home Family Management</li><li>Smart Home Scene Linkage</li><li>Smart Home Data Service</li><li>Device Status Notification</li></ul> |
+
+## Users
+
+If you are a smart home geek and have a bundle of devices from different platforms, this step-by-step tutorial will help you make devices HomeKit-enabled and then develop Tuya Homebridge plugins.
+
+## Feedback
+
+You can use the **GitHub Issue** or [**tickets**](https://service.console.tuya.com/8/2/list?_source=c5965e0f53c87ba9d0eb99af0f4b124f) to provide feedback on any problems you encounter.
+
+## LICENSE
+
+For more information, see the [LICENSE](LICENSE) file.

package/config/config.json

@@ -0,0 +1,30 @@
+{
+    "bridge": {
+        "name": "homebridge-tuya-platform",
+        "username": "BE:B9:AC:79:6C:CB",
+        "port": 8081,
+        "pin": "034-85-685"
+    },
+
+    "description": "This is an Homebridge Plugin of Tuya.",
+
+    "platforms": [
+        {
+            "platform": "TuyaPlatform",
+            "name": "TuyaPlatform",
+            "options": {
+              "username": "",
+              "password": "",
+              "accessId": "",
+              "accessKey": "",
+              "lang": "en",
+              "projectType": "2",
+              "appSchema": "",
+              "countryCode":86 ,
+              "debug": true,
+              "valve": []
+            }
+          }
+    ]
+}
+

package/config.schema.json

@@ -0,0 +1,106 @@
+{
+	"pluginAlias": "TuyaPlatform",
+	"pluginType": "platform",
+	"singular": true,
+	"headerDisplay": "Official Tuya Homebridge plugin, supported by Tuya Developers.",
+	"footerDisplay": "",
+	"schema": {
+		"type": "object",
+		"properties": {
+			"name": {
+				"title": "Name",
+				"type": "string",
+				"required": true,
+				"default": "TuyaPlatform",
+				"description": "You shouldn't need to change this."
+			},
+			"options": {
+				"title": "",
+				"type": "object",
+				"required": true,
+				"properties": {
+					"username": {
+						"title": "Username",
+						"type": "string",
+						"required": true
+					},
+					"password": {
+						"title": "Password",
+						"type": "string",
+						"required": true
+					},
+					"accessId": {
+						"title": "Access ID",
+						"type": "string",
+						"required": true
+					},
+					"accessKey": {
+						"title": "Access Key",
+						"type": "string",
+						"required": true
+					},
+					"lang": {
+						"title": "Language Code",
+						"type": "string",
+						"default": "en",
+						"description": "Your two letter language code",
+						"required": true
+					},
+					"projectType": {
+						"title": "Project Type",
+						"type": "string",
+						"default": "form",
+						"oneOf": [{
+								"title": "PaaS",
+								"enum": ["2"]
+							},
+							{
+								"title": "Custom",
+								"enum": ["1"]
+							}
+						],
+						"required": true
+					},
+					"appSchema": {
+						"title": "PaaS Platform",
+						"type": "string",
+						"default": "form",
+						"oneOf": [{
+								"title": "Tuya Smart",
+								"enum": ["tuyaSmart"]
+							},
+							{
+								"title": "Smart Life",
+								"enum": ["smartlife"]
+							}
+						],
+						"required": true
+					},
+					"countryCode": {
+						"title": "Country Code",
+						"type": "number",
+						"default": "",
+						"description": "Your two integer country code",
+						"required": true
+					},
+					"valve":{
+						"title": "switch with timer",
+						"type":"array",
+						"description":"This feature let you use the switch as a valve accessory. it means that you can set countdown directly through the home app which is great for boiler switch the only issue is that valve accessories do not support automation, it can be set only through Tuya / SmartLife App.",
+						"items":{
+							"title":"device id",
+							"type":"string"
+						}
+					},
+					
+					"debug": {
+						"title": "Enable Debug Logging",
+						"type": "boolean",
+						"default": false,
+						"required": true
+					}
+				}
+			}
+		}
+  }
+}