แพลตฟอร์มขั้นสูง ZCL (ZAP)

ZCL Advanced Platform (ZAP) เป็นเครื่องมือเทมเพลต node.js ที่อิงตาม Matter Clusters

ZAP มีฟีเจอร์ต่อไปนี้สำหรับแอปและ SDK ของ Matter

• กำหนดค่าปลายทาง คลัสเตอร์ แอตทริบิวต์ และฟีเจอร์อื่นๆ ของอุปกรณ์ Matter จากอินเทอร์เฟซ GUI
• สร้างเทมเพลตที่สร้างคำจำกัดความของโมเดลข้อมูล, Callback และซอร์สโค้ด Matter อื่นๆ โดยอัตโนมัติ
• สร้างและใช้ไฟล์ ZAP ที่กำหนดค่าไว้ล่วงหน้าเพื่อรวมไว้ใน SDK

ติดตั้ง

1. ไปที่หน้ารุ่นของ ZAP

2. มองหารุ่นที่ติดแท็ก "ล่าสุด" (ส่วนใหญ่จะติดแท็ก "รุ่นทดลอง")

3. ในรุ่นนี้ ให้เลือกแพ็กเกจที่กำหนดไว้สำหรับระบบปฏิบัติการของคุณในส่วนหัวชิ้นงาน แล้วดาวน์โหลด

4. ในเครื่องที่ใช้ Debian หรือ Ubuntu ให้ติดตั้ง ZAP โดยเรียกใช้คำสั่งต่อไปนี้

   sudo dpkg -i path/to/zap_installation_package

ใน Debian หรือ Ubuntu Linux ไบนารี zap จะติดตั้งใน /usr/bin/ ในระบบปฏิบัติการอื่นๆ ไบนารีอาจติดตั้งอยู่ที่อื่น ไม่ว่าในกรณีใดก็ตาม ให้ตรวจสอบว่าตำแหน่งของไฟล์ปฏิบัติการอยู่ในตัวแปรสภาพแวดล้อม PATH

ไฟล์ ZAP

ZAP ใช้ไฟล์เทมเพลตที่เรียกว่าไฟล์ ZAP ไฟล์ ZAP คือไฟล์ JSON ที่กำหนดปลายทาง, คำสั่ง, แอตทริบิวต์ และฟีเจอร์อื่นๆ ของอุปกรณ์ ไฟล์ ZAP มีชื่อที่ลงท้ายด้วย .zap เช่น lighting-app.zap ใน connectedhomeip/examples/lighting-app/lighting-common

ไฟล์ all-clusters-app.zap ที่พบใน connectedhomeip/examples/all-clusters-app/all-clusters-common ได้รับการกำหนดค่าล่วงหน้าด้วยคลัสเตอร์ Matter ทั่วไปและปลายทาง 3 รายการ ซึ่งรวมถึงประเภทอุปกรณ์ที่ทำหน้าที่เป็นคอมมิชชันเนอร์สำหรับเครือข่ายรอง Matter ตัวอย่างนี้เหมาะสำหรับการสำรวจการกำหนดค่าคลัสเตอร์ต่างๆ

เรียกใช้

1. เลือกไฟล์ ZAP จากตัวอย่าง Matter รายการ
2. จากไดเรกทอรีรากของที่เก็บ Matter (connectedhomeip) ให้เรียกใช้สคริปต์ Wrapper run_zaptool.sh โดยส่งเส้นทางไปยังไฟล์ .zap

เช่น

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

ตั้งค่า

ในการตั้งค่า settings คุณสามารถกำหนดค่าอินเทอร์เฟซผู้ใช้ของ ZAP ได้ รวมถึงเลือกธีมสว่างหรือธีมมืด และเปิดหรือปิดใช้เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์

การคลิกtune ตัวเลือกจะช่วยให้คุณเลือกผู้ผลิตผลิตภัณฑ์ นโยบายการตอบกลับเริ่มต้น และเปิดหรือปิดใช้การค้นหาคำสั่งได้

