Version: V018.000

#ABORT
ABORT

Aborts a GETHTTP Transfer.
#BASICSETTINGS
BASICSETTINGS READ|STORE

  READ:    Read basic settings parameters from persistent memory
  STORE:   Write the current basic settings configuration to persistent memory
Most settings belong to the category MEASSETTINGS. The following commands
allow configuration of BASICSETTINGS parameters:

  BAUDRATE
  ECHO
  KEYLOCK
  LANGUAGE
  PASSWD
  UART_PROTOCOL
  UNIT
#BOOTMODE
BOOTMODE [FIELDBUS|RECOVERY]

Switches the sensor's firmware mode. If the requested mode is already active, no action is
performed. Otherwise the requested firmware is installed and the sensor reboots. The installation
takes approx. one minute. During this period, the sensor must not be disconnected from power supply.

  FIELDBUS:   Activates fieldbus mode.
  RECOVERY:   Activates recovery mode.
#CHANGESETTINGS
CHANGESETTINGS

Output MEASSETTINGS if any such parameters have changed since the last
time MEASSETTINGS STORE was called.
Output BASICSETTINGS if any such parameters have changed since the last
time BASICSETTINGS STORE was called.
#COMP
COMP [CH01 [<id>]]
COMP CH01 <id> MEDIAN <signal> <median data count>
COMP CH01 <id> MOVING <signal> <moving data count>
COMP CH01 <id> RECURSIVE <signal> <recursive data count>
COMP CH01 <id> NONE

With the COMP command it is possible to display, create, modify, and delete
customised measurement data processing computations. MEDIAN, MOVING,
and RECURSIVE are averaging functions that alter the output of <signal>.

  <id> 1...10
  <signal> a measurement data signal (see META_COMP)
  <median data count> 3|5|7|9
  <moving data count> 2 .. 4096
  <recursive data count> 2 .. 32767

  MEDIAN will sort the last <median data count> values and output the middle
    value. Useful, for example, for eliminating spikes.
  MOVING will output an average over the last <moving data count> values.
  RECURSIVE averaging uses the previous average value when calculating the new
    average value. This permits a high degree of smoothing of the measurement
    values. A higher <recursive data count> will result in a higher amount of
    smoothing.
  NONE is a special option which is used to delete an entry.
#ECHO
ECHO [ON|OFF]

Defines if command name should return after writing access. In reading mode
command name is always returned.

  ON:  Return command name and command response or error message
  OFF: Return command response or error message
#EXPORT
EXPORT (MEASSETTINGS <SettingName>) | BASICSETTINGS | MEASSETTINGS_ALL | ALL

Exports the settings of the sensor.

  MEASSETTINGS:     Exports the measurement settings with name <SettingName>
  BASICSETTINGS:    Exports only the basic settings
  MEASSETTINGS_ALL: Exports all measurement settings
  ALL:              Exports basic settings and all measurement settings
#EXPOSURELIMIT
EXPOSURELIMIT [<value>]

Set or display the upper limit of the exposure period limiting the controlled
range. The range is internally limited by the selected measurement frequency
and the current lower limit of the exposure period (EXPOSUREMIN).
The unit is us.

  value: 0.1 .. 4000.0 (accuracy: 0.1)
#EXPOSUREMIN
EXPOSUREMIN [<value>]

Set or display the lower limit of the exposure period limiting the controlled
range. The range is internally limited by the selected measurement frequency
and the current upper limit of the exposure period (EXPOSURELIMIT).
The unit is us.

  value: 0.1 .. 4000.0 (accuracy: 0.1)
#EXPOSUREMODE
EXPOSUREMODE [STANDARD|BACKGROUND]

  STANDARD:    standard exposure control
  BACKGROUND:  background suppression; reduces impact of ambient light immission

Note: The mode BACKGROUND works with a double exposure. This halves the frequency with which
      measurement data is recorded, but the maximum possible exposure time remains the same.
#FIELD_LINEARIZATION
FIELD_LINEARIZATION <subcommand> [<name>]

