ponics-protocol/SENSORS.md

Sensors & Field Mapping

Основные поля (live data)

Эти поля публикуются в {UID}/data-timescale/{FIELD} и доступны через /api/box/{id}/live/.

API поле	MQTT имена (синонимы)	Единица	Описание
ph	ph, wpH, pH	0–14	pH раствора (откалиброванный)
ec	ec, wEC, EC	мСм/см	EC раствора (откалиброванный)
tankTemp	temp_cal, wNTC, waterTemp	°C	Температура воды (NTC, откалиброванная)
rootTemp	rootTemp, RootTemp	°C	Температура субстрата (DS18B20)
airTemp	airTemp, AirTemp	°C	Температура воздуха (BME280)
airHumidity	airHumidity, AirHum	%	Влажность воздуха (BME280)
waterLevel	calc_dist, Dist, wLevel	% или см	Уровень воды (HC-SR04)
light	calc_pr, PR	%	Освещённость (фоторезистор)

Системные поля

MQTT поле	Единица	Описание
RSSI	dBm	Уровень WiFi сигнала
uptime	мс	Аптайм устройства
CPUTemp	°C	Температура процессора ESP32
freeHeap	байт	Свободная RAM
MixerWeight	г	Вес в миксере (HX711)
readGPIO	0–65535	Битовая маска GPIO MCP23017

Сырые / отладочные поля

MQTT поле	Описание
NTC	Сырое значение АЦП NTC
pHmV	pH в милливольтах
pHraw	Сырое значение АЦП pH
ec_no_termo	EC без температурной компенсации
AirPress	Атмосферное давление (гПа)
Vcc	Напряжение питания (мВ)
hall	Датчик Холла ESP32
CO2	CO2 (ppm)
tVOC	Летучие вещества
PumpA_SUM, PumpB_SUM	Суммарный объём помп

Калибровка

pH

Точки: (px1, py1), (px2, py2), (px3, py3)
ADC → pH = кусочно-линейная интерполяция
Корректировка: pH_final = pH + pHlKorr

EC

Точки калибровки: ec1 (1.41 мСм/см), ec2 (12.88 мСм/см)
Соответствующие ADC значения: ex1, ex2
Температурная компенсация: EC_25 = EC_T / (1 + kt * (T - 25))
Корректировка: ecKorr (множитель, default = 1.0)

Температура воды (NTC)

Тип: NTC3950 (ntcType)
B-коэффициент: ntcB = 3950
R1 = 10000 Ом
Корректировка: ntcValKorr (offset °C, default = 0.0)

Уровень воды (HC-SR04)

maxLLevel → maxLRaw (100% → ADC значение)
minLLevel → minLRaw (0% → ADC значение)
Линейная интерполяция