1. Supported host OSes

Matter is supported on Windows, Linux, and macOS.

2. Clone repository may fail

Error:

Bootstrap: SSL error in Python when downloading CIPD client.

Solution: Please execute the commands suggested in the console output to install the Python SSL certificates, for more details see Pigweed prerequisite steps for macOS: https://pigweed.dev/docs/get_started/first_time_setup.html#install-prerequisites.

After installing the Python SSL certificates try to run the bootstrap script again using the "Update Repository" command on the imported Matter repository.

---

Error:

error: unable to create symlink src/test_driver/….: Permission denied

Solution: Please make sure to run Pigweed prerequisite steps from: https://pigweed.dev/docs/get_started/first_time_setup.html#configure-system-settings

---

Error:

error: RPC failed; curl 92 HTTP/2 stream 0 was not closed cleanly: CANCEL (err 8)
error: 4627 bytes of body are still expected
fetch-pack: unexpected disconnect while reading sideband packet
fatal: early EOF
fatal: fetch-pack: invalid index-pack output

Solution: Git network connection error. Please retry the clone repository operation.

3. Build project fails

Error:

error: unable to create file lib/third_party/mcu_vendor/espressif/esp-idf/components/nghttp/nghttp2/doc/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf: Filename too long

Solution: This is caused by the path length limit enforced by Windows. Please re-clone repository in a shorter path.

---

Error:

Build errors caused by the ARM GCC Toolchain incompatibility. The ARM GCC Toolchain version 14.2 is not compatible with Matter version 1.4.0.2.

Solution: Please manually install ARM GCC Toolchain version 13.2 and add it in VS Code.

---

Error

Build issues on FRDM-MCXW7X platforms when using the default configuration. Builds fail on FRDM-MCXW7X platforms unless an additional CMake argument is provided.

Solution: Please manually add CONFIG_MCUX_COMPONENT_middleware.freertos-kernel.config="n" CMake extra argument in the Build Configuration view.

4. Kernel Configuration (guiconfig)

Error:

   import _tkinter # If this fails your Python may not be configured for Tk
    ^^^^^^^^^^^^^^^
ModuleNotFoundError: No module named '_tkinter'

Solution: On macOS, the guiconfig tool does not launch due to the absence of python-tk support. Please use menuconfig as an alternative to guiconfig.

home