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

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
Index
Level
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
• 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
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
• If Softstart mode = 3 or 13 and the specified softstart pulse length is larger than the
laser signal period duration specified via
(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
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
• If the "freely definable wobbel shape" wobbel mode is activated, then this command
will have no effect; see
® ®
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
10
2 –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
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
References set_softstart_mode, set_softstart_mode_list,
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
Allowed Values Description
0 ... 1023 index number of the softstart table value
12
0 ... 2 –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
corresponds to 10 V.
32
0 ... (2 -1) for softstart mode = 3 and 13 (see set_softstart_mode).
1 bit corresponds to a pulse length of 1/64 µs (in RTC
®
(in RTC 4 compatibility mode).
(get_last_error return code RTC5_PARAM_ERROR).
write_da_x or write_da_x_list).
set_softstart_mode
"Softstart Mode" on page
chapter 8.4 "Wobbel Mode", page
must always be called before set_softstart_level.
set_softstart_mode
set_laser_pulses or set_laser_timing
command must be called before first-
135.
167.
set_laser_timing
set_softstart_level_list
12
–1
®
5 mode) or 1/8 µs
(unspec-
– is no longer
484