Page 1
ET5X
Enterprise Tablet
Integrator Guide
for Android ™ Version
6.0.1
MN-003016-03Rev. A
Page 2
Copyright
© 2017 ZIH Corp. and/or its affiliates. All rights reserved. ZEBRA and the stylized Zebra head are trademarks of
ZIH Corp., registered in many jurisdictions worldwide. All other trademarks are the property of their respective
owners.
COPYRIGHTS & TRADEMARKS: For complete copyright and trademark information, go to www.zebra.com/
copyright.
WARRANTY: For complete warranty information, go to www.zebra.com/warranty.
END USER LICENSE AGREEMENT: For complete EULA information, go to www.zebra.com/eula.
Terms of Use
• Proprietary Statement
This manual contains proprietary information of Zebra Technologies Corporation and its subsidiaries
(“Zebra Technologies”). It is intended solely for the information and use of parties operating and
maintaining the equipment described herein. Such proprietary information may not be used, reproduced,
or disclosed to any other parties for any other purpose without the express, written permission of Zebra
Technologies.
• Product Improvements
Continuous improvement of products is a policy of Zebra Technologies. All specifications and designs are
subject to change without notice.
• Liability Disclaimer
Zebra Technologies takes steps to ensure that its published Engineering specifications and manuals are
correct; however, errors do occur. Zebra Technologies reserves the right to correct any such errors and
disclaims liability resulting therefrom.
• Limitation of Liability
In no event shall Zebra Technologies or anyone else involved in the creation, production, or delivery of the
accompanying product (including hardware and software) be liable for any damages whatsoever
(including, without limitation, consequential damages including loss of business profits, business
interruption, or loss of business information) arising out of the use of, the results of use of, or inability to
use such product, even if Zebra Technologies has been advised of the possibility of such damages. Some
jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so the above
limitation or exclusion may not apply to you.
Revision History
Changes to the original guide are listed below:
Change Date Description
Rev A 7/2017 Initial release.
-02 Rev. A 12/2017 Correct SSI barcode in Accessories chapter.
-03 Rev. A 10/2019 Update cradle drawings and accessory list.
1
Page 3
Table of Contents
Copyright ........................................................................................................................................... 1
Terms of Use .................................................................................................................................... 1
Revision History ................................................................................................................................ 1
About This Guide
Introduction ....................................................................................................................................... 8
Configurations ................................................................................................................................... 8
Chapter Descriptions ........................................................................................................................ 9
Notational Conventions ..................................................................................................................... 9
Related Documents and Software .................................................................................................. 10
Service Information ......................................................................................................................... 10
Provide Documentation Feedback .................................................................................................. 10
Getting Started
Introduction ..................................................................................................................................... 11
Unpacking ....................................................................................................................................... 11
Getting Started ................................................................................................................................ 11
Installing a micro SIM Card (ET55 Only) ................................................................................... 11
Installing a microSD Card ......................................................................................................... 15
Charging the ET5X .................................................................................................................... 16
Resetting the ET5X ......................................................................................................................... 16
Accessories
Introduction ..................................................................................................................................... 18
Charge Only Cradle ........................................................................................................................ 21
Installing the Insert .................................................................................................................... 21
Charging the ET5X .................................................................................................................... 22
Communication and Charging Cradle ............................................................................................. 24
Installing the Insert .................................................................................................................... 25
Charging the ET5X .................................................................................................................... 25
Rugged Communication and Charging Cradle ............................................................................... 28
Charging the ET5X .................................................................................................................... 29
4-Slot Charge Only Cradle .............................................................................................................. 32
Insert Installation ....................................................................................................................... 32
Guide Installation ............................................................................................................................ 34
3
Page 4
Table of Contents
Battery Charger Installation ....................................................................................................... 35
Power Setup .............................................................................................................................. 36
Charging the Battery ................................................................................................................. 37
4-Slot Battery Charger .................................................................................................................... 38
Rugged Frame ................................................................................................................................ 41
Expansion Back .............................................................................................................................. 44
Installation ................................................................................................................................. 44
Configuring the SE4750 Expansion Backs ............................................................................... 46
Expansion Back Conversion Procedures ............................................................................ 46
Replacement Hand Strap .......................................................................................................... 47
Attaching the Stylus to the Expansion Back .............................................................................. 51
Removal .................................................................................................................................... 52
USB Communication
Connecting to a Host Computer via USB ........................................................................................ 55
Transferring Files using Media Transfer Protocol ..................................................................... 55
Transferring Files using Photo Transfer Protocol ...................................................................... 56
Disconnect from the Host Computer ............................................................................................... 56
DataWedge Configuration
DataWedge Configuration ............................................................................................................... 57
Basic Scanning ............................................................................................................................... 57
Profiles ............................................................................................................................................ 57
Profile0 ...................................................................................................................................... 58
Plug-ins ..................................................................................................................................... 58
Input Plug-ins ............................................................................................................................ 58
Process Plug-ins ....................................................................................................................... 58
Output Plug-ins ......................................................................................................................... 58
Profiles Screen .......................................................................................................................... 59
Profile Context Menu ................................................................................................................. 59
Options Menu ............................................................................................................................ 60
Disabling DataWedge ............................................................................................................... 60
Creating a New Profile .............................................................................................................. 61
Profile Configuration ....................................................................................................................... 61
Associating Applications ........................................................................................................... 62
Data Capture Plus ..................................................................................................................... 64
BarCode Input ........................................................................................................................... 67
Enabled ............................................................................................................................... 67
Scanner Selection ............................................................................................................... 67
Decoders ............................................................................................................................. 67
Decoder Params ................................................................................................................. 69
HAN XIN .............................................................................................................................. 72
Decode Lengths .................................................................................................................. 74
UPC EAN Params ............................................................................................................... 75
Reader Params ................................................................................................................... 77
Scan Params ....................................................................................................................... 78
Keep Enabled on Suspend ....................................................................................................... 79
Keystroke Output ...................................................................................................................... 79
Intent Output ............................................................................................................................. 80
4
Page 5
Table of Contents
Intent Overview ................................................................................................................... 81
IP Output ................................................................................................................................... 82
Usage .................................................................................................................................. 83
Using IP Output with IPWedge ............................................................................................ 84
Using IP Output without IPWedge ....................................................................................... 85
Generating Advanced Data Formatting Rules ................................................................................ 86
Configuring ADF Plug-in ................................................................................................................. 86
Creating a Rule ................................................................................................................... 87
Deleting a Rule .................................................................................................................... 87
Defining Criteria .................................................................................................................. 87
Defining an Action ..................................................................................................................... 89
Deleting a Rule .......................................................................................................................... 89
Order Rules List ........................................................................................................................ 90
Deleting an Action ..................................................................................................................... 91
ADF Example ............................................................................................................................ 92
DataWedge Settings ................................................................................................................. 94
Exporting a Configuration File ................................................................................................... 95
Importing a Configuration File ................................................................................................... 96
Exporting a Profile ..................................................................................................................... 96
Importing a Profile File .............................................................................................................. 96
Restoring DataWedge ............................................................................................................... 96
Configuration and Profile File Management .................................................................................... 97
Enterprise Folder ....................................................................................................................... 97
Auto Import ................................................................................................................................ 97
Programming Notes ........................................................................................................................ 97
Overriding Trigger Key in an Application ................................................................................... 98
Capture Data and Taking a Photo in the Same Application ...................................................... 98
Soft Scan Feature ..................................................................................................................... 98
Sample ................................................................................................................................ 98
Scanner Input Plugin ................................................................................................................. 98
Function Prototype .............................................................................................................. 99
Parameters .......................................................................................................................... 99
Return Values ..................................................................................................................... 99
Example .............................................................................................................................. 99
Comments ......................................................................................................................... 100
Enumerate Scanners .............................................................................................................. 100
Function Prototype ............................................................................................................ 100
Parameters ........................................................................................................................ 100
Return Values ................................................................................................................... 100
Example ............................................................................................................................ 101
Comments ......................................................................................................................... 101
Set Default Profile ................................................................................................................... 101
Default Profile Recap ........................................................................................................ 101
Usage Scenario ................................................................................................................. 102
Function Prototype ............................................................................................................ 102
Parameters ........................................................................................................................ 102
Return Values ................................................................................................................... 102
Example ............................................................................................................................ 103
Comments ......................................................................................................................... 103
Reset Default Profile ............................................................................................................... 104
Function Prototype ............................................................................................................ 104
5
Page 6
Table of Contents
Parameters ........................................................................................................................ 104
Return Values ................................................................................................................... 104
Example ............................................................................................................................ 104
Comments ......................................................................................................................... 104
Switch To Profile ..................................................................................................................... 105
Profiles Recap ................................................................................................................... 105
Usage Scenario ................................................................................................................. 105
Function Prototype ............................................................................................................ 105
Parameters ........................................................................................................................ 105
Return Values ................................................................................................................... 106
Example ............................................................................................................................ 106
Comments ......................................................................................................................... 106
Settings
Screen Unlock Settings ................................................................................................................. 108
Set Screen Unlock Using PIN ................................................................................................. 108
Set Screen Unlock Using Password ....................................................................................... 109
Set Screen Unlock Using Pattern ............................................................................................ 110
Passwords .................................................................................................................................... 112
Accounts ....................................................................................................................................... 112
Language Usage ........................................................................................................................... 112
Changing the Language Setting .............................................................................................. 112
Adding Words to the Dictionary ............................................................................................... 113
Keyboard Settings ......................................................................................................................... 113
About Tablet .................................................................................................................................. 113
Application Deployment
Security ......................................................................................................................................... 115
Secure Certificates ........................................................................................................................ 115
Installing a Secure Certificate ....................................................................................................... 115
Development Tools ....................................................................................................................... 116
Android .................................................................................................................................... 116
EMDK for Android ................................................................................................................... 117
StageNow ................................................................................................................................ 117
ADB USB Setup ............................................................................................................................ 117
Application Installation .................................................................................................................. 117
Installing Applications Using the USB Connection .................................................................. 117
Installing Applications Using the Android Debug Bridge ......................................................... 118
Uninstalling an Application ............................................................................................................ 118
System Update ............................................................................................................................. 120
Random Access Memory .............................................................................................................. 123
Device Storage ............................................................................................................................. 124
Enterprise Storage .................................................................................................................. 126
Portable Storage ..................................................................................................................... 126
Formatting a microSD Card or USB Drive ........................................................................ 127
Format as Internal Memory ............................................................................................... 128
Application Management .............................................................................................................. 129
Viewing Application Details ..................................................................................................... 130
Managing Downloads ................................................................................................................... 131
6
Page 7
Table of Contents
Maintenance and Troubleshooting
Introduction ................................................................................................................................... 132
Maintaining the ET5X .................................................................................................................... 132
Battery Safety Guidelines ............................................................................................................. 132
Cleaning ........................................................................................................................................ 133
Materials Required .................................................................................................................. 133
Cleaning the ET5X .................................................................................................................. 133
Housing ............................................................................................................................. 133
Display .............................................................................................................................. 133
Power Connector .............................................................................................................. 133
Cleaning Cradle Connectors ................................................................................................... 134
Cleaning Expansion Back Connectors .................................................................................... 134
Cleaning Frequency ................................................................................................................ 135
Troubleshooting ............................................................................................................................ 136
Device Diagnostic Tool ........................................................................................................... 137
Settings ............................................................................................................................. 140
Battery Test Information .................................................................................................... 140
GPS Test Information ........................................................................................................ 141
System Test Information ................................................................................................... 141
WLAN Test Information ..................................................................................................... 141
WWAN Test Information ................................................................................................... 141
Bluetooth Test Information ................................................................................................ 141
ET5X ....................................................................................................................................... 143
Charge Only Cradle ................................................................................................................ 144
Communication and Charging Cradles ................................................................................... 144
Expansion Back ...................................................................................................................... 145
Specifications
Technical Specifications ............................................................................................................... 146
ET5X ....................................................................................................................................... 146
SE4750 Expansion Back Decode Range ..................................................................................... 149
SE4750 SR Decode Ranges ................................................................................................... 149
SE4750 MR Decode Ranges .................................................................................................. 150
Accessory Specifications .............................................................................................................. 151
Charge Only Cradle ................................................................................................................ 151
Communication and Charging Cradle ..................................................................................... 151
Rugged Communication and Charging Cradle ....................................................................... 152
Expansion Backs ..................................................................................................................... 152
7
Page 8
About This Guide
Introduction
This guide provides information about configuring and setting up the ET5X and accessories.
NOTE Screens and windows pictured in this guide are samples and can differ from actual screens.
Configurations
This guide covers the following configurations:
Table 1 Configurations
Configuration
ET50PE Version
ET50PT Version
ET55BE Version
ET55BT Version
Operating
System
6.0.1
6.0.1
6.0.1
6.0.1
Radios Display Memory Data Capture
WLAN:
802.11a/b/g/n/ac/d/h/i
WPAN: Bluetooth
WLAN:
802.11a/b/g/n/ac/d/h/i
WPAN: Bluetooth
WLAN:
802.11a/b/g/n/ac/d/h/i
WPAN: Bluetooth
WWAN: NA - LTE
WLAN:
802.11a/b/g/n/ac/d/h/i
WPAN: Bluetooth
WWAN: NA - LTE
8” color 2 GB RAM/
32 GB Flash
10” color 2 GB RAM/
32 GB Flash
8” color 2 GB RAM/
32 GB Flash
10” color 2 GB RAM/
32 GB Flash
SE4750
Expansion Backs,
RS507
Hands-free
Imager
SE4750
Expansion Backs,
RS507
Hands-free
Imager
SE4750
Expansion Backs,
RS507
Hands-free
Imager
SE4750
Expansion Backs,
RS507
Hands-free
Imager
8
Page 9
Table 1 Configurations (Continued)
About This Guide
Configuration
ET55TE Version
ET55TT Version
Operating
System
6.0.1
6.0.1
Chapter Descriptions
Topics covered in this guide are as follows:
• Getting Started, provides information on getting the tablet up and running for the first time.
• Accessories, describes the accessories available for the tablet and how to use the accessories with the
tablet.
• USB Communication, describes how to connect the ET5X to a host computer using USB.
• DataWedge Configuration, describes how to use and configure the DataWedge application.
• Settings, provides the settings for configuring the ET5X.
• Application Deployment, provides information for developing and managing applications.
• Maintenance and Troubleshooting, includes instructions on cleaning and storing the tablet, and provides
troubleshooting solutions for potential problems during tablet operation.
• Specifications, includes a table listing the technical specifications for the tablet.
Radios Display Memory Data Capture
WLAN:
802.11a/b/g/n/ac/d/h/i
WPAN: Bluetooth
WWAN: ROW - LTE
WLAN:
802.11a/b/g/n/ac/d/h/i
WPAN: Bluetooth
WWAN: ROW - LTE
8” color 2 GB RAM/
32 GB Flash
10” color 2 GB RAM/
32 GB Flash
SE4750
Expansion Backs,
RS507
Hands-free
Imager
SE4750
Expansion Backs,
RS507
Hands-free
Imager
Notational Conventions
The following conventions are used in this document:
• “tablet” refers to the Zebra ET5X tablet.
• Bold text is used to highlight the following:
• Dialog box, window and screen names
• Drop-down list and list box names
• Check box and radio button names
• Icons on a screen
• Key names on a keypad
• Button names on a screen.
9
Page 10
About This Guide
• Bullets (•) indicate:
• Action items
• Lists of alternatives
• Lists of required steps that are not necessarily sequential.
• Sequential lists (e.g., those that describe step-by-step procedures) appear as numbered lists.
Related Documents and Software
The following documents provide more information about the ET5X tablets.
• ET5X Quick Reference Guide, p/n MN001844Axx
• ET5X User Guide for Android Version 6.0.1, p/n MN-003015-xx
For the latest version of this guide and all guides, go to: www.zebra.com/support
Service Information
If you have a problem with your equipment, contact Zebra Global Customer Support for your region. Contact
information is available at: www.zebra.com/support
When contacting support, please have the following information available:
• Serial number of the unit
• Model number or product name
• Software type and version number.
Zebra responds to calls by email, telephone or fax within the time limits set forth in support agreements.
If your problem cannot be solved by Zebra Customer Support, you may need to return your equipment for servicing
and will be given specific directions. Zebra is not responsible for any damages incurred during shipment if the
approved shipping container is not used. Shipping the units improperly can possibly void the warranty.
If you purchased your Zebra business product from a Zebra business partner, contact that business partner for
support.
.
.
Provide Documentation Feedback
If you have comments, questions, or suggestions about this guide, send an email to EVM-Techdocs@zebra.com.
10
Page 11
Getting Started
Introduction
This chapter explains how to set the device up for the first time.
Unpacking
Carefully remove all protective material from around the ET5X and save the shipping container for later storage
and shipping.
Verify that you received all equipment listed below:
• Table with lithium-ion battery
• Quick Reference Guide.
Inspect the equipment for damage. If you are missing any equipment or if you find any damaged equipment,
contact the Zebra Support Center immediately. See Service Information on page 10 for contact information.
Getting Started
In order to start using the ET5X for the first time:
• install the micro SIM Card (ET55 only)
• install microSD card (optional)
• start the ET5X
• configure the ET5X.
Installing a micro SIM Card (ET55 Only)
CAUTION Do not use nano to micro SIM card adapters.
To install a micro SIM card:
1. Press the Power button to turn off the ET55.
2. Lift the notched corner of the battery cover.
11
Page 12
Getting Started
Figure 1 Removing the Battery Cover
3. Carefully lift the battery cover off the ET55.
4. On the 8” version, push the two locking tabs up, then pull up on the tab to remove battery.
On the 10” version, push the two locking tabs up (1), then, using index fingers, lift the battery up (2).
Figure 2 Removing the Battery - 8”
Pull Tab
Locking Tabs
8” Version
12
Page 13
Figure 3 Removing the Battery - 10”
2.LIFT UP
2.LIFT
UP
1.RELEASE LOCKING
1.RELEASE LOCKING
Getting Started
Locking Tabs
10” Version
5. Insert the micro SIM card with contacts facing down.
Figure 4 Insert SIM Card
8” Version 10” Version
6. Push the SIM card in and ensure that it locks into place.
7. Replace the battery.
On the 10” version, ensure that the two battery latches engage.
13
Page 14
Figure 5 Insert Battery
CAUTION Be aware of the orientation of the battery cover. Failure to replace the battery cover properly may damage
the battery cover.
Getting Started
8. Align the tabs on the underside of the cover with the slot around the battery well. Make sure that the notch on
the battery cover is at the bottom left cover of the ET5X.
Figure 6 Align Battery Cover
9. Carefully press down around the edge of the cover. Make sure that the cover is seated properly.
14
Page 15
Figure 7 Press Down on Battery Cover
10. Press Power button to turn on the ET55.
Installing a microSD Card
Getting Started
To install a microSD card:
1. Open access door.
Figure 8 Open Access Door
2. Insert microSD card into slot with contacts facing down.
3. Press the card in to ensure that it is seated properly.
4. Close access door.
15
Page 16
Figure 9 Close Access Door
Charging the ET5X
Getting Started
NOTE Use only Zebra approved accessories listed in this guide when charging the ET5X.
Use one of the available accessories to charge the ET5X. Refer to Chapter 6, Accessories for charging
accessories.
The 8” tablet main battery charges from fully depleted to 90% in approximately 2.5 hours and from fully depleted to
100% in approximately 3.5 hours.
The 10” tablet main battery charges from fully depleted to 90% in approximately three hours and from fully depleted
to 100% in approximately four hours.
Table 2 Charging Indicator
LED Indication
Off ET5X is not in cradle. ET5X is not seated properly. Cradle is not powered.
Orange ET5X is charging.
Green Charging complete.
Note: When the battery is initially inserted in the ET5X, the amber LED flashes once if
the battery power is low or the battery is not fully inserted.
Red Error in charging; check placement of the ET5X.
Resetting the ET5X
CAUTION Resetting the ET5X erases all data from the ET5X, including your account configuration, applications,
music, pictures and files. Make sure that you back up all the required data before you proceed.
Resetting the ET5X returns the device to original factory settings.
16
Page 17
Getting Started
To reset the ET5X:
1. Swipe down with two fingers from the status bar to open the quick access panel and then touch .
2. Touch Backup & reset.
3. Touch Enterprise data reset.
CAUTION Resetting the ET5X erases all data from the ET5X, including your account configuration, applications,
music, pictures and files.
4. Touch RESET TABLET.
5. If required, enter PIN, or password and touch Continue.
6. Touch ERASE EVERYTHING. The ET5X erases all data then reboots.
17
Page 18
Accessories
Introduction
The ET5X accessories provide a variety of product support capabilities. Table 3 lists the accessories available.
Table 3 ET5X Accessories
Accessory Part Number Description
Cradles
Charge Only Cradle CRD-ET5X-1SCG2 Charges the ET5X main battery and optional
Power Pack installed in the Expansion Back.
Requires power supply PWR-BGA12V50W0WW,
DC Line Cord CBL-DC-388A1-01 and
country-specific AC line cord.
Communication and
Charging Cradle
Rugged Communication
and Charging Cradle
4-Slot Charge Only Cradle CRD-ET5X-SE4CO2-01 Charges up to four ET5X main battery and optional
Chargers
Power Supply PWR-BGA12V108W0WW Provides power to the 4-Slot Charge Only Cradle.
CRD-ET5X-1SCOM2 Charges the ET5X main battery and optional
Power Pack installed in the Expansion Back.
Requires power supply PWR-BGA12V50W0WW,
DC Line Cord CBL-DC-388A1-01 and
country-specific AC line cord.
CRD-ET5X-1SCOM2R Charges the ET5X main battery and optional
Power Pack installed in the Expansion Back.
Supports ET5X with rugged frame and rugged IO
Adapter. Requires power supply
PWR-BGA12V50W0WW, DC Line Cord
CBL-DC-388A1-01 and country-specific AC line
cord.
Power Pack installed in the Expansion Back and
up to four Power Pack in the optional 4-Slot
Battery Charger. Requires power supply
PWR-BGA12V108W0WW, DC line cord
CBL-DC-378A1-01, DC line cord and
country-specific AC line cord.
18
Page 19
Accessories
Table 3 ET5X Accessories (Continued)
Accessory Part Number Description
Power Supply PWR-BGA12V50W0WW Provides power to the Charge Only Cradle, the
Communication and Charging Cradles, the 4-Slot
Battery Charger, and Rugged Charge Connector.
4-Slot Battery Charger SAC-ET5X-4PPK1-01 Chargers up to four Power Packs. Requires power
supply PWR-BGA12V50W0WWl, DC Line cord
CBL-DC-388A1-01, and country-specific AC line
cord.
Rugged Charge Connector CHG-ET5X-CBL2-01 Charges the ET5X main battery and optional
Power Pack installed in the Expansion Back.
Requires power supply PWR-BGA12V50W0WW,
DC Line Cord CBL-DC-388A1-01 and
country-specific AC line cord.
Miscellaneous
Replacement 8” Internal
Battery
Replacement 10” Internal
Battery
Replacement 8” Battery
Cover
Replacement 10” Battery
Cover
8” Rugged Frame with IO
Adapter
10” Rugged Frame with IO
Adapter
Replacement Rugged IO
Connector
8” SE4750 Expansion Back ZBK-ET5X-8SCN5-02 Provides data capture using the SE4750 scan
BTRY-ET5X-8IN1-01 Replacement battery for 8” tablet.
BTRY-ET5X-10IN1-01 Replacement battery for 10” tablet.
KT-ET5X-8BTDR1-01 Replacement battery cover for 8” tablet.
KT-ET5X-10BTDR1-01 Replacement battery cover for 10” tablet.
SG-ET5X-8RCSE1-02 Add extra protection for the 8” tablet and IO
Adapter for connection to the Rugged
Communication and Charging Cradle.
SG-ET5X-10RCSE1-01 Add extra protection for the 10” tablet and IO
Adapter for connection to the Rugged
Communication and Charging Cradle.
SG-ET5X-RGIO1-01 Replacement rugged IO connector for the Rugged
Frames.
engine, rotating hand strap and slot for optional
Power Pack.
8” Expansion Back ZBK-ET5X-8RH1-01 Provides rotating hand strap and slot for optional
Power Pack.
10” SE4750 Expansion
Back
10” Expansion Back ZBK-ET5X-10RH1-01 Provides rotating hand strap and slot for optional
Power Pack BTRY-ET5X-PRPK1-01 Provides additional power for charging the ET5X
ZBK-ET5X-10SCN5-02 Provides data capture using the SE4750 scan
engine, rotating hand strap and slot for optional
Power Pack.
Power Pack.
battery using an Expansion Back.
19
Page 20
Accessories
Table 3 ET5X Accessories (Continued)
Accessory Part Number Description
Active Stylus KT-ET5X-ASTY2-01 Provides easy writing, drawing, and navigation and
accuracy with the thin tip.
Replacement Expansion
Back Hand Strap
Coiled Stylus Tether SG-ET5X-SLTETR-01 Secures a stylus to the hand strap on the
10” Screen Protector KT-ET5X-10SCRN1-01 Provides additional screen protection for 10” tablet
8” Screen Protector KT-ET5X-8SCRN1-01 Provides additional screen protection for 8” tablet
10” Screen Protector
(Rugged Frame)
8” Screen Protector
(Rugged Frame)
8” Operations Case SG-ET5X-8HLST-01 Provides carrying solution for 8” tablet.
10” Operations Case SG-ET5X-10HLST-01 Provides carrying solution for 10” tablet.
Breakaway Shoulder Strap SG-ET5X-SHDRSTP-01 Use with the Operations Case and D-clips to carry
SG-ET5X-RHTP1-01 Replacement hands strap for Expansion Backs.
Expansion Backs.
(5-pack).
(5-pack).
KT-ET5X-8SCRN1-01 Provides additional screen protection for 10” tablet
with Rugged Frame (5-pack).
KT-ET5X-10SCRN1-02 Provides additional screen protection for 8” tablet
with Rugged Frame (5-pack).
tablet on shoulder.
20
Page 21
Charge Only Cradle
CAUTION Ensure that you follow the guidelines for battery safety described in Battery Safety Guidelines on page
132.
This section describes how to use a Charge Only Cradle with the ET5X. The Charge Only Cradle ships with an
insert that must be installed when inserting an ET5X without the protective boot installed.
The Charge Only Cradle:
• Provides power for operating the ET5X.
• Charges the ET5X’s battery.
Figure 10 Charge Only Cradle - Front View
Accessories
Charging PinsGuide Pins Small Insert Tall Insert
Figure 11 Charge Only Cradle - Rear View
Power Input
Installing the Insert
The insert must be installed onto the cradle when docking an ET5X without a protective boot.
1. Align the insert over the pins.
21
Page 22
Accessories
Figure 12 Align Insert with Cradle
2. Press the insert down until it seats flush in the cradle.
Charging the ET5X
To charge the ET5X in the Charge Only Cradle:
1. Align the ET5X with the alignment pins on the cradle.
2. Insert the ET5X into the cradle.
Figure 13 Insert ET5X into Charge Only Cradle
3. The ET5X Charging LED indicates charging.
4. To remove the ET5X from the Charge Only Cradle, hold the cradle down with one hand and lift the ET5X.
22
Page 23
Accessories
Figure 14 Remove ET5X from Charge Only Cradle
Charge batteries in ambient temperatures from 0°C to 40°C (32°F to 104°F) as reported by the battery. Charging is
intelligently controlled by the charger. To accomplish this, for small periods of time, the charger alternately enables
and disables battery charging to keep the battery at acceptable temperatures.
The ET5X’s amber charge LED shows the status of the battery charging in the ET5X. See Table 2 on page 16 for
charging status indications.
The 8” tablet main battery charges from fully depleted to 90% in approximately 2.5 hours and from fully depleted to
100% in approximately 3.5 hours.
The 10” tablet main battery charges from fully depleted to 90% in approximately three hours and from fully depleted
to 100% in approximately four hours.
NOTE The Charging indicator only illuminates when the ET5X is connected to AC power.
Table 4 Charging Indicator
LED Indication
Off ET5X is not in cradle. ET5X is not seated properly. Cradle is not powered.
Orange ET5X is charging.
Green Charging complete.
Red Error in charging; check placement of the ET5X.
23
Page 24
Accessories
Communication and Charging Cradle
CAUTION Ensure that you follow the guidelines for battery safety described in Battery Safety Guidelines on page
132.
This section describes how to use a Communication and Charing Cradle with the ET5X.
The Communication and Charging cradle:
• Provides power for operating the ET5X.
• Provides ports for connecting USB devices to the tablet, video output and connection to a LAN.
Figure 15 Communication and Charging Cradle - Front View
Docking
Connector
Guide Pins Short Insert
Charging
Pins
Locking
Latches
Release
Button
Figure 16 Communication and Charging Cradle - Rear View
USB 3.0 Ports LAN (RJ45) PortPower Input
HDMI Port
Tall Insert
24
Page 25
Accessories
Figure 17 Communication and Charging Cradle - Setup
Installing the Insert
Install the tall insert when using an ET5X without an Expansion Back. Install the small insert when using an ET5X
with an Expansion Back.
1. Align the insert over the pins.
Figure 18 Align Insert with Cradle
2. Press the insert down until it seats flush in the cradle.
Charging the ET5X
To charge the ET5X in the Communication and Charging Cradle:
1. Open the bottom access door and hold it to the back of the tablet.
2. Align the ET5X with the alignment pins on the cradle.
3. Insert the ET5X into the cradle. Note that the Communication and Charging Cradles contains a locking
mechanism that locks the ET5X to the cradle.
25
Page 26
Accessories
Figure 19 Insert ET5X into Communication and Charging Cradle
4. The ET5X Charging LED indicates charging.
5. To remove the ET5X from the Communication and Charging Cradle, press the release button on the right side
of the cradle and lift the ET5X. Use thumb to hold down the cradle.
Figure 20 Remove ET5X from Communication and Charging Cradles
Charge batteries in ambient temperatures from 0°C to 40°C (32°F to 104°F) as reported by the battery. Charging is
intelligently controlled by the charger. To accomplish this, for small periods of time, the charger alternately enables
and disables battery charging to keep the battery at acceptable temperatures.
26
Page 27
Accessories
The ET5X’s amber charge LED shows the status of the battery charging in the ET5X. See Table 2 on page 16 for
charging status indications.
The 8” tablet main battery charges from fully depleted to 90% in approximately 2.5 hours and from fully depleted to
100% in approximately 3.5 hours.
The 10” tablet main battery charges from fully depleted to 90% in approximately three hours and from fully depleted
to 100% in approximately four hours.
27
Page 28
Accessories
Rugged Communication and Charging Cradle
CAUTION Ensure that you follow the guidelines for battery safety described in Battery Safety Guidelines on page
132.
This section describes how to use a Rugged Communication and Charing Cradle with the ET5X.
The Rugged Communication and Charging cradle:
• Provides power for operating the ET5X.
• Provides ports for connecting USB devices to the tablet, video output and connection to a LAN.
• Charges the ET5X’s battery
Figure 21 Rugged Communication and Charging Cradle - Front View
and optional Power Pack installed in an Expansion Back
Rugged Docking
Connector
.
Guide Pins
Charging
Pins
Locking
Latches
Release
Button
Figure 22 Rugged Communication and Charging Cradle - Rear View
USB 3.0 Ports LAN (RJ45) PortPower Input
HDMI Port
28
Page 29
Accessories
Figure 23 Rugged Communication and Charging Cradle - Setup
Charging the ET5X
To charge the ET5X using the Rugged Communication and Charging Cradle:
1. Align the ET5X with the alignment pins on the cradle.
2. Insert the ET5X into the cradle. Note that the Rugged Communication and Charging Cradles contains a locking
mechanism that locks the ET5X to the cradle.
29
Page 30
Accessories
Figure 24 Insert ET5X with Rugged Frame and IO Adapter into Rugged Communication and Charging Cradle
3. The ET5X Charging LED indicates charging.
4. To remove the ET5X from the Rugged Communication and Charging Cradle, press the release button on the
right side of the cradle and lift the ET5X. Use thumb to hold down the cradle.
Figure 25 Remove ET5X from Rugged Communication and Charging Cradles
30
Page 31
Accessories
Charge batteries in ambient temperatures from 0°C to 40°C (32°F to 104°F) as reported by the battery. Charging is
intelligently controlled by the charger. To accomplish this, for small periods of time, the charger alternately enables
and disables battery charging to keep the battery at acceptable temperatures.
The ET5X’s amber charge LED shows the status of the battery charging in the ET5X. See Table 2 on page 16 for
charging status indications.
The 8” tablet main battery charges from fully depleted to 90% in approximately 2.5 hours and from fully depleted to
100% in approximately 3.5 hours.
The 10” tablet main battery charges from fully depleted to 90% in approximately three hours and from fully depleted
to 100% in approximately four hours.
31
Page 32
4-Slot Charge Only Cradle
CAUTION Ensure that you follow the guidelines for battery safety described in Battery Safety Guidelines on page
132.
• Provides 5 VDC power for operating the ET5X.
• Simultaneously charges up to four ET5Xs and up to four Power Packs using the optional Battery Charger
Adapter.
Figure 26 4-Slot Charge Only Cradle
Accessories
Power LED
Insert Installation
Install inserts into slots for ET5X tablets without Rugged Frame.
32
Page 33
Figure 27 Install Insert in Slot
Accessories
33
Page 34
Guide Installation
The cradle comes with four 8” tablets guide and four 10” tablet guides. Install the appropriate guides for the tablets.
1. Align the two tabs on the guide with the two slots in the cradle.
Figure 28 Align Guide with Slot
Guide Tab
Accessories
2. Place the guide down onto the cradle and then rotate the guide until it snaps into the cradle.
34
Page 35
Figure 29 Rotate Guide onto Slot
Accessories
Battery Charger Installation
Install optional 4-Slot Battery Charger onto cradle:
1. Align the mounting holes on the bottom of the charger with the four studs on the cradle.
35
Page 36
Figure 30 Align Battery Charger on Adapter
Accessories
2. Place the charger on the cradle and then slide toward the front of the cradle.
Power Setup
Figure 31 4-Slot Charge Only Cradle Setup
36
Page 37
Accessories
Figure 32 4-Slot Charge Only Cradle with Battery Charger Setup
Charging the Battery
Charge batteries in ambient temperatures from 0°C to 40°C (32°F to 104°F) as reported by the battery. Charging is
intelligently controlled by the charger. To accomplish this, for small periods of time, the charger alternately enables
and disables battery charging to keep the battery at acceptable temperatures.
The ET5X’s amber charge LED shows the status of the battery charging in the ET5X. See Table 2 on page 16 for
charging status indications.
The 8” tablet main battery charges from fully depleted to 90% in approximately 2.5 hours and from fully depleted to
100% in approximately 3.5 hours.
The 10” tablet main battery charges from fully depleted to 90% in approximately three hours and from fully depleted
to 100% in approximately four hours.
37
Page 38
4-Slot Battery Charger
CAUTION Ensure that you follow the guidelines for battery safety described in Battery Safety Guidelines on page
132.
The 4-Slot Battery Charger:
• Provides 12 VDC power for charging the Power Packs.
• Simultaneously charges up to four Power Packs.
To charge a Power Pack:
Figure 33 4-Slot Battery Charger
Accessories
38
Page 39
Figure 34 Insert Power Pack
Accessories
When charging, the Power Pack Charge Level Indicators indicate the charge level.
Figure 35 Power Pack Charge LEDs
Charge Level Indicators
Table 5 Power Pack Charge Status Indicators
Power Pack
Indicators
Power not applied to Power Pack.
Charge level is between 0% and 20%.
Charge level is between 20% and 40%.
Change level is between 40% and 60%.
Description
Solid Green LED
Blinking Green LED
Blinking Red LED
39
Page 40
Accessories
Table 5 Power Pack Charge Status Indicators (Continued)
Power Pack
Indicators
Charge level is between 60% and 80%.
Charge level is between 80% and 100%.
Fully charged.
Charging error.
Solid Green LED
Blinking Green LED
Blinking Red LED
Charge batteries in ambient temperatures from 0°C to 40°C (32°F to 104°F) as reported by the battery. Charging is
intelligently controlled by the charger. To accomplish this, for small periods of time, the charger alternately enables
and disables battery charging to keep the battery at acceptable temperatures.
Description
40
Page 41
Rugged Frame
The Rugged Frame (8 inch and 10 inch) adds additional protection to the ET5X. Use the Rugged I/O Adapter when
docking the ET5X into the Rugged Communications and Charging Cradle.
1. Open the access cover.
Figure 36 Open Access Door
Accessories
2. If installing the Rugged IO Adapter, pull the access cover away from the ET5X until it separates from the ET5X.
Figure 37 Remove Access Door
3. Insert the Rugged IO Adapter onto the tablet.
41
Page 42
Accessories
Figure 38 Insert Rugged IO Adapter
4. Remove the Rugged Frame and screws from box.
5. Separate the top and bottom sections of the Rugged Frame.
6. Place the bottom section on a flat surface.
Figure 39 Protective Boot Assembly
Interface Connector
Rugged IO Adapter
7. Place the ET5X into the bottom section.
8. Align the top section over the bottom section.
9. Press the top section down onto the bottom section.
10. Using a T6 Torx screwdriver, secure the Rugged Frame together using the provided M1.6 Torx screws.
42
Page 43
Figure 40 Secure 8” Rugged Frame
Figure 41 Secure 10” Rugged Frame
Accessories
11. Torque the screws to 12 N-cm.
43
Page 44
Expansion Back
The Expansion Backs provide data capture and or Power Pack slot for the ET5X.
Installation
To install an Expansion Back:
CAUTION Remove power before installing the Expansion Back.
1. Power off the ET5X.
2. Remove battery cover and store in safe place.
Figure 42 Remove Battery Cover
Accessories
3. On 8” version only, remove rubber gasket.
Figure 43 Remove Rubber Gasket
Rubber Gasket
44
Page 45
Accessories
Figure 44 Align Expansion Back with 8” Configuration
Power Pack
Slot Cover
Interface Connector
4. Align expansion back with device. Ensure that the power pack slot cover is aligned with the bottom of the
device and the interface connector on expansion back aligns with interface connector on device.
Figure 45 Align Expansion Back with 8” Configuration
Power Pack Slot
Cover
Interface Connector
45
Page 46
Accessories
Figure 46 Secure Screws
Screws (4)
5. Using a T6 Torx screwdriver, secure expansion back to device using four screws. Torque to 14 n-cm.
Configuring the SE4750 Expansion Backs
Use only the 8” SE4750 Expansion Back (ZBK-ET5X-8SCN5-02) or 10” SE4750 Expansions Back
(ZBK-ET5X-10SCN5-02) with the ET5X running the Android operating system. If using SE4750 Expansion Back
(ZBK-ET5X-8SCN5-01 or ZBK-ET5X-10SCN5-01) convert the Expansion Back for use with the ET5X running
Android. See conversion procedures below.
Expansion Back Conversion Procedures
The 8” SE4750 Expansion Back (ZBK-ET5X-8SCN5-01) or 10” SE4750 Expansions Back
(ZBK-ET5X-10SCN5-01) cannot be used with the ET5X running Android operating system. If using SE4750
Expansion Back (ZBK-ET5X-8SCN5-01 or ZBK-ET5X-10SCN5-01) convert the Expansion Back for use with the
ET5X running Android.
1. Install the Expansion Back onto the tablet.
2. Ensure that the ET5X has the latest Android operating system version.
3. Ensure that the battery charge level is greater than 30%.
4. Check if the Expansion Back scanner is in SSI Mode.
a. Open the DataWedge application.
b. Touch > About.
c. Check if the Scanner Firmware information displays.
d. Open the DWDemo application.
e. Try to scan a bar code using soft-key on the DWDemo application.
NOTE The Trigger button on the Expansion Back [Hard key] might not work to scan because the Expansion
Back scanner may not have the latest scanner firmware.
f. If the scanner firmware version displays and the bar code is scanned successfully, the scanner is in SSI
mode.
5. If the Expansion Back scanner is in SSI Mode and the firmware version in DataWedge application ends with
PAABLC44-001-R00, the Expansion Back scanner is in SSI Mode and the scanner has the latest firmware.
6. If the Expansion Back scanner is already in SSI Mode and the scanner firmware version does not end with
PAABLC44-001-R00, then proceed to step 12, otherwise continue to next step to convert the Expansion Back
scanner to SSI Mode.
46
Page 47
Accessories
7. Scan the below bar code using the Expansion Back trigger button.
Figure 47 Set Defaults
8. Wait five seconds. You will hear a disconnect indication (2 short beeps) followed by a boot indication (3 beeps)
from the Expansion Back.
9. Scan the below bar code using the Expansion Back trigger button.
Figure 48 SSI Over USB CDC Bar Code
10. Wait five seconds. You will hear a disconnect indication (2 short beeps) followed by a boot indication (3 beeps)
from the Expansion Back.
11. Wait five seconds. The Expansion Back scanner should now be in SSI Mode.
12. Open DataWedge application.
13. Touch > About.
14. Check the Scanner Firmware version. The firmware version should be PAABLC44-001-R00.
15. Once the scanner is in SSI mode, reboot the ET5X.
a. Press the Power button until the menu appears.
b. Touch Power Off.
c. Wait for the ET5X to turn off.
d. Press the Power button to turn on the ET5X.
CAUTION After the ET5X turns on, do not suspend or reboot the device using the Power button as this would
stop the firmware update process. Unlock the screen by swiping the lock screen up.
16. The firmware update occurs as a background process and takes approximately five minutes. Do not open
DataWedge or DWDemo applications during this time.
17. After the update is completed successfully you would hear bootup indication (3 beeps) from the Expansion
Back.
18. Wait 15 seconds.
19. Open the DataWedge application.
20. Touch > About.
21. The Scanner Firmware version displays PAABLC44-001-R00.
The Expansion Back is ready for normal use.
Replacement Hand Strap
To replace the hand strap:
1. If the Power Pack is installed, remove the Power Pack.
2. Rotate the disk so that the strap end without the eyelet is aligned with the Power Pack opening.
3. Open both ends of the hand strap.
47
Page 48
Accessories
Figure 49 Open Straps
4. Pull the strap end without the eyelet through the slot on the Expansion Back.
Figure 50 Remove Strap
5. Rotate the disk 180°.
6. Slide the pad off the hand strap.
7. Pull the eyelet end through the slot on the Expansion Back.
48
Page 49
Figure 51 Pull Eyelet End
Accessories
8. Remove pad from new replacement hand strap.
9. Rotate the disk so that one of the slots is aligned with the Power Pack opening.
10. Feed the new hand strap through the slot at the Power Pack opening.
Figure 52 Feed New Strap
Eyelet
Hook
Material
Disk Slot
Hook
Material
Disk Slot
Hand Strap Disk
Power Pack
Opening
11. Slide pad onto hand strap with the stylus holder facing up.
12. Fold the eyelet end of the strap up and press hook and loop material together.
49
Page 50
Accessories
Figure 53 Secure Eyelet End
Pad
Stylus
Holder
13. Rotate disk 180° so that the empty slot is aligned with the Power Pack opening.
14. Feed strap through the slot.
Figure 54 Feed Strap
15. Fold the end of the strap up and press hook and loop material together.
50
Page 51
Accessories
Figure 55 Secure Strap
Attaching the Stylus to the Expansion Back
The Expansion Backs provide a holder for the stylus. To install the stylus onto the Expansion Back with th option
tether:
1. Insert one loop of the tether into the hole in the stylus end cap.
Figure 56 Insert Loop
2. Feed the other end of the tether through the loop.
Figure 57 Feed Tether Through Loop
3. Pull the tether all the way through the loop.
4. Insert the loop of the tether through the eyelet on the hand strap of the Expansion Back.
5. Feed the stylus through the loop.
51
Page 52
Accessories
Figure 58 Feed Stylus through Loop
6. Pull the stylus all the way through the loop.
7. Slide the stylus into the holder for storing the stylus.
Figure 59 Insert Stylus into Holder
Removal
To remove an Expansion Back:
CAUTION Remove power before removing the Expansion Back.
1. Power off the ET5X.
2. Using a T6 Torx screwdriver, remove four screws securing expansion back to device.
Figure 60 Remove Screws
Screws (4)
3. Lift Expansion Back off device.
52
Page 53
Accessories
Figure 61 Lift Expansion Back
4. On 8” version only, replace rubber gasket removed during installation.
Figure 62 Rubber Gasket Replacement
Rubber Gasket
5. Replace battery cover.
Figure 63 Align Battery Cover
6. Carefully press down around the edge of the cover. Make sure that the cover is seated properly.
53
Page 54
Accessories
Figure 64 Press Down on Battery Cover
7. Press the Power button to turn on the ET5X.
54
Page 55
USB Communication
This chapter provides information for transferring files between the device and a host computer.
Connecting to a Host Computer via USB
Connect the ET5X to a host computer using a USB cable to transfer files between the ET5X and the host
computer.
CAUTION When connecting the ET5X to a host computer, follow the host computer’s instructions for connecting
and disconnecting USB devices, to avoid damaging or corrupting files.
Transferring Files using Media Transfer Protocol
NOTE Use Media Transfer Protocol (MTP) to copy files between the ET5X (internal memory or microSD card)
and the host computer.
1. Connect a USB Cable to the ET5X. See Communication and Charging Cradle for setup information.
2. Pull down the Notification panel and touch USB for Charging.
Figure 5-1 Use USB Dialog Box
3. Touch File transfers.
4. On the host computer, open a file explorer application.
5. Locate the ET5X as a portable device.
6. Open the SD card or the Internal storage folder.
7. Copy files to and from the ET5X or delete files as required.
55
Page 56
USB Communication
Transferring Files using Photo Transfer Protocol
NOTE Use Photo Transfer Protocol (PTP) to copy photos from either the microSD card or internal memory to the
host computer.
1. Connect the USB Cable to the ET5X. See Communication and Charging Cradle for setup information.
2. Pull down the Notification panel and touch USB for Charging.
Figure 5-2 Use USB Dialog Box
3. Touch Photo transfer (PTP).
4. On the host computer, open a file explorer application.
5. Open the SD card or the Internal storage folder.
6. Copy or delete photos as required.
Disconnect from the Host Computer
CAUTION Carefully follow the host computer’s instructions to unmount the device and disconnect USB devices
correctly to avoid losing information.
7. On the host computer, unmount the device.
8. Remove the USB cable from the device.
56
Page 57
DataWedge Configuration
DataWedge Configuration
This chapter applies to DataWedge on Android devices. DataWedge is an application that reads data, processes
the data and sends the data to an application.
Basic Scanning
Scanning can be performed using the Expansion Back or RS507 Hands-free imager.
To capture bar code data:
1. Ensure that an application is open on the ET5X and a text field is in focus (text cursor in text field).
2. Aim the exit window at a bar code.
3. Press the trigger button. Ensure the red scan beam covers the entire bar code. The Charging/Scan LED
Indicators illuminate green and a beep sounds to indicate a successful decode.
Profiles
DataWedge is based on profiles and plug-ins. A profile contains information on how DataWedge should behave
with different applications.
Profile information consists of:
Using profiles, each application can have a specific DataWedge configuration. For example, each user application
can have a profile which outputs scanned data in the required format when that application comes to the
foreground. DataWedge can be configured to process the same set of captured data differently based on the
requirements of each application.
DataWedge includes the following pre-configured profiles which support specific built-in applications:
• Associated application
• data capture plus configurations
• Input plug-in configurations
• Output plug-in configurations
• Process plug-in configurations.
• Profile0 - created automatically the first time DataWedge runs. Generic profile used when there are no
user created profiles associated with an application (default).
57
Page 58
DataWedge Configuration
• Launcher - disables scanning when the Launcher is in foreground.
• DWDemo - provides support for the DWDemo application.
Some Zebra applications are capable of capturing data by scanning. DataWedge is pre-loaded with private and
hidden profiles for this purpose. There is no option to modify these private profiles.
Profile0
Profile0 can be edited but cannot be associated with an application. That is, DataWedge allows manipulation of
plug-in settings for Profile0 but it does not allow assignment of a foreground application. This configuration allows
DataWedge to send output data to any foreground application other than applications associated with user-defined
profiles when Profile0 is enabled.
Profile0 can be disabled to allow DataWedge to only send output data to those applications which are associated
in user-defined profiles. For example, create a profile associating a specific application, disable Profile0 and then
scan. DataWedge only sends data to the application specified in the user-created profile. This adds additional
security to DataWedge enabling the sending of data only to specified applications.
Plug-ins
A plug-in is a software module utilized in DataWedge to extend its functionality to encompass technologies such as
bar code scanning. The plug-ins can be categorized into three types based on their operations:
• Input Plug-ins
• Output Plug-ins
• Process Plug-ins.
Input Plug-ins
An Input Plug-in supports an input device, such as a bar code scanner contained in, or attached to the device.
DataWedge contains base plug-ins for these input devices.
• Bar Code Scanner Input Plug-in – The Bar Code Scanner Input Plug-in is responsible for reading data
from the integrated bar code scanner and supports different types of bar code readers including laser,
imager and internal camera. Raw data read from the bar code scanner can be processed or formatted
using Process Plug-ins as required. DataWedge has built-in feedback functionality for the bar code
scanner to issue user alerts. The feedback settings can be configured according to user requirement.
Process Plug-ins
Process Plug-ins are used in DataWedge to manipulate the received data according to the requirement, before
sending to the foreground application via the Output Plug-in.
• Advanced Data Formatting Process Plug-in – The Advanced Data Formatting Plug-in allows
DataWedge to apply rules (actions to be performed based on defined criteria) to the data received via an
input plug-in before passing it to an Output Plug-in.
• Basic Data Formatting Process Plug-in – The Basic Data Formatting Plug-in allows DataWedge to add
a prefix and/or a suffix to the captured data before passing it to an Output Plug-in.
Output Plug-ins
Output Plug-ins are responsible for sending the data from Input Plug-ins to a foreground application on the device.
58
Page 59
DataWedge Configuration
• Keystroke Output Plug-in – The Keystroke Output Plug-in collects and sends data received from the
Input Plug-in to the foreground applications by emulating keystrokes.
• Intent Output Plug-in – The Intent Output Plug-in collects and sends data received from the Input
Plug-ins to foreground applications using the Android Intent mechanism.
• IP Output Plug-in – The IP Output Plug-in collects and sends data received from the Input Plug-ins to a
host computer via a network connection. Captured data can be sent over an IP network to a specified IP
address and port using either TCP or UDP transport protocols.
Profiles Screen
To launch DataWedge, touch > . By default, three profiles appear:
• Profile0
• Launcher
• DWDemo.
Profile0 is the default profile and is used when no other profile can be applied.
Figure 6 DataWedge Profiles Screen
Profile names are color coded. Enabled profiles are white and disabled profiles are gray.
To configure a profile touch the profile name.
Profile Context Menu
Touch and hold a profile to open a context menu that allows additional actions to be performed on the selected
profile.
59
Page 60
DataWedge Configuration
Figure 7 Profile Context Menu
The profile context menu allows the profile to be edited (same as just tapping on a profile), renamed or deleted.
Options Menu
Touch to open the options menu.
Figure 8 DataWedge Options Menu
The menu provides options to create a new profiles, access to general DataWedge settings and DataWedge
version information.
Disabling DataWedge
1. Touch > .
2. Touch .
3. Touch Settings.
4. Touch DataWedge enabled.
The blue check disappears from the checkbox indicating that DataWedge is disabled.
60
Page 61
DataWedge Configuration
Creating a New Profile
1. Touch > .
2. Touch .
3. Touch New profile.
4. In the New profile dialog box, enter a name for the new profile. It is recommended that profile names be
unique and made up of only alpha-numeric characters (A-Z, a-z, 0-9).
Figure 9 New Profile Name Dialog Box
5. Touch OK.
The new profile name appears in the DataWedge profile screen.
Profile Configuration
To configure the Profile0 or a user-created profile, touch the profile name.
Figure 10 Profile Configuration Screen
The configuration screen lists the following sections:
61
Page 62
DataWedge Configuration
• Profile enabled
• Applications
• Data Capture Plus (DCP)
• Barcode Input
• Keystroke output
• Intent Output
• IP Output.
Associating Applications
Use Applications option to associate applications with this profile. User created profiles should be associated with
one or more applications and its activities.
1. Touch Associated apps. A list of applications/activities associated with the profile displays. Initially the list
does not contain any applications/activities.
Figure 11 Associated Apps Screen
2. Touch .
3. Touch New app/activity.
62
Page 63
Figure 12 Select Application Menu
DataWedge Configuration
4. In the Select application screen, select the desired application from the list.
Figure 13 Select Activity Menu
5. In the Select activity menu, selecting the activity adds that application/activity combination to the associated
application list for that profile. Selecting * as the activity results in all activities within that application being
associated to the profile. During operation, DataWedge tries to match the specific application/activity
combinations with the foreground application/activity before trying to match the general application/*
combinations.
6. Touch .
63
Page 64
DataWedge Configuration
Figure 14 Selected Application/Activity
Data Capture Plus
The Data Capture Plus (DCP) is a DataWedge feature that enables the user to initiate data capture by touching an
area on the screen. A button or screen overlay acts like a scan button.
64
Page 65
DataWedge Configuration
Figure 15 Data Capture Plus Dock Button
DCP
Button
The DataWedge profile configuration screen allows the user to configure how the DCP appears on the screen once
the particular profile is enabled. The DCP is hidden by default. Enabling DCP option displays additional
configuration parameters.
65
Page 66
DataWedge Configuration
Figure 16 Data Capture Plus Settings
• Enable - Select to enable Data Capture Plus (default - disabled).
• Dock button on - Select position of the button.
• Left or right - Allows user to place the button on either the right or left edge of the screen.
• Left only - Places the button on left edge of the screen.
• Right only - Places the button on the right edge of the screen.
• Start in - Select the initial DCP state.
• Fullscreen mode - DCP covers the whole screen.
• Button mode - DCP displays as a circular button on the screen and can be switched to fullscreen
mode.
• Button only mode - DCP displays as a circular button on the screen and cannot be switched to
fullscreen mode.
• Button highest position - Select the top of the range the user is allowed to move the DCP, given as a
percent of the screen height (default - 0).
• Button lowest position - Select the bottom of the range the user is allowed to move the DCP, given as a
percent of the screen height (default - 100).
• Drag detect time - Select the time in milliseconds that the scanner waits before activating scanner. This
allows the user to drag the button without initiating scanner (default - 100 ms, maximum 1000 ms).
NOTE The DCP does not appear if the scanner is disabled in the profile even though the Enabled option is set.
In Button mode, the user can place DCP in full screen mode by dragging the button over Fullscreen mode. The
overlay covers the screen.
66
Page 67
Figure 17 Fullscreen Mode
DataWedge Configuration
Swipe down to return to button mode.
BarCode Input
Use the BarCode Input options to configure the Bar Code Scanner Input Plug-in for the profile.
Enabled
Enables or disables this plug-in. A check in the checkbox indicates that the plug-in is enabled.
Scanner Selection
Configures which scanning device to use for bar code data capture when the profile is active.
• Auto - The software automatically selects the best scanner.
• Plugable Serial SSI Scanner - Scanning is performed using the Expansion Back.
• Bluetooth Scanner - Scanning is performed using the optional RS507 scanner.
Decoders
Configures which bar code decoders are enabled or disabled. For best performance disable all unnecessary
decoders.
Touch Decoders. The Barcode input screen appears. A check in the checkbox indicates that the decoder is
enabled. By default the most commonly used decoders are enabled (shown below with an asterisk). The supported
decoders are:
67
Page 68
DataWedge Configuration
NOTE DataWedge supports the decoders listed below but not all are validated on this device.
Touch to return to the previous screen.
Table 6 Supported Decoders
Symbology SE4750 Expansion Back Default RS507 Default
Australian Postal Disabled Disabled
Aztec Enabled Enabled
Canadian Postal Disabled Not Supported
Chinese 2 of 5 Disabled Disabled
Codabar Enabled Enabled
Code 11 Disabled Disabled
Code 128 Enabled Enabled
Code 39 Enabled Enabled
Code 93 Disabled Disabled
Composite AB Disabled Disabled
Composite C Disabled Disabled
Discrete 2 of 5 Disabled Disabled
Datamatrix Enabled Enabled
Decoder Signature Disabled Disabled
Dutch Postal Disabled Disabled
EAN13 Enabled Enabled
EAN8 Enabled Enabled
GS1 DataBar Enabled Enabled
GS1 DataBar Expanded Enabled Enabled
GS1 DataBar Limited Disabled Disabled
HAN XIN Disabled Not supported
Interleaved 2 of 5 Disabled Disabled
Japanese Postal Disabled Disabled
Korean 3 of 5 Disabled Disabled
Matrix 2 of 5 Disabled Disabled
Maxicode Enabled Enabled
MicroPDF Disabled Disabled
68
Page 69
DataWedge Configuration
Table 6 Supported Decoders (Continued)
Symbology SE4750 Expansion Back Default RS507 Default
MicroQR Disabled Disabled
MSI Disabled Disabled
PDF417 Enabled Enabled
QRCode Enabled Enabled
TLC39 Disabled Disabled
Trioptic 39 Disabled Disabled
UK Postal Disabled Disabled
UPCA Enabled Enabled
UPCE0 Enabled Enabled
UPCE1 Disabled Disabled
US4state Disabled Disabled
US4state FICS Disabled Disabled
US Planet Disabled Disabled
US Postnet Disabled Disabled
Decoder Params
Use Decode Params to configure individual decoder parameters.
Codabar
• 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 (default - disabled).
• Length1 - Use to set decode lengths (default - 6). See Decode Lengths on page 74 for more information.
• Length2 - Use to set decode lengths (default - 55). See Decode Lengths on page 74 for more information.
• Redundancy - Sets the reader to read the bar code twice before accepting data. A check in the checkbox
indicates that redundancy is enabled (default - enabled).
• 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 (default - disabled).
• Redundancy - Sets the reader to read the bar code twice before accepting data. A check in the checkbox
indicates that redundancy is enabled (default - enabled).
Code 11
• Length1 - Use to set decode lengths (default - 4). See Decode Lengths on page 74 for more information.
• Length2 - Use to set decode lengths (default - 55). See Decode Lengths on page 74 for more information.
• Redundancy - Sets the reader to read the bar code twice before accepting data. A check in the checkbox
indicates that redundancy is enabled (default - enabled).
• Report Check Digit - Transmit Code 11 data with or without the check digit. A check in the checkbox
indicates to send Code 11 data with check digit (default - disabled).
69
Page 70
DataWedge Configuration
• 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 bar code.
• No Check Digit - Do not verify check digit.
• 1 Check Digit - Bar code contains one check digit (default).
• 2 Check Digits - Bar code contains two check digits.
Code128
• Code128 Reduced Quiet Zone - Enables decoding of margin-less Code 128 bar codes (SE4750 only).
• Ignore Code128 FCN4 - When enabled, and a Code 128 bar code has an embedded FNC4 character, it
will be removed from the data and the following characters will not be changed. When the feature is
disabled, the FNC4 character will not be transmitted but the following character will have 128 added to it
(SE4750 only).
• Check ISBT Table - The ISBT specification includes a table that lists several types of ISBT bar codes 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. A check in the checkbox
indicates that redundancy is enabled (default - disabled).
• Enable GS1-128 - Set the GS1 128 subtype. A check in the checkbox indicates that the option is enabled
(default - enabled).
• Enable ISBT128 - Set the ISBT128 subtype. A check in the checkbox indicates that the option is enabled
(default - enabled).
• ISBT128 Concatenation Mode - Select an option for concatenating pairs of ISBT code types:
• Concat Mode Never - Do not concatenate pairs of ISBT codes encountered (default).
• 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 DataWedge
Configuration 4 - 11 Redundancy - Code128 before transmitting its data to confirm that there is no
additional ISBT symbol.
• Length1 - Use to set decode lengths (default - 0). See Decode Lengths on page 74 for more information.
• Length2- Use to set decode lengths (default - 55). See Decode Lengths on page 74 for more information.
• Redundancy - Sets the reader to read the bar code twice before accepting data. A check in the checkbox
indicates that redundancy is enabled (default - disabled).
• Security Level - The scanner offers four levels of decode security for Code 128 bar codes. Select
increasing levels of security for decreasing levels of bar code quality. There is an inverse relationship
between security and scanner aggressiveness, so choose only that 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” bar codes.
• Security Level 1 - This setting eliminates most misdecodes (default).
• Security Level 2 - Select this option if Security level 1 fails to eliminate misdecodes.
• Security Level 3 - If Security Level 2 is selected and misdecodes still occur, select this security level.
Be advised, selecting this option is an extreme measure against mis-decoding severely out of spec bar
codes. Selecting this level of security significantly impairs the decoding ability of the scanner. If this
level of security is needed, try to improve the quality of the bar codes.
70
Page 71
DataWedge Configuration
Code39
• Code39 Reduced Quiet Zone - Enables decoding of margin-less Code 39 bar codes (SE4750 only).
• Convert Code39 To Code32 - Code 32 is a variant of Code 39 used by the Italian pharmaceutical
industry. Scan the appropriate bar code below to enable or disable converting Code 39 to Code 32 (default
- disabled).
• Full ASCII- Code 39 Full ASCII is a variant of Code 39 that pairs characters to encode the full ASCII
character set. To enable or disable Code 39 Full ASCII (default - disabled).
• Length1 - Use to set decode lengths (default - 0). See Decode Lengths on page 74 for more information.
• Length2 - Use to set decode lengths 4 (default - 55). See Decode Lengths on page 74 for more
information.
• Redundancy - Sets the reader to read the bar code twice before accepting data. A check in the checkbox
indicates that redundancy is enabled (default - disabled).
• Report Check Digit - Transmit Code 39 data with or without the check digit. A check in the checkbox
indicates to send Code 39 data with check digit (default - disabled).
• Report Code32 Prefix - Scan the appropriate bar code to enable or disable adding the prefix character “A”
to all Code 32 bar codes (default - disabled).
• Security Level - Options: Security level 0, Security Level 1, Security Level 2 and Security Level 3
(default - Security level 1).
• Security Level 0 - This setting allows the scanner to operate in its most aggressive state, while
providing sufficient security in decoding most “in-spec” bar codes.
• Security Level 1 - This setting eliminates most misdecodes (default).
• Security Level 2 - Select this option if Security level 1 fails to eliminate misdecodes.
• Security Level 3 - If Security Level 2 is selected and misdecodes still occur, select this security level.
Be advised, selecting this option is an extreme measure against mis-decoding severely out of spec bar
codes. Selecting this level of security significantly impairs the decoding ability of the scanner. If this
level of security is needed, try to improve the quality of the bar codes.
• 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 (default - disabled).
Code93
• Length1 - Use to set decode lengths (default - 0). See Decode Lengths on page 74 for more information.
• Length2 - Use to set decode lengths (default - 55). See Decode Lengths on page 74 for more information.
• Redundancy - Sets the reader to read the bar code twice before accepting data. A check in the checkbox
indicates that redundancy is enabled (default - disabled).
Composite AB
• UCC Link Mode
• Link Flag ignored - 1D component is transmitted regardless of whether a 2D component is detected.
• Always Linked - 1D and the 2D components are transmitted. If 2D is not present, the 1D component
is not transmitted.
• Auto Discriminate - the digital scanner determines if there is a 2D portion, then transmits the 1D
component, as well as the 2D portion if present. (default).
71
Page 72
DataWedge Configuration
Discrete 2 of 5
• Length1 - Use to set decode lengths (default - 0). See Decode Lengths on page 74 for more information.
• Length2 - Use to set decode lengths (default - 14). See Decode Lengths on page 74 for more information.
• Redundancy - Sets the reader to read the bar code twice before accepting data. A check in the checkbox
indicates that redundancy is enabled (default - enabled).
GS1 DataBar Limited
• GS1 Limited Security Level
• Security Level 1 - This setting allows the scanner to operate in its most aggressive state, while
providing sufficient security in decoding most “in-spec” bar codes.
• Security Level 2 - This setting eliminates most misdecodes (default).
• Security Level 3 - Select this option if Security level 0 fails to eliminate misdecodes.
• Security Level 4 - If Security Level 3 is selected and misdecodes still occur, select this security level.
Be advised, selecting this option is an extreme measure against mis-decoding severely out of spec bar
codes. Selecting this level of security significantly impairs the decoding ability of the scanner. If this
level of security is needed, try to improve the quality of the bar codes.
HAN XIN
• HAN XIN Inverse (SE4750 only)
• Disable - Disables decoding of HAN XIN inverse bar codes (default).
• Enable - Enables decoding of HAN XIN inverse bar codes.
• Auto - Decodes both HAN XIN regular and inverse bar codes.
Interleaved 2 of 5
• Check Digit
• No Check Digit - A check digit is not used. (default)
• USS Check Digit - Select to check the integrity of all Interleaved 2 of 5 symbols to verify the data
complies with either 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 either the Optical Product Code Council (OPCC) check digit algorithm.
• Length1 - Use to set decode lengths (default - 14). See Decode Lengths on page 74 for more information.
• Length2 - Use to set decode lengths (default - 10). See Decode Lengths on page 74 for more information.
• Redundancy - Sets the reader to read the bar code twice before accepting data. A check in the checkbox
indicates that redundancy is enabled (default - enabled).
• Report Check Digit - Transmit Interleaved 2 of 5 data with or without the check digit. A check in the
checkbox indicates to send Interleaved 2 of 5 data with check digit (default - disabled).
• I2of5 Security Level - Options: I2of5 Security level 0, I2of5 Security Level 1, I2of5 Security Level 2
and I2of5 Security Level 3 (default - I2of5 Security level 1) (SE4750 only).
• Convert ITF-14 To EAN13 - Convert 14-character Interleaved 2 of 5 bar codes to EAN-13, and transmit as
EAN-13. The Interleaved 2 of 5 bar code must be enabled and must have a leading zero and a valid
EAN-13 check digit. A check in the checkbox indicates that the option is enabled (default - disabled).
• I2of5 Reduced Quiet Zone - Enables decoding of margin-less I2of5 bar codes (SE4750 only).
72
Page 73
DataWedge Configuration
Matrix 2 of 5
• Length1 - Use to set decode lengths (default - 10). See Decode Lengths on page 74 for more information.
• Length2 - Use to set decode lengths (default - 0). See Decode Lengths on page 74 for more information.
• Redundancy - Sets the reader to read the bar code twice before accepting data. A check in the checkbox
indicates that redundancy is enabled (default - disabled).
• Report Check Digit - Transmit Matrix 2 of 5 data with or without the check digit. A check in the checkbox
indicates to send Matrix 2 of 5 data with check digit (default - enabled).
• Verify Check Digit - Enable this feature to check the integrity of all Matrix 2 of 5 symbols to verify that the
data complies with a specified check digit algorithm (default - enabled).
MSI
• Check Digit - With MSI symbols, one check digit is mandatory and always verified by the reader. The
second check digit is optional.
• One Check Digit - Verify one check digit (default).
• 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 and second check digit is MOD 10 (default).
• Mod-10-10 - Both check digits are MOD 10.
• Length 1 - Use to set decode lengths (default - 4). See Decode Lengths on page 74 for more information.
• Length 2 - Use to set decode lengths (default - 55). See Decode Lengths on page 74 for more information.
• Redundancy - Sets the reader to read the bar code twice before accepting data. A check in the checkbox
indicates that redundancy is enabled (default - enabled).
• Report Check Digit - Transmit MSI data with or without the check digit. A check in the checkbox indicates
to send MSI data with check digit (default - disabled).
Trioptic 39
• Redundancy - Sets the reader to read the bar code twice before accepting data. A check in the checkbox
indicates that redundancy is enabled (default - enabled).
UK Postal
• Report Check Digit - Transmit UK Postal data with or without the check digit. A check in the checkbox
indicates to send UK Postal data with check digit (default - disabled).
UPCA
• Preamble - Preamble characters are part of the UPC symbol consisting of Country Code and System
Character. Select the appropriate option to match the host system.
There are three options for transmitting a UPCA preamble:
• Preamble None - Transmit no preamble.
• Preamble Sys Char - Transmit System Character only (default).
• Preamble Country and Sys Char - Transmit System Character and Country Code (“0” for USA).
Select the appropriate option to match the host system.
• 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 (default
- enabled).
73
Page 74
DataWedge Configuration
UPCE0
• 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).
• Preamble - Preamble characters are part of the UPC symbol consisting of Country Code and System
Character. Select the appropriate option to match the host system.
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 (default).
• 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 (default
- disabled).
UPCE1
• 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 (default disabled).
• Preamble - Preamble characters are part of the UPC symbol consisting of Country Code and System
Character. Select the appropriate option to match the host system.
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 (default).
• 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 (default
- disabled).
US Planet
• 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 (default
- disabled).
Decode Lengths
• The allowable decode lengths are specified by options Length1 and Length2 as follows:
• Variable length: Decode symbols containing any number of characters.
• Set both Length1 and Length2 to 0.
• Range: Decode a symbol with a specific length range (from
• Set Length1 to
a
and set Length2 to b.
a
to b, including a and b).
• Two Discrete Lengths: Decode only symbols containing either of two selected lengths.
• Set both Length1 or Length2 to the specific lengths. Length1 must be greater than Length2.
• One Discrete Length: Decode only symbols containing a specific length.
• Set both Length1 and Length2 to the specific length.
74
Page 75
DataWedge Configuration
UPC EAN Params
Allows the configuration of the parameters that apply to more than one UPC or EAN decoder.
• Convert DataBar To UPC EAN - If this is set it converts DataBar bar codes 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.
• UPC Reduced Quiet Zone - Enables decoding of margin-less UPC bar codes (SE4750 only).
• Bookland - Enable Bookland decoding. A check in the checkbox indicates that the option is enabled.
• Bookland Format - If Bookland EAN is enabled, select one of the following formats for Bookland data:
• Format ISBN-10 - The decoder 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. (default)
• Format ISBN-13 - The decoder reports Bookland data (starting with either 978 or 979) as EAN-13 in
13-digit format to meet the 2007 ISBN-13 protocol.
• Coupon - Enables Coupon code decoding. Note that in order to successfully decode Coupon codes, all of
the correct decoders must be enabled. A check in the checkbox indicates that the option is enabled.
• Coupon Repost Mode - Traditional coupon symbols are composed of two bar code: UPC/EAN and Code
128. A new coupon symbol is composed of a single Data Expanded bar code. The new format offers more
options for purchase values (up to $999.999) and supports complex discount offers as a second purchase
requirement. An interim coupon symbol also exists that contain both types of bar codes: UPC/EAN and
Databar Expanded. This format accommodates both retailers that do not recognize or use the additional
information included in the new coupon symbol, as well as those who can process new coupon symbols.
• Old Coupon Report Mode - Scanning an old coupon symbol reports both UPC and Code 128,
scanning is interim coupon symbol reports UPC, and scanning a new coupon symbol reports nothing
(no decode).
• New Coupon Report Mode - Scanning an old coupon symbol reports either UPC or Code 128, and
scanning an interim coupon symbol or a new coupon symbol reports Databar Expanded.
• Both Coupon Report Modes - Scanning an old coupon symbol reports both UPC and Code 128, and
scanning an interim coupon symbol or a new coupon symbol reports Databar Expanded.
• Ean Zero Extended – Enable this parameter to add five leading zeros to decoded EAN-8 symbols to make
them compatible in format to EAN-13 symbols. Disable this to transmit EAN-8 symbols as is. Default –
disabled.
• Linear Decode - This option applies to code types containing two adjacent blocks (e.g., UPC-A, EAN-8,
EAN-13). Enable this parameter to transmit a bar code only when both the left and right blocks are
successfully decoded within one laser scan. Enable this option when bar codes are in proximity to each
other.
• Retry Count - Retry count for auto-discriminating for supplementals. Possible values are 2 to 20 inclusive.
Note that this flag is only considered if Supplemental Mode - UPC EAN 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, default 10).
75
Page 76
DataWedge Configuration
• Security Level - The scanner offers four levels of decode security for UPC/EAN bar codes. Select higher
security levels for lower quality bar codes. There is an inverse relationship between security and decode
speed, so be sure to choose only that level of security necessary for the application.
• Level 0 - This default setting allows the scanner to operate fastest, while providing sufficient security in
decoding “in-spec” UPC/EAN bar codes (default).
• Level 1 - As bar code quality levels diminish, certain characters become prone to misdecodes before
others (i.e., 1, 2, 7, 8). If the scanner is misdecoding poorly printed bar codes, and the misdecodes are
limited to these characters, select this security level.
• Level 2 - If the scanner is misdecoding poorly printed bar codes, and the misdecodes are not limited to
characters 1, 2, 7, and 8, select this security level.
• Level 3 - If the scanner is still misdecoding, select this security level. Be advised, selecting this option
is an extreme measure against misdecoding severely out of spec bar codes. Selecting this level of
security can significantly impair the decoding ability of the scanner. If this level of security is necessary,
try to improve the quality of the bar codes.
• Supplemental2 - Enables or disables this option. A check in the checkbox indicates that the option is
enabled.
• Supplemental5 - Enables or disables this option. A check in the checkbox indicates that the option is
enabled.
• 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 (default).
• Supplemental Always - the scanner only decodes UPC/EAN symbols with supplemental characters,
and ignores symbols without supplementals.
• Supplements Auto - the scanner decodes UPC/EAN symbols with supplemental characters
immediately. If the symbol does not have a supplemental, the scanner must decode the bar code 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 right away if it does not belong to one of the following supplemental types: 378,
379, 977, 978, 979, 414, 419, 434 or 439. If the bar code starts with one of the prefixes it searches the
image more aggressively for a supplemental. Tries to scan the supplemental if it is present. If the
supplemental scanning failed, then the main bar code 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 bar code not starting with 378
or 379. Tries to scan the supplemental if it is present. If the supplemental scanning failed, then the
main bar code 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 bar code not starting with 978 or
979. Tries to scan the supplemental if it is present. If the supplemental scanning failed, then the main
bar code 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 bar code
4 - 16 not starting with 414, 419, 434 or 439. Tries to scan the supplemental if it is present. If the
supplemental scanning failed, then the main bar code is returned.
• Supplemental 977 - Enables (auto-discriminate) supplemental for UPC/EAN codes starting with 977.
Disables reading of supplementals for another UPC/EAN bar code not starting with 977. Tries to scan
the supplemental if it is present. If the supplemental scanning failed, then the main bar code is
returned.
76
Page 77
DataWedge Configuration
Reader Params
Allows the configuration of parameters specific to the selected bar code reader.
• 1D Quiet Zone Level - Sets the level of aggressiveness in decoding bar codes with a reduced quiet zone
(the area in front of and at the end of a bar code), and applies to symbologies enabled by a Reduced Quiet
Zone parameter. Because higher levels increase the decoding time and risk of misdecodes, Zebra strongly
recommends enabling only the symbologies which require higher quiet zone levels, and leaving Reduced
Quiet Zone disabled for all other symbologies (SE4750 only). Options are:
• 0 - The scanner performs normally in terms of quiet zone.
• 1 - The scanner performs more aggressively in terms of quiet zone (default).
• 2 - The scanner only requires one side EB (end of bar code) for decoding.
• 3 - The scanner decodes anything in terms of quiet zone or end of bar code.
• Aim mode - Turns the scanner cross-hairs on or off.
• On - Cross-hair is on (default).
• Off - Cross-hair is off.
• Character Set Selection
• ISO-88959-1 - part of the ISO/IEC 8859 series of ASCII-based standard character encodings. It is
generally intended for Western European languages.
• Shift_JIS - Shift Japanese Industrial Standards (JIS) is a character encoding for the Japanese
language.
• GB18030 - GB 18030 is a Chinese government standard Chinese coded character set and defines the
required language and character support necessary for software in China.
• UTF-8 - A character encoding capable of encoding all possible characters, or code points, defined by
Unicode (default).
• Time Delay to Low Power - Sets the time the decoder remains active after decoding. After a scan
session, the decoder waits this amount of time before entering Low Power Mode. Options: 1 Second
(default), 30 Seconds, 1 Minute or 5 Minutes.
• Illumination mode - Turns imager illumination on and off. This option is only available when Bluetooth
Scanner is selected in the Barcode input, Scanner selection option.
• On - Illumination is on.
• Off - Illumination is off (default).
• Inverse 1D Mode - This parameter allows the user to select decoding on inverse 1D bar codes.
• Disable - Disables decoding of inverse 1D bar codes (default).
• Enable - Enables decoding of only inverse 1D bar codes.
• Auto - Allows decoding of both twice positive and inverse 1D bar codes.
• LCD Mode - Enables or disables LCD mode. LCD mode enhances the ability of the imager to read bar
codes from LCD displays such as cellphones.
• Disable - Disables the LCD mode (default).
• Enable - Enables LCD mode.
77
Page 78
DataWedge Configuration
• Picklist - Allows the imager to decode only the bar code that is directly under the cross-hair/reticle (+) part
of the pattern. This feature is useful in applications where multiple bar codes may appear in the field of
view during a decode session and only one of them is targeted for decode.
• Disabled – Disables Picklist mode. Any bar code within the field of view can be decoded (default).
• Enabled – Enables Picklist mode so that only the bar code under the projected reticle can be
decoded.
•
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.
• Aim Timer - Sets the maximum amount of time that aiming remains on (0 - 60,000 ms in increments of 100
ms). A value of 0 sets the aim to stay on indefinitely (default - 500).
• Aim Type - Set the aiming usage.
• Trigger - A trigger event activates decode processing, which continues until the trigger event ends or
a valid decode occurs.
• Timed Hold - A trigger pull and hold activates the laser for aiming, which continues until the trigger is
released, a valid decode, or the decode session time-out is expired.
• Timed Release - A trigger pull activates the laser for aiming, which continues until a valid decode or
the remaining decode session time has expired.
• Press and Release - A trigger pull and release activates the laser for aiming, which continues until a
trigger is pressed again, a valid decode, or the decode session time-out is expired.
• Continuous Read - When the imager detects an object in its field of view, it triggers and attempt to
decode.
• Beam Timer - Sets the maximum amount of time that the reader remains on (0 - 60,000 ms in increments
of 100 ms). A value of 0 sets the reader to stay on indefinitely (default -15000).
• Different Symbol Timeout - Controls the time the scanner is inactive between decoding different
symbols. Programmable in 500 msec increments from 0 to 5 seconds. The default is 500 msec.
• Same Symbol Timeout - Controls the time the scanner is inactive between decoding same symbols.
Programmable in 500 msec increments from 0 to 5 seconds. The default is 500 msec.
Scan Params
Allows the configuration of Code ID and decode feedback options.
• Code ID Type - A Code ID character identifies the code type of a scanned bar code. This is useful when
the reader is decoding more than one code type. Select a code ID character to insert between the prefix
and the decoded symbol.
• Code ID Type None - No prefix (default)
• Code ID Type AIM - Insert AIM Character prefix.
• Code ID Type Symbol - Insert Symbol character prefix.
• BT Disconnect On Exit - Bluetooth connection is disconnected when data capture application is closed
(RS507 only).
78
Page 79
DataWedge Configuration
• Connection Idle Time - Set connection idle time. The Bluetooth connection disconnects after being idle
for set time (RS507 only).
• Decode Haptic Feedback - Enable the device to vibrate upon a good decode (default - enabled).
• Display BT Address Barcode - Enable or disable displaying Bluetooth Address bar code if there is no
Bluetooth scanner being paired when application tries to enable the Bluetooth scanner (RS507 only).
• Establish Connection Time - The timeout which the device will try to enable or reconnect to the Bluetooth
scanner when the Bluetooth scanner is not in the vicinity or not paired (RS507 only).
• Audio Feedback Mode - Select good decode audio indication (RS507 only).
• Local Audio Feedback - Good decode audio indication on ET5X only.
• Remote Audio Feedback - Good decode audio indication on Bluetooth scanner only.
• Both - Good decode audio indication on ET5X and Bluetooth scanner (default).
• Disable - No good decode audio indication on either ET5X or Bluetooth scanner.
• LED Feedback Mode - Select good decode LED indication (RS507 only).
• Remote LED Feedback - Good decode LED indication on Bluetooth scanner only (default).
• Disable - No good decode LED indication on either ET5X or Bluetooth scanner.
• Decode Audio Feedback - Select an audio tone to sound upon a good decode (SE4750 only).
• Beep Volume Control - Set the good decode beep to a system or other sound. This allows for
independent control of the good beep volume.
NOTE Not all ringtones are fully supported as decode tones and those of longer length may be truncated when
used as a decode tone. The recommendation is to test the selected tone for operation before deployment
to a customer site.
• Media - Set the good decode beep to the media sound.
• Ringer - Set the good decode beep to the ringer sound.
• Notifications - Set the good decode beep to the notification sound (default).
• Alarms - Set the good decode beep to the alarm sound.
UDI Parameters
Not applicable.
Keep Enabled on Suspend
Keep the Bluetooth scanner enabled after suspend (default - disabled) (RS507 only).
Keystroke Output
Use to configure the Keystroke Output Plug-in for the profile.
• Enabled — Enables or disables this plug-in. A check in the checkbox indicates that the plug-in is enabled
(default - enabled).
79
Page 80
DataWedge Configuration
• Action key character - Enables decoding of a special character embedded within a bar code data for use
in native Android applications. This feature is helpful when populating or executing a form.
• None - Action key character feature is disabled (default).
• Tab - Tab character code in a bar code is processed. When DataWedge detects this character code in
a bar code, move the focus to the next field.
• Line feed - Line feed character code in a bar code is processed. When DataWedge detects this
character code in a bar code, move the focus to the next field.
• Carriage return - Carriage return character code in a bar code is processed. When DataWedge
detects this character code in a bar code, move the focus to the next field.
• Multi byte character display - Set the amount of time (in milliseconds) of the inter character delay for
multi byte characters. (default - 0.)
• Key event delay - Set the amount of time (in milliseconds) a delay for dispatching control characters as
keystrokes to the foreground application.
• Token selection - Not applicable.
• Advanced data formatting - is a way to customizing data before transmission. Use advanced data
formatting (ADF) to edit scan data to suit requirements.
• Enable - Enables or disables ADF. A check in the checkbox indicates that ADF is enabled (default -
disabled).
• Rules - ADF uses rules to customize data. These rules perform detailed actions when the data meets
certain criteria. One rule may consist of single or multiple criteria applied to single or multiple actions.
See Generating Advanced Data Formatting Rules on page 86 for more information.
• Basic data formatting - Allows the configuration of any data formatting for the related Output Plug-in.
When the plug-in is disabled, any data is passed on without modification.
• Enabled - Enables or disables Basic Data Formatting. A check in the checkbox indicates that it is
enabled (default - enabled).
• Prefix to data - Add characters to the beginning of the data when sent.
• Suffix to data - Add characters to the end of the data when sent.
• Send data - Set to transfer the captured data to the foreground application. Disabling this option
prevents the actual data from being transmitted. However, the prefix and suffix strings, if present, are
still transmitted even when this option is disabled (default - enabled).
• Send as hex - Set to send the data in hexadecimal format. A check in the checkbox indicates that the
plug-in is enabled (default - disabled).
• Send TAB key - Set to append a tab character to the end of the processed data. A check in the
checkbox indicates that the plug-in is enabled (default - disabled).
• Send ENTER key - Set to append an Enter character to the end of the processed data. A check in the
checkbox indicates that the plug-in is enabled (default - disabled).
Intent Output
Allows configuration of the Intent Output Plug-in for the profile. The Intent Output Plug-in allows the captured data
to be sent to an application in the form of an implicit Intent. Refer to the Android Developer web site for more
information, http://developer.android.com.
• Enabled - Enables or disables this plug-in. A check in the checkbox indicates that the plug-in is enabled
(default - disabled).
• Intent action - Enter the Intent Action name (required).
• Intent category - Enter the Intent Category name (required).
80
Page 81
DataWedge Configuration
• Intent delivery - Select the method by which the intent is delivered:
• Send via StartActivity
• Send via startService (default)
• Broadcast intent
• Receiver foreground flag - Not applicable.
• Advanced data formatting - is a way to customizing data before transmission. Use advanced data
formatting (ADF) to edit scan data to suit requirements.
• Enable - Enables or disables ADF. A check in the checkbox indicates that ADF is enabled (default -
disabled).
• Rules - ADF uses rules to customize data. These rules perform detailed actions when the data meets
certain criteria. One rule may consist of single or multiple criteria applied to single or multiple actions.
See Generating Advanced Data Formatting Rules on page 86 for more information.
• Basic data formatting - Allows configuration of any data formatting for the related Output Plug-in. When
the plug-in is disabled any data is passed on without modification.
• Enabled - Enables or disables Basic Data Formatting. A check in the checkbox indicates that it is
enabled (default - enabled).
• Prefix to data - Add characters to the beginning of the data when sent.
• Suffix to data - Add characters to the end of the data when sent.
• Send data - Set to transfer the captured data to the foreground application. Disabling this option
prevents the actual data from being transmitted. However, the prefix and suffix strings, if present, are
still transmitted even when this option is disabled (default - enabled).
• Send as hex - Set to send the data in hexadecimal format. A check in the checkbox indicates that the
plug-in is enabled (default - disabled).
• Send TAB key - Set to append a tab character to the end of the processed data. A check in the
checkbox indicates that the plug-in is enabled (default - disabled).
• Send ENTER key - Set to append an Enter character to the end of the processed data. A check in the
checkbox indicates that the plug-in is enabled (default - disabled).
Intent Overview
The core components of an Android application (its activities, services, and broadcast receivers) are activated by
intents. An intent is a bundle of information (an Intent object) describing a desired action - including the data to be
acted upon, the category of component that should perform the action, and other pertinent instructions. Android
locates an appropriate component to respond to the intent, launches a new instance of the component if one is
needed, and passes it the Intent object.
Components advertise their capabilities, the kinds of intents they can respond to, through intent filters. Since the
system must learn which intents a component can handle before it launches the component, intent filters are
specified in the manifest as <intent-filter> elements. A component may have any number of filters, each one
describing a different capability. For example, if the manifest contains the following:
<intent-filter . . . >
<action android:name=”android.intent.action.DEFAULT” />
<category android:name=”android.intent.category.MAIN” />
</intent-filter>
81
Page 82
DataWedge Configuration
In the Intent output plug-in configuration, the Intent action would be:
android.intent.category.DEFAULT
and the Intent category would be:
android.intent.category.MAIN.
The Intent delivery option allows the method by which the intent is delivered to be specified. The delivery
mechanisms are Send via startActivity, Send via startService or Broadcast intent.
The decode related data added to the Intent’s bundle can be retrieved using the
Intent.getStringExtra() and Intent.getSerializableExtra() calls, using the following
String tags:
• String LABEL_TYPE_TAG = “com.symbol.emdk.datawedge.label_type”;
• String contains the label type of the bar code.
• String DATA_STRING_TAG = “com.symbol.emdk.datawedge.data_string”;
• String contains the output data as a String. In the case of concatenated bar codes, the decode data is
concatenated and sent out as a single string.
• String DECODE_DATA_TAG = “com.symbol.emdk.datawedge.decode_data”;
• Decode data is returned as a list of byte arrays. In most cases there will be one byte array per decode.
For bar code symbologies that support concatenation e.g. Codabar, Code128, MicroPDF, etc., the
decoded data is stored in multiple byte arrays (one byte array per bar code). Clients can get data in
each byte array by passing an index.
Most scanning applications might want the user to be able to decode data and for that decode data to be sent to
the *current* activity but not necessarily displayed. If this is the case, then the activity needs to be marked as
‘singleTop’ in its AndroidManifest.xml file. If your activity is not defined as singleTop, then on every decode, the
system will create another copy of your Activity and send the decode data to this second copy.
Finally there will be a configuration option for each process plug-in so that the process plug-in can be configured
specifically for the intent output, which in this case is the basic data formatting process plug-in.
IP Output
NOTE IPWedge application is required on a host computer. Download the IPWedge application from the Support
Central web site: www.zebra.com/support.
IP Output allows DataWedge to send captured data to a host computer via a network connection. Captured data
can be sent over an IP network to a specified IP address and port using either TCP or UDP transport protocols.
• Enabled - Enables or disables this plug-in. A check in the checkbox indicates that the plug-in is enabled
(default - disabled).
• Remote Wedge - Enable or disable the Remote Wedge option (default - enabled). Remote Wedge is used
with the IPWedge application.
• Protocol - Select the protocol used by the remote application. Options: TCP (default) or UDP.
• IP address - Enter the IP address used by the remote application (default - 0.0.0.0).
• Port - Enter the port number used by the remote application (default - 58627).
• Token selection - Not applicable.
82
Page 83
DataWedge Configuration
• Advanced data formatting - is a way of customizing data before transmission. Use advanced data
formatting (ADF) to edit scan data to suit requirements.
• Enable - Enables or disables ADF. A check in the checkbox indicates that ADF is enabled (default -
disabled).
• Rules - ADF uses rules to customize data. These rules perform detailed actions when the data meets
certain criteria. One rule may consist of single or multiple criteria applied to single or multiple actions.
See Generating Advanced Data Formatting Rules on page 86 for more information.
• Basic data formatting - Allows configuration of any data formatting for the related Output Plug-in. When
the plug-in is disabled any data is passed on without modification.
• Enabled - Enables or disables Basic Data Formatting. A check in the checkbox indicates that it is
enabled (default - enabled).
• Prefix to data - Add characters to the beginning of the data when sent.
• Suffix to data - Add characters to the end of the data when sent.
• Send data - Set to transfer the captured data to the foreground application. Disabling this option
prevents the actual data from being transmitted. However, the prefix and suffix strings, if present, are
still transmitted even when this option is disabled (default - enabled).
• Send as hex - Set to send the data in hexadecimal format. A check in the checkbox indicates that the
plug-in is enabled (default - disabled).
• Send TAB key - Set to append a tab character to the end of the processed data. A check in the
checkbox indicates that the plug-in is enabled (default - disabled).
• Send ENTER key - Set to append an Enter character to the end of the processed data. A check in the
checkbox indicates that the plug-in is enabled (default - disabled).
Usage
This section provides information on how to configure IP Output using the DataWedge configuration user interface.
To use IP Output in a particular DataWedge profile (for example: Profile0), scroll downward on IP Output.
83
Page 84
Figure 18 IP Output Screen
DataWedge Configuration
Using IP Output with IPWedge
IPWedge is a computer application that can be easily configured to retrieve data sent over network by DataWedge
IP Output. Refer to the IPWedge User Manual on how to install and configure in a host computer. To enable IP
Output to send captured data to a remote computer that is installed with IPWedge:
1. In IP Output, touch Enabled.
A check appears in the checkbox.
2. Ensure Remote Wedge option is enabled.
3. Touch Protocol.
4. In the Choose protocol dialog box, touch the same protocol selected for the IPWedge computer application.
(TCP is the default).
Figure 19 Protocol Selection
5. Touch IP Address.
6. In the Enter IP Address dialog box, enter the IP address of host computer to send data to.
84
Page 85
DataWedge Configuration
Figure 20 IP Address Entry
7. Touch Port.
8. In the Enter port number dialog box, enter same port number selected for IPWedge computer application.
Figure 21 Port Number Entry
9. Configure Advanced data formatting and Basic data formatting Plug-in if any required modification to be
done to captured data before sending to remote computer.
Using IP Output without IPWedge
IP Output Plug-in can be used to send captured data from DataWedge to a remote device or host computer without
using IPWedge. At the data receiving end, the host computer or mobile device should have an application, that
listens to TCP or UDP data coming from a configured port and IP address in the IP Output plug-in. To enable IP
Output to send captured data to a remote computer:
1. In IP Output, touch Enabled.
2. A check appears in the checkbox.
3. Ensure Remote Wedge option is disabled.
4. Touch Protocol.
5. In the Choose protocol dialog box, touch the same protocol selected in the client application. (TCP is the
default).
Figure 22 Protocol Selection
6. Touch IP Address.
7. In the Enter IP address dialog box, enter the IP address of host computer to send data to.
85
Page 86
DataWedge Configuration
Figure 23 IP Address Entry
8. Touch Port.
9. In the Enter port number dialog box, enter the port number that the host computer application is listening on.
Figure 24 Port Number Entry
10. Configure Advanced Data Formatting and Basic Data Formatting Plug-in if any required modification to be
done to captured data before sending to remote computer.
Generating Advanced Data Formatting Rules
The ADF plug-in applies rules (actions to be performed based on defined criteria) to the data received via an input
plug-in before sending it to the output plug-in.
• Rules - The ADF process plug-in consists of one or more rules. DataWedge formats the output data
according to the first matching rule. A rule is a combination of criteria and a set of actions to be performed,
upon fulfillment of the criteria set in the rule.
• Criteria - Criteria can be set according to Input plug-in, symbology, matching string within the data (at the
specified position) and/or data length. Received data must match the defined criteria in order for the data
to be processed.
• Actions - A set of procedures defined to format data. There are four types of actions which are for
formatting cursor movement, data modification, data sending and delay specifications. An action can be
defined to send the first number of characters to the Output plug-in, pad the output data with spaces or
zeros, remove spaces in data, etc.
Configuring ADF Plug-in
Configuring the ADF plug-in consists of creating a rule, defining the criteria and defining the actions.
1. Touch > .
2. Touch a DataWedge profile.
3. In Keystroke Output, touch Advanced data formatting.
86
Page 87
DataWedge Configuration
Figure 25 Advanced Data Formatting Screen
4. Touch the Enable checkbox to enable ADF.
Creating a Rule
NOTE By default, Rule0, is the only rule in the Rules list.
1. Touch .
2. Touch New rule.
3. Touch the Enter rule name text box.
4. In the text box, enter a name for the new rule.
5. Touch OK.
Deleting a Rule
1. Touch and hold on a rule until the context menu appears.
2. Touch Delete to delete the rule from the Rules list.
NOTE When there is no rule available for ADF plug-in or all rules are disabled, DataWedge passes decoded data
to the output plug-in without processing the data.
Defining Criteria
1. Touch Criteria.
87
Page 88
Figure 26 Criteria Screen
DataWedge Configuration
2. Touch String to check for option to specify the string that must be present in the data.
3. In the Enter the string to check for dialog box, enter the string.
4. Touch OK.
5. Touch String position option to specify the position of the string specified in the String to check for option.
The ADF rule is only applied if the specific string in String to check for is found at the specified String
position location (zero for the start of the string).
6. Touch the + or - to change the value.
7. Touch OK.
8. Touch String length option to specify a length for the received data. The ADF rule only applies to the bar
code data with that specified length.
9. Touch the + or - to change the value.
10. Touch OK.
11. Touch Source criteria option to associate an input device to an ADF rule. The ADF rule only applies to data
received from associated input devices.
12. Touch Barcode input.
13. Touch the Source enabled checkbox to accept data from this source.
88
Page 89
Figure 27 Barcode Input Screen
DataWedge Configuration
14. Touch the All decoders enabled checkbox to select all bar code symbologies. Deselect the All decoders
enabled checkbox to individually select the symbologies.
15. Touch until the Rule screen appears.
16. If required, repeat steps to create another rule.
17. Touch until the Rule screen appears.
Defining an Action
NOTE By default the Send remaining action is in the Actions list.
1. Touch .
2. Touch New action.
3. In the New action menu, select an action to add to the Actions list. See Table 7 on page 90 for a list of
supported ADF actions.
4. Some Actions require additional information. Touch the Action to display additional information fields.
5. Repeat steps to create more actions.
6. Touch .
7. Touch .
Deleting a Rule
1. Touch and hold on a rule until the context menu appears.
89
Page 90
DataWedge Configuration
2. Touch Delete to delete the rule from the Rules list.
NOTE When there is no rule available for ADF plug-in or all rules are disabled, DataWedge passes decoded data
to the output plug-in without processing the data.
Order Rules List
NOTE When there are no rules defined, ADF passes the captured data through as is. In contrast, when rules are
defined but all are disabled, ADF does not pass any captured data through.
Rules are processed in top-down order. The rules that are on top of the list are processed first. Use the icon next to
the rule to move it to another position in the list.
Table 7 ADF Supported Actions
Type Actions Description
Cursor
Movement
Skip ahead Moves the cursor forward by a specified number of characters.
Enter the number of characters to move the cursor ahead.
Skip back Moves the cursor back by a specified number of characters. Enter
the number of characters to move the cursor back.
Skip to start Moves the cursor to the beginning of the data.
Move to Moves the cursor forward until the specified string is found. Enter
the string in the data field.
Move past a Moves the cursor forward past the specified string. Enter the string
in the data field.
90
Page 91
DataWedge Configuration
Table 7 ADF Supported Actions (Continued)
Type Actions Description
Data
Modification
Crunch spaces Remove spaces between words to one and remove all spaces at
the beginning and end of the data.
Stop space crunch Stops space crunching. This disables the last Crunch spaces
action.
Remove all spaces Remove all spaces in the data.
Stop space removal Stop removing spaces. This disables the last Remove all spaces
action.
Remove leading zeros Remove all zeros at the beginning of data.
Stop zero removal Stop removing zeros at the beginning of data. This disables the
previous Remove leading zeros action.
Pad with zeros Left pad data with zeros to meet the specified length. Enter the
number zeros to pad.
Stop pad zeros Stop padding with zeros. This disables the previous Pad with
zeros action.
Pad with spaces Left pad data with spaces to meet the specified length. Enter the
number spaces to pad.
Stop pad spaces Stop padding with spaces. This disables the previous Pad with
spaces action.
Replace string Replaces a specified string with a new string. Enter the string to
Stop all replace string Stop all Replace string actions.
Remove characters Remove the number of characters specified in given positions
Stop remove chars Stops removing characters from subsequent send actions.
Data
Sending
Send next Sends the specified number of characters from the current cursor
Send remaining Sends all data that remains from the current cursor position.
Send up to Sends all data up to a specified string. Enter the string.
Send pause Pauses the specified number of milliseconds before continuing the
Send string Sends a specified string. Enter the string to send.
Send char Sends a specified ASCII/ Unicode character. Enter a character
Deleting an Action
replace and the string to replace it with.
when send actions are executed.
position. Enter the number of characters to send.
next action. Enter the amount of time in milliseconds.
value. The maximum Unicode character value can be entered is
U-10FFFF (= 1114111 in decimal).
1. Touch and hold the action name.
91
Page 92
DataWedge Configuration
2. Select Delete action from the context menu.
ADF Example
The following illustrates an example of creating Advanced Data Formatting:
When a user scans a bar code with the following criteria:
• Code 39 bar code.
• length of 12 characters.
• contains 129 at the start position.
Modify the data as follows:
• Pad all sends with zeros to length 8.
• send all data up to character X.
• send a space character.
To create an ADF rule for the above example:
1. Touch > > Profile0.
2. Under Keystroke Output, touch Advanced data formatting.
3. Touch Enable.
4. Touch Rule0.
5. Touch Criteria.
6. Touch String to check for.
7. In the Enter the string to check for text box, enter 129 and then touch OK.
8. Touch String position.
9. Verify the value is 0.
10. Touch String length.
11. Change value to 12.
12. Touch OK.
13. Touch Source criteria.
14. Touch Barcode input.
15. Touch All decoders enabled to disable all decoders.
16. Touch Code 39.
17. Touch three times.
18. Touch Actions.
19. Touch and hold on the Send remaining rule until a menu appears.
20. Touch Delete action.
21. Touch .
22. Touch New action.
23. Select Pad with zeros.
24. Touch the Pad with zeros rule.
25. Touch How many.
92
Page 93
DataWedge Configuration
26. Change value to
27. Touch .
28. Touch .
29. Touch New action.
30. Select Send up to.
31. Touch Send up to rule.
32. Touch String.
33. In the Enter a string text box, enter X.
34. Touch OK.
35. Touch .
36. Touch .
37. Touch New action.
38. Select Send char.
39. Touch Send char rule.
40. Touch Character code.
41. In the Enter character code text box, verify 32 value in field.
42. Touch OK.
and then touch OK.
8
43. Touch .
Figure 28 ADF Sample Screen
44. Touch .
93
Page 94
DataWedge Configuration
45. Ensure that an application is open on the device and a text field is in focus (text cursor in text field).
46. Aim the exit window at the bar code.
Figure 29 Sample Bar Code
47. Press and hold the scan key.
The red laser aiming pattern turns on to assist in aiming. Ensure that the bar code is within the area formed by
the aiming pattern. The LED light red to indicate that data capture is in process.
48. A beep sounds to indicate the bar code was decoded successfully. The formatted data 00001299 appears in
the text field.
Scanning a Code 39 bar code of 1299X15598 does not transmit data (rule is ignored) because the bar code
data did not meet the length criteria.
Figure 30 Formatted Data
DataWedge Settings
The DataWedge Settings screen provides access to general, non-profile related options. Touch > Settings.
94
Page 95
DataWedge Configuration
Figure 31 DataWedge Settings Window
• DataWedge enabled - Enables or disables DataWedge. To disable DataWedge uncheck this option.
• Enable logging - Enables or disables DataWedge debug messages in logcat. To enable check this
option.
• Disable app list - Disables scanning functions for selected apps and/or activities anywhere on the device.
IMPORTANT: Apps/activities associated with a specific profile cannot be disabled.
Disabled apps/activities cannot be associated with a profile.
Disabling a parent package disables all of its activities.
A disabled activity does not disable the parent or its other activities.
• Import - allows import of a DataWedge configuration file. The imported configuration replaces the current
configuration.
• Export - allows export of the current DataWedge configuration.
• Import Profile - allows import of a DataWedge profile file.
• Export Profile - allows export of a DataWedge profile.
• Restore - return the current configuration back to factory defaults.
Exporting a Configuration File
1. Touch > .
2. Touch .
3. Touch Settings.
4. Touch Export.
95
Page 96
DataWedge Configuration
5. In the Export to dialog box, select the location to save the file.
6. Touch Export. The configuration file (
datawedge.db
) is saved to the selected location.
Importing a Configuration File
1. Copy the configuration file to the Internal Storage
/storage/emulated/0/Android/data/com.symbol.datawedge/files
2. Touch > .
3. Touch .
4. Touch Settings.
5. Touch Import.
6. Touch filename to import.
7. Touch Import. The configuration file (
datawedge.db
) is imported and replaces the current configuration.
Exporting a Profile
1. Touch > .
folder.
2. Touch .
3. Touch Settings.
4. Touch Export Profile.
5. Touch the profile to export.
6. Touch Export.
The profile file (
dwprofile_x.db
, where x = name of the profile) is saved to the selected location.
Importing a Profile File
NOTE Do not change the filename of the of the profile file. If the filename is changed, the file will not be imported.
1. Copy the profile file to the Internal Storage
/storage/emulated/0/Android/data/com.symbol.datawedge/files folder.
2. Touch > .
3. Touch .
4. Touch Settings.
5. Touch Import Profile.
6. Touch the profile file to import.
7. Touch Import. The profile file (
the profile list.
dwprofile_x.db
, where x = the name of the profile) is imported and appears in
Restoring DataWedge
To restore DataWedge to the factory default configuration:
1. Touch > .
96
Page 97
DataWedge Configuration
2. Touch .
3. Touch Settings.
4. Touch Restore.
5. Touch Yes.
Configuration and Profile File Management
The configuration or profile settings for DataWedge can be saved to a file for distribution to other devices.
After making configuration or profile changes, export the new configuration or profile to the root of the Internal
Storage. The configuration file created is automatically named
automatically named
Storage of other devices and imported into DataWedge on those devices. Importing a configuration or profile
replaces the existing settings.
dwprofile_x.db
, where x is the profile name. The files can then the copied to the Internal
Enterprise Folder
datawedge.db
. The profile file created is
Internal storage contains the Enterprise folder (
after an Enterprise reset. After an Enterprise Reset, DataWedge checks folder
/enterprise/device/settings/datawedge/enterprisereset/
dwprofile_x.db
. If the file is found, it imports the file to replace any existing configuration or profile.
NOTE A Factory Reset deletes all files in the Enterprise folder.
/enterprise
for a configuration file,
). The Enterprise folder is persistent and maintains data
datawedge.db
or a profile file,
Auto Import
DataWedge supports remote deployment of a configuration to a device, using tools such as MSP. DataWedge
monitors the
(
datawedge.db
or profile file is found, it imports the file to replace any existing configuration or profile. Once the file has been
imported it is deleted from the folder.
While DataWedge is running it receives a notification from the system that a file has been placed into the
/enterprise/device/settings/datawedge/autoimport
configuration or profile, replacing the existing one and delete the file. DataWedge begins using the imported
configuration immediately.
/enterprise/device/settings/datawedge/autoimport
) or a profile file (
NOTE A Factory Reset deletes all files in the Enterprise folder.
dwprofile_x.db
). When DataWedge launches it checks the folder. If a configuration
folder. When this occurs, DataWedge imports this new
folder for the DataWedge configuration file
It is strongly recommended that the user exits DataWedge before remotely deploying any configuration or
profile. It is required that the file permissions are set to 666.
Programming Notes
The following paragraphs provide specific programming information when using DataWedge.
97
Page 98
DataWedge Configuration
Overriding Trigger Key in an Application
To override the trigger key in an application, create a profile for the application that disables the Barcode input. In
the application, use standard APIs, such as onKeyDown() to listen for the KEYCODE_BUTTON_L1 and
KEYCODE_BUTTON_R1 presses.
Capture Data and Taking a Photo in the Same Application
To be able to capture bar code data and take a photo in the same application:
• Create a Datawedge profile pertaining to the picture taking Activity in your application that disables
scanning and use standard Android SDK APIs to control the Camera.
• The default Datawedge profile takes care of the scanning in the application. You might want to create
another DataWedge profile that caters to any specific scanning needs, associated to your Application's
Activity pertaining to scanning.
Soft Scan Feature
DataWedge allows a native Android application to programmatically start, stop, or toggle the scan trigger state.
The application can issue an Android Broadcast Intent, to control the scanner, without requiring the scan key to be
pressed. The active DataWedge profile is required to control all the parameters during a scan operation.
The structure of the broadcast intent that resolves to the soft scan is:
action: “com.symbol.emdk.datawedge.api.ACTION_SOFTSCANTRIGGER”
extras: This is a String name/value pair that contains trigger state details.
name: “com.symbol.emdk.datawedge.api.EXTRA_PARAMETER”
value: “START_SCANNING” or “STOP_SCANNING” or “TOGGLE_SCANNING”
Sample
Intent sendIntent = new Intent();
sendIntent.setAction(“com.symbol.emdk.datawedge.api.ACTION_SOFTSCANTRIGGER”);
sendIntent.putExtra(“com.symbol.emdk.datawedge.api.EXTRA_PARAMETER”,
“TOGGLE_SCANNING”);
sendBroadcast(sendIntent);
Scanner Input Plugin
The ScannerInputPlugin API command can be used to enable/disable the scanner plug-in being used by the
currently active Profile. Disabling the scanner plug-in effectively disables scanning in that Profile, regardless of
whether the Profile is associated or unassociated. Valid only when Barcode Input is enabled in the active Profile.
NOTE Use of this API changes only the runtime status of the scanner; it does not make persistent changes to the
Profile.
98
Page 99
DataWedge Configuration
Function Prototype
Intent i = new Intent();
i.setAction(ACTION);
i.putExtra(EXTRA_DATA, "<parameter>");
Parameters
action: String "com.symbol.datawedge.api.ACTION_SCANNERINPUTPLUGIN"
extra_data: String "com.symbol.datawedge.api.EXTRA_PARAMETER"
<parameter>: The parameter as a string, using either of the following:
• "ENABLE_PLUGIN" - enables the plug-in
• "DISABLE_PLUGIN" - disables the plug-in
Return Values
None.
Error and debug messages will be logged to the Android logging system which then can be viewed and filtered by
the logcat command. You can use logcat from an ADB shell to view the log messages, e.g.
$ adb logcat -s DWAPI
Error messages will be logged for invalid actions and parameters.
Example
// define action and data strings
String scannerInputPlugin = "com.symbol.datawedge.api.ACTION_SCANNERINPUTPLUGIN";
String extraData = "com.symbol.datawedge.api.EXTRA_PARAMETER";
public void onResume() {
// create the intent
Intent i = new Intent();
// set the action to perform
i.setAction(scannerInputPlugin);
// add additional info
i.putExtra(extraData, "DISABLE_PLUGIN");
// send the intent to DataWedge
context.this.sendBroadcast(i);
}
99
Page 100
DataWedge Configuration
Comments
This Data Capture API intent allows the scanner plug-in for the current Profile to be enabled or disabled. For
example, activity A launches and uses the Data Capture API intent to switch to ProfileA in which the scanner
plug-in is enabled, then at some point it uses the Data Capture API to disable the scanner plug-in. Activity B is
launched. In DataWedge, ProfileB is associated with activity B. DataWedge switches to ProfileB. When activity A
comes back to the foreground, in the
switch back to ProfileA, then use the Data Capture API intent again to disable the scanner plug-in, to return back to
the state it was in.
NOTE Use of this API changes only the runtime status of the scanner; it does not make persistent changes to the
Profile.
The above assumes that ProfileA is not associated with any applications/activities, therefore when focus
switches back to activity A, DataWedge will not automatically switch to ProfileA therefore activity A must
switch back to ProfileA in its onResume method. Because DataWedge will automatically switch Profile
when an activity is paused, it is recommended that this API function be called from the onResume method
of the activity.
onResume method, activity A needs to use the Data Capture API intent to
Enumerate Scanners
Use the enumerateScanners API command to get a list of scanners available on the device.
Function Prototype
Intent i = new Intent();
i.setAction(ACTION);
Parameters
action: String "com.symbol.datawedge.api.ACTION_ENUMERATESCANNERS"
Return Values
The enumerated list of scanners will be returned via a broadcast Intent. The broadcast Intent action is
"com.symbol.datawedge.api.ACTION_ENUMERATEDSCANNERLIST" and the list of scanners is returned as a
string array (see the example below).
Error and debug messages will be logged to the Android logging system which then can be viewed and filtered by
the logcat command. You can use logcat from an ADB shell to view the log messages, e.g.
$ adb logcat -s DWAPI
Error messages will be logged for invalid actions and parameters
100
Loading...