Manual Pemilik SDK Bluetooth Mesh SILICON LABS

Maklumat Produk
Simplicity SDK Suite termasuk ciri yang disokong oleh spesifikasi Bluetooth Mesh versi 1.1. Ia menyediakan platform untuk membangunkan aplikasi menggunakan teknologi Bluetooth Mesh.

Arahan Penggunaan Produk

Bluetooth Mesh ialah topologi baharu yang tersedia untuk peranti Bluetooth Tenaga Rendah (LE) yang membolehkan komunikasi banyak-ke-banyak (m:m). Ia dioptimumkan untuk mencipta rangkaian peranti berskala besar dan amat sesuai untuk membina automasi, rangkaian penderia dan penjejakan aset. Perisian dan SDK kami untuk pembangunan Bluetooth menyokong fungsi Bluetooth Mesh dan Bluetooth. Pembangun boleh menambahkan komunikasi rangkaian mesh pada peranti LE seperti lampu bersambung, automasi rumah dan sistem penjejakan aset. Perisian ini menyokong suar Bluetooth, pengimbasan suar dan sambungan GATT supaya Bluetooth Mesh boleh menyambung ke telefon pintar, tablet dan peranti Bluetooth LE lain. Keluaran ini termasuk ciri yang disokong oleh spesifikasi Bluetooth Mesh versi 1.1.

Nota keluaran ini meliputi versi SDK

7.0.3.0 dikeluarkan 23 April 2025 (Perubahan platform asas sahaja)
7.0.2.0 dikeluarkan pada 18 September 2024
7.0.1.0 dikeluarkan pada 24 Julai 2024
7.0.0.0 dikeluarkan pada 5 Jun 2024

Notis Keserasian dan Penggunaan
Untuk mendapatkan maklumat lanjut tentang kemas kini keselamatan dan notis, lihat bab Keselamatan Nota Keluaran Platform yang dipasang dengan SDK ini atau pada halaman Nota Keluaran Silicon Labs. Silicon Labs juga amat mengesyorkan agar anda melanggan Nasihat Keselamatan untuk mendapatkan maklumat terkini. Untuk arahan, atau jika anda baru menggunakan Silicon Labs Bluetooth Mesh SDK, lihat Menggunakan Keluaran Ini.

Penyusun Serasi
Meja Kerja Terbenam IAR untuk ARM (IAR-EWARM) versi 9.40.1

Menggunakan wain untuk membina dengan utiliti baris arahan IarBuild.exe atau GUI Meja Kerja Terbenam IAR pada macos atau Linux boleh mengakibatkan tidak betul files digunakan kerana perlanggaran dalam algoritma pencincangan wain untuk menjana pendek file nama.

Pelanggan di macos atau Linux dinasihatkan untuk tidak membina dengan IAR di luar Simplicity Studio. Pelanggan yang berbuat demikian hendaklah mengesahkan dengan teliti bahawa yang betul files sedang digunakan.
GCC (The GNU Compiler Collection) versi 12.2.1, disediakan dengan Simplicity Studio.

Ciri pengoptimuman masa pautan GCC telah dilumpuhkan, mengakibatkan sedikit peningkatan dalam saiz imej.

CIRI-CIRI UTAMA

Migrasi ke Simplicity SDK Suite
Mengalih keluar sokongan untuk Siri 0/1
Sokongan untuk kemas kini perisian tegar termampat delta

Barang Baru

Ciri Baharu

Ditambah dalam keluaran 7.0.1.0
Sokongan untuk Kemas Kini Perisian Tegar Peranti Mesh (DFU) yang menggunakan pemampatan delta yang cekap, berdasarkan pengecaman perbezaan antara dua versi perisian tegar, telah ditambahkan. Ciri ini memerlukan penggunaan versi alat Komander yang menyokong menganalisis perbezaan binari ELF, serta penggunaan pemuat but yang menyokong penggunaan kemas kini perisian tegar termampat.

Ditambah dalam keluaran 7.0.0.0
Sokongan untuk Pengurus Jam telah ditambah. Komponen tindanan tidak lagi menggunakan device_init() untuk permulaan jam. Sebaliknya, projek aplikasi kini mesti memasukkan komponen clock_manager, yang melakukan permulaan jam.
Sokongan untuk Pengurus Memori Biasa telah ditambah.

