SILICON LABS Zigbee EmberZ Net SDK Talimatları

Silicon Labs, Zigbee ağını ürünlerine dönüştüren OEM'ler için tercih edilen tedarikçidir. Silicon Labs Zigbee platformu, mevcut en entegre, eksiksiz ve özellik açısından zengin Zigbee çözümüdür. Silicon Labs EmberZNet SDK, Silicon Labs'ın Zigbee yığını spesifikasyonunun uygulamasını içerir.

ANA ÖZELLİKLER

Zigbee

-APS bağlantı anahtarı tablosunda 250+ giriş
Android 12 (v21.0.6113669) ve Tizen'de (v0.1-13.1) ZigbeeD desteği

xG26 Modül desteği

çoklu protokol

OpenWRT'de ZigbeeD ve OTBR desteği – GA
SoC için MG26'da Eş Zamanlı Dinleme ile DMP BLE + CMP ZB ve Matter/OT – GA

802.15.4 Birleşik radyo zamanlayıcı öncelik bileşeni
MP ana bilgisayar uygulamaları için Debian paketleme desteği – Alpha

Yeni Ürünler

Önemli Değişiklikler
APS bağlantı anahtarı tablosu boyutu (SL_ZIGBEE_KEY_TABLE_SIZE kullanılarak yapılandırılır) 127'den 254 girdiye genişletildi.

ZDD Ağ devreye alma işlevselliği için R23 desteği eklendi. Tünelleme işlevselliği, Eski Ağ kullanım durumları için destek olmadan kullanılabilir.

Ağ Yönlendirme ve Ağ Oluşturucu bileşenleri, R23 katılımına yönelik desteği içerecek şekilde güncellendi. Bunlar aşağıdaki ilgili değişiklikleri içerir.
- Varsayılan Trust Center Bağlantı Anahtarı (TCLK) istek politikası, her talep eden cihaz için yeni anahtarlar üretecek şekilde güncellendi. Talep eden cihazlar Trust Center Bağlantı Anahtarlarını güncellemeye her çalıştığında yeni bir anahtar üretilir.
- Önceki TCLK politika değişikliği nedeniyle, Ağ Oluşturucu Güvenlik bileşeni artık Güvenlik Bağlantı Anahtarları bileşenini gerektirir. Yükseltme yapılan uygulamalar bu yeni gereksinime uyacak şekilde güncellenecektir.
- Yeni bir yapılandırma,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY, çekirdek, karma anahtar kullanılarak katılmaya izin vermek için eklenmiştir. Bu yapılandırma, Ağ Oluşturucu Güvenlik bileşeni altında bulunur. Bu politikanın kullanımı, katılan her cihazın katılma sonrası benzersiz bir TCLK almasına izin verir, ancak TCLK'yi güncellemek için tekrarlanan girişimler, talep eden cihaz için yeni bir anahtarla sonuçlanmaz. Karma bağlantı anahtarlarının bu şekilde kullanılması, bu sürümden önce varsayılan politikaydı ve bu politikanın kullanımı, Güven Merkezi'nin anahtarları Flash'ta kaydeden Güvenlik Bağlantı Anahtarları bileşenini getirmekten kaçınmasını sağlar.
  Not: Silicon Labs, katılan cihazların TCLK'larını yüklemesini veya güncellemesini engellediği için bu politikanın kullanılmasını önermez.

Ana bilgisayar SPI aygıtının ve pin arayüzlerinin yapılandırılmasına olanak sağlamak için zigbee_ezsp_spi bileşenine yeni bir yapılandırma kümesi eklendi.
Eski sevgiliampProjeler, proje dahil files (.slcps) ve proje klasörü, Silicon Labs adlandırma yönergelerine göre yeniden adlandırıldı ve “projeler” dizini altına taşındı.

Yeni Platform Desteği

Yeni modüller
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Yeni radyo panoları
- MGM260P-RB4350A
- MGM260P-RB4351A
Yeni bölüm
- efr32xg27
Gezgin Kiti
- BRD2709A
- MGM260P-EK2713A

Yeni Belgeler
600 ve üzeri sürümler için yeni EZSP kullanıcı kılavuzları UG8.1.

İyileştirmeler

SL_ZIGBEE_KEY_TABLE_SIZE sınırları 254 girdiye kadar genişletildi.
Z3Light'a zigbee_security_link_keys eklendi.
zigbee_mp_z3_tc_z3_tc'ye zigbee_security_link_keys eklendi. Anahtar tablosu boyutu da güncellendi.
Z3 Gateway anahtar tablosu boyutu (ncp olarak ayarlanacak) 20'ye çıkarıldı.

Düzeltilen Sorunlar

