คำแนะนำสำหรับ SDK Zigbee EmberZ Net ของ SILICON LABS

Silicon Labs คือผู้จำหน่ายที่ผู้ผลิตอุปกรณ์ดั้งเดิม (OEM) เลือกใช้ในการพัฒนาระบบเครือข่าย Zigbee ให้กับผลิตภัณฑ์ของตน แพลตฟอร์ม Zigbee ของ Silicon Labs ถือเป็นโซลูชัน Zigbee ที่มีการบูรณาการ สมบูรณ์ และมีคุณสมบัติครบครันที่สุดที่มีจำหน่าย Silicon Labs EmberZNet SDK ประกอบด้วยการนำข้อมูลจำเพาะของสแต็ก Zigbee ของ Silicon Labs ไปใช้งาน

คุณสมบัติที่สำคัญ

ซิกบี

-250+ รายการในตารางคีย์ลิงก์ APS
รองรับ ZigbeeD บน Android 12 (v21.0.6113669) และ Tizen (v0.1-13.1)

รองรับโมดูล xG26

หลายโปรโตคอล

รองรับ ZigbeeD และ OTBR บน OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT พร้อมการรับฟังพร้อมกันบน MG26 สำหรับ SoC – GA

802.15.4 ส่วนประกอบลำดับความสำคัญของตัวจัดกำหนดการวิทยุแบบรวม
การสนับสนุนการบรรจุภัณฑ์ Debian สำหรับแอปพลิเคชันโฮสต์ MP – Alpha

สินค้าใหม่

การเปลี่ยนแปลงที่สำคัญ
ขนาดตารางคีย์ลิงก์ APS (กำหนดค่าโดยใช้ SL_ZIGBEE_KEY_TABLE_SIZE) ได้รับการขยายจาก 127 รายการเป็น 254 รายการ

เพิ่มการรองรับ R23 สำหรับฟังก์ชันการใช้งานเครือข่าย ZDD ฟังก์ชันการสร้างอุโมงค์จะพร้อมใช้งานโดยไม่ต้องรองรับกรณีการใช้งานเครือข่ายแบบดั้งเดิม

ส่วนประกอบของ Network Steering และ Network Creator ได้รับการอัปเดตเพื่อรวมการรองรับการเข้าร่วม R23 ซึ่งรวมถึงการเปลี่ยนแปลงที่เกี่ยวข้องดังต่อไปนี้
- นโยบายการร้องขอ Trust Center Link Key (TCLK) เริ่มต้นได้รับการอัปเดตเพื่อสร้างคีย์ใหม่สำหรับแต่ละอุปกรณ์ที่ร้องขอ คีย์ใหม่จะถูกสร้างขึ้นทุกครั้งที่อุปกรณ์ที่ร้องขอพยายามอัปเดต Trust Center Link Key ของตน
- เนื่องจากนโยบาย TCLK มีการเปลี่ยนแปลงก่อนหน้านี้ ส่วนประกอบ Network Creator Security จึงต้องใช้ส่วนประกอบ Security Link Keys การอัพเกรดแอปพลิเคชันจะได้รับการอัปเดตเพื่อให้สอดคล้องกับข้อกำหนดใหม่นี้
- การกำหนดค่าใหม่
  เพิ่ม SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY เพื่อให้สามารถเข้าร่วมโดยใช้คีย์แฮชหลัก การกำหนดค่านี้พบได้ภายใต้ส่วนประกอบ Network Creator Security การใช้หลักเกณฑ์นี้ทำให้แต่ละอุปกรณ์ที่เข้าร่วมสามารถรับ TCLK ที่ไม่ซ้ำกันหลังเข้าร่วม แต่การพยายามอัปเดต TCLK ซ้ำๆ จะไม่ส่งผลให้ได้คีย์ใหม่สำหรับอุปกรณ์ที่ร้องขอ การใช้คีย์ลิงก์แฮชนี้เป็นหลักเกณฑ์เริ่มต้นก่อนการเผยแพร่นี้ และการใช้หลักเกณฑ์นี้ทำให้ Trust Center หลีกเลี่ยงการนำส่วนประกอบ Security Link Keys เข้ามา ซึ่งจะบันทึกคีย์ใน Flash
  บันทึก:Silicon Labs ไม่แนะนำให้ใช้นโยบายนี้ เนื่องจากจะป้องกันไม่ให้อุปกรณ์ที่เข้าร่วมทำการโรลหรืออัปเดต TCLK ของตน

