Skip to main content

​
Iso11783PDDChangeDesignator

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

long Iso11783PDDChangeDesignator( dword ecuHandle, word objectID, char asciiDesignator[] );
long Iso11783PDDChangeDesignator( dword ecuHandle, word objectID, char asciiDesignator[], byte encoding );

​
Description

The function sends a Change Designator message with a new object designator to the Task Controller. The first variant converts the ASCII designator string to an UTF-8 string if the supported version is 2 or higher. In the second variant you can specify if the designator string shall be encoded to UTF-8 or not.

​
Parameters

  • ecuHandle: Handle of the ECU. The handle must be created with Iso11783CreateECU beforehand or ZERO for general parameters.
  • objectID: ID of the object.
  • asciiDesignator: New object designator.
  • encoding: Specifies if the designator is encoded before it is transmitted or not
    • 0: designator string is not encoded
    • 1: designator string is encoded to UTF-8

​
Return Values

error code

​
Example

Example 1 
if (Iso11783PDDChangeDesignator( ecuHandle, 1, "myNewDesignator" ) == 0) {
  write( "Change Designator command is sent successfully" );
}
Example 2 (avoid encoding because string is already UTF-8 string encoded) 
char euroSign[255];
euroSign.byte(0) = 0xE2;
euroSign.byte(1) = 0x82;
euroSign.byte(2) = 0xAC;
euroSign.byte(3) = 0;

if (Iso11783PDDChangeDesignator( ecuHandle, 1, euroSign, 0 ) == 0) {
  write( "Command to change designator to '€' is sent successfully" );
}