Request for integration with Tuya

Terdious · February 26, 2026, 10:45am

I think I’m ready for a review of this PR that updates the Tuya integration by preparing the groundwork for the new connection and local detection:

github.com/GladysAssistant/Gladys

Tuya local baseline

master ← Terdious:tuya-local-baseline

ouvert 06:02PM - 15 Feb 26 UTC

Terdious

+4737 -194

### Pull Request check-list To ensure your Pull Request can be accepted as fa…st as possible, make sure to review and check all of these items: - [x] If your changes affect the code, did you write the tests? - [x] Are tests passing? (`npm test` on both front/server) - [x] Is the linter passing? (`npm run eslint` on both front/server) - [x] Did you run prettier? (`npm run prettier` on both front/server) - [x] If you are adding a new feature/service, did you run the integration comparator? (`npm run compare-translations` on front) - [x] Did you test this pull request in real life? With real devices? If this development is a big feature or a new service, we recommend that you provide a Docker image to the community ([forum](https://community.gladysassistant.com/)) for testing before merging. - [ ] If you are adding a new features/services which needs explanation, did you modify the user documentation? See [the GitHub repo](https://github.com/GladysAssistant/v4-website) and the [website](https://gladysassistant.com). - [ ] Did you add fake requests data for the demo mode (`front/src/config/demo.js`) so that the demo website is working without a backend? (if needed) See [https://demo.gladysassistant.com](https://demo.gladysassistant.com). NOTE: these things are not required to open a PR and can be done afterwards / while the PR is open. ### Description of change * **Translate** * +160 lines / -40 lines * **Front** * +995 lines / -66 lines * **Server** * +863 lines / -30 lines * **Package Tuya** * +103 lines / -2 lines * **Tests** * +1720 lines / -33 lines Before : <img width="1100" height="749" alt="image" src="https://github.com/user-attachments/assets/57742051-84b4-4fcd-8447-b6b0069f67e3" /><img width="1093" height="705" alt="image" src="https://github.com/user-attachments/assets/24718a52-4320-4da8-baa4-35a70f155418" /> After : - Ajout de champs pour la connexion - Client Secret caché - Ajout d'informations complémentaire pour la configuration - Ajout d'une gestion locale avec information - Ajout de logs spécifique quand non configuré <img width="894" height="920" alt="image" src="https://github.com/user-attachments/assets/80eb8ec5-5a4e-4acd-b8d1-50c9fc37e331" /> - Ajout de log de connexion <img width="896" height="920" alt="image" src="https://github.com/user-attachments/assets/e5d637c9-1305-420c-8955-d65257187db1" /> - Ajout de logs d'erreur sur mauvais client ID ou mauvais client secret <img width="904" height="306" alt="image" src="https://github.com/user-attachments/assets/4835591a-060e-4263-af46-bf2fe42d359b" /> <img width="897" height="302" alt="image" src="https://github.com/user-attachments/assets/99bd8154-e6e7-4472-bd02-609c0e285d9c" /> - Ajout d'un bouton de déconnexion manuelle pour rester déconnecté du cloud une fois tous ses appareils connectés en local avec logs d'info <img width="906" height="937" alt="image" src="https://github.com/user-attachments/assets/e5896c92-73c8-4354-a143-7a51639584e0" /> - Scan cloud pour retrouver les appareils présents sur ses applications avec loader d'information <img width="901" height="402" alt="image" src="https://github.com/user-attachments/assets/ac79d7c2-1480-408f-b3f1-ffbfd280444b" /> - Scan local auto qui scan le réseau local pour retrouver les appareils correspondants aux appareils cloud et complète automatiquement les informations complémentaires des appareils (notamment adresse ip et version du protocole) nécessaires à la gestion en local. <img width="896" height="370" alt="image" src="https://github.com/user-attachments/assets/ee33c000-d551-4e24-922a-3f4bedd5761e" /> - Liste des appareils découverts revu à la façon de Tasmota avec mise en ordre : Nouveaux appareils disponible à la création / puis appareils déjà créés à mettre à jour (nouvelles fonctionnalités ou autre) / puis Nouveaux appareils disponible mais non pris en charges (Possibilité de créer une issue github directement avec les informations de l'appareil récupérées, sans les informations "sensibles") / enfin les appareils déjà créés. - Les informations nécessaires ont été ajoutées pour guider l'utilisateur. - En cas d'ajout avec fonctionnement via le cloud, un simple clic sur Sauvegarder suffit - En cas d'ajout pour un fonctionnement local les explications présentent à partir du champs "Adresse IP" doivent permettre à l'utilisateur de faire ce qu'il faut si le bouton de "Scan local auto" n'a pas permis de trouver les appareils sur le réseau (base d'adresse IP différente de Gladys par exemple) - Les explications pour réaliser les opérations pour la proposition d'ajout d'un appareil non pris en charge sont indiquées. <img width="629" height="856" alt="image" src="https://github.com/user-attachments/assets/e49729ed-6389-40d9-a0f3-f560f671bea6" /> - Pour passer un appareil en local déjà créé précédemment en cloud, cliquer sur le bouton du champs "Adresse IP" pour passer de "Cloud" à "Local" - Le champs se vide alors et il faut rentrer une adresse IP valide. - Le bouton "Mettre à jour" (ou "Sauvegarder" depuis l'onglet "Appareils") restera bloqué tant que la vérification des DP n'est pas faite à l'aide du bouton "Poll des DP". Tout est expliqué. - Si la version du protocol n'est pas connu, il suffit de cliquer directement sur le bouton, toutes les versions seront testée (plus long). Si connue, sélectionner directement la version et lancer la vérification. Si aucun protocole ne fonctionne, soit l'adresse IP est mauvaise, soit une version du protocole n'est pas prise en charge. <img width="308" height="795" alt="image" src="https://github.com/user-attachments/assets/aa4467c4-aad1-42ef-837e-3ffb2b945cf1" /> <img width="313" height="523" alt="image" src="https://github.com/user-attachments/assets/008603c7-78be-4c60-817c-79dfc57cccb0" /> <img width="316" height="265" alt="image" src="https://github.com/user-attachments/assets/7cfd08da-70d1-440f-968c-3bbf8f0b0f25" /> <img width="314" height="280" alt="image" src="https://github.com/user-attachments/assets/7c5780d8-e999-4b9f-aff9-e6d5f69fae0a" /> - Une fois le "Poll local OK" on peut mettre à jour / sauvegarder. <img width="318" height="323" alt="image" src="https://github.com/user-attachments/assets/2247e1bc-8954-4820-bc85-51027281a5a5" /> ## Summary by CodeRabbit * **New Features** * Local UDP discovery and TCP local polling with in‑UI poll controls, device details (IDs, keys, IP, protocol), GitHub issue helper, and service status/disconnect endpoints. * **Improvements** * Enhanced cloud vs local setup flow and connection state messaging, auto-reconnect, protocol 3.5 handling, UDP port/scan feedback, IP masking, and local-first write fallback. * **Documentation** * Expanded EN/DE/FR translations and updated setup labels/placeholders. * **Tests** * Extensive new tests for local scan/poll, config, status, device param utilities, and disconnect flows.

Once this one is validated, I will update the following PR which adds protocol 3.5 necessary for new devices. A big advantage compared to HA is that this will be part of Gladys itself, whereas for HA you have to go through an external HACS integration. Additionally, we were able to integrate the creation of a GitHub issue that provides all the info to add devices/features not supported in Gladys:

github.com/GladysAssistant/Gladys

Add Tuya local protocol 3.5 support

master ← Terdious:tuya-local-protocol-3.5

ouvert 02:40AM - 21 Feb 26 UTC

Terdious

+5851 -303

### Pull Request check-list To ensure your Pull Request can be accepted as fa…st as possible, make sure to review and check all of these items: - [x] If your changes affect the code, did you write the tests? - [x] Are tests passing? (`npm test` on both front/server) - [x] Is the linter passing? (`npm run eslint` on both front/server) - [x] Did you run prettier? (`npm run prettier` on both front/server) - [x] If you are adding a new feature/service, did you run the integration comparator? (`npm run compare-translations` on front) - [ ] Did you test this pull request in real life? With real devices? If this development is a big feature or a new service, we recommend that you provide a Docker image to the community ([forum](https://community.gladysassistant.com/)) for testing before merging. - [ ] If your changes modify the API (REST or Node.js), did you modify the API documentation? (Documentation is based on comments in code) - [ ] If you are adding a new features/services which needs explanation, did you modify the user documentation? See [the GitHub repo](https://github.com/GladysAssistant/v4-website) and the [website](https://gladysassistant.com). - [ ] Did you add fake requests data for the demo mode (`front/src/config/demo.js`) so that the demo website is working without a backend? (if needed) See [https://demo.gladysassistant.com](https://demo.gladysassistant.com). NOTE: these things are not required to open a PR and can be done afterwards / while the PR is open. ### Description of change ## Summary - Add local protocol 3.5 support using npm modules `tuyapi` and `@demirdeniz/tuyapi-newgen`. - Improve local scan/poll/set flows and discovery resilience. ## Details - Local scan: 3.1/3.5 parsing, safer debug logs, sender IP fallback. - Local poll: retry strategy, timeout handling, listener cleanup, updated device refresh. - Set value: always disconnect on failures; 3.5 local API support. * **Front** (+ 1603 lines) * **Server** (+ 1351 lines) * **Languages** (+ 214 lines) * **Tests** (+ 2505 lines) * **Packages** (+ 344 lines) ## Summary by CodeRabbit * **New Features** * Local device polling with multi-protocol fallback, UDP local discovery, connection status, manual disconnect, reconnect logic, and cloud/local mode controls. * **UI** * Richer Tuya setup UI with new credential fields and connection states; device view shows masked IP, product/device identifiers, protocol/IP controls, local-poll actions, GitHub issue shortcut, and improved discovery ordering/status. * **Localization** * Expanded DE/EN/FR translations for setup, discovery, devices, statuses, errors, and guidance. * **Tests** * Extensive new and updated tests for local poll/scan, discovery, config, status, setValue, and lifecycle.

And finally another one will come with the setup of the base mapping for cloud vs local devices. I took the Smart Sockets to work on this base which will make it easier to add future devices/features:

github.com/GladysAssistant/Gladys

Tuya air conditioner support

master ← Terdious:tuya-air-conditioner-support

ouvert 01:59AM - 23 Feb 26 UTC

Terdious

+9297 -434

### Pull Request check-list To ensure your Pull Request can be accepted as fa…st as possible, make sure to review and check all of these items: - [ ] If your changes affect the code, did you write the tests? - [ ] Are tests passing? (`npm test` on both front/server) - [ ] Is the linter passing? (`npm run eslint` on both front/server) - [ ] Did you run prettier? (`npm run prettier` on both front/server) - [ ] If you are adding a new feature/service, did you run the integration comparator? (`npm run compare-translations` on front) - [ ] Did you test this pull request in real life? With real devices? If this development is a big feature or a new service, we recommend that you provide a Docker image to the community ([forum](https://community.gladysassistant.com/)) for testing before merging. - [ ] If your changes modify the API (REST or Node.js), did you modify the API documentation? (Documentation is based on comments in code) - [ ] If you are adding a new features/services which needs explanation, did you modify the user documentation? See [the GitHub repo](https://github.com/GladysAssistant/v4-website) and the [website](https://gladysassistant.com). - [ ] Did you add fake requests data for the demo mode (`front/src/config/demo.js`) so that the demo website is working without a backend? (if needed) See [https://demo.gladysassistant.com](https://demo.gladysassistant.com). NOTE: these things are not required to open a PR and can be done afterwards / while the PR is open. ### Description of change Summary Added a Tuya mapping registry with per‑device type mappings (cloud/local) and strict local mode for calibrated devices. Moved “ignored” DPS/codes to the backend mapping and exposed them in tuya_mapping, so the UI no longer hardcodes ignored DPS. Improved local DPS detection in the Tuya UI using device properties and applied mode‑specific counting (cloud vs local). Preserved temperature unit handling and existing conversions. Key changes New mapping structure under server/services/tuya/lib/mappings/ (global + air‑conditioner + smart‑socket; cloud/local). tuya.convertDevice now provides tuya_mapping with ignored_local_dps and ignored_cloud_codes. Tuya UI uses backend mapping to filter “unimplemented features”, and only uses local DPS when local mode is enabled. ## Summary by CodeRabbit * **New Features** * More air‑conditioning controls: fan‑speed, eco, drying, cleaning, aux‑heat, light, sleep, health. * Local network discovery and polling for Tuya devices. * GitHub issue workflow to suggest unsupported/partially supported devices. * **Improvements** * Richer Tuya device UI: cloud/local mode, IP/protocol controls, device ranking and partial‑support indicators, better connection states. * Automatic temperature‑unit detection and conversion. * Expanded translations (EN/DE/FR) and messaging.

Thanks in advance.

EDIT: After a full recheck, I saw that the PR should have been split into more elements. So I preferred to put it on standby. I just reopened it. @pierre-gilles it is ready for review. I’m referring to this one:

github.com/GladysAssistant/Gladys

Tuya local baseline

master ← Terdious:tuya-local-baseline

ouvert 06:02PM - 15 Feb 26 UTC

Terdious

+4737 -194

### Pull Request check-list To ensure your Pull Request can be accepted as fa…st as possible, make sure to review and check all of these items: - [x] If your changes affect the code, did you write the tests? - [x] Are tests passing? (`npm test` on both front/server) - [x] Is the linter passing? (`npm run eslint` on both front/server) - [x] Did you run prettier? (`npm run prettier` on both front/server) - [x] If you are adding a new feature/service, did you run the integration comparator? (`npm run compare-translations` on front) - [x] Did you test this pull request in real life? With real devices? If this development is a big feature or a new service, we recommend that you provide a Docker image to the community ([forum](https://community.gladysassistant.com/)) for testing before merging. - [ ] If you are adding a new features/services which needs explanation, did you modify the user documentation? See [the GitHub repo](https://github.com/GladysAssistant/v4-website) and the [website](https://gladysassistant.com). - [ ] Did you add fake requests data for the demo mode (`front/src/config/demo.js`) so that the demo website is working without a backend? (if needed) See [https://demo.gladysassistant.com](https://demo.gladysassistant.com). NOTE: these things are not required to open a PR and can be done afterwards / while the PR is open. ### Description of change * **Translate** * +160 lines / -40 lines * **Front** * +995 lines / -66 lines * **Server** * +863 lines / -30 lines * **Package Tuya** * +103 lines / -2 lines * **Tests** * +1720 lines / -33 lines Before : <img width="1100" height="749" alt="image" src="https://github.com/user-attachments/assets/57742051-84b4-4fcd-8447-b6b0069f67e3" /><img width="1093" height="705" alt="image" src="https://github.com/user-attachments/assets/24718a52-4320-4da8-baa4-35a70f155418" /> After : - Ajout de champs pour la connexion - Client Secret caché - Ajout d'informations complémentaire pour la configuration - Ajout d'une gestion locale avec information - Ajout de logs spécifique quand non configuré <img width="894" height="920" alt="image" src="https://github.com/user-attachments/assets/80eb8ec5-5a4e-4acd-b8d1-50c9fc37e331" /> - Ajout de log de connexion <img width="896" height="920" alt="image" src="https://github.com/user-attachments/assets/e5d637c9-1305-420c-8955-d65257187db1" /> - Ajout de logs d'erreur sur mauvais client ID ou mauvais client secret <img width="904" height="306" alt="image" src="https://github.com/user-attachments/assets/4835591a-060e-4263-af46-bf2fe42d359b" /> <img width="897" height="302" alt="image" src="https://github.com/user-attachments/assets/99bd8154-e6e7-4472-bd02-609c0e285d9c" /> - Ajout d'un bouton de déconnexion manuelle pour rester déconnecté du cloud une fois tous ses appareils connectés en local avec logs d'info <img width="906" height="937" alt="image" src="https://github.com/user-attachments/assets/e5896c92-73c8-4354-a143-7a51639584e0" /> - Scan cloud pour retrouver les appareils présents sur ses applications avec loader d'information <img width="901" height="402" alt="image" src="https://github.com/user-attachments/assets/ac79d7c2-1480-408f-b3f1-ffbfd280444b" /> - Scan local auto qui scan le réseau local pour retrouver les appareils correspondants aux appareils cloud et complète automatiquement les informations complémentaires des appareils (notamment adresse ip et version du protocole) nécessaires à la gestion en local. <img width="896" height="370" alt="image" src="https://github.com/user-attachments/assets/ee33c000-d551-4e24-922a-3f4bedd5761e" /> - Liste des appareils découverts revu à la façon de Tasmota avec mise en ordre : Nouveaux appareils disponible à la création / puis appareils déjà créés à mettre à jour (nouvelles fonctionnalités ou autre) / puis Nouveaux appareils disponible mais non pris en charges (Possibilité de créer une issue github directement avec les informations de l'appareil récupérées, sans les informations "sensibles") / enfin les appareils déjà créés. - Les informations nécessaires ont été ajoutées pour guider l'utilisateur. - En cas d'ajout avec fonctionnement via le cloud, un simple clic sur Sauvegarder suffit - En cas d'ajout pour un fonctionnement local les explications présentent à partir du champs "Adresse IP" doivent permettre à l'utilisateur de faire ce qu'il faut si le bouton de "Scan local auto" n'a pas permis de trouver les appareils sur le réseau (base d'adresse IP différente de Gladys par exemple) - Les explications pour réaliser les opérations pour la proposition d'ajout d'un appareil non pris en charge sont indiquées. <img width="629" height="856" alt="image" src="https://github.com/user-attachments/assets/e49729ed-6389-40d9-a0f3-f560f671bea6" /> - Pour passer un appareil en local déjà créé précédemment en cloud, cliquer sur le bouton du champs "Adresse IP" pour passer de "Cloud" à "Local" - Le champs se vide alors et il faut rentrer une adresse IP valide. - Le bouton "Mettre à jour" (ou "Sauvegarder" depuis l'onglet "Appareils") restera bloqué tant que la vérification des DP n'est pas faite à l'aide du bouton "Poll des DP". Tout est expliqué. - Si la version du protocol n'est pas connu, il suffit de cliquer directement sur le bouton, toutes les versions seront testée (plus long). Si connue, sélectionner directement la version et lancer la vérification. Si aucun protocole ne fonctionne, soit l'adresse IP est mauvaise, soit une version du protocole n'est pas prise en charge. <img width="308" height="795" alt="image" src="https://github.com/user-attachments/assets/aa4467c4-aad1-42ef-837e-3ffb2b945cf1" /> <img width="313" height="523" alt="image" src="https://github.com/user-attachments/assets/008603c7-78be-4c60-817c-79dfc57cccb0" /> <img width="316" height="265" alt="image" src="https://github.com/user-attachments/assets/7cfd08da-70d1-440f-968c-3bbf8f0b0f25" /> <img width="314" height="280" alt="image" src="https://github.com/user-attachments/assets/7c5780d8-e999-4b9f-aff9-e6d5f69fae0a" /> - Une fois le "Poll local OK" on peut mettre à jour / sauvegarder. <img width="318" height="323" alt="image" src="https://github.com/user-attachments/assets/2247e1bc-8954-4820-bc85-51027281a5a5" /> ## Summary by CodeRabbit * **New Features** * Local UDP discovery and TCP local polling with in‑UI poll controls, device details (IDs, keys, IP, protocol), GitHub issue helper, and service status/disconnect endpoints. * **Improvements** * Enhanced cloud vs local setup flow and connection state messaging, auto-reconnect, protocol 3.5 handling, UDP port/scan feedback, IP masking, and local-first write fallback. * **Documentation** * Expanded EN/DE/FR translations and updated setup labels/placeholders. * **Tests** * Extensive new tests for local scan/poll, config, status, device param utilities, and disconnect flows.

