background image

 
 

User Guide to PL131 

 

 

Document Number 1155-4713   Rev E 

 

Page iii 

C

ONFID

ENTIA

L

 

In

fo

rm

a

ti

o

n

 c

la

s

s

ifi

e

d

 Co

n

fi

d

e

n

ti

a

Do 

n

o

c

o

p

y

 (Se

e

 l

a

s

p

a

g

e

 f

o

r o

b

lig

a

ti

o

n

s

)

 

This document contains confidential and proprietary information of Quake Global corporation.  It may be used by recipient only for the purpose for which it was transmitted 
and will be returned upon request or when no longer needed by recipient.  Disclosure to unauthorized third parties or duplication without the express written permission of 
Quake Global is prohibited.  © 2013-2015   QUAKE GLOBAL, INC. - All rights reserved. 

5.1

 

Messaging .................................................................................................................... 21

 

6

 

FILE OVER-THE-AIR TRANSFER (FOTA) SPECIFICATION ............................... 23

 

6.1

 

Creating a patch file ..................................................................................................... 23

 

6.1.1

 

BSDIFF details ...................................................................................................................... 23

 

6.1.2

 

Backend server validity checks ............................................................................................. 25

 

6.2

 

Delivering a patch file ................................................................................................... 26

 

6.2.1

 

FOTA protocol message definitions ...................................................................................... 27

 

6.2.1.1

 

File header ....................................................................................................................................... 27

 

6.2.1.2

 

Data .................................................................................................................................................. 27

 

6.2.1.3

 

Header or Message Ack ................................................................................................................... 28

 

6.2.1.4

 

Header or Message Nack ................................................................................................................. 28

 

6.2.2

 

Example flow of communication ............................................................................................ 29

 

APPENDIX A

– GLOSSARY OF TERMS ...................................................................... 30

 

 
 

List of Figures 

 
Figure 5-1:  Iridium network diagram .......................................................................................................... 21

 

Figure 6-1:  Output structure of the standard BSDIFF file .......................................................................... 24

 

Figure 6-2:  New output structure of the BSDIFF file .................................................................................. 25

 

Figure 6-3:  Process flow of maximum application image size checks ....................................................... 26

 

 

 

List of Tables 

Table 2-1:  Battery voltage/LED operation .................................................................................................... 5

 

Table 4-1:  Concatenated message .............................................................................................................. 9

 

Table 4-1.1:  Example Concatenated message ............................................................................................ 9

 

Table 4-2:  Status message ........................................................................................................................ 10

 

Table 4-2.1:  Example Status message ...................................................................................................... 11

 

Table 4-2.2:  Example Status message - parsed ........................................................................................ 11

 

Table 4-3:  Ack message ............................................................................................................................ 11

 

Table 4-3.1:  Example Ack message .......................................................................................................... 12

 

Table 4-3.2:  Example Ack message - parsed ............................................................................................ 12

 

Table 4-4:  Nack message .......................................................................................................................... 12

 

Table 4-4.1:  Example Nack message ........................................................................................................ 12

 

Table 4-4.2:  Example Nack message - parsed .......................................................................................... 12

 

Table 4-5:  Factory Reset message ............................................................................................................ 13

 

Table 4-5.1:  Example Factory Reset message .......................................................................................... 13

 

Table 4-5.2:  Example Factory Reset message - parsed ........................................................................... 13

 

Table 4-6:  Configuration message ............................................................................................................. 13

 

Table 4-6.1:  Example Configuration message ........................................................................................... 14

 

Table 4-6.2:  Example Configuration message - parsed ............................................................................ 14

 

Table 6-1:  FOTA file header message ....................................................................................................... 27

 

Table 6-2:  FOTA data message ................................................................................................................. 27

 

Table 6-3:  FOTA header or message Ack ................................................................................................. 28

 

Table 6-4:  FOTA header or message Nack ............................................................................................... 28

 

Содержание PL131

Страница 1: ...Page Document 1155 4713 Revision E User Guide to PL131 SENSITIVITY LEVEL YELLOW THE LEADER IN REMOTE ASSET TRACKING...

Страница 2: ...able 4 2 1 Added Time Offset field to Configuration Message in o Table 4 6 o Table 4 6 1 o Table 4 6 2 Corrected size of first Length field to 1 byte in Table 4 1 Corrected size of Length field to 12...

Страница 3: ...ting 4 2 1 3 1 Screws 4 2 2 Setup 4 2 3 Provisioning and activation 4 2 3 1 Iridium 4 2 3 1 1 Activation 4 2 3 1 2 Provisioning 4 2 4 Powering On Off 4 2 4 1 Power on 4 2 4 2 Power off 5 2 5 Testing 5...

Страница 4: ...tion 29 APPENDIX A GLOSSARY OF TERMS 30 List of Figures Figure 5 1 Iridium network diagram 21 Figure 6 1 Output structure of the standard BSDIFF file 24 Figure 6 2 New output structure of the BSDIFF f...

Страница 5: ...itioning System GPS receiver capable of determining the position of the device 2 Wireless network A communications network capable of sending information to and from the device Iridium SBD 3 CAT Wirel...

Страница 6: ...or which it was transmitted and will be returned upon request or when no longer needed by recipient Disclosure to unauthorized third parties or duplication without the express written permission of Qu...

Страница 7: ...e express written permission of Quake Global is prohibited 2013 2015 QUAKE GLOBAL INC All rights reserved Caution There is a risk of explosion if the battery is replaced by an incorrect type Dispose o...

Страница 8: ...ny interference with other electronic devices 2 1 3 Mounting 2 1 3 1 Screws M6 hex head or socket screws The preference is Hex head the design must also accommodate a deep well socket If socket head i...

