Hi-G-Te k Ltd. Microelectronics and Asset Tracking Technology User’s Manual Ver.
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 ..............................................................
4.1.2 5 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 .............................................
5.8.1 5.8.2 5.8.3 6 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 .............
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 ...
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.......................................
8.6 8.7 9 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 :.......
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.
Chapter 1 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.
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.
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.
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.
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.
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.
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.
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.
Chapter 1 Introduction Indoor DataReade r Antenna Electronics Bay Led Indicator Cable Connection - 18 - Hi-G-Tek Ltd.
Chapter 2 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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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).
Chapter 3 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.
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.
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.
Chapter 4 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. 2 Press the Sensor Plate to the DataT ag such that the 1 double-side d tape will hold the Sensor Plate in place.
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.
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.
Chapter 5 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.
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.
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).
Chapter 5 5.1.4 DataReader Installation and Operating Instructions RS-232 Wiring Diagram Hi-G-Tek Ltd.
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.
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.
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.
Chapter 5 DataReader Installation and Operating Instructions 1 5 6 5 1 9 5 10 15 5.2.3 9 6 1 6 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 1 Positive Power 2 Signal GND 3 Negative Power 4 Negative Power 5 TX 6 RX 7 Hi-G-Tek Ltd.
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 1 Positive Power 2 Signal GND 3 Negative Power 4 Negative Power 5 RX-A 6 RX-B 7 T X-A 8 T X-B 9 - 50 - Hi-G-Tek Ltd.
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 1 Positive Power 2 Signal GND 3 Negative Power 4 Negative Power 5 T X/RX-A 6 T X/RX-B 7 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.
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.
Chapter 5 DataReader Installation and Operating Instructions Hi-G-Tek Ltd.
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.
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 1 2 3 4 5 6 7 PWR+ PWRRXB RXA GND TXB TXA MOXA TXB TXA RXB RXA GND PWRPWR+ 1 2 3 4 5 6 7 Term inal B lock Hi-G-Tek Ltd.
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.
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.
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.
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).
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.
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.
Chapter 6 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Chapter 6 System Overview Table 6-3: Memory map of the lower portion of the User Data. Address 0 Byte Content UDT Version 1 2 T ime & Date 3 4 5 . . 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.
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.
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.
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.
Chapter 7 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.
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.
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.
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.
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.
Chapter 7 1 Evaluation Softw are 3b 2 4 5 6 7 3a 8 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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
Chapter 7 Evaluation Softw are Argument Value in Description example #Rr 2 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).
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.
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.
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.
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.
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) 5 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.
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 0 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 1 The sequential number of the first Event record to read. Number of Events to read 5 The number of Event records to read. The response is composed of the following fields: Hi-G-Tek Ltd.
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.
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.
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- .
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.
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.
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.
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.
Chapter 8 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.
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.
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.
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.
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.
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.
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).
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.
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: 7 6 5 4 3 2 1 0 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.
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.
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.
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.
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.
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.
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: 7 Sp 6 Sp 5 Sp 4 Sp 3 Sp 2 A 1 E 0 M Where: Sp - not used (spare) - must be 0.
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).
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.
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).
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.
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).
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.
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).
Chapter 8 System Parameters and Comm ands Ve rify Mask in HGTVe rifyMaskEnum (not supported). Data Type Byte Default Value 5 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).
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.
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.
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.
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.
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.
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.
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.
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.
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 5 Remarks See the description of the Verify command for more information about this parameter.
Chapter 8 System Parameters and Comm ands 0 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
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 1 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 2 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 t The following scheme demonstrates the various parts of the Receiving Window through t
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Chapter 9 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Chapter 10 11 Technical Specifications INDEX 1 12v Indoor DataR eader 12v Outdoor DataR eader 242 241 2 24v Indoor DataR eader 24v Outdoor DataR eader 241 240 4 48v Indoor DataR eader 48v Outdoor DataR eader 243 241 A 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,
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 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
Chapter 10 Technical Specifications D 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
Index E 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 F 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,
Chapter 10 Technical Specifications I 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 L Last Date & Time Update (DataSeal Parameter) 151 Last Set Reader ID (DataSeal Parameter) 151, 208, 209 LFSee Low F requency
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
Chapter 10 Technical Specifications P ower LED P ower S upply 62, 236 58 R 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.
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.
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.
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.
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.
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 T 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 lo
Chapter 10 Technical Specifications W 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.
Contact Infomation Hi-G-Te k Ltd. Microelectronics and Asset TrackingT echnology T el: 972-3-5339359 Fax: 972-3-5339225 http://www.higtek.