fix(i2c_master): Fix an I2C issue that slave streth happen but master timeout set seems doesn't work

Closes https://github.com/espressif/esp-idf/issues/14129
Closes https://github.com/espressif/esp-idf/issues/14401
This commit is contained in:
C.S.M 2024-08-22 16:20:29 +08:00
parent 561f46d989
commit deb91c7abe
8 changed files with 67 additions and 55 deletions

View File

@ -46,6 +46,8 @@ static const char *TAG = "i2c.master";
#define I2C_FIFO_LEN(port_num) (SOC_I2C_FIFO_LEN) #define I2C_FIFO_LEN(port_num) (SOC_I2C_FIFO_LEN)
#endif #endif
#define I2C_CLR_BUS_TIMEOUT_MS (50) // 50ms is sufficient for clearing the bus
static esp_err_t s_i2c_master_clear_bus(i2c_bus_handle_t handle) static esp_err_t s_i2c_master_clear_bus(i2c_bus_handle_t handle)
{ {
#if !SOC_I2C_SUPPORT_HW_CLR_BUS #if !SOC_I2C_SUPPORT_HW_CLR_BUS
@ -554,23 +556,13 @@ static esp_err_t s_i2c_transaction_start(i2c_master_dev_handle_t i2c_dev, int xf
i2c_master->rx_cnt = 0; i2c_master->rx_cnt = 0;
i2c_master->read_len_static = 0; i2c_master->read_len_static = 0;
i2c_hal_master_set_scl_timeout_val(hal, i2c_dev->scl_wait_us, i2c_master->base->clk_src_freq_hz);
if (!i2c_master->base->is_lp_i2c) {
I2C_CLOCK_SRC_ATOMIC() {
i2c_ll_set_source_clk(hal->dev, i2c_master->base->clk_src);
}
}
#if SOC_LP_I2C_SUPPORTED
else {
LP_I2C_SRC_CLK_ATOMIC() {
lp_i2c_ll_set_source_clk(hal->dev, i2c_master->base->clk_src);
}
}
#endif
I2C_CLOCK_SRC_ATOMIC() { I2C_CLOCK_SRC_ATOMIC() {
i2c_hal_set_bus_timing(hal, i2c_dev->scl_speed_hz, i2c_master->base->clk_src, i2c_master->base->clk_src_freq_hz); i2c_hal_set_bus_timing(hal, i2c_dev->scl_speed_hz, i2c_master->base->clk_src, i2c_master->base->clk_src_freq_hz);
} }
// Set the timeout value
i2c_hal_master_set_scl_timeout_val(hal, i2c_dev->scl_wait_us, i2c_master->base->clk_src_freq_hz);
i2c_ll_master_set_fractional_divider(hal->dev, 0, 0); i2c_ll_master_set_fractional_divider(hal->dev, 0, 0);
i2c_ll_update(hal->dev); i2c_ll_update(hal->dev);
@ -909,6 +901,19 @@ esp_err_t i2c_new_master_bus(const i2c_master_bus_config_t *bus_config, i2c_mast
} }
ESP_GOTO_ON_ERROR(i2c_param_master_config(i2c_master->base, bus_config), err, TAG, "i2c configure parameter failed"); ESP_GOTO_ON_ERROR(i2c_param_master_config(i2c_master->base, bus_config), err, TAG, "i2c configure parameter failed");
if (!i2c_master->base->is_lp_i2c) {
I2C_CLOCK_SRC_ATOMIC() {
i2c_ll_set_source_clk(hal->dev, i2c_master->base->clk_src);
}
}
#if SOC_LP_I2C_SUPPORTED
else {
LP_I2C_SRC_CLK_ATOMIC() {
lp_i2c_ll_set_source_clk(hal->dev, i2c_master->base->clk_src);
}
}
#endif
i2c_master->bus_lock_mux = xSemaphoreCreateBinaryWithCaps(I2C_MEM_ALLOC_CAPS); i2c_master->bus_lock_mux = xSemaphoreCreateBinaryWithCaps(I2C_MEM_ALLOC_CAPS);
ESP_GOTO_ON_FALSE(i2c_master->bus_lock_mux, ESP_ERR_NO_MEM, err, TAG, "No memory for binary semaphore"); ESP_GOTO_ON_FALSE(i2c_master->bus_lock_mux, ESP_ERR_NO_MEM, err, TAG, "No memory for binary semaphore");
xSemaphoreGive(i2c_master->bus_lock_mux); xSemaphoreGive(i2c_master->bus_lock_mux);

View File

@ -583,7 +583,7 @@ static inline void i2c_ll_get_stop_timing(i2c_dev_t *hw, int *setup_time, int *h
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param ptr Pointer to data buffer * @param ptr Pointer to data buffer
* @param len Amount of data needs to be writen * @param len Amount of data needs to be written
* *
* @return None. * @return None.
*/ */
@ -647,7 +647,7 @@ static inline void i2c_ll_master_get_filter(i2c_dev_t *hw, uint8_t *filter_conf)
} }
/** /**
* @brief Reste I2C master FSM. When the master FSM is stuck, call this function to reset the FSM * @brief reset I2C master FSM. When the master FSM is stuck, call this function to reset the FSM
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* *
@ -675,7 +675,7 @@ static inline void i2c_ll_master_clr_bus(i2c_dev_t *hw, uint32_t slave_pulses)
hw->scl_sp_conf.scl_rst_slv_num = slave_pulses; hw->scl_sp_conf.scl_rst_slv_num = slave_pulses;
hw->scl_sp_conf.scl_rst_slv_en = 1; hw->scl_sp_conf.scl_rst_slv_en = 1;
hw->ctr.conf_upgate = 1; hw->ctr.conf_upgate = 1;
// hardward will clear scl_rst_slv_en after sending SCL pulses, // hardware will clear scl_rst_slv_en after sending SCL pulses,
// and we should set conf_upgate bit to synchronize register value. // and we should set conf_upgate bit to synchronize register value.
while (hw->scl_sp_conf.scl_rst_slv_en); while (hw->scl_sp_conf.scl_rst_slv_en);
hw->ctr.conf_upgate = 1; hw->ctr.conf_upgate = 1;
@ -756,7 +756,8 @@ static inline bool i2c_ll_master_is_cmd_done(i2c_dev_t *hw, int cmd_idx)
static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us) static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us)
{ {
uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000); uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000);
return 31 - __builtin_clz(clk_cycle_num_per_us * timeout_us); // round up to an integer
return 32 - __builtin_clz(clk_cycle_num_per_us * timeout_us);
} }
//////////////////////////////////////////Deprecated Functions////////////////////////////////////////////////////////// //////////////////////////////////////////Deprecated Functions//////////////////////////////////////////////////////////
@ -791,7 +792,7 @@ typedef enum {
* @brief Configure I2C SCL timing * @brief Configure I2C SCL timing
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param high_period The I2C SCL hight period (in core clock cycle, hight_period > 2) * @param high_period The I2C SCL height period (in core clock cycle, hight_period > 2)
* @param low_period The I2C SCL low period (in core clock cycle, low_period > 1) * @param low_period The I2C SCL low period (in core clock cycle, low_period > 1)
* @param wait_high_period The I2C SCL wait rising edge period. * @param wait_high_period The I2C SCL wait rising edge period.
* *
@ -906,7 +907,7 @@ static inline void i2c_ll_master_disable_rx_it(i2c_dev_t *hw)
* @brief Configure I2C SCL timing * @brief Configure I2C SCL timing
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param hight_period The I2C SCL hight period (in core clock cycle, hight_period > 2) * @param hight_period The I2C SCL height period (in core clock cycle, hight_period > 2)
* @param low_period The I2C SCL low period (in core clock cycle, low_period > 1) * @param low_period The I2C SCL low period (in core clock cycle, low_period > 1)
* *
* @return None. * @return None.

View File

@ -663,7 +663,7 @@ static inline void i2c_ll_get_stop_timing(i2c_dev_t *hw, int *setup_time, int *h
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param ptr Pointer to data buffer * @param ptr Pointer to data buffer
* @param len Amount of data needs to be writen * @param len Amount of data needs to be written
* *
* @return None. * @return None.
*/ */
@ -698,7 +698,7 @@ static inline void i2c_ll_read_rxfifo(i2c_dev_t *hw, uint8_t *ptr, uint8_t len)
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param ram_offset Offset value of I2C RAM. * @param ram_offset Offset value of I2C RAM.
* @param ptr Pointer to data buffer * @param ptr Pointer to data buffer
* @param len Amount of data needs to be writen * @param len Amount of data needs to be written
*/ */
static inline void i2c_ll_write_by_nonfifo(i2c_dev_t *hw, uint8_t ram_offset, const uint8_t *ptr, uint8_t len) static inline void i2c_ll_write_by_nonfifo(i2c_dev_t *hw, uint8_t ram_offset, const uint8_t *ptr, uint8_t len)
{ {
@ -770,7 +770,7 @@ static inline void i2c_ll_master_get_filter(i2c_dev_t *hw, uint8_t *filter_conf)
} }
/** /**
* @brief Reste I2C master FSM. When the master FSM is stuck, call this function to reset the FSM * @brief reset I2C master FSM. When the master FSM is stuck, call this function to reset the FSM
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* *
@ -798,7 +798,7 @@ static inline void i2c_ll_master_clr_bus(i2c_dev_t *hw, uint32_t slave_pulses)
hw->scl_sp_conf.scl_rst_slv_num = slave_pulses; hw->scl_sp_conf.scl_rst_slv_num = slave_pulses;
hw->scl_sp_conf.scl_rst_slv_en = 1; hw->scl_sp_conf.scl_rst_slv_en = 1;
hw->ctr.conf_upgate = 1; hw->ctr.conf_upgate = 1;
// hardward will clear scl_rst_slv_en after sending SCL pulses, // hardware will clear scl_rst_slv_en after sending SCL pulses,
// and we should set conf_upgate bit to synchronize register value. // and we should set conf_upgate bit to synchronize register value.
while (hw->scl_sp_conf.scl_rst_slv_en); while (hw->scl_sp_conf.scl_rst_slv_en);
hw->ctr.conf_upgate = 1; hw->ctr.conf_upgate = 1;
@ -929,7 +929,8 @@ static inline bool i2c_ll_master_is_cmd_done(i2c_dev_t *hw, int cmd_idx)
static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us) static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us)
{ {
uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000); uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000);
return 31 - __builtin_clz(clk_cycle_num_per_us * timeout_us); // round up to an integer
return 32 - __builtin_clz(clk_cycle_num_per_us * timeout_us);
} }
//////////////////////////////////////////Deprecated Functions////////////////////////////////////////////////////////// //////////////////////////////////////////Deprecated Functions//////////////////////////////////////////////////////////
@ -968,7 +969,7 @@ typedef enum {
* @brief Configure I2C SCL timing * @brief Configure I2C SCL timing
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param high_period The I2C SCL hight period (in core clock cycle, hight_period > 2) * @param high_period The I2C SCL height period (in core clock cycle, hight_period > 2)
* @param low_period The I2C SCL low period (in core clock cycle, low_period > 1) * @param low_period The I2C SCL low period (in core clock cycle, low_period > 1)
* @param wait_high_period The I2C SCL wait rising edge period. * @param wait_high_period The I2C SCL wait rising edge period.
* *
@ -1155,7 +1156,7 @@ static inline void i2c_ll_slave_disable_rx_it(i2c_dev_t *hw)
* @brief Configure I2C SCL timing * @brief Configure I2C SCL timing
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param hight_period The I2C SCL hight period (in core clock cycle, hight_period > 2) * @param hight_period The I2C SCL height period (in core clock cycle, hight_period > 2)
* @param low_period The I2C SCL low period (in core clock cycle, low_period > 1) * @param low_period The I2C SCL low period (in core clock cycle, low_period > 1)
* *
* @return None. * @return None.

View File

@ -611,7 +611,7 @@ static inline void i2c_ll_get_stop_timing(i2c_dev_t *hw, int *setup_time, int *h
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param ptr Pointer to data buffer * @param ptr Pointer to data buffer
* @param len Amount of data needs to be writen * @param len Amount of data needs to be written
* *
* @return None. * @return None.
*/ */
@ -646,7 +646,7 @@ static inline void i2c_ll_read_rxfifo(i2c_dev_t *hw, uint8_t *ptr, uint8_t len)
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param ram_offset Offset value of I2C RAM. * @param ram_offset Offset value of I2C RAM.
* @param ptr Pointer to data buffer * @param ptr Pointer to data buffer
* @param len Amount of data needs to be writen * @param len Amount of data needs to be written
*/ */
static inline void i2c_ll_write_by_nonfifo(i2c_dev_t *hw, uint8_t ram_offset, const uint8_t *ptr, uint8_t len) static inline void i2c_ll_write_by_nonfifo(i2c_dev_t *hw, uint8_t ram_offset, const uint8_t *ptr, uint8_t len)
{ {
@ -746,7 +746,7 @@ static inline void i2c_ll_master_clr_bus(i2c_dev_t *hw, uint32_t slave_pulses)
hw->scl_sp_conf.scl_rst_slv_num = slave_pulses; hw->scl_sp_conf.scl_rst_slv_num = slave_pulses;
hw->scl_sp_conf.scl_rst_slv_en = 1; hw->scl_sp_conf.scl_rst_slv_en = 1;
hw->ctr.conf_upgate = 1; hw->ctr.conf_upgate = 1;
// hardward will clear scl_rst_slv_en after sending SCL pulses, // hardware will clear scl_rst_slv_en after sending SCL pulses,
// and we should set conf_upgate bit to synchronize register value. // and we should set conf_upgate bit to synchronize register value.
while (hw->scl_sp_conf.scl_rst_slv_en); while (hw->scl_sp_conf.scl_rst_slv_en);
hw->ctr.conf_upgate = 1; hw->ctr.conf_upgate = 1;
@ -863,7 +863,8 @@ static inline void i2c_ll_slave_clear_stretch(i2c_dev_t *dev)
static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us) static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us)
{ {
uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000); uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000);
return 31 - __builtin_clz(clk_cycle_num_per_us * timeout_us); // round up to an integer
return 32 - __builtin_clz(clk_cycle_num_per_us * timeout_us);
} }
//////////////////////////////////////////Deprecated Functions////////////////////////////////////////////////////////// //////////////////////////////////////////Deprecated Functions//////////////////////////////////////////////////////////
@ -902,7 +903,7 @@ typedef enum {
* @brief Configure I2C SCL timing * @brief Configure I2C SCL timing
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param high_period The I2C SCL hight period (in core clock cycle, hight_period > 2) * @param high_period The I2C SCL high period (in core clock cycle, hight_period > 2)
* @param low_period The I2C SCL low period (in core clock cycle, low_period > 1) * @param low_period The I2C SCL low period (in core clock cycle, low_period > 1)
* @param wait_high_period The I2C SCL wait rising edge period. * @param wait_high_period The I2C SCL wait rising edge period.
* *
@ -1090,7 +1091,7 @@ static inline void i2c_ll_slave_disable_rx_it(i2c_dev_t *hw)
* @brief Configure I2C SCL timing * @brief Configure I2C SCL timing
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param hight_period The I2C SCL hight period (in core clock cycle, hight_period > 2) * @param hight_period The I2C SCL high period (in core clock cycle, hight_period > 2)
* @param low_period The I2C SCL low period (in core clock cycle, low_period > 1) * @param low_period The I2C SCL low period (in core clock cycle, low_period > 1)
* *
* @return None. * @return None.

View File

@ -734,7 +734,7 @@ static inline void i2c_ll_master_get_filter(i2c_dev_t *hw, uint8_t *filter_conf)
} }
/** /**
* @brief Reste I2C master FSM. When the master FSM is stuck, call this function to reset the FSM * @brief reset I2C master FSM. When the master FSM is stuck, call this function to reset the FSM
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* *
@ -972,7 +972,8 @@ static inline bool i2c_ll_master_is_cmd_done(i2c_dev_t *hw, int cmd_idx)
static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us) static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us)
{ {
uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000); uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000);
return 31 - __builtin_clz(clk_cycle_num_per_us * timeout_us); // round up to an integer
return 32 - __builtin_clz(clk_cycle_num_per_us * timeout_us);
} }
//////////////////////////////////////////Deprecated Functions////////////////////////////////////////////////////////// //////////////////////////////////////////Deprecated Functions//////////////////////////////////////////////////////////

View File

@ -613,7 +613,7 @@ static inline void i2c_ll_get_stop_timing(i2c_dev_t *hw, int *setup_time, int *h
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param ptr Pointer to data buffer * @param ptr Pointer to data buffer
* @param len Amount of data needs to be writen * @param len Amount of data needs to be written
* *
* @return None. * @return None.
*/ */
@ -648,7 +648,7 @@ static inline void i2c_ll_read_rxfifo(i2c_dev_t *hw, uint8_t *ptr, uint8_t len)
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param ram_offset Offset value of I2C RAM. * @param ram_offset Offset value of I2C RAM.
* @param ptr Pointer to data buffer * @param ptr Pointer to data buffer
* @param len Amount of data needs to be writen * @param len Amount of data needs to be written
*/ */
static inline void i2c_ll_write_by_nonfifo(i2c_dev_t *hw, uint8_t ram_offset, const uint8_t *ptr, uint8_t len) static inline void i2c_ll_write_by_nonfifo(i2c_dev_t *hw, uint8_t ram_offset, const uint8_t *ptr, uint8_t len)
{ {
@ -720,7 +720,7 @@ static inline void i2c_ll_master_get_filter(i2c_dev_t *hw, uint8_t *filter_conf)
} }
/** /**
* @brief Reste I2C master FSM. When the master FSM is stuck, call this function to reset the FSM * @brief reset I2C master FSM. When the master FSM is stuck, call this function to reset the FSM
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* *
@ -748,7 +748,7 @@ static inline void i2c_ll_master_clr_bus(i2c_dev_t *hw, uint32_t slave_pulses)
hw->scl_sp_conf.scl_rst_slv_num = slave_pulses; hw->scl_sp_conf.scl_rst_slv_num = slave_pulses;
hw->scl_sp_conf.scl_rst_slv_en = 1; hw->scl_sp_conf.scl_rst_slv_en = 1;
hw->ctr.conf_upgate = 1; hw->ctr.conf_upgate = 1;
// hardward will clear scl_rst_slv_en after sending SCL pulses, // hardware will clear scl_rst_slv_en after sending SCL pulses,
// and we should set conf_upgate bit to synchronize register value. // and we should set conf_upgate bit to synchronize register value.
while (hw->scl_sp_conf.scl_rst_slv_en); while (hw->scl_sp_conf.scl_rst_slv_en);
hw->ctr.conf_upgate = 1; hw->ctr.conf_upgate = 1;
@ -879,7 +879,8 @@ static inline bool i2c_ll_master_is_cmd_done(i2c_dev_t *hw, int cmd_idx)
static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us) static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us)
{ {
uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000); uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000);
return 31 - __builtin_clz(clk_cycle_num_per_us * timeout_us); // round up to an integer
return 32 - __builtin_clz(clk_cycle_num_per_us * timeout_us);
} }
//////////////////////////////////////////Deprecated Functions////////////////////////////////////////////////////////// //////////////////////////////////////////Deprecated Functions//////////////////////////////////////////////////////////
@ -918,7 +919,7 @@ typedef enum {
* @brief Configure I2C SCL timing * @brief Configure I2C SCL timing
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param high_period The I2C SCL hight period (in core clock cycle, hight_period > 2) * @param high_period The I2C SCL height period (in core clock cycle, hight_period > 2)
* @param low_period The I2C SCL low period (in core clock cycle, low_period > 1) * @param low_period The I2C SCL low period (in core clock cycle, low_period > 1)
* @param wait_high_period The I2C SCL wait rising edge period. * @param wait_high_period The I2C SCL wait rising edge period.
* *
@ -1106,7 +1107,7 @@ static inline void i2c_ll_slave_disable_rx_it(i2c_dev_t *hw)
* @brief Configure I2C SCL timing * @brief Configure I2C SCL timing
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param hight_period The I2C SCL hight period (in core clock cycle, hight_period > 2) * @param hight_period The I2C SCL height period (in core clock cycle, hight_period > 2)
* @param low_period The I2C SCL low period (in core clock cycle, low_period > 1) * @param low_period The I2C SCL low period (in core clock cycle, low_period > 1)
* *
* @return None. * @return None.

View File

@ -615,7 +615,7 @@ static inline void i2c_ll_get_stop_timing(i2c_dev_t *hw, int *setup_time, int *h
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param ptr Pointer to data buffer * @param ptr Pointer to data buffer
* @param len Amount of data needs to be writen * @param len Amount of data needs to be written
* *
* @return None. * @return None.
*/ */
@ -650,7 +650,7 @@ static inline void i2c_ll_read_rxfifo(i2c_dev_t *hw, uint8_t *ptr, uint8_t len)
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param ram_offset Offset value of I2C RAM. * @param ram_offset Offset value of I2C RAM.
* @param ptr Pointer to data buffer * @param ptr Pointer to data buffer
* @param len Amount of data needs to be writen * @param len Amount of data needs to be written
*/ */
static inline void i2c_ll_write_by_nonfifo(i2c_dev_t *hw, uint8_t ram_offset, const uint8_t *ptr, uint8_t len) static inline void i2c_ll_write_by_nonfifo(i2c_dev_t *hw, uint8_t ram_offset, const uint8_t *ptr, uint8_t len)
{ {
@ -722,7 +722,7 @@ static inline void i2c_ll_master_get_filter(i2c_dev_t *hw, uint8_t *filter_conf)
} }
/** /**
* @brief Reste I2C master FSM. When the master FSM is stuck, call this function to reset the FSM * @brief reset I2C master FSM. When the master FSM is stuck, call this function to reset the FSM
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* *
@ -750,7 +750,7 @@ static inline void i2c_ll_master_clr_bus(i2c_dev_t *hw, uint32_t slave_pulses)
hw->scl_sp_conf.scl_rst_slv_num = slave_pulses; hw->scl_sp_conf.scl_rst_slv_num = slave_pulses;
hw->scl_sp_conf.scl_rst_slv_en = 1; hw->scl_sp_conf.scl_rst_slv_en = 1;
hw->ctr.conf_upgate = 1; hw->ctr.conf_upgate = 1;
// hardward will clear scl_rst_slv_en after sending SCL pulses, // hardware will clear scl_rst_slv_en after sending SCL pulses,
// and we should set conf_upgate bit to synchronize register value. // and we should set conf_upgate bit to synchronize register value.
while (hw->scl_sp_conf.scl_rst_slv_en); while (hw->scl_sp_conf.scl_rst_slv_en);
hw->ctr.conf_upgate = 1; hw->ctr.conf_upgate = 1;
@ -976,7 +976,8 @@ static inline bool i2c_ll_master_is_cmd_done(i2c_dev_t *hw, int cmd_idx)
static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us) static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us)
{ {
uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000); uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000);
return 31 - __builtin_clz(clk_cycle_num_per_us * timeout_us); // round up to an integer
return 32 - __builtin_clz(clk_cycle_num_per_us * timeout_us);
} }
//////////////////////////////////////////Deprecated Functions////////////////////////////////////////////////////////// //////////////////////////////////////////Deprecated Functions//////////////////////////////////////////////////////////
@ -1015,7 +1016,7 @@ typedef enum {
* @brief Configure I2C SCL timing * @brief Configure I2C SCL timing
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param high_period The I2C SCL hight period (in core clock cycle, hight_period > 2) * @param high_period The I2C SCL height period (in core clock cycle, hight_period > 2)
* @param low_period The I2C SCL low period (in core clock cycle, low_period > 1) * @param low_period The I2C SCL low period (in core clock cycle, low_period > 1)
* @param wait_high_period The I2C SCL wait rising edge period. * @param wait_high_period The I2C SCL wait rising edge period.
* *
@ -1203,7 +1204,7 @@ static inline void i2c_ll_slave_disable_rx_it(i2c_dev_t *hw)
* @brief Configure I2C SCL timing * @brief Configure I2C SCL timing
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param hight_period The I2C SCL hight period (in core clock cycle, hight_period > 2) * @param hight_period The I2C SCL height period (in core clock cycle, hight_period > 2)
* @param low_period The I2C SCL low period (in core clock cycle, low_period > 1) * @param low_period The I2C SCL low period (in core clock cycle, low_period > 1)
* *
* @return None. * @return None.

View File

@ -671,7 +671,7 @@ static inline void i2c_ll_get_stop_timing(i2c_dev_t *hw, int *setup_time, int *h
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param ptr Pointer to data buffer * @param ptr Pointer to data buffer
* @param len Amount of data needs to be writen * @param len Amount of data needs to be written
* *
* @return None. * @return None.
*/ */
@ -706,7 +706,7 @@ static inline void i2c_ll_read_rxfifo(i2c_dev_t *hw, uint8_t *ptr, uint8_t len)
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param ram_offset Offset value of I2C RAM. * @param ram_offset Offset value of I2C RAM.
* @param ptr Pointer to data buffer * @param ptr Pointer to data buffer
* @param len Amount of data needs to be writen * @param len Amount of data needs to be written
*/ */
static inline void i2c_ll_write_by_nonfifo(i2c_dev_t *hw, uint8_t ram_offset, const uint8_t *ptr, uint8_t len) static inline void i2c_ll_write_by_nonfifo(i2c_dev_t *hw, uint8_t ram_offset, const uint8_t *ptr, uint8_t len)
{ {
@ -778,7 +778,7 @@ static inline void i2c_ll_master_get_filter(i2c_dev_t *hw, uint8_t *filter_conf)
} }
/** /**
* @brief Reste I2C master FSM. When the master FSM is stuck, call this function to reset the FSM * @brief reset I2C master FSM. When the master FSM is stuck, call this function to reset the FSM
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* *
@ -931,7 +931,8 @@ static inline bool i2c_ll_master_is_cmd_done(i2c_dev_t *hw, int cmd_idx)
static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us) static inline uint32_t i2c_ll_calculate_timeout_us_to_reg_val(uint32_t src_clk_hz, uint32_t timeout_us)
{ {
uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000); uint32_t clk_cycle_num_per_us = src_clk_hz / (1 * 1000 * 1000);
return 31 - __builtin_clz(clk_cycle_num_per_us * timeout_us); // round up to an integer
return 32 - __builtin_clz(clk_cycle_num_per_us * timeout_us);
} }
//////////////////////////////////////////Deprecated Functions////////////////////////////////////////////////////////// //////////////////////////////////////////Deprecated Functions//////////////////////////////////////////////////////////
@ -986,7 +987,7 @@ static inline void i2c_ll_get_scl_clk_timing(i2c_dev_t *hw, int *high_period, in
* @brief Configure I2C SCL timing * @brief Configure I2C SCL timing
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param high_period The I2C SCL hight period (in core clock cycle, hight_period > 2) * @param high_period The I2C SCL height period (in core clock cycle, hight_period > 2)
* @param low_period The I2C SCL low period (in core clock cycle, low_period > 1) * @param low_period The I2C SCL low period (in core clock cycle, low_period > 1)
* @param wait_high_period The I2C SCL wait rising edge period. * @param wait_high_period The I2C SCL wait rising edge period.
* *
@ -1157,7 +1158,7 @@ static inline void i2c_ll_slave_disable_rx_it(i2c_dev_t *hw)
* @brief Configure I2C SCL timing * @brief Configure I2C SCL timing
* *
* @param hw Beginning address of the peripheral registers * @param hw Beginning address of the peripheral registers
* @param high_period The I2C SCL hight period (in core clock cycle, hight_period > 2) * @param high_period The I2C SCL height period (in core clock cycle, hight_period > 2)
* @param low_period The I2C SCL low period (in core clock cycle, low_period > 1) * @param low_period The I2C SCL low period (in core clock cycle, low_period > 1)
* *
* @return None. * @return None.