DLN_GET_VER

DLN_GET_VER Command

Go to response

The DLN_GET_VER command retrieves the following data about the DLN adapter:

  • Hardware type - The type of the device (e.g. DLN-4);
  • Hardware version - The version of the hardware, used in the device;
  • Firmware version - The version of the firmware, installed in the device;
  • Server version - The version of the server;
  • Library version - The version of the DLN-library.
 typedef struct
 {
    DLN_MSG_HEADER header;	
 } __PACKED_ATTR DLN_GET_VER_CMD;

Parameters:

header

Defines the DLN message header DLN_MSG_HEADER. The header contains several predefined fields and is used to identify and route messages. When sending the command, a user must fill the following fields:

  • size - The size of the message. Must be equal to the size of the DLN_GET_VER_CMD structure.
  • msgId - Defines the message. For the DLN_GET_VER command it must be set to 0x0030. You can also use the DLN_MSG_ID_GET_VER constant.
  • echoCounter - Can be used to link a command to a response. The response will have the same echoCounter value. This field can be any numerical value from 0 to 0xFFFF (65536).
  • handle - A handle to the DLN-series adapter. You may specify either a handle to a specific device (stream) or the HDLN_ALL_DEVICES value.

DLN_GET_VER Response

Go to command

The adapter sends the DLN_GET_VER response after the command execution. The response will contain the retrieved information. 

 typedef struct
 {
    DLN_MSG_HEADER header;
    DLN_RESULT result;
    DLN_VERSION version;
 } __PACKED_ATTR DLN_GET_VER_RSP;

Parameters:

header

Defines the DLN message header DLN_MSG_HEADER. The response header contains the following fields:

  • size - The size of the message. It is equal to the size of the DLN_GET_VER_RSP structure.
  • msgId - Defines the message. For the DLN_GET_VER response it is set to 0x0030. The DLN_MSG_ID_GET_VER> constant can be used.
  • echoCounter - Links a command to a response. The echoCounter value is copied from the respective command header.
  • handle - A handle to the DLN-series adapter. Can be either a handle to a specific device (stream) or the HDLN_ALL_DEVICES value.
result

Contains the result of the command execution. The following values are available:

  • DLN_RES_SUCCESS - the information has been successfully retrieved.
version

The DLN_VERSION structure, containing the version information.