Define parameters and unit conversions
Purpose
Section titled “Purpose”Parameters give incoming values meaningful names, types, units, validation rules, and optional writable behavior.
Before you start
Section titled “Before you start”Know the incoming data type and unit. Do not assume a device can accept a command merely because it reports a value.
- Open Parameters and add or edit a parameter.
- In Basics, choose its key, label, kind, data type, and unit.
- In Behavior, describe supported reporting or writable behavior.
- Use Validation for appropriate bounds and checks; use Advanced only for needed advanced settings.
- For a numeric read-only measurement or counter, configure incoming conversion when needed. Stored value = incoming value × multiplier + offset.
- Check a sample input/output, save, and validate.
Expected result
Section titled “Expected result”The saved definition explains how to interpret and validate values. Conversion changes stored numeric values; a unit label alone only names the unit.
Troubleshooting
Section titled “Troubleshooting”Incorrect readings can come from confusing incoming and stored units or applying a conversion twice. Verify an actual sample. Read-only parameters cannot be used as writable commands.