Zebra MC9090-Z RFID Handheld Reader, MC3190 Handheld Computer Provider for Biztalk RFID Mobile Developer Guide
PROVIDER FOR BIZTALK
RFID MOBILE
DEVELOPER GUIDE
PROVIDER FOR BIZTALK RFID MOBILE
DEVELOPER GUIDE
72E-167372-02
Revision A
April 2015
ii PROVIDER FOR BIZTALK RFID MOBILE DEVELOPER GUIDE
© 2015 ZIH Corp and/or its affiliates. All rights reserved.
No part of this publication may be reproduced or used in any form, or by any electrical or mechanical means,
without permission in writing from Zebra. This includes electronic or mechanical means, such as photocopying,
recording, or information storage and retrieval systems. The material in this ma nual is subject to change
without notice.
The software is provided strictly on an “as i s” basis. All sof twar e, including firmware, furnished to the user is on
a licensed basis. Zebra grants to the user a non-transferable and non-exclusive license to use each software
or firmware program delivered hereunder (licensed program) . Except as n oted below, such license may not be
assigned, sublicensed, or otherwise tran sfe rr e d by th e user without prior written consent of Zebra. No right to
copy a licensed program in whole or in part is granted, exce pt as permitted unde r copyright law. The user shall
not modify , merge, or incorporate any for m or portion of a licensed program with other pro gram material, create
a derivative work from a licensed program , or us e a li censed program in a network without written permission
from Zebra. The user agrees to maintain Zebra’s copyright notice on the licensed programs delivered
hereunder , and to include the same on any authorized copies it makes, in whole or in part. The user agrees not
to decompile, disassemble, decode, or reverse engineer any licensed program delivered to the user or any
portion thereof.
Zebra reserves the right to make changes to any software or product to improve reliability, function, or design.
Zebra does not assume any product liability arising out of, or in connection with, the application or use of any
product, circuit, or application described herein.
No license is granted, either expressly or by implication, estoppel, or otherwise under any Zebra Technologies
Corporation, intellectual property rights. An implied license only exists for equipment, circuits, and subsystems
contained in Zebra products.
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.
Zebra Technologies Corporation
Lincolnshire, IL U.S.A.
http://www.zebra.com
Warranty
For the complete Zebra hardware product warranty statement, go to:
http://www.zebra.com/warranty.
Revision History
Changes to the original guide are listed below:
Change Date Description
-01 Rev A 8/2012 Initial release
-02 Rev A 4/2015 Zebra Re-Branding
iii
iv PROVIDER FOR BIZTALK RFID MOBILE DEVELOPER GUIDE
TABLE OF CONTENTS
Warranty ......................................................................................................................................... ii
Revision History.............................................................................................................................. iii
About This Guide
Introduction..................................................................................................................................... ix
Chapter Descriptions ...................................................................................................................... ix
Notational Conventions................................................................................................................... x
Related Documents ........................................................................................................................ x
Service Information......................................................................................................................... xi
Chapter 1: Getting Started
Introduction .................................................................................................................................... 1-1
Installation ...................................................................................................................................... 1-1
Requirements ........................................................................................................................... 1-1
Installing Zebra Provider From PC ........................................................................................... 1-2
Installing Zebra Provider From Device Using .Cab File ........................................................... 1-8
Verification ............................................................................................................................... 1-11
Chapter 2: Configuration
Introduction .................................................................................................................................... 2-1
Provider Properties ........................................................................................................................ 2-1
Property Descriptions ............................................................................................................... 2-3
Device Properties ........................................................................................................................... 2-4
General Properties ................................................................................................................... 2-4
RF Properties ........................................................................................................................... 2-7
Command Properties ............................................................................................................... 2-8
Notification Properties .............................................................................................................. 2-9
Custom Device Properties ....................................................................................................... 2-10
Event Processing Service Properties ....................................................................................... 2-11
Inventory Control Properties .................................................................................................... 2-12
API3 version related properties ................................................................................................ 2-13
vi PROVIDER FOR BIZTALK RFID MOBILE DEVELOPER GUIDE
Management Related Properties ............................................................................................. 2-14
Reader Capabilities Properties ................................................................................................ 2-15
Source Properties .................................................................................................................... 2-16
Antenna Configuration Custom Properties .............................................................................. 2-17
Singulation and Pre-filter Properties ........................................................................................ 2-19
RF Properties ........................................................................................................................... 2-22
Chapter 3: Basic Operations
Introduction .................................................................................................................................... 3-1
Reading Tags ................................................................................................................................ 3-1
Chapter 4: Supported Commands
Introduction .................................................................................................................................... 4-1
General Commands ....................................................................................................................... 4-1
Gen2 Commands ..................................................................................................................... 4-3
Vendor Commands .................................................................................................................. 4-7
AccessSequence ..................................................................................................................... 4-8
Index
Table of Contents vii
viii PROVIDER FOR BIZTALK RFID MOBILE DEVELOPER GUIDE
ABOUT THIS GUIDE
Introduction
The Zebra Provider for BizTalk RFID Mobile Developer Guide provides software developers information on
creating applications that use the Microsoft BizTalk RFID platform for the Zebra hand held MC3190Z and MC9090Z
RFID Readers.
This guide assumes familiarity with the Microsoft BizTalk programming model and RFID documentation, as well as
with Microsoft .NET, C#, and Visual Studio 2005 or above.
Chapter Descriptions
Topics covered in this guide are as follows:
•
Chapter 1, Getting Started describes how to install Zebra Provider.
•
Chapter 2, Configuration includes information on configuring Zebra Provider.
•
Chapter 3, Basic Operations includes information on how to use the Zebra provider, including tag reading
and device diagnostics.
•
Chapter 4, Supported Commands includes information on the commands supported by the Zebra Provider,
including general and Gen2 commands.
x PROVIDER FOR BIZTALK RFID MOBILE DEVELOPER GUIDE
*Baud Rate 9600
Feature/Option
* Indicates Default
Notational Conventions
The following conventions are used in this document:
•
Italics are used to highlight the following:
• Cha
• Dialog box, window and screen names
• Drop-down list and list box names
• Check box and radio button names
•
Bold text is used to highlight the following:
• Pr
• Key names on a keypad
• Button names on a screen.
•
bullets (•) indicate:
• Action items
• L
• Lists of required steps that are not necessarily sequential
pters and sections in this and related documents
operty and command names
ists of alternatives
•
Sequential lists (e.g., those that describe step-by-s te p pr oc ed ur e s) ap pe a r as nu m be re d lists.
•
Throughout the programming bar code menus, asterisks (*) are used to denote default parameter
settings.
Related Documents
Refer to the Product Reference Guide for the mobile RFID reader for product-specific information.
For the latest version of this guide an
d all Zebra guides, go to: http://www.zebra.com/support.
Service Information
If you have a problem using the equipment, contact your facility's technical or systems support. If there is a
problem with the equipment, they will contact the Zebra Global Customer Support Center at:
http://www.zebra.com/support.
When contacting Zebra 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 e-mail, telephone or fax within the time limits set forth in service agreements.
If your problem cannot be solved by Zebra 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 business product from a Zebra business partner, please contact that business partner
for support.
About This Guide xi
xii PROVIDER FOR BIZTALK RFID MOBILE DEVELOPER GUIDE
CHAPTER 1 GETTING STARTED
Introduction
The Zebra DSPI Provider enables software developers to write applications using Microsoft's BizTalk RFID
programming model for the Zebra hand held MC3190Z and MC9090 Z RFID Readers. The provider supports
all basic operations including connecting to th e ra dio mo dule, reading tags continuously, and reading tags on
demand.
Installation
Requirements
•
Windows Mobile 6.0 (and above)
•
Microsoft BizTalk Mobile RFID
1 - 2 PROVIDER FOR BIZTALK RFID MOBILE DEVELOPER GUIDE
Install Zebra DSPI Provider to the hand held mobile device from the PC or to the device directly through .cab
file.
Installing Zebra Provider From PC
1. Copy the setup.exe and the MotorolaProviderInstaller.msi to a local directory on the host PC. The file is
available on Zebra support at http://www.zebra.com/support.
2. Double-click setup.exe to launch.
3. Run installer sequence and accept all defaults.
Figure 1-1
Initial Installer Window
4. .Select Next to start installation.
Getting Started 1 - 3
Figure 1-2
Confirm Installation Window
1 - 4 PROVIDER FOR BIZTALK RFID MOBILE DEVELOPER GUIDE
Figure 1-3
Installing Window
5. The Installer begins installing the cab onto the device automatically.
Getting Started 1 - 5
Figure 1-4
Downloading Complete Window
1 - 6 PROVIDER FOR BIZTALK RFID MOBILE DEVELOPER GUIDE
6. Continue to device UI for completing installation.
Figure 1-5
Device Install Location Window
Figure 1-6
Device Install Window
Getting Started 1 - 7
Figure 1-7
Device Installation Confirmation Window
Loading...