Skip to content

Commit

Permalink
Update Matter dependencies, create release
Browse files Browse the repository at this point in the history
  • Loading branch information
Yacubane committed Nov 26, 2023
1 parent 28f06ec commit abacf79
Showing 1 changed file with 10 additions and 10 deletions.
20 changes: 10 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@
This projects aims at possibility to easily launch Matter internet-of-things protocol on ESP32 with Arduino. Repository contains precompiled and ready to use components from two projects: [Espressif's SDK for Matter](https://github.com/espressif/esp-matter) and [Matter](https://github.com/project-chip/connectedhomeip).

## Installing on Arduino IDE
1. Make sure that ESP32 board version is **2.0.11**. **This is crucial**, because this library contains pre-compiled files.
1. Make sure that ESP32 board version is **2.0.14**. **This is crucial**, because this library contains pre-compiled files.
2. [Turn on C++17 support for Arduino](#enabling-c17-on-arduino-ide).
3. [Download](https://github.com/Yacubane/esp32-arduino-matter/releases) and [import library into Arduino IDE](https://docs.arduino.cc/software/ide-v1/tutorials/installing-libraries).
4. Choose larger partition scheme, for example `Minimal SPIFFS`.
5. To prevent some issues related to old data, enable `Erase Flash Before Sketch Upload` option.
6. Run example sketch.

## Installing on PlatformIO
1. Use espressif32 platform at version compatible with **2.0.11** `arduino-esp32` core version (you can determine it by looking at changelog [here](https://github.com/platformio/platform-espressif32/releases)). Other versions might work, but there is no guarantee - this library contains precompiled libraries and binaries might or might not be compatible. Set that version by adding: `platform = [email protected]` in `platformio.ini`.
1. Use espressif32 platform at version compatible with **2.0.14** `arduino-esp32` core version (you can determine it by looking at changelog [here](https://github.com/platformio/platform-espressif32/releases)). Other versions might work, but there is no guarantee - this library contains precompiled libraries and binaries might or might not be compatible. Set that version by adding: `platform = [email protected]` in `platformio.ini`.
2. Turn on C++17 support, by setting `build_unflags=-std=gnu++11` and `build_flags=-std=gnu++17` in `platformio.ini`.
3. Copy the [latest release](https://github.com/Yacubane/esp32-arduino-matter/releases) zip file URL into the `lib_deps` section of `platformio.ini`, (:warning: you cannot use this repository URL in `platformio.ini` because this repository does not contain binaries due to their large size).
4. Choose larger partition scheme, for example `board_build.partitions=min_spiffs.csv` in `platformio.ini`. `min_spiffs.csv` is one of build-in partition schemas and does need to be created.
Expand All @@ -20,7 +20,7 @@ This projects aims at possibility to easily launch Matter internet-of-things pro
In `examples` folder there are some sketches that demonstrates usage of Matter. `Light` example is tested every release. Example sketches are in [release](https://github.com/Yacubane/esp32-arduino-matter/releases) created from [esp32-arduino-matter-builder repository](https://github.com/Yacubane/esp32-arduino-matter-builder/tree/master/lib_files/examples).

## Compatibility
This project contains precompiled libraries based on specific version of ESP32 SDK and this library does not guarantee support for other versions. Current build is based on `esp-idf` at version v4.4.5 and will work with Arduino IDE on [ESP32 board](https://github.com/espressif/arduino-esp32) at version 2.0.11
This project contains precompiled libraries based on specific version of ESP32 SDK and this library does not guarantee support for other versions. Current build is based on `esp-idf` at version v4.4.6 and will work with Arduino IDE on [ESP32 board](https://github.com/espressif/arduino-esp32) at version 2.0.14

## Limitations
* Library only works on ESP32 (ESP32-C3 and ESP32-S3 might work as well, but aren't tested).
Expand All @@ -33,18 +33,18 @@ This project is currently build based on these projects:

| Project | Tag / Commit hash |
| ------------- | ------------- |
| [esp32-arduino-matter-builder](https://github.com/Yacubane/esp32-arduino-matter-builder) | v1.0.0-beta6 |
| [Matter](https://github.com/project-chip/connectedhomeip) | 08b13661b6 |
| [esp-matter](https://github.com/espressif/esp-matter) | 603296a |
| [esp-idf](https://github.com/espressif/esp-idf) | v4.4.5 |
| [arduino-esp32](https://github.com/espressif/arduino-esp32) | 2.0.11 |
| [esp32-arduino-matter-builder](https://github.com/Yacubane/esp32-arduino-matter-builder) | v1.0.0-beta7 |
| [Matter](https://github.com/project-chip/connectedhomeip) | v1.1.0.2 |
| [esp-matter](https://github.com/espressif/esp-matter) | dd4f34e |
| [esp-idf](https://github.com/espressif/esp-idf) | v4.4.6 |
| [arduino-esp32](https://github.com/espressif/arduino-esp32) | 2.0.14 |

## Enabling C++17 on Arduino IDE
1. Find `platform.txt` for ESP32 board. Location of this file is platform depended.

MacOS: `~/Library/Arduino15/packages/esp32/hardware/esp32/2.0.11/platform.txt`
MacOS: `~/Library/Arduino15/packages/esp32/hardware/esp32/2.0.14/platform.txt`

Windows: `C:\Users\<USER>\AppData\Local\Arduino15\packages\esp32\hardware\esp32\2.0.11\platform.txt`
Windows: `C:\Users\<USER>\AppData\Local\Arduino15\packages\esp32\hardware\esp32\2.0.14\platform.txt`

2. Inside `platform.txt` find `ESP32 Support Start` section and it's `compiler.cpp.flags.esp32` key. Change `-std=gnu++11` to `-std=gnu++17`. Do the same thing for `ESP32S3` and `ESP32C3` `Support Start` section if you are using ESP32-S3/ESP32-C3.

Expand Down

0 comments on commit abacf79

Please sign in to comment.