Config flow: improve instructions for hub connections

- Devices connected through hubs need to use the hub's device id and the uuid from the sub device (used to be labelled cid or node_id in various places in the API Explorer, and uuid was a duplicate, but the API Explorer seems to have been consolidated and now only shows uuid). - Remove cid from the options flow. This forms part of the unique id for the device registry, so cannot be changed after installation.
johnnyaug · Nov 11, 2024 · faffaba · faffaba
1 parent 175c1cc
commit faffaba
Show file tree

Hide file tree

Showing 21 changed files with 64 additions and 81 deletions.
diff --git a/custom_components/tuya_local/config_flow.py b/custom_components/tuya_local/config_flow.py
@@ -470,10 +470,6 @@ async def async_step_user(self, user_input=None):
             vol.Required(
                 CONF_POLL_ONLY, default=config.get(CONF_POLL_ONLY, False)
             ): bool,
-            vol.Optional(
-                CONF_DEVICE_CID,
-                default=config.get(CONF_DEVICE_CID, ""),
-            ): str,
         }
         cfg = await self.hass.async_add_executor_job(
             get_config,

diff --git a/custom_components/tuya_local/translations/bg.json b/custom_components/tuya_local/translations/bg.json
@@ -37,11 +37,11 @@
                 "description": "[Следвайте тези инструкции, за да откриете идентификатора на вашето устройство и локалния ключ] (https://github.com/make-all/tuya-local#finding-your-device-id-and-local-key)",
                 "data": {
                     "host": "IP адрес или име на хост",
-                    "device_id": "Device ID",
+                    "device_id": "Device ID (или Device ID шлюза, за устройства свързани чрез шлюз)",
                     "local_key": "Локален ключ",
                     "protocol_version": "Версия на протокола (опитайте автоматична, ако не е известна)",
                     "poll_only": "Само анкетиране (опитайте това, ако устройството ви не работи напълно)",
-                    "device_cid": "[bg] Sub device ID (for devices connected via gateway)"
+                    "device_cid": "Sub device UUID (за устройства свързани чрез шлюз)"
                 }
             },
             "select_type": {
@@ -87,8 +87,7 @@
                     "host": "IP адрес или име на хост",
                     "local_key": "Локален ключ",
                     "protocol_version": "Версия на протокола (опитайте автоматична, ако не е известна)",
-                    "poll_only": "Само анкетиране (опитайте това, ако устройството ви не работи напълно)",
-                    "device_cid": "Sub device ID (за устройства свързани чрез шлюз)"
+                    "poll_only": "Само анкетиране (опитайте това, ако устройството ви не работи напълно)"
                 }
             }
         },

diff --git a/custom_components/tuya_local/translations/cz.json b/custom_components/tuya_local/translations/cz.json
@@ -37,11 +37,11 @@
                 "description": "[Postupujte podle tohoto návodu pro získaní identifikátoru zařízení (device_id) a lokálního klíče (local_key).](https://github.com/make-all/tuya-local#finding-your-device-id-and-local-key)",
                 "data": {
                     "host": "IP adresa nebo název hostitele (hostname)",
-                    "device_id": "identifikátor zařízení (device_id)",
+                    "device_id": "identifikátor zařízení (device_id, nebo device_id brány pro zařízení připojená pomocí brány) ",
                     "local_key": "lokální klíč (local_key)",
                     "protocol_version": "Verze protokolu (zkuste auto pokud ji neznáte)",
                     "poll_only": "Poll only (vyzkoušejte pokud zařízení úplně nefunguje)",
-                    "device_cid": "Sub device ID (pro zařízení připojená pomocí brány)"
+                    "device_cid": "Sub device UUID (pro zařízení připojená pomocí brány)"
                 }
             },
             "select_type": {
@@ -87,8 +87,7 @@
                     "host": "IP adresa nebo název hostitele (hostname)",
                     "local_key": "lokální klíč (local_key)",
                     "protocol_version": "Verze protokolu (zkuste auto pokud ji neznáte)",
-                    "poll_only": "Poll only (vyzkoušejte pokud zařízení úplně nefunguje)",
-                    "device_cid": "Sub device ID (pro zařízení připojená pomocí brány)"
+                    "poll_only": "Poll only (vyzkoušejte pokud zařízení úplně nefunguje)"
                 }
             }
         },

