Capteurs

Sur cette page, vous connectez deux capteurs et envoyez leurs données au portail. D'abord le SHT31 (climat du placard), puis la thermistance (température du radiateur). C'est l'étape « récolter les données » avant d'ajouter la logique de contrôle.

Le principe de travail avec le cœur est simple : votre code dans loop() écrit les lectures frais dans les champs s_link.telemetry.*, et la façade publie automatiquement vers le cloud tous les telemetryPeriodMs définis dans Config. Aucun appel de publication manuel n'est nécessaire.

Champs de télémétrie

Pour notre placard, nous utilisons trois champs (l'index [0] est la première et unique chambre) :

Champ	Contient	Flag dans Config
s_link.telemetry.airTempC[0]	température de l'air, °C	hasAirTemp
s_link.telemetry.airHumidityPct[0]	humidité de l'air, %	hasAirHumidity
s_link.telemetry.heaterTempC[0]	température du radiateur, °C	hasHeaterTemp

Nous avons déjà activé ces trois flags dans la Config de l'étape précédente.

Règle : le code du capteur ne doit pas bloquer loop()

La façade idryer-core gère le Wi-Fi et MQTT dans le même loop(). Par conséquent, lors de la lecture des capteurs, vous ne pouvez pas appeler delay() — une pause interrompt la session réseau. Le capteur est interrogé par une minuterie et la valeur prête est simplement lue. Les pilotes fournis dans l'écosystème sont déjà organisés de cette façon.

Étape 1. SHT31 : climat du placard

Vous n'avez pas besoin d'écrire le pilote SHT31 à partir de zéro — la classe prête Sht31ClimateSensor existe dans l'exemple iDryer-Storage. Elle utilise la bibliothèque robtillaart/SHT31 et lit le capteur sans blocage.

1. Ajoutez la bibliothèque SHT31 à lib_deps dans votre platformio.ini :

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

2. Copiez quatre fichiers de iDryer-Storage/src/storage/sensors/ dans votre dossier src/ : Sht31ClimateSensor.h, Sht31ClimateSensor.cpp, IClimateSensor.h et sensor_reading.h.

3. Connectez le capteur via I2C (voir Schéma de connexion) et lisez-le dans 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 — broches de votre carte
    s_climateOk = s_climate.begin();  // trouve automatiquement l'adresse 0x44 ou 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 structure SensorReading (champs ok, temperature, humidity) est déclarée dans sensor_reading.h. Après flashage, la température et l'humidité du placard apparaîtront sur le portail — c'est la première rétroaction du périphérique.

Étape 2. Thermistance : température du radiateur

Je n'ai pas de classe thermistance prête pour ESP32, donc nous la lisons/écrivons directement dans src/main.cpp. La thermistance est connectée à une broche ADC via un convertisseur de tension (voir Schéma de connexion) : le contrôleur mesure la tension au point milieu, ce qui permet de calculer la résistance de la thermistance, puis la température.

#include <math.h>

static const int   THERM_PIN  = 2;         // broche ADC
static const float SERIES_R   = 4700.0f;   // résistance du diviseur, Ω
static const float NOMINAL_R  = 100000.0f; // résistance de la thermistance à 25 °C, Ω
static const float NOMINAL_T  = 25.0f;     // °C
static const float BETA       = 3950.0f;   // coefficient B de la fiche technique de la thermistance

// Retourne la température du radiateur en °C.
static float readHeaterTempC() {
    int   raw = analogRead(THERM_PIN);          // 0..4095 sur ESP32
    float v   = (float)raw / 4095.0f;           // fraction de l'échelle complète
    float r   = SERIES_R * (1.0f - v) / v;      // résistance de la thermistance, Ω
    // Équation Steinhart–Hart (paramètre B) :
    float tK  = 1.0f / (1.0f / (NOMINAL_T + 273.15f) + logf(r / NOMINAL_R) / BETA);
    return tK - 273.15f;
}

Dans loop(), écrivez le résultat dans la télémétrie près de la lecture du SHT31 :

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

C'est une lecture simplifiée — adaptez les paramètres à votre thermistance

Les constantes NOMINAL_R et BETA dépendent de la thermistance spécifique — prenez-les dans sa fiche technique (thermistance générique courante — Generic 3950, 100 kΩ). La formule du diviseur correspond au schéma de Schéma de connexion : thermistance à 3.3V, résistance à GND. Avec une autre disposition, la formule change. L'ADC sur ESP32 est non linéaire, donc pour des mesures précises les lectures sont étalonnées — dans les contrôleurs iDryer en série, une table thermistance est utilisée pour cela (bibliothèque Thermistor).

Test thermistance au multimètre — Vérification de la thermistance.

Fichier src/main.cpp complet après ce chapitre

Ci-dessous — tout le fichier au complet. Les nouvelles lignes par rapport au chapitre précédent sont marquées // ← chapitre 5; le reste n'a pas changé.

Ce qui était — src/main.cpp après le chapitre 4

#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>                  // ← chapitre 5
#include <math.h>                  // ← chapitre 5
#include "Sht31ClimateSensor.h"    // ← chapitre 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);

// ← chapitre 5 : capteur climatique SHT31
static Sht31ClimateSensor s_climate(&Wire);
static bool               s_climateOk = false;

// ← chapitre 5 : thermistance du radiateur
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);                 // ← chapitre 5  (SDA, SCL — broches de votre carte)
    s_climateOk = s_climate.begin();  // ← chapitre 5
    s_link.begin();
}

void loop() {
    s_link.loop();

    if (s_climateOk) {                                       // ← chapitre 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();     // ← chapitre 5
}

Vérification des résultats

Après cette étape, trois valeurs doivent s'afficher sur le portail :

• température de l'air dans le placard ;
• humidité du placard ;
• température du radiateur.

Si les lectures « flottent » ou sont clairement incorrectes :

• vérifiez la masse commune et le câblage (interférences des fils de puissance) — Erreurs de câblage ;
• vérifiez la valeur de la résistance du diviseur et le type de thermistance ;
• assurez-vous que le SHT31 répond sur I2C (adresse correcte et lignes).

Diagnostic « le capteur affiche des bêtises » — Vérification de la thermistance et Erreurs courantes.

Prochaine étape

Les données des capteurs sont disponibles. Maintenant, décrivons les paramètres du périphérique (température cible, hystérésis) dans Menu de YAML afin qu'ils puissent être modifiés à partir du portail et stockés en mémoire.