DlnSpiMasterReadWrite() Function

The DlnSpiMasterReadWrite() function sends and receives data via SPI bus. The received and sent data are arrays of 1-byte elements. This function is suited to transmit data frames of 8 bits or less. In case you set a frame size more than 8 bits, it is advised to use the DlnSpiMasterReadWrite16() [1] function.

Syntax

C/C++

DLN_RESULT DlnSpiMasterReadWrite(
    HDLN handle, 
    uint8_t port, 
    uint16_t size, 
    uint8_t *writeBuffer, 
    uint8_t *readBuffer
);

Parameters

handle: A handle to the DLN-series adapter.
port: A number of the selected SPI master port.
size: The size of the message buffer. This parameter is specified in bytes. The maximum value is 256 bytes.
writeBuffer: A pointer to an array of unsigned 8-bit integers that receives data to be sent to a slave during the function execution.
readBuffer: A pointer to an array of unsigned 8-bit integers that receives data from the slave during the function execution.

Return Value

DLN_RES_SUCCESS (0x00): The function successfully transmitted data.
DLN_RES_INVALID_PORT_NUMBER (0xA8): The port number is not valid. Use the DlnSpiMasterGetPortCount() [2] function to find the maximum possible port number.
DLN_RES_DISABLED (0xB7): The SPI master port is disabled. Use the DlnSpiMasterEnable() [3] function to activate the SPI master port.

Remarks

The DlnSpiMasterReadWrite() function is defined in dln_spi_master.h file.