WriteIO (Set Status of Digital Control Ports)
The WriteIO instruction is used to set the status of the digital control ports under program control. See also PortSet (Set Port).
Syntax
Example
This example uses WriteIO to set control port 2 high when the temperature TBlk1(1) exceeds 77 degrees. It sets control port 2 low when the temperature is equal to or below 77 degrees.
Public Tblk1( 1 )
Dim Tref
DataTable( TEST,1, 1000 )
DataInterval( 0, 1,Sec, 100 )
Average( 1, Tblk1(), FP2, 0 )
EndTable
BeginProg
Scan( 1,Sec, 0, 0 )
If Tblk1( 1 ) > 77
Then 'Is it true?
WriteIO( &B10, &B10 ) 'Set bit 2 (C2) high if temp > 77
Else
'Is it false
WriteIO( &B10, &B00 ) 'Set bit 2 (C2) low if temp < 77
EndIf
CallTable
TEST 'Run Table TEST
NextScan
'Loop up for the next scan
EndProg
Remarks
By default, 5 V is applied to the port when the State is set high. Use the PortPairConfig instruction to set the output to 3.3 V.
There are 8 digital control ports available on the datalogger. The WriteIO instruction is used to set these ports using a binary number where a high port (+5 V) equals to 1 and a low port (0 V) equals to 0. For example, if ports 1 and 3 are to be set high and the remaining ports are to be low, the binary representation is 00000101, or decimal 5.
This instruction is not controlled by the task sequencer, but is controlled by processing. Therefore this instruction can be placed within a conditional statement. It should be remembered that processing can lag multiple scans behind measurements. See also PortSet.
NOTE: Programs with WriteIO will compile in sequential mode unless put into pipeline mode using the PipelineMode instruction. Because WriteIO runs as a processing task, when run in PipelineMode port changes may not occur in synchrony with measurements being made. Thus in PipelineMode, the instruction should not be used to control power to sensors from which measurements are being made.
Parameters
Mask
The Mask parameter is used to select which of the ports to read or write. It is a binary representation of the ports.
WriteIO: If a port position in the mask is set to 1, the datalogger sets the port based on the value for that port in the Source. If a port position in the mask is set to 0 the value in the Source is ignored. Binary numbers are entered into CRBasic by preceding the number with "&B". For example, if the mask is entered as &B110 (leading zeros can be omitted in binary format just as in decimal) and the source is 5 decimal (binary 101) port 3 will be set high and port 2 will be set low. The mask indicates that only 3 and 2 should be set. While the value of the source also has a 1 for port 1, it is ignored because the mask indicates 1 should not be changed.
ReadIO: If a port position is set to 1, the datalogger reads the status of the port. If a port position is set to 0 the datalogger ignores the status of the port (the Mask is "anded" with the port status; the "and" operation returns a 1 for a digit if the Mask digit and the port status are both 1, and a 0 if either or both is 0). CRBasic allows the entry of numbers in binary format by preceding the number with "&B". For example, if the Mask is entered as &B100 (leading zeros can be omitted in binary format just as in decimal) and ports 3 and 1 are high, the result of the instruction will be 4 (decimal, binary = 100); if port 3 is low, the result would be 0.
Type: Binary value (preceded by &B) or Integer (from 0 to 255 representing the binary value)
Source
The name of the Variable that is the input for the instruction. Right-click the parameter to display a list of defined variables.
Type: Variable
For the WriteIO instruction, the Source parameter is a constant or the variable that holds the value for setting the control ports. The Source value is interpreted as a binary number and the ports are set accordingly.