SILICON LABS Zigbee EmberZ Net SDK instrukcijas

Silicon Labs ir OEM izvēles pārdevējs, kas savos produktos attīsta Zigbee tīklus. Silicon Labs Zigbee platforma ir visintegrētākais, pilnīgākais un ar funkcijām bagātākais pieejamais Zigbee risinājums. Silicon Labs EmberZNet SDK satur Silicon Labs Zigbee steka specifikācijas ieviešanu.

GALVENĀS ĪPAŠĪBAS

Zigbee

-250+ ieraksti APS saites atslēgu tabulā
ZigbeeD atbalsts operētājsistēmās Android 12 (v21.0.6113669) un Tizen (v0.1–13.1)

xG26 moduļa atbalsts

Daudzprotokola

ZigbeeD un OTBR atbalsts vietnē OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT ar vienlaicīgu klausīšanos MG26, kas paredzēts SoC — GA

802.15.4 Vienotais radio plānotāja prioritātes komponents
Debian iepakojuma atbalsts MP resursdatora lietojumprogrammām — Alpha

Jaunas preces

Svarīgas izmaiņas
APS saites atslēgas tabulas lielums (konfigurēts, izmantojot SL_ZIGBEE_KEY_TABLE_SIZE) ir paplašināts no 127 uz 254 ierakstiem.

R23 atbalsts ir pievienots ZDD tīkla nodošanas ekspluatācijā funkcionalitātei. Tunelēšanas funkcionalitāte ir pieejama bez atbalsta mantotā tīkla lietošanas gadījumiem.

Tīkla vadības un tīkla veidotāja komponenti ir atjaunināti, iekļaujot atbalstu R23 pievienošanai. Tie ietver šādas saistītās izmaiņas.
- Noklusējuma uzticamības centra saites atslēgas (TCLK) pieprasījuma politika ir atjaunināta, lai ģenerētu jaunas atslēgas katrai pieprasītājai ierīcei. Jauna atslēga tiek ģenerēta katru reizi, kad pieprasītājas ierīces mēģina atjaunināt savu uzticamības centra saites atslēgu.
- Iepriekšējo TCLK politikas izmaiņu dēļ tīkla veidotāja drošības komponentam tagad ir nepieciešams komponents Security Link Keys. Lietojumprogrammu jaunināšana tiks atjaunināta, lai atbilstu šai jaunajai prasībai.
- Jauna konfigurācija,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY ir pievienots, lai ļautu pievienoties, izmantojot jaukto atslēgu. Šī konfigurācija ir atrodama Network Creator Security komponentā. Izmantojot šo politiku, katra pievienošanās ierīce pēc pievienošanās saņem unikālu TCLK, taču atkārtoti mēģinājumi atjaunināt TCLK neizraisīs jaunu atslēgu pieprasītajai ierīcei. Šī jaukto saišu atslēgu izmantošana bija noklusējuma politika pirms šī laidiena, un šīs politikas izmantošana ļauj uzticamības centram izvairīties no drošības saites atslēgu komponenta, kas saglabā atslēgas programmā Flash, ievadīšanas.
  Piezīme: Silicon Labs neiesaka izmantot šo politiku, jo tā neļauj savienotajām ierīcēm pārvietot vai atjaunināt to TCLK.

Komponentam zigbee_ezsp_spi ir pievienota jauna konfigurācijas kopa, kas ļauj konfigurēt resursdatora SPI ierīci un tās tapu saskarnes.
Bijušaisample projektus, tostarp projektu files (.slcps) un projektu mape tiek pārdēvētas par Silicon Labs nosaukumu vadlīnijām un pārvietotas uz direktoriju “projekti”.

Jaunas platformas atbalsts

Jauni moduļi
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Jaunas radio plates
- MGM260P-RB4350A
- MGM260P-RB4351A
Jauna daļa
- efr32xg27
Explorer komplekts
- BRD2709A
- MGM260P-EK2713A

Jauna dokumentācija
Jaunas EZSP lietotāja rokasgrāmatas UG600 versijām 8.1 un jaunākām versijām.

Uzlabojumi

SL_ZIGBEE_KEY_TABLE_SIZE ierobežojumi paplašināti līdz 254 ierakstiem.
Zigbee_security_link_keys pievienots Z3Light.
Pievienots zigbee_security_link_keys zigbee_mp_z3_tc_z3_tc. Atjaunināts arī tā atslēgu tabulas izmērs.
Z3 Gateway taustiņu tabulas izmērs (kas tiks iestatīts uz ncp) ir palielināts līdz 20.

Fiksētas problēmas

