Архитектура системы
Из каких блоков собрана система.
Обзор системы
MQTT, сигнальный сервер и прямой локальный API.
Потоки данных
Внутри периферии: датчик в контроллер
-
Сканирование шины
При старте и по команде пересканирования реестр перебирает адреса I²C.
-
Определение типа
На каждый адрес вызывается detect() каждого драйвера.
-
Клонирование и инициализация
Реестр создаёт свежий экземпляр драйвера через clone().
-
Опрос по расписанию
Каждый драйвер сообщает свой интервал опроса.
От контроллера наружу
-
MQTT
Каждая метрика уходит отдельным сообщением в свой топик.
-
REST и WebSocket
Локально — REST и WebSocket с push-обновлениями.
-
История на SD
Каждое значение дописывается в дневной CSV-файл.
-
Регистрация на сервере
Контроллер повторяет регистрацию раз в 30 секунд.
Реестр модулей
Реестр владеет прототипами драйверов, активными записями и списком мультиплексоров.
Прототип
Образец для клонирования.
Активная запись
Пара «драйвер + адрес + мультиплексор + канал».
Мультиплексоры
Список адресов TCA9548A из конфигурации.
Блокировка шины
Все обращения к шине проходят под семафором.
Счётчик compositionRevision растёт при каждом изменении состава датчиков.
Жизненный цикл модуля
| Состояние | Как обнаруживается | Что видит пользователь |
|---|---|---|
| Отсутствует | Нет ответа на адресе при сканировании | Датчика нет в списке |
| Онлайн | Успешный ответ на шине | Обычные значения |
| Офлайн | Проверка живости не получила ответа | Запись остаётся, значения — «нет данных» |
| Восстановление | Создаётся новый клон драйвера | Метрики снова обновляются |
Офлайн-записи не удаляются намеренно.
Отказоустойчивость
Не удалось прочитать датчик
Ошибка не роняет остальные метрики датчика.
Шина I²C зависла
Неподтверждённая передача завершается по таймауту.
Пропал UART
Контроллер продолжает работать.
Пропал MQTT-брокер
Публикации повторяются, история пишется.
Пропал сигнальный сервер
Данные продолжают идти по MQTT.
Зависла прошивка
Сторожевой таймер перезагружает через 20 секунд.
Масштабирование
Масштабирование идёт по трём независимым осям.
| Ось | Как расширяется | Предел |
|---|---|---|
| Больше датчиков на одной плате | Дополнительные адреса, затем мультиплексор | 8 каналов на мультиплексор |
| Больше модулей на контроллере | Второй сенсорный модуль | Один модуль на пару UART-пинов |
| Больше контроллеров | Новый идентификатор устройства | Ограничено брокером и реестром |
Практический предел — длина кабелей и питание.
Модель данных
Значение метрики проходит через систему с тремя уровнями описания.
Тип датчика
Одно число плюс имя.
Экземпляр датчика
Строка вида BME680_0x76.
Метрика
Ключ, единица измерения и значение.
Ключи метрик могут совпадать у разных датчиков.