DLN_GPIO_PORT_SET_OUT_VAL Command and Response

The DLN_GPIO_PORT_SET_OUT_VAL command is used to set the output values for the specified GPIO port pins. If the pins are outputs, the values are applied immediately. If the pins are inputs, the values are stored in internal latches. These values will be applied when the pins become outputs.

DLN_GPIO_PORT_SET_OUT_VAL Command

Go to response

typedef struct
 {
    DLN_MSG_HEADER header;
    uint8_t port;
    uint8_t mask;	    	
    uint8_t values;	
 } __PACKED_ATTR	DLN_GPIO_PORT_SET_OUT_VAL_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_PORT_SET_OUT_VAL_CMD structure.
msgId	Identifies the message. For the DLN_GPIO_PORT_SET_OUT_VAL command it must be set to 0x0107. You can use the DLN_MSG_ID_GPIO_PORT_SET_OUT_VAL 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.

port

A port whose pins will be configured.

mask

A bit field that defines, which I/O lines are to be configured. Each of the eight bits, contained in the byte, corresponds to a pin of the port. The new configuration will be applied only to the pins with their mask bits set to 1. The configuration of pins with mask bits set to 0 will remain unchanged.

values

A bit field, which contains new port output values to be set. Note, that output values will be applied only for the pins with mask bits set to 1.

DLN_GPIO_PORT_SET_OUT_VAL Response

Go to command

The adapter sends the DLN_GPIO_PORT_SET_OUT_VAL response after the DLN_GPIO_PORT_SET_OUT_VAL command execution. The result field informs a user if the settings were successfully configured.

 typedef struct
 {
    DLN_MSG_HEADER header;		
    uint8_t result;				
 } __PACKED_ATTR DLN_GPIO_PORT_SET_OUT_VAL_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_PORT_SET_OUT_VAL_RSP structure.
msgId	Contains the message id. For the DLN_GPIO_PORT_SET_OUT_VAL response it is set to 0x0107. The DLN_MSG_ID_GPIO_PORT_SET_OUT_VAL 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_PORT_SET_OUT_VAL command DLN-series adapter can return the following result values:

Return Code	Description
DLN_RES_SUCCESS	Output values were successfully set.

DLN_GPIO_PORT_SET_OUT_VAL Command and Response