Skip to main content
Every reading names its metric with an integer metric_id. The catalogue is shared across all devices, so a soil moisture reading from any device is id 220 in percent. The API stores the value as sent and does not convert units, so the device converts to the catalogue unit before posting.

Catalogue

Battery has two ids on purpose. Post 200 when the device reports a percentage and 2 when it reports volts. Never scale one into the other with a guessed curve.
Ids 221 to 223 (nitrogen, phosphorus and potassium) exist in the catalogue but aren’t a supported reading. Don’t build on them.

Adding a Metric

Need a metric that isn’t listed? Ask for it through support. Don’t reuse an existing id for a different measurement: the models read the id, not the device, and a mislabelled reading reaches them.