มีการเพิ่มชุดการกำหนดค่าใหม่ให้กับส่วนประกอบ zigbee_ezsp_spi เพื่อให้สามารถกำหนดค่าอุปกรณ์โฮสต์ SPI และอินเทอร์เฟซพินของอุปกรณ์ได้
อดีตampโครงการต่างๆ รวมถึงโครงการ fileโฟลเดอร์ s (.slcps) และโปรเจ็กต์ ได้รับการเปลี่ยนชื่อเป็นแนวทางการตั้งชื่อของ Silicon Labs และย้ายไปอยู่ภายใต้ไดเร็กทอรี “projects”

การสนับสนุนแพลตฟอร์มใหม่

โมดูลใหม่
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- บอร์ดวิทยุใหม่
- MGM260P-RB4350A
- MGM260P-RB4351A
ส่วนใหม่
- เอฟอาร์32xg27
ชุดนักสำรวจ
- BRD2709A
- MGM260P-EK2713A

เอกสารใหม่
คู่มือผู้ใช้ EZSP ใหม่ UG600 สำหรับรุ่น 8.1 ขึ้นไป

การปรับปรุง

ขีดจำกัด SL_ZIGBEE_KEY_TABLE_SIZE ขยายได้ถึง 254 รายการ
เพิ่ม zigbee_security_link_keys ให้กับ Z3Light
เพิ่ม zigbee_security_link_keys ลงใน zigbee_mp_z3_tc_z3_tc และอัปเดตขนาดตารางคีย์ด้วยเช่นกัน
เพิ่มขนาดตารางคีย์ Z3 Gateway (ที่จะตั้งค่าเป็น ncp) เป็น 20

ปัญหาที่ได้รับการแก้ไข

ปัญหาที่ทราบในรุ่นปัจจุบัน

มีการเพิ่มปัญหาที่เป็นตัวหนาตั้งแต่รุ่นก่อนหน้า หากคุณพลาดการเผยแพร่ บันทึกประจำรุ่นล่าสุดมีอยู่ที่ https://www.silabs.com/developers/zigbee-emberznet ในแท็บเอกสารทางเทคนิค

รายการที่เลิกใช้

คอมโพเนนต์ zigbee_watchdog_periodic_refresh จะไม่ถูกใช้ในกรอบงานแอปพลิเคชัน Zigbee อีกต่อไป และจะไม่รองรับอีกต่อไปในรุ่นนี้ ตัวจับเวลา watchdog จะถูกปิดใช้งานตามค่าเริ่มต้นสำหรับทุกๆ sampแอปพลิเคชัน ในอนาคตจะมีการเพิ่มส่วนประกอบ watchdog ที่ได้รับการปรับปรุงให้ดียิ่งขึ้นให้กับ SDK
บันทึก: เปิดใช้งานตัวจับเวลาเฝ้าระวังโดยตั้งค่ารายการการกำหนดค่า SL_LEGACY_HAL_DISABLE_WATCHDOG เป็น 0 ในแอปพลิเคชันของคุณ

ข้อจำกัดและข้อควรพิจารณาเกี่ยวกับเครือข่าย