Zināmās problēmas pašreizējā laidienā

Kopš iepriekšējā laidiena tika pievienotas problēmas ar treknrakstu. Ja esat palaidis garām kādu laidienu, jaunākās piezīmes par laidienu ir pieejamas vietnē https://www.silabs.com/developers/zigbee-emberznet cilnē Tehniskie dokumenti.

Novecojuši vienumi

Komponents zigbee_watchdog_periodic_refresh vairs netiek izmantots Zigbee lietojumprogrammu sistēmā, un šajā laidienā tas ir novecojis. Watchdog taimeris pēc noklusējuma ir atspējots visiem samplietojumprogrammas. Nākotnē SDK tiks pievienots uzlabots sargsuņa komponents.
Piezīme: iespējojiet sargsuņa taimeri ar konfigurācijas vienumu SL_LEGACY_HAL_DISABLE_WATCHDOG, kas jūsu lietojumprogrammā ir iestatīts uz 0

Tīkla ierobežojumi un apsvērumi

Noklusējuma uzticamības centra lietojumprogrammas, kas tiek piegādātas kopā ar šo EmberZNet laidienu, spēj atbalstīt vairākas tīkla ierīces. Šis skaitlis tiek noteikts, pamatojoties uz vairākiem faktoriem, tostarp konfigurētiem tabulas izmēriem, NVM lietojumu un citām ģenerēšanas laika un izpildes laika vērtībām. Lietotājiem, kuri vēlas izveidot lielus tīklus, var rasties problēmas ar resursiem, palielinot tīklu, nekā to var atbalstīt lietojumprogramma. Piemēram,ample, ierīce, kas no uzticamības centra pieprasa uzticamības centra saites atslēgu, var izraisīt sl_zigbee_af_zigbee_key_establishment_cb atzvanu uzticamības centrā ar h statusu, kas ir iestatīts uz SL_ZIGBEE_KEY_TABLE_FULL, norādot, ka atslēgu tabulā nav vietas, lai pievienotu pieprasītajai ierīcei vai jaunu atslēgu. NVM3 nav brīvas vietas. Silicon Labs sniedz šādus ieteikumus lietotājiem, kuri vēlas izveidot lielus tīklus. Uzticības centra lietojumprogrammām ir ieteicamas šādas konfigurācijas. Šie ieteikumi nav izsmeļoši, un tie kalpo par pamatu lietojumprogrammām, kas plāno paplašināt lielus tīklus.

Adrešu tabulas komponenta (zigbee_address_table) iekļaušana ar
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE konfigurācijas vienums ir iestatīts uz vajadzīgā tīkla lielumu
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE vērtība ir iestatīta uz maksimālo (4)

Drošības saites atslēgu komponenta (zigbee_security_link_keys) iekļaušana ar
- SL_ZIGBEE_KEY_TABLE_SIZE vērtība ir iestatīta atbilstoši tīkla lielumam
Tālāk norādītie konfigurācijas vienumi ir iestatīti atbilstoši vēlamā tīkla izmēram
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, kas atrodams Zigbee Pro Stack komponentā
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, kas atrodams avota maršrutēšanas komponentā, ja tiek izmantota avota maršrutēšana
NVM3_DEFAULT_NVM_SIZE un NVM3_DEFAULT_CACHE_SIZE pielāgošana atbilstoši NVM3 lietojumam
- Piemēram, tīkla izmēriem, kas ir lielāki par 65 mezgliem, iespējams, ir nepieciešams NVM3 izmērs 64 K. Noklusējuma NVM3 izmērs pakalpojumā Silicon Labs Zigbee samplietojumprogrammu skaits ir 32 XNUMX. Lietojumprogrammām, kas intensīvāk izmanto NVM, šī vērtība var būt jāpielāgo vēl lielākai.
- Lieliem tīkliem līdz 65 mezgliem var būt nepieciešams NVM3 kešatmiņas lielums 1200 baiti; ja tīkli kļūst lielāki, var būt nepieciešams dubultot šo vērtību līdz 2400 baitiem.

Šīs korekcijas attiecas tikai uz uzticības centru

Daudzprotokolu vārteja un RCP

