Merge branch 'develop'

Author: GOB52

README.ja.md

@@ -60,13 +60,81 @@ void setup() {
     auto pin_num_sda = M5.getPin(m5::pin_name_t::port_a_sda);
     auto pin_num_scl = M5.getPin(m5::pin_name_t::port_a_scl);
     M5_LOGI("getPin: SDA:%u SCL:%u", pin_num_sda, pin_num_scl);
+    Wire.end();
     Wire.begin(pin_num_sda, pin_num_scl, 400 * 1000U);
 
-    M5.Display.clear(TFT_DARKGREEN);
     if (!Units.add(unit, Wire)  // unit を UnitUnified マネージャへ追加
         || !Units.begin()) {    // ユニットの始動
         M5_LOGE("Failed to add/begin");
-        M5.Display.clear(TFT_RED);
+    }
+}
+
+void loop() {
+    M5.update();
+    Units.update();
+    if (unit.updated()) {
+        // *3 ユニット固有の計測値の取得
+        M5.Log.printf("CO2:%u Temp:%f Hum:%f\n", unit.co2(), unit.temperature(), unit.humidity());
+    }
+}
+```
+
+#### I2C_Class (M5Unified 内部 I2C) 使用のユニット
+```cpp
+// M5Paper 内蔵 SHT30 センサを M5Unified の In_I2C 経由で読み取る例
+#include <M5Unified.h>
+#include <M5UnitUnified.h>
+#include <M5UnitUnifiedENV.h>  // *1 使用するユニットのヘッダ
+
+m5::unit::UnitUnified Units;
+m5::unit::UnitSHT30 unit;  // *2 使用するユニットのインスタンス
+
+void setup() {
+    M5.begin();
+
+    // M5Unified の In_I2C（内部 I2C バス）を使用
+    // ピンや周波数の手動設定は不要
+    if (!Units.add(unit, M5.In_I2C)  // I2C_Class を使用してユニットを追加
+        || !Units.begin()) {
+        M5_LOGE("Failed to add/begin");
+    }
+}
+
+void loop() {
+    M5.update();
+    Units.update();
+    if (unit.updated()) {
+        // *3 ユニット固有の計測値の取得
+        M5.Log.printf("Temp:%f Hum:%f\n", unit.temperature(), unit.humidity());
+    }
+}
+```
+
+#### M5HAL Bus (SoftwareI2C) 使用のユニット
+```cpp
+// 他のユニットを使用する場合、インクルードファイル (*1)、インスタンス (*2)、値の取得 (*3) を変更する
+#include <M5Unified.h>
+#include <M5UnitUnified.h>
+#include <M5UnitUnifiedENV.h>  // *1 使用するユニットのヘッダ
+#include <M5HAL.hpp>
+
+m5::unit::UnitUnified Units;
+m5::unit::UnitCO2 unit;  // *2 使用するユニットのインスタンス
+
+void setup() {
+    M5.begin();
+
+    auto pin_num_sda = M5.getPin(m5::pin_name_t::port_a_sda);
+    auto pin_num_scl = M5.getPin(m5::pin_name_t::port_a_scl);
+
+    m5::hal::bus::I2CBusConfig i2c_cfg;
+    i2c_cfg.pin_sda = m5::hal::gpio::getPin(pin_num_sda);
+    i2c_cfg.pin_scl = m5::hal::gpio::getPin(pin_num_scl);
+    auto i2c_bus    = m5::hal::bus::i2c::getBus(i2c_cfg);
+
+    if (!Units.add(unit, i2c_bus ? i2c_bus.value() : nullptr)  // M5HAL Bus を使用してユニットを追加
+        || !Units.begin()) {
+        M5_LOGE("Failed to add/begin");
     }
 }
 
