This page covers the setup of Newland scanner when using Mobile WMS.
| Table of Contents |
|---|
GS1 DataMatrix support
If the scanner needs to process GS1 DataMatrix barcodes in Mobile WMS. The AIM identifier can be enabled by scanning the barcode below:
Then check the “exec script” box and click “OK”.
Scanner Settings
This section covers the list of configurations applicable to the scanners using the start.cfg file. The behaviors of Newland Scanners are configurable in the start.cfg file and further applied when entering Mobile WMS. Here is an example of how it can be done:
...
A configuration option is set within <scanEngineProperty key="KEY" value="VALUE"/>, where KEY and VALUEare set based on the configurations listed in the following tables.
Scanner
...
This section covers the list of configurations applicable to the scanners using the start.cfg file.
Scanner behavior configurations
...
behavior configurations
The table below the setup example consists of all configuration options supported in Mobile WMS. The details about the configuration ID can be found in the Newland scanner handbook.
...
| Configuration ID | Value (* indicates default) |
|---|---|
| EXTRA_SCAN_POWER | Value = 0 Disable scanner = 1 Enable scanner* Note: When scanner is enabled, it will take some time to initialize during which all scan requests will be ignored. |
| EXTRA_TRIG_MODE | Value = 0 Level mode = 1 Continuous mode = 2 Pulse mode* = 4 Delay mode* |
| EXTRA_SCAN_MODE | Value = 1 Fill in EditText directly* = 2 Simulate keystroke = 3 Output via API (required to use Mobile WMS) |
| SEND_SCAN_FAIL_BROADCAST | Value = 0 Disable the send scan fail broadcast = 1 Enable the send scan fail broadcast |
| EXTRA_SCAN_AUTOENT | Value = 0 Do not add a line feed* = 1 Add a line feed |
| EXTRA_SCAN_NOTY_SND | Value = 0 Sound notification off = 1 Sound notification on* |
| EXTRA_SCAN_NOTY_VIB | Value = 0 Vibration notification off* = 1 Vibration notification on |
| EXTRA_SCAN_NOTY_LED | Value = 0 LED notification off = 1 LED notification on* |
| SCAN_TIMEOUT | Set decode session timeout (millisecond) Value = 0-9000; default: 3000* |
| SCAN_INTERVAL | Set timeout between decode sessions (millisecond) Value >= 50; default: 50* |
| TRIGGER_MODE_MAIN | Value = 0 Disable the Scan key on front panel as scan trigger = 1 Enable the Scan key on front panel as scan trigger* |
| TRIGGER_MODE_LEFT | Value = 0 Disable the Scan key on left side as scan trigger = 1 Enable the Scan key on left side as scan trigger* |
| TRIGGER_MODE_RIGHT | Value = 0 Disable the Scan key on right side as scan trigger = 1 Enable the Scan key on right side as scan trigger* |
| TRIGGER_MODE_BLACK | Value = 0 Disable the trigger on pistol grip as scan trigger = 1 Enable the trigger on pistol grip as scan trigger* (Precondition: The terminal supports this feature) |
| NON_REPEAT_TIMEOUT | Set reread delay (millisecond) Value = 0 Reread same barcode with no delay* > 0 Do not allow to reread same barcode before the delay expires |
| SCAN_PREFIX_ENABLE | Value = 0 Disable prefix = 1 Enable prefix* |
| SCAN_SUFFIX_ENABLE | Value = 0 Disable suffix = 1 Enable suffix* |
| SCAN_PREFIX | Set prefix Value = Hexadecimal value of prefix character; default: null* e.g. 0x61 should be entered as 61. |
| SCAN_SUFFIX | Set suffix Value = Hexadecimal value of suffix character; default: null* e.g. 0x61 should be entered as 61. |
| SCAN_ENCODE | Character encoding Value = 1 UTF-8 = 2 GBK* = 3 ISO-8859-1 = 4 AUTO = 5 Other Should enter the value of SCAN_OTHER_ENCODE at the same time = 6 windows-1251 |
| OUTPUT_RECOVERABLE | Value = true Enable overwrite output = false Disable overwrite output* |
| EXTRA_OUTPUT_EDITOR_ACTION_ENABLE | Value = 0 Disable software key event output * = 1 Enable software key event output |
| EXTRA_OUTPUT_EDITOR_ACTION | Value = 0 IME_ACTION_UNSPECIFIED = 1 IME_ACTION_NONE = 2 IME_ACTION_GO = 3 IME_ACTION_SEARCH = 4 IME_ACTION_SEND = 5 IME_ACTION_NEXT = 6 IME_ACTION_DONE * = 7 IME_ACTION_PREVIOUS |
...
| Symbology (marked with bold) | Configuration | |
|---|---|---|
| ID (marked with bold) | Value | |
Code 128 CODE128 | Enable/Disable Code 128 Enable | "0" or "1" (default: 1) "0": Disable Code 128 "1": Enable Code 128 |
Set minimum length Minlen | "1" – "127" (default: 1) | |
Set maximum length Maxlen | "1" – "127" (default: 48) | |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
GS1-128 (UCC/EAN-128) UCCEAN128 | Enable/Disable GS1-128 Enable | "0" or "1" (default: 1) |
Set minimum length Minlen | "1" – "127" (default: 1) | |
Set maximum length Maxlen | "1" - "127" (default: 48) | |
AIM 128 AIM128 | Enable/Disable AIM 128 Enable | "0" or "1" (default: 0) "0": Disable AIM 128 "1": Enable AIM 128 |
Set minimum length Minlen | "1" - "127" (default: 1) | |
Set maximum length Maxlen | "1" - "127" (default: 48) | |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
EAN-8 EAN8 | Enable/Disable EAN-8 Enable | "0" or "1" (default: 1) "0": Disable EAN-8 "1": Enable EAN-8 |
Transmit check character TrsmtChkChar | "0" or "1" (default: 1) "0": Do not transmit EAN-8 check character "1": Transmit EAN-8 check character | |
2-digit add-on code Digit2 | "0" or "1" (default: 0) "0": Disable 2-digit add-on code "1": Enable 2-digit add-on code | |
5-digit add-on code Digit5 | "0" or "1" (default: 0) "0": Disable 5-digit add-on code "1": Enable 5-digit add-on code | |
Add-on code required AddonRequired | "0" or "1" (default: 0) "0": EAN-8 add-on code not required "1": EAN-8 add-on code required | |
Enable EAN-8 zero extend MsgtoEan13 | "0" or "1" (default: 0) "0": Disable EAN-8 zero extend "1": Enable EAN-8 zero extend | |
Convert EAN-8 to EAN-13 TypetoEan13 | "0" or "1" (default: 0) "0": Do not convert EAN-8 to EAN-13 "1": Convert EAN-8 to EAN-13 | |
EAN-13 EAN13 | Enable/Disable EAN-13 Enable | "0" or "1" (default: 1) "0": Disable EAN-13 "1": Enable EAN-13 |
Transmit check character TrsmtChkChar | "0" or "1" (default: 1) "0": Do not transmit EAN-13 check character "1": Transmit EAN-13 check character | |
2-digit add-on code Digit2 | "0" or "1" (default: 0) "0": Disable 2-digit add-on code "1": Enable 2-digit add-on code | |
5-digit add-on code Digit5 | "0" or "1" (default: 0) "0": Disable 5-digit add-on code "1": Enable 5-digit add-on code | |
Add-on code required AddonRequired | "0" or "1" (default: 0) "0": EAN-13 add-on code not required "1": EAN-13 add-on code required | |
ISSN ISSN | Enable/Disable ISSN Enable | "0" or "1" (default: 0) "0": Disable ISSN "1": Enable ISSN |
ISBN ISBN | Enable/Disable ISBN Enable | "0" or "1" (default: 0) "0": Disable ISBN "1": Enable ISBN |
Set ISBN format Length | "0" or "1" (default: 1) "0": ISBN-13 "1": ISBN-10 | |
UPC-E UPCE | Enable/Disable UPC-E Enable | "0" or "1" (default: 1) "0": Disable UPC-E "1": Enable UPC-E |
Transmit check character TrsmtChkChar | "0" or "1" (default: 1) "0": Do not transmit UPC-E check character "1": Transmit UPC-E check character | |
2-digit add-on code Digit2 | "0" or "1" (default: 0) "0": Disable 2-digit add-on code "1": Enable 2-digit add-on code | |
5-digit add-on code Digit5 | "0" or "1" (default: 0) "0": Disable 5-digit add-on code "1": Enable 5-digit add-on code | |
Add-on code required AddonRequired | "0" or "1" (default: 0) "0": UPC-E add-on code not required "1": UPC-E add-on code required | |
Transmit system character TrsmtSysDigit | "0" or "1" (default: 1) "0": Do not transmit system character "1": Transmit system character | |
Enable UPC-E extend MsgToupca | "0" or "1" (default: 0) "0": Disable UPC-E extend "1": Enable UPC-E extend | |
UPC-A UPCA | Enable/Disable UPC-A Enable | "0" or "1" (default: 1) "0": Disable UPC-A "1": Enable UPC-A |
Transmit check character TrsmtChkChar | "0" or "1" (default: 1) "0": Do not transmit UPC-A check character "1": Transmit UPC-A check character | |
2-digit add-on code Digit2 | "0" or "1" (default: 0) "0": Disable 2-digit add-on code "1": Enable 2-digit add-on code | |
5-digit add-on code Digit5 | "0" or "1" (default: 0) "0": Disable 5-digit add-on code "1": Enable 5-digit add-on code | |
Add-on code required AddonRequired | "0" or "1" (default: 0) "0": UPC-A add-on code not required "1": UPC-A add-on code required | |
Transmit preamble character TrsmtSysDigit | "0" or "1" (default: 0) "0": Do not transmit UPC-A preamble character "1": Transmit UPC-A preamble character | |
Enable UPC-A + Coupon Coupon | "0" or "1" (default: 0) "0": Enable UPC-A + Coupon "1": Disable UPC-A + Coupon | |
Require coupon ReqCoupon | "0" or "1" (default: 0) "0": Do not require coupon "1": Require coupon | |
Coupon GS1 Databar output Gs1Coupon | "0" or "1" (default: 0) "0": GS1 output off "1": GS1 output on | |
Interleaved 2 of 5 ITF | Enable/Disable Interleaved 2 of 5 Enable | "0" or "1" (default: 1) "0": Disable Interleaved 2 of 5 "1": Enable Interleaved 2 of 5 |
Set minimum length Minlen | "1" – "127" (default: 6) | |
Set maximum length Maxlen | "1" – "127" (default: 80) | |
Check character verification Check | "0" - "1" (default: 0) "0": Disable check character verification "1": Enable check character verification | |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
ITF-6 ITF6 | Enable/Disable ITF-6 Enable | "0" or "1" (default: 0) "0": Disable ITF-6 "1": Enable ITF-6 |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
ITF-14 ITF14 | Enable/Disable ITF-14 Enable | "0" or "1" (default: 0) "0": Disable ITF-14 "1": Enable ITF-14 |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
Matrix 2 of 5 MATRIX25 | Enable/Disable Matrix 2 of 5 Enable | "0" or "1" (default: 1) "0": Disable Matrix 2 of 5 "1": Enable Matrix 2 of 5 |
Set minimum length Minlen | "1" – "127" (default: 4) | |
Set maximum length Maxlen | "1" – "127" (default: 80) | |
Check character verification Check | "0" - "1" (default: 0) "0": Disable check character verification "1": Enable check character verification | |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
Industrial 25 IND25 | Enable/Disable Industrial 25 Enable | "0" or "1" (default: 0) "0": Disable Industrial 25 "1": Enable Industrial 25 |
Set minimum length Minlen | "1" – "127" (default: 6) | |
Set maximum length Maxlen | "1" – "127" (default: 48) | |
Check character verification Check | "0" - "1" (default: 0) "0": Disable check character verification "1": Enable check character verification | |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
Standard 25 STD25 | Enable/Disable Standard 25 Enable | "0" or "1" (default: 0) "0": Disable Standard 25 "1": Enable Standard 25 |
Set minimum length Minlen | "1" – "127" (default: 6) | |
Set maximum length Maxlen | "1" – "127" (default: 48) | |
Check character verification Check | "0" - "1" (default: 0) "0": Disable check character verification "1": Enable check character verification | |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
Code 39 CODE39 | Enable/Disable Code 39 Enable | "0" or "1" (default: 1) "0": Disable Code 39 "1": Enable Code 39 |
Set minimum length Minlen | "1" – "127" (default: 1) | |
Set maximum length Maxlen | "1" – "127" (default: 48) | |
Check character verification Check | "0" - "1" (default: 0) "0": Disable check character verification | |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
Transmit start/stop character TrsmtStasrtStop | "0" or "1" (default: 0) "0": Do not transmit start/stop character "1": Transmit start/stop character | |
Code 39 Full ASCII FullAscii | "0" or "1" (default: 0) "0": Disable Code 39 Full ASCII "1": Enable Code 39 Full ASCII | |
Codabar CODABAR | Enable/Disable Codabar Enable | "0" or "1" (default: 1) "0": Disable Codabar "1": Enable Codabar |
Set minimum length Minlen | "1" – "127" (default: 2) | |
Set maximum length Maxlen | "1" – "127" (default: 60) | |
Check character verification Check | "0" - "1" (default: 0) "0": Disable check character verification "1": Enable check character verification | |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
Transmit start/stop character TrsmtStasrtStop | "0" or "1" (default: 0) "0": Do not transmit start/stop character "1": Transmit start/stop character | |
Start/Stop character format StartStopMode | "0" or "1" (default: 0) "0": ABCD/ABCD "1": ABCD/TN*E | |
Code 93 CODE93 | Enable/Disable Code 93 Enable | "0" or "1" (default: 0) "0": Disable Code 93 "1": Enable Code 93 |
Set minimum length Minlen | "1" – "127" (default: 1) | |
Set maximum length Maxlen | "1" – "127" (default: 48) | |
Check character verification Check | "0" - "1" (default: 0) "0": Disable check character verification "1": Enable check character verification | |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
Code 11 CODE11 | Enable/Disable Code 11 Enable | "0" or "1" (default: 0) "0": Disable Code 11 "1": Enable Code 11 |
Set minimum length Minlen | "1" – "127" (default: 4) | |
Set maximum length Maxlen | "1" – "127" (default: 48) | |
Check character verification Check | "0" - "5" (default: 1) "0": Disable "1": 1 check character, MOD11 "2": 2 check characters, MOD11/MOD11 "3": 2 check characters, MOD11/MOD9 "4": 1 check character, MOD11; 2 check characters, MOD11/MOD11 "5": 1 check character, MOD11; 2 check characters, MOD11/MOD9 | |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
Plessey PLSY | Enable/Disable Plessey Enable | "0" or "1" (default: 0) "0": Disable Plessey "1": Enable Plessey |
Set minimum length Minlen | "1" – "127" (default: 1) | |
Set maximum length Maxlen | "1" – "127" (default: 127) | |
Check character verification Check | "0" - "1" (default: 0) "0": Disable check character verification "1": Enable check character verification | |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
MSI-Plessey MSIPLSY | Enable/Disable MSI-Plessey Enable | "0" or "1" (default: 0) "0": Disable MSI-Plessey "1": Enable MSI-Plessey |
Set minimum length Minlen | "1" – "127" (default: 4) | |
Set maximum length Maxlen | "1" – "127" (default: 48) | |
Check character verification Check | "0" - "3" (default: 1) "0": Disable "1": 1 check character, MOD10 "2": 2 check characters, MOD10/MOD10 "3": 2 check characters, MOD10/MOD11 | |
Transmit check character TrsmtChkChar | "0" or "1" (default: 0) "0": Do not transmit check character "1": Transmit check character | |
PDF417 PDF417 | Enable/Disable PDF417 Enable | "0" or "1" (default: 1) "0": Disable PDF417 "1": Enable PDF417 |
Set minimum length Minlen | "1" – "2710" (default: 1) | |
Set maximum length Maxlen | "1" – "2710" (default: 2710) | |
PDF417 twin code CodeNum | "1" or "2" (default: 1) "1": Read single PDF417 code "2": Read two PDF417 codes | |
Fixed number of barcodes on an image NumFixed | "0" or "1" (default: 1) "0": Varied number of barcodes on an image "1": Fixed number of barcodes on an image | |
PDF417 inverse VideoMode | "0" or "2" (default: 0) "0": Decode regular PDF417 barcodes only "1": Decode inverse PDF417 barcodes only "2": Decode both | |
QR Code QR | Enable/Disable QR Code Enable | "0" or "1" (default: 1) "0": Disable QR Code "1": Enable QR Code |
Set minimum length Minlen | "1" – "7089" (default: 1) | |
Set maximum length Maxlen | "1" – "7089" (default: 7089) | |
QR twin code CodeNum | "1" or "2" (default: 1) "1": Read single QR code "2": Read two QR codes | |
Fixed number of barcodes on an image NumFixed | "0" or "1" (default: 1) "0": Varied number of barcodes on an image "1": Fixed number of barcodes on an image | |
QR Code inverse VideoMode | "0" or "2" (default: 0) "0": Decode regular QR barcodes only "1": Decode inverse QR barcodes only "2": Decode both | |
Data Matrix DM | Enable/Disable Data Matrix Enable | "0" or "1" (default: 1) "0": Disable Data Matrix "1": Enable Data Matrix |
Set minimum length Minlen | "1" – "3116" (default: 1) | |
Set maximum length Maxlen | "1" – "3116" (default: 3116) | |
Rectangular barcode RectAngle | "0" or "1" (default: 1) "0": Disable rectangular DM "1": Enable rectangular DM | |
Data Matrix twin code CodeNum | "1" or "2" (default: 1) "1": Read single Data Matrix code "2": Read two Data Matrix codes | |
Fixed number of barcodes on an image NumFixed | "0" or "1" (default: 1) "0": Varied number of barcodes on an image "1": Fixed number of barcodes on an image | |
Data Matrix inverse VideoMode | : "0" or "2" (default: 0) "0": Decode regular Data Matrix barcodes only "1": Decode inverse Data Matrix barcodes only "2": Decode both | |
Chinese Sensible (CS) Code CSC | Enable/Disable CS Code Enable | "0" or "1" (default: 0) "0": Disable CS Code "1": Enable CS Code |
Set minimum length Minlen | "1" – "7827" (default: 1) | |
Set maximum length Maxlen | "1" – "7827" (default: 7827) | |
CS twin code CodeNum | "1" or "2" (default: 1) "1": Read single CS code "2": Read two CS codes | |
Fixed number of barcodes on an image NumFixed | "0" or "1" (default: 1) "0": Varied number of barcodes on an image "1": Fixed number of barcodes on an image | |
CS Code inverse VideoMode | "0" or "2" (default: 0) "0": Decode regular CS barcodes only "1": Decode inverse CS barcodes only "2": Decode both | |
Aztec AZTEC | Enable/Disable Aztec Enable | "0" or "1" (default: 0) "0": Disable Aztec "1": Enable Aztec |
Set minimum length Minlen | "1" – "3832" (default: 1) | |
Set maximum length Maxlen | "1" – "3832" (default: 3832) | |
Aztec twin code CodeNum | "1" or "2" (default: 1) "1": Read single Aztec code "2": Read two Aztec codes | |
Fixed number of barcodes on an image NumFixed | "0" or "1" (default: 1) "0": Varied number of barcodes on an image "1": Fixed number of barcodes on an image | |
Aztec inverse VideoMode | "0" or "2" (default: 0) "0": Decode regular Aztec barcodes only "1": Decode inverse Aztec barcodes only "2": Decode both | |
MicroPDF417 MICROPDF | Enable/Disable MicroPDF417 Enable | "0" or "1" (default: 0) "0": Disable MicroPDF417 "1": Enable MicroPDF417 |
Set minimum length Minlen | "1" – "366" (default: 1) | |
Set maximum length Maxlen | "1" – "366" (default: 366) | |
Micro QR MICROQR | Enable/Disable Micro QR Enable | "0" or "1" (default: 0) "0": Disable Micro QR "1": Enable Micro QR |
Set minimum length Minlen | "1" – "35" (default: 1) | |
Set maximum length Maxlen | "1" – "35" (default: 35) | |
GS1 DataMatrix support
If the scanner needs to process GS1 DataMatrix barcodes in Mobile WMS. The AIM identifier can be enabled by scanning the barcode below:
...
Common issues & fix
This section covers the common issues from the users and their corresponding fix.
Scanner related issues
If the scanner does not behave correctly according to the setup in start.cfg, please consider resetting the scanner settings:
- Open "Quick Settings" app:
- Select "Scan".
- Make sure the "Enable scan" option is checked.
- Select "Restore default".
- After restore default, if the device needs to support GS1 barcodes, please scan the QR-code shown in the first section of this page to enable GS1 barcode support.
- Restart Mobile WMS and check if the issue still occurs.