SILICON LABS SDK 7.4.1.0 GA Zigbee Protocol Stack Software Brukerveiledning

For sikkerhetsoppdateringer og merknader, se sikkerhetskapittelet i Gecko Platform Release Notes installert med denne SDK-en, eller besøk TECH DOCS-fanen på Silicon Labs webnettstedet.
Hold deg oppdatert ved å abonnere på Security Advisories.

FAQ

Spørsmål: Hvordan bekrefter jeg riktig files blir brukt med de kompatible kompilatorene?
Svare: Du kan bekrefte at det er riktig files brukes ved å sjekke GCC versjon 12.2.1 som følger med Simplicity Studio.

Spørsmål: Hvor kan jeg finne informasjon om sikkerhetsoppdateringer og merknader?
Svare: For sikkerhetsoppdateringer og merknader, se sikkerhetskapittelet i Gecko Platform Release notes eller besøk TECH DOCS-fanen på Silicon Labs' webnettstedet.

Silicon Labs er den foretrukne leverandøren for OEM-er som utvikler Zigbee-nettverk i produktene deres. Silicon Labs Zigbee-plattformen er den mest integrerte, komplette og funksjonsrike Zigbee-løsningen som er tilgjengelig.
Silicon Labs EmberZNet SDK inneholder Silicon Labs’ implementering av Zigbee stack-spesifikasjonen.

Disse utgivelsesnotatene dekker SDK-versjon(er):

7.4.1.0 utgitt 14. februar 2024
7.4.0.0 utgitt 13. desember 2023

NØKKELFUNKSJONER

Zigbee

Zigbee R23-samsvar

Zigbee Smart Energy 1.4a samsvar – produksjon
Zigbee GP 1.1.2 samsvar – Alpha

MG27-støtte – produksjon
Forbedret støtte for Secure Vault-deler

Søvnig støtte på NCP SPI (ikke-CPC)-applikasjoner – Alpha

Multi

Samtidig lyttestøtte (RCP) – MG21 og MG24
Concurrent Multiprotocol (CMP) Zigbee NCP + OpenThread RCP – produksjon

Dynamisk multiprotokoll Bluetooth + Concurrent Multiprotocol (CMP) Zigbee- og OpenThread-støtte på SoC

Kompatibilitet og bruksmerknader

For informasjon om sikkerhetsoppdateringer og merknader, se sikkerhetskapittelet i Gecko Platform Release notes installert med denne SDK-en eller på TECH DOCS-fanen på https://www.silabs.com/developers/zigbee-emberznet. Silicon Labs anbefaler også sterkt at du abonnerer på Security Advisories for oppdatert informasjon. For instruksjoner, eller hvis du er ny på Zigbee EmberZNet SDK, se Bruke denne versjonen.

Kompatible kompilatorer

IAR Embedded Workbench for ARM (IAR-EWARM) versjon 9.40.1.
Bruk av Wine til å bygge med kommandolinjeverktøyet IarBuild.exe eller IAR Embedded Workbench GUI på macOS eller Linux kan føre til feil files blir brukt på grunn av kollisjoner i Wines hashing-algoritme for å generere short file navn.
Kunder på macOS eller Linux anbefales ikke å bygge med IAR utenfor Simplicity Studio. Kunder som gjør det bør nøye verifisere at det er riktig files blir brukt.

GCC (The GNU Compiler Collection) versjon 12.2.1, levert med Simplicity Studio.
EZSP-protokollversjonen for denne utgivelsen er 0x0D.

Nye varer

Denne utgivelsen av Gecko SDK (GSDK) vil være den siste med kombinert støtte for alle EFM- og EFR-enheter, bortsett fra patcher til denne versjonen etter behov. Fra midten av 2024 introduserer vi separate SDK-er:

Den eksisterende Gecko SDK vil fortsette med støtte for serie 0 og 1 enheter.
En ny SDK vil imøtekomme spesifikt serie 2 og 3 enheter.

Gecko SDK vil fortsette å støtte alle serie 0- og 1-enheter uten endringer i den langsiktige støtten, vedlikeholdet, kvaliteten og reaksjonsevnen gitt under programvarepolicyen vår.
Den nye SDK vil forgrene seg fra Gecko SDK og begynne å tilby nye funksjoner som hjelper utviklere å ta fordeltage av de avanserte egenskapene til våre serie 2 og 3 produkter.
Denne beslutningen er i tråd med tilbakemeldinger fra kunder, og reflekterer vår forpliktelse til å heve kvaliteten, sikre stabilitet og forbedre ytelsen for en eksepsjonell brukeropplevelse på tvers av programvare-SDK-ene våre.

Nye komponenter

Nytt i utgivelsen

Komponentene "zigbee_direct_security_p256" og "zigbee_direct_security_curve25519" er lagt til slik at brukere kan konfigurere et spesifikt Zigbee Direct-sikkerhetsalternativ.
Brukere har lov til å ha flere "zigbee_direct_security"-komponenter aktivert på en Zigbee Direct Device-applikasjon (ZDD). I dette tilfellet avhenger det faktiske sikkerhetsalternativet av Zigbee Virtual Device (ZVD)-konfigurasjonen.

Nye APIer
Nytt i utgivelsen

Lagt til en ny API sl_zigbee_token_factory_reset for å tilbakestille Zigbee NVM3-tokens til standardverdien.
Lagt til API-bool sl_zigbee_sec_man_link_key_slot_available(EmberEUI64 eui), som returnerer true hvis lenkenøkkeltabellen kan legge til eller oppdatere en oppføring med denne adressen (tabellen er ikke full).

Lagt til en ny API-bool sl_zb_sec_man_compare_key_to_value (sl_zb_sec_man_context_t*-kontekst, sl_zb_sec_man_key_t*-nøkkel), som returnerer true hvis nøkkelen refereres til av kontekst har samme verdi som nøkkelen som er oppgitt i argumentet.

Ny plattformstøtte
Nytt i utgivelsen

Zigbee stack-støtte for følgende nye deler er lagt til i denne utgivelsen: EFR32MG24A010F768IM40 og EFR32MG24A020F768IM40.

Ny dokumentasjon
Nytt i versjon 7.4.0.0