Controls the global linearization of the measured distance based on three
reference points. When the two-point linearization is active, point 1 and
point 2 are used. For three-point linearization point 3 is used in addition.

  STATE [<state>]:                Get/Set the linearization state.
                                  <state> = ON|OFF

  MODE [<mode>]:                  Get/Set the linearization mode.
                                  <mode> = NONE|TWO_POINT|THREE_POINT

  TARGET_VALUE [<index> <value>]: Get the target values of all reference points
                                  or set the target value for the reference
                                  point linked to the given index.
                                  <index> = 1|2|3
                                  <value> = -2147.0 ... 2147.0

  SET_POINT [<index>]:            Get the stored positions of all reference
                                  points or stores the current measurement
                                  value as position of the reference point
                                  linked to the given index.
                                  <index> = 1|2|3

  COEFFICIENTS:                   Get the linearization coefficients dependent
                                  on the current mode.
                                  The coefficients are normalized to the
                                  measurement range.
                                  The linearized value 'y' is retrieved by the
                                  following formula with 'x' as original
                                  value (mr := measurement range):
                                  y = (a_2 / mr) * x^2 + a_1 * x + a_0 * mr
#GETINFO
GETINFO

Returns information about the sensor.
#GETUSERLEVEL
GETUSERLEVEL

Get the current user level.
#HELP
HELP [HELP|<Command>]

Output a list of available commands. This help text or Command specific help text.

Command without parameters
--------------------------
  <Command>    Run command

Command with parameters
-----------------------
  <Command>    Display current parameter settings.
  <Command> <Parameter1> [<Parameter2> [...]]
               Set variable number of parameters.
  <Command> <Parameter1> <Parameter2> ... <Parameter...>
               Set fixed number of parameters.

Command responses
-----------------
  ->           Cursor, the sensor is ready for input.
  E<ddd> <Msg> Error message, execution aborted.
  W<ddd> <Msg> Warning message, execution continues.

  <ddd>        Three-digit number
  <Msg>        Message

Format description
------------------
  ()           Grouping
  []           Optional parameter
  <>           Placeholder
  |            Alternation

  If a parameter includes spaces it has to be set in double quotes.

Examples
------------------
  a|b          Use either a or b
  a b          Both parameters are required
  a [b [c]]    Variable number of parameters: a, a b, or a b c

  PASSWD <Old password> <New password> <New password>
               To change the password all parameters are required.
#IMPORT
IMPORT [FORCE] [APPLY] <ImportData>

Imports settings into the sensor.

  FORCE:      Allow to overwrite existing settings
  APPLY:      Apply the imported settings
  ImportData: Data in JSON format
#LANGUAGE
LANGUAGE [DE | EN | CN | KR | JP]

Set the language for the website.
  DE:  Set the language to German
  EN:  Set the language to English
  CN:  Set the language to Chinese
  JP:  Set the language to Japanese
  KR:  Set the language to Korean
#LASERPOW
LASERPOW [FULL|MEDIUM|REDUCED|OFF]

  FULL:       Full power for standard surfaces
  MEDIUM:     Optimized power for strongly reflective surfaces and small
              measuring ranges
  REDUCED:    Minimum power for service
  OFF:        Laser is off

When switching the laser power, ensure that the signal intensity is in a range
from 25 to 50%.
#LOGIN
LOGIN <password>

Change the current user level to PROFESSIONAL. (see GETUSERLEVEL)

The password must contain at least 1 character, and can contain a
maximum of 31 characters.
The following characters are permitted: a-zA-Z0-9 _(),;.:-_/.
If the password contains spaces, the whole password must be set
in quotes ("password").

  password: defined password
#LOGOUT
LOGOUT

Change the current user level to USER.
#MASTER
MASTER [<signal>]
MASTER [ALL|<signal> [SET|RESET]]

Display actual master configuration or set a master configuration.
The SET master function will take a current measurement value from <signal>,
and the <signal> master value (configured using MASTERSIGNAL), to determine an
offset. This offset will then be applied to all subsequent measured values.
  Example: If the master value is 0, and <signal> currently measures 0.5mm,
  then the offset, which will be applied to <signal>, will be -0.5mm.
