SILICON LABS Zigbee EmberZ Net SDK Instruktioner

Silicon Labs är leverantören av valet för OEM-tillverkare som utvecklar Zigbee-nätverk i sina produkter. Silicon Labs Zigbee-plattformen är den mest integrerade, kompletta och funktionsrika Zigbee-lösningen som finns. Silicon Labs EmberZNet SDK innehåller Silicon Labs implementering av Zigbee-stackspecifikationen.

NYCKELFUNKTIONER

Zigbee

-250+ poster i APS-länknyckeltabellen
ZigbeeD-stöd på Android 12 (v21.0.6113669) och Tizen (v0.1-13.1)

xG26 Modulstöd

Multi

Stöd för ZigbeeD och OTBR på OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT med samtidig lyssning på MG26 för SoC – GA

802.15.4 Unified radio scheduler priority komponent
Debianpaketeringsstöd för MP-värdapplikationer – Alpha

Nya föremål

Viktiga ändringar
APS-länknyckeltabellstorleken (konfigurerad med SL_ZIGBEE_KEY_TABLE_SIZE) utökas från 127 till 254 poster.

R23-stöd läggs till för ZDD Network idrifttagningsfunktioner. Tunnelfunktion är tillgänglig utan stöd för Legacy Network-användningsfall.

Komponenterna Network Steering och Network Creator har uppdaterats för att inkludera stöd för R23-anslutning. Dessa inkluderar följande relaterade ändringar.
- Standardbegäran för Trust Center Link Key (TCLK) har uppdaterats för att generera nya nycklar för varje begärande enhet. En ny nyckel genereras varje gång de begärande enheterna försöker uppdatera sin Trust Center Link Key.
- På grund av den tidigare TCLK-policyändringen kräver Network Creator Security-komponenten nu komponenten Security Link Keys. Uppgradering av applikationer kommer att uppdateras för att överensstämma med detta nya krav.
- En ny konfiguration,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY läggs till för att tillåta koppling med en hashad kärnnyckel. Denna konfiguration finns under Network Creator Security-komponenten. Användning av denna policy gör att varje ansluten enhet kan ta emot en unik TCLK efter anslutning, men upprepade försök att uppdatera TCLK kommer inte att resultera i en ny nyckel för den begärande enheten. Denna användning av hashade länknycklar var standardpolicyn före den här utgåvan, och användningen av denna policy gör att Trust Center undviker att ta in komponenten Security Link Keys, som sparar nycklar i Flash.
  Notera: Silicon Labs rekommenderar inte användningen av denna policy, eftersom detta förhindrar att ansluta enheter från att rulla eller uppdatera deras TCLK.

En ny konfigurationsuppsättning läggs till i komponenten zigbee_ezsp_spi för att möjliggöra konfigurationen av värd-SPI-enheten och dess stiftgränssnitt.
Exampprojekt, inklusive projektet files (.slcps) och projektmappen, döps om till Silicon Labs namngivningsriktlinjer och flyttas till katalogen "projekt".

Ny plattformssupport

Nya moduler
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nya radiotavlor
- MGM260P-RB4350A
- MGM260P-RB4351A
Ny del
- efr32xg27
Explorer Kit
- BRD2709A
- MGM260P-EK2713A

Ny dokumentation
En ny EZSP användarguide UG600 för versioner 8.1 och högre.

Förbättringar

SL_ZIGBEE_KEY_TABLE_SIZE gränser utökade upp till 254 poster.
Lade till zigbee_security_link_keys till Z3Light.
Lade till zigbee_security_link_keys till zigbee_mp_z3_tc_z3_tc. Uppdaterade dess nyckeltabellstorlek också.
Ökade Z3 Gateway-nyckeltabellstorleken (som kommer att ställas in på ncp) till 20.

Fixade problem

Kända problem i den aktuella versionen

Nummer i fetstil har lagts till sedan den tidigare utgåvan. Om du har missat en release finns de senaste releasenoteserna tillgängliga på https://www.silabs.com/developers/zigbee-emberznet på fliken Tekniska dokument.

Utfasade artiklar

Komponenten zigbee_watchdog_periodic_refresh används inte längre i Zigbee-applikationsramverket och är utfasad i den här versionen. Watchdog-timern är inaktiverad som standard för alla sample applikationer. Det kommer att läggas till en förbättrad watchdog-komponent till SDK i framtiden.
Notera: Aktivera watchdog-timern med konfigurationsobjektet SL_LEGACY_HAL_DISABLE_WATCHDOG inställt på 0 i din applikation

Nätverksbegränsningar och överväganden

Standardtillämpningarna för Trust Center som levereras med denna EmberZNet-version kan stödja flera enheter i nätverket. Detta antal bestäms baserat på flera faktorer, inklusive konfigurerade tabellstorlekar, NVM-användning och andra genereringstids- och körtidsvärden. Användare som vill skapa stora nätverk kan möta resursproblem när de växer nätverket större än vad applikationen kan stödja. Till exempelample, en enhet som begär en Trust Center Link Key från Trust Center kan utlösa ett sl_zigbee_af_zigbee_key_establishment_cb callback på Trust Center med h status inställd på SL_ZIGBEE_KEY_TABLE_FULL, vilket indikerar att nyckeltabellen inte har utrymme att lägga till en ny nyckel för den begärande enheten eller att NVM3 har inget tillgängligt utrymme. Silicon Labs ger följande rekommendationer för användare som vill skapa stora nätverk. För Trust Center-applikationer rekommenderas följande konfigurationer. Dessa rekommendationer är inte uttömmande, och de fungerar som en baslinje för applikationer som avser att växa stora nätverk.

Inkludering av adresstabellkomponenten (zigbee_address_table), med
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE konfigurationsobjektet inställt på storleken på det önskade nätverket
- värdet SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE satt till det maximala (4)

Inkludering av säkerhetslänknycklar-komponenten (zigbee_security_link_keys), med
- Värdet SL_ZIGBEE_KEY_TABLE_SIZE är inställt på storleken på nätverket
Följande konfigurationsobjekt är inställda på storleken på det önskade nätverket
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, som finns i Zigbee Pro Stack-komponenten
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, som finns i källdirigeringskomponenten, om källdirigering används
Justering av NVM3_DEFAULT_NVM_SIZE och NVM3_DEFAULT_CACHE_SIZE enligt NVM3-användning
- Nätverksstorlekar större än 65 noder kräver sannolikt en NVM3-storlek på 64K. Standard NVM3-storlek i Silicon Labs Zigbee sample applikationer är 32K. Applikationer som använder NVM mer kan behöva justera detta värde ännu högre.
- Stora nätverk upp till 65 noder kan behöva en NVM3-cachestorlek på 1200 byte; växande nätverk större än så kan kräva att detta värde fördubblas till 2400 byte.

Dessa justeringar gäller endast Trust Center

Multiprotocol Gateway och RCP

Nya föremål
Aktiverat GA SoC-stöd för BLE DMP med Zigbee + Openthread CMP med samtidig lyssning på xG26-delar. Debians alfastöd har lagts till för Zigbeed-, OTBR- och Z3Gateway-applikationer. Zigbeed och OTBR tillhandahålls också i DEB-paketformat för den valda referensplattformen (Raspberry PI 4). Se Köra Zigbee, OpenThread och Bluetooth samtidigt på en Linux-värd med en Multiprotocol Co-processor, som finns på docs.silabs.com, för detaljer. Lade till Zigbeed-stöd för Tizen-0.1-13.1 för arm32 och aarch64 samt Android 12 för aarch64. Mer information om Zigbeed finns på docs.silabs.com. Lade till den nya "802.15.4 Unified radio scheduler priority"-komponenten. Denna komponent används för att konfigurera radioprioriteterna för en 15.4 stack. Komponenten kräver också den nya komponenten "radio_priority_configurator". Den här komponenten tillåter projekt att använda verktyget Radio Priority Configurator i Simplicity Studio för att konfigurera radioprioritetsnivåerna för de stackar som kräver det.

Förbättringar
Applikationsnotering Att köra Zigbee, OpenThread och Bluetooth samtidigt på en Linux-värd med en Multiprotocol Co-Processor (AN1333) har flyttats till docs.silabs.com. OpenWRT-stöd är nu GA-kvalitet. OpenWRT-stöd har lagts till för Zigbee-, OTBR- och Z3Gateway-applikationer. Zigbeed och OTBR tillhandahålls också i IPK-paketformat för referensplattformen (Raspberry PI 4). Se Köra Zigbee, OpenThread och Bluetooth samtidigt på en Linux-värd med en Multiprotocol Co-processor, som finns på docs.silabs.com, för detaljer.

Fixade problem

Kända problem i den aktuella versionen
Nummer i fetstil har lagts till sedan den tidigare utgåvan. Om du har missat en utgåva finns de senaste utgåvorna tillgängliga oathttps://www.silabs.com/developers/simplicity-software-development-kit.

Utfasade artiklar
"Multiprotocol Container" som för närvarande är tillgänglig på DockerHub (siliconlabsinc/multiprotocol) kommer att fasas ut i en kommande release. Behållaren kommer inte längre att uppdateras och kan hämtas från DockerHub. De Debian-baserade paketen för cpcd, ZigBee och ot-br-posix, tillsammans med inbyggt genererade och kompilerade projekt, kommer att ersätta den funktionalitet som gick förlorad när behållaren togs bort.

Använder denna version

Den här utgåvan innehåller följande:

Zigbee stack
Zigbee Application Framework
Zigbee Sample Applikationer

För mer information om Zigbee och EmberZNet SDK se UG103.02: Zigbee Fundamentals. Om du är en förstagångsanvändare, se QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 and Higher, för instruktioner om hur du konfigurerar din utvecklingsmiljö, bygger och flashar somampapplikationen och dokumentationsreferenser som pekar på de förlängda stegen.

Installation och användning
Zigbee EmberZNet SDK tillhandahålls som en del av Simplicity SDK, sviten av Silicon Labs SDK:er. För att snabbt komma igång med Simplicity SDK, installera Simplicity Studio 5, som kommer att ställa in din utvecklingsmiljö och vägleda dig genom Simplicity SDK-installationen. Simplicity Studio 5 innehåller allt som behövs för IoT-produktutveckling med Silicon Labs-enheter, inklusive en resurs- och projektstartare, mjukvarukonfigurationsverktyg, fullständig IDE med GNU-verktygskedja och analysverktyg. Installationsinstruktioner finns i Simplicity Studio 5 användarhandbok online. Alternativt kan Simplicity SDK installeras manuellt genom att ladda ner eller klona det senaste från GitHub. Se https://github.com/SiliconLabs/simplicity_sdk för mer information. Simplicity Studio installerar Simplicity SDK som standard i:

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

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

Dokumentation som är specifik för SDK-versionen installeras med SDK. Ytterligare information finns ofta i kunskapsbasartiklarna (KBA). API-referenser och annan information om denna och tidigare utgåvor finns tillgängligt https://docs.silabs.com/.

Säkerhetsinformation
Säker Vault-integration
För program som väljer att lagra nycklar säkert med komponenten Secure Key Storage på Secure Vault-High-delar visar följande tabell de skyddade nycklarna och deras lagringsskyddsegenskaper som Zigbee Security Manager-komponenten hanterar.Inslagna nycklar som är markerade som "Icke-exporterbara" kan användas men kan inte vara det viewed eller delas under körning. Inslagna nycklar som är markerade som "Exporterbara" kan användas eller delas under körning men förblir krypterade medan de lagras i Flash. Användarapplikationer behöver aldrig interagera med majoriteten av dessa nycklar. Befintliga API:er för att hantera Link Key Table-nycklar eller Transient Keys är fortfarande tillgängliga för användarapplikationen och dirigeras nära nog genom Zigbee Security Manager-komponenten.

Säkerhetsrådgivning
För att prenumerera på Security Advisories, logga in på Silicon Labs kundportal och välj sedan Kontohem. Klicka på HEM för att gå till portalens hemsida och klicka sedan på panelen Hantera aviseringar. Se till att "Meddelanden om programvara/säkerhet och meddelanden om produktändringar (PCN)" är markerad och att du som minimum är prenumererad på din plattform och ditt protokoll. Klicka på Spara för att spara eventuella ändringar.

Stöd
Development Kit-kunder är berättigade till utbildning och teknisk support. Använd Silicon Laboratories Zigbee web sida för att få information om alla Silicon Labs Zigbee produkter och tjänster och för att registrera dig för produktsupport. Du kan kontakta Silicon Laboratories support på http://www.silabs.com/support.

Zigbee-certifiering
Ember ZNet 8.1-utgåvan har kvalificerats för Zigbee-kompatibel plattform för SoC-, NC-, P- och RCP-arkitekturer. Det finns ett ZCP-certifierings-ID kopplat till den här utgåvan, vänligen kontrollera CSA websida här:
https://csa-iot.org/csa-iot_products/.

Observera att ZCP-certifieringen är filed posta releasen, och det tar några veckor innan man reflekterar över CSA webplats. För ytterligare frågor, kontakta Silicon Laboratories support på http://www.silabs.com/support.

Vanliga frågor

F: Hur uppdaterar jag storleken på APS-länknyckeltabellen i SDK?
S: APS-länknyckeltabellens storlek kan konfigureras med parametern SL_ZIGBEE_KEY_TABLE_SIZE. I version 8.1 har den utökats från 127 till 254 poster.

F: Vilka är förbättringarna i version 8.1?
S: Version 8.1 ger förbättringar som att utöka storleken på APS-länknyckeltabellen, byta namn på komponenter, lägga till mutex-skydd för Athe pp Framework-händelsekön och mer. Se versionsinformationen för en detaljerad lista över förbättringar.

F: Hur hanterar jag fixade problem i SDK:n?
S: Fixade problem i SDK inklusive att lösa potentiella problem med granntabellstorlekskonfiguration, byta namn på komponenter, fixa källruttoverhead, hantera ZCL-kommandon och mer. Se till att du uppdaterar till den senaste versionen för att dra nytta av dessa korrigeringar.

Dokument/resurser

SILICON LABS Zigbee EmberZ Net SDK [pdfInstruktioner
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Referenser

Användarmanual

SILICON LABS Zigbee EmberZ Net SDK

Specifikationer

Produktinformation