Logan Clutch Integration

The Logan Clutch integration lets the Pump Display app monitor the Logan Clutch Controller (LCC), clutch pressure, and controller diagnostics. It is read-only: the app does not send CAN control commands to the LCC.

NOTE: The integration was introduced in display app version 3.3.0.

NOTE: this integration requires the following software versions at minimum:

App v3.3.0
Controller 3 (M3600) v1.3.1
Logan Clutch controller v1.0.0

Enable the Integration

Configuration:

Logan Clutch Integration (loganClutchIntegration): Unit Config 1 > Clutch Settings. This setting is disabled by default.
High Pressure Warning Setpoint: 245 PSI by default, with an allowed range of 200 PSI to 250 PSI.
Low Pressure Warning Setpoint: 185 PSI by default, with an allowed range of 180 PSI to 200 PSI.

The Clutch Info page is available when the unit’s clutch is enabled. Enable Logan Clutch Integration before using LCC-specific readings or adding LCC data to Spoke.Zone dashboards.

The warning setpoints are application-level warnings. They do not replace the LCC’s own high- and low-pressure failsafes.

Clutch Info

The Clutch Info page includes:

Watchdog Sensor: raw voltage and pressure reading.
Logan Clutch Sensor: raw voltage, pressure reading, and supply voltage. Supply voltage is an average of five samples.
Logan Clutch Error History: the 10 most recent LCC errors, newest first. Each entry includes its description, timestamp, and the Logan Clutch and Watchdog pressure readings captured when the error occurred. The history and total-error count are kept in memory for the current app run.
Service Info:
- Lifetime clutch engaged time (reset from Diagnostics)
- LCC cycle count: the total number of cycles/operations performed by the LCC to date

The newest error is highlighted red while the LCC remains in an error state.

Watchdog Pressure Errors

The configurable warning setpoints are designed to create a ladder logic system for clutch pressure monitoring. The allowed ranges for the warning setpoints are set so that the warnings will be triggered before the LCC fail-safes kick in.

For example, if the high pressure warning setpoint is set to 240 PSI, an increasing clutch pressure will first hit the warning threshold, which triggers an engine idle to try and mitigate the problem. If this succeeds, operation can continue on and the LCC fail-safe will not be triggered. However, if pressure continues to increase and reaches the LCC fail-safe threshold of 250 PSI (which is nonconfigurable), then the clutch will be disengaged and the app will run a full unit stop as quickly as possible. The same flow is used for low pressure errors.

All pressure-related errors are cleared once the pressure reading returns to the “safe” range.

NOTE: The system is currently only available for units with a Logan Clutch; however, there are plans to extend the functionality to all clutched units.

LCC Diagnostic Status

The LCC reports its diagnostic status over CAN. Codes 0 through 4 are normal or transitional states:

0: Normal operation.
1: Initial fill sequence.
2: Adjusting up to setpoint.
3: Adjusting down to setpoint.
4: No operation.

Codes 10 through 16 are critical faults:

10 (LCC_SupplyOvervoltage): Overvoltage detected on the supply voltage.
11 (LCC_PressureFeedbackTimeout): No transducer feedback was received before the timeout.
12 (ClutchLowPressure): The low clutch pressure failsafe was triggered.
13 (ClutchHighPressure): The high clutch pressure failsafe was triggered.
14 (LCC_CANTimeout): No CAN control messages were received before the timeout.
15 (LCC_LowEngineSpeed): The low engine speed failsafe was triggered.
16 (LCC_HighEngineSpeed): The high engine speed failsafe was triggered.

Closing the error popup acknowledges and clears the app error. The error also clears automatically when the LCC reports an OK status. The app records both pressure readings with each LCC error so the operator can compare the Logan Clutch and Watchdog readings at the time of the event.

Spoke.Zone Monitoring

When Logan Clutch Integration is enabled, the app publishes the Logan Clutch pressure reading to Spoke.Zone as logan_clutch_pressure_sensor_reading. The Spoke.Zone error handler also receives the LCC and clutch-pressure error signals for dashboard monitoring, including supply overvoltage, pressure-feedback timeout, CAN timeout, engine-speed failsafes, and high- or low-pressure errors.

Current Scope

The app does not send control commands to the LCC. The following items are not part of the current integration:

A current LCC status widget.
LCC cycle count in Service Info.
Reading the LCC control setpoint dynamically over CAN.
Robust differentiation between LCC-specific clutch features and general clutch features.
- Ex: a centralized ladder logic alarm system for pressure readings with a configurable “primary” reading.