คลิก extension Extensions เพื่อเพิ่มคลัสเตอร์หรือคำสั่ง ZCL ที่กำหนดเองลงใน Zigbee Clusters Configurator

ใช้

ปลายทาง

ไฟล์ lighting-app.zap ได้รับการกำหนดค่าไว้ล่วงหน้าด้วยโหนดรูท Matter (Endpoint - 0) และไฟหรี่แสงได้ Matter (Endpoint - 1)

ปลายทาง - 0 ประกอบด้วยคลัสเตอร์ทั่วไปที่เกี่ยวข้องกับทั้งโหนด เช่น คลัสเตอร์เครือข่าย การคอมมิชชัน ตัวบ่งชี้ ข้อมูลเข้าสู่ระบบการทำงาน และ OTA

ในขั้นตอนถัดไป คุณจะตรวจสอบและกำหนดค่า Endpoint - 1 Matter ไฟหรี่ได้จากตัวอย่าง lighting-app

1. จากที่เก็บ Matter connectedhomeip ให้เรียกใช้ ZAP

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

2. คลิกปลายทาง - 1 แล้วคลิก edit แก้ไข

3. ไม่บังคับ: Matter รองรับอุปกรณ์ประเภทต่างๆ ในเมนูแบบเลื่อนลงอุปกรณ์ ให้เริ่มพิมพ์ matter เพื่อเปลี่ยนอุปกรณ์ แล้วคลิกบันทึก

   

ดูข้อมูลเพิ่มเติมได้ที่อุปกรณ์และปลายทางในคู่มือเบื้องต้นเกี่ยวกับ Matter

คลัสเตอร์

คลัสเตอร์ แอตทริบิวต์ และตัวเลือกการรายงานที่กำหนดไว้ล่วงหน้าจะเปิดใช้ใน Endpoint - 1 โดยค่าเริ่มต้น

หากต้องการแสดงเฉพาะคลัสเตอร์ที่เปิดใช้ ให้คลิก Endpoint - 1 แล้วเลือกคลัสเตอร์ที่เปิดใช้จากเมนูแสดง นอกจากนี้ คุณยังค้นหาคลัสเตอร์ search ตามชื่อได้ด้วย เช่น on

หากต้องการเปิดใช้คลัสเตอร์เป็นไคลเอ็นต์ เซิร์ฟเวอร์ หรือไคลเอ็นต์และเซิร์ฟเวอร์ ให้ใช้เมนูแบบเลื่อนลงเปิดใช้ นอกจากนี้ คุณยังเลือกไม่ได้เปิดใช้เพื่อปิดใช้คลัสเตอร์ที่กำหนดค่าไว้ล่วงหน้าซึ่งไม่เกี่ยวข้องกับประเภทอุปกรณ์ของคุณได้ด้วย

ดูข้อมูลเพิ่มเติมได้ที่คลัสเตอร์ในคู่มือเบื้องต้นเกี่ยวกับ Matter

แอตทริบิวต์และคำสั่ง

หากต้องการกำหนดค่าแอตทริบิวต์และคำสั่ง ให้ทำตามขั้นตอนต่อไปนี้

1. ค้นหาคลัสเตอร์ On/Off

2. ในแถวเดียวกัน ให้คลิกไอคอนกำหนดค่า settings

   

คุณสามารถเปิดหรือปิดใช้แอตทริบิวต์ ตั้งค่าตัวเลือกแอตทริบิวต์ต่างๆ และค้นหาแอตทริบิวต์ search ตามชื่อได้ที่นี่

คลิกคำสั่งเพื่อกำหนดค่าการดำเนินการสำหรับคลัสเตอร์นี้ ตัวอย่างเช่น คลัสเตอร์เปิด/ปิดสำหรับไฟจะประกอบด้วยคำสั่งเปิด ปิด และสลับ คลัสเตอร์บางรายการ เช่น คลัสเตอร์ Temperature Measurement อาจไม่มีคำสั่งที่เชื่อมโยง

