Support Document

0 mins to read

Aug 26, 2022

Introduction

The Spreader Controller Add-in is a tool that is used by Customers and Partners to apply controller configurations to the IOX-WRKS harness, without the need to contact Support. Each Spreader Controller has a unique data protocol which requires a specific configuration that needs to be applied to the IOX-WRKS, so that the controller data can be interpreted and transmitted effectively. This Add-in is also used as a validation tool to confirm that valid controller data is being transmitted to MyGeotab.

Getting Started

The Spreader Controller Add-in must be installed to your MyGeotab application before attempting the configuration or validation process.

Installing the Spreader Controller Add-in

1

From the MyGeotab main menu, navigate to Administration > System…> System Settings.

2

From the System Settings page, select the Add-Ins tab.

3

Click the New Add-In button and an Add-In popup displays.

4

In the open text field, replace the current configuration with the following:

{

"url": "https://app.geotab.com/addins/geotab/ioxwrksaddin/manifest.json"

}

5

Click the OK button, and then Save.

✱ NOTE: If a yellow information message displays notifying you to refresh your page, click Refresh and repeat steps two through four.

6

From the MyGeotab main menu, select the Engine & Maintenance dropdown. The Spreader Controller Add-in is now available.

Assigning the Spreader Configuration to IOX-WRKS

After the Add-in is installed to your MyGeotab application, use the Spreader Controller feature from your MyGeotab main menu to begin assigning the Spreader Configuration to IOX-WRKS.

How to Assign the Spreader Configuration to IOX-WRKS

1

From the MyGeotab main menu go to Engine & Maintenance > Spreader Controller.

2

From the Spreader Controller Configuration page, select your vehicle from the Select Vehicle dropdown.

✱ NOTE: Narrow the results by typing part of the vehicle name or serial number into the Select Vehicle text field.

3

Once the vehicle is selected, the Device Information displays.

! IMPORTANT: Confirm that the Rate plan detected is ProPlusWinterOps, and that the IOX-WRKS detection status is Detected.

4

Once the Device Information details are confirmed, select the desired Spreader Controller from the Controller Type dropdown.

5

Use the Set Spreader button to send the controller configuration to the IOX-WRKS.

✱ NOTE: The vehicle ignition must be on in order to send a configuration to the IOX-WRKS.

6

After sending the controller configuration, an in progress… message displays. The message changes to a success message once the process is complete.

✱ NOTE: This message should appear within a few seconds but can take up to one minute.

Verifying Controller Measurements

After sending the Spreader Controller configuration, verify simulated controller data.

! IMPORTANT: The vehicle’s ignition should be running for at least five minutes, or the vehicle should have a short trip before verifying controller measurements.

How to Verify Controller Measurements

1

Begin Simulation Mode on the Spreader Controller that is connected to the IOX-WRKS.

✱ NOTE: The vehicle’s ignition must be on during this test.

2

From the MyGeotab main menu, navigate to Engine & Maintenance > Spreader Controller.

3

From the Spreader Controller Configuration page, select your vehicle from the Select Vehicle dropdown. Narrow the results by typing part of the vehicle name or serial number. Then select the Verify Measurements button.

✱ NOTE: You do not need to re-select your vehicle if it is already selected.

4

The Spreader Controller details initially display No Data. This data refreshes every five seconds. Expect to see controller data reporting within five minutes. This data should match the Spreader Controller display in your vehicle.

Frequently Asked Questions

Q: What Rate Plan is required on my Go device to set a Spreader Controller Add-in on my IOX-WRKS?

A: The GO device must be on the ProPlusWinterOps plan in order to send and receive data using the IOX-WRKS. ✱ NOTE: Please reach out to your Partner if your desired GO device does not display the correct plan.

Q: Why does my GO device not display a Rate Plan?

A: The GO device must be installed in a vehicle to establish its first communication with the server and receive its first updates, so that it can report the plan.

Q: What should I do if I get a timeout message after using the Set Spreader button?

A: The timeout message occurs if no success message displays within one minute of using the Set Spreader button. Ensure you have the correct GO device and Spreader Controller selected. In the Device Information section, make sure the IOX-WRKS is Detected, you have the ProPlusWinterOps Rate Plan, and there is an IOX-WRKS Firmware present. If all of these are present and correct, try the Set Spreader button again. If you still do not see a success message, please contact Support.

scroll-up