Matter - nordic 自定义开发（4）

nRF Connect SDK 和 Matter SDK 的 matter 协议版本

1. nRF Connect SDK（NCS）是 Nordic 官方维护的，里面包含某个版本的 Matter SDK。
2. Matter SDK 为 CSA 联盟维护的，里面包含各平台的SDK，其中包含了某个版本的 NCS。

需要探索最新标准 matter 协议，使用最新 Matter SDK ，去配置需要使用的 NCS 版本。

需要 Nordic 最新维护发布的稳定版本，直接使用 NCS 即可。

NCS 适配的 Matter 协议版本：

ZAP Tool 

        Matter开发主要包括两方面的工作：一是Matter应用本身的开发，二是非Matter应用开发。Matter应用开发本质上就是cluster/endpoint/node的添加、编辑、删除以及相关回调事件处理等，如前所述，这个需要通过 zcl 编辑工具 zap 来生成ember层的代码，以及手动添加或者修改其他c++文件来实现。

保证 zap 版本一致性：

NCS 安装：

~/ncs/v2.5.2/modules/lib/matter/scripts/setup/nrfconnect/get_zap.py -l ~/Nordic/Tools/zap_tool -o

Matter SDK 安装：

查看 ~/connectedhomeip/scripts/setup/zap.version，文件确认版本

到 https://github.com/project-chip/zap/releases，下载对应版本：

下载解压完成后，如：~/Nordic/Tools/zap_tool，将 zap_tool 文件夹添加到环境变量。

（已经安装了的旧版或者其他版本，Linux 系统下将 ~/.zap 这个文件夹删除，windows 下位于 C:\Users\${username}\.zap）

添加 Cluster

创建 Matter Template 工程

使用命令行打开 template.zap 文件，(windows 下路径默认用的是 '\'，输入要换成 '/'，否则出现乱码不兼容) 

zap ~/template/src/template.zap --zcl ~/ncs/v2.5.2/modules/lib/matter/src/app/zap-templates/zcl/zcl.json --gen ~/ncs/v2.5.2/modules/lib/matter/src/app/zap-templates/app-templates.json

 弹出ZCL窗口：

        例子目前只有Endpoint 0，选择Endpoint 0，并选择“Enabled Clusters”，我们可以看到这个Endpoint使能了哪些cluster，比如 Descriptor cluster。
        下面我们添加一个Endpoint以支持Matter On/Off Light设备，选择“ADD ENDPOINT”，如下添加：

       

 

完成添加后保存，点击 generate 生成代码到 template/src/zap-generated 文件夹中。或者使用python 脚本：

python ~/ncs/v2.5.0/modules/lib/matter/scripts/tools/zap/generate.py ~/template/src/template.zap -t src/app/zap-templates/app-templates.json -o ~/template/src/zap-generated

修改项目代码

        添加 Matter stack 回调函数，以处理 controller 发送过来的命令，比如开灯。这个主要通过覆盖 MatterPostAttributeChangeCallback() 来实现更新 attribute 数值，以让 Matter stack 可以将最新的状态或者 event 同步给 controller。这个主要通过Clusters::OnOff::Attributes::OnOff::Set()之类的函数实现。

        如 light_hulb 工程中的 zcl_callback.cpp：

/*
 * Copyright (c) 2021 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */

#include <lib/support/logging/CHIPLogging.h>

#include "app_task.h"

#include <app-common/zap-generated/attributes/Accessors.h>
#include <app-common/zap-generated/ids/Attributes.h>
#include <app-common/zap-generated/ids/Clusters.h>
#include <app/ConcreteAttributePath.h>

using namespace ::chip;
using namespace ::chip::app::Clusters;
using namespace ::chip::app::Clusters::OnOff;

void MatterPostAttributeChangeCallback(const chip::app::ConcreteAttributePath &attributePath, uint8_t type,
				       uint16_t size, uint8_t *value)
{
	ClusterId clusterId = attributePath.mClusterId;
	AttributeId attributeId = attributePath.mAttributeId;

	if (clusterId == OnOff::Id && attributeId == OnOff::Attributes::OnOff::Id) {
		ChipLogProgress(Zcl, "Cluster OnOff: attribute OnOff set to %" PRIu8 "", *value);
		AppTask::Instance().GetPWMDevice().InitiateAction(*value ? PWMDevice::ON_ACTION : PWMDevice::OFF_ACTION,
								  static_cast<int32_t>(AppEventType::Lighting), value);
	} else if (clusterId == LevelControl::Id && attributeId == LevelControl::Attributes::CurrentLevel::Id) {
		ChipLogProgress(Zcl, "Cluster LevelControl: attribute CurrentLevel set to %" PRIu8 "", *value);
		if (AppTask::Instance().GetPWMDevice().IsTurnedOn()) {
			AppTask::Instance().GetPWMDevice().InitiateAction(
				PWMDevice::LEVEL_ACTION, static_cast<int32_t>(AppEventType::Lighting), value);
		} else {
			ChipLogDetail(Zcl, "LED is off. Try to use move-to-level-with-on-off instead of move-to-level");
		}
	}
}

/** @brief OnOff Cluster Init
 *
 * This function is called when a specific cluster is initialized. It gives the
 * application an opportunity to take care of cluster initialization procedures.
 * It is called exactly once for each endpoint where cluster is present.
 *
 * @param endpoint   Ver.: always
 *
 * TODO Issue #3841
 * emberAfOnOffClusterInitCallback happens before the stack initialize the cluster
 * attributes to the default value.
 * The logic here expects something similar to the deprecated Plugins callback
 * emberAfPluginOnOffClusterServerPostInitCallback.
 *
 */
void emberAfOnOffClusterInitCallback(EndpointId endpoint)
{
    // Cluster 初始化后调用，在这里同步最初的 Cluster 状态
    // 在 InitCallback 之前，调用 Attributes 下的方法会返回失败。
	EmberAfStatus status;
	bool storedValue;

	/* Read storedValue on/off value */
	status = Attributes::OnOff::Get(endpoint, &storedValue);
	if (status == EMBER_ZCL_STATUS_SUCCESS) {
		/* Set actual state to the cluster state that was last persisted */
		AppTask::Instance().GetPWMDevice().InitiateAction(
			storedValue ? PWMDevice::ON_ACTION : PWMDevice::OFF_ACTION,
			static_cast<int32_t>(AppEventType::Lighting), reinterpret_cast<uint8_t *>(&storedValue));
	}

	AppTask::Instance().UpdateClusterState();
}

使用 Apple Home Pod 测试