Hướng dẫn sử dụng SDK Zigbee EmberZ Net của SILICON LABS

Silicon Labs là nhà cung cấp được các OEM lựa chọn để phát triển mạng lưới Zigbee vào sản phẩm của họ. Nền tảng Zigbee của Silicon Labs là giải pháp Zigbee tích hợp, hoàn thiện và giàu tính năng nhất hiện có. SDK EmberZNet của Silicon Labs chứa triển khai đặc tả ngăn xếp Zigbee của Silicon Labs.

ĐẶC ĐIỂM CHÍNH

Zigbee

-250+ mục nhập trong bảng khóa liên kết APS
Hỗ trợ ZigbeeD trên Android 12 (v21.0.6113669) và Tizen (v0.1-13.1)

Hỗ trợ mô-đun xG26

Đa giao thức

Hỗ trợ ZigbeeD và OTBR trên OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT với chức năng lắng nghe đồng thời trên MG26 cho SoC – GA

802.15.4 Thành phần ưu tiên lập lịch vô tuyến hợp nhất
Hỗ trợ đóng gói Debian cho các ứng dụng máy chủ MP – Alpha

Sản phẩm mới

Những thay đổi quan trọng
Kích thước bảng khóa liên kết APS (được cấu hình bằng SL_ZIGBEE_KEY_TABLE_SIZE) được mở rộng từ 127 lên 254 mục.

Hỗ trợ R23 được thêm vào cho chức năng vận hành Mạng ZDD. Chức năng đường hầm khả dụng mà không cần hỗ trợ cho các trường hợp sử dụng Mạng cũ.

Các thành phần Network Steering và Network Creator đã được cập nhật để bao gồm hỗ trợ cho việc tham gia R23. Bao gồm các thay đổi liên quan sau.
- Chính sách yêu cầu Trust Center Link Key (TCLK) mặc định đã được cập nhật để tạo khóa mới cho mỗi thiết bị yêu cầu. Một khóa mới được tạo mỗi lần các thiết bị yêu cầu cố gắng cập nhật Trust Center Link Key của chúng.
- Do thay đổi chính sách TCLK trước đó, thành phần Network Creator Security hiện yêu cầu thành phần Security Link Keys. Việc nâng cấp ứng dụng sẽ được cập nhật để tuân thủ yêu cầu mới này.
- Một cấu hình mới,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY được thêm vào để cho phép tham gia bằng khóa băm lõi. Cấu hình này nằm trong thành phần Network Creator Security. Việc sử dụng chính sách này cho phép mỗi thiết bị tham gia nhận được một TCLK duy nhất sau khi tham gia, nhưng các nỗ lực lặp lại để cập nhật TCLK sẽ không tạo ra khóa mới cho thiết bị yêu cầu. Việc sử dụng khóa liên kết băm này là chính sách mặc định trước bản phát hành này và việc sử dụng chính sách này cho phép Trust Center tránh đưa vào thành phần Security Link Keys, thành phần này lưu khóa trong Flash.
  Ghi chú:Silicon Labs không khuyến khích sử dụng chính sách này vì điều này ngăn cản các thiết bị tham gia triển khai hoặc cập nhật TCLK của chúng.

Một bộ cấu hình mới được thêm vào thành phần zigbee_ezsp_spi để cho phép cấu hình thiết bị SPI chủ và giao diện chân của nó.
Người cũampcác dự án, bao gồm cả dự án files (.slcps) và thư mục dự án được đổi tên thành hướng dẫn đặt tên của Silicon Labs và được chuyển vào thư mục “dự án”.

Hỗ trợ nền tảng mới

Mô-đun mới
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Bảng radio mới
- MGM260P-RB4350A
- MGM260P-RB4351A
Phần mới
- efr32xg27
Bộ công cụ khám phá
- BRD2709A
- MGM260P-EK2713A

Tài liệu mới
Hướng dẫn sử dụng EZSP UG600 mới cho phiên bản 8.1 trở lên.

Cải tiến

Giới hạn SL_ZIGBEE_KEY_TABLE_SIZE được mở rộng lên tới 254 mục.
Đã thêm zigbee_security_link_keys vào Z3Light.
Đã thêm zigbee_security_link_keys vào zigbee_mp_z3_tc_z3_tc. Cập nhật kích thước bảng khóa của nó.
Tăng kích thước bảng khóa Z3 Gateway (sẽ được đặt thành ncp) lên 20.

Các vấn đề đã được khắc phục

Các vấn đề đã biết trong bản phát hành hiện tại

