Главная / Вики / Архитектура
🏗️ Раздел 2

Архитектура системы

Из каких блоков собрана система.

Обзор системы

Периферия
🌡️
Сенсорный модуль
ESP32-C6 · I²C · без Wi-Fi
🔌
Драйверы датчиков
общий реестр, по клону на каждый датчик
→
Агрегация
🧠
Главный контроллер
ESP32-C3 / ESP32-C6 / ESP32-S3
приём кадров · карта метрик · MQTT · веб-API · SD
💾
История на SD
CSV по дням, до 60 файлов
→
Внешний контур
📶
MQTT-брокер
Mosquitto · iot/
🖥️
Сигнальный сервер
реестр устройств, аварии, правила
📱
Приложение и панель
дашборд · графики · аварии · управление

MQTT, сигнальный сервер и прямой локальный API.

Потоки данных

Внутри периферии: датчик в контроллер

  1. Сканирование шины

    При старте и по команде пересканирования реестр перебирает адреса I²C.

  2. Определение типа

    На каждый адрес вызывается detect() каждого драйвера.

  3. Клонирование и инициализация

    Реестр создаёт свежий экземпляр драйвера через clone().

  4. Опрос по расписанию

    Каждый драйвер сообщает свой интервал опроса.

От контроллера наружу

  1. MQTT

    Каждая метрика уходит отдельным сообщением в свой топик.

  2. REST и WebSocket

    Локально — REST и WebSocket с push-обновлениями.

  3. История на SD

    Каждое значение дописывается в дневной CSV-файл.

  4. Регистрация на сервере

    Контроллер повторяет регистрацию раз в 30 секунд.

Реестр модулей

Реестр владеет прототипами драйверов, активными записями и списком мультиплексоров.

🧩

Прототип

Образец для клонирования.

📋

Активная запись

Пара «драйвер + адрес + мультиплексор + канал».

🔀

Мультиплексоры

Список адресов TCA9548A из конфигурации.

🔒

Блокировка шины

Все обращения к шине проходят под семафором.

🔢

Счётчик compositionRevision растёт при каждом изменении состава датчиков.

Жизненный цикл модуля

Состояние Как обнаруживается Что видит пользователь
Отсутствует Нет ответа на адресе при сканировании Датчика нет в списке
Онлайн Успешный ответ на шине Обычные значения
Офлайн Проверка живости не получила ответа Запись остаётся, значения — «нет данных»
Восстановление Создаётся новый клон драйвера Метрики снова обновляются

Офлайн-записи не удаляются намеренно.

Отказоустойчивость

Не удалось прочитать датчик

Ошибка не роняет остальные метрики датчика.

Шина I²C зависла

Неподтверждённая передача завершается по таймауту.

Пропал UART

Контроллер продолжает работать.

Пропал MQTT-брокер

Публикации повторяются, история пишется.

Пропал сигнальный сервер

Данные продолжают идти по MQTT.

Зависла прошивка

Сторожевой таймер перезагружает через 20 секунд.

Масштабирование

Масштабирование идёт по трём независимым осям.

Ось Как расширяется Предел
Больше датчиков на одной плате Дополнительные адреса, затем мультиплексор 8 каналов на мультиплексор
Больше модулей на контроллере Второй сенсорный модуль Один модуль на пару UART-пинов
Больше контроллеров Новый идентификатор устройства Ограничено брокером и реестром
📏

Практический предел — длина кабелей и питание.

Модель данных

Значение метрики проходит через систему с тремя уровнями описания.

1

Тип датчика

Одно число плюс имя.

2

Экземпляр датчика

Строка вида BME680_0x76.

3

Метрика

Ключ, единица измерения и значение.

🔑

Ключи метрик могут совпадать у разных датчиков.