Troubleshooting

🐛 Решение проблем

Поезд не появляется в интерфейсе

• Убедитесь, что Bluetooth включён на компьютере
• Хаб должен быть в режиме BLE: кнопка питания мигает зелёным
• Linux: выполните sudo setcap cap_net_raw+eip $(eval readlink -f \which node`)`
• Windows: перезапустите службу Bluetooth в Диспетчере устройств

Поезд не реагирует на команды

• Уменьшите шаг рампа до 5% и увеличьте интервал до 150–200 мс в настройках
• Проверьте заряд батарей (отображается на карточке, ⚠ при ≤15%)
• Убедитесь, что поезд находится в зоне приёма BLE (~10 м без препятствий)
• Попробуйте кнопку Переподключить на карточке поезда

Ошибка Cannot find module './lib/...'

Структура файлов должна быть:

LegoTrainPanel/
├── server.js
└── lib/
    ├── ramp.js
    ├── logger.js
    └── scheduler.js

Браузер не подключается

• Сервер запущен? В консоли должна быть строка 🚂 http://localhost:3000
• Брандмауэр? Разрешите входящие соединения на порт 3000
• С другого устройства используйте IP компьютера, а не localhost

Ошибка Bluetooth на macOS

Error: Could not get BLE adapter

Решение: Системные настройки → Конфиденциальность и безопасность → Bluetooth → добавьте Terminal / Node.js

npm install падает с ошибкой нативных модулей (Windows)

npm install --global windows-build-tools
# или
npm install --global --production windows-build-tools

Если не помогает — установите Visual Studio Build Tools с компонентом «Desktop development with C++».

PyBricks хаб не обнаруживается

• Убедитесь, что программа запущена на хабе (зелёный светодиод)
• Проверьте, что в консоли есть строка PyBricks detected:
• Убедитесь, что установлен пакет @stoprocent/noble (входит в node-poweredup)

Включение подробных логов BLE

Запустите с отладочным флагом:

// server.js — строка создания RampEngine
const ramp = new RampEngine(trains, io, log, true); // true = debug mode

Все BLE-команды будут выводиться в консоль с префиксом [DBG].