Terdious · February 27, 2026, 3:38pm

Once the previous one is validated, I will update the following PRs :

Addition of protocol 3.5 required for recent devices. Big advantage compared to Home Assistant (HA): this will be an integral part of Gladys, whereas for Home Assistant you have to go through an external HACS integration:

github.com/GladysAssistant/Gladys

Add Tuya local protocol 3.5 support

master ← Terdious:tuya-local-protocol-3.5

ouvert 02:40AM - 21 Feb 26 UTC

Terdious

+5851 -303

### Pull Request check-list To ensure your Pull Request can be accepted as fa…st as possible, make sure to review and check all of these items: - [x] If your changes affect the code, did you write the tests? - [x] Are tests passing? (`npm test` on both front/server) - [x] Is the linter passing? (`npm run eslint` on both front/server) - [x] Did you run prettier? (`npm run prettier` on both front/server) - [x] If you are adding a new feature/service, did you run the integration comparator? (`npm run compare-translations` on front) - [ ] Did you test this pull request in real life? With real devices? If this development is a big feature or a new service, we recommend that you provide a Docker image to the community ([forum](https://community.gladysassistant.com/)) for testing before merging. - [ ] If your changes modify the API (REST or Node.js), did you modify the API documentation? (Documentation is based on comments in code) - [ ] If you are adding a new features/services which needs explanation, did you modify the user documentation? See [the GitHub repo](https://github.com/GladysAssistant/v4-website) and the [website](https://gladysassistant.com). - [ ] Did you add fake requests data for the demo mode (`front/src/config/demo.js`) so that the demo website is working without a backend? (if needed) See [https://demo.gladysassistant.com](https://demo.gladysassistant.com). NOTE: these things are not required to open a PR and can be done afterwards / while the PR is open. ### Description of change ## Summary - Add local protocol 3.5 support using npm modules `tuyapi` and `@demirdeniz/tuyapi-newgen`. - Improve local scan/poll/set flows and discovery resilience. ## Details - Local scan: 3.1/3.5 parsing, safer debug logs, sender IP fallback. - Local poll: retry strategy, timeout handling, listener cleanup, updated device refresh. - Set value: always disconnect on failures; 3.5 local API support. * **Front** (+ 1603 lines) * **Server** (+ 1351 lines) * **Languages** (+ 214 lines) * **Tests** (+ 2505 lines) * **Packages** (+ 344 lines) ## Summary by CodeRabbit * **New Features** * Local device polling with multi-protocol fallback, UDP local discovery, connection status, manual disconnect, reconnect logic, and cloud/local mode controls. * **UI** * Richer Tuya setup UI with new credential fields and connection states; device view shows masked IP, product/device identifiers, protocol/IP controls, local-poll actions, GitHub issue shortcut, and improved discovery ordering/status. * **Localization** * Expanded DE/EN/FR translations for setup, discovery, devices, statuses, errors, and guidance. * **Tests** * Extensive new and updated tests for local poll/scan, discovery, config, status, setValue, and lifecycle.

Implementation of the base mapping of cloud vs local devices. I used the Smart Sockets to work on this base which will make it easier to add future devices/features:

github.com/GladysAssistant/Gladys

Tuya - add mapping core for local/cloud device handling - PR3

master ← Terdious:tuya-local-mapping-core

ouvert 12:04PM - 27 Feb 26 UTC

Terdious

+6202 -324

### Pull Request check-list To ensure your Pull Request can be accepted as fa…st as possible, make sure to review and check all of these items: - [ ] If your changes affect the code, did you write the tests? - [ ] Are tests passing? (`npm test` on both front/server) - [ ] Is the linter passing? (`npm run eslint` on both front/server) - [ ] Did you run prettier? (`npm run prettier` on both front/server) - [ ] If you are adding a new feature/service, did you run the integration comparator? (`npm run compare-translations` on front) - [ ] Did you test this pull request in real life? With real devices? If this development is a big feature or a new service, we recommend that you provide a Docker image to the community ([forum](https://community.gladysassistant.com/)) for testing before merging. - [ ] If your changes modify the API (REST or Node.js), did you modify the API documentation? (Documentation is based on comments in code) - [ ] If you are adding a new features/services which needs explanation, did you modify the user documentation? See [the GitHub repo](https://github.com/GladysAssistant/v4-website) and the [website](https://gladysassistant.com). - [ ] Did you add fake requests data for the demo mode (`front/src/config/demo.js`) so that the demo website is working without a backend? (if needed) See [https://demo.gladysassistant.com](https://demo.gladysassistant.com). NOTE: these things are not required to open a PR and can be done afterwards / while the PR is open. ### Description of change This PR introduces a mapping core for Tuya devices to make local/cloud handling more consistent and future device integrations easier. ## Summary - Add a Tuya **mapping core** to structure local/cloud mappings and simplify future device support. - Introduce first concrete mapping set for **smart-socket** with controlled fallback behavior. ## Details - Add mapping modules: - `server/services/tuya/lib/mappings/cloud/{global,smart-socket}.js` - `server/services/tuya/lib/mappings/local/{global,smart-socket}.js` - `server/services/tuya/lib/mappings/index.js` - Add local mapping resolver: - `server/services/tuya/lib/device/tuya.localMapping.js` - Update conversion/poll/set paths to use mapping selection and fallback consistently. - Add dedicated tests for mappings and local mapping resolver behavior. ## Diff metrics ### Logical delta (vs `tuya-local-protocol-3.5`) - **Total:** `+1340 / -171` (29 files) - **Front:** `-3` - **Server:** `+658` - **Languages:** `-3` - **Tests:** `+517` - **Packages:** `+0` ### GitHub compare view (vs `master`, cumulative stack) - **Total:** `+6204 / -324` (63 files) - **Front:** `+972` - **Server:** `+1817` - **Languages:** `+132` - **Tests:** `+2783` - **Packages:** `+176` ## Validation - `npm run test-service --service=tuya` - Result: **175 passing** ## Summary by CodeRabbit * **New Features** * Local polling and UDP local discovery for Tuya devices (faster detection and direct device checks). * Local/cloud mode toggle with hybrid polling and manual cloud disconnect. * Save/connect flow with explicit connect/disconnect controls and status feedback. * **Improvements** * Expanded setup and discovery UI text, validation and error messages; clearer Client ID/Secret and App UID fields. * Device panel shows protocol, IP, identifiers and local poll status; better success/error indicators.

They are also ready and are just waiting for the first one ^^

Then I separated a PR for integrating the automatic creation of GitHub issues.

github.com/GladysAssistant/Gladys

Tuya - add GitHub issue assistant for unsupported and partially supported devices - PR4

master ← Terdious:tuya-local-github-issues

ouvert 04:37PM - 27 Feb 26 UTC

Terdious

+7183 -339

### Pull Request check-list To ensure your Pull Request can be accepted as fa…st as possible, make sure to review and check all of these items: - [ ] If your changes affect the code, did you write the tests? - [ ] Are tests passing? (`npm test` on both front/server) - [ ] Is the linter passing? (`npm run eslint` on both front/server) - [ ] Did you run prettier? (`npm run prettier` on both front/server) - [ ] If you are adding a new feature/service, did you run the integration comparator? (`npm run compare-translations` on front) - [ ] Did you test this pull request in real life? With real devices? If this development is a big feature or a new service, we recommend that you provide a Docker image to the community ([forum](https://community.gladysassistant.com/)) for testing before merging. - [ ] If your changes modify the API (REST or Node.js), did you modify the API documentation? (Documentation is based on comments in code) - [ ] If you are adding a new features/services which needs explanation, did you modify the user documentation? See [the GitHub repo](https://github.com/GladysAssistant/v4-website) and the [website](https://gladysassistant.com). - [ ] Did you add fake requests data for the demo mode (`front/src/config/demo.js`) so that the demo website is working without a backend? (if needed) See [https://demo.gladysassistant.com](https://demo.gladysassistant.com). NOTE: these things are not required to open a PR and can be done afterwards / while the PR is open. ### Description of change ## Summary This PR restores and improves the Tuya GitHub issue creation flow from the device discovery UI. It helps users report unsupported Tuya devices (or missing features) with a structured payload, while masking sensitive information. ## Scope - Frontend only. - No server/API behavior change in this PR. - No protocol/mapping logic change in this PR. ## What was added - Add a "Suggest this device" flow for unsupported models. - Add a "Suggest new functions" flow for partially supported models. - Detect partially supported devices using: - unknown local DPS keys (when local poll DPS is available), - unknown cloud specification codes (fallback). - Build a structured JSON payload for GitHub issue body. - Mask sensitive fields in payload: - `LOCAL_KEY`, - IP values (`IP_ADDRESS`, `CLOUD_IP`). - Check if a similar GitHub issue already exists before opening a new one. - Add cache for GitHub search requests. - Handle long payloads: - if URL is too long, show payload in textarea, - allow copy-to-clipboard, - allow opening an empty GitHub issue with title only. - Add/complete EN/FR/DE i18n keys used by this flow. ## Files changed - `front/src/routes/integration/all/tuya/TuyaDeviceBox.jsx` - `front/src/config/i18n/en.json` - `front/src/config/i18n/fr.json` - `front/src/config/i18n/de.json` ## Diff stats - `TuyaDeviceBox.jsx`: `+703 / -81` - `en.json`: `+12 / -1` - `fr.json`: `+12 / -1` - `de.json`: `+12 / -1` - Total: `+739 / -84` across 4 files ## Validation performed - `npx eslint src/routes/integration/all/tuya/TuyaDeviceBox.jsx src/config/i18n/en.json src/config/i18n/fr.json src/config/i18n/de.json` - `npm run compare-translations` (front) ## Notes - This PR is intended as a stacked step after mapping-core work. - If compared directly against `master`, GitHub may show additional changes from previous stacked PRs. ## Summary by CodeRabbit * **New Features** * Local network discovery, local polling/control, and hybrid cloud/local device handling for Tuya devices * Real-time connection status with auto-reconnect and manual cloud disconnect * GitHub issue helper to report or suggest device features * **Improvements** * Richer device metadata shown (IDs, keys, protocol, IP) and improved discovery ordering * Enhanced setup UI: clearer credential labels, app username, secret visibility toggle, validation/status messages * **Localization** * Added extensive EN/FR/DE translations for Tuya workflows and messages

pierre-gilles · March 2, 2026, 4:13pm

Thanks a lot for the PRs, I’ll let you know once I’ve had a chance to look!

Terdious · March 3, 2026, 7:15am

@Papashultz and @GBoulvin, I just restarted a build on the same test image, I would be very interested in your new test and your feedback.

For info @GBoulvin I added support for these issues:

github.com/GladysAssistant/Gladys

Tuya (local) [b61eihfqeaexn54g]: Add support for LSC Power Plug FR incl. Power meter (partially supported)

ouvert 04:40PM - 24 Feb 26 UTC

gboulvin

