Οδηγίες SILICON LABS Zigbee EmberZ Net SDK

Η Silicon Labs είναι ο προμηθευτής της επιλογής για ΚΑΕ που αναπτύσσουν τη δικτύωση Zigbee στα προϊόντα τους. Η πλατφόρμα Silicon Labs Zigbee είναι η πιο ολοκληρωμένη, ολοκληρωμένη και πλούσια σε χαρακτηριστικά λύση Zigbee που είναι διαθέσιμη. Το Silicon Labs EmberZNet SDK περιέχει την υλοποίηση της προδιαγραφής Zigbee stack από την Silicon Labs.

ΒΑΣΙΚΑ ΧΑΡΑΚΤΗΡΙΣΤΙΚΑ

Zigbee

-250+ καταχωρήσεις στον πίνακα κλειδιού σύνδεσης APS
Υποστήριξη ZigbeeD σε Android 12 (v21.0.6113669) και Tizen (v0.1-13.1)

Υποστήριξη μονάδας xG26

Πολλαπλό πρωτόκολλο

Υποστήριξη ZigbeeD και OTBR στο OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT με ταυτόχρονη ακρόαση στο MG26 για SoC – GA

802.15.4 Ενοποιημένο στοιχείο προτεραιότητας προγραμματιστή ραδιοφώνου
Υποστήριξη συσκευασίας Debian για εφαρμογές κεντρικού υπολογιστή MP – Alpha

Νέα είδη

Σημαντικές Αλλαγές
Το μέγεθος του πίνακα κλειδιού σύνδεσης APS (που έχει διαμορφωθεί χρησιμοποιώντας SL_ZIGBEE_KEY_TABLE_SIZE) επεκτείνεται από 127 σε 254 καταχωρήσεις.

Προστίθεται υποστήριξη R23 για τη λειτουργία έναρξης λειτουργίας του δικτύου ZDD. Η λειτουργία σήραγγας είναι διαθέσιμη χωρίς υποστήριξη για περιπτώσεις χρήσης δικτύου παλαιού τύπου.

Τα στοιχεία Διεύθυνσης Δικτύου και Δημιουργός Δικτύου έχουν ενημερωθεί για να περιλαμβάνουν υποστήριξη για σύνδεση R23. Αυτές περιλαμβάνουν τις ακόλουθες σχετικές αλλαγές.
- Η προεπιλεγμένη πολιτική αιτήματος κλειδιού σύνδεσης κέντρου αξιοπιστίας (TCLK) έχει ενημερωθεί για τη δημιουργία νέων κλειδιών για κάθε συσκευή που ζητά. Ένα νέο κλειδί δημιουργείται κάθε φορά που οι συσκευές που ζητούν επιχειρούν να ενημερώσουν το Κλειδί συνδέσμου Κέντρου αξιοπιστίας τους.
- Λόγω της προηγούμενης αλλαγής πολιτικής TCLK, το στοιχείο Network Creator Security απαιτεί πλέον το στοιχείο Security Link Keys. Η αναβάθμιση των εφαρμογών θα ενημερωθεί για να συμμορφώνεται με αυτή τη νέα απαίτηση.
- Μια νέα διαμόρφωση,
  Το SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY προστίθεται για να επιτρέπεται η σύνδεση με χρήση ενός πυρήνα, κατακερματισμένου κλειδιού. Αυτή η ρύθμιση παραμέτρων βρίσκεται στο στοιχείο Network Creator Security. Η χρήση αυτής της πολιτικής επιτρέπει σε κάθε συνδεδεμένη συσκευή να λαμβάνει ένα μοναδικό TCLK μετά τη σύνδεση, αλλά οι επαναλαμβανόμενες προσπάθειες ενημέρωσης του TCLK δεν θα οδηγήσουν σε νέο κλειδί για τη συσκευή που ζητά. Αυτή η χρήση κατακερματισμένων κλειδιών συνδέσμου ήταν η προεπιλεγμένη πολιτική πριν από αυτήν την κυκλοφορία και η χρήση αυτής της πολιτικής επιτρέπει στο Κέντρο αξιοπιστίας να αποφύγει την εισαγωγή του στοιχείου Κλειδιά συνδέσμου ασφαλείας, το οποίο αποθηκεύει κλειδιά στο Flash.
  Σημείωμα: Η Silicon Labs δεν συνιστά τη χρήση αυτής της πολιτικής, καθώς αυτό εμποδίζει τη σύνδεση συσκευών από την κύλιση ή την ενημέρωση των TCLK τους.

