Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

This page covers the setup of Newland scanner when using Mobile WMS.

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:

start.cfg (xml)
...
	<!-- SCANNER -->
	<scanner>
		<type>internal</type>
		...
		<scanEngineProperties>
		...
			<scanEngineProperty key="KEY" value="VALUE"/>
		...
		</scanEngineProperties>
		...
	</scanner>
...

A configuration option is set within <scanEngineProperty key="KEY" value="VALUE"/>, where KEY and VALUE are set based on the configurations listed in the following tables.

Scanner Settings

This section covers the list of configurations applicable to the scanners using the start.cfg file.

Scanner 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.

Setup example

Here are some examples of changing the scanner behaviors within the <scanEngineProperties> tag in start.cfg file:

start.cfg (xml)
<!-- Syntax: key="Configuration ID" value="Value" -->

<!-- Example: Change scan mode to level mode -->
<scanEngineProperty key="EXTRA_TRIG_MODE" value="0"/>

<!-- Example: Enable overwrite output -->
<scanEngineProperty key="OUTPUT_RECOVERABLE" value="true"/>

<!-- Example: Set suffix to 0x61 -->
<scanEngineProperty key="SCAN_SUFFIX" value="61"/>

Where the content of the key is a Configuration ID and content of the value is the corresponding Value to the Configuration ID as key.


Configuration IDValue (* indicates default)
EXTRA_SCAN_POWERValue = 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_MODEValue = 0 Level mode
          = 1 Continuous mode
          = 2 Pulse mode*
          = 4 Delay mode*
EXTRA_SCAN_MODEValue = 1 Fill in EditText directly*
          = 2 Simulate keystroke
          = 3 Output via API
SEND_SCAN_FAIL_BROADCASTValue = 0 Disable the send scan fail broadcast
          = 1 Enable the send scan fail broadcast
EXTRA_SCAN_NOTY_SNDValue = 0 Sound notification off
          = 1 Sound notification on*
EXTRA_SCAN_NOTY_VIBValue = 0 Vibration notification off*
          = 1 Vibration notification on 
EXTRA_SCAN_NOTY_LEDValue = 0 LED notification off
          = 1 LED notification on*
SCAN_TIMEOUTSet decode session timeout (millisecond)
Value = 0-9000; default: 3000*
SCAN_INTERVALSet timeout between decode sessions (millisecond)
Value >= 50; default: 50*
TRIGGER_MODE_MAINValue = 0 Disable the Scan key on front panel as scan trigger
         = 1 Enable the Scan key on front panel as scan trigger*
TRIGGER_MODE_LEFTValue = 0 Disable the Scan key on left side as scan trigger
          = 1 Enable the Scan key on left side as scan trigger*
TRIGGER_MODE_RIGHTValue = 0 Disable the Scan key on right side as scan trigger
          = 1 Enable the Scan key on right side as scan trigger* 
TRIGGER_MODE_BLACKValue = 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_TIMEOUTSet 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_ENABLEValue = 0 Disable prefix
          = 1 Enable prefix*
SCAN_SUFFIX_ENABLEValue = 0 Disable suffix
          = 1 Enable suffix*
SCAN_PREFIXSet prefix
Value = Hexadecimal value of prefix character; default: null*
e.g. 0x61 should be entered as 61.
SCAN_SUFFIXSet suffix
Value = Hexadecimal value of suffix character; default: null*
e.g. 0x61 should be entered as 61.
SCAN_ENCODECharacter 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_RECOVERABLEValue = true  Enable overwrite output
          = false Disable overwrite output*
EXTRA_OUTPUT_EDITOR_ACTION_ENABLEValue = 0 Disable software key event output *
          = 1 Enable software key event output
EXTRA_OUTPUT_EDITOR_ACTIONValue = 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

Scanner symbology configurations

The table below the setup example consists of all symbology configurations supported in Mobile WMS:

Setup example

Here are some examples of changing the scanner symbologies configurations within the <scanEngineProperties> tag in start.cfg file:

start.cfg (xml)
<!-- Syntax -->
<!-- key="Symbology" value="ConfigurationID:ConfigurationValue" -->

<!-- Example: Disable Code 128 -->
<scanEngineProperty key="CODE128" value="Enable:0"/>

<!-- Example: Set GS1-128 (UCC/EAN-128) maximum length to 127 -->
<scanEngineProperty key="UCCEAN128" value="Maxlen:127"/>

Where the content of the key is a Symbology and content of the value consists of an Configuration ID followed by ":" and the corresponding Configuration Value to the ID.

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)
"0": Disable GS1-128(UCC/EAN-128)
"1": Enable GS1-128(UCC/EAN-128)

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:

Qr code Description automatically generated

Then check the “exec script” box and click “OK”.

  • No labels