sam-4screen-desktop 2026-7-2:21:28:53

300 areas/310 Home Assistant/Tuya Local Integration Notes.md

@@ -1,6 +1,6 @@
 ---
 created: 2026-05-26
-modified: 2026-05-26
+modified: 2026-07-02
 type: note
 tags: []
 aliases: []
@@ -10,18 +10,61 @@ aliases: []
 ## Tuya IoT Portal
 
 - URL: https://iot.tuya.com/
-- Navigate to: **Cloud → API Explorer**
 - Select the correct **Data Center** (Central Europe for EU users)
-- Use **Device Management → Query Device Details** to get device info
+- Access ID: `pwwd8y3v7kj8j9c3nnj5`
+
+## Renavigating After a Device is Re-Paired / Reset
+
+When a Tuya device is reset and re-paired to WiFi, it gets a **new Device ID** and **new Local Key**. The old credentials are invalid. Steps to recover:
+
+### 1. Check IoT Core Subscription
+
+If API calls return `code: 28841002` / `"IoT Core service subscription has expired."`:
+
+- Go to **iot.tuya.com** → **Cloud** → **IoT Core** (under Cloud section)
+- You'll likely see an option to **extend the service trial period**
+- There's a form asking for: project background, estimated lead time, relevant info
+- Sample blurb: *"Personal home automation project using Home Assistant to control smart lighting. Need temporary API access to retrieve local device keys for re-paired bulbs."*
+- Estimated lead time: 1–3 days
+- Approval is usually quick (sometimes instant, sometimes minutes)
+
+### 2. Get the New Device ID (Virtual ID) from the Phone App
+
+The new Device ID is **not visible in the IoT portal's device management**. You need to get it from the app:
+
+- Open the **Tuya Smart / Smart Life / Genio** app on your phone
+- Go to the device details/settings page for the device
+- Look for **Device Information** → **Device ID** (or **Virtual ID**) — this is the ID to use in the API
+- Copy this ID — it looks like: `bfd8b357cc21529eb8zpbo`
+
+### 3. Query Device Details via API Explorer
+
+- Go to **Cloud → API Explorer** (not IoT Core → API Explorer)
+- Method: `Query Device Details` under Device Management
+- Enter the new Device ID from the app
+- Execute
+- In the response, note the `"local_key"` field
+
+### 4. Add to Home Assistant (Tuya Local)
+
+- In HA: **Settings → Devices & Services → Tuya Local → Add Device**
+- Choose **Manually provide device connection information**
+- Enter:
+  - **IP Address** — from router's connected device list
+  - **Device ID** — from app
+  - **Local Key** — from API Explorer response
+  - **Protocol** — Try 3.3 or 3.4 first, or try 3.1 if those fail
+- Select device type (e.g., Simple RGBCW lightbulb for RGB+CCT bulbs)
+- Submit
 
 ## Fields Required for Home Assistant (Tuya Local)
 
 | Field | Source |
 |-------|--------|
-| **Device ID** | Tuya portal → Devices list or API Explorer |
+| **Device ID (Virtual ID)** | Phone app → Device Info page |
-| **Local Key** | API Explorer → Query Device Details |
+| **Local Key** | IoT Portal → Cloud → API Explorer → Query Device Details |
 | **IP Address** | Router's connected device list |
-| **Protocol Version** | Usually auto-detected; try 3.5, 3.4, or 3.1 |
+| **Protocol Version** | Usually auto-detected; try 3.3, 3.4, or 3.1 |
 
 ## Steps to Add a Device
 
@@ -37,3 +80,4 @@ aliases: []
 - Genio bulbs may need the Genio app for initial WiFi setup
 - Some newer bulbs use Protocol 3.5 (auto-detected by Tuya Local)
 - If port 6668 is closed on the device, it may be cloud-only
+- The Local Key **rotates** every time a device is re-paired — always get a fresh one via API Explorer