Ένα νέο σύνολο ρυθμίσεων προστίθεται στο στοιχείο zigbee_ezsp_spi για να επιτραπεί η διαμόρφωση της κεντρικής συσκευής SPI και των διεπαφών ακροδεκτών της.
Ο πρώηνampστα έργα, συμπεριλαμβανομένου του έργου files (.slcps) και φάκελος έργου, μετονομάζονται σε οδηγίες ονομασίας της Silicon Labs και μετακινούνται στον κατάλογο "έργα".

Υποστήριξη νέας πλατφόρμας

Νέες ενότητες
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Νέοι πίνακες ραδιοφώνου
- MGM260P-RB4350A
- MGM260P-RB4351A
Νέο μέρος
- efr32xg27
Εξερεύνηση κιτ
- BRD2709A
- MGM260P-EK2713A

Νέα Τεκμηρίωση
Ένας νέος οδηγός χρήστη EZSP UG600 για εκδόσεις 8.1 και άνω.

Βελτιώσεις

Τα όρια SL_ZIGBEE_KEY_TABLE_SIZE επεκτάθηκαν έως και 254 καταχωρίσεις.
Προστέθηκαν zigbee_security_link_keys στο Z3Light.
Προστέθηκαν zigbee_security_link_keys στο zigbee_mp_z3_tc_z3_tc. Ενημερώθηκε επίσης το βασικό μέγεθος του πίνακα.
Αύξησε το μέγεθος του πίνακα κλειδιού Z3 Gateway (που θα οριστεί σε ncp) σε 20.

Διορθώθηκαν Θέματα

Γνωστά ζητήματα στην τρέχουσα έκδοση

Θέματα με έντονους χαρακτήρες προστέθηκαν από την προηγούμενη έκδοση. Εάν χάσατε μια κυκλοφορία, οι σημειώσεις πρόσφατης έκδοσης είναι διαθέσιμες στη διεύθυνση https://www.silabs.com/developers/zigbee-emberznet στην καρτέλα Tech Docs.

Καταργημένα στοιχεία

Το στοιχείο zigbee_watchdog_periodic_refresh δεν χρησιμοποιείται πλέον στο πλαίσιο εφαρμογής Zigbee και έχει καταργηθεί σε αυτήν την έκδοση. Ο χρονοδιακόπτης παρακολούθησης είναι απενεργοποιημένος από προεπιλογή για όλα τα sample εφαρμογές. Στο μέλλον θα προστεθεί στο SDK ένα βελτιωμένο στοιχείο παρακολούθησης.
Σημείωμα: Ενεργοποιήστε το χρονόμετρο παρακολούθησης με το στοιχείο διαμόρφωσης SL_LEGACY_HAL_DISABLE_WATCHDOG που έχει οριστεί σε 0 στην εφαρμογή σας

Περιορισμοί Δικτύου και Θεωρήσεις

