Abstract:
A system and method for providing communication with a tracking device are disclosed. An example tracking device includes a location detector, a communication device, memory, a processor, and a configuration routine. The location detector is operative to determine locations of the tracking device. The communication device is operative to communicate with a remote system. The memory stores data and code, the data including location data determined by the location detector and configuration data. The processor is operative to execute the code to impart functionality to the tracking device. The functionality of the tracking device depends at least in part on the configuration data. The configuration routine is operative to modify the configuration data responsive to communications from the remote system. Thus, functional access to the tracking device is provided to the remote system.

Description:
RELATED APPLICATIONS 
       [0001]    This application is a continuation of U.S. patent application Ser. No. 12/322,941 (now U.S. Pat. No. 8,154,401), filed Feb. 9, 2009 by at least one common inventor, which claims the benefit of U.S. Provisional Patent Application No. 61/065,116 filed Feb. 8, 2008 by at least one common inventor, all of which are incorporated herein by reference in their respective entireties. 
     
    
     BACKGROUND 
       [0002]    1. Technical Field 
         [0003]    This invention relates generally to a system and method for monitoring location, and more specifically to a system and method for enabling communication with a tracking device. 
         [0004]    2. Background Art 
         [0005]    Currently, systems exist for tracking the location of persons and/or property. Generally, such systems include a tracking device that transmits the location of the tracking device to a central station, which may then take some action based on the location data. 
         [0006]    Known systems have generally been very limited with respect to the communication capabilities between the tracking device and the central station. For example, communications from a tracking device to a central station have typically been limited to the transmission of a device identifier in combination with location data and, in some cases, a distress signal. 
         [0007]    Perhaps, the limited communication between tracking devices and central stations has evolved due to the disadvantages of prior art tracking systems. For example, in personal tracking devices power consumption is a serious concern, because the devices power storage capacity is a limiting factor with respect to the amount of communication that can take place. Another concern is the cost of network access (e.g., mobile phone air time). 
         [0008]    What is needed is a system and method for providing enhanced communication with tracking devices. What is also needed is a system and method for providing enhanced communication with tracking devices, while minimizing power consumption. What is also needed is a system and method for providing enhanced communication with tracking devices, while minimizing network air time. 
       SUMMARY 
       [0009]    A system and method for providing communication with a tracking device is disclosed. The inventor has discovered that several advantages are provided by the communication system and methods disclosed herein. These advantages include the efficient use of network access time and the conservation of tracking device power. Additional advantages include enhanced efficiency and flexibility in the communication of location data from tracking devices. Yet another advantage is that functional access (e.g., setting and/or resetting of functions, parameters, etc.) to the tracking device is provided to the central station. These and other advantages will be apparent to those skilled in the art in view of the following disclosure. 
         [0010]    In a disclosed example, a tracking device includes a location detector, a communication device, memory, a processor, and a configuration routine. The location detector (e.g., a Global Positioning Satellite receiver) is operative to determine locations of the tracking device. The communication device (e.g., a cell phone modem) is operative to communicate with a remote system (e.g., a central station, subscriber server, etc.). The memory stores data and code, the data including location data determined by the location detector and configuration data. The processor is operative to execute the code to impart functionality to the tracking device. The functionality of the tracking device depends at least in part on the configuration data. The configuration routine is operative to modify the configuration data responsive to a communication from the remote system. Thus, functional access to the tracking device is provided to the remote system. 
         [0011]    The tracking device can be configured and reconfigured in many ways. In one example, the configuration data modifiable responsive to the communication from the remote system at least partially determines an interval for communicating the location data to the remote system. In another example, the configuration data modifiable responsive to the communication from the remote system at least partially determines an interval for buffering the location data when the communication device is unable to communicate the location data to the remote system (e.g., out of communication range). The interval for buffering the location data can be, for example and without limitation, a time interval (e.g., every 30 minutes) or a distance interval (e.g., whenever the tracking device moves 50 yards). In yet another example, the configuration data modifiable responsive to the communication from the remote system at least partially determines a power state of the location detector. In yet another example, the configuration data modifiable responsive to the communication from the remote system at least partially determines a monitored condition with respect to the location of the tracking device (e.g., a “geofence”). For example and without limitation, the monitored condition can be a geographical area (e.g., circular or polygonal, etc.), a velocity, a distance, a time/distance relationship (e.g., a time the tracking device remains stationary), or any combination of these. In yet another example, the configuration data modifiable responsive to the communication from the remote system at least partially determines a threshold distance between one of the locations and subsequent ones of the locations for storing the subsequent ones of the locations (e.g., only buffer location data if the tracking device has moved at least the threshold distance). As even yet another example, the configuration data modifiable responsive to the communication from the remote system at least partially determines an interval for communicating diagnostic information from the tracking device to the remote system. 
         [0012]    The example tracking device also includes a data transfer routine operative to communicate operational data between the tracking device and the remote system. In one example, the tracking device includes a battery and the data transfer routine responsive to a request from the server is operative to communicate data indicative of the status of the battery to the remote system. In another example, the data transfer routine responsive to a request from the server is operative to communicate data indicative of a radio signal strength to the remote system. In yet another example, the data transfer routine responsive to a request from the server is operative to communicate data indicative of a status of the location detector to the remote system. In yet another example, the data transfer routine responsive to a status of a monitored location condition (e.g., a geofence definition) is operative to communicate data indicative of a violation or satisfaction of the location condition to the remote system. As yet another example, the data transfer routine responsive to a request from the server is operative to communicate diagnostic data to the remote system. 
         [0013]    Another feature of the example tracking device is that when the communication device is unable to establish a connection with the remote system, the location data is accumulated in the memory. Then, when the communication device is able to establish a connection with the remote server, the data transfer routine communicates the accumulated data to the remote system. 
         [0014]    An example method for communicating with a tracking device is also disclosed. The method includes communicating with the tracking device via a wireless network and providing configuration data to the tracking device via the wireless network. The configuration data causes the tracking device to operate according to a first configuration. The method further includes receiving processed data from the tracking device. The processed data is generated by the tracking device in the first configuration. The method further includes providing new configuration data to the tracking device via the wireless network. The new configuration data changes the first configuration of the tracking device to a different configuration. The method further includes receiving additional processed data from the tracking device. The additional processed data is generated by the tracking device in the different configuration. 
         [0015]    In the example method, the configuration data at least partially determines a location data reporting interval. In another example method, the configuration data at least partially determines a location data buffering interval. In yet another example method, the configuration data at least partially determines a power state of the tracking device. In yet another example method, the configuration data at least partially determines a location based condition that if violated or satisfied causes an indication of the violation or satisfaction of the location based condition to be communicated from the tracking device to the remote system. In yet another example method, the configuration data at least partially determines a diagnostic reporting interval. In yet another example method, the configuration data at least partially determines a distance threshold for buffering location data. In yet another example method, the processed data includes data indicative of a battery status of the tracking device. In yet another example method, the processed data includes data indicative of a radio signal strength determined by the tracking device. In yet another example method, the processed data includes data generated by a diagnostic routine of the tracking device. 
         [0016]    Many other detailed examples are disclosed in the communication protocol specification set forth below. 
     
    
     
       BRIEF DESCRIPTION OF THE DRAWINGS 
         [0017]    The present invention is described with reference to the following drawings, wherein like reference numbers denote substantially similar elements: 
           [0018]      FIG. 1  is a block diagram of a tracking system; 
           [0019]      FIG. 2  is a block diagram of a server of the tracking system of  FIG. 1 ; 
           [0020]      FIG. 3  is a block diagram of a subscriber system of the tracking system of  FIG. 1 ; 
           [0021]      FIG. 4  is a block diagram of a tracking device of the tracking system of  FIG. 1 ; and 
           [0022]      FIG. 5  is a flow chart summarizing an example method of communicating with the tracking device of  FIG. 1  and  FIG. 4 . 
       
    
    
     DETAILED DESCRIPTION 
       [0023]      FIG. 1  is a block diagram of a system  100  for tracking and/or monitoring one or more tracking devices  102 ( 1 - m ). System  100  includes one or more servers  104 ( 1 - m ), a subscriber profile database  106 , a vendor information database  108 , a public database cache  110 , and tracking interface  112 , all intercommunicating via an internal network  114 . System  100  communicates with remote components including one or more vendors  116 ( 1 - n ), one or more subscribers  118 ( 1 - p ), and one or more public databases  120 ( 1 - q ), all via an internetwork  122  (e.g., the Internet). A firewall  124  provides a measure of security for internal network  114  against threats via internetwork  122 . 
         [0024]    Servers  104  host services for subscribers  118  and/or other authorized users that facilitate the tracking and/or monitoring of the location of tracking devices  102 . Subscriber profile database  106  stores information associated with particular subscribers  118  and/or other users of system  100 . Vendor information database  108  stores information associated with vendors  116  that provide goods and or services that can be made available to subscribers  118  and/or other users of system  100  based on information from subscriber profile database  106  and/or location data received from tracking devices  102 . Public database cache  110  provides temporary storage for data retrieved from public databases  120 . Tracking interface  112  transmits (via wireless communication) data and commands to tracking devices  102  and receives data (e.g., location data, sensor readings, distress signal, etc.) from tracking devices  102 . Vendors  116  offer goods and services that may be offered to subscribers and other users of system  100  as described above. In addition, information associated with vendors (e.g., type of business) can be used to help define boundaries used to monitor tracking devices  102 . Similarly, public databases  120  provide information (e.g., sex offender registries, etc.) that can be used as criteria for defining boundaries. 
         [0025]    Subscribers  118  are the primary users of system  100  and interact with servers  104  to define tracking criteria and to obtain information and alerts regarding the tracking of associated tracking devices  102 . In this example, the primary users are referred to as subscribers, because it is expected that users will be willing to pay for the right to use system  100 . However, it should be understood that system  100  is not limited to a subscription type business model. For example, access to system  100  could be provided to users on a free basis, relying on some other business model to raise revenue. 
         [0026]    In addition communication between tracking devices  102  and servers  104 , the communication methods described herein can be used to provide direct communication between tracking devices  102  and subscribers  118  via a communication link (e.g., mobile phone network), which is not shown in  FIG. 1 . Similarly, the communication methods described herein can be used to provide direct communication between tracking devices  102  (e.g., GPS enabled cell phone to GPS enabled cell phone). In that case tracking devices  102  can function as both a tracking device and a subscriber system. 
         [0027]      FIG. 2  is a block diagram of a server  102  of tracking system  100 . Server  102  includes non-volatile data storage  202 , one or more processing units  204 , memory  206 , user I/O devices  208 , and a network interface  210 . Nonvolatile data storage  202  stores data and code that is retained even when server  104  is powered down. Memory  206  stores data and code that when processed by processing unit(s)  204  imparts functionality to server  104 . User input/output devices  208  (e.g., keyboard, mouse, monitor, etc.) provide a means of interaction between server  104  and a local human user. Network interface  210  provides a communication link to other components on internal network  114  and internetwork  122 . 
         [0028]    For the sake of clear explanation data and code are shown in memory  206  as functional blocks. It should be understood, however, that the various functions of server  104  need not be run in any particular location of memory  206  and may grouped in any useful manner. For example, the several application program interfaces (APIs) shown could be grouped into a single API. 
         [0029]    Memory  206  includes an operating system  214 , public database API  216 , subscriber API  218 , processing queues  220 , vendor API  222 , control and coordination routines  224 , application programs  226 , and a tracking device communication protocol  228 . Operating system  214  provides low level control of server  104  and provides a platform on top of which the other modules can operate. Application programs  226  are tracking service programs that receive and process location and/or sensor data from tracking devices  102 , process the received data, communicate with subscribers  118 , read and/or update subscriber profile database  106 , search remote data sources, and so on. Public database API  216 , vendor API  222 , and subscriber API  218  provide a means of communication between application programs  226  and public databases  120 , vendors  116 , and subscribers  118 , respectively. Control and coordination module  224  provides overall control and coordination of the tracking services provided by server  104 . Processing queues  220  provide temporary storage for tracking data that is being processed. 
         [0030]    Tracking device communication protocol  228  defines a protocol for communicating with tracking device  102 . In this particular embodiment, this communication occurs via network  114 , tracking interface  112 , and the wireless connection with tracking devices  102 . It is sometimes, therefore, referred to as the over-the-air protocol. The definitions and functionality of an example tracking device communication protocol  228  is fully described below. 
         [0031]      FIG. 3  is a block diagram of a subscriber system  118  of tracking system  100 . Subscriber system  118  includes non-volatile data storage  302 , one or more processing units  304 , memory  306 , user I/O devices  308 , and a network interface  310 , all intercommunicating via a bus  312 . Memory  306  includes operating system  314 , application programs  316 , subscriber API  318 , and tracking device communication protocol  320 . Application programs  316  provide various tracking based services (e.g., set up tracking account, associate particular tracking devices  102  with user account, receive and/or display real time and/or historical location information associated with particular tracking devices  102 , and so on). Subscriber API  318  (in conjunction with subscriber API  218  of server  104  shown in  FIG. 2 ) facilitates communication between application programs  316  of subscriber system  118  and application programs  226  of server  104  ( FIG. 2 ). 
         [0032]    Tracking device communication protocol  320  is similar to tracking device communication protocol  228  of server  104 , except that tracking device communication protocol  320  resides on a subscriber system  118 . Therefore, tracking device communication protocol  320  facilitates direct communication between subscriber system  118  and tracking device  102  via a separate communication link (not shown), such as a mobile telephone network. 
         [0033]      FIG. 4  is a block diagram of a tracking device  102  of tracking system  100 . Tracking device server  102  includes non-volatile data storage  402 , one or more processing unit(s)  404 , memory  406 , location detector (e.g., GPS receiver)  408  with optional sensors (e.g., temperature sensor, motion sensor, etc.), and a wireless communication device  410 , all intercommunicating via a bus  412 . Memory  406  includes an operating system  414 , application programs  416 , a tracking API  418 , location data  420 , tracking device communication protocol  422 , and sensor data  424 . Application programs  416  facilitate the processing of location data  420  and/or sensor data  424 , provide alerts and/or updates to server  104  ( FIG. 1 ), facilitate updates to existing routines or the addition of new routines, and provide any other specified functionality for tracking device  102 . For example, application programs  416  can be updated or replaced by server  104  via tracking interface  112 . Tracking API facilitates communication between application programs  416  and application programs  226  of server  104 , for example, to communicate location data from tracking device  102  to server  104 . Sensor data  424  and location data  420  can be accessed by application programs  416  as needed. Data indicative of the velocity of tracking device  102  can be characterized as either sensor data or location data. Tracking device communication protocol  422  is similar to tracking device communication protocol  228 , except that tracking device protocol  422  operates on the device side of the communication link. 
         [0034]    The following is a detailed description of a particular example of a tracking device communication protocol. 
       1. Gradient Fields 
     1.1 Overview 
       [0035]    Many of the fields within the structures in this document use index values to pass a value measured by or stored at the device. 
         [0036]    When a data field is defined as a gradient, the firmware will calculate an index value as the number of increments from a defined base value. This value, an integer, will be placed within the structure for transmission. 
         [0000]      index=(measurement−base)/increment
 
         [0037]    When the server receives the index value, that actual measured value is calculated by first retrieving the pre-defined values for base, increment, and unit of measure from a table lookup. These values are stored based on Device Type and Firmware Version, and are applied uniformly for all devices sharing these characteristics. 
         [0038]    Once the server has retrieved the conversion values, the actual measurement value is calculated as 
         [0000]      measurement=base+(index*increment) 
         [0039]    The server will can then store the calculated result as a high-precision value in the database. System presentation layers can convert these values to the localized measurement system for display, using the unit of measure field as a helper. 
         [0000]    1.2 Field List with Suggested Metrics 
         [0040]    The following table lists the structure fields defined as gradient fields. All gradient fields are defined as integer values. 
         [0041]    The suggested base and increment are suggested values only. The developer must decide the actual base and increment to meet the requirements for range and granularity imposed by the specific implementation. 
         [0000]    
       
         
               
               
               
               
               
               
             
               
               
               
               
               
               
             
           
               
                   
               
               
                 Field Type 
                   
                   
                 Incre- 
                 Unit of 
                 Range 
               
               
                 Definition 
                 Data Type 
                 Base 
                 ment 
                 Measure 
                 (Rounded) 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 RSSI 
                 Byte 
                 −113 
                 2 
                 dBm 
                 −113 to 397 
               
               
                   
                   
                   
                   
                   
                 dBm 
               
               
                 BATTERY 
                 Unsigned 
                 0 
                 1 
                 mV 
                 0 to 65.5 volts 
               
               
                   
                 Short 
               
               
                 ALTITUDE 
                 Unsigned 
                 −4000 
                 1 
                 Decimeter 
                 −400 to 6,153 
               
               
                   
                 Short 
                   
                   
                   
                 meters/−1312 
               
               
                   
                   
                   
                   
                   
                 to 20,188 feet 
               
               
                 SPEED 
                 Unsigned 
                 0 
                 1 
                 Dekameters 
                 0 to 6,553 
               
               
                   
                 Short 
                   
                   
                   
                 meters per 
               
               
                   
                   
                   
                   
                   
                 hour/0 to 
               
               
                   
                   
                   
                   
                   
                 407 miles per 
               
               
                   
                   
                   
                   
                   
                 hour 
               
               
                 BEARING 
                 Unsigned 
                 0 
                 1 
                  1/100 ths  of a 
                 360 degrees 
               
               
                   
                 Short 
                   
                   
                 degree 
               
               
                 DISTANCE 
                 Unsigned 
                 0 
                 1 
                 Hectometers 
                 0 to 6,553 
               
               
                   
                 Short 
                   
                   
                   
                 kilometers/0 
               
               
                   
                   
                   
                   
                   
                 to 4,072 miles 
               
               
                 DOP 
                 Byte 
                 0 
                 0.2 
                 Absolute 
                 0 to 50.8 
               
               
                 VDOP 
                 Byte 
                 0 
                 0.2 
                 Absolute 
                 0 to 50.8 
               
               
                 HDOP 
                 Byte 
                 0 
                 0.2 
                 Absolute 
                 0 to 50.8 
               
               
                 GPSSNR 
                 Byte 
                 0 
                 1 
                 dB 
                 0 to 255 dB 
               
               
                   
               
             
          
         
       
     
       2. Data Types 
       [0042]    The following data types are referenced in this document. 
       2.1 Primitives 
       [0043]      
         [0000]    
       
         
               
               
               
             
           
               
                   
               
               
                 Name 
                 Byte Length 
                 Comment 
               
               
                   
               
             
             
               
                 Byte 
                 1 
                 No type checking 
               
               
                 Short Integer 
                 2 
                 Integer values from −32,768 to 
               
               
                   
                   
                 32,767. Little endian. 
               
               
                 Unsigned Short 
                 2 
                 Integer values from 0 to 
               
               
                   
                   
                 65,535. Little endian. 
               
               
                 Integer 
                 4 
                 Integer values from −2147483648 
               
               
                   
                   
                 to 2147483647. Little endian. 
               
               
                 Unsigned Integer 
                 4 
                 Integer values from 0 to 
               
               
                   
                   
                 4,294,967,296. Little endian. 
               
               
                 Float 
                 4 
                 A single-precision 32-bit IEEE 
               
               
                   
                   
                 754 floating point value. 
               
               
                   
               
             
          
         
       
     
       2.2 Defined Types 
       [0044]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Name 
                 Data Type 
                 Length 
                 Comment 
               
               
                   
               
             
             
               
                 DATETIME 
                 Byte Array 
                 6 
                 YMDHMS 
               
               
                 CRC32 
                 Integer 
                 4 
                 Result of CRC-32 hash 
               
               
                 LATITUDE 
                 Float 
                 4 
               
               
                 LONGITUDE 
                 Float 
                 4 
               
               
                 DATETIME 
                 Unsigned Integer 
                 4 
               
               
                 RSSI 
                 Byte 
                 1 
                 Gradient field 
               
               
                   
                   
                   
                 containing the data 
               
               
                   
                   
                   
                 transceiver Received 
               
               
                   
                   
                   
                 Signal Strength 
               
               
                   
                   
                   
                 Indication 
               
               
                 BATLEVEL 
                 Unsigned Short 
                 2 
                 Gradient field 
               
               
                   
                   
                   
                 containing battery 
               
               
                   
                   
                   
                 condition. 
               
               
                 ALTITUDE 
                 Unsigned Short 
                 2 
                 Gradient field 
               
               
                   
                   
                   
                 containing an altitude 
               
               
                   
                   
                   
                 value. 
               
               
                 SPEED 
                 Unsigned Short 
                 2 
                 Gradient field 
               
               
                   
                   
                   
                 containing a speed or 
               
               
                   
                   
                   
                 velocity value. 
               
               
                 BEARING 
                 Unsigned Short 
                 2 
                 Gradient field 
               
               
                   
                   
                   
                 containing a compass 
               
               
                   
                   
                   
                 bearing or course 
               
               
                   
                   
                   
                 direction value. 
               
               
                 DISTANCE 
                 Unsigned Short 
                 2 
                 Gradient field 
               
               
                   
                   
                   
                 containing a linear 
               
               
                   
                   
                   
                 distance value. 
               
               
                   
               
             
          
         
       
     
       3. Constants 
       [0045]    The following constant values are referenced in this document. 
       3.1 Transport Structure IDs 
       [0046]    See section 5 Structure Summary. 
       3.2 Device Types 
       [0047]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Name 
                 Value 
                 Comment 
               
               
                   
                   
               
             
             
               
                   
                 DT_HERMES 
                 0x01 
                 Use for Hermes hardware 
               
               
                   
                   
                   
                 specification devices. 
               
               
                   
                 DT_PPC 
                 0x02 
                 Use for Windows Pocket PC 
               
               
                   
                   
                   
                 devices. 
               
               
                   
                   
               
             
          
         
       
     
       3.3 GPS Fix States 
       [0048]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Name 
                 Value 
                 Comment 
               
               
                   
                   
               
             
             
               
                   
                 GPS_NOFIX 
                 0x01 
                 GPS is powered on but could 
               
               
                   
                   
                   
                 not establish a fix. 
               
               
                   
                 GPS_SEARCHING 
                 0x02 
                 GPS is establishing a fix. 
               
               
                   
                 GPS_LOCONLY 
                 0x03 
                 GPS fix two dimensional 
               
               
                   
                   
                   
                 without altitude. 
               
               
                   
                 GPS_LOCALT 
                 0x04 
                 GPS has a full three 
               
               
                   
                   
                   
                 dimension fix with altitude. 
               
               
                   
                 GPS_POWEROFF 
                 0x05 
                 GPS is powered off. 
               
               
                   
                   
               
             
          
         
       
     
       3.4 GPS Power States 
       [0049]      
         [0000]    
       
         
               
               
               
             
           
               
                   
               
               
                 Name 
                 Value 
                 Comment 
               
               
                   
               
             
             
               
                 GPS_POWERDOWN 
                 0x01 
                 Power down the GPS. 
               
               
                 GPS_POWERUP 
                 0x02 
                 Power up the GPS and attempt 
               
               
                   
                   
                 to obtain a fix. 
               
               
                 GPS_POWERDOWNUNTIL 
                 0x03 
                 Power down until the wake up 
               
               
                   
                   
                 time. 
               
               
                   
               
             
          
         
       
     
       3.5 Interactivity Modes 
       [0050]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Name 
                 Value 
                 Comment 
               
               
                   
                   
               
             
             
               
                   
                 IMODE_HIGN 
                 0x01 
                 High Interactivity mode. 
               
               
                   
                 IMODE_LOW 
                 0x02 
                 Low Interactivity mode. 
               
               
                   
                   
               
             
          
         
       
     
       3.6 Geofence Types 
       [0051]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Name 
                 Value 
                 Comment 
               
               
                   
                   
               
             
             
               
                   
                 GFT_INCLUSION 
                 0x01 
                   
               
               
                   
                 GFT_EXCLUSION 
                 0x02 
               
               
                   
                 GFT_BOTH 
                 0x03 
               
               
                   
                 GFT_POLYGON 
                 0x04 
               
               
                   
                 GPT_CIRCULAR 
                 0x05 
               
               
                   
                 GFT_VELOCITY 
                 0x06 
               
               
                   
                 GFT_STATIONARY 
                 0x07 
               
               
                   
                 GFT_MOVEMENT 
                 0x08 
               
               
                   
                   
               
             
          
         
       
     
       3.7 NACK Types 
       [0052]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Name 
                 Value 
                 Comment 
               
               
                   
                   
               
             
             
               
                   
                 NACK_UNKNOWN 
                 0x01 
                   
               
               
                   
                 NACK_NOT_SUPPORTED 
                 0x02 
               
               
                   
                 NACK_FAIILED_CRC 
                 0x03 
               
               
                   
                 NACK_INVALID_LENGTH 
                 0x04 
               
               
                   
                   
               
             
          
         
       
     
       4. Structure Summary 
       [0053]    Utility structures are not included in the summary. 
         [0000]    
       
         
               
               
               
             
               
               
               
               
               
             
               
               
               
               
               
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Orientation 
                   
               
             
          
           
               
                   
                 Manifest 
                 Mobile 
                 Host to 
                 Protocol Usage 
               
             
          
           
               
                 Structure Name 
                 Type 
                 Value 
                 to host 
                 Mobile 
                 UDP 
                 RHTTP 
                 DHTTP 
                 TCP 
                 SMS 
               
               
                   
               
               
                 UDP_ENVELOPE 
                 Transport 
                 n.a. 
                 ✓ 
                 ✓ 
                 ✓ 
                   
                   
                   
                   
               
               
                 RHTTP_ENVELOPE 
                 Transport 
                 n.a. 
                 ✓ 
                 ✓ 
                   
                 ✓ 
               
               
                 DHTTP_ENVELOPE 
                 Transport 
                 n.a. 
                 ✓ 
                 ✓ 
                   
                   
                 ✓ 
               
               
                 TCP_ENVELOPE 
                 Transport 
                 n.a. 
                 ✓ 
                 ✓ 
                   
                   
                   
                 ✓ 
               
               
                 SMS_ENVELOPE 
                 Transport 
                 n.a. 
                 ✓ 
                 ✓ 
                   
                   
                   
                   
                 ✓ 
               
               
                 GET_DEVICE_ID 
                 Request 
                 0x0101 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 GET_CURRENT_LOCATION 
                 Request 
                 0x0102 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 GET_BATTERY_STATUS 
                 Request 
                 0x0103 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 GET_RSSI 
                 Request 
                 0x0104 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 GET_GPS_STATUS 
                 Request 
                 0x0105 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 GET_GEOFENCE_HANDLE 
                 Request 
                 0x0106 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 GET_GEOFENCES 
                 Request 
                 0x0107 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 GET_CUSTOM_PARAM 
                 Request 
                 0x0108 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 GET_DIAGNOSTIC 
                 Request 
                 0x0109 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 GET_SYSTEMTIME 
                 Request 
                 0x010A 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_REPORTING_INTERVAL 
                 Request 
                 0x0201 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_GPS_POWERSTATE 
                 Request 
                 0x0202 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_BUFFERING_INTERVAL 
                 Request 
                 0x0203 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_START_BUFFER 
                 Request 
                 0x0204 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_END_BUFFER 
                 Request 
                 0x0205 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_HEARTBEAT_PARAMETERS 
                 Request 
                 0x0206 
                   
                 ✓ 
                   
                 ✓ 
               
               
                 SET_INTERACTIVITY_MODE 
                 Request 
                 0x0207 
                   
                 ✓ 
                   
                 ✓ 
                   
                   
                 ✓ 
               
               
                 SET_CIRCULAR_GEOFENCE 
                 Request 
                 0x0208 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_POLYGON_GEOFENCE 
                 Request 
                 0x0209 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_VELOCITY_GEOFENCE 
                 Request 
                 0x020A 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_STATIONARY_GEOFENCE 
                 Request 
                 0x020B 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_DELETE_GEOFENCE 
                 Request 
                 0x020C 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_CUSTOM_PARAM 
                 Request 
                 0x020D 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_REPORTING_GRANULARITY 
                 Request 
                 0x020E 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_MOVEMENT_GEOFENCE 
                 Request 
                 0x020F 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_DIAGNOSTIC_INTERVAL 
                 Request 
                 0x0210 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 SET_DEBUG_LEVEL 
                 Request 
                 0x0211 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_CURRENT_LOCATION 
                 Response 
                 0x0301 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_BATTERY_STATUS 
                 Response 
                 0x0302 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_RSSI 
                 Response 
                 0x0303 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_GPS_STATUS 
                 Response 
                 0x0304 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_GEOFENCE_HANDLE 
                 Response 
                 0x0305 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_GEOFENCE 
                 Response 
                 0x0306 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_CUSTOM_PARAM 
                 Response 
                 0x0307 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_LOCATION 
                 Response 
                 0x0308 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_GEOFENCE_VIOLATION 
                 Response 
                 0x0309 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_DEVICE_ID 
                 Response 
                 0x030A 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_LOCATION_ARRAY 
                 Response 
                 0x030B 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_DIAGNOSTIC 
                 Response 
                 0x030C 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_SYSTEMTIME 
                 Response 
                 0x030D 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 PUT_DEBUG_MESSAGE 
                 Response 
                 0x030E 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 ACK_MOBILE 
                 Acknow. 
                 0x0401 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 ACK_HOST 
                 Acknow. 
                 0x0402 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 NACK_MOBILE 
                 Acknow. 
                 0x0403 
                 ✓ 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                 NACK_HOST 
                 Acknow. 
                 0x0404 
                   
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       5. Utility Structures 
     5.1 Structure POSITION 
       [0054]    POSITION defines a geographic position. 
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Latitude 
                 LATITUDE 
                 4 
                   
               
               
                   
                 Longitude 
                 LONGITUDE 
                 4 
               
               
                   
                 TOTAL 
                   
                 8 
               
               
                   
                   
               
             
          
         
       
     
       5.2 Structure CORNER 
       [0055]    CORNER defines a corner of a polygon geofence. 
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Sequence Number 
                 Byte 
                 1 
                 The number of the corner 
               
               
                   
                   
                   
                 in clockwise sequence. 
               
               
                 Position 
                 POSITION 
                 8 
                 The geographic position of 
               
               
                   
                   
                   
                 the corner. 
               
               
                 TOTAL 
                   
                 9 
               
               
                   
               
             
          
         
       
     
       5.3 Structure LOCATE 
       [0056]    LOCATE defines complete information about the device location in a moment in time. 
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Position 
                 POSITION 
                 8 
                 Geographic position of the 
               
               
                   
                   
                   
                 device. 
               
               
                 Fix Time 
                 DATETIME 
                 6 
                 Byte array [YMDHMS] 
               
               
                 Fix Type 
                 Byte 
                 1 
                 GPS Fix Type 
               
               
                 Speed 
                 SPEED 
                 2 
                 Speed gradient value 
               
               
                 Bearing 
                 BEARING 
                 2 
                 Bearing gradient value 
               
               
                 Linear Motion 
                 DISTANCE 
                 2 
                 Linear distance gradient 
               
               
                   
                   
                   
                 value 
               
               
                 Altitude 
                 ALTITUDE 
                 2 
                 Altitude gradient value 
               
               
                 TOTAL 
                   
                 22 
               
               
                   
               
             
          
         
       
     
       6. Transport Envelope Structures 
       [0057]    Transport Envelopes contain transport-specific information necessary to ensure reliable deliver of information between host and mobile applications. Each transport has a specific transport envelope that all request and response transaction structures are encapsulated within. 
       6.1 Structure UDP_ENVELOPE 
       [0058]    The UDP Transport Envelope is use to encase all UDP transport request and response structures. 
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Checksum 
                 CRC32 
                 4 
                 Checksum of the 
               
               
                   
                   
                   
                 request/response structure 
               
               
                   
                   
                   
                 using the CRC-32 
               
               
                   
                   
                   
                 algorithm. 
               
               
                 SeqNo 
                 Byte 
                 1 
                 Sequence Number. 
               
               
                   
                   
                   
                 Increment with each NEW 
               
               
                   
                   
                   
                 transmission. No carry. 
               
               
                   
                   
                   
                 Use same SeqNo for 
               
               
                   
                   
                   
                 retransmissions. 
               
               
                 Payload Size 
                 Unsigned Short 
                 2 
                 SizeOf(Payload) 
               
               
                 Payload 
                 Array of Byte 
                 N 
                 Contains the request or 
               
               
                   
                   
                   
                 response structure being 
               
               
                   
                   
                   
                 transported. 
               
               
                 TOTAL 
                   
                 N + 8 
               
               
                   
               
             
          
         
       
     
       6.2 Structure RHTTP_ENVELOPE 
       [0059]    The Reverse HTTP Transport Envelope is use to encase all Reverse HTTP transport request and response structures. 
       6.2.1 Structure RHTTP_ENVELOPE 
       [0060]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Timeout 
                 Unsigned Short 
                 2 
                 The number of seconds the 
               
               
                   
                   
                   
                 client will maintain the 
               
               
                   
                   
                   
                 open HTTP request waiting 
               
               
                   
                   
                   
                 for a response from the 
               
               
                   
                   
                   
                 host. 
               
               
                 Checksum 
                 CRC32 
                 4 
                 Checksum of the 
               
               
                   
                   
                   
                 request/response structure 
               
               
                   
                   
                   
                 using the CRC-32 
               
               
                   
                   
                   
                 algorithm. 
               
               
                 Payload Size 
                 Unsigned Short 
                 2 
                 SizeOf(Payload) 
               
               
                 Payload 
                 Array of Byte 
                 N 
                 Contains the request or 
               
               
                   
                   
                   
                 response structure being 
               
               
                   
                   
                   
                 transported. 
               
               
                 TOTAL 
                   
                 N + 8 
               
               
                   
               
             
          
         
       
     
       6.3 Structure DHTTP_ENVELOPE 
       [0061]    The Direct HTTP Transport Envelope is use to encase all Direct HTTP transport request and response structures. 
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Checksum 
                 CRC32 
                 4 
                 Checksum of the 
               
               
                   
                   
                   
                 request/response structure 
               
               
                   
                   
                   
                 using the CRC-32 
               
               
                   
                   
                   
                 algorithm. 
               
               
                 Payload Size 
                 Unsigned Short 
                 2 
                 SizeOf(Payload) 
               
               
                 Payload 
                 Array of Byte 
                 N 
                 Contains the request or 
               
               
                   
                   
                   
                 response structure being 
               
               
                   
                   
                   
                 transported. 
               
               
                 TOTAL 
                   
                 N + 6 
               
               
                   
               
             
          
         
       
     
       6.4 Structure TCP_ENVELOPE 
       [0062]    The TCP Transport Envelope is use to encase all TCP transport request and response structures. 
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Checksum 
                 CRC32 
                 4 
                 Checksum of the 
               
               
                   
                   
                   
                 request/response structure 
               
               
                   
                   
                   
                 using the CRC-32 
               
               
                   
                   
                   
                 algorithm. 
               
               
                 Payload Size 
                 Unsigned Short 
                 2 
                 SizeOf(Payload) 
               
               
                 Payload 
                 Array of byte 
                 N 
                 Contains the request or 
               
               
                   
                   
                   
                 response structure being 
               
               
                   
                   
                   
                 transported. 
               
               
                 TOTAL 
                   
                 N + 6 
               
               
                   
               
             
          
         
       
     
       6.5 Structure SMS_ENVELOPE 
       [0063]    The SMS Transport Envelope is use to encase all SMS transport request and response structures. 
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Checksum 
                 CRC32 
                 4 
                 Checksum of the 
               
               
                   
                   
                   
                 request/response structure 
               
               
                   
                   
                   
                 using the CRC-32 
               
               
                   
                   
                   
                 algorithm. 
               
               
                 Payload Size 
                 Unsigned Short 
                 2 
                 SizeOf(Payload) 
               
               
                 Payload 
                 Array of Byte 
                 N 
                 Contains the request or 
               
               
                   
                   
                   
                 response structure being 
               
               
                   
                   
                   
                 transported. 
               
               
                 TOTAL 
                   
                 N + 8 
               
               
                   
               
             
          
         
       
     
       7. GET Request Structures 
       [0064]    GET request structures can be used to initiate both host-to-mobile and mobile-to-host application-layer transactions. These requests contain a request for data, which is typically acknowledged by a corresponding PUT response structure containing the requested data. 
       7.1 Structure GET_DEVICE_ID 
       [0065]    GET_DEVICE_ID is used by the device during first time initialization to obtain a unique device identifier from the GTX host platform. This unique device identifier is the primary method by which the device data is organized within the GTX platform. Most subsequent requests require a valid device identified as a structure member. 
       7.1.1 Protocol Usage 
       [0066]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       7.1.2 Request Orientation 
       [0067]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       7.1.3 Structure Definition 
       [0068]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device SN 
                 Array[1 . . . 
                 15 
                 Contains a string 
               
               
                   
                 15] of byte 
                   
                 representation of device 
               
               
                   
                   
                   
                 IMEI (GSM) or MEID 
               
               
                   
                   
                   
                 (CDMA). If the IMEI or 
               
               
                   
                   
                   
                 ESN can not be obtained 
               
               
                   
                   
                   
                 from the device, it is 
               
               
                   
                   
                   
                 acceptable to submit the 
               
               
                   
                   
                   
                 telephone number. This 
               
               
                   
                   
                   
                 field is padded with nulls. 
               
               
                   
                   
                   
                 (0x00). 
               
               
                 Firmware Version 
                 Float 
                 4 
                 Contains the firmware 
               
               
                   
                   
                   
                 revision of the device 
               
               
                   
                   
                   
                 expressed as a major 
               
               
                   
                   
                   
                 version integer minor 
               
               
                   
                   
                   
                 version fraction. 
               
               
                 Device Type 
                 Byte 
                 1 
                 Contains the device type 
               
               
                   
                   
                   
                 constant. 
               
               
                 TOTAL 
                   
                 22 
               
               
                   
               
             
          
         
       
     
       7.1.4 Expected Response 
       [0069]    A properly formatted GET_DEVICE_ID request structure will be responded to from the host with a PUT_DEVICE_ID response structure. 
       7.2 Structure GET_CURRENT_LOCATION 
       [0070]    GET_CURRENT_LOCATION is used by the host to request the most recent location coordinates from the mobile. 
       7.2.1 Protocol Usage 
       [0071]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       7.2.2 Request Orientation 
       [0072]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       7.2.3 Structure Definition 
       [0073]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 TOTAL 
                   
                 2 
               
               
                   
                   
               
             
          
         
       
     
       7.2.4 Expected Response 
       [0074]    A properly formatted GET_CURRENT_LOCATION request structure will be responded to from the mobile with a PUT_CURRENT_LOCATION response structure. 
       7.3 Structure GET_BATTERY_STATUS 
       [0075]    GET_BATTERY_STATUS is used by the host to request the current battery condition from the mobile. 
       7.3.1 Protocol Usage 
       [0076]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       7.3.2 Request Orientation 
       [0077]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       7.3.3 Structure Definition 
       [0078]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 TOTAL 
                   
                 2 
               
               
                   
                   
               
             
          
         
       
     
       7.3.4 Expected Response 
       [0079]    A properly formatted GET_BATTERY_STATUS request structure will be responded to from the mobile with a PUT_BATTERY_STATUS response structure. 
         [0080]    7.4 Structure GET_RSSI 
         [0081]    GET_RSSI is used by the host to request the current radio signal strength condition from the mobile. 
         [0082]    The mobile actually replies with and index value from 0 to 255 that hashes the actual measured signal quality. 
         [0083]    The host calculates the actual signal quality value by referencing in a table containing domain parameters for this device type. The server stores the BASE value, the INCREMENT, an override value for transmitting the signal quality is UNKNOWN, and UNIT of measure field used for formatting the value for display.
       If the server received value is equal to UNKNOWN, an undefined or unknown signal quality is calculated, otherwise the server calculates the signal quality value for by multiplying the received index by INCREMENT and adding the product to BASE.       
 
       7.4.1 Protocol Usage 
       [0085]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       7.4.2 Request Orientation 
       [0086]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       7.4.3 Structure Definition 
       [0087]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 TOTAL 
                   
                 2 
               
               
                   
                   
               
             
          
         
       
     
       7.4.4 Expected Response 
       [0088]    A properly formatted GET_RSSI request structure will be responded to from the mobile with a PUT_RSSI response structure. 
       7.5 Structure GET_GPS_STATUS 
       [0089]    GET_GPS_STATUS is used by the host to request the current condition of the GPS receiver from the mobile. 
       7.5.1 Protocol Usage 
       [0090]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       7.5.2 Request Orientation 
       [0091]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       7.5.3 Structure Definition 
       [0092]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 TOTAL 
                   
                 2 
               
               
                   
                   
               
             
          
         
       
     
       7.5.4 Expected Response 
       [0093]    A properly formatted GET_GPS_STATUS request structure will be responded to from the mobile with a PUT_GPS_STATUS response structure. 
       7.6 Structure GET_GEOFENCE_HANDLE 
       [0094]    GET_GEOFENCE_HANDLE is used by the host to request the handle for the next available geofence parameters storage area. 
       7.6.1 Protocol Usage 
       [0095]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       7.6.2 Request Orientation 
       [0096]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       7.6.3 Structure Definition 
       [0097]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 Type 
                 Byte 
                 1 
                 Geofence type 
               
               
                   
                 TOTAL 
                   
                 3 
               
               
                   
                   
               
             
          
         
       
     
       7.6.4 Expected Response 
       [0098]    The device must respond with a PUT_GEOFENCE_HANDLE transaction containing the handle to the available storage location, or a NACK if storage is full or the geofence type is unsupported. 
       7.7 Structure GET_GEOFENCES 
       [0099]    GET_GEOFENCES is used by the host to request an iteration of the geofence parameter data currently stored on the device. 
       7.7.1 Protocol Usage 
       [0100]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       7.7.2 Request Orientation 
       [0101]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       7.7.3 Structure Definition 
       [0102]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 TOTAL 
                   
                 2 
               
               
                   
                   
               
             
          
         
       
     
       7.7.4 Expected Response 
       [0103]    The device must respond iteratively with one PUT_GEOFENCE message for each set of geofence data currently stored. The device should NACK if not geofences are stored. 
       7.8 Structure GET_CUSTOM_PARAM 
       [0104]    GET_CUSTOM_PARAM is used to query a custom parameter value, such as a carrier-specific connection parameter. The parameter name to query is specified in a variable length field. Up to 255 characters may be sent using this structure, however the response will be formatted as a string in NAME=VALUE format up to 255 bytes in length. 
       7.8.1 Protocol Usage 
       [0105]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       7.8.2 Request Orientation 
       [0106]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       7.8.3 Structure Definition 
       [0107]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 BufferLen 
                 Byte 
                 1 
                 SizeOf(Buffer) 
               
               
                 Buffer 
                 Array[1 . . . BufferLen] of 
                 N 
                 NAME part of 
               
               
                   
                 Byte 
                   
                 NAME = VALUE 
               
               
                   
                   
                   
                 parameter format. 
               
               
                 TOTAL 
                   
                 N + 3 
               
               
                   
               
             
          
         
       
     
       7.8.4 Expected Response 
       [0108]    A properly formatted GET_CUSTOM_PARAM should be acknowledged with a PUT_CUSTOM_PARAM structure containing the response in NAME=VALUE format. 
       7.9 Structure GET_DIAGNOSTIC 
       [0109]    GET_DIAGNOSTIC is used to make a one-time request for a complete diagnostic payload. Use SET_DIAGNOSTIC_INTERVAL to establish periodic reporting of the diagnostics by the device. 
       7.9.1 Protocol Usage 
       [0110]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       7.9.2 Request Orientation 
       [0111]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       7.9.3 Structure Definition 
       [0112]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 TOTAL 
                   
                 2 
               
               
                   
                   
               
             
          
         
       
     
       7.9.4 Expected Response 
       [0113]    A properly formatted GET_DIAGNOSTIC should be acknowledged with a PUT_DIAGNOSTIC structure. 
       7.10 Structure GET_SYSTEMTIME 
       [0114]    GET_SYSTEMTIME is used to request the current UTC date and time at the host. 
       7.10.1 Protocol Usage 
       [0115]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       7.10.2 Request Orientation 
       [0116]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       7.10.3 Structure Definition 
       [0117]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 TOTAL 
                   
                 2 
               
               
                   
                   
               
             
          
         
       
     
       7.10.4 Expected Response 
       [0118]    A properly formatted GET_SYSTEMTIME should be acknowledged with a PUT_SYSTEMTIME structure. 
       8. SET Request Structures 
       [0119]    SET request structures are used to initiate both host-to-mobile and mobile-to-host application-layer transactions. These structures contain a command to alter the system running state or modify an internal parameters or values. SET requests are typically confirmed with a generic acknowledgement. 
       8.1 Structure SET_REPORTING_INTERVAL 
       [0120]    SET_REPORTING_INTERVAL is used by the host to set the autonomous location report interval. When the reporting interval is set to a non-zero value, the mobile report automatically transmits asynchronous PUT_LOCATION structures according to the set interval. 
       8.1.1 Protocol Usage 
       [0121]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.1.2 Request Orientation 
       [0122]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.1.3 Structure Definition 
       [0123]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Min Interval 
                 Unsigned Short 
                 2 
                 Minimum reporting 
               
               
                   
                   
                   
                 interval in seconds. Set 
               
               
                   
                   
                   
                 to Zero to turn off 
               
               
                   
                   
                   
                 autonomous reporting. 
               
               
                   
                   
                   
                 Reports will be sent 
               
               
                   
                   
                   
                 NOT MORE often then 
               
               
                   
                   
                   
                 this, regardless of the 
               
               
                   
                   
                   
                 distance trigger. 
               
               
                 Max Interval 
                 Unsigned Short 
                 2 
                 Maximum reporting 
               
               
                   
                   
                   
                 interval in seconds. Set 
               
               
                   
                   
                   
                 to Zero to turn off 
               
               
                   
                   
                   
                 autonomous reporting. 
               
               
                   
                   
                   
                 Reports will be sent AT 
               
               
                   
                   
                   
                 LEAST this often, if the 
               
               
                   
                   
                   
                 distance trigger is not 
               
               
                   
                   
                   
                 met. 
               
               
                 Linear Distance 
                 DISTANCE 
                 2 
                 Distance reporting 
               
               
                 Trigger 
                   
                   
                 trigger gradient. 
               
               
                   
                   
                   
                 Reports will be sent 
               
               
                   
                   
                   
                 when this accumulated 
               
               
                   
                   
                   
                 distance is traveled. 
               
               
                 TOTAL 
                   
                 8 
               
               
                   
               
             
          
         
       
     
       8.1.4 Expected Response 
       [0124]    A properly formatted SET_REPORTING_INTERVAL should be acknowledged with a ACK_MOBILE structure with the Acknowledgement field set to SET_REPORTING_INTERVAL. 
       8.2 Structure SET_GPS_POWERSTATE 
       [0125]    SET_GPS_POWERSTATE is used by the host to set the power state of the GPS receiver. 
       8.2.1 Protocol Usage 
       [0126]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.2.2 Request Orientation 
       [0127]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.2.3 Structure Definition 
       [0128]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 New Power 
                 Byte 
                 1 
                 One of the GPS Power State 
               
               
                 State 
                   
                   
                 Constants. 
               
               
                 Wakeup 
                 DATETIME 
                 6 
                 If the power state is being set to 
               
               
                   
                   
                   
                 GPS_POWERDOWNUNTIL, 
               
               
                   
                   
                   
                 this field specifies that date 
               
               
                   
                   
                   
                 and time to power back up. 
               
               
                 TOTAL 
                   
                 9 
               
               
                   
               
             
          
         
       
     
       8.2.4 Expected Response 
       [0129]    A properly formatted SET_GPS_POWERSTATE should be acknowledged with a ACK_MOBILE structure with the Acknowledgement field set to SET_GPS_POWERSTATE. 
       8.3 Structure SET_BUFFERING_INTERVAL 
       [0130]    SET_BUFFERING_INTERVAL is used by the host to set the local location buffering interval. The buffering interval controls how frequently location records will be stored in the device memory in the event of a temporary out-of-coverage condition. The buffer is implemented as a circular queue. When the allocated storage for the buffer is used, new entries overwrite the oldest entry in the buffer. 
       8.3.1 Protocol Usage 
       [0131]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.3.2 Request Orientation 
       [0132]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.3.3 Structure Definition 
       [0133]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Min Interval 
                 Unsigned Short 
                 2 
                 Minimum reporting 
               
               
                   
                   
                   
                 interval in seconds. Set 
               
               
                   
                   
                   
                 to Zero to turn off 
               
               
                   
                   
                   
                 autonomous reporting. 
               
               
                   
                   
                   
                 Locates will be buffered 
               
               
                   
                   
                   
                 NOT MORE often then 
               
               
                   
                   
                   
                 this, regardless of the 
               
               
                   
                   
                   
                 distance trigger. 
               
               
                 Max Interval 
                 Unsigned Short 
                 2 
                 Maximum reporting 
               
               
                   
                   
                   
                 interval in seconds. Set 
               
               
                   
                   
                   
                 to Zero to turn off 
               
               
                   
                   
                   
                 autonomous reporting. 
               
               
                   
                   
                   
                 Locates will be buffered 
               
               
                   
                   
                   
                 AT LEAST this often, if 
               
               
                   
                   
                   
                 the distance trigger is 
               
               
                   
                   
                   
                 not met. 
               
               
                 Linear Distance 
                 DISTANCE 
                 2 
                 Distance reporting 
               
               
                 Trigger 
                   
                   
                 trigger gradient. 
               
               
                   
                   
                   
                 Locates will be buffered 
               
               
                   
                   
                   
                 when this accumulated 
               
               
                   
                   
                   
                 distance is traveled. 
               
               
                 TOTAL 
                   
                 8 
               
               
                   
               
             
          
         
       
     
       8.3.4 Expected Response 
       [0134]    A properly formatted SET_BUFFERING_INTERVAL should be acknowledged with an ACK_MOBILE structure with the Acknowledgement field set to SET_BUFFERING_INTERVAL. 
       8.4 Structure SET_START_BUFFER 
       [0135]    SET_START_BUFFER starts a dump of the current location buffer from the mobile to the host. When the mobile receives a request to start sending buffered data, it will begin traversing the circular queue starting with the oldest record, sending each record to the host using a PUT_LOCATION structure. Reporting stops when a SET_END_BUFFER request is received, or when the newest buffered data has been transmitted. 
       8.4.1 Protocol Usage 
       [0136]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.4.2 Request Orientation 
       [0137]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.4.3 Structure Definition 
       [0138]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 TOTAL 
                   
                 3 
               
               
                   
                   
               
             
          
         
       
     
       8.4.4 Expected Response 
       [0139]    A properly formatted SET_START_BUFFER structure should be acknowledged with a PUT_LOCATION structure containing the oldest record in the buffer. 
       8.5 Structure SET_END_BUFFER 
       [0140]    SET_END_BUFFER stops a dump of the location buffer from the mobile. 
       8.5.1 Protocol Usage 
       [0141]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.5.2 Request Orientation 
       [0142]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.5.3 Structure Definition 
       [0143]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 TOTAL 
                   
                 2 
               
               
                   
                   
               
             
          
         
       
     
       8.5.4 Expected Response 
       [0144]    A properly formatted SET_END_BUFFER should be acknowledged with a ACK_MOBILE structure with the Acknowledgement field set to SET_END_BUFFER. 
       8.6 Structure SET_HEARTBEAT_PARAMETERS 
       [0145]    SET_HEARTBEAT_PARAMETERS is used to set the starting parameters for the HTTP session timeout for the Reverse HTTP Transport. 
       8.6.1 Protocol Usage 
       [0146]      
         [0000]    
       
         
               
               
               
               
               
             
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
                   
                   
                   
               
               
                   
                   
               
             
          
         
       
     
       8.6.2 Request Orientation 
       [0147]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.6.3 Structure Definition 
       [0148]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Starting Interval 
                 Unsigned Short 
                 2 
                 Starting interval in 
               
               
                   
                   
                   
                 seconds. 
               
               
                 Step Interval 
                 Unsigned Short 
                 2 
                 The amount to add or 
               
               
                   
                   
                   
                 subtract from the 
               
               
                   
                   
                   
                 timeout after a 
               
               
                   
                   
                   
                 successful session or a 
               
               
                   
                   
                   
                 timeout. 
               
               
                 Interval Limit 
                 Unsigned Short 
                 2 
                 The longest timeout 
               
               
                   
                   
                   
                 interval the system will 
               
               
                   
                   
                   
                 seek to, in seconds. 
               
               
                 TOTAL 
                   
                 8 
               
               
                   
               
             
          
         
       
     
       8.6.4 Expected Response 
       [0149]    A properly formatted SET_HEARTBEAT_INTERVAL should be acknowledged with an ACK_MOBILE structure with the Acknowledgement field set to SET_HEARTBEAT_INTERVAL. 
         [0000]    8.7 Structure SET_INTERACTIVITY_MODE SET_INTERACTIVITY_MODE is used to set the toggle between High Interactivity and Low Interactive Mode for Reverse HTTP Transport devices. 
         [0150]    When this command is sent via SMS, it still applies to the devices Reverse HTTP Transport mode. In this case, it is used as an out-of-band signal to switch to High Interactivity mode and force immediate Reverse HTTP session establishment. 
       8.7.1 Protocol Usage 
       [0151]      
         [0000]    
       
         
               
               
               
               
               
             
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
                   
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.7.2 Request Orientation 
       [0152]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.7.3 Structure Definition 
       [0153]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
               
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Interactivity Mode 
                 Byte 
                 1 
                 One of the Interactivity 
               
               
                   
                   
                   
                 Mode constants. 
               
               
                 Polling Rate 
                 Unsigned Short 
                 2 
                 For Low Interactivity 
               
               
                   
                   
                   
                 mode, this sets the 
               
               
                   
                   
                   
                 polling rate in seconds. 
               
             
          
           
               
                 TOTAL 
                   
                 8 
               
               
                   
               
             
          
         
       
     
       8.7.4 Expected Response 
       [0154]    A properly formatted SET_INTERACTIVITY_MODE should be acknowledged with an ACK_MOBILE structure with the Acknowledgement field set to SET_INTERACTIVITY_MODE. 
       8.8 Structure SET_CIRCULAR_GEOFENCE 
       [0155]    SET_CIRCULAR_GEOFENCE is used to create a circular area which the device to generate alerts if the area in entered or exited. 
       8.8.1 Protocol Usage 
       [0156]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.8.2 Request Orientation 
       [0157]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.8.3 Structure Definition 
       [0158]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Handle 
                 Byte 
                 1 
               
               
                 Center 
                 POSITION 
                 8 
               
               
                 Radius 
                 DISTANCE 
                 2 
                 Distance gradient value 
               
               
                 Type 
                 Byte 
                 1 
                 GFT_INCLUSION 
               
               
                   
                   
                   
                 GFT_EXCLUSION 
               
               
                   
                   
                   
                 GFT_BOTH 
               
               
                 TOTAL 
                   
                 16 
               
               
                   
               
             
          
         
       
     
       8.8.4 Expected Response 
       [0159]    ACK is the device accepts the geofence, NACK if the handle is invalid or the geofence type is unsupported. 
       8.9 Structure SET_POLYGON_GEOFENCE 
       [0160]    SET_CIRCULAR_GEOFENCE is used to create a rectangular area which the device will generate alerts if the area in entered or exited. 
       8.9.1 Protocol Usage 
       [0161]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.9.2 Request Orientation 
       [0162]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.9.3 Structure Definition 
       [0163]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Handle 
                 Byte 
                 1 
               
               
                 Corner Count 
                 Byte 
                 1 
               
               
                 Corners 
                 Array[1 . . . Corner 
                 N * 8 
               
               
                   
                 Count] of CORNER 
               
               
                 Type 
                 Byte 
                 1 
                 GFT_INCLUSION 
               
               
                   
                   
                   
                 GFT_EXCLUSION 
               
               
                   
                   
                   
                 GFT_BOTH 
               
               
                 TOTAL 
                   
                 N * 8 + 5 
               
               
                   
               
             
          
         
       
     
       8.9.4 Expected Response 
       [0164]    ACK is the device accepts the geofence, NACK if the handle is invalid or the geofence type is unsupported. 
       8.10 Structure SET_VELOCITY_GEOFENCE 
       [0165]    SET_CIRCULAR_GEOFENCE is used to create a threshold speed which the device will generate alerts if the threshold is exceeded. 
       8.10.1 Protocol Usage 
       [0166]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.10.2 Request Orientation 
       [0167]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.10.3 Structure Definition 
       [0168]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Handle 
                 Byte 
                 1 
               
               
                 Speed 
                 SPEED 
                 2 
                 Speed gradient value 
               
               
                 TOTAL 
                   
                 11 
               
               
                   
               
             
          
         
       
     
       8.10.4 Expected Response 
       [0169]    ACK is the device accepts the geofence, NACK if the handle is invalid or the geofence type is unsupported. 
       8.11 Structure SET_STATIONARY_GEOFENCE 
       [0170]    SET_STATIONARY_GEOFENCE is used to create a threshold period of time which the device will generate alerts if it is stationary for a period of time greater than the threshold. 
       8.11.1 Protocol Usage 
       [0171]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.11.2 Request Orientation 
       [0172]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.11.3 Structure Definition 
       [0173]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Handle 
                 Byte 
                 1 
               
               
                 Trigger Speed 
                 SPEED 
                 2 
                 Speed gradient value 
               
               
                 Time at Rest 
                 DATETIME 
                 6 
               
               
                 TOTAL 
                   
                 13 
               
               
                   
               
             
          
         
       
     
       8.11.4 Expected Response 
       [0174]    ACK is the device accepts the geofence, NACK if the handle is invalid or the geofence type is unsupported. 
       8.12 Structure SET_DELETE_GEOFENCE 
       [0175]    SET_DELETE_GEOFENCE is used to delete the parameters associated with a particular geofence and suppress alerting based on those parameters. 
       8.12.1 Protocol Usage 
       [0176]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.12.2 Request Orientation 
       [0177]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.12.3 Structure Definition 
       [0178]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 Handle 
                 Byte 
                 1 
               
               
                   
                 TOTAL 
                   
                 3 
               
               
                   
                   
               
             
          
         
       
     
       8.12.4 Expected Response 
       [0179]    ACK is the geofence could be deleted, NACK if the handle is invalid. 
       8.13 Structure SET_CUSTOM_PARAM 
       [0180]    SET_CUSTOM_PARAM is used to set a custom parameter, such as a carrier-specific connection parameter. The parameter is specified in a variable length field in NAME=VALUE format. Up to 255 characters may be sent using this structure. 
       8.13.1 Protocol Usage 
       [0181]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.13.2 Request Orientation 
       [0182]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.13.3 Structure Definition 
       [0183]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 BufferLen 
                 Byte 
                 1 
                 SizeOf(Buffer) 
               
               
                 Buffer 
                 Array[1 . . . BufferLen] of 
                 N 
                 Parameter in 
               
               
                   
                 Byte 
                   
                 NAME = VALUE 
               
               
                   
                   
                   
                 format. 
               
               
                 TOTAL 
                   
                 N + 3 
               
               
                   
               
             
          
         
       
     
       8.13.4 Expected Response 
       [0184]    A properly formatted SET_CUSTOM_PARAM should be acknowledged with an ACK_MOBILE structure with the Acknowledgement field set to SET_CUSTOM_PARAM. 
       8.14 Structure SET_REPORTING_GRANULARITY 
       [0185]    SET_REPORTING_GRANULARITY is used to set the threshold distance between internal location samples. When a reporting granularity value is set, the device will not accumulate inter-sample distances below the set distance. This is designed to dampen phantom location “drift” generated by a stationary device. 
       8.14.1 Protocol Usage 
       [0186]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.14.2 Request Orientation 
       [0187]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.14.3 Structure Definition 
       [0188]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Distance 
                 DISTANCE 
                 2 
                 Distance gradient value 
               
               
                 TOTAL 
                   
                 4 
               
               
                   
               
             
          
         
       
     
       8.14.4 Expected Response 
       [0189]    A properly formatted SET_REPORTING_GRANULARITY should be acknowledged with a ACK_MOBILE structure with the Acknowledgement field set to SET_REPORTING_GRANULARITY. 
       8.15 Structure SET MOVEMENT_GEOFENCE_MOVEMENT_GEOFENCE 
       [0190]    SET_MOVEMENT_GEOFENCE is used to create a threshold distance which the device to generate alerts if that distance is traveled. This is different than setting reporting based on distance because when a movement geofence is set, the device will report PUT_GEOFENCE_VIOLATION when the distance has been traveled. 
       8.15.1 Protocol Usage 
       [0191]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.15.2 Request Orientation 
       [0192]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.15.3 Structure Definition 
       [0193]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Handle 
                 Byte 
                 1 
               
               
                 Trigger Distance 
                 DISTANCE 
                 2 
                 Distance gradient value 
               
               
                 TOTAL 
                   
                 11 
               
               
                   
               
             
          
         
       
     
       8.15.4 Expected Response 
       [0194]    ACK is the device accepts the geofence, NACK if the handle is invalid or the geofence type is unsupported. 
       8.16 Structure SET_DIAGNOSTIC_INTERVAL 
       [0195]    SET_DIAGNOSTIC_INTERVAL is used by the host to set the request periodic diagnostic payload reporting. When the reporting interval is set to a non-zero value, the mobile automatically transmits asynchronous PUT_DIAGNOSTIC structures according to the set interval. 
       8.16.1 Protocol Usage 
       [0196]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.16.2 Request Orientation 
       [0197]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.16.3 Structure Definition 
       [0198]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Min Interval 
                 Unsigned Short 
                 2 
                 Minimum reporting 
               
               
                   
                   
                   
                 interval in seconds. Set 
               
               
                   
                   
                   
                 to Zero to turn off 
               
               
                   
                   
                   
                 autonomous reporting. 
               
               
                   
                   
                   
                 Reports will be sent 
               
               
                   
                   
                   
                 NOT MORE often then 
               
               
                   
                   
                   
                 this, regardless of the 
               
               
                   
                   
                   
                 distance trigger. 
               
               
                 Max Interval 
                 Unsigned Short 
                 2 
                 Maximum reporting 
               
               
                   
                   
                   
                 interval in seconds. Set 
               
               
                   
                   
                   
                 to Zero to turn off 
               
               
                   
                   
                   
                 autonomous reporting. 
               
               
                   
                   
                   
                 Reports will be sent AT 
               
               
                   
                   
                   
                 LEAST this often, if the 
               
               
                   
                   
                   
                 distance trigger is not 
               
               
                   
                   
                   
                 met. 
               
               
                 Linear Distance 
                 DISTANCE 
                 2 
                 Distance reporting 
               
               
                 Trigger 
                   
                   
                 trigger gradient. 
               
               
                   
                   
                   
                 Reports will be sent 
               
               
                   
                   
                   
                 when this accumulated 
               
               
                   
                   
                   
                 distance is traveled. 
               
               
                 TOTAL 
                   
                 8 
               
               
                   
               
             
          
         
       
     
       8.16.4 Expected Response 
       [0199]    A properly formatted SET_DIAGNOSTIC_INTERVAL should be acknowledged with a ACK_MOBILE structure with the Acknowledgement field set to SET_DIAGNOSTIC_INTERVAL. 
       8.17 Structure SET_DEBUG_LEVEL 
       [0200]    SET_DEBUG_LEVEL is used by the host to set the debug reporting level for the device. Debug level  0  turns off reporting. Other levels are firmware defined. Protocol Usage 
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       8.17.1 Request Orientation 
       [0201]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       8.17.2 Structure Definition 
       [0202]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 Debug Level 
                 Byte 
                 1 
               
               
                   
                 TOTAL 
                   
                 3 
               
               
                   
                   
               
             
          
         
       
     
       8.17.3 Expected Response 
       [0203]    A properly formatted SET_DEBUG_LEVEL should be acknowledged with a ACK_MOBILE structure with the Acknowledgement field set to SET_DEBUG_LEVEL. 
       9. PUT Response Structures 
       [0204]    PUT Request structures are used to acknowledge host-to-mobile and mobile-to-host application-layer transactions. These structures typically contain a response to a GET request. 
         [0205]    PUT requests may also be used to asynchronously deliver event notifications. When delivering an asynchronous notification, they may be confirmed with a generic acknowledgement. 
       9.1 Structure PUT_CURRENT_LOCATION 
       [0206]    PUT_CURRENT_LOCATION is used to respond to and acknowledge a GET_CURRENT_LOCATION request. 
       9.1.1 Protocol Usage 
       [0207]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.1.2 Orientation 
       [0208]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       9.1.3 Structure Definition 
       [0209]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer 
                 4 
                 Device ID returned in the 
               
               
                   
                   
                   
                 PUT_DEVICE_ID 
               
               
                   
                   
                   
                 response. 
               
               
                 Location 
                 LOCATE 
                 22 
               
               
                 TOTAL 
                   
                 28 
               
               
                   
               
             
          
         
       
     
       9.2 Structure PUT_BATTERY_STATUS 
       [0210]    PUT_BATTERY_STATUS is used to respond to and acknowledge a GET_BATTERY_STATUS request. 
       9.2.1 Protocol Usage 
       [0211]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.2.2 Orientation 
       [0212]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       9.2.3 Structure Definition 
       [0213]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer 
                 4 
                 Device ID returned in the 
               
               
                   
                   
                   
                 PUT_DEVICE_ID 
               
               
                   
                   
                   
                 response. 
               
               
                 Battery Level 
                 BATLEVEL 
                 4 
               
               
                 TOTAL 
                   
                 10 
               
               
                   
               
             
          
         
       
     
       9.3 Structure PUT_RSSI 
       [0214]    PUT_RSSI is used to respond to and acknowledge a GET_RSSI request. 
         [0215]    The mobile actually replies with and index value from 0 to 255 that hashes the actual measured signal quality. 
         [0216]    The host calculates the actual signal quality value by referencing in a table containing domain parameters for this device type. The server stores the BASE value, the INCREMENT, an override value for transmitting the signal quality is UNKNOWN, and UNIT of measure field used for formatting the value for display. 
         [0217]    If the server receives value is equal to UNKNOWN, an undefined or unknown signal quality is calculated, otherwise the server calculates the signal quality value for by multiplying the received index by INCREMENT and adding the product to BASE. 
       9.3.1 Protocol Usage 
       [0218]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.3.2 Orientation 
       [0219]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       9.3.3 Structure Definition 
       [0220]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer 
                 4 
                 Device ID returned in the 
               
               
                   
                   
                   
                 PUT_DEVICE_ID 
               
               
                   
                   
                   
                 response. 
               
               
                 Radio Signal 
                 RSSI 
                 1 
               
               
                 Strength 
                   
                   
               
               
                 TOTAL 
                   
                 7 
               
               
                   
               
             
          
         
       
     
       9.4 Structure PUT_GPS_STATUS 
       [0221]    PUT_GPS_STATUS is used to respond to and acknowledge a GET_GPS_STATUS request. 
       9.4.1 Protocol Usage 
       [0222]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.4.2 Orientation 
       [0223]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       9.4.3 Structure Definition 
       [0224]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer 
                 4 
                 Device ID returned in the 
               
               
                   
                   
                   
                 PUT_DEVICE_ID response. 
               
               
                 Fix Type 
                 Byte 
                 1 
                 One of the GPS Fix State 
               
               
                   
                   
                   
                 constants. 
               
               
                 Satellites 
                 Byte 
                 1 
                 Number of satellites in 
               
               
                   
                   
                   
                 view of the receiver. 
               
               
                 DOP 
                 Byte 
                 1 
                 Gradient; Dilution of 
               
               
                   
                   
                   
                 Precision from the GPS, if 
               
               
                   
                   
                   
                 available. 
               
               
                 VDOP 
                 Byte 
                 1 
                 Gradient; Vertical Dilution 
               
               
                   
                   
                   
                 of Precision from the GPS, 
               
               
                   
                   
                   
                 if available. 
               
               
                 HDOP 
                 Byte 
                 1 
                 Gradient; Horizontal 
               
               
                   
                   
                   
                 Dilution of Precision from 
               
               
                   
                   
                   
                 the GPS, if available. 
               
               
                 Accuracy 
                 Byte 
                 1 
                 Accuracy in meters. 255 is 
               
               
                   
                   
                   
                 used for anything greater 
               
               
                   
                   
                   
                 than 254. 
               
               
                 TOTAL 
                   
                 11 
               
               
                   
               
             
          
         
       
     
       9.5 Structure PUT_GEOFENCE_HANDLE 
       [0225]    The device responds to a GET_GEOFENCE_HANDLE message with PUT_GEOFENCE_HANDLE. After retrieving the handle, the host can set a geofence using the supplied handle. 
       9.5.1 Protocol Usage 
       [0226]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.5.2 Request Orientation 
       [0227]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       9.5.3 Structure Definition 
       [0228]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer 
                 4 
                 Device ID returned in the 
               
               
                   
                   
                   
                 PUT_DEVICE_ID 
               
               
                   
                   
                   
                 response. 
               
               
                 Handle 
                 Byte 
                 1 
               
               
                 TOTAL 
                   
                 7 
               
               
                   
               
             
          
         
       
     
       9.5.4 Expected Response 
       [0229]    The host should transmit a desired geofence message type using the supplied handle. 
       9.6 Structure PUT_GEOFENCE 
       [0230]    PUT_GEOFENSE is used by the device to transmit the parameters of a particular geofence. PUT_GEOFENCE could used in response to a require for a specific geofence&#39;s parameters, or PUT_GEOFENCE could be transmitted iteratively for each stored geofence in response to GET_GEOFENSES. 
       9.6.1 Protocol Usage 
       [0231]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.6.2 Request Orientation 
       [0232]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       9.6.3 Structure Definition 
       [0233]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer 
                 4 
               
               
                 Handle 
                 Byte 
                 1 
               
               
                 Type 
                 Byte 
                 1 
                 Geofence type 
               
               
                 Radius 
                 Unsigned Integer 
                 4 
               
               
                 Corner Count 
                 Byte 
                 1 
               
               
                 Corners 
                 Array[1 . . . Corner 
                 N * 9 
               
               
                   
                 Count] of CORNER 
                   
               
               
                 TOTAL 
                   
                 N * 9 + 13 
               
               
                   
               
             
          
         
       
     
       9.7 Structure PUT_CUSTOM_PARAM 
       [0234]    PUT_CUSTOM_PARAM is used to respond to a GET_CUSTOM_PARAM structure with the value of a custom parameter, such as a carrier-specific connection parameter. The response is formatted in a variable length field in NAME=VALUE format. Up to 255 characters may be sent using this structure. 
       9.7.1 Protocol Usage 
       [0235]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.7.2 Request Orientation 
       [0236]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       9.7.3 Structure Definition 
       [0237]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer 
                 4 
                 Device ID returned in 
               
               
                   
                   
                   
                 the PUT_DEVICE_ID 
               
               
                   
                   
                   
                 response. 
               
               
                 BufferLen 
                 Byte 
                 1 
                 SizeOf(Buffer) 
               
               
                 Buffer 
                 Array[1 . . . 
                 N 
                 Parameter in 
               
               
                   
                 BufferLen] of 
                   
                 NAME = VALUE 
               
               
                   
                 Byte 
                   
                 format. 
               
               
                 TOTAL 
                   
                 N + 7 
               
               
                   
               
             
          
         
       
     
       9.8 Structure PUT_LOCATION 
       [0238]    PUT_LOCATION is used to send an unacknowledged coordinate fix from the mobile to the host. This coordinate fix may be initiated by a request from the host to begin autonomous interval reporting, or to stream buffered location data in response to a request from the host to dump the buffer, or may be initiated by the device after a back-in-cellular-coverage condition. 
       9.8.1 Protocol Usage 
       [0239]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.8.2 Orientation 
       [0240]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       9.8.3 Structure Definition 
       [0241]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer 
                 4 
                 Device ID returned in the 
               
               
                   
                   
                   
                 PUT_DEVICE_ID 
               
               
                   
                   
                   
                 response 
               
               
                 Location 
                 LOCATE 
                 22 
               
               
                 TOTAL 
                   
                 28 
               
               
                   
               
             
          
         
       
     
       9.9 Structure PUT_GEOFENCE_VIOLATION 
       [0242]    PUT_GEOFENCE_VIOLATION is used to signal that a geofence boundary has been crossed or a threshold has been exceeded. 
       9.9.1 Protocol Usage 
       [0243]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.9.2 Orientation 
       [0244]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       9.9.3 Structure Definition 
       [0245]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer 
                 4 
                 Device ID returned in the 
               
               
                   
                   
                   
                 PUT_DEVICE_ID 
               
               
                   
                   
                   
                 response. 
               
               
                 Handle 
                 Byte 
                 1 
                 Geofence Handle 
               
               
                 Location 
                 LOCATE 
                 22 
               
               
                 TOTAL 
                   
                 29 
               
               
                   
               
             
          
         
       
     
       9.10 Structure PUT_DEVICE_ID 
       [0246]    PUT_DEVICE_ID is send by the host in response to a GET_DEVICE_ID request structure. 
       9.10.1 Protocol Usage 
       [0247]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.10.2 Request Orientation 
       [0248]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       9.10.3 Structure Definition 
       [0249]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
                   
               
               
                   
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
                   
               
             
             
               
                   
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                   
                 Device ID 
                 Unsigned Integer 
                 4 
               
               
                   
                 TOTAL 
                   
                 6 
               
               
                   
                   
               
             
          
         
       
     
       9.11 Structure PUT_LOCATION_ARRAY 
       [0250]    PUT_LOCATION_ARRAY is used to send multiple coordinate fixes from the mobile to the host. This may be initiated by a request from the host to begin to stream buffered location data in response to a request from the host to dump the buffer, or may be initiated by the device after a back-in-cellular-coverage condition. 
         [0251]    PUT_LOCATION_ARRAY should be used whenever more than one buffered locate record is being set to the host. The maximum number of locates that can be passed in the array is 255, but implementation limitations such as maximum transport payload may significantly limit this number. It is the developer&#39;s responsibility to insure that a structure small enough to be supported by the transport layer is created. 
       9.11.1 Protocol Usage 
       [0252]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.11.2 Orientation 
       [0253]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       9.11.3 Structure Definition 
       [0254]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer 
                 4 
                 Device ID 
               
               
                   
                   
                   
                 returned in the 
               
               
                   
                   
                   
                 PUT_DEVICE_ID 
               
               
                   
                   
                   
                 response 
               
               
                 Array Size 
                 Byte 
                 1 
                 Number of LOCATE 
               
               
                   
                   
                   
                 elements in the array 
               
               
                 Locations 
                 Array[1 . . . Array 
                 N * 22 
               
               
                   
                 Size] of LOCATE 
                   
               
               
                 TOTAL 
                   
                 7 + 
               
               
                   
                   
                 (N * 22) 
               
               
                   
               
             
          
         
       
     
       9.11.4 Expected Response 
       [0255]    Because of the relatively large amount of data carried in a PUT_LOCATION_ARRAY structure, it should be acknowledged with an ACK_HOST structure with the Acknowledgement field set to PUT_LOCATION_ARRAY. 
       9.12 Structure PUT_DIAGNOSTIC 
       [0256]    PUT_DIAGNOSTIC is used to respond to and acknowledge a GET_DIAGNOSTIC request and to send periodic diagnostic payloads if requested by SET_DIAGNOSTIC_INTERVAL. 
       9.12.1 Protocol Usage 
       [0257]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.12.2 Orientation 
       [0258]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       9.12.3 Structure Definition 
       [0259]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer 
                 4 
                 Device ID returned in the 
               
               
                   
                   
                   
                 PUT_DEVICE_ID 
               
               
                   
                   
                   
                 response. 
               
               
                 Location 
                 LOCATION 
                 20 
               
               
                 GPSSNR 
                 Byte 
                 1 
                 GPS Signal to noise ratio in 
               
               
                   
                   
                   
                 dB 
               
               
                 Battery Level 
                 BATLEVEL 
                 2 
               
               
                 Satellites 
                 Byte 
                 1 
                 Number of satellites in 
               
               
                   
                   
                   
                 view of the receiver. 
               
               
                 Accuracy 
                 Byte 
                 1 
                 Accuracy in meters. 255 is 
               
               
                   
                   
                   
                 used for anything greater 
               
               
                   
                   
                   
                 than 254. 
               
               
                 DOP 
                 Byte 
                 1 
                 Gradient; Dilution of 
               
               
                   
                   
                   
                 Precision from the GPS, if 
               
               
                   
                   
                   
                 available. 
               
               
                 VDOP 
                 Byte 
                 1 
                 Gradient; Vertical Dilution 
               
               
                   
                   
                   
                 of Precision from the GPS, 
               
               
                   
                   
                   
                 if available. 
               
               
                 HDOP 
                 Byte 
                 1 
                 Gradient; Horizontal 
               
               
                   
                   
                   
                 Dilution of Precision from 
               
               
                   
                   
                   
                 the GPS, if available. 
               
               
                 Network Status 
                 Byte 
                 1 
               
               
                 TOTAL 
                   
                 28 
               
               
                   
               
             
          
         
       
     
       9.13 Structure PUT_SYSTEMTIME 
       [0260]    PUT_SYSTEMTIME is used to respond to and acknowledge a GET_SYSTEMTIME request and to send the current UTC date and time at the host. 
       9.13.1 Protocol Usage 
       [0261]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.13.2 Orientation 
       [0262]      
         [0000]    
       
         
               
               
               
             
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 ✓ 
               
               
                   
                   
               
             
          
         
       
     
       9.13.3 Structure Definition 
       [0263]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 System Time 
                 DATETIME 
                 6 
                 UTC time at the host. 
               
               
                 TOTAL 
                   
                 8 
               
               
                   
               
             
          
         
       
     
       9.14 Structure PUT_DEBUG_MESSAGE 
       [0264]    PUT_DEBUG_MESSAGE is used to send debugging messages from the device to the server. This is a firmware defined implementation. 
       9.14.1 Protocol Usage 
       [0265]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
                 ✓ 
               
               
                   
               
             
          
         
       
     
       9.14.2 Orientation 
       [0266]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ✓ 
                   
               
               
                   
                   
               
             
          
         
       
     
       9.14.3 Structure Definition 
       [0267]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Debug Message  
                 Binary 
                 Var 
                 Variable length field. 
               
               
                 TOTAL 
                   
                 Var 
               
               
                   
               
             
          
         
       
     
       10. Acknowledgements 
       [0268]    Acknowledgements are generic positive and negative confirmations of requests and notifications. They are also used to carry “no operation” signaling for some transport models. 
       10.1 Structure ACK_MOBILE 
       [0269]    ACK_MOBILE is a generic acknowledgement for requests from the host that do not have a specific response structure. 
         [0270]    ACK_MOBILE is also used as a special purpose structure to open an HTTP transmission channel from the mobile to the host. The mobile will keep the HTTP session open for the period of time defined in the Timeout value in the Reverse HTTP Transport Envelope. If the host desired to send an application-layer request to the mobile, it creates a properly formatted request structure within a Reverse HTTP Transport Envelope, BINHEX encodes the entire payload, transmits the payload through the open socket, and closes the socket. 
       10.1.1 Protocol Usage 
       [0271]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 
                           
                 
                 
                           
                 
                 
                           
                 
                 
                           
                 
                 
                           
                 
               
               
                   
               
             
          
         
       
     
       10.1.2 Orientation 
       [0272]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 
                           
                 
                   
               
               
                   
                   
               
             
          
         
       
     
       10.1.3 Structure Definition 
       [0273]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Byte 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer  
                 4 
                 Device ID returned in the 
               
               
                   
                   
                   
                 PUT_DEVICE_ID 
               
               
                   
                   
                   
                 response 
               
               
                 Acknowledgement 
                 Unsigned Short 
                 2 
                 The Structure ID of the 
               
               
                   
                   
                   
                 last transmission to 
               
               
                   
                   
                   
                 acknowledge. 
               
               
                 Baggage 
                 Unsigned Short 
                 2 
                 Additional 
               
               
                   
                   
                   
                 acknowledgement 
               
               
                   
                   
                   
                 information. 
               
               
                 TOTAL 
                   
                 10 
               
               
                   
               
             
          
         
       
     
       10.2 Structure ACK_HOST 
       [0274]    ACK_HOST is a generic acknowledgement for requests from the mobile that do not have a specific response structure. 
         [0275]    ACK_HOST is also a special purpose structure used to close an HTTP transmission channel from the when the timeout period is about to expire and the host does not need to submit a command to the mobile. ACK_HOST simple tells the mobile that the data session is still active. Typically, the mobile will reestablish a new HTTP session with the host, submitting an ACK_MOBILE structure. In Reverse HTTP High Interactivity mode, this reestablishment will occur immediately, and in Reverse HTTP Low Interactivity mode, the client will wait a defined amount of time before re-polling the host for a command. 
       10.2.1 Protocol Usage 
       [0276]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                   
                 
                           
                 
                   
                   
                   
               
               
                   
               
             
          
         
       
     
       10.2.2 Orientation 
       [0277]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                   
                 
                           
                 
               
               
                   
                   
               
             
          
         
       
     
       10.2.3 Structure Definition 
       [0278]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Byte 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Short 
                 2 
                   
               
               
                 Acknowledgement 
                 Unsigned Short 
                 2 
                 The Structure ID of the 
               
               
                   
                   
                   
                 last transmission to 
               
               
                   
                   
                   
                 acknowledge. 
               
               
                 Baggage 
                 Unsigned Short 
                 2 
                 Additional 
               
               
                   
                   
                   
                 acknowledgement 
               
               
                   
                   
                   
                 information. 
               
               
                 TOTAL 
                   
                 6 
               
               
                   
               
             
          
         
       
     
       10.3 Structure NACK_MOBILE 
       [0279]    NACK_MOBILE is used to negatively acknowledge a request structure received by the mobile device. NACK should only be used if the envelope fails checksum verification or if an unsupported request is made by the host. 
       10.3.1 Protocol Usage 
       [0280]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 
                           
                 
                 
                           
                 
                 
                           
                 
                 
                           
                 
                 
                           
                 
               
               
                   
               
             
          
         
       
     
       10.3.2 Orientation 
       [0281]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 
                           
                 
                   
               
               
                   
                   
               
             
          
         
       
     
       10.3.3 Structure Definition 
       [0282]      
         [0000]    
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                   
               
             
          
           
               
                 Structure ID  
                 Unsigned Short 
                 2 
                   
               
               
                 Device ID 
                 Unsigned Integer  
                 4 
                 Device ID returned in the 
               
               
                   
                   
                   
                 PUT_DEVICE_ID 
               
               
                   
                   
                   
                 response. Do not NACK an 
               
               
                   
                   
                   
                 invalid response to 
               
               
                   
                   
                   
                 GET_DEVICE_ID. 
               
               
                   
                   
                   
                 Resend the 
               
               
                   
                   
                   
                 GET_DEVICE_ID request. 
               
               
                 Acknowledgement 
                 Unsigned Short 
                 2 
                 The Structure ID of the 
               
               
                   
                   
                   
                 transmission to that 
               
               
                   
                   
                   
                 generated the error. 
               
               
                 Baggage 
                 Unsigned Short 
                 2 
                 Additional 
               
               
                   
                   
                   
                 acknowledgement 
               
               
                   
                   
                   
                 information. 
               
               
                 Type 
                 Byte 
                 1 
                 NACK Type constant 
               
               
                 TOTAL 
                   
                 11 
               
               
                   
               
             
          
         
       
     
       10.4 Structure NACK_HOST 
       [0283]    NACK_HOST is used to negatively acknowledge a request structure received by the host. NACK_HOST should only be used if the envelope fails checksum verification or if an unsupported request is made by the mobile. 
       10.4.1 Protocol Usage 
       [0284]      
         [0000]    
       
         
               
               
               
               
               
             
           
               
                   
               
               
                 UDP 
                 Reverse HTTP 
                 Direct HTTP 
                 TCP 
                 SMS 
               
               
                   
               
             
             
               
                 
                           
                 
                 
                           
                 
                 
                           
                 
                 
                           
                 
                 
                           
                 
               
               
                   
               
             
          
         
       
     
       10.4.2 Orientation 
       [0285]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                   
                 
                           
                 
               
               
                   
                   
               
             
          
         
       
     
       10.4.3 Structure Definition 
       [0286]      
         [0000]    
       
         
               
               
               
               
             
           
               
                   
               
               
                 Member Name 
                 Data Type 
                 Bytes 
                 Comments 
               
               
                   
               
             
             
               
                 Structure ID 
                 Unsigned Integer 
                 2 
                   
               
               
                 Acknowledgement  
                 Unsigned Short 
                 2 
                 The Structure ID of the 
               
               
                   
                   
                   
                 transmission to that 
               
               
                   
                   
                   
                 generated the error. 
               
               
                 Baggage 
                 Unsigned Short 
                 2 
                 Additional 
               
               
                   
                   
                   
                 acknowledgement 
               
               
                   
                   
                   
                 information. 
               
               
                 Type 
                 Byte 
                 1 
                 NACK Type constant 
               
               
                 TOTAL 
                   
                 7 
               
               
                   
               
             
          
         
       
     
       11. UDP Transport Use Cases 
       [0287]    UDP Transactions consist of a properly formatted request structure placed inside a properly formatted UDP transport envelope structure and sent to the GTX platform host address. 
       11.1 Mobile Client First-time Initialization or Cold-start 
       [0288]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 GET_DEVICE_ID 
                 PUT_DEVICE_ID 
               
               
                   
                   
               
             
          
         
       
     
       11.2 Host Request Location 
       [0289]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
                   
               
             
             
               
                   
                 GET_CURRENT_LOCATION 
                 PUT_CURRENT_LOCATION 
               
               
                   
                   
               
             
          
         
       
     
       11.3 Start or Stop Interval Location Reporting 
       [0290]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
                   
               
             
             
               
                   
                 SET_REPORTING_INTERVAL 
                 ACK_MOBILE 
               
               
                   
                   
               
             
          
         
       
     
         [0291]    After defined non-zero interval: 
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
             
             
               
                   
                     
                 PUT_LOCATION 
               
               
                   
                   
               
             
          
         
       
     
       11.4 Host Request Battery Level 
       [0292]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
                   
               
             
             
               
                   
                 GET_BATTERY_LEVEL 
                 PUT_BATTERY_LEVEL 
               
               
                   
                   
               
             
          
         
       
     
       11.5 Host Request Radio Status 
       [0293]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
                   
               
             
             
               
                   
                 GET_RSSI 
                 PUT_RSSI 
               
               
                   
                   
               
             
          
         
       
     
       11.6 Host Request GPS Status 
       [0294]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
                   
               
             
             
               
                   
                 GET_ GPS_STATUS 
                 PUT_GPS_STATUS 
               
               
                   
                   
               
             
          
         
       
     
       11.7 Host Set GPS Power State 
       [0295]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
                   
               
             
             
               
                   
                 SET_GPS_POWERSTATE 
                 ACK_MOBILE 
               
               
                   
                   
               
             
          
         
       
     
       11.8 Host Set Buffering Interval 
       [0296]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
                   
               
             
             
               
                   
                 SET_BUFFERING_INTERVAL 
                 ACK_MOBILE 
               
               
                   
                   
               
             
          
         
       
     
       11.9 Start Buffered Data Transmission 
       [0297]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
                   
               
             
             
               
                   
                 SET_START_BUFFER 
                 PUT_LOCATION 
               
               
                   
                   
               
             
          
         
       
     
         [0298]    Repeats until a stop buffer transmission request is received or the newest record has been transmitted: 
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
             
             
               
                   
                     
                 PUT_LOCATION 
               
               
                   
                   
               
             
          
         
       
     
       11.10 Stop Buffered Data Transmission 
       [0299]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
                   
               
             
             
               
                   
                 END_BUFFERED_DATA 
                 ACK_MOBILE 
               
               
                   
                   
               
             
          
         
       
     
       11.11 Establish Circular Geofence 
       [0300]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
                   
               
             
             
               
                   
                 GET_GEOFENCE_HANDLE 
                 PUT_GEOFENCE_HANDLE 
               
               
                   
                 SET_CIRCULAR_GEOFENCE 
                 ACK_MOBILE 
               
               
                   
                   
               
             
          
         
       
     
       11.12 Establish Polygon Geofence 
       [0301]      
         [0000]    
       
         
               
               
             
           
               
                   
               
               
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
               
             
             
               
                 GET_GEOFENCE_HANDLE  
                 PUT_GEOFENCE_HANDLE 
               
               
                 SET_POLYGON_GEOFENCE 
                 ACK_MOBILE 
               
               
                   
               
             
          
         
       
     
       11.13 Establish Velocity Geofence 
       [0302]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
                   
               
             
             
               
                   
                 GET_GEOFENCE_HANDLE 
                 PUT_GEOFENCE_HANDLE 
               
               
                   
                 SET_VELOCITY_GEOFENCE 
                 ACK_MOBILE 
               
               
                   
                   
               
             
          
         
       
     
       11.14 Establish Stationary Geofence 
       [0303]      
         [0000]    
       
         
               
               
             
           
               
                   
               
               
                 Host-to-mobile 
                 Mobile-to-host 
               
               
                   
               
             
             
               
                 GET_GEOFENCE_HANDLE 
                 PUT_GEOFENCE_HANDLE 
               
               
                 SET_STATIONARY_GEOFENCE 
                 ACK_MOBILE 
               
               
                   
               
             
          
         
       
     
       12. Reverse HTTP Transport Use Cases 
       [0304]    Reverse HTTP Application-layer transactions are coupled with the HTTP transport-layer transaction for mobile-initiated requests and decoupled from the HTTP transport-layer transaction for host-initiated requests. 
       12.1 Mobile Client First-time Initialization or Cold-start 
       [0305]      
         [0000]                                            Mobile-to-host   Host-to-mobile                           GET_DEVICE_ID   PUT_DEVICE_ID                        