The RESET function will set the offset back to 0.
The display output lists signals and the word ACTIVE, if mastering is currently
active for this signal, or INACTIVE if it is not.

  signal: a measurement data signal (see META_MASTER)
#MASTERSIGNAL
MASTERSIGNAL [<signal>]
MASTERSIGNAL <signal> <master value>
MASTERSIGNAL <signal> NONE

  <signal> a measurement data signal (see META_MASTERSIGNAL)
  <master value> A value in mm between -2147.0 and 2147.0

Display, configure, or delete, master configuration entries.
The master value is the value that the current measurement value will be
adjusted to if mastering is active. Mastering can be activated using the MASTER
command.
The command META_MASTERSIGNAL lists all the available signals that can be used
with this command.
The display output lists signals and currently configured master values.
#MASTERSIGNALSELECT
MASTERSIGNALSELECT [ALL | NONE | <signal1> [ | <signal2> [...]]]

Display or set the selection of the measurement data signal(s) for mastering
via selected input source (MFI/KEY_SELECT). A list of available signals is provided by
the command META_MASTER.
The configuration of signals is done by using the command MASTERSIGNAL.

  ALL:    All configured signals will be mastered by the selected input source.
  NONE:   No signal will be mastered.
  signal: The specified signals will be mastered by the selected input source.
#MEASPEAK
MEASPEAK [DISTA | DISTW | DIST1 | DISTL]

  DISTA:      Use peak with highest amplitude (standard at diffuse reflection)
  DISTW:      Use peak with largest area
  DIST1:      Use first peak
  DISTL:      Use last peak
#MEASRATE
MEASRATE [<frequency>]

Get or set the measuring rate, i.e. the frequency in kHz.

  <frequency [kHz]> = 0.250 .. 20.000
#MEASSETTINGS
MEASSETTINGS <subcommand> [<name>]

Handle application-dependent measuring settings. Either use a PRESET prepared
by the manufacturer (PRESETMODE and setting from PRESETLIST), or use a
user-defined setting.
During a mastering process also the current setup will be stored into the flash - for
more information see to the command MASTERSOURCE
  PRESETMODE:        Get current preset mode
  PRESETMODE <mode>: Set preset mode, <mode> = STATIC|BALANCED|DYNAMIC|NOAVERAGING
  PRESETLIST:        List all manufacturer settings
  CURRENT:           Get name of current setting
  READ <Name>:       Load setting <name> from persistent memory
  STORE <name new>:  Write user-defined setting into persistent memory
  RENAME <name> <name new> [FORCE]: Rename user-defined setting
  DELETE <name>:     Remove user-defined setting <name> from persistent memory
  INITIAL AUTO:      Load the last stored setting when the sensor is started
  INITIAL <name>:    Load setting <name> when the sensor is started
                     Note: Only user-defined settings are allowed
  LIST:              List the names of all stored user-defined settings

  FORCE:     Allow overwriting of an existing user-defined setting.
  <name>     The name of a manufacturer setting or a user-defined setting.
  <name new> The name of a user-defined setting. Names must contain at least 2
             characters, and can contain a maximum of 31 characters.
             The following characters are permitted: a-zA-Z0-9_
             The names of presets are not allowed, and names may not begin
             with "AUTO".

#META_COMP
META_COMP [CH01 <id>]

List the signals which can be used with the command COMP.
The command COMP places some restrictions on which signals can be used and
when, and which combinations of channels and signals are allowed.
If supplied with a channel and id, this command will list the signals allowed
for the command 'COMP <channel> <id> ..'

  id: 1 .. 10
#META_CORE_RANGE
META_CORE_RANGE

Displays the first and last pixel of the sensor line, which are the limits by the
calibrated measuring range.
#META_MASTER
META_MASTER

List the signals (configured with the command MASTERSIGNAL) which can be
selected with the command MASTER.
#META_MASTERSIGNAL
META_MASTERSIGNAL

List the signals which can be selected with the command MASTERSIGNAL.
#META_STATISTIC
META_STATISTIC

List the signals (configured with the command STATISTICSIGNAL) which can be
selected with the command STATISTIC.
#META_STATISTICSIGNAL
META_STATISTICSIGNAL

