14.2 Scanner Monitoring

The ScannerMonitoring feature of the SP-ICE-3 Card allows monitoring of the return value of an arbitrary SL2-100 command, and throws an exception if the value from the scanner is not as expected.

Thus it is possible to stop execution of the current Command List immediately if the scanner is no longer working as expected.

Scanner Monitoring Configuration

ScannerMonitoring offers several options to enable and adjust monitoring of the scanner. It works as follows:

The configured Command is sent by the firmware to the scanner every Period milliseconds using the TransceiveEnhanced API call.
The response is compared to the GoodValue after applying the Mask.
If both values do not match then an internal error count is increased.
If both values match then the internal error count is reset to zero.
If the internal error count reaches MinConsecutiveErrors any ongoing execution will be stopped immediately, and an exception thrown.
- At this point, if ContinueOnError is true, the internal error count will be reset, and monitoring will continue.
- However, if ContinueOnError is false, monitoring will be suspended, and the card will go into an error state that prevents it from executing further Command Lists until the error is cleared.
  The error state can be cleared by calling ResetOperatingState, or by disabling scanner monitoring.
  Please refer to 18.2 Card Operating State for more information about error states on the SP-ICE-3 Card.

StandAlone Mode

When in 16 Stand-Alone Mode, the Error List will be executed if scanner monitoring detects an error.

Note
If ContinueOnError is enabled, the error list will be called over and over again, as long as the error condition persists. When ContinueOnError is disabled, however, the error list will be executed once only. All branches or calls to other lists from inside the error list will be ignored. StandAlone mode will automatically continue after the error state has been cleared.