Digital input and output parameters

ID Label Type #Val Min Max Attr Description

500

Force DIO on or off

String

 

 0

31

 

This string accepts a command to force DIO signals on or off, or to clear forcing. Digital inputs, digital outputs, and soft digital signals can all have their values forced. When forced, the DIO signal value is set to the forced state independent of the value that is being read by the hardware or commanded via a user program. This is a useful diagnostic tool when you are debugging a cell.

The format of the string is as follows:

   <signal>,<value>
  or
   <first_signal>,<last_signal>,0

For the first form, a single signal is affected.  <signal> is a standard DIO signal number and <value> is interpreted as follows:

    1 means force on
   -1 means force off
    0 clears any force on or off condition

For the second form, a range of signals are forced off.  <first_signal> and <last_signal> are standard DIO signal numbers that specify the range. Uninstalled or invalid signals within the range are ignored.  For example, to clear all non-soft signals, specify "1, 19999, 0".

501

General DIO outputs

Uint8

96

 

 

RO

This parameter returns the current state of a bank of 96 general digital output signals or a single signal.

The database unit number specifies which bank of signals to access and should be set to:
     1 + bank + 1000*node

Bank 0 contains the general digital outputs on the local (master) controller and any of its networked slave controllers.   Node 0 or 1 refers to the local (master) controller.  Nodes > 1 refer to networked slave controllers.  Banks > 0 contain Remote I/O module digital outputs.  For Remote I/O modules, the node must always be 0.

The values returned correspond to signals:
     1 + 100*bank + 100000*node
   through
     96 + 100*bank. + 100000*node

Each returned value is interpreted as bit flags that are defined as follows:

    &H01 The signal is ON
    &H02 The signal is configured, i.e. this is a valid DOUT
    &H04 The signal is currently forced ON
    &H08 The signal is currently forced OFF

For example, if the 13th number has a value of &H0A, this would imply that channel 13 was configured as a digital output signal and its value was currently being forced OFF.

502

General DIO inputs

Uint8

96

 

 

RO

This parameter returns the current state of a bank of 96 general digital input signals or a single signal.

The database unit number specifies which bank of signals to access and should be set to:
     1 + bank + 1000*node

Bank 0 contains the general digital inputs on the local (master) controller and any of its networked slave controllers.   Node 0 or 1 refers to the local (master) controller.  Nodes > 1 refer to networked slave controllers.  Banks > 0 contain Remote I/O module digital inputs.  For Remote I/O modules, the node must always be 0.

The values returned correspond to signals:
     10001 + 100*bank + 100000*node
   through
     10096 + 100*bank. + 100000*node

Please see the description for the "General DIO outputs" (DataID 501) for how to interpret the values returned by this parameter.

503

Dedicated DIO outputs

Uint8

96

 

 

RO

This parameter returns the current state of a bank of 96 dedicated digital output signals or a single signal.

The database unit number specifies which bank of signals to access and should be set to:
     1 + bank

Bank 0 contains the controller related digital outputs.  Banks > 0 contain axis-related digital outputs.   Access to Remote I/O boards is not supported.

The values returned correspond to signals:
     8001 + 100*bank
  through
     8096 + 100*bank.

Please see the description for the "General DIO outputs" (DataID 501) for how to interpret the values returned by this parameter.

504

Dedicated DIO inputs

Uint8

96

 

 

RO

This parameter returns the current state of a bank of 96 dedicated digital input signals or a single signal.

The database unit number specifies which bank of signals to access and should be set to:
     1 + bank

Bank 0 contains the controller related digital inputs.  Banks > 0 contain axis-related digital inputs.   Access to Remote I/O boards is not supported.

The values returned correspond to signals:
     18001 + 100*bank
  through
     18096 + 100*bank.

Please see the description for the "General DIO outputs" (DataID 501) for how to interpret the values returned by this parameter.

505 Soft DIO signals Uint8 64     RO This parameter returns the current state of a range of software digital input and output signals or a single signal. The soft DIO signals are internal variables and do not correspond to any externally generated or sensed hardware signals. These signals are provided as a programming convenience and are often used for simple semaphores between threads. The soft digital I/O signals start at channel 20001 and go up to 21000. Please see the description for the "General DIO outputs" DataID(501) for how to interpret the values returned by this parameter.

506

Number of hardware latches

Unit8

 

 

 

RO

The number of hardware latches present on the local controller. The first n general digital inputs use these latches starting with input signal number 10001.

507

Latch: input, queued, unmapped, badpos, inpovr, outovr

Uint32

6

 

 

RO

An array of statistics related to encoder latching. The elements are as follows:


   1: The number of latch results detected locally by hardware or software.
   2: The number of latch results queued to a master or a robot.
   3: The number of latch results ignored because they were not assigned to any robot.
   4: The number of failures to read encoder positions after a latch result was detected.
   5: The number of overflows for the latch result input FIFO.
   6: The number of overflows for the latch result output robot queue.

508

Local DIO mask: inputs, outputs

Uint32

2

 

 

RO

An array of bit masks showing the local DIO hardware available on the local controller. A bit that is set means that the corresponding DIO point is available. The array elements are organized as follows:

1: Input signals 10001 - 10032
2: Output signals 1 - 32.

511

General AIO outputs

%

6

 

 

RO

This parameter returns the current output value of a single analog output channel or the values of all channels. The numbers returned by this function are the commanded values after being thresholded to be within specified limits but prior to the application of a scale factor and offset. The scale and offset convert the commanded value to hardware DAC units. If a channel is not configured in the system, a value of 0 is returned. The equation for transforming the commanded output value to DAC units is as follows:

  DAC out = (command - offset) * scale factor

512

General AIO inputs

%

4

 

 

RO

This parameter returns the current value of a single analog input channel or the values of all channels. The numbers returned by this function are the values after the ADC readings have been transformed by a scale factor and offset and thresholded to be within specified limits. Normally, the scaling factor and offset are chosen such that the operating range of the ADC translates into 100% to -100%. If a channel is not configured in a system, a value of 0 is returned. The implemented ADC value transformation is as follows:

  output = (ADC reading * scale factor) + offset

518

Local AIO mask: input, outputs

 

 

 

 

 

 

520

Gen AIO Out scale factor

Flt32

6

 

 

 

This is an array of scale factors, one per channel, that are applied to the General AIO out values to convert them to DAC units. Please see "General AIO outputs" (DataID 511) for a description of the transformation equation.

521

Gen AIO Out offset

Flt32

6

 

 

 

This is an array of offsets, one per channel, that are applied to the General AIO out values to convert them to DAC units. Please see "General AIO outputs" (DataID 511) for a description of the transformation equation.

522

Gen AIO Out-min scaled value

Flt32

6

 

 

 

This is an array of minimum values, one per channel, in user units that are applied to the "General AIO output" (DataID 511) commands to ensure the values are within a specified range. If a commanded value is outside of the range, it is set to this limit prior to conversion to DAC units.

523

Gen AIO Out max scaled value

Flt32

6

 

 

 

This is an array of maximum values, one per channel, in user units that are applied to the "General AIO output" (DataID 511) commands to ensure the values are within a specified range. If a commanded value is outside of the range, it is set to this limit prior to conversion to DAC units.

524

Gen AIO In scale factor

Flt32

4

 

 

 

This is an array of scale factors, one per channel, that are applied to the General AIO input values to convert them to from raw ADC units. Please see "General AIO inputs" (DataID 512) for a description of the transformation equation.

525

Gen AIO In offset

Flt32

4

 

 

 

This is an array of offsets, one per channel, that are applied to the General AIO input values to convert them to from raw ADC units. Please see "General AIO inputs" (DataID 512) for a description of the transformation equation.

526

Gen AIO In min scaled value

Flt32

4

 

 

 

This is an array of minimum values, one per channel, in user units that are applied to the "General AIO input" (DataID 512) transformed values to ensure that they are within a specified range. If a converted value is outside of the range, it is set to this limit.

527

Gen AIO In max scaled value

Flt32

4

 

 

 

This is an array of maximum values, one per channel, in user units that are applied to the "General AIO input" (DataID 512) transformed values to ensure that they are within a specified range. If a converted value is outside of the range, it is set to this limit.

530

DOUT sink mode 1, 2, 3, 4, 5, 6, 7, 8

BOOL

8

 

 

 

For newer controllers that support software DIO configuration, this parameter sets and displays whether local digital output signals operate in sinking or sourcing mode. Each output signal's mode can be individually set. The output is sinking if its corresponding element is 1, otherwise a value of 0 indicates sourcing. By default, all local outputs (GPL signals 13-20) are set to sinking.

531

DIN sink mode 1-4, 5-8, 9-12

BOOL

3

 

 

 

For newer controllers that support software DIO configuration, this parameter sets and displays whether local digital input signals operate in sinking or sourcing mode. The input signals are set in groups of four. A group of inputs are sinking if their corresponding element is 1, otherwise a value of 0 indicates sourcing. By default, all local inputs (GPL signals 10001-10012) are set to sourcing.

541

General DOUT labels

String

32

15

 

This is an array of strings that is provided as a documentation aid for generating DIO web pages. Rather than hard coding the names of DOUT signals into a HTML form, the names can be stored in this array. These names can then be automatically included in dynamic, ASP web pages. If the usage of the DOUT signals are later changed, the values in this array can be modified and the displayed contents on a web page will be updated without changing the HTML source code.

542

General DIN labels

String

32

0

15

 

This is an array of strings that is provided as a documentation aid for generating DIO web pages. Rather than hard coding the names of DIN signals into a HTML form, the names can be stored in this array. These names can then be automatically included in dynamic, ASP web pages. If the usage of the DIN signals are later changed, the values in this array can be modified and the displayed contents on a web page will be updated without changing the HTML source code.

543

ZIO DOUT labels

String

8

0

15

 

An array of strings provided as a documentation aid for generating DIO web pages using the ZIO outputs. See "General DOUT labels" (DataId 541) for details.

544

ZIO DIN labels

String

8

0

15

 

An array of strings provided as a documentation aid for generating DIO web pages using the ZIO inputs. See "General DIN labels" (DataId 542) for details.