AnalogOutput
The AnalogOutput component is designed for supporting local physical analog outputs working as voltage outputs (range 0 V-10 V) or PWM.
The component must be placed under LocalIODevice component.
The default value of the component is 0.00 V.
The AnalogOutput 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;
- Analog Type: allows to select the mode, which the analog output operates in.
- Status: indicates a current status of the component;
Available Analog Modes
The following input types are available:
- 0-10 V: the analog output works as a voltage output in range of 0-10V;
- PWM1Hz: the analog output operates in PWM mode with a frequency of 1 Hz;
- PWM10Hz: the analog output operates in PWM mode with a frequency of 10 Hz;
- PWM100Hz: the analog output operates in PWM mode with a frequency of 100 Hz;
- PWM01Hz: the analog output operates in PWM mode with a frequency of 0,1 Hz.
- Linear Conversion: converts the Out slot value according to the formula y=ax+b, where x = value of the In slot with the highest priority other than null; a = the Scale slot; b = the Offset slot. Incorrect scaling of the results in the calculated value (exceeding the available range for the device, e.g., 0-10 V), results in indicating a different value on the input and on the Out slot. If the scaling is correct, the values are identical;
- Out: provides a real-time information about the current value of the input data together with the units selected in the Facets slot and the current state of the point. If the value of the Out slot is forced by one of the available component actions, the value is followed by the information about the executed action, e.g., {overridden}. If the component is working correctly, 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.
The AnalogOutput 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 Poll Frequency settings.
Any change of the configuration slots such as Input Number, Analog Type, or Default Output results in sending this configuration to the device automatically.