Skip to main content
Open topic with navigation CAPL Functions » ISO11783 » Task Controller Interaction Layer (TC IL) » TCIL_OnAddressClaimConflict

​
TCIL_OnAddressClaimConflict (Callback)

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

dword TCIL_OnAddressClaimConflict(dword addressArbitrationResult, dword nextAddress, dword& suppressAddressClaimed);

​
Description

This callback function is called by any interaction layer that detects an address conflict. A conflict occurs if another node sends an Address Claim Message from the same address with or without preceding request. Additionally, the callback is called when an ISOBUS Interaction Layer sends a Request for Address Claim at initialization time and its preferred address is already used, regardless of the priority of the device name. If the IL is Arbitrary Address Capable the parameter nextAddress is set to the next available address beginning with 0x80, else nextAddress is set to 0xFE (Null Address). If the arbitration is won, nextAddress is set to current (preferred) address. This callback can be used to define custom rules for address resolution and to override the suggested address. To use the callback, make sure the ILs property AddressClaimSupport is set to ExtendedAddressClaimSupport (2).

​
Parameters

  • addressArbitrationResult
    • 0: Arbitration won
    • 1: Arbitration lost
    • 2: Address already in use and current ECU won
    • 3: Address already in use and current ECU lost
  • nextAddress
    • The address the IL will claim if not overridden.
  • suppressAddressClaimed
    • Set to 1, if the ACL message shall be suppressed.

​
Return Values

  • 0..254
    • The new address that shall be claimed.

​
Example

variables
{
  byte lastUsedAddress = 0x80;

  enum AddressClaimSupport
  {
    NoAddressClaimSupport        = 0,
    BasicAddressClaimSupport     = 1,
    ExtendedAddressClaimSupport  = 2
  };
}

on preStart
{
  TCIL_SetNodeProperty("AddressClaimSupport", ExtendedAddressClaimSupport);
}

dword TCIL_OnAddressClaimConflict(dword addressArbitrationResult, dword nextAddress, dword& suppressAddressClaimed)
{
  if (addressArbitrationResult == 1 || addressArbitrationResult == 3)
  {
    if(lastUsedAddress < 0xFE)
    {
      // calculate new address and return it so the IL uses it for address claiming
      lastUsedAddress++;
      write("Node_A claims new address %u", lastUsedAddress);
      return lastUsedAddress;
    }
  }
  return nextAddress;
}