Canopy Temperature (CWSI) Node.

What it does.

An ESP32 + a non-contact MLX90614 infrared thermometer pointed at the canopy, reporting canopy temperature, air temperature, and the canopy-minus-air gap as oat-ods.

That’s the Collect layer for one more kind of sensor: it reads the instrument, shapes each reading into the one oat-ods message every Open Agriculture Technology device speaks, and pushes it to a place you own. The value is what you do with the reading later; this just gets it flowing.

What it reads.

Each reading goes out as its own oat-ods message, filed under the place you name, so swapping the hardware later never breaks the record:

What you need.

Wiring. The MLX90614 is I²C (3.3 V): SDA, SCL, 3V3, GND. Aim it at the canopy (not the soil or pot) and keep direct sun from glinting into the sensor.

What it sends.

It pushes to wherever you point it (Webhook (HTTP POST) or MQTT) as oat-ods/0.3. One measurement per message; here’s a reading from this node:

{
  "schema": "oat-ods/0.3",
  "observed_at": "2026-06-25T14:30:00Z",
  "stream": { "id": "gh2-canopy", "name": "…", "location": "…" },
  "measurement": "canopy_air_delta",
  "value": -2.4,
  "unit": "Cel",
  "source": { "tier": "oat-cwsi-node", "gateway_id": "…", "physical_id": "mlx90614" }
}

That’s the same envelope the whole library speaks. Point it at your webhook, an Home Assistant broker, or Open Agriculture Technology; the receiver can’t tell which node produced it. The developer reference has the full spec.

Get it & build it.

The project downloads whole: the sketch plus the shared oat_ods library it needs, so it builds as-is:

Full PlatformIO project (.zip) Just the sketch (.ino)

Two ways to put it on a board, both free:

1. PlatformIO (builds all four ESP32 chips): unzip, then cd oat-cwsi-node && pio run -t upload. The bundled lib/oat_ods/ resolves automatically.
2. Arduino IDE: open the .ino, install the libraries below from the Library Manager, pick your ESP32 board, and upload.

Compile-verified on our side (it builds clean with the pinned toolchain), but not yet run on the bench with real sensors, so it ships as source rather than a browser image. If you run it, tell the collective how it went; that’s what turns it into a flash-from-browser sketch.

Set it up.

Setup happens on the device’s own page: nothing to install, works with no internet:

1. Power the node from any USB charger or your computer.
2. Join its Wi-Fi network OAT-CWSI-XXXX, and the setup page opens (or visit http://192.168.4.1).
3. Sign in, set your Wi-Fi, where the readings go, and the sensor details above, then save.
4. Point delivery at the test endpoint and watch your first reading arrive, checked against the standard.

Settings persist across reboots; a fresh flash wipes them, on purpose, so a re-used board never carries the last owner’s Wi-Fi or endpoint.

Notes.

• A cool canopy (negative delta) = transpiring, well-watered; a warm canopy (positive delta) = stomata closing, water stress.
• CWSI itself is derived downstream where vapor-pressure deficit (from air temp + RH) is known; this node provides the canopy ingredient.

For makers & trainers.