PDF - Naurtech Corporation
Contents
1. StartTagInventory Start the tag inventory action Returns zero on success or non zero if fails status ReadTag Read a single tag Returns zero on success or non zero if fails status ProgramTags tagID verifyCount eraseAttempts programAttempts Program all tags within range Returns zero on success or non zero if fails status EraseTag verifyCount eraseAttempts Erase all tags within range Returns zero on success or non zero if fails status SetScrollInventoryDefaults Set inventory parameters to the scroll inventory default values Returns zero on success or non zero if fails CETerm RFID Guide for Symbol Mobile Computers Page 12 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC status SetTreeInventoryDefaults Set inventory parameters to the tree inventory default values Returns zero on success or non zero if fails status TagFilterAdd index bitMask options Add a tag filter Returns zero on success or non zero if fails See Section x for details on setting a bitMask and Appendix 1 for options values status TagFilterRemove index bitMask options Remove a tag filter Returns zero on success or non zero if fails See Section x for details on setting a bitMask and Appendix 1 for options values status TagFilterRemoveAll Remove all tag filters Returns zero on success or non zero if fails Inventory Access Methods tagObject GetTag index Returns2. inventory The event handler receives a handle to a tag object containing the data for the newly read tag CETerm RFID Guide for Symbol Mobile Computers Page 20 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC Syntax function OnRFIDReadNewTag tagObject tagObject handle to RFIDTag object describing the new tag Example This example is from the RFIDInventory sample It does not use the new tag information but simply updates a total count to inform the user OnRFIDReadNewTag function OnRFIDReadNewTag tag Message Text Inventory Active rTag count Reader TotalTagCount 4 4 THE ONRFIDFILTERMATCH EVENT The OnRFIDFilterMatch event is fired when a newly read tag matches a pass or drop filter The event handler receives a handle to a tag object containing the data for the tag Use the TagFilterDropSound or TagFilterPassSound properties for a simple tone notification of the filter action Any script should be brief to avoid slowing the inventory operation Syntax function OnRFIDFilterMatch filterIndex tagObject filterlndex index specified when filter was defined tagObject handle to RFIDTag object describing the new tag Example This example shows how to keep a count of the filter matches OnRFIDFilterMatch var matchCounts 0 0 0 0 co OnRFIDFilterMatch filterIndex tagObject Increment count matchCounts filterIndex CETerm RFID Guide for Symbol Mobile Co
3. var RFID GEN2 LOCK MASK EPC PWD var RFID var RFID var RFID var RFID GEN2 GEN2 GEN2 GEN2 LOCK LOCK LOCK LOCK MASK MASK MASK MASK Lock action var ACCESSPWD PERM ACCESSPWD PWD KILLPWD PERM KILLPWD PWD var var var var var var var var var var RFID GEN2 LOCK ACTION NONE RFID GEN2 LOCK ACTION USER PERM RFID GEN2 LOCK ACTION USER PWD RFID GEN2 LOCK ACTI RFID GEN2 LOCK ACTI RFID GEN2 LOCK ACTI RFID GEN2 LOCK ACTI RFID GEN2 LOCK ACTI RFID GEN2 LOCK ACTI RFID GEN2 LOCK ACTI RFID GEN2 LOCK ACTI ON TID PERM ON TID PWD ON EPC PERM ON EPC PWD ON ACCESSPWD PERM ON ACCESSPWD PWD ON KILLPWD PERM ON KILLPWD PWD CETerm RFID Guide for Symbol Mobile Computers 0 0x01 0x01 lt lt 1 Ox01 lt lt 2 O 0x01 Ox01 lt lt 1 Ox01 lt lt 2 Ox01l lt lt 3 Ox01 lt lt 4 Ox01 lt lt 5 Ox01 lt lt 6 O0x01xx7 1 0 0x01 lt lt 0 Ox01 lt lt 1 0x01 lt lt 2 Ox01l lt lt 3 Ox01 lt lt 4 1 Ox01 lt lt 5 Ox01 lt lt 6 O0x01xx7 0x01xx8 Ox01 lt lt 9 1 1 Ox01 lt lt 0 OxO0l lt lt 1 Ox01 lt lt 2 Ox01l lt lt 3 Ox01 lt lt 4 f Ox01 lt lt 5 Ox01 lt lt 6 0x01xx7 0x01xx8 Ox01 lt lt 9 Page 23 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC READCAP AND WRITECAP CON
4. Computers Page 16 Inventory Result Properties Property Description Values TotalTagCount Valid tags in inventory read only 0 200 TotalReadCount Total reads for all tags read only O max NewTagCount New tags read in last inventory 0 200 cycle read only ElapsedReadTime Total elapsed time of read read 0 max only millisec LastSequenceNumber Sequence number of last read 0 max read only MaximumTagCount Maximum tags managed by 200 reader InventoryLastStatus Status of last Inventory cycle status See Appendix 1 for status values read only 3 3 THE RFIDTAG OBJECT The RFIDTag object provides access to the properties of a tag after an inventory operation Methods The RFIDTag object has no methods Properties The RFIDTag object contains only read only properties Property Description Values Status Returns status of last tag read See status Appendix 1 for status values AntennaNumber Antenna number used for read 0 10 DataLength Number of bytes in tag 0 max FirstReadTime Time of first tag read text LastReadTime Time of last tag read text ReadCount Count of reads of this tag 0 max Type Type of tag See Appendix 1 for tagType tagType values Format Format of tag See Appendix 1 for tagFormat tagFormat values MemoryPageNumber Page number Available only in EX tag 0 max mode MemoryPageOf
5. Page 25 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC byteHexValue hexArray Math floor bitIndex 8 if byteHexValue match 0x i return null Prepend hex designator if missing byteHexValue 0x byteHexValue bitMask byteHexValue amp 0x1 lt lt 7 bitIndex 53 8 feast OTa bitIndex return bitMask CETerm RFID Guide for Symbol Mobile Computers Page 26 Appendix 2 RFID Inventory Sample Scripts This appendix contains the RFID Inventory Sample application scripts RFID Utils Constants Symbol RFID Inventory Sample var RFIDTriggerAllowed false var RFIDInventoryActive false var Message CETerm Message var Reader CETerm RFIDReader OnRFIDInventoryDone function OnRFIDInventoryDone status totalTags newTags Check our global flag for active inventory if RFIDInventoryActive Start another inventory cycle Reader StartTagInventory else Process inventory data Message ProgressRunning false Message Progress 0 if CETerm Session CETerm ActiveSession Browser DocLoaded Hide information message Message IsVisible false Build table to return data var tag var tagTable tagTable lt font size 1 gt lt table width 100 bgcolor tan gt lt tr gt lt td align center width 5 s lt td gt lt td align center width 5 sCls lt td gt lt td ali
6. an object representing the specified tag in the current tag inventory If there are no tags available or index is out of range returns a null reference See the property TotalTagCount to find the number of tags available The variable index is zero based and has a valid range of 0 to TotalTagCount 1 See the RFIDTag object for a description of methods and properties available on the tag object tagID GetTagID index Returns the tag ID of the specified tag in the current tag inventory If there are no tags available or index is out of range returns an empty value See the property TotalTagCount to find the number of tags available The variable index is zero based and has a valid range of O to TotalTagCount 1 status ClearInventory Clears the current tag inventory Returns zero on success or non zero if fails CETerm RFID Guide for Symbol Mobile Computers Page 13 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC Properties The RFIDReader object has many properties to control the inventory and other operations The properties are separated into several groups for convenience General Reader Properties Property Description Values ReaderEnabled Enable state of reader read only true false Use the EnableReader method to change this state TriggerEnabled Enable state of trigger read only true false Use the EnableTrigger method to change this state UseExtendedTagFormat True to use the Symbol extend
7. for details on basic usage and configuration of the Naurtech clients We believe that the CETerm RFID and Scripting features will enrich and extend the capabilities of your TE and browser applications Explore a little deeper and we think you will be amazed at the possibilities for building powerful business applications NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC 1 1 FEATURE HIGHLIGHTS Following are some of the special features in CETerm RFID JavaScript Naurtech uses the industry standard JavaScript scripting language This powerful language is familiar to programmers and non programmers world wide as the core of rich web applications With JScript the Microsoft version of JavaScript additional features are available such as the ability to use ActiveX objects in scripts Full Support for Symbol RFID features The CETerm RFID Control Object provides access to all native features of the Symbol RFID device This includes setting all parameters controlling reads writes locks and inventories and retrieving statistical reports Full Access from both TE and Browser Sessions Both terminal emulation and browser sessions can control the RFID device The user can switch between multiple sessions with each having different settings and operations For example a TE session may be performing inventory operations whereas a web session may be reading barcodes and programming RFID tags with the corresponding information CETerm Auto
8. lt form gt NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC lt script language javascript gt function LoadActions Prepare object oCETerm new ActiveXObject Cebrowsex IdaCt1 Initialize RFID oCETerm CETerm RunScript RFIDInitInventory Set current display SetPageContent Update params UpdateParams OnRFIDInventoryDone is called by CETerm script engine function OnRFIDInventoryDone status totalTags readCount tagtable document forml TotalTags value totalTags document forml TotalReads value readCount BottomContent innerHTML tagtable UpdateParams function UpdateParams Update RFID params oCETerm CETerm RunScript RFIDUpdateBrowserParams function OnReturn SetPageContent function OnEscape Clear all function SetPageContent switch currentstate CETerm RFID Guide for Symbol Mobile Computers ks Page 32 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC case reset Tag page TopContent innerHTML lt font size 2 gt lt center gt Pull trigger to start inventory lt br gt lt center gt lt font gt BottomContent innerHTML lt font size 1 gt lt table width 100 bgcolor tan s lt tr gt lt td align center width 5 s lt td gt lt td align center width 5 sCls lt td gt lt td align center width 5 gt Rd lt td
9. this mature and rich language to the TE user to provide more productive TE applications Scripting can also interact with web browser sessions to enrich and extend existing web applications on the mobile device Together JavaScript and the CETerm RFID Control Object allow nearly limitless flexibility for reading writing inventory and other RFID tag operations The browser provides an especially powerful environment to build highly interactive stand alone or casually connected RFID applications Legacy applications using terminal emulation can also be RFID enabled with little or no changes to the existing application This guide describes how to use the CETerm RFID Control Object within the CETerm Scripting Engine The properties methods and events of the RFID control are documented together with some simple examples For full documentation of the CETerm Scripting Engine the steps for writing and running scripts and the features provided through the CETerm Automation Objects refer to the CETerm Scripting Guide Please consult the standard references for details on JavaScript or JScript syntax and XML You may also need to consult standard references for HTML syntax the browser Document Object Model DOM and other aspects of Dynamic HTML if you are scripting web browser features Additional information on the CETerm Web browser features can be found in the CETerm Web Browser Programming Guide Please refer to the Naurtech User s Manual
10. D GEN2 SEL SL SET 3 options for RFID READCAP G2 SESSION var RFID GEN2 SESSION S0 0 var RFID GEN2 SESSION S1 1 CETerm RFID Guide for Symbol Mobile Computers Page 22 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC var RFID GEN2 SESSION S2 var RFID GEN2 SESSION S3 options for RFID READCAP G2 TARGET var RFID GEN2 INVENTORIED FLAG A var RFID GEN2 INVENTORIED FLAG B HO writing options for Gen 2 write tags memory bank RFID GEN2 RFID GEN2 RFID GEN2 RFID GEN2 var var var var Lock options for Gen 2 var var RFID GEN2 LOCK OPTION WRITE OPTION NONE WRITE OPTION BLOCK WRITE WRITE OPTION BLOCK ERASE FIRST WRITE OPTION PROGRAM EPC write tags memory bank RFID GEN2 LOCK OPTION NONE PERMA LOCK AFTER WRITE var RFID GEN2 LOCK OPTION USE PERMA LOCK BIT var RFID GEN2 LOCK OPTION PWD WRITE AFTER WRITE var RFID GEN2 LOCK OPTION USE PWD WRITE BIT var RFID GEN2 LOCK OPTION PERMA LOCK BANK2 AFTER WRITE var RFID GEN2 LOCK OPTION USE PERMA LOCK BIT2 var RFID GEN2 LOCK OPTION PWD WRITE BANK2 AFTER WRITE var RFID GEN2 LOCK OPTION USE PWD WRITE BIT2 Lock var RFID var RFID mask GEN2 GEN2 LOCK LOCK MASK MASK NONE USER PERM var RFID GEN2 LOCK MASK USER PWD var RFID GEN2 LOCK MASK TID PERM var RFID GEN2 LOCK MASK TID PWD var RFID GEN2 LOCK MASK EPC PERM
11. DRAFT Oct 2006 i NAUR TECH CETerm RFID Guide for Symbol Mobile Computers for Version 5 1 or later Naurtech Terminal Emulation and Web Browser Smart Clients for Windows CE Devices CETerm CE3270 CE5250 CEVT220 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC Copyright Notice This document may not be reproduced in full in part or in any form without prior written permission of Naurtech Corporation Naurtech Corporation makes no warranties with respect to the contents of this document and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose Further Naurtech Corporation reserves the right to revise this publication and referenced software without any obligation to notify any person or organization of such revision or changes Trademarks CETerm CE3270 CE5250 CEVT220 are trademarks of Naurtech Corporation Other product names mentioned in this manual may be trademarks or registered trademarks of their respective companies and are hereby acknowledged Software Version This document is for Version 5 1 or later of Naurtech Smart Clients CETerm RFID Guide for Symbol Mobile Computers Page 2 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC Table of Contents Additional Documentation Online Knowledgebase 11 0 Introduction 2 1 RFIDInventory Scripts 2 2 RFIDInventory HTML Page CETerm RFID Guide for Symbol Mobile Co
12. FIDInventory js and RFIDUtils js must be imported into CETerm using the configuration dialog under Session gt Configure gt Options gt Configure Scripting On the Scripts tab select an empty script slot and tap Edit then Import Select the file and check the Load at Startup option then tap OK Import both scripts as described above then on the General tab make sure that Enable is checked then tap Re Initialize and OK to close the dialogs See the CETerm Scripting Guide for more details on loading scripts and configuring the scripting engine The RFIDInventory scripts are shown in Appendix 2 The function RFIDInitInventory must be run first and this is invoked by the HTML page when it loads After initialization the important functions are the event handlers OnRFIDTrigger and OnRFIDInventoryDone When the trigger is pulled OnRFIDTrigger Starts the inventory and stops it when the trigger is released During the inventory cycles OnRFIDInventoryDone is called when there are results to be displayed OnRFIDInventoryDone formats the results for the web browser and passes them to the browser with a similarly named OnRFIDInventoryDone method in the JavaScript of the web page Please note that the web browser JavaScript cannot directly access the RFID Control Object because it belongs to the NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC CETerm JavaScript engine This does not prevent the web page from requesting or receiving RF
13. ID results Rather it simply requires that some scripts run in the CETerm environment Another notable function is RFIDUpdateBrowserParams This function is run to update the current RFID inventory configuration based on the current settings within the HTML page The RFIDInventory scripts also have the ability to direct RFID data to a TE session if that is the currently active session 2 2 RFIDINVENTORY HTML PAGE The inventory sample HTML page is contained in RFIDInventory htm and is shown in Appendix 3 The HTML file should be copied to the device and placed in the V root directory Select a session in CETerm for the sample and check the HTML Host Type Configure the Host Address as file RFIDInventory htm The sample page contains three general sections These are the top instruction section the middle results section and the bottom configuration section The instruction section provides feedback to the user for operating the sample application The results section shows the results of tag inventories and the bottom section can be used to change the desired tag classes and good read feedback 2 3 RUNNING THE RFID INVENTORY SAMPLE After the above configuration to run the RFID Inventory sample simply connect the corresponding session with Session 5 Connect Pulling the trigger will now start a tag inventory Results will be displayed when the trigger is released You can change the desired tag clas
14. STANTS Selected raw capability access var var var var var var var var var var var var var var var var RFID READCAP RF ATTENUATION RFID WRITECAP RF ATTENUATION RFID WRITECAP TAGTYPE RFID TAGCAP LOCKCODE RFID DEVCAP IP PORT RFID TAGCAP CO SINGULATION FIELD RFID READCAP METHOD RFID READCAP OUTLOOP RFID READCAP INLOOP RFID DEVCAP ANTENNA SEQUENCE RFID READCAP READMODE RFID WRITECAP ANTENNA RFID WRITECAP CO PAGE RFID READCAP CO PAGE RFID READCAP DUTYCYCLE ONTIME RFID READCAP DUTYCYCLE OFFTIME PCNT Gen 2 inventory var var var var RFID READCAP G2 SEL RFID READCAP G2 SESSION RFID READCAP G2 TARGET RFID READCAP G2 START Q Gen 2 read tag s memory bank 20h var var var var var RFID TAGCAP G2 SELECT MEM BANK RFID TAGCAP G2 MEM BANK RFID TAGCAP G2 WORD POINTER RFID WRITECAP G2 WRITE OPTIONS RFID WRITECAP G2 LOCK OPTIONS Gen 2 lock tags memory 23h var var RFID WRITECAP G2 LOCK MASK RFID WRITECAP G2 LOCK ACTION Gen 2 kill tag 24h var var RFID TAGCAP G2 ACCESS PASSWORD RFID TAGCAP G2 KILL PASSWORD CETerm RFID Guide for Symbol Mobile Computers 0x0001 0x0004 0x0005 0x0006 0x000a 0x000b 0x000d 0x000e Ox000f 0x0010 0x0011 0x0012 0x0013 0x0014 0x0016 0x0017 0x0018 0x0019 Ox001A Ox001B Ox001C Ox001D Ox001E Ox001F 0x0020 0x0021 0x0022 0x0023 0
15. c forml1 NewTagBeep checked Page 29 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC Reader EnableReader false RFIDReadOneTag function RFIDReadOneTag var result Reader ReadTag OS Alert tag result Reader GetCommandStatusText result Reader GetTagID 0 function RFIDInitInventory RFIDTriggerAllowed true Reader EnableTrigger true Reader EnableReader true Reader ClearInventory Reader TagClasslEnabled true Reader TagClass0Enabled true Reader TagClassGen2Enabled true Reader NewTagSoundEnabled true Reader NewTagScriptEnabled true Reader NewTagSound nledtemp wav Filters Reader TagFilterRemoveA11 Display message box Message Title RFID Tag Inventory Message Text Waiting for trigger Message Timeout 0 Message AbortButtonVisible false Message ProgressVisible true Message ProgressRunning false Message IsVisible false CETerm RFID Guide for Symbol Mobile Computers Page 30 Appendix 3 RFID Inventory Sample HTML This appendix contains the RFID Inventory Sample HTML page lt html gt lt head gt lt title gt RFID Inventory lt title gt lt meta http equiv TextSize content Smallest gt lt meta http equiv Scanner content Enabled gt lt meta http equiv ScannerNavigate content Javascript OnScan s Ss s Ss S gt lt meta http equiv OnKey RETURN conten
16. d only object RFIDReader Returns RFID object read only object TextInput Return text input object read only object 3 2 THE RFIDREADER OBJECT The RFIDReader object provides configuration and control of the RFID device Although typically used to read and inventory tags the RFIDReader also provides access to program lock and kill operations This section documents the methods and properties of the RFIDReader object NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC Methods The following methods are available Method Action EnableReader Enable or disable the reader EnableTrigger Enable or disable the trigger GetCommandStatusText Returns text description of Symbol error status GetCapList Returns a list of Symbol RFID capabilities GetCaplnfo Return an XML description of a capability SetCapValue Set a single BYTE WORD or DWORD capability GetCapValue Get a single BYTE WORD or DWORD capability GetStats Return an XML description of the current statistics StartT agInventory Start a tag inventory cycle ReadTag Read a single tag ProgramTags Program tags within range EraseTag Erase tags within range LockTag Lock tags within range KillTag Kill tags within range SetScrolllnventoryDefaults Set to default scroll inventory parameters SetTreelnventoryDefaults Set to default tree inventory parameters TagFilterAdd Add a tag filt
17. ed Enable Class 0 Zuma tags true false TagClass1Enabled Enable Class 1 tags true false TagClassGen2Enabled Enable Gen2 tags true false TagClassOtherEnabled Enable other classes of tags true false ActionTagType Tag type for action See Appendix 1 for tagType tagType values SingulationFieldClassO Singulation ID for write See Appendix 1 tagSingID for tagSingID values LockCode Lock code for tag O Oxffffff Generation 2 Tag Properties See the Symbol RFID SDK for details on these properties Property Description Values Gen2SelectedFlagMode Flag mode for operations ignore set clear Gen2CommunicationSession Session for read operations SO 1 S2 S3 Gen2RequiredInventoriedFlag Required flag for inventory A B Gen2InitiallnventoryQ Initial slots for inventory 0 15 Gen2SelectMemoryBank Memory bank for select operation EPC TID USER Gen2GeneralMemoryBank Memory bank for general EPC TID operations USER Gen2StartBitAddress Starting bit address for operation 0 16000 Gen2WriteOptions Write Options See Appendix 1 writeOptions for writeOption values Gen2LockOptions Lock Options See Appendix 1 for lockOptions lockOption values Gen2LockMaskMode Lock Mask Mode See Appendix maskMode 1 for maskMode values Gen2LockAction Lock Mask Mode See Appendix lockAction 1 for lockAction values Gen2AccessPassword Access password 32 bit value O Oxffffffff Gen2KillPassword Kill password 32 bit value O Oxffffffff CETe
18. ed true false EX tag format for tag masks and inventory results ReaderNumber Unique number identifying this 0 255 reader ReaderPowerOn Enable or disable power to the true false reader See the Symbol RFID SDK for usage details RFPowerOn Enable or disable RF power to the true false reader See the Symbol RFID SDK for usage details RFWriteAttenuation RF write attenuation level 0 255 RFReadAttenuation RF read attenuation level 0 255 ReadDutyCycleOnTime Reader on time in millisec 0 255 ReadDutyCycleOffT imePercent Reader off time in percent 0 100 LastGetCapStatus Status of last GetCap call See status Appendix 1 for status values read only LastSetCapStatus Status of last SetCap call See status Appendix 1 for status values read only LastGetParamStatus Status of last GetParam call See status Appendix 1 for status values read only LastSetParamStatus Status of last SetParam call See status Appendix 1 for status values read only CETerm RFID Guide for Symbol Mobile Computers Page 14 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC General Tag Properties Property Description Values TagMask Tag mask for all actions bitMask TagClassOEnabled Enable Class 0 tags true false TagClassOPlusEnabled Enable Class O Plus tags true false TagClassOZumaEnabl
19. er TagFilterRemove Remove a single tag filter TagFilterRemoveAll Remove all tag filters GetTag Returns the requested tag object GetTagID Returns the tag ID of the specified tag Clearlnventory Clear the current tag inventory status EnableReader enabled Enable the reader if enabled is true disable if enabled is false Returns zero on success or non zero if fails status EnableTrigger enabled Enable the trigger if enabled is true disable if enabled is false Returns zero on success or non zero if fails CETerm RFID Guide for Symbol Mobile Computers Page 11 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC text GetCommandStatusText status Return the text description of a Symbol error status text GetCapList Return the text list of Symbol RFID Reader capabilities capXML GetCapInfo capID Return an XML description of the capability specified by capID status SetCap Value capID value Set a capability that uses a single BYTE WORD or DWORD value Returns zero on success or non zero if fails value GetCapValue capID Returns the value of a capability that uses a single BYTE WORD or DWORD value The property LastGetCapStatus will contain the status of the last call and can be used to check for errors statsX ML GetStats Return an XML description of the current reader statistics Tag Operation Methods status
20. fset Page offset Available only in EX tag 0 max mode MemoryPageLength Page length Available only in EX tag 0 max mode ID Tag ID value Returned as a sequence of text hexadecimal values separated by spaces 4 0 CETerm RFID Events This section describes the script events within the CETerm script engine that are triggered by the RFID reader These events provide ways to handle various conditions in CETerm The event handlers are arbitrary scripts The event model in CETerm uses specific event handler names to bind events to handlers If the event handler function e g ONRFIDInventoryDone is defined in the script engine it will be executed when the event occurs There is no special command required to register or bind the function to the event Event handlers can be re defined at any time If the handler is no longer needed the function can be re defined as empty Event Fired when OnRFIDInventoryDone An RFID inventory cycle completes OnRFIDTrigger The trigger is pulled or released OnRFIDReadNewTag A previously un read tag is read OnRFIDFilterMatch A tag is read which matches a drop or pass filter 4 1 THE ONRFIDINVENTORYDONE EVENT The OnRFIDInventoryDone event is fired when an inventory cycle completes An inventory cycle is started with the StartTagInventory method The duration of a cycle depends on the inventory parameters Typically if the trigger is held a new cyc
21. gn center width 5 gt s Rd lt td gt lt td align center width 85 gt sID lt tds lt tr gt for var j 0 j lt totalTags j tag Reader GetTag j tagTable lt tr gt lt td gt j 1 lt tds lt td gt switch tag Type case RFID TAG TYPE EPC CLASSO tagTable CO break case RFID TAG TYPE EPC CLASS1 tagTable C1 break case RFID TAG TYPE EPC CLASSG2 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC tagTable G2 break default tagTable tagTable lt td gt lt td gt tag ReadCount lt td gt lt td gt tag ID lt td gt lt tr gt tagTable lt table gt lt font gt var script OnRFIDInventoryDone status totalTags Reader TotalReadCount tagTable var b CETerm Session CETerm ActiveSession Browser b RunScript script else TE session Show success message Message Text Inventory Done rtotalTags totalTags newTags newTags status status rPull Trigger to continue r Send tag data to current session for var j 0 j lt totalTags Message will vanish in 2 seconds Message Timeout 2 CETerm SendText Reader GetTagID j 0 Prepare for next read Reader ClearInventory RFIDTriggerAllowed true OnRFIDTrigger function OnRFIDTrigger status if RFIDTrigge
22. gt lt td align center width 85 sID lt tds lt tr gt lt table gt lt font gt break case configReader break function poweron function OnScan data source type time length alert Scanned barcode was data nThe symbology was type nScanned at time nWith a length of length alert Received PowerOn notification lt script gt lt body gt lt html gt CETerm RFID Guide for Symbol Mobile Computers Page 33 Index C CETerm object 10 ClearInventory 11 13 E EnableReader 11 EnableTrigger 11 EraseTag 11 12 G GetCapInfo 11 12 GetCapList 11 12 GetCapValue 11 12 GetCommandStatusText 11 12 GetStats 11 12 GetTag 11 13 GetTagID 11 13 K KillTag 11 L LockTag 11 O OnRFIDFilterMatch 19 21 OnRFIDInventoryDone 19 OnRFIDReadNewTag 19 20 OnRFIDTrigger 19 20 OS object 10 P ProgramTags 11 12 R ReadTag 11 12 RFID Constants 22 RFIDReader object 10 14 RFIDTag 18 S SetCapValue 11 12 SetScrollInventoryDefaults 11 12 SetTreeInventoryDefaults 11 13 StartTagInventory 11 12 T TagFilterAdd 11 13 TagFilterRemove 11 13 TagFilterRemoveAll 11 13 TextInput 10
23. le will begin immediately following the current cycle When the trigger is released the results can be processed and sent to a TE or browser session Syntax function OnRFIDInventoryDone status totalTags newTags status status of inventory read cycle totalTags total tags in inventory since last cleared newTags new tags read during this cycle Example See the RFIDInventory js scripts for a sample use of OnRFIDInventoryDone NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC 4 2 THE ONRFIDTRIGGER EVENT The onRFIDTrigger event is fired when the trigger is enabled and the trigger is pulled or released Syntax function OnRFIDTrigger status status trigger status flags Example This example is from the RFIDInventory sample OnRFIDTrigger function OnRFIDTrigger status if RFIDTriggerAllowed amp amp status amp TRIGGER ALL MASK Trigger pulled RFIDTriggerAllowed false RFIDInventoryActive true Reader ReaderPowerOn true Reader StartTagInventory else If trigger not enabled or released Stop inventory RFIDInventoryActive false Usually PowerOn false will stop inventory Sometimes if the trigger is released too quickly it fails to stop the inventory To recover pull and release the trigger again Reader ReaderPowerOn false 4 3 THE ONRFIDREADNEWTAG EVENT The OnRFIDReadNewTag event is fired when a new tag is read during an
24. mation Objects CETerm Automation Objects are available to access and control the state of CETerm the state of a TE or web browser session the mobile device and the Windows CE Operating System Together these objects provide a rich set of features to build complex RFID operations including stand alone and casually connected applications which store RFID results locally and later forward to a host system CETerm RFID Guide for Symbol Mobile Computers Page 7 2 0 Getting Started This section describes some common ways that RFID features can be used within CETerm Here we describe a web browser sample application that receives RFID inventory results This sample application demonstrates how RFID data can be passed to a web browser application and how some basic RFID configurations can be set from a browser page For discussion the application can be conveniently divided into a scripts component and a HTML component page Please note that the HTML page will also have JavaScript which runs separately in the browser JavaScript Engine 2 1 RFIDINVENTORY SCRIPTS The RFID Scripts for this sample are stored on the device and are loaded into the CETerm JavaScript engine at program startup It is also possible to download scripts dynamically from a web server or TE server The main scripts are contained in the RFIDInventory js file and additional RFID utility scripts are in the RFIDUtils js file To prepare for the sample program both R
25. mputers NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC Preface All of us at Naurtech Corporation constantly strive to deliver the highest quality products and services to our customers We are always looking for ways to improve our solutions If you have comments or suggestions please direct these to Naurtech Corporation e mail contact naurtech com Phone 1 425 837 0800 Assumptions This manual assumes you have a working knowledge of Microsoft Windows user interface metaphor and terminology Stylus based touch screen navigation terminology Basic programming and scripting concepts Dynamic HTML the browser DOM and JavaScript Basic operations and requirements of the host applications you want to access with the Naurtech smart client Conventions used in this Manual This manual uses the following typographical conventions e All user actions and interactions with the application are in bold as in Session Configure e Any precautionary notes or tips are presented as follows Tip Text associated with a specific tip e represents new version specific information e All text associated with samples is presented as follows alert OS Alert Script done CETerm RFID Guide for Symbol Mobile Computers Page 4 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC Additional Documentation Naurtech RFID features are integral to Naurtech terminal emulation Smart Clients Please refer to the User
26. mputers Page 21 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC Appendix 1 RFID Constants This appendix contains various constants that are used by CETerm RFID Objects Many of these constants are a direct representation of the equivalent values from the Symbol RFID APIs and constants These constants are presented as JavaScript variables for direct inclusion in scripts GENERAL CONSTANTS RFID Utils Constants Contains constants and utility functions for Symbol RFID Constants are taken from the Symbol rfiddefs h file Revision 1 8 SDate 2006 02 15 23 15 26 S SAuthor yjiang Tag types var RFID TAG TYPE OTHER var RFID TAG TYPE EPC CLASSO var RFID TAG TYPE EPC CLASSOPLUS var RFID TAG TYPE EPC CLASS1 var RFID TAG TYPE EPC CLASSG2 var RFID TAG TYPE EPC CLASS0ZUMA UN bh WN KH oO Filter constants var RFID FILTER OPTION PASS var RFID FILTER OPTION DROP a ee o CETerm special filter options var RFID FILTER OPTION PLAYSOUND 0x80000000 var RFID FILTER OPTION FIRESCRIPTEVENT 0x40000000 GEN2 CONSTANTS Memory bank options for Gen 2 write tags memory bank command 21h var RFID GEN2 MEMORY BANK RESERVED 0 var RFID GEN2 MEMORY BANK EPC 0x01 var RFID GEN2 MEMORY BANK TID 0x02 var RFID GEN2 MEMORY BANK USER 0x03 options for for RFID READCAP G2 SE var RFID GEN2 SEL IGNORE SL 0 var RFID GEN2 SEL SL NOT SET 2 var RFI
27. rAllowed amp amp status amp TRIGGER ALL MASK Trigger pulled RFIDTriggerAllowed false CETerm RFID Guide for Symbol Mobile Computers Page 28 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC RFIDInventoryActive true Message Text Inventory Active rTag count Message Timeout 0 Message IsVisible true Message ProgressRunning true Reader ReaderPowerOn true Reader StartTagInventory else If trigger not enabled or released Stop inventory RFIDInventoryActive false Usually PowerOn false will stop inventory Sometimes if the trigger is released too quickly it fails to stop the inventory To recover pull and release trigger Reader ReaderPowerOn false OnRFIDReadNewTag function OnRFIDReadNewTag tag Message Text Inventory Active rTag count Reader TotalTagCount function RFIDUpdateBrowserParams var doc CETerm Session CETerm ActiveSession Browser Document Stop any current reader action Reader ReaderPowerOn false if doc forml SelectDevice 0 checked Reader EnableTrigger true Reader EnableReader true else Reader EnableTrigger false CETerm RFID Guide for Symbol Mobile Computers Reader TagClasslEnabled doc forml Class1 checked Reader TagClass0Enabled doc forml Class0 checked Reader TagClassGen2Enabled doc forml Gen2 checked Reader NewTagSoundEnabled do
28. rm RFID Guide for Symbol Mobile Computers Page 15 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC Inventory Acquisition Properties See the Symbol RFID SDK for details on these properties It is usually best to not alter the loop properties and simple set the tree or scroll inventory defaults using the methods Set Scrol1InventoryDefaults or SetTreeInventoryDefaults Property Description Values InventoryType Type of inventory search O tree 1 scroll InventoryClearBeforeRead Clear inventory before read true false InventoryWakeLoops Overall tag wake loops 1 25 InventoryReadLoops Number of read loops within each 1 25 wake loop InventoryWakesPerLoop Number of wake actions in outer 0 25 loop InventoryWakesAfterLoops Number of wake actions after 0 25 outer loops InventoryFrequencyHopping Hop frequencies during read true false InventorySleepsAfterRead Sleep interval after each tag read 0 25 NewTagSoundEnabled Generate a sound for each new true false tag read NewTagSound Specifies the new tag sound text wav file NewTagScriptEnabled Run the OnRFIDNewTag script true false for each new tag WARNING This script must be brief TagFilterDropSound Generate a sound when a tag is text wav file dropped by a drop filter TagFilterPassSound Generate a sound when a tag is text wav file passed by a pass filter CETerm RFID Guide for Symbol Mobile
29. s Manual for detailed installation and configuration information Also refer to the Naurtech Scripting Guide for details on scripting features within CETerm These manuals may be downloaded from the Support section of our website Online Knowledgebase Although we continually strive to keep this manual up to date you may find our online support knowledgebase useful for the latest issues troubleshooting tips and bug fixes You can access the support knowledgebase from our website at www naurtech com gt Support gt Knowledgebase CETerm RFID Guide for Symbol Mobile Computers Page 5 1 0 Introduction The Naurtech CETerm Smart Clients provide a robust and flexible environment for Terminal Emulation TE and Web based applications on a mobile device This document describes the RFID features available within CETerm for the Symbol family of mobile computers which contain RFID readers CETerm fully integrates RFID support using the CETerm Scripting Engine to make the RFID reader available to both TE and web browser sessions All native capabilities of the Symbol RFID reader are accessible within the CETerm Scripting Engine CETerm uses the industry standard JavaScript programming language which is familiar to most programmers and is a driving force behind the rich next generation web based applications This new class of web applications is sometimes referred to as Web 2 0 using Asynchronous JavaScript and XML AJAX CETerm brings
30. ses by unchecking or checking the appropriate boxes CETerm RFID Guide for Symbol Mobile Computers Page 9 3 0 CETerm RFID Automation Objects This section describes the RFID automation objects available from the CETerm script engine The RFIDReader object provides control and configuration of the RFID device The RFIDTag object provides access to the properties of a tag that has been read The automation objects are accessed in a hierarchical manner similar to the Document Object Model DOM of a webpage The two top level objects are CETerm and OS The CETerm object provides access to application specific features whereas the OS object provides access to generic Operating System OS features such as files and the device registry The CETerm object provides access to the RFIDReader object Below we describe just a small portion of the CETerm object For full documentation of the CETerm object refer to the CETerm Scripting Guide 3 1 THE CETERM OBJECT The CETerm object gives access to CETerm features settings and session state The RFIDReader object is accessed as a property of the CETerm object Here we describe only the properties and omit all method descriptions Properties The CETerm object has several application level properties Property Description Values ActiveSession Current active session read only 1 4 MaxSession Maximum session index read only 4 Message Returns message object rea
31. t Javascript OnReturn gt lt meta http equiv OnKey ESCAPE content Javascript OnEscape gt lt script language javascript gt Global variables var oCETerm null var currentstate reset lt script gt lt head gt lt body scroll no onload Javascript LoadActions gt lt form name forml1 gt lt div id TopContent gt Error lt div gt lt hr align center width 95 gt lt center gt Tag Inventory lt center gt lt div id BottomContent gt Error lt div gt lt br gt lt font size 2 gt lt hr align center width 95 gt Total Tags lt input type text name TotalTags value 0 size 4 disabled gt Reads lt input type text name TotalReads value 0 size 4 disabled gt lt br gt lt hr align center width 95 gt lt input type checkbox name Gen2 value Gen2 onclick UpdateParams checked gt Gen2 lt input type checkbox name Class0 value Class0 onclick UpdateParams checkeds Class0 lt input type checkbox name Class1 value Class1 onclick UpdateParams checkeds gt Class1 lt br gt lt input type checkbox name NewTagBeep value NewTagBeep onclick UpdateParams checked gt New Tag Beep lt input type radio name SelectDevice value RFID onclick UpdateParams checked gt RFID lt input type radio name SelectDevice value Barcode onclick UpdateParams gt Barcode lt font gt
32. x0024 Page 24 NAURTECH SMART CLIENTS FOR WINDOWS CE AND POCKET PC TRIGGER CONSTANTS Trigger status values var TRIGGER STAGE1 MASK 0x000000ff var TRIG1 STAGE1 0x00000001 var TRIG2 STAGE1 0x00000002 var TRIG3 STAGE1 0x00000004 var TRIG4 STAGE1 0x00000008 var TRIG5 STAGE1 0x00000010 var TRIG6 STAGE1 0x00000020 var TRIG7 STAGE1 0x00000040 var EXT TRIG STAGE1 0x00000080 var TRIGGER STAGE2 MASK 0x0000ff00 var TRIG1 STAGE2 0x00000100 var TRIG2 STAGE2 0x00000200 var TRIG3 STAGE2 0x00000400 var TRIG4 STAGE2 0x00000800 var TRIG5 STAGE2 0x00001000 var TRIG6 STAGE2 0x00002000 var TRIG7 STAGE2 0x00004000 var EXT TRIG STAGE2 0x00008000 var TRIGGER ALL MASK TRIGGER STAGE1 MASK TRIGGER STAGE2 MASK UTILITY FUNCTIONS Convert hex digits in form 10 20 30 to bit mask representation Hex digits must contain the offset skipped locations Allow comma and Ox prefix on each hex digit pair function BitMaskFromHex startOffset bitCount hexString var bitMask Split hexString into array var hexArray hexString split I sl Build skipped locations for var j 0 j lt startOffset j var bitIndex startOffset var byteHexValue for var k startOffset k lt bitCount k bitMask x Verify that there are enough hex digits if bitIndex 8 gt hexArray length CETerm RFID Guide for Symbol Mobile Computers
Download Pdf Manuals
Related Search