{"id":27878683,"url":"https://github.com/m5stack/m5unitunified","last_synced_at":"2026-04-14T08:00:51.636Z","repository":{"id":258183905,"uuid":"797676270","full_name":"m5stack/M5UnitUnified","owner":"m5stack","description":"M5UnitUnified is a library for unified handling of various M5 units products.","archived":false,"fork":false,"pushed_at":"2026-03-25T14:31:26.000Z","size":2048,"stargazers_count":21,"open_issues_count":0,"forks_count":4,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-03-26T16:46:19.186Z","etag":null,"topics":["m5stack"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/m5stack.png","metadata":{"files":{"readme":"README.ja.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-05-08T09:54:02.000Z","updated_at":"2026-03-18T08:56:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"161cad97-d533-435e-847f-bbd60d1b7cbf","html_url":"https://github.com/m5stack/M5UnitUnified","commit_stats":null,"previous_names":["m5stack/m5unitunified"],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/m5stack/M5UnitUnified","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m5stack%2FM5UnitUnified","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m5stack%2FM5UnitUnified/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m5stack%2FM5UnitUnified/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m5stack%2FM5UnitUnified/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/m5stack","download_url":"https://codeload.github.com/m5stack/M5UnitUnified/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m5stack%2FM5UnitUnified/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31787263,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["m5stack"],"created_at":"2025-05-05T03:14:20.082Z","updated_at":"2026-04-14T08:00:51.630Z","avatar_url":"https://github.com/m5stack.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# M5UnitUnified\n\n[English](README.md)\n\n**M5Stack に色々な M5 ユニットをつないで扱う為の新たなアプローチ**  \nM5Stack シリーズ、 M5Unitシリーズの為のライブラリです。\n\n## 概要\nM5UnitUnified は、様々な M5 ユニット製品を統一的に扱うためのライブラリです。\n\n### APIの統一化\n各ユニットの外部ライブラリは、それぞれ独自の API デザインがされています。  \n基本的なAPIを統一し、すべてのユニットが同じように扱えるようにします。\n\n### 接続と通信の統一化\n各ユニットの外部ライブラリは独自の通信機能と前提条件が必要です。  \n前提条件や通信方法を統一化します。  \n将来的には[M5HAL(Hardware Abstraction Layer)](https://github.com/m5stack/M5HAL)と連携し、各ユニットとの通信を統一する予定です。\n\n### ライセンスの統一化\n各ユニットの外部ライブラリのライセンスは様々な物が混在しています。  \nすべてのM5UnitUnifiedおよび関連ライブラリは、[MITライセンス](LICENSE)下にあります。\n\n## インストール方法\nArduino/PlatformIO のライブラリマネージャーに登録されています\n\n### ArduinoIDE\n1. ライブラリマネージャから使用したいユニットのライブラリ (M5Unit-Foo) を選択してください\n\n依存する M5UnitUnified 関連のライブラリは自動で DL されます\n\n### PlatformIO\n1. platformio.ini の lib\\_deps に記述してください\n```ini\nlib_deps=m5stack/M5Unit-foo ;使用したいユニットのライブラリ\n```\n\n依存する M5UnitUnified 関連のライブラリは自動で DL されます\n\n## 使い方\n\n各ユニットのリポジトリの例も参照のこと。\n\n### Unit コンポーネントを UnitUnified とともに使用する (標準的な使用法)\n\n#### Wire 使用のユニット\n\n```cpp\n// 他のユニットを使用する場合、インクルードファイル (*1)、インスタンス (*2)、値の取得 (*3) を変更する\n#include \u003cM5Unified.h\u003e\n#include \u003cM5UnitUnified.h\u003e\n#include \u003cM5UnitUnifiedENV.h\u003e  // *1 使用するユニットのヘッダ\n\nm5::unit::UnitUnified Units;\nm5::unit::UnitCO2 unit;  // *2 使用するユニットのインスタンス\n\nvoid setup() {\n    M5.begin();\n\n    auto pin_num_sda = M5.getPin(m5::pin_name_t::port_a_sda);\n    auto pin_num_scl = M5.getPin(m5::pin_name_t::port_a_scl);\n    M5_LOGI(\"getPin: SDA:%u SCL:%u\", pin_num_sda, pin_num_scl);\n    Wire.end();\n    Wire.begin(pin_num_sda, pin_num_scl, 400 * 1000U);\n\n    if (!Units.add(unit, Wire)  // unit を UnitUnified マネージャへ追加\n        || !Units.begin()) {    // ユニットの始動\n        M5_LOGE(\"Failed to add/begin\");\n    }\n}\n\nvoid loop() {\n    M5.update();\n    Units.update();\n    if (unit.updated()) {\n        // *3 ユニット固有の計測値の取得\n        M5.Log.printf(\"CO2:%u Temp:%f Hum:%f\\n\", unit.co2(), unit.temperature(), unit.humidity());\n    }\n}\n```\n\n#### I2C_Class (M5Unified 内部 I2C) 使用のユニット\n```cpp\n// M5Paper 内蔵 SHT30 センサを M5Unified の In_I2C 経由で読み取る例\n#include \u003cM5Unified.h\u003e\n#include \u003cM5UnitUnified.h\u003e\n#include \u003cM5UnitUnifiedENV.h\u003e  // *1 使用するユニットのヘッダ\n\nm5::unit::UnitUnified Units;\nm5::unit::UnitSHT30 unit;  // *2 使用するユニットのインスタンス\n\nvoid setup() {\n    M5.begin();\n\n    // M5Unified の In_I2C（内部 I2C バス）を使用\n    // ピンや周波数の手動設定は不要\n    if (!Units.add(unit, M5.In_I2C)  // I2C_Class を使用してユニットを追加\n        || !Units.begin()) {\n        M5_LOGE(\"Failed to add/begin\");\n    }\n}\n\nvoid loop() {\n    M5.update();\n    Units.update();\n    if (unit.updated()) {\n        // *3 ユニット固有の計測値の取得\n        M5.Log.printf(\"Temp:%f Hum:%f\\n\", unit.temperature(), unit.humidity());\n    }\n}\n```\n\n#### M5HAL Bus (SoftwareI2C) 使用のユニット\n```cpp\n// 他のユニットを使用する場合、インクルードファイル (*1)、インスタンス (*2)、値の取得 (*3) を変更する\n#include \u003cM5Unified.h\u003e\n#include \u003cM5UnitUnified.h\u003e\n#include \u003cM5UnitUnifiedENV.h\u003e  // *1 使用するユニットのヘッダ\n#include \u003cM5HAL.hpp\u003e\n\nm5::unit::UnitUnified Units;\nm5::unit::UnitCO2 unit;  // *2 使用するユニットのインスタンス\n\nvoid setup() {\n    M5.begin();\n\n    auto pin_num_sda = M5.getPin(m5::pin_name_t::port_a_sda);\n    auto pin_num_scl = M5.getPin(m5::pin_name_t::port_a_scl);\n\n    m5::hal::bus::I2CBusConfig i2c_cfg;\n    i2c_cfg.pin_sda = m5::hal::gpio::getPin(pin_num_sda);\n    i2c_cfg.pin_scl = m5::hal::gpio::getPin(pin_num_scl);\n    auto i2c_bus    = m5::hal::bus::i2c::getBus(i2c_cfg);\n\n    if (!Units.add(unit, i2c_bus ? i2c_bus.value() : nullptr)  // M5HAL Bus を使用してユニットを追加\n        || !Units.begin()) {\n        M5_LOGE(\"Failed to add/begin\");\n    }\n}\n\nvoid loop() {\n    M5.update();\n    Units.update();\n    if (unit.updated()) {\n        // *3 ユニット固有の計測値の取得\n        M5.Log.printf(\"CO2:%u Temp:%f Hum:%f\\n\", unit.co2(), unit.temperature(), unit.humidity());\n    }\n}\n```\n\n#### GPIO 使用のユニット\n\n```cpp\n// 他のユニットを使用する場合、インクルードファイル (*1)、インスタンス (*2)、値の取得 (*3) を変更する\n#include \u003cM5Unified.h\u003e\n#include \u003cM5UnitUnified.h\u003e\n#include \u003cM5UnitUnifiedTUBE.h\u003e // *1 使用するユニットのヘッダ\n\nm5::unit::UnitUnified Units;\nm5::unit::UnitTubePressure unit; // *2 使用するユニットのインスタンス\n\nvoid setup()\n{\n    M5.begin();\n\n    // PortB if available, PortA if not\n    auto pin_num_gpio_in  = M5.getPin(m5::pin_name_t::port_b_in);\n    auto pin_num_gpio_out = M5.getPin(m5::pin_name_t::port_b_out);\n    if (pin_num_gpio_in \u003c 0 || pin_num_gpio_out \u003c 0) {\n        M5_LOGW(\"PortB is not available\");\n        Wire.end();\n        pin_num_gpio_in  = M5.getPin(m5::pin_name_t::port_a_pin1);\n        pin_num_gpio_out = M5.getPin(m5::pin_name_t::port_a_pin2);\n    }\n\n    if (!Units.add(unit, pin_num_gpio_in, pin_num_gpio_out) // Add unit to UnitUnified manager\n        || !Units.begin()) { // Begin each unit\n        M5_LOGE(\"Failed to add/begin\");\n    }\n}\n\nvoid loop()\n{\n    M5.update();\n    Units.update();\n    if (unit.updated()) {\n        // *3 ユニット固有の計測値の取得\n        M5.Log.printf(\"Pressure:%.2f\\n\", unit.pressure());\n    }\n}\n```\n\n#### UART(Serial) 使用のユニット\n\n```cpp\n// 他のユニットを使用する場合、インクルードファイル (*1)、インスタンス (*2)、API呼び出し (*3) を変更する\n#include \u003cM5Unified.h\u003e\n#include \u003cM5UnitUnified.h\u003e\n#include \u003cM5UnitUnifiedFINGER.h\u003e // *1 使用するユニットのヘッダ\n\nm5::unit::UnitUnified Units;\nm5::unit::UnitFinger unit; // *2 使用するユニットのインスタンス\n\nvoid setup()\n{\n    M5.begin();\n\n    // PortC if available, PortA if not\n    auto pin_num_in  = M5.getPin(m5::pin_name_t::port_c_rxd);\n    auto pin_num_out = M5.getPin(m5::pin_name_t::port_c_txd);\n    if (pin_num_in \u003c 0 || pin_num_out \u003c 0) {\n        M5_LOGW(\"PortC is not available\");\n        Wire.end();\n        pin_num_in  = M5.getPin(m5::pin_name_t::port_a_pin1);\n        pin_num_out = M5.getPin(m5::pin_name_t::port_a_pin2);\n    }\n\n#if SOC_UART_NUM \u003e 2\n    auto\u0026 s = Serial2;\n#elif SOC_UART_NUM \u003e 1\n    auto\u0026 s = Serial1;\n#else\n#error \"Not enough Serial\"\n#endif\n    s.end();\n    // 備考: ユニットによって初期化パラメータは異なる\n    s.begin(19200, SERIAL_8N1, pin_num_in, pin_num_out);\n\n    if (!Units.add(unit, s) // Add unit to UnitUnified manager\n        || !Units.begin()) { // Begin each unit\n        M5_LOGE(\"Failed to begin\");\n    }\n}\n\nvoid loop() {\n    M5.update();\n    Units.update();\n    // *3 任意の API 呼び出し...\n}\n\n```\n\n#### SPI 使用のユニット\n\n```cpp\n// 他のユニットを使用する場合、インクルードファイル (*1)、インスタンス (*2)、API呼び出し (*3) を変更する\n#include \u003cM5Unified.h\u003e\n#include \u003cM5UnitUnified.h\u003e\n#include \u003cM5UnitUnifiedFoo.h\u003e // *1 使用するユニットのヘッダ\n\nm5::unit::UnitUnified Units;\nm5::unit::UnitFoo unit; // *2 使用するユニットのインスタンス\n\nvoid setup()\n{\n    M5.begin();\n\n    if (!SPI.bus()) {\n        auto spi_sclk = M5.getPin(m5::pin_name_t::sd_spi_sclk);\n        auto spi_mosi = M5.getPin(m5::pin_name_t::sd_spi_mosi);\n        auto spi_miso = M5.getPin(m5::pin_name_t::sd_spi_miso);\n        M5_LOGI(\"getPin: %d,%d,%d\", spi_sclk, spi_mosi, spi_miso);\n        SPI.begin(spi_sclk, spi_miso, spi_mosi);\n    }\n\n    // 備考: ユニットによって初期化パラメータは異なる\n    SPISettings settings = {10000000, MSBFIRST, SPI_MODE1};\n    if (!Units.add(cap, SPI, settings) || !Units.begin()) {\n        M5_LOGE(\"Failed to begin\");\n        lcd.fillScreen(TFT_RED);\n        while (true) {\n            m5::utility::delay(10000);\n        }\n    }\n}\n\nvoid loop() {\n    M5.update();\n    Units.update();\n    // *3 任意の API 呼び出し...\n}\n```\n\n\n## サポートされているもの\n### サポートされるフレームワーク\n- Arduino\n\n将来的には Wire クラス等を直接使わず、全て M5HAL 経由で接続を行えるようになる予定です。\n\n### サポートされる通信\n- I2C TwoWire class による\n- I2C I2C_Class (M5Unified In_I2C/Ex_I2C) による\n- I2C M5HAL Bus (SoftwareI2C を含む) による\n- GPIO (現在は各ユニットに必要な機能のみ搭載）\n- UART HardwareSerial class による\n- SPI SPI class による\n\n### サポートされるデバイス,ユニット\n[Wiki](https://github.com/m5stack/M5UnitUnified/wiki/)を参照\n\n\n## Examples\n使用例は各ユニットのリポジトリ (M5Unit-ENV, M5Unit-HEART 等) を参照してください。\n\n\n## Doxygen ドキュメント\n\n[GitHub Pages](https://m5stack.github.io/M5UnitUnified/)\n\nあなたのローカルマシンでドキュメントを生成したい場合は、以下のコマンドを実行してください。\n```\nbash docs/doxy.sh\n```\ndocs/html の下に出力されます。  \nGit コミットのハッシュを html に出力したい場合は、 git クローンしたフォルダに対して実行してください。\n\n### 必要な物\n- [Doxygen](https://www.doxygen.nl/)\n- [pcregrep](https://formulae.brew.sh/formula/pcre2)\n- [Git](https://git-scm.com/)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm5stack%2Fm5unitunified","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fm5stack%2Fm5unitunified","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm5stack%2Fm5unitunified/lists"}