# Soft Events

Soft events let the user access the advanced functionality of the reader through special commands that allow access to internal data and parameters of the readers:

- Train Code – triggers the reader and trains the read code;
- Train Match String – triggers the reader and assigns the read code for Match string validation
- Focus – sets the reader through a focus adjustment sequence
- Train Brightness – sets the reader through a brightness adjustment sequence
- Untrain – disables the current trained code
- Set Input String – configures the input string for the serial
- Execute DMCC – sends a DMCC command to the reader
- Set Match String – configures the match string

The last three commands use the User data block and details and the following need to be set:

- User Data Option - Currently only used by “Set Match String” soft event. Specifies which code target to assign the string

- 1: DataMatrix
- 2: QR Code/MaxiCode/AztecCode
- 3: Linear/ Postal/ Stacked
- 4: VeriCode®
- 5: DotCode

- User Data Length – Size of data in the User Data
- User Data – necessary data to be sent

Set Match String Example

- Select User Data Option, for example 1
- Set User Data Length, for example 6
- Write in User Data the Match String you want to use, for example ABC123
- Trigger soft event

Execute DMCC

- Set User Data Length, for example 23
- Write Command in User Data like in command reference manual, for example GET DVALID.MATCH-STRING
- Trigger soft event

Set Input String Example

- Enable Input String with DMCC command, for example SET INPUT-STRING.ENABLE ON
- Set Input String Footer with DMCC command, for example SET INPUT-STRING.FOOTER <ETX>
- Set Input String Header with DMCC command, for example SET INPUT-STRING.HEADER <STX>
- Set User Data Length, for example 28
- Write in User Data the Input String you want to use, for example <STX>123<ETX>
- Trigger soft event