Oppdaterte beskrivelsen for Zigbee Secure Key Storage-komponenten for å gjenspeile tillegget av Zigbee Secure Key Storage Upgrade (som legger til bakoverkompatibilitet med eksisterende prosjekter).
Lagt til et nytt applikasjonsmerknad for samhandling med Zigbee Security Manager-gruppen av komponenter (AN1412: Zigbee Security Manager).

Tiltenkt oppførsel

Brukere blir påminnet om at usynkroniserte CSL-sendinger fra Zigbee er underlagt protokollforhånd hos radioplanleggeren. I SleepyToSleepy-applikasjonene kan og vil BLE forhindre en Zigbee CSL-overføring, som vil avslutte overføringen. Scheduler preemption er mer vanlig for usynkronisert CSL, gitt at en potensielt lang oppvåkningsrammesekvens kan brukes. Brukere som ønsker å justere overføringsprioriteter kan bruke DMP Tuning and Testing-komponenten for å gjøre det. Brukere kan også konsultere UG305: Dynamic Multiprotocol User's Guide for mer informasjon.

Forbedringer

Endret i utgivelsen
emberCounterHandler API-dokumentendringer

I tidligere versjoner ble Counter Handler-tilbakekalling for MAC- og APS-lag EmberCounterTypes angående pakke RX og TX ikke sendt til riktig målnode-ID eller dataargumenter, og API-dokumentasjon angående oppførselen til visse tellere som brukte disse parameterne var uklar eller misvisende.
Selv om signaturen til emberCounterHandler() ikke har endret seg, har måten parameterne fylles ut på endret seg litt.

Kommentarer rundt EmberCounterType enums i ember-types.h har blitt utvidet for klarhet.
Node ID-parameteren til Counter Handler for TX-relaterte tellere sjekker nå om destinasjonsadressemodusen indikerer en gyldig kort ID før den brukes. (Hvis ikke, er ingen destinasjonsadresse fylt ut, og en plassholderverdi på EMBER_UNKNOWN_NODE_ID brukes i stedet.)
Node ID-parameteren til Counter Handler for RX-relaterte tellere gjenspeiler nå kildenodene ID, ikke destinasjonsnoden ID.

Antallet nye forsøk er *ikke* sendt som dataparameter for EMBER_COUNTER_MAC_TX_UNICAST_ SUCCESS/FAILED-tellere som beskrevet i ember-typer. h i tidligere versjoner, men dette ble aldri riktig fylt ut i tidligere utgitte versjoner, så verdien i tidligere utgivelser ville alltid vært 0. Denne oppførselen er tydeliggjort i beskrivelsen av disse EmberCounterTypes. Imidlertid fortsetter antallet forsøk på nytt for APS-lagforsøk å fylles ut i dataparameteren for EMBER_COUNTER_APS_TX_UNICAST_SUCCESS/FAILED tellertyper, for å være konsistent med tidligere utgivelser.
Alle tellere som fyller ut node-ID-en eller dataparameteren for tilbakeringingen har blitt revidert for å sikre at de sender de forventede dataene, adressen eller EMBER_UNKNOWN_NODE_ID hvis en node-ID var forventet, men ikke kunne hentes fra pakken, som beskrevet i den reviderte ember- type.h dokumentasjon.
Tellerbehandleren for EMBER_COUNTER_MAC_TX_UNICAST_RETRY reflekterer nå korrekt MAC-lagets destinasjonsnode-ID og flere gjenforsøk i dens destinasjonsnode-ID og dataparametere.

Tellerbehandleren for EMBER_COUNTER_PHY_CCA_FAIL_COUNT gir nå destinasjonsnode-ID-informasjon gjennom Node ID-parameteren om det tiltenkte MAC-lagmålet for meldingen som mislyktes i overføringen.

Oppdatert Green Power Code
Green Power serverkode er oppdatert med forskjellige forbedringer, inkludert:

Lagt til mer valideringskode for innkommende kommandoer med ugyldig endepunkt ved mottak på GP-serveren.

Lagt til kode for å håndtere saken når det ikke er mer plass til å bygge meldinger om grønn strøm.
Vasken dropper nå paringskonfigurasjon med handling fjern paring i noen tilfeller per spesifikasjonsseksjon A.3.5.2.4.1.
Vasken lagrer nå den eksisterende gruppelisten for en oppføring før den fjernes ved behandling av sammenkoblingskonfigurasjon med handlingsforlengelse.

Kommandoen Translation Query returnerer "NOT FOUND" som feilkode når oversettelsestabellen er tom eller indeksen er større enn flere oppføringer i tabellen.
Endret versjonen av GP-endepunktet i noen apper fra 1 til 0.

Bruk av CSMA i GPDF Send-funksjonen er begrenset fordi Green Power Devices er minimale energienheter og ikke bruker CSMA i de fleste designene. I stedet er det foretrukne designet å sende ut flere pakker med samme energibudsjett.
Fjernet bruken av et skjult endepunkt i Green Power Server-plugin-alternativet. Bruk et av applikasjonsendepunktene i stedet.
Nettverksnøkkeloppdatering Plugin-kodeforbedringer

Endret den periodiske oppdateringsperioden for nettverksnøkkelen til å være så lang som 1 år.

Omstrukturerte noen APIer for å unngå unødvendig nøkkeleksport
Gjorde endringer for å favorisere bruken av nøkkelkontekster fremfor rentekstnøkkeldata.

sl_zigbee_send_security_challenge_request tar nå inn et sl_zb_sec_man_context_t argument i stedet for EmberKeyData.

Verdiene til sl_zb_sec_man_derived_key_type enum er nå en 16-bits bitmaske som direkte støtter visse nøkkelavledninger som kombinerer flere avledede typer.

Faste problemer

Rettet i utgivelsen

