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

​
TCIL_ValueCommand, TCIL_ValueCommandRaw, TCIL_ValueCommandPhysical

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

  • long TCIL_ValueCommand(dbNode client, dword ddi, dword elementNumber); // form 1
  • long TCIL_ValueCommand(dword addressClient, dword ddi, dword elementNumber); // form 2
  • long TCIL_ValueCommand(dbNode tc, dbNode client, dword ddi, dword elementNumber); // form 3
  • long TCIL_ValueCommand(dbNode tc, dword addressClient, dword ddi, dword elementNumber); // form 4
  • long TCIL_ValueCommandRaw(dbNode client, dword ddi, dword elementNumber, long value); // form 5
  • long TCIL_ValueCommandRaw(dword addressClient, dword ddi, dword elementNumber, long value); // form 6
  • long TCIL_ValueCommandRaw(dbNode tc, dbNode client, dword ddi, dword elementNumber, long value); // form 7
  • long TCIL_ValueCommandRaw(dbNode tc, dword addressClient, dword ddi, dword elementNumber, long value); // form 8
  • long TCIL_ValueCommandPhysical(dbNode client, dword ddi, dword elementNumber, double value); // form 9
  • long TCIL_ValueCommandPhysical(dword addressClient, dword ddi, dword elementNumber, double value); // form 10
  • long TCIL_ValueCommandPhysical(dbNode tc, dbNode client, dword ddi, dword elementNumber, double value); // form 11
  • long TCIL_ValueCommandPhysical(dbNode tc, dword addressClient, dword ddi, dword elementNumber, double value); // form 12

​
Description

Form (1) and (3) send the current value of the specified data entity to the client with Value command. It can be used to send to the client the previously set Compressed State DDIs (using TCIL_SetValueRaw or TCIL_SetValuePhysical). Form (5)-(12) set the value to the specified data entity (if exists) and sends the value to the client with Value command.

​
Parameters

  • tc: Task Controller simulation node to apply the function.
  • client: Task Controller client node the TC sends the Value command to.
  • addressClient: Address of the Task Controller client node the TC sends the Value command to.
  • elementNumber: Element number, 0x000..0xFFF.
  • ddi: Data dictionary identifier, 0x0000..0xFFFF.
  • value: New value of the data entity.

​
Return Values

  • 0: Function has been executed successfully
  • < 0: An error has occurred, see IL Error Code

​
Example

Example form 11 
void SendSetpointMassPerAreaApplicationRate(long double value)
{
  long result;
  result = TCIL_ValueCommandPhysical(TC, Sprayer, 6, 1, value);
  switch (result)
  {
    case 0: TestStepPass(); break;
    case -2202: TestStepFail("Function is not available in passive mode of the TC IL!"); break;
    case -2204: TestStepFail("Node 'Sprayer' is no client device!"); break;
    case -2210: TestStepFail("Failed to send Value command!"); break;
    default: TestStepFail("Unexpected error"); break;
  }
}