Mwongozo wa Mmiliki wa SDK wa SILICON LABS Bluetooth Mesh

Taarifa ya Bidhaa
SDK Suite ya Urahisi inajumuisha vipengele vinavyotumika na toleo la 1.1 la vipimo vya Bluetooth Mesh. Inatoa jukwaa la kukuza programu kwa kutumia teknolojia ya Bluetooth Mesh.

Maagizo ya Matumizi ya Bidhaa

Bluetooth Mesh ni topolojia mpya inayopatikana kwa vifaa vya Bluetooth Low Energy (LE) ambayo huwezesha mawasiliano kati ya nyingi hadi nyingi (m:m). Imeboreshwa kwa ajili ya kuunda mitandao mikubwa ya vifaa na inafaa kabisa kwa ajili ya kujenga otomatiki, mitandao ya vitambuzi na ufuatiliaji wa vipengee. Programu yetu na SDK ya ukuzaji wa Bluetooth inasaidia Bluetooth Mesh na utendakazi wa Bluetooth. Wasanidi programu wanaweza kuongeza mawasiliano ya mtandao wa wavu kwenye vifaa vya LE kama vile taa zilizounganishwa, mitambo ya kiotomatiki ya nyumbani na mifumo ya kufuatilia vipengee. Programu hii inaauni uangazaji wa Bluetooth, uchanganuzi wa vinara, na miunganisho ya GATT ili Bluetooth Mesh iweze kuunganishwa kwenye simu mahiri, kompyuta kibao na vifaa vingine vya Bluetooth LE. Toleo hili linajumuisha vipengele vinavyoauniwa na toleo la 1.1 la vipimo vya Bluetooth Mesh.

Madokezo haya ya toleo yanashughulikia matoleo ya SDK

7.0.3.0 iliyotolewa Aprili 23, 2025 (Mabadiliko ya msingi ya jukwaa pekee)
7.0.2.0 iliyotolewa tarehe 18 Septemba 2024

7.0.1.0 iliyotolewa Julai 24, 2024
7.0.0.0 iliyotolewa tarehe 5 Juni 2024

Ilani za Utangamano na Matumizi
Kwa maelezo zaidi kuhusu masasisho na arifa za usalama, angalia sura ya Usalama ya Vidokezo vya Kutolewa kwa Mfumo vilivyosakinishwa kwa SDK hii au kwenye ukurasa wa Vidokezo vya Kutolewa vya Maabara ya Silicon. Silicon Labs pia inapendekeza sana ujiandikishe kwa Ushauri wa Usalama kwa maelezo ya kisasa. Kwa maagizo, au kama wewe ni mgeni kwa SDK ya SDK ya Silicon Labs Bluetooth Mesh, angalia Kutumia Toleo Hili.

Compilers Sambamba
IAR Iliyopachikwa Workbench ya ARM (IAR-EWARM) toleo la 9.40.1

Kutumia divai kujenga na matumizi ya mstari wa amri ya IarBuild.exe au IAR Embedded Workbench GUI kwenye macos au Linux kunaweza kusababisha makosa. files inatumika kwa sababu ya migongano katika kanuni ya hashing ya mvinyo kwa ajili ya kuzalisha fupi file majina.
Wateja kwenye macos au Linux wanashauriwa wasijenge kwa kutumia IAR nje ya Siplicity Studio. Wateja wanaofanya hivyo wanapaswa kuthibitisha kwa uangalifu kwamba ni sahihi files zinatumika.

GCC (Mkusanyiko wa Mkusanyaji wa GNU) toleo la 12.2.1, lililotolewa na Studio ya Urahisi.
Kipengele cha uboreshaji wa muda wa kiungo cha GCC kimezimwa, na kusababisha ongezeko kidogo la ukubwa wa picha.

SIFA MUHIMU

Uhamisho hadi Urahisi wa SDK Suite

Imeondoa usaidizi kwa Mfululizo wa 0/1
Usaidizi wa sasisho za firmware zilizobanwa kwa delta

Vipengee Vipya

Vipengele Vipya

Imeongezwa katika toleo la 7.0.1.0
Usaidizi wa Usasishaji wa Firmware ya Kifaa cha Mesh (DFU) unaotumia ukandamizaji bora wa delta, kulingana na kutambua tofauti kati ya matoleo mawili ya programu dhibiti, umeongezwa. Kipengele hiki kinahitaji matumizi ya toleo la zana ya Kamanda ambayo inasaidia kuchanganua tofauti za binary za ELF, pamoja na matumizi ya bootloader ambayo inasaidia kutumia sasisho la programu dhibiti iliyobanwa.

Imeongezwa katika toleo la 7.0.0.0
Usaidizi wa Kidhibiti Saa umeongezwa. Vijenzi vya rafu havitumii tena device_init() kuanzisha saa. Badala yake, mradi wa maombi lazima sasa ujumuishe kijenzi cha clock_manager, ambacho hufanya uanzishaji wa saa.
Usaidizi kwa Meneja wa Kumbukumbu ya Kawaida umeongezwa.

API mpya

Imeongezwa katika toleo la 7.0.0.0

Maboresho

Imebadilishwa katika toleo la 7.0.0.0

Mabadiliko ya BGAPI
Amri ya darasa la nodi ya BGAPI, sl_btmesh_node_test_identity, imeongezwa kwa kuangalia kama tangazo la utambulisho wa nodi iliyopokelewa inatoka kwa nodi fulani au la.

Exampmabadiliko ya maombi
Kipengele cha Nodi ya Nguvu ya Chini kimeongezwa kwa seva ya zamani ya Sensoramples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light), na kipengele cha Rafiki kiliongezwa kwa mteja wa zamani wa seva ya sensor.ample (btmesh_soc_sen-sor_client).

Masuala yasiyobadilika

Fasta katika kutolewa 7.0.2.0

ID #	Maelezo
1331888, 1334927, 1338088, 1338090	Imerekebisha hitilafu kadhaa za ugawaji kumbukumbu ambazo hazijashughulikiwa ambazo zinaweza kusababisha ajali wakati kifaa kimejaa trafiki.
1345827	Upotevu usiobadilika wa tukio la BGAPI la kisambazaji cha DFU la kuondolewa kwa nodi.
1301401	Hitilafu zisizobadilika za sasisho la hali ya seva wakati wa kupokea seva ya mwanga. Weka maombi kwa muda wa mpito.
1345411	Kumbukumbu isiyohamishika ya sl_memory_realloc() inayovuja, inayoongoza kwa msambazaji wa zamani wa DFUampna kukosa kumbukumbu.

Fasta katika kutolewa 7.0.1.0

ID #	Maelezo
1301325	Imesuluhisha suala katika kuhifadhi vitendo vya muundo wa Mratibu.
1305041	Suala la kuisha kwa muda lisilobadilika katika mawasiliano ya NCP kutoka kwa mwenyeji hadi EFR32.
1305928	Upotevu usiobadilika wa data sahihi ya orodha ya Wapokeaji katika matukio ya DFU baada ya kurekebisha tukio 1258654 kutekelezwa.
1319326	Imerekebisha thamani zisizo sahihi za hesabu za biti za uthibitishaji wa ingizo na towe.
1325194	Imerekebisha marudio yasiyo ya lazima ya tukio la hali ya kipokeaji cha mteja wa kisambazaji cha DFU baada ya kurekebisha tukio 1258654 kutekelezwa.
1310377	Kutatua tatizo katika programu ya IOP Relay. Hapo awali, iliangaza tu kwa kutumia GATT.

Fasta katika kutolewa 7.0.0.0

ID #	Maelezo
356148	Huepuka kuanzisha kibeba tangazo ikiwa nodi inatolewa kwa kutumia PB-GATT pekee.
1250461	Imefanya utoaji wa kuripoti tukio kuwa thabiti zaidi kwenye kifaa kilichopakiwa kupita kiasi.
1258654	Ilifanya tukio la DFU kuripoti kuwa thabiti zaidi kwenye kifaa kilichopakiwa kupita kiasi.
1274632	Miundo ya Kisambazaji cha DFU na Kisasisho Kinachojitegemea sasa itaripoti hitilafu ikiwa usanidi wa Uhamisho wa Blob kwenye nodi hautoshi.
1284204	Ulinzi thabiti wa kuhifadhi uchezaji wa marudiano kwa NVM3 wakati programu inatumia sl_btmesh_node_power_off() API.

Masuala Yanayojulikana Katika Toleo La Sasa

Masuala yenye herufi nzito yaliongezwa tangu toleo lililopita

