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
, see below).
Call
laser_on_pulses_list( Period, Pulses )
Parameters
Period
time interval in
bits
as an unsigned 32-bit value.
1 bit 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
), 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
(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
(external signal pulses aren’t taken into account, see comments there).
Otherwise (for 0
Pulses
65535)
laser_on_pulses_list
(in contrast to
)
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
(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
or
before it can be switched on with
laser_on_pulses_list
).