```json { "id": "be2e78e9-3b66-413a-966e-cd8c90c5947a", "name": "Chauffage c…abinet", "selector": "tuya-bf2be3c32ea4d8f561ujmu", "model": "LSC Power Plug FR incl. Power meter", "external_id": "tuya:bf2be3c32ea4d8f561ujmu", "service_id": "966ff9b2-7d5d-4c88-aa54-80c406d5743d", "product_id": "b61eihfqeaexn54g", "product_key": null, "online": true, "protocol_version": "3.5", "local_override": true, "specifications": { "functions": [ { "code": "switch_1", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Switch 1", "type": "Boolean", "values": "{}" }, { "code": "countdown_1", "lang_config": { "unit": "Second" }, "name": "Countdown 1", "type": "Integer", "values": "{\"unit\":\"s\",\"min\":0,\"max\":86400,\"scale\":0,\"step\":1}" }, { "code": "relay_status", "lang_config": { "last": "Remember last status", "power_off": "OFF", "power_on": "" }, "name": "Relay Status", "type": "Enum", "values": "{\"range\":[\"power_off\",\"power_on\",\"last\"]}" }, { "code": "overcharge_switch", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Overcharge Switch", "type": "Boolean", "values": "{}" }, { "code": "light_mode", "lang_config": { "none": "OFF", "pos": "Indicate switch location", "relay": "Indicate switch on/off" }, "name": "Light Mode", "type": "Enum", "values": "{\"range\":[\"relay\",\"pos\",\"none\"]}" }, { "code": "child_lock", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Child Lock", "type": "Boolean", "values": "{}" }, { "code": "cycle_time", "lang_config": { "unit": "" }, "name": "Cycle Time", "type": "String", "values": "{}" }, { "code": "random_time", "lang_config": { "unit": "" }, "name": "Random Time", "type": "String", "values": "{}" }, { "code": "switch_inching", "lang_config": { "unit": "" }, "name": "Switch Inching", "type": "String", "values": "{}" } ], "status": [ { "code": "switch_1", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Switch 1", "type": "Boolean", "values": "{}" }, { "code": "countdown_1", "lang_config": { "unit": "Second" }, "name": "Countdown 1", "type": "Integer", "values": "{\"unit\":\"s\",\"min\":0,\"max\":86400,\"scale\":0,\"step\":1}" }, { "code": "add_ele", "lang_config": { "unit": "" }, "name": "Electricity", "type": "Integer", "values": "{\"min\":0,\"max\":50000,\"scale\":3,\"step\":100}" }, { "code": "cur_current", "lang_config": { "unit": "Milliampere" }, "name": "Current", "type": "Integer", "values": "{\"unit\":\"mA\",\"min\":0,\"max\":30000,\"scale\":0,\"step\":1}" }, { "code": "cur_power", "lang_config": { "unit": "W" }, "name": "Power", "type": "Integer", "values": "{\"unit\":\"W\",\"min\":0,\"max\":80000,\"scale\":1,\"step\":1}" }, { "code": "cur_voltage", "lang_config": { "unit": "Volt" }, "name": "Voltage", "type": "Integer", "values": "{\"unit\":\"V\",\"min\":0,\"max\":5000,\"scale\":1,\"step\":1}" }, { "code": "voltage_coe", "lang_config": { "unit": "" }, "name": "Voltage Coe", "type": "Integer", "values": "{\"min\":0,\"max\":1000000,\"scale\":0,\"step\":1}" }, { "code": "electric_coe", "lang_config": { "unit": "" }, "name": "Electric Coe", "type": "Integer", "values": "{\"min\":0,\"max\":1000000,\"scale\":0,\"step\":1}" }, { "code": "power_coe", "lang_config": { "unit": "" }, "name": "Power Coe", "type": "Integer", "values": "{\"min\":0,\"max\":1000000,\"scale\":0,\"step\":1}" }, { "code": "electricity_coe", "lang_config": { "unit": "" }, "name": "Electricity Coe", "type": "Integer", "values": "{\"min\":0,\"max\":1000000,\"scale\":0,\"step\":1}" }, { "code": "fault", "lang_config": { "ls_cr": "loss of flow fault", "ls_pow": "loss of power fault", "ls_vol": "loss of voltage fault", "ov_cr": "overcurrent fault", "ov_pwr": "over power fault", "ov_vol": "overvoltage fault" }, "name": "Fault", "type": "Bitmap", "values": "{\"label\":[\"ov_cr\",\"ov_vol\",\"ov_pwr\",\"ls_cr\",\"ls_vol\",\"ls_pow\"]}" }, { "code": "relay_status", "lang_config": { "last": "Remember last status", "power_off": "OFF", "power_on": "" }, "name": "Relay Status", "type": "Enum", "values": "{\"range\":[\"power_off\",\"power_on\",\"last\"]}" }, { "code": "overcharge_switch", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Overcharge Switch", "type": "Boolean", "values": "{}" }, { "code": "light_mode", "lang_config": { "none": "OFF", "pos": "Indicate switch location", "relay": "Indicate switch on/off" }, "name": "Light Mode", "type": "Enum", "values": "{\"range\":[\"relay\",\"pos\",\"none\"]}" }, { "code": "child_lock", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Child Lock", "type": "Boolean", "values": "{}" }, { "code": "cycle_time", "lang_config": { "unit": "" }, "name": "Cycle Time", "type": "String", "values": "{}" }, { "code": "random_time", "lang_config": { "unit": "" }, "name": "Random Time", "type": "String", "values": "{}" }, { "code": "switch_inching", "lang_config": { "unit": "" }, "name": "Switch Inching", "type": "String", "values": "{}" } ] }, "properties": { "properties": [ { "code": "switch_1", "custom_name": "", "dp_id": 1, "time": 1771777823927, "type": "bool", "value": false }, { "code": "countdown_1", "custom_name": "", "dp_id": 9, "time": 1771777824455, "type": "value", "value": 0 }, { "code": "add_ele", "custom_name": "", "dp_id": 17, "time": 1771779631214, "type": "value", "value": 1 }, { "code": "cur_current", "custom_name": "", "dp_id": 18, "time": 1771777824455, "type": "value", "value": 0 }, { "code": "cur_power", "custom_name": "", "dp_id": 19, "time": 1771777824455, "type": "value", "value": 0 }, { "code": "cur_voltage", "custom_name": "", "dp_id": 20, "time": 1771949581664, "type": "value", "value": 2340 }, { "code": "test_bit", "custom_name": "", "dp_id": 21, "time": 1771777824455, "type": "value", "value": 1 }, { "code": "voltage_coe", "custom_name": "", "dp_id": 22, "time": 1771777824455, "type": "value", "value": 566 }, { "code": "electric_coe", "custom_name": "", "dp_id": 23, "time": 1771777824455, "type": "value", "value": 26471 }, { "code": "power_coe", "custom_name": "", "dp_id": 24, "time": 1771777824455, "type": "value", "value": 14621 }, { "code": "electricity_coe", "custom_name": "", "dp_id": 25, "time": 1771777824455, "type": "value", "value": 2840 }, { "code": "fault", "custom_name": "", "dp_id": 26, "time": 1771777824455, "type": "bitmap", "value": 0 }, { "code": "relay_status", "custom_name": "", "dp_id": 38, "time": 1771777824455, "type": "enum", "value": "memory" }, { "code": "overcharge_switch", "custom_name": "", "dp_id": 39, "time": 1771777824455, "type": "bool", "value": false }, { "code": "light_mode", "custom_name": "", "dp_id": 40, "time": 1771777824455, "type": "enum", "value": "relay" }, { "code": "child_lock", "custom_name": "", "dp_id": 41, "time": 1771777824455, "type": "bool", "value": false }, { "code": "cycle_time", "custom_name": "", "dp_id": 42, "time": 1771704520013, "type": "string", "value": "" }, { "code": "random_time", "custom_name": "", "dp_id": 43, "time": 1771704520007, "type": "string", "value": "" }, { "code": "switch_inching", "custom_name": "", "dp_id": 44, "time": 1771777824455, "type": "string", "value": "" } ] }, "thing_model": { "modelId": "e1n2e11c", "services": [ { "actions": [], "code": "", "description": "", "events": [], "name": "", "properties": [ { "abilityId": 1, "accessMode": "rw", "code": "switch_1", "description": "", "extensions": { "iconName": "icon-dp_power2", "attribute": "641" }, "name": "开关1", "typeSpec": { "type": "bool" } }, { "abilityId": 9, "accessMode": "rw", "code": "countdown_1", "description": "", "extensions": { "iconName": "icon-dp_time2", "attribute": "736" }, "name": "倒计时1", "typeSpec": { "type": "value", "max": 86400, "min": 0, "scale": 0, "step": 1, "unit": "s" } }, { "abilityId": 17, "accessMode": "ro", "code": "add_ele", "description": "", "extensions": { "attribute": "736", "trigger": "direct" }, "name": "增加电量", "typeSpec": { "type": "value", "max": 50000, "min": 0, "scale": 3, "step": 100 } }, { "abilityId": 18, "accessMode": "ro", "code": "cur_current", "description": "", "extensions": { "attribute": "704" }, "name": "电流", "typeSpec": { "type": "value", "max": 30000, "min": 0, "scale": 0, "step": 1, "unit": "mA" } }, { "abilityId": 19, "accessMode": "ro", "code": "cur_power", "description": "", "extensions": { "attribute": "704" }, "name": "功率", "typeSpec": { "type": "value", "max": 80000, "min": 0, "scale": 1, "step": 1, "unit": "W" } }, { "abilityId": 20, "accessMode": "ro", "code": "cur_voltage", "description": "", "extensions": { "attribute": "704" }, "name": "电压", "typeSpec": { "type": "value", "max": 5000, "min": 0, "scale": 1, "step": 1, "unit": "V" } }, { "abilityId": 21, "accessMode": "ro", "code": "test_bit", "description": "", "extensions": { "attribute": "736" }, "name": "产测结果位", "typeSpec": { "type": "value", "max": 5, "min": 0, "scale": 0, "step": 1 } }, { "abilityId": 22, "accessMode": "ro", "code": "voltage_coe", "description": "", "extensions": { "attribute": "736" }, "name": "电压校准系数", "typeSpec": { "type": "value", "max": 1000000, "min": 0, "scale": 0, "step": 1 } }, { "abilityId": 23, "accessMode": "ro", "code": "electric_coe", "description": "", "extensions": { "attribute": "736" }, "name": "电流校准系数", "typeSpec": { "type": "value", "max": 1000000, "min": 0, "scale": 0, "step": 1 } }, { "abilityId": 24, "accessMode": "ro", "code": "power_coe", "description": "", "extensions": { "attribute": "736" }, "name": "功率校准系数", "typeSpec": { "type": "value", "max": 1000000, "min": 0, "scale": 0, "step": 1 } }, { "abilityId": 25, "accessMode": "ro", "code": "electricity_coe", "description": "", "extensions": { "attribute": "736" }, "name": "电量校准系数", "typeSpec": { "type": "value", "max": 1000000, "min": 0, "scale": 0, "step": 1 } }, { "abilityId": 26, "accessMode": "ro", "code": "fault", "description": "", "extensions": { "attribute": "640" }, "name": "故障告警", "typeSpec": { "type": "bitmap", "label": [ "ov_cr", "ov_vol", "ov_pwr", "ls_cr", "ls_vol", "ls_pow" ], "maxlen": 6 } }, { "abilityId": 38, "accessMode": "rw", "code": "relay_status", "description": "", "extensions": { "iconName": "icon-zhuangtai", "attribute": "736" }, "name": "上电状态设置", "typeSpec": { "type": "enum", "range": [ "off", "on", "memory" ] } }, { "abilityId": 39, "accessMode": "rw", "code": "overcharge_switch", "description": "", "extensions": { "iconName": "", "attribute": "128" }, "name": "过充保护", "typeSpec": { "type": "bool" } }, { "abilityId": 40, "accessMode": "rw", "code": "light_mode", "description": "", "extensions": { "iconName": "tcl_function_light", "attribute": "224" }, "name": "指示灯状态设置", "typeSpec": { "type": "enum", "range": [ "relay", "pos", "none", "on" ] } }, { "abilityId": 41, "accessMode": "rw", "code": "child_lock", "description": "", "extensions": { "iconName": "icon-dp_power2", "attribute": "128" }, "name": "童锁开关", "typeSpec": { "type": "bool" } }, { "abilityId": 42, "accessMode": "rw", "code": "cycle_time", "description": "涂鸦协议", "extensions": { "iconName": "icon-dp_time3", "attribute": "224" }, "name": "循环定时", "typeSpec": { "type": "string", "maxlen": 255 } }, { "abilityId": 43, "accessMode": "rw", "code": "random_time", "description": "涂鸦协议", "extensions": { "iconName": "icon-dp_time2", "attribute": "224" }, "name": "随机定时", "typeSpec": { "type": "string", "maxlen": 255 } }, { "abilityId": 44, "accessMode": "rw", "code": "switch_inching", "description": "涂鸦协议", "extensions": { "iconName": "", "attribute": "224" }, "name": "点动开关", "typeSpec": { "type": "string", "maxlen": 255 } } ] } ] }, "thing_model_raw": "{\"modelId\":\"e1n2e11c\",\"services\":[{\"actions\":[],\"code\":\"\",\"description\":\"\",\"events\":[],\"name\":\"\",\"properties\":[{\"abilityId\":1,\"accessMode\":\"rw\",\"code\":\"switch_1\",\"description\":\"\",\"extensions\":{\"iconName\":\"icon-dp_power2\",\"attribute\":\"641\"},\"name\":\"开关1\",\"typeSpec\":{\"type\":\"bool\"}},{\"abilityId\":9,\"accessMode\":\"rw\",\"code\":\"countdown_1\",\"description\":\"\",\"extensions\":{\"iconName\":\"icon-dp_time2\",\"attribute\":\"736\"},\"name\":\"倒计时1\",\"typeSpec\":{\"type\":\"value\",\"max\":86400,\"min\":0,\"scale\":0,\"step\":1,\"unit\":\"s\"}},{\"abilityId\":17,\"accessMode\":\"ro\",\"code\":\"add_ele\",\"description\":\"\",\"extensions\":{\"attribute\":\"736\",\"trigger\":\"direct\"},\"name\":\"增加电量\",\"typeSpec\":{\"type\":\"value\",\"max\":50000,\"min\":0,\"scale\":3,\"step\":100}},{\"abilityId\":18,\"accessMode\":\"ro\",\"code\":\"cur_current\",\"description\":\"\",\"extensions\":{\"attribute\":\"704\"},\"name\":\"电流\",\"typeSpec\":{\"type\":\"value\",\"max\":30000,\"min\":0,\"scale\":0,\"step\":1,\"unit\":\"mA\"}},{\"abilityId\":19,\"accessMode\":\"ro\",\"code\":\"cur_power\",\"description\":\"\",\"extensions\":{\"attribute\":\"704\"},\"name\":\"功率\",\"typeSpec\":{\"type\":\"value\",\"max\":80000,\"min\":0,\"scale\":1,\"step\":1,\"unit\":\"W\"}},{\"abilityId\":20,\"accessMode\":\"ro\",\"code\":\"cur_voltage\",\"description\":\"\",\"extensions\":{\"attribute\":\"704\"},\"name\":\"电压\",\"typeSpec\":{\"type\":\"value\",\"max\":5000,\"min\":0,\"scale\":1,\"step\":1,\"unit\":\"V\"}},{\"abilityId\":21,\"accessMode\":\"ro\",\"code\":\"test_bit\",\"description\":\"\",\"extensions\":{\"attribute\":\"736\"},\"name\":\"产测结果位\",\"typeSpec\":{\"type\":\"value\",\"max\":5,\"min\":0,\"scale\":0,\"step\":1}},{\"abilityId\":22,\"accessMode\":\"ro\",\"code\":\"voltage_coe\",\"description\":\"\",\"extensions\":{\"attribute\":\"736\"},\"name\":\"电压校准系数\",\"typeSpec\":{\"type\":\"value\",\"max\":1000000,\"min\":0,\"scale\":0,\"step\":1}},{\"abilityId\":23,\"accessMode\":\"ro\",\"code\":\"electric_coe\",\"description\":\"\",\"extensions\":{\"attribute\":\"736\"},\"name\":\"电流校准系数\",\"typeSpec\":{\"type\":\"value\",\"max\":1000000,\"min\":0,\"scale\":0,\"step\":1}},{\"abilityId\":24,\"accessMode\":\"ro\",\"code\":\"power_coe\",\"description\":\"\",\"extensions\":{\"attribute\":\"736\"},\"name\":\"功率校准系数\",\"typeSpec\":{\"type\":\"value\",\"max\":1000000,\"min\":0,\"scale\":0,\"step\":1}},{\"abilityId\":25,\"accessMode\":\"ro\",\"code\":\"electricity_coe\",\"description\":\"\",\"extensions\":{\"attribute\":\"736\"},\"name\":\"电量校准系数\",\"typeSpec\":{\"type\":\"value\",\"max\":1000000,\"min\":0,\"scale\":0,\"step\":1}},{\"abilityId\":26,\"accessMode\":\"ro\",\"code\":\"fault\",\"description\":\"\",\"extensions\":{\"attribute\":\"640\"},\"name\":\"故障告警\",\"typeSpec\":{\"type\":\"bitmap\",\"label\":[\"ov_cr\",\"ov_vol\",\"ov_pwr\",\"ls_cr\",\"ls_vol\",\"ls_pow\"],\"maxlen\":6}},{\"abilityId\":38,\"accessMode\":\"rw\",\"code\":\"relay_status\",\"description\":\"\",\"extensions\":{\"iconName\":\"icon-zhuangtai\",\"attribute\":\"736\"},\"name\":\"上电状态设置\",\"typeSpec\":{\"type\":\"enum\",\"range\":[\"off\",\"on\",\"memory\"]}},{\"abilityId\":39,\"accessMode\":\"rw\",\"code\":\"overcharge_switch\",\"description\":\"\",\"extensions\":{\"iconName\":\"\",\"attribute\":\"128\"},\"name\":\"过充保护\",\"typeSpec\":{\"type\":\"bool\"}},{\"abilityId\":40,\"accessMode\":\"rw\",\"code\":\"light_mode\",\"description\":\"\",\"extensions\":{\"iconName\":\"tcl_function_light\",\"attribute\":\"224\"},\"name\":\"指示灯状态设置\",\"typeSpec\":{\"type\":\"enum\",\"range\":[\"relay\",\"pos\",\"none\",\"on\"]}},{\"abilityId\":41,\"accessMode\":\"rw\",\"code\":\"child_lock\",\"description\":\"\",\"extensions\":{\"iconName\":\"icon-dp_power2\",\"attribute\":\"128\"},\"name\":\"童锁开关\",\"typeSpec\":{\"type\":\"bool\"}},{\"abilityId\":42,\"accessMode\":\"rw\",\"code\":\"cycle_time\",\"description\":\"涂鸦协议\",\"extensions\":{\"iconName\":\"icon-dp_time3\",\"attribute\":\"224\"},\"name\":\"循环定时\",\"typeSpec\":{\"type\":\"string\",\"maxlen\":255}},{\"abilityId\":43,\"accessMode\":\"rw\",\"code\":\"random_time\",\"description\":\"涂鸦协议\",\"extensions\":{\"iconName\":\"icon-dp_time2\",\"attribute\":\"224\"},\"name\":\"随机定时\",\"typeSpec\":{\"type\":\"string\",\"maxlen\":255}},{\"abilityId\":44,\"accessMode\":\"rw\",\"code\":\"switch_inching\",\"description\":\"涂鸦协议\",\"extensions\":{\"iconName\":\"\",\"attribute\":\"224\"},\"name\":\"点动开关\",\"typeSpec\":{\"type\":\"string\",\"maxlen\":255}}]}]}", "features": [ { "name": "开关1", "external_id": "tuya:bf2be3c32ea4d8f561ujmu:switch_1", "selector": "tuya-bf2be3c32ea4d8f561ujmu-switch-1", "read_only": false, "has_feedback": false, "min": 0, "max": 1, "category": "switch", "type": "binary", "keep_history": true, "id": "1bed0439-9362-4739-b4b3-13b8b2f43c66" }, { "name": "增加电量", "external_id": "tuya:bf2be3c32ea4d8f561ujmu:add_ele", "selector": "tuya-bf2be3c32ea4d8f561ujmu-add-ele", "read_only": true, "has_feedback": false, "min": 0, "max": 50000, "category": "switch", "type": "energy", "unit": "kilowatt-hour", "keep_history": true, "id": "0c18a42c-6b65-4f57-850b-c2d6243d6481", "energy_parent_id": "ce42956a-a2e5-495f-a7ab-9a442ab0723f" }, { "name": "当前电流", "external_id": "tuya:bf2be3c32ea4d8f561ujmu:cur_current", "selector": "tuya-bf2be3c32ea4d8f561ujmu-cur-current", "read_only": true, "has_feedback": false, "min": 0, "max": 30000, "category": "switch", "type": "current", "unit": "milliampere", "keep_history": true, "id": "b2ccd148-b30a-46df-977d-9c08a72392ec" }, { "name": "当前功率", "external_id": "tuya:bf2be3c32ea4d8f561ujmu:cur_power", "selector": "tuya-bf2be3c32ea4d8f561ujmu-cur-power", "read_only": true, "has_feedback": false, "min": 0, "max": 80000, "category": "switch", "type": "power", "unit": "watt", "keep_history": true, "id": "91e773e8-56eb-458e-8cbb-8f51ba432580" }, { "name": "当前电压", "external_id": "tuya:bf2be3c32ea4d8f561ujmu:cur_voltage", "selector": "tuya-bf2be3c32ea4d8f561ujmu-cur-voltage", "read_only": true, "has_feedback": false, "min": 0, "max": 5000, "category": "switch", "type": "voltage", "unit": "volt", "keep_history": true, "id": "890d458e-fe70-43d0-a474-e3fa8a50de08" } ], "params": [ { "name": "DEVICE_ID", "value": "bf2be3c32ea4d8f561ujmu" }, { "name": "LOCAL_KEY", "value": "***" }, { "name": "CLOUD_IP", "value": "91.x.x.x" }, { "name": "LOCAL_OVERRIDE", "value": true }, { "name": "PRODUCT_ID", "value": "b61eihfqeaexn54g" }, { "name": "IP_ADDRESS", "value": "192.x.x.x" }, { "name": "PROTOCOL_VERSION", "value": "3.5" }, { "name": "LOCAL_POLL_DPS", "value": "{\"1\":false,\"9\":0,\"18\":0,\"19\":0,\"20\":2268,\"21\":1,\"22\":566,\"23\":26471,\"24\":14621,\"25\":2840,\"26\":0,\"38\":\"memory\",\"39\":false,\"40\":\"relay\",\"41\":false,\"44\":\"\"}" } ], "local_poll": { "status": null, "error": null, "protocol": null, "dps": { "1": false, "9": 0, "18": 0, "19": 0, "20": 2268, "21": 1, "22": 566, "23": 26471, "24": 14621, "25": 2840, "26": 0, "38": "memory", "39": false, "40": "relay", "41": false, "44": "" } } } ```

github.com/GladysAssistant/Gladys

Tuya (local) [bbcg1hrkrj5rifsd]: Add support for Smart Meter

ouvert 04:46PM - 24 Feb 26 UTC

gboulvin

Feature tuya