ID #	Beskrivelse
1036893	Rettet et problem som førte til at OTA-klyngekomponenten installerte den eldre oppstartslastergrensesnittkomponenten som en avhengighet.
1114905	Zigbee Direct: Forbedret håndtering av Leave Network Characteristic.
1180937	Fast WDT-tilbakestilling ved tilkobling av Zigbee Direct ZDD til tredjeparts ZVD.
1223904	Rettet et problem som førte til at sluttenheten flyttet til å fungere feil i et veldig travelt miljø.
1224393	Oppdaterte Green Power-vasketabellens forespørselshåndteringskode for å oppdatere svardestinasjonsadressen.
1228808	Fikset skjermproblemet med makrodefinisjoner i gp-types.h-dokumentasjonen.
1232297	Rettet et problem der emberSetOutgoingNwkFrameCounter og emberSetOutgoingApsFrameCounter ikke fungerte på 64-biters vertsapplikasjoner (returnerer EMBER_BAD_ARGUMENT).
1232359	Rettet gppTunnelingDelay-parameterberegningen i grønn strømklientkommandobehandling.
1240392	ZDO Bind/unbind-forespørsler som avvises på grunn av tilgang/tillatelse, bør returnere EMBER_ZDP_NOT_AUTHORIZED-status i stedet for EMBER_ZDP_NOT_PERMITTED-status i henhold til Zigbee-spesifikasjonene.
1243523	Zigbee Direct: Forbedret stabilitet av BLE-tilkobling til ZVD.
1249455	Rettet et problem som førte til at en søvnig sluttenhet gikk i dvale når den mottok en kringkasting før den mottok en kvittering.
1252295	Rett opp en skrivefeil i komponentkatalogmakroen SL_CATALOG_ZIGBEE_OTA_STORAGE_COMMON_PRESENT.

Rettet i utgivelsen

ID #	Beskrivelse
1019348	Rettet avhengighetskravene for Zigbee ZCL Cli-komponenten slik at den kan fjernes når den ikke er nødvendig.
1024246	Oppdaterte funksjonsbeskrivelsen for emberHaveLinkKey() og sl_zb_sec_man_have_link_key().
1036503	Lagt til en beskrivelse for å anbefale bruken av Micrium-kjernen for DMP-erampappene.
1037661	Et problem som hindret applikasjonen i å installere enten pro stack eller leaf stack er løst.
1078136	Rettet et periodisk krasj ved endring av hendelser fra avbruddskontekst
1081548	Brukere blir påminnet om at usynkroniserte CSL-sendinger fra Zigbee er underlagt protokollforhånd hos radioplanleggeren. I SleepyToSleepy-applikasjonene kan og vil BLE forhindre en Zigbee CSL-overføring, som vil avslutte overføringen. Scheduler preemption er mer vanlig for usynkronisert CSL, gitt at en potensielt lang oppvåkningsrammesekvens kan brukes. Brukere som ønsker å justere overføringsprioriteter kan bruke DMP Tuning and Testing-komponenten for å gjøre det. Brukere kan også konsultere UG305: Dynamic Multiprotocol User's Guide for mer informasjon. Et problem er løst i CSL der en ny oppvåkningsrammesekvens som mottas umiddelbart etter en tidligere nyttelastramme, ikke ble registrert på riktig måte. Dette vil resultere i en tapt nyttelastramme.
1084111	Opprinnelig søvnig SPI-NCP-støtte for MG24-baserte kort oppdateres som en del av denne utgivelsen.
1104056	Lagt til støtte for nettverksstyring for å kjøre på et sekundært nettverk i tilfelle multinettverk
1120515	Rettet et problem der kanalen ikke endret seg ved bruk av mfglib set-channel-kommandoen.
1141109	Rettet et problem som forårsaket den genererte sampapplikasjonen ncp-uart-gp-multi-rail for å gå glipp av noen header files når du bruker den grønne strømadapterkomponenten med alternativet -cp.
1144316	Oppdaterte beskrivelsen av noen datastrukturtyper i gp-types.h dokumentasjon.
1144884	Fikset falsk ramme som venter bit satt når ingen data venter.
1152512	Rettet en potensiell krasj i low-mac-rail ved endring av hendelsen i ISR-sammenheng.

ID #	Beskrivelse
1154616	Lagt til et unntak for betingelsen om å initialisere nettverket med saken "Bytter rolle fra Sleepy End-enhet til Non-sleepy End-enhet".
1157289	Rettet et problem som kan forårsake BDB-testfeil DN-TLM-TC-02B.
1157426	Rettet et byggeproblem ved bygging av zigbee_simple_app med green_power_adapter-komponenten.
1157932	Lagt til en betingelse for å sjekke om "overgangstidspunkt"-feltet mangler og angi en standardverdi på 0xFFFF for dette manglende feltet.
1166340	Rettet et problem som hindret emberAfGpdfSend fra å sende ut det tiltenkte antallet gjentatte sendinger.
1167807	Rettet et problem der enheter som fungerer som tillitssentre i distribuerte nettverk feilaktig tømmer forbigående koblingsnøkler hver gang en ny enhet ble med.
1169504	Rettet et problem som forårsaket en tilbakestilling av en søvnig enhet ved tvungen vekking.
1169966	Rettet manglende returverdivalidering i buffertildelingskode.
1171477, 172270	Med mfglib start 1 sendes ingen meldinger, men mottas, så den viste terminalmeldingen "mfglib send complete" er feil og endret til "RXed %d packets in the last %d ms".
1171935	Endret den periodiske oppdateringsperioden for nettverksnøkkelen til å være så lang som 1 år.
1172778	La til den manglende påkallingen av emberAfPluginGreenPowerServerUpdateAliasCallback til Green Power-serveren.
1174288	Rettet et problem som førte til at nettverksstyringsprosessen hevdes hvis et anrop for å stoppe en pågående skanning kalles.
1178393	Oppdaterte en dokumentasjonsfeil.
1180445	I Smart Energy fortsetter OTA nå å laste ned hvis koordinatoren når den begrensede driftssyklusen.
1185509	Rettet et problem i CSL der en ny oppvåkningsrammesekvens som mottas umiddelbart etter en tidligere nyttelastramme, ikke ble registrert på riktig måte. Dette vil resultere i en tapt nyttelastramme.
1186107	Rettet et problem som førte til at den mislykkede dekrypteringen av mottatte GPDF-er erstattet den innkommende GPDF-en i gp-igangkjøringsvarselet.
1188397	Rettet et problem som forårsaket en kompileringsfeil ved aktivering av utvidet rapporttabellstørrelse.
1194090	Rettet feilstatusen i standardsvaret for kommandoen Sink Commissioning Mode – følgende avsnitt 3.3.4.8.2
1194963	Rettet et problem som satte commissioningGpd-strukturen før tilbakeringing av brukeren emberAfGreenPowerServerPairingStatusCallback.
1194966	Rettet et problem der feltene endepunkt og proxiesInvolved ikke ble angitt med Exit Commissioning-handlingen.
1196698	Rettet et bitsett for falsk ramme som venter når ingen data var ventende.
1199958	Lagt til kode for å håndtere saken når det ikke er mer plass til å bygge meldinger om grønn strøm.
1202034	Rettet et problem der stackvariabelen sl_zb_sec_man_context_t ikke ble initialisert på riktig måte, noe som førte til at sammenkobling med installasjonskode mislyktes.
1206040	Å ringe emberRemoveChild() under et sikkert gjenopprettingsforsøk av en sluttenhet kan potensielt føre til en ekstra reduksjon av Child Count, potensielt føre til en Child Count på -1 (255), og hindre sluttenheter i å bli med/føye seg sammen på grunn av en indikert mangel av kapasitet i Beacon.
1207580	Underordnede tabellsøkefunksjoner i stabelen er inkonsekvente i bruken av 0x0000 versus 0xFFFF for node-ID-returverdi som representerer ugyldige/tomme oppføringer, noe som fører til problemer med å se etter ubrukte oppføringer i APIer som emberRemoveChild().
1210706	Destinasjon og PHY-indeks gitt i EmberExtraCounterInfo struct som en del av emberCounterHandler() kan ha vært feil for MAC TX Unicast-tellertyper.
1211610 1212525	Rettet et problem der Dynamic Multiprotocol-applikasjoner krasjet etter aktivering av Secure Key Storage Upgrade-komponenten.
1211847	Selv om signaturen til emberCounterHandler() ikke har endret seg, har måten parameterne fylles ut på endret seg litt. Endringer rundt denne API-en er forklart i avsnitt 2 ovenfor.
1212449	Utgående Beacons ble feil kategorisert av MAC-laget, noe som førte til at emberCounterHandler() ikke klarte å fange disse pakkene med tellertypen EMBER_COUNTER_MAC_TX_BROADCAST og i stedet telle Beaconene med tellertypen EMBER_COUNTER_MAC_TX_UNICAST_SUCCESS. Dette resulterte potensielt i upålitelige verdier for dest EmberNodeId-parameteren sendt til EmberCounterInfo-strukturen