แอปพลิเคชัน Trust Center เริ่มต้นที่มาพร้อมกับ EmberZNet รุ่นนี้สามารถรองรับอุปกรณ์ต่างๆ บนเครือข่ายได้หลายเครื่อง จำนวนนี้กำหนดขึ้นจากปัจจัยหลายประการ รวมถึงขนาดตารางที่กำหนดค่า การใช้งาน NVM และค่าเวลาการสร้างและรันไทม์อื่นๆ ผู้ใช้ที่ต้องการสร้างเครือข่ายขนาดใหญ่จะประสบปัญหาทรัพยากรเมื่อขยายเครือข่ายให้ใหญ่เกินกว่าที่แอปพลิเคชันจะรองรับได้ ตัวอย่างเช่นampอุปกรณ์ที่ร้องขอ Trust Center Link Key จาก Trust Center อาจทริกเกอร์การเรียกกลับ sl_zigbee_af_zigbee_key_establishment_cb บน Trust Center โดยที่สถานะ h ถูกตั้งเป็น SL_ZIGBEE_KEY_TABLE_FULL ซึ่งระบุว่าตารางคีย์ไม่มีพื้นที่ว่างสำหรับเพิ่มคีย์ใหม่สำหรับอุปกรณ์ที่ร้องขอหรือ NVM3 ไม่มีพื้นที่ว่าง Silicon Labs ให้คำแนะนำต่อไปนี้สำหรับผู้ใช้ที่ต้องการสร้างเครือข่ายขนาดใหญ่ สำหรับแอปพลิเคชัน Trust Center แนะนำให้ใช้การกำหนดค่าต่อไปนี้ คำแนะนำเหล่านี้ไม่ครอบคลุมทั้งหมด และทำหน้าที่เป็นพื้นฐานสำหรับแอปพลิเคชันที่ต้องการขยายเครือข่ายขนาดใหญ่

การรวมส่วนประกอบของตารางที่อยู่ (zigbee_address_table) ด้วย
- รายการการกำหนดค่า SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE จะถูกตั้งค่าตามขนาดของเครือข่ายที่ต้องการ
- ตั้งค่า SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE ไว้สูงสุด (4)

การรวมส่วนประกอบ Security Link Keys (zigbee_security_link_keys) ด้วย
- ค่า SL_ZIGBEE_KEY_TABLE_SIZE ถูกตั้งค่าเป็นขนาดของเครือข่าย
รายการกำหนดค่าต่อไปนี้จะถูกตั้งค่าตามขนาดเครือข่ายที่ต้องการ
- SL_ZIGBEE_BROADCAST_TABLE_SIZE ตามที่พบในส่วนประกอบ Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE ตามที่พบในส่วนประกอบการกำหนดเส้นทางต้นทาง ถ้ามีการใช้การกำหนดเส้นทางต้นทาง
การปรับ NVM3_DEFAULT_NVM_SIZE และ NVM3_DEFAULT_CACHE_SIZE ตามการใช้งาน NVM3
- ขนาดเครือข่ายที่ใหญ่กว่า 65 โหนดอาจต้องใช้ขนาด NVM3 ที่ 64K ขนาด NVM3 เริ่มต้นในเครือข่าย Zigbee ของ Silicon Labsampแอปพลิเคชันมีขนาด 32K แอปพลิเคชันที่ใช้ NVM มากขึ้นอาจต้องปรับค่านี้ให้สูงขึ้นอีก
- เครือข่ายขนาดใหญ่ที่มีโหนดถึง 65 โหนดอาจต้องใช้แคช NVM3 ขนาด 1200 ไบต์ หากเครือข่ายมีขนาดใหญ่กว่านั้นอาจต้องเพิ่มค่าเป็นสองเท่าเป็น 2400 ไบต์

การปรับเปลี่ยนเหล่านี้มีผลใช้กับศูนย์ความน่าเชื่อถือเท่านั้น

เกตเวย์หลายโปรโตคอลและ RCP

