Crestron SIMPL+ - DIGITAL_OUTPUT Declaration

Software Crestron SIMPL+
®
52 z SIMPL+
®
Language Reference Guide - DOC. 5797G
DIGITAL_OUTPUT
Name:
DIGITAL_OUTPUT
Syntax:
DIGITAL_OUTPUT <var1>[,<var2>...];
DIGITAL_OUTPUT <var[size]>;
DIGITAL_OUTPUT <var[size[,<min>]]>;
Description:
Routes a value from the SIMPL+ program to a SIMPL program. If a value different
from 0 is placed on a DIGITAL_OUTPUT, the digital signal in the SIMPL program
is set high when the control system processes the logic.
Refer to the discussion on arrays on page 46.
In X-Generation Control Systems, if a new value is assigned to the
DIGITAL_OUTPUT from the SIMPL+ program, the value read back from it within
the SIMPL+ program will have the original state until the logic is serviced. For
example, if a DIGITAL_OUTPUT has a value of 0, and the value 1 is written to it,
the value read back will be 0 until the system processes the rest of the logic attached
to that SIMPL+ symbol. This is unlike an ANALOG_OUTPUT. If every change of
a DIGITAL_OUTPUT is required to be seen by the logic, a PROCESSLOGIC
statement is required after the assignment to the DIGITAL_OUTPUT.
In the 2-Series Control Systems, the logic process sees ALL values that are assigned
to the DIGITAL_OUTPUT. No PROCESSLOGIC is required. As an example, if the
following code is used in the 2-Series Control Systems:
DIGITAL_OUTPUT State1;
State1=1;
State1=0;
The logic will end up seeing a short pulse.
For an array of DIGITAL_OUTPUTs, the maximum value of SIZE is 65535. Valid
indices are 1 through the specified size.
NOTE: DIGITAL_OUTPUTs may be jammed with other digital values from a
SIMPL program (i.e., from a BUFFER or other jammable digital logic, even other
SIMPL+ symbols). When such an output is jammed, the new value is read back into
the SIMPL+ symbol and the value of the output is altered.
NOTE: <min> is the number of outputs shown at a minimum in SIMPL Windows.
The Default is 1. The user can expand the minimum up to the full size. Only the last
array of a type can have <min>. Refer to Arrays on page 31, and Declarations on
page 45.
NOTE: You should use isSignalDefined to test whether the output is connected to an
actual signal in the SIMPL Windows program before assigning a value to it. If you
assign a value and there is no signal, a message is placed in the system error log.