Trang này được dịch bởi Cloud Translation API.

Nền tảng nâng cao ZCL (ZAP)

Nền tảng nâng cao ZCL (ZAP) là một công cụ mẫu node.js dựa trên Các cụm Matter.

ZAP cung cấp các tính năng sau cho ứng dụng và SDK Matter:

Định cấu hình các Điểm cuối, Cụm, Thuộc tính và các tính năng khác của thiết bị Matter từ giao diện GUI.
Tạo các mẫu tự động tạo định nghĩa Mô hình dữ liệu, lệnh gọi lại và mã nguồn Matter khác.
Tạo và sử dụng các tệp ZAP được định cấu hình trước để đưa vào SDK của bạn.

Cài đặt

Chuyển đến trang Bản phát hành ZAP.
Tìm bản phát hành được gắn thẻ "Mới nhất" (hầu hết sẽ được gắn thẻ "Trước khi phát hành").
Trong bản phát hành này, trong tiêu đề Tài sản, hãy chọn gói được chỉ định cho hệ điều hành của bạn rồi tải gói đó xuống.
Trên máy chạy Debian hoặc Ubuntu, hãy cài đặt ZAP bằng cách chạy:
```
sudo dpkg -i path/to/zap_installation_package
```

Trên Debian hoặc Ubuntu Linux, tệp nhị phân zap được cài đặt trong /usr/bin/. Trên các hệ điều hành khác, tệp nhị phân có thể được cài đặt ở nơi khác. Trong mọi trường hợp, hãy kiểm tra để đảm bảo vị trí của tệp thực thi nằm trong biến môi trường PATH.

Tệp ZAP

ZAP sử dụng các tệp mẫu có tên là tệp ZAP. Tệp ZAP là tệp JSON xác định các Điểm cuối, Lệnh, Thuộc tính và các tính năng khác của thiết bị. Tệp ZAP có tên kết thúc bằng .zap. Ví dụ: lighting-app.zap trong connectedhomeip/examples/lighting-app/lighting-common.

Tệp all-clusters-app.zap có trong connectedhomeip/examples/all-clusters-app/all-clusters-common được preconfigured với các cụm Matter phổ biến và ba Thiết bị đầu cuối, bao gồm cả loại Thiết bị uỷ quyền mạng phụ Matter. Đây là một ví dụ điển hình để khám phá nhiều cấu hình cụm.

Chạy

Chọn một tệp ZAP trong một trong các ví dụ về Matter.
Từ thư mục gốc của kho lưu trữ Matter (connectedhomeip), hãy chạy tập lệnh trình bao bọc run_zaptool.sh, truyền đường dẫn đến tệp .zap.

Ví dụ:

./scripts/tools/zap/run_zaptool.sh ./examples/lighting-app/lighting-common/lighting-app.zap

Thiết lập

Trong Settings (Cài đặt), bạn có thể định cấu hình giao diện người dùng ZAP, bao gồm cả lựa chọn giao diện sáng hoặc tối và bật hoặc tắt các công cụ dành cho nhà phát triển.

Khi nhấp vào Tuỳ chọn, bạn có thể chọn Nhà sản xuất sản phẩm, Chính sách phản hồi mặc định và bật hoặc tắt tính năng Khám phá lệnh.

Nhấp vào Extensions (Tiện ích) để thêm các cụm hoặc lệnh ZCL tuỳ chỉnh vào Trình định cấu hình cụm Zigbee.

Sử dụng

Điểm cuối

Tệp lighting-app.zap được định cấu hình trước bằng Nút gốc Matter (Điểm cuối – 0) và Đèn có thể điều chỉnh độ sáng Matter (Điểm cuối – 1).

Điểm cuối – 0 bao gồm các cụm chung liên quan đến toàn bộ nút, ví dụ: Kết nối mạng, Uỷ quyền, Chỉ số mô tả, Thông tin xác thực hoạt động và Cụm OTA.

Trong các bước tiếp theo, bạn sẽ xem xét và định cấu hình Điểm cuối – 1 Matter Đèn có thể điều chỉnh độ sáng từ ví dụ lighting-app.

Từ kho lưu trữ Matter connectedhomeip, hãy chạy ZAP.

scripts/tools/zap/run_zaptool.sh \
examples/lighting-app/lighting-common/lighting-app.zap

Nhấp vào Endpoint – 1 (Điểm cuối – 1), sau đó nhấp vào biểu tượng EDIT (CHỈNH SỬA).
Không bắt buộc: Matter hỗ trợ nhiều loại thiết bị. Trong trình đơn thả xuống Thiết bị, hãy bắt đầu nhập matter để thay đổi thiết bị, sau đó nhấp vào LƯU.

Để tìm hiểu thêm, hãy tham khảo phần Thiết bị và Điểm cuối trong Hướng dẫn cơ bản về Matter.

Cụm

Các tùy chọn Cụm, Thuộc tính và Báo cáo được xác định trước được bật trong Điểm cuối – 1 theo mặc định.

Để chỉ hiển thị các cụm đã bật, hãy nhấp vào Điểm cuối – 1 rồi chọn Cụm đã bật trong trình đơn Hiển thị. Bạn cũng có thể tìm kiếm các cụm theo tên, ví dụ: on.

Để bật bất kỳ cụm nào làm Khách hàng, Máy chủ hoặc Khách hàng và máy chủ, hãy sử dụng trình đơn thả xuống Bật. Bạn cũng có thể chọn Not Enabled (Không bật) để tắt một cụm được định cấu hình trước không áp dụng cho loại thiết bị của bạn.

Để tìm hiểu thêm, hãy tham khảo phần Nhóm trong phần Giới thiệu về Matter.

Thuộc tính và lệnh

Để định cấu hình Thuộc tính và Lệnh, hãy hoàn tất các bước sau:

Tìm cụm On/Off.
Trên cùng một hàng, hãy nhấp vào biểu tượng Định cấu hình .

Tại đây, bạn có thể bật hoặc tắt Thuộc tính, đặt nhiều tuỳ chọn Thuộc tính và Tìm kiếm thuộc tính theo tên.

Nhấp vào Lệnh để định cấu hình các hành động cho cụm này. Ví dụ: cụm Bật/tắt cho đèn sẽ bao gồm các lệnh Bật, Tắt và Bật/tắt. Một số cụm, chẳng hạn như cụm Temperature Measurement, có thể không có bất kỳ Lệnh nào được liên kết.

Để tìm hiểu thêm, hãy tham khảo phần Thuộc tính và lệnh trong phần Giới thiệu về Matter.

Tạo tệp nguồn ZAP

Các ví dụ về Matter sử dụng mã nguồn do ZAP tạo, có sẵn trong thư mục connectedhomeip/zzz_generated. Một số tệp dành riêng cho ứng dụng, trong khi các tệp ZAP chung khác được nhóm trong app-common.

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

Sau khi định cấu hình Điểm cuối, bạn có thể tạo tệp nguồn để tích hợp vào dự án.

Nhấp vào Tạo.
Chọn một thư mục để lưu đầu ra ZAP. Ví dụ: chuyển đến connectedhomeip/zzz_generated/lighting-app/zap-generated cho lighting-app.
Không bắt buộc. Mở các tệp trong IDE mà bạn muốn.

ZAP tạo các định nghĩa, hàm và mã nguồn khác tuỳ chỉnh theo loại thiết bị và cấu hình ZAP.

Ví dụ: callback-stub.cpp bao gồm một phương thức gọi lại cụm chỉ bao gồm các cụm mà bạn đã bật:

void emberAfClusterInitCallback(EndpointId endpoint, ClusterId clusterId)
{
    switch (clusterId)
    {
     ...
     case ZCL_ON_OFF_CLUSTER_ID :
        emberAfOnOffClusterInitCallback(endpoint);
        break;
     ...
    }
}

Sử dụng tệp nguồn ZAP

Các tệp nguồn ZAP phổ biến, ví dụ: Attributes.h trong zzz_generated/app-common/app-common/zap-generated/ids/, có thể được dùng để lấy và đặt Thuộc tính loại thiết bị:

Attributes.h

namespace DeviceTemperatureConfiguration {
  namespace Attributes {

  namespace CurrentTemperature {
    static constexpr AttributeId Id = 0x00000000;
    } // namespace CurrentTemperature

  ...

  } // namespace Attributes
} // namespace DeviceTemperatureConfiguration

main.cpp

#include <app-common/zap-generated/att-storage.h>
#include <app-common/zap-generated/attribute-id.h>
#include <app-common/zap-generated/attribute-type.h>
#include <app-common/zap-generated/attributes/Accessors.h>
#include <app-common/zap-generated/callback.h>
#include <app-common/zap-generated/cluster-id.h>
#include <app-common/zap-generated/cluster-objects.h>
#include <app-common/zap-generated/command-id.h>

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

static void InitServer(intptr_t context)
{
    ...

    // Sets temperature to 20C
    int16_t temperature = 2000;
    auto status         = DeviceTemperatureConfiguration::Attributes::CurrentTemperature::Set(1, temperature);
    if (status != EMBER_ZCL_STATUS_SUCCESS)
    {
        ChipLogError(Shell, "Temp measurement set failed");
    }
}

Sau khi hiểu cách sử dụng tệp ZAP trong mã nguồn Matter, bạn có thể tích hợp ZAP theo một số cách sau:

Sử dụng các tệp zzz_generated hiện có để tạo các ví dụ mới, dành riêng cho các loại thiết bị của bạn.
Tạo tệp .zap tuỳ chỉnh cho dự án.

Tuỳ chỉnh

Tệp ZAP được tạo từ mẫu ZAP. Khi bạn sử dụng run_zaptool.sh để chạy ZAP, tập lệnh này sẽ truyền vào các mẫu sau:

node src-script/zap-start.js --logToStdout \
    --gen "$CHIP_ROOT/src/app/zap-templates/app-templates.json" \
    --zcl "$CHIP_ROOT/src/app/zap-templates/zcl/zcl.json" \
    "${ZAP_ARGS[@]}"

templates.json xác định tên mẫu Matter và tệp đầu ra tương ứng được dùng trong các ví dụ về Matter.

{
    "path": "templates/app/callback-stub-src.zapt",
    "name": "ZCL callback-stub source",
    "output": "callback-stub.cpp"
}

Để tuỳ chỉnh các giải pháp Matter, bạn có thể thực hiện một số bước tiếp theo khi làm việc với ZAP:

Tạo mẫu ZAP.
Tích hợp ZAP vào SDK.

Tài nguyên

Để biết thêm tài nguyên về ZAP, hãy tham khảo kho lưu trữ ZAP (zap) trên GitHub.