Files
buryan-infra/ops/work/CHAINS.md
T

76 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Цепочки подключения в Комбайне (12.11.2026)
## Зачем
Аксессуар подключается **не обязательно к терминалу напрямую**. В проекте
владельца: RoomCast E2 + UVC86 + VCM36-W ×3 — матрица прямо говорит
`UVC86 → VCM36-W, до 4, «used as an expansion microphone»`.
Раньше движок привязывал всё к хосту: такие устройства либо получали
фиктивный кабель, либо объявлялись несовместимыми.
## Как работает
`port_plan` теперь делает **два прохода**:
1. **Прямые связи**: устройство → порт хоста (с проверкой матрицы).
2. **Цепочки**: если напрямую нельзя, ищем в составе устройство, которое
это умеет (`edges[промежуточное][устройство].supported`), с учётом
`max_qty` и (по возможности) совпадения портов.
Результат попадает в:
* `rows` — у строки появляется `via` (через кого) и понятная причина;
* `chains` — список цепочек `{via, device, qty, max_qty, condition}`;
* `cable_schedule` — добавляет кабель `промежуточное → устройство`;
* `signal_chains` — цепочка **не** считается блокером;
* `issues` — блокеров больше нет, остаются только предупреждения о данных.
## Проверка на проекте владельца
```
RoomCast E2 + UVC86 + VCM36-W×3 + WPP30 + MSpeaker Pro + RCH40 E2 + ПК + Проектор
```
Кабельный журнал:
```
Roomcast E2 out:USB → UVC86 USB (в комплекте)
UVC86 → USB → VCM36-W ×3 USB (через UVC86, до 4)
Roomcast E2 out:USB → WPP30 USB-C
UVC86 → VCH → MSpeaker Pro VCH (через UVC86, до 4)
Roomcast E2 LAN → RCH40 E2 LAN
Roomcast E2 HDMI → ПК (BYOD) HDMI
Roomcast E2 out:HDMI → Проектор HDMI
кабелей: 7 · нерешённых: 0
```
Проверка состава:
```
blockers: 0 · ready: True
предупреждения: нет данных о питании, неполные данные (только матрица)
```
## Что это меняет для владельца
Раньше Комбайн отвечал «VCM36-W не поддерживается» и рисовал фиктивную связь
или оставлял устройство без порта. Теперь он собирает **правильную схему**:
микрофоны и спикер идут через UVC86, а не через RoomCast E2.
## Что осталось
1. **Питание**: у большинства устройств нет данных о потреблении
(`missing_power`), поэтому проверка бюджета PoE не считается.
2. **`chains_needed` в `capacity`** по-прежнему `None` — поле не заполняется,
хотя цепочки уже есть в `port_plan`.
3. **Порты RoomCast E2** берутся по роли (`source: role`), а не из даташита —
отсюда «VCH», которого у устройства может не быть. Нужна выверка
в `interfaces_verified.yaml`.
## Ловушка
`edges_of(host)` по умолчанию отдаёт только поддерживаемые связи
(`supported_only=True`). Для проверки запретов нужен
`edges_of(hk, supported_only=False)` — иначе матрица «молчит».