```json { "id": null, "name": "Production solaire", "selector": "tuya-bf8a…5bf8acc4540a41rere", "model": "Smart Meter", "external_id": "tuya:bf8a5bf8acc4540a41rere", "service_id": "966ff9b2-7d5d-4c88-aa54-80c406d5743d", "product_id": "bbcg1hrkrj5rifsd", "product_key": null, "online": true, "protocol_version": null, "local_override": true, "specifications": {}, "properties": { "properties": [ { "code": "power_a", "custom_name": "", "dp_id": 101, "time": 1771951460001, "type": "value", "value": 706 }, { "code": "direction_a", "custom_name": "", "dp_id": 102, "time": 1771951348019, "type": "enum", "value": "FORWARD" }, { "code": "tbd", "custom_name": "", "dp_id": 103, "time": 1743762507831, "type": "bool", "value": false }, { "code": "direction_b", "custom_name": "", "dp_id": 104, "time": 1743767172287, "type": "enum", "value": "REVERSE" }, { "code": "power_b", "custom_name": "", "dp_id": 105, "time": 1771951348019, "type": "value", "value": 0 }, { "code": "energy_forword_a", "custom_name": "", "dp_id": 106, "time": 1771951345936, "type": "value", "value": 149241 }, { "code": "energy_reverse_a", "custom_name": "", "dp_id": 107, "time": 1771951348019, "type": "value", "value": 43222 }, { "code": "energy_forword_b", "custom_name": "", "dp_id": 108, "time": 1771951348019, "type": "value", "value": 0 }, { "code": "energy_reserse_b", "custom_name": "", "dp_id": 109, "time": 1771951348019, "type": "value", "value": 0 }, { "code": "power_factor", "custom_name": "", "dp_id": 110, "time": 1771951438623, "type": "value", "value": 73 }, { "code": "freq", "custom_name": "", "dp_id": 111, "time": 1771951449324, "type": "value", "value": 4927 }, { "code": "voltage_a", "custom_name": "", "dp_id": 112, "time": 1771951459889, "type": "value", "value": 2352 }, { "code": "current_a", "custom_name": "", "dp_id": 113, "time": 1771951449206, "type": "value", "value": 410 }, { "code": "current_b", "custom_name": "", "dp_id": 114, "time": 1771951348019, "type": "value", "value": 0 }, { "code": "total_power", "custom_name": "", "dp_id": 115, "time": 1771951460016, "type": "value", "value": 706 }, { "code": "voltage_coef", "custom_name": "", "dp_id": 116, "time": 1771951345564, "type": "value", "value": 1000 }, { "code": "current_a_calibration", "custom_name": "", "dp_id": 117, "time": 1771951345590, "type": "value", "value": 1000 }, { "code": "power_a_calibration", "custom_name": "", "dp_id": 118, "time": 1771951345699, "type": "value", "value": 1000 }, { "code": "energy_a_calibration_fwd", "custom_name": "", "dp_id": 119, "time": 1771951345718, "type": "value", "value": 1000 }, { "code": "coef_a_reset", "custom_name": "", "dp_id": 120, "time": 1743762507831, "type": "bool", "value": false }, { "code": "power_factor_b", "custom_name": "", "dp_id": 121, "time": 1771951348019, "type": "value", "value": 100 }, { "code": "freq_calibration", "custom_name": "", "dp_id": 122, "time": 1771951345575, "type": "value", "value": 1000 }, { "code": "current_b_calibration", "custom_name": "", "dp_id": 123, "time": 1771951345731, "type": "value", "value": 1000 }, { "code": "power_b_calibration", "custom_name": "", "dp_id": 124, "time": 1771951345761, "type": "value", "value": 1000 }, { "code": "energy_b_calibration_fwd", "custom_name": "", "dp_id": 125, "time": 1771951348019, "type": "value", "value": 1000 }, { "code": "coef_b_reset", "custom_name": "", "dp_id": 126, "time": 1743762507831, "type": "bool", "value": false }, { "code": "energy_a_calibration_rev", "custom_name": "", "dp_id": 127, "time": 1771951345723, "type": "value", "value": 1000 }, { "code": "energy_b_calibration_rev", "custom_name": "", "dp_id": 128, "time": 1771951345905, "type": "value", "value": 1000 }, { "code": "report_rate_control", "custom_name": "", "dp_id": 129, "time": 1771951345921, "type": "value", "value": 10 }, { "code": "forward_energy_total", "custom_name": "", "dp_id": 130, "time": 1771951345925, "type": "value", "value": 149241 }, { "code": "reverse_energy_total", "custom_name": "", "dp_id": 131, "time": 1771951348019, "type": "value", "value": 43222 } ] }, "thing_model": { "modelId": "flu1ic", "services": [ { "actions": [], "code": "", "description": "", "events": [], "name": "默认服务", "properties": [ { "abilityId": 101, "accessMode": "ro", "code": "power_a", "description": "", "name": "Power_a", "typeSpec": { "type": "value", "max": 600000, "min": 0, "scale": 1, "step": 1, "unit": "W" } }, { "abilityId": 102, "accessMode": "ro", "code": "direction_a", "description": "", "name": "Current_Flow_A", "typeSpec": { "type": "enum", "range": [ "FORWARD", "REVERSE" ] } }, { "abilityId": 103, "accessMode": "ro", "code": "tbd", "description": "", "name": "TBD", "typeSpec": { "type": "bool" } }, { "abilityId": 104, "accessMode": "ro", "code": "direction_b", "description": "", "name": "Current_FLow_B", "typeSpec": { "type": "enum", "range": [ "FORWARD", "REVERSE" ] } }, { "abilityId": 105, "accessMode": "ro", "code": "power_b", "description": "", "name": "Power_b", "typeSpec": { "type": "value", "max": 600000, "min": 0, "scale": 1, "step": 1, "unit": "W" } }, { "abilityId": 106, "accessMode": "ro", "code": "energy_forword_a", "description": "", "name": "Forward Energy-A", "typeSpec": { "type": "value", "max": 99999999, "min": 0, "scale": 2, "step": 1, "unit": "KWH" } }, { "abilityId": 107, "accessMode": "ro", "code": "energy_reverse_a", "description": "", "name": "Reverse Energy-A", "typeSpec": { "type": "value", "max": 99999999, "min": 0, "scale": 2, "step": 1, "unit": "KWH" } }, { "abilityId": 108, "accessMode": "ro", "code": "energy_forword_b", "description": "", "name": "Forward Energy-B", "typeSpec": { "type": "value", "max": 99999999, "min": 0, "scale": 2, "step": 1, "unit": "KWH" } }, { "abilityId": 109, "accessMode": "ro", "code": "energy_reserse_b", "description": "", "name": "Reverse Energy-B", "typeSpec": { "type": "value", "max": 99999999, "min": 0, "scale": 2, "step": 1, "unit": "KWH" } }, { "abilityId": 110, "accessMode": "ro", "code": "power_factor", "description": "", "name": "Power_factor", "typeSpec": { "type": "value", "max": 100, "min": 0, "scale": 2, "step": 1, "unit": "" } }, { "abilityId": 111, "accessMode": "ro", "code": "freq", "description": "", "name": "AC_Freq", "typeSpec": { "type": "value", "max": 10000, "min": 0, "scale": 2, "step": 1, "unit": "Hz" } }, { "abilityId": 112, "accessMode": "ro", "code": "voltage_a", "description": "", "name": "Voltage", "typeSpec": { "type": "value", "max": 28000, "min": 0, "scale": 1, "step": 1, "unit": "V" } }, { "abilityId": 113, "accessMode": "ro", "code": "current_a", "description": "", "name": "Current_a", "typeSpec": { "type": "value", "max": 1000000, "min": 0, "scale": 0, "step": 1, "unit": "mA" } }, { "abilityId": 114, "accessMode": "ro", "code": "current_b", "description": "", "name": "Current_b", "typeSpec": { "type": "value", "max": 1000000, "min": 0, "scale": 0, "step": 1, "unit": "mA" } }, { "abilityId": 115, "accessMode": "ro", "code": "total_power", "description": "", "name": " Total_Power", "typeSpec": { "type": "value", "max": 99999999, "min": -99999999, "scale": 1, "step": 1, "unit": "W" } }, { "abilityId": 116, "accessMode": "rw", "code": "voltage_coef", "description": "", "name": "电压校准", "typeSpec": { "type": "value", "max": 1200, "min": 800, "scale": 3, "step": 1, "unit": "" } }, { "abilityId": 117, "accessMode": "rw", "code": "current_a_calibration", "description": "", "name": "current_a_calibration", "typeSpec": { "type": "value", "max": 1200, "min": 800, "scale": 3, "step": 1, "unit": "" } }, { "abilityId": 118, "accessMode": "rw", "code": "power_a_calibration", "description": "", "name": "power_a_calibration", "typeSpec": { "type": "value", "max": 1200, "min": 800, "scale": 3, "step": 1, "unit": "" } }, { "abilityId": 119, "accessMode": "rw", "code": "energy_a_calibration_fwd", "description": "", "name": "energy_a_calibration_fwd", "typeSpec": { "type": "value", "max": 1200, "min": 800, "scale": 3, "step": 1, "unit": "" } }, { "abilityId": 120, "accessMode": "wr", "code": "coef_a_reset", "description": "", "name": "coef_a_reset", "typeSpec": { "type": "bool" } }, { "abilityId": 121, "accessMode": "ro", "code": "power_factor_b", "description": "", "name": "Power_factor_b", "typeSpec": { "type": "value", "max": 100, "min": 0, "scale": 2, "step": 1, "unit": "" } }, { "abilityId": 122, "accessMode": "rw", "code": "freq_calibration", "description": "", "name": "频率校准", "typeSpec": { "type": "value", "max": 1200, "min": 800, "scale": 3, "step": 1, "unit": "" } }, { "abilityId": 123, "accessMode": "rw", "code": "current_b_calibration", "description": "", "name": "current_b_calibration", "typeSpec": { "type": "value", "max": 1200, "min": 800, "scale": 3, "step": 1, "unit": "" } }, { "abilityId": 124, "accessMode": "rw", "code": "power_b_calibration", "description": "", "name": "power_b_calibration", "typeSpec": { "type": "value", "max": 1200, "min": 800, "scale": 3, "step": 1, "unit": "" } }, { "abilityId": 125, "accessMode": "rw", "code": "energy_b_calibration_fwd", "description": "", "name": "energy_b_calibration_fwd", "typeSpec": { "type": "value", "max": 1200, "min": 800, "scale": 3, "step": 1, "unit": "" } }, { "abilityId": 126, "accessMode": "wr", "code": "coef_b_reset", "description": "", "name": "coef_b_reset", "typeSpec": { "type": "bool" } }, { "abilityId": 127, "accessMode": "rw", "code": "energy_a_calibration_rev", "description": "", "name": "energy_a_calibration_rev", "typeSpec": { "type": "value", "max": 1200, "min": 800, "scale": 3, "step": 1, "unit": "" } }, { "abilityId": 128, "accessMode": "rw", "code": "energy_b_calibration_rev", "description": "", "name": "energy_b_calibration_rev", "typeSpec": { "type": "value", "max": 1200, "min": 800, "scale": 3, "step": 1, "unit": "" } }, { "abilityId": 129, "accessMode": "rw", "code": "report_rate_control", "description": "", "name": "上报频率", "typeSpec": { "type": "value", "max": 60, "min": 3, "scale": 0, "step": 1, "unit": "s" } }, { "abilityId": 130, "accessMode": "ro", "code": "forward_energy_total", "description": "", "name": "forward_energy_total", "typeSpec": { "type": "value", "max": 99999999, "min": 0, "scale": 2, "step": 1, "unit": "KWH" } }, { "abilityId": 131, "accessMode": "ro", "code": "reverse_energy_total", "description": "", "name": "reverse_energy_total", "typeSpec": { "type": "value", "max": 99999999, "min": 0, "scale": 2, "step": 1, "unit": "KWH" } } ] } ] }, "thing_model_raw": "{\"modelId\":\"flu1ic\",\"services\":[{\"actions\":[],\"code\":\"\",\"description\":\"\",\"events\":[],\"name\":\"默认服务\",\"properties\":[{\"abilityId\":101,\"accessMode\":\"ro\",\"code\":\"power_a\",\"description\":\"\",\"name\":\"Power_a\",\"typeSpec\":{\"type\":\"value\",\"max\":600000,\"min\":0,\"scale\":1,\"step\":1,\"unit\":\"W\"}},{\"abilityId\":102,\"accessMode\":\"ro\",\"code\":\"direction_a\",\"description\":\"\",\"name\":\"Current_Flow_A\",\"typeSpec\":{\"type\":\"enum\",\"range\":[\"FORWARD\",\"REVERSE\"]}},{\"abilityId\":103,\"accessMode\":\"ro\",\"code\":\"tbd\",\"description\":\"\",\"name\":\"TBD\",\"typeSpec\":{\"type\":\"bool\"}},{\"abilityId\":104,\"accessMode\":\"ro\",\"code\":\"direction_b\",\"description\":\"\",\"name\":\"Current_FLow_B\",\"typeSpec\":{\"type\":\"enum\",\"range\":[\"FORWARD\",\"REVERSE\"]}},{\"abilityId\":105,\"accessMode\":\"ro\",\"code\":\"power_b\",\"description\":\"\",\"name\":\"Power_b\",\"typeSpec\":{\"type\":\"value\",\"max\":600000,\"min\":0,\"scale\":1,\"step\":1,\"unit\":\"W\"}},{\"abilityId\":106,\"accessMode\":\"ro\",\"code\":\"energy_forword_a\",\"description\":\"\",\"name\":\"Forward Energy-A\",\"typeSpec\":{\"type\":\"value\",\"max\":99999999,\"min\":0,\"scale\":2,\"step\":1,\"unit\":\"KWH\"}},{\"abilityId\":107,\"accessMode\":\"ro\",\"code\":\"energy_reverse_a\",\"description\":\"\",\"name\":\"Reverse Energy-A\",\"typeSpec\":{\"type\":\"value\",\"max\":99999999,\"min\":0,\"scale\":2,\"step\":1,\"unit\":\"KWH\"}},{\"abilityId\":108,\"accessMode\":\"ro\",\"code\":\"energy_forword_b\",\"description\":\"\",\"name\":\"Forward Energy-B\",\"typeSpec\":{\"type\":\"value\",\"max\":99999999,\"min\":0,\"scale\":2,\"step\":1,\"unit\":\"KWH\"}},{\"abilityId\":109,\"accessMode\":\"ro\",\"code\":\"energy_reserse_b\",\"description\":\"\",\"name\":\"Reverse Energy-B\",\"typeSpec\":{\"type\":\"value\",\"max\":99999999,\"min\":0,\"scale\":2,\"step\":1,\"unit\":\"KWH\"}},{\"abilityId\":110,\"accessMode\":\"ro\",\"code\":\"power_factor\",\"description\":\"\",\"name\":\"Power_factor\",\"typeSpec\":{\"type\":\"value\",\"max\":100,\"min\":0,\"scale\":2,\"step\":1,\"unit\":\"\"}},{\"abilityId\":111,\"accessMode\":\"ro\",\"code\":\"freq\",\"description\":\"\",\"name\":\"AC_Freq\",\"typeSpec\":{\"type\":\"value\",\"max\":10000,\"min\":0,\"scale\":2,\"step\":1,\"unit\":\"Hz\"}},{\"abilityId\":112,\"accessMode\":\"ro\",\"code\":\"voltage_a\",\"description\":\"\",\"name\":\"Voltage\",\"typeSpec\":{\"type\":\"value\",\"max\":28000,\"min\":0,\"scale\":1,\"step\":1,\"unit\":\"V\"}},{\"abilityId\":113,\"accessMode\":\"ro\",\"code\":\"current_a\",\"description\":\"\",\"name\":\"Current_a\",\"typeSpec\":{\"type\":\"value\",\"max\":1000000,\"min\":0,\"scale\":0,\"step\":1,\"unit\":\"mA\"}},{\"abilityId\":114,\"accessMode\":\"ro\",\"code\":\"current_b\",\"description\":\"\",\"name\":\"Current_b\",\"typeSpec\":{\"type\":\"value\",\"max\":1000000,\"min\":0,\"scale\":0,\"step\":1,\"unit\":\"mA\"}},{\"abilityId\":115,\"accessMode\":\"ro\",\"code\":\"total_power\",\"description\":\"\",\"name\":\" Total_Power\",\"typeSpec\":{\"type\":\"value\",\"max\":99999999,\"min\":-99999999,\"scale\":1,\"step\":1,\"unit\":\"W\"}},{\"abilityId\":116,\"accessMode\":\"rw\",\"code\":\"voltage_coef\",\"description\":\"\",\"name\":\"电压校准\",\"typeSpec\":{\"type\":\"value\",\"max\":1200,\"min\":800,\"scale\":3,\"step\":1,\"unit\":\"\"}},{\"abilityId\":117,\"accessMode\":\"rw\",\"code\":\"current_a_calibration\",\"description\":\"\",\"name\":\"current_a_calibration\",\"typeSpec\":{\"type\":\"value\",\"max\":1200,\"min\":800,\"scale\":3,\"step\":1,\"unit\":\"\"}},{\"abilityId\":118,\"accessMode\":\"rw\",\"code\":\"power_a_calibration\",\"description\":\"\",\"name\":\"power_a_calibration\",\"typeSpec\":{\"type\":\"value\",\"max\":1200,\"min\":800,\"scale\":3,\"step\":1,\"unit\":\"\"}},{\"abilityId\":119,\"accessMode\":\"rw\",\"code\":\"energy_a_calibration_fwd\",\"description\":\"\",\"name\":\"energy_a_calibration_fwd\",\"typeSpec\":{\"type\":\"value\",\"max\":1200,\"min\":800,\"scale\":3,\"step\":1,\"unit\":\"\"}},{\"abilityId\":120,\"accessMode\":\"wr\",\"code\":\"coef_a_reset\",\"description\":\"\",\"name\":\"coef_a_reset\",\"typeSpec\":{\"type\":\"bool\"}},{\"abilityId\":121,\"accessMode\":\"ro\",\"code\":\"power_factor_b\",\"description\":\"\",\"name\":\"Power_factor_b\",\"typeSpec\":{\"type\":\"value\",\"max\":100,\"min\":0,\"scale\":2,\"step\":1,\"unit\":\"\"}},{\"abilityId\":122,\"accessMode\":\"rw\",\"code\":\"freq_calibration\",\"description\":\"\",\"name\":\"频率校准\",\"typeSpec\":{\"type\":\"value\",\"max\":1200,\"min\":800,\"scale\":3,\"step\":1,\"unit\":\"\"}},{\"abilityId\":123,\"accessMode\":\"rw\",\"code\":\"current_b_calibration\",\"description\":\"\",\"name\":\"current_b_calibration\",\"typeSpec\":{\"type\":\"value\",\"max\":1200,\"min\":800,\"scale\":3,\"step\":1,\"unit\":\"\"}},{\"abilityId\":124,\"accessMode\":\"rw\",\"code\":\"power_b_calibration\",\"description\":\"\",\"name\":\"power_b_calibration\",\"typeSpec\":{\"type\":\"value\",\"max\":1200,\"min\":800,\"scale\":3,\"step\":1,\"unit\":\"\"}},{\"abilityId\":125,\"accessMode\":\"rw\",\"code\":\"energy_b_calibration_fwd\",\"description\":\"\",\"name\":\"energy_b_calibration_fwd\",\"typeSpec\":{\"type\":\"value\",\"max\":1200,\"min\":800,\"scale\":3,\"step\":1,\"unit\":\"\"}},{\"abilityId\":126,\"accessMode\":\"wr\",\"code\":\"coef_b_reset\",\"description\":\"\",\"name\":\"coef_b_reset\",\"typeSpec\":{\"type\":\"bool\"}},{\"abilityId\":127,\"accessMode\":\"rw\",\"code\":\"energy_a_calibration_rev\",\"description\":\"\",\"name\":\"energy_a_calibration_rev\",\"typeSpec\":{\"type\":\"value\",\"max\":1200,\"min\":800,\"scale\":3,\"step\":1,\"unit\":\"\"}},{\"abilityId\":128,\"accessMode\":\"rw\",\"code\":\"energy_b_calibration_rev\",\"description\":\"\",\"name\":\"energy_b_calibration_rev\",\"typeSpec\":{\"type\":\"value\",\"max\":1200,\"min\":800,\"scale\":3,\"step\":1,\"unit\":\"\"}},{\"abilityId\":129,\"accessMode\":\"rw\",\"code\":\"report_rate_control\",\"description\":\"\",\"name\":\"上报频率\",\"typeSpec\":{\"type\":\"value\",\"max\":60,\"min\":3,\"scale\":0,\"step\":1,\"unit\":\"s\"}},{\"abilityId\":130,\"accessMode\":\"ro\",\"code\":\"forward_energy_total\",\"description\":\"\",\"name\":\"forward_energy_total\",\"typeSpec\":{\"type\":\"value\",\"max\":99999999,\"min\":0,\"scale\":2,\"step\":1,\"unit\":\"KWH\"}},{\"abilityId\":131,\"accessMode\":\"ro\",\"code\":\"reverse_energy_total\",\"description\":\"\",\"name\":\"reverse_energy_total\",\"typeSpec\":{\"type\":\"value\",\"max\":99999999,\"min\":0,\"scale\":2,\"step\":1,\"unit\":\"KWH\"}}]}]}", "features": [], "params": [ { "name": "DEVICE_ID", "value": "bf8a5bf8acc4540a41rere" }, { "name": "LOCAL_KEY", "value": "***" }, { "name": "CLOUD_IP", "value": "62.x.x.x" }, { "name": "LOCAL_OVERRIDE", "value": true }, { "name": "PRODUCT_ID", "value": "bbcg1hrkrj5rifsd" } ], "local_poll": { "status": null, "error": null, "protocol": null, "dps": null } } ```

github.com/GladysAssistant/Gladys

Tuya (local) [c03zek9b5daz7omr]: Add support for Pilote Thermostat

ouvert 11:58AM - 02 Mar 26 UTC

Terdious