ดูข้อมูลเพิ่มเติมได้ที่แอตทริบิวต์และคำสั่งในคู่มือเบื้องต้นเกี่ยวกับ Matter

สร้างไฟล์ต้นฉบับ ZAP

ตัวอย่าง Matter ใช้ซอร์สโค้ดที่สร้างโดย ZAP ซึ่งมีอยู่ในไดเรกทอรี connectedhomeip/zzz_generated ไฟล์บางไฟล์เป็นไฟล์เฉพาะแอป ส่วนไฟล์ ZAP ทั่วไปอื่นๆ จะจัดกลุ่มอยู่ใน app-common

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

เมื่อกำหนดค่าปลายทางแล้ว คุณจะสร้างไฟล์ต้นฉบับเพื่อผสานรวมเข้ากับโปรเจ็กต์ได้

1. คลิก video_settings สร้าง
2. เลือกโฟลเดอร์ที่จะบันทึกเอาต์พุต ZAP เช่น ไปที่ connectedhomeip/zzz_generated/lighting-app/zap-generated สำหรับ lighting-app
3. ไม่บังคับ เปิดไฟล์ใน IDE ที่ต้องการ

ZAP จะสร้างคำจำกัดความ ฟังก์ชัน และซอร์สโค้ดอื่นๆ ที่กำหนดเองสำหรับประเภทอุปกรณ์และการกำหนดค่า ZAP ของคุณ

ตัวอย่างเช่น callback-stub.cpp มีเมธอด Callback ของคลัสเตอร์ที่มีเฉพาะคลัสเตอร์ที่คุณเปิดใช้เท่านั้น

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

ใช้ไฟล์ต้นฉบับ ZAP

คุณสามารถใช้ไฟล์ต้นฉบับ ZAP ทั่วไป เช่น Attributes.h ใน zzz_generated/app-common/app-common/zap-generated/ids/ เพื่อรับและตั้งค่าแอตทริบิวต์ประเภทอุปกรณ์ได้ ดังนี้

namespace DeviceTemperatureConfiguration {
  namespace Attributes {

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

  ...

  } // namespace Attributes
} // namespace DeviceTemperatureConfiguration

#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");
    }
}

เมื่อเข้าใจวิธีใช้ไฟล์ ZAP ในซอร์สโค้ด Matter แล้ว คุณจะผสานรวม ZAP ได้หลายวิธีดังนี้

• ใช้ไฟล์ zzz_generated ที่มีอยู่เพื่อสร้างตัวอย่างใหม่ซึ่งไม่ซ้ำกันสำหรับประเภทอุปกรณ์ของคุณ
• สร้างไฟล์ .zap ที่กำหนดเองสำหรับโปรเจ็กต์ของคุณ

ปรับแต่ง

ระบบจะสร้างไฟล์ ZAP จากเทมเพลต ZAP เมื่อคุณใช้ run_zaptool.sh เพื่อเปิดใช้ ZAP สคริปต์นี้จะส่งผ่านเทมเพลตต่อไปนี้

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 กำหนดชื่อเทมเพลต Matter และไฟล์เอาต์พุตที่เกี่ยวข้องซึ่งใช้ในตัวอย่าง Matter

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

หากต้องการปรับแต่งโซลูชัน Matter คุณสามารถทำตามขั้นตอนถัดไปหลายขั้นตอนเมื่อทำงานร่วมกับ ZAP ดังนี้

• สร้างเทมเพลต Zap
• ผสานรวม ZAP เข้ากับ SDK

แหล่งข้อมูล

ดูแหล่งข้อมูลเพิ่มเติมเกี่ยวกับ ZAP ได้ที่ ที่เก็บ ZAP (zap) ใน GitHub