Главная / Вики / Датчики
🌡️ Раздел 4

Датчики и драйверы

Какие датчики поддерживаются.

🧩

Распиновка датчиков — в соседнем разделе.

Реестр драйверов

Драйверы лежат в общей папке и используются обеими прошивками.

firmware/shared/sensor_modules/
├── include/
│   ├── sensor_module.h      базовый интерфейс драйвера
│   ├── sensor_registry.h    реестр: сканирование, опрос, восстановление
│   ├── uart_frame.h         сборка и разбор кадров
│   ├── bme680_module.h
│   ├── bh1750_module.h
│   ├── bmp280_module.h
│   ├── ina219_module.h
│   └── scd30_module.h
└── src/
    ├── sensor_registry.cpp
    ├── bme680_module.cpp
    ├── bh1750_module.cpp
    ├── bmp280_module.cpp
    ├── ina219_module.cpp
    └── scd30_module.cpp

Каждый драйвер сам регистрирует себя одной макросом в конце файла.

Типы и коды датчиков

type_id Датчик Адреса I²C Питание Интервал опроса Метрики
1 BME680 0x76, 0x77 3,3 В 5000 мс
temperature · C
humidity · %
pressure · hPa
gas_resistance · Ohm
2 BH1750 0x23, 0x5C 3,3 В 5000 мс
illuminance · lux
3 SCD30 0x61 3,3–5 В 2000 мс
scd30_co2 · ppm
scd30_temperature · C
scd30_humidity · %
4 INA219 0x40 3,3–5 В 5000 мс
ina219_voltage · V
ina219_current · mA
ina219_power · mW
5 BMP280 0x76, 0x77 3,3 В 5000 мс
bmp280_temperature · C
bmp280_pressure · hPa

Все датчики рассчитаны на 3,3 В.

🔢

Код типа — это часть протокола.

Определение по chip ID

Для датчиков с общим диапазоном адресов проверяется регистр идентификатора.

Датчик Регистр Ожидаемое значение Смысл
BME680 0xD0 0x60 Чип точно BME680
BMP280 0xD0 0x58 Чип точно BMP280
BH1750 только отклик по адресу — Диапазон адресов не пересекается
INA219 только отклик по адресу — Единственный адрес — 0x40
SCD30 только отклик по адресу — Фиксированный адрес 0x61

Без такой проверки два чипа на одном адресе определяются как один.

Метрики и единицы

Каждый драйвер возвращает описание метрик и значения в том же порядке.

  • Ключ метрики — короткая строка латиницей.
  • Единица измерения приходит от драйвера.
  • Порядок метрик обязан быть стабильным.
  • Одинаковые ключи у разных датчиков получают префикс.
🚫

Значения NAN и INF в публикацию не попадают.

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

Что произошло Поведение системы
Часть метрик не прочиталась На их место подставляется NAN
Датчик перестал отвечать Запись переводится в офлайн
Датчик ответил снова Создаётся новый клон драйвера
Появился датчик того же типа на новом адресе Создаётся второй независимый экземпляр
Драйвер вернул неверное число метрик Данные выравниваются по описанию

Датчики за TCA9548A

Идентичность датчика включает адрес мультиплексора и канал.

Расположение Идентификатор Пример
Прямо на шине имя_0xадрес BME680_0x76
Канал 0 мультиплексора 0x70 имя_0xадрес_c0 BME680_0x76_c0
Канал 3 мультиплексора 0x71 имя_0xадрес_c3 INA219_0x40_c3

Как добавить свой датчик

Процедура одинакова для любого I²C-датчика.

Заведите два файла в общей папке

Класс наследуется от SensorModule.

Выберите свободный type_id

Возьмите 6.

Опишите адреса и определение

Метод detect() должен подтвердить чип.

Реализуйте init(), read() и metrics()

Порядок значений должен совпадать с metrics().

Отдайте clone() и интервал

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

Зарегистрируйте драйвер макросом

Одна строка в конце файла.

Подключите библиотеку и пересоберите

Добавьте библиотеку в lib_deps и пересоберите.

Минимальный драйвер

#include "sensor_module.h"

class MySensorModule : public SensorModule {
public:
    uint8_t typeId() const override { return 6; }
    const char* moduleName() const override { return "MySensor"; }

    std::vector<uint8_t> i2cAddresses() const override { return {0x48}; }

    bool detect(uint8_t address) override {
        uint8_t chipId = 0;
        if (!readSensorRegister(address, 0x0F, chipId)) return false;
        return chipId == 0x2C;
    }

    bool init(uint8_t address) override {
        _address = address;
        return writeRegister(address, 0x00, 0xA0);
    }

    std::vector<Metric> read() override {
        std::vector<Metric> out;
        float raw = readValue(_address);
        out.push_back({"my_value", raw, "unit"});
        return out;
    }

    std::vector<MetricDef> metrics() const override {
        return {{"my_value", "My Value", "unit"}};
    }

    uint32_t readInterval() const override { return 5000; }

    SensorModule* clone() const override { return new MySensorModule(); }
};

REGISTER_SENSOR(MySensorModule)
✅

После пересборки датчик появится сам.