homebridge-tuya-community 3.3.0

package/.eslintrc.js

@@ -0,0 +1,29 @@
+module.exports = {
+    env: {
+        node: true,
+        es2021: true
+    },
+    extends: 'eslint:recommended',
+    parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'script'
+    },
+    rules: {
+        // Relaxed for legacy codebase - only critical errors
+        'no-unused-vars': ['warn', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+        'no-console': 'off',
+        'no-empty': 'warn',
+        'no-constant-condition': 'warn',
+        'no-prototype-builtins': 'off',
+        'no-case-declarations': 'off',
+
+        // Disable style rules for legacy code
+        'semi': 'off',
+        'quotes': 'off',
+        'indent': 'off',
+        'comma-dangle': 'off',
+        'no-trailing-spaces': 'off',
+        'eol-last': 'off'
+    },
+    ignorePatterns: ['node_modules/', 'package-lock.json']
+};

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,40 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: iRayanKhan
+
+---
+
+**Checklist**
+- [ ] I have read the common issues wiki page
+- [ ] I have checked to make sure the plugin is up to date
+
+
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Environment (please complete the following information):**
+ - OS: 
+-  iOS version:
+-  Homehubs: 
+ - Node Version: 
+ - Plugin Version:
+-  Accessory Type
+
+
+
+**Additional context**
+Add any other context about the problem here.

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

@@ -0,0 +1,24 @@
+---
+name: New Device
+about: Question regarding support for a new device.
+title: 'New Device: '
+labels: 'newDevice'
+
+---
+
+**Describe your device**
+A clear and concise description of what your device is, such as accessory type, and product description.
+
+Example: Generic Brand Lightbulb with Hex Color support, and 255 brightness. 
+
+**Partial Support?**
+Does this device work in any fashion in the plugin? 
+
+**Device Schema**
+Please print your devices schema below:
+
+
+**Additional context**
+Add any other context about the problem here.
+
+

package/.github/workflows/codeql-analysis.yml

@@ -0,0 +1,67 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ master ]
+  schedule:
+    - cron: '31 12 * * 5'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'javascript' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python' ]
+        # Learn more:
+        # https://docs.github.com/en/free-pro-team@latest/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v1
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v1
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v1

package/.github/workflows/eslint.yml

@@ -0,0 +1,28 @@
+name: ESLint
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  eslint:
+    name: Run ESLint
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint
+        run: npm run lint