Страница 9: ...of Quake Global is prohibited 2013 2015 QUAKE GLOBAL INC All rights reserved 2 4 2 Power off To power down the PL131 either remove the battery or utilize the push button 2 5 Testing When the battery...

Страница 10: ...er The Air OTA configuration The CAT Wireless Office System is a system of middleware that manages the collection and communication of data from Caterpillar to the communications network and a web bas...

Страница 11: ...s Set only the Satellite Breadcrumbs parameters For the Satellite Breadcrumbs set the following parameters Enabled turns this feature on Interval determines how long the device will sleep between send...

Страница 12: ...BAL INC All rights reserved Time offset and Interval can both be set at the same time Before going to sleep the unit will decide whether to wake up at Minute of Day or at another set interval The mini...

Страница 13: ...ibed in this section All INT types are assumed to be little endian 4 1 1 Concatenated This message is an MO message and is less than or equal to 340 bytes In the event the modem has more than one mess...

Страница 14: ...detic long double lat lon lon_code lat_code lat 90 0 unsigned long lat_code double 0XFFFFFF 180 0 lon unsigned long lon_code double 0XFFFFFF 360 0 if lon 180 0 lon lon 360 0 See parsed example in Tabl...

Страница 15: ...0x3DBC7E00u Seconds difference between Jan 6 1980 GPS Epoch and Nov 1 2012 Timestamp seconds since GPS Epoch NEW_EPOCH_OFFSET Table 4 2 1 Example Status message Data Type Size 61 DA D0 4D 24 32 AA 01...

Страница 16: ...e C7 Configuration Checksum 00 00 0000 reserved Timestamp D2 1D 6A 01 8 2 2013 4 07 46 PM 4 1 4 Nack This message can be either MO or MT Table 4 4 Nack message Name Data Type Size Notes Message opcode...

Страница 17: ...Parsed Value Message opcode AF Factory Reset message Type of object FF Reserved ObjectId 00 00 Reserved Unit will default its configurations 4 1 6 Configuration This message is an MT message Table 4 6...

Страница 18: ...9 bytes Table 4 6 2 Example Configuration message parsed Field Name Data Hex Parsed Value Message opcode C7 Configuration message Enable Motion Detection FA 80 Enabled Motion Detection Threshold 250...

Страница 19: ...emperature reading battery voltage signal strength wake up event type Is network available Queue message Attempt connection to server Did Locator connect to server No Yes Send message to server Did Lo...

Страница 20: ...rd parties or duplication without the express written permission of Quake Global is prohibited 2013 2015 QUAKE GLOBAL INC All rights reserved Wait for FOTA packet Received a packet Last packet End of...

Страница 21: ...third parties or duplication without the express written permission of Quake Global is prohibited 2013 2015 QUAKE GLOBAL INC All rights reserved 4 2 2 Communication path Send a Status message 4 2 2 1...

Страница 22: ...C All rights reserved 4 3 Failure modes 4 3 1 Failure to get GPS fix If the Locator fails to get a GPS fix no message will be queued and the Locator will go to sleep and wake up at the next specified...

Страница 23: ...Quake Global is prohibited 2013 2015 QUAKE GLOBAL INC All rights reserved 4 3 3 Signal strength is unknown If signal strength is unknown or undetectable it will be set to 99 this will not stop an atte...

Страница 24: ...able to be read the Locator will report 127 as the temperature Locator wakes up Does Locator know its temperature Temperature is recorded in the status message Report 127 as the temperature in the sta...

Страница 25: ...between modems and the Iridium ground network are accomplished via a constellation of low earth orbit LEO satellites There are 66 operational satellites with additional spares that operate in 6 polar...

Страница 26: ...he express written permission of Quake Global is prohibited 2013 2015 QUAKE GLOBAL INC All rights reserved Mobile Terminated Short Burst Data MT SBD 1 A message is sent to the Iridium Gateway server b...

Страница 27: ...ory constraints on the SAT units 2 LZF Compression http oldhome schmorp de marc liblzf html LZF Compression does not differ programmatically from the standard open source implementation BSDIFF creates...

Страница 28: ...ed by recipient Disclosure to unauthorized third parties or duplication without the express written permission of Quake Global is prohibited 2013 2015 QUAKE GLOBAL INC All rights reserved Figure 6 1 O...

Страница 29: ...triplet x1 y1 z1 24 byte triplet x_n y_n z_n 34 byte header Control Section of size ctrl_len Diff section is Interleaved with extra section Figure 6 2 New output structure of the BSDIFF file The diff...

Страница 30: ...Set the IsCompressed flag in header to 0 Yes Figure 6 3 Process flow of maximum application image size checks 6 2 Delivering a patch file QUAKE has developed a custom transport protocol for delivering...

Страница 31: ...ta Type Size Notes Opcode Message opcode U8 1 byte Set to 0x3D EndSeqNo Total pkts in download 1 U16 2 bytes Checksum Checksum of entire file after compression U16 2 bytes FileId not used U8 1 byte Fi...

Страница 32: ...byte Set to 0x36 AckOpcode OpCode of the message ACK U8 1 byte Will be 0x3D when ACK ing the header Will be 0x3C when ACK ing the data every 7 packets Checksum Should be 0x0000 reserved for future U16...

Страница 33: ...no longer needed by recipient Disclosure to unauthorized third parties or duplication without the express written permission of Quake Global is prohibited 2013 2015 QUAKE GLOBAL INC All rights reserv...

Страница 34: ...be returned upon request or when no longer needed by recipient Disclosure to unauthorized third parties or duplication without the express written permission of Quake Global is prohibited 2013 2015 QU...

Страница 35: ...AKE products and services described herein No license express or implied by estoppel or otherwise to any intellectual property rights is granted under this document If any part of this document refers...

Отзывы: