DlnI2cMasterSetMaxReplyCount() Function

The DlnI2cMasterSetMaxReplyCount() function sets maximum reply count for I²C master port.

DLN-1 and DLN-2 adapters cannot send a single slave address and direction bit without data bytes. This is a firmware driver limitation. Therefore, an adapter cannot read a single byte at all possible addresses. Retrying every read/write operation 10 times is set by default in firmware I²C driver, but using the DlnI2cMasterSetMaxReplyCount() function you can modify this parameter.

This function can be used only for DLN-1 and DLN-2 adapters.

Syntax

C/C++

DLN_RESULT DlnI2cMasterSetMaxReplyCount(
    HDLN handle, 
    uint8_t port, 
    uint16_t maxReplyCount
);

Parameters

handle: A handle to the DLN-series adapter.
port: A number of the I2C master port.
maxReplyCount: Maximum reply count value.

Return Value

DLN_RES_SUCCESS (0x00): The function set the maximum reply count successfully.
DLN_RES_INVALID_PORT_NUMBER (0xA8): The port number is not valid. Use the DlnI2cMasterGetPortCount() function to find the maximum possible port number.
DLN_RES_BUSY (0xB6): The function cannot change the maximum reply count while the I²C master port is busy transferring.
DLN_RES_INVALID_VALUE (0xE2): The provided value is zero or not valid.

Remarks

The DlnI2cMasterSetMaxReplyCount() function is defined in dln_i2c_master.h file.

Версия для печати

Вы здесь

Языки

Вход на сайт

Форма поиска

Вход на сайт