ID #	Maelezo	Suluhu
401550	Hakuna tukio la BGAPI la kushindwa kwa utunzaji wa ujumbe uliogawanywa.	Programu inahitaji kubaini kutofaulu kutokana na kuisha kwa muda/ukosefu wa jibu la safu ya programu; kwa mifano ya wauzaji, API imetolewa.
454059	Idadi kubwa ya matukio muhimu ya mabadiliko ya hali ya uonyeshaji upya yanatolewa mwishoni mwa mchakato wa KR, na hiyo inaweza kufurika kwenye foleni ya NCP.	Ongeza urefu wa foleni ya NCP katika mradi.
454061	Uharibifu mdogo wa utendaji ikilinganishwa na 1.5 katika majaribio ya kusubiri ya safari ya kwenda na kurudi ulionekana.
624514	Tatizo la kuanzisha upya utangazaji unaoweza kuunganishwa ikiwa miunganisho yote imekuwa amilifu na proksi ya GATT inatumika.	Tenga muunganisho mmoja zaidi ya inavyohitajika.
841360	Utendaji duni wa uwasilishaji wa ujumbe uliogawanywa kwenye mtoaji wa GATT.	Hakikisha kwamba muda wa Muunganisho wa msingi wa BLE ni mfupi; hakikisha kuwa ATT MTU ni kubwa ya kutosha kutoshea PDU kamili ya Mesh; rekebisha urefu wa chini zaidi wa tukio la muunganisho ili kuruhusu pakiti nyingi za LL kutumwa kwa kila tukio la muunganisho.
1121605	Hitilafu za kuzunguka zinaweza kusababisha matukio yaliyopangwa kuanzishwa kwa nyakati tofauti kidogo kuliko inavyotarajiwa.
1226127	Mtoa huduma mwenyeji exampinaweza kukwama inapoanza kutoa nodi ya pili.	Anzisha upya programu ya mtoa huduma kabla ya kutoa nodi ya pili.
1204017	Kisambazaji hakiwezi kushughulikia Usasishaji wa FW binafsi na Upakiaji wa FW.	Usikimbilie sasisho la FW la kibinafsi na upakiaji wa FW sambamba.

Vipengee Vilivyoacha kutumika

Imeacha kutumika katika toleo la 7.0.0.0
Amri ya BGAPI sl_btmesh_prov_test_identity imeacha kutumika. Tumia sl_btmesh_node_test_identity badala yake.

Vipengee Vilivyoondolewa

Imeondolewa katika toleo la 7.0.0.0

Usaidizi wa maunzi ya Series 1 (xG12 na xG13) umeondolewa katika toleo hili.

Kwa Kutumia Toleo Hili

Toleo hili lina yafuatayo

Maabara ya Silicon Maktaba ya rafu ya matundu ya Bluetooth
Bluetooth mesh sampmaombi

Ikiwa wewe ni mtumiaji wa mara ya kwanza, angalia QSG176: Silicon Labs Bluetooth Mesh SDK v2. x Mwongozo wa Kuanza Haraka.

Ufungaji na Matumizi

SDK ya wavu wa Bluetooth imetolewa kama sehemu ya SDK ya Urahisi (GSDK), seti ya SDK za Silicon Labs.
Ili kuanza kwa haraka kutumia SDK ya Urahisi, sakinisha Studio ya Urahisi 5, ambayo itaweka mazingira yako ya usanidi na kukupitisha katika usakinishaji wa SDK wa Urahisi.
Urahisi Studio 5 inajumuisha kila kitu kinachohitajika kwa utengenezaji wa bidhaa za Iot kwa vifaa vya Silicon Labs, ikijumuisha rasilimali na kizindua mradi, zana za usanidi wa programu, IDE kamili iliyo na mnyororo wa zana wa GNU, na zana za uchambuzi.
Maagizo ya usakinishaji yametolewa katika Mwongozo wa Watumiaji wa Studio 5 wa Urahisi wa mtandaoni.
Vinginevyo, SDK ya Urahisi inaweza kusakinishwa mwenyewe kwa kupakua au kuiga ya hivi punde kutoka GitHub. Tazama https://github.com/Sili-conLabs/simplicity_sdk kwa taarifa zaidi.

Studio ya Urahisi husakinisha SDK ya Urahisi kwa chaguomsingi katika:
- Windows: C:\Watumiaji\ \SimplicityStudio\SDKs\simplicity_sdk
- MacOS: /Watumiaji/ /SimplicityStudio/SDKs/simplicity_sdk

