花盆缺水提醒：先校准土壤探头，再决定报警阈值

python3 calibrate.py dry.csv drained-wet.csv
# 将你自己的输出常量写入soil_config.h，再按README完整FQBN重编/上传

// ---- SoilAlert.h ----
// SPDX-License-Identifier: MIT
#pragma once
#include <stdint.h>
class SoilAlert {
 public:
  enum State { UNCALIBRATED, SUSPECT_RAIL, OK, DRY };
  SoilAlert(uint16_t dry, uint16_t wet):dry_(dry),wet_(wet) {}
  State update(uint16_t raw) {
    if (!calibrated()) { reset(); return state_=UNCALIBRATED; }
    if (raw<=8 || raw>=4087) { reset(); return state_=SUSPECT_RAIL; }
    index_ = raw>=dry_ ? 0 : raw<=wet_ ? 100 : uint16_t((uint32_t(dry_-raw)*100)/(dry_-wet_));
    clamped_=raw>dry_ || raw<wet_;
    if (state_!=OK && state_!=DRY) state_=index_<=30 ? DRY : OK;
    const bool change = state_==OK ? index_<=30 : index_>=40;
    if (!change) { qualifying_=0; return state_; }
    if (++qualifying_>=3) { state_=state_==OK?DRY:OK; qualifying_=0; }
    return state_;
  }
  bool calibrated() const { return dry_<=4086 && wet_>=9 && dry_>wet_ && dry_-wet_>=100; }
  uint16_t index() const { return index_; }
  bool clamped() const { return clamped_; }
 private:
  void reset() {qualifying_=0;index_=0;clamped_=false;}
  uint16_t dry_,wet_,index_=0;uint8_t qualifying_=0;bool clamped_=false;State state_=UNCALIBRATED;
};

// ---- soil_config.h ----
// SPDX-License-Identifier: MIT
#pragma once
#include <stdint.h>
// Replace with YOUR measured 16-sample means in the same soil, depth, supply,
// ADC resolution and attenuation. Zero defaults intentionally disable alert.
constexpr uint16_t CAL_DRY=0;
constexpr uint16_t CAL_WET=0;

// ---- esp32-plant-moisture-alert.ino ----
// SPDX-License-Identifier: MIT
// SEN0193 @3V3; S->GPIO6/ADC1_CH5, GND->GND; GPIO4 external LED.
#include <Arduino.h>
#include "SoilAlert.h"
#include "soil_config.h"
constexpr uint8_t SOIL_PIN=6, LED_PIN=4;
SoilAlert alert(CAL_DRY,CAL_WET);
void setup() {
  pinMode(LED_PIN,OUTPUT);digitalWrite(LED_PIN,LOW);
  Serial.begin(115200);
  analogReadResolution(12);analogSetPinAttenuation(SOIL_PIN,ADC_11db);
  Serial.println("S04 SEN0193; raw=12bit; means of16; index is relative, not water-content percent");
  Serial.println("ms,raw_mean,index,clamped,state,led_latch");
}
void loop() {
  static uint32_t sampledAt=0,sum=0;
  static uint8_t count=0;
  uint32_t now=millis();
  if(uint32_t(now-sampledAt)>=20) {
    sampledAt=now;sum+=analogRead(SOIL_PIN);++count;
    if(count==16) {
      uint16_t mean=uint16_t((sum+8)/16);sum=0;count=0;
      auto state=alert.update(mean);
      bool led=state==SoilAlert::DRY;digitalWrite(LED_PIN,led?HIGH:LOW);
      Serial.printf("%lu,%u,%u,%d,%s,%d\n",(unsigned long)now,mean,alert.index(),alert.clamped(),
        state==SoilAlert::UNCALIBRATED?"UNCALIBRATED":state==SoilAlert::SUSPECT_RAIL?"SUSPECT_RAIL":state==SoilAlert::DRY?"DRY":"OK",led);
    }
  }
  delay(1);
}

clang++ -std=c++17 -Wall -Wextra -Werror tests/soil_test.cpp -o /tmp/s04-soil-test
/tmp/s04-soil-test
python3 calibrate_test.py