12.2 Idle State: Mobile Waiting for Command from Host
 
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ACK_MOBILE 
                 ACK_HOST 
               
               
                   
                   
               
             
          
         
       
     
         [0306]    In Reverse HTTP High Interactivity mode, a new HTTP session is established immediately. In Reverse HTTP Low Interactivity Mode, a defined interval elapses before the mobile re-polls the host for a command. If any mobile-initiated events occur during this period, the mobile established an HTTP session immediately and sends the host a structure. 
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
             
             
               
                   
                 ACK_MOBILE 
                 ACK_HOST or &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
       12.3 Host Request Location 
       [0307]      
         [0000]    
       
         
               
               
             
           
               
                   
               
               
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
               
             
             
               
                 ACK_MOBILE 
                 GET_CURRENT_LOCATION 
               
               
                 PUT_CURRENT_LOCATION 
                 &lt;any valid request&gt; 
               
               
                   
               
             
          
         
       
     
       12.4 Start or Stop Interval Location Reporting 
       [0308]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ACK_MOBILE 
                 SET_REPORTING_INTERVAL 
               
               
                   
                 ACK_MOBILE 
                 &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
         [0309]    After defined non-zero interval: 
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
             
             
               
                   
                 PUT_LOCATION 
                 &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
       12.5 Host Request Battery Level 
       [0310]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ACK_MOBILE 
                 GET_BATTERY_LEVEL 
               
               
                   
                 PUT_BATTERY_LEVEL 
                 &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
       12.6 Host Request Radio Status 
       [0311]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ACK_MOBILE 
                 GET_RSSI  
               
               
                   
                 PUT_RSSI 
                 &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
       12.7 Host Request GPS Status 
       [0312]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ACK_MOBILE 
                 GET_GPS_STATUS 
               
               
                   
                 PUT_GPS_STATUS 
                 &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
       12.8 Host Set GPS Power State 
       [0313]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ACK_MOBILE 
                 SET_GPS_POWERSTATE 
               
               
                   
                 ACK_MOBILE 
                 &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
       12.9 Host Set Buffering Interval 
       [0314]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ACK_MOBILE 
                 SET_BUFFERING_INTERVAL 
               
               
                   
                 ACK_MOBILE 
                 &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
       12.10 Start Buffered Data Transmission 
       [0315]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ACK_MOBILE 
                 GET_BUFFER 
               
               
                   
                 PUT_LOCATION 
                 &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
         [0316]    After defined non-zero interval: 
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
             
             
               
                   
                 PUT_LOCATION 
                 &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
       12.11 End Buffered Data Transmission 
       [0317]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ACK_MOBILE 
                 END_BUFFERED_DATA 
               
               
                   
                 ACK_MOBILE 
                 &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
       12.12 Set Heartbeat Interval 
       [0318]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ACK_MOBILE 
                 SET_HEARTBEAT_INTERVAL 
               
               
                   
                 ACK_MOBILE 
                 &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
       12.13 Set Interactivity Mode 
       [0319]      
         [0000]    
       
         
               
               
               
             
           
               
                   
                   
               
               
                   
                 Mobile-to-host 
                 Host-to-mobile 
               
               
                   
                   
               
             
             
               
                   
                 ACK_MOBILE 
                 SET_INTERACTIVITY_MODE 
               
               
                   
                 ACK_MOBILE 
                 &lt;any valid request&gt; 
               
               
                   
                   
               
             
          
         
       
     
         [0320]      FIG. 5  is a flow chart summarizing a method  500  for communicating with a tracking device using, for example, the above-described communication protocol. In a first step  502 , communication is established between the tracking device (e.g., tracking device  102 ) and a remote system (e.g., system  104 ) via a wireless network (e.g., a mobile phone network). Then, in a second step  504  configuration data is provided to the tracking device from the remote server. Next, in a third step  506 , the remote server receives processed data from the tracking device. Then, in a fourth step  508  a determination is made whether the configuration of the tracking device should be changed. If so, then in a fifth step  510 , different configuration data is provided to the tracking device to reconfigure the tracking device. Then, in a sixth step  512 , the remote system receives additional processed data from the tracking device, which has been processed and/or provided by the tracking device in the tracking device&#39;s new configuration. If in fourth step  508  it is determined that no configuration change is necessary, then method  500  proceeds to sixth step  512  where the remote system receives addition processed data from the tracking device, but the additional processed data will have been processed and/or provided by the tracking device in the tracking device&#39;s first configuration. 
         [0321]    The description of particular example embodiments of the present invention is now complete. Many of the described features may be substituted, altered or omitted without departing from the scope of the invention. For example, the tracking devices of the present invention can be embodied in an article of clothing worn by a tracked subject. As another example, tracking devices  102  and/or subscriber systems  118  can be embodied in GPS enabled mobile telephones or other hand-held position determining devices. These and other deviations from the particular embodiments shown will be apparent to those skilled in the art, particularly in view of the foregoing disclosure.