Mevcut Sürümdeki Bilinen Sorunlar

Kalın harflerle yazılan konular önceki sürümden bu yana eklenmiştir. Bir sürümü kaçırdıysanız, en son sürüm notlarına şuradan ulaşabilirsiniz: https://www.silabs.com/developers/zigbee-emberznet Teknik Belgeler sekmesinde.

Kullanımdan Kaldırılan Öğeler

Zigbee_watchdog_periodic_refresh bileşeni artık Zigbee uygulama çerçevesinde kullanılmıyor ve bu sürümde kullanım dışı bırakıldı. Bekçi zamanlayıcısı tüm s için varsayılan olarak devre dışıdırampGelecekte SDK'ya geliştirilmiş bir watchdog bileşeni eklenecek.
Not: Uygulamanızda SL_LEGACY_HAL_DISABLE_WATCHDOG yapılandırma öğesini 0 olarak ayarlayarak bekçi zamanlayıcısını etkinleştirin

Ağ Sınırlamaları ve Hususlar

Bu EmberZNet sürümüyle birlikte gelen varsayılan Trust Center uygulamaları ağdaki çeşitli cihazları destekleyebilir. Bu sayı, yapılandırılmış tablo boyutları, NVM kullanımı ve diğer nesil zamanı ve çalışma zamanı değerleri dahil olmak üzere çeşitli faktörlere göre belirlenir. Büyük ağlar oluşturmak isteyen kullanıcılar, ağı uygulamanın destekleyebileceğinden daha büyük hale getirirken kaynak sorunlarıyla karşılaşabilirler. Örneğinample, Güven Merkezi'nden bir Güven Merkezi Bağlantı Anahtarı isteyen bir cihaz, h durumu SL_ZIGBEE_KEY_TABLE_FULL olarak ayarlandığında Güven Merkezi'nde sl_zigbee_af_zigbee_key_establishment_cb geri aramasını tetikleyebilir; bu, anahtar tablosunun talep eden cihaz için yeni bir anahtar eklemek için yer olmadığını veya NVM3'ün kullanılabilir alanı olmadığını gösterir. Silicon Labs, büyük ağlar oluşturmak isteyen kullanıcılar için aşağıdaki önerileri sağlar. Güven Merkezi uygulamaları için aşağıdaki yapılandırmalar önerilir. Bu öneriler kapsamlı değildir ve büyük ağlar oluşturmayı amaçlayan uygulamalar için bir temel oluşturur.

Adres Tablosu bileşeninin (zigbee_address_table) dahil edilmesi
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE yapılandırma öğesi istenen ağın boyutuna ayarlandı
- SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE değeri maksimuma (4) ayarlandı

Güvenlik Bağlantı Anahtarları bileşeninin (zigbee_security_link_keys) eklenmesi
- SL_ZIGBEE_KEY_TABLE_SIZE değeri ağın boyutuna ayarlanır
Aşağıdaki yapılandırma öğeleri, istenen ağın boyutuna göre ayarlanır
- Zigbee Pro Stack bileşeninde bulunan SL_ZIGBEE_BROADCAST_TABLE_SIZE
- Kaynak yönlendirme kullanılıyorsa, Kaynak yönlendirme bileşeninde bulunan SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE
NVM3 kullanımına göre NVM3_DEFAULT_NVM_SIZE ve NVM3_DEFAULT_CACHE_SIZE'ın ayarlanması
- Örn. 65 düğümden büyük ağ boyutları muhtemelen 3K'lık bir NVM64 boyutu gerektirir. Silicon Labs Zigbee'deki varsayılan NVM3 boyutuample uygulamaları 32K'dır. NVM'yi daha yoğun kullanan uygulamalar bu değeri daha da yükseltmeyi gerektirebilir.
- 65 düğüme kadar olan büyük ağlar, 3 baytlık bir NVM1200 önbellek boyutuna ihtiyaç duyabilir; bundan daha büyük büyüyen ağlar, bu değerin 2400 bayta çıkarılmasını gerektirebilir.

Bu ayarlamalar yalnızca Güven Merkezi için geçerlidir

Çok Protokollü Ağ Geçidi ve RCP