diff --git a/custom_components/tuya_local/translations/de.json b/custom_components/tuya_local/translations/de.json
@@ -37,11 +37,11 @@
                 "description": "[Folgen Sie diesen Anweisungen, um Ihre Geräte-ID und Ihren lokalen Schlüssel zu finden.](https://github.com/make-all/tuya-local#finding-your-device-id-and-local-key)",
                 "data": {
                     "host": "IP-Adresse oder Host-Name",
-                    "device_id": "Geräte-ID",
+                    "device_id": "Geräte-ID (device_id, oder device_id des Gateways für Geräte, die über ein Gateway angeschlossen sind)",
                     "local_key": "Lokaler Schlüssel",
                     "protocol_version": "Protokollversion (versuchen Sie auto, falls nicht bekannt)",
                     "poll_only": "Nur Abfrage (versuchen Sie dies, wenn Ihr Gerät nicht vollständig funktioniert)",
-                    "device_cid": "Sub Geräte-ID (für Geräte, die über ein Gateway angeschlossen sind)"
+                    "device_cid": "Sub Geräte UUID (für Geräte, die über ein Gateway angeschlossen sind)"
                 }
             },
             "select_type": {
@@ -87,8 +87,7 @@
                     "host": "IP-Adresse oder Host-Name",
                     "local_key": "Lokaler Schlüssel",
                     "protocol_version": "Protokollversion (versuchen Sie auto, falls nicht bekannt)",
-                    "poll_only": "Nur Abfrage (versuchen Sie dies, wenn Ihr Gerät nicht vollständig funktioniert)",
-                    "device_cid": "Sub Geräte-ID (für Geräte, die über ein Gateway angeschlossen sind)"
+                    "poll_only": "Nur Abfrage (versuchen Sie dies, wenn Ihr Gerät nicht vollständig funktioniert)"
                 }
             }
         },

diff --git a/custom_components/tuya_local/translations/el.json b/custom_components/tuya_local/translations/el.json
@@ -37,11 +37,11 @@
                 "description": "[Ακολουθήστε αυτές τις οδηγίες για να βρείτε το device id και το local key.](https://github.com/make-all/tuya-local#finding-your-device-id-and-local-key)",
                 "data": {
                     "host": "Διεύθυνση IP ή όνομα",
-                    "device_id": "Device ID",
+                    "device_id": "Device ID (ή device_id της gateway για συσκευές συνδεδεμένες μέσω gateway)",
                     "local_key": "Local key",
                     "protocol_version": "Έκδοση Πρωτοκόλλου (δοκιμάστε αυτόματο (auto) αν δεν το γνωρίζετε)",
                     "poll_only": "Ανίχνευση μόνο (δοκιμάστε αυτό αν η συσκευή δε λειτουργεί πλήρως)",
-                    "device_cid": "Sub device ID (για συσκευές συνδεμένες μέσω gateway)"
+                    "device_cid": "Sub device UUID (για συσκευές συνδεμένες μέσω gateway)"
                 }
             },
             "select_type": {
@@ -87,8 +87,7 @@
                     "host": "Διεύθυνση IP ή όνομα",
                     "local_key": "Local key",
                     "protocol_version": "Έκδοση Πρωτοκόλλου (δοκιμάστε αυτόματο (auto) αν δεν το γνωρίζετε)",
-                    "poll_only": "Ανίχνευση μόνο (δοκιμάστε αυτό αν η συσκευή δε λειτουργεί πλήρως)",
-                    "device_cid": "Sub device ID (για συσκευές συνδεμένες μέσω gateway)"
+                    "poll_only": "Ανίχνευση μόνο (δοκιμάστε αυτό αν η συσκευή δε λειτουργεί πλήρως)"
                 }
             }
         },

diff --git a/custom_components/tuya_local/translations/en.json b/custom_components/tuya_local/translations/en.json
@@ -37,11 +37,11 @@
                 "description": "[Follow these instructions to find your device id and local key.](https://github.com/make-all/tuya-local#finding-your-device-id-and-local-key)",
                 "data": {
                     "host": "IP address or hostname",
-                    "device_id": "Device ID",
+                    "device_id": "Device ID (or the hub's Device ID for devices connected via gateway)",
                     "local_key": "Local key",
                     "protocol_version": "Protocol version (try auto if not known)",
                     "poll_only": "Poll only (try this if your device does not work fully)",
-                    "device_cid": "Sub device ID (for devices connected via gateway)"
+                    "device_cid": "Sub device UUID (for devices connected via gateway)"
                 }
             },
             "select_type": {
@@ -87,8 +87,7 @@
                     "host": "IP address or hostname",
                     "local_key": "Local key",
                     "protocol_version": "Protocol version (try auto if not known)",
-                    "poll_only": "Poll only (try this if your device does not work fully)",
-                    "device_cid": "Sub device ID (for devices connected via gateway)"
+                    "poll_only": "Poll only (try this if your device does not work fully)"
                 }
             }
         },

