[I2C] Add general call mode API

Adding true to the 3 Wire::begin() method will enable the
general call mode else false per default.

Signed-off-by: Frederic.Pillon <[email protected]>

Author: fpistm

cores/arduino/stm32/twi.c

@@ -192,7 +192,7 @@ void i2c_custom_init(i2c_t *obj, i2c_timing_e timing, uint32_t addressingMode, u
   handle->Init.OwnAddress2     = 0xFF;
   handle->Init.AddressingMode  = addressingMode;
   handle->Init.DualAddressMode = I2C_DUALADDRESS_DISABLE;
-  handle->Init.GeneralCallMode = I2C_GENERALCALL_DISABLE;
+  handle->Init.GeneralCallMode = (obj->generalCall == 0) ? I2C_GENERALCALL_DISABLE : I2C_GENERALCALL_ENABLE;
   handle->Init.NoStretchMode   = I2C_NOSTRETCH_DISABLE;
 
   handle->State = HAL_I2C_STATE_RESET;

cores/arduino/stm32/twi.h

@@ -107,6 +107,7 @@ struct i2c_s {
   volatile uint8_t i2cTxRxBufferSize;
   volatile uint8_t slaveMode;
   uint8_t isMaster;
+  uint8_t generalCall;
 };
 
 ///@brief I2C state

libraries/Wire/src/Wire.cpp

@@ -59,12 +59,12 @@ TwoWire::TwoWire(uint8_t sda, uint8_t scl)
 
 // Public Methods //////////////////////////////////////////////////////////////
 
-void TwoWire::begin(void)
+void TwoWire::begin(bool generalCall)
 {
-  begin(MASTER_ADDRESS);
+  begin(MASTER_ADDRESS, generalCall);
 }
 
-void TwoWire::begin(uint8_t address)
+void TwoWire::begin(uint8_t address, bool generalCall)
 {
   rxBufferIndex = 0;
   rxBufferLength = 0;
@@ -80,6 +80,8 @@ void TwoWire::begin(uint8_t address)
 
   _i2c.isMaster = (address == MASTER_ADDRESS) ? 1 : 0;
 
+  _i2c.generalCall = (generalCall == true) ? 1 : 0;
+
   i2c_custom_init(&_i2c, I2C_100KHz, I2C_ADDRESSINGMODE_7BIT, ownAddress);
 
   if (_i2c.isMaster == 0) {
@@ -91,9 +93,9 @@ void TwoWire::begin(uint8_t address)
   }
 }
 
-void TwoWire::begin(int address)
+void TwoWire::begin(int address, bool generalCall)
 {
-  begin((uint8_t)address);
+  begin((uint8_t)address, generalCall);
 }
 
 void TwoWire::end(void)

libraries/Wire/src/Wire.h

@@ -82,9 +82,9 @@ class TwoWire : public Stream {
     {
       _i2c.sda = sda;
     };
-    void begin();
-    void begin(uint8_t);
-    void begin(int);
+    void begin(bool generalCall = false);
+    void begin(uint8_t, bool generalCall = false);
+    void begin(int, bool generalCall = false);
     void end();
     void setClock(uint32_t);
     void beginTransmission(uint8_t);