Các vấn đề in đậm đã được thêm vào kể từ phiên bản trước. Nếu bạn đã bỏ lỡ một bản phát hành, các ghi chú phát hành gần đây có sẵn tại https://www.silabs.com/developers/zigbee-emberznet trong tab Tài liệu Công nghệ.

Các mặt hàng không được dùng nữa

Thành phần zigbee_watchdog_periodic_refresh không còn được sử dụng trong khuôn khổ ứng dụng Zigbee và đã bị loại bỏ trong bản phát hành này. Bộ đếm thời gian giám sát bị vô hiệu hóa theo mặc định cho tất cả cácampứng dụng. Sẽ có một thành phần giám sát được cải tiến được thêm vào SDK trong tương lai.
Ghi chú: Kích hoạt bộ đếm thời gian giám sát với mục cấu hình SL_LEGACY_HAL_DISABLE_WATCHDOG được đặt thành 0 trong ứng dụng của bạn

Những hạn chế và cân nhắc về mạng

Các ứng dụng Trust Center mặc định đi kèm với bản phát hành EmberZNet này có khả năng hỗ trợ nhiều thiết bị trên mạng. Con số này được xác định dựa trên một số yếu tố, bao gồm kích thước bảng được cấu hình, mức sử dụng NVM và các giá trị thời gian thế hệ và thời gian chạy khác. Người dùng muốn tạo mạng lớn có thể gặp phải các vấn đề về tài nguyên khi mở rộng mạng lớn hơn mức ứng dụng có thể hỗ trợ. Ví dụample, một thiết bị yêu cầu Khóa liên kết Trung tâm tin cậy từ Trung tâm tin cậy có thể kích hoạt lệnh gọi lại sl_zigbee_af_zigbee_key_establishment_cb trên Trung tâm tin cậy với trạng thái h được đặt thành SL_ZIGBEE_KEY_TABLE_FULL, cho biết bảng khóa không có đủ chỗ để thêm khóa mới cho thiết bị yêu cầu hoặc NVM3 không có đủ không gian. Silicon Labs cung cấp các khuyến nghị sau cho người dùng muốn tạo mạng lớn. Đối với các ứng dụng Trung tâm tin cậy, các cấu hình sau được khuyến nghị. Các khuyến nghị này không đầy đủ và chúng đóng vai trò là cơ sở cho các ứng dụng có ý định phát triển mạng lớn.

Bao gồm thành phần Bảng địa chỉ (zigbee_address_table), với
- mục cấu hình SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE được đặt thành kích thước của mạng mong muốn
- giá trị SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE được đặt ở mức tối đa (4)

Bao gồm thành phần Khóa liên kết bảo mật (zigbee_security_link_keys), với
- Giá trị SL_ZIGBEE_KEY_TABLE_SIZE được đặt thành kích thước của mạng
Các mục cấu hình sau được thiết lập theo kích thước của mạng mong muốn
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, như được tìm thấy trong thành phần Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, như được tìm thấy trong thành phần định tuyến Nguồn, nếu định tuyến nguồn được sử dụng
Điều chỉnh NVM3_DEFAULT_NVM_SIZE và NVM3_DEFAULT_CACHE_SIZE theo cách sử dụng NVM3
- Ví dụ kích thước mạng lớn hơn 65 nút có thể yêu cầu kích thước NVM3 là 64K. Kích thước NVM3 mặc định trong Silicon Labs Zigbee sampứng dụng là 32K. Các ứng dụng sử dụng NVM nhiều hơn có thể yêu cầu điều chỉnh giá trị này cao hơn nữa.
- Các mạng lớn lên tới 65 nút có thể cần kích thước bộ đệm NVM3 là 1200 byte; các mạng lớn hơn thế có thể cần tăng gấp đôi giá trị này lên 2400 byte.

Những điều chỉnh này chỉ áp dụng cho Trung tâm tin cậy

Cổng đa giao thức và RCP

Sản phẩm mới
Đã bật hỗ trợ GA SoC cho BLE DMP với Zigbee + Openthread CMP với chức năng lắng nghe đồng thời trên các bộ phận xG26. Đã thêm hỗ trợ Debian alpha cho các ứng dụng Zigbeed, OTBR và Z3Gateway. Zigbeed và OTBR cũng được cung cấp ở định dạng gói DEB cho nền tảng tham chiếu đã chọn (Raspberry PI 4). Xem Chạy Zigbee, OpenThread và Bluetooth đồng thời trên Máy chủ Linux với Bộ đồng xử lý đa giao thức, có tại docs.silabs.com, để biết chi tiết. Đã thêm hỗ trợ Zigbeed cho Tizen-0.1-13.1 cho arm32 và aarch64 cũng như Android 12 cho aarch64. Có thể tìm thêm thông tin về Zigbeed tại docs.silabs.com. Đã thêm thành phần “802.15.4 Unified radio scheduler priority” mới. Thành phần này được sử dụng để cấu hình các ưu tiên radio của một ngăn xếp 15.4. Thành phần này cũng yêu cầu thành phần “radio_priority_configurator” mới. Thành phần này cho phép các dự án sử dụng công cụ Radio Priority Configurator trong Simplicity Studio để cấu hình các mức ưu tiên radio của các ngăn xếp yêu cầu.

