Scanlab RTC 5 PC Interface Board - laser_on_pulses_list

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
312
innovators for industry
Variable
List Command
laser_on_pulses_list
Function turns on the LASERON laser control signal for the specified number of external signal
pulses, but for no longer than the specified time interval
(if
Pulses > 65535, the command’s function is identical to laser_on_list, see below).
Call
laser_on_pulses_list( Period, Pulses )
Parameters Period time interval in bits as an unsigned 32-bit value.
1bit equals 10µs. Allowed range: 0 
Period  (2
32
–1)
Pulses Number of external signal pulses as an unsigned 32-bit value.
Allowed range: 0 
Pulses  65535 or larger (see comments below).
Comments • The command is useful for marking separate points in laser mode 6 (see page 137), but
also effective in the other laser modes.
• The external pulses must be supplied as TTL pulses at the LASER connector’s
DIGITAL IN1 digital input (see page 46). Via set_laser_control(bit #5), you can specify
whether signal pulses should be counted at rising or falling edges.
•If
Period = 0, then the command has no effect and laser_on_pulses_list becomes a
short list command.
• If 0 <
Period  (2
31
–1), then the command’s duration is always Period clocks (i.e.
Period · 10 µs), even if the specified number of external signal pulses will expire in a
shorter time interval.
•If 2
31
 Period  (2
32
–1), the command’s maximum duration is ( Period – 2
31
) clocks
(i.e. (
Period – 2
31
) · 10 µs). Here, however, the command will terminate as soon as the
specified number of external signal pulses has been detected.
•If
Pulses > 65535, then laser_on_pulses_list’s function is identical to laser_on_list
(external signal pulses aren’t taken into account, see comments there).
Otherwise (for 0 
Pulses  65535) laser_on_pulses_list (in contrast to laser_on_list)
won’t toggle the laser control signals between “laser active” and “laser standby” oper-
ation, but instead only switches the LASERON signal (hence not the LASER1 and LASER2
signals), whereby laser delays aren’t taken into account. Likewise during this command,
unexpired laser delays activated by prior commands will have no effect (though their
effect will resume when the LASERON signal switches off again after the final pulse or
after
Period ).
•If 1
Pulses  65535, then the LASERON signal will switch on upon the edge (accor-
ding the polarity set via set_laser_control(bit#5)) of the first external pulse (unless it’s
already on due to an unexpired LaserOff delay) and remains on for the specified number
of pulses, but no longer than until the end of the number of 10 µs periods specified via
Period . Users should ensure to define Period large enough for processing Pulses
number of signal pulses in this time interval. If the DIGITAL IN1 input doesn’t receive
any pulses, then laser_on_pulses_list will not alter the LASERON signal. If more signal
pulses than specified via
Pulses are received during the time interval defined by Period ,
then the surplus pulses will be ignored.
•If
Pulses = 0, then laser_on_pulses_list will have no effect (the LASERON signal is not
switched on). Then laser_on_pulses_list becomes a short list command.
• The LASERON signal must first be defined and enabled via set_laser_control or
enable_laser before it can be switched on with laser_on_pulses_list (see page 128).