API baharu

Ditambah dalam keluaran 7.0.0.0

Penambahbaikan

Diubah dalam keluaran 7.0.0.0

Perubahan BGAPI
Perintah kelas BGAPI nod, sl_btmesh_node_test_identity, telah ditambahkan untuk menyemak sama ada iklan identiti nod yang diterima berasal daripada nod tertentu atau tidak.

Exampperubahan permohonan
Ciri Nod Kuasa Rendah telah ditambahkan pada pelayan Sensor examples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light), dan ciri Rakan telah ditambahkan pada bekas pelanggan pelayan sensorample (btmesh_soc_sen-sor_client).

Isu Tetap

Dibetulkan dalam keluaran 7.0.2.0

ID #	Penerangan
1331888, 1334927, 1338088, 1338090	Memperbaiki beberapa kegagalan peruntukan memori yang tidak dikendalikan yang berpotensi menyebabkan ranap apabila peranti terlalu sarat dengan trafik.
1345827	Memperbaiki kehilangan acara BGAPI pengedar DFU yang bermaklumat untuk penyingkiran nod.
1301401	Ralat kemas kini keadaan pelayan Pencahayaan tetap apabila menerima pelayan pencahayaan Tetapkan permintaan dengan masa peralihan.
1345411	Membetulkan memori sl_memory_realloc() yang bocor, membawa kepada bekas pengedar DFUample kehabisan memori timbunan.

Dibetulkan dalam keluaran 7.0.1.0

ID #	Penerangan
1301325	Memperbaiki isu dalam menyimpan tindakan model Penjadual.
1305041	Isu tamat masa dalam komunikasi NCP daripada hos kepada EFR32 telah diperbaiki.
1305928	Memperbaiki kehilangan data senarai Penerima yang betul dalam peristiwa DFU selepas pembetulan kehilangan peristiwa 1258654 dilaksanakan.
1319326	Memperbaiki nilai yang salah untuk penghitungan bit pengesahan OOB input dan output.
1325194	Memperbaiki pertindihan peristiwa status penerima pelanggan pengedar DFU yang tidak perlu selepas pembetulan kehilangan peristiwa 1258654 dilaksanakan.
1310377	Memperbaiki isu dalam apl IOP Relay. Sebelum ini, ia hanya dipancarkan menggunakan GATT.

Dibetulkan dalam keluaran 7.0.0.0

ID #	Penerangan
356148	Elakkan memulakan pembawa iklan jika nod sedang diperuntukkan hanya menggunakan PB-GATT.
1250461	Menjadikan pelaporan acara peruntukan lebih mantap pada peranti yang terlebih muatan.
1258654	Menjadikan pelaporan acara DFU lebih mantap pada peranti yang lebih muatan.
1274632	Model DFU Distributor dan Standalone Updater kini akan melaporkan ralat jika konfigurasi Blob Transfer pada nod tidak mencukupi.
1284204	Memperbaiki penjimatan perlindungan main semula kepada NVM3 apabila aplikasi menggunakan sl_btmesh_node_power_off() API.

Isu Diketahui dalam Keluaran Semasa

Isu dalam huruf tebal telah ditambahkan sejak keluaran sebelumnya

ID #	Penerangan	Penyelesaian
401550	Tiada acara BGAPI untuk kegagalan pengendalian mesej tersegmen.	Aplikasi perlu menyimpulkan kegagalan daripada tamat masa/kekurangan tindak balas lapisan aplikasi; untuk model vendor, API telah disediakan.
454059	Sebilangan besar peristiwa perubahan keadaan muat semula utama dijana pada penghujung proses KR, dan itu mungkin membanjiri baris gilir NCP.	Tambah panjang baris gilir NCP dalam projek.
454061	Kemerosotan prestasi sedikit berbanding 1.5 dalam ujian kependaman pergi balik telah diperhatikan.
624514	Isu dengan mewujudkan semula pengiklanan boleh sambung jika semua sambungan telah aktif dan proksi GATT sedang digunakan.	Peruntukkan satu sambungan lebih daripada yang diperlukan.
841360	Prestasi rendah penghantaran mesej tersegmen ke atas pembawa GATT.	Pastikan selang Sambungan sambungan BLE asas adalah pendek; memastikan bahawa ATT MTU cukup besar untuk memuatkan PDU Mesh penuh; sesuaikan panjang peristiwa sambungan minimum untuk membolehkan berbilang paket LL dihantar setiap peristiwa sambungan.
1121605	Ralat pembulatan boleh menyebabkan peristiwa yang dijadualkan dicetuskan pada masa yang berbeza sedikit daripada yang dijangkakan.
1226127	Pembekal hos example boleh tersekat apabila ia mula menyediakan nod kedua.	Mulakan semula apl penyedia hos sebelum memperuntukkan nod kedua.
1204017	Pengedar tidak dapat mengendalikan Kemas Kini FW sendiri dan Muat Naik FW secara selari.	Jangan jalankan kemas kini FW sendiri dan muat naik FW secara selari.