Cải tiến
Ghi chú ứng dụng Chạy Zigbee, OpenThread và Bluetooth đồng thời trên Máy chủ Linux với Bộ xử lý đồng thời đa giao thức (AN1333) đã được chuyển đến docs.silabs.com. Hỗ trợ OpenWRT hiện đạt chất lượng GA. Hỗ trợ OpenWRT đã được thêm vào cho các ứng dụng Zigbee, OTBR và Z3Gateway. Zigbeed và OTBR cũng được cung cấp ở định dạng gói IPK cho nền tảng tham chiếu (Raspberry PI 4). Xem Chạy Zigbee, OpenThread và Bluetooth đồng thời trên Máy chủ Linux với Bộ đồng xử lý đa giao thức, có tại docs.silabs.com, để biết chi tiết.

Các vấn đề đã được khắc phục

Các vấn đề đã biết trong bản phát hành hiện tại
Các vấn đề in đậm đã được thêm vào kể từ bản phát hành trước. Nếu bạn đã bỏ lỡ một bản phát hành, các ghi chú phát hành gần đây có sẵnhttps://www.silabs.com/developers/simplicity-software-development-kit.

Các mặt hàng không được dùng nữa
“Multiprotocol Container” hiện có trên DockerHub (siliconlabsinc/multiprotocol) sẽ bị loại bỏ trong bản phát hành sắp tới. Container sẽ không còn được cập nhật và có thể được kéo từ DockerHub. Các gói dựa trên Debian cho cpcd, ZigBee và ot-br-posix, cùng với các dự án được tạo và biên dịch gốc, sẽ thay thế chức năng bị mất khi loại bỏ container.

Sử dụng bản phát hành này

Bản phát hành này có chứa những điều sau đây:

Ngăn xếp Zigbee
Khung ứng dụng Zigbee
Zigbee Sample Các ứng dụng

Để biết thêm thông tin về Zigbee và EmberZNet SDK, hãy xem UG103.02: Nguyên tắc cơ bản về Zigbee. Nếu bạn là người dùng lần đầu, hãy xem QSG180: Hướng dẫn bắt đầu nhanh Zigbee EmberZNet dành cho SDK 7.0 trở lên, để biết hướng dẫn về cách định cấu hình môi trường phát triển của bạn, xây dựng và nhấp nháy dưới dạngampứng dụng và tài liệu tham khảo chỉ ra các bước mở rộng.

Cài đặt và sử dụng
SDK Zigbee EmberZNet được cung cấp như một phần của SDK Simplicity, bộ SDK Silicon Labs. Để nhanh chóng bắt đầu với SDK Simplicity, hãy cài đặt Simplicity Studio 5, sẽ thiết lập môi trường phát triển của bạn và hướng dẫn bạn cài đặt Simplicity SDK. Simplicity Studio 5 bao gồm mọi thứ cần thiết để phát triển sản phẩm IoT với các thiết bị Silicon Labs, bao gồm trình khởi chạy tài nguyên và dự án, công cụ cấu hình phần mềm, IDE đầy đủ với chuỗi công cụ GNU và công cụ phân tích. Hướng dẫn cài đặt được cung cấp trong Hướng dẫn sử dụng Simplicity Studio 5 trực tuyến. Ngoài ra, Simplicity SDK có thể được cài đặt thủ công bằng cách tải xuống hoặc sao chép phiên bản mới nhất từ GitHub. Xem https://github.com/SiliconLabs/simplicity_sdk để biết thêm thông tin. Simplicity Studio cài đặt Simplicity SDK theo mặc định trong:

(Windows): C:\Users\\SimplicityStudio\SDKs\simplicity_sdk

(MacOS): /Users//SimplicityStudio/SDKs/simplicity_sdk

Tài liệu dành riêng cho phiên bản SDK được cài đặt cùng với SDK. Thông tin bổ sung thường có thể được tìm thấy trong các bài viết cơ sở kiến thức (KBA). Tài liệu tham khảo API và thông tin khác về phiên bản này và các phiên bản trước đó có sẵn tại https://docs.silabs.com/.