Hati mahususi kwa toleo la SDK imesakinishwa kwa SDK. Maelezo ya ziada mara nyingi yanaweza kupatikana katika makala ya msingi ya maarifa (KBAs). Marejeleo ya API na maelezo mengine kuhusu toleo hili na matoleo ya awali yanapatikana https://docs.silabs.com/.

Taarifa za Usalama

Ushirikiano wa Vault salama
Toleo hili la rafu limeunganishwa na Usimamizi wa Ufunguo Salama wa Vault. Inapotumwa kwenye vifaa vya Secure Vault High, funguo za usimbaji fiche za wavu zinalindwa kwa kutumia utendakazi wa Kudhibiti Ufunguo wa Vault Salama. Jedwali hapa chini linaonyesha funguo zilizolindwa na sifa zao za ulinzi wa hifadhi.

Ufunguo	Usafirishaji kwenye nodi	Usafirishaji kwenye Mtoa huduma	Vidokezo
Kitufe cha mtandao	Inaweza kuhamishwa	Inaweza kuhamishwa	Utoaji wa ufunguo wa mtandao unapatikana tu kwenye RAM, wakati funguo za mtandao zimehifadhiwa kwenye flash.
Kitufe cha maombi	Isiyoweza kuuzwa nje	Inaweza kuhamishwa
Kitufe cha kifaa	Isiyoweza kuuzwa nje	Inaweza kuhamishwa	Katika hali ya Mtoa huduma, inatumika kwa ufunguo wa kifaa cha Mtoa huduma pamoja na funguo za vifaa vingine.

Vifunguo ambavyo vimewekwa alama kama "Zisizohamishika" vinaweza kutumika lakini haziwezi kutumika viewed au kushirikiwa wakati wa utekelezaji.

Vifunguo vilivyoalamishwa kama "Inaweza kuhamishwa" vinaweza kutumika au kushirikiwa wakati wa utekelezaji, lakini zibaki zikiwa zimesimbwa kwa njia fiche zikiwa zimehifadhiwa katika mweko.
Kwa maelezo zaidi kuhusu utendaji wa Usimamizi wa Ufunguo Salama wa Vault, angalia Hifadhi ya Ufunguo Salama ya AN1271.

Ushauri wa Usalama
Ili kujiandikisha kwa Ushauri wa Usalama, ingia kwenye tovuti ya mteja ya Silicon Labs, kisha uchague Nyumbani ya Akaunti. Bofya HOME ili kwenda kwenye ukurasa wa nyumbani wa tovuti kisha ubofye kigae cha Dhibiti Arifa. Hakikisha kuwa 'Ilani za Ushauri wa Programu/Usalama na Notisi za Mabadiliko ya Bidhaa (PCNS)' zimechaguliwa, na kwamba umesajiliwa kwa uchache zaidi kwa ajili ya mfumo na itifaki yako. Bofya Hifadhi ili kuhifadhi mabadiliko yoyote.

Kielelezo kifuatacho ni cha zamaniample.e

Msaada
Wateja wa Development Kit wanastahiki kupata mafunzo na usaidizi wa kiufundi. Tumia wavu wa Bluetooth wa Maabara ya Silicon web ukurasa ili kupata taarifa kuhusu bidhaa na huduma zote za Bluetooth za Silicon Labs, na kujisajili kwa usaidizi wa bidhaa.
Wasiliana na usaidizi wa Maabara ya Silicon kwa http://www.silabs.com/support.

Studio ya Unyenyekevu
Ufikiaji wa MCU na zana zisizotumia waya kwa mbofyo mmoja, uhifadhi wa hati, programu, maktaba ya msimbo wa chanzo na zaidi. Inapatikana kwa Windows, Mac na Linux

Usaidizi na Jumuiya
www.silabs.com/jumuiya

Kanusho

Silicon Labs inakusudia kuwapa wateja hati za hivi punde, sahihi na za kina za vifaa vya pembeni na moduli zote zinazopatikana kwa watekelezaji wa mfumo na programu wanaotumia au wanaokusudia kutumia bidhaa za SiliconLabsCharacterisationt dataa, moduli na vifaa vya pembeni vinavyopatikana, ukubwa wa kumbukumbu na anwani za kumbukumbu hurejelea kila kifaa mahususi, na "Vigezo vya kawaida vya programu na vifaa vinavyotolewa".

