[2026-05-27] docs: 8BitDo dual dongles — must be on separate USB ports (Huasheng HUB conflict)

family/how-to/htpc-system.md

@@ -8,6 +8,23 @@
 - TV: LG webOS (192.168.1.75)
 - HTPC IP: 192.168.1.86
 
+## Контроллеры
+
+### 8BitDo Ultimate (2 шт.) — донглы
+
+**Важно:** оба донгла 8BitDo Ultimate (`2dc8:3106`) должны быть воткнуты в **разные физические порты USB**, не подключённые через общий USB-хаб (Huasheng USB2.0 HUB на порту 006). Если оба висят на одном хабе — второй не enum'ится корректно (`#Ifs=0 Cfg#=0`, не создаёт /dev/input/js).
+
+**Правильное расположение (рабочая конфигурация):**
+- **Port 005** (прямой порт xHCI, не через хаб) → 8BitDo #1 (`E417D8D87F0C`)
+- **Port 006 → Port 001** (через Huasheng HUB) → 8BitDo #2 (`E417D8C197E4`)
+- **Port 006 → Port 004** → Xbox 360 Wireless Receiver
+
+**Симптомы неправильного расположения:**
+- lsusb показывает оба донгла, но второй с `#Ifs=0 Cfg#=0`
+- `/dev/input/js` только один (или один из донглов не создаёт input)
+- Steam видит только один контроллер
+- Перестановка донгла на другой порт решает проблему
+
 ## ОС
 - **Bazzite 44** (Fedora-based, immutable OSTree)
 - Вариант: `bazzite-deck` (Steam Gaming Mode / gamescope)