List the signals which can be selected with the command STATISTICSIGNAL.
#NOK
NOK

Repeat a GETHTTP Transfer.
#OK
OK

Continue a GETHTTP Transfer.
#PASSWD
PASSWD <old_password> <new_password> <new_password>

Change the password for user level PROFESSIONAL.

The password must contain at least 1 character, and can contain a
maximum of 31 characters.
The following characters are permitted: a-zA-Z0-9 _(),;.:-_/.
If the password contains spaces, the whole password must be set
in quotes ("password").
#PEAK_THRESGLOB
PEAK_THRESGLOB [<value>]

Set the global minimal threshold. A valid peak must be above this threshold
value.
The value of PEAK_THRESGLOB must be greater than PEAK_THRESNOISE.

<value> = 0.0 .. 100.0[%]
#PEAK_WIDTHMAX
PEAK_WIDTHMAX [<value>]

Set the global maximal peak width threshold. A valid peak must be below this
threshold value.

<value> = 1 .. 1024
#PRINT
PRINT [ALL]

Print a partial, or a complete, list of setting parameters and their values.
#RESET
RESET

Restart the sensor.
#RESETCNT
RESETCNT [TIMESTAMP] [MEASCNT] [TRIGGEREVENT] [TRIGGERVALUE]

Reset the internal counters, e.g. to synchronize.

  TIMESTAMP:    Time stamp
  MEASCNT:      Measured value counter (profile counter)
  TRIGGEREVENT: Trigger event counter
  TRIGGERVALUE: Trigger value counter
#ROI
ROI [<begin> [<end>]]

Set or display the range of interest.

  <begin>: 0 .. (<end>-1)
  <end>:   (<begin>+1) .. 1023
#SETDEFAULT
SETDEFAULT ALL | MEASSETTINGS | BASICSETTINGS

Reset the sensor to the factory's default settings.

  ALL:            Delete all settings and load the factory settings
  MEASSETTINGS:   Delete all measurement settings
  BASICSETTINGS:  Delete all basic settings
#SHUTTER
SHUTTER [<value>]

Select a preferred fixed exposure time.
This value will be used when SHUTTERMODE is set to MANUAL.
The actual exposure time may be less than <value> as the maximum exposure time
is inversely proportional to the MEASRATE. The unit is usec.

  value: 0.1 .. 4000.0 (accuracy: 0.1, unit: us)
#SHUTTERMODE
SHUTTERMODE [MEAS|MANUAL]

  MEAS:       Exposure time is adapted automatically
  MANUAL:     Exposure time is set manually (see also SHUTTER)
#STATISTIC
STATISTIC ALL|<signal> RESET

Reset the values of the STATISTICSIGNAL signals:
  <signal>_MIN
  <signal>_MAX
  <signal>_PEAK

  signal: a measurement data signal (see META_STATISTIC)
#STATISTICSIGNAL
STATISTICSIGNAL [<signal>]
STATISTICSIGNAL <signal> NONE|INFINITE|<depth>

Display, configure, or delete statistic configuration entries.
Statistic configuration entries will produce new signals in the form:
  <signal>_MIN
  <signal>_MAX
  <signal>_PEAK
These new signals will output the minimum value, the maximum value, and the
peak value (maximum - minimum) from the last <depth> measurement cycles of
<signal>.
The option INFINITE can be selected instead of a fixed depth, and means the
new signals will contain the statistics from all <signal> data.
The special option 'NONE' is used to delete a statistic configuration entry.
The command STATISTIC can be used to reset the values in the new signals.
The command META_STATISTICSIGNAL lists all the available signals that can be
used with this command.

  signal: a measurement data signal (see META_STATISTICSIGNAL)
  depth:  2|4|8|...|4096|8192
          The depth of values to be used in the calculation in the range.
#STDUSER
STDUSER [USER|PROFESSIONAL]

Get or set the standard user level. This is the user level which is used after
system start and RESET.
#TARGETMODE
TARGETMODE [STANDARD | MULTISURFACE | PENETRATION]

Select material-dependent algorithm.
#UNIT
UNIT [MM|INCH]

Get or set the measurement units used in the website. The command measurement
units are not affected.