Item Dihentikan

Ditamatkan dalam keluaran 7.0.0.0
Perintah BGAPI sl_btmesh_prov_test_identity telah ditamatkan. Gunakan sl_btmesh_node_test_identity sebaliknya.

Item Dialih Keluar

Dialih keluar dalam keluaran 7.0.0.0

Sokongan untuk perkakasan Siri 1 (xG12 dan xG13) telah dialih keluar dalam keluaran ini.

Menggunakan Keluaran Ini

Keluaran ini mengandungi perkara berikut

Pustaka tindanan jejaring Bluetooth Silicon Labs
jaring Bluetooth sample aplikasi

Jika anda pengguna kali pertama, lihat QSG176: Silicon Labs Bluetooth Mesh SDK v2. x Panduan Mula Pantas.

Pemasangan dan Penggunaan

SDK jejaring Bluetooth disediakan sebagai sebahagian daripada SDK Simplicity (GSDK), 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/Sili-conLabs/simplicity_sdk untuk maklumat lanjut .
Simplicity Studio memasang Simplicity SDK secara lalai dalam:
- Windows: C:\Users\ \SimplicityStudio\SDKs\simplicity_sdk
- MacOS: /Pengguna/ /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
Versi timbunan ini disepadukan dengan Pengurusan Kunci Bilik Kebal Selamat. Apabila digunakan pada peranti Secure Vault High, kunci penyulitan mesh dilindungi menggunakan fungsi Pengurusan Kunci Secure Vault. Jadual di bawah menunjukkan kunci yang dilindungi dan ciri perlindungan storannya.

kunci	Keboleheksportan pada nod	Keboleheksportan pada Penyedia	Nota
Kunci rangkaian	Boleh dieksport	Boleh dieksport	Derivasi kunci rangkaian hanya wujud dalam RAM, manakala kunci rangkaian disimpan pada denyar.
Kunci permohonan	Tidak boleh dieksport	Boleh dieksport
Kunci peranti	Tidak boleh dieksport	Boleh dieksport	Dalam kes Penyedia, digunakan pada kunci peranti Penyedia serta kunci peranti lain.

Kekunci yang ditandakan sebagai "Tidak Boleh Dieksport" boleh digunakan tetapi tidak boleh digunakan viewed atau dikongsi semasa masa jalan.
Kekunci yang ditandakan sebagai "Boleh Dieksport" boleh digunakan atau dikongsi semasa masa jalan, tetapi kekal disulitkan semasa disimpan dalam kilat.

Untuk mendapatkan maklumat lanjut tentang kefungsian Pengurusan Kunci Secure Vault, lihat AN1271 Secure Key Storage.

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 (PCNS)' ditandakan dan anda melanggan sekurang-kurangnya untuk platform dan protokol anda. Klik Simpan untuk menyimpan sebarang perubahan.

Rajah berikut ialah bekasample.e

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

Studio Kesederhanaan
Akses satu klik kepada MCU dan alatan wayarles, dokumentasi, perisian, perpustakaan kod sumber & banyak lagi. Tersedia untuk Windows, Mac dan Linux

Penafian

