SILICON LABS Zigbee EmberZ Net SDK Instruksies

Silicon Labs is die voorkeurverskaffer vir OEM's wat Zigbee-netwerke in hul produkte ontwikkel. Die Silicon Labs Zigbee-platform is die mees geïntegreerde, volledige en kenmerkryke Zigbee-oplossing wat beskikbaar is. Die Silicon Labs EmberZNet SDK bevat Silicon Labs se implementering van die Zigbee-stapel-spesifikasie.

SLEUTELKENMERKE

Zigbee

-250+ inskrywings in die APS-skakelsleuteltabel
ZigbeeD-ondersteuning op Android 12 (v21.0.6113669) en Tizen (v0.1-13.1)

xG26 Module ondersteuning

Multiprotokol

ZigbeeD- en OTBR-ondersteuning op OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT met gelyktydige luister op MG26 vir SoC – GA

802.15.4 Unified radio skeduleerder prioriteit komponent
Debian-verpakkingsondersteuning vir MP-gasheertoepassings – Alpha

Nuwe items

Belangrike veranderinge
Die grootte van die APS-skakelsleuteltabel (gekonfigureer deur SL_ZIGBEE_KEY_TABLE_SIZE) word van 127 na 254 inskrywings uitgebrei.

R23-ondersteuning word bygevoeg vir ZDD Network-ingebruiknemingsfunksionaliteit. Tonnelfunksionaliteit is beskikbaar sonder ondersteuning vir Legacy Network-gebruiksgevalle.

Die Network Steering- en Network Creator-komponente is opgedateer om ondersteuning vir R23-aansluiting in te sluit. Dit sluit die volgende verwante veranderinge in.
- Die verstek Trust Centre Link Key (TCLK) versoekbeleid is opgedateer om nuwe sleutels vir elke versoekende toestel te genereer. 'n Nuwe sleutel word gegenereer elke keer as die versoekende toestelle probeer om hul Trustsentrum-skakelsleutel op te dateer.
- As gevolg van die vorige TCLK-beleidsverandering, vereis die Network Creator Security-komponent nou die Security Link Keys-komponent. Opgradering van toepassings sal opgedateer word om aan hierdie nuwe vereiste te voldoen.
- 'n Nuwe konfigurasie,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY is bygevoeg om aansluiting moontlik te maak met behulp van 'n kern-gehakte sleutel. Hierdie konfigurasie word gevind onder die Network Creator Security-komponent. Die gebruik van hierdie beleid laat elke aansluitingstoestel toe om 'n unieke TCLK na-aansluiting te ontvang, maar herhaalde pogings om die TCLK op te dateer sal nie 'n nuwe sleutel vir die versoekende toestel tot gevolg hê nie. Hierdie gebruik van gehashte skakelsleutels was die verstekbeleid voor hierdie vrystelling, en die gebruik van hierdie beleid laat die Trustsentrum toe om te verhoed dat die Sekuriteitskakelsleutels-komponent ingebring word, wat sleutels in Flash stoor.
  Let wel: Silicon Labs beveel nie die gebruik van hierdie beleid aan nie, aangesien dit verhoed dat aansluittoestelle rol, of hul TCLK's opdateer.

'n Nuwe konfigurasiestel word by die komponent zigbee_ezsp_spi gevoeg om die konfigurasie van die gasheer-SPI-toestel en sy pen-koppelvlakke toe te laat.
Die eksample projekte, insluitend die projek files (.slcps) en projeklêer, word hernoem na Silicon Labs-benoemingsriglyne en onder die "projekte"-gids geskuif.

Nuwe Platform Ondersteuning

Nuwe modules
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nuwe radioborde
- MGM260P-RB4350A
- MGM260P-RB4351A
Nuwe deel
- efr32xg27
Explorer Kit
- BRD2709A
- MGM260P-EK2713A

Nuwe dokumentasie
'n Nuwe EZSP-gebruikersgids UG600 vir vrystellings 8.1 en hoër.

Verbeterings

SL_ZIGBEE_KEY_TABLE_SIZE limiete uitgebrei tot 254 inskrywings.
Het zigbee_security_link_keys by Z3Light gevoeg.
Het zigbee_security_link_keys by zigbee_mp_z3_tc_z3_tc gevoeg. Sy sleuteltabelgrootte is ook opgedateer.
Het die Z3 Gateway-sleuteltabelgrootte (wat op ncp gestel sal wees) tot 20 verhoog.

