Abeeway Industrial Tracker Reference Manual
  1. Manuals
  2. Brands
  3. Abeeway Manuals
  4. GPS
  5. Industrial Tracker
  6. Reference manual

Abeeway Industrial Tracker Reference Manual

Multi-mode tracker
Hide thumbs
Table of Contents

Advertisement

Quick Links

Industrial Tracker Reference Guide
Industrial Tracker
Firmware V1.8
ABEEWAY SAS
contact@abeeway.com
www.abeeway.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Industrial Tracker and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Abeeway Industrial Tracker

Summary of Contents for Abeeway Industrial Tracker

  • Page 1 Industrial Tracker Reference Guide Industrial Tracker Firmware V1.8 ABEEWAY SAS contact@abeeway.com www.abeeway.com...

  • Page 2: Table Of Contents

    Industrial Tracker Reference Guide FW 1.8 V0.2 Table of contents 1 Introduction..............................4 1.1 Document purpose.......................... 4 1.2 Product description........................4 1.3 Applications............................4 2 Features................................5 3 Industrial tracker device..........................6 3.1 Getting started..........................6 3.2 Advice usage............................6 4 Functioning..............................
  • Page 3 Industrial Tracker Reference Guide FW 1.8 V0.2 7.4 Request device configuration....................31 7.5 SOS mode configuration......................32 7.6 Parameters configuration......................32 7.7 Debug command..........................38 7.8 Two’s complement Encoding..................... 38 8 Default delivered Industrial tracker configuration................. 39 9 Configuration examples..........................40 9.1 Profile 1: Accurate on demand positioning................

  • Page 4: Introduction

    1.2 Product descripton The Abeetay Industrial Tracker is a multimode tracker combining GPS/Lot poter GPS, WIFI and LoRa radios tith embedded sensors to support accurate outdoor and indoor geolocaton. Designed to tithstand harsh environment, it is ideal for lotipoter industrial indoor and outdoor tracking applicatons.

  • Page 5: Features

    Industrial Tracker Reference Guide FW 1.8 V0.2 2 FEATURES  Multple operatng modes  Standby: Lora heartbeat only  Moton traciing: Get the tracker positon at a given cycle then moton is detected.  Permanent traciing: Get permanently a positon of the tracker.

  • Page 6: Industrial Tracker Device

    Industrial Tracker Reference Guide FW 1.8 V0.2 3 INDUSTRIAL TRACKER DEVICE 3.1 Getting started  The tracker is provided tith batery connected  Your LoRa nettork provider can use tto actvaton modes  OTAA (Over The Air Actvaton) that requires the folloting keys to join the nettork: DEVEUI, APPEUI and APPKEY for each device.

  • Page 7: Functioning

    Industrial Tracker Reference Guide FW 1.8 V0.2 4 FUNCTIONING 4.1 Main operatng modes 4.1.1 Overview The tracker supports up to fve diferent operatonal modes: Standby, Moton tracking, Permanent tracking, Start/End tracking, Actvity tracking. The mode is confgurable using confguratons parameters...

  • Page 8: Side Operations

    Industrial Tracker Reference Guide FW 1.8 V0.2 4.1.5 Moton Start/End traciing mode This mode is usually used then only the beginning and the end of a moton is the point of the interest. The tracker provides its positon then it starts and stops moving. The technology used is defned by the geoloc sensor parameter.

  • Page 9: Sos Mode

    Industrial Tracker Reference Guide FW 1.8 V0.2 4.2.2 Positon on Demand The tracker positon can be requested via LoRa dotnlink message. In this case, the geoloc_method strategy is used. Note This acton has precedence over the operatonal mode. So, if a positon acquisiton is already on progress, the operaton is stopped, and the demand is serviced.
  • Page 10 Industrial Tracker Reference Guide FW 1.8 V0.2  The range [1 .. 100] gives the sensitvity (in percentage). Page 10 of 46 10th July 2019 Restricted distribution...
  • Page 11 Industrial Tracker Reference Guide FW 1.8 V0.2 Notes 1i High percentage values should be used then a high sensitvity is expected (a light moton triggers an event). 2i Lot percentage values should be used then a lot sensitvity is expected (a strong moton trigger an event).

  • Page 12: Event Messages

    Industrial Tracker Reference Guide FW 1.8 V0.2 4.5 Event Messages These messages are notfcatons sent by the tracker informing the server about specifc events Based on the confguraton, events can be:  Geolocaton start  Moton start  Moton end The sending and the type of these messages depend on the operatonal mode as tell as of the config_flags (bits 6, 8 and 9).

  • Page 13: Shock Detection

    Industrial Tracker Reference Guide FW 1.8 V0.2 4.5.5 In actvity traciing operatng mode config flag bits Bit6 Bit 8 Bit 9 Message geolocaton start Moton start Moton end Beginning of moton Moton Start event End of moton Moton End event 4.6 Shoci detecton...

  • Page 14: Geolocation Strategy Modes

    Industrial Tracker Reference Guide FW 1.8 V0.2 5 GEOLOCATION STRATEGY MODES 5.1 Main operatng modes and SOS mode The folloting geolocaton technology setng (geoloc_sensor parameter) are used by the operatng modes: motonitracking, permanentitracking, start/end tracking and SOS. Note that in standby mode, only side operatons can report positons.
  • Page 15 Industrial Tracker Reference Guide FW 1.8 V0.2 Afer the frst positon is obtained, the geolocaton tming uplink are scheduled using the ul_period parameter (or 120seconds fxed in SOS mode). Important note: Depending on the config_flags, the geoloc start message can be: ...
  • Page 16 Industrial Tracker Reference Guide FW 1.8 V0.2 Once completed the positon is reported via LoRa and the GPS component stitches to the standby state. Once the gps_standbt_timeout delay expires, the GPS component is potered of. This leads into a loss of all data and ephemeris.
  • Page 17 With this technology, the device sends the data given by the GPS module before the agps_timeout delay expiry and the positon calculaton is done by the ABEEWAY server. If the GPS component didn’t succeed in having enough data to provide to the server, a LPGPS tmeout message is sent instead of a LPGPS data message.
  • Page 18 Industrial Tracker Reference Guide FW 1.8 V0.2 The actual geolocaton tmeout can be determined using the formula: Geoloc_tmeout =gps_timeout or agps_timeout depending on the used technology If geoloc_tmeout + WIFI_tme (5 seconds) +stitching techno tme (3 seconds) is higher than ul_period, geoloc_tmeout is adjusted and reduced to ft the ul_period.

  • Page 19: Uplink Messages

    Industrial Tracker Reference Guide FW 1.8 V0.2 6 UPLINK MESSAGES This secton describes the payload messages supported by the tracker. Unless othertise specifed, all values are transmited in nettork byte order (MSB frst). Each message is composed by:  A common header ...

  • Page 20: Encoded Form

    Industrial Tracker Reference Guide FW 1.8 V0.2 Strategy Statc device Moton device Single transmission using a random data rate tithin Single random 0x01 [SF7iSF12]. Double transmissions: Single transmission  First transmission using a random data rate tithin (2). using nettork ADR...
  • Page 21 Industrial Tracker Reference Guide FW 1.8 V0.2 1i Values calculated using this formula provides a truncated value rounding tithin a range of step_size. Decoded value<Real value<decoded value + step_size 2i if real value<step size, then a value of 0 is decoded...

  • Page 22: Common Message Header

    Industrial Tracker Reference Guide FW 1.8 V0.2 6.3 Common message header Common header Data Byte 0 Byte 1 Byte 2 Byte 3 Byte 4 Variable Type Status Batery Temperatur ACK/Opt Informaton Type: refer to Message types Status: Bit7i5 Operatng mode: ...

  • Page 23: Heartbeat Messages

    Industrial Tracker Reference Guide FW 1.8 V0.2 6.4 Heartbeat messages Common header Data Byte 0i4 Byte 5 Byte 6i8 Header tith Type=0x05 Cause FW version Cause: Last reset cause  0x01i PoteriOn Reset  0x02i BrotniOut Unregulated Domain Reset  0x04i BrotniOut Regulated Domain Reset ...
  • Page 24 Industrial Tracker Reference Guide FW 1.8 V0.2 6.5.1 GPS fix payload Common header Positon informaton data Byte 0i4 Byte 5 Byte 6i8 Byte 9i11 Byte 12 Byte 13i15 Header tith Opt=0 Lattude Longitude EHPE Encrypted Age: Time diference betteen the fx and the Lora transmission.
  • Page 25 Industrial Tracker Reference Guide FW 1.8 V0.2 6.5.3 WIFI tmeout payload Common header Positon informaton data Byte 0i4 Byte 5 Byte 6 Byte 7 Byte 8 Byte 9 Byte 10 Header tith Opt=3 v_bat1 v_bat2 v_bat3 v_bat4 v_bat5 v_bat6 V_bat1: encoded voltage at the start tme (T0) of the WIFI scan.

  • Page 26: Energy Status Messages

    Industrial Tracker Reference Guide FW 1.8 V0.2 6.5.5 WIFI BSSID payload Common Positon informaton data header Byte1 Byte2 Byte3 Byte 0i4 Byte5 B 6i11 Byte12 B 13i18 B 20i25 B 27i32 Header BSSID0 RSSI0 BSSID1 RSSI1 BSSID2 RSSI2 BSSID3 RSSI3...

  • Page 27: Activity Status Messages

    Industrial Tracker Reference Guide FW 1.8 V0.2 6.7 Actvity status messages 6.7.1 Actvity operatng mode When the operaton mode is actvity, the actvity status reportng has the folloting format: Common header Data Byte 0i4 Byte 5 Byte 6i9 Header tith Type=0x07...

  • Page 28: Shock Detection Messages

    Industrial Tracker Reference Guide FW 1.8 V0.2 Specials parameters  Firmware version (Parameter ID equals to 0xFE) should be read as follot: Parameter x Byte 5*x+1 Byte 5*x+2 Byte 5*x+3 Byte 5*x+4 Byte 5*x+5 Parameter ID Parameter value 0xFE 0x00...

  • Page 29: Event Message

    Industrial Tracker Reference Guide FW 1.8 V0.2 6.11 Event message It notfes generic events. Common header Data Additonal data with Event value=0x02 Byte 0i4 Byte 5 Byte 6i7 Byte 8i9 Byte 10i11 Header tith Type=0x0A Event Value X axis Y axis...

  • Page 30: Downlink Messages

    Industrial Tracker Reference Guide FW 1.8 V0.2 7 DOWNLINK MESSAGES These messages are sent from the server to the tracker through the LoRa nettork. They are used to either confgure or manage the tracker. Each message contains a header including: ...

  • Page 31: Operational Mode Configuration

    Industrial Tracker Reference Guide FW 1.8 V0.2 7.2 Operatonal mode configuraton The operatng mode can be remotely confgured tith a dotnlink LoRa message built as follot: Byte 0 Byte 1 Byte 2 0x02 Mode ACK: Acknotledge token. Refer to the secton Acknotledge token.

  • Page 32: Sos Mode Configuration

    Industrial Tracker Reference Guide FW 1.8 V0.2 Special parameter Id:  Tracker orientaton: o 0xFA: X axis accelerometer value in mG o 0xFB: Y axis accelerometer value in mG o 0xFC: Z axis accelerometer value in mG provides the orientaton of the tracker on each axis. The orientaton can be negatve, refer to the secton Tto’s complement Encoding...
  • Page 33 Industrial Tracker Reference Guide FW 1.8 V0.2 The table belot sum up all parameters and their ID. The parameters described as “reserved” are not used for this tracker. Parameter Parameter ul_period 0x00 transmit_strat 0x0E lora_period 0x01 Reserved 0x0F pw_stat_period 0x02...
  • Page 34 Industrial Tracker Reference Guide FW 1.8 V0.2 Example: To modify the heartbeat period to 1 hour, the command 0x0B020100000E10 should be sent. Descripton:  (0x0B): set the parameter  (0x02): tith an ack token of 2  (0x01): heartbeat message period ...
  • Page 35 Industrial Tracker Reference Guide FW 1.8 V0.2 Parameter Unit Range Descripton mete gps_ehpe 0x0B 0i100 Acceptable GPS horizontal error for GPS geolocaton seco Time let to the GPS module to refne the calculated gps_coniergence 0x0C 0i300 positon seco Duraton of the GPS standby mode before going OFF.
  • Page 36 When 0, no energy status report is transmited. Confguraton lags: bit 0: Frame pending mechanism bit 1: Reserved, not used in industrial tracker bit 2: Reserved, not used in industrial tracker bit 3: Send a confguraton uplink message in response to a confguraton modifcaton dotnlink.
  • Page 37 Industrial Tracker Reference Guide FW 1.8 V0.2 Parameter Unit Range Descripton This parameter provides the confguraton of the sensitvity of the shock detecton from 1 to 100%. A value of 0 disables the shock detecton. 0x15 0i100 shock_detection Note: When enabled, the motion_sensitiiitt...

  • Page 38: Debug Command

    Industrial Tracker Reference Guide FW 1.8 V0.2 7.7 Debug command Debug dotnlink commands allot to trigger specifc behavior. Byte 0 Byte 1 Byte 2 Byte 3 0xFF Debug CMD ID Acton (optonal) ACK: Acknotledge token. Refer to the secton Acknotledge token.

  • Page 39: Default Delivered Industrial Tracker Configuration

    Industrial Tracker Reference Guide FW 1.8 V0.2 8 DEFAULT DELIVERED INDUSTRIAL TRACKER CONFIGURATION  mode = 0 (standby)  lora_period = 600 seconds (10 minutes)  ul_period = 300 seconds  pt_stat_period = 43200 seconds  periodic_pos_period = 86400 seconds ...

  • Page 40: Configuration Examples

    Industrial Tracker Reference Guide FW 1.8 V0.2 9 CONFIGURATION EXAMPLES This chapter provides some confguraton profles examples depending on partcular use cases. The parameters can be modifed depending on the expected positon accuracy, the environment type (indoor, outdoor) and the expected batery life.

  • Page 41: Profile 2: Accurate Daily Periodic Position

    Industrial Tracker Reference Guide FW 1.8 V0.2 Side operatng modes The folloting functons can be added to this profle:  Shock detecton: confgure the shock_detection parameter  Moton informaton: enable moton_start and moton_end events, via the config_flags parameter  Periodic positon reportng: confgure the period_pos_period parameter 9.2 Profile 2: Accurate Daily periodic positon...

  • Page 42: Profile 3: Hourly Periodic Position With Medium Accuracy

    Industrial Tracker Reference Guide FW 1.8 V0.2 9.3 Profile 3: Hourly periodic positon with medium accuracy Use case: periodic medium accurate positons. The proposed confguraton uses:  Standby operatng mode  Accurate daily positoning Outdoor: GPS only  Indoor/Outdoor: WGPS ...

  • Page 43: Profile 4: Accurate Positions At Start And Stop Moving (Including Start/Stop Events Message)

    Industrial Tracker Reference Guide FW 1.8 V0.2 9.4 Profile 4: Accurate positons at start and stop moving (including start/stop events message) Use case: Accurate positons sent at the beginning and the end of a moton. The proposed confguraton uses:  Start/end traciing operatng mode ...

  • Page 44: Profile 5: Motion Tracking

    Industrial Tracker Reference Guide FW 1.8 V0.2 9.5 Profile 5: Moton traciing Use case: Accurate positons sent every 120s during a moton. The proposed confguraton uses:  Moton traciing operatng mode  Geolocaton strategy Outdoor: GPS only  Indoor/Outdoor: WGPS ...

  • Page 45: Profile 6: Permanent Tracking

    Industrial Tracker Reference Guide FW 1.8 V0.2 9.6 Profile 6: Permanent traciing Use case: Accurate positons sent every minute. WARNING: this mode is very consuming for the battery and should be used only for a short period The proposed confguraton uses: ...
  • Page 46 Industrial Tracker Reference Guide FW 1.8 V0.2 Page 46 of 46 10th July 2019 Restricted distribution...

Table of Contents