diff --git a/custom_components/tuya_local/translations/es.json b/custom_components/tuya_local/translations/es.json
@@ -37,11 +37,11 @@
                 "description": "[Siga estas instrucciones para encontrar la identificación de su dispositivo y la clave local.](https://github.com/make-all/tuya-local#finding-your-device-id-and-local-key)",
                 "data": {
                     "host": "Dirección IP o nombre de host",
-                    "device_id": "Identificación del dispositivo (device_id)",
+                    "device_id": "Identificación del dispositivo (device_id, o device_id de la puerta de enlace para dispositivos conectados a través de una puerta de enlace)",
                     "local_key": "Clave local (Local key)",
                     "protocol_version": "Versión del protocolo (pruebe automático si no lo sabe)",
                     "poll_only": "Solo encuesta (pruebe esto si su dispositivo no funciona completamente)",
-                    "device_cid": "Sub device ID (para dispositivos conectados a través de una puerta de enlace)"
+                    "device_cid": "Sub device UUID (para dispositivos conectados a través de una puerta de enlace)"
                 }
             },
             "select_type": {
@@ -87,8 +87,7 @@
                     "host": "Dirección IP o nombre de host",
                     "local_key": "Clave local (Local key)",
                     "protocol_version": "Versión del protocolo (pruebe automático si no lo sabe)",
-                    "poll_only": "Solo encuesta (pruebe esto si su dispositivo no funciona completamente)",
-                    "device_cid": "Sub device ID (para dispositivos conectados a través de una puerta de enlace)"
+                    "poll_only": "Solo encuesta (pruebe esto si su dispositivo no funciona completamente)"
                 }
             }
         },

diff --git a/custom_components/tuya_local/translations/fr.json b/custom_components/tuya_local/translations/fr.json
@@ -37,11 +37,11 @@
                 "description": "[Suivre ces instructions pour trouver le 'device id' et la 'local key'.](https://github.com/make-all/tuya-local#finding-your-device-id-and-local-key)",
                 "data": {
                     "host": "Adresse IP ou Nom d'hote",
-                    "device_id": "Device ID",
+                    "device_id": "Device ID (ou device_id de la passerelle pour les appareils connectés via une passerelle)",
                     "local_key": "Local key",
                     "protocol_version": "Version du Protocole (Auto si inconnu)",
                     "poll_only": "Poll only (Essayez ceci si votre appareil ne fonctionne pas complètement)",
-                    "device_cid": "ID de sous-appareil (Pour les appareils connectés via une passerelle)"
+                    "device_cid": "UUID de sous-appareil (Pour les appareils connectés via une passerelle)"
                 }
             },
             "select_type": {
@@ -87,8 +87,7 @@
                     "host": "Adresse IP ou Nom d'hote",
                     "local_key": "Local key",
                     "protocol_version": "Version du Protocole (Auto si inconnu)",
-                    "poll_only": "Poll only (essayez ceci si votre appareil ne fonctionne pas complètement)",
-                    "device_cid": "ID de sous-appareil (pour les appareils connectés via une passerelle)"
+                    "poll_only": "Poll only (essayez ceci si votre appareil ne fonctionne pas complètement)"
                 }
             }
         },

diff --git a/custom_components/tuya_local/translations/hu.json b/custom_components/tuya_local/translations/hu.json
@@ -37,11 +37,12 @@
                 "description": "[Kövesd ezeket az utasításokat, hogy megtaláld az eszköz azonosítóját (device_id) és a helyi kulcsot (local_key).](https://github.com/make-all/tuya-local#finding-your-device-id-and-local-key)",
                 "data": {
                     "host": "IP cím vagy állomásnév",
-                    "device_id": "Eszköz azonosító (device_id)",
+                    "or device_id of gateway": "Vagy átjáró eszköz azonosítója (device_id átjárón keresztül használt eszközök esetén)",
+                    "device_id": "Eszköz azonosító (device_id, vagy átjáró device_id)",
                     "local_key": "Helyi kulcs (local_key)",
                     "protocol_version": "Protokol verzió (hagyd auto-n, ha nem tudod)",
                     "poll_only": "Csak olvasás (próbáld ki ezt, ha az eszköz nem működik rendesen)",
-                    "device_cid": "Aleszköz azonosító (átjárón keresztül használt eszközök esetén)"
+                    "device_cid": "Aleszköz UUID (átjárón keresztül használt eszközök esetén)"
                 }
             },
             "select_type": {
@@ -87,8 +88,7 @@
                     "host": "IP cím vagy állomásnév",
                     "local_key": "Helyi kulcs (local_key)",
                     "protocol_version": "Protokol verzió (hagyd auto-n, ha nem tudod)",
-                    "poll_only": "Csak olvasás (próbáld ki ezt, ha az eszköz nem működik rendesen)",
-                    "device_cid": "Aleszköz azonosító (átjárón keresztül használt eszközök esetén)"
+                    "poll_only": "Csak olvasás (próbáld ki ezt, ha az eszköz nem működik rendesen)"
                 }
             }
         },

diff --git a/custom_components/tuya_local/translations/id.json b/custom_components/tuya_local/translations/id.json
@@ -37,7 +37,7 @@
                 "description": "[Ikuti petunjuk ini untuk menemukan ID perangkat dan kunci lokal.](https://github.com/make-all/tuya-local#finding-your-device-id-and-local-key)",
                 "data": {
                     "host": "Alamat IP atau nama hos",
-                    "device_id": "ID Perangkat (device_id)",
+                    "device_id": "ID Perangkat (device_id, atau device_id dari gateway untuk perangkat yang tersambung via gateway)",
                     "local_key": "Kunci lokal (local_key)",
                     "protocol_version": "Versi protokol (coba otomatis bila tidak diketahui)",
                     "poll_only": "Hanya poll (Coba ini bila perangkat Anda tidak berfungsi secara penuh)",
@@ -87,8 +87,7 @@
                     "host": "Alamat IP atau nama hos",
                     "local_key": "Kunci lokal (local_key)",
                     "protocol_version": "Versi protokol (coba otomatis bila tidak diketahui)",
-                    "poll_only": "Hanya poll (Coba ini bila perangkat Anda tidak berfungsi secara penuh)",
-                    "device_cid": "ID sub perangkat (untuk perangkat yang tersambung via gateway)"
+                    "poll_only": "Hanya poll (Coba ini bila perangkat Anda tidak berfungsi secara penuh)"
                 }
             }
         },

diff --git a/custom_components/tuya_local/translations/it.json b/custom_components/tuya_local/translations/it.json
@@ -37,11 +37,12 @@
                 "description": "[Segui queste istruzioni per trovare 'device id' e 'local key'.](https://github.com/make-all/tuya-local#finding-your-device-id-and-local-key)",
                 "data": {
                     "host": "Indirizzo IP o nome host",
-                    "device_id": "Device ID",
+                    "or device_id of gateway": "oppure ID dispositivo del gateway",
+                    "device_id": "Device ID (oppure device_id del gateway per dispositivi connessi tramite gateway)",
                     "local_key": "Local key",
                     "protocol_version": "Versione protocollo (prova 'auto' in caso di dubbi)",
                     "poll_only": "Poll only (prova questa opzione se il dispositivo non funziona correttamente)",
-                    "device_cid": "Sub device ID (per dispositivi connessi tramite gateway)"
+                    "device_cid": "Sub device UUID (per dispositivi connessi tramite gateway)"
                 }
             },
             "select_type": {
@@ -87,8 +88,7 @@
                     "host": "Indirizzo IP o nome host",
                     "local_key": "Local key",
                     "protocol_version": "Versione protocollo (prova 'auto' in caso di dubbi)",
-                    "poll_only": "Poll only (prova questa opzione se il dispositivo non funziona correttamente)",
-                    "device_cid": "[it] Sub device ID (per dispositivi connessi tramite gateway)"
+                    "poll_only": "Poll only (prova questa opzione se il dispositivo non funziona correttamente)"
                 }
             }
         },

diff --git a/custom_components/tuya_local/translations/ja.json b/custom_components/tuya_local/translations/ja.json
@@ -37,11 +37,11 @@
                 "description": "[これらの手順に従ってデバイスIDとローカルキーを見つけてください。](https://github.com/make-all/tuya-local#finding-your-device-id-and-local-key)",
                 "data": {
                     "host": "IPアドレスまたはホスト名",
-                    "device_id": "デバイスID",
+                    "device_id": "デバイスID（デバイスがハブ経由で接続されている場合はハブのdevice_id）",
                     "local_key": "ローカルキー",
                     "protocol_version": "プロトコルのバージョン (不明な場合はAutoを試してください)",
                     "poll_only": "投票のみ (デバイスが動作しない場合)",
-                    "device_cid": "サブデバイスID (デバイスがハブ経由で接続されている場合)"
+                    "device_cid": "サブデバイスUUID (デバイスがハブ経由で接続されている場合)"
                 }
             },
             "select_type": {
@@ -87,8 +87,7 @@
                     "host": "IPアドレスまたはホスト名",
                     "local_key": "ローカルキー",
                     "protocol_version": "プロトコルのバージョン (不明な場合はAutoを試してください)",
-                    "poll_only": "投票のみ (デバイスが動作しない場合)",
-                    "device_cid": "サブデバイスID (デバイスがハブ経由で接続されている場合)"
+                    "poll_only": "投票のみ (デバイスが動作しない場合)"
                 }
             }
         },