Yeni Ürünler
xG26 parçalarında eşzamanlı dinleme ile Zigbee + Openthread CMP ile BLE DMP için GA SoC desteği etkinleştirildi. Zigbeed, OTBR ve Z3Gateway uygulamaları için Debian alpha desteği eklendi. Zigbeed ve OTBR, seçilen referans platformu (Raspberry PI 4) için DEB paket biçiminde de sağlanır. Çok Protokollü Eş İşlemcili Bir Linux Ana Bilgisayarında Zigbee, OpenThread ve Bluetooth'u Eş Zamanlı Çalıştırma konusuna bakın, şu adreste bulunabilir: docs.silabs.com, ayrıntılar için. Arm0.1 ve aarch13.1 için Tizen-32-64 ve aarch12 için Android 64 için Zigbeed desteği eklendi. Zigbeed hakkında daha fazla bilgi şu adreste bulunabilir: docs.silabs.com. Yeni “802.15.4 Birleşik radyo zamanlayıcı önceliği” bileşeni eklendi. Bu bileşen, 15.4 yığınının radyo önceliklerini yapılandırmak için kullanılır. Bileşen ayrıca yeni “radio_priority_configurator” bileşenini gerektirir. Bu bileşen, projelerin Simplicity Studio'daki Radyo Öncelik Yapılandırıcı aracını kullanarak, onu gerektiren yığınların radyo öncelik seviyelerini yapılandırmasına olanak tanır.

İyileştirmeler
Uygulama notu Çok Protokollü Eş İşlemcili (AN1333) bir Linux Ana Bilgisayarında Zigbee, OpenThread ve Bluetooth'u Eş Zamanlı Olarak Çalıştırma şuraya taşındı: docs.silabs.com. OpenWRT desteği artık GA kalitesindedir. Zigbee, OTBR ve Z3Gateway uygulamaları için OpenWRT desteği eklendi. Zigbeed ve OTBR, referans platformu (Raspberry PI 4) için IPK paket formatında da sağlanır. Çok Protokollü Eş İşlemcili Bir Linux Ana Bilgisayarında Zigbee, OpenThread ve Bluetooth'u Eş Zamanlı Çalıştırma konusuna bakın, şu adreste bulunabilir: docs.silabs.com, detaylar için.

Düzeltilen Sorunlar

Mevcut Sürümdeki Bilinen Sorunlar
Kalın yazıyla gösterilen sorunlar önceki sürümden sonra eklenmiştir. Bir sürümü kaçırdıysanız, son sürüm notları şu adreste mevcuttur:https://www.silabs.com/developers/simplicity-software-development-kit.

Kullanımdan Kaldırılan Öğeler
Şu anda DockerHub'da (siliconlabsinc/multiprotocol) bulunan "Çoklu Protokol Konteyneri" yaklaşan bir sürümde kullanımdan kaldırılacak. Konteyner artık güncellenmeyecek ve DockerHub'dan çekilemeyecek. cpcd, ZigBee ve ot-br-posix için Debian tabanlı paketler, yerel olarak oluşturulmuş ve derlenmiş projelerle birlikte, konteynerin kaldırılmasıyla kaybolan işlevselliğin yerini alacak.

Bu Sürümü Kullanma

Bu sürüm aşağıdakileri içerir:

Zigbee yığını
Zigbee Uygulama Çerçevesi
Zigbee SampUygulamalar

Zigbee ve EmberZNet SDK hakkında daha fazla bilgi için bkz. UG103.02: Zigbee Fundamentals. İlk kez kullanıcıysanız, geliştirme ortamınızı yapılandırma, oluşturma ve flaşlama talimatları için QSG180: SDK 7.0 ve Üzeri için Zigbee EmberZNet Hızlı Başlangıç Kılavuzu'na bakın.ampUygulama ve dokümantasyon referansları ext adımlarına işaret ediyor.

Kurulum ve Kullanım
Zigbee EmberZNet SDK, Silicon Labs SDK'larının paketi olan Simplicity SDK'nın bir parçası olarak sağlanır. Simplicity SDK'yı hızla kullanmaya başlamak için, geliştirme ortamınızı ayarlayacak ve Simplicity SDK kurulumunda size yol gösterecek olan Simplicity Studio 5'i yükleyin. Simplicity Studio 5, kaynak ve proje başlatıcısı, yazılım yapılandırma araçları, GNU araç zincirine sahip tam IDE ve analiz araçları dahil olmak üzere Silicon Labs cihazlarıyla IoT ürün geliştirme için gereken her şeyi içerir. Kurulum talimatları çevrimiçi Simplicity Studio 5 Kullanıcı Kılavuzu'nda verilmiştir. Alternatif olarak, Simplicity SDK, GitHub'dan en son sürümü indirerek veya kopyalayarak manuel olarak yüklenebilir. Bkz. https://github.com/SiliconLabs/simplicity_sdk daha fazla bilgi için. Simplicity Studio, varsayılan olarak Simplicity SDK'sını şuraya yükler:

(Windows): C:\Kullanıcılar\\SimplicityStudio\SDK'lar\simplicity_sdk

(MacOS): /Kullanıcılar//SimplicityStudio/SDK'lar/simplicity_sdk