Maombi kwa mfanoampvilivyofafanuliwa hapa ni kwa madhumuni ya kielelezo pekee.
Silicon Labs inahifadhi haki ya kufanya mabadiliko bila taarifa zaidi kwa maelezo ya bidhaa, vipimo, na maelezo humu, na haitoi hakikisho kuhusu usahihi au ukamilifu wa maelezo yaliyojumuishwa.
Bila arifa ya awali, Maabara ya Silicon yanaweza kusasisha programu dhibiti ya bidhaa wakati wa mchakato wa utengenezaji kwa sababu za usalama au za kutegemewa. Mabadiliko kama haya hayatabadilisha vipimo au utendaji wa bidhaa. Silicon Labs haitakuwa na dhima kwa matokeo ya matumizi ya habari iliyotolewa katika hati hii.

Hati hii haimaanishi au kutoa leseni yoyote ya kubuni au kutengeneza saketi zilizounganishwa.
Bidhaa hazijaundwa au kuidhinishwa kutumika ndani ya vifaa vyovyote vya FDA Class III, maombi ambayo kibali cha soko la awali cha FDA kinahitajika, au Mifumo ya Usaidizi wa Maisha bila idhini mahususi iliyoandikwa ya Silicon Labs.
"Mfumo wa Usaidizi wa Maisha" ni bidhaa au mfumo wowote unaokusudiwa kusaidia au kudumisha maisha na/au afya, ambayo, ikiwa itashindwa, inaweza kutarajiwa kusababisha majeraha makubwa ya kibinafsi au kifo.

Bidhaa za Silicon Labs hazijaundwa au kuidhinishwa kwa matumizi ya kijeshi. Bidhaa za Silicon Labs hazitatumika kwa hali yoyote katika silaha za maangamizi makubwa, ikijumuisha (lakini sio tu) silaha za nyuklia, kibayolojia au kemikali, au makombora yenye uwezo wa kutoa silaha kama hizo.
Silicon Labs inakanusha dhamana zote za wazi na zilizodokezwa na haitawajibika au kuwajibika kwa majeraha au uharibifu wowote unaohusiana na matumizi ya bidhaa ya Silicon Labs katika programu ambazo hazijaidhinishwa.

Taarifa za Alama ya Biashara
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® na nembo ya Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, nembo ya Energy Micro na michanganyiko yake, "the world's most energy, the world's most energy, Redpines, Wink-Connectals, Wink Signals, Wink-Connectals" bora zaidi duniani. EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress® Zentri, nembo ya Zentri na Zentri DMS, Z-Wave®, na nyinginezo ni alama za biashara au alama za biashara zilizosajiliwa za Silicon Labs. ARM, CORTEX, Cortex-M3 na THUMB ni alama za biashara au alama za biashara zilizosajiliwa za ARM Holdings. Keil ni chapa ya biashara iliyosajiliwa ya ARM Limited. Wi-Fi ni chapa ya biashara iliyosajiliwa ya Muungano wa Wi-Fi. Bidhaa zingine zote au majina ya chapa yaliyotajwa hapa ni alama za biashara za wamiliki husika.

Kampuni ya Silicon Laboratories Inc.
400 West Cesar Chavez Avenue, Austin, TX 78701 USA
www.silabs.com

Maswali Yanayoulizwa Mara kwa Mara

Swali: Ninaweza kupata wapi maelezo zaidi kuhusu masasisho ya usalama?
A: Rejelea sura ya Usalama ya Vidokezo vya Kutolewa kwa Mfumo au tembelea ukurasa wa Vidokezo vya Kutolewa kwa Maabara ya Silicon kwa maelezo ya kina ya sasisho la usalama.

Swali: Je, ninajisajili vipi kwa Ushauri wa Usalama?
A: Silicon Labs inapendekeza kujiandikisha kwa Ushauri wa Usalama kwa maelezo ya kisasa. Fuata maagizo yaliyotolewa kwenye hati au wasiliana na usaidizi wa Maabara ya Silicon.

Nyaraka / Rasilimali

SILICON LABS Bluetooth Mesh SDK [pdf] Mwongozo wa Mmiliki
7.0.3.0, 7.0.2.0, 7.0.1.0, 7.0.0.0, Bluetooth Mesh SDK, Mesh SDK, SDK

Marejeleo

Mwongozo wa Mtumiaji

SILICON LABS Bluetooth Mesh SDK

Vipimo