Οι προεπιλεγμένες εφαρμογές Trust Center που συνοδεύουν αυτήν την έκδοση EmberZNet μπορούν να υποστηρίζουν πολλές συσκευές στο δίκτυο. Αυτός ο αριθμός καθορίζεται με βάση διάφορους παράγοντες, συμπεριλαμβανομένων των διαμορφωμένων μεγεθών πίνακα, της χρήσης NVM και άλλων τιμών χρόνου παραγωγής και χρόνου εκτέλεσης. Οι χρήστες που επιδιώκουν να δημιουργήσουν μεγάλα δίκτυα ενδέχεται να αντιμετωπίσουν προβλήματα πόρων όταν μεγαλώνουν το δίκτυο σε μεγαλύτερο μέγεθος από αυτό που μπορεί να υποστηρίξει η εφαρμογή. Για π.χample, μια συσκευή που ζητά κλειδί συνδέσμου Κέντρου αξιοπιστίας από το Κέντρο αξιοπιστίας μπορεί να ενεργοποιήσει μια επανάκληση sl_zigbee_af_zigbee_key_establishment_cb στο Κέντρο αξιοπιστίας με την κατάσταση h να έχει οριστεί σε SL_ZIGBEE_KEY_TABLE_FULL, υποδεικνύοντας ότι ο πίνακας κλειδιών δεν έχει χώρο για να προσθέσει μια νέα συσκευή ή αυτό το κλειδί για το Το NVM3 δεν έχει διαθέσιμο χώρο. Η Silicon Labs παρέχει τις ακόλουθες συστάσεις για χρήστες που επιθυμούν να δημιουργήσουν μεγάλα δίκτυα. Για εφαρμογές Trust Center, συνιστώνται οι ακόλουθες διαμορφώσεις. Αυτές οι συστάσεις δεν είναι εξαντλητικές και χρησιμεύουν ως βάση για εφαρμογές που σκοπεύουν να αναπτύξουν μεγάλα δίκτυα.

Συμπερίληψη του στοιχείου Πίνακας διευθύνσεων (zigbee_address_table), με
- το στοιχείο διαμόρφωσης SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE έχει οριστεί στο μέγεθος του επιθυμητού δικτύου
- η τιμή SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE ορίστηκε στο μέγιστο (4)

Συμπερίληψη του στοιχείου Security Link Keys (zigbee_security_link_keys), με
- Η τιμή SL_ZIGBEE_KEY_TABLE_SIZE ορίζεται στο μέγεθος του δικτύου
Τα ακόλουθα στοιχεία διαμόρφωσης ρυθμίζονται στο μέγεθος του επιθυμητού δικτύου
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, όπως βρίσκεται στο στοιχείο Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, όπως βρίσκεται στο στοιχείο δρομολόγησης πηγής, εάν χρησιμοποιείται δρομολόγηση πηγής
Προσαρμογή των NVM3_DEFAULT_NVM_SIZE και NVM3_DEFAULT_CACHE_SIZE σύμφωνα με τη χρήση του NVM3
- Π.χ. μεγέθη δικτύου μεγαλύτερα από 65 κόμβους πιθανότατα απαιτούν μέγεθος NVM3 64K. Το προεπιλεγμένο μέγεθος NVM3 στο Silicon Labs Zigbee sampοι εφαρμογές είναι 32K. Οι εφαρμογές που χρησιμοποιούν περισσότερο το NVM ενδέχεται να απαιτούν ακόμη μεγαλύτερη προσαρμογή αυτής της τιμής.
- Μεγάλα δίκτυα έως 65 κόμβους μπορεί να χρειάζονται μέγεθος κρυφής μνήμης NVM3 1200 byte. Τα αναπτυσσόμενα δίκτυα μεγαλύτερα από αυτό ενδέχεται να απαιτούν διπλασιασμό αυτής της τιμής στα 2400 byte.

Αυτές οι προσαρμογές ισχύουν μόνο για το Κέντρο εμπιστοσύνης

Multiprotocol Gateway και RCP

