Probe¶
A probe is an on-demand, one-shot reachability check of a sub-device: the platform asks its gateway to perform a real read on the field bus and report whether the device answered and the round-trip time. The platform only relays the request; it never interprets or stores the reading as business data.
Probe vs presence¶
Presence is the platform's continuous, cached connection state. For a passive sub-device it reflects only what its gateway asserts while the gateway's own platform session is alive — a device that drops off the field bus (power loss, wiring fault) can still appear online until the gateway notices via a health check. A probe instead proves end-to-end application reachability at the moment it runs and returns the measured round-trip time. It never updates presence or any other device state.
Probe vs health check¶
- Probe — manual, one-off batch check; results are shown only to the operator.
- Health check — a periodic probe loop configured on a connector instance that automatically drives the bound device's online/offline state.
Probe modes¶
The platform only validates and forwards mode; its precise semantics are defined by the edge implementation.
| Mode | Recommended meaning |
|---|---|
cached |
Answer from the most recent known check; no new field-bus read is required. |
fresh (default) |
Perform a new read on the field bus now. |
strict |
Perform a new read under the strictest checking rules. |
A probe targets only sub-devices bound to a gateway. Devices on an offline gateway are not queued; they fail immediately with a not-connected error.