[2026-09-14] eagle: family/how-to/t610-access.md

family/how-to/t610-access.md

@@ -394,6 +394,33 @@ jq -r '.["0x…"]' /config/zigbee2mqtt/state.json
 
 **Порядок критичен:** сначала реестры, **потом** (после старта HA) правка `friendly_name` в z2m и `entity_id` в HA. Переименование до переноса реестров пропадёт — HA перезапишет реестр.
 
+### 🔍 Где искать человеческие имена устройств (важный урок 2026-09-14)
+
+**В реестрах HA имён устройств НЕТ.** Проверено на TrueNAS: `core.entity_registry` содержит `original_name` = имя **параметра** («Температура», «Влага», «Занятость»), а не устройства; `name`/`name_by_user` — `null`. Все 16 датчиков t° называются «Температура» → **по `original_name` устройство не определить.**
+
+**Три места, где реально лежат имена:**
+1. **z2m** → `/config/zigbee2mqtt/configuration.yaml` → секция `devices:` → `friendly_name`. ✅ На TrueNAS там были человеческие имена (`Насос обратки`, `Kitchen hood`, `Sauna`, `Dimmer bed`...).
+2. **HA `core.device_registry`** → `data.devices[].name`, связь через `identifiers: [["mqtt","zigbee2mqtt_0x…"]]`:
+```bash
+jq -r '.data.devices[] | select((.identifiers|tostring)|test("zigbee2mqtt_0x")) | [.id, (.name//"—"), (.area_id//"—"), (.model//"—")] | @tsv' \
+  /mnt/RED_2TB/docker/ha/.storage/core.device_registry
+```
+3. **Дашборд `lovelace.home_plan`** → `entity` в `picture-elements` — **самый надёжный** источник рабочей схемы имён (`switch.sauna`, `light.smart_light_office_left`, `binary_sensor.shower_2_presence_sensor_presence`...).
+
+**Питфолл поиска по автоматизациям:** триггеры часто ссылаются на **`device_id`**, а не `entity_id`:
+```yaml
+triggers:
+  - type: battery_level
+    device_id: 52266a1b4a9d301f0da0dfa6f97c4ea2    # ← имени нет
+```
+Поэтому `grep` по `entity_id` даёт пусто. Искать надо по `device_id` → `core.device_registry` → `identifiers` → IEEE.
+
+**⚠️ Питфолл при переносе z2m:** если залить `configuration.yaml` **без секции `devices:`**, z2m при старте сам создаст её и пропишет `friendly_name` = IEEE для каждого устройства → hex-имена. Это и случилось на t610 2026-09-14 (человеческие имена с TrueNAS были потеряны). **Проверять секцию `devices:` сразу после переноса.**
+
+**Зоны TrueNAS (`core.area_registry`):** Гостиная `living_room`, Кухня `kitchen`, Спальня `bedroom`, Детская `detskaia`, Кабинет `kabinet`, Ванная `vannaia`, Душевая `dushevaia`, Туалет `tualet`, Северная `severnaia`, Котельная `kotelnaia`, Лестница `lestnitsa`.
+
+> 📌 Полезно: имя устройства в z2m ≠ `entity_id` в HA. `entity_id` формируется при **первом появлении** сущности в HA и **не меняется** при смене `friendly_name`. Чтобы переименовать — нужно менять `entity_id` в `core.entity_registry` (или удалить сущность и дать создать заново).
+
 **Полезные команды разведки конфига (из SSH-аддона на t610):**
 ```bash
 ls -la /config/                                          # состав HA-конфига