Νέα είδη
Ενεργοποιημένη υποστήριξη GA SoC για BLE DMP με Zigbee + Openthread CMP με ταυτόχρονη ακρόαση σε μέρη xG26. Έχει προστεθεί υποστήριξη Debian alpha για εφαρμογές Zigbeed, OTBR και Z3Gateway. Το Zigbeed και το OTBR παρέχονται επίσης σε μορφή πακέτου DEB για την επιλεγμένη πλατφόρμα αναφοράς (Raspberry PI 4). Δείτε Εκτέλεση Zigbee, OpenThread και Bluetooth ταυτόχρονα σε κεντρικό υπολογιστή Linux με συν-επεξεργαστή πολλαπλών πρωτοκόλλων, που βρίσκεται στο docs.silabs.com, για λεπτομέρειες. Προστέθηκε υποστήριξη Zigbeed για Tizen-0.1-13.1 για arm32 και aarch64 καθώς και Android 12 για aarch64. Περισσότερες πληροφορίες για το Zigbeed μπορείτε να βρείτε στη διεύθυνση docs.silabs.com. Προστέθηκε το νέο στοιχείο "802.15.4 Ενοποιημένη προτεραιότητα προγραμματιστή ραδιοφώνου". Αυτό το στοιχείο χρησιμοποιείται για τη διαμόρφωση των προτεραιοτήτων ραδιοφώνου μιας στοίβας 15.4. Το στοιχείο απαιτεί επίσης το νέο στοιχείο "radio_priority_configurator". Αυτό το στοιχείο επιτρέπει στα έργα να χρησιμοποιούν το εργαλείο Radio Priority Configurator στο Simplicity Studio για να διαμορφώσουν τα επίπεδα προτεραιότητας ραδιοφώνου των στοίβων που το απαιτούν.

Βελτιώσεις
Σημείωση εφαρμογής Η εκτέλεση Zigbee, OpenThread και Bluetooth ταυτόχρονα σε κεντρικό υπολογιστή Linux με συν-επεξεργαστή πολλαπλών πρωτοκόλλων (AN1333) έχει μετακινηθεί στο docs.silabs.com. Η υποστήριξη OpenWRT είναι πλέον ποιότητα GA. Η υποστήριξη OpenWRT έχει προστεθεί για εφαρμογές Zigbee, OTBR και Z3Gateway. Το Zigbeed και το OTBR παρέχονται σε μορφή πακέτου IPK για την πλατφόρμα αναφοράς (Raspberry PI 4). Δείτε Εκτέλεση Zigbee, OpenThread και Bluetooth ταυτόχρονα σε κεντρικό υπολογιστή Linux με συν-επεξεργαστή πολλαπλών πρωτοκόλλων, που βρίσκεται στο docs.silabs.com, για λεπτομέρειες.

Διορθώθηκαν Θέματα

Γνωστά ζητήματα στην τρέχουσα έκδοση
Θέματα με έντονους χαρακτήρες προστέθηκαν από την προηγούμενη έκδοση. Εάν χάσατε μια κυκλοφορία, υπάρχουν διαθέσιμες σημειώσεις πρόσφατης έκδοσηςhttps://www.silabs.com/developers/simplicity-software-development-kit.

Καταργημένα στοιχεία
Το "Multiprotocol Container" που είναι προς το παρόν διαθέσιμο στο DockerHub (siliconlabsinc/multiprotocol) θα καταργηθεί σε μια επερχόμενη κυκλοφορία. Το κοντέινερ δεν θα ενημερώνεται πλέον και δεν θα είναι δυνατή η απόσυρσή του από το DockerHub. Τα πακέτα που βασίζονται στο Debian για cpcd, ZigBee και ot-br-posix, μαζί με εγγενώς δημιουργημένα και μεταγλωττισμένα έργα, θα αντικαταστήσουν τη λειτουργικότητα που χάθηκε με την κατάργηση του κοντέινερ.

Χρήση αυτής της έκδοσης

Αυτή η έκδοση περιέχει τα ακόλουθα:

Στοίβα Zigbee
Zigbee Application Framework
Ζίγκμπι Σample Εφαρμογές

Για περισσότερες πληροφορίες σχετικά με το Zigbee και το EmberZNet SDK, ανατρέξτε στο UG103.02: Zigbee Fundamentals. Εάν είστε χρήστης για πρώτη φορά, ανατρέξτε στο QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 and Higher, για οδηγίες σχετικά με τη διαμόρφωση του περιβάλλοντος ανάπτυξής σας, τη δημιουργία και την αναλαμπή ωςampτην αίτηση και τις αναφορές τεκμηρίωσης που δείχνουν τα επόμενα βήματα.