## Summary Unsupported or partially supported Tuya device report. - Device nam…e: `Thermostat Bureau Psycho` - External ID: `tuya:bfc3c1dcdd95241afal8mo` - Product ID: `c03zek9b5daz7omr` - Product key: `unknown` - Model: `Pilote Thermostat` - Category: `cjkg` - Online: `true` - Local override: `true` - Local poll status: `Success` - Local poll protocol: `3.5` ## Implementation Guide Implement the Tuya support first, then finalize the tests: 1. Add or update the Tuya cloud mapping in `server/services/tuya/lib/mappings/cloud/`. 2. Add or update the Tuya local mapping in `server/services/tuya/lib/mappings/local/`. 3. Register or update the device definition in `server/services/tuya/lib/mappings/index.js`. 4. If the new feature needs a new Gladys `category/type`, add it in `server/utils/constants.js`. 5. If the new feature uses a new `category/type` not yet handled by Tuya reading, update `readValues` in `server/services/tuya/lib/device/tuya.deviceMapping.js`. 6. If the feature should be writable from Gladys, also update `writeValues` in `server/services/tuya/lib/device/tuya.deviceMapping.js`. ## Maintainer Notes This issue contains: - the complete structured Tuya report - suggested fixture input files for onboarding tests - raw cloud responses - local poll DPS when available This issue does not contain: - `expected-device.json` - `expected-events.json` or `expected-cloud-events.json` / `expected-local-events.json` - `expected-local-mapping.json` These expected files should still be reviewed and created manually. `poll-device.json` is only a starting point based on the current support level in Gladys. After adding or updating mappings, it should be completed with the final supported features and mapping metadata. ## Data Coverage - `GET /v1.0/users/{sourceId}/devices` -> `Device List Entry` below - `GET /v1.2/iot-03/devices/{deviceId}/specification` -> `input-device.json > specifications` - `GET /v1.0/iot-03/devices/{deviceId}` -> `input-device.json` top-level metadata - `GET /v2.0/cloud/thing/{deviceId}/shadow/properties` -> `input-device.json > properties` and `cloud-status.json` - `GET /v2.0/cloud/thing/{deviceId}/model` -> `input-device.json > thing_model` - local poll -> `local-dps.json` when available ## Suggested Fixture Folder ```text pilote-thermostat-c03zek9b5daz7omr ``` Example: ```text server/test/services/tuya/fixtures/devices/pilote-thermostat-c03zek9b5daz7omr ``` ## Suggested File: manifest.js ```js module.exports = { name: 'Thermostat Bureau Psycho', convertDevice: { input: './input-device.json', expected: './expected-device.json', }, pollCloud: { device: './poll-device.json', response: './cloud-status.json', expectedEvents: './expected-cloud-events.json', }, pollLocal: { device: './poll-device.json', dps: './local-dps.json', expectedEvents: './expected-local-events.json', expectedCloudRequests: 0, }, localMapping: { device: './poll-device.json', expected: './expected-local-mapping.json', }, }; ``` ## Suggested File: input-device.json Use this as the base input for `convertDevice`. ```json { "id": "bfc3c1dcdd95241afal8mo", "name": "Thermostat Bureau Psycho", "product_name": "Pilote Thermostat", "model": "RP5", "product_id": "c03zek9b5daz7omr", "local_key": "***", "ip": "10.x.x.x", "cloud_ip": "82.x.x.x", "protocol_version": "3.5", "local_override": true, "online": true, "specifications": { "category": "cjkg", "functions": [], "status": [] }, "properties": { "properties": [ { "code": "mode", "custom_name": "", "dp_id": 101, "time": 1771985024201, "type": "enum", "value": "Anti_forst" }, { "code": "child_lock", "custom_name": "", "dp_id": 102, "time": 1771985024201, "type": "bool", "value": false }, { "code": "week_program_1", "custom_name": "", "dp_id": 103, "time": 1771985024423, "type": "raw", "value": "VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV" }, { "code": "week_program_2", "custom_name": "", "dp_id": 104, "time": 1771985024512, "type": "raw", "value": "VVVVVVVVVSIhEVVRElEVURURFVVVVVVV" }, { "code": "week_program_3", "custom_name": "", "dp_id": 105, "time": 1771985024631, "type": "raw", "value": "VVVVVVVVVSIhEVVRFVEVURURFVVVVVVV" }, { "code": "week_program_4", "custom_name": "", "dp_id": 106, "time": 1771985024722, "type": "raw", "value": "VVVVVVVVVSIhEVVRFVEVURURVVVVVVVV" }, { "code": "week_program_5", "custom_name": "", "dp_id": 107, "time": 1771985024756, "type": "raw", "value": "VVVVVVVVVSIhEVVRFVEVURURVVVVVVVV" }, { "code": "week_program_6", "custom_name": "", "dp_id": 108, "time": 1771985024793, "type": "raw", "value": "VVVVVVVVVSIhEVVRFVEVURVVVVVVVVVV" }, { "code": "week_program_7", "custom_name": "", "dp_id": 109, "time": 1771985024927, "type": "raw", "value": "VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV" }, { "code": "vacation_duration", "custom_name": "", "dp_id": 110, "time": 1771985024201, "type": "value", "value": 0 }, { "code": "boost_duration", "custom_name": "", "dp_id": 111, "time": 1771985024201, "type": "value", "value": 0 }, { "code": "electricity_statistics", "custom_name": "", "dp_id": 112, "time": 1772406000505, "type": "value", "value": 0 }, { "code": "elec_statistics_day", "custom_name": "", "dp_id": 113, "time": 1772406000719, "type": "raw", "value": "AAAAAAAAAAAAAAAAAAAAAAAAAcAhAuAAAAAqBHAABCAEAAAAA5BZBXCkD4AAAABJ" }, { "code": "elec_statistics_month", "custom_name": "", "dp_id": 114, "time": 1772406000805, "type": "raw", "value": "AAADpwjGB1sEqwAAAAAAAAAAAAAAAAAAAAA=" }, { "code": "elec_statistics_year", "custom_name": "", "dp_id": 115, "time": 1772406000909, "type": "raw", "value": "AAAMBg==" }, { "code": "temp_current", "custom_name": "", "dp_id": 116, "time": 1772452150987, "type": "value", "value": 152 }, { "code": "average_power", "custom_name": "", "dp_id": 117, "time": 1772452201260, "type": "value", "value": 20 }, { "code": "temp_correction", "custom_name": "", "dp_id": 118, "time": 1771985024201, "type": "value", "value": 0 }, { "code": "fault", "custom_name": "", "dp_id": 119, "time": 1772443861071, "type": "bitmap", "value": 0 }, { "code": "air_pressure_index", "custom_name": "", "dp_id": 120, "time": 1772452450978, "type": "raw", "value": "H4ppqtom8Ljr3qW5xnTAeqoAiTyiz2E9" }, { "code": "support_features", "custom_name": "", "dp_id": 121, "time": 1771985024201, "type": "value", "value": 31 }, { "code": "window_check", "custom_name": "", "dp_id": 122, "time": 1771985024201, "type": "bool", "value": true }, { "code": "window_state", "custom_name": "", "dp_id": 123, "time": 1771985024201, "type": "bool", "value": false }, { "code": "window_keep_time", "custom_name": "", "dp_id": 124, "time": 1771985024201, "type": "value", "value": 30 }, { "code": "temp_set", "custom_name": "", "dp_id": 125, "time": 1772451000793, "type": "value", "value": 210 }, { "code": "temp_unit_convert", "custom_name": "", "dp_id": 126, "time": 1771985024201, "type": "enum", "value": "c" }, { "code": "app_features", "custom_name": "", "dp_id": 127, "time": 1771985024201, "type": "value", "value": 2 }, { "code": "switch_diff", "custom_name": "", "dp_id": 128, "time": 1771985024201, "type": "value", "value": 10 }, { "code": "upper_temp", "custom_name": "", "dp_id": 129, "time": 1771985024201, "type": "value", "value": 350 }, { "code": "lower_temp", "custom_name": "", "dp_id": 130, "time": 1771985024201, "type": "value", "value": 50 }, { "code": "running_mode", "custom_name": "", "dp_id": 131, "time": 1771985024201, "type": "enum", "value": "Anti_forst" }, { "code": "night_led_config", "custom_name": "", "dp_id": 132, "time": 1771985025374, "type": "raw", "value": "BLAB4AE=" }, { "code": "ecowatt_url", "custom_name": "", "dp_id": 133, "time": 1762239529277, "type": "string", "value": "" } ] }, "thing_model": { "modelId": "fjl7k0", "services": [ { "actions": [], "code": "", "description": "", "events": [], "name": "默认服务", "properties": [ { "abilityId": 101, "accessMode": "rw", "code": "mode", "description": "", "extensions": { "iconName": "icon-dp_mode", "attribute": "4096" }, "name": "模式", "typeSpec": { "type": "enum", "range": [ "Standby", "Comfort", "Comfort_1", "Comfort_2", "ECO", "Anti_forst", "Programming", "Thermostat" ] } }, { "abilityId": 102, "accessMode": "rw", "code": "child_lock", "description": "", "extensions": { "iconName": "icon-dp_lock", "attribute": "4096" }, "name": "童锁开关", "typeSpec": { "type": "bool" } }, { "abilityId": 103, "accessMode": "rw", "code": "week_program_1", "description": "周日", "extensions": { "iconName": "icon-dp_time3", "attribute": "4096" }, "name": "周程序1", "typeSpec": { "type": "raw", "maxlen": 128 } }, { "abilityId": 104, "accessMode": "rw", "code": "week_program_2", "description": "周一", "extensions": { "iconName": "icon-dp_mode", "attribute": "4096" }, "name": "周程序2", "typeSpec": { "type": "raw", "maxlen": 128 } }, { "abilityId": 105, "accessMode": "rw", "code": "week_program_3", "description": "周二", "extensions": { "iconName": "icon-dp_mode", "attribute": "4096" }, "name": "周程序3", "typeSpec": { "type": "raw", "maxlen": 128 } }, { "abilityId": 106, "accessMode": "rw", "code": "week_program_4", "description": "周三", "extensions": { "iconName": "icon-dp_mode", "attribute": "4096" }, "name": "周程序4", "typeSpec": { "type": "raw", "maxlen": 128 } }, { "abilityId": 107, "accessMode": "rw", "code": "week_program_5", "description": "周四", "extensions": { "iconName": "icon-dp_mode", "attribute": "4096" }, "name": "周程序5", "typeSpec": { "type": "raw", "maxlen": 128 } }, { "abilityId": 108, "accessMode": "rw", "code": "week_program_6", "description": "周五", "name": "周程序6", "typeSpec": { "type": "raw", "maxlen": 128 } }, { "abilityId": 109, "accessMode": "rw", "code": "week_program_7", "description": "周六", "name": "周程序7", "typeSpec": { "type": "raw", "maxlen": 128 } }, { "abilityId": 110, "accessMode": "rw", "code": "vacation_duration", "description": "假期时长，单位是天当开始执行假期模式\n时，需要每天递减", "name": "假期时长", "typeSpec": { "type": "value", "max": 364, "min": 0, "scale": 0, "step": 1, "unit": "天" } }, { "abilityId": 111, "accessMode": "rw", "code": "boost_duration", "description": "", "name": "Boost 模式时长", "typeSpec": { "type": "value", "max": 120, "min": 0, "scale": 0, "step": 1, "unit": "分钟" } }, { "abilityId": 112, "accessMode": "ro", "code": "electricity_statistics", "description": "", "name": "电量统计", "typeSpec": { "type": "value", "max": 2000000000, "min": 0, "scale": 1, "step": 1, "unit": "kWh" } }, { "abilityId": 113, "accessMode": "ro", "code": "elec_statistics_day", "description": "", "name": "日电量", "typeSpec": { "type": "raw", "maxlen": 128 } }, { "abilityId": 114, "accessMode": "ro", "code": "elec_statistics_month", "description": "", "name": "月电量", "typeSpec": { "type": "raw", "maxlen": 128 } }, { "abilityId": 115, "accessMode": "ro", "code": "elec_statistics_year", "description": "", "name": "年电量", "typeSpec": { "type": "raw", "maxlen": 128 } }, { "abilityId": 116, "accessMode": "ro", "code": "temp_current", "description": "", "extensions": { "trigger": "direct" }, "name": "当前温度", "typeSpec": { "type": "value", "max": 9000, "min": -300, "scale": 1, "step": 1, "unit": "" } }, { "abilityId": 117, "accessMode": "ro", "code": "average_power", "description": "30分钟内的平均功率", "name": "平均功率", "typeSpec": { "type": "value", "max": 2000000000, "min": 0, "scale": 1, "step": 1, "unit": "W" } }, { "abilityId": 118, "accessMode": "rw", "code": "temp_correction", "description": "", "name": "温度校准", "typeSpec": { "type": "value", "max": 100, "min": -100, "scale": 1, "step": 1, "unit": "" } }, { "abilityId": 119, "accessMode": "ro", "code": "fault", "description": "e1：探头异常 e2：电量统计芯片通信异常", "extensions": { "scope": "fault" }, "name": "故障告警", "typeSpec": { "type": "bitmap", "label": [ "e1", "e2" ], "maxlen": 2 } }, { "abilityId": 120, "accessMode": "ro", "code": "air_pressure_index", "description": "", "name": "气压指数", "typeSpec": { "type": "raw", "maxlen": 128 } }, { "abilityId": 121, "accessMode": "ro", "code": "support_features", "description": "bit有效\nbit0：是否支持comfort-1/comfort-2模式\nbit1：是否支持开窗功能\nbit2：是否支持电量统计\nbit3：是否支持温控逻辑", "name": "功能点", "typeSpec": { "type": "value", "max": 2147483647, "min": 0, "scale": 0, "step": 1, "unit": "" } }, { "abilityId": 122, "accessMode": "rw", "code": "window_check", "description": "", "extensions": { "iconName": "icon-dp_house" }, "name": "开窗检测", "typeSpec": { "type": "bool" } }, { "abilityId": 123, "accessMode": "ro", "code": "window_state", "description": "0为未开窗，1为开窗", "name": "窗户状态", "typeSpec": { "type": "bool" } }, { "abilityId": 124, "accessMode": "rw", "code": "window_keep_time", "description": "", "name": "开窗维持时间", "typeSpec": { "type": "value", "max": 120, "min": 0, "scale": 0, "step": 1, "unit": "min" } }, { "abilityId": 125, "accessMode": "rw", "code": "temp_set", "description": "", "extensions": { "iconName": "icon-a_function_celsius", "attribute": "0" }, "name": "目标温度", "typeSpec": { "type": "value", "max": 3000, "min": 50, "scale": 1, "step": 5, "unit": "" } }, { "abilityId": 126, "accessMode": "rw", "code": "temp_unit_convert", "description": "", "name": "温度单位", "typeSpec": { "type": "enum", "range": [ "c", "f" ] } }, { "abilityId": 127, "accessMode": "rw", "code": "app_features", "description": "bit有效；\nbit0：app是否已设置features，1表示未设置，0表示已设置；设备配网后上报的bit0会是1；\nbit1：是否支持comfort-1/comfort-2模式\nbit2：是否支持开窗功能", "name": "app支持特性", "typeSpec": { "type": "value", "max": 2147483647, "min": 0, "scale": 0, "step": 1, "unit": "" } }, { "abilityId": 128, "accessMode": "rw", "code": "switch_diff", "description": "开差偏差", "name": "开关偏差", "typeSpec": { "type": "value", "max": 100, "min": 1, "scale": 1, "step": 1, "unit": "" } }, { "abilityId": 129, "accessMode": "rw", "code": "upper_temp", "description": "", "name": "设置温度上限", "typeSpec": { "type": "value", "max": 3000, "min": 50, "scale": 1, "step": 10, "unit": "" } }, { "abilityId": 130, "accessMode": "rw", "code": "lower_temp", "description": "", "name": "设置温度下限", "typeSpec": { "type": "value", "max": 3000, "min": 50, "scale": 1, "step": 10, "unit": "" } }, { "abilityId": 131, "accessMode": "ro", "code": "running_mode", "description": "", "name": "运行状态", "typeSpec": { "type": "enum", "range": [ "Standby", "Comfort", "Comfort_1", "Comfort_2", "ECO", "Anti_forst" ] } }, { "abilityId": 132, "accessMode": "rw", "code": "night_led_config", "description": "共5byte\nByte0-Byte1：开始时间，离00:00的分钟数，大端表示\nByte2-Byte3：结束时间，离00:00的分钟数，大端表示\nByte4：使能开关", "name": "夜间LED配置", "typeSpec": { "type": "raw", "maxlen": 128 } }, { "abilityId": 133, "accessMode": "rw", "code": "ecowatt_url", "description": "", "name": "ecowatt网址", "typeSpec": { "type": "string", "maxlen": 255 } } ] } ] } } ``` ## Suggested File: poll-device.json Use this as a base Gladys device for cloud/local poll tests. Important: - this file reflects the support level available when the issue was created - after implementing support in mappings, update `device_type`, `features`, and `tuya_mapping` to match the final Gladys support - if the final support changes significantly, prefer rebuilding this file from the resulting converted device ```json { "external_id": "tuya:bfc3c1dcdd95241afal8mo", "params": [ { "name": "DEVICE_ID", "value": "bfc3c1dcdd95241afal8mo" }, { "name": "LOCAL_KEY", "value": "***" }, { "name": "CLOUD_IP", "value": "82.x.x.x" }, { "name": "LOCAL_OVERRIDE", "value": true }, { "name": "PRODUCT_ID", "value": "c03zek9b5daz7omr" }, { "name": "IP_ADDRESS", "value": "10.x.x.x" }, { "name": "PROTOCOL_VERSION", "value": "3.5" } ], "features": [], "tuya_mapping": { "ignored_local_dps": [], "ignored_cloud_codes": [] } } ``` ## Suggested File: cloud-status.json Use this as the cloud poll response fixture. Derived from `cloud.assembled.properties`. ```json { "result": [ { "code": "mode", "value": "Anti_forst" }, { "code": "child_lock", "value": false }, { "code": "week_program_1", "value": "VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV" }, { "code": "week_program_2", "value": "VVVVVVVVVSIhEVVRElEVURURFVVVVVVV" }, { "code": "week_program_3", "value": "VVVVVVVVVSIhEVVRFVEVURURFVVVVVVV" }, { "code": "week_program_4", "value": "VVVVVVVVVSIhEVVRFVEVURURVVVVVVVV" }, { "code": "week_program_5", "value": "VVVVVVVVVSIhEVVRFVEVURURVVVVVVVV" }, { "code": "week_program_6", "value": "VVVVVVVVVSIhEVVRFVEVURVVVVVVVVVV" }, { "code": "week_program_7", "value": "VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV" }, { "code": "vacation_duration", "value": 0 }, { "code": "boost_duration", "value": 0 }, { "code": "electricity_statistics", "value": 0 }, { "code": "elec_statistics_day", "value": "AAAAAAAAAAAAAAAAAAAAAAAAAcAhAuAAAAAqBHAABCAEAAAAA5BZBXCkD4AAAABJ" }, { "code": "elec_statistics_month", "value": "AAADpwjGB1sEqwAAAAAAAAAAAAAAAAAAAAA=" }, { "code": "elec_statistics_year", "value": "AAAMBg==" }, { "code": "temp_current", "value": 152 }, { "code": "average_power", "value": 20 }, { "code": "temp_correction", "value": 0 }, { "code": "fault", "value": 0 }, { "code": "air_pressure_index", "value": "H4ppqtom8Ljr3qW5xnTAeqoAiTyiz2E9" }, { "code": "support_features", "value": 31 }, { "code": "window_check", "value": true }, { "code": "window_state", "value": false }, { "code": "window_keep_time", "value": 30 }, { "code": "temp_set", "value": 210 }, { "code": "temp_unit_convert", "value": "c" }, { "code": "app_features", "value": 2 }, { "code": "switch_diff", "value": 10 }, { "code": "upper_temp", "value": 350 }, { "code": "lower_temp", "value": 50 }, { "code": "running_mode", "value": "Anti_forst" }, { "code": "night_led_config", "value": "BLAB4AE=" }, { "code": "ecowatt_url", "value": "" } ] } ``` ## Suggested File: local-dps.json Use this as the local poll DPS fixture. ```json { "101": "Anti_forst", "102": false, "110": 0, "111": 0, "112": 0, "116": 152, "117": 20, "118": 0, "119": 0, "121": 31, "122": true, "123": false, "124": 30, "125": 210, "126": "c", "127": 2, "128": 10, "129": 350, "130": 50, "131": "Anti_forst" } ``` ## Manual Files Guide Build the remaining files manually after the Tuya mappings are in place: 1. Paste `input-device.json` from this issue, then add or update the Tuya mappings in `server/services/tuya/lib/mappings/cloud/`, `server/services/tuya/lib/mappings/local/`, and `server/services/tuya/lib/mappings/index.js`. 2. Create `expected-device.json` from the final Gladys device returned by `convertDevice`. This corresponds to the Tuya device as it should appear in the Discover page once support is implemented. 3. Build or complete `poll-device.json` from the final supported Gladys features. It should contain the final `device_type`, `features`, params, and `tuya_mapping` metadata. 4. Copy `cloud-status.json` from the cloud property values and `local-dps.json` from the local poll DPS payload when available. 5. Create `expected-events.json` if cloud and local polling should emit the same states. If they differ, keep separate `expected-cloud-events.json` and `expected-local-events.json` files instead. 6. Create `expected-local-mapping.json` from the final supported features present in `poll-device.json`, using the resolved DPS returned by the local mapping. ## Device List Entry Source: `GET /v1.0/users/{sourceId}/devices`. ```json { "active_time": 1770543097, "biz_type": 18, "category": "cjkg", "create_time": 1762239529, "icon": "smart/icon/ay1547209623516pqlXf/015f744da8317ddebc6dc6c87019db64.png", "id": "bfc3c1dcdd95241afal8mo", "ip": "82.x.x.x", "lat": "49.6", "local_key": "***", "lon": "0.33", "model": "RP5", "name": "Thermostat Bureau Psycho", "online": true, "owner_id": "20747383", "product_id": "c03zek9b5daz7omr", "product_name": "Pilote Thermostat", "sub": false, "time_zone": "+01:00", "uid": "eu16072678921349PYdM", "update_time": 1771984335, "uuid": "1a82e50fbdb148fb" } ``` ## Supplemental Diagnostics Additional metadata that does not naturally belong to the suggested fixture files. ```json { "selector": "tuya:bfc3c1dcdd95241afal8mo", "service_id": "2ae251ee-8619-4310-9c71-f0542d7a99b7", "device_type": "unknown", "protocol_version": "3.5", "poll_frequency": 30000, "should_poll": true, "local_poll_status": "Success", "unknown_local_dps": [ "101", "102", "110", "111", "112", "116", "117", "118", "119", "121", "122", "123", "124", "125", "126", "127", "128", "129", "130", "131" ] } ``` Note: - The raw `thing_model.response.result.model` string is intentionally omitted here because it is already represented in a readable object form in `input-device.json > thing_model`. ## Remaining Files To Create Manually ```text mapping file(s) in `server/services/tuya/lib/mappings/cloud/` and/or `server/services/tuya/lib/mappings/local/` `server/services/tuya/lib/mappings/index.js` `server/utils/constants.js` when a new Gladys category/type is required `server/services/tuya/lib/device/tuya.deviceMapping.js` when new read/write handlers are required poll-device.json (completed with final supported features) expected-device.json expected-events.json or expected-cloud-events.json / expected-local-events.json expected-local-mapping.json ``` ## Validation Checklist - Confirm the inferred `device_type` - Create or update the mapping files in `server/services/tuya/lib/mappings/cloud/` and/or `server/services/tuya/lib/mappings/local/` - Register the mapping in `server/services/tuya/lib/mappings/index.js` - Update `server/utils/constants.js` if the feature introduces a new Gladys `category/type` - Update `server/services/tuya/lib/device/tuya.deviceMapping.js` if new `readValues` or `writeValues` handlers are needed - Rebuild `poll-device.json` so it matches the final supported Gladys features - Build `expected-device.json` from the final converted Gladys device shown in Discover - Confirm the expected Gladys features - Use a shared `expected-events.json` only when cloud and local polling should emit the same states - Confirm cloud polling behavior - Confirm local polling behavior - Confirm local mapping - Add or update mapping files if needed

