DLN_I2C_SLAVE_ENABLE Command and Response

The DLN_I2C_SLAVE_ENABLE command is used to activate the corresponding I2C slave port of your DLN-series adapter.

DLN_I2C_SLAVE_ENABLE Command

 typedef struct
 {
    DLN_MSG_HEADER header;
    uint8_t port;
 } __PACKED_ATTR DLN_I2C_SLAVE_ENABLE_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_I2C_SLAVE_ENABLE_CMD structure.
msgId	Identifies the message. For the DLN_I2C_SLAVE_ENABLE command it must be set to 0x0C01. You can use the DLN_MSG_ID_I2C_SLAVE_ENABLE 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 number of the I2C slave port to retrieve the information from.

DLN_I2C_SLAVE_ENABLE Response

Go to command

The adapter sends the DLN_I2C_SLAVE_ENABLE response after the DLN_I2C_SLAVE_ENABLE command execution. The result field informs a user if the specified I2C slave port has been successfully activated.

 typedef struct
 {
    DLN_MSG_HEADER header;
    DLN_RESULT result;
    uint16_t conflict;
 } __PACKED_ATTR DLN_I2C_SLAVE_ENABLE_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_I2C_SLAVE_ENABLE_RSP structure.
msgId	Contains the message id. For the DLN_I2C_SLAVE_ENABLE response it is set to 0x0C01. The DLN_MSG_ID_I2C_SLAVE_ENABLE 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_I2C_SLAVE_ENABLE command DLN-series adapter can return the following result values:

Return Code	Description
DLN_RES_SUCCESS	The specified I2C slave port has been successfully activated.

conflict

A pointer to an unsigned 16-bit integer. This integer can be filled with a number of the conflicted pin, if any.

A conflict arises if a pin is already assigned to another module of the DLN-series adapter and cannot be used by the I2C module. To fix this a user has to disconnect a pin from a module that it has been assigned to and send the DLN_I2C_SLAVE_ENABLE command once again. In case there still are conflicted pins, only the number of the next one will be returned.

DLN_I2C_SLAVE_ENABLE Command and Response