Εγκατάσταση και χρήση
Το Zigbee EmberZNet SDK παρέχεται ως μέρος του Simplicity SDK, της σουίτας Silicon Labs SDK. Για να ξεκινήσετε γρήγορα με το Simplicity SDK, εγκαταστήστε το Simplicity Studio 5, το οποίο θα ρυθμίσει το περιβάλλον ανάπτυξης και θα σας καθοδηγήσει στην εγκατάσταση του Simplicity SDK. Το Simplicity Studio 5 περιλαμβάνει όλα όσα χρειάζονται για την ανάπτυξη προϊόντων IoT με συσκευές Silicon Labs, συμπεριλαμβανομένου ενός προγράμματος εκκίνησης πόρων και έργου, εργαλείων διαμόρφωσης λογισμικού, πλήρους IDE με αλυσίδα εργαλείων GNU και εργαλείων ανάλυσης. Οδηγίες εγκατάστασης παρέχονται στον ηλεκτρονικό Οδηγό χρήσης Simplicity Studio 5. Εναλλακτικά, το Simplicity SDK μπορεί να εγκατασταθεί με μη αυτόματο τρόπο με λήψη ή κλωνοποίηση του πιο πρόσφατου από το GitHub. Βλέπω https://github.com/SiliconLabs/simplicity_sdk για περισσότερες πληροφορίες. Το Simplicity Studio εγκαθιστά το Simplicity SDK από προεπιλογή σε:

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

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

Η τεκμηρίωση ειδικά για την έκδοση SDK εγκαθίσταται με το SDK. Πρόσθετες πληροφορίες μπορούν συχνά να βρεθούν στα άρθρα της γνωσιακής βάσης (KBA). Αναφορές API και άλλες πληροφορίες σχετικά με αυτήν και προηγούμενες εκδόσεις είναι διαθέσιμες https://docs.silabs.com/.

Πληροφορίες Ασφαλείας
Ενσωμάτωση Ασφαλούς Θησαυροφυλάκιου
Για εφαρμογές που επιλέγουν να αποθηκεύουν τα κλειδιά με ασφάλεια χρησιμοποιώντας το στοιχείο Secure Key Storage σε εξαρτήματα Secure Vault-High, ο ακόλουθος πίνακας δείχνει τα προστατευμένα κλειδιά και τα χαρακτηριστικά προστασίας αποθήκευσης που διαχειρίζεται το στοιχείο Zigbee Security Manager.Τα τυλιγμένα κλειδιά που επισημαίνονται ως "Μη Εξαγώγιμα" μπορούν να χρησιμοποιηθούν αλλά δεν μπορούν να χρησιμοποιηθούν viewέκδοση ή κοινή χρήση κατά το χρόνο εκτέλεσης. Τα τυλιγμένα κλειδιά που επισημαίνονται ως "Εξαγώγιμα" μπορούν να χρησιμοποιηθούν ή να μοιραστούν κατά το χρόνο εκτέλεσης, αλλά παραμένουν κρυπτογραφημένα ενώ αποθηκεύονται στο Flash. Οι εφαρμογές χρήστη δεν χρειάζεται ποτέ να αλληλεπιδρούν με τα περισσότερα από αυτά τα κλειδιά. Τα υπάρχοντα API για τη διαχείριση των κλειδιών του πίνακα κλειδιών σύνδεσης ή των κλειδιών μεταβατικής χρήσης εξακολουθούν να είναι διαθέσιμα στην εφαρμογή χρήστη και δρομολογούνται μέσω του στοιχείου Zigbee Security Manager.