I think and hope that the last one also handles @Papashultz’s pilot wire

And for info, here’s what the Issues look like now:

github.com/GladysAssistant/Gladys

Tuya (local) [f3goccgfj6qino4c]: Add support for Air Conditioner

ouvert 04:07PM - 03 Mar 26 UTC

Terdious

## Summary Unsupported or partially supported Tuya device report. - Device nam…e: `Clim Salle d'attente` - External ID: `tuya:bf5638fc7cc3f25e32i45q` - Product ID: `f3goccgfj6qino4c` - Product key: `keyquxnsj75xc8se` - Model: `Air Conditioner` - Category: `kt` - Online: `true` - Local override: `true` - Local poll status: `Success` - Local poll protocol: `3.3` ## Implementation Guide Implement the Tuya support first, then finalize the tests: 1. Add or update the Tuya cloud mapping in `server/services/tuya/lib/mappings/cloud/`. 2. Add or update the Tuya local mapping in `server/services/tuya/lib/mappings/local/`. 3. Register or update the device definition in `server/services/tuya/lib/mappings/index.js`. 4. If the new feature needs a new Gladys `category/type`, add it in `server/utils/constants.js`. 5. If the new feature uses a new `category/type` not yet handled by Tuya reading, update `readValues` in `server/services/tuya/lib/device/tuya.deviceMapping.js`. 6. If the feature should be writable from Gladys, also update `writeValues` in `server/services/tuya/lib/device/tuya.deviceMapping.js`. ## Maintainer Notes This issue contains: - the complete structured Tuya report - suggested fixture input files for onboarding tests - raw cloud responses - local poll DPS when available This issue does not contain: - `expected-device.json` - `expected-events.json` or `expected-cloud-events.json` / `expected-local-events.json` - `expected-local-mapping.json` These expected files should still be reviewed and created manually. `poll-device.json` is only a starting point based on the current support level in Gladys. After adding or updating mappings, it should be completed with the final supported features and mapping metadata. ## Data Coverage - `GET /v1.0/users/{sourceId}/devices` -> `Device List Entry` below - `GET /v1.2/iot-03/devices/{deviceId}/specification` -> `input-device.json > specifications` - `GET /v1.0/iot-03/devices/{deviceId}` -> `input-device.json` top-level metadata - `GET /v2.0/cloud/thing/{deviceId}/shadow/properties` -> `input-device.json > properties` and `cloud-status.json` - `GET /v2.0/cloud/thing/{deviceId}/model` -> `input-device.json > thing_model` - local poll -> `local-dps.json` when available ## Suggested Fixture Folder ```text air-conditioner-f3goccgfj6qino4c ``` Example: ```text server/test/services/tuya/fixtures/devices/air-conditioner-f3goccgfj6qino4c ``` ## Suggested File: manifest.js ```js module.exports = { name: 'Clim Salle d\'attente', convertDevice: { input: './input-device.json', expected: './expected-device.json', }, pollCloud: { device: './poll-device.json', response: './cloud-status.json', expectedEvents: './expected-cloud-events.json', }, pollLocal: { device: './poll-device.json', dps: './local-dps.json', expectedEvents: './expected-local-events.json', expectedCloudRequests: 0, }, localMapping: { device: './poll-device.json', expected: './expected-local-mapping.json', }, }; ``` ## Suggested File: input-device.json Use this as the base input for `convertDevice`. ```json { "id": "bf5638fc7cc3f25e32i45q", "name": "Clim Salle d'attente", "product_name": "Air Conditioner", "model": "Air Conditioner", "product_id": "f3goccgfj6qino4c", "product_key": "keyquxnsj75xc8se", "local_key": "***", "ip": "10.x.x.x", "cloud_ip": "82.x.x.x", "protocol_version": "3.3", "local_override": true, "online": true, "specifications": { "category": "kt", "functions": [ { "code": "switch", "lang_config": { "false": "", "true": "" }, "name": "开关", "type": "Boolean", "values": "{}" }, { "code": "eco", "lang_config": { "false": "", "true": "" }, "name": "ECO模式", "type": "Boolean", "values": "{}" }, { "code": "drying", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Dry", "type": "Boolean", "values": "{}" }, { "code": "cleaning", "lang_config": { "false": "", "true": "" }, "name": "自清洁", "type": "Boolean", "values": "{}" }, { "code": "temp_unit_convert", "lang_config": { "c": "℃", "f": "℉" }, "name": "Display Units", "type": "Enum", "values": "{\"range\":[\"c\",\"f\"]}" }, { "code": "temp_set", "lang_config": { "unit": "℃" }, "name": "Set Temp", "type": "Integer", "values": "{\"unit\":\"℃\",\"min\":160,\"max\":880,\"scale\":1,\"step\":10}" }, { "code": "mode", "lang_config": { "auto": "Auto", "cold": "Cool", "hot": "Heat", "wind": "Vent" }, "name": "Mode", "type": "Enum", "values": "{\"range\":[\"auto\",\"cold\",\"wet\",\"heat\",\"fan\"]}" }, { "code": "heat", "lang_config": { "false": "OFF", "true": "ON" }, "name": " Auxiliary Heat", "type": "Boolean", "values": "{}" }, { "code": "light", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Light", "type": "Boolean", "values": "{}" }, { "code": "sleep", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Sleep", "type": "Boolean", "values": "{}" }, { "code": "health", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Health", "type": "Boolean", "values": "{}" }, { "code": "fan_speed_enum", "lang_config": { "auto": "Auto", "high": "High", "level_2": "Low-Med", "level_4": "Med-High", "low": "Low", "middle": "Medium", "mute": "Quiet", "strong": "Turbo" }, "name": "WindSpeed", "type": "Enum", "values": "{\"range\":[\"auto\",\"low\",\"low_mid\",\"mid\",\"mid_high\",\"high\",\"mute\",\"turbo\"]}" } ], "status": [ { "code": "switch", "lang_config": { "false": "", "true": "" }, "name": "开关", "type": "Boolean", "values": "{}" }, { "code": "fan_speed_enum", "lang_config": { "auto": "Auto", "high": "High", "level_2": "Low-Med", "level_4": "Med-High", "low": "Low", "middle": "Medium", "mute": "Quiet", "strong": "Turbo" }, "name": "WindSpeed", "type": "Enum", "values": "{\"range\":[\"auto\",\"low\",\"low_mid\",\"mid\",\"mid_high\",\"high\",\"mute\",\"turbo\"]}" }, { "code": "eco", "lang_config": { "false": "", "true": "" }, "name": "ECO模式", "type": "Boolean", "values": "{}" }, { "code": "drying", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Dry", "type": "Boolean", "values": "{}" }, { "code": "cleaning", "lang_config": { "false": "", "true": "" }, "name": "自清洁", "type": "Boolean", "values": "{}" }, { "code": "temp_unit_convert", "lang_config": { "c": "℃", "f": "℉" }, "name": "Display Units", "type": "Enum", "values": "{\"range\":[\"c\",\"f\"]}" }, { "code": "temp_set", "lang_config": { "unit": "℃" }, "name": "Set Temp", "type": "Integer", "values": "{\"unit\":\"℃\",\"min\":160,\"max\":880,\"scale\":1,\"step\":10}" }, { "code": "temp_current", "lang_config": { "unit": "℃" }, "name": "Temp Current", "type": "Integer", "values": "{\"unit\":\"℃\",\"min\":0,\"max\":600,\"scale\":1,\"step\":1}" }, { "code": "mode", "lang_config": { "auto": "Auto", "cold": "Cool", "hot": "Heat", "wind": "Vent" }, "name": "Mode", "type": "Enum", "values": "{\"range\":[\"auto\",\"cold\",\"wet\",\"heat\",\"fan\"]}" }, { "code": "heat", "lang_config": { "false": "OFF", "true": "ON" }, "name": " Auxiliary Heat", "type": "Boolean", "values": "{}" }, { "code": "light", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Light", "type": "Boolean", "values": "{}" }, { "code": "countdown_left", "lang_config": { "unit": "Min" }, "name": "Left Time", "type": "Integer", "values": "{\"unit\":\"分钟\",\"min\":0,\"max\":1440,\"scale\":0,\"step\":1}" }, { "code": "sleep", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Sleep", "type": "Boolean", "values": "{}" }, { "code": "health", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Health", "type": "Boolean", "values": "{}" } ] }, "properties": { "properties": [ { "code": "Power", "custom_name": "", "dp_id": 1, "time": 1772521207887, "type": "bool", "value": true }, { "code": "temp_set", "custom_name": "", "dp_id": 2, "time": 1772522965366, "type": "value", "value": 200 }, { "code": "temp_current", "custom_name": "", "dp_id": 3, "time": 1772553646892, "type": "value", "value": 230 }, { "code": "mode", "custom_name": "", "dp_id": 4, "time": 1772521207672, "type": "enum", "value": "heat" }, { "code": "windspeed", "custom_name": "", "dp_id": 5, "time": 1770803041733, "type": "enum", "value": "auto" }, { "code": "mode_ECO", "custom_name": "", "dp_id": 8, "time": 1770474510177, "type": "bool", "value": false }, { "code": "mode_dry", "custom_name": "", "dp_id": 9, "time": 1770474510177, "type": "bool", "value": false }, { "code": "heat", "custom_name": "", "dp_id": 12, "time": 1772522965366, "type": "bool", "value": true }, { "code": "light", "custom_name": "", "dp_id": 13, "time": 1770642835259, "type": "bool", "value": true }, { "code": "windshake", "custom_name": "", "dp_id": 15, "time": 1770642484099, "type": "enum", "value": "off" }, { "code": "Fault", "custom_name": "", "dp_id": 20, "time": 1770474510259, "type": "bitmap", "value": 0 }, { "code": "Countdown", "custom_name": "", "dp_id": 21, "time": 1770474506674, "type": "enum", "value": "0" }, { "code": "countdown_left", "custom_name": "", "dp_id": 22, "time": 1770474508806, "type": "value", "value": 0 }, { "code": "use_number", "custom_name": "", "dp_id": 101, "time": 1770474510421, "type": "value", "value": 0 }, { "code": "total_time", "custom_name": "", "dp_id": 102, "time": 1772553334896, "type": "value", "value": 151 }, { "code": "electricity", "custom_name": "", "dp_id": 103, "time": 1772552853000, "type": "value", "value": 1 }, { "code": "electricity_number", "custom_name": "", "dp_id": 104, "time": 1770474506674, "type": "value", "value": 0 }, { "code": "unit", "custom_name": "", "dp_id": 105, "time": 1771803944077, "type": "enum", "value": "c" }, { "code": "horizontal", "custom_name": "", "dp_id": 106, "time": 1770642446631, "type": "enum", "value": "off" }, { "code": "vertical", "custom_name": "", "dp_id": 107, "time": 1770642484099, "type": "enum", "value": "off" }, { "code": "swing3d", "custom_name": "", "dp_id": 108, "time": 1770474510177, "type": "bool", "value": false }, { "code": "sleep", "custom_name": "", "dp_id": 109, "time": 1770641883241, "type": "bool", "value": false }, { "code": "health", "custom_name": "", "dp_id": 110, "time": 1770642739109, "type": "bool", "value": true }, { "code": "clean", "custom_name": "", "dp_id": 111, "time": 1770474510177, "type": "bool", "value": false }, { "code": "type", "custom_name": "", "dp_id": 112, "time": 1770474510177, "type": "enum", "value": "cold" }, { "code": "fault2", "custom_name": "", "dp_id": 113, "time": 1770474510259, "type": "bitmap", "value": 0 }, { "code": "current_mode", "custom_name": "", "dp_id": 114, "time": 1770474506674, "type": "enum", "value": "cold" }, { "code": "heat8", "custom_name": "", "dp_id": 115, "time": 1770642896790, "type": "bool", "value": false } ] }, "thing_model": { "modelId": "0000003fy5", "services": [ { "actions": [], "code": "", "description": "", "events": [], "name": "默认服务", "properties": [ { "abilityId": 1, "accessMode": "rw", "code": "Power", "description": "", "extensions": { "iconName": "icon-dp_power", "attribute": "1" }, "name": "开关", "typeSpec": { "type": "bool" } }, { "abilityId": 2, "accessMode": "rw", "code": "temp_set", "description": "摄氏度：16-31\n华氏度：61-88", "extensions": { "iconName": "icon-dp_temp" }, "name": "设置温度", "typeSpec": { "type": "value", "max": 880, "min": 160, "scale": 1, "step": 10, "unit": "℃" } }, { "abilityId": 3, "accessMode": "ro", "code": "temp_current", "description": "", "extensions": { "iconName": "icon-dp_sun" }, "name": "当前温度", "typeSpec": { "type": "value", "max": 600, "min": 0, "scale": 1, "step": 1, "unit": "℃" } }, { "abilityId": 4, "accessMode": "rw", "code": "mode", "description": "自动/制冷/除湿/制热/送风", "extensions": { "iconName": "icon-dp_mode" }, "name": "工作模式", "typeSpec": { "type": "enum", "range": [ "auto", "cold", "wet", "heat", "fan" ] } }, { "abilityId": 5, "accessMode": "rw", "code": "windspeed", "description": "自动/低风/中低风/中风/中高风/高风/静音/超强", "extensions": { "iconName": "icon-dp_wind" }, "name": "风速", "typeSpec": { "type": "enum", "range": [ "auto", "low", "low_mid", "mid", "mid_high", "high", "mute", "turbo" ] } }, { "abilityId": 8, "accessMode": "rw", "code": "mode_ECO", "description": "", "extensions": { "iconName": "icon-eco" }, "name": "ECO模式", "typeSpec": { "type": "bool" } }, { "abilityId": 9, "accessMode": "rw", "code": "mode_dry", "description": "", "extensions": { "iconName": "icon-dp_flower" }, "name": "干燥模式", "typeSpec": { "type": "bool" } }, { "abilityId": 12, "accessMode": "rw", "code": "heat", "description": "", "extensions": { "iconName": "icon-dp_light2" }, "name": "辅热", "typeSpec": { "type": "bool" } }, { "abilityId": 13, "accessMode": "rw", "code": "light", "description": "", "extensions": { "iconName": "icon-dp_light" }, "name": "灯光", "typeSpec": { "type": "bool" } }, { "abilityId": 15, "accessMode": "rw", "code": "windshake", "description": "上下/左右/全部/关闭", "extensions": { "iconName": "icon-dp_shake" }, "name": "风摆", "typeSpec": { "type": "enum", "range": [ "un_down", "left_right", "all", "off" ] } }, { "abilityId": 20, "accessMode": "ro", "code": "Fault", "description": "", "extensions": { "iconName": "icon-dp_warming", "scope": "fault" }, "name": "故障告警", "typeSpec": { "type": "bitmap", "label": [ "CL", "E4", "E5", "H6", "H9", "HE", "L0", "L1", "L2", "L3", "L6", "L7", "L8", "L9", "LA", "Ld", "P0", "P1", "P6", "P8", "PA", "PC", "Pd", "PE" ], "maxlen": 24 } }, { "abilityId": 21, "accessMode": "rw", "code": "Countdown", "description": "0:取消，1-6小时。可根据产品实际功能进行设定。", "extensions": { "iconName": "icon-dp_time2" }, "name": "倒计时", "typeSpec": { "type": "enum", "range": [ "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24" ] } }, { "abilityId": 22, "accessMode": "ro", "code": "countdown_left", "description": "", "extensions": { "iconName": "icon-dp_time" }, "name": "倒计时剩余时间", "typeSpec": { "type": "value", "max": 1440, "min": 0, "scale": 0, "step": 1, "unit": "分钟" } }, { "abilityId": 101, "accessMode": "ro", "code": "use_number", "description": "", "name": "使用时间上报次数", "typeSpec": { "type": "value", "max": 100000, "min": 0, "scale": 0, "step": 1, "unit": "" } }, { "abilityId": 102, "accessMode": "ro", "code": "total_time", "description": "", "name": "使用时间", "typeSpec": { "type": "value", "max": 70000, "min": 0, "scale": 0, "step": 1, "unit": "" } }, { "abilityId": 103, "accessMode": "ro", "code": "electricity", "description": "", "extensions": { "trigger": "direct" }, "name": "耗电量", "typeSpec": { "type": "value", "max": 70000, "min": 0, "scale": 1, "step": 1, "unit": "" } }, { "abilityId": 104, "accessMode": "ro", "code": "electricity_number", "description": "", "name": "耗电量上报次数", "typeSpec": { "type": "value", "max": 10000, "min": 0, "scale": 0, "step": 1, "unit": "" } }, { "abilityId": 105, "accessMode": "rw", "code": "unit", "description": "", "name": "温标切换", "typeSpec": { "type": "enum", "range": [ "c", "f" ] } }, { "abilityId": 106, "accessMode": "rw", "code": "horizontal", "description": "关闭/同相扫风/相向扫风", "name": "左右扫风", "typeSpec": { "type": "enum", "range": [ "off", "same", "opposite" ] } }, { "abilityId": 107, "accessMode": "rw", "code": "vertical", "description": "关闭/15扫风/位置1/位置2/位置3/位置4/位置5", "name": "上下扫风", "typeSpec": { "type": "enum", "range": [ "off", "15", "1", "2", "3", "4", "5" ] } }, { "abilityId": 108, "accessMode": "rw", "code": "swing3d", "description": "", "name": "3d扫风", "typeSpec": { "type": "bool" } }, { "abilityId": 109, "accessMode": "rw", "code": "sleep", "description": "", "name": "睡眠", "typeSpec": { "type": "bool" } }, { "abilityId": 110, "accessMode": "rw", "code": "health", "description": "", "name": "健康", "typeSpec": { "type": "bool" } }, { "abilityId": 111, "accessMode": "rw", "code": "clean", "description": "", "name": "清洁", "typeSpec": { "type": "bool" } }, { "abilityId": 112, "accessMode": "ro", "code": "type", "description": "单冷/冷暖", "name": "机型", "typeSpec": { "type": "enum", "range": [ "cold", "cold_heat" ] } }, { "abilityId": 113, "accessMode": "ro", "code": "fault2", "description": "", "extensions": { "scope": "fault" }, "name": "故障告警2", "typeSpec": { "type": "bitmap", "label": [ "PF", "SC", "U0", "U1", "U2", "U3", "U4", "U5", "U6", "U7", "U8", "U9", "UC", "Ud", "E1", "E2" ], "maxlen": 16 } }, { "abilityId": 114, "accessMode": "ro", "code": "current_mode", "description": "", "name": "当前模式", "typeSpec": { "type": "enum", "range": [ "cold", "wet", "heat", "fan" ] } }, { "abilityId": 115, "accessMode": "rw", "code": "heat8", "description": "", "name": "八度制热", "typeSpec": { "type": "bool" } } ] } ] } } ``` ## Suggested File: poll-device.json Use this as a base Gladys device for cloud/local poll tests. Important: - this file reflects the support level available when the issue was created - after implementing support in mappings, update `device_type`, `features`, and `tuya_mapping` to match the final Gladys support - if the final support changes significantly, prefer rebuilding this file from the resulting converted device ```json { "external_id": "tuya:bf5638fc7cc3f25e32i45q", "params": [ { "name": "DEVICE_ID", "value": "bf5638fc7cc3f25e32i45q" }, { "name": "LOCAL_KEY", "value": "***" }, { "name": "CLOUD_IP", "value": "82.x.x.x" }, { "name": "LOCAL_OVERRIDE", "value": true }, { "name": "PRODUCT_ID", "value": "f3goccgfj6qino4c" }, { "name": "CLOUD_STRATEGY", "value": "legacy" }, { "name": "IP_ADDRESS", "value": "10.x.x.x" }, { "name": "PROTOCOL_VERSION", "value": "3.3" }, { "name": "PRODUCT_KEY", "value": "keyquxnsj75xc8se" } ], "features": [ { "name": "switch", "external_id": "tuya:bf5638fc7cc3f25e32i45q:switch", "selector": "tuya:bf5638fc7cc3f25e32i45q:switch", "read_only": false, "has_feedback": true, "min": 0, "max": 1, "category": "switch", "type": "binary" }, { "name": "Power", "external_id": "tuya:bf5638fc7cc3f25e32i45q:Power", "selector": "tuya:bf5638fc7cc3f25e32i45q:Power", "read_only": false, "has_feedback": true, "min": 0, "max": 1, "category": "switch", "type": "binary" } ], "tuya_mapping": { "ignored_local_dps": [], "ignored_cloud_codes": [] } } ``` ## Suggested File: cloud-status.json Use this as the cloud poll response fixture. Derived from `cloud.assembled.properties`. ```json { "result": [ { "code": "Power", "value": true }, { "code": "temp_set", "value": 200 }, { "code": "temp_current", "value": 230 }, { "code": "mode", "value": "heat" }, { "code": "windspeed", "value": "auto" }, { "code": "mode_ECO", "value": false }, { "code": "mode_dry", "value": false }, { "code": "heat", "value": true }, { "code": "light", "value": true }, { "code": "windshake", "value": "off" }, { "code": "Fault", "value": 0 }, { "code": "Countdown", "value": "0" }, { "code": "countdown_left", "value": 0 }, { "code": "use_number", "value": 0 }, { "code": "total_time", "value": 151 }, { "code": "electricity", "value": 1 }, { "code": "electricity_number", "value": 0 }, { "code": "unit", "value": "c" }, { "code": "horizontal", "value": "off" }, { "code": "vertical", "value": "off" }, { "code": "swing3d", "value": false }, { "code": "sleep", "value": false }, { "code": "health", "value": true }, { "code": "clean", "value": false }, { "code": "type", "value": "cold" }, { "code": "fault2", "value": 0 }, { "code": "current_mode", "value": "cold" }, { "code": "heat8", "value": false } ] } ``` ## Suggested File: local-dps.json Use this as the local poll DPS fixture. ```json { "1": true, "2": 200, "3": 230, "4": "heat", "5": "auto", "8": false, "9": false, "12": true, "13": true, "15": "off", "20": 0, "22": 0, "101": 0, "102": 151, "103": 1, "105": "c", "106": "off", "107": "off", "108": false, "109": false, "110": true, "111": false, "112": "cold", "113": 0, "115": false } ``` ## Suggested File: local-scan.json Use this only if a local scan payload exists. ```json { "ip": "10.x.x.x", "version": "3.3", "productKey": "keyquxnsj75xc8se" } ``` ## Manual Files Guide Build the remaining files manually after the Tuya mappings are in place: 1. Paste `input-device.json` from this issue, then add or update the Tuya mappings in `server/services/tuya/lib/mappings/cloud/`, `server/services/tuya/lib/mappings/local/`, and `server/services/tuya/lib/mappings/index.js`. 2. Create `expected-device.json` from the final Gladys device returned by `convertDevice`. This corresponds to the Tuya device as it should appear in the Discover page once support is implemented. 3. Build or complete `poll-device.json` from the final supported Gladys features. It should contain the final `device_type`, `features`, params, and `tuya_mapping` metadata. 4. Copy `cloud-status.json` from the cloud property values and `local-dps.json` from the local poll DPS payload when available. 5. Create `expected-events.json` if cloud and local polling should emit the same states. If they differ, keep separate `expected-cloud-events.json` and `expected-local-events.json` files instead. 6. Create `expected-local-mapping.json` from the final supported features present in `poll-device.json`, using the resolved DPS returned by the local mapping. ## Device List Entry Source: `GET /v1.0/users/{sourceId}/devices`. ```json { "active_time": 1770474506, "biz_type": 18, "category": "kt", "create_time": 1770474506, "icon": "smart/program_category_icon/kt.png", "id": "bf5638fc7cc3f25e32i45q", "ip": "82.x.x.x", "lat": "49.6", "local_key": "***", "lon": "0.33", "model": "", "name": "Clim Salle d'attente", "online": true, "owner_id": "20747383", "product_id": "f3goccgfj6qino4c", "product_name": "Air Conditioner", "status": [ { "code": "switch", "value": true }, { "code": "temp_set", "value": 200 }, { "code": "temp_current", "value": 230 }, { "code": "mode", "value": "hot" }, { "code": "fan_speed_enum", "value": "auto" }, { "code": "eco", "value": false }, { "code": "drying", "value": false }, { "code": "heat", "value": true }, { "code": "light", "value": true }, { "code": "countdown_left", "value": 0 }, { "code": "temp_unit_convert", "value": "c" }, { "code": "sleep", "value": false }, { "code": "health", "value": true }, { "code": "cleaning", "value": false } ], "sub": false, "time_zone": "+01:00", "uid": "eu16072678921349PYdM", "update_time": 1771984329, "uuid": "3a0a51d0530c85aa" } ``` ## Supplemental Diagnostics Additional metadata that does not naturally belong to the suggested fixture files. ```json { "selector": "tuya:bf5638fc7cc3f25e32i45q", "service_id": "f631c437-9b06-4108-9151-4fb27f001e59", "device_type": "unknown", "protocol_version": "3.3", "poll_frequency": 30000, "should_poll": true, "local_poll_status": "Success", "unknown_specification_codes": [ "eco", "drying", "cleaning", "temp_unit_convert", "fan_speed_enum" ], "unknown_local_dps": [ "2", "3", "4", "5", "8", "9", "12", "13", "15", "20", "22", "101", "102", "103", "105", "106", "107", "108", "109", "110", "111", "112", "113", "115" ] } ``` Note: - The raw `thing_model.response.result.model` string is intentionally omitted here because it is already represented in a readable object form in `input-device.json > thing_model`. ## Remaining Files To Create Manually ```text mapping file(s) in `server/services/tuya/lib/mappings/cloud/` and/or `server/services/tuya/lib/mappings/local/` `server/services/tuya/lib/mappings/index.js` `server/utils/constants.js` when a new Gladys category/type is required `server/services/tuya/lib/device/tuya.deviceMapping.js` when new read/write handlers are required poll-device.json (completed with final supported features) expected-device.json expected-events.json or expected-cloud-events.json / expected-local-events.json expected-local-mapping.json ``` ## Validation Checklist - Confirm the inferred `device_type` - Create or update the mapping files in `server/services/tuya/lib/mappings/cloud/` and/or `server/services/tuya/lib/mappings/local/` - Register the mapping in `server/services/tuya/lib/mappings/index.js` - Update `server/utils/constants.js` if the feature introduces a new Gladys `category/type` - Update `server/services/tuya/lib/device/tuya.deviceMapping.js` if new `readValues` or `writeValues` handlers are needed - Rebuild `poll-device.json` so it matches the final supported Gladys features - Build `expected-device.json` from the final converted Gladys device shown in Discover - Confirm the expected Gladys features - Use a shared `expected-events.json` only when cloud and local polling should emit the same states - Confirm cloud polling behavior - Confirm local polling behavior - Confirm local mapping - Add or update mapping files if needed