Jaunas preces
Iespējots GA SoC atbalsts BLE DMP ar Zigbee + Openthread CMP ar vienlaicīgu klausīšanos xG26 daļās. Zigbeed, OTBR un Z3Gateway lietojumprogrammām ir pievienots Debian alfa atbalsts. Zigbeed un OTBR tiek nodrošināti arī DEB pakotnes formātā izvēlētajai atsauces platformai (Raspberry PI 4). Skatiet sadaļu Zigbee, OpenThread un Bluetooth vienlaicīga palaišana Linux resursdatorā ar vairāku protokolu kopprocesoru, kas atrodams vietnē docs.silabs.com, lai iegūtu sīkāku informāciju. Pievienots Zigbeed atbalsts Tizen-0.1-13.1 ierīcēm arm32 un aarch64, kā arī Android 12 operētājsistēmai aarch64. Plašāku informāciju par Zigbeed var atrast vietnē docs.silabs.com. Pievienots jaunais komponents “802.15.4 vienotā radio plānotāja prioritāte”. Šis komponents tiek izmantots, lai konfigurētu 15.4 steka radio prioritātes. Komponentam ir nepieciešams arī jaunais komponents “radio_priority_configurator”. Šis komponents ļauj projektiem izmantot Simplicity Studio rīku Radio Priority Configurator, lai konfigurētu to skursteņu radio prioritātes līmeņus, kuriem tas nepieciešams.

Uzlabojumi
Lietojumprogrammas piezīme Zigbee, OpenThread un Bluetooth vienlaicīga palaišana Linux resursdatorā ar vairāku protokolu kopprocesoru (AN1333) ir pārvietota uz docs.silabs.com. OpenWRT atbalsts tagad ir GA kvalitāte. OpenWRT atbalsts ir pievienots Zigbee, OTBR un Z3Gateway lietojumprogrammām. Zigbeed un OTBR tiek nodrošināti arī IPK pakotnes formātā atsauces platformai (Raspberry PI 4). Skatiet sadaļu Zigbee, OpenThread un Bluetooth vienlaicīga palaišana Linux resursdatorā ar vairāku protokolu kopprocesoru, kas atrodams vietnē docs.silabs.com, lai iegūtu sīkāku informāciju.

Fiksētas problēmas

Zināmās problēmas pašreizējā laidienā
Kopš iepriekšējā laidiena tika pievienotas problēmas ar treknrakstu. Ja esat palaidis garām laidienu, ir pieejamas jaunākās piezīmes par laidienuhttps://www.silabs.com/developers/simplicity-software-development-kit.

Novecojuši vienumi
“Multiprotocol Container”, kas pašlaik ir pieejams vietnē DockerHub (siliconlabsinc/multiprotocol), tiks pārtraukts nākamajā laidienā. Konteiners vairs netiks atjaunināts, un to varēs izvilkt no DockerHub. Debian bāzes pakotnes cpcd, ZigBee un ot-br-posix kopā ar sākotnēji ģenerētiem un apkopotiem projektiem aizstās funkcionalitāti, kas zaudēta, noņemot konteineru.

Šī laidiena izmantošana

Šajā laidienā ir:

Zigbee kaudze
Zigbee lietojumprogrammu sistēma
Zigbī Sample Lietojumprogrammas

Papildinformāciju par Zigbee un EmberZNet SDK skatiet UG103.02: Zigbee Fundamentals. Ja lietojat pirmo reizi, skatiet sadaļu QSG180: Zigbee EmberZNet ātrās palaišanas rokasgrāmata SDK 7.0 un jaunākām versijām, lai iegūtu norādījumus par izstrādes vides konfigurēšanu, veidošanu un mirgošanu kāamplietojumprogrammu un dokumentācijas atsauces, kas norāda uz turpmākajām darbībām.

Uzstādīšana un lietošana
Zigbee EmberZNet SDK tiek nodrošināts kā daļa no Simplicity SDK, Silicon Labs SDK komplekta. Lai ātri sāktu darbu ar Simplicity SDK, instalējiet Simplicity Studio 5, kas iestatīs jūsu izstrādes vidi un iepazīstinās jūs ar Simplicity SDK instalēšanu. Simplicity Studio 5 ietver visu nepieciešamo IoT produktu izstrādei ar Silicon Labs ierīcēm, tostarp resursu un projektu palaidēju, programmatūras konfigurācijas rīkus, pilnu IDE ar GNU rīkķēdi un analīzes rīkus. Instalēšanas norādījumi ir sniegti tiešsaistes Simplicity Studio 5 lietotāja rokasgrāmatā. Alternatīvi, Simplicity SDK var instalēt manuāli, lejupielādējot vai klonējot jaunāko no GitHub. Skat https://github.com/SiliconLabs/simplicity_sdk lai iegūtu vairāk informācijas. Simplicity Studio pēc noklusējuma instalē Simplicity SDK:

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

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

