Scanlab RTC 5 PC Interface Board Installation And Operation Manual page 312

Variable laser_on_pulses_list
List Command
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
Pulses
Comments • The command is useful for marking separate points in laser mode 6 (see
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
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
Period · 10 µs), even if the specified number of external signal pulses will expire in a
shorter time interval.
31
• If 2
(i.e. (Period – 2
specified number of external signal pulses has been detected.
• If Pulses > 65535, then laser_on_pulses_list's function is identical to
(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
enable_laser
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
time interval in bits as an unsigned 32-bit value.
1 bit equals 10 µs. Allowed range: 0  Period  (2
Number of external signal pulses as an unsigned 32-bit value.
Allowed range: 0  Pulses  65535 or larger (see comments below).
page
31
–1), then the command's duration is always Period clocks (i.e.
 Period  (2 32
–1), the command's maximum duration is (Period – 2
31
) · 10 µs). Here, however, the command will terminate as soon as the
before it can be switched on with laser_on_pulses_list (see
32
46). Via set_laser_control(bit #5), you can specify
set_laser_control
–1)
page 137), but
31
) clocks
laser_on_list
or
page 128).
312