← Back to the chapter · Next detail →

Technical detail · Cloud Data: IoT Reference Model

A versioned soil-moisture record

Worked example: normalizing soil moisture
three vendors report the same physical measure differently:

vendor A:
field: moisture_percent
value: 48.0
meaning: already percent

vendor B:
field: moisture_fraction
value: 0.48
conversion: 0.48 * 100 = 48.0 percent

vendor C:
field: adc_reading
value: 1966
range: 0 to 4095
calibration: 0 counts = 0% moisture; 4095 counts = 100% moisture
conversion: 1966 / 4095 * 100 = 48.01 percent

canonical Level 5 record:
device_id: soil-17
event_time_utc: 2026-07-03T07:00:00Z
moisture_pct: 48.0
source_vendor: vendor-c
source_field: adc_reading
source_value: 1966
schema_version: soil-moisture-v3
quality_state: valid
lineage_ref: raw/topic/soil-17/offset/884201

design reading:
The dashboard should not need vendor-specific code. It should read moisture_pct,
quality_state, and lineage_ref from the Level 5 product and show a consistent
result across all vendors.

← Back to the chapter · Next detail →