Умный дом зигби и не только - архитектура моей IoT-системы на распбери пи

🔌 Как добавить новое Zigbee-устройство в домашнюю IoT-систему

Когда вы подключаете новое Zigbee-устройство (розетку, реле, датчик и т.д.) через Zigbee2MQTT, важно убедиться, что оно не только сопряглось, но и корректно передаёт данные в вашу систему. Ниже — проверенный рабочий алгоритм от сопряжения до отображения на панели.

1. Сопряжение устройства

• Зайдите в веб-интерфейс Zigbee2MQTT (обычно http://ваш_сервер:8080).
• Нажмите «Add new device» и следуйте инструкциям для вашего устройства (часто — удержание кнопки при подаче питания).
• После сопряжения устройству присвоится MAC-адрес вида 0xa4c1385d1ba39457.

2. Задайте понятное имя

Задается внутри интерфейса Zigbee2MQTT после сопряжения. но если не получилось то вручную.

Откройте файл конфигурации Zigbee2MQTT — обычно /opt/zigbee2mqtt/data/configuration.yaml — и добавьте:

devices:
  '0xa4c1385d1ba39457':
    friendly_name: fish_light

Перезапустите службу для надежности: sudo systemctl restart zigbee2mqtt.

3. Проверьте MQTT-трафик в реальном времени

Выполните в терминале:

mosquitto_sub -h localhost -t "zigbee2mqtt/#" -v

Теперь включите/выключите устройство. Вы должны увидеть сообщения вида:

zigbee2mqtt/fish_light {"state_l1":"OFF","state_l2":"OFF","state_l3":"OFF","linkquality":210}

Если JSON содержит нужные поля (state, temperature, state_l1 и т.д.) — устройство работает.

4. Убедитесь, что данные сохраняются в базу

Ваш логгер (например, mqtt-to-mysql.py) должен «разворачивать» JSON и сохранять каждое поле отдельно:

zigbee2mqtt/fish_light/state_l1 → OFF
zigbee2mqtt/fish_light/state_l2 → OFF

Проверьте в MySQL:

SELECT topic, value FROM sensor_data
WHERE topic LIKE '%fish_light%'
ORDER BY timestamp DESC LIMIT 5;

Если записей нет — обновите логгер, чтобы он сохранял все ключи, кроме служебных (linkquality, last_seen и т.д.).

5. Добавьте устройство на панель вручную, если нет устройства (виртуально)

Выполните в базе данных:

INSERT INTO sensor_info (topic, name, room, group_name, icon) VALUES
('zigbee2mqtt/fish_light/state_l1', 'Кормушка 1', 'Аквариум', 'Реле', '🔌'),
('zigbee2mqtt/fish_light/state_l2', 'Кормушка 2', 'Аквариум', 'Реле', '🔌'),
('zigbee2mqtt/fish_light/state_l3', 'Кормушка 3', 'Аквариум', 'Реле', '🔌');

6. Настройте управление

Убедитесь, что ваша панель распознаёт state_l1 как управляемый переключатель. В PHP-коде должно быть:

$type = basename($row['topic']);
if ($type === 'status' || preg_match('/^state_l\d+$/', $type)) {
    $type = 'valve';
}

А в JS-функции отправки команды — корректная обработка каналов:

// Пример для топика zigbee2mqtt/fish_light/state_l1
const match = decodedTopic.match(/^(zigbee2mqtt\/[^\/]+)\/state_(l\d+)$/);
if (match) {
    payload[match[2]] = command; // → {"l1": "ON"}
}

💡 Советы

• Если устройство не публикует state_l1, а только status — используйте общий режим управления через {"state": "ON"}.
• Не забудьте обновить автоматизации: старые правила с MAC-адресом перестанут работать после смены имени.
• Регулярно очищайте таблицу sensor_data — иначе сайт начнёт тормозить. Достаточно оставлять данные за последние 3–7 дней.

После этих шагов ваше устройство будет полноценно интегрировано в систему: вы сможете управлять им с панели, строить графики и создавать автоматизации.