fix(i2c): release platform mutex on intr/pm_lock delete failure

ESP_RETURN_ON_ERROR inside the s_i2c_platform.mutex critical section
returns without releasing the mutex, permanently blocking all I2C
bus operations. Replace with ESP_GOTO_ON_ERROR that jumps to a
cleanup label releasing the mutex before return.
This commit is contained in:
morris
2026-06-30 16:52:21 +08:00
parent 9f2a14562b
commit 1428638fd6
3 changed files with 27 additions and 14 deletions

View File

@@ -190,15 +190,24 @@ esp_err_t i2c_acquire_bus_handle(i2c_port_num_t port_num, i2c_bus_handle_t *i2c_
esp_err_t i2c_release_bus_handle(i2c_bus_handle_t i2c_bus) esp_err_t i2c_release_bus_handle(i2c_bus_handle_t i2c_bus)
{ {
esp_err_t ret = ESP_OK;
int port_num = i2c_bus->port_num; int port_num = i2c_bus->port_num;
i2c_clock_source_t clk_src = i2c_bus->clk_src; i2c_clock_source_t clk_src = i2c_bus->clk_src;
bool do_deinitialize = false; bool do_deinitialize = false;
_lock_acquire(&s_i2c_platform.mutex); _lock_acquire(&s_i2c_platform.mutex);
if (s_i2c_platform.buses[port_num]) { if (s_i2c_platform.buses[port_num]) {
s_i2c_platform.count[port_num]--; if (s_i2c_platform.count[port_num] > 1) {
if (s_i2c_platform.count[port_num] == 0) { s_i2c_platform.count[port_num]--;
} else {
do_deinitialize = true; do_deinitialize = true;
s_i2c_platform.buses[port_num] = NULL; if (i2c_bus->intr_handle) {
ESP_GOTO_ON_ERROR(esp_intr_free(i2c_bus->intr_handle), err, TAG, "delete interrupt service failed");
i2c_bus->intr_handle = NULL;
}
if (i2c_bus->pm_lock) {
esp_pm_lock_delete(i2c_bus->pm_lock);
i2c_bus->pm_lock = NULL;
}
#if I2C_USE_RETENTION_LINK #if I2C_USE_RETENTION_LINK
if (i2c_bus->is_lp_i2c == false) { if (i2c_bus->is_lp_i2c == false) {
if (i2c_bus->retention_link_created) { if (i2c_bus->retention_link_created) {
@@ -207,12 +216,8 @@ esp_err_t i2c_release_bus_handle(i2c_bus_handle_t i2c_bus)
sleep_retention_module_deinit(i2c_regs_retention[port_num].module_id); sleep_retention_module_deinit(i2c_regs_retention[port_num].module_id);
} }
#endif #endif
if (i2c_bus->intr_handle) { s_i2c_platform.count[port_num] = 0;
ESP_RETURN_ON_ERROR(esp_intr_free(i2c_bus->intr_handle), TAG, "delete interrupt service failed"); s_i2c_platform.buses[port_num] = NULL;
}
if (i2c_bus->pm_lock) {
ESP_RETURN_ON_ERROR(esp_pm_lock_delete(i2c_bus->pm_lock), TAG, "delete pm_lock failed");
}
// Disable I2C module // Disable I2C module
if (!i2c_bus->is_lp_i2c) { if (!i2c_bus->is_lp_i2c) {
I2C_RCC_ATOMIC() { I2C_RCC_ATOMIC() {
@@ -244,9 +249,11 @@ esp_err_t i2c_release_bus_handle(i2c_bus_handle_t i2c_bus)
if (do_deinitialize) { if (do_deinitialize) {
ESP_LOGD(TAG, "delete bus %d", port_num); ESP_LOGD(TAG, "delete bus %d", port_num);
} }
ESP_RETURN_ON_FALSE(s_i2c_platform.count[port_num] == 0, ESP_ERR_INVALID_STATE, TAG, "Bus not freed entirely");
return ESP_OK; return ESP_OK;
err:
_lock_release(&s_i2c_platform.mutex);
return ret;
} }
esp_err_t i2c_select_periph_clock(i2c_bus_handle_t handle, soc_module_clk_t clk_src) esp_err_t i2c_select_periph_clock(i2c_bus_handle_t handle, soc_module_clk_t clk_src)

View File

@@ -863,11 +863,12 @@ static esp_err_t i2c_master_bus_destroy(i2c_master_bus_handle_t bus_handle)
} }
bus_handle = NULL; bus_handle = NULL;
} }
free(i2c_master);
} else { } else {
free(i2c_master); // Non-OK here means interrupt teardown did not complete, so the ISR
// may still reference i2c_slave and its wrapper-owned resources.
return err;
} }
free(i2c_master);
return ESP_OK; return ESP_OK;
} }

View File

@@ -212,6 +212,11 @@ static esp_err_t i2c_slave_device_destroy(i2c_slave_dev_handle_t i2c_slave)
i2c_ll_disable_intr_mask(i2c_slave->base->hal.dev, I2C_LL_SLAVE_EVENT_INTR); i2c_ll_disable_intr_mask(i2c_slave->base->hal.dev, I2C_LL_SLAVE_EVENT_INTR);
i2c_common_deinit_pins(i2c_slave->base); i2c_common_deinit_pins(i2c_slave->base);
ret = i2c_release_bus_handle(i2c_slave->base); ret = i2c_release_bus_handle(i2c_slave->base);
if (ret != ESP_OK) {
// Non-OK here means interrupt teardown did not complete, so the ISR
// may still reference i2c_slave and its wrapper-owned resources.
return ret;
}
} }
if (i2c_slave->rx_ring_buf) { if (i2c_slave->rx_ring_buf) {
vRingbufferDeleteWithCaps(i2c_slave->rx_ring_buf); vRingbufferDeleteWithCaps(i2c_slave->rx_ring_buf);