Add access methods to get the Wire bus number and I2C bus handle (#11570)

* feat(i2c): Add method to access the I2C bus handle

* feat(wire): Add access method to get the I2C bus number

* ci(pre-commit): Apply automatic fixes

---------

Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com>

Author: me-no-dev

cores/esp32/esp32-hal-i2c-ng.c

@@ -56,6 +56,13 @@ static bool i2cDetachBus(void *bus_i2c_num) {
   return true;
 }
 
+void *i2cBusHandle(uint8_t i2c_num) {
+  if (i2c_num >= SOC_I2C_NUM) {
+    return NULL;
+  }
+  return bus[i2c_num].bus_handle;
+}
+
 bool i2cIsInit(uint8_t i2c_num) {
   if (i2c_num >= SOC_I2C_NUM) {
     return false;

cores/esp32/esp32-hal-i2c.h

@@ -19,6 +19,7 @@
 
 #include "soc/soc_caps.h"
 #if SOC_I2C_SUPPORTED
+#include "esp_idf_version.h"
 
 #ifdef __cplusplus
 extern "C" {
@@ -39,6 +40,10 @@ esp_err_t i2cWriteReadNonStop(
 );
 bool i2cIsInit(uint8_t i2c_num);
 
+#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 4, 0)
+void *i2cBusHandle(uint8_t i2c_num);
+#endif
+
 #ifdef __cplusplus
 }
 #endif

libraries/Wire/src/Wire.cpp

@@ -39,7 +39,7 @@ extern "C" {
 #include "Arduino.h"
 
 TwoWire::TwoWire(uint8_t bus_num)
-  : num(bus_num & 1), sda(-1), scl(-1), bufferSize(I2C_BUFFER_LENGTH)  // default Wire Buffer Size
+  : num(bus_num), sda(-1), scl(-1), bufferSize(I2C_BUFFER_LENGTH)  // default Wire Buffer Size
     ,
     rxBuffer(NULL), rxIndex(0), rxLength(0), txBuffer(NULL), txLength(0), txAddress(0), _timeOutMillis(50), nonStop(false)
 #if !CONFIG_DISABLE_HAL_LOCKS
@@ -62,6 +62,10 @@ TwoWire::~TwoWire() {
 #endif
 }
 
+uint8_t TwoWire::getBusNum() {
+  return num;
+}
+
 bool TwoWire::initPins(int sdaPin, int sclPin) {
   if (sdaPin < 0) {  // default param passed
     if (num == 0) {

libraries/Wire/src/Wire.h

@@ -105,6 +105,8 @@ class TwoWire : public HardwareI2C {
 
   bool end() override;
 
+  uint8_t getBusNum();
+
   bool setClock(uint32_t freq) override;
 
   void beginTransmission(uint8_t address) override;