SDK versijai raksturīgā dokumentācija ir instalēta kopā ar SDK. Papildu informāciju bieži var atrast zināšanu bāzes rakstos (KBA). API atsauces un cita informācija par šo un iepriekšējām versijām ir pieejamas https://docs.silabs.com/.

Drošības informācija
Droša Vault integrācija
Lietojumprogrammām, kuras izvēlas droši glabāt atslēgas, izmantojot Secure Vault-High daļās esošo komponentu Secure Key Storage, šajā tabulā ir parādītas aizsargātās atslēgas un to krātuves aizsardzības raksturlielumi, ko pārvalda Zigbee Security Manager komponents.Iesaiņotās atslēgas, kas ir atzīmētas kā “Neeksportējamas”, var izmantot, bet nevar viewrediģēts vai kopīgots izpildlaikā. Iesaiņotās atslēgas, kas ir atzīmētas kā “Eksportējamas”, var izmantot vai koplietot izpildlaikā, taču tās paliek šifrētas, kamēr tās tiek glabātas programmā Flash. Lietotāju lietojumprogrammām nekad nav jāsadarbojas ar lielāko daļu šo taustiņu. Esošās API, lai pārvaldītu saites atslēgu tabulas atslēgas vai īslaicīgās atslēgas, joprojām ir pieejamas lietotāja lietojumprogrammai, un tās tiek maršrutētas, izmantojot Zigbee Security Manager komponentu.

Drošības konsultācijas
Lai abonētu drošības ieteikumus, piesakieties Silicon Labs klientu portālā un pēc tam atlasiet konta sākumlapa. Noklikšķiniet uz SĀKUMS, lai atvērtu portāla sākumlapu, un pēc tam noklikšķiniet uz elementa Pārvaldīt paziņojumus. Pārliecinieties, vai ir atzīmēta izvēles rūtiņa “Programmatūras/drošības ieteikuma paziņojumi un paziņojumi par produktu izmaiņām (PCN)” un ka esat abonējis vismaz savu platformu un protokolu. Noklikšķiniet uz Saglabāt, lai saglabātu izmaiņas.

Atbalsts
Development Kit klienti ir tiesīgi saņemt apmācību un tehnisko atbalstu. Izmantojiet Silicon Laboratories Zigbee web lapu, lai iegūtu informāciju par visiem Silicon Labs Zigbee produktiem un pakalpojumiem un reģistrētos produktu atbalstam. Varat sazināties ar Silicon Laboratories atbalstu pa e-pastu http://www.silabs.com/support.

Zigbee sertifikācija
Ember ZNet 8.1 laidiens ir kvalificēts Zigbee saderīgajai platformai SoC, NC, P un RCP arhitektūrām, un šim laidienam ir piesaistīts ZCP sertifikācijas ID. Lūdzu, pārbaudiet CSA webvietne šeit:
https://csa-iot.org/csa-iot_products/.

Lūdzu, ņemiet vērā, ka ZCP sertifikācija ir filed publicējiet laidienu, un paiet dažas nedēļas, pirms tas tiek atspoguļots CSA webvietne. Ja jums rodas papildu jautājumi, lūdzu, sazinieties ar Silicon Laboratories atbalsta dienestu pa e-pastu http://www.silabs.com/support.

FAQ

J: Kā atjaunināt APS saites atslēgas tabulas lielumu SDK?
A: APS saites atslēgas tabulas izmēru var konfigurēt, izmantojot parametru SL_ZIGBEE_KEY_TABLE_SIZE. Versijā 8.1 tas ir paplašināts no 127 līdz 254 ierakstiem.

J: Kādi ir uzlabojumi versijā 8.1?
A: Versijā 8.1 ir iekļauti uzlabojumi, piemēram, APS saites atslēgas tabulas lieluma palielināšana, komponentu pārdēvēšana, mutex aizsardzības pievienošana Athe pp Framework notikumu rindai un citi. Detalizētu uzlabojumu sarakstu skatiet izlaiduma piezīmēs.

J: Kā risināt SDK fiksētās problēmas?
A: Novērstas problēmas SDK, tostarp potenciālo problēmu atrisināšana ar blakus tabulas lieluma konfigurāciju, komponentu pārdēvēšana, avota maršruta pieskaitāmo izmaksu labošana, ZCL komandu apstrāde un daudz kas cits. Noteikti atjauniniet uz jaunāko versiju, lai gūtu labumu no šiem labojumiem.

Dokumenti / Resursi

SILICON LABS Zigbee EmberZ Net SDK [pdfNorādījumi
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Atsauces

Lietotāja rokasgrāmata

SILICON LABS Zigbee EmberZ Net SDK

Specifikācijas

Informācija par produktu