SILICON LABS Zigbee EmberZ Net SDK Arahan

Silicon Labs ialah vendor pilihan untuk OEM yang membangunkan rangkaian Zigbee ke dalam produk mereka. Platform Zigbee Silicon Labs ialah penyelesaian Zigbee yang paling bersepadu, lengkap dan kaya ciri yang tersedia. Silicon Labs EmberZNet SDK mengandungi pelaksanaan Silicon Labs bagi spesifikasi tindanan Zigbee.

CIRI-CIRI UTAMA

Zigbee

-250+ entri dalam jadual kunci pautan APS
Sokongan ZigbeeD pada Android 12 (v21.0.6113669) dan Tizen (v0.1-13.1)

Sokongan modul xG26

Multiprotokol

Sokongan ZigbeeD dan OTBR pada OpenWRT – GA
DMP BLE + CMP ZB & Matter/OT dengan Mendengar Serentak pada MG26 untuk SoC – GA

802.15.4 Komponen keutamaan penjadual radio bersatu
Sokongan pembungkusan Debian untuk aplikasi hos MP – Alpha

Barang Baru

Perubahan Penting
Saiz jadual kekunci pautan APS (dikonfigurasikan menggunakan SL_ZIGBEE_KEY_TABLE_SIZE) dikembangkan daripada 127 kepada 254 entri.

Sokongan R23 ditambah untuk fungsi pentauliahan Rangkaian ZDD. Fungsi terowong tersedia tanpa sokongan untuk kes penggunaan Legacy Network.

Komponen Pemandu Rangkaian dan Pencipta Rangkaian telah dikemas kini untuk menyertakan sokongan untuk penyertaan R23. Ini termasuk perubahan berkaitan berikut.
- Dasar permintaan Kunci Pautan Pusat Amanah (TCLK) lalai telah dikemas kini untuk menjana kunci baharu bagi setiap peranti yang meminta. Kunci baharu dijana setiap kali peranti yang meminta cuba mengemas kini Kunci Pautan Pusat Amanah mereka.
- Disebabkan oleh perubahan dasar TCLK sebelumnya, komponen Keselamatan Pencipta Rangkaian kini memerlukan komponen Kunci Pautan Keselamatan. Peningkatan aplikasi akan dikemas kini untuk mematuhi keperluan baharu ini.
- Konfigurasi baru,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY ditambahkan untuk membenarkan penyertaan menggunakan kunci teras yang dicincang. Konfigurasi ini ditemui di bawah komponen Keselamatan Pencipta Rangkaian. Penggunaan dasar ini membolehkan setiap peranti yang disambungkan menerima TCLK selepas penyertaan yang unik, tetapi percubaan berulang untuk mengemas kini TCLK tidak akan menghasilkan kunci baharu untuk peranti yang meminta. Penggunaan kunci pautan dicincang ini merupakan dasar lalai sebelum keluaran ini dan penggunaan dasar ini membolehkan Pusat Amanah mengelak daripada membawa masuk komponen Kunci Pautan Keselamatan, yang menyimpan kunci dalam Flash.
  Nota: Silicon Labs tidak mengesyorkan penggunaan dasar ini, kerana ini menghalang peranti daripada bergolek, atau mengemas kini, TCLK mereka.

Set konfigurasi baharu ditambahkan pada komponen zigbee_ezsp_spi untuk membenarkan konfigurasi peranti SPI hos dan antara muka pinnya.
bekas ituample projek, termasuk projek files (.slcps) dan folder projek, dinamakan semula kepada garis panduan penamaan Silicon Labs dan dialihkan di bawah direktori "projek".

Sokongan Platform Baharu

Modul baru
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Papan radio baharu
- MGM260P-RB4350A
- MGM260P-RB4351A
Bahagian baru
- efr32xg27
Kit Penjelajah
- BRD2709A
- MGM260P-EK2713A

Dokumentasi Baharu
Panduan pengguna EZSP baharu UG600 untuk keluaran 8.1 dan ke atas.

Penambahbaikan

Had SL_ZIGBEE_KEY_TABLE_SIZE dikembangkan sehingga 254 entri.
Menambahkan zigbee_security_link_keys pada Z3Light.
Menambahkan zigbee_security_link_keys pada zigbee_mp_z3_tc_z3_tc. Mengemas kini saiz jadual utamanya juga.
Meningkatkan saiz jadual kunci Gerbang Z3 (yang akan ditetapkan kepada ncp) kepada 20.

