Skip to main content
Open topic with navigation CAPL Functions » ISO11783 » Virtual Terminal Interaction Layer (VT IL) » VTIL_EnableAddressViolationDetection

​
VTIL_EnableAddressViolationDetection

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

long VTIL_EnableAddressViolationDetection(dword numberOfDM1Transmissions); // form 1
long VTIL_EnableAddressViolationDetection(dbNode node, dword numberOfDM1Transmissions); // form 2

​
Description

Activates detection of address violations by other nodes. Address violation means that a message is registered on the bus with the source address of the simulated node that was not sent by the simulated node itself. If an address violation is detected, the simulated node sends an Address Claimed message. If diagnostics support is activated (via VTIL_ActivateDiagnosticsSupport) then the node also sends message DM1 with SPN=2000+nodeAddress, FMI=31 and OC=1. This behavior can be influenced by implementing the function VTIL_OnAddressViolation.

​
Parameters

  • numberOfDM1Transmissions
    • 1..0xFFFFFFFF: activates the detection of address violations
    • 0: deactivates detection of address violations
    If value is >0 and an address violation is detected and diagnostics support is activated then message DM1 is sent numberOfDM1Transmissions times. If numberOfDM1Transmissions is 0xFFFFFFFF then sending of DM1 is not stopped.
  • node
    • Simulation node to apply the function.

​
Return Values

  • 0
    • Function has been executed successfully
  • < 0

​
Example

—