Συμβουλές ασφαλείας
Για να εγγραφείτε στο Security Advisories, συνδεθείτε στην πύλη πελατών της Silicon Labs και, στη συνέχεια, επιλέξτε Αρχική σελίδα λογαριασμού. Κάντε κλικ στο HOME για να μεταβείτε στην αρχική σελίδα της πύλης και, στη συνέχεια, κάντε κλικ στο πλακίδιο Διαχείριση ειδοποιήσεων. Βεβαιωθείτε ότι είναι επιλεγμένες οι "Συμβουλευτικές Ειδοποιήσεις Λογισμικού/Ασφάλειας & Ειδοποιήσεις Αλλαγών Προϊόντος (PCN)" και ότι έχετε εγγραφεί τουλάχιστον για την πλατφόρμα και το πρωτόκολλό σας. Κάντε κλικ στην Αποθήκευση για να αποθηκεύσετε τυχόν αλλαγές.

Υποστήριξη
Οι πελάτες του Development Kit δικαιούνται εκπαίδευση και τεχνική υποστήριξη. Χρησιμοποιήστε το Silicon Laboratories Zigbee web σελίδα για να λάβετε πληροφορίες σχετικά με όλα τα προϊόντα και τις υπηρεσίες της Silicon Labs Zigbee και να εγγραφείτε για υποστήριξη προϊόντων. Μπορείτε να επικοινωνήσετε με την υποστήριξη της Silicon Laboratories στη διεύθυνση http://www.silabs.com/support.

Πιστοποίηση Zigbee
Η έκδοση Ember ZNet 8.1 έχει εγκριθεί για Zigbee Compliant Platform για αρχιτεκτονικές SoC, NC, P και RCP, υπάρχει ένα αναγνωριστικό πιστοποίησης ZCP που συνδέεται με αυτήν την έκδοση, ελέγξτε το CSA website εδώ:
https://csa-iot.org/csa-iot_products/.

Λάβετε υπόψη ότι η πιστοποίηση ZCP είναι filed δημοσιεύσετε την κυκλοφορία και χρειάζονται μερικές εβδομάδες πριν λάβετε υπόψη την CSA webτοποθεσία. Για οποιαδήποτε περαιτέρω απορία, επικοινωνήστε με την υποστήριξη της Silicon Laboratories στη διεύθυνση http://www.silabs.com/support.

Συχνές ερωτήσεις

Ε: Πώς μπορώ να ενημερώσω το μέγεθος του πίνακα κλειδιού σύνδεσης APS στο SDK;
Α: Το μέγεθος του πίνακα κλειδιού σύνδεσης APS μπορεί να διαμορφωθεί χρησιμοποιώντας την παράμετρο SL_ZIGBEE_KEY_TABLE_SIZE. Στην έκδοση 8.1, έχει επεκταθεί από 127 σε 254 καταχωρήσεις.

Ε: Ποιες είναι οι βελτιώσεις στην έκδοση 8.1;
Α: Η έκδοση 8.1 φέρνει βελτιώσεις όπως η επέκταση του μεγέθους του πίνακα κλειδιού σύνδεσης APS, η μετονομασία στοιχείων, η προσθήκη προστασίας mutex για την ουρά συμβάντων Athe pp Framework και πολλά άλλα. Ανατρέξτε στις σημειώσεις έκδοσης για μια λεπτομερή λίστα βελτιώσεων.

Ε: Πώς μπορώ να χειριστώ διορθωμένα προβλήματα στο SDK;
Α: Διορθώθηκαν προβλήματα στο SDK, συμπεριλαμβανομένης της επίλυσης πιθανών προβλημάτων με τη διαμόρφωση του μεγέθους του πίνακα γειτονικών, τη μετονομασία στοιχείων, τη διόρθωση της επιβάρυνσης της διαδρομής πηγής, τον χειρισμό εντολών ZCL και άλλα. Βεβαιωθείτε ότι έχετε ενημερώσει στην πιο πρόσφατη έκδοση για να επωφεληθείτε από αυτές τις επιδιορθώσεις.

Έγγραφα / Πόροι

SILICON LABS Zigbee EmberZ Net SDK [pdf] Οδηγίες
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Αναφορές

Εγχειρίδιο χρήστη

SILICON LABS Zigbee EmberZ Net SDK

Προδιαγραφές

Πληροφορίες προϊόντος