Hi G Tek IGRS46D9916 Data Reader User Manual UM4710 rev A6
Hi-G-Tek Ltd Data Reader UM4710 rev A6
Hi G Tek >
Manual revised
Hi-G-Te k Ltd. Microelectronics and Asset Tracking Technology User’s Manual Ver. A61 UM4710 1 INTRO DUCTIO N....................................................................... 10 1.1 WH AT PRODUCTS ARE COVERED BY TH IS MANUAL .................. 10 1.2 ABOUT TH E PRO DUCT............................................................... 10 1.3 SYSTEM CO MPO NENTS.............................................................. 14 1.3.1 The Mounting Fixture............................................................ 14 1.3.2 The DataSeal ........................................................................ 14 1.3.3 Sealing Wire ......................................................................... 15 1.3.4 Outdoor DataReader.............................................................. 15 1.3.5 Indoor DataReader ................................................................ 17 Q UICK-START .......................................................................... 20 2.1 2.2 2.3 2.4 2.5 2.6 2.7 BEFORE YO U BEG IN................................................................... 20 SETT ING UP TH E DATA READERS ............................................... 21 INSTALLING TH E EVALUATION SOFTW ARE ............................... 21 CONFIG URING TH E SYSTEM ...................................................... 22 PREPARING TH E DATA SEAL/DATA TAG ..................................... 24 EX ECUTING A VERIFY COMMAND.............................................. 27 A BRIEF TUTORIAL TH RO UGH TH E STATES O F TH E DATA SEAL 29 DATAS EAL INSTALLATIO N................................................... 34 DATATAG INSTALLATIO N..................................................... 38 4.1 PLACING TH E DATA TAG O N A VEH ICLE.................................... 38 4.1.1 Horizontal Orientation:.......................................................... 39 -2 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology 4.1.2 Vertical Orientation............................................................... 39 DATAREADER INSTALLATIO N ............................................. 42 5.1 O UTDOOR DATA READER INSTALLATIO N .................................. 42 5.1.1 Ceiling Installation................................................................ 42 5.1.2 Connecting the Outdoor Unit ................................................. 43 5.1.3 Wiring the Outdoor DataReader ............................................. 44 5.1.4 RS-232 Wiring Diagram........................................................ 45 5.1.5 RS-485 Full Duplex Wiring Diagram...................................... 46 5.1.6 RS-485 Half Duplex Wiring Diagram..................................... 46 5.1.7 DataReader Configuration Switches ....................................... 46 5.2 INDOO R DATA READER INSTALLATION ...................................... 47 5.2.1 Connecting the Indoor Unit.................................................... 47 5.2.2 Wiring the Indoor DataReader................................................ 48 5.2.3 RS-232 Wiring Diagram........................................................ 49 5.2.4 RS-485 Full Duplex Wiring Diagram...................................... 50 5.2.5 RS-485 Half Duplex Wiring Diagram..................................... 51 5.3 CHAINING DATA READERS TO G ETH ER ...................................... 51 5.4 RS-232/RS-485 ADAPTER.......................................................... 54 5.4.1 Connecting the RS-232/RS-485 Adapter to the First DataReader 54 5.4.2 Connecting the RS-232/RS-485 Adapter to the Controlling Computer 56 5.5 PO W ER SUPPLY REQUIREMENTS............................................... 56 5.5.1 General................................................................................. 56 5.5.2 Indoor Installation................................................................. 57 5.5.3 Outdoor Installation............................................................... 57 5.6 CABLE SELECTION .................................................................... 58 5.7 INSTALLATIO N NO TES............................................................... 59 5.8 DATA READER O PERATIO N INSTRUCTIONS................................ 60 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology -3 - 5.8.1 5.8.2 5.8.3 Power Indicators:.................................................................. 60 Channel 1 SD/RD Indicator:.................................................. 60 Channel 2 SD/RD Indicator:.................................................. 61 SYSTEM O VERVIEW................................................................ 64 6.1 SYSTEM DESCRIPTIO N ............................................................... 64 6.2 DATA SEAL AND DATA READER MODES O F OPERATION ............. 66 6.2.1 DataSeal Modes of Operation................................................. 66 6.2.2 DataReader Modes of Operation............................................. 68 6.3 MO ST COMMON CO MMANDS AND SEAL STATUS ....................... 69 6.3.1 Most Commonly Used Commands ......................................... 69 6.3.2 DataSeal's Status................................................................... 70 6.4 SYSTEM PLANNING ................................................................... 71 6.4.1 Electromagnetic Environment ................................................ 72 6.4.2 System Layout ...................................................................... 72 6.4.2.1 Radio Frequency Communication Layout. ............................ 73 6.4.2.2 Line Communication RS-485 Layout.................................... 74 6.5 SYSTEMS SEG REG ATIO N ........................................................... 75 6.5.1 Companies Segregation by OrgID.......................................... 76 6.5.2 Department Isolation ............................................................. 76 6.5.3 Services to Several Companies by a Service Provider .............. 77 6.5.4 Subgroups of DataSeals ......................................................... 77 6.5.5 OrgID, Department, Global and ADI Impact on DataSeal’s Response 78 6.6 DATA SEAL 'S MEMORY.............................................................. 79 6.6.1 Events Memory..................................................................... 79 6.6.2 User Data.............................................................................. 80 6.6.2.1 The User Data portion used by the DataT erminal................... 81 6.7 SYSTEM CO MMANDS................................................................. 82 -4 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology 7 EVALUATIO N SO FTWARE...................................................... 88 7.1 SO FTWARE INSTALLATIO N........................................................ 88 7.2 COMMUNICATION SETUP – TH E READERS ADMINISTRATION W INDOW............................................................................................ 89 7.2.1 Defining the Connected DataReaders...................................... 89 7.2.2 Setting Up the Communication Port........................................ 90 7.3 READER SETUP ......................................................................... 90 7.4 TH E VERIFY AND SET WINDOW................................................. 91 7.4.1 Executing Broadcast Verify Command................................... 94 7.4.2 Executing Addressed Verify Command .................................. 96 7.4.3 Executing Set Command........................................................ 98 7.4.4 Cyclical Interrogations Options.............................................. 99 7.5 EX ECUTING ANY CO MMAND USING TH E ALL CO MMANDS W INDOW.......................................................................................... 100 7.5.1 Executing an RF Command ................................................. 101 7.6 SPECIFIC CO MMAND STRUCTURES.......................................... 102 7.6.1 Verify................................................................................. 103 7.6.2 T ampered (T amper)............................................................. 105 7.6.3 Addressed Verify ................................................................ 105 7.6.4 Set 106 7.6.5 Soft Set............................................................................... 107 7.6.6 Suspended Set..................................................................... 107 7.6.7 Read Data........................................................................... 108 7.6.8 Write Data.......................................................................... 110 7.6.9 Read Parameters.................................................................. 112 7.6.10 Write Parameters................................................................. 113 7.6.11 Reset Data .......................................................................... 115 7.6.12 Deep Sleep.......................................................................... 116 7.6.13 Hard Wakeup...................................................................... 117 7.6.14 Start Alert Burst Mode......................................................... 118 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology -5 - 7.6.15 Start Alert Burst Mode (all).................................................. 119 7.6.16 Stop Alert Burst Mode......................................................... 120 7.6.17 Stop Alert Burst Mode (all).................................................. 120 7.6.18 Acknowledge Alert Burst..................................................... 121 7.6.19 Read Events........................................................................ 122 7.7 ADVANCED FEATURES............................................................. 124 7.7.1 Built-In Test ....................................................................... 124 7.7.2 Authorization Levels and Passwords..................................... 125 7.7.2.1 Logging-in Using the Desired Authorization Level.............. 126 7.7.2.2 Changing Passwords.......................................................... 126 7.7.3 Updating the DataReader's Internal Software......................... 127 7.7.3.1 The MCU Download Utility............................................... 128 7.7.3.2 RF Modem Download Utility............................................. 129 SYSTEM PARAMETERS AND CO MMANDS ........................ 132 8.1 TH E H IGH FREQ UENCY RF PRO TO CO L................................... 132 8.1.1 The Basics.......................................................................... 132 8.1.2 Addressing T ypes................................................................ 134 8.1.3 The Slotted Aloha Concept .................................................. 135 8.2 DATA SEAL PARAMETERS........................................................ 136 8.2.1 The DataSeal Status Flags.................................................... 167 8.3 EV ENTS................................................................................... 179 8.3.1 General Structure of an Event Record................................... 180 8.4 H IGH -FREQUENCY RF COMMANDS SUMMARY........................ 186 8.4.1 Broadcast Commands.......................................................... 187 8.4.2 Addressed Commands......................................................... 195 8.4.3 Multi Addressed Commands................................................ 204 8.4.3.1 Multi Addressed Commands With Parameters..................... 204 8.4.3.2 Multi Addressed Commands Without Parameters................ 205 8.5 BURST MESSAG ES ................................................................... 210 -6 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology 8.6 8.7 DATA READER PARAMETERS................................................... 215 COMMAND CHAIN ................................................................... 230 TRO UBLE SHOO TING AND PROBLEM SO LVING ............. 234 9.1 9.2 9.3 9.4 G ENERAL DATA READER PRO BLEMS....................................... 234 RS-232/485 CO MMUNICATIO N PRO BLEMS .............................. 234 G ENERAL RF COMMUNICATION PRO BLEMS ........................... 234 SPECIFIC RF CO MMANDS TROUBLESHOO TING :....................... 235 10 TECHNICAL SPECIFICATIO NS............................................ 238 10.1 10.2 10.3 10.4 10.5 10.6 10.7 10.8 10.9 24V O UTDOO R DATA READER .................................................. 238 12V O UTDOO R DATA READER .................................................. 239 48V O UTDOO R DATA READER .................................................. 241 24V INDOO R DATA READER ..................................................... 242 12V INDOO R DATA READER ..................................................... 243 48V INDOO R DATA READER ..................................................... 243 DATA SEAL .............................................................................. 244 MAGNETIC DATA SEAL............................................................. 245 FCC APPRO VED PRODUCTS:.................................................... 246 11 INDEX....................................................................................... 250 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology -7 - This User’s Manual includes all the information required for installing and operating Hi-G-T ek Electronic DataSeals and DataReaders. Software License Agreement Information in this document is subject to change without notice and does not represent a commitment on the part of the manufacturer. The software described in this document is furnished under licens e agreem ent or nondisclosure agreement. It is against the law to copy the software on any medium except as speci fi cally allowed in the license or nondisclosure agreem ent. The purchaser may make one copy of the software for backup purposes. No part of this manual may be reproduced or transmitted in any form or by any means, elect ronic or m echanical, including photocopying, recording, or information storage and retrieval, for any purpose other than for the purchaser’s personal use, without written permission. © Copyright 2001 Hi-G-T ek Ltd. All rights reserved. DataSealTM is a trademark of Hi-G-T ek. Pentium TM is a trademark of Intel Corporation. Microsoft Windows 98 ® and Microsoft Windows NT ® are trademarks of Microsoft Corporation. Moxa is a trademark of Moxa Technologies. -8 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 1 Introduction Introduction 1.1 What Products are Covered by this Manual This manual covers the DataReader (both Indoor and Outdoor versions), DataSeal, DataT ag and the MagneticDataSeal products. The DataTerminal, DataPort, MicroDataReader, T rackingDataReader and SmartDataReader are Hi-G-T ek products that are referred to in some places in the manual, but are not covered by it. 1.2 About the Product Thank you for choosing Hi-G-T ek quality products. The Hi-G-T ek range of products provides a highly reliable and secure cargo and asset monitoring system utilizing state-of-the-art RFID technologies. Cost-effective, more reliable and more secure than their mechanical counterparts, the Hi-G-T ek product range will constantly monitor your assets and alert you to any potential problems at all times. The Hi-G-Tek system was developed in order to fill the requirement for fast, automatic processing of secured cargoes and to provide real time monitoring and improved management of cargoes both in transit and in storage. The basis of the system is a family of reusable electronic seals named DataSeal. This family of products includes the DataSeal, DataT ag and the MagneticDataSeal. - 10 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 1 Introduction Note : T his manual uses the term DataSeal to refer to any member of this family of products, unless otherwise specified. The most significant purposes of the DataSeal are: Track any attempts of opening, bypassing or tampering. Record events when tamper occurs. Write and read user data. The reusable electronic seal automates the processing of secured cargoes enabling the organization to effectively and economically process the increasing numbers of containers’ traffic in the ports and between inland destinations. The DataSeal includes a transmitter / receiver unit, real-time clock, processor, memory and sensing circuitry for sealing verification. T he Sealing Wire1 prevents any attempt of opening, bypassing or tampering with the seal without alerting the system and recording of the event. T he system combines the technological and operational advantages of both low frequency close-range AND high frequency (UHF) long range for sealing verification and other communications with the DataSeal. The low frequency (short range) communication protocol is used by the DataTerminal, the DataPort and the MicroDataReader. T his channel of communication is useful for writing the electronic manifest of the sealed cargo into the DataSeal's memory. For example: this information can In the case of DataTag, there's a “ Sensor Plate” instead of the Sealing Wire, and in the case of the MagneticDataSeal, there's a “ Magnet Element”. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 11 - Chapter 1 Introduction include the vehicle ID, container and invoice numbers, cargo description, etc. It is also useful for reading the DataSeal's event records, and to reset the DataSeal for a new use (an operation called "Set"). Note : The low frequency protocol, the DataTerminal, DataPort and MicroDataReader devices are not covered by this manual. The high frequency protocol is used by devices of the DataReader family of products. This family includes the DataReader itself, which connects to a controlling computer (normally a PC) through an RS-232/485 interface; the TrackingDataReader which contains a GPS and GSM modules and is usually installed on a truck; and the SmartDataReader which contains an embedded PC and connects to an Ethernet network. This manual covers only the DataReader device itself. The high frequency protocol is useful for monitoring the presence and status of one or more DataSeals constantly or periodically. It is capable of communicating with multiple DataSeals simultaneously and even with DataSeals in high speed motion, for example: on a train. The DataSeal and DataReader devices are capable of communicating in distances of up to 30 meters, and in some cases even more. The use of the high frequency/long range protocol enables applications such as: tracking and sealing verification of containers in transit; protection of containers in storage; remote automatic data collection from secured cargoes as they pass through check points, etc. The DataReader is able to detect which DataSeals are present in its area, and their statuses (open/close, tampered, etc). It can also receive messages from DataSeals in real-time, for example when the DataSeal is tampered. These types of messages that the DataSeal transmits are called "Burst Messages". - 12 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 1 Introduction Multiple DataReaders can be connected to a single controlling computer using the RS-485 interface. This allows to maximize the coverage area of the DataReaders while keeping them synchronized. The DataReader is available in both indoor and outdoor models. A set of Mounting Fixtures has been developed for the DataSeal system which allow convenient mounting and removal of the DataSeal from a container whenever required. The various Mounting Fixtures differ in the level of protection they provide to the DataSeal as may be required in various environments. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 13 - Chapter 1 1.3 1.3.1 Introduction System Components The Mounting Fixture The DataSeal Mounting Fixture is used to mount the DataSeal on the container’s keeper bar or other surface. 1.3.2 The DataSeal The DataSeal unit contains the DataSeal electronics, a battery, a transceiver, a processor and memory to record and store the events and the relevant information about the cargo. - 14 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 1 1.3.3 Introduction Sealing Wire The Sealing Wire serves to seal the cargo. Any tampering with the Sealing Wire at any point during transport is recorded and can be reported at once. 1.3.4 Outdoor DataReader The Hi-G-Tek DataSeal System uses state-of-the-art technology to secure and monitor secured cargoes in storage and during transport. The DataReader is comprised of two compartments. The upper compartment is the heart of the unit and contains the DataReader’s electronics section. The lower compartment contains the terminal glands which connect Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 15 - Chapter 1 Introduction the unit to the RS-232/485 networking cable. The DataReader may be used in both stationary and mobile configurations. In the stationary configuration, the unit is mounted on a flat surface such as a wall or pole. A typical installation of this configuration is at the point of exit from ports, customs terminals, warehouses, etc. This operation mode allows monitoring of the DataSeal at predetermined sites and checkpoints. In the mobile configuration, the unit is mounted in the truck cabin. T he DataReader monitors the seal during the entire journey, and reports its status via the vehicle’s communication system to the control center in realtime. T his configuration requires an additional 3rd party controlling device to control the DataReader, or to use the T rackingDataReader which is not covered by this manual. - 16 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 1 Introduction The DataReader is mastered by a controlling computer. Once installed, the unit waits for commands coming from the controlling computer. 1.3.5 Indoor DataReader Similar to the outdoor version, the Indoor DataReader uses state-of-theart technology to secure and monitor secured cargoes in an indoor environment. The Indoor DataReader may be use d in stationary configuration only. The unit is mounted on a flat surface such as a wall or pole. A typical installation of this configuration is at the point of closed warehouses, offices, etc. Unlike the Outdoor DataReader, the Indoor version does not have the lower compartment. Instead it has 3 connectors. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 17 - Chapter 1 Introduction Indoor DataReade r Antenna Electronics Bay Led Indicator Cable Connection - 18 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 2 Quick Start Quick-Start The aim of this chapter is to lead you step-by-step in the quickest way to the stage where you can verify that the Demo System is working properly, and that you have a simple system that you can play with, in order to evaluate the potential of the products. This guide a ssumes that the parameters of the DataReader and DataSeal are the factory defaults, and it refers only to the Demo System. For installation instructions for a DataReader that is not a Demo System, see chapter 5. 2.1 Before you begin Before you begin, make sure that you have the following items available: 1. The Hi-G-T ek DataReader device. 2. DataReader Antenna. 3. At least one Hi-G-T ek DataSeal device. 4. The Seal ID of the DataSeal (printed on the sticker on the bottom side of the DataSeal). 5. Sealing Wire(s) (according to the number of DataSeals. If you are using DataTags you need Sensor Plate(s) instead of the Sealing Wires) 6. PC running one of the following operating systems: • Windows 98 or above. • Windows NT 4.0 or above. - 20 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 2 Quick Start This computer must have at least one available serial communication port, a CD-ROM drive, and at least 20MB of free hard disk space. T he computer must use an Intel Pentium TM or compatible processor. 7. CD-ROM with Evaluation Software. 2.2 Setting up the DataReaders First, connect the antenna to the DataReader. The antenna connects to the T NC connector at the top side of the DataReader. Then, connect the DB9 female connector to a serial communication port in the PC. T ake note of which port you are using (for example COM2). It is good practice to connect and disconnect cables only when the computer is off. Plug the power chord of the DataReader into a power outlet. You should see the POWER LED blinking red and green. After about 30 seconds it should remain green. If it remains red, or isn't lit at all, there is a problem with the DataReader. Refer to the chapter 0 for troubleshooting. 2.3 Installing the Evaluation Softw are If the computer is not turned on, turn it on now, and wait until the operating system is loaded completely. Insert the CD-ROM labeled "Hi-G-T ek" into the CD-ROM drive. From the Start menu, choose "Run". Assuming your CD-ROM drive is drive E, type "E:\DataSeal Evaluation Software\Setup.EXE" in the "Run" dialog box. If your CD-ROM drive letter is not E, replace the first E with your CD-ROM drive letter. Click OK to start installing the DataSeal Evaluation Software. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 21 - Chapter 2 Quick Start Follow the instructions on the screen until it says that the software is successfully installed. If you're using Windows 98, restart your computer (even if you're not requested to by the installation software). The Evaluation Software is now installed. A new shortcut icon " DataSeal Evaluation" is added to your Start->Programs menu. 2.4 Configuring the System Run the Evaluation Software by clicking on that icon. T he Reade rs Administration Window shown in Figure 2-1 will be displayed. - 22 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 2 Quick Start Figure 2-1 - The Readers Administration Window. If you connected the Reader to a serial port other than COM1, choose the appropriate COM port from the Comm Port drop down list, and then click on the Se t Comm Port button. Click O K to close the message window that says "Comm port was set successfully". Click on the Auto De tect button on the bottom of the window, to automatically find the Reader ID of the DataReader. The message shown in Figure 2-2 will be displayed. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 23 - Chapter 2 Quick Start Figure 2-2 - Auto Detect Warning Message. Because you're using the Demo System that includes only one DataReader, click Yes. If everything is connected appropriately, a message window will appear saying "Reader was added successfully". Click O K to close this message. If instead of this message, a "T imeout" message appears, check your connections and verify that the communication port setting corresponds to the one you're using. Remember to click on Se t Comm Port each time you change the communication port setting. If a different message appears, refer to chapter 9 for troubleshooting. The DataReader's ID is now added to the list with a Reader Address of 1. Click on the Close button to close the Reade rs Administration window. 2.5 Preparing the DataSeal/DataTag DataSeals provided by Hi-G-T ek leave the factory in a special power saving mode called "Deep Sleep Mode". Before you can communicate normally with a DataSeal, you must send it a special command called "Hard Wakeup" that returns the DataSeal into its normal mode of operation. You will then have to close the Sealing Wire (as will be - 24 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 2 Quick Start explained below), and send another command called "Set" that prepares the DataSeal for normal operation. This section describes how to prepare a single DataSeal. If you have more than one DataSeal, repeat all the instructions in this section for each DataSeal you have. In order to send the Hard Wakeup command to the DataSeal or DataSeals do the following: Click on the window shown in Figure 2-3. button on the tool bar to open the Figure 2-3 - All Commands Window. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 25 - Chapter 2 Quick Start From the Command Code drop down list, select Hard Wakeup. Copy the Seal ID of the DataSeal you want to wake up into the Seals/Tags ID text box. The Seal ID is printed on the sticker on the bottom of the DataSeal. Click the Command Exe cution button. The mouse cursor will change to an hourglass icon for about 11.5 seconds and then return to a normal pointer cursor. If the DataSeal received the message, The Result box will show the message "Command OK" in green letters. If not, verify that you typed the Seal ID correctly in the Seals/Tags ID box, and that the DataSeal is nearby, and try again. If you still don't get the green "Command OK" message, or you see a different red message in the Result box, refer to chapter 9 for troubleshooting. If you're using a DataSeal (as opposed to a DataTag), you now have to close the Sealing Wire by inserting its 2 ends to the 2 sockets in the DataSeal. Push the ends inside the sockets as far as you can. (You should hear a 'Click' when the wire end is fully inserted). If you're using a DataTag, you should place the Sensor Plate in its appropriate place at the bottom of the DataTag. From the Command Code drop down list, select Set and then click the Command Exe cution button. After about 4 seconds, a green "Command OK" message should appear in the Result box. Congratulations! Now your DataSeal is prepared for normal operation! - 26 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 2 2.6 Quick Start Executing a Verify comm and As a matter of fact, if everything worked fine up to this point, you can be sure that your Demo System is working. Nevertheless, you probably want to know how to perform some basic operations. The most commonly used command is the Verify command. T he main purpose of this command is to detect which DataSeals are currently around, and their status (opened/closed, tampered/not tampered). In order to execute a Verify command, open the Ve rify & Se t window, by clicking on the button on the tool bar. The window shown in Figure 2-4 will be displayed. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 27 - Chapter 2 Quick Start Figure 2-4 - The Verify & Set Window. Note that there are 2 buttons labeled "Single Interrogation": the upper one resides in a rectangle labeled "Broadcast Verify", and the lower one in a rectangle labeled "Address Verify and Set". In this guide, we'll only use the upper one (Broadcast Verify). Click this button now. After about 5 seconds, one or more lines will be added to the list, according to the number of DataSeals that were detected. Figure 2-5 shows an example of a list with 5 detected DataSeals. - 28 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 2 Quick Start Figure 2-5 - 5 DataSeals Detected. Clicking the Single Interrogation button again will add another one or more lines to the list. T o clear the list, click on the Reset button at the bottom of the window. A complete explanation about the results you see is out of the scope of this Quick-Start chapter. Nevertheless, there are 2 flags in the DataSeal's Short Status that are worth a brief explanation here. 2.7 A Brief Tutorial Through the States of the DataSeal The DataSeal has many flags that determine its state, as well as Parameters, Event Records and User Data. Even though most of these features are out of the scope of this chapter, 2 of the flags represent the most fundamental concepts of the DataSeal. T hese flags are the Tampe re d flag (shown in Figure 2-5 as "S/T "), and the Opene d flag (shown in Figure 2-5 as "O/C"). Note that in the Evaluation Software, flags that are set appear in red, while unset flags appear in black. If you have followed this guide step by step up to this point, you should have both flags off (black). If you cleared the list, click Single Inte rrogation (the upper one) again to see the flags. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 29 - Chapter 2 Quick Start The O pene d flag is set (on) whenever the Sealing Wire is open, and unset (off) whenever it is closed. That explains why the O/C flag appears black. Now, open the Sealing Wire by pulling one of its ends out of the socket. Click the Single Interrogation button again to see that the O/C flag has turned red (on). You may have noticed that also the S/T flag has become red. This indicates that the DataSeal was Tampered. If you now close the Sealing Wire, this flag will remain on, even though the O pene d flag will turn off again. Try it now: close the wire, and click the Single inte rrogation once more. You should see the O/C flag black again, but the S/T remains red. No matter how many times you would open and close the wire now, the Tampe re d flag remains set, to indicate that it was opene d at least once. You can try it if you want. You may be wondering by now, whether this tutorial led you to a state where the DataSeal is irreversibly tampered, meaning that the DataSeal is no longer usable! Well, you can relax because the Hi-G-T ek DataSeal is a reusable seal, meaning that you can clear that Tampe re d flag. T he Tampe re d flag can be cleared only when the Sealing Wire is closed, and it is done by sending a Se t command to the DataSeal. That’s right, that's the same command you sent after the Hard Wakeup in the "Preparing the Seal/T ag" section. You can send this command from the Ve rify & Se t windows too. After performing a Single Inte rrogation, click on the line in the list that shows the Seal ID of the DataSeal you want to Set. Notice that the Seal ID now appears in the Seal ID box at the top part of the window. You may also type the Seal ID there manually if you prefer. Make sure that the Sealing Wire is closed, and then click on the Set button (inside the Addresse d Ve rify and Se t frame). - 30 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 2 Quick Start After about 5 seconds, you should see a green "Set OK" message in the Result box (in the upper left side of the window). If you see a "Set Failed" message instead, it means that the Sealing Wire is not properly closed. If you see a different message, refer to chapter 0 for troubleshooting. Perform another Verify interrogation (click the Single Inte rrogation button). You should see now that both the Tampe re d (S/T ) and O pe ne d (O/C) flags are clear (black), just as they were in the beginning. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 31 - Chapter 3 DataSeal Installation DataSeal Installation To install the DataSeal Mounting Fixture, attach the fixture to the keeper bar at the back of the container (Fig.1). A click indicates that the fixture is in place. The two side holes may be use d to secure the Mounting Fixture to the container, using a 3-5mm width by 180-250 mm length plastic strap (Fig. 2). - 34 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 3 DataSeal Installation To install the DataSeal, hold the unit at a 45° angle as illustrated and snap it into place in its cradle on the DataSeal Mounting Fixture. (Fig. 3) To connect the Sealing Wire, simply attach one end of the Sealing Wire connectors to either of the sockets at the base of the DataSeal (Fig. 4). Loop the wire through the container locking ring and the keeper bar, then insert the end into the other socket (Fig. 5). Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 35 - Chapter 3 DataSeal Installation Alternatively, you may loop the wire through both keeper bars then insert the end into the other socket (Fig. 6). FCC ID: OB6- IGRS40916 This device complies with Part 15 of FCC rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) This device must accept any interference that may cause undesired operation. - 36 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 4 DataTag Installation DataTag Installation The DataTag is delivered with a set of double-sided tapes that are used for placing the DataTag on the tagged object. The Sensor Plate (item #1) is supplied separately from the DataT ag. To place the Sensor Plate peel the paper from the double-sided tape (item #2) and place the Sensor Plate in its place. Press the Sensor Plate to the DataT ag such that the 1 double-side d tape will hold the Sensor Plate in place. Make sure the contacts at the bottom part of the plate are aligned with the pins in the DataT ag. Peel the paper from the three pieces of double-side d tape: The two larger pieces (items #3 & #4) are used for holding the DataTag to the tagged object, while the smaller piece in the middle (item #5) is used for pulling the Sensor Plate off the DataT ag when the DataT ag is removed from the tagged object, in order to detect the T amper event. 4.1 Placing the DataTag on a Vehicle Note : The Installation instructions refer to the case when the DataReader is installed Vertically. - 38 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 4 DataTag Installation There are two preferred orientations for placing the DataT ag on a vehicle: Horizontal and Vertical. These 2 options are described in the following sections: 4.1.1 Horizontal Orientation: Place the tag on a flat surface that is completely horizontal and press firmly to create good contact between the DataT ag and the tagged object. 4.1.2 Vertical Orientation Place the DataT ag on a flat surface that is completely vertical, and press firmly to create good contact between the DataTag and the vehicle. It is recommended that the height of the DataT ag above the ground will be above 3’, and the optimal height is 5’ above ground. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 39 - Chapter 4 DataTag Installation FCC ID: OB6-IGRS40T916 This device complies with Part 15 of FCC rules. Operation is subject to the following two conditions: (1) T his device may not cause harmful interference, and (2) This device must accept any interference that may cause undesired operation. Note: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable prot ection against harm ful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may caus e harm ful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harm ful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures: Reorient or relocate the receiving antenna. Increase the separation between the equipment and receiver. Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. Consult the dealer or an experienced radio/TV technician for help. Changes or modifications to this equipment not expressly approved by Hi-G-Tek Ltd. could void the user’s authority to operate the equipment. - 40 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 5 DataReader Installation and Operating Instructions DataReader Installation 5.1 Outdoor DataReader Installation The DataReader should be mounted on a smooth, flat surface. To mount the unit, insert 4 screws into the holes on the unit and fix to the surface. A 6mm plastic anchor and 35mm pan head tapping screw is recommended. 5.1.1 Ceiling Installation The DataReader can be mounted on the ceiling. In such cases it is requested to mount the antenna perpendicular to the ceiling using a 90° connector. The figure below shows the DataReader installed on a ceiling, with the - 42 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 5 DataReader Installation and Operating Instructions antenna perpendicular to the ceiling. 5.1.2 Connecting the Outdoor Unit Note: The electronics compartment panel should only be opened by an authorized repair person. Unauthorized use may result in loss of warranty. Remove the cover of the bottom portion of the DataReader unit by removing the screws holding it in place. Remove the covers from the glands being used. Expose the wires in the cable and insert them through the glands into the terminal blocks. Use a small screwdriver to push the lever of the connector in order to let the wires in. Ensure that the wires are inserted in the slots in accordance with the color scheme. Wiring information for specific configurations are given further on in the chapter. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 43 - Chapter 5 5.1.3 DataReader Installation and Operating Instructions Wiring the Outdoor DataReader The DataReader can be communicated with via one of three types of serial communication modes: 1. RS-485 Full Duplex 2. RS-485 Half duplex. 3. RS-232 (different model number) According to the DataReader model in use, the serial connection can be either RS-232 or RS-485 (see chapter 10 for technical specifications). When the DataReader is connected using RS485, it can be set by the user to full duplex mode or half duplex mode by altering a configuration switch. For further information see sections 5.1.45.1.5 - 5.1.7. - 44 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 5 5.1.4 DataReader Installation and Operating Instructions RS-232 Wiring Diagram Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 45 - Chapter 5 DataReader Installation and Operating Instructions 5.1.5 RS-485 Full Duplex Wiring Diagram 5.1.6 RS-485 Half Duplex Wiring Diagram 5.1.7 DataReader Configuration Sw itches S1: - 46 - Reserved for future use. Must be OFF. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 5 S2: DataReader Installation and Operating Instructions T ermination ON/OFF switch. In RS-232 mode this switch does not exist. In RS-485 mode, set this switch to ON if this is the last DataReader in the RS-485 chain. When this switch is ON, it connects an internal 120 Ohm termination resistor to the RS485 chain. S3, S6: Full/Half duplex switches. In RS-232 mode this switch does not exist. In RS-485 Full Duplex mode this switch must be ON. In RS-485 Half Duplex mode this switch must be OFF. S4: DataReader shut-down switch. While OFF: DataReader is active. While ON: DataReader is not powered. Default position: OFF 5.2 Indoor DataReader Installation The DataReader should be mounted on a smooth, flat surface. To mount the unit, insert 4 screws into the holes on the unit and fix to the surface. A 6mm plastic anchor and 35mm pan head tapping screw is recommended. 5.2.1 Connecting the Indoor Unit Note: The electronics compartment panel should only be opened by an authorized repair person. Unauthorized use may result in loss of warranty. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 47 - Chapter 5 DataReader Installation and Operating Instructions The indoor unit has three connector sockets at its base. Connector socket P1 is for incoming communications and power-in. Socket P3 is used to transfer power and to connect the unit to the next unit in a daisy chain. 5.2.2 Wiring the Indoor DataReader The DataReader may be connected to the network via three types of serial communication: 1. RS-485 Full Duplex 2. RS-485 Half duplex. 3. RS-232. Note : RS-485 and RS-232 are different models. According to the DataReader model in use, the serial connection can be either RS232 or RS485 (see Technical Specifications). The RS485 connector is always optically isolated. - 48 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 5 DataReader Installation and Operating Instructions 10 15 5.2.3 11 DB9 MALE PIN ARRAGEMENT DB9 FEMALE PIN ARRAGEMENT DB15 FEMALE PIN ARRAGEMENT RS-232 Wiring Diagram 4. Pin assignment for PWR/COM IN (P1) & PWR/COM OUT (P3) Function Pin Number Positive Power Positive Power Signal GND Negative Power Negative Power TX RX Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 49 - Chapter 5 5.2.4 DataReader Installation and Operating Instructions RS-485 Full Duplex Wiring Diagram Pin assignment for PWR/COM IN ( P1) & PWR/COM OUT ( P3) Function Pin Number Positive Power Positive Power Signal GND Negative Power Negative Power RX-A RX-B T X-A T X-B - 50 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 5 5.2.5 DataReader Installation and Operating Instructions RS-485 Half Duplex Wiring Diagram Pin assignment for PWR/COM IN ( P1) & PWR/COM OUT ( P3) Function Pin Number Positive Power Positive Power Signal GND Negative Power Negative Power T X/RX-A T X/RX-B 5.3 Chaining DataReaders Together Up to 32 DataReaders can be connected in a daisy chain using RS-485. T he last DataReader in the chain should be terminated by a 120 Ohm resistor between the RXA and the RXB. For the Outdoor version, the user can decide to create either an internal or external termination switch. The internal termination switch is created by setting to ON the termination switch (S2) of the last DataReader in the daisy chain. An external termination is relevant for the Indoor version only. An RS-485 to RS-232 adapter termination should be provided for the adapter receive channel. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 51 - Chapter 5 DataReader Installation and Operating Instructions The diagram in the next page shows the connections of a system with 4 DataReaders using an RS-485 chain. - 52 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 5 DataReader Installation and Operating Instructions Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 53 - Chapter 5 5.4 DataReader Installation and Operating Instructions RS-232/RS-485 Adapter To connect one or more DataReaders that use RS-485 to a controlling computer you need an RS-232 to RS-485 adapter. Adapter’s requirements: Full/Half duplex operation mode. Isolated communication lines. Recommended adapter: Moxa T echnologies, model A53. Adapter configuration: (refer to adapter’s User Manual) 1. Communication mode, either half or full duplex – according to the DataReader configuration. 2. Txd: always enabled. 3. Rxd: always enabled. Default configuration of the Moxa A53: Full Duplex mode Txd always enabled. Rxd always enabled. 5.4.1 Connecting the RS-232/RS-485 Adapter to the First DataReader The Rx and Tx lines should be crossed between the adapter and the first DataReader as follows: - 54 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 5 DataReader Installation and Operating Instructions DataReader DataReader RXA RXB RXA RXB TXA TXB TXA TXB SIG-GND SIG-GND Moxa A53 Wiring: Reade r TB1 PWR+ PWRRXB RXA GND TXB TXA MOXA TXB TXA RXB RXA GND PWRPWR+ Term inal B lock Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 55 - Chapter 5 5.4.2 DataReader Installation and Operating Instructions Connecting the RS-232/RS-485 Adapter to the Controlling Com puter RS-232 3-wire connection should be performed between the Adapter and the controlling computer. (Other control signals beside the Rx, Tx and GND are not required). Rx and Tx should be crossed as follows: Contr. Compute r Adapter Rx Tx GND Rx Tx GND The Moxa A51 is connected to the controlling computer with RJ45/DB25 cable supplied with the adapter. If the controlling computer has a DB9 connector, a DB25/DB9 adapter should be used. 5.5 5.5.1 Power Supply Requirements General The DataReader supply voltage is chosen according to the model, either 12v, 24v or 48v (see the specifications of the different models in chapter 10. Power supply wattage: each DataReader consumes maximum 1.7W, so the power should tolerate the number of DataReaders in the chain multiplied by each DataReader’s power consumption. - 56 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 5 DataReader Installation and Operating Instructions Example: 10 DataReaders connected in a daisy chain require 10x1.7=17W of power supply. Note that if the power supply is installed in a high temperature area (usually above 40° C), there is a derate in power supply wattage. (Refer to your power supply manual). For safety reasons, power supply current should be limited to 3A. Current limitation should be done internally in the power supply, or externally with a 3A fuse. Both in the Outdoor and Indoor systems, the power supply should be installed indoor. When power supply cable ends are connected directly to system cable, a proper isolation should be made. Using heat shrink tube is recommended. 5.5.2 Indoor Installation When the DataReader is installed indoor, the power supply used should be UL1950 approved. A desktop style with IEC320 inlet is recommended. 5.5.3 Outdoor Installation For safety reasons, the DataReader shall be use d with the following power supply only: HI-G-TEK P/N HGT 5291A Manufacture r Manufacture r P/N EDAC EA1050D-240 Supply Voltage [V] Supply Wattage [W] 24 24 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 57 - Chapter 5 5.6 DataReader Installation and Operating Instructions Cable Selection The cable is used for power supply to DataReaders in a chain and for RS485 serial communication. For most applications, 3 or 4 pairs of 24AWG shielded cable is adequate. The serial communication requires shielded twisted pair cable, the power supply requires low ohmic resistance of the conductors. Cable connection: 1 pair for RXA and RXB signals. 1 pair for TXA and T XB signals. SI GNAL GND may be connected to shield or to a pair of wires (shield connection is recommended, though it depends on the noise level of the specific environment). For the power supply: two main issues should be considered: max current carrying capacity and wire resistance. Max current capacity: For 24AWG cable, the jacket is heated at 1°C at 0.1A current, max temperature is 80°C. So, this cable can carry a max of 2A at 60°C. ( (80°-60°)*0.1 ). This calculation should be done for the application specific requirements. Wire resistance: The voltage drop across the cable may cause insufficient voltage to the last DataReaders in the chain. Calculation of voltage drop for the certain setup should be done, in order to avoid this. In most cases, the solution for such problems can be connecting a pair of wires for the supply (2 for supply and 2 for return), using thicker cable, or - 58 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 5 DataReader Installation and Operating Instructions using higher temperature rated cable. Environmental considerations: In an outdoor installation, the cable should withstand all outdoor conditions, including water proof, temperature, ruggedness etc. Example: A setup of 10 DataReaders with 20 meter 24AWG cable between DataReaders and 24v supply to the first DataReader. The ohmic resistance between DataReaders is 3.4 Ohms (20 meter of supply and 20 meters of return). Calculating the voltage drop across the lines gives 5v only, left to the last DataReader in the chain. T his is below DataReader specification of DataReader minimum supply voltage. If two conductors are used for supply and return, the ohmic resistance would be 3.4/2=1.7 ohm. The voltage to the last DataReader in the chain would then be 17v, well above the minimum voltage required. If you experience difficulty calculating the voltage drop across the supply line, contact your distributor for assistance. 5.7 Installation Notes The DataReader is distributed to a commercial/industrial use only, and should only be sold to the professional customers. When installed outdoors, the unit shall be installed in accordance with the NEC or CEC. Installation must be performed according to this user manual, and by a professional personnel only. It is the responsibility of the installer to ensure that when using the outdoor antenna kits in the United States (or where FCC rules apply), only those antennas certified with the product are used. The use of any antenna other Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 59 - Chapter 5 DataReader Installation and Operating Instructions than those certified with the product is expressly forbidden in accordance with FCC rules CFR47 part 15.204. 5.8 DataReader Operation Instructions Three LED indicators are located on the lefthand side of the electronics compartment. 5.8.1 Power Indicators: The DataReader is activated by connecting it to a power supply. At power ON and selftest the power indicator's color alternates between green and red for several seconds. If the check result is OK, the indicator remains green. If a problem was detected, the indicator remains red. This LED also has a special meaning when performing firmware download: On MCU firmware download, the indicator alternates between green and red. On RF Modem firmware download - the indicator remains off. 5.8.2 Channel 1 SD/RD Indicator: When this indicator is red, the unit is in SD (sending RF data) mode. When the indicator is green, the unit is in RD (receiving RF data) mode. When the indicator is off, it is in stand-by mode. - 60 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 5 5.8.3 DataReader Installation and Operating Instructions Channel 2 SD/RD Indicator: This indicator is not in use. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 61 - Chapter 6 System Overview System Overview 6.1 System description The Hi-G-T ek system consists of the following components: 1. DataSeal The DataSeal is a sophisticated device, which includes 2 transmitter/receiver units (one for high frequency/long range and another one for low frequency/short range communications), real-time clock, processor, memory and sensing circuitry for sealing verification. T he Sealing Wire prevents any attempt of opening, bypassing, or tampering with the DataSeal without alerting the system and recording the event. Data may also be written into and read from the DataSeal to store and retrieve general information. The DataSeal can communicate both in low frequency with short range devices, such as the DataTerminal and MicroDataReader, and in high frequency for long ranges with the DataReader, together allowing a broad range of applications. 2. DataTag The DataTag is a variant of the DataSeal device. Instead of the Sealing Wire it has a removal sensing mechanism. T his makes it more suitable for cases where you want to tag goods, but you don't have to seal them. Other than that, it is identical to the DataSeal device. 3. MagneticDataSeal The MagneticDataSeal is a variant of the DataSeal device. Instead of the Sealing Wire it has a Magnet element. This makes it more suitable for cases - 64 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 6 System Overview where you want to sense if the door is open but you can’t seal it. Other than that, it is identical to the DataSeal device. 4. DataReade r The DataReader uses in high frequency (long range) RF communication to communicate with the DataSeals mainly for reading their IDs and their Statuses. T he DataReader can also be used for reading and writing information to and from the DataSeal and retrieving logged events from the DataSeal. Each DataReader can communicate with numerous DataSeals simultaneously and verify their presence and status. T he DataReaders can also be chained together to allow a longer and wider range of coverage. DataReaders must be connected to a controlling computer that control them. 5. DataTe rminal (previously known as Hand Held T erminal or HHT ) This is a mobile handheld device which includes a keypad, a small LCD screen, a low frequency receiver/transmitter, and an RS-232 interface. The main things that you can do with the DataTerminal are: Reading a DataSeal's ID and Status; Reset the DataSeal for a new use ("Set" command); reading and writing data to and from the DataSeal – for example: manifest number, truck number, driver name etc.; reading the events that were logged in the DataSeal; T ransferring this information to and from a PC. 6. DataPort (Previously known as Low Frequency T erminal, or LFT) The DataPort is a simple low frequency modem. It includes a low frequency transmitter/receiver and an RS-232 interface that connects to a PC. In other words, it enables a PC to communicate almost directly with a DataSeal. In general, the DataPort enables the PC to perform the same Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 65 - Chapter 6 System Overview operations as the DataT erminal, given that an appropriate software exists in the PC. 7. MicroDataRe ade r The MicroDataReader is a key ring size mobile device that includes a lo w frequency transmitter/receiver, 1 or 2 buttons and a LED indicator. Using the MicroDataReader you can perform the following functions: 1. Verify – The LED will turn green if the DataSeal's Status is OK, or to red if it's Tampered. 2. Set (Optional) – prepares the DataSeal for a new use. The type of the Set command (normal, Soft Set or Suspended Set) is model specific. Hi-G-T ek can provide MicroDataReaders with different commands if required. 6.2 6.2.1 DataSeal and DataReader Modes of Operation DataSeal Modes of Operation Generally speaking, a DataSeal can be used in any of the following ways: 1. O peration Mode (Normal Mode ) This is the normal and most basic mode of operation. In this mode, the DataSeal is on standby most of the time. Once every predetermined period, called Tw, the DataSeal samples the HF (high frequency) channel searching for a transmission from a DataReader. If it detects such transmission, it listens and answers as needed. The default value of T w is 3 seconds, which is the most appropriate for most applications. In the Operation Mode, the DataSeal also listens constantly to the low frequency channel and responds as needed. During the Operation Mode the DataSeal - 66 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 6 System Overview logs events (like opened, closed, tampered, etc.) and stores them internally in the Events Memory. 2. Dee p Slee p Mode This mode should be use d when the DataSeal is not in use in order to conserve energy. DataSeals always leave the factory in this mode. It is possible to enter a DataSeal to this mode also by using high frequency or low frequency command. To exit this mode, interrogate the DataSeal using low frequency (for example, using a DataTerminal), or send a Hard Wakeup command in high frequency using a DataReader. Note : While in Deep Sleep mode, no Events are recorded. Events aren't recorded also after waking up the DataSeal, until a Set command is performed. In other words, after waking up a DataSeal, you must also perform a Set command in order for the DataSeal to start record events. 3. Ale rt Burst Mode This mode is similar to the Operation Mode. In addition, whenever the DataSeal is opened, it transmits an Alert Burst message in the high frequency channel. T he DataReader and the application should both be configured to receive and handle the alert message. A DataSeal can be configured also to transmit Burst messages on other events. 4. Footprint Eve nts Mode This mode is a way of using the DataSeal, rather than a configuration of the DataSeal. When the DataSeal receives a special variant of the Verify command in low frequency or in high frequency, it records a certain Event called "Read", that includes the DataReader's ID or the low frequency device's ID. To use this special command in the DataReader, the DataReader has to be configured accordingly. This mode is useful to determine the DataSeal's track if there are several DataReaders, or check Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 67 - Chapter 6 System Overview points with DataT erminals along the way. In this scenario, you can know the DataSeal's track by reading its Events, without having to have these DataReaders connected to any central system. 6.2.2 DataReader Modes of Operation There are several aspects that determine the DataReader's mode of operation. T hese aspects are determined by the Mode parameter, which is a bit oriented parameter. 5. Carrie r Sense Collision Pre vention Just like you can't understand what two people are saying when the speak simultaneously, that way a DataSeal can't understand two DataReaders that transmit simultaneously. When two (or more) close DataReaders aren't controlled by the same controlling computer (or by controlling computers that are synchronized among them), there's a chance that they will try to transmit simultaneously. In order to prevent that, the DataReaders can be configured to sense for a carrier (transmission of another DataReader or DataSeal) before they start transmitting. When a DataReader is configured for Carrier Sense, each time before it transmits something it listens to the frequency, and only if it's clear (no one else is transmitting), it start transmitting its own message. 6. Burst Re ceiving Mode When DataSeals are operating in Alert Burst mode, the DataReader’s receiver must be ON at all times in order to receive the Burst messages. The controlling computer has to query the DataReader periodically to receive the Burst messages that the DataReader received. - 68 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 6 6.3 System Overview Most Comm on Comm ands and Seal Status 6.3.1 Most Comm only Used Comm ands There are a number of key commands that are used in most applications, as they enable the basic operation of the system. These commands are: 7. Ve rify The Ve rify command is use d to detect DataSeals which are located within the DataReaders Receiving Zone and also verify their state. The DataSeals which respond may be in one of two states. T he DataSeals may be in either the normal state, meaning the have not been tampered with, or in the tampered state, meaning they have been tampered with. Additional information can also be queried from the DataSeal. T his is the most useful and commonly used command in the system. 8. Tampe re d The Tampe re d command is used to communicate with tampered DataSeals. The command operates the same as the Ve rify command only DataSeals which are in the T ampered state respond. T he aim of the command is to provide high priority to tampered DataSeals in a crowded DataSeals environment. 9. Se t The Set command is use d to set a DataSeal for a new use. T he Sealing Wire must be connected and closed in order for a DataSeal to be set. T he Se t command deletes all Events stored in the Events Memory and is the first new Event recorded in the DataSeal. T he DataReader can send the Se t command to up to 8 DataSeals simultaneously. 10. Suspende d Set Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 69 - Chapter 6 System Overview Similar to the Set command, Suspende d Se t is used to set a DataSeal for new use. Unlike the Set command, when performing a Suspende d Se t command, the Sealing Wire Must be opened (or completely disconnected from the DataSeal). T he DataSeal will become armed (Set) once the Sealing Wire has been connected to the DataSeal and closed. 11. Approve Open The Approve Open command allows a Sealing Wire to be opened after the DataSeal has been set in a way that the application can determine that the DataSeal was opened with an approval. When the Sealing Wire will be opened after receiving this command, the application will be a ble to determine that the opening is approved by examining the Approved Open flag in the DataSeal's Status. 6.3.2 DataSeal's Status The DataSeal's Status consists of 4 bytes. A DataReader may be used to request the DataSeal's Status. The DataSeal's Status is use d to indicate the DataSeal's current state and is a bitwise value. Each bit in the Status represents a specific status flag. The DataSeal's Status is divide d into the Short Status and Long Status parameters as explained below: The DataSeal's Short Status parameter consists of 1 byte (8 bits) which is a subset of the Long Status parameter. The Short Status contains the most important flags. T hese flags are: 1. Tampe re d – The Tampe re d flag gets set if the Sealing Wire was opened or tampered with. It remains set even if the Sealing Wire is closed again. It can only be unset by performing on of the Se t commands. 2. Low Battery Warning – Battery is low, replace the DataSeal. 3. O pene d – Indicates that the Sealing Wire is open. - 70 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 6 System Overview 4. Suspende d Se t – A Suspende d Set command was performed, and the Sealing Wire wasn't closed yet. 5. Se aling Wire Change d – Indicates that the Sealing Wire's electronic characteristics have changed since the DataSeal was Set. 6. Dee p Slee p – Indicates that the DataSeal is in Deep Sleep mode. 7. Ge neral Error – Indicates an error with the DataSeal that is not represented in the DataSeal's Short Status. 8. Approve d O pen – If the DataSeal O pe ne d flag is on, the Approve d O pen flag means that the opening is approved. If the DataSeal's O pene d flag is off, it means that the next open will be approved, if performed during a certain period. The DataSeal's Long Status contains the Short Status flags as well as 3 additional bytes that together represents the complete DataSeal's status. For a detailed description of the Long Status, see chapter 8. 6.4 System Planning When planning an application, attention should be paid to both system operation and topology. Application requirements and electromagnetic environment characteristics should also be taken into account. 2 basic types of applications are possible: Fixed DataReader applications and Mobile DataReader applications. A complex application that combines DataReaders in both configurations is also possible. The Fixed DataReader applications are applications where the DataReaders are mounted at a fixed site. The Mobile applications are situations where the DataReaders are mounted on vehicles for monitoring DataSeals in transit. Mobile applications are normally implemented using the TrackingDataReader, but may also be implemented using a DataReader Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 71 - Chapter 6 System Overview connected to any mobile controller (E.g. laptop, palmtop, etc), that has a serial communications port. 6.4.1 Electrom agnetic Environment Radio Frequency Communication is the basic technology used by the system. While this is a very robust method for communicating with remote devices, several issues should be considered when planning a site. Metal walls should not be used to shield the remote devices. Communication distance between remote devices may vary due to atmospheric conditions and other electromagnetic interferences. Communication distance may also vary according to one or more of the following: • Line of sight between devices – existence and clearance. • Proximity to metal objects. • Indoor or Outdoor environment. • Antenna orientation between the devices. It is recommended to map the site with actual devices for proper coverage. When planning the site layout, safe margins should be taken into account to ensure proper operation at all times. Possible environmental changes should also be considered. 6.4.2 System Layout T wo aspects should be considered when dealing with system layout: 1. Radio Frequency Communication Layout. 2. Line Communication RS-485 or RS-232 Layout. - 72 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 6 System Overview 6.4.2.1 Radio Frequency Communication Layout. When only one DataReader is in use, the previously mentioned environmental considerations are all that need be taken into account. When more than one DataReader is in use, it should be understood that in the same area only one DataReader can communicate with the DataSeals at the same time. Interference will be cause d by more than one DataReader Trying to communicate with the DataSeals in the same period of time. The DataReade rs should be synchronize d using the application software or using the Carrie r Sense mode . Several DataReaders may operate simultaneously provided that it has previously been confirmed that they will not interfere with each other. 6.4.2.1.1 Cellular Layout Cellular topology should be used to ensure efficient coverage of a large area. The following diagram illustrates the concept: Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 73 - Chapter 6 System Overview Re ade r Zo ne DataReaders must be properly placed to ensure there are no dead zones within the defined area. Overlaps should be as shown in the above drawing. DataReader's Receiving Zone is the term used to describe the area of reliable communication covered by a DataReader. T he DataReader's Receiving Zone is also called a Cell. As the drawing illustrates, it is extremely important that the application software controls and synchronizes the DataReader’s operation in order to avoid RF collisions. In other words, the application software has to make sure that no two DataReaders with overlapping Receiving Zones transmit at the same time. 6.4.2.2 Line Comm unication RS-485 Layout The connection of many DataReaders to a controlling computer is done via the RS-485 protocol. Up to 32 DataReaders may be connected to one serial - 74 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 6 System Overview communications port, depending on the type of RS-485 to RS-232 converter used. T wo topologies can be used: A long daisy chain connection, where all the DataReaders are connected in one long line. A star-type connection, where the DataReaders are split into groups and each group is connected directly to the converter. It is recommended that the second alternative be used wherever possible. A star-type connection provides better tolerance to connection failures. This alternative is also preferable from the power supply point of view, as only one power supply for the DataReaders is necessary. The power supply should be located near the converter. When the line is divided into segments, the voltage drop along the segments is smaller. 6.5 Systems Segregation When Hi-G-T ek has designed the system, several security and operational considerations have been taken into account: Similar equipment belonging to one company should not be able to mess with another company's system either intentionally or unintentionally. Limit unauthorized access between different departments of the same company. Equipment belonging to one department of a company should not be able to interfere with equipment of another department, either intentionally or unintentionally. Service Providers should be able to communicate with their customer's equipment in order to supply common services to several companies. This should be done in an authorized an limited manner. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 75 - Chapter 6 System Overview DataSeals may have to be divided into groups that are not related to companies or departments. 6.5.1 Com panies Segregation by OrgID OrgID is a unique value assigned to each company by Hi-G-T ek or by one of its authorized dealers. Every device supplied to that company is preprogrammed with the same OrgID at production, and the customer can't change it ever again. In every communication between two devices, the caller (e.g. DataReader) sends its own OrgID value. When the consignee (e.g. DataSeal) receives the message, it first compares the OrgID it received with its own OrgID, and only if they match the consignee performs the command and sends its response. If a DataSeal receives a message a different OrgID than its own, it turns on the Ille gal O rgID flag in the Long Status, and ignores the message. There's one exception in which a DataSeal can respond to a message with a different OrgID in order to allow collaboration with service providers. This is described in more details in section 6.5.3. 6.5.2 Department Isolation Department is a unique value assigned by a company to a group of devices belonging to the same department. It is possible to isolate equipment between departments by using the Department parameter in the various devices. The default value of Department is zero in all devices. When set to that default setting, all the devices can communicate with one another without any limitations. If a DataReader's Department value is not zero, it can communicate only with DataSeals that has the same Department value. - 76 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 6 System Overview If a DataReader's Department value is not zero, it can communicate with all of the DataSeals in the same organization, even if their Department value is non-zero. Such a DataReader is considered "Supervisor". T he De partment parameter both in DataReaders and in DataSeals can be changed by the user at any time. 6.5.3 Services to Several Companies by a Service Provider The DataSeal has a boolean parameter named Global, which is designed to allow a Service Provider to service several customers. If a DataSeal’s Global parameter is on, then that DataSeal will respond to any Ve rify command from any DataReader, regardless of OrgID. T he Ve rify response will be a limited one, containing only a certain few of the DataSeal parameters. See the description of the Global parameter in chapter 8 for a list of the parameters that can be included in the Ve rify response in this case. Note : T he Global parameter is programmed during production, and it must be define d and re queste d in advance . 6.5.4 Subgroups of DataSeals When a DataReader sends a Ve rify command In order to detect the DataSeals in its area, it can receive only a limited number of responses at a time. If there are many DataSeals in the DataReader's Receiving Zone there could be too many DataSeals trying to respond at the same time, and that would cause that none of them will be properly received by the DataReaders. In order to avoid that, the DataSeals can be divided into small groups and each group be assigned a unique value called ADI. When the DataReader will execute a Ve rify command, it would be able to specify a specific group, and only DataSeals that belong to that group will respond. If the DataReader would iterate through the groups, it can receive all the DataSeal in a relatively short time. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 77 - Chapter 6 System Overview For that purpose, the DataSeal and DataReader devices have an ADI parameter. T he ADI parameter works very similar to the De partment parameter, with 2 differences: ADI is 4 bytes while De partment is 1 only byte, and the controlling computer can explicitly specify a different ADI for each RF command it requests the DataReader to transmit. The ADI parameter can be used also to create groups by usa ge in other scenarios. 6.5.5 OrgID, Department, Global and ADI Impact on DataSeal’s Response The following statements summarizes when and what a DataSeal responds: 1. If the DataReader's De partment parameter is zero, the De partment is always considered to match. 2. If the DataReader sends a zero ADI, the ADI is always considered to match. 3. OrgID doesn't match and Global is on: DataSeal will respond with limited Ve rify command only. 4. OrgID doesn't match and Global is off: DataSeal will not respond. Table 6-1 : OrgID and G lobal OrgID Global Effe ct: Unmatched ON DataSeal will respond with limited Verify command only Unmatched OFF DataSeal will not respond - 78 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 6 System Overview 5. OrgID matches, De partment matches, and ADI matches: DataSeal will respond without limitations. 6. OrgID matches, and ADI doesn't match: DataSeal will not respond. Table 6-2 : OrgID, Department, and ADI OrgID De partment ADI Effe ct: Match Match Match DataSeal will Respond without any limitations. Match Match/ Unmatched Unmatched DataSeal respond will not Match Unmatched Matched/ Unmatched DataSeal respond will not Unmatched Match/ Unmatched Match/ Unmatched DataSeal respond will not 6.6 DataSeal's Memory The DataSeal's Memory is divided into 2 sections: Events Memory and User Data. 6.6.1 Events Mem ory This memory stores the Events detected by the DataSeal during normal operation. This memory can contain up to 55 Event records. The memory has a FIFO type structure with 2 segments: T he first segment can store 45 Events and is a simple FIFO buffer. The second segment can store 10 Events and is a cyclic buffer with the last Events detected. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 79 - Chapter 6 System Overview When this cyclic buffer is overrun, the Scroll flag in the Long Status is set. The Se t Event is always the first Event record in the Events Memory. First segment: 45 Events Se t Event Second segment: 10 Events Some Events are caused by an external intervention (like Opened and Closed), while others are caused by internal procedures. The most common Events are the Se t, Tampe re d, Opene d and Close d Events. See chapter 8 for a complete list and descriptions of each Event type. 6.6.2 User Data User Data is the memory segment where free data can be written and read. For example, the electronic manifest can be stored in this memory. The User Data can be read and written using the Read Data and Write Data RF commands accordingly. T he User Data can also be read by the Ve rify and the Read Multi Access Data RF commands. The size of the User Data memory segment is 2KB. - 80 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 6 System Overview Even though all the User Data is simply a flat memory segment, the lowest 53 bytes are of special meaning for the DataTerminal. If you're using or considering to use a DataT erminal in your system someday in the future, you should use these 53 bytes in a way that is compatible with the DataTerminal. The DataT erminal uses the first 53 bytes as follows: 6.6.2.1 The User Data portion used by the DataTerm inal The DataT erminal is capable of viewing and editing 48 bytes (addressed 5 – 52) of the User Data as a structure of ASCII fields. T his structure has to be defined first by the user, using a special PC software provided with the DataTerminal, and then uploaded to the DataT erminal. The structure definition includes the labels and sizes of the fields and is assigned an identifier (called UDT ), and a version number. When the user writes User Data using the DataT erminal, the DataT erminal always stores this identifier and version number in address 0, and the date and time when the data was written, in addresses 1-4. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 81 - Chapter 6 System Overview Table 6-3: Memory map of the lower portion of the User Data. Address Byte Content UDT Version T ime & Date Data 52 6.7 System Comm ands The following list describes the commands that can be sent to one or more DataSeals by the DataReader. For more information about each command see chapter 8 and the DataSealLib COM DLL help file. 1. Ve rify – Uses to detect DataSeals located inside a DataReader's Receiving Zone. 2. Tampe re d – Uses to detect DataSeals located inside a DataReader's receiving zone that are in the T ampered state. - 82 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 6 System Overview 3. Se t – Uses to prepare DataSeals for a new use. Sealing Wire must be attached and closed prior to the Set command. This command can be sent up to 8 DataSeals simultaneously. 4. Suspende d Set – Similar to the Se t command except that the Sealing Wire must be open prior to performing the command and the DataSeal gets set once the Sealing Wire is closed. T his command can be sent to up to 8 DataSeals simultaneously. 5. Soft Se t – Similar to the Se t command, the Soft Set command is use d to prepare DataSeals for a new use. Unlike the Se t command, the Soft Se t command does not delete the previously recorded Events in the Events Memory. This command can be sent to up to 8 DataSeals simultaneously. 6. Dee p Slee p – Puts the DataSeal into Deep Sleep mode. T his command can be sent to up to 8 DataSeals simultaneously. 7. Hard Wakeup – Brings DataSeals which are in Deep Sleep mode back to normal operating mode. This command can be sent to up to 8 DataSeals simultaneously. 8. Start Ale rt Burst Mode – Puts DataSeals into Alert Burst mode. This command can be sent to up to 8 DataSeals simultaneously, or to all the receiving DataSeals. 9. Stop Ale rt Burst Mode – Brings DataSeals which are in Alert Burst mode back to normal operating mode. This command can be sent to up to 8 DataSeals simultaneously, or to all the receiving DataSeals. 10. Acknowle dge Alert Burst – Acknowledges the reception of Alert Burst messages from DataSeals. T he Acknowle dge Ale rt Burst command tells the DataSeal that its message has been received. After receiving an Acknowle dge Ale rt Burst command, the DataSeal stops transmitting its Burst message until a new T ampered event is detected. This command can be sent to up to 8 DataSeals simultaneously. 11. Read Data – Retrieves data from a DataSeals’ User Data area. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 83 - Chapter 6 System Overview 12. Write Data – Writes data into a DataSeal's User Data area. 13. Rese t Data – Erases all the data in a DataSeals’ User Data area. 14. Se t/Reset Status – Sets or resets specific flags of the DataSeal’s Long Status. 15. Write Parame ters – Writes new values to one or more DataSeal parameters. 16. Read Paramete rs – Reads the values of one or more DataSeal parameters. 17. Addresse d Ve rify – The Addresse d Ve rify command is the same as the Verify command except that it is applicable to only one DataSeal. This command is most commonly used to verify that a specific DataSeal is located within a DataReader’s Receiving Zone. 18. Multi Addresse d Ve rify – T he Multi Addresse d Ve rify command is the same as the Addresse d Ve rify command, but is applicable to up to 7 DataSeals simultaneously. 19. Read Eve nts – Reads part of or all Events stored in the DataSeal’s Events Memory. 20. Approve Open – Permits to open a DataSeal after it has been Se t. If opened, both the DataSeal's Approve d O pen and the Tampe re d flags will be set. This command is intended for recognizing permitted DataSeal openings. 21. Start Force d Burst – Forces the DataSeal to send a special Burst message called Force d Burst. It is most useful when this command is executed in Low Frequency, and by that causing the DataSeal to send information to the DataReader. When used in high frequency, it may be executed in one DataReader, while a different DataReader (in another place for example), should receive the Force d Burst message. 22. Te mporarily Disable HF – Disables the HF channel in a DataSeal for a specified period. This is useful to conserve battery when the area may - 84 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 6 System Overview be dense with HF communications that don't apply to that DataSeal, or to prevent the DataSeal from responding to a Ve rify command for a certain period, in order to allow other DataSeals to be received. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 85 - Chapter 7 Evaluation Softw are Evaluation Software Hi-G-T ek provides the DataSeal Evaluation Software for its customers in order for them to get an impression of how the system works. Using the Evaluation Software you can play with many of the system's features and examine its behavior. If you're reading this manual chapter by chapter, you should now have an idea of how the system works but lacking the details. Before going into the details in the next chapters, getting to know the Evaluation Software is just the right thing to do in order to have a tool that allows you to play with the "bits and bytes" of the various commands. 7.1 Softw are Installation If you have an older version of the Evaluation Software you should first remove it (from the "Add/Remove Programs" icon in the Control Panel) Insert the CD-ROM labeled "Hi-G-T ek" into the CD-ROM drive. From the Start menu, choose "Run". Assuming your CD-ROM drive is drive E, type "E:\DataSeal Evaluation Software\Setup.EXE" in the "Run" dialog box. If your CD-ROM drive letter is not E, replace the first E with your CD-ROM drive letter. Click O K to start installing the DataSeal Evaluation Software. Follow the instructions on the screen until it says that the software is successfully installed. If you're using Windows 98, restart your computer (even if you're not requested to by the installation software). - 88 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are The Evaluation Software is now installed. A new shortcut icon " DataSeal Evaluation" is added to your Start->Programs menu. 7.2 Comm unication Setup – The Readers Adm inistration Window The Evaluation Software must know which DataReaders are connected to the computer as well as the serial communication port they're connected to and the baud rate of that port. The Evaluation Software supports up to 32 DataReadres connected using RS-485 to a single communication port or a single DataReader connected using RS232. Configuring the DataReaders, Figure 7-0 communication port and baud rate is done through the Re ade rs Administration window. The Reade rs Administration window can be accessed by clicking on the Reade rs menu button on the top of the screen, and then on Reade rs Administration. Alternatively, click on the Re aders Administration icon (Figure 7-0) or press Ctrl+R. 7.2.1 Defining the Connected DataReaders To add a DataReader, insert the Reader ID in the Re ader ID text box and click on the Add button (Figure 7-0). The Reader ID is located on the back of the DataReader, in barcode and in numeric format. To remove DataReader, use the mouse to Figure 7-0 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 89 - Chapter 7 Evaluation Softw are mark it and click on the Remove button. The Evaluation Software assigns a Reader Address to each configured DataReader automatically. 7.2.2 Setting Up the Comm unication Port In the Reade rs Administration window, click on the Comm. Port drop down list to define the communication port that the DataReaders are connected to. Click on the Baud Rate drop down list to the right of the Comm. Port drop down list to define the baud rate of that port. Once you have made your selection, click on the Set Comm Port button. Figure 7-0 shows the Reade rs Administration window. Figure 7-0 7.3 Reader Setup The Reade r Se tup window allows you to view and to modify the parameters of the DataReaders. A complete description of each parameter is given in chapter 8. To open the Re ader Se tup window, click on the Reade r Setup icon in the toolbar or select the Reade rs menu and then the Re ader Se tup item as shown in Figure 7-0. - 90 - Figure 7-0 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are Figure 7-0 The parameters of the DataReader are divided into 2 groups: MCU and RF Modem. Each group has its own tab in the Reade r Setup window. Some parameters are read-only. These parameters appear over a grey background (like the Firmware Version parameter in Figure 7-0) If you want to change the value of one or more parameters, enter the new value(s) in their corresponding text boxes, and then click Apply to write the new values to the DataReader. To read the current values from the DataReader click on the Refresh button. 7.4 The Verify and Set Window The Ve rify and Se t window contains the most useful commands in a way that is easy to use. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 91 - Chapter 7 Evaluation Softw are You can access the Ve rify and Set window by clicking the Seals menu button on the top of the screen, and then on Ve rify and Se t as shown in Figure 7 0- . Alternatively, you can click on the Verify & Set icon as shown in Figure 7-0 Figure 7-0 or press Ctrl+I. Figure 7-0 shows the various parts of the window. Following are the descriptions of these parts: - 92 - Figure 7-0 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are 3b 3a Figure 7-0 1. Reader ID selection box: In this box, you can choose which DataReader will invoke the commands. 2. Broadcast (normal) Verify frame: Through this frame you can invoke the Ve rify command as well as to control some of its parameters. 3a. Addressed Verify and Set frame: T hrough this frame you can invoke the Addresse d Ve rify command and the Se t command. 3b. Seal ID box: In this box you have to specify the Seal ID with which you want to communicate using the Addresse d Ve rify and the Se t commands. A Seal ID can also be entered to this box by clicking on the desired Seal ID in the Broadcast Verify responses list (Item #8) 4. Result indication box: After invoking any of the commands, this box indicates whether the command succeeded or failed. Success indications appear in green, while failure indications appear in red. In Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 93 - Chapter 7 Evaluation Softw are some cases of failure more detailed information about the cause of the failure can be seen by hovering with the mouse cursor over this box. 5. Addressed Verify response indicators: When a DataSeal responds to an Addresse d Ve rify command, these indicators display the information that was received by it. Its Long Status is displayed in the Seal Status indicators (Item #6) 6. Seal Status indicators: When a DataSeal responds to an Addresse d Ve rify command, these indicators reflect the DataSeal's Long Status as reported by the DataSeal. Flags that are set appear in red, while unset flags remain black. When a DataSeal responds to a Se t command, only the Short Status is returned and is indicated by the leftmost column. The rest 3 columns are dimmed. A complete list of the DataSeal's Long Status flags and their meanings appear in chapter 8. 7. Broadcast Verify responses list: After a Broadcast Verify interrogation, the responses of the DataSeals are added to this list. 8. Cyclical interrogations control frame: T his frame contains some controls that you can use to affect the way that a cyclical interrogation (Broadcast or Addressed) is executed. 7.4.1 Executing Broadcast Verify Command The Broadcast Ve rify command (sometimes referred to simply as Ve rify) is a command that collects information from all the DataSeals that receive the command (given that their OrgID, Department and ADI match). This command is the most powerful command, and has many parameters that enable to fine tune its behavior. A complete description of all the parameters is given in chapter 8. Normally, the default values of the parameters are adequate, but you may change them to best suit your needs. If you want to execute the Broadcast Ve rify command only once, click on the Single Inte rrogation button (shown in Figure 7-0). You can also execute the Broadcast Ve rify command continuously (or cyclically) by - 94 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are clicking the Cyclical Interrogation button. You can control some aspects of the cyclical interrogation from the cyclical interrogations control frame (item #8 in Figure 7-0) as described in section 7.4.4. The results (responses) of the Broadcast Ve rify command are displayed in the Broadcast Verify responses list (item #7 in Figure Figure 7-0 7-0). The results are always appended to this list. To clear the list click on the Rese t button on the lower right side of the window. Each response in the Broadcast Verify responses list contains the following information: Seal ID Events: The number of Event records that exist in the DataSeal. Seal Short Status: This column is divided into 7 sub columns, each represents a single flag in the DataSeal's Short Status. If the flag is set (on), the flag appears red, and if unset (off) the flag appears black. T he flags are: • S/T – Set/T ampered: if on, indicates that the DataSeal wa s tampered. • LBW – Low Battery Warning. • O/C – Open/Close: if on, indicates that the Sealing Wire is open. • SS – Suspended Set: if on, indicates that the DataSeal is in Suspended Set state. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 95 - Chapter 7 Evaluation Softw are • WRC – Wire Resistance Changed: indicates that an attempt to short circuit the Sealing Wire was detected. • Sleep – If on, indicates that the DataSeal is in Deep-Sleep mode. • GE – General Error: if this flag is on, it indicates a problem that can be determined by other flags in the DataSeal's Long Status, that are not included in the Short Status. • Session: T his column displays the sequential number of the session (interrogation). This number is increased with each new Ve rify command. This parameter is added by the Evaluation Software, and is not part of the DataSeal's response. • Rdr (Reader): The Reader Address of the DataReader that executed the command. T his parameter is added by the Evaluation Software, and is not part of the DataSeal's response. You can sort the list using any of the following columns by clicking on the title of that column: Seal ID, Events, Session and Reader. The content of the Broadcast Verify responses list can be saved to a tabbeddelimited text file (Seals.txt), by choosing Save to Seals.txt from the File menu. After saving the file, you'll be given the possibility to view the file (if a correct version of Microsoft Excel is installed, the file will be viewe d using Excel, otherwise it will be viewed using Notepad). 7.4.2 Executing Addressed Verify Comm and The Addre sse d Ve rify command is similar to the Broadcast Ve rify command except that it addresses only one specified DataSeal, instead of all the DataSeals that receive the command. In order to execute an Addresse d Ve rify command, you must first specify the Seal ID of the DataSeal you want to interrogate. You do it by typing the - 96 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are Seal ID into the Seal ID box (Item #3b in Figure 7-0). Another option is to select the Seal ID from the Broadcast Verify responses list (Item #7 in Figure 7-0), if it previously responses to Broadcast Ve rify. Figure 7-0 As in the Broadcast Ve rify frame, here you also have the Single Inte rrogation and the Cyclical Inte rrogation options: clicking the Single Inte rrogation button will execute the Addre sse d Ve rify command only once, while clicking the Cyclical Inte rrogation button will execute the Addresse d Ve rify command cyclically according to the options that are selected in the Cyclical Interrogations control frame (Item #8 in Figure 7-0) as described in section 7.4.4. The result (response) of the Addresse d Ve rify is displayed in the Addresse d Verify response indicators (Item #5 in Figure 7-0) and in the Seal Status indicators (Item #6 in Figure 7-0). Figure 7-0 The Addresse d Ve rify response indicators contains the following fields: Data & T ime – The current date and time in UT C (GMT) as returned by the DataSeal. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 97 - Chapter 7 Evaluation Softw are # of Events – The number of Event records that are written in the DataSeal. Seal Stamp – The value of the Se al Stamp parameter of the DataSeal. This parameter is a random number that is generated on each open and close. Rdr Addr (Reader Address) – T he Reader Address of the DataReader that executed the command. This field is added by the Evaluation Software and is not part of the DataSeal's response. Status – OK or T ampered. In addition to these indicators, the Seal Status indicators also indicates the DataSeal's Long Status. Flags that are set appear in red, while unset flags appear black. For a complete list of the flags in the DataSeal's Long Status, and their meanings see chapter 0 8. If the DataSeal didn't respond to the Addre sse d Ve rify command, the Result indication box (Item #4 in Figure 7-0) displays a red message "Seal does not respond". 7.4.3 Executing Set Comm and The Set command is used to prepare a DataSeal for a new use. T he Se t command is addressed to a specific DataSeal (in fact, it can be addressed to up to 8 DataSeals simultaneously, but the Evaluation Software does not support it through this window). In order to execute a Set command you must first specify the DataSeal you want to send the command to in the Seal ID box (Item #3b in Figure 7-0). You can do it also by selecting it from the Broadcast Verify responses list (Item #8 in Figure 7-0) if it appears there. The Sealing Wire must be close in order for the Set command to succeed. The result of the command is indicated using the Addressed Verify - 98 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are command indicators and the Seal Long Status indicators (Items #5 and #6 in Figure 7-0). 7.4.4 Cyclical Interrogations Options The Cyclical Interrogations control frame (Figure 7 0- ) contains some options that allow you a variety of ways to execute cyclical interrogations. In the No. of cycles box you can enter the number of cycles that will be executed. If you enter "-1", the Evaluation Software will execute interrogations until you click on the Stop Cycle button. Even if No. of cycles is not "-1", you can click on the Stop Cycle button to stop the interrogations. Figure 7-0 In the System Pause field you can specify the pause between one interrogation to the next in seconds. The Loop through all Reade rs check box is available if more than 1 DataReader is defined. If this check box is checked, the Evaluation Software will execute the first interrogation using the first DataReader in the list, the second interrogation using the second DataReader and so on. After the last DataReader was used, the first one is used again, and so on. For example, it there are 3 DataReaders, and No. of cycles is 8, the order that the DataReaders will interrogate will be: 1,2,3,1,2,3,1,2. The Session # box indicates the sequential number of the interrogation. T he Evaluation Software increases this value with each new interrogation. T o reset this number, and to clear the Broadcast Verify responses list, click the Rese t button. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 99 - Chapter 7 7.5 Evaluation Softw are Executing Any Command using the All Comm ands Window The All Commands window lets you execute any RF command and play with the "bits and bytes" of the RF protocol. Normally, when a software programmer writes an application, he doesn't have to play with the bits and bytes, because the DataSealLib software library (COM DLL) provides higher level interfaces, but acquaintance with the bits and bytes can be very helpful sometimes. Also, this is the only place in the Evaluation Software that you can execute all the RF commands. To access the All Commands window, choose the All Commands item from the Se als menu as shown in Figure 7-0. Alternatively, click on the All Commands icon or press Ctrl+A. - 100 - Figure 7-0 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are Figure 7-0 7.5.1 Executing an RF Comm and To execute an RF command do the following: 1. Select the command from the Command Code drop down list. T he code of the command will be displayed to the right of the drop down list, and the Command Data field will be filled by the default parameters for that command in hexadecimal format. For commands that does not have any parameters this field will be empty. 2. You may change the arguments in the Command Data line as desired. A detailed explanation of each command's structure is the following sections. 3. Select the DataReader that you want to use from the Re ader drop down list. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 101 - Chapter 7 Evaluation Softw are 4. If the command is an addressed command or multi-addressed command (also called BMM List), you have to enter the Seal ID of the DataSeal or DataSeals that you want to address in the Se als/Tags ID box. T o enter more than one Seal ID, enter each Seal ID on its own line. 5. Click the Command Exe cution button. The results will be displayed in an hexadecimal format in the Re sponse box, and for some commands the result will be displayed also as a table or as text. You can also execute a command cyclically by clicking the Cyclic Exe cution button instead of the Command Exe cution button. T o stop the cyclical execution click the Stop button. Using the System Pause field you can specify the pause in seconds between two interrogations in a cycle. The Re ade r Session field displays the duration in milliseconds of one interrogation of the selected command. For some commands you can also change this value. However, note that specifying lower value than the default will usually cause an error. When the command completes, the Result box indicates whether the command succeeded or failed. 7.6 Specific Comm and Structures Below is a description of the each one of the RF commands. For each command its structure (Command Data) is given and also the structure of the response. Complete descriptions of the command arguments are given in chapter 8. - 102 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 7.6.1 Evaluation Softw are Verify The Verify command is used to seek all the DataSeals located in the DataReader's Receiving Zone, that their OrgID, Department and ADI values match those of the DataReader. Figure 7-0 The following table explains the most important arguments shown in Figure 7 0- : Argument Value in Description example Ts 29h (41) Size of response window in milliseconds Nr 32h (50) Number of response windows Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 103 - Chapter 7 Evaluation Softw are Argument Value in Description example #Rr Number of windows that each DataSeal will chose to respond in. Mask D360h A bit mask that determines which parameters the DataSeal will send in the response. In the example, the mask contains the following fields: Short Status, Date & Time , Numbe r of Eve nts, Firmware Version, Long Status, OrgID & De partment and Se al Stamp. In the example, the result contains 7 responses (some of them are from the same DataSeal). Each response is composed of the following fields: Field Value in e xample Description Number of bytes 19h (25) The total number of bytes in the response. Seal ID 48 48 10 10 10 2F (IADA01052719) The Seal ID of the DataSeal that sent this response. Msg type 10h (16) The code of the Ve rify command. Short Status Date & T ime 33 09 93 01(hex) (13/08/2001 9:33) Number of Events - 104 - The DataSeal's internal clock value (UT C) Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are Field Value in e xample Firmware Version 02 03 (hex) (2.03) Long Status 00 00 00 00 OrgID & Department 12 34 00 (hex) Seal Stamp 70 1D (hex) (28701) 7.6.2 Description OrgID = 4660, Department = 0 Tampered (Tam per) The Tampe re d command is used to find all the DataSeals in the DataReader’s Receiving Zone which indicate a Tampe re d status. T he command parameters and response structure are identical to the Ve rify command. 7.6.3 Addressed Verify The Addresse d Ve rify command is identical to the Verify command, except that it is addressed to a specific DataSeal. This command is an Addressed command, and therefore the Seal ID of the addressed DataSeal has to be entered in the Seals/Tags ID field before executing the command. The arguments of the command are identical to the arguments of the Verify command. Note however that there is no use in specifying Rr that is different than Nr in Addresse d Verify, because there are no collisions. Nr and Rr can be greater than 1 in order to increase the probability of reception in case of RF interferences. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 105 - Chapter 7 7.6.4 Evaluation Softw are Set Figure 7-0 The Se t command is used to prepare a DataSeal for a new use. If the Sealing Wire is open while the DataSeal receives the command, the command is not executed. If the Sealing Wire is closed, then all the Event records are deleted, the Tampe re d flag is cleared, and a new (first) Event record is written to indicate the Se t operation. This command is multi-addressed, and can be sent to up to 8 DataSeals in a single command. You must enter between 1 and 8 Seal IDs in the Se als/Tags ID box, one in each line, before executing the command. The Seal Status in the response indicates whether the command succeede d or failed: If the Status is OK (closed, not tampered) the command succeeded, and if it is tampered the command failed. An example of this can be seen in the Re sponse box in Figure 7 0- : the first row indicates an open Sealing Wire and T ampered state, (the Se t operation failed), while the second row indicates a closed Sealing Wire and OK state (the Set operation succeeded). - 106 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are Note : old DataSeals return only the Short Status as a response to the Se t command (as shown in Figure 7 0- ), while newer ones (version 2.20 and above) return Long Status and Seal Stamp. 7.6.5 Soft Set Similar to the Se t command, the Soft Se t command is used to prepare a DataSeals for a new use, but unlike the Se t command, the existing Event records are not deleted. For the description of the response see the Se t command in the previous section. This command is multi-addressed, and can be sent to up to 8 DataSeals in a single command. You must enter between 1 and 8 Seal IDs in the Se als/Tags ID box, one in each line, before executing the command. 7.6.6 Suspended Set This command is also similar to the Set command, but unlike the Se t command, the Sealing Wire can be open, and the operation completes only afterwards, when the Sealing Wire is closed. Between the command execution and the closing of the Sealing Wire, the Suspende d Se t (SS) flag in the Short Status is set. Only when the Sealing Wire is closed, the Event records are deleted, the Tampe re d flag is cleared and a new Suspende d Se t Event record is written. If the Sealing Wire was open at the time of the command execution, the DataSeal's will indicate the following flags in the Status: Tampe re d, O pene d, and Suspende d Se t. If the Sealing Wire was closed at the time of the command execution, the DataSeal will indicate an OK status. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 107 - Chapter 7 Evaluation Softw are Figure 7-0 This command is multi-addressed, and can be sent to up to 8 DataSeals in a single command. You must enter between 1 and 8 Seal IDs in the Se als/Tags ID box, one in each line, before executing the command. 7.6.7 Read Data The Re ad Data command reads data from the User Data memory of the DataSeal. The Evaluation Software displays the result of this command both in hexadecimal and ASCII formats. The largest block size that can be read in one session is 67 bytes. If the arguments of the command are invalid, or the DataSeal can't perform the command due to any other reason, it responds with message type E3 (hex). - 108 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are This command is an Addressed command, and therefore the Seal ID of the addressed DataSeal has to be entered in the Seals/Tags ID field before executing the command. Figure 7-0 The Command Data is composed of the following arguments: Argument Value in example Description Address (2 bytes) The address of the block of data in the DataSeal's memory that you want to read. Block Length (2 bytes) 12h (18) The length in bytes of the block of data that you want to Read. The response is composed of the following fields: Field Value in e xample Description Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 109 - Chapter 7 Evaluation Softw are Field Value in e xample Description Number of bytes 1Ch (28) The total number of bytes in the response. Seal ID 48 48 10 10 10 2B The Seal ID of the DataSeal (hex) that sent this response. (IADA01052715) Msg type 63h Short Status Packet/# of Packets 11h (1 of 1) The first nibble is the packet number, the 2nd is the total number of packets. User Data … The requested data. 7.6.8 The code of the Read Data command. Write Data The Write Data command writes a block of data into the User Data memory in the DataSeal. Figure 7-0 - 110 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are The largest block size that can be written in one session is 67 bytes. If the parameters of the command are invalid, or the DataSeal can't perform the command due to any other reason, it responds with message type E8 (hex). This command is an Addressed command, and therefore the Seal ID of the addressed DataSeal has to be entered in the Seals/Tags ID field before executing the command. The Command Data is composed of the following arguments: Argument Value in example Description P/#PK 11h Packet number out of total number of packets. At this stage this argument is not in use and must be 11h. Base Address The address in the DataSeal's User Data memory to where you want to write the data. Data (All the rest) The data to write to the DataSeal's User Data memory. This field can have any length up to 67. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 111 - Chapter 7 Evaluation Softw are The response data is shown in Figure 7 0- . Figure 7-0 7.6.9 Read Parameters The Re ad Paramete rs command uses to read the values of selected Parameters of a DataSeal. This command is an Addressed command, and therefore the Seal ID of the addressed DataSeal has to be entered in the Seals/Tags ID field before executing the command. The Command Data is composed of the following arguments: Argument Description P/#PK Packet number out of total number of packets. At this stage this argument is not in use and must be 11h. Parameter codes This argument can contain a list of the codes of the Parameters that you want to read. Each Parameter code is 1 byte. A complete list of the DataSeal Parameters and their codes can be found in chapter 8. - 112 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are The response is composed of the following fields: Field Description Number of bytes The total number of bytes in the response. Seal ID The Seal ID of the DataSeal that sent this response. Msg type The code of the Read Parameters command (64h) Short Status Packet/# of Packets The first nibble is the packet number, the 2nd is the total number of packets. Parameter codes and values This field is a list of pairs of codes and values. Each pair corresponds to one Parameter that was requested in the Command Data and is composed from 1 byte of the code of the Parameter and then the value of the Parameter. The size of the value of the Parameter depends on the Parameter itself and can be found in the list of the DataSeal Parameters in chapter 8. 7.6.10 Write Parameters The Write Paramete rs command writes new values for specified Parameters of the a DataSeal. You can write new values for multiple Parameters in one Write Paramete rs command. Note that some Parameters in the DataSeal are read only and cannot be written. In this case, and in any other case of failure, the DataSeal will respond with the Message T ype E9 (hex). Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 113 - Chapter 7 Evaluation Softw are This command is an Addressed command, and therefore the Seal ID of the addressed DataSeal has to be entered in the Seals/Tags ID field before executing the command. The example in Figure 7-0 updates the ADI parameter of the DataSeal to 11h. Figure 7-0 The Command Data is composed of the following arguments: Argument Value in example Description P/#PK 11h Packet number out of total number of packets. At this stage this argument is not in use and must be 11h. - 114 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are Argument Value in example Description Parameters' codes and values 13h (The code of the ADI parameter), 00 00 00 11h (new value) This argument can contain a list of pairs of Parameters codes and their new values that you want to write. Each Parameter code is 1 byte, followed by the value that you want to write to that Parameter. The size of the value depends on the Parameter itself and can be found in the list of the DataSeal Parameters in chapter 8. The response is composed of the following fields: Field Description Number of bytes The total number of bytes in the response. Seal ID The Seal ID of the DataSeal that sent this response. Msg type The code of the Re ad Parame te rs command (64h) Short Status 7.6.11 Reset Data The Reset Data command erases all the User Data area and initialize it to 0s. This command is multi-addressed, and can be sent to up to 8 DataSeals in a single command. You must enter between 1 and 8 Seal IDs in the Se als/Tags ID box, one in each line, before executing the command. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 115 - Chapter 7 Evaluation Softw are The command has no arguments, and the response is shown in Figure 7 0-. Figure 7-0 7.6.12 Deep Sleep The Dee p Sleep command puts DataSeals in Deep Sleep mode. - 116 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are Figure 7-0 This command is multi-addressed, and can be sent to up to 8 DataSeals in a single command. You must enter between 1 and 8 Seal IDs in the Se als/Tags ID box, one in each line, before executing the command. 7.6.13 Hard Wakeup This command returns DataSeals from Deep Sleep mode into normal operation mode. This command is multi-addressed, and can be sent to up to 8 DataSeals in a single command. You must enter between 1 and 8 Seal IDs in the Se als/Tags ID box, one in each line, before executing the command. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 117 - Chapter 7 Evaluation Softw are Figure 7-0 7.6.14 Start Alert Burst Mode The Start Ale rt Burst Mode command puts the DataSeal into Alert Burst mode. In this mode, whenever the DataSeal is opened, it transmits a message that the DataReaders can receive to report the event. The number of transmissions, the pause between then, and the data that will be sent with it can be configured using some DataSeal Parameters. See chapter 8 for a detailed descriptions of the DataSeal Parameters. This command is multi-addressed, and can be sent to up to 8 DataSeals in a single command. You must enter between 1 and 8 Seal IDs in the Se als/Tags ID box, one in each line, before executing the command. - 118 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are Figure 7-1 7.6.15 Start Alert Burst Mode (all) This command is similar to the Start Ale rt Burst Mode command, except that it is a broadcast command instead of a multi-addressed command. In Figure 7-1 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 119 - Chapter 7 Evaluation Softw are other words, all the DataSeals that receive this command enter into Alert Burst mode. This command does not have any arguments, and the receiving DataSeals don't send any response to this command. 7.6.16 Stop Alert Burst Mode The Stop Ale rt Burst Mode command stops the DataSeal from working in Alert Burst mode. This command is multi-addressed, and can be sent to up to 8 DataSeals in a single command. You must enter between 1 and 8 Seal IDs in the Se als/Tags ID box, one in each line, before executing the command. Figure 7-1 7.6.17 Stop Alert Burst Mode (all) This command is similar to the Start Ale rt Burst Mode command, except that it is a broadcast command instead of a multi-addressed command. In other words, all the DataSeals that receive this command stop being in Alert Burst mode. - 120 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are Figure 7-1 7.6.18 Acknowledge Alert Burst The Acknowle dge Alert Burst command confirms to the DataSeal that its Burst message has been received. After T he DataSeal receives the Acknowle dge Ale rt Burst command, the DataSeal stops transmitting the Burst message until a new Tampe re d Event occurs. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 121 - Chapter 7 Evaluation Softw are Figure 7-1 This command is multi-addressed, and can be sent to up to 8 DataSeals in a single command. You must enter between 1 and 8 Seal IDs in the Se als/Tags ID box, one in each line, before executing the command. 7.6.19 Read Events The Re ad Eve nts command reads part or all of the Event records stored in the DataSeal's Events Memory. This command is an Addressed command, and therefore the Seal ID of the addressed DataSeal has to be entered in the Seals/Tags ID field before executing the command. - 122 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are Figure 7-1 The Command Data is composed of the following arguments: Argument Value in example Description First Event number The sequential number of the first Event record to read. Number of Events to read The number of Event records to read. The response is composed of the following fields: Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 123 - Chapter 7 Evaluation Softw are Field Description Number of bytes The total number of bytes in the response. Seal ID The Seal ID of the DataSeal that sent this response. Msg type The code of the Re ad Parame te rs command (64h) Short Status Packet/# of Packets The first nibble is the packet number, the 2nd is the total number of packets. Event records This field contains all the requested Event records. Figure 7-1 illustrates the format of the Event records. A complete description of the Event records is found in chapter 8. The Evaluation software displays the Event records also as a table below the hexadecimal string. Note that there are 2 kinds of Event records: Short Events (8 bytes) and Long Events (16 bytes). In Figure 7-1, Event records 1 and 5 are Long Events, and the rest are Short Events. 7.7 Advanced Features 7.7.1 Built-In Test The DataReader can perform a self-test and report its status. In order to perform the test, open the Te sts window by clicking on the Reade rs menu and then on the Built-In Tests menu item as - 124 - Figure 7-1 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are shown in Figure 7-1. Figure 7-1 shows the Tests window. In order to perform the built-in test, first select the DataReader you want to test from the Reade r drop down list (Item #1). T hen click on the Exe cute Built-In Te st button. If you only want to get the results of the last performed test, click on the Ge t Current Re ader Status button. Figure 7-1 The Voltage Value s box (Item #2) displays the actual values measured by the DataReader: The first value (2.544 in the example) represents the voltage value of the MCU, the second (0 in the example) represents the voltage value of RF Modem #1 (not installed) and the third value (2.56 in the example) represents the voltage value of RF Modem #2. Item #3 displays the status flags of the DataReader. A flag that is on appears red, while flags that are off appear black. 7.7.2 Authorization Levels and Passwords Some features in the Evaluation Software are meant to be used only by advanced users or by Hi-G-T ek's distributors. To prevent unauthorized users from accessing the advanced features, the software requires a password. The software recognizes 3 levels of authorized users: User (the default), Administrator and Distributor. This manual does not cover the features that are available only to Distributors. Note : The levels of authorization, passwords and log-ins of the Evaluation Software are completely separate from the user permissions, passwords and log-ins which are used by the operating system. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 125 - Chapter 7 Evaluation Softw are 7.7.2.1 Logging-in Using the Desired Authorization Level After the software is installed, it does not request a password and is automatically activated using the User authorization level (the lowest). In order to log in with a different level of authorization, do the following: Open the O ptions dialog (shown in Figure 7-1) by choosing O ptions from the Tools menu, as shown in Figure 7 1- . Clear the check box labeled Always login using this use r type and password (item #1 in Figure 7-1) Click O K to close the Options Figure 7-1 dialog windo w. Restart the Evaluation Software (exit the software, the run it again). You should now see the Login dialog windo w as shown in Figure 7 1- . Choose the desired authorization level from the Login as drop down list, type the appropriate password in the Password box and click O K. The Default password for User is empty (no password), and for Administrator is Figure 7-1 "Admin". 7.7.2.2 Changing Passw ords In order to change a password for a particular user type (authorization level), you must be logge d in to the - 126 - Figure 7-1 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are Evaluation Software using this user type. For example, in order to change the Administrator's password you must be logged in as Administrator. To change the password of the currently logged in user type do the following: Open the O ptions dialog (shown in Figure 7-1) by choosing O ptions from the Tools menu, as shown in Figure 7 1- . Make sure that the user type that appears in the Current Logge d-in Use r box is the user type to which you wish to change the password. If it is not, close the options dialog by clicking Cancel, then restart the Evaluation Software and log in using the user type to which you want to change the password. Type in the old password in the appropriate box. Type the new password in the appropriate box. Type the new password again in the box labeled Re-ente r ne w password. Click on the Change Password button. If everything went fine (the old password was correct and the 2 new copies of the new password are equal), an acknowledgment message box will appear, saying that you must click on Ok or Apply in order to apply the change. Click O K to apply the change and to close the dialog window. 7.7.3 Updating the DataReader's Internal Softw are The DataReader's internal software is composed of 2 modules. These modules can be updated (downloaded to the DataReader) with newer versions supplied by Hi-G-T ek when they'r e available. The Evaluation Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 127 - Chapter 7 Evaluation Softw are Software includes 2 do wnload utilities to update these 2 modules: T he MCU Download Utility and the RF Modem Download utility. 7.7.3.1 The MCU Dow nload Utility To update the DataReader's MCU software do the following: Open the MCU Download window (shown in Figure 7 1- ) by choosing the Tools menu, then the Update Reade r's Software -> MCU item as shown in Figure 7 1- . Select the appropriate Reader ID from the drop down list. Type the full path and file name of the updated software's file, or click Browse … to select it using a common file selection dialog box. Click Start to start the download process. If the download process starts successfully, a progress bar will indicate the progress of the download process. If after 10 seconds the process won't start, the message shown in Figure 7 1- will be displayed, letting you the option to keep trying or to cancel. - 128 - Figure 7-1 Figure 7-1 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 7 Evaluation Softw are After the process has been completed successfully, an appropriate message will appear, and the Figure 7-1 DataReader will reinitialize itself using the new software. T he re-initialization takes about 30 seconds in which the power LED of the DataReader alternates between red and green, and at the end it should remain green. If it remains red or unlit, see chapter 0 for troubleshooting. 7.7.3.2 RF Modem Dow nload Utility To update the DataReader's RF Modem software do the following: Open the De vice Download Utility window (shown in Figure 7 1- ) by choosing the Tools menu, then the Update Reade r's Software ->RF Modem item as shown in Figure 7-1. Figure 7-1 Select the appropriate Reader ID from the drop down list. If the appropriate Reader ID does not appear in the drop down list, return to the Re ade rs Administration window and add the DataReader as described in section 7.2. Type the full path and file name of the updated Figure 7-1 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 129 - Chapter 7 Evaluation Softw are software's file, or click Browse … to select it using a common file selection dialog box. Make sure that the value in the De vice drop down list shows "2". Click Start to start the download process. A progress bar will indicate the progress of the download process. During the process the DataReader's Power LED indicator will be off. After the process has been completed successfully an appropriate message will appear, and the DataReader's Power LED indicator will turn green. - 130 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands System Parameters and Commands This chapter describes the details of the communications with the DataSeal and the DataReader. Even though Hi-G-T ek publishes the RS-232/485 protocol of the DataReader, and part of the RF protocol, this manual does not cover these details. Instead, it describes the commands and the parameters in a more conceptual way, with syntax and examples in Visual Basic as they can be used through the DataSealLib COM library. Note there's also an online help that is supplied with the library. T his online help is more technical than the explanations in this chapter: while this chapter explains the concepts, the online help describes the COM interface in more details. 8.1 The High Frequency RF Protocol 8.1.1 The Basics In order to conserve power, the DataSeal is "asleep" most of the time. It only opens its High-Frequency receiver for a short time every predetermined period – usually 3 seconds. T his fact has some implications on the RF protocol as explained below. The interval in which the DataSeal opens its receiver is determined by a configurable parameter called Tw ( which its default value corresponds to about 3 seconds). Because the DataSeal listens to the RF only in this intervals, if a DataReader wants to communicate with that DataSeal, it must transmit a special signal called Reader Interrogation Header, that is at least in the duration of Tw, in order for the DataSeal to receive it. When the DataSeal receives this signal (in the short period that its receiver is open), it knows that a command should follow, and it waits for that command. After - 132 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands receiving and performing the command and responding if necessary, it returns to the state of sleeping and opening the receiver every Tw. The duration of the Reader Interrogation Header should be 135msec more than Tw. T he DataReader has a configurable parameter called Thw that determines this period. Note that the DataSeal's Tw parameter should be configured with the same value for all the DataSeals, and the corresponding Thw parameter value should be configured appropriately in all the DataReaders in a given system. DataSeal Wakeup period (T w) Response DataReader - Receive - T ransmit Reader Interrogation header (Thw = T w +135ms) Command Figure 8-0 Figure 8-0 demonstrates the concept of the wakeup period and the Reader Interrogation Header. T he upper line represents the time line of the DataSeal, and the bottom line represents the time line of the DataReader. It is clear to see from that figure why Thw (the length of the Reader Interrogation Header) should be just a bit more than the Wakeup Period (Tw). Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 133 - Chapter 8 System Parameters and Comm ands The Reader Interrogation Header is composed of many short segments that contain indications of when the command starts. This way, when a DataSeal receives the Reader Interrogation Header, it doesn't have to keep its receiver open until the command, rather, it goes to sleep exactly until the command. Choosing the best Tw and Thw should take in account the following facts: Small Tw and Thw will improve response times for RF command. Big Tw and Thw will cause lengthily interrogations. Small Tw and Thw will shorten the battery lifetime of the DataSeals. Big Tw and Thw will lengthen it. 8.1.2 Addressing Types In general, there are 3 types of commands that are distinguished by the way they indicate which DataSeal or DataSeals will respond: 1. Addresse d (AMM): These commands specify exactly one Seal ID. Only the DataSeal with that Seal ID responds. 2. Multi Addresse d (BMM List): These commands specify a list of Seal IDs. The DataSeals in the list respond in the same order as they appear in the list. This way there are no RF collisions between the responses of the different DataSeals. Multi Addressed commands without arguments can contain up to 8 Seal IDs in the list. Currently, the only Multi Addressed command with arguments is the Multi Addre sse d Ve rify, which can contain up to 7 Seal IDs. 3. Broadcast (BMM): These commands are aimed for all the DataSeals that receive the DataReader's transmission. There are actually 2 types of broadcast commands: commands without response and commands with response. T he commands that do not wait for a response from the DataSeals are the simplest, in the way that after the DataReader has - 134 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands transmitted the command, the commands is completed, and whatever DataSeals that received the command, performed it. T he second type – commands with response – use the Slotted Aloha concept in order to overcome potential RF collisions between the responding DataSeals. The only commands of this type are the (broadcast) Verify and the Tampe re d commands. T he Slotted Aloha concept is described in the following paragraph. 8.1.3 The Slotted Aloha Concept Because the set of the receiving DataSeals is not known in advance, there's no deterministic way to synchronize their responses. In other words, RF collisions are unavoidable. However, by using retransmits, the probability of receiving all the responses can be very high. Here's the way it works: The command includes 2 arguments that are relevant to this matter: Nr and Rr. Nr determines the total number of windows (time slots) in which the DataSeal can respond, and Rr determines how many times the DataSeal will transmit its response (or: how many time slots the DataSeal will actually use to send its response). It is clear that Nr should be much greater than Rr in order to allow many DataSeals to be received. Each DataSeal randomly chooses Rr time slots in which it will respond. The following table demonstrates the situation when Nr (number of windows) is 23, Rr (number of retransmits) is 4, and there are 3 DataSeals in the DataReader's Receiving Zone: Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 135 - 18 17 16 15 14 13 12 11 10 2 x Chapter 8 System Parameters and Comm ands In this table, each row represents one DataSeal, and each column represents a windo w. An 'X' in a cell represents that the DataSeal sent its response in the specified window. Note that there are exactly 4 'X's in each row, corresponding to Rr. You can see that even though there were some collisions (in windows 4 and 16), all the 3 DataSeals have at least 1 transmission that does not collide with any other transmission. In order to achieve high probability to receive all the DataSeals, an estimation of the maximal number of DataSeals that would respond should be taken in account before selecting the appropriate values for Nr and Rr. Fortunately, DataSealLib provides a function that calculates the appropriate values for Nr and Rr according to the maximal number of expected DataSeals. T his function is the RFParamete rs.De faultsFor method. In fact, the newer DataSeals (versions 3.0 and above), use an improvement of the Slotted Aloha concept: Whenever the DataReader receives a specific DataSeal it sends an acknowledge to that DataSeal, causing it to stop retransmitting its response. This lowers the probability for further collisions and can shorten the total time of the interrogation by using lower Nr value, or allow more DataSeals to be received in the same time. T he RFParame te rs.DefaultsFor method takes this improvement into account too. 8.2 DataSeal Parameters The DataSeal can be configured very flexibly to fit almost any application requirements. For that purpose it has a set of predefined Parameters that can be read and/or written. The DataSeal also has some Parameters that are read-only, either because they are configured in the factory (like the Seal ID), or because they are status Parameters. All the Parameters can be read using the Read Parame te rs RF command, and all the Parameters that are not read only can be written to the DataSeal using the Write Parame ters RF command. Some Parameters can also be - 136 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands read using the Verify and Tampe re d commands (including Addressed and Multi Addresse d Ve rify). In DataSealLib, all the DataSeal Parameters has corresponding properties of the Se al object. See the online help for information about how to use these properties. T here's also an enumeration that contains constants for the parameter codes (HGTSealParame terCode Enum). This enumeration is used by the Seal.ReadParame ter, Seal.ReadParame ters, Se al.Write Paramete r and Se al.Write Paramete rs methods. Another enumeration contains the flags of the Verify Mask that allows to read parameters using the Verify and Tampe re d commands. This is the HGTVe rifyMaskEnum enumeration, and it is used by the Reade r.Ve rify, Se al.Ve rify, and Se als.Ve rify methods. Below are the descriptions of all the DataSeal Parameters: ADI Se al O bject Prope rty ADI Access Read & Write. Description An identifier of a group that the DataSeal belongs to. HGTADI (13h) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Long Remarks See chapter 6 for more information about this parameter. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 137 - Chapter 8 System Parameters and Comm ands Alert and Close Burst Period (Tb) Se al O bject Prope rty Ale rtBurstPe riod (CloseBurstPe riod is a synonym). Access Read & Write. Description This Parameter determines the base interval for sending retries of Ale rt Burst messages and Close Burst messages. HGTAle rtBurstPe riod (34h). HGTTb Constant in and HGTCloseBurstPe riod are HGTSe alParamete rCode Enum synonyms to HGTAle rtBurstPeriod. Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Long. Max Value: 65535. Unit is 1/1.024ms (976ms). Default Value 4096 (4 seconds). Remarks The actual interval is calculated as follows: Tb + r* Tw/8 Where r is random value between 1 and 7. Alert Burst Data Descriptor Se al O bject Prope rty Ale rtBurstDataDescriptor Access Read & Write. Description Determines what data will be included in an Alert Burst message. - 138 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Constant in HGTAle rtBurstDataDescriptor HGTSe alParamete rCode Enum (72h). Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type BurstDataDescriptor type. Default Value All 0's. Remarks This type has 3 members: Mask (as HGTVe rifyMaskEnum) – determines which parameters the DataSeal will include in the Ale rt Burst message. It works in the same way as the Mask argument of the Verify command. StartAddress (Integer) – determines the starting address of a block of User Data to be included in the Alert Burst message. T his value is relevant only if the HGTUse rDataVerifyMask flag is specified in the Mask member. Length (Byte) – determines the length in bytes of the block of User Data to be included in the Alert Burst message. T his value is relevant only if the HGTUserDataVe rifyMask flag is specified in the Mask member. Note : if all the members are 0, the DataSeal uses the old Ale rt Burst message format (code 77h) instead of the new one (7Ah). Application Flags Se al O bject Prope rty ApplicationFlags (Hidden property) Access Read & Write. Description Bit oriented value that controls specific aspects of the DataSeal's behavior. HGTApplicationFlags (14h) Constant in HGTSe alParamete rCode Enum Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 139 - Chapter 8 System Parameters and Comm ands Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte Remarks The format of this parameter is as follows: Sp Sp Sp Sp Sp Sp Hf Lf Where: Sp - not used (spare) - must be 0. Lf - if Lf=1, then before issuing a Dee p Slee p command in LF, the Sealing Wire must be open; If Lf = 0, Dee p Slee p command in LF will always succeed. Hf - if Hf=1, then before issuing a De e p Sleep command in HF, the Sealing Wire must be open; If Hf = 0, Dee p Slee p command in HF will always succeed. Battery Voltage Value Se al O bject Prope rty Batte ryVoltageValue Access Read-Only. Description Indicates the a value that is proportional to the current voltage value of the DataSeal's battery. HGTBatteryVoltage Value (70h). Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte. Unit is of internal A/D converter. - 140 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Remarks See also the Low Batte ry Error Thre shold and Low Battery Warning Thre shold Parameters. BIT (Built-in Test) Period Se al O bject Prope rty BITPe riod (Hidden property). Access Read-Only. Description This Parameter determines interval that the DataSeal will perform a built-in test. HGTBITPe riod (35h) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte. Unit: 2 * Tw. Value 150 (about 15 minutes). Close Burst Data Descriptor Se al O bject Prope rty CloseBurstDataDe scriptor Access Read & Write. Description Determines what data will be included in a Close Burst message. Constant in HGTCloseBurstDataDescriptor HGTSe alParamete rCode Enum (73h). Ve rify Mask in HGTVe rifyMaskEnum (not supported). Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 141 - Chapter 8 System Parameters and Comm ands Data Type BurstDataDescriptor type. Default Value All 0's. Remarks This type has 3 members: Mask (as HGTVe rifyMaskEnum) – determines which parameters the DataSeal will include in the Close Burst message. It works in the same way as the Mask argument of the Verify command. StartAddress (Integer) – determines the starting address of a block of User Data to be included in the Close Burst message. T his value is relevant only if the HGTUse rDataVerifyMask flag is specified in the Mask member. Length (Byte) – determines the length in bytes of the block of User Data to be included in the Close Burst message. This value is relevant only if the HGTUserDataVe rifyMask flag is specified in the Mask member. Date & Tim e (UTC) Se al O bject Prope rty Date Time Access Read-Only Description Returns the current date & time of the real-time clock of the DataSeal. T he date & time are in Universal Time Coordinates (GMT ). HGTDate Time (1) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum HGTDate Time Ve rifyMask (4000h) Data Type Date - 142 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Deep Sleep Burst Period Se al O bject Prope rty Dee pSlee pBurstPe riod Access Read & Write. Description This Parameter determines the base interval for sending retries of Dee p Slee p Burst messages. HGTDee pSlee pBurstPe riod (77h) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte. Unit is 250ms. Default Value 32 Remarks The actual interval is calculated in the same manner as the actual interval of the Alert Burst messages. Department Se al O bject Prope rty De partment Access Read & Write. Description The identifier of the department within the organization. HGTDe partment (16h) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 143 - Chapter 8 System Parameters and Comm ands Data Type Byte Remarks See chapter 6 for more information about this parameter. Distance Index Se al O bject Prope rty Distance Index Access Read-Only Description Returns a value that is proportional to the distance between the DataReader and the DataSeal. (not available) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum HGTDistance Inde xVerifyMask (400h) Data Type Byte Remarks This parameter can be read only using the Ve rify and Tampe re d commands. In order to read this parameter, the Tcm value (RFParame ters.Tcm) that is used by the Verify or Tampe re d command must not be 0. Event Counter Value Se al O bject Prope rty Eve ntCounte rValue (Hidden property) Access Read-Only. - 144 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 Description System Parameters and Comm ands Indicates the total number of Event records that were written since the last reset. HGTEve ntCounte rValue (75h). Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte Remarks Note : Do not confuse this parameter with the Numbe r of Eve nts parameter that indicates the current number of Events. Firmw are Version Se al O bject Prope rty Firmware Ve rsion Access Read-Only Description Returns the version of the firmware of the DataSeal. HGTFirmwareVe rsion (6) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum HGTFirmwareVe rsionVe rifyMask (200h) Data Type String. Remarks The format of the string is n.nn where the left part is the version number and the right part is the edition number. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 145 - Chapter 8 System Parameters and Comm ands Flags Se al O bject Prope rty Flags (Hidden property) Access Read & Write. Description Bit oriented value that controls specific aspects of the DataSeal's behavior. HGTFlags (14h) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte Remarks The format of this parameter is as follows: Sp Sp Sp Sp Sp Where: Sp - not used (spare) - must be 0. A – if A = 1, after the DataSeal has sent a Burst message it waits for an immediate acknowledge from a DataReader. See the description of the ABM flag in the DataReader's Mode parameter in section 8.6 for more information about this flag. E – if E = 1 then the internal coding of the Date & T ime in the DataSeal Event records is the new format, which has an accuracy of 1 second (instead of 1 minute). M – if M = 1 then the internal coding of the Date & T ime when returned as a response to Ve rify or Tampe re d, or in a Burst message (when the Mask parameter contains the appropriate flag), is the new format, which has an accuracy of 1 second (instead of 1 minute). - 146 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Global Se al O bject Prope rty (not supported). Access Read-Only. Description Determines whether the DataSeal will respond to Ve rify commands that are sent from a DataReader with a different OrgID. HGTAcce ptGlobalCommands (15h) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte Remarks If the value of this parameter is 1, the DataSeal will respond to Verify commands even if the OrgID of the DataReader is not the same as of the DataSeal. Nevertheless, only the following parameters can be retrieved by a DataReader with a different OrgID: Short Status, Date & Time , Numbe r of Eve nts, Firmware Ve rsion and Se al Stamp. See chapter 6 for more information about this parameter. Include User Data in Verify Response Se al O bject Prope rty Use rData Access Read-Only Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 147 - Chapter 8 System Parameters and Comm ands Description Returns a byte array corresponding to a portion of the DataSeal's memory that was reque sted in a Verify or Tampe re d command or in a Burst message (not supported) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum HGTUserDataVe rifyMask (4) Data Type Array of Bytes Remarks In fact, this in not a Parameter of the DataSeal, and cannot be read or written using the Read Parame te rs and Write Paramete rs commands. Instead, it is a flag in the Ve rify and Tampe re d commands that indicates that a block of the User Data is requested, and that the command includes the address and size of this block after the Mask argument. When the DataSeal responds to the Ve rify or Tampe re d command it returns the data that corresponds to the specified address and size. Even though this property is Read-Only, you can write to the User Data area using the Write Data command. Internal Firmware Version Se al O bject Prope rty Inte rnalFirmwareVe rsion (Hidden property). Access Read-Only. Description Internal version number (build number) of the DataSeal's firmware. - 148 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands HGTInte rnalFirmware Ve rsion (40h). Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte. Remarks See also the Firmware Ve rsion parameter. Last Date & Time Update Se al O bject Prope rty LastDate Time Update Access Read-Only. Description The date & time of the last time that the Date & Time parameter was written. HGTLastDate Time Update (38h). Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Date Remarks See also the Minimal Inte rval be tween Time Updates parameter. Last Set Reader ID Se al O bject Prope rty LastSetRe ade r Access Read-Only Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 149 - Chapter 8 System Parameters and Comm ands Indicates the Reader ID of the device that sent the last Se t command (or any of its variants) to the DataSeal. Description HGTLastSe tReade r (9) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum HGTLastSe tReade rVe rifyMask (2) Data Type Long (Reader ID), or Re ade r object. See the online help for more information about the type of this property. Life Counter Se al O bject Prope rty LifeCounte r Access Read-Only Description This value is initialized at the factory to a value of 2048 and it is decremented in each Se t command. HGTLifeCounter (4) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum HGTLifeCounterVe rifyMask (800h) Data Type Long. Max value: 65535. Long Status Se al O bject Prope rty - 150 - LongStatus Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Access Read-Only Description Returns a bit field of the flags that represent the status of the DataSeal. HGTLongStatus (7) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum HGTLongStatusVe rifyMask (100h) Data Type HGTSe alLongStatusBitEnum (Long) Remarks This parameter contains all the status flags of the DataSeal (including these that are part of the Short Status parameter). Use the constants in the HGTSe alLongStatusBitEnum enumeration to determine the state of the specific flags. Each flag has also a corresponding boolean property in the Se al object. Even though this parameter is read-only, some of the flags can be set using the Se t Status command (Seal.SetStatus). Section 8.2.1 contains descriptions of the various flags. Low Battery Error Threshold Se al O bject Prope rty LowBatte ryErrorThreshold (Hidden property) Access Read-Only. Description The highest value of the battery voltage that will cause the Low Batte ry Error status flag to be set. Constant in HGTLowBatte ryErrorThre shold HGTSe alParamete rCode Enum (61h). Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 151 - Chapter 8 System Parameters and Comm ands Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte. Unit is of internal A/D converter. Value 112 Remarks This parameter is factory configured and cannot be changed. See also the Low Batte ry Warning Threshold, and the Batte ry Voltage Value parameters. Low Battery Warning Threshold Se al O bject Prope rty LowBatte ryWarningThreshold (Hidden property) Access Read-Only. Description The highest value of the battery voltage that will cause the Low Batte ry Warning status flag to be set. Constant in HGTLowBatte ryWarningThreshold HGTSe alParamete rCode Enum (61h). Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte. Unit is of internal A/D converter. Value 104 Remarks This parameter is factory configured and cannot be changed. See also the Low Batte ry Error Threshold, and the Batte ry Voltage Value parameters. - 152 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Maxim al Alert and Close Burst Retries Se al O bject Prope rty MaxAle rtBurstRe tries Access Read & Write. Description Determines the number of times that the DataSeal will transmit an Ale rt Burst message or a Close Burst message if it doesn't receive an acknowledge. HGTMaxAle rtBurstRe tries (76h). Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte Default Value 10 Remarks See also the Ale rt Burst Pe riod parameter. Maxim al Deep Sleep Burst Retries Se al O bject Prope rty MaxDee pSlee pBurstRe tries Access Read & Write. Description Determines the number of times that the DataSeal will transmit a Dee p Slee p Burst message if it doesn't receive an acknowledge. Constant in HGTMaxDee pSlee pBurstRetrie s HGTSe alParamete rCode Enum (78h) Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 153 - Chapter 8 System Parameters and Comm ands Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte Default Value Remarks See also the Dee p Slee p Burst Pe riod Parameter. Maxim al Difference in Time Update Se al O bject Prope rty MaxTime DiffUpdate Access Read-Only. Description Updating the Date & Time Parameter is allowed only if the difference from the current value is less than the value of this Parameter. HGTMaxTime DiffUpdate (37h). Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte. Unit: minutes. Value 8 minutes. Remarks This Parameter is factory configured and cannot be changed. See also the Minimal Inte rval be tween Time Updates Parameter. - 154 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Maxim al Message Size Se al O bject Prope rty MaxMessageSize (Hidden property) Access Read-Only. Description The maximal size in bytes of an RF message that the DataSeal can send. HGTMaxMessageSize (52h). Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte Value 80 Remarks This Parameter is factory configured and cannot be changed. Maxim al Num ber Of Events Se al O bject Prope rty MaxNumberO fEve nts Access Read-Only. Description The maximal number of Event records that the DataSeal can store. HGTMaxNumbe rOfEve nts (50h). Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte Value 55 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 155 - Chapter 8 System Parameters and Comm ands Remarks This Parameter is factory configured and cannot be changed. See also the Numbe r of Eve nts, and the Numbe r of Scroll Eve nts Parameters. See also the next section for further information about the Events Memory and the DataSeal Events. Minim al Interval between Time Updates Se al O bject Prope rty MinIntervalBetweenTime Updates Access Read-Only. Description Updating the Date & TimeParameter is only allowed if a the interval specified by this Parameter has passed since the last update. HGTMinIntervalBetweenTimeUpdates Constant in HGTSe alParamete rCode Enum (36h) Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte. Unit: weeks. Value 13 weeks (3 months). Remarks This Parameter is factory configured and cannot be changed. See also the Maximal Difference in Time Update parameter. Num ber of Events Se al O bject Prope rty Eve ntsCount Access Read-Only - 156 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 Description System Parameters and Comm ands Returns the number of Event records that are currently written in the Events Memory of the DataSeal. HGTEve ntsCount (3) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum HGTEve ntsCountVerifyMask (1000h) Data Type Byte Remarks The value of this Parameter may vary according to the version of the DataSeal's firmware, and according to the value of the Maximal Numbe r of Eve nts parameter. Num ber of Scroll Events Se al O bject Prope rty Numbe rOfScrollEve nts Access Read-Only. Description The size of the Scrollable Portion of the Events Memory, specified by the number of Event records that can be stored in it. HGTNumbe rOfScrollEve nts (51h). Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte Value 10 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 157 - Chapter 8 System Parameters and Comm ands Remarks This Parameter is factory configured and cannot be changed. See also the Maximal Numbe r of Eve nts, and the Numbe r of Eve nts Parameters. See also the next section for further information about the Events Memory and the DataSeal Events. OrgID & Department Se al O bject Prope rty OrgID Access Read-Only Description The identifier of the organization and of the department within the organization. HGTO rgID (12h) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum HGTO rgIDVe rifyMask (40h) Data Type Long Remarks The first (most significant) bytes of this parameter are the OrgID value, and the 3 rd byte is the Department. See chapter 6 for further details about the OrgID & De partment Parameters. RSSI Se al O bject Prope rty RSSI Access Read-Only - 158 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Description Returns the reception level of the last RF command. HGTRSSI (8) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum HGTRSSIVe rifyMask (80h) Data Type Byte Seal ID Se al O bject Prope rty Se alID (binary format), FormatB (string format) Access Read-Only*. Description This is the identifier of the DataSeal. Each DataSeal has a unique Seal ID that is given to it in the factory. HGTSe alID1 (10h) – first 2 bytes. Constant in HGTSe alParamete rCode Enum HGTSe alID2 (11h) – last 4 bytes. Ve rify Mask in HGTVe rifyMaskEnum (not supported). Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 159 - Chapter 8 System Parameters and Comm ands Data Type Se alID: SEAL_ID type (contains an array of 6 bytes) FormatB: String in the format AAAAnnnnnnnn where A is any letter from A to Z, and n is any digit from 0 to 9. When read using HGTSealID1 and HGTSe alID2: Both values are of type Long: HGTSealID1 returns the first 2 bytes (0-65535) and HGTSealID2 returns the last 4 bytes (0-FFFFFFFFh) Remarks *Even though the Parameter in the DataSeal is Read-Only, the SealID and FormatB properties of the Seal object in DataSealLib are read/write. See the online help for further details about these properties. Seal Stamp Se al O bject Prope rty Se alStamp Access Read-Only Description This is a unique (random) value that DataSeal generates each time it is being opened or closed, or when it receives one of the Set commands. HGTSe alStamp (17h) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum HGTSe alStampVe rifyMask (20h) Data Type Long. Max value: 65535. - 160 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Remarks This value is also recorded in each Event record. If you read only the Status of the DataSeal periodically, you may see the same Status even though the DataSeal has been opened, closed or Set between the 2 interrogations. By reading also the Se al Stamp, you can determine if something like this happens. Short Status Se al O bject Prope rty ShortStatus Access Read-Only Description Returns a bit field of the most important flags that represent the status of the DataSeal. HGTShortStatus (0) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum HGTShortStatusVe rifyMask (8000h) Data Type HGTSe alShortStatusBitEnum (byte) Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 161 - Chapter 8 System Parameters and Comm ands Remarks This parameter is part of the Long Status Parameter which contains all the status flags of the DataSeal. Use the constants in the HGTSealShortStatusBitEnum enumeration to determine the state of the specific flags. Each flag has also a corresponding boolean property in the Se al object. Section 8.2.1- The DataSeal Status Flags contains descriptions of the various flags. Size of User Data Se al O bject Prope rty Use rDataSize Access Read-Only. Description The size of the User Data memory area in the DataSeal. HGTUserDataSize (42h). Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte. Value About 2K Remarks The exact value of this Parameter depends on the version of the DataSeal's firmware, and on the Maximal Number of Eve nts Parameter. Sleep Duration Unit Se al O bject Prope rty - 162 - Slee pDurationUnit Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Access Read & Write. Description This Parameter defines the units for the Slee p Duration argument in the Ve rify and Tampe re d commands. HGTSlee pDurationUnit (33h) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte. Unit is seconds. Default Value Remarks See the description of the Verify command for more information about this parameter. Time Filter for Read (Footprint) Events Se al O bject Prope rty Time Filte rForReadEve nt Access Read & Write. Description If the interval between 2 Re ad (Footprint) Events is less than the value of this Parameter then the 2 nd Event record won't be written. HGTTime Filte rForRe adEve nt (6Ah). Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte. Unit is Tw. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 163 - Chapter 8 System Parameters and Comm ands Default Value Remarks If the value of this Parameter is 0, then Re ad (Footprint) Event record are always written. The purpose of this Parameter is to prevent too many Event records to be written if a DataReader performs a Ve rify command with Footprint cyclically. See the DataReader's SYS Parameter, and the Re ad Event for further details. Tp (Wakeup Time Interval in Deep Sleep Mode) Se al O bject Prope rty Tp (hidden property) Access Read & Write. Description The interval in which the DataSeal wakes up in Deep Sleep Mode, in order to check for a HF Hard Wakeup RF command. HGTTp (32h) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Long. Max value: 65535. Unit is 1/1.024ms (0.976ms). Default Value 10000 (9.766 seconds) Remarks In Deep Sleep mode, the DataSeal wakes up in the interval specified by this Parameter, to check for a Hard Wakeup command in HF. - 164 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Ts (Time Slot Duration) Se al O bject Prope rty Ts (hidden property) Access Read-Only. Description Indicates the duration of each time slot in Multi Addressed commands without arguments. HGTTs (30h) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Long. Max value: 65535. Unit is 1.024ms. Value 41 Remarks This Parameter is factory configured and cannot be changed. Tw (Wakeup Time Interval) Se al O bject Prope rty Tw (hidden property) Access Read & Write. Description The interval in which the DataSeal wakes up in Normal Mode, in order to check for HF RF commands. HGTTw (31h) Constant in HGTSe alParamete rCode Enum Ve rify Mask in HGTVe rifyMaskEnum (not supported). Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 165 - Chapter 8 System Parameters and Comm ands Data Type Long. Max value: 65535. Unit is 1/1.024ms (0.976ms). Default Value 3000 (2.93 seconds) Remarks See section 8.1 - T he High Frequency RF Protocol for more information about this Parameter. User Parameter 1 and User Parameter 2 Se al O bject Prope rty Use rParamete r1 Use rParamete r2 Access Read & Write Description Each of these Parameters are strings of 8 bytes that the user can use to store anything he wants. HGTUserParame te r1 (68h) Constant in HGTSe alParamete rCode Enum HGTUserParame te r2 (69h) Ve rify Mask in HGTVe rifyMaskEnum HGTUserParame te r1Ve rifyMask (10h) HGTUserParame te r2Ve rifyMask (8) Data Type String. Max length: 8 bytes. Remarks These Parameters can be used by the user for any purpose. - 166 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 8.2.1 System Parameters and Comm ands The DataSeal Status Flags The Long Status Parameter of the DataReader is a 32-bit value which each bit represents a specific flag of Status. T he Short Status Parameter is the 8 most significant bits of the Long Status. Below are the descriptions of each of the Status flags: (All the flags are included in the Long Status, and the first 8 are also included in the Short Status) Tampered Se al O bject Prope rty Tampe re d Mne monic S/T Description This flag gets set when the Sealing Wire is opened or its electrical resistance changes. It is cleared only by one of the Set commands. Constant in HGTSe alShortStatusBitEnum HGTTampe re dShort (80h) Constant in HGTSe alLongStatusBitEnum HGTStatusTampe re d (80000000h) Low Battery Warning Se al O bject Prope rty LowBatte ryWarning Mne monic LBW Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 167 - Chapter 8 System Parameters and Comm ands Description This flag gets set when the DataSeal's battery voltage gets below the value of the Low Batte ry Warning Threshold Parameter. Constant in HGTSe alShortStatusBitEnum HGTLowBatte ryWarningShort (40h) Constant in HGTSe alLongStatusBitEnum HGTStatusLowBatte ryWarning (40000000h) Remarks If this flag is on, the DataSeal is still functioning. However, you should replace the DataSeal as soon as possible before it stops functioning. Opened Se al O bject Prope rty O pene d Mne monic O /C Description This flag is on when the Sealing Wire is open, and off when it is closed. Constant in HGTSe alShortStatusBitEnum HGTO penShort (20h) Constant in HGTSe alLongStatusBitEnum HGTStatusOpen (20000000h) Remarks When this flag is on, the Tampe re d flag is also set (if it wasn't yet). Suspended Set Se al O bject Prope rty - 168 - Suspende dSet Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Mne monic SS Description This flag gets set when a Suspende d Se t command is received, and stays on until the Sealing Wire is closed. Constant in HGTSe alShortStatusBitEnum HGTSuspende dSe tShort (10h) Constant in HGTSe alLongStatusBitEnum HGTStatusSuspende dSet (10000000h) Sealing Wire Changed Se al O bject Prope rty Se alWireChange d Mne monic WRC Description This flag gets set when the electrical resistance of the Sealing Wire changes relative to what it was during the last Se t operation. Constant in HGTSe alShortStatusBitEnum HGTSuspende dSe tShort (8h) Constant in HGTSe alLongStatusBitEnum HGTStatusSuspende dSet (8000000h) Remarks This may indicate that a thief tries to short the Sealing Wire. Deep Sleep Se al O bject Prope rty Dee pSlee p Mne monic SL Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 169 - Chapter 8 System Parameters and Comm ands Description Indicates whether the DataSeal is in Deep Sleep mode. Constant in HGTSe alShortStatusBitEnum HGTDee pSlee pShort (4h) Constant in HGTSe alLongStatusBitEnum HGTStatusDee pSlee p (4000000h) General Error Se al O bject Prope rty Ge neralError Mne monic GE Description Indicates an error that is indicated by flags of the Long Status that are not part of the Short Status. Constant in HGTSe alShortStatusBitEnum HGTGene ralErrorShort (2) Constant in HGTSe alLongStatusBitEnum HGTStatusGene ralError (2000000h) Remarks This flag's value (0 or 1) is the logical OR of the following flags: Life Counte r 0, Re al Time Clock Error, Low Battery Error, Database Error, Database Corrupte d, Hardware Error and Illegal OrgID. Approved Open Se al O bject Prope rty Approve dO pen Mne monic AO - 170 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Description If the O pene d flag is on, this flag indicates whether the open is approved. If the O pene d flag is off, this flag indicates whether opening the DataSeal is allowed. Constant in HGTSe alShortStatusBitEnum HGTApprove dO penShort (1) Constant in HGTSe alLongStatusBitEnum HGTStatusApprove dO pen (1000000h) Remarks This flag gets set using the Approve O pen command, and unset according to the arguments of that command. Opening the Sealing Wire while this flag is on does not prevent the Tampe re d flag from turning on, rather it is possible to detect that this is an allowed "tampered" situation by examining the Approve d Open flag. Life Counter 0 Se al O bject Prope rty LifeCounte rZe ro Mne monic LC0 Description When the Life Counte r Parameter reaches 0, this flag is set. In this case the DataSeal ceases to write Event records. Constant in HGTSe alLongStatusBitEnum HGTStatusLifeCounte rZe ro (800000h) Remarks The Life Counte r Parameter is decremented on each open and close events, and when a Set command is issued. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 171 - Chapter 8 System Parameters and Comm ands Real Time Clock (RTC) Error Se al O bject Prope rty RTC Error Mne monic RTC Description Indicates an error in the Real T ime Clock of the DataSeal. Constant in HGTSe alLongStatusBitEnum HGTStatusRTCError (400000h) Remarks You can clear this flag using the Se t/Reset Status command. Low Battery Error Se al O bject Prope rty LowBatte ryError Mne monic LBE Description This flag gets set when the DataSeal's battery voltage gets below the value of the Low Batte ry Error Thre shold Parameter. Constant in HGTSe alLongStatusBitEnum HGTStatusRTCError (200000h) Remarks When this flag is on, the DataSeal is about to stop functioning, and you should replace the DataSeal immediately. Database Error (Corrupted and Restored) Se al O bject Prope rty - 172 - DBCorrupte dAndRe store d Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Mne monic DBE Description This flag indicates that an error in the DataSeal's internal database was detected, but successfully restored. Constant in HGTSe alLongStatusBitEnum HGTStatusDBCorrupte dAndRestore d (100000h) Remarks You can clear this flag using the Se t/Reset Status command. Database Corrupted Se al O bject Prope rty DBCorrupte d Mne monic DBC Description This flag indicates that an error in the DataSeal's internal database was detected, and could not be fixed. Constant in HGTSe alLongStatusBitEnum HGTStatusDBCorrupte d (80000h) Remarks When this flag is on, you should replace the DataSeal. New Battery Se al O bject Prope rty Ne wBatte ry Mne monic NB Description Indicates that a battery was replaced. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 173 - Chapter 8 System Parameters and Comm ands Constant in HGTSe alLongStatusBitEnum HGTStatusNe wBattery (20000h) Remarks This flag is used only with DataSeals with replaceable batteries. You can clear this flag using the Se t/Reset Status command. Hardw are Error Se al O bject Prope rty Hardware Error Mne monic HRE Description Indicates that an hardware error was detected. Constant in HGTSe alLongStatusBitEnum HGTStatusHardware Error (10000h) Remarks When this flag is on, you should replace the DataSeal. Illegal OrgID Se al O bject Prope rty Ille galO rgID Mne monic O ID Description Indicates that communication with the DataSeal was attempted from a device with a different OrgID or Department. Constant in HGTSe alLongStatusBitEnum HGTStatusIlle galO rgID (8000h) - 174 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Remarks This flag may indicate that someone tried to "hack" the DataSeal using unauthorized equipment. You can clear this flag using the Se t/Reset Status command. Comm and Failed Se al O bject Prope rty CommandFaile d Mne monic CMF Description Indicates that the DataSeal could not execute a command it received. Constant in HGTSe alLongStatusBitEnum HGTStatusCommandFaile d (4000h) Remarks You can clear this flag using the Se t/Reset Status command. Unrecognized Comm and Se al O bject Prope rty Unre cognize dCommand Mne monic UNC Description Indicates that the DataSeal received a command that it does not recognize. Constant in HGTSe alLongStatusBitEnum HGTStatusUnre cognize dCommand (2000h) Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 175 - Chapter 8 System Parameters and Comm ands Remarks One reason for this flag to be set can be in case you're using a DataReader and a COM DLL with a versions that are newer that the version of the DataSeal, and you're trying to execute a new command that the DataSeal does not recognize. You can clear this flag using the Se t/Reset Status command. Close Burst Mode Se al O bject Prope rty CloseBurstMode Mne monic BMC Description Determines whether the DataSeal will send a Burst message when the Sealing Wire becomes closed. Constant in HGTSe alLongStatusBitEnum HGTStatusCloseBurstMode (1000h) Remarks The Burst message that is sent in this case is the Close Burst message. You can set or clear this flag using the Se t/Reset Status command. Note : This flag is in effect only if the Ale rt Burst Mode flag is also set. (Alert) Burst Mode Se al O bject Prope rty Ale rtBurstMode Mne monic BMU Description Determines whether the DataSeal will send Burst messages. - 176 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 Constant in HGTSe alLongStatusBitEnum System Parameters and Comm ands HGTStatusAle rtBurstMode (800h) Remarks If this flag is on, the DataSeal will send an Alert Burst message when the Sealing Wire becomes opened. The Burst message that is sent in this case is the Ale rt Burst message or the Extende d Ale rt Burst message. This flag also determines whether other types of Burst message is allowed. If this flag is off, the DataSeal won't send any kind of Burst message. This flag can be set using the Start Alert Burst Mode and Start Alert Burst Mode for All Se als, and cleared using the Stop Alert Burst Mode and Stop Ale rt Burst Mode for All Se als commands. Buffer Full Se al O bject Prope rty Buffe rFull Mne monic BF Description This flag is set if a Re ad Data, Read Eve nts or Re ad Parame te rs command requests too much data that exceeds the size of the DataSeal's output buffer. Constant in HGTSe alLongStatusBitEnum HGTStatusAle rtBurstMode (80h) Remarks The largest block you can read is Maximal Me ssage Size – 13 (=67 bytes). You can clear this flag using the Se t/Reset Status command. Scroll Se al O bject Prope rty Scroll Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 177 - Chapter 8 System Parameters and Comm ands Mne monic SRL Description Indicates whether the Events Memory began to overwrite older Event records in the Scrollable Portion of the Events Memory, because the Events Memory is full. Constant in HGTSe alLongStatusBitEnum HGTStatusScroll (40h) Remarks See the next section for more information about the Events Memory and the DataSeal Events. High Frequency (HF) Disabled Se al O bject Prope rty HFDisable d Mne monic HFD Description Determines whether the DataSeal will listen to the HF channel. Constant in HGTSe alLongStatusBitEnum HGTStatusHFDisable d (20h) Remarks When this flag is on the DataSeal will not open the HF receiver to listen for messages. You can set or clear this flag using the Se t/Reset Status command. The Te mporarily Disable HF command, and the Ve rify and Tampe re d commands with Slee p Duration argument that is not 0, also turn on this flag for a specified period. Note : T his mode does not affect the Low Frequency channel. - 178 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Send OrgID in Burst Se al O bject Prope rty OrgIDBurst Mne monic O IB Description Determines whether the OrgID of the DataSeal will be sent when it transmits a Burst message. Constant in HGTSe alLongStatusBitEnum HGTStatusOrgIDBurst (10h) Remarks You can set or clear this flag using the Se t/Reset Status command. Accelerated Verify Mode Se al O bject Prope rty (Not supported). Mne monic AVM Description Indicates that the DataSeal is in an Accelerated Verify mode. Constant in HGTSe alLongStatusBitEnum HGTStatusAccelerate dVe rifyMode (8) Remarks See the Accelerate Ve rify command for further information about this flag. 8.3 Events See chapter 6 for a general description of the Events Memory. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 179 - Chapter 8 8.3.1 System Parameters and Comm ands General Structure of an Event Record There are 2 main types of Event records: Short Event Record and Long Event Record. In DataSealLib, both types are represented by the SealEve nt class, but the Short Event Record does not use all the members. T he following SealEve nt class members are used both in Short Events and in Long Event records: Numbe r – The sequential number of the Event record. Code – The code (type) of the Event record. T he HGTEve ntCode Enum enumeration contains the constants for these codes. Date Time – T he date & time (in UT C) when the event occurred. Se alStamp – T he value of the Se al Stamp parameter when the event occurred. CRC – The Cyclic Redundancy Check code that ensures the validity of the first part of the record. The following SealEve nt class members are used only in the Long Event records: Code Ex – T he code of the extension of the Event record. This is always the same as Code + 80h. Reade r ID – T he ID of the device that caused the Event (for example, in a Set operation). Note that this is not necessarily an ID of a DataReader – it could also be the ID of a DataT erminal, DataPort or any other kind of device that could cause the Event. Note : If DataSealLib recognizes the Reader ID as a DataReader that it knows it returns the Reade r object instead of the Reader ID itself. Se alStamp2 – 2 Additional bytes that contain data specific to the type of Event. Most Event types does not use this field at all. - 180 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands CRC2 - T he Cyclic Redundancy Check code that ensures the validity of the second part of the record. Below are the descriptions of the different Event types: Set Constant in HGTEve ntCode Enum HGTSe tEve nt (1) Type of Event record Long When Written On a successful completion of a Set command. Remarks This is always the first Event record in the Events Memory. Sealing Wire Changed Constant in HGTEve ntCode Enum HGTWire Tampe re dEve nt (2) Type of Event record Short When Written If the electrical resistance of the Sealing Wire has changed relative to what it was when the last Set command was executed. Low Battery Warning Constant in HGTEve ntCode Enum HGTLowBatte ryWarningEve nt (3) Type of Event record Short Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 181 - Chapter 8 System Parameters and Comm ands When the DataSeal's battery voltage gets below the value of the Low Batte ry Warning Thre shold Parameter. When Written Remarks There's no "Low Battery Error" Event because when the Low Batte ry Error flag is set the DataSeal ceases to write Events. Sealing Wire Opened Constant in HGTEve ntCode Enum HGTWireO pene dEve nt (4) Type of Event record Short When Written When the Sealing Wire is opened or cut. Sealing Wire Closed Constant in HGTEve ntCode Enum HGTWireClose dEve nt (5) Type of Event record Short When Written When the Sealing Wire is closed. Soft Set Constant in HGTEve ntCode Enum HGTSoftSetEve nt (7) Type of Event record Long - 182 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 When Written System Parameters and Comm ands On successful completion of a Soft Set command. Remarks The Soft Set command is similar to the Se t command, but does not clear the Events Memory. Instead, it writes the Soft Se t Event record. Real Time Clock (RTC) Stopped Constant in HGTEve ntCode Enum HGTRTCStoppe dEve nt (8) Type of Event record Short When Written When the Built-in T est detects an error in the Real T ime Clock. Database Corrupted and Restored Constant in HGTEve ntCode Enum HGTDBCorrupte dEve nt (9) Type of Event record Short When Written When the Built-in T est detects an error in the DataSeal's internal Database, but succeeds to restore it. Remarks If the DataSeal is not able to restore the database, it doesn't write Event records, and you should replace the DataSeal. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 183 - Chapter 8 System Parameters and Comm ands Read (Footprint) Constant in HGTEve ntCode Enum HGTRe adEve nt (10) Type of Event record Long When Written On successful completion of one of the Ve rify or Tampere d commands, if bit 7 of the DataReader's SYS Parameter of the DataReader is 1. Also written on completion of the Low-Frequency Read command. Date & Tim e Updated Constant in HGTEve ntCode Enum HGTTime Update Eve nt (0Bh) Type of Event record Long When Written On successful completion of a Write Paramete rs command that updates the Date & Time Parameter. Value of Se alStamp2 The high (MSB) byte contains the number of minutes (signed) that was added to the previous value of the Date & Time Parameter. The low (LSB) byte is not used (0). Suspended Set Constant in HGTEve ntCode Enum - 184 - HGTSuspende dSe tEve nt (0Ch) Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Type of Event record Long When Written On successful completion of a Suspende d Set command. Remarks If the Sealing Wire was opened when the Suspe nde d Se t command was executed, the Suspende d Se t Event will first be appended to the existing Events, and after closing the Sealing Wire, all the previous Event records will be deleted, and the Suspende d Set Event will become the first. Start Burst Mode Constant in HGTEve ntCode Enum HGTStartBurstMode Eve nt (0Dh) Type of Event record Long When Written On successful completion of a Start Ale rt Burst Mode or Start Ale rt Burst Mode for All Se als command. Stop Burst Mode Constant in HGTEve ntCode Enum HGTStopBurstMode Eve nt (0Eh) Type of Event record Long When Written On successful completion of a Stop Ale rt Burst Mode or Stop Ale rt Burst Mode for All Se als command. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 185 - Chapter 8 System Parameters and Comm ands Start Deep Sleep Mode Constant in HGTEve ntCode Enum HGTStartDee pSlee pMode Eve nt (0Fh) Type of Event record Long When Written On successful completion of a Dee p Slee p command. Remarks After this Event the DataSeal enters Deep Sleep mode and stops writing new Event records. After a Hard Wakeup command the DataSeal wakes up, but it continues to write Event records only after a new Se t command is executed. Approved Open Constant in HGTEve ntCode Enum HGTApprove dO penEve nt (0Fh) Type of Event record Long When Written On successful completion of an Approve Open command. 8.4 High-Frequency RF Comm ands Summ ary There are 3 groups of HF RF commands: Addressed, M ulti Addresse d (with or without arguments) and Broadcast (see section 8.1.2 - Addressing Types for descriptions about these 3 groups). DataSealLib exposes each RF command as a method of a class: Addressed commands are provided as methods of the Seal class; Multi Addressed commands are provided as methods of the Se als class, and Broadcast commands are provided as methods of the Reade r class. - 186 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands All of the methods in DataSealLib that execute RF commands take the following 2 optional arguments (usually these are the last arguments): RFCommandO bject – This argument is used for controlling specific issues regarding the way that DataSealLib returns the results of the RF command. When the command completes, its Result property contains the results. For further information about this argument and the RFCommandO bject class see the online documentation. ADI – This is the ADI (group ID) that will be sent with the command. See chapter 6 for further information about ADI. The following sections contain a summary of the (HF) RF commands and their arguments. The RFCommandO bje ct and ADI arguments are omitted from each command, because they are common to all and described above. Arguments that are relevant only to DataSealLib and does not affect the RF communications, are omitted too. See the online documentation for help about these arguments. Note that there are default values to almost all arguments of all the commands. See the online documentation for further information about these default values. 8.4.1 Broadcast Commands NOP ( No Operation) Me thod Reade r.NOP (Hidden method) Description When a DataSeal receives this commands it does nothing for the specified period. This is sometimes useful when performing a Command Chain. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 187 - Chapter 8 System Parameters and Comm ands Arguments: Name Type Description Period Long The period until the DataS eal will wait for the next comm and. Result Type Boole an Result Description Always returns True (DataSeals don't respond to this command). Remarks See section 8.7 for further information about Command Chains. Verify, Tam pered Me thod Reade r.Ve rify Description Detects which DataSeals are in the DataReader's Receiving Zone, or which tampered DataSeals are in the DataReader's Receiving Zone. It can also read selected Parameters and/or User Data from the receiving DataSeals. - 188 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Arguments: Name Type Description Mask HG TVerifyMaskEnum enum eration The set of param eters to request. Use the 'Or' operator to com bine m ore than one constant from the HGTVerifyM askEnum enum eration. TamperedO nly Boolean Whether to ask only the tampered DataS eal to respond. Internally, DataS ealLib uses this argum ent to determines the type of the comm and that will be sent (the Verify comm and or the Tampered comm and). RFParameters RFParameters class C ontains properties that controls low-level features of the comm and. S ee the R em arks below for further inform ation. StartAddress Integer The starting address of the User Data to request. This argum ent is relevant only if the HGTUserDataVerifyM ask flag is included in the Mask argum ent. Length Byte The length in bytes of the User Data to request. This argum ent is relevant only if the HGTUserDataVerifyM ask flag is included in the Mask argum ent. Result Type Se als class Result Description The Seals class contains the Se al objects that represents the responded DataSeals. The requested parameters are reflected through the Se al objects' properties. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 189 - Chapter 8 System Parameters and Comm ands Remarks The following scheme demonstrates the various parts of the Ve rify command through time: R e a d er O p e r a t in g In t e r r o g a t io n In t e r v a l 1 - I R e a d er M a st e r O p e r a t in g M es s a g e - R M M In t e r v a l 2 - I H e a d e r - IH C a li b r a t io n In t e r l a c e R e c e i v in g M es s a g e s Window Window Window The following scheme demonstrates the various parts of the Receiving Window through time: As si g n ed W i n d ow s AW AW . . . . . . . Ra n do m W i nd o w s AW Na RW RW . . . . . . . Ta m p er W i n d o w s RW Nr TW TW . . . . . . . TW Nt The RFParame te rs class has the following properties: Name Type Description Tcm Byte Duration of the C alibration M essage Window. Units are 1.024m s. If 0 – there's no C alibration M essage Window. The C alibration M essage Window is used along with the HGTDistanceIndexVerifyM ask flag of the Mask argum ent, to determine the relative distance of the DataS eal from the DataR eader. (Default is 0). T iw - 190 - Integer The duration of the R eader Interlace Window. Units are 1.024m s. (Default is 0). Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Ts Byte Duration of the Tim e S lice (window) that the DataR eader receives a single DataS eal response. This duration m ust be in correlation with the number of bytes that were requested in the Mask and Length argum ents, and with the value of the RFParameters.Confirmation Flag property. This property is usually calculated autom atically, or you can use the SetBestT s m ethod to calculate it. Units are 1.024 ms Na Byte Num ber of Assigned Windows. This argum ent is currently not supported by the DataS eals. Nr Byte Num ber of R andom Windows. You can calculate the best value for this property using the DefaultsFor method. Nt Byte Num ber of T amper Windows. These windows are m eant only for DataS eals that their Tam pered flag is on. Rr Byte The 7 rightmost bits are the num ber of random retries in the R andom Windows, which is the num ber of Windows in which each DataS eal chooses randomly to send his responses. The leftm ost bit determines whether the DataR eader will send a confirm ation to a DataS eal when it receives its response. This bit is also exposed through the ConfirmationFlag property. You can calculate the best value Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 191 - Chapter 8 System Parameters and Comm ands for this property using the DefaultsFor method. Rt Byte Num ber of random retries in the Tam per Windows. S leepDuration Byte If this param eter is not 0, and the ConfirmationFlag is True, the DataS eal will execute a Temporarily Disable HF comm and with the duration specified by this argum ent, upon receiving the confirm ation. The units of this argum ents is determined by the DataS eal's S leep Duration Unit param eter. This is useful to avoid collisions and to save battery when you need to receive large amount of DataS eals that are in the sam e zone. Start Alert Burst Mode for All Seals, Stop Alert Burst Mode for All Seals Me thod Reade r.Se tAsyncAle rtBurstMode Description Causes all the DataSeals that receive this command to start or to stop being in Alert Burst Mode by setting or clearing their Ale rt Burst Mode status flag. - 192 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Arguments: Name Type Description Bur stMode Boolean Determines whether to start or to stop B urst M ode. Internally, DataS ealLib uses this argum ent to determines the type of the comm and that will be sent (the S tart Alert Burst Mode for All S eals comm and or the Stop Alert B urst Mode for All Seals comm and). Result Type Boole an Result Description Always returns True (DataSeals don't respond to this command). Accelerate Verify Me thod Reade r.AccelerateVe rify Description Allows large amount of DataSeals to respond to a Ve rify command in a short period of time, and in high velocity (on a train, for example). It does so by changing Tw temporarily to a smaller value (shorter period). Arguments: Name Type Description NewTw Integer The new (temporary) value of Tw. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 193 - Chapter 8 System Parameters and Comm ands Phase Long The interval in seconds of the tim e between the DataS eal receives the comm and and until it starts the Active P eriod (the period in which Tw is replaced with NewTw). ActiveInterval Long The duration of the Active Interval in seconds. The resolution is the m aximum of the following two values: the original value of the Tw param eter and the value of the NewTw argum ent. CheckReader Boolean S ee R em arks. UseInVerify Boolean S ee R em arks. UseInTamper Boolean S ee R em arks. RestoreTwO nConfirmation Boolean Determines whether the DataS eal should exit the Active P eriod (restore Tw ) when it receives a confirm ation to a Verify response. Result Type Boole an Result Description Always returns True (DataSeals don't respond to this command). - 194 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Remarks If the DataSeal received a Ve rify command during the Active Period and Use InVe rify is T rue, upon receiving a confirmation flag to its response it does the following: If Restore TwOnConfirmation is T rue, it restores the original Tw, and leaves the Active Period. If it is False, the DataSeal ignores further Ve rify commands until the end of the Active Period. If CheckRe ade r is T rue, the DataSeal ignores only Ve rify commands transmitted by the same DataReader. The same thing applies for a Tampe re d command and the Use InTampe r flag. When the DataSeal receives this command it sets the Accele rate d Verify Mode flag in the Long Status, and clears it when it leaves the Active Period. 8.4.2 Addressed Commands Addressed Verify Me thod Se al.Ve rify Description Verifies that a specific DataSeal is in the DataReader's Receiving Zone. It can also read selected parameters and/or User Data from that DataSeal. Arguments: Name Type Description Mask HG TVerifyMaskEnum enum eration The set of param eters to request. Use the 'Or' operator to com bine m ore than one constant from the HGTVerifyM askEnum enum eration. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 195 - Chapter 8 System Parameters and Comm ands RFParameters RFParameters class C ontains properties that controls low-level features of the comm and. S ee the R em arks of the Verify comm and for further inform ation. The following properties are not applicable to the Addressed Verify: Na, Nt and Rt. StartAddress Integer The starting address of the User Data to request. This argum ent is relevant only if the HGTUserDataVerifyM ask flag is included in the Mask argum ent. Length Byte The length in bytes of the User Data to request. This argum ent is relevant only if the HGTUserDataVerifyM ask flag is included in the Mask argum ent. Result Type Se al class Result Description The original Seal objects that represents the specified DataSeal. T he requested parameters are reflected through the object properties. Approve Open Me thod Se al.ApproveO pen Description T urns on the Approve d O pen flag in the DataSeal's Status to indicate that it allows to be opened. Arguments: Name - 196 - Type Description Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 ClearO nClose System Parameters and Comm ands Boolean Whether the DataS eal should clear the Approved O pen flag when the S ealing Wire is closed again. Result Type Byte Result Description The Short Status of the DataSeal. Remarks When the DataSeal receives this command it writes an Approve d Open Event record. Temporarily Disable High Frequency Me thod Se al.Te mpDisableHF Description T urns on the HF Disable d flag in the DataSeal's Status for a specified period. Arguments: Name Type Description Period Long (M ax value: 65535). The duration in seconds in which the HF will be disabled. InterruptO nTamper Boolean Whether the DataS eal would reactivate its HF receiver when a Tampered Event occurrs. Result Type Byte Result Description The Short Status of the DataSeal. Read Events Me thod Se al.Re adEve nts Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 197 - Chapter 8 System Parameters and Comm ands Returns all or part of the Event records that are currently in the DataSeal's Events Memory. Description Arguments: Name Type Description StartEventNumber Byte The first Event num ber to read. NumberO fEvents Byte The m axim um number of Event records to read. Result Type Eve nts class Result Description The returned Eve nts object is a collection of Se alEvent objects that represent the Event records. Read Data Me thod Se al.Re adData Description Reads a block of data from the User Data memory of the specified DataSeal. Arguments: Name Type Description BaseAddress Integer The first address in the DataS eal's User Data m em ory from which to start reading. B lockLength Integer The length in bytes of the block of m emory to read from the DataS eal. Result Type Array of Byte s. Result Description The block of data that was read from the DataSeal. - 198 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Remarks The maximal possible BlockLength is 67 bytes. Read Parameters Me thod Se al.Re adParamete rs (for reading multiple parameters) Se al.Re adParamete r (for reading single parameter) Description Reads the value of one or more Parameters of the specified DataSeal. Se al.Re adParamete rs Arguments: Name Type Description CodesAndValues SealCodesAndValues class The collection of the param eters to read. S ee the online docum entation for further inform ation regarding how to fill this collection. Se al.Re adParamete r Arguments: Name Type Description Code HG TSealParameterCodeEnum enum eration The code of the param eter that you want to read. Result Type for Se al.Re adParamete rs Se alCodesAndValues class Result Description for The collection is filled with the values of the parameters. Se al.Re adParamete rs Result Type for Se al.Re adParamete r Variant (according to the type of the parameter) Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 199 - Chapter 8 System Parameters and Comm ands Result Description for Se al.Re adParamete r The value of the parameter that was read. Read Multi Access Data Me thod Se al.Re adMultiAccessData Description Reads one or more blocks of data (possibly inadjacent) from the User Data memory of the specified DataSeal. Arguments: Name Type Description AddressesAndSize s Variant An array that contains pairs of Address and Size of the blocks of User Data to read. Result Type Array of bytes or an array of array of bytes – see the online documentation for further information. Result Description The result is the requested data. Write Data Me thod Se al.Write Data Description Writes a block of data to the User Data memory of the specified DataSeal. Arguments: Name Type Description BaseAddress Integer The first address in the DataS eal's User Data m em ory to where you want to write the data. Data Array of bytes The data that you want to write to th D t S l - 200 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands the DataS eal. Result Type Byte Result Description The Short Status of the DataSeal. Write Parameters Me thod Se al.Write Paramete rs (for writing multiple parameters) Se al.Write Paramete r (for writing single parameter) Description Writes new value(s) to one or more Parameters of the DataSeal. Arguments for Se al.Write Paramete rs: Name Type Description CodesAndValues SealCodesAndValues class A collection that contains pairs of P aram eter codes and the values that you want to write to them. Arguments for Se al.Write Paramete r: Name Type Description Code HG TSealParameterCodeEnum enum eration The code of the param eter that you want to update. Value Variant (according to the specific param eter) The new value that you want to write to that param eter. Result Type Byte Result Description The Short Status of the DataSeal. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 201 - Chapter 8 System Parameters and Comm ands Start Forced Burst Me thod Se al.StartForce dBurst Description Instructs the DataSeal to transmit a special Burst message according to the specified arguments. Arguments: Name Type Description Mask HG TVerifyMaskEnum enum eration The set of param eters that you want the DataS eal to transm it in the Forced Burst m essages. Use the 'Or' operator to com bine more than one constant from the HG TVerifyMaskEnum enum eration. Phase Long The interval in m illiseconds since the DataS eal received the comm and and until it should start sending the Forced Burst m essages. Period Long The m ean interval, in m iliseconds, between retries (retransm its) of the Forced Burst m essages. RandomDiff Long The range, in miliseconds, of the random variance from the m ean interval between retries of the Forced Burst m essages. Retries Byte The m axim um number of retries that the DataS eal will send. S pecify 0 for unlim ited number of retries. Specify 255 to stop the DataS eal from sending further Forced Burst m essages. UserCode Byte A general purpose value that will be sent in the Forced B urst - 202 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands m essages, that you m ay use to indicate the reason for the Forced Bur st m essage. StartAddress Integer The start address of the User Data that will be transm itted in the Forced Burst m essages. The HG TUserDataVerifyMask value m ust be included in the Mask argum ent in order to send data. Length Byte The length in bytes of the User Data that will be transm itted in the Forced Burst m essages. The HG TUserDataVerifyMask value m ust be included in the Mask argum ent in order to send data. Result Type Byte Result Description The Short Status of the DataSeal. Remarks The DataSeal must be in Burst Mode in order to send the Force d Burst messages. Set/Reset Status Me thod Se al.Se tStatus Description Sets or clears specified flags in the DataSeal's Long Status. Arguments: Name Type Description Mask HG TSealLongStatusBitEnum enum eration The m ask of the flags that you want to set. Value HG TSealLongStatusBitEnum enum eration The values of the flags that you want to set. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 203 - Chapter 8 System Parameters and Comm ands Result Type Byte Result Description The Short Status of the DataSeal. Remarks Not all flags in the Long Status can be changed. See section 8.2.1- T he DataSeal Status Flags for information about which flags can be changed using this command. 8.4.3 Multi Addressed Comm ands 8.4.3.1 Multi Addressed Comm ands With Parameters Multi Addressed Verify Me thod Se als.Verify Description Verifies that the specific DataSeals are in the DataReader's Receiving Zone. It can also read selected parameters and/or User Data from those DataSeals. Arguments: Name Type Description Mask HG TVerifyMaskEnum enum eration The set of param eters to request. Use the 'Or' operator to com bine m ore than one constant from the HGTVerifyM askEnum enum eration. RFParameters RFParameters class C ontains properties that controls low-level features of the comm and. S ee the R em arks of the Verify comm and for further inform ation. The following properties are not applicable to - 204 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands the Mult i Addressed Verify: Na, Nt and Rt. StartAddress Integer The starting address of the User Data to request. This argum ent is relevant only if the HGTUserDataVerifyM ask flag is included in the Mask argum ent. Length Byte The length in bytes of the User Data to request. This argum ent is relevant only if the HGTUserDataVerifyM ask flag is included in the Mask argum ent. Result Type Se als class Result Description The returned Se als object contains only the Se al objects of the DataSeals that responded. The requested parameters are reflected through the Se al objects' properties. Remarks The maximal number of DataSeals that can be addressed using this command is 7. To address more than 7 DataSeals you can send this command multiple times, or use a Command Chain. 8.4.3.2 Multi Addressed Comm ands Without Parameters All the Multi Addressed commands without parameters can apply up to 8 DataSeals. T he result type is always a Seals object that contains only the DataSeals that have responded. For all the commands their ShortStatus property is updated according to their response, and for the Set, Suspende d Se t and Soft Set commands also the LongStatus and SealStamp properties are updated. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 205 - Chapter 8 System Parameters and Comm ands Note : All the 3 types of set are performed through DataSealLib using the Se als.SealSe t method. You specify the type of Set through the SetO ptions argument. See the online documentation for further information. Set Me thod Se als.SealSe t Description Prepares the DataSeal for a new use. Remarks When a DataSeal receives this command it performs the following actions: 1. Clearing the following Status flags: Tampere d, Low Batte ry Warning, Opene d, Suspende d Se t and Sealing Wire Change d. 2. Deleting all the Event records from the Events Memory. 3. Write a new Set Event record. 4. The Last Set Reade r parameter is updated. The Se t command fails in the following situations: The DataSeal is in Deep Sleep mode. Life Counte r is 0. The DataSeal's internal database is corrupted. The Low Battery Error flag is on. The Sealing Wire is open. Suspended Set Me thod Se als.SealSe t Description Prepares the DataSeal for a new use. Remarks - 206 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands When a DataSeal receives this command it performs the following actions: If upon receiving the command the Sealing Wire is opened: 1. T urning on the Suspende d Set flag in the Status is on 2. A Suspende d Se t Event is written. 3. After the Sealing Wire gets closed: the following Status flags are cleared: Tampe re d, Low Battery Warning, Opene d, Suspende d Se t, Se aling Wire Change d, Approve d O pen and Database Error. 4. All the Event records are deleted from the Events Memory, except the Suspende d Set Event, that becomes the first Event record. 5. The Last Set Reade r ID parameter is updated. If upon receiving the command the Sealing Wire is closed: 1. The following Status flags are cleared: Tampere d, Low Batte ry Warning, O pene d, Suspende d Set, Se aling Wire Change d, Approve d Open and Database Error. 2. All the Event records are deleted from the Events Memory. 3. A new Suspende d Se t Event is written. 4. The Last Set Reade r ID parameter is updated. The Suspende d Se t command fails in the following situations: The DataSeal is in Deep Sleep mode. Life Counte r is 0. The DataSeal's internal database is corrupted. The Low Battery Error flag is on. Soft Set Me thod Se als.SealSe t Description Prepares the DataSeal for a new use without deleting existing Event records. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 207 - Chapter 8 System Parameters and Comm ands Remarks When a DataSeal receives this command it performs the following actions: 1. Clearing the following Status flags: Tampere d, Low Batte ry Warning, Opene d, Suspende d Se t and Sealing Wire Change d. 2. Write a new Soft Se t Event record. 3. The Last Set Reade r ID parameter is updated. The Soft Set command fails in the following situations: The DataSeal is in Deep Sleep mode. Life Counte r is 0. The DataSeal's internal database is corrupted. The Low Battery Error flag is on. The Sealing Wire is open. Reset Data Me thod Se als.ResetDataBlock Description Initializes all the User Data memory to 0's. Deep Sleep Me thod Se als.DeepSleep Description Puts the specified DataSeals in Deep Sleep mode. Remarks When a DataSeal receives this command it performs the following actions: 1. The Dee p Sleep flag in the DataSeal's Status is turned on. 2. A Dee p Slee p Event is written. 3. If the Alert Burst Mode flag is on, an Ale rt Burst message sending - 208 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands process begins. If the HF flag in the Application Flags parameter is 1 and the Sealing Wire is closed, the command fails. In Deep Sleep mode, built-in tests and Sealing Wire resistance checking are not performed. T he DataSeal wakes up in Tp intervals to check for a Hard Wakeup command. Hard Wakeup Me thod Se als.DeepSleep Description Wakes up DataSeals that are in Deep Sleep mode. Remarks When a DataSeal receives this command it performs the following actions: 1. The Dee p Sleep flag is cleared. 2. The wakeup interval of the DataSeal returns to be Tw (instead of Tp). However, built-in tests and Sealing Wire resistance checking are not performed until the successful completion of the next Set, Suspende d Se t, or Soft Set command. Start Alert Burst Mode, Stop Alert Bust Mode Me thod Se als.SetAsyncAle rtBurstMode Description Starts or stops the specified DataSeals from being in Burst Mode. Remarks The method has a boolean argument called BustMode that determines whether to perform Start Alert Burst Mode command or a Stop Ale rt Burst Mode command. When a DataSeal receives this command it sets (Start) or clears (Stop) the Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 209 - Chapter 8 System Parameters and Comm ands Ale rt Burst Mode flag in the Long Status. Acknowledge Alert Burst, Acknowledge Close Burst, Acknowledge Forced Burst Me thod Se als.AckBurst Description T ells the DataSeals that send the specified type of Burst message that their message has been received, and that they can stop sending more retries of it. Remarks The method has an argument called AckBurstType that determines the specific type of command to perform. When a DataSeal receives this command it stops sending more retries of the same Burst message of the specified type, until a new Event of this kind occurs. 8.5 Burst Messages Burst messages are messages that a DataSeal transmits to the listening DataReaders. Unlike the RF commands, the Burst messages are sent from the DataSeal not as a response to a command, but asynchronous to the DataReader's transmissions, as a result of some kind of event. Be aware that Burst messages may interfere with normal RF commands transmissions because they are not synchronized with them. Proper system design should be made in order to prevent or overcome these cases. There are 4 events that can cause Burst messages: Sealing Wire is opened, Sealing Wire is closed, T he DataSeal is being put in Deep Sleep (either through HF or LF), and an event that is initiated by a special RF command - 210 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands called Start Force d Burst (either LF or HF). Further details about each type of Burst message are given below. Burst messages should be enabled in the DataSeal, by sending the Start Ale rt Burst Mode or Start Ale rt Burst Mode for All Seals command. In addition, in order for a DataReader to receive Burst message, a special flag called Allow Burst in the DataReader has to be on. When a DataReader receives a Burst message, if it's Allow Burst flag (Reade r.AllowBurst property) is on and it is not currently executing another RF command, it stores the message inside its memory. The application software should check for Burst messages periodically in order to receive them, using the Reade r.GetBurstMessages method. In addition, Close Burst messages have to be enabled in the DataSeal by setting the Close Burst Mode flag in the DataSeal's Long Status. Burst messages can be sent more than once (for each causing event) in order to maximize the probability that a DataReader will receive the message. T he exact number of retries is determined by the Maximal Ale rt and Close Burst Re tries and Maximal Dee p Slee p Burst Retrie s DataSeal parameters, and the intervals between them is determined by the Ale rt and Close Burst Pe riod and the Dee p Slee p Burst Pe riod. For Force d Burst messages the number of retries an the interval is determined by the command arguments. When a DataReader receives a Burst message, it can send an acknowledge back to the DataSeal, so the DataSeal can stop sending more retries of the same message. This helps to reduce the DataSeal's battery usage and make the RF environment less "noisy". T here are 2 options to acknowledge Burst messages: automatic and manual. The automatic acknowledge is sent by the receiving DataReader immediately when it receives the message. In order to use the automatic acknowledge, the Automatic Acknowle dge Burst flag (Re ade r.AutoAckBurst property) in the DataReader should be on and also Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 211 - Chapter 8 System Parameters and Comm ands nd the 2 bit in the DataSeal's Flags parameter should be on. If the Automatic Acknowle dge Random Delay flag (Reade r.AckBurstRandomDelay property) in the DataReader is on too, the DataReader will randomly choose 1 of 4 windows in which it will send its acknowledge. The advantages of the automatic Burst acknowledge are: The acknowledge is very short (about 50ms). The application doesn't have to take care of it. The disadvantages of the automatic Burst acknowledge are: The acknowledge does not ensure that the application received the message. If the Automatic Acknowle dge Random Delay flag is off, if more than one DataReader receives the message, and both will try to send an acknowledge, the RF transmissions of these acknowledges will collide. If Automatic Acknowle dge Random Delay flag is on, for 2 DataReaders there's a chance of 25% for collision, for 3 DataReaders 35%, and for 4 DataReaders or more the probability rises to about 50% or more. The manual acknowledge is a normal RF command initiated by the application. Note that DataSealLib sends this command by default when the application gets the Burst messages from a DataReader (using the Reade r.GetBurstMessages method), but you have the opportunity to cancel it, and/or send it when most appropriate to you. See the online documentation for more information. The advantages of the manual Burst acknowledge are: - 212 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands The application may send the acknowledge after it has written the message to a database. This ensures that no data will be lost even in case of application crash or DataReader's reset. The application can send only one acknowledge to every burst message even if many DataReaders received it or more than one retry was received. The application can choose the most appropriate timing for sending the acknowledge. The disadvantages of the manual Burst acknowledge are: Because it is a normal RF command it takes the 3 seconds of the Reader Interrogation Header (Thw). It is not automatic. Nevertheless, DataSealLib sends it automatically by default. Note that more than one DataReader may receive the same Burst message, and that each DataReader may receive more than one retry of the same burst message. It is the application's responsibility to correlate equal Burst messages. There are 2 formats of Burst messages: one is older, an always include d only the Short Status of the DataSeal. T he new format can include any parameter and/or User Data. See the description of the Ale rt Burst Data Descriptor, Close Burst Data Descriptor and the arguments of the Start Force d Burst RF command for information about how to define which parameters and User Data will be included in each type of message. In addition, the new format includes a sequential number for each event that caused a Burst message. T his way you can easily correlate messages that are received by different DataReader, or 2 retries of the same message. T he Force d Burst messages also contain a special Use r Code argument that the user can use to define the purpose of the Burst message. In DataSealLib, you receive the Burst messages through the Reade r.BurstEx event, and Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 213 - Chapter 8 System Parameters and Comm ands you can know which parameters a Burst message includes by examining the Se al.Response Mask property. See the online documentation for further details. Below there's a summary of all the Burst messages: Alert Burst Constant in HGTBurstType Enum HGTAle rtBurst (77h) – old format. HGTAle rtBurstEx (7Ah) – new format. Constant of acknowle dge HGTAckAle rtBurst (BBh) type in HGTAckBurstType Enum Sealing Wire is opened or its resistance changes. Occurs when Remarks Any of the Set commands also stops the Burst message from being retransmitted. Deep Sleep Burst Constant in HGTBurstType Enum HGTDee pSlee pBurst (77h) – old format (this is a synonym of the HGTAlertBurst constant). HGTAle rtBurstEx (7Ah) – new format. Constant of acknowle dge HGTAckDee pSlee pBurst (BBh) (this is a synonym of the HGTAckAlertBurst type in constant). HGTAckBurstType Enum Occurs when - 214 - The DataSeal completes a Dee p Slee p RF command (either in LF or in HF). Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Remarks The RF message and the acknowledge are the same for Ale rt Burst and for Dee p Slee p Burst. However, you can distinguish them using the flags in the Short Status. Close Burst Constant in HGTBurstType Enum HGTCloseBurst (79h) Constant of acknowle dge HGTAckCloseBurst (BDh) type in HGTAckBurstType Enum Occurs when Sealing Wire is closed. Forced Burst Constant in HGTBurstType Enum HGTForce dBurst (78h) Constant of acknowle dge HGTForce dBurst (BCh) type in HGTAckBurstType Enum Occurs when 8.6 The DataSeal completes a Start Force d Burst RF command (either in LF or in HF), and the specified Pe riod has passed. DataReader Parameters Like the DataSeal, the DataReader also has a set of configurable parameters that affect its operation. In DataSealLib most of these parameters are exposed as properties of the Reade r class, and some are even used Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 215 - Chapter 8 System Parameters and Comm ands internally by the library. You can use the ReadParame ter and WriteParame te r methods of the Re ader class to read and write the parameters. As in the DataSeal, some parameters are Read-Only, and others are Read/Write. Below is a summary of the DataReader Parameters: MCU Firmw are Version Prope rty Name (not supported). Access Read-Only. Data Type String. HGTRe ade rFirmware Version (1) Constant in HGTRe ade rParame te rCode Enum Returns the firmware version of the MCU (main) unit of the DataReader. Description Reader ID Prope rty Name Reade rID (Default property). Access Read-Only. Data Type String. The string contains a number between 0 and 2 32 -1. HGTRe ade rID (2) Constant in HGTRe ade rParame te rCode Enum Description Returns the unique identification number of the DataReader. Remarks Hi-G-T ek assigns the Reader ID uniquely to each manufactured DataReader, DataPort, DataTerminal and MicroDataReader. - 216 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Reader Address Prope rty Name Address (Hidden property). Access Read-Only. Data Type Long. Max value: 65535. HGTRe ade rAddress (3) Constant in HGTRe ade rParame te rCode Enum Description Returns the RS-485 address of the DataReader. Remarks Inside the DataReader this parameter is writable, but DataSealLib assigns and manages the Addre ss parameter of all the connected DataReaders internally. Each DataReader that is connected to the same RS-485 chain must have a unique Address. Warning: Even though changing this parameter using WriteParame te r is possible, the behavior of DataSealLib will be unpredictable. OrgID Prope rty Name (not supported). Access Read & Write. Data Type Intege r HGTRe ade rOrgID (4) Constant in HGTRe ade rParame te rCode Enum Description The organization identifier of the DataReader. Remarks This parameter does not include the Department ID. See chapter 6 for more Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 217 - Chapter 8 System Parameters and Comm ands information about the OrgID parameter. Analog Values Prope rty Name (not supported). Access Read-Only. Data Type Array of Double HGTRe ade rAnalogValues (5) Constant in HGTRe ade rParame te rCode Enum Returns the internal voltage values of the MCU unit, and each of the RF modem units. (currently only RF Modem #2 is available). Description Remarks The first element in the returned array is the MCU voltage, the 2nd is the RF Modem #1 (Extension Slot #1) voltage (this value is always 0). And the 3 rd is the RF Modem #2 (Extension Slot #2) voltage. Built-in Test Period Prope rty Name (not supported). Access Read-Only. Data Type Byte HGTRe ade rBITPe riod (6) Constant in HGTRe ade rParame te rCode Enum Value - 218 - 60 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Description Returns the interval in minutes between automatic executions of the Built-in T est. Minim al Threshold for MCU Voltage Checking Prope rty Name (not supported). Access Read-Only. Data Type Double HGTRe ade rVccMin (7) Constant in HGTRe ade rParame te rCode Enum Value 2.368 Maxim al Threshold for MCU Voltage Checking Prope rty Name (not supported). Access Read-Only. Data Type Double HGTRe ade rVccMax (8) Constant in HGTRe ade rParame te rCode Enum Value 2.624 Minim al Threshold for RF Modem Voltage Checking Prope rty Name (not supported). Access Read-Only. Data Type Double Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 219 - Chapter 8 System Parameters and Comm ands HGTRe ade rVRFMin (9) Constant in HGTRe ade rParame te rCode Enum 2.368 Value Maxim al Threshold for RF Modem Voltage Checking Prope rty Name (not supported). Access Read-Only. Data Type Double HGTRe ade rVRFMax (0Ah) Constant in HGTRe ade rParame te rCode Enum 2.624 Value Loader Firmware Version Prope rty Name (not supported). Access Read-Only. Data Type String HGTRe ade rLoade rVe rsion (0Bh) Constant in HGTRe ade rParame te rCode Enum Returns the version number of the Loader software module of the DataReader. Description Internal Version of MCU Firmware Prope rty Name - 220 - (not supported). Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Access Read-Only. Data Type Byte (not supported) (0Ch). Constant in HGTRe ade rParame te rCode Enum Description Returns the Build number of the MCU firmware. Internal Version of Loader Firmw are Prope rty Name (not supported). Access Read-Only. Data Type Byte (not supported) (0Dh). Constant in HGTRe ade rParame te rCode Enum Description Returns the Build number of the Loader firmware. Inputs Prope rty Name Inputs Access Read-Only. Data Type HGTRe ade rInputsEnum enumeration. (not supported) (0Eh). Constant in HGTRe ade rParame te rCode Enum Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 221 - Chapter 8 System Parameters and Comm ands Description Returns the state of the 2 input ports (Isolated Input and External Interrupt Input) and the 6 configuration flags. Remarks You can also use the Reade r.Isolate dInput and Reade r.Exte rnalInte rruptInput properties to read the values of the input ports. Outputs Prope rty Name Outputs Access Read & Write. Data Type HGTRe ade rOutputsEnum enumeration. (not supported) (0Eh). Constant in HGTRe ade rParame te rCode Enum Description Returns the last state or set the state of the 4 output ports (External LED output, Isolated Output #1, Isolated Output #2 and the Dry Contact Output). Remarks You can also use the Reade r.Exte rnalLEDOutput, Reade r.Isolate dOutput1, Reade r.Isolate dOutput2 and Reade r.DryContact properties to write to the output ports. - 222 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Reader Reset Timeout Prope rty Name (not supported). Access Read & Write. Data Type Intege r (not supported) (10h). Constant in HGTRe ade rParame te rCode Enum Description Determines the maximal interval in seconds that the DataReader will wait for a command from the controlling computer before it will reset itself. Remarks If this parameter is not 0, then the DataReader will reset itself if it does not receive a command from the controlling computer in the duration specified by this parameter's value. T his is like a "watchdog" for the RS-232/485 communication. You should set this value to the biggest gap you expect between 2 commands that are addressed to that DataReader. If you set this parameter to 0, and there is a problem with the RS-232/485 communications you will have to reset the DataReader manually. Chain NOP Interval Prope rty Name ChainNopInte rval Access Read & Write. Data Type Long. Max value: 65535. (not supported) (11h). Constant in HGTRe ade rParame te rCode Enum Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 223 - Chapter 8 System Parameters and Comm ands See the online documentation for further information about this parameter. Description Remarks This parameter is used with Command Chains. Command Chains are described in the next sections of this chapter. Chain NOP Count Prope rty Name ChainNopCount Access Read & Write. Data Type Long. Max value: 65535. (not supported) (12h). Constant in HGTRe ade rParame te rCode Enum See the online documentation for further information about this parameter. Description Remarks This parameter is used with Command Chains. Command Chains are described in the next sections of this chapter. RF Modem Firmw are Version Prope rty Name (not supported). Access Read-Only. Data Type String Constant in HGTHFMode mFirmware Ve rsion HGTRe ade rParame te rCode Enum (40h). - 224 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands Description Returns the version of the firmware of the HF RF Modem of the DataReader. ADI Prope rty Name ADI Access Read & Write. Data Type Long HGTHFMode mADI (41h) Constant in HGTRe ade rParame te rCode Enum Description The default ADI value that will sent with each RF command that the DataReader transmits. Remarks When executing an RF command, if you specify and ADI that is not 0, the ADI you specified is used. If you specify 0 (or does not provide the optional argument), the value of this parameter is used. See chapter 6 for further information about the ADI concept. Department Prope rty Name (not supported). Access Read & Write. Data Type Byte HGTHFMode mDe partment (42h) Constant in HGTRe ade rParame te rCode Enum Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 225 - Chapter 8 System Parameters and Comm ands The Department ID of the DataReader. Description Remarks See chapter 6 for further information about the department and organization IDs concept. SYS Prope rty Name (not supported). Access Read & Write. Data Type Byte HGTHFMode mSYS (43h) Constant in HGTRe ade rParame te rCode Enum This value is part of the End of Header of all RF commands. Description Remarks This value is a bit oriented value that is sent in all the HF RF commands. The format of this value is as follows: FP f AD If OID f sp are where: FPf Footprint Flag: if FPf=1, after successful completion of one of the Ve rify or Tampe re d commands, a Footprint (Read) Event will be written in the DataSeal. ADIf ADI Flag: In an execution of a Command Chain, if ADIf=1 and the ADI in the DataSeal does not match the ADI in the command (and it isn't 0), the DataSeal stops listening to the Command Chain. O IDf OrgID Flag: In an execution of a Command Chain, if OIDf=1 and the value of the OrgID and Department in the DataSeal does not - 226 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands match the OrgID and Department in the command (and they'r e not 0), the DataSeal stops listening to the Command Chain. Mode Prope rty Name Mode Access Read & Write. Data Type Byte HGTHFMode mMode (44h) Constant in HGTRe ade rParame te rCode Enum Description A bit oriented value that controls that controls the operation of the DataReader. Remarks DataSealLib also provides several Boolean or enumerated properties that reflect specific flags of this parameter: Carrie rSense – Determines whether the DataReader will make sure that the RF is clear before starting transmitting a command. Use this flag when there are DataReaders that are not connected to the same controlling computer to avoid RF collisions. In synchronized systems this flag should be off to ensure that the timings are deterministic. AllowBurst – Determines whether the DataReader will listen for Burst messages while it is not executing another RF command. If this flag is on, you have to check for the Burst messages that the DataReader received using the Reade r.Ge tBurstMe ssages method. Powe rCalibrationMode – Because temperature changes affect transmission power, it is required to perform a temperature test and power calibration process every once in a while. This property determines the terms in which the DataReader will perform those operations. See the online documentation for further information about the different options. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 227 - Chapter 8 System Parameters and Comm ands AutoAckBurst – Determines whether to send an acknowledge messa ge automatically to every Burst message the DataReader receives. See section 8.5 above for further information about this flag. AckBurstRandomDelay – Determines whether the DataReader will choose 1 of 4 windows for the automatic acknowledgment message. See section 8.5 above for further information about this flag. Thw Prope rty Name Thw Access Read & Write. Data Type Long. Max value: 65535. Units 3.072msec. Default Value 997 (3 seconds). HGTHFMode mThw (45h) Constant in HGTRe ade rParame te rCode Enum The duration of the Reader Interrogation Header. Description Remarks See section 8.1.1 for further information about this parameter. Thp Prope rty Name Thp Access Read & Write. Data Type Long. Max value: 65535. Units 3.072msec. - 228 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 Default Value System Parameters and Comm ands 3256 (10 seconds). HGTHFMode mThp (46h) Constant in HGTRe ade rParame te rCode Enum Description The duration of the Reader Interrogation Header for a Hard Wakeup command. Remarks This parameter is the same as the Thw parameter, but for Hard Wakeup command. RSSI Prope rty Name (not supported). Access Read-Only. Data Type Byte HGTHFMode mRSSI (47h) Constant in HGTRe ade rParame te rCode Enum Description The reception level of the last message that was received from a DataSeal. Remarks This value may give an approximate estimation about the distance of the DataSeal from the DataReader. RF Transm ission Power Prope rty Name (not supported). Access Read & Write. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 229 - Chapter 8 System Parameters and Comm ands Data Type Byte Default Value 65 Constant in HGTHFModemTransmittionPower HGTReaderParameterCodeEnum (48h) Description The nominal value of the RF transmission power. Remarks Using this parameter you can control the DataReader's Receiving Zone. Internal Version of RF Modem Firmware Prope rty Name (not supported). Access Read-Only. Data Type Byte Constant in HGTHFMode mFirmware Ve rsion HGTRe ade rParame te rCode Enum (48h) The Build number of the firmware version of the RF Modem. Description 8.7 Comm and Chain As mentioned before, setting Thw and Tw to smaller numbers reduces the response times, but shortens the batteries' lifetime. Even though the default 3 seconds is mostly a reasonable response time, when you have to send many RF commands, it can accumulate to a lengthily time. The Command Chain feature allows to execute many RF commands in a row with a single Reader Interrogation Header (one Thw). The battery consumption of all the DataSeals that are in Normal Mode (not in Deep Sleep or HF Disabled), even those that are not addressed by any command in the Chain is exactly - 230 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 8 System Parameters and Comm ands the same as it would if these commands were executes normally one after the other, but now that consumption is at a shorter period. However, in times that there are no transmissions, the battery consumption is normal (unlike the result of using a small Thw and Tw). Commands can also be adde d to the Command Chain on the go, when you want to perform a command as a result of the response or responses that you received in a previous command. For example, suppose that you want to perform a Se t command to all the DataSeals that their User Paramete r 1 contains the string "READY". You can do it by initiating a Command Chain with only a broadcast Ve rify command that asks for the Use r Paramete r 1 parameter, and after receiving the results and examining the content of the Use r Parame te r 1 parameter, you add the Set command with the list of Seal ID's of those DataSeals that their Use r Paramete r 1 parameter contain the string "READY". Note that all the DataSeals that receive the Reader Interrogation Header of a Command Chain keep listening to all the commands, which consumes battery as if these commands were executed one after the other. For DataSeals that there are no command for them it means a waste of battery. There are few things that you can do to avoid it: 1. Make sure that the DataSeals that should not receive the commands in the Chain are either in Deep Sleep, but usually more appropriate, their HF Disable d flag is on (for example by using the Slee p Duration argument of the Ve rify command). 2. If there are DataSeals with different OrgIDs or Departments, and you want to turn only to one of them, you should turn on the O IDf flag in the DataReader's SYS parameter. 3. If there are DataSeals with different ADIs, and want to turn only to a specific group, you should turn on the ADIf flag in the DataReader's SYS parameter. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 231 - Chapter 8 System Parameters and Comm ands For more information about Command Chains see the description of the CommandChain class in the online documentation. - 232 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 9 9.1 Troubleshooting and Problem Solving Trouble Shooting and Problem Solving General DataReader Problems 1. Power LED is red: The DataReader is malfunctioning. Replace the DataReader. 2. Power LED is off: Check the power connection. 9.2 RS-232/485 Comm unication Problems 3. DataReader does not respond to the controlling computer: Verify that the Power LED blinks during power on. The LED should then remain steadily green. Verify that the cables are connected according to the diagrams in chapter 5. Verify that the Reader ID you specified is the same number as the S/N printed on the sticker on the back side of the DataReader (below the barcode). Verify that a terminator exists at end of the RS-485 chain, as described in chapter 5. Make sure that the specified COM port is the COM port that in fact the DataReader is connected to. 9.3 General RF Comm unication Problems 4. DataReader does not receive a specific DataSeal: Verify that the DataSeal is within the DataReader's Receiving Zone. Check that the RF Transmission Powe r parameter is not too - 234 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 9 Troubleshooting and Problem Solving low. Putting the DataSeal too close to the DataReader's antenna (few centimeters) may causes signal distortions. Verify that the antenna is connected properly. Verify that the SD/RD LED of Channel 2 is red for a about 3 seconds (with default Thw) upon receiving the command from the controlling computer, and then turns green for a short time. The DataSeal may be in Deep Sleep mode. Try to execute a Hard Wakeup command. Make sure that the ADI and De partment parameters in the DataReader are either 0 or the same values that should be in the DataSeal. If you can communicate with the DataSeal using a Low Frequency device (DataT erminal or DataPort), make sure that the ADI, OrgID and De partment parameters match those of the DataReader. Also make sure that Tw is appropriate for the Thw in the DataReader. See chapter 8 for information about Thw and Tw. Make sure that the HF Disable d flag is off too. The Ve rify parameters are invalid. See chapter 8 for information about the parameters of the Verify command. 9.4 Specific RF comm ands troubleshooting: 5. DataSeal does not respond to a Tampe re d command: The DataSeal is not tampered. Check the DataSeal's Tampe re d flag. 6. DataSeal does not respond to a Hard Wakeup command: The DataSeal may already be waked up (in Normal mode). Check the DataSeal's Dee p Slee p flag. 7. Se t/Reset Status command fails: Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 235 - Chapter 9 Troubleshooting and Problem Solving On or more of the specified flags may be read-only. 8. Write Parame ters command fails: One or more of the specified parameters may be read-only. The data type or the parameter size of one or more parameters are invalid. - 236 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 10 10 Technical Specifications Technical Specifications 10.1 RS485 24V Outdoor DataReader 24V Outdoor DataRe ade r IG-RS-46D-916 IG-RS-46D-433 IG-RS-46D-318 IG-RS-46D-315 Physical Characteristics Dimensions Weight Power requirements – External Power Consumption 195x165x95mm, not including antenna 1000gr Nominal - 24VDC Minimum – 10VDC Maximum – 35VDC 1.7W @Tx, 1.1W@Rx Performance Characteristics RS485 optically isolated Interface 433.92 318 Operating frequency [MHz] 916.5 30m @ open space Read Range 315 Environmental Conditions Operating Temperature Storage Temperature Humidity Mechanical Vibration Mechanical Shock -40ºC — 70ºC -40ºC — 70ºC 90% Non condensing As per MIL-810D & SAE J1455 As per MIL-810D & SAE J1455 Standards Designed according to - 238 - FCC partEN300220 15C EN301489 UL1950 EN60950 UL1950 UL1950 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 10 Technical Specifications 10.2 RS232, 24V Outdoor DataReader 24V Outdoor DataRe ade r IG-RS-43D-916 IG-RS-43D-433 IG-RS-43D-318 IG-RS-43D-315 Physical Characteristics Dimensions Weight Power requirements – External Power Consumption 195x165x95mm, not including antenna 1000gr Nominal - 24VDC Minimum – 10VDC Maximum – 35VDC 1.7W @Tx, 1.1W@Rx Performance Characteristics RS232 Interface 916.5 433.92 318 Operating frequency [MHz] 30m open space Read Range 315 Environmental Conditions Operating Temperature Storage Temperature Humidity Mechanical Vibration Mechanical Shock -40ºC — 70ºC -40ºC — 70ºC 90% Non condensing As per MIL-810D & SAE J1455 As per MIL-810D & SAE J1455 Standards Designed according to FCC part 15C UL1950 EN300220 EN301489 EN60950 UL1950 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology UL1950 - 239 - Chapter 10 Technical Specifications 10.3 Specific- 24V Outdoor DataReader 24V Outdoor DataRe ade r IG-RS-46D9-916 IG-RS-43D9-916 Physical Characteristics Dimensions Weight Power requirements – External Power Consumption 195x165x95mm, not including antenna 1000gr Nominal - 24VDC Minimum – 10VDC Maximum – 35VDC 1.7W @Tx, 1.1W@Rx Performance Characteristics RS485optically isolated RS232 Interface 916.5 Operating frequency [MHz] Antenna dependant Read Range Environmental Conditions Operating Temperature Storage Temperature Humidity Mechanical Vibration Mechanical Shock -40ºC — 70ºC -40ºC — 70ºC 90% Non condensing As per MIL-810D & SAE J1455 As per MIL-810D & SAE J1455 Standards Designed according to - 240 - FCC part 90, FCC part 15B UL1950 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 10 Technical Specifications 10.4 12V Outdoor DataReader 12V Outdoor DataRe ade r IG-RS-26D-916 IG-RS-26D-433 IG-RS-26D-318 IG-RS-26D-315 Physical Characteristics Power requirements – External Power Consumption Nominal - 12VDC Minimum – 10VDC Maximum – 35VDC 1.7W @Tx, 1.1W@Rx * All other specifications are as in section 10.1. 10.5 48V Outdoor DataReader 48V Outdoor DataRe ade r IG-RS-86D-916 IG-RS-86D-433 IG-RS-86D-318 IG-RS-86D-315 Physical Characteristics Power requirements – External Nominal - 48VDC Minimum – 20VDC Maximum – 70VDC Power Consumption 1.7W @Tx, 1.1W@Rx All other specifications are as in section 10.1. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 241 - Chapter 10 Technical Specifications 10.6 24V Indoor DataReader 24V Indoor DataRe ade r IG-RS-46-916 IG-RS-46-433 IG-RS-46-318 IG-RS-46-315 Physical Characteristics Dimensions Weight Power requirements – External Power Consumption 195x165x95mm, not including antenna 1000gr Nominal - 24VDC Minimum – 10VDC Maximum – 35VDC 1.7W @Tx, 1.1W@Rx Performance Characteristics RS485 optically isolated Interface 433.92 318 Operating frequency [MHz] 916.5 30m @ open space Read Range 315 Environmental Conditions Operating Temperature Storage Temperature 0ºC — 70ºC -20ºC — 70ºC Standards Designed according to - 242 - FCC part 15.249 UL1950 EN300220 EN301489 EN60950 UL1950 UL1950 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 10 Technical Specifications 10.7 12V Indoor DataReader 12V Indoor DataRe ade r IG-RS-26-916 IG-RS-26-433 IG-RS-26-318 IG-RS-26-315 IG-RS-86-318 IG-RS-86-315 Physical Characteristics Power requirements – External Power Consumption Nominal - 12VDC Minimum – 10VDC Maximum – 35VDC 1.7W @Tx, 1.1W@Rx * All other specifications are as in section 10.6. 10.8 48V Indoor DataReader 48V Indoor DataRe ade r IG-RS-86-916 IG-RS-86-433 Physical Characteristics Power requirements – External Power Consumption Nominal - 48VDC Minimum – 20VDC Maximum – 70VDC 1.7W @Tx, 1.1W@Rx * All other specifications are as in section 10.6. Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 243 - Chapter 10 Technical Specifications 10.9 DataSeal DataSeal IG-RS-40-916 IG-RS-40-433 IG-RS-40-318 IG-RS-40-315 Physical Characteristics Dimensions Weight Housing Power User Memory Ev ents Memory 49x37x35mm 100gr Plastic reinforced with fiberglass Internal 3.6V battery 2048 bytes 55 Performance Characteristics Mounting cradle p/n IG-DH-40 Interface 433.92 318 Operating frequency [MHz] 916.5 30m @ open space Read Range 125KHz Operating frequency 50cm Read Range 315 Environmental Conditions Operating Temperature Storage Temperature Humidity Mechanical Vibration Mechanical Shock -40ºC — 70ºC -40ºC — 70ºC 90% non condensing As per MIL-810D & SAE J1455 As per MIL-810D & SAE J1455 Standards Designed according to FCC part 15.249 EN300220 EN301489 Antenna Characteristics Beam Divergence Polarization - 244 - Omni-directional on non-metal wall. Hemisphere on metal wall. Vertical Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 10 Technical Specifications 10.10 Magnetic DataSeal Magnetic DataSe al IG-RS-40M-916 IG-RS-40M-433 IG-RS-40M-318 IG-RS-40M-315 Physical Characteristics Dimensions Weight Housing Power User Memory Ev ents Memory 49x37x35mm 100gr Plastic reinforced with fiberglass Internal 3.6V battery 2048 bytes 55 Performance Characteristics 433.92 Operating frequency [MHz] 916.5 30m open space Read Range 125KHz Operating frequency 50cm Read Range 318 315 Environmental Conditions Operating Temperature Storage Temperature Humidity Mechanical Vibration Mechanical Shock -40ºC — 70ºC -40ºC — 70ºC 90% non condensing As per MIL-810D & SAE J1455 As per MIL-810D & SAE J1455 Standards Designed according to FCC part 15.249 EN300220 EN301489 Antenna Characteristics Beam divergence Polarization Omni-directional on non-metal wall. Hemisphere on metal wall. Vertical Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 245 - Chapter 10 Technical Specifications 10.11 FCC approved products: Product P/N FCC ID DataReader IG-RS-46D-916 OB6-IGR46D916 DataSeal IG-RS-40-916 OB6-IGRS40916 DataTag IG-DT -40-916 OB6-IGDT40916 DataReader IG-RS-46D9-916 OB6-IGRS46D9916 DataReader IG-RS-43D9-916 OB6-IGRS46D9916 Note : T his equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures: Reorient or relocate the receiving antenna. Increase the separation between the equipment and receiver. Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. Consult the dealer or an experienced radio/T V technician for help. Changes or modifications to this equipment not expressly approved by Hi-G-T ek Ltd. could void the user’s authority to operate the equipment. - 246 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Chapter 10 Technical Specifications Warning:For unlicensed transmitters approved according to FCC part 15 subpart C, it is the responsibility of the installer to ensure that when using the outdoor antenna kits in the United States (or where FCC rules apply), only those antennas certified with the product are used. T he use of any antenna other than those certified with the product is expressly forbidden in accordance with FCC rules CFR47 part 15.204.” Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 247 - Chapter 10 11 Technical Specifications INDEX 12v Indoor DataR eader 12v Outdoor DataR eader 242 241 24v Indoor DataR eader 24v Outdoor DataR eader 241 240 48v Indoor DataR eader 48v Outdoor DataR eader 243 241 Accelerate Verify (RF Comm and) Accelerated Verify Mode (Status flag) Acknowledge Alert Burst (RF Comm and) Acknowledge Close Burst (RF C omm and) Acknowledge Forced Burst (RF Command) Address (DataR eader P aram eter) Addressed C omm ands Addressed Verify (RF C omm and) 32, 86, 95, 96, 98, 99, 100, ADI 79, 80, 96, 189, DataR eader P aram eter DataS eal P aram eter Alert and Close Burst P eriod (DataS eal P aram eter) Alert Burst B urst M essage 155, M ode 69, 70, 85, 120, 122, Alert Burst Data Descriptor (DataS eal P aram eter) Alert Burst M ode (Status flag) 178, Alert Burst Period (DataS eal P aram eter) Analog Values (DataReader Parameter) - 250 - 181 181, 197 85, 123, 212 212 212 219 136, 197 107, 139, 197 227, 228, 233 226, 237 139 140, 213 179, 210, 216 194, 205, 211 140, 215 194, 210, 211 155 220 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Application Flags (DataS eal P aram eter) Approve Open (RF Comm and) Approved Open Event S tatus flag Index 141, 210 72, 86, 173, 188, 198 188, 199 72, 73, 86, 172, 173, 198, 208 B attery Voltage Value (DataS eal P aram eter) B aud R ate BIT Period (DataSeal Parameter) BMM BMM List B roadcast C omm ands B roadcast Verify (RF C omm and) Buffer Full (Status flag) B uilt-In Test Built-in Test Period (DataReader Parameter) B urst M essages B urst Mode Burst Mode (Status flag) B urst R eceiving M ode (DataR eader) 142, 154 92 143 See B roadcast Comm ands See Multi Addressed C omm ands 136 See Verify (RF Comm and) 179 126 220 14, 148, 212 See Alert B urst M ode See Alert B urst M ode (S tatus flag) 70 C ables 60 C alibration M essage Window 192 C arrier S ense 70, 75 C ellular Layout 75 C hain of Comm ands See Comm and C hain RS -485 53, 76 Chain NOP Count (DataReader Parameter) 226 Chain NOP Interv al (DataReader Parameter) 225 C lose Burst (Burst M essage) 155, 178, 213, 217 Close Burst Data Descriptor (DataSeal Parameter) 143, 215 Close Burst Mode (Status f lag) 178, 213 C losed (Event) 82 C ommand Chain 189, 190, 207, 225, 226, 228, 232, 233 Command Failed (Status f lag) 177 C ommandChain (DataS ealLib C lass) 233 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 251 - Chapter 10 Technical Specifications Database C orrupted S tatus flag 172 Database Corrupted (Status flag) 175 Database Corrupted and Restored Event 185 S tatus flag 174 Database Error S tatus flag 172, 174, 208 DataPort 12, 13, 14, 67, 182, 218, 237 DataR eader 14 Installation 44 DataS eal 12, 243 Installation 36 DataS eal Evaluation Software See Evaluation Software DataS ealLib (C OM DLL) 84, 102, 134, 182, 188, 189, 195, 207, 214, 215, 217, 219, 229 DataTag 12, 13, 22, 26, 28, 40, 41, 66 Installation 40 P lacing on a Vehicle 40 DataTerm inal 12, 13, 14, 66, 67, 68, 69, 70, 83, 182, 218, 237 Date & Time (DataSeal Parameter) 144, 149, 151, 156, 158, 186 Date & Tim e (P aram eter) 186 Date & Time Updated (Ev ent) 186 Deep S leep B urst 145 B urst M essage 155 Event 210 M ode 26, 69, 73, 119, 166, 172, 188, 208, 209, 210, 211, 232, 233 RF C omm and 85, 118, 142, 188, 210, 216 S tatus flag 73, 171, 210, 211, 237 Deep S leep B urst (B urst M essage) 216 Deep Sleep Burst Period (DataSeal Parameter) 145, 156, 213 Deep S leep M ode (Event) 188 Dem o S ystem 22 Departm ent 78, 80, 96, 160, 176, 233 DataR eader P aram eter 227, 237 DataS eal P aram eter 79, 80, 145 Distance Index (DataSeal Parameter) 146 - 252 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Index Evaluation S oftware 23, 90 Installation 90 Ev ent Counter Value (DataSeal Parameter) 146 Events 31, 69 Events (DataS ealLib Class) 200 Events M emory69, 71, 81, 82, 85, 86, 124, 158, 159, 160, 180, 181, 183, 185, 199, 208, 243, 244 Extended Alert Burst (Burst M essage) 179 Firmware Version (DataSeal Parameter) Flags (DataSeal Parameter) F ootprint Footprint (Ev ent) F ootprint Events Mode F orced B urst F orced B urst (Burst M essage) F orced B urst (Burst M essage) 147, 149 148, 213 69, 165, 166, 186, 228 See R ead (Event) 69 86, 204 204, 205, 213, 215, 217 204 General Error (Status flag) Global (DataS eal P aram eter) GPS GSM 73, 172 79, 80, 149 14 14 Hard W akeup (RF Comm and) 26, 27, 28, 32, 69, 85, 119, 166, 188, 210, 211, 230, 231, 237 Hardware Error (Status flag) 172, 176 HF See High F requency HF Disabled (Status f lag) See High F requency Disabled HGTSealP aram eterC odeEnum (DataS ealLib Enum eration) 139, 201, 203 HGTVerifyM askEnum (DataS ealLib Enum eration) 139, 141, 144, 191, 197, 204, 206 High F requency 13, 14, 134, 168 High Frequency Disabled (Status flag) 180, 199, 233, 237 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 253 - Chapter 10 Technical Specifications Illegal OrgID (Status flag) Indoor DataR eader Inputs (DataReader Parameter) Internal Firmware Version (DataSeal Parameter) Internal Version of Loader Firmware (DataReader Parameter) Internal Version of MCU Firmware (DataReader Parameter) Internal Version of RF Modem Firmware (DataReader Parameter) 78, 172, 176 19, 49, 59 223 150 223 222 232 Last Date & Time Update (DataSeal Parameter) 151 Last Set Reader ID (DataSeal Parameter) 151, 208, 209 LFSee Low F requency Lif e Counter (DataSeal Parameter) 152, 173, 208, 209 Life C ounter 0 (S tatus flag) 172, 173 Loader Firmware Version (DataReader Parameter) 222 Long Event 182 Long Events 126 Long S tatus (DataS eal P aram eter) 72, 73, 78, 82, 86, 96, 98, 100, 109, 152, 164, 169, 172, 197, 205, 206, 211, 213 Low Battery Error (Status flag) 143, 153, 154, 172, 174, 184, 208, 209 Low B attery Error Threshold (DataS eal P aram eter) 143, 153, 154, 174 Low Battery Warning Event 183 S tatus flag 169, 208, 209 Low B attery W arning (S tatus flag) 72, 154 Low B attery W arning Threshold (DataS eal P aram eter) 143, 154, 170, 184 Low F requency 13 M agneticDataS eal 12, 13, 66, 244 Maximal Alert and Close Burst Retries (DataSeal Parameter) 155, 213 Maximal Deep Sleep Burst Retries (DataSeal Parameter) 155 M axim al Deep Sleep B urst R etries (DataS eal P aram eters) 213 Maximal Difference in Time Update (DataSeal Parameter) 156, 158 Maximal Message Size (DataSeal Parameter) 157, 179 M axim al Number of Events (DataS eal P aram eter) 159, 160, 164 Maximal Number Of Events (DataSeal Parameter) 157 Maximal Threshold for MCU Voltage Checking (DataReader Parameter) 221 - 254 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Index Maximal Threshold for RF Modem Voltage Checking (DataReader Parameter) 222 M axTim eDiffUpdate (DataS ealLib P roperty) 156 MC U 62, 93, 127, 130, 218, 220, 223 MCU Firmware Version (DataReader Parameter) 218 M icroDataR eader 12, 13, 14, 66, 68, 218 M inimal Interval between Tim e Updates (DataS eal P aram eter) 156, 158 Minimal Threshold f or MCU Voltage Checking (DataReader Parameter) 221 Minimal Threshold f or RF Modem Voltage Checking (DataReader Parameter) 221 M ode DataR eader P aram eter 148 Mode (DataReader Parameter) 228 M ounting Fixture 15, 16, 36 M oxa T echnologies 56 M ulti Addressed C omm ands 136 M ulti Addressed Verify (RF C omm and) 86, 136, 139, 206 New Battery S tatus flag NOP (RF Command) Norm al Mode Num ber of Events (DataS eal P aram eter) Num ber of Events (DataS eal P aramter) Number of Scroll Events (DataSeal Parameter) 175 189 See Operation Mode 149, 158, 160 158 159 Opened Event 82 S tatus flag 31, 72, 109, 170, 173, 208, 209 Operation M ode 68 OrgID 78, 79, 80, 96, 149, 160, 176, 181, 228, 233 DataR eader P aram eter 219, 237 OrgID & Department (DataSeal Parameter) 160 Outdoor DataR eader 17, 44, 46, 59 Outputs (DataReader Parameter) 224 P aram eters DataS eal 31, 138 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 255 - Chapter 10 Technical Specifications P ower LED P ower S upply 62, 236 58 R andom Windows R ead (Event) R ead Data (RF C omm and) R ead Events (RF Comm and) R ead Multi Access Data (RF C omm and) R ead P aram eters (RF C omm and) R eader (DataS ealLib Class) Reader Address (DataReader Parameter) Reader ID (DataReader Parameter) R eader Interlace Window R eader Interrogation Header Reader Reset Timeout (DataReader Parameter) R eader.AccelerateVerify (DataS ealLib M ethod) R eader.AckBurstR andomDelay (DataS ealLib P roperty) R eader.Address (DataS ealLib P roperty) R eader.ADI (DataS ealLib P roperty) R eader.AllowB urst (DataS ealLib P roperty) R eader.AutoAckBurst (DataS ealLib M ethod) R eader.AutoAckBurst (DataS ealLib P roperty) R eader.BurstEx (DataS ealLib Event) R eader.C arrierS ense (DataS ealLib P roperty) R eader.ChainNopCount (DataS ealLib P roperty) R eader.ChainNopInterval (DataS ealLib P roperty) R eader.DryContact (DataS ealLib P roperty) R eader.ExternalInterruptInput (DataS ealLib P roperty) R eader.ExternalLEDOutput (DataS ealLib P roperty) R eader.GetBurstM essages (DataS ealLib M ethod) R eader.Inputs (DataS ealLib P roperty) R eader.IsolatedInput (DataS ealLib P roperty) R eader.IsolatedOutput1 (DataS ealLib P roperty) R eader.IsolatedOutput2 (DataS ealLib P roperty) R eader.Mode (DataS ealLib P roperty) R eader.NOP (DataS ealLib M ethod) R eader.Outputs (DataS ealLib P roperty) R eader.PowerC alibrationM ode (DataS ealLib P roperty) R eader.R eaderID (DataS ealLib P roperty) R eader.R eadP aram eter (DataS ealLib M ethod) - 256 - 192 166, 186, 228 82, 85, 110, 179, 200 86, 124, 179, 199 82, 202 86, 114, 138, 150, 179, 201 188, 217 218 218 192 134, 135, 136, 215, 230, 232, 233 224 195 213, 229 218 226 213, 229 213 229 215 229 226 225 224 223 224 213, 214, 229 223 223 224 224 228 189 224 229 218 217 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Index R eader.S etAsyncAlertBurstM ode (DataS ealLib M ethod) 194 R eader.Thp (DataS ealLib P roperty) 230 R eader.Thw (DataS ealLib P roperty) 230 R eader.Verify (DataS ealLib M ethod) 139, 190 R eader.WriteP aram eter (DataS ealLib M ethod) 217 R eal Tim e Clock Error (Status flag) 172, 174 Real Time Clock Stopped (Event) 185 R eceiving Zone 71, 76, 79, 86, 137, 190, 197, 206, 232, 236 R eset Data (RF Comm and) 86, 117, 210 RF M odem 62, 93, 127, 130, 131, 220, 226, 232 RF Modem Firmware Version (DataReader Parameter) 226 RF Transmission Power (DataReader Parameter) 231, 236 RFC omm andObject (DataS ealLib Class) 189 RFP aram eters (DataS ealLib C lass) 138, 146, 191, 192, 197, 206 RFP aram eters.DefaultsFor (DataS ealLib M ethod) 138 RFP aram eters.T cm (DataS ealLib P roperty) 146 RS -232 14, 18, 46, 47, 49, 50, 51, 53, 56, 58, 67, 74, 77, 91, 134, 225, 236 Wiring Diagram 47, 51 RS -232/RS -485 Adapter 56 RS -485 15, 46, 48, 49, 50, 52, 53, 54, 56, 58, 60, 74, 76, 91, 219, 236 F ull Duplex 46, 48, 50, 52 Half Duplex 46, 48, 50, 53 RSSI DataS eal P aram eter 160 RSSI (DataReader Parameter) 231 RTC Error (Status flag) 174 RTC Stopped (Ev ent) See R eal Tim e Clock S topped (Event) S croll (Status flag) S crollable Portion S D/R D LED S eal (DataS ealLib Class) Seal ID (DataSeal Parameter) S eal Stam p (DataS eal P aram eter) S eal.ADI (DataS ealLib P roperty) S eal.AlertB urstDataDescriptor (DataS ealLib P roperty) S eal.AlertB urstMode (DataS ealLib P roperty) S eal.AlertB urstP eriod (DataS ealLib M ethod) S eal.ApplicationF lags (DataS ealLib P roperty) S eal.ApprovedOpen (DataS ealLib P roperty) 82, 158, 159, 62, 63, 153, 188, 191, 198, 179 180 237 207 161 100, 109, 149, 162, 163, 182 139 140 178 140 141 172 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 257 - Chapter 10 Technical Specifications S eal.ApproveOpen (DataS ealLib M ethod) S eal.B atteryVoltageValue (DataS ealLib P roperty) S eal.B ITPeriod (DataS ealLib P roperty) S eal.BufferF ull (DataS ealLib P roperty) S eal.CloseB urstDataDescriptor (DataS ealLib P roperty) S eal.CloseB urstMode (DataS ealLib P roperty) S eal.CloseB urstP eriod (DataS ealLib M ethod) S eal.Comm andF ailed (DataS ealLib P roperty) S eal.DateTim e (DataS ealLib P roperty) S eal.DBC orrupted (DataS ealLib P roperty) S eal.DBC orruptedAndR estored (DataS ealLib P roperty) S eal.DeepSleep (DataS ealLib P roperty) S eal.DeepSleepBurstP eriod (DataS ealLib P roperty) S eal.Departm ent (DataS ealLib P roperty) S eal.DistanceIndex (DataS ealLib P roperty) S eal.EventCounterValue (DataS ealLib P roperty) S eal.EventsC ount (DataS ealLib P roperty) S eal.Firm wareVersion (DataS ealLib P roperty) S eal.Flags (DataS eal P aram eter) S eal.Form atB (DataS ealLib P roperty) S eal.GeneralError (DataS ealLib P roperty) S eal.HardwareError (DataS ealLib P roperty) S eal.HF Disabled (DataS ealLib P roperty) S eal.IllegalOrgID (DataS ealLib P roperty) S eal.InternalFirm wareVersion (DataS ealLib P roperty) S eal.LastDateTim eUpdate (DataS ealLib P roperty) S eal.LastS etR eader (DataS ealLib P roperty) S eal.LifeCounter (DataS ealLib P roperty) S eal.LifeCounterZero (DataS ealLib P roperty) S eal.LongStatus (DataS ealLib P roperty) S eal.LowB atteryError (DataS ealLib P roperty) S eal.LowB atteryErrorThreshold (DataS ealLib P roperty) S eal.LowB atteryWarning (DataS ealLib P roperty) S eal.LowB atteryWarningThreshold (DataS ealLib P roperty) S eal.M axAlertBurstR etries (DataS ealLib P roperty) S eal.M axDeepS leepB urstR etries (DataS ealLib P roperty) S eal.M axM essageSize (DataS ealLib P roperty) S eal.M axNum berOfEvents (DataS ealLib P roperty) S eal.MinIntervalB etweenTim eUpdates (DataS eal P roperty) S eal.NewB attery (DataS ealLib P roperty) S eal.NumberOfS crollEvents (DataS ealLib P roperty) S eal.Opened (DataS ealLib P roperty) - 258 - 198 142 143 179 143 178 140 177 144 175 174 171 145 145 146 146 158 147 148 161 172 176 180 176 150 151 151 152 173 152, 207 174 153 169 154 155 155 157 157 158 175 159 170 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Index S eal.OrgID (DataS ealLib P roperty) S eal.OrgIDB urst (DataS ealLib P roperty) S eal.R eadData (DataS ealLib M ethod) S eal.R eadEvent (DataS ealLib M ethod) S eal.R eadM ultiAccessData (DataS ealLib M ethod) S eal.R eadP aram eter (DataS ealLib M ethod) S eal.R eadP aram eters (DataS ealLib M ethod) S eal.R esponseM ask (DataS ealLib P roperty) S eal.RSS I (DataS ealLib P roperty) S eal.RTCError (DataS ealLib P roperty) S eal.S ealID (DataS ealLib P roperty) S eal.S ealS tamp (DataS ealLib P roperty) S eal.S ealWireC hanged (DataS ealLib P roperty) S eal.S etS tatus (DataS ealLib M ethod) S eal.ShortS tatus (DataS ealLib P roperty) S eal.SleepDurationUnit (DataS ealLib P roperty) S eal.StartForcedBurst (DataS ealLib M ethod) S eal.SuspendedS et (DataS ealLib P roperty) S eal.Tam pered (DataS ealLib P roperty) S eal.Tem pDisableHF (DataS ealLib M ethod) S eal.Tim eFilterF orR eadEvent (DataS ealLib P roperty) S eal.Tp (DataS ealLib P roperty) S eal.Ts (DataS ealLIb P roperty) S eal.Tw (DataS ealLib P roperty) S eal.UnrecognizedC omm and (DataS ealLib P roperty) S eal.UserData (DataS ealLib P roperty) S eal.UserDataSize (DataS ealLib P roperty) S eal.UserP aram eter1 (DataS ealLib P roperty) S eal.UserP aram eter2 (DataS ealLib P roperty) S eal.Verify (DataS ealLib M ethod) S eal.WriteData (DataS ealLib M ethod) S eal.WriteP aram eter (DataS ealLib M ethod) S eal.WriteP aram eters (DataS ealLib M ethod) S ealC odesAndValues (DataS ealLib Class) S ealEvent (DataS ealLib Class) S ealing Wire Sealing Wire Changed Event S tatus flag S ealing Wire C hanged (Status flag) Sealing Wire Closed (Ev ent) Sealing Wire Opened (Ev ent) Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology 160 181 200 199 202 139, 201 139, 201 215 160 174 161 162 171 153, 205 163, 207 164 203 170 169 199 165 166 167 167 177 149 164 168 168 139, 197 202 139, 203 139, 203 201, 203 182, 200 13, 17 183 171 73, 208, 209 184 184 - 259 - Chapter 10 Technical Specifications S eals (DataS ealLib C lass) 188, 191, 207 S eals.AckB urst (DataS ealLib M ethod) 212 S eals.DeepS leep (DataS ealLib M ethod) 210, 211 S eals.R esetDataB lock (DataS ealLib M ethod) 210 S eals.S ealS et (DataS ealLib M ethod) 207, 208, 209 S eals.S etAsyncAlertB urstMode (DataS ealLib M ethod) 211 S eals.Verify (DataS ealLib M ethod) 139, 206 S ealStamp (DataS ealLib P roperty) 207 Send OrgID in Burst (Status f lag) 181 S ensor Plate 13, 22, 28, 40 S et Event 82, 183 RF C omm and 14, 32, 69, 71, 85, 95, 100, 108, 152, 162, 169, 171, 173, 183, 185, 188, 207, 208, 211, 216, 233 S uspended (RF Comm and) See Suspended S et (RF Comm and) S et Status (RF C omm and) 153 S et/R eset S tatus (R F Comm and) 86, 174, 175, 176, 177, 178, 179, 180, 181, 205, 237 S hort Event 182 S hort Events 126, 182 S hort Status (DataS eal P aram eter) 31, 72, 73, 96, 97, 98, 109, 149, 153, 163, 169, 172, 199, 203, 205, 215, 216 Size of User Data (DataSeal Parameter) 164 Sleep Duration Unit (DataSeal Parameter) 164, 192 S lotted Aloha 137 Sm artDataR eader 12, 14 S oft S et Event 209 RF C omm and 209 S oft S et (Event) 184, 185 S oft S et (RF C omm and) 68, 85, 109, 185, 207, 209, 211 S tart Alert Burst Mode (RF C omm and) 85, 120, 121, 122, 179, 187, 194, 195, 211, 213 S tart Alert Burst Mode for All S eals (RF Comm and) 121, 179, 187, 194, 195, 213 Start Burst Mode Event 187 S tart F orced B urst (RF Comm and) 86, 203, 212, 215, 217 S tatus DataS eal 72 S top Alert Burst M ode (R F Comm and) 85, 122, 179, 187 S top Alert Burst M ode for All S eals (RF C omm and) 122, 179, 187, 194, 195 Stop Alert Bust Mode (RF Command) 211 Stop Burst Mode Event 187 - 260 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology S uspended S et Event RF C omm and S tatus flag S YS (DataR ead P aram eter) S YS (DataR eader P aram eter) Index 109, 186, 71, 85, 109, 171, 187, 207, 73, 109, 170, 186, 187, 208, 208, 228, 208 211 209 233 166 Tam per Windows Tam pered Event RF C omm and 71, 84, 107, 139, 146, 148, 150, 165, 180, S tatus flag 31, 72, 86, 107, 108, 109, 169, Tb See Alert and Close B urst P eriod (DataS eal P aram eter) Tem porarily Disable HF (RF Comm and) Temporarily Disable High Frequency (RF Command) Term inal B locks Thp (DataReader Parameter) Thw (DataR eader P aram eter) 135, 136, Time Filter f or Read (Footprint) Ev ents (DataSeal Parameter) Time Slot Duration (DataSeal Parameter) Tp (DataSeal Parameter) TrackingDataR eader Ts (DataSeal Parameter) Tw (DataS eal P aram eter) 68, 134, 135, 136, 165, 167, 192 82, 85, 123, 199 186, 190, 197, 228, 237 170, 173, 208, 209, 237 86, 180, 192 199 45 230 215, 230, 231, 232, 237 165 167 166, 210, 211 12, 14, 18, 73 167 195, 197, 211, 232, 237 Unrecognized Command (Status f lag) 177 User Data 31, 81, 82, 83, 85, 86, 110, 112, 117, 141, 144, 150, 164, 190, 191, 197, 200, 202, 204, 206, 210, 215 User Parameter 1 (DataSeal Parameter) 168, 233 User Parameter 2 (DataSeal Parameter) 168 Verify Addressed (RF C omm and) See Addressed Verify (RF Comm and) Verify (RF Comm and) 29, 30, 32, 33, 68, 69, 71, 79, 80, 82, 84, 86, 87, 95, 96, 97, 98, 99, 105, 107, 137, 139, 144, 146, 148, 149, 150, 165, 166, 180, 186, 190, 191, 192, 195, 197, 206, 228, 233, 236, 237 Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology - 261 - Chapter 10 Technical Specifications Wakeup Time Interv al (DataSeal Parameter) 167 Wakeup Time Interv al in Deep Sleep Mode (DataSeal Parameter) 166 Write Data (RF C omm and) 82, 86, 112, 150, 202 Write P aram eters (RF C omm and) 86, 115, 138, 150, 186, 203, 238 - 262 - Hi-G-Tek Ltd. Microelectronics & Asset Tracking Technology Contact Infomation Hi-G-Te k Ltd. Microelectronics and Asset TrackingT echnology T el: 972-3-5339359 Fax: 972-3-5339225 http://www.higtek.com
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.4 Linearized : No Create Date : 2004:02:22 13:37:55Z Modify Date : 2004:02:22 15:58:26+02:00 Page Count : 263 Creation Date : 2004:02:22 13:37:55Z Mod Date : 2004:02:22 15:58:26+02:00 Producer : Acrobat Distiller 5.0.5 (Windows) Author : roni Metadata Date : 2004:02:22 15:58:26+02:00 Creator : roni Title : Microsoft Word - UM4710 rev-A6.doc Page Mode : UseOutlinesEXIF Metadata provided by EXIF.tools