--- title: Error Handling Settings slug: legacy-doc-gk2/error-handling-settings icon: 🔧 createdAt: 2024-01-14T23:54:54.262Z --- :::hint{type="info"} The following settings are related to error handling limits and behaviours once triggered on the micro**DRIVE** units. The unit limits are also handled within these settings. ::: ### Bus Current Limit | **Description** | Limits the maximum current limit allowed on the bus. The unit will cap the maximum power output at the limit setpoint. | | --------------- | ---------------------------------------------------------------------------------------------------------------------- | | **CAN Name** | BUS\_CUR\_LIM | | **Units** | Units are in Amps (A) | | **Advanced** | NO | ### Motor Temperature Limit | **Description** | The maximum temperature to allow the connected sensor within the motor to reach. Once the temperature is reached, the motor temperature response behaviour is triggered. | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **CAN Name** | MOT\_OVT\_LIM | | **Units** | Units are in Degrees Celsius (°C) | | **Advanced** | YES | ### Motor Temperature Response | **Description** | The response to apply when the motor temperature limit is reached. | | --------------- | ------------------------------------------------------------------ | | **CAN Name** | MOT\_OVT\_RESP | | **Units** | N/A | | **Advanced** | YES | **Value Mappings**: - 0 -> None - 1 -> Limit ### Motor Temperature Sensing | **Description** | Toggle the motor temperature sensor function. Enabling will introduce motor temperature measurement and limiting. | | --------------- | ----------------------------------------------------------------------------------------------------------------- | | **CAN Name** | MOT\_T\_EN | | **Units** | N/A | | **Advanced** | YES | ### Motor Temperature Sensor Coefficient | **Description** | The motor temperature sensor coefficient. The temperature coefficient is accessible from the sensor datasheet. | | --------------- | -------------------------------------------------------------------------------------------------------------- | | **CAN Name** | MOT\_T\_COEFF | | **Units** | N/A | | **Advanced** | YES | ### Motor Temperature Sensor Nominal Resistance | **Description** | The motor temperature sensor nominal resistance coefficient. The coefficient is accessible from the sensor datasheet. | | --------------- | --------------------------------------------------------------------------------------------------------------------- | | **CAN Name** | MOT\_T\_NOMR | | **Units** | N/A | | **Advanced** | YES | ### Motor Temperature Sensor Nominal Temperature | **Description** | The motor temperature sensor nominal resistance coefficient. The coefficient is accessible from the sensor datasheet. | | --------------- | --------------------------------------------------------------------------------------------------------------------- | | **CAN Name** | MOT\_T\_NOMT | | **Units** | N/A | | **Advanced** | YES | ### Motor Temperature Sensor Type | **Description** | Selection of sensor type embedded into the motor, for use with motor temperature sensing. | | --------------- | ----------------------------------------------------------------------------------------- | | **CAN Name** | MOT\_T\_TYPE | | **Units** | N/A | | **Advanced** | YES | **Value Mappings**: - 0 -> NTC - 1 -> PT100 - 2 -> PT1000 ### Over Temperature Duty Limit | **Description** | The maximum duty cycle limit for the Over Temperature Response | | --------------- | -------------------------------------------------------------- | | **CAN Name** | OVT\_RAMP\_DTY\_MIN | | **Units** | Units are in % duty cycle (%) | | **Advanced** | YES | ### Over Temperature Limit | **Description** | The limit at which over-temperature event activation occurs on the controller. The over-temperature response setting defines the behaviour. Note that the controller has a separate hard temperature limit at 135C at which point the controller will shutdown. | | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **CAN Name** | TEMP\_LIM | | **Units** | Units are in Degrees Celsius (°C) | | **Advanced** | NO | ### Over Temperature Ramp End Temperature | **Description** | Temperature at which the ramp should end when using "Power Ramp" Over Temperature Response. At this temperature the maximum duty cycle is limited to Over Temperature Duty Limit. | | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **CAN Name** | OVT\_RAMP\_TEMP | | **Units** | Units are in Degrees Celsius (°C) | | **Advanced** | NO | ### Over Temperature Response | **Description** | The response to apply to limit maximum output duty cycle when the temperature limit is reached on the controller. "Power Step" sets the maximum duty to "Over Temperature Duty Limit". "Power Ramp" linearly ramps the maximum duty cycle from 100 at "Temperature Limit" to "Over Temperature Duty Limit" at "Over Temperature Ramp End Temperature". "None" does not apply any limits to maximum output duty cycle. Note that the controller has a separate hard temperature limit at 135C at which point the controller will shutdown. | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **CAN Name** | OVT\_RESP | | **Units** | N/A | | **Advanced** | NO | **Value Mappings**: - 0 -> Power Step - 1 -> Power Ramp - 2 -> None ### Overvoltage Limit Response | **Description** | Behaviour response when configured over-voltage limit on the bus is triggered. Bus voltage exceeded the limit. | | --------------- | -------------------------------------------------------------------------------------------------------------- | | **CAN Name** | OVV\_LIM\_RES | | **Units** | N/A | | **Advanced** | YES | **Value Mappings**: - 0 -> Limit Duty Cycle Output - 1 -> Hard Shutdown - 2 -> Disabled ### Overvoltage Threshold | **Description** | The maximum voltage to allow the unit to operate up to before triggering overvoltage response. | | --------------- | ---------------------------------------------------------------------------------------------- | | **CAN Name** | OVV\_START | | **Units** | Units are in Volts (V) | | **Advanced** | YES | ### Phase Current Limit | **Description** | The current limit to apply to drive on the phase/output from the controller. | | --------------- | ---------------------------------------------------------------------------- | | **CAN Name** | PH\_CUR\_LIM | | **Units** | Units are in Amps (A) | | **Advanced** | NO | ### PTC Offset Resistance | **Description** | Offset resistance calculated by the ESC when using PTC temperature sensors. | | --------------- | --------------------------------------------------------------------------- | | **CAN Name** | PTC\_OFST\_RES | | **Units** | N/A | | **Advanced** | YES | ### PTC Reference Temperature | **Description** | Reference temperature value to calibrate motor temperature measured by the PTC. This value should be the actual temperature of the PTC sensor. When this value is set to non-zero, the PTC temperature calibration runs and calculates the offset resistance, and this value is set back to zero. | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **CAN Name** | PTC\_REF\_TEMP | | **Units** | N/A | | **Advanced** | YES | ### Signal Timeout Period | **Description** | A timeout period where no valid signal is present results in shutting the output drive. The drive will be resumed once a valid signal is returned and the throttle is 0%. If the Arm message timeout period is less than this setting, the Arm timeout period will take precedence. | | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **CAN Name** | RX\_TIMEOUT | | **Units** | Units are in Milliseconds (Ms) | | **Advanced** | YES | ### Start-Up Bridge Tests | **Description** | Run bridge self-tests when the unit powers on. | | --------------- | ---------------------------------------------- | | **CAN Name** | BRIDGE\_TST\_EN | | **Units** | N/A | | **Advanced** | YES | ### Undervoltage Limit Response | **Description** | Behaviour response when configured under voltage limit on the bus is triggered. Bus voltage below the limit. | | --------------- | ------------------------------------------------------------------------------------------------------------ | | **CAN Name** | UVV\_LIM\_RES | | **Units** | N/A | | **Advanced** | YES | **Value Mappings**: - 0 -> Limit Duty Cycle Output - 1 -> Hard Shutdown - 2 -> Disabled ### Undervoltage Threshold | **Description** | The minimum voltage to allow the unit to operate up to before triggering under voltage response. | | --------------- | ------------------------------------------------------------------------------------------------ | | **CAN Name** | UVV\_START | | **Units** | Units are in Volts (V) | | **Advanced** | YES |