1、Matter介绍

Matter由CSA（连接标准联盟）发起，由巨头公司联合推出，旨在解决通信协议纷繁复杂的碎片化问题，打破多生态系统间的监护壁垒，实现智能设备的无缝通信与写作。
Matter开发环境安装

2、环境配置

本次开发基于Ubuntu 22.04环境配置，建议安装Ubuntu22.04作为matter开发编译环境。
注意：建议将硬盘容量设置为80G往上，单个connectedhomeip代码文件在9G左右。

3、安装必要依赖项，为配置Matter编译环境做准备。

matter@Env:~$ sudo apt-get install git gcc g++ pkg-config libssl-dev libdbus-1-dev \
 libglib2.0-dev libavahi-client-dev ninja-build python3-venv python3-dev \
 python3-pip unzip libgirepository1.0-dev libcairo2-dev libreadline-dev

4、Ubuntu下安装git后，使用git命令从github拉取matter源码。

matter@Env:~$ git clone -b v1.2.0.0 -recurse -submodules https://github.com/project-chip/connectedhomeip.git

注意：拉取代码时建议使用VPN

5、下载安装编译工具。

配置gn+ninja，后续使用gn+ninja编译matter源码（参考文档：https://blog.csdn.net/qiuguolu1108/article/details/103842556）
a、下载gn和ninja，一般先安装依赖项，下载代码，编译代码，安装程序。
b、直接下载gn和ninja的二进制程序，
链接：https://pan.baidu.com/s/1_l8JMfuhLJgD7RKs-IDOnQ 提取码：1e0r
将gn、ninja下载后，直接放在/usr/bin目录下，这样在任意位置可以直接使用这个两个程序了。
给gn和ninja添加权限

matter@Env:~/connectedhomeip/gn-demo# chmod +x /usr/bin/gn 
matter@Env:~/connectedhomeip/gn-demo# chmod +x /usr/bin/ninja 

先用gn生成ninja工程

matter@Env:~/connectedhomeip/gn-demo# gn gen out                
#Done. Made 2 targets from 4 files in 4ms

再用ninja生成可执行文件

matter@Env:~/connectedhomeip/gn-demo# ninja -C out
ninja: Entering directory `./out'
[3/3] STAMP obj/default.stamp

6、配置matter编译环境

打开命令行终端，进入matter源码主目录，执行以下命令，调用脚本文件配置matter编译环境。

matter@Env:~/connectedhomeip$ source scripts/activate.sh

若执行activate.sh脚本后显示环境过期，可通过以下命令执行bootstrap.sh脚本来更新代码：

matter@Env:~/connectedhomeip$ source scripts/bootstarp.sh

注意：执行脚本过程中需要使用VPN
建议使用activate.sh，bootstarp.sh为重新配置，时间较长。

7、期间遇到的错误

a、替换文件后环境崩溃
在替换了GD32VW553 适配 matter 的文件之后，报错找不到某个文件。原因是某些快捷方式链接不成功，可能因为代码未拉取完整导致。
替换之前运行source scripts/activate.sh可以通过，替换后不可以通过。原因为替换了一些和分支不匹配的代码。
替换之后运行生成工程gn gen out，报错
ERROR at //third_party/connectedhomeip/src/app/chip_data_model.gni:197:20: Script returned non-zero exit code.
_cluster_sources = exec_script(“/home/matter/connectedhomeip/build/gn_run_binary.py /home/matter/connectedhomeip/src/app/zap_cluster_list.py --zap_file=/home/matter/connectedhomeip/examples/lighting-app/lighting-common/lighting-app.zap”)
^----------
Current dir: /home/matter/connectedhomeip/examples/lighting-app/gd32mcu/gd32vw55x/out/
Command: python /home/matter/connectedhomeip/build/gn_run_binary.py /home/matter/connectedhomeip/src/app/zap_cluster_list.py --zap_file=/home/matter/connectedhomeip/examples/lighting-app/lighting-common/lighting-app.zap
Returned 127.
查看代码后，打印了程序运行前后内容和路径，单独运行Command均正确。运行activate.sh不通过，环境报错。
注意：从git上拉取的代码一般不会有问题，不要随意更改拉取下来的代码，代码大概率是没问题的。需要从其他方面，比如分支不对、拉取的代码不完整、环境依赖项目冲突等原因。
b、pw_cli.plugins.Error: Failed to import module “pw_watch.watch” (ImportError: cannot import name ‘OneStyleAndTextTuple’ from ‘prompt_toolkit.formatted_text’ (/home/matter/connectedhomeip/.environment/pigweed-venv/lib/python3.10/site-packages/prompt_toolkit/formatted_text/init.py))
Error during bootstrap–see messages above.
错误原因：在尝试导入名为 “OneStyleAndTextTuple” 的模块时出现了问题，可能的原因是 “prompt_toolkit.formatted_text” 模块中找不到 “OneStyleAndTextTuple”。
解决方法：升级模块prompt_toolkit

matter@Env:~/connectedhomeip$ pip install --upgrade prompt_toolkit

将升级后的版本号更新在文件constraints.txt,文档中模块名为prompt-toolkit。

matter@Env:~/connectedhomeip$ gedit scripts/setup/constraints.txt

c、复制或者移动后，出现pw command not found错误时。
解决办法清除缓存，然后再配置环境

matter@Env:~/connectedhomeip$ git clean -Xdf
matter@Env:~/connectedhomeip$ source ./scripts/bootstrap.sh

d、ERROR: Cannot install -r python/gen/matter_build_venv/generated_requirements.txt (line 86) and protobuf~=3.20.1 because these package versions have conflicting dependencies.
but you have protobuf 3.20.1 which is incompatible.google-api-core 2.17.1 requires protobuf!=3.20.0,!=3.20.1,!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5,<5.0.0.dev0,>=3.19.5, but you have protobuf 3.20.1 which is incompatible.
这个错误原因是安装的部分依赖包出现了冲突，查看依赖包的条件，然后手动安装合适的包版本号。
解决办法

matter@Env:~/connectedhomeip$ pip install protobuf==3.20.3
matter@Env:~/connectedhomeip$ source scripts/activate.sh

e、matter@Env:~/connectedhomeip/examples/lighting-app/gd32mcu/gd32vw55x$ gn gen out
ERROR at //third_party/connectedhomeip/src/app/chip_data_model.gni:192:26: Script returned non-zero exit code.
_cluster_sources = exec_script(“${_app_root}/zap_cluster_list.py”,
^----------
Current dir: /home/matter/connectedhomeip/examples/lighting-app/gd32mcu/gd32vw55x/out/
Command: python /home/matter/connectedhomeip/examples/lighting-app/gd32mcu/gd32vw55x/third_party/connectedhomeip/src/app/zap_cluster_list.py --zap_file …/third_party/connectedhomeip/examples/lighting-app/lighting-common/lighting-app.zap
Returned 127.
这个错误的原因为环境配置未通过。一些配置文件或者依赖文件不完全，导致执行不下去。
在使用gn生成工程之前，需要先执行source scripts/activate.sh,环境好了之后，再去生成工程。