SDK sürümüne özgü belgeler SDK ile birlikte yüklenir. Ek bilgiler genellikle bilgi tabanı makalelerinde (KBA'lar) bulunabilir. API referansları ve bu ve önceki sürümler hakkında diğer bilgiler şu adreste mevcuttur: https://docs.silabs.com/.

Güvenlik Bilgileri
Güvenli Kasa Entegrasyonu
Anahtarları Secure Vault-High parçalarında Güvenli Anahtar Depolama bileşenini kullanarak güvenli bir şekilde saklamayı seçen uygulamalar için aşağıdaki tablo, Zigbee Güvenlik Yöneticisi bileşeninin yönettiği korumalı anahtarları ve bunların depolama koruma özelliklerini gösterir."Dışa Aktarılamaz" olarak işaretlenen sarmalanmış anahtarlar kullanılabilir ancak kullanılamaz. viewÇalışma zamanında düzenlenebilir veya paylaşılabilir. "Dışa Aktarılabilir" olarak işaretlenen sarılmış anahtarlar çalışma zamanında kullanılabilir veya paylaşılabilir ancak Flash'ta saklanırken şifreli kalır. Kullanıcı uygulamalarının bu anahtarların çoğuyla etkileşime girmesine asla gerek yoktur. Bağlantı Anahtarı Tablosu anahtarlarını veya Geçici Anahtarları yönetmek için mevcut API'ler hala kullanıcı uygulaması tarafından kullanılabilir ve Zigbee Güvenlik Yöneticisi bileşeni aracılığıyla yönlendirilir.

Güvenlik Önerileri
Güvenlik Önerilerine abone olmak için Silicon Labs müşteri portalında oturum açın ve ardından Hesap Ana Sayfası'nı seçin. Portal ana sayfasına gitmek için GİRİŞ'e tıklayın ve ardından Bildirimleri Yönet kutucuğuna tıklayın. 'Yazılım/Güvenlik Danışma Bildirimleri ve Ürün Değişiklik Bildirimleri (PCN'ler)' öğesinin işaretli olduğundan ve platformunuz ve protokolünüz için en azından abone olduğunuzdan emin olun. Değişiklikleri kaydetmek için Kaydet'e tıklayın.

Destek
Geliştirme Kiti müşterileri eğitim ve teknik destek almaya hak kazanır. Silikon Laboratuvarları Zigbee'yi kullanın web tüm Silicon Labs Zigbee ürünleri ve hizmetleri hakkında bilgi edinmek ve ürün desteğine kaydolmak için sayfaya gidin. Silicon Laboratories desteğiyle şu adresten iletişime geçebilirsiniz: http://www.silabs.com/support.

Zigbee Sertifikasyonu
Ember ZNet 8.1 sürümü, SoC, NC, P ve RCP mimarileri için Zigbee Uyumlu Platform için onaylanmıştır; bu sürüme bağlı bir ZCP sertifika kimliği vardır, lütfen CSA'yı kontrol edin website burada:
https://csa-iot.org/csa-iot_products/.

Lütfen ZCP sertifikasının filed sürümü yayınlar ve CSA'ya yansıması birkaç hafta sürer website. Daha fazla sorunuz varsa lütfen Silicon Laboratories destek ekibiyle iletişime geçin http://www.silabs.com/support.

SSS

S: SDK'da APS bağlantı anahtarı tablo boyutunu nasıl güncellerim?
A: APS bağlantı anahtarı tablosu boyutu SL_ZIGBEE_KEY_TABLE_SIZE parametresi kullanılarak yapılandırılabilir. 8.1 sürümünde 127'den 254 girdiye genişletilmiştir.

S: 8.1 sürümündeki yenilikler nelerdir?
A: Sürüm 8.1, APS bağlantı anahtarı tablosu boyutunu genişletme, bileşenleri yeniden adlandırma, Athe pp Framework olay kuyruğu için mutex koruması ekleme ve daha fazlası gibi geliştirmeler getiriyor. Geliştirmelerin ayrıntılı bir listesi için sürüm notlarına bakın.

S: SDK'daki düzeltilen sorunları nasıl çözerim?
A: Komşu tablo boyutu yapılandırmasındaki olası sorunları çözme, bileşenleri yeniden adlandırma, kaynak rotası ek yükünü düzeltme, ZCL komutlarını işleme ve daha fazlası dahil olmak üzere SDK'daki sorunlar düzeltildi. Bu düzeltmelerden yararlanmak için en son sürüme güncellediğinizden emin olun.

Belgeler / Kaynaklar

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

Referanslar

Kullanıcı Kılavuzu

SILICON LABS Zigbee EmberZ Net SDK

Özellikler

Ürün Bilgileri