The Digital and Analogue mappings for the Oyster are explained below. Please note the minor differences between Telematics Guru mappings and what is received in the raw data. Telematics Guru manipulates the raw data.


Telematics Guru

On Telematics Guru, the defaults are shown graphically below. These can be viewed and edited under the IO Mappings tab when editing an asset (click the gear icon on the manage assets screen, and select edit).


For the Analogue Mappings, the analogue number is on the left. The meaning for that number is given in the name. The type, unit and conversion factor explain how to interpret the number. The conversion factor can be thought of as the multiplier to convert the raw number to the right unit.


For the Digital Mappings, the digital input/output number is on the left. Note inputs vs outputs. All Oyster default mappings are inputs. The digital input/output bit explains the position in the Digital Data bit field.

There are some important notes regarding the mappings in Telematics Guru

  • The Profile Counters (Analogue 11 and up) will move to a dedicated message that will be sent less often. This is pending in May 2017.
  • The Status bits (Digital 24 and up) are copied from the special status bits field, which are 2 dedicated bytes in the Digital Data field. See below for more explanation. 


Raw Data from OEM

The raw data will appear slightly differently to what is show above in Telematics Guru. Here are the key differences:

  1. Analogues 1-10 come in the 16 bit analogue field ID.
  2. Analogues 11-20 come in the 32 bit analogue field ID.
  3. Digital Inputs come in the Digital Data field, as 4 bytes. This is a total of 32 inputs. The status bits shown above (Trip State; Battery) are not in these 32 bits.
  4. Digital Outputs come in the Digital Data field as 2 bytes. This is a total of 16 outputs. The
  5. The Status bits come in the Digital Data field, as 2 bytes. This is a total of 16 bit flags:
    1. Trip State is bit 0 of the status bits
    2. Battery Good is bit 1 of the status bits.