感應器¶

本頁你連接兩個感應器並將它們的資料輸出到門戶。首先是SHT31（櫃氣候），然後是溫敏電阻（加熱器溫度）。這是「獲取資料」步驟，在新增控制邏輯之前。

與核心協作的原理很簡單：你的loop()程式碼中的程式碼將新鮮讀數寫入s_link.telemetry.*欄位，外觀自動每telemetryPeriodMs時間發佈到雲端（來自Config）。無需手動呼叫發佈。

遙測欄位¶

對於我們的櫃子，使用三個欄位（索引[0]——第一個和唯一的攝像機）：

欄位	儲存內容	Config中的標誌
`s_link.telemetry.airTempC[0]`	空氣溫度，°C	`hasAirTemp`
`s_link.telemetry.airHumidityPct[0]`	空氣濕度，%	`hasAirHumidity`
`s_link.telemetry.heaterTempC[0]`	加熱器溫度，°C	`hasHeaterTemp`

所有三個標誌我們已在上一步的Config中啟用。

規則：感應器程式碼不應阻止loop()¶

idryer-core外觀在相同的loop()中為Wi-Fi和MQTT服務。因此，讀取感應器時不能呼叫delay()——暫停會中斷網路會話。感應器按計時器輪詢，現成的值只被讀取。生態系統中現成的驅動程式已經這樣構造了。

步驟1。SHT31：櫃氣候¶

SHT31驅動程式無需從頭寫起——現成的Sht31ClimateSensor類在iDryer-Storage範例中。它使用robtillaart/SHT31函式庫並無阻塞地讀取感應器。

將SHT31函式庫新增到你platformio.ini的lib_deps：

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

從iDryer-Storage/src/storage/sensors/複製四個檔案到你的src/資料夾：Sht31ClimateSensor.h、Sht31ClimateSensor.cpp、IClimateSensor.h和sensor_reading.h。
透過I2C連接感應器（見接線圖）並在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 — 你的板的引腳
    s_climateOk = s_climate.begin();  // 自動尋找位址0x44或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;
        }
    }
}

SensorReading結構（欄位ok、temperature、humidity）在sensor_reading.h中聲明。刷新後，門戶將顯示櫃的溫度和濕度——這是設備的第一個反饋。

步驟2。溫敏電阻：加熱器溫度¶

我沒有現成的ESP32溫敏電阻類，所以我們直接在src/main.cpp中編寫。溫敏電阻透過分壓轉換器連接到ADC引腳（見接線圖）：控制器測量中點的電壓，據此計算溫敏電阻的電阻，然後是溫度。

#include <math.h>

static const int   THERM_PIN  = 2;         // ADC引腳
static const float SERIES_R   = 4700.0f;   // 分壓電阻，Ω
static const float NOMINAL_R  = 100000.0f; // 溫敏電阻在25 °C時的電阻，Ω
static const float NOMINAL_T  = 25.0f;     // °C
static const float BETA       = 3950.0f;   // 來自溫敏電阻技術規格的B係數

// 返回加熱器溫度（°C）。
static float readHeaterTempC() {
    int   raw = analogRead(THERM_PIN);          // ESP32上0..4095
    float v   = (float)raw / 4095.0f;           // 完整範圍的比例
    float r   = SERIES_R * (1.0f - v) / v;      // 溫敏電阻電阻，Ω
    // Steinhart-Hart方程（B參數）：
    float tK  = 1.0f / (1.0f / (NOMINAL_T + 273.15f) + logf(r / NOMINAL_R) / BETA);
    return tK - 273.15f;
}

在loop()中，將結果與SHT31讀數一起寫入遙測：

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

這是簡化的讀數——根據你的溫敏電阻調整參數

常數NOMINAL_R和BETA取決於具體的溫敏電阻——從其技術規格表中取得（常見的家用溫敏電阻——Generic 3950，100 kΩ）。分壓公式對應接線圖中的方案：溫敏電阻至3.3V，電阻至GND。對於不同的佈線，公式會改變。ESP32上的ADC是非線性的，因此對於精確測量，讀數是校準的——在iDryer系列控制器中，使用溫敏電阻表（Thermistor函式庫）進行此操作。

用萬用表檢查溫敏電阻——溫敏電阻檢查。

本章後的完整`src/main.cpp`¶

下面是整個檔案。相對於上一章的新行標記為// ← 第5章；其餘部分未改變。

什麼是——src/main.cpp在第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>                  // ← 第5章
#include <math.h>                  // ← 第5章
#include "Sht31ClimateSensor.h"    // ← 第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);

// ← 第5章：SHT31氣候感應器
static Sht31ClimateSensor s_climate(&Wire);
static bool               s_climateOk = false;

// ← 第5章：加熱器溫敏電阻
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);                 // ← 第5章（SDA, SCL — 你的板的引腳）
    s_climateOk = s_climate.begin();  // ← 第5章
    s_link.begin();
}

void loop() {
    s_link.loop();

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

驗證結果¶

此步驟後，門戶應顯示三個值：

櫃中空氣溫度；
櫃中濕度；
加熱器溫度。

如果讀數「漂浮」或明顯錯誤：

檢查公共接地和佈線（電源線干擾）——接線錯誤；
檢查分壓電阻的額定值和溫敏電阻類型；
確保SHT31透過I2C回應（正確的位址和線路）。

「感應器顯示垃圾」診斷——溫敏電阻檢查和常見錯誤。

下一步¶

我們有來自感應器的資料。現在在YAML菜單中描述設備設定（目標溫度、滯後），以便可以從門戶更改它們。