Quality and command codes
For what quality and commands mean, see Quality and Commands and confirmation.
Driver quality
| Code | Quality | Shown as |
|---|---|---|
| 0 | Good | Good |
| 1 | Uncertain | Uncertain; Uncertain · Simulated for a simulated value |
| 2 | Bad | Bad |
| 3 | Not connected | Bad · Not connected |
| 4 | Overflow | Uncertain · EU exceeded |
| 5 | Substituted | Good · Substituted (field manual) or Good · Local override (SCADA manual) |
Quality reasons: 1 Comm failure, 2 Sensor failure, 3 Config error, 4 Stale (last usable), 5 EU exceeded, 6 Initial value.
Quality bits
| Bit | Value | Meaning |
|---|---|---|
| IV | 0x80 | Invalid |
| NT | 0x40 | Not topical |
| SB | 0x20 | Substituted |
| BL | 0x10 | Blocked |
| OV | 0x01 | Overflow |
Screen and screen script quality (quality)
| Value | Meaning |
|---|---|
| 0 | Good |
| 1 | No connection between the browser and the server |
| 2 | Driver or device not connected |
| 3 | Signal failure (Uncertain, Bad or Overflow) |
| 4 | Manual value |
| 5 | Simulated value |
Command states (.cmd_state)
| Value | State | Meaning |
|---|---|---|
| 0 | Idle | No command in progress |
| 1 | Sending | The command is on its way |
| 2 | Applied | The device accepted the command |
| 3 | Rejected | The command was refused |
| 4 | Timeout | No result came back in time |
| 5 | ReadbackMismatch | The read-back value differs from the value sent |
| 6 | Unconfirmed | Sent; the device does not confirm commands |
| 7 | Confirmed | Read-back or feedback showed the expected value |
| 8 | NotConfirmed | Feedback did not reach the expected value in time |
Command reason codes
The text is shown after Command rejected or the other result texts.
| Code | Text shown |
|---|---|
no_comm | No device communication |
stale | Command expired, not applied |
busy | Previous command in progress |
unknown_tag | Signal not found |
not_writable | Signal is not writable |
type_mismatch | Value type not suitable |
out_of_range | Value out of range |
access_denied | Device does not allow writing |
device_error | Device returned an error |
timeout | No response from device |
unsupported | This operation is not supported |
forbidden | You are not authorised to send commands |
unauthorized | Session required |
login_required | Sign in to send commands |
zone_forbidden | You do not have control rights for this zone |
zone_not_controlled | The area is controlled by someone else, not by you. |
zone_unavailable | The area information has not loaded yet; try again. |
internal | System error |
readback_mismatch | Read-back value did not match the sent value |
forbidden_role | Your role is not permitted to write this signal |
limit_confirm_required | Write limit confirmation required |
approval_required | Critical command: reason / second-user approval required |
approval_invalid | Second-user approval is invalid |
unlock_invalid | The interlock override is invalid or already used; override the interlock again. |
unlock_rules_changed | The interlock rules have changed; override the interlock again. |
select_required | Select the device first (select → confirm in the control panel) |
select_expired | The selection expired — select the device again |
reserved | The device is selected by another operator |
tagged | Device is tagged — commands blocked |
cancelled | Cancelled — not sent |
not_confirmed | Feedback did not reach the expected value |