
Soil Sensor
Soil moisture sensor for plants and gardens
Two-prong soil moisture probe with its own on-board co-processor. It measures the soil between the prongs and reports a calibrated moisture level over I2C, with a status LED that shows the reading at a glance. Ideal for automated watering and plant health monitoring.
For ages 14 and up. Not a toy. Contains small parts: choking hazard. Keep away from children under 3. Adult supervision recommended.
Made by Atech ApS, Lille Strandstræde 6A, st. th., 1254 København K, Denmark.
Technical specifications
- Part
- Soil Moisture Sensor (two-prong galvanic probe)
- Interface
- I2C (0x37)
- Ports
- 1 port
- Current
- ~25 mA
- Chip
- CH32V003
Pins
- 3.3V
- supply
- GND
- ground
- Data A
- I²C SDA
- Data B
- I²C SCL
Key features
- Calibrated 0-100% moisture readings
- Conductance and raw readings too
- Status LED colours itself from the reading
- Low power draw
- Single-width module
Common applications
Technical
Soil Sensor
Soil Moisture Sensor (two-prong galvanic probe)A two-prong soil probe on a 70 mm blade. An on-board CH32V003 co-processor measures the resistance between the prongs and reports it over I2C at 0x37, with a status LED that colours itself from the reading. The driver reports calibrated moisture 0-100 %, plus conductance, resistance and the raw value, from a background poll task, so reads are instant. I2C SDA on Line A, SCL on Line B.
read_moistureRead calibrated soil moisture, 0-100 %float %read_conductanceRead conductance between the prongs in microsiemensfloat uSread_rawRead the raw oversampled reading (HIGH means DRY)int countscalibrate_dryRecord the current reading as the 0 % point; call with the probe in aircalibrate_wetRecord the current reading as the 100 % point; call with the prongs in waterset_status_colorDrive the on-module status LEDset_status_offTurn the on-module status LED off
SOIL MOISTURE SENSOR (two-prong probe, I2C co-processor at 0x37): - THIS IS AN I2C MODULE, NOT AN ANALOG ONE. analogRead() on its port samples the idle SDA line and never tracks the soil (soil_sensor.md). - THE RAW READING IS INVERTED: readRaw() is HIGH when the soil is DRY. readMoisture() is already the right way round (0 % dry, 100 % wet), so prefer it. - Getters return the latest cached value from a background poll task and never block. Guard the first reads with hasReading() rather than showing a spurious 0 %. - Moisture is only meaningful after calibration. Call setCalibration(dryRaw, wetRaw) in setup() with values the user recorded (it is ignored unless dryRaw > wetRaw), or expose calibrateDry() / calibrateWet() so they can record them. - isDry() means the probe reads OPEN: in air, or the prongs are not touching soil. It does not mean "the plant needs water". isSaturated() means standing water or a short. - The module already smooths on board; setSmoothing() and setSlewThreshold() are the knobs. Do not add a second filter on the host. - For a probe that lives in soil for months, setSamplePeriod(1000) or slower: the probe is only energised while measuring. - The status LED already shows moisture (a dry-to-wet colour ramp anchored to the calibration, dim white for an open probe). Only call setStatusColor() for something different; it keeps the LED until setStatusAuto().
A large moisture percentage readout with a vertical fill gauge beside it, coloured dry-to-wet, and a 24-hour sparkline beneath. Show a 'probe open' pill whenever the probe is out of contact, so a bench reading is never mistaken for parched soil. Add Calibrate dry / Calibrate wet buttons, since the percentage means nothing until both are recorded.
| Pin | Line | Dir | Function |
|---|---|---|---|
| 1 | HV | – | not connected |
| 2 | 5V | – | not connected |
| 3 | 3.3V | input | supply |
| 4 | GND | – | ground |
| 5 | Data A | bidirectional | I²C SDA |
| 6 | Data B | input | I²C SCL |
from p2p/ground_truth/hardware/prototyping_line/modules/soil_sensor.md
CH32V003no single datasheet published