diff --git a/ops/work/PC-BYOD.md b/ops/work/PC-BYOD.md new file mode 100644 index 0000000..34cc875 --- /dev/null +++ b/ops/work/PC-BYOD.md @@ -0,0 +1,77 @@ +# ПК как средство подключения (BYOD) — 12.11.2026 + +## Как это принято в практике AV + +ПК/ноутбук в переговорной — это **источник (source)**, а не аксессуар комнаты. +Он отдаёт видео в систему и получает от неё USB-периферию (камера, микрофон, +звук). Два режима: + +| Режим | Что происходит | Как моделировать | +|---|---|---| +| **BYOD (проводной)** | ПК подключается HDMI или USB-C, получает камеру/микрофон по USB | роль `pc` | +| **MTR-W** | ПК сам запускает Teams Rooms на Windows и является кодеком комнаты | роль `codec` | + +Практика подтверждается вендорами: Ashton Bentley X-Range — USB-C AV-комплекты +для BYOD ([inavate](https://www.inavateonthenet.net/products/article/ashton-bentley-launches-xrange-usbc-av-kits-to-streamline-byod-collaboration)), +Yealink — «有线 BYOD» через VCH51 Pro +([support.yealink.com.cn](https://support.yealink.com.cn/docs/smartvision-40/%E6%9C%89%E7%BA%BF-byod-%E9%80%9A%E8%BF%87yealink-vch51-pro/ab97451850c4424dbfc27fd83dc5347d)), +Lightware — HDMI-ingest и USB-периферия +([руководство LARA](https://assets.prod.pim.lightware.com/assets/File-Downloads/Guides-and-Manuals/User-Manual/LARA_UserManual.pdf)). + +## Что добавлено + +### Роль `pc` в движке + +```python +"pc": {"in": ["USB", "USB-C"], "out": ["HDMI", "USB-C"]} +ROLE_PORT_PREF["pc"] = ["HDMI", "USB-C", "USB"] +``` + +Смысл: ПК **отдаёт** HDMI/USB-C и **принимает** USB (периферия). +Группа в конструкторе: **«ПК и источники (BYOD)»**. + +### Устройства + +| Устройство | Роль | Что значит | +|---|---|---| +| **ПК (BYOD)** | `pc` | ноутбук/ПК, подключённый к комнате | +| **ПК с Teams Rooms (MTR-W)** | `codec` | ПК как терминал комнаты | + +Псевдонимы: `PC`, `ПК`, `Ноутбук`, `Laptop`, `BYOD`, `MTR-W`. + +### Исправлено по ходу + +1. **Кодек получил HDMI-вход** (`in: [LAN, HDMI]`) — так в комнату приходит + картинка с ПК. Без этого ПК некуда было подключить. +2. **Дисплей подключается к выходу хоста.** Раньше телевизор цеплялся + к HDMI-*входу* кодека (конфликт с ПК). Приоритет исправлен. +3. **Терминалом может быть кодек без связей в графе** — иначе + «ПК с Teams Rooms» не появлялся в списке (у него нет связей Yealink). + +## Проверка + +``` +Комната: MeetingBar A30 + ПК (BYOD) + UVC86 + Телевизор + A30 HDMI (вход) → ПК (BYOD) HDMI ← ПК отдаёт картинку + A30 out:USB → UVC86 USB ← камера как USB-периферия + A30 out:HDMI → Телевизор HDMI ← вывод на экран + кабелей: 3 · нерешённых: 0 + +ПК как терминал + камера: + ПК (BYOD) USB → UVC86 USB (режим USB-камеры для BYOD) + +Терминалов в списке: 60 (37 кодеков + 23 камеры) +Группа «ПК и источники (BYOD)» есть у любого хоста +``` + +## Замечание про микрофон + +`ПК + CM20` даёт «нет порта» — и это правильно: проводной микрофон Yealink +подключается к кодекам по VCH, а не к ПК. Для BYOD микрофон отдаёт сам кодек +через USB. + +## Ловушка + +У кодека теперь HDMI и на вход, и на выход. В кабельном журнале это видно +по префиксу: `HDMI` — вход, `out:HDMI` — выход. При ручной правке схемы +учитывайте этот префикс. diff --git a/ops/work/web/combine_core.py b/ops/work/web/combine_core.py index c521ed2..778efc3 100644 --- a/ops/work/web/combine_core.py +++ b/ops/work/web/combine_core.py @@ -38,7 +38,9 @@ class Core: "speaker": {"in": ["VCH"], "out": []}, "touch": {"in": ["LAN"], "out": ["USB"]}, "sharing_or_hub": {"in": ["USB"], "out": ["HDMI"]}, - "codec": {"in": ["LAN"], "out": ["HDMI", "USB", "VCH"]}, + # ПК/BYOD — источник: отдаёт видео в комнату, принимает USB-периферию + "pc": {"in": ["USB", "USB-C"], "out": ["HDMI", "USB-C"]}, + "codec": {"in": ["LAN", "HDMI"], "out": ["HDMI", "USB", "VCH"]}, "mount": {"in": [], "out": []}, "infrastructure": {"in": ["LAN"], "out": ["LAN"]}, } @@ -50,6 +52,7 @@ class Core: "speaker": ["VCH"], "touch": ["USB", "LAN", "USB-C"], "sharing_or_hub": ["USB", "USB-C", "HDMI", "VCH"], + "pc": ["HDMI", "USB-C", "USB"], } PORT_RANK = {"USB": 0, "USB-C": 1, "VCH": 2, "RJ-9": 3, "3.5mm": 4, @@ -85,6 +88,7 @@ class Core: {"id": "camera", "name": "Камеры", "roles": ["camera"]}, {"id": "panel", "name": "Панели управления", "roles": ["touch", "remote"]}, {"id": "sharing", "name": "Презентация и хабы", "roles": ["sharing_or_hub"]}, + {"id": "pc", "name": "ПК и источники (BYOD)", "roles": ["pc"], "static_role": "pc"}, {"id": "phone", "name": "Аудиоустройства и телефоны", "roles": ["audio"], "only": r"^CP50|^CP965|^CPE|^CP\d|^PA\d"}, {"id": "display", "name": "Дисплеи", "roles": ["display"]}, @@ -712,9 +716,14 @@ class Core: def rank(item): r, ap, hp = item + base = 0 + # дисплей принимает видео — подключаем к ВЫХОДУ хоста, + # иначе он цепляется к HDMI-входу кодека (BYOD). + if role == "display" and not str(hp).startswith("out:"): + base = 500 if ap in pref: - return pref.index(ap) - return 90 + r + return base + pref.index(ap) + return base + 90 + r cands.sort(key=rank) _, port, slot = cands[0] if slot and slot.startswith("out:"): diff --git a/ops/work/web/services/svc_catalog.py b/ops/work/web/services/svc_catalog.py index 47b4e2b..8ebb503 100644 --- a/ops/work/web/services/svc_catalog.py +++ b/ops/work/web/services/svc_catalog.py @@ -51,8 +51,8 @@ def hosts(q, body): # устройство комнаты (10.11.2026 просьба владельца). if role not in ("codec", "camera"): continue - if role == "codec" and not C.edges.get(k): - continue + # связей может не быть (ПК с Teams Rooms) — терминал всё равно нужен + out.append({"key": k, "name": v["name"], "kind": role, "accessories": len(C.edges_of(k)), "completeness": C.completeness(k)}) diff --git a/ops/work/web/services/svc_engine.py b/ops/work/web/services/svc_engine.py index e51f69b..ee5428d 100644 --- a/ops/work/web/services/svc_engine.py +++ b/ops/work/web/services/svc_engine.py @@ -58,6 +58,13 @@ def groups(q, body): if m not in have: items.append({"model": m, "role": "mount", "max_qty": 1, "condition": "лист Mounts & Bracket"}) + # ПК и другие источники обычно не описаны в графе Yealink — + # показываем их из каталога по роли (иначе группа пустая). + if not items and g.get("static_role"): + for k2, v2 in C.devices.items(): + if v2.get("role") == g["static_role"]: + items.append({"model": v2["name"], "role": v2.get("role"), + "max_qty": 2, "condition": "источник BYOD"}) if items: out.append({"id": g["id"], "name": g["name"], "hint": "", "items": sorted(items, key=lambda x: x["model"])})