← 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.