Sensor Sampling
How the Device Manages Sensor Sampling with SampleGroups
{{company_name}}'s {{device_name}} uses a feature called SampleGroup to efficiently manage how sensors are sampled. Instead of configuring each channel individually, you can assign multiple sensors (channels) to a group that shares the same sampling behavior. This simplifies configuration, conserves power, and ensures synchronized data collection.
What is a SampleGroup?
A SampleGroup is a configuration mechanism that allows multiple sensor channels to be sampled at the same time interval using a shared set of parameters. Each {{device_name}} supports multiple SampleGroups that can be used to organize sensor behavior based on type, protocol, or timing needs.
Why Use SampleGroups?
✅ Group sensors of the same type for consistent sampling
✅ Simplify interval management across channels
✅ Save power by synchronizing wake-up and sampling
✅ Enable advanced behaviors like calibration mode sampling
Best Practices
Group all analog current (4–20mA) sensors in one group
Group analog voltage (0–5V, 0–10V) sensors separately
Serial sensors in a group must share the same protocol (e.g., Modbus RTU or SDI-12)
Digital channels (PCNT, PERIODIC) must also belong to a group to be sampled
Supported Groups by Firmware Version
Older than v2.301
Group 1 and Group 2 only (optional)
v2.301 and newer
Group 1 to Group 6 (mandatory for most)
⚠️ Starting from firmware v2.301, analog, serial, and most digital channels must be assigned to a SampleGroup or they will not sample.
SampleGroup Parameters
Each SampleGroup defines the following parameters:
group_active
Enables/disables group sampling (AS_OFF, AS_ON, AS_ON_HOLD)
AS_ON
group_sample_interval_sec
Time interval (in seconds) for regular sampling
300
group_sample_interval_type
Time sync behavior (INTERVAL_NORMAL or INTERVAL_SYNCED)
INTERVAL_NORMAL
group_sample_interval_calib
Interval during calibration mode (must be ≤ group_sample_interval_sec)
60
group_sequentiality_mode
Determines sampling order: all-at-once (GROUPED) or sequential (SEQUENTIAL)
GROUPED
ℹ️ Avoid using
INTERVAL_SYNCEDif your sampling interval is set below 60 seconds to prevent data loss.
Configuration Steps (via UI)
Navigate to Devices in the platform
Select the desired {{device_name}} in the Sites Tree
Go to the Configuration tab
Click Advanced Device Configuration
Expand the SampleGroup section and choose a group
Assign sensor channels to the group and set parameters accordingly
Additional References
Last updated