DigitalOutput
The DigitalOutput component is designed to service local physical digital outputs.
The DigitalOutput component
The component must be placed under LocalIODevice component.
The default value of the component is false.
The DigitalOutput in the Property Sheet
The DigitalOutput component has the following slots:
- Facets: determines how an input value will be displayed.
- Proxy Ext: the component’s extension that handles the point's configuration and has the following slots:
- Status: indicates a current status of the component;
- Ok: the component is working properly;
- Disabled: the component or its parent (device or network) is disabled (the Enabled slot is set to false);
- Fault: indicates an incorrect configuration of the component;
- Down: no response from the point;
- Fault Cause: describes a cause of an error if there is a fault or down status;
- None: no fault;
- Bad Parent: component has been inserted in an incorrect place in the structure (the only correct place is the Device component or a subfolder of the Device component);
- Duplicated Component: appears if a component with a given address already exists (prevents double representation of the input/output within an application);
- Invalid Type: a type of component is not supported by the device;
- Parent disabled: a parent (device or network) is disabled;
- Point down: the point is unavailable.
- Enabled: enables/disables the component;
- Poll Frequency: allows to select a poll frequency of the points, the available options are: fast, normal, slow;
- Output Number: allows to select an output number; if the point is added to the device, the component selects the first unused output number automatically;
- Max Output Number: shows the number of available outputs in the device;
- Polarity Conversion: allows for the output to operate in a reversed polarity. The following options are available from a drop-down list:
- Direct: the digital output works in a normally open mode (default);
Reverse: the digital output works in a normally closed mode.
- Status: indicates a current status of the component;
Warning!
Using a reverse polarity changes the NO operation of the digital output to NC only on the software side. The physical relays are normally open type and will update their state only when the station is running. Please be cautious when using a reversed polarity, as this can lead to later confusion when solving logic issues.
- Out: provides a real-time information about the current value of the input data, according to parameters set in the Facets slot, Polarity Conversion slot, and current state of the point. If the Out slot value was forced by one of the available component’s actions, the value is followed by information about the executed action, e.g., {overridden}. If the component is working properly, the status is considered normal, and the value appears with the default status {ok}.
- In1-In16: input slots; the value of the highest priority slot different from null is rewritten into the Out slot. The In1 has the highest priority, while the In16 has the lowest priority;
- Fallback: if the component has a null value, or is incorrect on all In1-In16 slots, the Out slot takes the value entered into this slot. The value of the Fallback slot can be set with the Set action.
- Override Expiration: the time after which the Override action expires;
- Min Active Time: allows to set a timer to specify the minimum active time; typically, used is to prevent short cycling of equipment controlled by the point;
- Min Inactive Time: allows to set a timer to specify the minimum inactive time; typically, used is to prevent short cycling of equipment controlled by the point;
- Set Min Inactive Time on Start: if the slot value is set to true, the Min Inactive Time timer is enabled from the start of the station.
The DigitalOutput component has the following actions:
- Emergency Override: overwrites the value of the component with the highest priority (In1); this action does not expire automatically–in order to disable it, enable the Emergency Auto action;
- Emergency Auto: restores the component to automatic operation; disables Emergency Override action;
- Override: overwrites the component value (on the In8 priority); the action is disabled after the time set in the Override Expiration slot;
- Auto: sets the point to automatic operation;
- Set: changes the value of the Fallback slot.
Additionally, the ProxyExt component’s extension has the following actions:
- Force Write Config: instantly saves point configurations to the device;
- Force Read: sends a query immediately, despite the settings in the Poll Frequency slot;
- Force Write: sends the overwrite command automatically despite the values set in the Poll Frequency slot.
Any change of configuration slots, such as Input Number or Default Output results in sending this configuration to the device automatically.