Thông tin bảo mật
Tích hợp Vault an toàn
Đối với các ứng dụng chọn lưu trữ khóa một cách an toàn bằng cách sử dụng thành phần Lưu trữ khóa an toàn trên các bộ phận Secure Vault-High, bảng sau đây hiển thị các khóa được bảo vệ và đặc điểm bảo vệ bộ lưu trữ của chúng mà thành phần Trình quản lý bảo mật Zigbee quản lý.Có thể sử dụng các khóa bọc được đánh dấu là "Không thể xuất" nhưng không thể viewđược biên tập hoặc chia sẻ khi chạy. Các khóa được bọc được đánh dấu là "Có thể xuất" có thể được sử dụng hoặc chia sẻ khi chạy nhưng vẫn được mã hóa trong khi lưu trữ trong Flash. Các ứng dụng của người dùng không bao giờ cần phải tương tác với phần lớn các khóa này. Các API hiện có để quản lý các khóa Bảng khóa liên kết hoặc Khóa tạm thời vẫn khả dụng cho ứng dụng của người dùng và không được định tuyến qua thành phần Zigbee Security Manager.

Cố vấn An ninh
Để đăng ký Tư vấn bảo mật, hãy đăng nhập vào cổng khách hàng của Silicon Labs, sau đó chọn Trang chủ tài khoản. Nhấp vào TRANG CHỦ để truy cập trang chủ cổng thông tin rồi nhấp vào ô Quản lý thông báo. Đảm bảo rằng bạn đã chọn 'Thông báo Tư vấn về Phần mềm/Bảo mật & Thông báo Thay đổi Sản phẩm (PCN)' và rằng bạn đã đăng ký ở mức tối thiểu cho nền tảng và giao thức của mình. Nhấp vào Lưu để lưu mọi thay đổi.

Ủng hộ
Khách hàng của Bộ công cụ phát triển đủ điều kiện được đào tạo và hỗ trợ kỹ thuật. Sử dụng Phòng thí nghiệm Silicon Zigbee web trang để lấy thông tin về tất cả các sản phẩm và dịch vụ Zigbee của Silicon Labs và để đăng ký hỗ trợ sản phẩm. Bạn có thể liên hệ với bộ phận hỗ trợ của Silicon Laboratories tại http://www.silabs.com/support.

Chứng nhận Zigbee
Bản phát hành Ember ZNet 8.1 đã được chứng nhận là Nền tảng tuân thủ Zigbee cho các kiến trúc SoC, NC, P và RCP, có ID chứng nhận ZCP liên quan đến bản phát hành này, vui lòng kiểm tra CSA webtrang web ở đây:
https://csa-iot.org/csa-iot_products/.

Xin lưu ý rằng chứng nhận ZCP là filed đăng bản phát hành và mất vài tuần trước khi được phản ánh trên CSA webtrang web. Nếu có bất kỳ thắc mắc nào khác, vui lòng liên hệ với bộ phận hỗ trợ của Silicon Laboratories tại http://www.silabs.com/support.

Câu hỏi thường gặp

H: Làm thế nào để cập nhật kích thước bảng khóa liên kết APS trong SDK?
A: Kích thước bảng khóa liên kết APS có thể được cấu hình bằng tham số SL_ZIGBEE_KEY_TABLE_SIZE. Trong phiên bản 8.1, nó đã được mở rộng từ 127 lên 254 mục.

H: Phiên bản 8.1 có những cải tiến gì?
A: Phiên bản 8.1 mang đến những cải tiến như mở rộng kích thước bảng khóa liên kết APS, đổi tên các thành phần, thêm bảo vệ mutex cho hàng đợi sự kiện Athe pp Framework, v.v. Tham khảo ghi chú phát hành để biết danh sách chi tiết các cải tiến.

H: Tôi phải xử lý các sự cố đã khắc phục trong SDK như thế nào?
A: Đã khắc phục các sự cố trong SDK bao gồm giải quyết các sự cố tiềm ẩn với cấu hình kích thước bảng lân cận, đổi tên thành phần, sửa lỗi phát sinh tuyến nguồn, xử lý lệnh ZCL, v.v. Đảm bảo bạn cập nhật lên phiên bản mới nhất để được hưởng lợi từ các bản sửa lỗi này.

Tài liệu / Tài nguyên

SILICON LABS Zigbee EmberZ Net SDK [tập tin pdf] Hướng dẫn
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Tài liệu tham khảo

Hướng dẫn sử dụng

SILICON LABS Zigbee EmberZ Net SDK

Thông số kỹ thuật

Thông tin sản phẩm