DM to DIG Geotab Integration Overview
Digital Matter sends device data to via a DIG connection to Geotab.
Initial Device Setup:
- Devices are provisioned on Geotab from the DM's Device Manger Server. Partners can use their MyAdmin credentials or provide Digital Matter with their Geotab ERP number - Provision a MyGeotab Device on OEM Server
Device Manager server will provide a Geotab Serial number for each device. - Devices are assigned a Geotab Connector from Device Manager. This tells Device Manager server to send data to Geotab.
3. Use the Geotab Serial number/s (provided by Device Manager server) when adding new assets to the Geotab portal.
Device Operation:
- Devices log GPS data and then upload to Device Manager Server.
- Data sent to the Device Manager Server by the device is directed to the DIG Geotab 3rd Party API.
- Data appears in Geotab for the Geotab Serial.
What is sent to MyGeotab:
- GPS data is sent most regularly (or according to how the device is setup):
- Position data: Lat, long, speed, Is GPS Valid.
- Digital data: Ignition, auxiliaries (Tamper for Remora in Aux 2), Battery Status (battery NOT good)
-
Device Profiling Counters are sent less regularly, usually once per day:
- Battery Voltage in Millivolts
- Battery Percentage
- Successful Uploads
- Failed Uploads
- GPS Freshen Attempts
- GPS Freshen Time
- Trip count
DIG Record Details:
Binary record:
- Bluetooth tag binary data (limited data supported)
GPS record:
- SerialNo
- DateTime/RecordDate
- Longitude
- Latitude
- IsGpsValid
- IsIgnitionOn
- IsAuxiliary1On
- IsAuxiliary2On
- IsAuxiliary3On
- IsAuxiliary4On
- IsAuxiliary5On // Power on/off
- IsAuxiliary6On // Battery level
- IsAuxiliary7On
- IsAuxiliary8On
Driver Change record:
- Geotab KeyType = 84
Status record:
- GEOTAB_TEMPERATURE_STATUS_CODE = 6;
- GEOTAB_HUMIDITY_STATUS_CODE = 293;
- GEOTAB_TEMPERATURE_Key = 12;
- GEOTAB_HUMIDITY_KEY = 13;
- GEOTAB_INTERNALBATTERYVOLTAGEMILLIVOLT_STATUS_CODE = 5;
- GEOTAB_INTERNALBATTERYPERCENTAGE_STATUS_CODE = 9;
- GEOTAB_SUCCESSFULUPLOADS_STATUS_CODE = 10;
- GEOTAB_FAILEDUPLOADS_STATUS_CODE = 11;
- GEOTAB_GPSFRESHENATTEMPTS_STATUS_CODE = 12;
- GEOTAB_GPSFRESHENTIMESECONDS_STATUS_CODE = 13;
- GEOTAB_TRIPS_STATUS_CODE = 14;