สินค้าใหม่
เปิดใช้งานการรองรับ GA SoC สำหรับ BLE DMP พร้อม Zigbee + Openthread CMP พร้อมการรับฟังพร้อมกันบนชิ้นส่วน xG26 เพิ่มการรองรับ Debian alpha สำหรับแอปพลิเคชัน Zigbeed, OTBR และ Z3Gateway Zigbeed และ OTBR มีให้ในรูปแบบแพ็คเกจ DEB สำหรับแพลตฟอร์มอ้างอิงที่เลือก (Raspberry PI 4) เช่นกัน ดูการเรียกใช้ Zigbee, OpenThread และ Bluetooth พร้อมกันบนโฮสต์ Linux ที่มีโคโปรเซสเซอร์หลายโปรโตคอล ได้ที่ docs.silabs.comสำหรับรายละเอียดเพิ่มเติม เพิ่มการรองรับ Zigbeed สำหรับ Tizen-0.1-13.1 สำหรับ arm32 และ aarch64 รวมถึง Android 12 สำหรับ aarch64 สามารถดูข้อมูลเพิ่มเติมเกี่ยวกับ Zigbeed ได้ที่ docs.silabs.comเพิ่มส่วนประกอบใหม่ “802.15.4 Unified radio scheduler priority” ส่วนประกอบนี้ใช้ในการกำหนดค่าความสำคัญของวิทยุของสแต็ก 15.4 ส่วนประกอบนี้ยังต้องการส่วนประกอบใหม่ “radio_priority_configurator” ส่วนประกอบนี้ช่วยให้โปรเจ็กต์สามารถใช้เครื่องมือ Radio Priority Configurator ใน Simplicity Studio เพื่อกำหนดค่าระดับความสำคัญของวิทยุของสแต็กที่ต้องการเครื่องมือนี้

การปรับปรุง
หมายเหตุการใช้งานการรัน Zigbee, OpenThread และ Bluetooth พร้อมกันบนโฮสต์ Linux ที่มีโคโปรเซสเซอร์แบบมัลติโปรโตคอล (AN1333) ได้ถูกย้ายไปที่ docs.silabs.com. ขณะนี้การรองรับ OpenWRT อยู่ในระดับคุณภาพ GA แล้ว มีการรองรับ OpenWRT สำหรับแอปพลิเคชัน Zigbee, OTBR และ Z3Gateway Zigbeed และ OTBR มีให้ในรูปแบบแพ็คเกจ IPK สำหรับแพลตฟอร์มอ้างอิง (Raspberry PI 4) เช่นกัน ดูการเรียกใช้ Zigbee, OpenThread และ Bluetooth พร้อมกันบนโฮสต์ Linux ที่มีโคโปรเซสเซอร์หลายโปรโตคอล ได้ที่ docs.silabs.com, สำหรับรายละเอียด

ปัญหาที่ได้รับการแก้ไข

ปัญหาที่ทราบในรุ่นปัจจุบัน
ปัญหาที่เป็นตัวหนาถูกเพิ่มเข้ามาตั้งแต่รุ่นก่อนหน้า หากคุณพลาดรุ่นใดรุ่นหนึ่ง โปรดดูหมายเหตุรุ่นใหม่ล่าสุดhttps://www.silabs.com/developers/simplicity-software-development-kit.

รายการที่เลิกใช้
“คอนเทนเนอร์มัลติโปรโตคอล” ซึ่งมีอยู่ใน DockerHub (siliconlabsinc/multiprotocol) ในปัจจุบันจะไม่รองรับอีกต่อไปในรุ่นที่จะออกในอนาคต คอนเทนเนอร์จะไม่ได้รับการอัปเดตอีกต่อไปและไม่สามารถดึงออกจาก DockerHub ได้ แพ็คเกจที่ใช้ Debian สำหรับ cpcd, ZigBee และ ot-br-posix รวมถึงโปรเจ็กต์ที่สร้างและคอมไพล์แบบเนทีฟจะเข้ามาแทนที่ฟังก์ชันการทำงานที่สูญเสียไปพร้อมกับการลบคอนเทนเนอร์ออก

การใช้ข่าวประชาสัมพันธ์ฉบับนี้

รุ่นนี้ประกอบด้วยสิ่งต่อไปนี้:

สแต็ก Zigbee
กรอบแอปพลิเคชัน Zigbee
ซิกบี เอสampแอปพลิเคชัน

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ Zigbee และ EmberZNet SDK โปรดดูที่ UG103.02: Zigbee Fundamentals หากคุณเป็นผู้ใช้ครั้งแรก โปรดดู QSG180: คู่มือเริ่มต้นใช้งานด่วน Zigbee EmberZNet สำหรับ SDK 7.0 และสูงกว่า สำหรับคำแนะนำในการกำหนดค่าสภาพแวดล้อมการพัฒนา การสร้างและการแฟลชเป็นampแอปพลิเคชันและเอกสารอ้างอิงที่ชี้ไปยังขั้นตอนที่ต่อพ่วง