Terdious · March 5, 2026, 7:14am

New issue addressed in PR:

github.com/GladysAssistant/Gladys

Tuya (local) [f3goccgfj6qino4c]: Add support for Air Conditioner

ouvert 04:07PM - 03 Mar 26 UTC

Terdious

## Summary Unsupported or partially supported Tuya device report. - Device nam…e: `Clim Salle d'attente` - External ID: `tuya:bf5638fc7cc3f25e32i45q` - Product ID: `f3goccgfj6qino4c` - Product key: `keyquxnsj75xc8se` - Model: `Air Conditioner` - Category: `kt` - Online: `true` - Local override: `true` - Local poll status: `Success` - Local poll protocol: `3.3` ## Implementation Guide Implement the Tuya support first, then finalize the tests: 1. Add or update the Tuya cloud mapping in `server/services/tuya/lib/mappings/cloud/`. 2. Add or update the Tuya local mapping in `server/services/tuya/lib/mappings/local/`. 3. Register or update the device definition in `server/services/tuya/lib/mappings/index.js`. 4. If the new feature needs a new Gladys `category/type`, add it in `server/utils/constants.js`. 5. If the new feature uses a new `category/type` not yet handled by Tuya reading, update `readValues` in `server/services/tuya/lib/device/tuya.deviceMapping.js`. 6. If the feature should be writable from Gladys, also update `writeValues` in `server/services/tuya/lib/device/tuya.deviceMapping.js`. ## Maintainer Notes This issue contains: - the complete structured Tuya report - suggested fixture input files for onboarding tests - raw cloud responses - local poll DPS when available This issue does not contain: - `expected-device.json` - `expected-events.json` or `expected-cloud-events.json` / `expected-local-events.json` - `expected-local-mapping.json` These expected files should still be reviewed and created manually. `poll-device.json` is only a starting point based on the current support level in Gladys. After adding or updating mappings, it should be completed with the final supported features and mapping metadata. ## Data Coverage - `GET /v1.0/users/{sourceId}/devices` -> `Device List Entry` below - `GET /v1.2/iot-03/devices/{deviceId}/specification` -> `input-device.json > specifications` - `GET /v1.0/iot-03/devices/{deviceId}` -> `input-device.json` top-level metadata - `GET /v2.0/cloud/thing/{deviceId}/shadow/properties` -> `input-device.json > properties` and `cloud-status.json` - `GET /v2.0/cloud/thing/{deviceId}/model` -> `input-device.json > thing_model` - local poll -> `local-dps.json` when available ## Suggested Fixture Folder ```text air-conditioner-f3goccgfj6qino4c ``` Example: ```text server/test/services/tuya/fixtures/devices/air-conditioner-f3goccgfj6qino4c ``` ## Suggested File: manifest.js ```js module.exports = { name: 'Clim Salle d\'attente', convertDevice: { input: './input-device.json', expected: './expected-device.json', }, pollCloud: { device: './poll-device.json', response: './cloud-status.json', expectedEvents: './expected-cloud-events.json', }, pollLocal: { device: './poll-device.json', dps: './local-dps.json', expectedEvents: './expected-local-events.json', expectedCloudRequests: 0, }, localMapping: { device: './poll-device.json', expected: './expected-local-mapping.json', }, }; ``` ## Suggested File: input-device.json Use this as the base input for `convertDevice`. ```json { "id": "bf5638fc7cc3f25e32i45q", "name": "Clim Salle d'attente", "product_name": "Air Conditioner", "model": "Air Conditioner", "product_id": "f3goccgfj6qino4c", "product_key": "keyquxnsj75xc8se", "local_key": "***", "ip": "10.x.x.x", "cloud_ip": "82.x.x.x", "protocol_version": "3.3", "local_override": true, "online": true, "specifications": { "category": "kt", "functions": [ { "code": "switch", "lang_config": { "false": "", "true": "" }, "name": "开关", "type": "Boolean", "values": "{}" }, { "code": "eco", "lang_config": { "false": "", "true": "" }, "name": "ECO模式", "type": "Boolean", "values": "{}" }, { "code": "drying", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Dry", "type": "Boolean", "values": "{}" }, { "code": "cleaning", "lang_config": { "false": "", "true": "" }, "name": "自清洁", "type": "Boolean", "values": "{}" }, { "code": "temp_unit_convert", "lang_config": { "c": "℃", "f": "℉" }, "name": "Display Units", "type": "Enum", "values": "{\"range\":[\"c\",\"f\"]}" }, { "code": "temp_set", "lang_config": { "unit": "℃" }, "name": "Set Temp", "type": "Integer", "values": "{\"unit\":\"℃\",\"min\":160,\"max\":880,\"scale\":1,\"step\":10}" }, { "code": "mode", "lang_config": { "auto": "Auto", "cold": "Cool", "hot": "Heat", "wind": "Vent" }, "name": "Mode", "type": "Enum", "values": "{\"range\":[\"auto\",\"cold\",\"wet\",\"heat\",\"fan\"]}" }, { "code": "heat", "lang_config": { "false": "OFF", "true": "ON" }, "name": " Auxiliary Heat", "type": "Boolean", "values": "{}" }, { "code": "light", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Light", "type": "Boolean", "values": "{}" }, { "code": "sleep", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Sleep", "type": "Boolean", "values": "{}" }, { "code": "health", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Health", "type": "Boolean", "values": "{}" }, { "code": "fan_speed_enum", "lang_config": { "auto": "Auto", "high": "High", "level_2": "Low-Med", "level_4": "Med-High", "low": "Low", "middle": "Medium", "mute": "Quiet", "strong": "Turbo" }, "name": "WindSpeed", "type": "Enum", "values": "{\"range\":[\"auto\",\"low\",\"low_mid\",\"mid\",\"mid_high\",\"high\",\"mute\",\"turbo\"]}" } ], "status": [ { "code": "switch", "lang_config": { "false": "", "true": "" }, "name": "开关", "type": "Boolean", "values": "{}" }, { "code": "fan_speed_enum", "lang_config": { "auto": "Auto", "high": "High", "level_2": "Low-Med", "level_4": "Med-High", "low": "Low", "middle": "Medium", "mute": "Quiet", "strong": "Turbo" }, "name": "WindSpeed", "type": "Enum", "values": "{\"range\":[\"auto\",\"low\",\"low_mid\",\"mid\",\"mid_high\",\"high\",\"mute\",\"turbo\"]}" }, { "code": "eco", "lang_config": { "false": "", "true": "" }, "name": "ECO模式", "type": "Boolean", "values": "{}" }, { "code": "drying", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Dry", "type": "Boolean", "values": "{}" }, { "code": "cleaning", "lang_config": { "false": "", "true": "" }, "name": "自清洁", "type": "Boolean", "values": "{}" }, { "code": "temp_unit_convert", "lang_config": { "c": "℃", "f": "℉" }, "name": "Display Units", "type": "Enum", "values": "{\"range\":[\"c\",\"f\"]}" }, { "code": "temp_set", "lang_config": { "unit": "℃" }, "name": "Set Temp", "type": "Integer", "values": "{\"unit\":\"℃\",\"min\":160,\"max\":880,\"scale\":1,\"step\":10}" }, { "code": "temp_current", "lang_config": { "unit": "℃" }, "name": "Temp Current", "type": "Integer", "values": "{\"unit\":\"℃\",\"min\":0,\"max\":600,\"scale\":1,\"step\":1}" }, { "code": "mode", "lang_config": { "auto": "Auto", "cold": "Cool", "hot": "Heat", "wind": "Vent" }, "name": "Mode", "type": "Enum", "values": "{\"range\":[\"auto\",\"cold\",\"wet\",\"heat\",\"fan\"]}" }, { "code": "heat", "lang_config": { "false": "OFF", "true": "ON" }, "name": " Auxiliary Heat", "type": "Boolean", "values": "{}" }, { "code": "light", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Light", "type": "Boolean", "values": "{}" }, { "code": "countdown_left", "lang_config": { "unit": "Min" }, "name": "Left Time", "type": "Integer", "values": "{\"unit\":\"分钟\",\"min\":0,\"max\":1440,\"scale\":0,\"step\":1}" }, { "code": "sleep", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Sleep", "type": "Boolean", "values": "{}" }, { "code": "health", "lang_config": { "false": "OFF", "true": "ON" }, "name": "Health", "type": "Boolean", "values": "{}" } ] }, "properties": { "properties": [ { "code": "Power", "custom_name": "", "dp_id": 1, "time": 1772521207887, "type": "bool", "value": true }, { "code": "temp_set", "custom_name": "", "dp_id": 2, "time": 1772522965366, "type": "value", "value": 200 }, { "code": "temp_current", "custom_name": "", "dp_id": 3, "time": 1772553646892, "type": "value", "value": 230 }, { "code": "mode", "custom_name": "", "dp_id": 4, "time": 1772521207672, "type": "enum", "value": "heat" }, { "code": "windspeed", "custom_name": "", "dp_id": 5, "time": 1770803041733, "type": "enum", "value": "auto" }, { "code": "mode_ECO", "custom_name": "", "dp_id": 8, "time": 1770474510177, "type": "bool", "value": false }, { "code": "mode_dry", "custom_name": "", "dp_id": 9, "time": 1770474510177, "type": "bool", "value": false }, { "code": "heat", "custom_name": "", "dp_id": 12, "time": 1772522965366, "type": "bool", "value": true }, { "code": "light", "custom_name": "", "dp_id": 13, "time": 1770642835259, "type": "bool", "value": true }, { "code": "windshake", "custom_name": "", "dp_id": 15, "time": 1770642484099, "type": "enum", "value": "off" }, { "code": "Fault", "custom_name": "", "dp_id": 20, "time": 1770474510259, "type": "bitmap", "value": 0 }, { "code": "Countdown", "custom_name": "", "dp_id": 21, "time": 1770474506674, "type": "enum", "value": "0" }, { "code": "countdown_left", "custom_name": "", "dp_id": 22, "time": 1770474508806, "type": "value", "value": 0 }, { "code": "use_number", "custom_name": "", "dp_id": 101, "time": 1770474510421, "type": "value", "value": 0 }, { "code": "total_time", "custom_name": "", "dp_id": 102, "time": 1772553334896, "type": "value", "value": 151 }, { "code": "electricity", "custom_name": "", "dp_id": 103, "time": 1772552853000, "type": "value", "value": 1 }, { "code": "electricity_number", "custom_name": "", "dp_id": 104, "time": 1770474506674, "type": "value", "value": 0 }, { "code": "unit", "custom_name": "", "dp_id": 105, "time": 1771803944077, "type": "enum", "value": "c" }, { "code": "horizontal", "custom_name": "", "dp_id": 106, "time": 1770642446631, "type": "enum", "value": "off" }, { "code": "vertical", "custom_name": "", "dp_id": 107, "time": 1770642484099, "type": "enum", "value": "off" }, { "code": "swing3d", "custom_name": "", "dp_id": 108, "time": 1770474510177, "type": "bool", "value": false }, { "code": "sleep", "custom_name": "", "dp_id": 109, "time": 1770641883241, "type": "bool", "value": false }, { "code": "health", "custom_name": "", "dp_id": 110, "time": 1770642739109, "type": "bool", "value": true }, { "code": "clean", "custom_name": "", "dp_id": 111, "time": 1770474510177, "type": "bool", "value": false }, { "code": "type", "custom_name": "", "dp_id": 112, "time": 1770474510177, "type": "enum", "value": "cold" }, { "code": "fault2", "custom_name": "", "dp_id": 113, "time": 1770474510259, "type": "bitmap", "value": 0 }, { "code": "current_mode", "custom_name": "", "dp_id": 114, "time": 1770474506674, "type": "enum", "value": "cold" }, { "code": "heat8", "custom_name": "", "dp_id": 115, "time": 1770642896790, "type": "bool", "value": false } ] }, "thing_model": { "modelId": "0000003fy5", "services": [ { "actions": [], "code": "", "description": "", "events": [], "name": "默认服务", "properties": [ { "abilityId": 1, "accessMode": "rw", "code": "Power", "description": "", "extensions": { "iconName": "icon-dp_power", "attribute": "1" }, "name": "开关", "typeSpec": { "type": "bool" } }, { "abilityId": 2, "accessMode": "rw", "code": "temp_set", "description": "摄氏度：16-31\n华氏度：61-88", "extensions": { "iconName": "icon-dp_temp" }, "name": "设置温度", "typeSpec": { "type": "value", "max": 880, "min": 160, "scale": 1, "step": 10, "unit": "℃" } }, { "abilityId": 3, "accessMode": "ro", "code": "temp_current", "description": "", "extensions": { "iconName": "icon-dp_sun" }, "name": "当前温度", "typeSpec": { "type": "value", "max": 600, "min": 0, "scale": 1, "step": 1, "unit": "℃" } }, { "abilityId": 4, "accessMode": "rw", "code": "mode", "description": "自动/制冷/除湿/制热/送风", "extensions": { "iconName": "icon-dp_mode" }, "name": "工作模式", "typeSpec": { "type": "enum", "range": [ "auto", "cold", "wet", "heat", "fan" ] } }, { "abilityId": 5, "accessMode": "rw", "code": "windspeed", "description": "自动/低风/中低风/中风/中高风/高风/静音/超强", "extensions": { "iconName": "icon-dp_wind" }, "name": "风速", "typeSpec": { "type": "enum", "range": [ "auto", "low", "low_mid", "mid", "mid_high", "high", "mute", "turbo" ] } }, { "abilityId": 8, "accessMode": "rw", "code": "mode_ECO", "description": "", "extensions": { "iconName": "icon-eco" }, "name": "ECO模式", "typeSpec": { "type": "bool" } }, { "abilityId": 9, "accessMode": "rw", "code": "mode_dry", "description": "", "extensions": { "iconName": "icon-dp_flower" }, "name": "干燥模式", "typeSpec": { "type": "bool" } }, { "abilityId": 12, "accessMode": "rw", "code": "heat", "description": "", "extensions": { "iconName": "icon-dp_light2" }, "name": "辅热", "typeSpec": { "type": "bool" } }, { "abilityId": 13, "accessMode": "rw", "code": "light", "description": "", "extensions": { "iconName": "icon-dp_light" }, "name": "灯光", "typeSpec": { "type": "bool" } }, { "abilityId": 15, "accessMode": "rw", "code": "windshake", "description": "上下/左右/全部/关闭", "extensions": { "iconName": "icon-dp_shake" }, "name": "风摆", "typeSpec": { "type": "enum", "range": [ "un_down", "left_right", "all", "off" ] } }, { "abilityId": 20, "accessMode": "ro", "code": "Fault", "description": "", "extensions": { "iconName": "icon-dp_warming", "scope": "fault" }, "name": "故障告警", "typeSpec": { "type": "bitmap", "label": [ "CL", "E4", "E5", "H6", "H9", "HE", "L0", "L1", "L2", "L3", "L6", "L7", "L8", "L9", "LA", "Ld", "P0", "P1", "P6", "P8", "PA", "PC", "Pd", "PE" ], "maxlen": 24 } }, { "abilityId": 21, "accessMode": "rw", "code": "Countdown", "description": "0:取消，1-6小时。可根据产品实际功能进行设定。", "extensions": { "iconName": "icon-dp_time2" }, "name": "倒计时", "typeSpec": { "type": "enum", "range": [ "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24" ] } }, { "abilityId": 22, "accessMode": "ro", "code": "countdown_left", "description": "", "extensions": { "iconName": "icon-dp_time" }, "name": "倒计时剩余时间", "typeSpec": { "type": "value", "max": 1440, "min": 0, "scale": 0, "step": 1, "unit": "分钟" } }, { "abilityId": 101, "accessMode": "ro", "code": "use_number", "description": "", "name": "使用时间上报次数", "typeSpec": { "type": "value", "max": 100000, "min": 0, "scale": 0, "step": 1, "unit": "" } }, { "abilityId": 102, "accessMode": "ro", "code": "total_time", "description": "", "name": "使用时间", "typeSpec": { "type": "value", "max": 70000, "min": 0, "scale": 0, "step": 1, "unit": "" } }, { "abilityId": 103, "accessMode": "ro", "code": "electricity", "description": "", "extensions": { "trigger": "direct" }, "name": "耗电量", "typeSpec": { "type": "value", "max": 70000, "min": 0, "scale": 1, "step": 1, "unit": "" } }, { "abilityId": 104, "accessMode": "ro", "code": "electricity_number", "description": "", "name": "耗电量上报次数", "typeSpec": { "type": "value", "max": 10000, "min": 0, "scale": 0, "step": 1, "unit": "" } }, { "abilityId": 105, "accessMode": "rw", "code": "unit", "description": "", "name": "温标切换", "typeSpec": { "type": "enum", "range": [ "c", "f" ] } }, { "abilityId": 106, "accessMode": "rw", "code": "horizontal", "description": "关闭/同相扫风/相向扫风", "name": "左右扫风", "typeSpec": { "type": "enum", "range": [ "off", "same", "opposite" ] } }, { "abilityId": 107, "accessMode": "rw", "code": "vertical", "description": "关闭/15扫风/位置1/位置2/位置3/位置4/位置5", "name": "上下扫风", "typeSpec": { "type": "enum", "range": [ "off", "15", "1", "2", "3", "4", "5" ] } }, { "abilityId": 108, "accessMode": "rw", "code": "swing3d", "description": "", "name": "3d扫风", "typeSpec": { "type": "bool" } }, { "abilityId": 109, "accessMode": "rw", "code": "sleep", "description": "", "name": "睡眠", "typeSpec": { "type": "bool" } }, { "abilityId": 110, "accessMode": "rw", "code": "health", "description": "", "name": "健康", "typeSpec": { "type": "bool" } }, { "abilityId": 111, "accessMode": "rw", "code": "clean", "description": "", "name": "清洁", "typeSpec": { "type": "bool" } }, { "abilityId": 112, "accessMode": "ro", "code": "type", "description": "单冷/冷暖", "name": "机型", "typeSpec": { "type": "enum", "range": [ "cold", "cold_heat" ] } }, { "abilityId": 113, "accessMode": "ro", "code": "fault2", "description": "", "extensions": { "scope": "fault" }, "name": "故障告警2", "typeSpec": { "type": "bitmap", "label": [ "PF", "SC", "U0", "U1", "U2", "U3", "U4", "U5", "U6", "U7", "U8", "U9", "UC", "Ud", "E1", "E2" ], "maxlen": 16 } }, { "abilityId": 114, "accessMode": "ro", "code": "current_mode", "description": "", "name": "当前模式", "typeSpec": { "type": "enum", "range": [ "cold", "wet", "heat", "fan" ] } }, { "abilityId": 115, "accessMode": "rw", "code": "heat8", "description": "", "name": "八度制热", "typeSpec": { "type": "bool" } } ] } ] } } ``` ## Suggested File: poll-device.json Use this as a base Gladys device for cloud/local poll tests. Important: - this file reflects the support level available when the issue was created - after implementing support in mappings, update `device_type`, `features`, and `tuya_mapping` to match the final Gladys support - if the final support changes significantly, prefer rebuilding this file from the resulting converted device ```json { "external_id": "tuya:bf5638fc7cc3f25e32i45q", "params": [ { "name": "DEVICE_ID", "value": "bf5638fc7cc3f25e32i45q" }, { "name": "LOCAL_KEY", "value": "***" }, { "name": "CLOUD_IP", "value": "82.x.x.x" }, { "name": "LOCAL_OVERRIDE", "value": true }, { "name": "PRODUCT_ID", "value": "f3goccgfj6qino4c" }, { "name": "CLOUD_STRATEGY", "value": "legacy" }, { "name": "IP_ADDRESS", "value": "10.x.x.x" }, { "name": "PROTOCOL_VERSION", "value": "3.3" }, { "name": "PRODUCT_KEY", "value": "keyquxnsj75xc8se" } ], "features": [ { "name": "switch", "external_id": "tuya:bf5638fc7cc3f25e32i45q:switch", "selector": "tuya:bf5638fc7cc3f25e32i45q:switch", "read_only": false, "has_feedback": true, "min": 0, "max": 1, "category": "switch", "type": "binary" }, { "name": "Power", "external_id": "tuya:bf5638fc7cc3f25e32i45q:Power", "selector": "tuya:bf5638fc7cc3f25e32i45q:Power", "read_only": false, "has_feedback": true, "min": 0, "max": 1, "category": "switch", "type": "binary" } ], "tuya_mapping": { "ignored_local_dps": [], "ignored_cloud_codes": [] } } ``` ## Suggested File: cloud-status.json Use this as the cloud poll response fixture. Derived from `cloud.assembled.properties`. ```json { "result": [ { "code": "Power", "value": true }, { "code": "temp_set", "value": 200 }, { "code": "temp_current", "value": 230 }, { "code": "mode", "value": "heat" }, { "code": "windspeed", "value": "auto" }, { "code": "mode_ECO", "value": false }, { "code": "mode_dry", "value": false }, { "code": "heat", "value": true }, { "code": "light", "value": true }, { "code": "windshake", "value": "off" }, { "code": "Fault", "value": 0 }, { "code": "Countdown", "value": "0" }, { "code": "countdown_left", "value": 0 }, { "code": "use_number", "value": 0 }, { "code": "total_time", "value": 151 }, { "code": "electricity", "value": 1 }, { "code": "electricity_number", "value": 0 }, { "code": "unit", "value": "c" }, { "code": "horizontal", "value": "off" }, { "code": "vertical", "value": "off" }, { "code": "swing3d", "value": false }, { "code": "sleep", "value": false }, { "code": "health", "value": true }, { "code": "clean", "value": false }, { "code": "type", "value": "cold" }, { "code": "fault2", "value": 0 }, { "code": "current_mode", "value": "cold" }, { "code": "heat8", "value": false } ] } ``` ## Suggested File: local-dps.json Use this as the local poll DPS fixture. ```json { "1": true, "2": 200, "3": 230, "4": "heat", "5": "auto", "8": false, "9": false, "12": true, "13": true, "15": "off", "20": 0, "22": 0, "101": 0, "102": 151, "103": 1, "105": "c", "106": "off", "107": "off", "108": false, "109": false, "110": true, "111": false, "112": "cold", "113": 0, "115": false } ``` ## Suggested File: local-scan.json Use this only if a local scan payload exists. ```json { "ip": "10.x.x.x", "version": "3.3", "productKey": "keyquxnsj75xc8se" } ``` ## Manual Files Guide Build the remaining files manually after the Tuya mappings are in place: 1. Paste `input-device.json` from this issue, then add or update the Tuya mappings in `server/services/tuya/lib/mappings/cloud/`, `server/services/tuya/lib/mappings/local/`, and `server/services/tuya/lib/mappings/index.js`. 2. Create `expected-device.json` from the final Gladys device returned by `convertDevice`. This corresponds to the Tuya device as it should appear in the Discover page once support is implemented. 3. Build or complete `poll-device.json` from the final supported Gladys features. It should contain the final `device_type`, `features`, params, and `tuya_mapping` metadata. 4. Copy `cloud-status.json` from the cloud property values and `local-dps.json` from the local poll DPS payload when available. 5. Create `expected-events.json` if cloud and local polling should emit the same states. If they differ, keep separate `expected-cloud-events.json` and `expected-local-events.json` files instead. 6. Create `expected-local-mapping.json` from the final supported features present in `poll-device.json`, using the resolved DPS returned by the local mapping. ## Device List Entry Source: `GET /v1.0/users/{sourceId}/devices`. ```json { "active_time": 1770474506, "biz_type": 18, "category": "kt", "create_time": 1770474506, "icon": "smart/program_category_icon/kt.png", "id": "bf5638fc7cc3f25e32i45q", "ip": "82.x.x.x", "lat": "49.6", "local_key": "***", "lon": "0.33", "model": "", "name": "Clim Salle d'attente", "online": true, "owner_id": "20747383", "product_id": "f3goccgfj6qino4c", "product_name": "Air Conditioner", "status": [ { "code": "switch", "value": true }, { "code": "temp_set", "value": 200 }, { "code": "temp_current", "value": 230 }, { "code": "mode", "value": "hot" }, { "code": "fan_speed_enum", "value": "auto" }, { "code": "eco", "value": false }, { "code": "drying", "value": false }, { "code": "heat", "value": true }, { "code": "light", "value": true }, { "code": "countdown_left", "value": 0 }, { "code": "temp_unit_convert", "value": "c" }, { "code": "sleep", "value": false }, { "code": "health", "value": true }, { "code": "cleaning", "value": false } ], "sub": false, "time_zone": "+01:00", "uid": "eu16072678921349PYdM", "update_time": 1771984329, "uuid": "3a0a51d0530c85aa" } ``` ## Supplemental Diagnostics Additional metadata that does not naturally belong to the suggested fixture files. ```json { "selector": "tuya:bf5638fc7cc3f25e32i45q", "service_id": "f631c437-9b06-4108-9151-4fb27f001e59", "device_type": "unknown", "protocol_version": "3.3", "poll_frequency": 30000, "should_poll": true, "local_poll_status": "Success", "unknown_specification_codes": [ "eco", "drying", "cleaning", "temp_unit_convert", "fan_speed_enum" ], "unknown_local_dps": [ "2", "3", "4", "5", "8", "9", "12", "13", "15", "20", "22", "101", "102", "103", "105", "106", "107", "108", "109", "110", "111", "112", "113", "115" ] } ``` Note: - The raw `thing_model.response.result.model` string is intentionally omitted here because it is already represented in a readable object form in `input-device.json > thing_model`. ## Remaining Files To Create Manually ```text mapping file(s) in `server/services/tuya/lib/mappings/cloud/` and/or `server/services/tuya/lib/mappings/local/` `server/services/tuya/lib/mappings/index.js` `server/utils/constants.js` when a new Gladys category/type is required `server/services/tuya/lib/device/tuya.deviceMapping.js` when new read/write handlers are required poll-device.json (completed with final supported features) expected-device.json expected-events.json or expected-cloud-events.json / expected-local-events.json expected-local-mapping.json ``` ## Validation Checklist - Confirm the inferred `device_type` - Create or update the mapping files in `server/services/tuya/lib/mappings/cloud/` and/or `server/services/tuya/lib/mappings/local/` - Register the mapping in `server/services/tuya/lib/mappings/index.js` - Update `server/utils/constants.js` if the feature introduces a new Gladys `category/type` - Update `server/services/tuya/lib/device/tuya.deviceMapping.js` if new `readValues` or `writeValues` handlers are needed - Rebuild `poll-device.json` so it matches the final supported Gladys features - Build `expected-device.json` from the final converted Gladys device shown in Discover - Confirm the expected Gladys features - Use a shared `expected-events.json` only when cloud and local polling should emit the same states - Confirm cloud polling behavior - Confirm local polling behavior - Confirm local mapping - Add or update mapping files if needed

github.com/GladysAssistant/Gladys

Tuya Air Condioner support

master ← Terdious:tuya-air-conditioner-support

ouvert 01:59AM - 23 Feb 26 UTC

Terdious

+15885 -452

### Pull Request check-list To ensure your Pull Request can be accepted as fa…st as possible, make sure to review and check all of these items: - [ ] If your changes affect the code, did you write the tests? - [ ] Are tests passing? (`npm test` on both front/server) - [ ] Is the linter passing? (`npm run eslint` on both front/server) - [ ] Did you run prettier? (`npm run prettier` on both front/server) - [ ] If you are adding a new feature/service, did you run the integration comparator? (`npm run compare-translations` on front) - [ ] Did you test this pull request in real life? With real devices? If this development is a big feature or a new service, we recommend that you provide a Docker image to the community ([forum](https://community.gladysassistant.com/)) for testing before merging. - [ ] If your changes modify the API (REST or Node.js), did you modify the API documentation? (Documentation is based on comments in code) - [ ] If you are adding a new features/services which needs explanation, did you modify the user documentation? See [the GitHub repo](https://github.com/GladysAssistant/v4-website) and the [website](https://gladysassistant.com). - [ ] Did you add fake requests data for the demo mode (`front/src/config/demo.js`) so that the demo website is working without a backend? (if needed) See [https://demo.gladysassistant.com](https://demo.gladysassistant.com). NOTE: these things are not required to open a PR and can be done afterwards / while the PR is open. ### Description of change ## Summary This PR adds full Tuya air-conditioner support in the integration stack, based on issue #2479. It introduces dedicated mapping, read/write conversions, UI support, and fixture-driven coverage for a real AC payload. ## Details - Added dedicated Tuya mappings for `air-conditioner`: - Cloud mapping: `switch`, `temp_set`, `temp_current`, `mode`, `fan_speed_enum`, `horizontal`, `vertical` - Local DPS mapping aligned with the same capabilities - Registered the new device type in Tuya mapping index and constants. - Extended Tuya read/write value mapping for air-conditioning capabilities: - power on/off - target/current temperature - mode - fan speed - horizontal/vertical swing - Added frontend support for new air-conditioning controls: - fan speed feature component - swing feature component - integration in supported feature rendering - Updated i18n labels (`en`, `fr`, `de`) for the new AC controls. - Added full fixture set for `air-conditioner-f3goccgfj6qino4c` and related integration tests. - Completed follow-up test/logic cleanup: - added missing write test for AC binary mapping - simplified `tuya.cloudStrategy` to remove dead/unreachable branches and keep behavior explicit ## Scope Diff vs `tuya-pilot-thermostat-support`: - `server (prod)`: `+311 / -11` - `server tests`: `+778 / -0` - `front (prod)`: `+147 / -45` - `translations (i18n)`: `+93 / -6` ## Summary by CodeRabbit * **New Features** * More air‑conditioning controls: fan‑speed, eco, drying, cleaning, aux‑heat, light, sleep, health. * Local network discovery and polling for Tuya devices. * GitHub issue workflow to suggest unsupported/partially supported devices. * **Improvements** * Richer Tuya device UI: cloud/local mode, IP/protocol controls, device ranking and partial‑support indicators, better connection states. * Automatic temperature‑unit detection and conversion. * Expanded translations (EN/DE/FR) and messaging.

Device :

Dashboard

Horizontal sweep :

Vertical sweep :

Mode :

Fan speed :

Topic		Replies	Views
Prises en charge des devices avec l'application Smartlife/tuya [Archive] Demande de fonctionnalités feature-integration , tuya	100	6197	July 10, 2023
Détection de présence via le réseau local [Archive] Demande de fonctionnalités feature-integration , capteur-présence	148	5055	May 13, 2023
Broadlink service Développement feature-integration	84	2140	May 17, 2024
[TP-Link] Développement nouveau service Développement	56	2556	January 14, 2022
Intégration HomeKit et Siri Développement	87	3019	December 3, 2025

Related topics