Skip to main content

​
DoIP_ConfigureRoutingActivationRetries

Valid for: CANoe DE

​
Function Syntax

void DoIP_ConfigureRoutingActivationRetries(dword numberOfRetries,
dword retryPeriod_ms, byte nackCodes[], dword nackCodesCount);

​
Description

Allows to activate or deactivate DoIP routing activation retries. Retries are only attempted for specific negative ACK codes that can be given in a list of codes. There is a default list that is used when nackCodesCount is 0.

​
Parameters

  • numberOfRetries: Routing activation will be retried this many times. The feature can be deactivated with a value of 0 (default).
  • retryPeriod_ms: Time to wait between the failure of the routing activation and the next try. Must be > 0 if numberOfRetries is > 0.
  • nackCodes: Array of negative ACK codes that will lead to a retry.
  • nackCodesCount: Number of negative ACK codes in the array. If this value is 0, a default will be activated that consists of the values 0x04 and 0x11.

​
Return Values

—

​
Example

ActivateRetries()
{
  byte nackCodes[1];
  // Perform up to 3 retries when the default codes 0x04 or 0x11 are returned
  DoIP_ConfigureRoutingActivationRetries(3, 100, nackCodes, 0);
}

DeactivateRetries()
{
  byte nackCodes[1];
  // Turn off retries
  DoIP_ConfigureRoutingActivationRetries(0, 0, nackCodes, 0);
}
DoIP_ConfigureRoutingActivationRequest • DoIP_ConfigureRoutingActivationResponse • _DoIP_RoutingActivationRequest