Vaste kwessies

Bekende kwessies in die huidige vrystelling

Kwessies in vetdruk is bygevoeg sedert die vorige uitgawe. As jy 'n vrystelling gemis het, is onlangse vrystellingnotas beskikbaar by https://www.silabs.com/developers/zigbee-emberznet in die Tegniese Dokumente-oortjie.

Verouderde items

Die zigbee_watchdog_periodic_refresh-komponent word nie meer in die Zigbee-toepassingsraamwerk gebruik nie en word in hierdie vrystelling opgeskort. Die waghondtydteller is by verstek gedeaktiveer vir al die sample toepassings. Daar sal in die toekoms 'n verbeterde waghond-komponent by die SDK gevoeg word.
Let wel: Aktiveer die waghondtydteller met konfigurasie-item SL_LEGACY_HAL_DISABLE_WATCHDOG gestel op 0 in jou toepassing

Netwerkbeperkings en -oorwegings

Die verstek Trustsentrum-toepassings wat saam met hierdie EmberZNet-vrystelling verskeep word, is in staat om verskeie toestelle op die netwerk te ondersteun. Hierdie getal word bepaal op grond van verskeie faktore, insluitend gekonfigureerde tabelgroottes, NVM-gebruik en ander generasietyd- en looptydwaardes. Gebruikers wat groot netwerke wil skep, kan hulpbronkwessies ondervind wanneer hulle die netwerk groter maak as wat die toepassing kan ondersteun. Byvoorbeeldample, 'n toestel wat 'n Trustsentrum-skakelsleutel van die Trustsentrum versoek, kan 'n sl_zigbee_af_zigbee_key_establishment_cb-terugbeloping op die Trustsentrum aktiveer met h-status gestel op SL_ZIGBEE_KEY_TABLE_FULL, wat aandui dat die sleuteltabel nie ruimte het om 'n nuwe sleutel vir die versoekende toestel by te voeg nie of dat NVM3 het geen beskikbare spasie nie. Silicon Labs verskaf die volgende aanbevelings vir gebruikers wat groot netwerke wil skep. Vir Trustsentrum-toepassings word die volgende konfigurasies aanbeveel. Hierdie aanbevelings is nie volledig nie, en dit dien as 'n basislyn vir toepassings wat van plan is om groot netwerke te laat groei.

Insluiting van die Adrestabel-komponent (zigbee_address_table), met
- die SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE konfigurasie-item gestel op die grootte van die verlangde netwerk
- die SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE waarde op die maksimum gestel (4)

Insluiting van die Sekuriteitskakelsleutels-komponent (zigbee_security_link_keys), met
- Die SL_ZIGBEE_KEY_TABLE_SIZE waarde is gestel op die grootte van die netwerk
Die volgende konfigurasie-items is ingestel op die grootte van die verlangde netwerk
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, soos gevind in die Zigbee Pro Stack-komponent
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, soos gevind in die Bron-roetering-komponent, as bronroetering gebruik word
Verstelling van NVM3_DEFAULT_NVM_SIZE en NVM3_DEFAULT_CACHE_SIZE volgens NVM3-gebruik
- Netwerkgroottes groter as 65 nodusse vereis waarskynlik 'n NVM3-grootte van 64K. Die verstek NVM3-grootte in Silicon Labs Zigbee sample aansoeke is 32K. Toepassings wat NVM meer gebruik, kan vereis dat hierdie waarde selfs hoër aangepas word.
- Groot netwerke tot 65 nodusse mag 'n NVM3-kasgrootte van 1200 grepe benodig; groeiende netwerke groter as dit kan vereis dat hierdie waarde verdubbel tot 2400 grepe.

Hierdie aanpassings is slegs van toepassing op die Trustsentrum

Multiprotokol Gateway en RCP

