Symbols

loading...

Files

loading (2/5)...

Summary Syntax Arguments References Call Tree Data Use

SourceVuESP-IDF Framework and ExamplesESP-IDFi2c_master_read()

i2c_master_read() function

Queue a "read (multiple) bytes" command to the commands list. Multiple bytes will be read on the I2C bus. This function shall only be called in I2C master mode. Call `i2c_master_cmd_begin()` to send all queued commands

Syntax

Show:

Summary

Declaration

Definition

esp_err_t i2c_master_read(i2c_cmd_handle_t cmd_handle, uint8_t *data, size_t data_len, i2c_ack_type_t ack);

Implemented in i2c.c:1367

Arguments

Argument

Description

cmd_handle

I2C commands list

data

Pointer where the received bytes will the stored. This buffer shall remain **valid** until the transaction is finished.

data_len

Size, in bytes, of the `data` buffer

ack

ACK signal

Return value

- ESP_OK Success - ESP_ERR_INVALID_ARG Parameter error - ESP_ERR_NO_MEM The static buffer used to create `cmd_handler` is too small - ESP_FAIL No more memory left on the heap

References

Code

Location

Referrer

esp_err_t i2c_master_read(i2c_cmd_handle_t cmd_handle, uint8_t *data, size_t data_len, i2c_ack_type_t ack)

esp_err_t i2c_master_read(i2c_cmd_handle_t cmd_handle, uint8_t *data, size_t data_len, i2c_ack_type_t ack);

ESP_GOTO_ON_ERROR(i2c_master_read(cmd_link, buffer, buffer_size, I2C_MASTER_LAST_NACK), err, TAG, "read data failed");

esp_lcd_panel_io_i2c_v1.c:136

panel_io_i2c_rx_buffer()

err = i2c_master_read(handle, read_buffer, read_size, I2C_MASTER_LAST_NACK);

i2c_master_read_from_device()

err = i2c_master_read(handle, read_buffer, read_size, I2C_MASTER_LAST_NACK);

i2c_master_write_read_device()

Call Tree

i2c_master_read() is called by 3 functions and calls 4 functions:

i2c_master_read_from_device()

i2c_master_write_read_device()

panel_io_i2c_rx_buffer()

i2c_master_read()

esp_log_timestamp()

esp_log_write()

i2c_master_read_static()

i2c_master_read_byte()

Data Use

i2c_master_read() reads 10 variables:

esp_log_level_t::ESP_LOG_ERROR

esp_log_level_t::ESP_LOG_WARN

esp_log_level_t::ESP_LOG_INFO

esp_log_level_t::ESP_LOG_DEBUG

esp_log_level_t::ESP_LOG_VERBOSE

i2c_ack_type_t::I2C_MASTER_ACK

i2c_ack_type_t::I2C_MASTER_NACK

i2c_ack_type_t::I2C_MASTER_LAST_NACK

i2c_ack_type_t::I2C_MASTER_ACK_MAX

i2c_master_read()

Class Tree

All items filtered out

All items filtered out

Override Tree

All items filtered out

All items filtered out

Implementations

All items filtered out

All items filtered out

Instances

Lifecycle

All items filtered out

All items filtered out