alex/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2025-12-07 17:08:49 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(i2c_master): Add a new api for adjusting address dynamically,

Browse Source 
Closes https://github.com/espressif/esp-idf/issues/15011
This commit is contained in:
C.S.M
2024-12-17 17:41:03 +08:00
parent 90f638e56e
commit 89ba620cfd
2 changed files with 51 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
components/esp_driver_i2c/include/driver/i2c_master.h
View File

@@ -247,6 +247,29 @@ esp_err_t i2c_master_register_event_callbacks(i2c_master_dev_handle_t i2c_dev, c
*/
esp_err_t i2c_master_bus_reset(i2c_master_bus_handle_t bus_handle);
/**
* @brief Change the I2C device address at runtime.
*
* This function updates the device address of an existing I2C device handle.
* It is useful for devices that support dynamic address assignment or when
* switching communication to a device with a different address on the same bus.
*
* @param[in] i2c_dev I2C device handle.
* @param[in] new_device_address The new device address.
* @param[in] timeout_ms Timeout for the address change operation, in milliseconds.
*
* @return
* - ESP_OK: Address successfully changed.
* - ESP_ERR_INVALID_ARG: Invalid arguments (e.g., NULL handle or invalid address).
* - ESP_ERR_TIMEOUT: Operation timed out.
*
* @note
* - This function does not send commands to the I2C device. It only updates
* the address used in subsequent transactions through the I2C handle.
* - Ensure that the new address is valid and does not conflict with other devices on the bus.
*/
esp_err_t i2c_master_device_change_address(i2c_master_dev_handle_t i2c_dev, uint16_t new_device_address, int timeout_ms);
/**
* @brief Wait for all pending I2C transactions done
*