การติดตั้งและการใช้งาน
Zigbee EmberZNet SDK จัดทำขึ้นเป็นส่วนหนึ่งของ Simplicity SDK ซึ่งเป็นชุด Silicon Labs SDK หากต้องการเริ่มต้นใช้งาน Simplicity SDK อย่างรวดเร็ว ให้ติดตั้ง Simplicity Studio 5 ซึ่งจะตั้งค่าสภาพแวดล้อมการพัฒนาของคุณและแนะนำคุณตลอดขั้นตอนการติดตั้ง Simplicity SDK Simplicity Studio 5 มีทุกอย่างที่จำเป็นสำหรับการพัฒนาผลิตภัณฑ์ IoT ด้วยอุปกรณ์ Silicon Labs รวมถึงตัวเรียกใช้ทรัพยากรและโปรเจ็กต์ เครื่องมือการกำหนดค่าซอฟต์แวร์ IDE เต็มรูปแบบพร้อมชุดเครื่องมือ GNU และเครื่องมือวิเคราะห์ คำแนะนำในการติดตั้งมีอยู่ในคู่มือผู้ใช้ Simplicity Studio 5 ออนไลน์ หรืออาจติดตั้ง Simplicity SDK ด้วยตนเองโดยดาวน์โหลดหรือโคลนเวอร์ชันล่าสุดจาก GitHub ดู https://github.com/SiliconLabs/simplicity_sdk สำหรับข้อมูลเพิ่มเติม Simplicity Studio จะติดตั้ง Simplicity SDK ตามค่าเริ่มต้นใน:

(วินโดวส์): C:\Users\\SimplicityStudio\SDKs\simplicity_sdk

(MacOS): /ผู้ใช้//SimplicityStudio/SDKs/simplicity_sdk

เอกสารประกอบเฉพาะสำหรับเวอร์ชัน SDK จะถูกติดตั้งพร้อมกับ SDK ข้อมูลเพิ่มเติมมักพบได้ในบทความฐานความรู้ (KBA) สามารถดูข้อมูลอ้างอิง API และข้อมูลอื่นๆ เกี่ยวกับเวอร์ชันนี้และเวอร์ชันก่อนหน้าได้ที่ https://docs.silabs.com/.

ข้อมูลด้านความปลอดภัย
การรวมห้องนิรภัยที่ปลอดภัย
สำหรับแอปพลิเคชันที่เลือกจัดเก็บคีย์อย่างปลอดภัยโดยใช้ส่วนประกอบ Secure Key Storage บนชิ้นส่วน Secure Vault-High ตารางต่อไปนี้จะแสดงคีย์ที่ได้รับการป้องกันและคุณลักษณะการป้องกันพื้นที่จัดเก็บข้อมูลที่ส่วนประกอบ Zigbee Security Manager จัดการคีย์ที่รวมไว้ซึ่งทำเครื่องหมายว่า "ไม่สามารถส่งออกได้" สามารถใช้ได้ แต่ไม่สามารถทำได้ viewed หรือแชร์ได้ในขณะรันไทม์ คีย์ที่ห่อหุ้มซึ่งทำเครื่องหมายว่า "ส่งออกได้" สามารถใช้หรือแชร์ได้ในขณะรันไทม์ แต่ยังคงเข้ารหัสในขณะที่จัดเก็บใน Flash แอปพลิเคชันของผู้ใช้ไม่จำเป็นต้องโต้ตอบกับคีย์ส่วนใหญ่เหล่านี้ API ที่มีอยู่เพื่อจัดการคีย์ Link Key Table หรือ Transient Keys ยังคงพร้อมใช้งานสำหรับแอปพลิเคชันของผู้ใช้และส่งต่อผ่านคอมโพเนนต์ Zigbee Security Manager ได้แล้ว