ID #	Beskrivelse
1214866	Sending av dataavstemningspakker i visse høytrafikkkonfigurasjoner kan resultere i en bussfeil.
1216552	Et problem som forårsaker en påstand under travle trafikkforhold er løst.
1216613	Rettet et problem som førte til en feil verdi for gruppe-cast-radius i proxy-tabellen.
1222509	Ruteren/koordinatoren sender en forespørsel om permisjon og på nytt til en sluttenhet som ikke er underordnet polling, men MAC-destinasjonen er 0xFFFF i stedet for å samsvare med NWK-destinasjonsadressen.
1223842	Rettet et problem med genereringen av sl_component_catalog.h som etterlot uønsket kode i den som forårsaket kompileringsfeil.
756628	Endret påkallingen av tilbakeringing av applikasjonen emberAfMacFilterMatchMessageCallback til å bare kalles for ZLL-meldingene som er validert av stabelen.
816088	Flyttet EMBER-konfigurasjonen fra zigbeed_configuration.h til zigbeed. slcp.
829508	For å unngå en løpstilstand ble ytterligere validering lagt til i emberSetLogicalAndRadioChannel for å returnere mislykket hvis de nedre lagene er opptatt eller ikke i en tilstand for å endre kanal.

Kjente problemer i gjeldende utgivelse

Utgaver i fet skrift er lagt til siden forrige utgivelse. Hvis du har gått glipp av en utgivelse, er nylige utgivelsesnotater tilgjengelig på https://www.si-labs.com/developers/zigbee-emberznet i fanen Tekniske dokumenter.