Silicon Labs berhasrat untuk menyediakan pelanggan dengan dokumentasi terkini, tepat dan mendalam bagi semua peranti dan modul yang tersedia untuk pelaksana sistem dan perisian yang menggunakan atau berhasrat untuk menggunakan produk SiliconLabsCiri-ciri dataa, modul dan persisian yang tersedia, saiz memori dan alamat memori merujuk kepada setiap peranti tertentu, dan parameter "Lazim" yang disediakan boleh dan berbeza-beza dalam aplikasi berbeza.
Permohonan cthampyang diterangkan di sini adalah untuk tujuan ilustrasi sahaja.
Silicon Labs berhak untuk membuat perubahan tanpa notis lanjut kepada maklumat produk, spesifikasi dan penerangan di sini, dan tidak memberikan jaminan tentang ketepatan atau kesempurnaan maklumat yang disertakan.

Tanpa pemberitahuan awal, Silicon Labs boleh mengemas kini perisian tegar produk semasa proses pembuatan atas sebab keselamatan atau kebolehpercayaan. Perubahan sedemikian tidak akan mengubah spesifikasi atau prestasi produk. Silicon Labs tidak akan bertanggungjawab ke atas akibat penggunaan maklumat yang dibekalkan dalam dokumen ini.
Dokumen ini tidak membayangkan atau secara nyata memberikan mana-mana lesen untuk mereka bentuk atau mengada-adakan sebarang litar bersepadu.
Produk tidak direka bentuk atau dibenarkan untuk digunakan dalam mana-mana peranti Kelas III FDA, aplikasi yang memerlukan kelulusan prapasaran FDA, atau Sistem Sokongan Hayat tanpa kebenaran bertulis khusus Silicon Labs.
“Sistem Sokongan Kehidupan” ialah sebarang produk atau sistem yang bertujuan untuk menyokong atau mengekalkan kehidupan dan/atau kesihatan, yang, jika gagal, boleh dijangka secara munasabah mengakibatkan kecederaan peribadi atau kematian yang ketara.
Produk Silicon Labs tidak direka bentuk atau dibenarkan untuk aplikasi ketenteraan. Produk Silicon Labs dalam apa jua keadaan tidak boleh digunakan dalam senjata pemusnah besar-besaran, termasuk (tetapi tidak terhad kepada) senjata nuklear, biologi atau kimia, atau peluru berpandu yang mampu menghantar senjata tersebut.
Silicon Labs menafikan semua waranti nyata dan tersirat dan tidak akan bertanggungjawab atau bertanggungjawab untuk sebarang kecederaan atau kerosakan yang berkaitan dengan penggunaan produk Silicon Labs dalam aplikasi tanpa kebenaran tersebut.

Maklumat Cap Dagangan
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® dan logo Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo dan gabungannya, "pengawal mikro paling mesra tenaga di dunia", Redpine Signals®, WiSeConnect, EZRadio®, WiSeConnect, n-Link, n-Link. EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress® Zentri, logo Zentri dan Zentri DMS, Z-Wave®, dan lain-lain ialah tanda dagangan atau tanda dagangan berdaftar Silicon Labs. ARM, CORTEX, Cortex-M3 dan THUMB ialah tanda dagangan atau tanda dagangan berdaftar ARM Holdings. Keil ialah tanda dagangan berdaftar ARM Limited. Wi-Fi ialah tanda dagangan berdaftar Wi-Fi Alliance. Semua produk atau nama jenama lain yang disebut di sini adalah tanda dagangan pemegang masing-masing.

Makmal Silikon Inc.
400 West Cesar Chavez Avenue, Austin, TX 78701 USA
www.silabs.com

Soalan Lazim

S: Di manakah saya boleh mendapatkan maklumat lanjut tentang kemas kini keselamatan?
A: Rujuk bab Keselamatan Nota Keluaran Platform atau lawati halaman Nota Keluaran Silicon Labs untuk maklumat kemas kini keselamatan terperinci.

S: Bagaimanakah cara saya melanggan Nasihat Keselamatan?
A: Silicon Labs mengesyorkan melanggan Penasihat Keselamatan untuk mendapatkan maklumat terkini. Ikut arahan yang diberikan dalam dokumentasi atau hubungi sokongan Silicon Labs.

Dokumen / Sumber

SILICON LABS Bluetooth Mesh SDK [pdf] Manual Pemilik
7.0.3.0, 7.0.2.0, 7.0.1.0, 7.0.0.0, Bluetooth Mesh SDK, Mesh SDK, SDK

Rujukan

Manual Pengguna

SILICON LABS Bluetooth Mesh SDK

Spesifikasi