DCMD_I2C_SENDRECV
QNX SDP8.0Customizing a BSPConfigurationDeveloper
#include <hw/i2c.h>
#define DCMD_I2C_SENDRECV __DIOTF(_DCMD_I2C, 7, i2c_sendrecv_t)
The arguments to devctl() are:
Argument | Value |
---|---|
filedes | A file descriptor that you obtained by opening the device. |
dcmd | DCMD_I2C_SENDRECV |
dev_data_ptr | A pointer to a i2c_sendrecv_t that's followed by a buffer |
n_bytes | sizeof(i2c_sendrecv_t) plus the size of the buffer |
dev_info_ptr | NULL |
The DCMD_I2C_SENDRECV command executes a send followed by a receive. This sequence is typically used to read a slave device's register value. When multiple applications access the same slave device, it is necessary to execute this sequence atomically to prevent register reads from being interrupted.
- Input
- i2c_sendrecv_t — the message header
- uint8_t[] — a buffer, containing the send data, that's large enough to hold the receive data
- Output
- i2c_sendrecv_t — the message header (unchanged)
- uint8_t[] — the receive data in the buffer
The i2c_sendrecv_t structure is defined as:
typedef struct {
i2c_addr_t slave; /* slave address */
uint32_t send_len; /* length of send data in bytes */
uint32_t recv_len; /* length of receive data in bytes */
uint32_t stop; /* set stop when complete? */
} i2c_sendrecv_t;
If an error occurs, the command returns:
- EIO
- The master send failed. Causes include: bad slave address, bad bus speed, bus is busy.
- EFAULT
- An error occurred while accessing the data buffer.
- EINVAL
- Bad message format.
- ENOMEM
- Insufficient memory.
- EPERM
- The master is locked by another connection.
Page updated: