SILICON LABS Zigbee EmberZ Net SDK-instructies

Silicon Labs is de leverancier bij uitstek voor OEM's die Zigbee-netwerken in hun producten ontwikkelen. Het Silicon Labs Zigbee-platform is de meest geïntegreerde, complete en feature-rijke Zigbee-oplossing die beschikbaar is. De Silicon Labs EmberZNet SDK bevat Silicon Labs' implementatie van de Zigbee-stackspecificatie.

BELANGRIJKSTE KENMERKEN

Zigbee

-250+ vermeldingen in de APS-linksleuteltabel
ZigbeeD-ondersteuning op Android 12 (v21.0.6113669) en Tizen (v0.1-13.1)

xG26 Module-ondersteuning

Multiprotocol

ZigbeeD en OTBR-ondersteuning op OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT met gelijktijdig luisteren op MG26 voor SoC – GA

802.15.4 Unified Radio Scheduler-prioriteitscomponent
Debian-pakketondersteuning voor MP-hosttoepassingen – Alfa

Nieuwe artikelen

Belangrijke wijzigingen
De sleuteltabelgrootte van de APS-koppeling (geconfigureerd met SL_ZIGBEE_KEY_TABLE_SIZE) is uitgebreid van 127 naar 254 vermeldingen.

R23-ondersteuning is toegevoegd voor ZDD Network commissioning-functionaliteit. Tunneling-functionaliteit is beschikbaar zonder ondersteuning voor Legacy Network-use cases.

De componenten Network Steering en Network Creator zijn bijgewerkt om ondersteuning voor R23-joining op te nemen. Deze omvatten de volgende gerelateerde wijzigingen.
- Het standaard Trust Center Link Key (TCLK)-aanvraagbeleid is bijgewerkt om nieuwe sleutels te genereren voor elk aanvragend apparaat. Elke keer dat de aanvragende apparaten proberen hun Trust Center Link Key bij te werken, wordt een nieuwe sleutel gegenereerd.
- Vanwege de vorige TCLK-beleidswijziging vereist het Network Creator Security-component nu het Security Link Keys-component. Applicaties die worden geüpgraded, worden bijgewerkt om te voldoen aan deze nieuwe vereiste.
- Een nieuwe configuratie,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY is toegevoegd om deelname met een kern, gehashte sleutel mogelijk te maken. Deze configuratie is te vinden onder het onderdeel Network Creator Security. Door dit beleid te gebruiken, kan elk deelnemend apparaat een unieke TCLK na deelname ontvangen, maar herhaalde pogingen om de TCLK bij te werken, resulteren niet in een nieuwe sleutel voor het aanvragende apparaat. Dit gebruik van gehashte koppelingssleutels was het standaardbeleid vóór deze release en door dit beleid te gebruiken, kan het Trust Center het onderdeel Security Link Keys vermijden, dat sleutels in Flash opslaat.
  Opmerking: Silicon Labs raadt het gebruik van dit beleid af, omdat dit voorkomt dat aangesloten apparaten hun TCLK's kunnen bijwerken of doorvoeren.

Er is een nieuwe configuratieset toegevoegd aan het onderdeel zigbee_ezsp_spi om de configuratie van het host-SPI-apparaat en de bijbehorende pininterfaces mogelijk te maken.
De exampde projecten, waaronder het project files (.slcps) en de projectmap worden hernoemd volgens de naamgevingsrichtlijnen van Silicon Labs en verplaatst naar de map “projecten”.

Nieuwe platformondersteuning

Nieuwe modules
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Nieuwe radioborden
- MGM260P-RB4350A
- MGM260P-RB4351A
Nieuw deel
- efr32xg27
Ontdekkingskit
- BRD2709A
- MGM260P-EK2713A

Nieuwe documentatie
Een nieuwe EZSP-gebruikershandleiding voor UG600 voor releases 8.1 en hoger.

Verbeteringen

De limieten voor SL_ZIGBEE_KEY_TABLE_SIZE zijn uitgebreid tot 254 vermeldingen.
zigbee_security_link_keys toegevoegd aan Z3Light.
zigbee_security_link_keys toegevoegd aan zigbee_mp_z3_tc_z3_tc. Ook de sleuteltabelgrootte is bijgewerkt.
De sleuteltabelgrootte van de Z3 Gateway (die wordt ingesteld op ncp) is verhoogd naar 20.

Opgeloste problemen

Bekende problemen in de huidige release

Vetgedrukte problemen zijn toegevoegd sinds de vorige release. Als u een release hebt gemist, zijn recente release-opmerkingen beschikbaar op https://www.silabs.com/developers/zigbee-emberznet op het tabblad Tech Docs.

Beëindigde artikelen

Het zigbee_watchdog_periodic_refresh-component wordt niet langer gebruikt in het Zigbee-toepassingsframework en is in deze release verouderd. De watchdog-timer is standaard uitgeschakeld voor alle sample-toepassingen. Er zal in de toekomst een verbeterde watchdog-component aan de SDK worden toegevoegd.
Opmerking: Schakel de watchdog-timer in met configuratie-item SL_LEGACY_HAL_DISABLE_WATCHDOG ingesteld op 0 in uw toepassing

Netwerkbeperkingen en overwegingen

De standaard Trust Center-toepassingen die bij deze EmberZNet-release worden geleverd, kunnen meerdere apparaten op het netwerk ondersteunen. Dit aantal wordt bepaald op basis van verschillende factoren, waaronder geconfigureerde tabelgroottes, NVM-gebruik en andere generatietijd- en runtimewaarden. Gebruikers die grote netwerken willen maken, kunnen te maken krijgen met resourceproblemen wanneer het netwerk groter wordt dan de toepassing kan ondersteunen. Bijvoorbeeldample, een apparaat dat een Trust Center Link Key aanvraagt van het Trust Center kan een sl_zigbee_af_zigbee_key_establishment_cb callback activeren op het Trust Center met h status ingesteld op SL_ZIGBEE_KEY_TABLE_FULL, wat aangeeft dat de sleuteltabel geen ruimte heeft om een nieuwe sleutel toe te voegen voor het aanvragende apparaat of dat NVM3 geen beschikbare ruimte heeft. Silicon Labs biedt de volgende aanbevelingen voor gebruikers die grote netwerken willen maken. Voor Trust Center-toepassingen worden de volgende configuraties aanbevolen. Deze aanbevelingen zijn niet uitputtend en dienen als basislijn voor toepassingen die van plan zijn om grote netwerken te laten groeien.

Opname van het Address Table-component (zigbee_address_table), met
- het configuratie-item SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE is ingesteld op de grootte van het gewenste netwerk
- de SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE-waarde is ingesteld op het maximum (4)

Opname van het Security Link Keys-component (zigbee_security_link_keys), met
- De waarde SL_ZIGBEE_KEY_TABLE_SIZE wordt ingesteld op de grootte van het netwerk
De volgende configuratie-items worden ingesteld op de grootte van het gewenste netwerk
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, zoals gevonden in het Zigbee Pro Stack-component
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, zoals gevonden in het bronrouteringscomponent, als bronroutering wordt gebruikt
Aanpassing van NVM3_DEFAULT_NVM_SIZE en NVM3_DEFAULT_CACHE_SIZE volgens NVM3-gebruik
- Bijvoorbeeld, netwerkgroottes groter dan 65 knooppunten vereisen waarschijnlijk een NVM3-grootte van 64K. De standaard NVM3-grootte in Silicon Labs Zigbee sample-toepassingen is 32K. Toepassingen die NVM zwaarder gebruiken, moeten deze waarde mogelijk nog verder aanpassen.
- Grote netwerken met maximaal 65 knooppunten hebben mogelijk een NVM3-cachegrootte van 1200 bytes nodig. Groeiende netwerken die groter zijn, vereisen mogelijk een verdubbeling van deze waarde tot 2400 bytes.

Deze aanpassingen zijn alleen van toepassing op het Trust Center

Multiprotocol-gateway en RCP

Nieuwe artikelen
GA SoC-ondersteuning ingeschakeld voor BLE DMP met Zigbee + Openthread CMP met gelijktijdig luisteren op xG26-onderdelen. Debian alpha-ondersteuning is toegevoegd voor Zigbeed-, OTBR- en Z3Gateway-toepassingen. Zigbeed en OTBR worden ook geleverd in DEB-pakketformaat voor het gekozen referentieplatform (Raspberry PI 4). Zie Zigbee, OpenThread en Bluetooth gelijktijdig uitvoeren op een Linux-host met een multiprotocol-coprocessor, te vinden op docs.silabs.com, voor details. Zigbeed-ondersteuning toegevoegd voor Tizen-0.1-13.1 voor arm32 en aarch64, evenals Android 12 voor aarch64. Meer informatie over Zigbeed is te vinden op docs.silabs.com. Het nieuwe onderdeel "802.15.4 Unified radio scheduler priority" is toegevoegd. Dit onderdeel wordt gebruikt om de radioprioriteiten van een 15.4-stack te configureren. Het onderdeel vereist ook het nieuwe onderdeel "radio_priority_configurator". Met dit onderdeel kunnen projecten de tool Radio Priority Configurator in Simplicity Studio gebruiken om de radioprioriteitsniveaus van de stacks te configureren die dit nodig hebben.

Verbeteringen
Toepassingsnotitie Het gelijktijdig uitvoeren van Zigbee, OpenThread en Bluetooth op een Linux-host met een multiprotocol-coprocessor (AN1333) is verplaatst naar docs.silabs.com. OpenWRT-ondersteuning is nu GA-kwaliteit. OpenWRT-ondersteuning is toegevoegd voor Zigbee-, OTBR- en Z3Gateway-toepassingen. Zigbeed en OTBR worden ook geleverd in IPK-pakketformaat voor het referentieplatform (Raspberry PI 4). Zie Zigbee, OpenThread en Bluetooth gelijktijdig uitvoeren op een Linux-host met een multiprotocol-coprocessor, te vinden op docs.silabs.com, voor details.

Opgeloste problemen

Bekende problemen in de huidige release
Problemen in vet zijn toegevoegd sinds de vorige release. Als u een release hebt gemist, zijn recente release-opmerkingen beschikbaar oathttps://www.silabs.com/developers/simplicity-software-development-kit.

Beëindigde artikelen
De "Multiprotocol Container" die momenteel beschikbaar is op DockerHub (siliconlabsinc/multiprotocol) zal in een aankomende release worden afgeschaft. De container zal niet langer worden bijgewerkt en kan niet meer worden opgehaald van DockerHub. De op Debian gebaseerde pakketten voor cpcd, ZigBee en ot-br-posix, samen met native gegenereerde en gecompileerde projecten, zullen de functionaliteit vervangen die verloren is gegaan door het verwijderen van de container.

Deze versie gebruiken

Deze uitgave bevat het volgende:

Zigbee-stapel
Zigbee-applicatieframework
Zigbee Sample toepassingen

Voor meer informatie over Zigbee en de EmberZNet SDK zie UG103.02: Zigbee Fundamentals. Als u een eerste gebruiker bent, zie dan QSG180: Zigbee EmberZNet Snelstartgids voor SDK 7.0 en hoger, voor instructies over het configureren van uw ontwikkelomgeving, het bouwen en flashen alsample-applicatie en documentatieverwijzingen die naar de ext-stappen verwijzen.

Installatie en gebruik
De Zigbee EmberZNet SDK wordt geleverd als onderdeel van de Simplicity SDK, de suite van Silicon Labs SDK's. Om snel aan de slag te gaan met de Simplicity SDK, installeert u Simplicity Studio 5, dat uw ontwikkelomgeving instelt en u door de installatie van de Simplicity SDK leidt. Simplicity Studio 5 bevat alles wat nodig is voor IoT-productontwikkeling met Silicon Labs-apparaten, inclusief een resource- en projectlauncher, softwareconfiguratietools, volledige IDE met GNU-toolchain en analysetools. Installatie-instructies vindt u in de online Simplicity Studio 5 User's Guide. Simplicity SDK kan ook handmatig worden geïnstalleerd door de nieuwste versie van GitHub te downloaden of te klonen. Zie https://github.com/SiliconLabs/simplicity_sdk voor meer informatie. Simplicity Studio installeert de Simplicity SDK standaard in:

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

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

Documentatie die specifiek is voor de SDK-versie wordt geïnstalleerd met de SDK. Aanvullende informatie is vaak te vinden in de knowledge base-artikelen (KBA's). API-referenties en andere informatie over deze en eerdere releases zijn beschikbaar op https://docs.silabs.com/.

Beveiligingsinformatie
Veilige Vault-integratie
Voor toepassingen die ervoor kiezen om sleutels veilig op te slaan met behulp van de Secure Key Storage-component op Secure Vault-High-onderdelen, toont de volgende tabel de beschermde sleutels en hun opslagbeschermingskenmerken die de Zigbee Security Manager-component beheert.Ingepakte sleutels die zijn gemarkeerd als "Niet-exporteerbaar" kunnen worden gebruikt, maar kunnen dat niet viewed of gedeeld tijdens runtime. Wrapped keys die zijn gemarkeerd als "Exporteerbaar" kunnen worden gebruikt of gedeeld tijdens runtime, maar blijven gecodeerd terwijl ze in Flash zijn opgeslagen. Gebruikersapplicaties hoeven nooit te communiceren met de meerderheid van deze sleutels. Bestaande API's om Link Key Table-sleutels of Transient Keys te beheren, zijn nog steeds beschikbaar voor de gebruikersapplicatie en worden nu gerouteerd via het Zigbee Security Manager-component.

Beveiligingsadviezen
Om u te abonneren op beveiligingsadviezen, logt u in op de Silicon Labs-klantenportal en selecteert u vervolgens Account Home. Klik op HOME om naar de startpagina van de portal te gaan en klik vervolgens op de tegel Meldingen beheren. Zorg ervoor dat 'Software/Security Advisory Notices & Product Change Notices (PCNs)' is aangevinkt en dat u minimaal bent aangemeld voor uw platform en protocol. Klik op Opslaan om eventuele wijzigingen op te slaan.

Steun
Development Kit-klanten komen in aanmerking voor training en technische ondersteuning. Gebruik de Silicon Laboratories Zigbee web pagina om informatie te verkrijgen over alle Silicon Labs Zigbee-producten en -services, en om u aan te melden voor productondersteuning. U kunt contact opnemen met Silicon Laboratories support op http://www.silabs.com/support.

Zigbee-certificering
De Ember ZNet 8.1-release is gekwalificeerd voor het Zigbee-compatibele platform voor SoC-, NC-, P- en RCP-architecturen. Er is een ZCP-certificerings-ID gekoppeld aan deze release. Controleer de CSA website hier:
https://csa-iot.org/csa-iot_products/.

Houd er rekening mee dat de ZCP-certificering filed na de release, en het duurt een paar weken voordat het op de CSA wordt weergegeven website. Voor verdere vragen kunt u contact opnemen met Silicon Laboratories support op http://www.silabs.com/support.

Veelgestelde vragen

V: Hoe kan ik de APS-koppelingssleuteltabelgrootte in de SDK bijwerken?
A: De APS-linksleuteltabelgrootte kan worden geconfigureerd met de parameter SL_ZIGBEE_KEY_TABLE_SIZE. In versie 8.1 is deze uitgebreid van 127 naar 254 vermeldingen.

V: Wat zijn de verbeteringen in versie 8.1?
A: Versie 8.1 brengt verbeteringen zoals het uitbreiden van de APS-linksleuteltabelgrootte, het hernoemen van componenten, het toevoegen van mutexbeveiliging voor Athe pp Framework-gebeurteniswachtrij en meer. Raadpleeg de release-opmerkingen voor een gedetailleerde lijst met verbeteringen.

V: Hoe ga ik om met opgeloste problemen in de SDK?
A: Problemen in de SDK opgelost, waaronder het oplossen van potentiële problemen met de configuratie van de grootte van de aangrenzende tabel, het hernoemen van componenten, het oplossen van bronroute-overhead, het verwerken van ZCL-opdrachten en meer. Zorg ervoor dat u een update uitvoert naar de nieuwste versie om van deze oplossingen te profiteren.

Documenten / Bronnen

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

Referenties

Gebruiksaanwijzing

SILICON LABS Zigbee EmberZ Net SDK

Specificaties

Productinformatie