DLN_GPIO_PIN_GET_DIRECTION Command and Response

The DLN_GPIO_PIN_GET_DIRECTION command is used to retrieve currently set direction of the pin.

DLN_GPIO_PIN_GET_DIRECTION Command

Syntax

C/C++

 typedef struct
 {
    DLN_MSG_HEADER header;
    uint8_t pin;
 } __PACKED_ATTR DLN_GPIO_PIN_GET_DIRECTION_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. You must fill the following fields before sending the command:

Field	Description
size	The size of the message. Must be equal to the size of the DLN_GPIO_PIN_GET_DIRECTION_CMD structure.
msgId	Identifies the message. For the DLN_GPIO_PIN_GET_DIRECTION command it must be set to 0x0114. You can use the DLN_MSG_ID_GPIO_PIN_GET_DIRECTION 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.

Pin

A number of the pin to retrieve the information from.

DLN_GPIO_PIN_GET_DIRECTION Response

Go to command

The adapter sends the DLN_GPIO_PIN_GET_DIRECTION response after the DLN_GPIO_PIN_GET_DIRECTION command execution. The response contains currently selected direction of the specified pin.

Syntax

C/C++

 typedef struct
 {
    DLN_MSG_HEADER header;
    DLN_RESULT result;
    uint8_t pin;
    uint8_t direction;
 } __PACKED_ATTR DLN_GPIO_PIN_GET_DIRECTION_RSP;

Parameters:

header

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

Field	Description
size	The size of the message. It is equal to the size of the DLN_GPIO_PIN_GET_DIRECTION_RSP structure.
msgId	Contains the message id. For the DLN_GPIO_PIN_GET_DIRECTION response it is set to 0x0114. The DLN_MSG_ID_GPIO_PIN_GET_DIRECTION constant can be used to check the message ID.
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. You can use the handle field to determine the adapter that have sent the response.

result

Contains the result of the command execution. For DLN_GPIO_PIN_GET_DIRECTION command DLN-series adapter can return the following result values:

Return Code	Description
DLN_RES_SUCCESS	Current pin direction has been successfully retrieved.
DLN_RES_INVALID_PIN_NUMBER	Invalid pin number was specified.

pin

Contains a number of the pin.

direction

Contains the currently set direction of the specified pin. The following values are available:

Value	Description
1	The pin is an output.
0	The pin is an input.

DLN_GPIO_PIN_GET_DIRECTION Command and Response