RFID READER SOFTWARE INTERFACE CONTROL GUIDE - PDF

Please download to get full document.

View again

of 174
All materials on our website are shared by users. If you have any questions about copyright issues, please report us to resolve them. We are always happy to assist you.
Information Report
Category:

Nature & Wildlife

Published:

Views: 33 | Pages: 174

Extension: PDF | Download: 2

Share
Related documents
Description
RFID READER SOFTWARE INTERFACE CONTROL GUIDE RFID READER SOFTWARE INTERFACE CONTROL GUIDE 72E Revision A February 2012 ii RFID Reader Software Interface Control Guide Motorola Solutions,
Transcript
RFID READER SOFTWARE INTERFACE CONTROL GUIDE RFID READER SOFTWARE INTERFACE CONTROL GUIDE 72E Revision A February 2012 ii RFID Reader Software Interface Control Guide Motorola Solutions, Inc. 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 Motorola. This includes electronic or mechanical means, such as photocopying, recording, or information storage and retrieval systems. The material in this manual is subject to change without notice. The software is provided strictly on an as is basis. All software, including firmware, furnished to the user is on a licensed basis. Motorola grants to the user a non-transferable and non-exclusive license to use each software or firmware program delivered hereunder (licensed program). Except as noted below, such license may not be assigned, sublicensed, or otherwise transferred by the user without prior written consent of Motorola. No right to copy a licensed program in whole or in part is granted, except as permitted under copyright law. The user shall not modify, merge, or incorporate any form or portion of a licensed program with other program material, create a derivative work from a licensed program, or use a licensed program in a network without written permission from Motorola. The user agrees to maintain Motorola 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. Motorola reserves the right to make changes to any software or product to improve reliability, function, or design. Motorola 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 Motorola, Inc., intellectual property rights. An implied license only exists for equipment, circuits, and subsystems contained in Motorola products. MOTOROLA, MOTO, MOTOROLA SOLUTIONS and the Stylized M Logo are trademarks or registered trademarks of Motorola Trademark Holdings, LLC and are used under license. All other trademarks are the property of their respective owners. Motorola Solutions, Inc. One Motorola Plaza Holtsville, New York Warranty For the complete Motorola hardware product warranty statement, go to: iii Revision History Changes to the original manual are listed below: Change Date Description -01 Rev A 11/2009 Initial release -02 Rev A 7/2010 Added reader management custom extensions, LLRP custom messages, and LLRP custom parameters; added SNMP chapter, updated XML schema. -03 Rev A 6/2011 Added Fujitsu commands. -04 Rev A 2/2012 Added: RM and LLRP custom extension tables by product Removed: MOTO_C2_COMMAND, MOTO_C2_COMMAND_RESPONSE. iv RFID Reader Software Interface Control Guide TABLE OF CONTENTS Warranty... ii Revision History... iii About This Guide Introduction... xiii Configurations... xiv Chapter Descriptions... xv Notational Conventions... xv Related Documents and Software... xvi Service Information... xvi Chapter 1: Getting Started Introduction RFID Control and Data Plane Reader (Device) Management Plane Audience Motorola Extensions Chapter 2: LLRP Custom Extensions Operation Introduction Asynchronous Tag Events in Autonomous Mode Operation Filtering Tags Based on RSSI and Time Class 1 Generation 2 (C1G2) Extensions Operation Chapter 3: Reader Management Custom Extensions Introduction RM Extensions by Product ReaderDevice.getCPUUsage ReaderDevice.getRAMUsage ReaderDevice.doFirmwareUpdate vi RFID Reader Software Interface Control Guide ReaderDevice.setFirmwareUpdateParams ReaderDevice.updateCertificate ReaderDevice.setUserLED ReaderDevice.getFlashMemoryUsage ReaderDevice.getFirmwareUpdateProgress ReaderDevice.getUserList ReaderDevice.doAddUser ReaderDevice.doDelUser ReaderDevice.doChangePassword ReaderDevice.doChangeUserRole ReaderDevice.doLogin ReaderDevice.doLogout ReaderDevice.doChangeDefaultUserPassword ReaderDevice.getSupportedRegionList ReaderDevice.getRegionStandardList ReaderDevice.getActiveRegion ReaderDevice.setActiveRegion ReaderDevice.getMaxAntennasSupported ReaderDevice.setAlarmNotificationSNMPHost ReaderDevice.getAlarmNotificationSNMPHost ReaderDevice.getNetworkInterfaceSettings ReaderDevice.setNetworkInterfaceSettings ReaderDevice.setDHCPConfig ReaderDevice.getWebServerSecuritySetting ReaderDevice.setWebServerSecuritySetting ReaderDevice.getShellStatus ReaderDevice.setShellStatus ReaderDevice.getFTPStatus ReaderDevice.setFTPStatus ReaderDevice.getUSBMode ReaderDevice.setUSBMode ReaderDevice.getLLRPConfig ReaderDevice.setLLRPConfig ReaderDevice.isLLRPRunning ReaderDevice.isLLRPConnected ReaderDevice.ConnectLLRP ReaderDevice.viewSystemLog ReaderDevice.viewAccessLog ReaderDevice.viewCurrentCertificateDetails ReaderDevice.setNTPConfig ReaderDevice.getWatchdogStatus ReaderDevice.setWatchdogStatus ReaderDevice.shutDown ReaderDevice.getExtAntennaMode ReaderDevice.setExtAntennaMode ReaderDevice.getReaderVersionInfo ReaderDevice.getManufacturer ReaderDevice.getModel ReaderDevice.getName ReaderDevice.setName ReaderDevice.getDebounceTime Table of Contents vii ReaderDevice.setDebounceTime ReaderDevice.getTimeTicks ReaderDevice.getLocalTime ReaderDevice.setLocalTime ReaderDevice.getAllReadPoints ReaderDevice.saveConfigChanges ReaderDevice.discardConfigChanges ReaderDevice.hasConfigChanged ReaderDevice.getUncommitedConfigChangesDescription ReaderDevice.getTimeZones ReaderDevice.setTimeZone ReaderDevice.getReaderProfileList ReaderDevice.setProfileActive ReaderDevice.deleteProfile ReaderDevice.importProfileToReader ReaderDevice.exportProfileFromReader ReaderDevice.getSerialTimeout ReaderDevice.setSerialTimeout ReaderDevice.getAntennaCheck ReaderDevice.setAntennaCheck ReaderDevice.getReaderDetails ReaderDevice.viewMACErrorLog AntennaReadPoint.getSupportedAirProtocols AntennaReadPoint.getCurrentAirProtocol AntennaReadPoint.setAirProtocol AntennaReadPoint.getTransmitPowerLevel AntennaReadPoint.setTransmitPowerLevel AntennaReadPoint.getGen2OptionalOperCounts AntennaReadPoint.getNXPCustomOperCounts AntennaReadPoint.getFujitsuCustomOperCounts Reader Management Custom Error Codes Chapter 4: LLRP Custom Extensions Introduction LLRP Custom Messages Per Product MOTO_GET_TAG_EVENT_REPORT MOTO_PURGE_TAGS MOTO_PURGE_TAGS_RESPONSE MOTO_TAG_EVENT_NOTIFY MOTO_UPDATE_RADIO_FIRMWARE MOTO_UPDATE_RADIO_FIRMWARE_RESPONSE MOTO_UPDATE_RADIO_CONFIG MOTO_UPDATE_RADIO_CONFIG_RESPONSE MOTO_GET_RADIO_UPDATE_STATUS MOTO_GET_RADIO_UPDATE_STATUS_RESPONSE LLRP Custom Parameters Per Product MotoGeneralRequestCapabilities MotoGeneralCapabilities MotoAutonomousCapabilities MotoTagEventsGenerationCapabilities viii RFID Reader Software Interface Control Guide MotoLocationCapabilities MotoFilterCapabilities MotoPersistenceCapabilities MotoGeneralGetParams MotoRadioPowerState MotoRadioUpdateStatusInfo MotoRadioDutyCycle MotoRadioDutyCycleTable MotoVersion MotoVersionList MotoFilterRule MotoFilterTimeOfDay MotoFilterTimeRange MotoUTCTimestamp MotoFilterRSSIRange MotoFindItem MotoLocationResult MotoAutonomousState MotoTagEventSelector MotoTagReportMode MotoFilterList MotoPersistenceSaveParams MotoDefaultSpec MotoTagEventList MotoTagEventEntry MotoC1G2LLRPCapabilities MotoC1G2ExtendedPC MotoC1G2Recommission MotoC1G2RecommissionOpSpecResult MotoC1G2BlockPermalock MotoC1G2BlockPermalockOpSpecResult MotoNXPChangeEAS MotoNXPChangeEASOpSpecResult MotoNXPSetQuiet MotoNXPSetQuietOpSpecResult MotoNXPResetQuiet MotoNXPResetQuietOpSpecResult MotoNXPCalibrate MotoNXPCalibrateOpSpecResult MotoNXPEASAlarmSpec MotoNXPEASAlarmNotification MotoConnectionFailureReason MotoCustomCommandOptions MotoFujitsuChangeWordLock MotoFujitsuChangeWordLockOpSpecResult MotoFujitsuChangeBlockLock MotoFujitsuChangeBlockLockOpSpecResult MotoFujitsuReadBlockLock MotoFujitsuReadBlockLockOpSpecResult MotoFujitsuChangeBlockOrAreaGroupPassword Table of Contents ix MotoFujitsuChangeBlockOrAreaGroupPasswordOpSpecResult MotoFujitsuBurstWrite MotoFujitsuBurstWriteOpSpecResult MotoFujitsuBurstErase MotoFujitsuBurstEraseOpSpecResult MotoFujitsuAreaReadLock MotoFujitsuAreaReadLockOpSpecResult MotoFujitsuAreaWriteLock MotoFujitsuAreaWriteLockOpSpecResult MotoFujitsuAreaWriteLockWOPassword MotoFujitsuAreaWriteLockWOPasswordOpSpecResult MotoNXPChangeConfig MotoNXPChangeConfigOpSpecResult MotoImpinjQT QTData MotoImpinjQTOpSpecResult Binary Packet Format for Custom Parameters MOTO_GET_TAG_EVENT_REPORT MOTO_PURGE_TAGS MOTO_PURGE_TAGS_RESPONSE MOTO_TAG_EVENT_NOTIFY MOTO_UPDATE_RADIO_FIRMWARE MOTO_UPDATE_RADIO_FIRMWARE_RESPONSE MOTO_UPDATE_RADIO_CONFIG MOTO_UPDATE_RADIO_CONFIG_RESPONSE MOTO_GET_RADIO_UPDATE_STATUS MOTO_GET_RADIO_UPDATE_STATUS_RESPONSE MotoGeneralRequestCapabilities MotoGeneralCapabilities MotoAutonomousCapabilities MotoTagEventsGenerationCapabilities MotoLocationCapabilities MotoFilterCapabilities MotoPersistenceCapabilities MotoGeneralGetParams MotoRadioPowerState MotoRadioUpdateStatusInfo MotoRadioDutyCycle MotoRadioDutyCycleTable MotoVersion MotoVersion List MotoFilterRule MotoFilterTimeOfDay MotoFilterTimeRange MotoUTCTimestamp MotoFilterRSSIRange MotoFindItem MotoLocationResult MotoAutonomousState MotoTagEventSelector x RFID Reader Software Interface Control Guide MotoTagReportMode MotoFilterList MotoPersistenceSaveParams MotoDefaultSpec MotoTagEventList MotoTagEventEntry MotoC1G2LLRPCapabilities MotoC1G2ExtendedPC MotoC1G2Recommission MotoC1G2RecommissionOpSpecResult MotoC1G2BlockPermalock MotoC1G2BlockPermalockOpSpecResult MotoNXPChangeEAS MotoNXPChangeEASOpSpecResult MotoNXPSetQuiet MotoNXPSetQuietOpSpecResult MotoNXPResetQuiet MotoNXPResetQuietOpSpecResult MotoNXPCalibrate MotoNXPCalibrateOpSpecResult MotoNXPEASAlarmSpec MotoNXPEASAlarmNotification MotoConnectionFailureReason MotoCustomCommandOptions MotoFujitsuChangeWordLock MotoFujitsuChangeWordLockOpSpecResult MotoFujitsuChangeBlockLock MotoFujitsuChangeBlockLockOpSpecResult MotoFujitsuReadBlockLock MotoFujitsuReadBlockLockOpSpecResult MotoFujitsuChangeBlockOrAreaGroupPassword MotoFujitsuChangeBlockOrAreaGroupPasswordOpSpecResult MotoFujitsuBurstWrite MotoFujitsuBurstWriteOpSpecResult MotoFujitsuBurstErase MotoFujitsuBurstEraseOpSpecResult MotoFujitsuAreaReadLock MotoFujitsuAreaReadLockOpSpecResult MotoFujitsuAreaWriteLock MotoFujitsuAreaWriteLockOpSpecResult MotoFujitsuAreaWriteLockWOPassword MotoFujitsuAreaWriteLockWOPasswordOpSpecResult MotoNXPChangeConfig MotoNXPChangeConfigOpSpecResult MotoImpinjQT QTData MotoImpinjQTOpSpecResult Table of Contents xi Chapter 5: SNMP Introduction Motorola Custom MIB SNMP MIB Global RM MIB TRAP Services Appendix A: XML Schema for RM Extensions Introduction... A-1 Index xii RFID Reader Software Interface Control Guide ABOUT THIS GUIDE Introduction This Software Interface Control Guide provides information for RFID system integrators and software developers for evaluating and applying Motorola RFID products in RFID applications, and describes Low Level Reader Protocol (LLRP) extensions for RFID control, and Reader Management (RM) protocol extensions which use XML over HTTP methods for reader web page control. xiv RFID Reader Software Interface Control Guide Configurations This guide applies to the following RFID configurations: FX A30-US: 4-Port RFID Reader, US FX A30-US: 2-Port RFID Reader, US FX A30-WR: 4-Port RFID Reader, Global FX A30-WR: 2-Port RFID Reader, Global FX D41-US: 4-port configuration, US and Canada FX D41-WW: 4-port configuration, International FX D41-US: 8-port configuration, US and Canada FX D41-WW: 8-port configuration, International MC3090Z-LC48HBAQE1: RFID Mobile Computer, US MC3090Z-LC48HBAQE2: RFID Mobile Computer, US and Canada MC319Z-GL4H24E0W: Laser, RFID, Worldwide MC319Z-GL4H24E0E: Laser, RFID, EU MC319Z-GI4H24E0W: Imager, RFID, Worldwide MC319Z-GI4H24E0E: Imager, RFID, EU MC9090-GJ0HJEQZ1US: Laser, RFID, US and Canada MC9090-GK0HJEQZ1US: 2D imager, RFID, US and Canada MC9090-GU0HJEQZ1US: 1D imager, RFID, US and Canada MC9090-GJ0HJEQZ4ER: Laser, RFID, EU MC9090-GK0HJEQZ4ER: 2D imager, RFID, EU MC9090-GU0HJEQZ4ER: 1D, RFID, EU MC919Z-GA0SWEQZ1WR: 1D, RFID, Worldwide MC919Z-GA0SWEQZ2EU: 1D, RFID, EU MC919Z-G30SWEQZ1WR: 2D imager, RFID, Worldwide MC919Z-G30SWEQZ2EU: 2D imager, RFID, EU MC919Z-G50SWEQZ1WR: 2D DPM Imager, RFID, Worldwide MC919Z-G50SWEQZ2EU: 2D DPM Imager, RFID, EU MC919Z-GJ0SWEQZ1WR: 1D LRX, RFID, Worldwide MC919Z-GJ0SWEQZ2EU: 1D LRX, RFID, EU MC919Z-GA0SWEQZ12R: 1D, RFID, Worldwide MC919Z-GA0SWEQZ22R: 1D, RFID, EU About This Guide xv Chapter Descriptions Topics covered in this guide are as follows: Chapter 1, Getting Started provides an overview of Motorola extensions. Chapter 2, LLRP Custom Extensions Operation provides general information on the Low Level Reader Protocol (LLRP) application. Chapter 3, Reader Management Custom Extensions describes Reader Management (RM) custom extensions. Chapter 4, LLRP Custom Extensions describes custom messages and parameters and provides the binary packet format for these. Chapter 5, SNMP describes reader support for RFC1213 (MIB for Network Management of TCP/IP-based internets: MIB-II), RM MIB, and a Motorola custom MIB. Appendix A, XML Schema for RM Extensions provides XML schema as a simple method of exercising RM commands. Notational Conventions The following conventions are used in this document: RFID Reader or reader refers to the Motorola FX Series RFID reader or RFID enabled MC Series mobile computers Italics are used to highlight the following: Chapters and sections in this guide Related documents and links 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. 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. xvi RFID Reader Software Interface Control Guide Related Documents and Software The following documents provide more information about the RFID readers mentioned in this guide. FX Series RFID Reader Integrator Guide, p/n 72E xx FX7400 Series RFID Reader Regulatory Guide, p/n xx FX9500 RFID Reader User Guide, p/n 72E xx FX9500 RFID Reader Regulatory Guide, p/n xx MC3090Z RFID Mobile Computer Integrator Guide, p/n 72E xx MC3090Z RFID Mobile Computer Quick Start Guide, p/n xx MC3090Z RFID Mobile Computer Regulatory Guide, p/n xx MC3191Z RFID Mobile Computer Integrator Guide, p/n 72E xx MC3191Z Mobile Computer Quick Start Guide, p/n xx MC3191Z Mobile Computer Regulatory Guide, p/n xx MC9090 Mobile Computer Integrator Guide, p/n 72E xx MC9090 Mobile Computer User Guide, p/n 72E xx MC9090 Mobile Computer Quick Start Guide, p/n xx MC9090 Mobile Computer Regulatory Guide, p/n xx MC919Z Mobile Computer User Guide, p/n 72E xx MC919Z Mobile Computer Quick Start Guide, p/n xx MC919Z Mobile Computer Regulatory Guide, p/n xx For the latest version of all software and guides, go to: Service Information If you have a problem with your equipment, contact Motorola Solutions support for your region. Contact information is available at: When contacting Motorola Solutions support, please have the following information available: Serial number of the unit Model number or product name Software type and version number Motorola responds to calls by , telephone or fax within the time limits set forth in service agreements. If your problem cannot be solved by Motorola Solutions support, you may need to return your equipment for servicing and will be given specific directions. Motorola 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 Motorola business partner, please contact that business partner for support. CHAPTER 1 GETTING STARTED Introduction This guide describes LLRP protocol extensions for RFID control, and RM protocol extensions which use XML over HTTP methods for reader web page control. These extensions, in addition to LLRP and RM standard protocols, constitute the native and most direct software interfaces to the RFID readers and RFID enabled mobile computers, and as such are used by the Motorola RFID3 API for C and.net. The RFID Reader software interface consists of the following two components. RFID Control and Data Plane The FX Series RFID reader and RFID enabled MC Series mobile computers support EPCGlobal Inc. s, LLRP (low level reader) protocol v1.0.1 standard. In addition to standard LLRP support, the readers supports LLRP custom extensions detailed in this guide. Reader (Device) Management Plane The FX Series supports a number of software interfaces such as SNMP, Web Services, and Reader Management (RM) protocol v1.0.1 by EPCGlobal Inc. For the management interface, this guide includes XML extensions over HTTP that support a reader web page interface. Since the FX Series supports XML over HTTP message transport binding as defined in global s RM protocol, the XML custom extensions can be regarded as RM custom extensions. The MC Series mobile computers do not support RM protocol. Audience The target audience for this guide are RFID system integrators, RFID middleware software developers, and RFID application software developers who want to control the reader directly while bypassing the RFID3 API interface, particularly developers familiar with LLRP and RM protocols. 1-2 RFID Reader Software Interface Control Guide Motorola Extensions The Reader currently supports Gen 2 v 1.2 new features, such as extended protocol control word (XPC), block permalocking, and re-commissioning using LLRP custom extensions. In the future, new functionality will be added to a new LLRP standard. Another important set of LLRP extensions supports asynchronous events which enable efficient tag reporting of visibility events, typically referred to as XR autonomous mode. Because this method allows for more efficient use of network resources, and because it was the preferred method for many XR customers, the FX and MC series supports it over the LLRP interface through a set of LLRP custom extensions. The RM protocol addresses basic RFID device management functionality. RM custom extensions address the need to extend the support of management interfaces beyond what is defined in the RM protocol, such as firmware upgrade and downgrade. The RM specification enables defining new vendor commands in a separate XML namespace. The RM custom extensions define the command interface (using XML over HTTP) to the reader s web management functions, available on the reader s web page. For example, the reader s web interface allows managing user (login) accounts, read point control, and region control. NOTE MC Series readers do not support RM. CHAPTER 2 LLRP CUSTOM EXTENSIONS OPERATION Introduction The Low Level Reader Protocol (LLRP) application provides necessary features for operating and monitoring the LLRP server and the lower level reader entities. In order minimize changes on the LLRP client side, it is strongly recommended to issue a capability query before using custom extensions as the capability value set can change in each software release. 2-2 RFID Reader Software Interface Control Guide Asynchronous Tag Events in Autonomous Mode Operation Traditional LLRP operations use a client controller model where the LLRP client instructs the reader to perform an operation and the reader reports the results of the operation. Class 1 Gen 2 provisions limit the level of data filtering that the reader returns so the reader reports all
We Need Your Support
Thank you for visiting our website and your interest in our free products and services. We are nonprofit website to share and download documents. To the running of this website, we need your help to support us.

Thanks to everyone for your continued support.

No, Thanks