homebridge-tuya-without-developer-account 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 1.0.0
+
+- Renamed plugin to **Tuya without developer account for Homebridge**.
+- Added Homebridge custom UI for QR Cloud Authentication before save.
+- Removed user-facing legacy Tuya IoT Developer Platform setup.
+- Removed Access ID, Access Secret, username/password, country code, local-key, local LAN, and hybrid setup paths from configuration.
+- Made QR Cloud Authentication the only supported connection mode.
+- Added publish-ready npm package metadata.

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/PUBLISHING.md

@@ -0,0 +1,80 @@
+# Publishing guide
+
+This package is intended to be published to npm so it can be installed from the Homebridge UI.
+
+## Package identity
+
+```text
+npm package: homebridge-tuya-without-developer-account
+Homebridge platform alias: TuyaNoDeveloperAccount
+Display name: Tuya without developer account for Homebridge
+```
+
+## Before publishing
+
+1. Create a GitHub repository:
+
+```text
+https://github.com/kosztyk/homebridge-tuya-without-developer-account
+```
+
+2. Push this source tree to GitHub.
+3. Confirm the package name is available on npm:
+
+```bash
+npm view homebridge-tuya-without-developer-account name
+```
+
+If npm returns `404 Not Found`, the package name is available.
+
+4. Run a package dry run:
+
+```bash
+npm pack --dry-run
+```
+
+5. Create the package locally:
+
+```bash
+npm pack
+```
+
+6. Test install the generated `.tgz` in a clean Homebridge instance:
+
+```bash
+npm install --prefix /var/lib/homebridge ./homebridge-tuya-without-developer-account-1.0.0.tgz
+hb-service restart
+```
+
+## Publish manually
+
+```bash
+npm login
+npm publish --access public
+```
+
+For an unscoped public package, `--access public` is harmless. For scoped packages it is required.
+
+## Publish through GitHub Actions
+
+This repository includes `.github/workflows/npm-publish.yml`.
+
+Add this GitHub repository secret:
+
+```text
+NPM_TOKEN
+```
+
+Then create a release or run the workflow manually.
+
+## Homebridge UI installation
+
+After npm publication and indexing, users can install from the Homebridge UI:
+
+```text
+Plugins → Search → homebridge-tuya-without-developer-account → Install
+```
+
+## Verification note
+
+Publishing to npm makes the plugin installable from the Homebridge UI. Homebridge verification is a separate review process and is not automatic.

package/README.md

