Overview
Barcode Input options specify the device hardware to use for scanning and the decoders to be applied on the acquired data before sending it for processing. Decoders included with DataWedge are explained below. DataWedge also provides audio and other feedback to alert the user of scanning results and barcode type. See the Scanner Parameters section for more information.
If using SimulScan, see SimulScan Input profile guide.
Barcode Input is used to specify:
- Device cameras
- 1D and 2D and imagers
- Laser-based barcode scanners
- Bluetooth-connected scanners
- USB synchronous serial interface (SSI) scanners
Barcode Scanner Input reads data from the integrated barcode scanner built into the device, or attached via cable or Bluetooth connection, or implemented as a snap-on module. DataWedge supports lasers, imagers and internal cameras. The raw barcode data that's acquired is processed or formatted as using the Basic and Advanced Data Formatting Processing options that are found near the Output options.
Note: When SimulScan is used, DataWedge concatenates all captured text into a single string, and performs processing on the concatenated string. See the SimulScan section for details.
The parameters of this feature can be configured using the Set Config API.
Scanner Selection
For Barcode Input, the Scanner selection panel determines which scanning device will be used for data capture. The list of available scanners is based on devices present in (or connected to) the unit being configured.
The "Auto" option automatically determines the best scanning device from the list of available devices based on the rules below.
Auto Scanner Selection Rules:
- If a Zebra Scan Module or Scan/MSR Module is installed, the 2D imager is selected.
- If no Scan Module is installed, the camera is selected.
- When the camera is selected, scanning is performed with the rear-facing camera.
- When 2D Imager is selected, scanning is performed using the installed Scan or Scan/MSR module.
Bluetooth Scanners
DataWedge supports the following Zebra Bluetooth scanners:
- RS507 Cordless Ring Scanner
- RS6000 Ring Scanner
- DS3678 Ultra-Rugged Scanner
- LI3678 Ultra-Rugged Laser Scanner
- DS2278 Bluetooth Scanner
- DS8178 Bluetooth Scanner
Bluetooth scanners are supported according to the following rules:
- To initially configure the RS507 in a Profile, the scanner must be paired and connected.
- After initial configuration, a Bluetooth scanner can be enabled and disabled in the Profile, even if it is disconnected from the device. However, to configure decoders, reader parameters and other scanner settings, a Bluetooth scanner must be connected.
- DataWedge does not automatically reconnect to a Bluetooth scanner if that scanner is connected while DataWedge is using a different auto-selected scanner. To re-enable a Bluetooth scanner, connect the scanner and select it in the Profile or re-choose the "Auto" selection option.
- Auto-selection and Battery Swap - If Scanner selection is set to Auto and an RS507 was enabled prior to a battery swap, DataWedge continues working with that RS507 scanner upon reconnection after a battery is swapped. If the RS507 does not reconnect after the swap, DataWedge reverts to the current default scanner.
- Keep Enabled on Suspend - This mode is supported on Bluetooth and pluggable scanners, and might result in faster battery drain than would otherwise be expected while in suspend mode. Note: The Zebra computing device wakes from suspend mode when pressing the scan trigger of any supported scanner.
USB SSI Scanners
DataWedge supports the following Zebra USB SSI scanners:
- DS3608 USB SSI Scanner
- LI3608 Ultra-Rugged USB SSI Laser Scanner
- RS4000 USB SSI Ring Scanner
- RS5000 USB SSI Ring Scanner
Support notes:
- The DS3608 and LI3608 scanners are supported only on VC80 devices running Android.
- Scanners must be configured using SSI over USB CDC.
- The scanner connects via USB port and cable
Important: Support for decode parameters can vary depending on the scanning device selected. For device-specific support notes, please refer to the Integrator Guide that accompanied the unit.
Hardware Trigger
This feature configures DataWedge to enable/disable use of the device hardware trigger for barcode input. The hardware trigger is enabled by default. If disabled, the scan beam does not appear when pressing the hardware trigger. However, the scan beam can still be activated by using the Soft Scan Trigger DataWedge API intent. This feature allows application programmers to enforce the use of app-specific features when scanning barcodes and documents within their app.
Note: When the hardware trigger is disabled, it cannot be used to trigger the scan beam. If scanning is initiated by the soft scan trigger API intent, a hardware trigger press cancels the beam.
Auto Switch to Default on Event
This feature configures DataWedge to select an external scanner as the default scanning device immediately upon connection and revert to a built-in scanner when the external scanner is disconnected. External scanners include those connecting by Bluetooth, serial cable or snap-on module. If enabled, SWITCH_SCANNER should not be used upon scanner connection/disconnection as it can cause unexpected behavior. Disabled by default. Available only when “Auto" is selected in the Scanner selection panel.
This feature is intended to help reduce scanning workflow interruptions when a Bluetooth scanner is introduced and/or it becomes disconnected by losing power or moving out of range.
For Bluetooth scanners, if the device was not previously paired, a pairing barcode is displayed prior to automatic connection.
"Auto switch to default on event" is available only when "Auto" is selected.
Available Options:
- Disabled - No scanner switching occurs when an external scanner is connected or disconnected (default).
- On connect - Selects the external scanner as the default scanning device immediately upon connection.
- On disconnect - Reverts to a built-in scanner based on its position in an internally managed scanner list (which varies by host device). This is usually the scanner most recently used prior to the external connection (see notes below).
- On connect/disconnect - Selects an external scanner as the default scanning device immediately upon connection. Upon disconnection, reverts to the scanner set as the default prior to the external connection.
Notes:
- The system selects the default scanner based on the connection state and the scanner's position in an internally managed scanner list. If the newly connected scanner is lower in the scanner list than the one currently selected as the default scanner, the newly connected scanner becomes the default scanner.
- On devices with only one built-in scanner or imager, "On disconnect" reverts to that built-in scanner or imager.
Global Scanner Configuration
Global scanner configuration allows users to specify a generic scanner configuration applicable for all supported scanners. Rather than specifying multiple individual configurations for each separate scanner within a given DataWedge profile, the global configuration setting is provided to configure multiple scanners in a single profile.
Global scanner configuration displays all scanner parameters and values for each and every scanner even if not supported by a specific scanner. Since this list is all-inclusive, there is a possibility a particular parameter or value may not be supported on an individual scanner. In this case, an error is logged in logcat during scanning.
When global scanner configuration is enabled, access is still available to settings specific to individual scanners, such as the option “Keep enabled on suspend” (which specifically applies to Bluetooth and other peripheral scanners), even if the default scanner is selected as an internal scanner for “Scanner Selection” (See Figure 1). When applying configurations, if any of the global settings are not applicable to the specific scanner, those settings cannot apply and will be disregarded.
When a global setting is configured and then an individual scanner is configured, both configuration options are saved. The configurations will be applied in the following order:
- The global configuration is applied.
- The specific scanner configuration is applied.
If reports are generated when the global scanner configuration is set, the values supported by the connected device will be returned.
Configuration
Open a profile in DataWedge. The "Barcode input" section contains the option "Configure scanner settings".
Note: The “Configure scanner settings” option is still accessible even when the selected scanner in “Scanner Selection” is disconnected. In previous DataWedge versions prior to 6.8, all the scanner parameters (decoders, decoder params, etc.) are grayed-out and inaccessible.
Profile settings
Tap "Configure scanner settings". A list of scanner configuration settings appears.
Scanner configuration
Tap "Select scanner to set parameters". All Scanners option is available to allow the scanner settings to apply to all scanners.
Global scanner configuration
Select All Scanners. A confirmation message appears indicating that any setting changes moving forward will be applicable to all scanners as a common global configuration. Any existing individual scanner setting will be replaced by this global setting. The scanner does not need to be connected to the device in order to configure the settings in the global scanner configuration.
Using Intents
Set the global scanner configuration by setting the value of parameter configure_all_scanners
to "true" via SET_CONFIG intent API.
Decoder Selection
Many input methods include parameters that are configurable according to the expected scan targets and/or preferences of an organization. Enabling a narrow selection of decoders can help increase security, reduce decode errors and improve scan performance. For example, a company that routinely receives packages encoded with Code 128 symbology might consider limiting the Code 128 decoders it implements to those of the non-EAN variety.
Parameters for individual Decoders are modified within a Profile. Each DataWedge Profile can be assigned a unique group of Decoders and Decoder parameters (where applicable) to use with its associated application(s). This guide covers the selection of Decoders and provides details for those with configurable parameters.
Default Decoders
DataWedge decodes all major barcode symbologies. Popular formats are enabled by default in all DataWedge Profiles (indicated by an *). To improve scanning performance, Zebra recommends disabling all Decoders not required by the app(s) associated with a given Profile.
Note:
- Decoders lacking configurable parameters do not appear in the Decoder Parameters section. Others are linked to their corresponding parameter descriptions.
- Only "Australian Postal" or "Canadian Postal" should be selected as a decoder, not both. If both are simultaneously selected as decoders, only "Canadian Postal" barcodes are decoded.
Australian Postal |
Aztec* |
Canadian Postal |
Chinese 2of5 |
||
Code 32* |
||
Datamatrix* |
||
EAN-13* |
Finnish Postal 4S |
GS1 DataBar |
GS1 DataBar Limited |
GS1 DataBar Expanded |
|
Japanese Postal |
||
MacroPDF* |
MAILMARK |
|
Maxicode* |
MICR E13B |
|
MicroQR |
MacroMicroPDF* |
|
PDF417* |
||
QR Code* |
TLC 39* |
|
US Currency |
||
US Postal |
UPC-A* |
|
US4state FICS |
US4state |
* Enabled by default
Note: Hyperlinked decoders indicate (and link to) configurable parameters.
Enable/Disable Decoders
To enable or disable Decoders:
1. From the Profile being edited, tap Configure scanner settings then tap Decoders as highlighted below.
A list of Decoders appears similar to the image in Step 2.
2. Select/deselect the desired Decoders by checking/unchecking the corresponding checkbox.
Note: Reducing nonessential Decoders can improve scanning performance.
Edit Decoder Parameters
To edit Decoder parameters:
1. From the Profile being edited, tap Decoder params as highlighted below.
A list of Decoders appears similar to the image in Step 2, below.
2. From the Decoder list, tap a Decoder to edit its parameters.
Decoder Parameters
Editable parameters of individual Decoders are explained below. Note: Decoders lacking configurable parameters do not appear in the Decoder Parameters section below. For further instructions about creating and editing DataWedge Profiles, see "Manage Profiles" guide.
Reduced Quiet Zone
The quiet zone is the blank space on either side of a bar code that indicates where the symbology begins and ends, and is intended to prevent the reader from scanning irrelevant information. When marginless decoders are used with Reduced Quiet Zone Level reader parameters, the decoders behave according to the following table:
Descriptions of the 1D Quiet Zone Levels shown above are in the Reader Params section along with important warnings.
UPCE0
Report Check Digit - The check digit is the last character of the symbol used to verify the integrity of the data. Enables or disables this option. A check in the checkbox indicates that the option is enabled.
Preamble - Preamble characters are part of the UPC symbol consisting of Country Code and System Character. There are three options for transmitting a UPCE0 preamble:
Preamble Sys Char - Transmit System Character only.
Preamble Country and Sys Char - Transmit System Character and Country Code ("0" for USA).
Preamble None - Transmit no preamble.
Select the appropriate option to match the host system.
Convert UPCE0 To UPCA - Enable to convert UPCE0 (zero suppressed) decoded data to UPC-A format before transmission. After conversion, the data follows UPC-A format and is affected by UPC-A programming selections. Disable to transmit UPCE0 decoded data as UPCE0 data, without conversion (default - disabled).
UPCE1
Report Check Digit - The check digit is the last character of the symbol used to verify the integrity of the data. Enables or disables this option. A check in the checkbox indicates that the option is enabled.
Preamble - Preamble characters are part of the UPC symbol consisting of Country Code and System Character. There are three options for transmitting a UPCE1 preamble:
Preamble Sys Char - Transmit System Character only.
Preamble Country and Sys Char - Transmit System Character and Country Code ("0" for USA).
Preamble None - Transmit no preamble.
Select the appropriate option to match the host system.
Convert UPCE1 To UPCA - Enable this to convert UPCE1 decoded data to UPC-A format before transmission. After conversion, the data follows UPC-A format and is affected by UPC-A programming selections. Disable this to transmit UPCE1 decoded data as UPCE1 data, without conversion.
UPCA
Report Check Digit - The check digit is the last character of the symbol used to verify the integrity of the data. Enables or disables this option. A check in the checkbox indicates that the option is enabled.
Preamble - Preamble characters are part of the UPC symbol consisting of Country Code and System Character. There are three options for transmitting a UPCA preamble:
Preamble Sys Char - Transmit System Character only.
Preamble Country and Sys Char - Transmit System Character and Country Code ("0" for USA).
Preamble None - Transmit no preamble.
Select the appropriate option to match the host system.
MSI
Length1* - To decode an MSI symbol with a specific length range, set this value to the lower limit. For example, to decode MSI symbols containing between 4 and 12 characters, this value would be set to 4.
Length2* - To decode an MSI symbol with a specific length range, set this value to the upper limit. For example, to decode MSI symbols containing between 4 and 12 characters, this value would be set to 12.
* See Decode Lengths section, below
Redundancy - Sets the reader to read the barcode twice before accepting data.
Check Digit - With MSI symbols, one check digit is required, and is always verified by the reader. The second check digit is optional.
- One Check Digit - Verify one check digit.
- Two Check Digits - Verify two check digits.
Check Digit Scheme - Two algorithms are possible for the verification of the second MSI check digit. Select the algorithm used to encode the check digit:
- Mod-11-10 - First check digit is MOD 11; the second check digit is MOD 10.
- Mod-10-10 - Both check digits are MOD 10.
Report Check Digit - Transmit MSI data with or without the check digit. A check in this checkbox will send MSI data with a check digit.
EAN8
Convert EAN8 To EAN13 - Converts EAN8 data to EAN 13 format. A check in the checkbox enables this conversion.
Codabar
Length1* - To decode a Codabar symbol with a specific length range, set this value to the lower limit. For example, to decode Codabar symbols containing between 8 and 24 characters, this value would be set to 8.
Length2* - To decode a Codabar symbol with a specific length range, set this value to the upper limit. For example, to decode Codabar symbols containing between 8 and 24 characters, this value would be set to 24.
* See Decode Lengths section, below
Redundancy - Sets the reader to read the barcode twice before accepting data.
Clsi Editing - Enable this parameter to strip the start and stop characters and insert a space after the first, fifth, and tenth characters of a 14-character Codabar symbol. Enable this feature if the host system requires this data format.
Notis Editing - Enable this parameter to strip the start and stop characters from a decoded Codabar symbol. Enable this feature if the host system requires this data format.
Code39
Length1* - To decode a Code 39 symbol with a specific length range, set this value to the lower limit. For example, to decode Code 39 symbols containing between 8 and 24 characters, this value would be set to 8.
Length2* - To decode a Code 39 symbol with a specific length range set this value to the upper limit. For example, to decode Code 39 symbols containing between 8 and 24 characters, this value would be set to 24.
* See Decode Lengths section, below
Verify Check Digit - Enable this feature to check the integrity of all Code 39 symbols to verify that the data complies with a specified check digit algorithm. The digital scanner decodes only those Code 39 symbols that include a modulo 43 check digit. Enable this feature only if the Code 39 symbols contain a modulo 43 check digit.
Report Check Digit - Transmit Code 39 data with or without the check digit. A check in the checkbox will send Code 39 data with a check digit.
Full ASCII - Code 39 Full ASCII is a variant of Code 39 that pairs characters to encode the full ASCII character set. Check this checkbox to enable Code 39 Full ASCII.
Redundancy - Sets the reader to read the barcode twice before accepting data.
Convert Code39 To Code32 - Code 32 is a variant of Code 39 used by the Italian pharmaceutical industry.
Report Code32 Prefix - Enables the addition of the prefix character "A" to all Code 32 barcodes.
Security Level - Options: Security level 0, Security Level 1, Security Level 2 and Security Level 3.
Discrete 2of5
Length1* - To decode a Discrete 2of5 symbol with a specific length range, set this value to the lower limit. For example, to decode Discrete 2of5 symbols containing between 4 and 12 characters, this value would be set to 4.
Length2* - To decode a Discrete 2of5 symbol with a specific length range, set this value to the upper limit. For example, to decode Discrete 2of5 symbols containing between 4 and 12 characters, this value would be set to 12.
* See Decode Lengths section, below
Redundancy - Sets the reader to read the barcode twice before accepting data.
DotCode
Inverse - To specify the reflectance for decoding DotCode barcodes, set the option:
- Disabled (0) - To decode DotCode barcodes with normal reflectance only.
- Enabled (1) - To decode DotCode barcodes with inverse reflectance only.
- Auto (2) - To decode both normal and inverse reflectance DotCode barcodes (default).
Mirror - To specify whether mirrored DotCode barcodes are decoded, set an option:
- Disabled (0) - To decode non-mirrored DotCode barcodes only.
- Enabled (1) - To decode mirrored DotCode barcodes only.
- Auto (2) - To decode both mirrored and non-mirrored DotCode barcodes (default).
Dutch Postal
Dutch Postal 3S - To enable/disable decoding of KIX 3S barcodes of type Dutch Postal.
Interleaved 2 of 5
Length1* - To decode an Interleaved 2 of 5 symbol with a specific length range, set this value to the lower limit. For example, to decode Interleaved 2 of 5 symbols containing between 4 and 12 characters, this value would be set to 4.
Length2* - To decode an Interleaved 2 of 5 symbol with a specific length range, set this value to the upper limit. For example, to decode Interleaved 2 of 5 symbols containing between 4 and 12 characters, this value would be set to 12.
* See Decode Lengths section, below
Redundancy - Sets the reader to read the barcode twice before accepting data.
Febraban - Enable or disable insertion of special check characters into the transmitted data stream of Interleaved 2 of 5 barcodes that are of length 14 characters and meet specific Febraban criteria.
Check Digit
No Check Digit - A check digit is not used.
USS Check Digit - Select to check the integrity of all Interleaved 2 of 5 symbols to verify the data complies with the Uniform Symbology Specification (USS) check digit algorithm.
OPCC Check Digit - Select to check the integrity of all Interleaved 2 of 5 symbols to verify the data complies with the Optical Product Code Council (OPCC) check digit algorithm.
Report Check Digit - Transmit Interleaved 2 of 5 data with or without the check digit. A check in the checkbox sends Interleaved 2 of 5 data with check digit.
Convert ITF-14 To EAN13 - Convert 14-character Interleaved 2 of 5 barcodes to EAN-13, and transmit as EAN-13. The Interleaved 2 of 5 barcode must be enabled and must have a leading zero and a valid EAN-13 check digit.
Code11
Length1* - To decode a Code 11 symbol with a specific length range, set this value to the lower limit. For example, to decode Code 11 symbols containing between 4 and 12 characters, this value would be set to 4.
Length2* - To decode a Code 11 symbol with a specific length range, set this value to the upper limit. For example, to decode Code 11 symbols containing between 4 and 12 characters, this value would be set to 12.
* See Decode Lengths section, below
Redundancy - Sets the reader to read the barcode twice before accepting data.
Verify Check Digit - Check the integrity of all Code 11 symbols to verify that the data complies with the specified check digit algorithm. This selects the check digit mechanism for the decoded Code 11 barcode.
No Check Digit - Do not verify check digit.
One Check Digit - Barcode contains one check digit.
Two Check Digits - Barcode contains two check digits.
Report Check Digit - Transmit Code 11 data with or without the check digit. A check in the checkbox sends Code 11 data with a check digit.
Code93
Length1* - To decode a Code 93 symbol with a specific length range, set this value to the lower limit. For example, to decode Code 93 symbols containing between 4 and 12 characters, this value would be set to 4.
Length2* - To decode a Code 93 symbol with a specific length range, set this value to the upper limit. For example, to decode Code 93 symbols containing between 4 and 12 characters, this value would be set to 12.
* See Decode Lengths section, below
Redundancy - Sets the reader to read the barcode twice before accepting data.
Code128
Length1* - To decode a Code 128 symbol with a specific length range, set this value to the lower limit. For example, to decode Code 128 symbols containing between 4 and 12 characters, this value would be set to 4.
Length2* - To decode a Code 128 symbol with a specific length range, set this value to the upper limit. For example, to decode Code 128 symbols containing between 4 and 12 characters, this value would be set to 12.
* See Decode Lengths section, below
Redundancy - Sets the reader to read the barcode twice before accepting data.
Enable EAN128 - Set the EAN128 subtype. A check in the checkbox indicates that the option is enabled for this label type.
Enable ISBT128 - Set the ISBT128 subtype. A check in the checkbox indicates that the option is enabled.
Enable Plain Code128 - Enables other (non-EAN or ISBT) Code 128 subtypes.
ISBT128 Concat Mode - Select an option for concatenating pairs of ISBT code types:
Concat Mode Never - Do not concatenate pairs of ISBT codes encountered.
Concat Mode Always - There must be two ISBT codes in order to decode and perform concatenation. Does not decode single ISBT symbols.
Concat Mode Auto - Decodes and concatenates pairs of ISBT codes immediately. If only a single ISBT symbol is present, the device must decode the symbol the number of times set via Redundancy - Code128 before transmitting its data to confirm that there is no additional ISBT symbol.
Check ISBT Table - The ISBT specification includes a table that lists several types of ISBT barcodes that are commonly used in pairs. If ISBT128 Concat Mode is set, enable "Check ISBT Table" to concatenate only those pairs found in this table. Other types of ISBT codes are not concatenated.
Security Level - The scanner offers four levels of decode security for Code 128 barcodes. As the quality of barcodes decreases, implementing an increased level of security will compensate and help improve decoding success. There is an inverse relationship between scanner aggressiveness and security. Zebra recommends choosing carefully the level of security necessary for any given application:
Security Level 0 - This setting allows the scanner to operate in its most aggressive state, while providing sufficient security in decoding most "in-spec" barcodes.
Security Level 1 - This setting eliminates most decode failures.
Security Level 2 - Select this option if Security level 1 fails to eliminate decode failures.
Security Level 3 - If Security Level 2 is selected and decode failures still occur, select this security level. Be advised, selecting this option is an extreme measure against mis-decoding severely out-of-spec barcodes. Selecting this security level significantly impairs the decoding ability of the scanner. If this level of security is required, try to improve the quality of the barcodes.
Grid Matrix
Inverse - To specify the reflectance for decoding Grid Matrix barcodes, set the option:
- Disabled (0) - To decode Grid Matrix barcodes with normal reflectance only (default).
- Enabled (1) - To decode Grid Matrix barcodes with inverse reflectance only.
- Auto (2) - To decode both normal and inverse reflectance Grid Matrix barcodes.
Mirror - To specify whether mirrored Grid Matrix barcodes are decoded, set an option:
- Disabled (0) - To decode non-mirrored Grid Matrix barcodes only (default).
- Enabled (1) - To decode mirrored Grid Matrix barcodes only.
- Auto (2) - To decode both mirrored and non-mirrored Grid Matrix barcodes.
GS1 Datamatrix
The following table depicts the decode behavior between Datamatrix and GS1 Datamatrix:
Can Decode | Type | Can Decode | Type | ||
Enabled | Enabled | Yes | LABEL-TYPE-DATAMATRIX | Yes | LABEL-TYPE-GS1-DATAMATRIX |
Enabled | Disabled | Yes | LABEL-TYPE-DATAMATRIX | Yes | LABEL-TYPE-DATAMATRIX |
Disabled | Enabled | No | [none] | Yes | LABEL-TYPE-GS1-DATAMATRIX |
Disabled | Disabled | No | [none] | No | [none] |
Notes:
- The blue shaded row indicates a successful decode for label types reported as Datamatrix although GS1 Datamatrix is disabled.
GS1 QR Code
The following table depicts the decode behavior between QR Code and GS1 QR Code:
Can Decode | Type | Can Decode | Type | ||
Enabled | Enabled | Yes | LABEL-TYPE-QRCODE | Yes | LABEL-TYPE-GS1-QRCODE |
Enabled | Disabled | Yes | LABEL-TYPE-QRCODE | Yes | LABEL-TYPE-QRCODE |
Disabled | Enabled | No | [none] | Yes | LABEL-TYPE-GS1-QRCODE |
Disabled | Disabled | No | [none] | No | [none] |
Notes:
- The blue shaded row indicates a successful decode for label types reported as QR Code although GS1 QR Code is disabled.
Trioptic39
Redundancy - Sets the reader to read the barcode twice before accepting data.
HAN XIN
HAN XIN Inverse - Checks the inverse of the HanXin decoder.
Matrix 2of5
Length1* - Used to set decode length.
Length2* - Used to set decode length.
Redundancy - Sets the reader to read the bar code twice before accepting data.
Report Check Digit - Transmit Matrix 2of5 data with or without the check digit.
Verify Check Digit - Enable this feature to check the integrity of all Matrix 2of5 symbols to verify that the data complies with a specified check digit algorithm.
* See Decode Lengths section, below
MicroPDF
Code 128 Emulation - Enable this option to transmit data from certain MicroPDF417 symbols as Code 128. This option requires that the AIM Code ID Character be enabled.
Enable Code 128 Emulation to transmit these MicroPDF417 symbols with one of the following prefixes:
]C1 if the first codeword is 903, 904 or 905
]C2 if the first codeword is 908 or 909
]C0 if the first codeword is 910 or 911
Disable Code 128 Emulation to transmit these MicroPDF417 symbols with one of the following prefixes:
]L3 if the first codeword is 903, 904 or 905
]L4 if the first codeword is 908 or 909
]L5 if the first codeword is 910 or 911.
Composite AB
UCC Link Mode:
Link Flag ignored
Always Linked
Auto Discriminate
MultiPacket Mode:
Multi-Part, Single-Packet
Mutli Independent Reads
Use UPC Preamble Check Digit - Use the UPC rules specified in the UPC-EAN parameters when reporting composite decode data.
Composite C
MultiPacket Mode:
Multi-Part, Single-Packet
Mutli Independent Reads
Korean 3of5
Length1* - To decode a Korean 3 of 5 symbol with a specific length range, set this value to the lower limit. For example, to decode Korean 3 of 5 symbols containing between 4 and 12 characters, this value would be set to 4.
Length2* - To decode a Korean 3 of 5 symbol with a specific length range, set this value to the upper limit. For example, to decode Korean 3 of 5 symbols containing between 4 and 12 characters, this value would be set to 12.
* See Decode Lengths section, below
Redundancy - Sets the reader to read the barcode twice before accepting data.
Decoder Signature
Decoder Signature is a special barcode format that allows to capture an area of a document (such as a signature) as an image. It is marked by two identical bar patterns placed on either side of the capture area. The bar pattern extends the full height of that area, for example:
For help creating a Signature Capture barcode like the one above, refer to the Decoder Signature Guide (pdf)
Format - Specify the desired output image format: JPEG, BMP, TIFF.
Width - Specify the desired output image width in number of pixels. The aspect ratio of Width to Height must match the aspect ratio of the signature capture barcode to avoid distortion in the captured image.
Height - Specify the desired output image height in number of pixels. The aspect ratio of Width to Height must match the aspect ratio of the signature capture barcode to avoid distortion in the captured image.
JPEG Quality - An integer value between 5 and 100 with increments of 5, with 100 representing the highest quality image and 5 representing the most optimized for image size.
Bits per pixel - Specify the color depth of the output image. This is not applicable to JPEG image formats. Possible values:
- 0 - 1 BPP (2 levels)
- 1 - 4 BPP (16 levels)
- 2 - 8 BPP (256 levels)
Note: Handling large image data - Since the data size of a single image (which can be 1280 x 800 bytes = 1000 kb) can exceed the size limit of a single intent, DataWedge supports image data delivery via Android FileProvider API. For Decoder Signature type decodes, all image data are delivered using this approach.
It is expected that the user application copy the image files from the given URI (Uniform Resource Identifier) as soon as possible since DataWedge only keeps a maximum of 2 sets of decoded images before deleting them to create new images in the internal memory.
Refer to the Signature Capture sample application for a code sample on handling image data from an Android client app.
OCR A
OCR A Variant - Font variants supported:
- Full ASCII - !"#$()*+,-./0123456789<>ABCDEFGHIJKLMNOPQRSTUVWXYZ\^
- Reserved 1 - $*+-./0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ
- Reserved 2 - $*+-./0123456789<>ABCDEFGHIJKLMNOPQRSTUVWXYZ
- Banking - -0123456789<>
OCR B
OCR B Variant - Font variants supported:
- Full ASCII - !#$%()*+,-./0123456789<>ABCDEFGHIJKLMNOPQRSTUVWXYZ^|Ñ
- Banking - #+-0123456789<>JNP|
- Limited - +,-./0123456789<>ACENPSTVX
- ISBN 1 - 10-Digit Book Numbers (-0123456789>BCEINPSXz)
- ISBN 2 - 10 or 13-Digit Book Numbers (-0123456789>BCEINPSXz)
- Travel Document 1 - Travel Document Version 1 (TD1) 3-Line ID Cards (-0123456789
- Travel Document 2 - Travel Document Version 2 (TD2) 2-Line ID Cards (-0123456789
- Travel Document 3 - Travel Document 2 or 3-Line ID Cards Auto-Detect (!#$%()*+,-./0123456789<>ABCDEFGHIJKLMNOPQRSTUVWXYZ^|Ñ)
- Passport - 0123456789
- Visa Type A - 0123456789
- Visa Type B - 0123456789
- ICAO Travel Documents - This allows reading either TD1, TD2, Passport, Visa Type A, or Visa Type B without switching between these options. It automatically recognizes the travel document read.
UK Postal
Report Check Digit - Transmit UK Postal data with or without the check digit. A check in the checkbox sends UK Postal data with a check digit.
USPlanet
Report Check Digit - Transmit USPlanet data with or without the check digit. A check in the checkbox sends USPlanet data with a check digit.
USPostnet
Report Check Digit - Transmit USPostnet data with or without the check digit. A check in the checkbox sends USPostnet data with a check digit.
Webcode
Webcode Subtype - Enables decoding of the GT Webcode subtype. A check in the checkbox enables this option.
Decode Lengths
The allowable decode lengths are specified by Length1 and Length2 as follows:
- Variable length - Decode symbols containing any number of characters:
- Set both Length1 and Length2 to "0" (zero)
- Range - Decode a symbol with a specific length range from a-b:
- Set Length1 to "a" (the lower bound) and set Length2 to "b" (the upper bound)
- Two Discrete Lengths - Decode only symbols containing either of two specific lengths:
- Set Length2 as the shorter length and Length1 as the longer one
- One Discrete Length - Decode only symbols containing a specific length:
- Set both Length1 and Length2 to the desired (non-zero) length
UPC/EAN Params
The UPC/EAN Parameter allows configuration of parameters that apply to more than one UPC or EAN decoder.
Security Level - The scanner offers four levels of decode security for UPC/EAN barcodes. As the quality of barcodes decreases, implementing an increased level of security will compensate and help improve decoding success. There is an inverse relationship between scanner aggressiveness and security. Zebra recommends choosing carefully the level of security necessary for any given application:
Level 0 - This setting allows the scanner to operate fastest, while providing sufficient security in decoding "in-spec" UPC/EAN barcodes.
Level 1 - As barcode quality levels diminish, certain characters become prone to decode failures before others (i.e., 1, 2, 7, 8). If the scanner is decode failures poorly printed barcodes, and the decode failures are limited to these characters, select this security level.
Level 2 - If the scanner fails to decode poorly printed barcodes, and the decode failures are not limited to characters 1, 2, 7, and 8, select this security level.
Level 3 - If the scanner is still fails to decode, select this security level. Be advised, selecting this option is an extreme measure against decode failures for severely out-of-spec barcodes. Selecting this level of security can significantly impair the decoding ability of the scanner. If this level of security is required, try to improve the quality of the barcodes.
Supplemental2 - A check in the checkbox enables this option.
Supplemental5 - A check in the checkbox enables this option.
Supplemental Mode
No Supplementals - The scanner is presented with a UPC/EAN plus supplemental symbol, the scanner decodes UPC/EAN and ignores the supplemental characters.
Supplemental Always - The scanner decodes only UPC/EAN symbols with supplemental characters, and ignores symbols without supplementals.
Supplemental Auto - The scanner decodes UPC/EAN symbols with supplemental characters immediately. If the symbol does not have a supplemental, the scanner must decode the barcode the number of times set via UPC/EAN Supplemental Redundancy before transmitting its data to confirm that there is no supplemental.
Supplemental Smart - Enables smart supplementals. In this mode, the decoder returns the decoded value of the main block immediately unless it belongs to one of the following supplemental types:
- 378
- 379
- 977
- 978
- 979
- 414
- 419
- 434
- 439
If the barcode is preceded by one of the prefixes above, the image is searched more aggressively for a supplemental and attempts to scan it. If the supplemental scanning fails, only the main barcode is returned.
Supplemental 378-379 - Enables (auto-discriminate) supplemental for UPC/EAN codes starting with 378 or 379. Disables reading of supplementals for any other UPC/EAN barcode not starting with 378 or 379. Tries to scan the supplemental if present. If the supplemental scanning fails, only the main barcode is returned.
Supplemental 978-979 - Enables (auto-discriminate) supplemental for UPC/EAN codes starting with 978 or 979. Disables reading of supplementals for another UPC/EAN barcode not starting with 978 or 979. Tries to scan the supplemental if present. If the supplemental scanning fails, only then the main barcode is returned.
Supplemental 414-419-434-439 - Enables (auto-discriminate) supplemental for UPC/EAN codes starting with 414, 419, 434 or 439. Disables reading of supplementals for another UPC/EAN barcode not starting with 414, 419, 434 or 439. Tries to scan the supplemental if present. If the supplemental scanning fails, only the main barcode is returned.
Supplemental 977 - Enables (auto-discriminate) supplemental for UPC/EAN codes starting with 977. Disables reading of supplementals for another UPC/EAN barcode not starting with 977. Tries to scan the supplemental if present. If the supplemental scanning fails, only the main barcode is returned.
Retry Count - Retry count for auto-discriminating for supplementals. Possible values are 2 to 20. Note that this flag is only considered if Supplemental Mode is set to one of the following values: Supplementals Auto, Supplementals Smart, Supplementals 378-379, Supplementals 978-979, Supplementals 977 or Supplementals 414-419-434-439 (2 to 20).
Random Check Digit - Enables random weight check digit verification.
Linear Decode - Not in use. Deprecated.
Coupon - Enables Coupon code decoding. To successfully decode any Coupon codes, all appropriate decoders must be enabled.
Bookland - When enabled, select a Bookland Format from the list below.
Bookland Format - When Bookland is enabled, permits selection of an option for Bookland data:
Format ISBN-10 - The scanner reports Bookland data starting with 978 in traditional 10-digit format with the special Bookland check digit for backward-compatibility. Data starting with 979 is not considered Bookland in this mode.
Format ISBN-13 - The scanner reports Bookland data (starting with either 978 or 979) as EAN-13 in 13-digit format to meet the 2007 ISBN-13 protocol.
Convert GS1 To UPC EAN - If this is set it converts GS1 barcodes to UPC/EAN format. For this setting to work UPC/EAN symbologies must be enabled. A check in the checkbox indicates that the option is enabled.
Reader Params
Reader Parameters control specific configuration options for the barcode reader selected in the Profile being edited. Not all parameters will apply to all readers.
Presentation mode parameters - Sets the sensitivity level in reaction to movement within the scanner field of view during the scanning session to automatically activate the scanner when movement is detected. Used when Presentation Mode is selected for Aim Type.
- Sensitivity - Sets the sensitivity level.
- High - Scanning is activated with high sensivity to movement in the scanner field of view (default). Any slight movement in the field of view can activate the scanner.
- Medium - Scanning is activated with medium sensivity to movement in the scanner field of view.
- Low - Scanning is activated with low sensivity to movement in the scanner field of view. Fast movement in the field of view does not activate the scanner.
1D Quiet Zone Level - Sets the effort at which the decoder will attempt to decode "marginless" barcodes. Behavior of these levels will vary based on the marginless decoder selected. See the Reduced Quiet Zone table for behaviors:
Level 0 - The decoder will perform margin decoding as usual.
Level 1 - The decoder will perform more aggressively.
Level 2 - The decoder requires only one side end of barcode.
Level 3 - The decoder can decode anything.
Note: Higher marginless levels will increase decoding times and the risk of decoding errors. Zebra recommends enabling only the symbologies that require a higher marginless level and leaving all other symbologies at the default level of 1.
Aim Mode - Turns aim pattern on and off.
Aim Timer - Sets the duration (in ms) for timed aim modes. Supports a range from 0 - 60,000 ms in increments of 100 ms.
Aim Type - Permits selection of reader behavior when the trigger is pressed:
Trigger - For each trigger press, a single barcode can be scanned.
Timed Hold – Once trigger is pressed, an aiming session is started for a time specified by Aim Timer. When this time expires, a decode session is started and scan beam will be visible. The decode session will remain active until the Beam Timer expires, the trigger is released or a barcode is decoded.
Timed Release - Once the trigger is pressed, an aiming session is started and will continue until the trigger is released. If the Aim Timer is expired when the trigger is released, a decode session will be started with scan beam visible for a remaining time equal to Beam Timer or a barcode is decoded.
Press and Release - The scan beam starts when the trigger is pressed and released. The decode session will remain active until the Beam Timer expires or a barcode is decoded.
Presentation - Automatically activates the scanner and starts scanning immediately when a barcode is presented in its field of view, without any trigger press.
Continuous Read - A press and hold of the scan trigger continuously scans barcodes. The same barcode can be scanned multiple times. Not supported with the Zebra RS507 Bluetooth Ring Scanner.
Press and Sustain - Starts the scan beam when the trigger is pressed and continues the decode session until the Beam Timer is expired, barcode is decoded or read is canceled. Scan beam is not stopped when the trigger is released. This avoids unexpected cancellations of a read by subsequently pressing the trigger button of the device; subsequent trigger presses while the beam is ON have no effect. Applies to internal imager on TC20/TC25 and RS6000/RS507 Bluetooth scanners connected to TC57/TC77 and PS20 devices.
DPM Illumination Control - Controls illumination for DPM barcodes:
- Direct Illumination - Scanner uses only direct (white) illumination. Recommended for use with dot peen barcodes - tilt the part 30 degrees for optimal decoding.
- Indirect Illumination - Scanner uses only red illumination. Recommended for use with laser etched barcodes on cylinders or curved, rough, grainy, highly reflective, or visibly machined surfaces.
- Cycle Illumination - Scanner cycles alternately between direct and indirect illumination. The scanner starts with the illumination used during the last successful decode.
DPM Mode - Mode to optimize DPM barcode decoding performance based on barcode size (Default value is Mode 2):
- Disabled - No special processing.
- DPM Mode 1 - Optimizes decoding performance for smaller DPM barcodes, typically found on electronics and medical instruments, especially on smooth surfaces. These barcodes tend to be laser etched or direct printed.
- DPM Mode 2 - Optimizes decoding performance for larger DPM barcodes, typically found on industrial parts, especially on rough, grainy or visibly machined surface. These barcodes tend to be dot peen or laser etched.
Illumination Brightness - Adjusts the brightness for the scanning session. Integer values: 0 - 10.
- Low (0) - Low intensity illumination during scanning session.
- High (10) - Maximum intensity illumination during scanning session (default).
Illumination mode - Turns illumination on and off.
Inverse 1D Mode - Permits option selection for inverse 1D barcode decoding:
Disabled - Disables decoding of inverse 1D symbologies.
Enabled - Enables decoding of inverse 1D symbologies only.
Auto - Automatically detects and decodes positive and inverse 1D symbologies.
LCD Mode - Used to Enable/Disable LCD Mode, which enhances the ability of the imager to read barcodes from LCD displays such as cellphones (applies to Scan Module only). Use of LCD mode might lead to performance degradation and a blinking reticle prior to decoding.
Linear Security Level - Sets the number of times a barcode is read to confirm an accurate decode:
Security Redundancy and Length - Two times read redundancy based on redundancy flags and code length.
Security Short or Codabar - Two times read redundancy if short barcode or Codabar.
Security All Twice - Two times read redundancy for all barcodes.
Security Long and Short - Two times read redundancy for long barcodes, three times for short barcodes.
Security All Thrice - Three times read redundancy for all barcodes.
HW Engine Low Power Timeout - Time (in ms) of inactivity before scanner enters low-power mode.
Picklist - Permits selection of Picklist mode, which instructs the imager to decode only the barcode directly under the cross-hair/reticle in the viewfinder. This feature is most useful for applications in which multiple barcodes may appear in the field of view during a decode session but only one is desired for decoding.
Disable - Disables Picklist mode; any barcode within the field of view can be decoded.
Hardware Picklist - Picklist mode is enabled by sending a command to hardware. 8y6
Software Picklist - Picklist feature is handled in the software; no commands are sent to hardware.
Notes:
- Performance might vary on some devices if Hardware or Software Picklist modes are set.
- If using MultiBarcode mode, see important behavior notes below.
Poor Quality Decode Effort - Permits selection of enhancement modes for decoding barcodes of poor or degraded quality. Available options:
Effort Level 0 - Decoding performance on regular 1D and 2D barcodes is not affected.
Effort Level 1 - The scanner performance on regular 2D barcodes is impacted while decoding performance on Tesco Thailand barcode and Suppository barcode is improved.
Effort Level 2 - same as Level 1.
Effort Level 3 - same as Level 1.
Note: Same performance from Effort Level 1 to Effort Level 3.
Beam Timer - Sets the maximum amount of time (in ms) that the reader remains on. Supports a range from 0 - 60,000 ms in increments of 100 ms. A value of 0 sets the reader to stay on indefinitely.
Different Symbol Timeout - Used to prevent the scanner from decoding another symbol within a specified time interval (applicable only when Aim Type is set to Continuous Read). A value of 0 indicates that no interval is required between two successive reads.
Same Symbol Timeout - Used to prevent the scanner from decoding the same symbol within a specified time interval (applicable only when Aim Type is set to Continuous Read). A value of 0 indicates that no interval is required between two successive reads.
Digimarc Decoding - Used to enable/disable support for Digimarc, which encodes and invisibly integrates traditional barcode data onto product packaging. Supported with internal imager and rear camera. Enabled by default. More about Digimarc.
Viewfinder Mode - Permits selection of supported Viewfinder modes:
Viewfinder Enabled - Enables only the viewfinder.
Static Reticle - Enables the viewfinder and a red reticle (cross-hairs) in the center of the screen to aid in positioning the barcode for scanning. This parameter is supported only when the Camera is used for scanning.
Scanning Modes - Used to select between Single (normal), UDI and Basic MultiBarcode modes.
Zoom - Required for decoding DotCode barcodes. User needs to set Camera Zoom value to 2 on the following devices: MC33, TC51/TC56, TC70x/TC75x, VC80x, TC52/TC57, TC72/TC77, PS20. If Camera Zoom is set to any value other than 2 on these devices, it can negatively impact the decoding of specific DotCode barcodes. Parameter values: 1 - 8. Default=1.
Keep Pairing Info After Reboot - Enable/disable automatic re-connection to the connected Bluetooth scanner after device reboot. Applies only to connected Bluetooth scanners.
See Important notes below.
Character Set Configuration
Provides options to make adjustments with the decoder character set. These options are:
- Character Set Selection
- Auto Character Set Preferred Order
- Auto Character Set Failure Option
Character Set Selection - Converts the barcode data to the specified encoding type if different from the default encoding type, UTF-8. Other options are: Auto Character Set Selection, ISO-8859-1, Shift_JIS and GB18030.
- Auto Character Set Selection (Best Effort) - Decodes data in the preference order of character sets specified in the "Auto Character Set Preferred Order" list. If the data cannot be decoded based on the character sets listed, "Auto Character Set Failure Option" takes into effect. See description for each respective option for more details.
Auto Character Set Preferred Order - If "Auto Character Set Selection (Best Effort)" is selected, data is decoded in the specified preference order of the supported character sets listed: UTF-8 and GB2312. This is useful in cases where data can be decoded from more than one character set. The first character set listed which can decode the data successfully is chosen to decode the data - any other character set located lower in the list is not considered, even if the data could be successfully decoded using that character set. If DataWedge cannot find a character set from the preferred list to decode the data successfully, the character set selected in "Auto Character Set Failure Option" is used to decode the data.
Both the preferred character set list and its preference order is configurable. The order is rearranged by dragging the “hamburger-like” icon of the character set into the desired position. To delete a character set, long press on the item and the “Delete” option appears. To add a new character set, tap the “hamburger” menu at the top right corner - an option to add a character set, such as UTF-8 and GB2312, appears.
Auto Character Set Failure Option - Used to decode data if the device cannot successfully decode based on the character sets listed in the "Auto Character Set Preferred Order" list. If “None” is selected, “Null” is returned as the data string.
Scan Params
Scan Parameters allow for configuration of Code ID and scanner-specific decoding feedback options for the scanner selected in the Profile being edited.
Note: Some parameters are device-dependent.
Code ID Type - Permits the selection of a Code ID character to insert between the prefix and the decoded symbol. The Code ID character identifies the code type of a scanned barcode. This information can be useful to an application when multiple barcode types are being read. Available options:
Code ID Type None - Insert no prefix.
Code ID Type Aim - Inserts a standards-based three-character prefix.
Code ID Type Symbol - Inserts a Zebra-defined single-character prefix.
Connection Idle Time - Specifies the length of time (in seconds) for a peripheral Bluetooth scanner to remain connected until transitioning to standby mode to conserve battery power.
Decode Haptic Feedback - Enable the mobile computer to vibrate to indicate a successful decode.
Display BT Address Barcode - When enabled (default) and the selected Bluetooth scanner is being accessed while it is not connected to the mobile computer, the Bluetooth address of the mobile computer is displayed through the Bluetooth Pairing Utility for the user to scan and pair with the Bluetooth scanner. Disable this option to prevent the Bluetooth address from being displayed.
Decode Audio Feedback - Select an audio tone to play to indicate a successful decode.
Decode Screen Notification - When enabled, a translucent green screen overlay appears for 1 second upon every successful decode.
Decode Screen Notification Timer - Defines the length of time (in milliseconds) to display the screen notification upon successful decode. Timer configuration range is 500 ms to 1500 ms. Default time is 1000 ms.
Decode Screen Translucency Level - Sets the translucency of the decode notification green screen. Translucency level range is 20 to 50, in increments of 5. The higher the value, the more the translucency (visibility).
Decoding LED Notification - When enabled, causes the Red LED to flash when the scan trigger is pressed.
Decode Feedback LED Timer - Defines the length of time (in ms) to flash the Green LED to indicate a successful decode.
Beep Volume Channel - Permits selection of the volume setting to be used when playing the Decode Audio Feedback. Available options:
Ringer - Uses Ringer volume setting for audio feedback.
Music and Media - Uses Music and Media volume setting for audio feedback.
Alarms - Uses the Alarms volume setting for audio feedback.
Notification - Uses Notification volume setting for audio feedback.
Note: Not all ringtones are supported as decode tones; some ringtones might be truncated when used as a decode tone. Zebra recommends testing all selected tones before deployment.
Important: Support for decode parameters can vary depending on the scanning device selected. For device-specific support notes, please refer to the Integrator Guide that accompanied the unit.
UDI Params
The Universal Device Identifier (UDI) parameter acquires multiple barcodes simultaneously.
Support for UDI barcodes, such as GS1, HIBCC and ICCBBA, is being terminated. This feature is supported using the imager on the following devices up to Android P (version 9.x) only:
- TC51
- TC56
- TC70x
- TC75x
Tap Scanning Modes to enable UDI decoding:
When UDI scanning mode is enabled (as above)... ...the selected UDI input parameter(s) will be used.
UDI Decoding Notes
- UDI decoding is supported only on the devices listed above.
- Output of collected UDI data might require settings adjustments of the token-separation character and/or output order. See the Keystroke Output guide guide for more information.
- UDI settings can vary by geographic region. See the relevant sections of Keystroke Output, Intent Output and/or IP Output guides for more information.
MultiBarcode Params
MultiBarcode acquires multiple, unique barcodes in a single scan session and can deliver the data either immediately or after the specified number of barcodes per scan is reached. Basic MultiBarcode is enabled through Scanning Modes within Reader Params, per above.
Access to Basic MultiBarcode params
Basic MultiBarcode params:
- Instant Reporting - Enable/Disable instantaneous reporting of unique barcodes within a scanning session (duplicates are ignored). If enabled, it ignores the value of Number of barcodes per scan and immediately reports the scanned data. If disabled (default), the decoded data is returned as a single entity after reaching the specified Number of barcodes per scan.
- Number of barcodes per scan- Specify the number of unique barcodes to be decoded with each scan session before sending the scanned data. This setting does not take effect if Instant Reporting is enabled. For example, if 5 is specified, the scanner does not send the data until 5 barcodes are scanned. Default value: 5; value range: 2 to 100.
- Report Decoded Barcodes - Enable/Disable reporting of decoded barcode data in a single scan session irrespective of the specified Number of barcodes per scan. Consider the following behavior when Report Decoded Barcodes is enabled:
- If Continuous Read is also enabled, it does not work.
- If Instant Reporting is also enabled, Instant Reporting takes higher priority.
MultiBarcode Notes
- Acquired data from all barcodes is delivered as a single string when output as keystrokes. To add separators and adjust output order, see the Keystroke Output guide.
- MultiBarcode supports a maximum data size of 64 KB.
- Picklist behavior - If the Picklist parameter is set to “Disabled,” the device will attempt to scan the number of barcodes specified in the Basic MultiBarcode params screen. If the Picklist parameter is set to a value other than “Disabled," the user is expected to move the cross-hair to each barcode to be scanned. Data is returned only after the specified number of barcodes is read.
- Duplicate barcodes - If a label to be scanned contains multiple barcodes, some of which are duplicates (with the same label type and data), only one barcode from the duplicates is decoded; the remainder are ignored. If the label has two duplicate barcodes plus another two different barcodes, a maximum of three barcodes will be decoded from that form; one will be ignored as a duplicate.
- Multiple barcode types - Barcodes can be of multiple label types and still be acquired together. For example, if the specified quantity for a Multi-barcode scan is four, two barcodes can be label type Code 128 and the other two can be type Code 39.
- Barcodes in view -If the specified number of barcodes is not initially in view of the scanner, the scanner will not decode any data. If the scanner's field of view contains a number of barcodes greater than the specified quantity, the scanner will randomly decode barcode(s) until the specified number is reached. For example, if the count is set to two and eight barcodes are in the field of view, the scanner will decode the first two barcodes it sees, returning the data in random order. Data is returned only after the specified number of barcodes is read.
- If both Continuous Read and Instant Reporting parameters are enabled, Instant Reporting takes precedence over Continuous Read, which is ignored.
OCR Params
Optical character recognition (OCR) decoding is not as secure as barcode. To decrease OCR misdecodes and speed OCR reading, set an accurate OCR template and character subset, and use a check digit. Enabling OCR can slow barcode decoding. Enabling more than one OCR font could also slow OCR decoding and impact OCR decoding accuracy.
Inverse OCR - White or light words on a black or dark background. Select an option for decoding inverse OCR:
- Regular Only - Decode regular OCR (black on white) strings only.
- Inverse Only - Decode inverse OCR (white on black) strings only.
- Auto-discriminate - Decode both regular and inverse OCR strings.
OCR Check Digit Modulus - Sets the OCR module check digit calculation. The check digit is the last digit (in the right most position) in an OCR string and improves the accuracy of the collected data. The check digit is the end product of a calculation made on the incoming data. For check digit calculation, for example Modulus 10, alpha and numeric characters are assigned numeric weights. The calculation is applied to the character weights and the resulting check digit is added to the end of the data. If the incoming data does not match the check digit, the data is considered corrupt. The selected check digit option does not take effect until you set OCR Check Digit Validation.
OCR Check Digit Multiplier - Sets OCR check digit multipliers for the character positions. For check digit validation, each character in scanned data has an equivalent weight used in the check digit calculation.
OCR Check Digit Validation - Protects against scanning errors by applying a check digit validation scheme. Options:
- None - 0 (default)
- Product Add Left to Right - Each character in the scanned data is assigned a numeric value. Each digit representing a character in the scanned data is multiplied by its corresponding digit in the multiplier, and the sum of these products is computed. The check digit passes if this sum modulo Check Digit Modulus is zero.
Example: Scanned data numeric value is 132456 (check digit is 6). Check digit multiplier string is 123456
Digit 1 3 2 4 5 6
Multiplier 1 2 3 4 5 6
Product 1 6 6 16 25 36
Product add 1+ 6+ 6+ 16+ 25+ 36 = 90
If the Check Digit Modulus is 10, it passes because 90 is divisible by 10 (the remainder is zero). - Product Add Right to Left - Each character in the scanned data is assigned a numeric value.
The check digit multiplier is reversed in order. Each value representing a character in the scanned data is multiplied by its corresponding digit in the reversed multiplier, resulting in a product for each character in the scanned data. The sum of these products is computed. The check digit passes if this sum modulo Check Digit Modulus is zero.
Example: Scanned data numeric value is 132459 (check digit is 9). Check digit multiplier string is 123456.
Digit 1 3 2 4 5 9
Multiplier 6 5 4 3 2 1
Product 6 15 8 12 10 9
Product add 6+ 15+ 8+ 12+ 10+ 9 = 60
If the Check Digit Modulus is 10, it passes because 60 is divisible by 10 (the remainder is 0). - Digit Add Left to Right - Each character in the scanned data is assigned a numeric value.
Each value representing a character in the scanned data is multiplied by its corresponding digit in the multiplier, resulting in a product for each character in the scanned data. The sum of each individual digit in all of the products is then calculated. The check digit passes if this sum modulo Check Digit Modulus is zero.
Example: Scanned data numeric value is 132456 (check digit is 6). Check digit multiplier string is 123456.
Digit 1 3 2 4 5 6
Multiplier 1 2 3 4 5 6
Product 1 6 6 16 25 36
Digit add 1+ 6+ 6+ 1+6+ 2+5+ 3+6 = 36
If the Check Digit Modulus is 12, it passes because 36 is divisible by 12 (the remainder is 0). - Digit Add Right to Left - Each character in the scanned data is assigned a numeric value.
The check digit multiplier is reversed in order. Each value representing a character in the scanned data is multiplied by its corresponding digit in the reversed multiplier, resulting in a product for each character in the scanned data. The sum of each individual digit in all of the products is then calculated. The check digit passes if this sum modulo Check Digit Modulus is zero.
Example: Scanned data numeric value is 132456 (check digit is 6). Check digit multiplier string is 123456.
Digit 1 3 2 4 5 6
Multiplier 6 5 4 3 2 1
Product 6 15 8 12 10 6
Digit add 6+ 1+5+ 8+ 1+2+ 1+0+ 6 = 30
The Check Digit Modulus is 10. It passes because 30 is divisible by 10 (the remainder is 0). - Product Add Right to Left Simple Remainder - Each character in the scanned data is assigned a numeric value. The check digit multiplier is reversed in order. Each value representing a character in the scanned data is multiplied by its corresponding digit in the reversed multiplier, resulting in a product for each character in the scanned data. The sum of these products except for the check digit's product is computed. The check digit passes if this sum modulo Check Digit Modulus is equal to the check digit's product.
Example: Scanned data numeric value is 122456 (check digit is 6). Check digit multiplier string is 123456.
Digit 1 2 2 4 5 6
Multiplier 6 5 4 3 2 1
Product 6 10 8 12 10 6
Product add 6+ 10+ 8+ 12+ 10 = 46 6
The Check Digit Modulus is 10. It passes because 46 divided by 10 leaves a remainder of 6. - Digit Add Right to Left Simple Remainder - Each character in the scanned data is assigned a numeric value. The check digit multiplier is reversed in order. Each value representing a character in the scanned data is multiplied by its corresponding digit in the reversed multiplier, resulting in a product for each character in the scanned data. The sum of each individual digit in all of the products except for the check digit's product is then calculated. The check digit passes if this sum modulo Check Digit Modulus is equal to the check digit's product.
Example: Scanned data numeric value is 122459 (check digit is 6). Check digit multiplier string is 123456.
Digit 1 2 2 4 5 9
Multiplier 6 5 4 3 2 1
Product 6 10 8 12 10 9
Digit add 6+ 1+0+ 8+ 1+2+ 1+0+ = 19 9
The Check Digit Modulus is 10. It passes because 19 divided by 10 leaves a remainder of 9. - Health Industry - HIBCC43 - The health industry module 43 check digit standard. The check digit is the modulus 43 sum of all the character values in a given message, and is printed as the last character in a given message.
OCR Lines - Select the number of OCR lines to decode:
- 1 Line
- 2 Line
- 3 Line
OCR Maximum Characters - Select the maximum number of OCR characters (including spaces) per line to decode.
OCR Minimum Characters - Select the minimum number of OCR characters (not including spaces) per line to decode.
OCR Orientation - Select the orientation of an OCR string to be read. Setting an incorrect orientation can cause mis-decodes. Options:
- 0 degree - to the imaging engine (default)
- 270 degree - clockwise (or 90o counterclockwise) to the imaging engine
- 180 degree - (upside down) to the imaging engine
- 90 degree - clockwise to the imaging engine
- Omnidirectional
OCR Quiet Zone - Sets the field width of blank space to stop scanning during OCR reading.
OCR Subset - Defines a custom group of characters in place of a preset font variant. For example, if scanning only numbers and the letters A, B, and C, create a subset of just these characters to speed decoding. This applies a designated OCR Subset across all enabled OCR fonts.
OCR Template - Creates a template for precisely matching scanned OCR characters to a desired input format, which helps eliminate scanning errors. The template expression is formed by numbers and letters. The default is 99999999 which accepts any alphanumeric character OCR string. If there are less than 8 '9' characters, the '9' represents only digit values. Carefully constructing an OCR template eliminates scanning errors.
Minimum length - 3
Maximum Length - 100 (Default - 99999999)
OCR Templates and Options:
Name | Description | Template | Valid Data/ Incoming Data |
Invalid Data/ Outgoing Data |
---|---|---|---|---|
Required Digit (9) | Only a numeric character is allowed in this position. | 99999 | 12987 | 123AB |
Required Alpha (A) | Only an alpha character is allowed in this position. | AAA | ABC | 12F |
Require and Suppress (0) | Any character in this position, including space or reject, is suppressed from the output. | 990AA | 12QAB | 12AB |
Optional Alphanumeric (1) | This option accepts an alphanumeric character if present. Optional characters are not allowed as the first character(s) in a field of like characters. | 99991 | 1234A | 1234< |
Optional Alpha (2) | This option accepts an alpha character if present. Optional characters are not allowed as the first character(s) in a field of like characters. | AAAA2 | ABCDE | ABCD6 |
Alpha or Digit (3) | An alphanumeric character is required in this position to validate the incoming data. | 33333 | 12ABC | 12AB< |
Any Including Space & Reject (4) | Accepts any character in this position, including space and reject. Rejects are represented as an underscore (_) in the output. This is a good selection for troubleshooting. | 99499 | 12$34 34_98 |
|
Any except Space & Reject (5) | Accepts any character in this position except a space or reject. | 55999 | A.123 *Z456 |
A BCD |
Optional Digit (7) | Accepts a numeric character if present. Optional characters are not allowed as the first character(s) in a field of like characters. | 99977 | 12345 789 |
789AB |
Digit or Fill (8) | Accepts any numeric or fill character in this position. | 88899 | 12345 >>789 <<789 |
|
Alpha or Fill (F) | Accepts any alpha or fill character in this position. | AAAFF | ABCXY LMN>> ABC<5 |
|
Optional Space ( ) | Accepts a space if present. Optional characters are not allowed as the first characte(s) in a field of like characters. | 99 99 | 12 34 1234 |
67891 |
Optional Small Special (.) | Accepts a special character if present. Optional characters are not allowed as the first character(s) in a field of like characters. Small special characters are - , and . | AA.99 | MN.35 XY98 |
XYZ12 |
Other Template Operators - These template operators assist in capturing, delimiting, and formatting scanned OCR data | ||||
Literal String (" and +) | Use either of these delimiting characters surrounding alphanumeric characters to define a literal string within a template that must be present in scanned OCR data. There are two characters used to delimit required literal strings; if one of the delimiter characters is present in the desired literal string, use the other delimiter. | "35+BC" | 35+BC | AB+22 |
New Line (E) | To create a template of multiple lines, add E between the template of each single line. | 999EAAAA | 321 BCAD |
XYZW 12 |
String Extract (C) | This operator combined with others defines a string of characters to extract from the scanned data. The string extract is structured as follows: CbPe Where: • C is the string extract operator • b is the string begin delimiter • P is the category (one or more numeric or alpha characters) describing the string representation • e is the string end delimiter Values for b and e can be any scannable character. They are included in the output stream. |
C>A> | XQ3>ABCDE> ->ATRU>123 |
>ABCDE> >ATRU> |
Ignore to End of Field (D) | This operator causes all characters after a template to be ignored. Use this as the last character in a template expression. | 999D | 123-PED 357298 |
123 357 |
Skip Until (P1) | This operator allows skipping over characters until a specific character type or a literal string is detected. It can be used in two ways: P1ct Where: • P1 is the Skip Until operator • c is the type of character that triggers the start of output • t is one or more template characters P1"s"t Where: • P1 is the Skip Until operator • "s" is one or more literal string characters that trigger the start of output • t is one or more template characters The trigger character or literal string is included in output from a Skip Until operator, and the first character in the template should accommodate this trigger. |
P1"PN"AA9999 | 123PN9876 X-PN3592 |
PN9876 PN3592 |
Skip Until Not (P0) | This operator allows skipping over characters until a specific character type or a literal string is not matched in the output stream. It can be used in two ways: P0ct Where: • P0 is the Skip Until Not operator • c is the type of character that triggers the start of output • t is one or more template characters P0"s"t Where: • P0 is the Skip Until Not operator • "s" is one or more literal string characters that trigger the start of output • t is one or more template characters The trigger character or literal string is included in output from a Skip Until Not operator. |
P0A9999 | BPN3456 X-PN3592 |
5341 No output |
Repeat Previous (R) | This operator allows a template character to repeat one or more times, allowing the capture of variable-length scanned data. The following examples capture two required alpha characters followed by one or more required digits: | AA9R | AB3 AB3 32RM52700 |
PN12345 PN12345 No output |
Scroll Until Match (S) | This operator steps through scanned data one character at a time until the data matches the template. | S99999 | AB3 PN12345 32RM52700 |
No output 12345 52700 |
Multiple Templates | This feature sets up multiple templates for OCR decoding. For each template in the multiple template string, use a capital letter X as a separator between the templates. For example, set the OCR Template as 99999XAAAAA to decode OCR strings of either 12345 or ABCDE. |
Following are sample templates with descriptions of valid data for each definition. The Field Definition is followed by its description: "M"99977 : M followed by three digits and two optional digits. "X"997777"X" : X followed by two digits, four optional digits, and an X. 9959775599 : Two digits followed by any character, a digit, two optional digits, any two characters, and two digits. A55"-"999"-"99 : A letter followed by two characters, a dash, three digits, a dash, and two digits. 33A"."99 : Two alphanumeric characters followed by a letter, a period, and two digits. 999992991 : Five digits followed by an optional alpha, two digits, and an optional alphanumeric. "PN98" : Literal field - PN98 |
Other DataWedge Input Options:
- Mag-stripe Reader - credit/debit and identity cards
- SimulScan - document capture and multibarcode scanning
Related guides: