Sensores¶

En esta página se conectan dos sensores y se envían sus datos al portal. Primero el SHT31 (clima del armario), luego el termistor (temperatura del calefactor). Este es el paso de "obtención de datos" antes de añadir lógica de control.

El principio de trabajo con el núcleo es simple: su código en loop() escribe lecturas frescas en los campos s_link.telemetry.*, y la fachada publica automáticamente al cloud cada telemetryPeriodMs del Config. No es necesario llamar a la publicación manualmente.

Campos de telemetría¶

Para nuestro armario se utilizan tres campos (índice [0] — primera y única cámara):

Campo	Qué almacena	Bandera en Config
`s_link.telemetry.airTempC[0]`	temperatura del aire, °C	`hasAirTemp`
`s_link.telemetry.airHumidityPct[0]`	humedad del aire, %	`hasAirHumidity`
`s_link.telemetry.heaterTempC[0]`	temperatura del calefactor, °C	`hasHeaterTemp`

Todos estos tres indicadores ya se habilitaron en Config en el paso anterior.

Regla: el código del sensor no debe bloquear loop()¶

La fachada idryer-core atiende Wi-Fi y MQTT en el mismo loop(). Por lo tanto, al leer sensores no se puede llamar a delay() — la pausa corta la sesión de red. El sensor se consulta por temporizador y el valor listo simplemente se lee. Los controladores listos del ecosistema ya están organizados así.

Paso 1. SHT31: clima del armario¶

No es necesario escribir el controlador SHT31 desde cero — la clase lista Sht31ClimateSensor está disponible en el ejemplo iDryer-Storage. Utiliza la biblioteca robtillaart/SHT31 y lee el sensor sin bloqueo.

Agregue la biblioteca SHT31 a lib_deps de su platformio.ini:

lib_deps =
    file://path/to/idryer-core
    bblanchon/ArduinoJson @ ^6.21.0
    knolleary/PubSubClient
    robtillaart/SHT31 @ ^0.5.0

Copie en su carpeta src/ cuatro archivos de iDryer-Storage/src/storage/sensors/: Sht31ClimateSensor.h, Sht31ClimateSensor.cpp, IClimateSensor.h y sensor_reading.h.
Conecte el sensor por I2C (véase Esquema de conexión) y léalo en src/main.cpp:

#include <Wire.h>
#include <iDryer.h>
#include "Sht31ClimateSensor.h"

static Sht31ClimateSensor s_climate(&Wire);
static bool               s_climateOk = false;

void setup() {
    Serial.begin(115200);
    Wire.begin(8, 9);                 // SDA, SCL — pines de su placa
    s_climateOk = s_climate.begin();  // encuentra automáticamente la dirección 0x44 o 0x45
    s_link.begin();
}

void loop() {
    s_link.loop();

    if (s_climateOk) {
        s_climate.tick(millis());
        SensorReading r = s_climate.get();
        if (r.ok) {
            s_link.telemetry.airTempC[0]       = r.temperature;
            s_link.telemetry.airHumidityPct[0] = r.humidity;
        }
    }
}

La estructura SensorReading (campos ok, temperature, humidity) se declara en sensor_reading.h. Después de programar el firmware, en el portal aparecerán la temperatura y humedad del armario — esta es la primera retroalimentación del dispositivo.

Paso 2. Termistor: temperatura del calefactor¶

No tengo una clase lista de termistor para ESP32, así que leemos escribimos en src/main.cpp directamente. El termistor está conectado al pin de ADC a través de un convertidor de voltaje (véase Esquema de conexión): el controlador mide el voltaje en el punto intermedio, se calcula la resistencia del termistor y luego — la temperatura.

#include <math.h>

static const int   THERM_PIN  = 2;         // pin de ADC
static const float SERIES_R   = 4700.0f;   // resistencia del divisor, Ω
static const float NOMINAL_R  = 100000.0f; // resistencia del termistor a 25 °C, Ω
static const float NOMINAL_T  = 25.0f;     // °C
static const float BETA       = 3950.0f;   // coeficiente B del termistor en su hoja de datos

// Devuelve la temperatura del calefactor en °C.
static float readHeaterTempC() {
    int   raw = analogRead(THERM_PIN);          // 0..4095 en ESP32
    float v   = (float)raw / 4095.0f;           // fracción de la escala completa
    float r   = SERIES_R * (1.0f - v) / v;      // resistencia del termistor, Ω
    // Ecuación de Steinhart–Hart (parámetro B):
    float tK  = 1.0f / (1.0f / (NOMINAL_T + 273.15f) + logf(r / NOMINAL_R) / BETA);
    return tK - 273.15f;
}

En loop() escriba el resultado en telemetría junto con la lectura de SHT31:

s_link.telemetry.heaterTempC[0] = readHeaterTempC();

Esta es lectura simplificada — ajuste los parámetros a su termistor

Las constantes NOMINAL_R y BETA dependen del termistor específico — extráigalas de su hoja de datos (termistor doméstico común — Generic 3950, 100 kΩ). La fórmula del divisor corresponde al esquema en Esquema de conexión: termistor a 3.3V, resistencia a GND. Con otra disposición, la fórmula cambia. El ADC en ESP32 es no lineal, por lo que para mediciones precisas se calibran las lecturas — en los controladores de serie iDryer se utiliza una tabla de termistor para esto (biblioteca Thermistor).

Diagnóstico del termistor con multímetro — Verificación del termistor.

Archivo `src/main.cpp` completo después de este capítulo¶

A continuación — el archivo completo. Las nuevas líneas con respecto al capítulo anterior se marcan con // ← capítulo 5; el resto no cambió.

??? nota «Antes — src/main.cpp después del capítulo 4»

```cpp
#include <iDryer.h>

static const iDryer::Config CFG = {
    .deviceType        = iDryer::DeviceType::Dryer,
    .unitsCount        = 1,
    .hasHeater         = true,
    .hasFan            = true,
    .hasAirTemp        = true,
    .hasAirHumidity    = true,
    .hasHeaterTemp     = true,
    .telemetryPeriodMs = 5000,
    .statusPeriodMs    = 10000,
    .hardwareVersion   = "1.0",
    .firmwareVersion   = "0.1.0",
    .model             = "DIY Storage Cabinet",
};
static iDryer::Link s_link(CFG);

void setup() {
    Serial.begin(115200);
    s_link.begin();
}

void loop() {
    s_link.loop();
}
```

#include <iDryer.h>
#include <Wire.h>                  // ← capítulo 5
#include <math.h>                  // ← capítulo 5
#include "Sht31ClimateSensor.h"    // ← capítulo 5

static const iDryer::Config CFG = {
    .deviceType        = iDryer::DeviceType::Dryer,
    .unitsCount        = 1,
    .hasHeater         = true,
    .hasFan            = true,
    .hasAirTemp        = true,
    .hasAirHumidity    = true,
    .hasHeaterTemp     = true,
    .telemetryPeriodMs = 5000,
    .statusPeriodMs    = 10000,
    .hardwareVersion   = "1.0",
    .firmwareVersion   = "0.1.0",
    .model             = "DIY Storage Cabinet",
};
static iDryer::Link s_link(CFG);

// ← capítulo 5: sensor climático SHT31
static Sht31ClimateSensor s_climate(&Wire);
static bool               s_climateOk = false;

// ← capítulo 5: termistor del calefactor
static const int   THERM_PIN  = 2;
static const float SERIES_R   = 4700.0f;
static const float NOMINAL_R  = 100000.0f;
static const float NOMINAL_T  = 25.0f;
static const float BETA       = 3950.0f;

static float readHeaterTempC() {
    int   raw = analogRead(THERM_PIN);
    float v   = (float)raw / 4095.0f;
    float r   = SERIES_R * (1.0f - v) / v;
    float tK  = 1.0f / (1.0f / (NOMINAL_T + 273.15f) + logf(r / NOMINAL_R) / BETA);
    return tK - 273.15f;
}

void setup() {
    Serial.begin(115200);
    Wire.begin(8, 9);                 // ← capítulo 5  (SDA, SCL — pines de su placa)
    s_climateOk = s_climate.begin();  // ← capítulo 5
    s_link.begin();
}

void loop() {
    s_link.loop();

    if (s_climateOk) {                                       // ← capítulo 5
        s_climate.tick(millis());
        SensorReading r = s_climate.get();
        if (r.ok) {
            s_link.telemetry.airTempC[0]       = r.temperature;
            s_link.telemetry.airHumidityPct[0] = r.humidity;
        }
    }
    s_link.telemetry.heaterTempC[0] = readHeaterTempC();     // ← capítulo 5
}

Verificación del resultado¶

Después de este paso, el portal debe mostrar tres valores:

temperatura del aire en el armario;
humedad en el armario;
temperatura del calefactor.

Si las lecturas "se desplazan" o son claramente incorrectas:

compruebe la masa común y la disposición (ruido de cables de potencia) — Errores de cableado;
compruebe la clasificación de la resistencia del divisor y el tipo de termistor;
asegúrese de que el SHT31 responda por I2C (dirección correcta y líneas).

Diagnóstico "el sensor muestra tonterías" — Verificación del termistor y Errores típicos.

Qué sigue¶

Hay datos del sensor. Ahora describiremos la configuración del dispositivo (temperatura objetivo, histéresis) en Menú de YAML para que se puedan cambiar desde el portal y almacenar en memoria.