Scanlab RTC 5 PC Interface Board, Инструкция по установке и эксплуатации

Страница: 484 / 622

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
484
innovators for industry
Ctrl Command set_softstart_level
Function sets the softstart values.
Call
set_softstart_level( Index, Level )
Parameters All parameters must be unsigned 32-bit values.
Parameter Allowed Values Description
Index
0 … 1023 index number of the softstart table value
Level
0 … 2
12
–1
0 … (2
32
-1)
for softstart mode = 1, 2, 11 and 12 (see set_softstart_mode ).
Value 0 corresponds to an analog voltage value of 0 V; value 2
12
–1
corresponds to 10 V.
for softstart mode = 3 and 13 (see
set_softstart_mode ).
1 bit corresponds to a pulse length of 1/64
µ
s (in RTC
®
5 mode) or 1/8
µ
s
(in RTC
®
4 compatibility mode).
Comments • The set_softstart_level command defines the
Level
value for the pulse number
Index
.
The command must be called separately for each individual
Level
value.
•
Index
must be in the range [0…1023], otherwise the set_softstart_level command will
not be executed ( get_last_error return code
RTC5_PARAM_ERROR
).
• If
Index

Number
(
Number
is defined via set_softstart_mode ) then set_softstart_level
will be executed but the defined value will not be used during softstart.
• Be sure to set as many softstart values as you defined by set_softstart_mode (unspec-
ified softstart values have undefined contents).
• The softstart mode is enabled by the command set_softstart_mode .
• For softstart modes 1, 2, 11 or 12,
Level
is restricted to 12 bits; higher bits will be
ignored (also see write_da_x or write_da_x_list ).
• If Softstart mode = 3 or 13 and the specified softstart pulse length is larger than the
laser signal period duration specified via set_laser_pulses or set_laser_timing
(2 ·
HalfPeriod
), then the laser will remain continuously on.
• Particularly if softstart values are to be outputted as analog voltage values (softstart
mode = 1, 2, 11 or 12), the set_softstart_mode command must be called before first-
time use of the set_softstart_level command; otherwise the specified value will not be
correctly converted to an analog value.
• Also observe the note in section "Softstart Mode" on page 135 .
• If the “freely definable wobbel shape“ wobbel mode is activated, then this command
will have no effect; see chapter 8.4 "Wobbel Mode", page 167 .
RTC
®
4

RTC
®
5 essentially unchanged functionality (except for the extended range of values)
In RTC
®
4 compatibility mode, analog voltage levels are internally multiplied by 4 (here
2
10
–1 corresponds to 10 V; the values are converted from 10 to 12 bits) and pulselenght
values are multiplied by 8 (here 1 bit corresponds to 1/8 µ s; the values are converted from
units of 1/8 µ s to units of 1/64 µ s; the 1 µ s timebase – see set_laser_timing – is no longer
supported). The permissible range of values for
Level
is correspondingly smaller. Due to
this difference in the handling of analog voltage and pulselenght values,
set_softstart_mode must always be called before set_softstart_level .
References set_softstart_mode , set_softstart_mode_list , set_softstart_level_list