Isu Tetap

Isu Diketahui dalam Keluaran Semasa

Isu dalam huruf tebal telah ditambahkan sejak keluaran sebelumnya. Jika anda terlepas keluaran, nota keluaran terbaru boleh didapati di https://www.silabs.com/developers/zigbee-emberznet dalam tab Dokumen Teknologi.

Item Dihentikan

Komponen zigbee_watchdog_periodic_refresh tidak lagi digunakan dalam rangka kerja aplikasi Zigbee dan tidak digunakan lagi dalam keluaran ini. Pemasa pengawas dilumpuhkan secara lalai untuk semua sample aplikasi. Komponen pengawas yang dipertingkatkan akan ditambahkan pada SDK pada masa hadapan.
Nota: Dayakan pemasa pengawas dengan item konfigurasi SL_LEGACY_HAL_DISABLE_WATCHDOG ditetapkan kepada 0 dalam aplikasi anda

Had dan Pertimbangan Rangkaian

Aplikasi Pusat Amanah lalai yang dihantar bersama keluaran EmberZNet ini mampu menyokong beberapa peranti pada rangkaian. Nombor ini ditentukan berdasarkan beberapa faktor, termasuk saiz jadual yang dikonfigurasikan, penggunaan NVM dan nilai masa dan masa penjanaan lain. Pengguna yang ingin mencipta rangkaian besar mungkin menghadapi masalah sumber apabila mengembangkan rangkaian lebih besar daripada yang boleh disokong oleh aplikasi. Untuk exampOleh itu, peranti yang meminta Kunci Pautan Pusat Amanah daripada Pusat Amanah boleh mencetuskan panggilan balik sl_zigbee_af_zigbee_key_establishment_cb pada Pusat Amanah dengan status h ditetapkan kepada SL_ZIGBEE_KEY_TABLE_FULL, menunjukkan bahawa jadual kunci tidak mempunyai ruang untuk menambah kunci baharu untuk peranti yang meminta atau itu NVM3 tidak mempunyai ruang yang tersedia. Silicon Labs menyediakan cadangan berikut untuk pengguna yang ingin membuat rangkaian besar. Untuk aplikasi Pusat Amanah, konfigurasi berikut disyorkan. Pengesyoran ini tidak menyeluruh dan ia berfungsi sebagai garis dasar untuk aplikasi yang berhasrat mengembangkan rangkaian yang besar.

Kemasukan komponen Jadual Alamat (zigbee_address_table), dengan
- item konfigurasi SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE ditetapkan kepada saiz rangkaian yang dikehendaki
- nilai SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE ditetapkan kepada maksimum (4)

Kemasukan komponen Kunci Pautan Keselamatan (zigbee_security_link_keys), dengan
- Nilai SL_ZIGBEE_KEY_TABLE_SIZE ditetapkan kepada saiz rangkaian
Item konfigurasi berikut ditetapkan kepada saiz rangkaian yang dikehendaki
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, seperti yang terdapat dalam komponen Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, seperti yang terdapat dalam komponen penghalaan Sumber, jika penghalaan sumber digunakan
Pelarasan NVM3_DEFAULT_NVM_SIZE dan NVM3_DEFAULT_CACHE_SIZE mengikut penggunaan NVM3
- Cth saiz rangkaian lebih besar daripada 65 nod berkemungkinan memerlukan saiz NVM3 64K. Saiz NVM3 lalai dalam Silicon Labs Zigbee samppermohonan adalah 32K. Aplikasi yang menggunakan NVM lebih banyak mungkin memerlukan pelarasan nilai ini lebih tinggi lagi.
- Rangkaian besar sehingga 65 nod mungkin memerlukan saiz cache NVM3 sebanyak 1200 bait; mengembangkan rangkaian yang lebih besar daripada itu mungkin memerlukan menggandakan nilai ini kepada 2400 bait.

Pelarasan ini digunakan untuk Pusat Amanah sahaja

Gerbang Berbilang Protokol dan RCP

