Automotive Diagnostic Command Set Toolkit Help

DoIP Send Vehicle Identification Request w EID.vi

  • Updated2024-08-07
  • 4 minute(s) read

DoIP Send Vehicle Identification Request w EID.vi

Purpose

Sends a UDP request to all DoIP-capable vehicles with a certain EID (MAC address) in the local subnet to identify themselves.

Format

diagram

Input

stringBroadcast Address is the subnet address to send the request to. It defaults to 255.255.255.255 (broadcast on the default Network Interface Controller), but can be overridden to specify a specific broadcast address, e.g. on a specific Network Interface Controller).
numeric clusterDiag reference in specifies the diagnostic session handle, obtained from Open Diagnostic on IP.vi and wired through subsequent diagnostic VIs. Normally, it is not necessary to manually manipulate the elements of this cluster.
stringEID is the Entity ID (usually the MAC address) of the DoIP entity assumed to respond. Specify the EID as xx-xx-xx-xx-xx-xx, where each x stands for a hexadecimal digit.
cluster error in is a cluster that describes error conditions occurring before the VI executes. If an error has already occurred, the VI returns the value of the error in cluster to error out.
boolean status is TRUE if an error occurred. This VI is not executed when status is TRUE.
long signed integer code is the error code number identifying an error. A value of 0 means success. A negative value means error: the VI did not execute the intended operation. A positive value means warning: the VI executed intended operation, but an informational warning is returned. For a description of the code, wire the error cluster to a LabVIEW error-handling VI, such as the Simple Error Handler.
string source identifies the VI where the error occurred.
booleanAll versions specifies whether the request is sent with 0xFF as the protocol version in the Generic DoIP header. The default is TRUE.

If the protocol version in Open Diagnostic on IP.vi is set to 2010, this flag is ignored and the request is always sent with the protocol version byte of the header set to 1.

Output

numeric clusterDiag reference out is a copy of Diag reference in. You can wire it to subsequent diagnostic VIs.
cluster error out describes error conditions. If the error in cluster indicated an error, the error out cluster contains the same information. Otherwise, error out describes the error status of this VI.
boolean status is TRUE if an error occurred.
long signed integer code is the error code number identifying an error. A value of 0 means success. A negative value means error: the VI did not execute the intended operation. A positive value means warning: the VI executed intended operation, but an informational warning is returned. For a description of the code, wire the error cluster to a LabVIEW error-handling VI, such as the Simple Error Handler.
string source identifies the VI where the error occurred.

Description

DoIP Send Vehicle Identification Request w EID.vi sends a Vehicle Identification Request to all DoIP entities in the local subnet identified by the given EID.

Usually, this is done as part of DoIP Get Entities.vi and does not need to be executed separately.

Log in to get a better experience