package/Changelog.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. This project uses [semantic versioning](https://semver.org/).
+
+## 3.3.0 (2026-01-09)
+
+### Added
+- **Light Switch support** - Multi-gang light switches with separate HomeKit accessories per gang
+  - `MultiLight` type for sequential DPs (1, 2, 3...)
+  - `CustomMultiLight` type for custom DP mappings with per-gang naming
+- **v3.5 protocol support** - Added GCM decryption for newer Tuya devices
+
+### Fixed
+- Fixed decryption issue in TuyaDiscovery (utf8 → binary encoding)
+- Fixed multiple connection attempts when using multi-gang accessories
+
+
+## 3.2.0 (2026-01-09)
+
+### 🎉 New Maintainer
+This plugin is now **homebridge-tuya-community**, a community-maintained fork of the original [homebridge-tuya](https://github.com/iRayanKhan/homebridge-tuya) by [@iRayanKhan](https://github.com/iRayanKhan).
+
+Now maintained by [@AxelDreemurr](https://github.com/AxelDreemurr).
+
+### Added
+- **Homebridge v2.0 support** - Full compatibility with Homebridge 2.0
+
+
+## 2.0.1 (2021-03-25)
+This update includes the following changes:
+
+[+] Fixes [#233](https://github.com/iRayanKhan/homebridge-tuya/issues/233#issue-833662092), where tempature divisor was not applying, thanks @xortuna [#238](https://github.com/iRayanKhan/homebridge-tuya/pull/238)
+
+[!] Note: The next release of this plugin (2.1.0) will change the config to "Tuya", instead of "TuyaLan". No change is needed 'till 2.1.0 is released.
+I am in need of beta testers for 2.1.0 once the next beta goes live, please stay tuned in the homebridge discord server for an announcement. 
+
+## 2.0.0 (2021-03-12)
+This update includes the following changes:
+
+* [+] Verified by Homebridge. [#264](https://github.com/homebridge/verified/issues/264)
+* [!] Note: The next release of this plugin (2.1.0) will change the config to "Tuya", instead of "TuyaLan". No change is needed 'till 2.1.0 is released.
+
+
+## 1.5.1 (2021-03-02)
+This update includes the following changes:
+
+* [+] Fix garage door accessory for Wofea devices, thanks @pelletip [#221](https://github.com/iRayanKhan/homebridge-tuya/pull/221)
+
+* [+] Fix log prefix for the following device types: BaseAccessory, RGBTWLight, SimpleBlinds(1), SimpleBlinds2, SimpleFanLight, SimpleHeater, SimpleLight, TuyaAccessory, and ValveAccessory.
+
+* [!] Warning: V2.0 will be released once this plugin is verified. The platform name will change from TuyaLan to just Tuya. Please be prepared once V2.0 comes out. No action is required at this time. 
+
+## 1.5.0 (2021-02-28)
+This update includes the following changes:
+
+* Updated dependencies [#215](https://github.com/iRayanKhan/homebridge-tuya/pull/215) + [#216](https://github.com/iRayanKhan/homebridge-tuya/pull/216)
+* Removed plugin prefix from Manufacturer (may have to clear cachedAccessories)
+* Fix crash on launch for garage accessory "ReferenceError: dps is not defined" [#201](https://github.com/iRayanKhan/homebridge-tuya/pull/201) Thanks @longzheng
+* Added dpStatus configuration for Wofea garage door [#202](https://github.com/iRayanKhan/homebridge-tuya/pull/202) Thanks @longzheng
+* Allow more numbers and strings for cmdLow, and cmdHigh [#204](https://github.com/iRayanKhan/homebridge-tuya/pull/204) Thanks @fra-iesus
+* Note: If you have custom logic or support for an unsupported accessory, please open a PR so it can be merged in!
+* Note: Update to Homebridge v1.3.1 to fix "No Response" for TW/RGBTW Lights. 
+
+## 1.4.0 (2021-02-14)
+Happy Valentines day!
+This update includes the following changes, courtesy of @davidh2075:
+
+* CachedAccessories Displayname now sync with the configuration [#196](https://github.com/iRayanKhan/homebridge-tuya/pull/196)
+* Fix for ECONNRESET spam [#197](https://github.com/iRayanKhan/homebridge-tuya/pull/197)
+* Support for Kogan garage door accessory [#198](https://github.com/iRayanKhan/homebridge-tuya/pull/198)
+
+
+## 1.3.0 (2021-01-25)
+* Added Adaptive Lighting to TW/RGBTW bulbs. Thanks @tom-23 [186]
+
+
+## 1.2.0 (2021-01-05)
+* Fix UDP errors in log, thanks @Giocirque [#78]
+* Merged fix for simpleFanLightAccessory DS-03 support, thanks @sholleman [#168]
+
+
+## 1.1 (2020-10-28)
+* Added Changelog.md
+* Added Oil Diffuser accessory, thanks @nitaybz    (#144) 
+* Added Dehumidifier accessory, thanks @fra-iesus  (#143)
+* Added AirPurifier  accessory, thanks @dhutchison (#139)
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 TuyAPI
+
+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,99 @@
+<p align="center">
+    <img src="https://raw.githubusercontent.com/iRayanKhan/homebridge-tuya/main/assets/Tuya-Plugin-Branding.png" height="100"><br>
+</p>
+
+
+<span align="center">
+
+# Homebridge-Tuya
+
+
+</span>
+
+
+
+Control your supported Tuya accessories locally in HomeKit
+
+* [Supported Device Types](#supported-device-types)
+* [Installation Instructions](#installation-instructions)
+* [Configuration](#configuration)
+* [Known Issues](#known-issues)
+* [Troubleshooting](#troubleshooting)
+* [Credits](#credits)
+* [License](#license)
+* [Donating](#donating)
+
+## Supported Device Types
+> Click the number next to your device to find the possible DataPoint "DP" values, then add as needed to your config.
+
+* Air Conditioner<sup>[1](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types#air-conditioners)</sup> 
+* Air Purifiers<sup>[2]()</sup>
+* Convectors<sup>[3](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types#heat-convectors)</sup>
+* Dehumidifers<sup>[4](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types)</sup>
+* Dimmers<sup>[5](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types#simple-dimmers)</sup>
+* Fan<sup>[6](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types)</sup>
+* Fan v2<sup>[7](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types)</sup>
+* Garages<sup>[8](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types#garage-doors)</sup>
+* Heaters<sup>[9](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types)</sup>
+* Lights
+  * On/Off<sup>[10](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types)</sup>
+  * Brightness<sup>[11](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types#tunable-white-light-bulbs)</sup>
+  * Color<sup>[12](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types#white-and-color-light-bulbs)</sup> (Hue, Saturation, Adaptive Lighting)
+* Light Switches (Multi-gang, each gang appears as separate accessory)
+  * Sequential (`MultiLight`) - uses DP 1, 2, 3...
+  * Custom (`CustomMultiLight`) - specify custom DPs per gang
+* Oil Diffusers<sup>[13](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types)</sup>
+* Outlets<sup>[14](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types#outlets)</sup>
+* Switches<sup>[15](https://github.com/iRayanKhan/homebridge-tuya/wiki/Supported-Device-Types)</sup>
+
+Note: Motion, and other sensor types don't behave well with responce requests, so they will not be added. 
+
+
+## Installation Instructions
+
+#### Option 1: Install via Homebridge Config UI X:
+
+Search for "Tuya" in [homebridge-config-ui-x](https://github.com/oznu/homebridge-config-ui-x) and install `homebridge-tuya-community`.
+
+#### Option 2: Manually Install:
+
+```
+sudo npm install -g homebridge-tuya-community
+```
+
+## Configuration
+> Homebridge UI
+
+1. Navigate to the Plugins page in [homebridge-config-ui-x](https://github.com/oznu/homebridge-config-ui-x).
+2. Click the **Settings** button for the Tuya plugin.
+3. Add your device types
+4. Add device parameters<sup>[10](apple.com/)</sup>
+5. Restart Homebridge or the plugin's child bridge for the changes to take effect.
+
+> Manual Configuration
+
+1. Edit the config.json file to add your device types, and parameters. 
+2. Restart Homebridge or the plugin's child bridge.
+
+
+## Known Issues
+
+1. If your devices add, but you can't control them, make sure you entered the DataPoint "DP" values for your device. 
+
+## Troubleshooting
+1. Make sure the plugin is up-to date
+2. Check for existing issues
+
+
+## Contributing
+
+If you have new accessory logic for a new device, please add a function defined by manufacturer, and describe your changes in the Readme file. 
+
+## Credits
+
+* [iRayanKhan](https://github.com/iRayanKhan) - original developer of the [homebridge-tuya](https://github.com/iRayanKhan/homebridge-tuya) plugin. 
+* [AMoo-Miki](https://github.com/AMoo-Miki) - developer of the [Tuya-Lan](https://github.com/AMoo-Miki/homebridge-tuya-lan) plugin which this plugin is based off. 
+* mxDanger - Plugin branding.
+* [CodeTheWeb](https://github.com/CodeTheWeb) - developer of [TuyaApi](https://github.com/codetheweb/tuyapi), who gratiously provided this repo's name.
+* [Oznu](https://github.com/oznu) - developer of Homebridge, added ```config.schema.json``` , fixed dependencies, and helped inspire this readME off his [gsh](https://github.com/oznu/homebridge-gsh) plugin.
+

package/bin/cli-decode.js

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+
+const YAML = require('yaml');
+const fs = require('fs-extra');
+const path = require('path');
+const program = require('commander');
+const crypto = require('crypto');
+const readline = require('readline');
+const async = require('async');
+
+let file;
+
+program
+    .name('tuya-lan decode')
+    .option('--key <key>', 'device key')
+    .option('--use <version>', 'override version string', '3.3')
+    .arguments('<file>')
+    .action(loc => {
+        file = loc;
+    })
+    .parse(process.argv);
+
+const crc32LookupTable = [];
+(() => {
+    for (let i = 0; i < 256; i++) {
+        let crc = i;
+        for (let j = 8; j > 0; j--) crc = (crc & 1) ? (crc >>> 1) ^ 3988292384 : crc >>> 1;
+        crc32LookupTable.push(crc);
+    }
+})();
+
+const getCRC32 = buffer => {
+    let crc = 0xffffffff;
+    for (let i = 0, len = buffer.length; i < len; i++) crc = crc32LookupTable[buffer[i] ^ (crc & 0xff)] ^ (crc >>> 8);
+    return ~crc;
+};
+
+const decodeLine = (key, input, log = true) => {
+    const encoding = (input.substr(0, 8) === '000055aa') ? 'hex' : 'base64';
+
+    let buffer = Buffer.from(input, encoding);
+    const raw = Buffer.from(input, encoding);
+    const len = buffer.length;
+    if (buffer.readUInt32BE(0) !== 0x000055aa || buffer.readUInt32BE(len - 4) !== 0x0000aa55) {
+        console.log("*** Input doesn't match the expected signature:", buffer.readUInt32BE(0).toString(16).padStart(8, '0'), buffer.readUInt32BE(len - 4).toString(16).padStart(8, '0'));
+        return rl.prompt();
+    }
+
+    // Try 3.3
+    const size = buffer.readUInt32BE(12);
+    const cmd = buffer.readUInt32BE(8);
+    const seq = buffer.readUInt32BE(4);
+    const crcIn = buffer.readInt32BE(len - 8);
+    const preHash = buffer.slice(0, len - 8);
+    if (log) {
+        console.log(`Cmd > ${cmd}  \tLen > ${len}\tSize > ${size}\tSeq > ${seq}`);
+        console.log(`CRC > \t${crcIn === getCRC32(preHash) ? 'Pass' : `Fail ${crcIn} ≠ ${getCRC32(preHash)}`}`);
+    }
+    const flag = buffer.readUInt32BE(16) & 0xFFFFFF00;
+    buffer = buffer.slice(len - size + (flag ? 0 : 4), len - 8);
+    if (buffer.indexOf(program.use || '3.3') !== -1) buffer = buffer.slice(15 + buffer.indexOf(program.use || '3.3'));
+    else if (buffer.indexOf('3.2') !== -1) buffer = buffer.slice(15 + buffer.indexOf('3.2'));
+
+    switch (cmd) {
+        case 7:
+        case 8:
+        case 10:
+        case 13:
+        case 16:
+            if (buffer.length === 0) {
+                console.log(`${('' + seq).padEnd(4)} Decoded ${cmd}> Empty`);
+                break;
+            }
+            try {
+                const decipher = crypto.createDecipheriv('aes-128-ecb', key, '');
+                let decryptedMsg = decipher.update(buffer, 'buffer', 'utf8');
+                decryptedMsg += decipher.final('utf8');
+
+                console.log(`${('' + seq).padEnd(4)} Decoded ${cmd}>`, decryptedMsg);
+                if (log) console.log(`${('' + seq).padEnd(4)} Raw ${cmd}>`, raw.toString('hex'));
+            } catch (ex) {
+                console.log(`${('' + seq).padEnd(4)}*Failed ${cmd}>`, raw.toString('hex'));
+            }
+            break;
+
+        case 9:
+            console.log(`${('' + seq).padEnd(4)} Decoded ${cmd}>`, flag ? 'Ping' : 'Pong');
+            break;
+
+        case 19:
+            let decryptedMsg;
+            try {
+                const decipher = crypto.createDecipheriv('aes-128-ecb', key, '');
+                decryptedMsg = decipher.update(buffer, 'buffer', 'utf8');
+                decryptedMsg += decipher.final('utf8');
+            } catch (ex) {
+                decryptedMsg = '';
+            }
+
+            if (!decryptedMsg) {
+                try {
+                    const decipher = crypto.createDecipheriv('aes-128-ecb', Buffer.from('6c1ec8e2bb9bb59ab50b0daf649b410a', 'hex'), '');
+                    decryptedMsg = decipher.update(buffer, 'buffer', 'utf8');
+                    decryptedMsg += decipher.final('utf8');
+                } catch (ex) {
+                    decryptedMsg = '';
+                }
+            }
+
+            if (!decryptedMsg) decryptedMsg = buffer.toString('utf8');
+
+            try {
+                JSON.parse(decryptedMsg);
+                console.log(`${('' + seq).padEnd(4)} Decoded ${cmd}>`, decryptedMsg);
+                if (log) console.log(`${('' + seq).padEnd(4)} Raw ${cmd}>`, raw.toString('hex'));
+            } catch (ex) {
+                console.log(`${('' + seq).padEnd(4)}*Failed ${cmd}>`, raw.toString('hex'));
+            }
+            break;
+
+        default:
+            console.log(`Unknown ${cmd}>`, raw.toString('hex'));
+    }
+};
+
+async.auto({
+    Key: next => {
+        if (program.key) return next(null, program.key);
+
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            prompt: '\nEnter the device key: ',
+            crlfDelay: Infinity
+        });
+
+        rl.prompt();
+
+        rl.on('line', line => {
+            const input = line.trim();
+            if (!input) return rl.prompt();
+
+            rl.close();
+            next(null, input);
+        });
+    },
+    File: ['Key', (data, next) => {
+        if (!file) return next();
+        let content;
+        try {
+            content = fs.readFileSync(path.resolve(file), 'utf8');
+        } catch (ex) {
+            console.error('Filed to read the file');
+            console.log(ex);
+            return next(true);
+        }
+
+        const packets = YAML.parseDocument(content);
+        if (Array.isArray(packets.errors) && packets.errors.length > 0) {
+            packets.errors.forEach(console.error);
+            return next(true);
+        }
+
+        const rows = packets.toJSON();
+
+        Object.keys(rows).forEach(key => {
+            decodeLine(data.Key, rows[key].replace(/\n/g, ''), false);
+        });
+
+        next();
+    }],
+    Line: ['File', (data, next) => {
+        if (file) return next();
+
+        console.log('\n\n*** Hit Ctrl+C or key in "exit" to end ***');
+
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            prompt: '\nEnter the encrypted message: ',
+            crlfDelay: Infinity
+        });
+
+        rl.prompt();
+
+        rl.on('line', line => {
+            const input = line.trim();
+            if (input.toLowerCase() === 'exit') process.exit(0);
+
+            decodeLine(data.Key, input);
+
+            rl.prompt();
+        }).on('close', () => {
+            process.exit(0);
+        });
+    }]
+});