คำแนะนำด้านความปลอดภัย
หากต้องการสมัครรับคำแนะนำด้านความปลอดภัย ให้เข้าสู่ระบบพอร์ทัลลูกค้าของ Silicon Labs จากนั้นเลือกหน้าแรกของบัญชี คลิก HOME เพื่อไปที่โฮมเพจของพอร์ทัล จากนั้นคลิกไทล์ Manage Notifications ตรวจสอบให้แน่ใจว่าได้เลือก 'ประกาศคำแนะนำด้านซอฟต์แวร์/ความปลอดภัย & ประกาศการเปลี่ยนแปลงผลิตภัณฑ์ (PCN)' และคุณได้สมัครใช้งานแพลตฟอร์มและโปรโตคอลเป็นขั้นต่ำ คลิก บันทึก เพื่อบันทึกการเปลี่ยนแปลงใดๆ

สนับสนุน
ลูกค้าชุดพัฒนามีสิทธิ์ได้รับการฝึกอบรมและการสนับสนุนทางเทคนิค ใช้ Zigbee ของห้องปฏิบัติการซิลิคอน web หน้าเพื่อรับข้อมูลเกี่ยวกับผลิตภัณฑ์และบริการ Zigbee ของ Silicon Labs ทั้งหมด และเพื่อสมัครรับการสนับสนุนผลิตภัณฑ์ คุณสามารถติดต่อฝ่ายสนับสนุนของ Silicon Laboratories ได้ที่ http://www.silabs.com/support.

การรับรอง Zigbee
Ember ZNet 8.1 ได้รับการรับรองสำหรับแพลตฟอร์มที่สอดคล้องกับ Zigbee สำหรับสถาปัตยกรรม SoC, NC, P และ RCP มีรหัสรับรอง ZCP ที่เชื่อมโยงกับรุ่นนี้ โปรดตรวจสอบ CSA webเว็บไซต์ที่นี่:
https://csa-iot.org/csa-iot_products/.

โปรดทราบว่าการรับรอง ZCP คือ filed โพสต์การเผยแพร่และใช้เวลาสองสามสัปดาห์ก่อนที่จะได้รับการสะท้อนบน CSA webไซต์ หากมีคำถามเพิ่มเติม โปรดติดต่อฝ่ายสนับสนุน Silicon Laboratories ได้ที่ http://www.silabs.com/support.

คำถามที่พบบ่อย

ถาม: ฉันจะอัปเดตขนาดตารางคีย์ลิงก์ APS ใน SDK ได้อย่างไร
A: สามารถกำหนดค่าขนาดตารางคีย์ลิงก์ APS ได้โดยใช้พารามิเตอร์ SL_ZIGBEE_KEY_TABLE_SIZE ในเวอร์ชัน 8.1 ได้ขยายจาก 127 เป็น 254 รายการ

ถาม: มีการปรับปรุงอะไรในเวอร์ชั่น 8.1 บ้าง?
A: เวอร์ชัน 8.1 นำการปรับปรุงต่างๆ มา เช่น การขยายขนาดตารางคีย์ลิงก์ APS การเปลี่ยนชื่อคอมโพเนนต์ การเพิ่มการป้องกันมิวเท็กซ์สำหรับคิวเหตุการณ์ของ Athe pp Framework และอื่นๆ อีกมากมาย โปรดดูรายละเอียดการปรับปรุงในหมายเหตุการเผยแพร่

ถาม: ฉันจะจัดการกับปัญหาที่ได้รับการแก้ไขใน SDK ได้อย่างไร
A: แก้ไขปัญหาใน SDK รวมถึงแก้ไขปัญหาที่อาจเกิดขึ้นกับการกำหนดค่าขนาดตารางข้างเคียง การเปลี่ยนชื่อส่วนประกอบ การแก้ไขโอเวอร์เฮดของเส้นทางต้นทาง การจัดการคำสั่ง ZCL และอื่นๆ ตรวจสอบให้แน่ใจว่าคุณอัปเดตเป็นเวอร์ชันล่าสุดเพื่อรับประโยชน์จากการแก้ไขปัญหาเหล่านี้

เอกสาร / แหล่งข้อมูล

SILICON LABS Zigbee EmberZ Net SDK [พีดีเอฟ] คำแนะนำ
Zigbee EmberZ Net SDK, EmberZ Net SDK, SDK สุทธิ

อ้างอิง

คู่มือการใช้งาน

SILICON LABS Zigbee EmberZ Net SDK

ข้อมูลจำเพาะ

ข้อมูลสินค้า