@@ -178,7 +246,7 @@ void loop() {
 // 他のユニットを使用する場合、インクルードファイル (*1)、インスタンス (*2)、API呼び出し (*3) を変更する
 #include <M5Unified.h>
 #include <M5UnitUnified.h>
-#include <M5UnitUnifiedFoo.h> // *1 Include the header of the unit to be used
+#include <M5UnitUnifiedFoo.h> // *1 使用するユニットのヘッダ
 
 m5::unit::UnitUnified Units;
 m5::unit::UnitFoo unit; // *2 使用するユニットのインスタンス
@@ -226,7 +294,9 @@ void loop() {
 ESP-IDF は将来対応予定です。
 
 ### サポートされる通信
-- Wire TwoWire class による
+- I2C TwoWire class による
+- I2C I2C_Class (M5Unified In_I2C/Ex_I2C) による
+- I2C M5HAL Bus (SoftwareI2C を含む) による
 - GPIO (現在は各ユニットに必要な機能のみ搭載）
 - UART HardwareSerial class による
 - SPI SPI class による

README.md

@@ -80,6 +80,75 @@ void loop() {
 }
 ```
 
+#### Unit using I2C_Class (M5Unified internal I2C)
+```cpp
+// Example: Reading the SHT30 sensor built into M5Paper via M5Unified's In_I2C
+#include <M5Unified.h>
+#include <M5UnitUnified.h>
+#include <M5UnitUnifiedENV.h>  // *1 Include the header of the unit to be used
+
+m5::unit::UnitUnified Units;
+m5::unit::UnitSHT30 unit;  // *2 Instance of the unit
+
+void setup() {
+    M5.begin();
+
+    // Use M5Unified's In_I2C (internal I2C bus)
+    // No manual pin/frequency configuration needed
+    if (!Units.add(unit, M5.In_I2C)  // Add unit using I2C_Class
+        || !Units.begin()) {
+        M5_LOGE("Failed to add/begin");
+    }
+}
+
+void loop() {
+    M5.update();
+    Units.update();
+    if (unit.updated()) {
+        // *3 Obtaining unit-specific measurements
+        M5.Log.printf("Temp:%f Hum:%f\n", unit.temperature(), unit.humidity());
+    }
+}
+```
+
+#### Unit using M5HAL Bus (SoftwareI2C)
+```cpp
+// If you use other units, change include files(*1), instances(*2), and get values(*3)
+#include <M5Unified.h>
+#include <M5UnitUnified.h>
+#include <M5UnitUnifiedENV.h>  // *1 Include the header of the unit to be used
+#include <M5HAL.hpp>
+
+m5::unit::UnitUnified Units;
+m5::unit::UnitCO2 unit;  // *2 Instance of the unit
+
+void setup() {
+    M5.begin();
+
+    auto pin_num_sda = M5.getPin(m5::pin_name_t::port_a_sda);
+    auto pin_num_scl = M5.getPin(m5::pin_name_t::port_a_scl);
+
+    m5::hal::bus::I2CBusConfig i2c_cfg;
+    i2c_cfg.pin_sda = m5::hal::gpio::getPin(pin_num_sda);
+    i2c_cfg.pin_scl = m5::hal::gpio::getPin(pin_num_scl);
+    auto i2c_bus    = m5::hal::bus::i2c::getBus(i2c_cfg);
+
+    if (!Units.add(unit, i2c_bus ? i2c_bus.value() : nullptr)  // Add unit using M5HAL Bus
+        || !Units.begin()) {
+        M5_LOGE("Failed to add/begin");
+    }
+}
+
+void loop() {
+    M5.update();
+    Units.update();
+    if (unit.updated()) {
+        // *3 Obtaining unit-specific measurements
+        M5.Log.printf("CO2:%u Temp:%f Hum:%f\n", unit.co2(), unit.temperature(), unit.humidity());
+    }
+}
+```
+
 #### Unit using GPIO
 
 ```cpp
@@ -225,6 +294,8 @@ Support ESP-IDF with M5HAL in the future.
 
 ### Supported connection
 - I2C with TwoWire class
+- I2C with I2C_Class (M5Unified In_I2C/Ex_I2C)
+- I2C with M5HAL Bus (including SoftwareI2C)
 - GPIO (Currently only functions required for the units are included)
 - UART with HardwareSerial class
 - SPI with SPI class

library.json

@@ -14,7 +14,7 @@
         "m5stack/M5Utility": ">=0.0.10",
         "m5stack/M5HAL": "*"
     },
-    "version": "0.3.2",
+    "version": "0.4.0",
     "frameworks": [
         "arduino"
     ],

library.properties

@@ -1,5 +1,5 @@
 name=M5UnitUnified
-version=0.3.2
+version=0.4.0
 author=M5Stack
 maintainer=M5Stack
 sentence=M5UnitUnified is a library for unified handling of various M5 units products. (Alpha version)

src/M5UnitComponent.cpp

@@ -150,6 +150,15 @@ bool Component::assign(TwoWire& wire)
     return false;
 }
 
+bool Component::assign(m5::I2C_Class& i2c)
+{
+    if (canAccessI2C() && _addr) {
+        _adapter = std::make_shared<AdapterI2C>(i2c, _addr, _component_cfg.clock);
+        return static_cast<bool>(_adapter);
+    }
+    return false;
+}
+
 bool Component::assign(const int8_t rx_pin, const int8_t tx_pin)
 {
     if (canAccessGPIO()) {

src/M5UnitComponent.hpp

@@ -25,6 +25,7 @@ class SPIClass;
 struct SPISettings;
 
 namespace m5 {
+class I2C_Class;
 namespace unit {
 
 class UnitUnified;
@@ -226,6 +227,8 @@ class Component {
     virtual bool assign(m5::hal::bus::Bus* bus);
     /*! @brief Assgin TwoWire */
     virtual bool assign(TwoWire& wire);
+    /*! @brief Assign I2C_Class */
+    virtual bool assign(m5::I2C_Class& i2c);
     /*! @brief Assgin GPIO */
     virtual bool assign(const int8_t rx_pin, const int8_t tx_pin);
     /*! @brief Assgin UART */

src/M5UnitUnified.cpp

@@ -57,6 +57,25 @@ bool UnitUnified::add(Component& u, TwoWire& wire)
     return false;
 }
 
+bool UnitUnified::add(Component& u, m5::I2C_Class& i2c)
+{
+    if (u.isRegistered()) {
+        M5_LIB_LOGW("Already added");
+        return false;
+    }
+
+    M5_LIB_LOGD("Add [%s] addr:%02x children:%zu", u.deviceName(), u.address(), u.childrenSize());
+
+    u._manager = this;
+    if (u.assign(i2c)) {
+        u._order = ++_registerCount;
+        _units.emplace_back(&u);
+        return add_children(u);
+    }
+    M5_LIB_LOGE("Failed to assign %s:%u", u.deviceName(), u.canAccessI2C());
+    return false;
+}
+
 bool UnitUnified::add(Component& u, const int8_t rx_pin, const int8_t tx_pin)
 {
     if (u.isRegistered()) {

src/M5UnitUnified.hpp

@@ -35,6 +35,7 @@ struct SPISettings;
   @brief Top level namespace of M5stack
  */
 namespace m5 {
+class I2C_Class;
 /*!
   @namespace unit
   @brief Unit-related namespace
@@ -104,6 +105,13 @@ class UnitUnified {
       @return True if successful
      */
     bool add(Component& u, m5::hal::bus::Bus* bus);
+    /*!
+      @brief Adding unit to be managed (I2C_Class)
+      @param u Unit Component
+      @param i2c I2C_Class to be used (e.g. M5.In_I2C)
+      @return True if successful
+     */
+    bool add(Component& u, m5::I2C_Class& i2c);
     ///@}
 
     //! @brief Begin of all units under management