Loadrite Integration

Integration reference data groups can be configured to allow the retrieval of data from Loadrite scales and submit it as a Set Payload Event. The integration works in the following way:

  • Pitram Mobile is connected to the Loadrite device over a serial port (COM port).

  • Pitram Mobile listens to the Loadrite device and on the "NW" (New Weight) event, data is added from Loadrite to Pitram.

  • When an "NW" event is generated from Loadrite, Pitram will generate an event (event based on reference data settings).

To configure the Loadrite for use with Pitram, the first step is to set up the integrations that will be mapped and configured.

Reference Data

Two reference groups are required to configure Loadrite:

  • LoadriteProfile

  • MobileUnitConfiguration

To make sure these groups are deployed open Pitram Portal and select the Reference Edit service.

From the Other Actions menu, select Deploy Reference Data.

The Deploy Reference Data option in the Other Actions menu

In the Reference Data Deployment dialog, ensure the LoadriteProfile and MobileUnitConfiguration groups are selected.

The Reference Data Deployment dialog

Note: Ensure that the LoadriteProfile option in the MobileUnitConfiguration branch is selected for deployment.

Click OK to deploy the relevant reference data.

Loadrite Profile

With the reference data deployed, the Loadrite profile can be created for the integration. To do this, in the Reference Edit service, click on Configuration Items > Mobile Settings > Loadrite Profile.

The Loadrite Profile option in the Reference Edit groups tree

The Loadrite Profile screen is displayed.

The Loadrite Profile screen

The Loadrite Profile screen lists the existing profiles. To create a new Loadrite Profile, Checkout the table and click New.

The Loadrite Profile contains the following attributes:

The Create New Loadrite Profile dialog

Attribute Name Description
ConnectionThreshold The time, in seconds, before a record from the Loadrite device will be ignored when determining the connection status. Defaults to 0 seconds.
DumpsWithNoPayloadFailure The number of sequential dumps without a Loadrite payload reading before the device switches to failure mode. Specify 0 to turn off.
ExpectedDataInterval Amount of time (in seconds) with no data received before the Loadrite device will fall into a medium health state. Defaults to 300 seconds.
FailMeasure The measure code against which failed measurements are recorded.
GenerateDump Determines whether Pitram will automatically generate a dump event after receiving a payload. Defaults to off (0), specify 1 to turn on.
GenerateHaulFromLoad Determines whether to record a haul event on successful load. Defaults to on (1), specify 0 to turn off.
GenerateLoad Sets whether to record a loading event when a payload is received. Defaults to on (1), specify 0 to turn off.
HardwareDisplayName The display name for this Loadrite device in Pitram Mobile.
MaxPayloadTonnes The maximum tonnes reading to be considered valid for generating a payload dump.
MinPayloadTonnes The minimum tonnes reading to be considered valid for generating a payload dump.
PartialWeightMultiplier The value to multiply the partial weight by to convert to tonnes. Defaults to 1.
PayloadMeasure The measure code against which payload measurements are recorded.
Port The communications port to which the Loadrite device is connected. Include prefix "COM" if it is a COM port (e.g. COM7).
PrimaryStates The list of primary statuses suitable for generating a valid payload event and other related events.
UseEqCapacityIfPayloadExceeds Whether to use equipment capacity if Loadrite payload exceeds the maximum value. Default off (0).
UseInvalidReadingForFails Whether to record an invalid tonnage (exceeds min/max) if received from Loadrite, or record an error tonnage of 1. Defaults to on (1), specify 0 to turn off.

Click OK to save the new Loadrite Profile. With the profile created, the Mobile Unit Configuration can be configured.

Mobile Unit Configuration

In MobileUnitConfiguration, the LoadriteProfile attribute needs to be set for the equipment to use the LoadriteProfile reference group.

In the Reference Data tree view, click on the Mobile Settings reference group and click MobileUnitConfiguration. The Mobile Unit Configuration screen will open.

The Mobile Unit Configuration screen

Checkout the table and open the Mobile Unit Configuration for the Loadrite Profile.

The Loadrite Profile option in the Mobile Unit Configuration dialog

Select the relevant Loadrite Profile from the drop down.

Click OK to save the changes to the Mobile Unit Configuration.

Pitram Mobile User Interface

When the Loadrite profile configuration has been correctly implemented, Pitram Mobile will display a new icon for weighing:

The Wighing icon in Pitram Mobile

Hardware Diagnostics in Pitram Mobile will also display the Loadrite profile (the value of the HardwareDisplayName attribute from the LoadriteProfile reference group).

Pitram Mobile Hardware Diagnostics

Diagnostics for Loadrite display the following:

The Hardware Diagnostics display for the Loadrite profile

You should be able to scroll down and see the displayed numbers update as they are changed.

Logs

For troubleshooting, debugging and other related purposes; logs are created. The most relevant logs to the Loadrite configuration are located with other MDU logs (e.g. C:\ProgramData\Micromine\PITRAM\Logs).

Loadrite logs are named by date, port or profile, for example:

  • 2021-09-21-mdu_Port_COM7.log

  • 2021-09-21-mdu_Loadrite.log

Integrations