Scanlab RTC 5 PC Interface Board - set_softstart_level

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