The following process should be followed when integrating a third-party device with the GO device using our Third-Party Data CAN Protocol:

1 - Request external device ID

Contact Geotab Solution Engineering team to obtain an External Device ID for your third-party device. This will allow us to uniquely identify your device when it connects to a GO device. Thereafter, any connection established by that type of external device will be recorded as Status Data in MyGeotab under the naming format "[External device name] device connected".

2 - Request status data IDs

There is an extensively defined Status Data ID list which can be found at MyGeotab Diagnostics. Specifics regarding Status Data ID implementations can be found on the README sheet.

3 - Implement the third-party CAN protocol

Implement the Third-Party CAN Protocol in the external device as described below. The CAN speed to be used will be 250K or 500K, and the external device should have its CAN transceiver set to normal mode. The IOX CAN will auto-baud between 250K and 500K.

CAN ID

The CAN ID is an extended frame message (29-bit) and is broken down into 4 bytes, with the most significant byte (MSB) (byte 1) containing 5 bits to make up the 29-bit ID header. A breakdown of the CAN ID is shown below:

Data length (DLC)

Indicates how many bytes of data are being sent (up to a maximum of 8).

Data

All values must be sent with the least significant byte first.

Each piece of information related to the third-party device must be sent individually and have its own Status Data ID as part of the message.

Note: See Appendix A for an example of raw message data.

Handshake

An initial Handshake is required in order for the GO device to accept MyGeotab API calls to produce CAN messages from the IOX-CAN. Vehicle ignition must be on during the handshake process.

1. After powering up, the GO device will enter an external device detection cycle. The GO device will listen for a Msg Type 0x81 from the external device. This message is used to indicate that an external device is present.
   • The external device must send this message once per second.
2. The GO device will reply with a Msg Type 0x02 to acknowledge it has received the external device ID. After detecting this response, the external device may stop broadcasting Msg Type 0x81.
3. The MyAdmin API can now be used to produce CAN messages from the IOX-CAN as described in Messages from MyGeotab

Msg type 0x02: Third-party data acknowledge

Issued by the GO device upon receipt of Third-Party Data from the external device.

Msg type 0x81: Third-party device ID

Issued by the external device upon powerup once every second until an Acknowledge message (Msg Type 0x02) is received.

Msg type 0x80: Third-party data as status data

Issued by the external device whenever it wants Third-Party Data saved on the GO device. Rate limit is 100 logs per 10 minutes, for each distinct data ID. If you exceed the rate limit, the GO device will stop taking data from the IOX.

Msg type 0x82: Free format third-party data

Currently not implemented.

Msg type 0x87: Third-party data as priority status data

Priority Status Data follows an expedited processing workflow on the GO device, but will otherwise be treated the same as the 0x80 Status Data message. It will also be logged using an Iridium modem connection, if available.

A handshake must be completed before this functionality will work. To send messages from MyGeotab to the external device, download the source code of the Starter Kit sample, and replace the Sample API with the following script. The alternative is to paste the script in the Runner.

Appendix A: Raw message data example for IOX-CAN