ID #	Beskrivelse	Løsning
N/A	· Følgende apper/komponenter støttes ikke i denne utgivelsen: EM4-støtte	Funksjonen vil bli aktivert i påfølgende utgivelser.
193492	emberAfFillCommandGlobalServerToClientConfigureRe-porteringsmakroen er ødelagt. Fyllingen av bufferen skaper en feil kommandopakke.	Bruk "zcl global send-me-a-report" CLI-kommandoen i stedet for API.
278063	Smart energitunnelering plugins har motstridende behandling/bruk av adressetabellindeks.	Ingen kjent løsning
289569	Valglisten for strømnivå for nettverksskapende komponent tilbyr ikke et komplett utvalg av støttede verdier for EFR32	Rediger området <-8..20> som er spesifisert i CMSIS-kommentaren for EMBER_AF_PLUGIN_NETWORK_CREATOR_RADIO_P OWER i /protocol/ZigBee/app/framework/plugin/network-creator/config/network-creator-config.h file. For eksample, endre til .
295498	UART-mottak faller noen ganger byte under stor belastning i brukstilfellet Zigbee+BLE dynamisk multiprotokoll.	Bruk maskinvareflytkontroll eller senk baudhastigheten.
312291	EMHAL: halCommonGetIntxxMillisecondTick-funksjonene på Linux-verter bruker for øyeblikket get meofday-funksjonen, som ikke garantert er monotonisk. Hvis systemtiden endres, kan det forårsake problemer med stabeltiming.	Endre disse funksjonene for å bruke clock_gettime med CLOCK_MONOTONIC-kilden i stedet.
338151	Initialisering av NCP med en lav pakkebuffertallverdi kan forårsake korrupte pakker.	Bruk den reserverte verdien 0xFF for pakkebuffertelling for å unngå den for lave standardverdien
387750	Problemet med formater for rutetabellforespørsel på sluttenheten.	Under etterforskning
400418	En berøringslink-initiator kan ikke koble til et ikke-fabrikknyt sluttenhetsmål.	Ingen kjent løsning.
424355	En ikke-fabrikkny, søvnig endeenhet med touchline mål-kompatible initiator er ikke i stand til å motta et enhetsinformasjonssvar under visse omstendigheter.	Under etterforskning
465180	Coexistence Radio Blocker Optimization-elementet "Enable Runtime Control" kan blokkere riktig Zigbee-drift.	Valgfri "Wi-Fi Select"-kontroll av blokkeringsoptimalisering skal stå "Deaktivert".
480550	OTA-klyngen har sin innebygde fragmenteringsmetode, og bør derfor ikke bruke APS-fragmentering. Selv om APS-kryptering er aktivert, øker nyttelasten til ImageBlockResponses til en størrelse der APS-fragmenteringen er aktivert. Dette kan føre til at OTA-prosessen mislykkes.	Ingen kjent løsning
481128	Detaljert tilbakestillingsårsak og krasjdetaljer skal være tilgjengelig som standard via Virtual UART (Serial 0) på NCP-plattformer når Diagnostics-plugin og Virtual UART perifer er aktivert.	Siden Serial 0 allerede er initialisert i NCP, kan kunder aktivere emberAfNcpInitCallback i Zigbee NCP Framework og kalle de riktige diagnosefunksjonene (halGetExtendedResetInfo, halGetExtendedResetString, halPrintCrashSummary, halPrintCrashDetail, halPrintCrash, skriv ut, og tilbakekall denne data i Crash. 0 for viewi Network Analyzer-registreringsloggen. For en eksamples om hvordan du bruker disse funksjonene, se koden inkludert i a-main-soc.c sin emberAfMainInit() når EXTENDED_RESET_INFO er definert.

ID #	Beskrivelse	Løsning
486369	Hvis en DynamicMultiProtocolLightSoc som danner et nytt nettverk har underordnede noder igjen fra et nettverk den har forlatt, returnerer emberAfGetChildTableSize en verdi som ikke er null i startIdentifyOnAllChildNodes, noe som forårsaker Tx 66-feilmeldinger når de adresserer "spøkelse"-barna.	Masseslett delen hvis mulig før du oppretter et nytt nettverk, eller sjekk underordnet tabellen programmessig etter at du har forlatt nettverket og slett alle barn som bruker emberRemoveChild før du danner et nytt nettverk.
495563	Blir med i SPI NCP Sleepy End Device Sample App forkorter ikke avstemningen, derfor mislykkes forsøket med å bli med i tilstanden Update TC Link Key.	Enheten som ønsker å bli med, bør være i Short Poll-modus før du prøver å bli med. Denne modusen kan tvinges av End Device Support-plugin.
497832	I Network Analyzer refererer Zigbee Application Support Command Breakdown for Verify Key Request Frame feilaktig til den delen av nyttelasten som angir rammens kildeadresse som destinasjonsadressen.	Ingen kjent løsning
519905 521782	Spi-NCP kan svært sjelden mislykkes i å starte oppstartslasterkommunikasjon ved å bruke "bootload" CLI-kommandoen til ota-klient-plugin.	Start oppstartsprosessen på nytt
620596	NCP SPI Eksample for BRD4181A (EFR32xGMG21) nWake standard pin definert kan ikke brukes som en wake-up pin.	Endre standardpinnen for nWake fra PD03 til en EM2/3-oppvåkningsaktivert pinne i NCP-SPI-plugin.
631713	En Zigbee End Device vil rapportere adressekonflikter gjentatte ganger hvis plugin "Zigbee PRO Stack Library" brukes i stedet for "Zigbee PRO Leaf Library".	Bruk "Zigbee PRO Leaf Library" i stedet for "Zigbee PRO Stack Library"-plugin.
670702	Ineffektivitet i rapporteringsplugin-modulen kan føre til betydelig ventetid basert på dataskrivingsfrekvens og tabellstørrelse, noe som kan forstyrre kundens applikasjonskode, inkludert hendelsestiming.	Hvis du skriver ofte, bør du vurdere å sjekke rapporteringsforholdene og sende rapporter manuelt i stedet for å bruke plugin.
708258	Uinitialisert verdi i groups-server.c via addEntryToGroupTable() kan skape en falsk binding og føre til at gruppecast-rapporteringsmeldinger sendes.	Legg til "binding.clusterId = EMBER_AF_INVALID_CLUSTER_ID;" etter "binding.type = EMBER_MULTICAST_BINDING;"
757775	Alle EFR32 deler har en unik RSSI offset. I tillegg kan tavledesign, antenner og kabinett påvirke RSSI.	Når du oppretter et nytt prosjekt, installer RAIL Utility, RSSI-komponenten. Denne funksjonen inkluderer standard RSSI Offset Silabs målt for hver del. Denne forskyvningen kan endres om nødvendig etter RF-testing av hele produktet.
758965	ZCL-klyngekomponenter og ZCL-kommandooppdagelsestabellen er ikke synkronisert. Derfor, når du aktiverer eller deaktiverer en ZCL-klyngekomponent, vil ikke implementerte kommandoer bli aktivert/deaktivert i den tilsvarende ZCL Advanced Configurator-kommandofanen.	Aktiver/deaktiver oppdagelse manuelt for de ønskede ZCL-kommandoene i ZCL Advanced Configurator.
765735	OTA-oppdateringen mislykkes på Sleepy End Device med aktivert Page Request.	Bruk Block Request i stedet for Page Request.
845649	Fjerne CLI: Kjernekomponenten eliminerer ikke EEPROM cli-kall til sl_cli.h.	Slett eeprom-cli.c file som kaller sl_cli.h. I tillegg kan anrop til sl_cli.h samt sl_cli_command_arg_t i ota-storage-simple-eeprom kommenteres ut.
857200	ias-zone-server. c gjør det mulig å opprette en binding med en "0000000000000000" CIE-adresse og tillater ikke ytterligere bindinger.	Ingen kjent løsning
1019961	Generert Z3Gateway-merkefile hardkoder "gcc" som CC	Ingen kjent løsning

ID #	Beskrivelse	Løsning
1039767	Zigbee-ruternettverksproblem med køoverløp på nytt i flertråds RTOS-bruk.	Zigbee Stack er ikke trådsikker. Som et resultat støttes ikke oppkalling av Zigbee stack APIer fra en annen oppgave i OS-miljøet og kan sette stabelen i en "ikke-fungerende" tilstand. Se følgende appnotat for mer informasjon og en løsning ved bruk av hendelsesbehandleren. https://www.silabs.com/documents/public/application- notater/an1322-dynamic-multiprotocol-bluetooth-zigbee-sdk- 7x.pdf .
1064370	Z3Switch sampapplikasjonen har bare aktivert én knapp (forekomst: btn1) som standard, noe som fører til feil i knappebeskrivelsen i prosjektet file.	Løsning: Installer btn0-forekomsten manuelt under opprettelsen av Z3Switch-prosjektet.
1161063	Z3Light og potensielt andre applikasjoner rapporterer feil klyngrevisjonsverdier.	Oppdater klyngrevisjonsattributtet manuelt til den aktuelle revisjonen.
1164768, 1171478, 1171479	FEIL: ezspErrorHandler 0x34 rapportert gjentatte ganger under mfglib-mottaksmodus	For å redusere feilmeldingene som skrives ut, konfigurer EMBER_AF_PLUGIN_GATEWAY_MAX_WAIT_FOR_EV ENT_TIMEOUT_MS på vertsappen til 100, slik at tilbakeringingskøen frigjøres raskere.
1252460	SimEEPROM-gjenopprettingsrutiner (for både v1 og v2) som kjøres ved oppstart kan utføre feiljusterte flash-side-slettekall som resulterer i påstander under em_msc. cs MSC_ErasePage-rutine.	*Løsning: Plasser følgende kodelinje øverst i MSC_ErasePage()-funksjonen i em_msc.c: startadresse = (uint32_t)((uint32_t)startAddress & ~(FLASH_PAGE_SIZE-1));**

Utdaterte varer

Avviklet i utgivelsen
I GSDK 7.4.0.0 og utover, inkludert denne oppdateringen, er "-v"-alternativet i en Z3Gateway for en linux-vertsapplikasjon for å lage et telnet-grensesnitt med port 4900 eller 4901 utdatert. Den alternative anbefalte måten å lage et telnet-grensesnitt på er å bruke linux-verktøy som "socat".

Avviklet i utgivelsen
Fjernet følgende utdaterte sikkerhets-APIer:

emberGetKey()
emberGetKeyTableEntry()
emberSetKeyTableEntry()

emberHaveLinkKey()
emberAddOrUpdateKeyTableEntry()
emberAddTransientLinkKey()

emberGetTransientKeyTableEntry()
emberGetTransientLinkKey()
emberHmacAesHash()

Bruk API-ene levert av Zigbee Security Manager for tilgang til nøkkellagring og HMAC-hashing.

Fjernede elementer

Fjernet i utgivelsen

Fjernet dupliserte offentlige APIer i offentlig overskrift file gp-typer.h.

zigbee_end_device_bind-komponenten er fjernet. Denne komponenten ble brukt for koordinatoren for å formidle bindende forespørsler om sluttenheter. Denne valgfrie funksjonaliteten ble fjernet fra R22 i Zigbee-kjernespesifikasjonen.
Fjernet setPacketBufferCount() i af-host.c og useless check case EZSP_CONFIG_PACKET_BUFFER_COUNT: i command-handlers.c.
Fjernet minnetildelingsargument fordi det ikke er nødvendig å dele opp i to faser ved initialisering av NCP.

Fjernet emberAfNcpInitCallback() i se14-comms-hub, se14-ihd og se14-meter-gas sin app.c.
Fjernet innstilling EZSP_CONFIG_RETRY_QUEUE_SIZE verdi under ncp initialisering i ncp-configuration.c

Multiprotokoll Gateway og RCP

Nye varer
Lagt til i utgivelsen

Samtidig lytting, muligheten for Zigbee- og OpenThread-stakkene til å operere på uavhengige 802.15.4-kanaler når du bruker en EFR32xG24 eller xG21 RCP, er frigitt.
Samtidig lytting er ikke tilgjengelig for 802.15.4 RCP/Bluetooth RCP-kombinasjonen, Zigbee NCP/OpenThread RCP-kombinasjonen eller for Zigbee/OpenThread system-on-chip (SoC). Det vil bli lagt til disse produktene i en fremtidig utgivelse.
OpenThread CLI-leverandørutvidelsen er lagt til OpenThread-vertsappene til multiprotokollbeholdere. Dette inkluderer coex cli-kommandoene.

Forbedringer
Endret i utgivelsen

Zigbee NCP/OpenThread RCP multiprotokollkombinasjonen er nå produksjonskvalitet.

Faste problemer
Rettet i utgivelsen

ID #	Beskrivelse
1213701	zigbeed tillot ikke at en kildetilpasningstabelloppføring ble opprettet for et barn hvis indirekte MAC-kø har data som allerede venter for det barnet. Denne oppførselen kan føre til at applikasjonslagstransaksjoner mellom barnet og en annen enhet mislykkes på grunn av mangel på APS Ack eller app-lagsrespons, spesielt avbrudd og uventet avslutning av ZCL OTA-oppgraderinger som er målrettet mot underenheten.
1244461	Kildematchtabelloppføring for barn kunne fjernes til tross for ventende meldinger.

Rettet i utgivelsen

ID #	Beskrivelse
1081828	Gjennomstrømningsproblem med FreeRTOS-baserte Zigbee/BLE DMP-erample applikasjoner.
1090921	Z3GatewayCpc hadde problemer med å danne et nettverk i et støyende miljø.
1153055	En påstand om verten ble forårsaket da det var en kommunikasjonsfeil ved lesing av NCP-versjonen fra zigbee_ncp-ble_ncp-uart sampappen.
1155676	802.15.4 RCP forkastet alle mottatte unicast-pakker (etter MAC-acking) hvis flere 15.4-grensesnitt delte samme 16-bits node-ID.
1173178	Verten rapporterte feilaktig hundrevis av pakker mottatt med mfglib i Host-RCP-oppsettet.
1190859	EZSP-feil ved sending av tilfeldige mfglib-pakker i Host-RCP-oppsettet.
1199706	Dataavstemninger fra barn som har glemt sluttenheten, satte ikke riktig inn en ventende ramme på RCP-en for å sette en Leave & Rejoin-kommando i kø til det tidligere barnet.
1207967	Kommandoen "mfglib send random" sendte ut ekstra pakker på Zigbeed.
1208012	mfglib rx-modusen oppdaterte ikke pakkeinformasjonen riktig ved mottak på RCP.
1214359	Koordinatornoden krasjet da 80 eller flere rutere prøvde å bli med samtidig i Host-RCP-oppsettet.
1216470	Etter å ha videresendt en kringkasting for adressemaske 0xFFFF, ville en Zigbee RCP som fungerer som en overordnet enhet forlate det ventende dataflagget satt for hvert barn. Dette resulterte i at hvert barn holdt seg våken og ventet på data etter hver avstemning, og krevde noen andre ventende datatransaksjoner til hver endeenhet for å fjerne denne tilstanden.

Kjente problemer i gjeldende utgivelse

ID #	Beskrivelse	Løsning
811732	Støtte for tilpasset token er ikke tilgjengelig når du bruker Zigbeed.	Støtte er planlagt i en fremtidig utgivelse.
937562	Bluetoothctl 'advertise on'-kommandoen mislykkes med rcp-uart-802154-blehci-appen på Raspberry Pi OS 11.	Bruk btmgmt-appen i stedet for bluetoothctl.
1022972	Coex fungerer ikke på ZB NCP + OT RCP.	Støtte er planlagt for en fremtidig utgivelse.
1074205	CMP RCP støtter ikke to nettverk på samme PAN-ID.	Bruk forskjellige PAN-IDer for hvert nettverk. Støtte er planlagt i en fremtidig utgivelse.
1122723	I et travelt miljø kan CLI-en ikke reagere i z3-light_ot-ftd_soc-appen.	Ingen kjent løsning.
1124140	z3-light_ot-ftd_soc sample app er ikke i stand til å danne Zigbee-nettverket hvis OT-nettverket allerede er oppe.	Start Zigbee-nettverket først og OT-nettverket etter.
1170052	CMP Zigbee NCP + OT RCP og DMP Zigbee NCP + BLE NCP passer kanskje ikke på 64KB og lavere RAM-deler i denne nåværende utgivelsen.	64KB deler støttes for øyeblikket ikke for disse appene.
1209958	ZB/OT/BLE RCP på Bobcat og Bobcat Lite kan slutte å virke etter noen minutter når du kjører alle tre protokollene	Vil bli behandlet i en fremtidig utgivelse
1221299	Mfglib RSSI-avlesninger varierer mellom RCP og NCP.	Vil bli behandlet i en fremtidig utgivelse.
1231021	OTBR kan hevde når 80+ zigbee-enheter blir med samtidig.	Lagt til en løsning som kan omgå problemet. Vil bli behandlet fullt ut i en fremtidig utgivelse.

Utdaterte varer

Ingen

Fjernede elementer
Fjernet i utgivelsen

«NONCOMPLIANT_ACK_TIMING_WORKAROUND»-makroen er fjernet. Alle RCP-apper støtter nå som standard 192 μs behandlingstid for ikke-forbedrede acks mens de fortsatt bruker 256 μs behandlingstid for forbedrede acks som kreves av CSL.

Bruker denne utgivelsen
Denne utgivelsen inneholder følgende:

Zigbee stabel

Zigbee Application Framework
Zigbee Sample Applikasjoner

For mer informasjon om Zigbee og EmberZNet SDK, se UG103.02: Zigbee Fundamentals.
Hvis du er en førstegangsbruker, se QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 and Higher, for instruksjoner om hvordan du konfigurerer utviklingsmiljøet, bygger og blinker somampapplikasjonen og dokumentasjonsreferanser som peker på neste trinn.

Installasjon og bruk

Zigbee EmberZNet SDK leveres som en del av Gecko SDK (GSDK), pakken med Silicon Labs SDK-er. For å komme raskt i gang med GSDK, installer Simplicity Studio 5, som vil sette opp utviklingsmiljøet ditt og lede deg gjennom GSDK-installasjonen. Simplicity Studio 5 inkluderer alt som trengs for IoT-produktutvikling med Silicon Labs-enheter, inkludert en ressurs- og prosjektstarter, programvarekonfigurasjonsverktøy, full IDE med GNU-verktøykjede og analyseverktøy. Installasjonsinstruksjoner finnes i den elektroniske brukerveiledningen for Simplicity Studio 5.
Alternativt kan Gecko SDK installeres manuelt ved å laste ned eller klone det siste fra GitHub. Se https://github.com/Sili-conLabs/gecko_sdk for mer informasjon.

Simplicity Studio installerer GSDK som standard i:

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

(MacOS): /Brukere/ /SimplicityStudio/SDKs/gecko_sdk

Dokumentasjon spesifikk for SDK-versjonen er installert med SDK. Ytterligere informasjon kan ofte finnes i kunnskapsbaseartiklene (KBA). API-referanser og annen informasjon om denne og tidligere utgivelser er tilgjengelig på https://docs.silabs.com/.

Sikkerhetsinformasjon

Sikker Vault-integrasjon
For programmer som velger å lagre nøkler sikkert ved å bruke Secure Key Storage-komponenten på Secure Vault-High-deler, viser følgende tabell de beskyttede nøklene og deres lagringsbeskyttelsesegenskaper som Zigbee Security Manager-komponenten administrerer.

Innpakket nøkkel	Eksporterbar / Ikke-eksporterbar	Notater
Nettverksnøkkel	Kan eksporteres
Tillitssenterkoblingsnøkkel	Kan eksporteres
Transient Link Key	Kan eksporteres	Indeksert nøkkeltabell, lagret som flyktig nøkkel
Application Link Key	Kan eksporteres	Indeksert nøkkeltabell
Sikker EZSP-nøkkel	Kan eksporteres
ZLL krypteringsnøkkel	Kan eksporteres
ZLL forhåndskonfigurert nøkkel	Kan eksporteres
GPD proxy nøkkel	Kan eksporteres	Indeksert nøkkeltabell
GPD Sink Key	Kan eksporteres	Indeksert nøkkeltabell
Intern/Plassholdernøkkel	Kan eksporteres	Intern nøkkel for bruk av Zigbee Security Manager

Innpakkede nøkler som er merket som "Ikke-eksporterbare" kan brukes, men kan ikke være det viewed eller delt under kjøring.
Innpakkede nøkler som er merket som "Eksporterbare" kan brukes eller deles under kjøring, men forblir krypterte mens de lagres i Flash.
Brukerapplikasjoner trenger aldri å samhandle med de fleste av disse tastene. Eksisterende APIer for å administrere Link Key Table-nøkler eller Transient Keys er fortsatt tilgjengelige for brukerapplikasjonen og rutes nå gjennom Zigbee Security Manager-komponenten.

Noen av disse nøklene kan bli ikke-eksporterbare til brukerapplikasjonen i fremtiden. Brukerapplikasjoner oppfordres til ikke å stole på eksport av nøkler med mindre det er absolutt nødvendig.
For mer informasjon om Secure Vault Key Management-funksjonalitet, se AN1271: Secure Key Storage.

Sikkerhetsråd
For å abonnere på Security Advisories, logg inn på Silicon Labs kundeportal, og velg deretter Kontohjem. Klikk HJEM for å gå til portalens hjemmeside, og klikk deretter på Administrer varsler-flisen. Sørg for at 'Software/Security Advisory Notices & Product Change Notices (PCNs)' er merket av, og at du som minimum abonnerer på din plattform og protokoll. Klikk Lagre for å lagre eventuelle endringer.

Støtte
Development Kit-kunder er kvalifisert for opplæring og teknisk støtte. Bruk Silicon Laboratories Zigbee web siden for å få informasjon om alle Silicon Labs Zigbee-produkter og -tjenester, og for å registrere deg for produktstøtte.
Du kan kontakte Silicon Laboratories support på http://www.silabs.com/support.

Simplicity Studio
Ett-klikks tilgang til MCU og trådløse verktøy, dokumentasjon, programvare, kildekodebiblioteker og mer. Tilgjengelig for Windows, Mac og Linux!

Ansvarsfraskrivelse
Silicon Labs har til hensikt å gi kundene den nyeste, nøyaktige og dyptgående dokumentasjonen av alle periferiutstyr og moduler tilgjengelig for system- og programvareimplementere som bruker eller har til hensikt å bruke Silicon Labs-produktene. Karakteriseringsdata, tilgjengelige moduler og periferiutstyr, minnestørrelser og minneadresser refererer til hver spesifikk enhet, og "Typiske" parametere kan variere i forskjellige applikasjoner. Søknad eksampLesene beskrevet her er kun for illustrasjonsformål. Silicon Labs forbeholder seg retten til å gjøre endringer uten ytterligere varsel i produktinformasjonen, spesifikasjonene og beskrivelsene her, og gir ingen garantier for nøyaktigheten eller fullstendigheten til den inkluderte informasjonen. Uten forhåndsvarsel kan Silicon Labs oppdatere produktfastvaren under produksjonsprosessen av sikkerhets- eller pålitelighetsårsaker. Slike endringer vil ikke endre spesifikasjonene eller ytelsen til produktet. Silicon Labs skal ikke ha noe ansvar for konsekvensene av bruk av informasjonen i dette dokumentet. Dette dokumentet antyder eller gir ikke uttrykkelig noen lisens til å designe eller produsere integrerte kretser. Produktene er ikke designet eller autorisert for bruk i noen FDA Klasse III-enheter, applikasjoner som FDA forhåndsmarkedsgodkjenning kreves for eller Life Support Systems uten spesifikt skriftlig samtykke fra Silicon Labs. Et "Livsstøttesystem" er ethvert produkt eller system beregnet på å støtte eller opprettholde liv og/eller helse, som, hvis det mislykkes, med rimelighet kan forventes å resultere i betydelig personskade eller død. Silicon Labs-produkter er ikke designet eller autorisert for militære applikasjoner. Silicon Labs-produkter skal under ingen omstendigheter brukes i masseødeleggelsesvåpen, inkludert (men ikke begrenset til) atomvåpen, biologiske eller kjemiske våpen, eller missiler som er i stand til å levere slike våpen. Silicon Labs fraskriver seg alle uttrykkelige og underforståtte garantier og skal ikke være ansvarlig eller ansvarlig for skader eller skader relatert til bruk av et Silicon Labs-produkt i slike uautoriserte applikasjoner.

Note: Dette innholdet kan inneholde støtende terminologi som nå er foreldet. Silicon Labs erstatter disse vilkårene med inkluderende språk der det er mulig. For mer informasjon, besøk www.silabs.com/about-us/inclusive-lexicon-project.

Varemerkeinformasjon
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® og Silicon Labs-logoen®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro-logoen og kombinasjoner av disse , "verdens mest energivennlige mikrokontrollere", Redpine Signals®, WiSeConnect , n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress® , Zentri, Zentri-logoen og Zentri DMS, Z- Wave® og andre er varemerker eller registrerte varemerker for Silicon Labs. ARM, CORTEX, Cortex-M3 og THUMB er varemerker eller registrerte varemerker for ARM Holdings. Keil er et registrert varemerke for ARM Limited. Wi-Fi er et registrert varemerke for Wi-Fi Alliance. Alle andre produkter eller merkenavn nevnt her er varemerker for deres respektive eiere.

KONTAKT

Silicon Laboratories Inc.

400 West Cesar Chavez
Austin, TX 78701
USA

www.silabs.com

Dokumenter / Ressurser

SILICON LABS SDK 7.4.1.0 GA Zigbee Protocol Stack Software [pdfBrukerhåndbok
SDK 7.4.1.0 GA Zigbee Protocol Stack Software, SDK 7.4.1.0 GA, Zigbee Protocol Stack Software, Protocol Stack Software, Stack Software

Referanser

Brukerhåndbok

SILICON LABS SDK 7.4.1.0 GA Zigbee Protocol Stack Software

Produktinformasjon

Produktbruksinstruksjoner

FAQ

NØKKELFUNKSJONER

Nye komponenter

Tiltenkt oppførsel

Forbedringer

Faste problemer

Kjente problemer i gjeldende utgivelse

Utdaterte varer

Fjernede elementer

Multiprotokoll Gateway og RCP

Installasjon og bruk

Sikkerhetsinformasjon

KONTAKT

Dokumenter / Ressurser

Referanser

Legg igjen en kommentar

Avbryt svar