Nuwe items
Geaktiveerde GA SoC-ondersteuning vir BLE DMP met Zigbee + Openthread CMP met gelyktydige luister op xG26-dele. Debian alfa-ondersteuning is bygevoeg vir Zigbeed-, OTBR- en Z3Gateway-toepassings. Zigbeed en OTBR word ook in DEB-pakketformaat vir die gekose verwysingsplatform (Raspberry PI 4) verskaf. Sien die loop van Zigbee, OpenThread en Bluetooth gelyktydig op 'n Linux-gasheer met 'n multiprotokol-medeverwerker, gevind by docs.silabs.com, vir besonderhede. Bygevoeg Zigbeed-ondersteuning vir Tizen-0.1-13.1 vir arm32 en aarch64 sowel as Android 12 vir aarch64. Meer inligting oor Zigbeed kan gevind word by docs.silabs.com. Bygevoeg die nuwe "802.15.4 Unified radio skeduleerder prioriteit" komponent. Hierdie komponent word gebruik om die radioprioriteite van 'n 15.4-stapel op te stel. Die komponent vereis ook die nuwe "radio_priority_configurator" komponent. Hierdie komponent laat projekte toe om die Radio Priority Configurator-nutsding in Simplicity Studio te gebruik om die radioprioriteitsvlakke van die stapels wat dit vereis, op te stel.

Verbeterings
Toepassingsnota Om Zigbee, OpenThread en Bluetooth gelyktydig op 'n Linux-gasheer met 'n multiprotokol-ko-verwerker (AN1333) te laat loop, is geskuif na docs.silabs.com. OpenWRT-ondersteuning is nou GA-gehalte. OpenWRT-ondersteuning is bygevoeg vir Zigbee-, OTBR- en Z3Gateway-toepassings. Zigbeed en OTBR word ook in IPK-pakketformaat vir die verwysingsplatform (Raspberry PI 4) verskaf. Sien die loop van Zigbee, OpenThread en Bluetooth gelyktydig op 'n Linux-gasheer met 'n multiprotokol-medeverwerker, gevind by docs.silabs.com, vir besonderhede.

Vaste kwessies

Bekende kwessies in die huidige vrystelling
Kwessies in vetdruk is bygevoeg sedert die vorige uitgawe. As jy 'n vrystelling gemis het, is onlangse vrystellingnotas beskikbaarhttps://www.silabs.com/developers/simplicity-software-development-kit.

Verouderde items
Die "Multiprotocol Container" wat tans beskikbaar is op DockerHub (siliconlabsinc/multiprotocol) sal in 'n komende vrystelling opgeskort word. Die houer sal nie meer opgedateer word nie en kan van DockerHub af getrek word. Die Debian-gebaseerde pakkette vir cpcd, ZigBee en ot-br-posix, tesame met inheemse gegenereerde en saamgestelde projekte, sal die funksionaliteit wat verlore gaan met die verwydering van die houer vervang.

Gebruik hierdie vrystelling

Hierdie vrystelling bevat die volgende:

Zigbee stapel
Zigbee-toepassingsraamwerk
Zigbee Sample Aansoeke

Vir meer inligting oor Zigbee en die EmberZNet SDK sien UG103.02: Zigbee Fundamentals. As jy 'n eerstekeergebruiker is, sien QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 and Higher, vir instruksies oor die opstel van jou ontwikkelingsomgewing, bou en flits asample aansoek, en dokumentasieverwysings wat na die volgende stappe verwys.

Installasie en gebruik
Die Zigbee EmberZNet SDK word verskaf as deel van die Simplicity SDK, die reeks Silicon Labs SDK's. Om vinnig met die Simplicity SDK te begin, installeer Simplicity Studio 5, wat jou ontwikkelingsomgewing sal opstel en jou deur Simplicity SDK-installasie sal lei. Simplicity Studio 5 bevat alles wat nodig is vir IoT-produkontwikkeling met Silicon Labs-toestelle, insluitend 'n hulpbron- en projeklanseerder, sagteware-konfigurasie-instrumente, volledige IDE met GNU-gereedskapketting en analise-instrumente. Installasie-instruksies word in die aanlyn Simplicity Studio 5-gebruikersgids verskaf. Alternatiewelik kan Simplicity SDK met die hand geïnstalleer word deur die nuutste vanaf GitHub af te laai of te kloneer. Sien https://github.com/SiliconLabs/simplicity_sdk vir meer inligting. Simplicity Studio installeer die Simplicity SDK by verstek in:

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

(MacOS): /Users//SimplicityStudio/SDK's/simplicity_sdk

Dokumentasie spesifiek vir die SDK-weergawe word saam met die SDK geïnstalleer. Bykomende inligting kan dikwels in die kennisbasisartikels (KBA's) gevind word. API-verwysings en ander inligting oor hierdie en vroeëre vrystellings is beskikbaar by https://docs.silabs.com/.

Sekuriteitsinligting
Veilige Vault-integrasie
Vir toepassings wat kies om sleutels veilig te stoor deur die Secure Sleutelberging-komponent op Secure Vault-High-onderdele te gebruik, toon die volgende tabel die beskermde sleutels en hul bergingbeskermingseienskappe wat die Zigbee Security Manager-komponent bestuur.Toegedraaide sleutels wat as "Nie-uitvoerbaar" gemerk is, kan gebruik word, maar kan nie viewed of gedeel tydens looptyd. Toegedraaide sleutels wat as "Uitvoerbaar" gemerk is, kan tydens looptyd gebruik of gedeel word, maar bly geïnkripteer terwyl dit in Flash gestoor word. Gebruikerstoepassings hoef nooit met die meerderheid van hierdie sleutels te kommunikeer nie. Bestaande API's om skakelsleuteltabelsleutels of verbygaande sleutels te bestuur is steeds beskikbaar vir die gebruikertoepassing en word amper deur die Zigbee-sekuriteitsbestuurder-komponent geroer.

Sekuriteitsadvies
Om in te teken op Security Advisories, meld aan by die Silicon Labs-kliënteportaal en kies dan Account Home. Klik TUIS om na die portaaltuisblad te gaan en klik dan op die Bestuur kennisgewings-teël. Maak seker dat 'Sagteware/Sekuriteitsadvieskennisgewings en produkveranderingskennisgewings (PCN's)' gemerk is, en dat jy ten minste ingeteken is vir jou platform en protokol. Klik Stoor om enige veranderinge te stoor.

Ondersteuning
Development Kit-kliënte kom in aanmerking vir opleiding en tegniese ondersteuning. Gebruik die Silicon Laboratories Zigbee web bladsy om inligting oor alle Silicon Labs Zigbee-produkte en -dienste te bekom, en om aan te meld vir produkondersteuning. U kan Silicon Laboratories-ondersteuning kontak by http://www.silabs.com/support.

Zigbee-sertifisering
Die Ember ZNet 8.1-vrystelling is gekwalifiseer vir Zigbee-voldoende platform vir SoC-, NC-, P- en RCP-argitekture; daar is 'n ZCP-sertifiserings-ID gekoppel aan hierdie vrystelling, kyk asseblief na die CSA webwebwerf hier:
https://csa-iot.org/csa-iot_products/.

Neem asseblief kennis dat die ZCP-sertifisering is filed plaas die vrystelling, en neem 'n paar weke voordat dit oor die CSA besin word webwebwerf. Vir enige verdere navrae, kontak asseblief Silicon Laboratories ondersteuning by http://www.silabs.com/support.

Gereelde vrae

V: Hoe werk ek die grootte van die APS-skakelsleuteltabel in die SDK op?
A: Die grootte van die APS-skakelsleuteltabel kan gekonfigureer word deur die SL_ZIGBEE_KEY_TABLE_SIZE-parameter te gebruik. In weergawe 8.1 is dit van 127 na 254 inskrywings uitgebrei.

V: Wat is die verbeterings in weergawe 8.1?
A: Weergawe 8.1 bring verbeterings soos die uitbreiding van die APS-skakelsleuteltabelgrootte, die hernoem van komponente, die byvoeging van mutex-beskerming vir Athe pp Framework-gebeurteniswaglys, en meer. Verwys na die vrystellingnotas vir 'n gedetailleerde lys van verbeterings.

V: Hoe hanteer ek vaste kwessies in die SDK?
A: Vaste kwessies in die SDK insluitend die oplossing van potensiële probleme met buurtabelgrootte-konfigurasie, hernoeming van komponente, regstelling van bronroete-bokoste, hantering van ZCL-opdragte, en meer. Maak seker dat jy opdateer na die nuutste weergawe om voordeel te trek uit hierdie regstellings.

Dokumente / Hulpbronne

SILICON LABS Zigbee EmberZ Net SDK [pdf] Instruksies
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Verwysings

Gebruikershandleiding

SILICON LABS Zigbee EmberZ Net SDK

Spesifikasies

Produk inligting