Prerequisites
- CoreScanner must be installed on each host PC. Please refer to CoreScanner Installers.
-
After downloading the CLU from the Zebra Support website, add the execution permission to the utility:
$ sudo chmod +x CLU
-
Third Party Software Libraries.
Table 1: Minimum Software Requirements for CoreScanner Installation
Library / Technology Version Limitation C++ 98 and 11 standards compatibilities Libudev 147 or above
Scanner Device Communication Modes Vs. Capabilities
Table 2: Device Communication Modes
USB interface protocol | Supported CLU Features commands |
---|---|
USB SNAPI | All |
USB IBM Table-top | All** |
USB IBM Handheld | All** |
USB HID Keyboard | Switchhost* |
** Firmware update and configuration load are slower in IBM modes compared to USB SNAPI.
* Only the switchhost command is supported in HIDKB mode. Once switched to SNAPI or IBM, all features are supported.
If your application requires data in HIDKB format, enable the Simulated HID Keyboard Output feature in Zebra CoreScanner for Linux.
Simulated HID Keyboard Output allows scanners in USB-SNAPI, USB-IBM Table-top, USB-IBM Handheld, USB-OPOS or SSI mode to emulate HID Keyboard keystrokes to a host system. It sends the content of the scanned barcode as HID Keyboard keystrokes thus emulating USB-HIDKB scanner mode while continuing to operate in a bi-directional protocol needed to support the CLU.
NOTE: For a list of a scanner's supported attribute (parameter) numbers and definitions, refer to the Product Reference Guide for that scanner model, available from the Zebra Support website at http://www.zebra.com/support. Attributes include configuration parameters, monitored data, and asset tracking information.
References
- Find or Search for Scanner Parameters in 123Scan Config File
- List of Programmable RSM Scanner Parameters Dictionary Table Definition
Basic Usage Description
CLU status ID/return code values can be obtained by using the command 'returnvalues'.
./CLU returnvalues
CLU connected device(s) topology can be obtained by using the command 'topology'.
./CLU topology
CLU device filtering is done by using either the -model or -id switch.
./CLU -model <model-filter> <command>
./CLU -id <id-filter> <command>
Description: Execute the specified command on all connected scanners that match the Model or Corescanner ID filtering criteria.
Model / ID filtering options are:
Full model name - Ex: -model "DS8178-SR0F007ZZWW"
Scanner ID - Ex: -id "1"
Wild cards with leading string - Ex: -model "DS81*"
Wild card only (all scanners) - Ex: -model "\*"
Comma separated multiple strings - Ex: -model "DS81*,MP7*"
Comma separated multiple strings - Ex: -id "1,3,4"
Supported CLU command options (performed on scanners that match the filter criteria):
- list - List connected scanners.
- reboot - Reboot scanner.
- assetinfo - Output scanner type, model number, firmware version, serial number and date of manufacture.
- resetscale - If present, reset the scale.
- switchsnapi - Perform permanent switch of the scanner to 'USB-SNAPI with Imaging' host mode.
- switchsnapi temporary - Perform temporary switch of the scanner to 'USB-SNAPI with Imaging' host mode.
- switchibmhid - Perform permanent switch of the scanner to USB-IBMHID host mode.
- switchibmtt - Perform permanent switch of the scanner to USB-IBMTableTop host mode.
- updateconfig filepath - Update scanner configuration using a 123Scan configuration file. The configuration file path must be inside double quotes.
- setattribute attribute_id,data_type,attribute_value - Set attribute values temporarily in the scanner. Values must be comma-separated inside double quotes.
- storeattribute attribute_id,data_type,attribute_value - Store attribute values persistently in the scanner. Values must be comma-separated inside double quotes.
- getattribute attribute_id - Retrieves the data type and the value of the attribute ID. Multiple attribute_ids can be queried using a comma-separated list.
- getallattributes - Retrieves all attribute_ids of the scanner.
- updatefirmware filepath - Update scanner firmware using a DAT file. File path must be inside double quoptesp.
- updatefirmware filepath debug - Update scanner firmware using a DAT file with update event notifications. File path must be inside double quotes.
- updatefirmwarefromplugin filepath - Update scanner firmware using a 123Scan plugin file. File path must be inside double quotes.
- updatefirmwarefromplugin filepath debug - Update scanner firmware using a 123Scan plugin file with update event notifications. File path must be inside double quotes.
Examples of Commands
returnvalues | |
---|---|
Description | Obtain CLU status ID mapping / return status values. |
Example |
|
Samples |
|
list | |
Description | Lists the connected scanners that match the filter criteria. |
Example |
|
Samples |
|
reboot | |
Description | Reboots the scanner. |
Example |
|
Samples |
|
assetinfo | |
Description | Output scanner type, model number, firmware version, serial number and date of manufacture. |
Example |
|
Samples |
|
topology | |
Description | Obtains the device topology. |
Example |
|
Samples |
|
resetscale | |
Description | If present, reset the scale. |
Example |
|
Samples |
|
switchsnapi temporary | |
Description | Perform temporary switch of the scanner to 'USB-SNAPI with Imaging' host mode. |
Example |
|
Samples |
|
switchsnapi | |
Description | Performs persistent switch of the scanner to 'USB-SNAPI with Imaging' host mode. |
Example |
|
Samples |
|
switchibmhid | |
Description | Perform persistent switch of the scanner to USB-IBMHID host mode. |
Example |
|
Samples |
|
switchibmtt | |
Description | Perform persistent switch of the scanner to USB-IBMTableTop host mode. |
Example |
|
Samples |
|
getallattributes | |
Description | Retrieves all attribute_ids of the scanner. |
Example |
|
Samples |
|
getattribute | |
Description | Retrieves the data type and the value of the attribute ID. Multiple attribute_ids can be queried using a comma-separated list. |
Example |
|
Sample 1: specific attribute |
|
Sample 2: list of attributes |
|
setattribute | |
Description | Sets attribute values temporarily in the scanner. Values for attribute_id, data_type and attribute_value must be comma-separated inside double quotes. |
Example |
|
Sample (only set, not stored, lost after a reboot) |
|
storeattribute | |
Description | Stores attribute values persistently in the scanner. Values for attribute_id, data_type and attribute_value must be comma-separated inside double quotes. |
Example |
|
Sample (stored permanently, even after a reboot) |
|
updateconfig filepath | |
Description | Updates the scanner configuration using a 123Scan configuration file. The configuration absolute file path must be inside double quotes. |
Example |
|
Samples |
|
updatefirmware filepath | |
Description | Updates the scanner firmware using a DAT file. Absolute file path must be inside double quotes. |
Example |
|
Samples |
|
updatefirmware filepath debug | |
Description | Updates the scanner firmware using a DAT file with update event notifications. Absolute file path must be inside double quotes. |
Example |
|
Samples |
|
updatefirmwarefromplugin filepath | |
Description | Updates the scanner firmware using a 123Scan plugin file. Absolute file path must be inside double quotes. |
Example |
|
Samples |
|
updatefirmwarefromplugin filepath debug | |
Description | Updates the scanner firmware using a 123Scan plugin file with update event notifications. Absolute file path must be inside double quotes. |
Example |
|
Samples |
|