Scanlab RTC 5 PC Interface Board - set_port_default

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
469
innovators for industry
Ctrl Command set_port_default
Function defines the default output value for the selected output port.
Call
set_port_default( Port, Value )
Parameters Port Selection of the output port for which a default Value shall be defined as an
unsigned 32-bit value; allowed values:
= 0: ANALOG OUT1 output port (also see page 47)
= 1: ANALOG OUT2 output port (also see page 47)
= 2: 8-bit digital output port (also see page 50)
= 3: 16-bit digital output port (also see page 49)
= 4: 2-bit digital output port (also see page 46)
Value Desired default value as an unsigned 32-bit value; allowed values:
for
Port = 0/1: 12-bit values[0 … 4095], higher bits are ignored.
for
Port = 2: 8-bit values [0 … 255], higher bits are ignored.
for
Port = 3: 16-bit values [0 … (2
16
–1)], higher bits are ignored.
for
Port = 4: 2-bit values [0 … 3], higher bits are ignored.
For
Value = “–1“ (= 2
32
–1 = 0xFFFFFFFF), the corresponding default output
functionality is switched off (see comment below).
Comments • During initialization of the RTC
®
5 (via load_program_file), the default values of all
output ports are set to “–1“ (= 2
32
–1).
• If a default value “–1“ has been specified for an output port, the port will be set to
this default value as soon as processing of a list has ended with stop_execution or via
an external stop signal. For a default value of “–1”, the corresponding output port will
not be addressed (any existing high-impedance state of the digital output ports is
retained).
• Default values (“–1“) at the output ports 0/1 (ANALOG OUT1 or ANALOG OUT2) will
also be set at the end of pixel output mode (see page 192).
• After initialization of position- and/or speed-dependent laser control via
set_auto_laser_control, the corresponding default value (for output port 0, 1, 2 or 3,
depending on the selected laser signal parameter
Ctrl ), will also be outputted each
time the laser is switched off after marking or when position- and/or speed-dependent
laser control is set to another
Ctrl parameter via set_auto_laser_control or deacti-
vated via set_auto_laser_control (
Ctrl = 0) (see page 141). If the default value is then
defined as “–1”, then the maximum allowable value (4095, 4095, 255 or 65535) will
be outputted.
• If the values for
Port is invalid, then set_port_default will not be executed
(get_last_error return code:
RTC5_PARAM_ERROR ).
• The default values for the output ports 0-2 can also be defined via the command
set_laser_off_default.
RTC
®
4  RTC
®
5 new command
In RTC
®
4 compatibility mode, the RTC
®
5 multiplies the specified Value for Port =0/1 by
4 (the RTC
®
4’s analog outputs only handled 10-bit values).
References set_laser_off_default, set_default_pixel