wirenboard

Serial bus (RS-485/Modbus) on WB — custom templates, adding devices via confed, and diagnostics: CRC errors, timeouts, device not responding, slow polling, bus scan, health check.

Writing software FOR Wiren Board controllers — custom daemons (C++/Python/Go), MQTT bridges (Zigbee2MQTT → WB, Modbus → WB, custom hardware), MQTT-RPC services, wbdev cross-compilation, Debian packaging, /devices/X/controls/Y topic conventions. Use when user wants to write a daemon, integration bridge, or hardware adapter. NOT for wb-rules JS automation.

Root-cause investigation of Wiren Board field problems and regressions — reproduce, ground every claim in git/upstream, A/B versions, refute hypotheses experimentally, close the causal chain, and file a proof-backed bug report. Use when a support ticket / colleague says something broke (often 'after updating to release X'), when asked to reproduce a bug, find the root cause, prove why it happens, investigate a regression, or turn a vague complaint into a defensible bug report. Complements wb-troubleshooting (symptom→fix) with rigorous prove-it methodology.

Zigbee devices on WB via zigbee2mqtt — bridge/state liveness probe, native vs Docker install detection, wb-mqtt-zigbee vs wb-zigbee2mqtt converter recognition, IEEE-address (0x...) and zigbee_<id> topic patterns, pairing, control, OTA.

Reconfigure WB controller MOD slots via wb-hwconf-helper — switch a slot away from its default (usually RS-485) into raw UART (/dev/ttyMODx), bit-banged I2C (/dev/i2c-modN), CAN, SPI, or 1-Wire by loading the matching device-tree overlay module. Use when user wants to repurpose a MOD slot, expose UART/I2C on MOD pins for chip programming or a non-Modbus device, mentions wb-hwconf-helper, /etc/wb-hardware.conf, wbe2x-generic-uart, wbe2x-generic-i2c, or sees /dev/ttyMOD3 give `stty: Input/output error`.

Backup and restore of a Wiren Board controller — collect a tar.gz with configs, /etc, data, package lists, network settings. Use when user wants to save controller state, prepare for firmware flash or controller replacement, transfer settings, restore after factory reset, roll back. NOT for diagnostic archive (that's wb-troubleshooting).

Mosquitto MQTT broker administration on Wiren Board — listeners, users, ACLs, password files, TLS, bridges to external brokers. /etc/mosquitto/conf.d/. Use when user mentions MQTT broker config, mosquitto, MQTT auth/password, MQTT TLS, external MQTT bridge, broker not running, MQTT client can't connect from outside.

Network configuration on a Wiren Board controller — NetworkManager, wb-connection-manager, Ethernet/WiFi/4G/OpenVPN, static IP, failover priorities, DNS, hotspot. Use when user mentions networking, can't reach controller, no internet, ping fails, IP address, WiFi setup, 4G modem, VPN.

Функциональный каталог Modbus-устройств Wiren Board с быстрым выбором нужной модели и переходом в подробные страницы по каждому устройству. Используй, когда нужно: (1) определить назначение конкретного устройства WB, (2) найти устройство по типу (реле, счетчики, датчики, диммеры, шлюзы и т.д.), (3) открыть локальное подробное описание.

Разворачивать, подключать и диагностировать существующие шаблоны `wb-mqtt-serial` на контроллере Wiren Board: рендерить `.json.jinja` в `.json`, деплоить в `/etc/wb-mqtt-serial.conf.d/templates`, добавлять устройство в `/etc/wb-mqtt-serial.conf`, проверять логи и MQTT retained-топики, сверять каналы/регистры с документацией, а также разбирать несовместимость шаблона с устройством по `hw.signature`, минимальной версии прошивки и конфликтам системного/пользовательского шаблона. Использовать, когда нужно проверить работу шаблона на живом стенде, подобрать совместимый шаблон или разобрать ошибки опроса/публикации. Содержит справочник Modbus-регистров устройств Wiren Board.

Работать локально на контроллере Wiren Board с Modbus RTU/TCP и RS-485: диагностика systemd/journalctl/MQTT, чтение/запись регистров, скан шины, поиск конфликтов slave ID, смена адресов и безопасные сценарии прошивки/восстановления через modbus_client/modbus_client_rpc, wb-modbus-scanner, wb-mcu-fw-updater, wb-mcu-fw-flasher. Использовать для задач: "остановить/запустить wb-mqtt-serial", "прочитать/записать Modbus регистр", "скан RS-485", "дубликаты Modbus ID", "прошить/восстановить устройство".

Разрабатывать, объяснять и отлаживать серверные скрипты автоматизации wb-rules на JavaScript на контроллерах Wiren Board: `defineRule` (whenChanged/when/asSoonAs/cron), virtual devices, timers, modules, PersistentStorage, диагностика через `journalctl -u wb-rules`, `/etc/wb-rules`, `/var/run/wb-rules`, и интеграция с внешними сервисами через MQTT/hooks (`/hooks/wake`) и `POST /tools/invoke` (Telegram).

Проектировать, реализовывать и отлаживать кастомные веб-интерфейсы для Wiren Board через MQTT over WebSocket (`/mqtt` через nginx): читать/писать топики `/devices/.../controls/...`, строить UI по MQTT metadata, публиковать страницы в локальной сети, добавлять базовый hardening (ACL/auth/безопасный рендер), и диагностировать проблемы UI↔MQTT↔device. Использовать, когда нужно сделать отдельную страницу мониторинга/управления устройствами WB или доработать существующий веб-интерфейс.

Создавать JSON-описание MQTT-шаблона wb-mqtt-serial по документации Modbus-регистров (datasheet/register map/manual): извлекать все регистры, нормализовать адреса и типы, классифицировать channels/parameters, задавать enum/conditions/translations и возвращать структуру device_info+registers для small/medium/full шаблонов. Использовать, когда нужно сгенерировать или проверить шаблон устройства Wiren Board по карте Modbus-регистров.

Orchestrate a multi-aspect code review by spawning one specialized subagent per review dimension — security, stability, conventions/structure conformance, project-rules conformance (the repo's documented rules, if any), documentation conformance, regressions, test coverage of new code, simplification (over-complex/verbose code and heavyweight deps used trivially), plan-compliance (against the change's plan, if one exists), and an architect that proposes structural improvements as options with pros/cons — then act as a coordinator that deduplicates, re-categorizes, filters noise, surfaces valid architecture options to the user, and assembles one structured review with severity ratings and a merge verdict. Use whenever the user asks to review a diff, PR, MR, branch, or changes; mentions "code review", "review my changes", "review this PR/branch", "is this safe to merge", "did I break anything", "can this be simplified", "is this over-engineered", or wants a thorough multi-angle review. Use it even when the user

Draft a docs/<topic>_plan.md for a wb-mqtt-dali feature, refactor, or non-trivial change. Captures the public design — scenarios, RPC contracts, decision points, scope boundaries — and stays out of the implementer's lane.