Geotab Substance Spreader Protocol Documentation

Technical Document — Substance Spreader Integration

Geotab supports two substance spreader controllers: the DICKEY-john Control Point control system (via the IOX-DJ) and the Rexroth Compu-Spread CS440 and CS550 controllers (via the IOX-COMSPREAD).

The controllers transmit the following information to MyGeotab through the IOX:

While these controllers can be used for multiple purposes, they are primarily targeted at organizations operating winter vehicles during snow events. There are slight differences in the data provided by the different manufacturers; however, the underlying data types and engine codes are the same.

What are the features and benefits of substance spreader monitoring?

Are there additional monthly fees for substance spreader monitoring?

Devices using either IOX-DJ or IOX-COMSPREAD require, or will activate, the ProPlus rate plan.



Name: IOX-DJ (Support Document)

Description: IOX Add-On for GO6/GO7 for DICKEY-john

IOX Price: Please refer to MyAdmin for pricing of released products

Which DICKEY-john controller units are supported?

The IOX-DJ supports the Control Point control system from DICKEY-john. These systems have a DB9 connector to connect to the IOX-DJ.

Note: DICKEY-john ICS2000 and FLEX4 systems are not supported.

About DICKEY-john

DICKEY-john has customers ranging from individual farmers to original equipment manufacturers (OEMs). Amongst other markets, DICKEY-john provides systems for snow equipment vehicles which Geotab has focused on. Control Points®'s resourceful three-channel system gives you the power to control granular and liquid material application rates, spinner speed, and spread width.


Name: IOX-COMSPREAD (Support Document)

Description: IOX Add-On for GO6/GO7 for Rexroth Compu-Spread spreader controllers

IOX Price: Please refer to MyAdmin for pricing of released products

Which Compu-Spread controller units are supported?

The IOX-COMSPREAD supports the CS-440 and CS-550 spreaders. These systems have a DB9 connector that the IOX-COMSPREAD connects to. The IOX-COMSPREAD will only provide a female DB9 connector and special consideration will be needed for connection with the Compu-Spread unit. Please refer to the Support Document for more information.

Much like the DICKEY-john unit, the CS-440 and CS-550 will report data for the solid and liquid channels, as well as an additional third channel used for pre-wet materials.

About Rexroth Compu-Spread

As part of the Bosch Rexroth Canada Corporation, the Compu-Spread business group exclusively focuses on developing the industry's most advanced electronic and hydraulic spreader control systems. These integrated systems are designed to meet the specific and rapidly evolving needs of the snow and ice maintenance market throughout North America.

What kind of data is transmitted?

The GO device transmits two types of Material Spreader information:

  1. Status changes for the material being spread, including when the spreading begins and ends.
  2. The distance travelled while spreading (DICKEY-john only), the amount spread, and the time spent spreading or blasting a material.

All data is transmitted as Engine Diagnostic data and can be reviewed in the Engine Measurements Reports.

Status changes

When a given material has begun spreading, the value of one of the MAC select substance properties will change from 0 to 1. When the spreading concludes, the value will revert back to 0.

The GO device looks for changes in the distance value reported by the substance spreader to determine if the unit is applying a given material. Due to the relative infrequency of changes reported by the third-party spreader, there can be as much as a 100 meter distance difference between the time the driver makes a change to the time the GO device receives a notice from the spreader unit.

Exception Rules

Exception rules can be used to trigger notifications and alerts based on the values transmitted from the spreader units. Similarly, exception rules help you understand where substance spreading has taken place geographically. Before you can create an exception rule, you will need to determine the data being transmitted from the spreader unit to MyGeotab.

Use the Engine Measurements Report (Engine & Maintenance > Engine Data… > Engine Measurements) to determine the name of the MAC select substance property being transmitted from the unit. The table below lists all possible property names and values that can be transmitted:

Engine Status PID


34081 MAC select substance 1 — blast

MAC blast application substance 1 (solid)

34082 MAC select substance 2 — blast

MAC blast application substance 2 (solid)

34083 MAC select substance 3 — blast

MAC blast application substance 3 (solid)

34084 MAC select substance 4 — blast

MAC blast application substance 4 (solid)

34085 MAC select substance 5 — blast

MAC blast application substance 1 (liquid)

34086 MAC select substance 6 — blast

MAC blast application substance 2 (liquid)

34087 MAC select substance 7 — blast

MAC blast application substance 3 (liquid)

34088 MAC select substance 8 — blast

MAC blast application substance 4 (liquid)

34090 MAC select substance 1 — auto

MAC automatic substance 1 (solid)

34091 MAC select substance 2 — auto

MAC automatic application substance 2 (solid)

34092 MAC select substance 3 — auto

MAC automatic application substance 3 (solid)

34093 MAC select substance 4 — auto

MAC automatic application substance 4 (solid)

34094 MAC select substance 5 — auto

MAC automatic application substance 1 (liquid)

34095 MAC select substance 6 — auto

MAC automatic application substance 2 (liquid)

34096 MAC select substance 7 — auto

MAC automatic application substance 3 (liquid)

34097 MAC select substance 8 — auto

MAC automatic application substance 4 (liquid)

34089 MAC master switch status (0 = off / 1 = auto / 2 = unload)

Note: Rexroth spreaders use additional substance diagnostics numbered 9 to 12 for pre-wet materials.

Once you have determined which MAC select substance properties are relevant to your installation, you can create an exception rule.

Create an Exception Rule by navigating to Rules & Groups > Rules and clicking Add.

Next, select the Conditions tab.


Click the Add engine button.


Under the Engine label, set the Type to Measurement or Data. Next, choose the appropriate MAC select substance diagnostic and then set the Value field to be over 0. Click Add to finish editing the conditions and click Save to finalize the Engine Rule.


Distance, Volumes, Time, and Spread Rates

The substance spreader units also report distances (for DICKEY-john only), times, and volumes for the material being spread. The GO device listens for changes to these parameters as the material is spread or blasted. As the parameters change, the GO device captures the increments and transmits them to MyGeotab. When the material is being spread or blasted:

As the material is spread or applied, the relevant measurements data accumulates. The DICKEY-john units can be set up by the customer with 4 granular materials (with both regular and blast applications) and 4 liquid materials (with both regular and blast applications). The Rexroth units are set up similarly, but the Rexroth system supports a third channel for pre-wet applications with 4 material types (again with both regular and blast applications).

Because the spreader units are independently configured by the customer, Granular 1 could be salt, or sand, or a mixture of the two — it depends on the setup of the in-vehicle units. It is common practice to configure all fleet vehicles in the same manner. Granular 1 and Granular 2 are the most common materials chosen — with Granular 1 representing salt and Granular 2 representing sand.

The following engine status codes may be seen in MyGeotab depending on how the units are configured. Only diagnostics relating to solid materials are shown, but there are identical diagnostics for liquid and pre-wet materials.

Diagnostic Name



34147 MAC spread rate — actual (solid)

34148 MAC spread rate — set point (solid)

34000 MAC automatic distance substance 1 (solid)

34001 MAC automatic weight substance 1 (solid)

34002 MAC automatic duration substance 1 (solid)

34003 MAC blast distance substance 1 (solid)

34004 MAC blast weight substance 1 (solid)

34005 MAC blast duration substance 1 (solid)

34010 MAC automatic distance substance 2 (solid)

34011 MAC automatic weight substance 2 (solid)

34012 MAC automatic duration substance 2 (solid)

34013 MAC blast distance substance 2 (solid)

34014 MAC blast weight substance 2 (solid)

34015 MAC blast duration substance 2 (solid)

34020 MAC automatic distance substance 3 (solid)

34021 MAC automatic weight substance 3 (solid)

34022 MAC automatic duration substance 3 (solid)

34023 MAC blast distance substance 3 (solid)

34024 MAC blast weight substance 3 (solid)

34025 MAC blast duration substance 3 (solid)

34030 MAC automatic distance substance 4 (solid)

34031 MAC automatic weight substance 4 (solid)

34032 MAC automatic duration substance 4 (solid)

34033 MAC blast distance substance 4 (solid)

34034 MAC blast weight substance 4 (solid)

34035 MAC blast duration substance 4 (solid)


We have created a series of substance spreader reports that can be found in the Geotab Marketplace.

Copyright © Geotab Inc. 2016-2017 - All Rights Reserved | | Rev 1.2 - 04/2017

® denotes a trademark of Geotab Inc., registered in Canada, the United States and other countries