Barang Baru
Mendayakan sokongan SoC GA untuk BLE DMP dengan Zigbee + Openthread CMP dengan pendengaran serentak pada bahagian xG26. Sokongan alfa Debian telah ditambah untuk aplikasi Zigbeed, OTBR, dan Z3Gateway. Zigbeed dan OTBR disediakan dalam format pakej DEB untuk platform rujukan yang dipilih (Raspberry PI 4) juga. Lihat Menjalankan Zigbee, OpenThread dan Bluetooth Serentak pada Hos Linux dengan Pemproses Bersama Multiprotocol, ditemui di docs.silabs.com, untuk butiran. Menambahkan sokongan Zigbeed untuk Tizen-0.1-13.1 untuk arm32 dan aarch64 serta Android 12 untuk aarch64. Maklumat lanjut tentang Zigbeed boleh didapati di docs.silabs.com. Menambah komponen "802.15.4 Keutamaan penjadual radio bersatu" baharu. Komponen ini digunakan untuk mengkonfigurasi keutamaan radio bagi susunan 15.4. Komponen ini juga memerlukan komponen "radio_priority_configurator" baharu. Komponen ini membenarkan projek menggunakan alat Konfigurator Keutamaan Radio dalam Simplicity Studio untuk mengkonfigurasi tahap keutamaan radio bagi tindanan yang memerlukannya.

Penambahbaikan
Nota aplikasi Menjalankan Zigbee, OpenThread dan Bluetooth Serentak pada Hos Linux dengan Pemproses Bersama Multiprotocol (AN1333) telah dialihkan ke docs.silabs.com. Sokongan OpenWRT kini adalah kualiti GA. Sokongan OpenWRT telah ditambah untuk aplikasi Zigbee, OTBR, dan Z3Gateway. Zigbeed dan OTBR disediakan dalam format pakej IPK untuk platform rujukan (Raspberry PI 4) juga. Lihat Menjalankan Zigbee, OpenThread dan Bluetooth Serentak pada Hos Linux dengan Pemproses Bersama Multiprotocol, ditemui di docs.silabs.com, untuk keterangan.

Isu Tetap

Isu Diketahui dalam Keluaran Semasa
Isu dalam huruf tebal telah ditambahkan sejak keluaran sebelumnya. Jika anda terlepas keluaran, nota keluaran terbaru tersedia oathttps://www.silabs.com/developers/simplicity-software-development-kit.

Item Dihentikan
"Bekas Multiprotocol" yang kini tersedia di DockerHub (siliconlabsinc/multiprotocol) akan ditamatkan dalam keluaran akan datang. Bekas tidak akan dikemas kini lagi dan boleh ditarik dari DockerHub. Pakej berasaskan Debian untuk cpcd, ZigBee dan ot-br-posix, bersama-sama dengan projek yang dijana dan disusun secara asli, akan menggantikan fungsi yang hilang dengan pengalihan keluar bekas.

Menggunakan Keluaran Ini

Keluaran ini mengandungi perkara berikut:

Timbunan Zigbee
Rangka Kerja Aplikasi Zigbee
Zigbee Sample Aplikasi

Untuk maklumat lanjut tentang Zigbee dan EmberZNet SDK lihat UG103.02: Asas Zigbee. Jika anda pengguna kali pertama, lihat QSG180: Panduan Mula Pantas Zigbee EmberZNet untuk SDK 7.0 dan Lebih Tinggi, untuk arahan tentang mengkonfigurasi persekitaran pembangunan anda, membina dan berkelip sebagaiampaplikasi, dan rujukan dokumentasi yang menunjuk kepada langkah-langkah tambahan.

Pemasangan dan Penggunaan
SDK Zigbee EmberZNet disediakan sebagai sebahagian daripada SDK Simplicity, set SDK Silicon Labs. Untuk bermula dengan cepat dengan Simplicity SDK, pasang Simplicity Studio 5, yang akan menyediakan persekitaran pembangunan anda dan memandu anda melalui pemasangan Simplicity SDK. Simplicity Studio 5 merangkumi semua yang diperlukan untuk pembangunan produk IoT dengan peranti Silicon Labs, termasuk sumber dan pelancar projek, alat konfigurasi perisian, IDE penuh dengan rantai alat GNU dan alat analisis. Arahan pemasangan disediakan dalam Panduan Pengguna Simplicity Studio 5 dalam talian. Sebagai alternatif, Simplicity SDK boleh dipasang secara manual dengan memuat turun atau mengklon yang terkini daripada GitHub. Lihat https://github.com/SiliconLabs/simplicity_sdk untuk maklumat lanjut. Simplicity Studio memasang Simplicity SDK secara lalai dalam:

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

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