@@ -0,0 +1,233 @@
+# Tuya without developer account for Homebridge
+
+A Homebridge platform plugin for Tuya and Smart Life devices that uses **Home Assistant-style Tuya QR Cloud Authentication**.
+
+This plugin is designed for users who want to add Tuya / Smart Life devices to HomeKit through Homebridge **without creating a Tuya IoT Developer Platform account** and without entering Tuya cloud project credentials.
+
+## What this plugin does
+
+- Adds Tuya / Smart Life devices to Homebridge / HomeKit.
+- Uses QR Cloud Authentication modeled after the official Tuya Home Assistant authorization flow.
+- Shows the QR code directly inside the Homebridge plugin settings UI.
+- Saves the Tuya QR token locally inside the Homebridge storage folder.
+- Fetches Tuya homes, devices, scenes, device specifications, and device status through the Tuya mobile cloud API used by the QR flow.
+- Starts an MQTT-style status listener for live status updates where supported.
+
+## What this plugin does not require
+
+This plugin does **not** ask for:
+
+- Tuya IoT Developer Platform account
+- Tuya cloud project
+- Access ID
+- Access Secret
+- Tuya app username
+- Tuya app password
+- Country code / data center selection
+- Local device keys
+
+## Supported authentication method
+
+Only one connection method is supported:
+
+```text
+Tuya QR Cloud Authentication
+```
+
+Legacy connection methods were intentionally removed from this fork:
+
+```text
+Tuya IoT OpenAPI project credentials: removed
+Smart Home username/password cloud login: removed
+Local LAN / local-key mode: removed
+Hybrid cloud + local mode: removed
+```
+
+## Installation from Homebridge UI
+
+After the package is published to npm, users can install it from the Homebridge UI:
+
+1. Open Homebridge UI.
+2. Go to **Plugins**.
+3. Search for:
+
+```text
+homebridge-tuya-without-developer-account
+```
+
+4. Click **Install**.
+5. Open the plugin **Settings**.
+6. Enter your Tuya User Code.
+7. Click **Generate QR Code**.
+8. Scan the QR code with the Tuya Smart or Smart Life mobile app.
+9. Wait for the approval message.
+10. Click **Save Configuration**.
+11. Restart Homebridge.
+
+## Manual installation
+
+```bash
+npm install -g homebridge-tuya-without-developer-account
+```
+
+For the official Homebridge Linux service layout:
+
+```bash
+export PATH=/opt/homebridge/bin:$PATH
+npm install --prefix /var/lib/homebridge homebridge-tuya-without-developer-account
+hb-service restart
+```
+
+## Configuration
+
+The preferred configuration path is the Homebridge plugin GUI because the QR code is generated before saving.
+
+The saved config block looks like this:
+
+```json
+{
+  "platform": "TuyaNoDeveloperAccount",
+  "name": "Tuya without developer account",
+  "mode": "cloud",
+  "options": {
+    "projectType": "3",
+    "userCode": "YOUR_TUYA_USER_CODE"
+  }
+}
+```
+
+The plugin keeps `mode: "cloud"` and `projectType: "3"` internally only for compatibility with the original code structure. No other connection modes are supported.
+
+## Where to find the Tuya User Code
+
+In the Tuya Smart or Smart Life mobile app, find the **User Code** from the account/security area used by Tuya's Home Assistant QR authorization flow.
+
+Typical path:
+
+```text
+Tuya Smart / Smart Life app
+→ Me
+→ Settings
+→ Account and Security
+→ User Code
+```
+
+Tuya app layouts can change, so the exact path may vary by app version and region.
+
+## Token storage
+
+After QR approval, the plugin saves the token in the Homebridge storage folder:
+
+```text
+tuya-ha-qr-auth.<USER_CODE>.json
+```
+
+For official Linux Homebridge installs this is usually:
+
+```text
+/var/lib/homebridge/tuya-ha-qr-auth.<USER_CODE>.json
+```
+
+The file contains Tuya QR authentication tokens. Keep it private.
+
+## Re-authentication
+
+From the plugin settings UI:
+
+1. Enter the same User Code.
+2. Click **Clear Saved Auth**.
+3. Click **Generate QR Code**.
+4. Scan the new QR code.
+5. Save and restart Homebridge.
+
+Manual reset:
+
+```bash
+rm -f /var/lib/homebridge/tuya-ha-qr-auth.*.json
+hb-service restart
+```
+
+Then open the plugin settings and generate a new QR code.
+
+## Advanced options
+
+### Home whitelist
+
+Optional. Limit device discovery to specific Tuya home IDs.
+
+```json
+{
+  "options": {
+    "userCode": "YOUR_TUYA_USER_CODE",
+    "homeWhitelist": ["123456789"]
+  }
+}
+```
+
+### Device overrides
+
+Optional. Use only when a device is discovered with the wrong category or requires schema overrides.
+
+```json
+{
+  "options": {
+    "userCode": "YOUR_TUYA_USER_CODE",
+    "deviceOverrides": [
+      {
+        "id": "DEVICE_ID_OR_GLOBAL",
+        "category": "kg",
+        "unbridged": false
+      }
+    ]
+  }
+}
+```
+
+Use `
+`global` as the override ID to apply an override globally.
+
+## Troubleshooting
+
+### The QR code does not appear
+
+Make sure you opened the settings for this plugin, not another Tuya plugin. The plugin name should be:
+
+```text
+Tuya without developer account for Homebridge
+```
+
+Also make sure the package version is `1.0.0` or newer.
+
+### Homebridge starts but no devices are added
+
+Check the Homebridge logs. If you see:
+
+```text
+No saved QR authentication found
+```
+
+then the configuration was saved before the QR scan was approved. Open the plugin settings again, generate the QR code, scan it, wait for approval, save, and restart Homebridge.
+
+### Authentication expired or invalid
+
+Clear the saved auth from the plugin settings, generate a new QR code, scan it, save, and restart Homebridge.
+
+### Duplicate accessories
+
+Do not run this plugin and another Tuya Homebridge plugin against the same devices at the same time. Disable or remove the other Tuya platform block before using this plugin.
+
+## Package identity
+
+```text
+npm package: homebridge-tuya-without-developer-account
+Homebridge platform: TuyaNoDeveloperAccount
+Display name: Tuya without developer account for Homebridge
+```
+
+## Credits
+
+This project is based on the Homebridge Tuya plugin codebase and adapts the Tuya Home Assistant QR authorization model for Homebridge.
+
+## License
+
+MIT

package/SUPPORTED_DEVICES.md

@@ -0,0 +1,206 @@
+# Supported Tuya Devices
+
+First-class category name, sedond-class category name, category code can be found here:
+https://developer.tuya.com/docs/iot/standarddescription?id=K9i5ql6waswzq
+
+Most category code is pinyin abbreviation of Chinese name.
+
+## Lighting
+
+| Name | Name (zh) | Code | Homebridge Service | Supported | Links |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| Light | 光源 | dj<br> dsd | Lightbulb | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorydj?id=Kaiuyzy3eheyy) |
+| Ceiling Light | 吸顶灯 | xdd | Lightbulb | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/ceiling-light?id=Kaiuz03xxfc4r) |
+| Ambiance Light | 氛围灯 | fwd | Lightbulb | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/ambient-light?id=Kaiuz06amhe6g) |
+| String Lights | 灯串 | dc | Lightbulb | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/dc?id=Kaof7taxmvadu) |
+| Strip Lights | 灯带 | dd | Lightbulb | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/dd?id=Kaof804aibg2l) |
+| Motion Sensor Light | 感应灯 | gyd | Lightbulb<br> MotionSensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/gyd?id=Kaof8a8hycfmy) |
+| Ceiling Fan Light | 风扇灯 | fsd | Lightbulb<br> Fanv2 | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/fsd?id=Kaof8eiei4c2v) |
+| Solar Light | 太阳能灯 | tyndj | Lightbulb | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/tynd?id=Kaof8j02e1t98) |
+| Dimmer | 调光器 | tgq | Lightbulb | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/tgq?id=Kaof8ke9il4k4) |
+| Remote Control | 遥控器 | ykq | | | [Documentation](https://developer.tuya.com/en/docs/iot/ykq?id=Kaof8ljn81aov) |
+| Spotlight | 射灯 | sxd | Lightbulb | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/sxd?id=Kb7jayalltstu) |
+| White Noise Light | 白噪音灯 | bzyd | Lightbulb<br> Switch | ✅ | Documentation |
+
+
+## Electrical Products
+
+| Name | Name (zh) | Code | Homebridge Service | Supported | Links |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| Switch | 开关 | kg<br> tdq | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorykgczpc?id=Kaiuz08zj1l4y) |
+| Socket | 插座 | cz | Outlet | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorykgczpc?id=Kaiuz08zj1l4y) |
+| Power Strip | 排插 | pc | Outlet | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorykgczpc?id=Kaiuz08zj1l4y) |
+| Scene Switch | 场景开关 | cjkg | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorycjkg?id=Kaiuz0bcukqc5) |
+| Card Switch | 插卡取电开关 | ckqdkg | | | [Documentation](https://developer.tuya.com/en/docs/iot/categoryckqdkg?id=Kaiuz0e3wjryy) |
+| Curtain Switch | 窗帘开关 | clkg | Window Covering | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/category-clkg?id=Kaiuz0gitil39) |
+| Garage Door Opener | 车库门控制器 | ckmkzq | Garage Door Opener | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryckmkzq?id=Kaiuz0ipcboee) |
+| Dimmer Switch | 调光开关 | tgkg | Lightbulb | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorytgkg?id=Kaiuz0ktx7m0o) |
+| Fan Switch | 风扇开关 | fskg | Fanv2 | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryfskg?id=Kbcs129cl1gr9) |
+| Wireless Switch | 无线开关 | wxkg | Stateless Programmable Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/wxkg?id=Kbeo9t3ryuqm5) |
+| Scene Light Socket | 情景灯插座 | qjdcz | Switch | ✅ | Documentation |
+| Temperature Control Socket | 温控插座 | wkcz | Switch<br> Temperature Sensor<br> Humidity Sensor | ✅ | Documentation |
+
+
+## Large Home Appliances
+
+| Name | Name (zh) | Code | Homebridge Service | Supported | Links |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| Heater | 热水器 | rs | | | [Documentation](https://developer.tuya.com/en/docs/iot/categoryrs?id=Kaiuz0nfferyx) |
+| Ventilation System | 新风机 | xfj | | | [Documentation](https://developer.tuya.com/en/docs/iot/categoryxfj?id=Kaiuz0pphkowg) |
+| Refrigerator | 冰箱 | bx | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorybx?id=Kaiuz0s58ia6h) |
+| Bathtub | 浴缸 | yg | | | [Documentation](https://developer.tuya.com/en/docs/iot/categoryyg?id=Kaiuz0uoisp47) |
+| Washing Machine | 洗衣机 | xy | | | [Documentation](https://developer.tuya.com/en/docs/iot/categoryxy?id=Kaiuz0wxh08jf) |
+| Air Conditioner | 空调 | kt | Heater Cooler<br> Humidifier Dehumidifier<br> Fanv2<br> Temperature Sensor<br> Humidity Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorykt?id=Kaiuz0z71ov2n) |
+| Air Conditioner Controller | 空调控制器 | ktkzq | Heater Cooler<br> Humidifier Dehumidifier<br> Fanv2<br> Temperature Sensor<br> Humidity Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryktkzq?id=Kaiuz11eqy892) |
+| Boiler | 壁挂炉 | bgl | | | [Documentation](https://developer.tuya.com/en/docs/iot/boilerbgl?id=Kaiuz13shgrhp) |
+
+
+## Small Home Appliances
+
+| Name                       | Name (zh) | Code          | Homebridge Service | Supported | Links                                                                                    |
+|----------------------------| ---- |---------------| ---- | ---- |------------------------------------------------------------------------------------------|
+| Robot Vacuum               | 扫地机 | sd            | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorysd?id=Kaiuz16b2s6yd)      |
+| Heater                     | 取暖器 | qn<br>qn_old            | Heater Cooler | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryqn?id=Kaiuz18kih0sm)      |
+| Air Purifier               | 空气净化器 | kj            | Air Purifier | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorykj?id=Kaiuz1atqo5l7)      |
+| Drying Rack                | 晾衣架 | lyj           | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorylyj?id=Kaiuz1cy926vh)     |
+| Diffuser                   | 香薰机 | xxj           | Air Purifier<br> Lightbulb | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryxxj?id=Kaiuz1f9mo6bl)     |
+| Extraction hood            | 香薰机 | yyj           | Air Purifier<br> Lightbulb | ✅ | Documentation        |
+| Curtain                    | 窗帘 | cl            | Window Covering | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorycl?id=Kaiuz1hnpo7df)      |
+| Door and Window Controller | 门窗控制器 | mc            | Window | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorymc?id=Kaiuz1jyoassg)      |
+| Thermostat                 | 温控器 | wk            | Thermostat | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorywk?id=Kaiuz1m1xqnt6)      |
+| Thermostat Valve           | 温控阀 | wkf           | Thermostat | ✅ | Documentation                                                                            |
+| Bathroom Heater            | 浴霸 | yb            | | | [Documentation](https://developer.tuya.com/en/docs/iot/categoryyb?id=Kaiuz1oajgpib)      |
+| Irrigator                  | 灌溉器 | ggq<br> sfkzq | Valve | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryggq?id=Kaiuz1qib7z0k)     |
+| Humidifier                 | 加湿器 | jsq           | Humidifier Dehumidifier | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryjsq?id=Kaiuz1smr440b)     |
+| Dehumidifier               | 除湿机 | cs            | Humidifier Dehumidifier | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorycs?id=Kaiuz1vcz4dha)      |
+| Fan                        | 风扇 | fs            | Fanv2 | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryfs?id=Kaiuz1xweel1c)      |
+| Water Purifier             | 净水器 | js            | | | [Documentation](https://developer.tuya.com/en/docs/iot/categoryjs?id=Kaiuz204l58n9)      |
+| Electric Blanket           | 电热毯 | dr            | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorydr?id=Kaiuz22dyc66p)      |
+| Pet Treat Feeder           | 宠物弹射喂食器 | cwtswsq       | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorycwtswsq?id=Kaiuz24lq3fq5) |
+| Pet Ball Thrower           | 宠物网球发射器 | cwwqfsq       | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorycwwqfsq?id=Kaiuz26r7g1up) |
+| HVAC                       | 暖通器 | ntq           | | | [Documentation](https://developer.tuya.com/en/docs/iot/categoryntq?id=Kaiuz292sjqcz)     |
+| Pet Feeder                 | 宠物喂食器 | cwwsq         | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorycwwsq?id=Kaiuz2b6vydld)   |
+| Pet Fountain               | 宠物饮水机 | cwysj         | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorycwysj?id=Kaiuz2dfro0nd)   |
+| Sofa                       | 沙发 | sf            | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorysf?id=Kaiuz2fp9uqtt)      |
+| Electric Fireplace         | 电壁炉 | dbl           | | | [Documentation](https://developer.tuya.com/en/docs/iot/electric-fireplace?id=Kaiuz2hz4iyp6) |
+| Smart Milk Kettle          | 智能调奶器 | tnq           | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorytnq?id=Kakf01agbfkfa)     |
+| Cat Toilet                 | 猫砂盆 | msp           | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorymsp?id=Kakg2t7714ky7)     |
+| Towel Rack                 | 毛巾架 | mjj           | Thermostat | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorymjj?id=Kakkmlm9k4cir)     |
+| Smart Indoor Garden        | 植物生长机 | sz            | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorysz?id=Kaiuz4e6h7up0)      |
+
+
+## Kitchen Appliances
+
+| Name | Name (zh) | Code | Homebridge Service | Supported | Links |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| Smart Kettle | 电茶壶 | bh | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorybh?id=Kaiuz2kly679h) |
+| Bread Maker | 面包机 | mb | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorymb?id=Kaiuz2mrs0b2m) |
+| Coffee Maker | 咖啡机 | kfj | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorykfj?id=Kaiuz2p12pc7f) |
+| Bottle Warmer | 暖奶器 | nnq | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorynnq?id=Kaiuz2riz1s8d) |
+| Milk Dispenser | 冲奶机 | cn | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorycn?id=Kaiuz2tosvw2a) |
+| Sous Vide Cooker | 慢煮机 | mzj | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorymzj?id=Kaiuz2vy130ux) |
+| Rice Cabinet | 米柜 | mg | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorymg?id=Kaiuz2yb04ocu) |
+| Induction Cooker | 电磁炉 | dcl | | | [Documentation](https://developer.tuya.com/en/docs/iot/induction-cooker?id=Kaiuz30l7adxo) |
+| Air Fryer | 空气炸锅 | kqzg | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorykqzg?id=Kakda4kug3k1j) |
+| Bento Box | 智能饭盒 | znfh | | | [Documentation](https://developer.tuya.com/en/docs/iot/categoryznfh?id=Kako8jffneds3) |
+
+
+## Security & Video Surveillance
+
+| Name | Name (zh) | Code | Homebridge Service | Supported | Links |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| Alarm Host | 报警主机 | mal | Security System | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorymal?id=Kaiuz33clqxaf) |
+| Smart Camera | 智能摄像机 | sp | Motion Sensor<br> Doorbell | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorysp?id=Kaiuz35leyo12) |
+| Wireless Doorbell | 无线门铃 | wxml | StatelessProgrammableSwitch | ✅ | Documentation |
+| Siren Alarm | 声光报警传感器 | sgbj | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorysgbj?id=Kaiuz37tlpbnu) |
+| Gas Alarm | 燃气报警传感器 | rqbj | Leak Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryrqbj?id=Kaiuz3d162ubw) |
+| Smoke Alarm | 烟雾报警传感器 | ywbj | Smoke Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryywbj?id=Kaiuz3f6sf952) |
+| Temperature and Humidity Sensor | 温湿度传感器 | wsdcg | Temperature Sensor<br> Humidity Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorywsdcg?id=Kaiuz3hinij34) |
+| Contact Sensor | 门磁传感器 | mcs | Contact Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorymcs?id=Kaiuz3bnflmh2) |
+| Vibration Sensor | 震动传感器 | zd | Motion Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryzd?id=Kaiuz3a5vrzno) |
+| Water Detector | 水浸传感器 | sj | Leak Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorysj?id=Kaiuz3iub2sli) |
+| Luminance Sensor | 亮度传感器 | ldcg | Light Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryldcg?id=Kaiuz3n7u69l8) |
+| Pressure Sensor | 压力传感器 | ylcg<br> ylcgq | | | [Documentation](https://developer.tuya.com/en/docs/iot/categoryylcg?id=Kaiuz3kc2e4gm) |
+| Emergency Button | 紧急按钮 | sos | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorysos?id=Kaiuz3oi6agjy) |
+| PM2.5 Detector | PM2.5传感器 | pm25<br> pm2.5<br> pm25cgq | Air Quality Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorypm25?id=Kaiuz3qof3yfu) |
+| CO Detector | CO报警传感器 | cobj<br> cocgq | Carbon Monoxide Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorycobj?id=Kaiuz3u1j6q1v) |
+| CO2 Detector | CO2报警传感器 | co2bj<br> co2cgq | Carbon Dioxide Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryco2bj?id=Kaiuz3wes7yuy) |
+| Multi-functional Sensor | 多功能传感器 | dgnbj | | | [Documentation](https://developer.tuya.com/en/docs/iot/categorydgnbj?id=Kaiuz3yorvzg3) |
+| Methane Detector | 甲烷报警传感器 | jwbj | Leak Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryjwbj?id=Kaiuz40u98lkm) |
+| Human Motion Sensor | 人体运动传感器 | pir | Motion Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categorypir?id=Kaiuz3ss11b80) |
+| Human Presence Sensor | 人体存在传感器 | hps | Occupancy Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/categoryhps?id=Kaiuz42yhn1hs) |
+| Smart Lock | 智能门锁 | ms<br> jtmspro | LockMechanism | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/ms?id=Kb0o2s20fn9sy) |
+| Environmental Detector | 环境检测仪 | hjjcy | Air Quality Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/hjjcy?id=Kbeoad8y1nnlv) |
+
+
+## Exercise & Health
+
+| Name | Name (zh) | Code | Homebridge Service | Supported | Links |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| Massage Chair | 按摩椅 | amy | | | [Documentation](https://developer.tuya.com/en/docs/iot/categoryamy?id=Kaiuz4bmwxufp) |
+| Physiotherapy Products| 理疗产品 | liliao | | | [Documentation](https://developer.tuya.com/en/docs/iot/categoryliliao?id=Kakobe16fjw3l) |
+| Smart Jump Rope | 跳绳 | ts | | | [Documentation](https://developer.tuya.com/en/docs/iot/ts?id=Kat27rqhu47br) |
+| Body Fat Scale | 体脂秤 | tzc1 | | | [Documentation](https://developer.tuya.com/en/docs/iot/tzc1?id=Kat27zmbbs56t) |
+| Smart Watch/Fitness Tracker | 手表/手环 | sb | | | [Documentation](https://developer.tuya.com/en/docs/iot/sb?id=Kat28k7efsbi9) |
+| Smart Pill Box | 智能药盒 | znyh | | | [Documentation](https://developer.tuya.com/en/docs/iot/znyh?id=Kb2yxpjfcojdt) |
+
+
+## Gateway Control
+
+| Name | Name (zh) | Code | Homebridge Service | Supported | Links |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| Multifunctional Gateway | 多功能网关 | wg | | | [Documentation](https://developer.tuya.com/en/docs/iot/wg2?id=Kau22nplrptfe) |
+
+
+## Energy
+
+| Name | Name (zh) | Code | Homebridge Service | Supported | Links |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| Smart Electricity Meter | 智能电表 | zndb | | | [Documentation](https://developer.tuya.com/en/docs/iot/smart-meter?id=Kaiuz4gv6ack7) |
+| Smart Water Meter | 智能水表 | znsb | | | [Documentation](https://developer.tuya.com/en/docs/iot/smart-water-meter?id=Kaiuz4jf0jy9f) |
+| Circuit Breaker | 断路器 | dlq | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/iot/dlq?id=Kb0kidk9enyh8) |
+
+
+## Digital Entertainment
+
+| Name | Name (zh) | Code | Homebridge Service | Supported | Links |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| TV | 电视 | ds | | | [Documentation](https://developer.tuya.com/en/docs/iot/ds?id=Kat8px3b6tb9o) |
+| Projector | 投影仪 | tyy | | | [Documentation](https://developer.tuya.com/en/docs/iot/tyy?id=Kat8qpj75z0vv) |
+
+
+## Outdoor Travel
+
+| Name | Name (zh) | Code | Homebridge Service | Supported | Links |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| Tracker | 定位器 | tracker | | | [Documentation](https://developer.tuya.com/en/docs/iot/tracker?id=Kajk21wwy2mhi) |
+
+
+## IR Remote Control
+
+| Name | Name (zh) | Code | Homebridge Service | Supported | Links |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| Universal Remote Control | 万能遥控器 | wnykq<br> hwktwkq<br> wsdykq | Temperature Sensor<br> Humidity Sensor | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/ir-control-hub-open-service?id=Kb3oe2mk8ya72) |
+| TV | 电视 | infrared_tv | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-common-apis?id=Kb3oe2o7z0so9) |
+| STB | 机顶盒 | infrared_stb | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-common-apis?id=Kb3oe2o7z0so9) |
+| TV Box | 电视盒子 | infrared_box | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-common-apis?id=Kb3oe2o7z0so9) |
+| Air Conditioner | 空调 | infrared_ac | Heater Cooler<br> Humidifier Dehumidifier<br> Fanv2 | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-air-conditioner-apis?id=Kb3oe9ehg02fn) |
+| Fan | 电风扇 | infrared_fan | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-common-apis?id=Kb3oe2o7z0so9) |
+| Light | 灯 | infrared_light | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-common-apis?id=Kb3oe2o7z0so9) |
+| Amplifier | 音响 | infrared_amplifier | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-common-apis?id=Kb3oe2o7z0so9) |
+| Projector | 投影仪 | infrared_projector | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-common-apis?id=Kb3oe2o7z0so9) |
+| DVD | DVD | qt | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-common-apis?id=Kb3oe2o7z0so9) |
+| Camera | 相机 | qt | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-common-apis?id=Kb3oe2o7z0so9) |
+| Water Heater | 热水器 | infrared_waterheater | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-common-apis?id=Kb3oe2o7z0so9) |
+| Air Purifier | 净化器 | infrared_airpurifier | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-common-apis?id=Kb3oe2o7z0so9) |
+| DIY | - | qt | Switch | ✅ | [Documentation](https://developer.tuya.com/en/docs/cloud/infrared-learning-apis?id=Kb3oeap4nqqm3) |
+
+
+## Others
+
+| Name | Name (zh) | Code | Homebridge Service | Supported | Links |
+| ---- | ---- | ---- | ---- | ---- | ---- |
+| Fingerbot | 手指机器人 | szjqr | Switch | ✅ | Documentation |
+
+
+For the undocumented product category, you can try override it to the most similar one. See [ADVANCED_OPTIONS.md](./ADVANCED_OPTIONS.md).