SILICON LABS Bluetooth SDK Mesh
Bluetooth mesh minangka topologi anyar sing kasedhiya kanggo piranti Bluetooth Low Energy (LE) sing ngaktifake komunikasi many-to-many (m:m). Iki dioptimalake kanggo nggawe jaringan piranti skala gedhe lan cocog kanggo otomatisasi bangunan, jaringan sensor, lan pelacakan aset. Piranti lunak lan SDK kanggo pangembangan Bluetooth ndhukung fungsi Bluetooth Mesh lan Bluetooth 5.2. Pangembang bisa nambah komunikasi jaringan bolong menyang piranti LE kayata lampu sing disambungake, otomatisasi omah, lan sistem pelacakan aset. Piranti lunak uga ndhukung Bluetooth beaconing, beacon scanning, lan sambungan GATT supaya Bluetooth mesh bisa nyambung menyang smartphone, tablet, lan piranti Bluetooth LE liyane.
Cathetan rilis iki nyakup versi SDK:
- 2.1.10.0 dirilis 25 Oktober 2023 (dhukungan kanggo EFR32xG22, Révisi D)
- 2.1.9.0 dirilis 5 September 2023 (mung owah-owahan platform dhasar)
- 2.1.8.0 dirilis 13 Juli 2023 (dhukungan kanggo EFR32xG21, Revisi C lan mengko)
- 2.1.6.0 dirilis 29 Maret 2023 (dhukungan bagean akses awal)
- 2.1.5.0 dirilis 11 Januari 2023 (mung owah-owahan platform dhasar)
- 2.1.4.0 dirilis 13 Oktober 2021
- 2.1.3.0 dirilis 24 September 2021 (mung owah-owahan Bluetooth)
- 2.1.2.0 dirilis 8 September 2021
- 2.1.1.0 dirilis 21 Juli 2021
- 2.1.0.0 dirilis 16 Juni 2021
Kompatibilitas lan Panganggone Kabar
Kanggo informasi luwih lengkap babagan nganyari keamanan lan kabar, deleng bab Keamanan saka Cathetan Rilis Platform Gecko sing diinstal karo SDK iki utawa ing kaca Cathetan Rilis Silicon Labs. Silicon Labs uga banget nyaranake sampeyan langganan Advisories Keamanan kanggo informasi sing paling anyar. Kanggo instruksi, utawa yen sampeyan anyar ing Silicon Labs Bluetooth bolong SDK, waca Nggunakake Rilis Iki.
Compiler Kompatibel
IAR Embedded Workbench kanggo ARM (IAR-EWARM) versi 8.50.9
- Nggunakake anggur kanggo mbangun nganggo utilitas baris perintah IarBuild.exe utawa IAR Embedded Workbench GUI ing macOS utawa Linux bisa nyebabake salah files digunakake amarga tabrakan ing algoritma hashing anggur kanggo ngasilaken singkat file jeneng.
- Pelanggan ing macOS utawa Linux disaranake supaya ora nggawe IAR ing njaba Simplicity Studio. Pelanggan sing nindakake kudu kasebut kanthi teliti, verifikasi sing bener files lagi digunakake.GCC (The GNU Compiler Collection) versi 10.2.0, kasedhiya karo Simplicity Studio. Fitur optimasi link-wektu saka GCC wis dipateni, nyebabake ukuran gambar saya tambah sithik
Item anyar
Fitur anyar
Ditambahake ing release 2.1.0.0 Integrasi Vault Aman
Diwiwiti karo release 2.1.0.0, Bluetooth Mesh SDK nggunakake fungsi Secure Vault Key Management kanggo nyimpen tombol crypto-graphic mesh nalika piranti Secure Vault High digunakake. Integrasi Secure Vault katon kanggo pelanggan ing sawetara cara ing piranti Series 2:
- Tata letak data NVM3 kanggo kunci kriptografi lan owah-owahan metadata sing gegandhengan. Fungsi migrasi tombol diwenehake kanggo proyek sing wis digawe nggunakake SDK versi 2.0 utawa sadurunge. Migrasi tombol siji-wektu kudu ditindakake nalika perangkat kukuh ing piranti dianyari.
- Visibilitas data kunci sengaja diwatesi ing simpul bolong biasa. Aplikasi ing simpul bolong biasa ora diidini view data tombol aplikasi utawa piranti nggunakake sl_btmesh_node_get_key () printah BGAPI, nalika aplikasi ing simpul Provisioner ditempelake diijini kanggo nglakoni.
Kanggo informasi luwih lengkap babagan panyimpenan kunci ing Secure Vault, waca AN1271: Panyimpenan Kunci Aman.
Dhukungan Compiler
Compiler sing didhukung wis dianyari menyang versi GCC 10.2.0 lan versi IAR 8.50.9.
Ex anyarample Aplikasi
Lampu HSL example (Bluetooth Mesh - SoC HSL Light) ditambahake kanggo nduduhake simpul cahya sing bisa dikontrol liwat model server HSL. IOP demo (Bluetooth Mesh - IOP Test - *) ditambahake kanggo Papan Radio ing Pro Development Kits (SLWRB4104A, SLWRB4181A, SLWRB4181B, SLWRB4182A). Demo ngidini nguji interoperabilitas karo ponsel. Tes kasebut mbutuhake papatamples, saben example makili salah siji fitur Mesh: proxy, relay, kanca, lan LPN.
Komponen anyar
- Komponen Server HSL ditambahake.
- Dhukungan kanggo basis data GATT dinamis (fitur Bluetooth LE) ditambahake.
API Anyar Ditambahake ing release 2.1.4.0
Fungsi ngirim pesen Status Wektu eksplisit sl_btmesh_time_server_status () lan fungsi penerbitan eksplisit sing cocog sl_btmesh_time_server_publish () ditambahake menyang API model Server Wektu.
Ditambahake ing release 2.1.2.0
Kanthi gawan piranti Mesh normal sing dudu Provisioner ora bisa ngekspor data kunci keamanan liwat BGAPI. Yen ekspor tombol dibutuhake ing piranti kasebut kudu nggunakake printah BGAPI anyar, sl_btmesh_node_set_exportable_keys (), sadurunge tombol digawe ing simpul. Iki kalebu tombol sing digawe nalika nyedhiyakake piranti. A acara diagnostik notifikasi aplikasi saka owah-owahan pemandangan dijadwal, sl_btmesh_scheduler_server_scene_changed (), wis ditambahake.
Ditambahake ing release 2.1.1.0
Kanggo ngoptimalake panggunaan buffer karo model Scene, API opsional kanggo ngaktifake acara kelingan pemandangan kompak wis ditambahake (ref. masalah ID 706555). Disaranake nggunakake API anyar nalika simpul duwe jumlah gedhe saka model, utawa jumlah lalu lintas jaringan samesthine kanggo krungu simpul dhuwur. Kanggo ngaktifake API anyar, nggunakake printah BGAPI sl_btmesh_scene_server_enable_compact_recall_events (). Sawisé iku, sl_btmesh_evt_scene_server_compact_recall_events bakal sinyal panjalukan kelingan pemandangan. Kanggo njupuk negara model cached sawise request kelingan pemandangan, nggunakake printah sl_btmesh_generic_server_get_cached_state ().
Ditambahake ing release 2.1.0.0
Amarga integrasi Secure Vault, rincian nyimpen kunci enkripsi lan metadata sing gegandhengan wis diganti ing piranti Seri 2. Kelas BGAPI anyar kanggo migrasi kunci enkripsi lan database piranti Provisioner sing dipasang sawise nganyari perangkat kukuh ing piranti Series 2 mula ditambahake. Wis printah ing ngisor iki:
- sl_btmesh_migration_migrate_keys
- sl_btmesh_migration_migrate_ddb
dandan
API sing diganti
Diowahi ing release 2.1.2.0
Parameter zona wektu ing sl_btmesh_time_server_get_datetime() wis didandani dadi integer 16-bit sing ditandatangani. Parameter akurasi jam, sl_btmesh_lpn_clock_acuracy, wis ditambahake menyang konfigurasi LPN. Parameter iki bisa digunakake kanggo nyetel prilaku turu LPN nalika jam mabur ing piranti bakal nyebabake LPN ora kejawab wektu entek polling.
Diowahi ing release 2.1.1.0
Acara sl_btmesh_evt_friend_friendship_terminated saiki bakal digawe nalika Klien Konfigurasi mateni fitur Kanca simpul nalika kekancan aktif. Sadurunge mandap saka Persahabatan ing kahanan iki implicitly signaled dening acara sl_btmesh_evt_node_config_set. (Ref. masalah iD 627811)
Diowahi ing release 2.1.0.0
Ing ngisor iki BGAPI printah ing kelas prov saiki bali sawise validasi parameter, lan operasi dijaluk nyata njupuk Panggonan sawise respon BGAPI diwenehi. Rampung operasi sing dijaluk diwenehi tandha dening acara BGAPI sing cocog:
- sl_btmesh_prov_add_ddb_entry() - completion of addition is signaled by sl_btmesh_evt_prov_add_ddb_entry_complete
- sl_btmesh_prov_delete_ddb_entry () - completion saka pambusakan diwenehi tandha dening sl_btmesh_evt_prov_delete_ddb_entry_complete Printah BGAPI ing ngisor iki ing kelas prov wis acara tambahan sing bisa kui sawise disebut:
- sl_btmesh_prov_init - saliyane sl_btmesh_evt_prov_initialized, sl_btmesh_evt_prov_initialization_failed bisa digawe. Printah BGAPI wis ditambahake menyang model klien umum BGAPI:
mesh_generic_client_init_hsl()
Printah BGAPI wis ditambahake menyang model server umum BGAPI:
mesh_generic_server_init_hsl()
Masalah tetep
Didandani ing release 2.1.4.0
| ID # | Katrangan |
| 729116 | Ndandani masalah karo multiplikasi model Server Wektu sing ora disengaja nalika nambah unsur anyar menyang proyek |
| 735569 | Nangani tetep pesen multicast segmen sing dikirimake simpul kanca menyang simpul daya sing sithik |
Didandani ing release 2.1.2.0
| ID # | Katrangan |
| 627811 | Nggawe acara kekancan mungkasi nalika mandap dijaluk lokal |
| 676798 | Njupuk akun ora akurat karo LPN polling wektu tangi |
| 683518 | Gawe acara putus kekancan langsung nalika nampa pesen Friend Clear |
| 703974 | Ndandani masalah tes kualifikasi kanthi detak jantung |
| 709948 | Nyedhiyakake API kanggo ngontrol ekspor kunci keamanan ing simpul bolong |
| 724511 | Ndandani masalah karo ndhaptar opcode vendor liwat 0x1F |
| 730273 | Ndandani masalah karo penanganan offset zona wektu negatif |
| 731713 | Ndandani kemungkinan bocor memori kanthi ngirim pesen sing dibagi nalika piranti kurang memori |
| 734034 | Ndandani komunikasi kanca-kanggo-LPN nalika TTL nol |
| 734858 | Mbenerake masalah variabel tumpukan potensial karo penanganan struktur PSA |
| 736054 | Ndandani masalah tes kualifikasi kanthi ikatan kunci aplikasi model |
Didandani ing release 2.1.1.0
| ID # | Katrangan |
| 692961 | Ndandani simpul dadi ora responsif nalika transmisi relay diaktifake nalika ana beban abot |
| 713152 | Ndandani masalah nalika presisi pitungan winates nyebabake kesalahan pembulatan ing ikatan antarane Light Lightness Actual lan Light Lightness Linear |
Didandani ing release 2.1.0.0
| ID # | Katrangan |
| 3878 | Aplikasi kudu nglirwakake acara GATT kanggo ciri Mesh |
| 342521 | Perpustakaan matematika ora nambah ukuran gambar sing ora perlu |
| 358019 | Kode asil sing didandani diwenehake nalika publikasi model kanthi kredensial kekancan dijaluk nanging kekancan ora didhukung |
| 404070 | Kode asil sing didandani diwenehake nalika prentah provisioner kanggo nggawe kunci jaringan diarani ing piranti non-provisioner |
| 454332 | API LE GAP kudu digunakake kanggo iklan jeneng lokal piranti |
| 464907 | Mbusak acara BGAPI 'detak jantung' sing ora perlu nalika klien konfigurasi mateni denyut jantung ing simpul |
| 653405 | Ngalih metu-saka-kothak sampkonsumsi saiki le aplikasi saiki ing tingkat samesthine |
| 654477 | DCD decoded bener dening Network Analyzer |
| 660048 | Tombol Pencet komponen UC ora mbutuhake komponen IO Stream unneccesarily |
| 687105 | BT Mesh Commands bisa karo NCP Target example lan Panglima NCP |
| 690803 | Ndandani ID model vendor duplikat ing generator kode |
| 690862 | SoC kosong example saiki wiwit beaconing ing hardware xG22 |
| 707497 | Alokasi konteks kriptografi PSA sing didandani |
| 707524 | Ndandani regresi karo timer penjaga pemulihan IV, ora ngidini pemulihan liyane cepet banget |
| ID # | Katrangan |
| 710381 | Penanganan status standar cahya tetep nalika sawetara non-standar kanggo model sing cocog disetel |
| 711359 | Priksa parameter tetep kanggo nggawe sesi nggawe telpon BGAPI |
Masalah sing Dikenal ing Rilis Saiki
Masalah ing kandel ditambahake wiwit rilis sadurunge.
| ID # | Katrangan | Solusi |
| 401550 | Ora ana acara BGAPI amarga gagal nangani pesen sing dibagi | Aplikasi kudu nyuda kegagalan amarga wektu entek / kurang respon lapisan aplikasi |
| 418636 | Masalah karo API negara konfigurasi lokal mesh_test (identitas simpul, relay, transmisi ulang jaringan) | |
| 454059 | Akeh acara owah-owahan status refresh tombol digawe ing pungkasan proses KR, lan bisa banjir antrian NCP. | Tambah dawa antrian NCP ing proyek kasebut |
| 454061 | Degradasi kinerja sing sithik dibandhingake karo 1.5 ing tes latensi round-trip diamati | |
| 624514 | Jeksa Agung bisa ngetokake karo nggawe maneh iklan connectable yen kabeh sambungan wis aktif lan GATT proxy digunakake | Nyedhiyakake siji sambungan luwih saka sing dibutuhake |
| 650825 | Masalah karo transmisi ulang nalika model diterbitake sacara periodik | Nyiyapake transmisi ulang ing negara model lan micu penerbitan berkala dening timer aplikasi |
Item sing ora digunakake
Printah BGAPI ing ngisor iki ing kelas simpul wis ora digunakake: sl_btmesh_node_erase_mesh_nvm () - nggunakake sl_btmesh_node_reset () tinimbang.
Dibusak Item
- ora ana
Nggunakake Rilis Iki
Rilis iki ngemot ing ngisor iki
- Perpustakaan tumpukan bolong Bluetooth Silicon Labs
- Bluetooth sample aplikasi
Yen sampeyan pangguna pisanan, ndeleng QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Pandhuan Miwiti Cepet.
Instalasi lan Gunakake
Akun kadhaptar ing Silicon Labs dibutuhake kanggo ndownload Silicon Labs Bluetooth SDK. Sampeyan bisa ndhaftar ing https://sili-conlabs.force.com/apex/SL_CommunitiesSelfReg?form=short. Instruksi instalasi tumpukan dijamin ing QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Pandhuan Cepet Mulai. Gunakake Bluetooth mesh SDK karo platform pangembangan Silicon Labs Simplicity Studio V4. Simplicity Studio mesthekake yen paling kompatibilitas piranti lunak lan alat dikelola kanthi bener. Instal piranti lunak lan nganyari perangkat kukuh Papan sakcepete nalika sampeyan diwenehi kabar.Dokumentasi khusus kanggo versi SDK diinstal karo SDK. Informasi tambahan asring ditemokake ing artikel basis pengetahuan (KBA). Referensi API lan informasi liyane babagan iki lan rilis sadurungé kasedhiya ing https://docs.silabs.com/.
Informasi Keamanan Integrasi Vault Aman
Versi tumpukan iki digabungake karo Secure Vault Key Management. Nalika disebarake menyang piranti Secure Vault High, kunci enkripsi bolong dilindhungi nggunakake fungsi Secure Vault Key Management. Tabel ing ngisor iki nuduhake kunci sing dilindhungi lan karakteristik proteksi panyimpenan.
| Kunci | Exportability ing simpul | Exportability ing Provisioner | Cathetan |
| Tombol jaringan | Bisa diekspor | Bisa diekspor | Derivasi saka tombol jaringan mung ana ing RAM nalika tombol jaringan disimpen ing lampu kilat |
| Kunci aplikasi | Non-exportable | Bisa diekspor | |
| Tombol piranti | Non-exportable | Bisa diekspor | Ing kasus Provisioner, ditrapake kanggo kunci piranti Provisionerr dhewe uga tombol piranti liyane |
Tombol sing ditandhani minangka "Non-Exportable" bisa digunakake nanging ora bisa digunakake viewed utawa dienggo bareng nalika runtime. Tombol sing ditandhani minangka "Exportable" bisa digunakake utawa dienggo bareng nalika runtime nanging tetep ndhelik nalika disimpen ing lampu kilat. Kanggo informasi luwih lengkap babagan fungsi Manajemen Kunci Aman, deleng AN1271: Panyimpenan Kunci Aman
Penasihat Keamanan
Kanggo langganan Security Advisories, mlebu menyang portal pelanggan Silicon Labs, banjur pilih Akun Ngarep. Klik HOME kanggo pindhah menyang kaca ngarep portal banjur klik kothak Ngatur Notifikasi. Priksa manawa 'Software/Security Advisory Notice & Product Change Notice (PCNs)' dicenthang, lan sampeyan wis langganan minimal kanggo platform lan protokol sampeyan. Klik Simpen kanggo nyimpen owah-owahan.
Dhukungan
Pelanggan Development Kit layak kanggo latihan lan dhukungan teknis. Gunakake Silicon Labs Bluetooth mesh web kaca kanggo njupuk informasi babagan kabeh produk lan layanan Bluetooth Silicon Labs, lan kanggo ndhaptar dhukungan produk. Hubungi dhukungan Silicon Laboratories ing http://www.silabs.com/support.
Studio Kesederhanaan
Akses siji-klik menyang MCU lan piranti nirkabel, dokumentasi, piranti lunak, perpustakaan kode sumber & liya-liyane. Kasedhiya kanggo Windows, Mac lan Linux!
- Portofolio IoT
- SW/HW
- Kualitas
- Dhukungan & Komunitas
Penafian
Silicon Labs arep menehi dokumentasi paling anyar, akurat, lan jero kanggo kabeh periferal lan modul sing kasedhiya kanggo para pelaksana sistem lan piranti lunak sing nggunakake utawa arep nggunakake produk Silicon Labs. Data karakterisasi, modul lan peripheral sing kasedhiya, ukuran memori lan alamat memori nuduhake saben piranti tartamtu, lan paramèter "Khas" sing kasedhiya bisa beda-beda ing macem-macem aplikasi. Aplikasi exampsing diterangake ing kene mung kanggo ilustrasi. Silicon Labs nduweni hak kanggo nggawe owahan tanpa kabar luwih lengkap babagan informasi produk, spesifikasi, lan katrangan ing kene, lan ora menehi jaminan babagan akurasi utawa kelengkapan informasi sing kalebu. Tanpa kabar sadurunge, Silicon Labs bisa nganyari perangkat kukuh produk sajrone proses manufaktur amarga alasan keamanan utawa linuwih. Owah-owahan kasebut ora bakal ngowahi spesifikasi utawa kinerja produk. Silicon Labs ora duwe tanggung jawab kanggo akibat saka panggunaan informasi sing diwenehake ing dokumen iki. Dokumen iki ora nyatakake utawa kanthi tegas menehi lisensi kanggo ngrancang utawa nggawe sirkuit terpadu. Produk kasebut ora dirancang utawa diidini digunakake ing piranti Kelas III FDA, aplikasi sing dibutuhake persetujuan premarket FDA utawa Sistem Dhukungan Urip tanpa idin tinulis khusus saka Silicon Labs. "Sistem Dhukungan Urip" yaiku produk utawa sistem sing dimaksudake kanggo ndhukung utawa nylametake urip lan/utawa kesehatan, sing, yen gagal, bisa uga bisa nyebabake ciloko utawa pati pribadi sing signifikan. Produk Silicon Labs ora dirancang utawa sah kanggo aplikasi militer. Produk Silicon Labs ora bakal digunakake ing gaman pemusnah massal kalebu (nanging ora winates ing) senjata nuklir, biologi utawa kimia, utawa misil sing bisa ngirim senjata kasebut. Silicon Labs nolak kabeh jaminan sing nyata lan diwenehake lan ora tanggung jawab utawa tanggung jawab kanggo ciloko utawa kerusakan sing ana gandhengane karo panggunaan produk Silicon Labs ing aplikasi sing ora sah kasebut.
Cathetan: Isi iki bisa uga ngemot terminologi nyerang sing saiki wis lungse. Silicon Labs ngganti istilah kasebut nganggo basa inklusif yen bisa. Kanggo informasi luwih lengkap, bukak www.silabs.com/about-us/inclusive-lexicon-project
Informasi merek dagang
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® lan logo Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo lan kombinasi kasebut , "mikrokontroler paling ramah energi ing donya", Redpine Signals®, WiSeConnect , n-Link, ThreadArch®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress®, Zentri, logo Zentri lan Zentri DMS, Z-Wave®, lan liya-liyane yaiku merek dagang utawa merek dagang kadhaptar saka Silicon Labs. ARM, CORTEX, Cortex-M3 lan THUMB iku merek dagang utawa merek dagang kadhaptar saka ARM Holdings. Keil minangka merek dagang kadhaptar saka ARM Limited. Wi-Fi minangka merek dagang kadhaptar saka Wi-Fi Alliance. Kabeh produk utawa jeneng merek liyane sing kasebut ing kene minangka merek dagang saka sing duwe.
Silicon Laboratories Inc.. 400 West Cesar Chavez Austin, TX 78701 USA
Dokumen / Sumber Daya
 |
SILICON LABS Bluetooth SDK Mesh [pdf] Pandhuan Bluetooth SDK Mesh, SDK Mesh, Mesh |