Dokumentasi khusus untuk versi SDK dipasang dengan SDK. Maklumat tambahan selalunya boleh didapati dalam artikel pangkalan pengetahuan (KBA). Rujukan API dan maklumat lain tentang ini dan keluaran terdahulu tersedia di https://docs.silabs.com/.

Maklumat Keselamatan
Penyepaduan Bilik Kebal Selamat
Untuk aplikasi yang memilih untuk menyimpan kunci dengan selamat menggunakan komponen Storan Kunci Selamat pada bahagian Secure Vault-High, jadual berikut menunjukkan kunci yang dilindungi dan ciri perlindungan storannya yang diuruskan oleh komponen Pengurus Keselamatan Zigbee.Kekunci berbalut yang ditandakan sebagai "Tidak Boleh Dieksport" boleh digunakan tetapi tidak boleh digunakan viewed atau dikongsi semasa masa jalan. Kekunci berbalut yang ditandakan sebagai "Boleh Dieksport" boleh digunakan atau dikongsi pada masa jalan tetapi kekal disulitkan semasa disimpan dalam Flash. Aplikasi pengguna tidak perlu berinteraksi dengan kebanyakan kunci ini. API sedia ada untuk mengurus kekunci Jadual Kunci Pautan atau Kekunci Transient masih tersedia untuk aplikasi pengguna dan hampir dihalakan melalui komponen Pengurus Keselamatan Zigbee.

Penasihat Keselamatan
Untuk melanggan Nasihat Keselamatan, log masuk ke portal pelanggan Silicon Labs, kemudian pilih Laman Utama Akaun. Klik HOME untuk pergi ke halaman utama portal dan kemudian klik jubin Urus Pemberitahuan. Pastikan 'Notis Nasihat Perisian/Keselamatan & Notis Perubahan Produk (PCN)' ditandakan dan anda melanggan sekurang-kurangnya untuk platform dan protokol anda. Klik Simpan untuk menyimpan sebarang perubahan.

Sokongan
Pelanggan Kit Pembangunan layak mendapat latihan dan sokongan teknikal. Gunakan Makmal Silikon Zigbee web halaman untuk mendapatkan maklumat tentang semua produk dan perkhidmatan Silicon Labs Zigbee, dan untuk mendaftar untuk sokongan produk. Anda boleh menghubungi sokongan Silicon Laboratories di http://www.silabs.com/support.

Pensijilan Zigbee
Keluaran Ember ZNet 8.1 telah layak untuk Platform Mematuhi Zigbee untuk seni bina SoC, NC, P dan RCP terdapat ID pensijilan ZCP yang terikat dengan keluaran ini, sila semak CSA webtapak di sini:
https://csa-iot.org/csa-iot_products/.

Sila ambil perhatian bahawa pensijilan ZCP adalah filed menyiarkan keluaran dan mengambil masa beberapa minggu sebelum dicerminkan pada CSA webtapak. Untuk sebarang pertanyaan lanjut, sila hubungi sokongan Silicon Laboratories di http://www.silabs.com/support.

Soalan Lazim

S: Bagaimanakah cara saya mengemas kini saiz jadual kunci pautan APS dalam SDK?
J: Saiz jadual kekunci pautan APS boleh dikonfigurasikan menggunakan parameter SL_ZIGBEE_KEY_TABLE_SIZE. Dalam versi 8.1, ia telah dikembangkan daripada 127 kepada 254 entri.

S: Apakah penambahbaikan dalam versi 8.1?
J: Versi 8.1 membawa peningkatan seperti mengembangkan saiz jadual kunci pautan APS, menamakan semula komponen, menambah perlindungan mutex untuk baris gilir acara Athe pp Framework dan banyak lagi. Rujuk nota keluaran untuk senarai penambahbaikan yang terperinci.

S: Bagaimanakah cara saya mengendalikan isu tetap dalam SDK?
J: Memperbaiki isu dalam SDK termasuk menyelesaikan masalah yang berpotensi dengan konfigurasi saiz jadual jiran, menamakan semula komponen, menetapkan overhed laluan sumber, mengendalikan arahan ZCL dan banyak lagi. Pastikan anda mengemas kini kepada versi terkini untuk mendapat manfaat daripada pembaikan ini.

Dokumen / Sumber

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

Rujukan

Manual Pengguna

SILICON LABS Zigbee EmberZ Net SDK

Spesifikasi

Maklumat Produk