SILICON LABS Bluetooth Mesh SDK енгізілген бағдарламалық құрал

Өнімнің техникалық сипаттамалары

• Өнім атауы: Simplicity SDK Suite
• Нұсқа: 2024.6.0
• Шығарылған күні: 5 жылғы 2024 маусым
• Bluetooth Mesh спецификациясының нұсқасы: 1.1

Өнімді пайдалану нұсқаулары

Bluetooth торы - көптен көпке (м:м) байланысты мүмкіндік беретін Bluetooth төмен энергия (LE) құрылғылары үшін қолжетімді жаңа топология. Ол ауқымды құрылғылар желілерін құру үшін оңтайландырылған және автоматтандыру, сенсорлық желілер және активтерді бақылау үшін өте қолайлы. Біздің бағдарламалық құрал мен Bluetooth әзірлеуге арналған SDK Bluetooth Mesh және Bluetooth функцияларын қолдайды. Әзірлеушілер қосылған шамдар, үйді автоматтандыру және активтерді бақылау жүйелері сияқты LE құрылғыларына торлы желі байланысын қоса алады. Бағдарламалық құрал сонымен қатар Bluetooth сигналын, маякты сканерлеуді және GATT қосылымдарын қолдайды, осылайша Bluetooth торы смартфондарға, планшеттерге және басқа Bluetooth LE құрылғыларына қосыла алады. Бұл шығарылым Bluetooth тор спецификациясының 1.1 нұсқасы қолдайтын мүмкіндіктерді қамтиды.

Бұл шығарылым жазбалары SDK нұсқаларын қамтиды:
7.0.0.0 5 жылдың 2024 маусымында шығарылды

Үйлесімділік және пайдалану туралы ескертулер
Қауіпсіздік жаңартулары мен ескертулері туралы қосымша ақпаратты осы SDK немесе Silicon Labs шығарылым жазбалары бетінде орнатылған Platform Release Notes бағдарламасының Қауіпсіздік тарауын қараңыз. Silicon Labs сонымен қатар соңғы ақпарат алу үшін Қауіпсіздік кеңестеріне жазылуды ұсынады. Нұсқауларды немесе Silicon Labs Bluetooth mesh SDK жүйесінде жаңадан болсаңыз, Осы шығарылымды пайдалану бөлімін қараңыз.

Үйлесімді компиляторлар
ARM (IAR-EWARM) 9.40.1 нұсқасына арналған IAR ендірілген жұмыс үстелі

• MacOS немесе Linux жүйесінде IarBuild.exe пәрмен жолы утилитасымен немесе IAR ендірілген жұмыс үстелі графикалық интерфейсімен құру үшін шарапты пайдалану қатеге әкелуі мүмкін. files қысқа генерациялау үшін шараптың хэштеу алгоритміндегі соқтығыстарға байланысты пайдаланылады file атаулар.
• macOS немесе Linux жүйесіндегі тұтынушыларға Simplicity Studio қолданбасынан тыс IAR көмегімен құрастырмауға кеңес беріледі. Мұны жасайтын тұтынушылар дұрыстығын мұқият тексеруі керек fileлар қолданылуда.

Simplicity Studio бағдарламасымен қамтамасыз етілген GCC (GNU Compiler Collection) 12.2.1 нұсқасы.

• GCC байланыс уақытын оңтайландыру мүмкіндігі өшірілді, нәтижесінде кескін өлшемі аздап ұлғайды.

Жаңа элементтер
Simplicity SDK — 2 және 3 сериялы сымсыз және MCU құрылғыларымызға негізделген IoT өнімдерін жасауға арналған ендірілген бағдарламалық жасақтаманы әзірлеу платформасы. Ол сымсыз протокол стектерін, аралық бағдарламалық құралды, перифериялық драйверлерді, жүктегішті және бұрынғы қолданбаларды біріктіреді.amples – қуатты оңтайландырылған және қауіпсіз IoT құрылғыларын құруға арналған берік негіз. Simplicity SDK ультра төмен қуат тұтыну, күшті желі сенімділігі, көптеген түйіндерді қолдау және мультипротокол және алдын ала сертификаттау сияқты күрделі талаптарды абстракциялау сияқты қуатты мүмкіндіктерді ұсынады. Сонымен қатар, Silicon Labs құрылғыларды қашықтан жаңарту, техникалық қызмет көрсету шығындарын азайту және түпкі пайдаланушының өнім тәжірибесін жақсарту үшін ауадан (OTA) бағдарламалық құрал мен қауіпсіздік жаңартуларын ұсынады. Simplicity SDK — біздің танымал Gecko SDK бағдарламасының жалғасы, ол 0 және 1 сериялы құрылғыларымызға ұзақ мерзімді қолдау көрсете отырып, қолжетімді болады.

Series 0 және Series 1 құрылғылары туралы қосымша ақпаратты мына жерден қараңыз: 0 сериясы және 1 серия EFM32/EZR32/EFR32 құрылғысы (silabs.com).

Жаңа мүмкіндіктер

7.0.0.0 шығарылымында қосылды
Сағат менеджеріне қолдау қосылды. Стек құрамдастары бұдан былай сағатты инициализациялау үшін device_init() қолданбайды. Оның орнына, қолданба жобасы енді сағатты инициализациялауды жүзеге асыратын clock_manager құрамдасын қамтуы керек. Common Memory Manager қолдауы қосылды.

Жаңа API интерфейстері
7.0.0.0 шығарылымында қосылды Ешбір.

Жақсартулар

• Түйіннің идентификациялық хабарландыру көздерін тексеру үшін BGAPI класының түйін командасы, sl_btmesh_node_test_identity қосылды.
• Төмен қуат түйіні мүмкіндігі сенсор серверіне қосылды, мысалыamples.
• Дос мүмкіндігі сенсор сервер клиентіне қосылды, бұрынғыampле.

7.0.0.0 шығарылымында өзгертілді

• BGAPI өзгерістері:
  Түйіннің BGAPI сыныбы пәрмені, sl_btmesh_node_test_identity, алынған түйін идентификациялық хабарландырудың берілген түйіннен шыққанын немесе жоқтығын тексеру үшін қосылды.
• Exampқолданбадағы өзгерістер:
  Төмен қуат түйіні мүмкіндігі сенсор серверіне қосылды, мысалыamples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light) және Friend мүмкіндігі сенсор сервер клиентіне қосылды.ample (btmesh_soc_sen-sor_client).

Түзетілген мәселелер
7.0.0.0 шығарылымында түзетілді

• Түйін тек PB-GATT арқылы қамтамасыз етілсе, жарнама берушіні бастаудан аулақ болыңыз.
• Шамадан тыс жүктелген құрылғыдағы жағдай туралы есеп беру жақсартылған.
• Шамадан тыс жүктелген құрылғыдағы жақсартылған DFU оқиғасы туралы есеп беру.
• Түйіндегі Blob тасымалдау конфигурациясы DFU дистрибьюторы және автономды жаңартушы үлгілері үшін жеткіліксіз болса, қате туралы есеп қосылды.
• sl_btmesh_node_power_off() API пайдалану кезінде NVM3 жүйесіне қайта ойнатудан қорғауды сақтау түзетілді.

ID №	Сипаттама
356148	Түйін тек PB-GATT арқылы қамтамасыз етілсе, жарнаманы бастаудан аулақ болады.
1250461	Шамадан тыс жүктелген құрылғыда дайындау оқиғасы туралы есеп беруді сенімдірек етті.
1258654	Шамадан тыс жүктелген құрылғыда DFU оқиғасы туралы есеп беруді сенімдірек етті.
1274632	Түйіндегі Blob тасымалдау конфигурациясы жеткіліксіз болса, DFU дистрибьюторы және автономды жаңартушы үлгілері енді қате туралы хабарлайды.
1284204	Қолданба sl_btmesh_node_power_off() API пайдаланған кезде NVM3 жүйесіне қайта ойнатудан қорғауды сақтау түзетілді.

Ағымдағы шығарылымдағы белгілі мәселелер
Алдыңғы шығарылымнан бастап қалың қаріппен жазылған мәселелер қосылды.

• Сегменттелген хабарды өңдеу қатесі үшін BGAPI оқиғасы жоқ.
• Негізгі жаңарту күйін өзгерту оқиғаларымен NCP кезегін ықтимал су басуы.
• 1.5 нұсқасымен салыстырғанда бару кідіріс сынақтарында өнімділіктің аздап төмендеуі.
• Барлық қосылымдар белсенді болса және GATT проксиі қолданылса, қосылатын жарнаманы қалпына келтіруге қатысты мәселелер.
• GATT тасымалдаушысы арқылы сегменттелген хабарламаны жіберудің нашар өнімділігі.

ID №	Сипаттама	Шешім
401550	Сегменттелген хабарды өңдеу қатесі үшін BGAPI оқиғасы жоқ.	Қолданба күту уақыты/қолданбалы қабат жауапының жоқтығынан сәтсіздікті шығаруы керек; жеткізуші үлгілері үшін API қамтамасыз етілген.
454059	Негізгі жаңарту күйін өзгерту оқиғаларының үлкен саны KR процесінің соңында жасалады және бұл NCP кезегін толтыруы мүмкін.	Жобадағы NCP кезегінің ұзындығын ұлғайту.
454061	Айналмалы кідіріс сынақтарындағы 1.5-пен салыстырғанда өнімділіктің шамалы төмендеуі байқалды.
624514	Барлық қосылымдар белсенді болса және GATT проксиі қолданылса, қосылатын жарнаманы қайта орнату мәселесі.	Қажеттіден бір қосылымды көбірек бөліңіз.
841360	GATT тасымалдаушысы арқылы сегменттелген хабарламаны жіберудің нашар өнімділігі.	Негізгі BLE қосылымының Қосылым аралығы қысқа екеніне көз жеткізіңіз; ATT MTU толық Mesh PDU сыйымдылығы үшін жеткілікті үлкен болуын қамтамасыз етіңіз; қосылым оқиғасына бірнеше LL пакеттерін жіберуге мүмкіндік беру үшін ең аз қосылым оқиғасының ұзындығын реттеңіз.
1121605	Дөңгелектеу қателері жоспарланған оқиғалардың күтілгеннен біршама басқа уақытта іске қосылуын тудыруы мүмкін.
1226127	Хост провайдері бұрынғыample екінші түйінді қамтамасыз ете бастағанда тұрып қалуы мүмкін.	Екінші түйінді дайындамас бұрын хост провайдер қолданбасын қайта іске қосыңыз.
1204017	Дистрибьютор FW жаңартуын және кері жүктеуді параллельді өздігінен өңдей алмайды.	Өздігінен FW жаңартуын және FW жүктеп салуды параллель орындамаңыз.
1301325	Жоспарлағыш әрекеттері тұрақты жадқа дұрыс сақталмаған.
1305041	Хосттан EFR32-ге NCP байланысы күту бітуі мүмкін.	sl_simple_com_usart.c күту уақыты мәнін түзету үшін өңделуі мүмкін.
1305928	DFU қабылдағыштары ретінде 10 немесе одан да көп жаңарту түйіндерін орнату SoC дистрибьютор қолданбасында сәтсіз болуы мүмкін.

Ескірген элементтер
7.0.0.0 шығарылымында ескірген
BGAPI пәрмені sl_btmesh_prov_test_identity ескірген. Оның орнына sl_btmesh_node_test_identity пайдаланыңыз.

Жойылған элементтер
7.0.0.0 шығарылымында жойылды
Бұл шығарылымда 1 сериялы аппараттық құралға (xG12 және xG13) қолдау жойылды.

Осы шығарылымды пайдалану
Бұл шығарылым келесілерді қамтиды

• Silicon Labs Bluetooth торлы стек кітапханасы
• Bluetooth торы сampқолданбалар

Егер сіз бірінші рет пайдаланушы болсаңыз, QSG176: Silicon Labs Bluetooth Mesh SDK v2.x жылдам бастау нұсқаулығын қараңыз.

Орнату және пайдалану
Bluetooth торлы SDK Simplicity SDK (GSDK), Silicon Labs SDK жиынтығының бөлігі ретінде қамтамасыз етілген. Simplicity SDK-мен жылдам бастау үшін Simplicity Studio 5 бағдарламасын орнатыңыз, ол әзірлеу ортаңызды орнатады және Simplicity SDK орнатуы арқылы сізді көрсетеді. Simplicity Studio 5 IoT өнімдерін Silicon Labs құрылғыларымен әзірлеуге қажеттінің барлығын қамтиды, соның ішінде ресурс пен жобаны іске қосу құралы, бағдарламалық құрал конфигурациялау құралдары, GNU құралдар тізбегі бар толық IDE және талдау құралдары. Орнату нұсқаулары онлайн Simplicity Studio 5 пайдаланушы нұсқаулығында берілген. Немесе Simplicity SDK GitHub сайтынан ең соңғысын жүктеп алу немесе клондау арқылы қолмен орнатылуы мүмкін. Қараңыз https://github.com/Sili-conLabs/simplicity_sdk қосымша ақпарат алу үшін.

Simplicity Studio әдепкі бойынша Simplicity SDK файлын мына жерде орнатады:

• Windows:
  • C:\Пайдаланушылар\ \SimplicityStudio\SDKs\simplicity_sdk
• MacOS: /Пайдаланушылар/ /SimplicityStudio/SDKs/simplicity_sdk
  SDK нұсқасына тән құжаттама SDK көмегімен орнатылады. Қосымша ақпаратты жиі білім қоры мақалаларынан (КБА) табуға болады. API сілтемелері және осы және бұрынғы шығарылымдар туралы басқа ақпарат мына жерде қолжетімді https://docs.silabs.com/.

Қауіпсіздік туралы ақпарат

Кілт	Түйінде экспорттау мүмкіндігі	Провайдердегі экспорттау мүмкіндігі	Ескертпелер
Желі кілті	Экспортталатын	Экспортталатын	Желілік кілттің туындылары тек жедел жадта болады, ал желі кілттері флэште сақталады
Қолданба кілті	Экспортталмайды	Экспортталатын
Құрылғы кілті	Экспортталмайды	Экспортталатын	Провайдер жағдайында, Provisionerr-дің жеке құрылғы кілтіне, сондай-ақ басқа құрылғылардың кілттеріне қолданылады

Қауіпсіз қойма интеграциясы
Стектің бұл нұсқасы Secure Vault Key Management бағдарламасымен біріктірілген. Secure Vault High құрылғыларына орналастырылған кезде торлы шифрлау кілттері Secure Vault Key Management функциясы арқылы қорғалады. Төмендегі кесте қорғалған кілттерді және олардың сақтауды қорғау сипаттамаларын көрсетеді.

• «Экспортталмайтын» деп белгіленген кілттерді пайдалануға болады, бірақ мүмкін емес viewed немесе орындау уақытында ортақ.
• «Экспортталатын» деп белгіленген кілттерді орындау уақытында пайдалануға немесе ортақ пайдалануға болады, бірақ флеште сақталған кезде шифрланған күйде қалады.
• Secure Vault Key Management функциясы туралы қосымша ақпарат алу үшін, AN1271 қараңыз: Қауіпсіз кілт қоймасы.

Қауіпсіздік кеңестері
Қауіпсіздік кеңестеріне жазылу үшін Silicon Labs тұтынушы порталына кіріңіз, содан кейін Есептік жазбаның негізгі бетін таңдаңыз. Порталдың басты бетіне өту үшін HOME түймесін басыңыз, содан кейін Хабарландыруларды басқару тақтасын басыңыз. "Бағдарламалық қамтамасыз ету/қауіпсіздік бойынша кеңестік ескертулер және өнімді өзгерту туралы ескертулер (PCNs)" тексерілгеніне және платформаңыз бен протоколыңызға кемінде жазылғаныңызды тексеріңіз. Кез келген өзгертулерді сақтау үшін Сақтау түймесін басыңыз.

Қолдау
Development Kit тұтынушылары оқытуға және техникалық қолдауға құқылы. Silicon Labs Bluetooth торын пайдаланыңыз web барлық Silicon Labs Bluetooth өнімдері мен қызметтері туралы ақпаратты алу және өнімді қолдау қызметіне жазылу үшін бет.
Silicon Laboratories қолдау қызметіне хабарласыңыз http://www.silabs.com/support.

Қарапайымдылық студиясы
MCU және сымсыз құралдарға, құжаттамаға, бағдарламалық құралға, бастапқы код кітапханаларына және т.б. бір рет басу арқылы қол жеткізу. Windows, Mac және Linux үшін қол жетімді!

Жауапкершіліктен бас тарту
Silicon Labs тұтынушыларға Silicon Labs өнімдерін пайдаланатын немесе пайдаланғысы келетін жүйелік және бағдарламалық құралды іске асырушылар үшін қол жетімді барлық перифериялық құрылғылар мен модульдердің соңғы, дәл және тереңдетілген құжаттамасын ұсынуға ниетті. Сипаттама деректері, қол жетімді модульдер мен перифериялық құрылғылар, жад өлшемдері мен жад мекенжайлары әрбір нақты құрылғыға қатысты және берілген «Типтік» параметрлер әртүрлі қолданбаларда әр түрлі болуы мүмкін. Өтініш, мысалыampМұнда сипатталған мәліметтер тек көрнекі мақсаттарға арналған. Silicon Labs осы құжаттағы өнім туралы ақпаратқа, техникалық сипаттамаларға және сипаттамаларға қосымша ескертусіз өзгертулер енгізу құқығын өзіне қалдырады және енгізілген ақпараттың дәлдігі мен толықтығына кепілдік бермейді. Алдын ала ескертусіз Silicon Labs қауіпсіздік немесе сенімділік себептері үшін өндіріс процесі кезінде өнімнің микробағдарламасын жаңартуы мүмкін. Мұндай өзгертулер өнімнің техникалық сипаттамаларын немесе өнімділігін өзгертпейді. Silicon Labs компаниясы осы құжатта берілген ақпаратты пайдаланудың салдары үшін жауапкершілік көтермейді. Бұл құжат қандай да бір интегралдық микросхемаларды жобалауға немесе жасауға қандай да бір лицензияны білдірмейді немесе тікелей бермейді. Өнімдер FDA III класы құрылғыларында, FDA алдын ала рұқсаты қажет қолданбаларда немесе Silicon Labs компаниясының арнайы жазбаша келісімінсіз Life Support Systems жүйесінде пайдалануға арналмаған немесе рұқсат етілмеген. «Тіршілікті қолдау жүйесі» өмірді және/немесе денсаулықты қолдауға немесе қолдауға арналған кез келген өнім немесе жүйе, егер ол сәтсіз болса, елеулі жарақатқа немесе өлімге әкелуі мүмкін деп күтуге болады. Silicon Labs өнімдері әскери қолданбаларға арналмаған немесе рұқсат етілмеген. Silicon Labs өнімдері ешбір жағдайда жаппай қырып-жою қаруында, соның ішінде (бірақ олармен шектелмей) ядролық, биологиялық немесе химиялық қаруларда немесе осындай қаруды жеткізуге қабілетті зымырандарда пайдаланылмауы керек. Silicon Labs барлық айқын және болжамды кепілдіктерден бас тартады және Silicon Labs өнімін осындай рұқсат етілмеген қолданбаларда пайдалануға байланысты кез келген жарақаттар немесе зақымдар үшін жауапты емес немесе жауапты емес.

Ескерту: Бұл мазмұнда қазір ескірген қорлайтын терминология болуы мүмкін. Silicon Labs мүмкіндігінше бұл терминдерді инклюзивті тілмен ауыстырады. Қосымша ақпарат алу үшін мына сайтқа кіріңіз www.silabs.com/about-us/inclusive-lexicon-project

Сауда белгісі туралы ақпарат
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® және Silicon Labs логотипі®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro логотипі және олардың комбинациялары , «әлемдегі ең энергияға қолайлы микроконтроллерлер», Redpine Signals®, WiSeConnect, n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress®, Zentri, Zentri логотипі және Zentri DMS, Z-Wave® және басқалары Silicon Labs компаниясының сауда белгілері немесе тіркелген сауда белгілері. ARM, CORTEX, Cortex-M3 және THUMB — ARM Holdings компаниясының сауда белгілері немесе тіркелген сауда белгілері. Keil - ARM Limited компаниясының тіркелген сауда белгісі. Wi-Fi — Wi-Fi Alliance компаниясының тіркелген сауда белгісі. Мұнда аталған барлық басқа өнімдер немесе бренд атаулары олардың тиісті иелерінің сауда белгілері болып табылады.

Жиі қойылатын сұрақтар (ЖҚС)

С: Қауіпсіздік жаңартулары туралы қосымша ақпаратты қайдан табуға болады?
A: Қауіпсіздіктің егжей-тегжейлі жаңартулары үшін Platform Release Notes бағдарламасының Қауіпсіздік тарауын қараңыз немесе Silicon Labs Release Notes бетіне кіріңіз.

С: Сағатты инициализациялау үшін clock_manager компонентін қалай қосуға болады?
A: Сағатты инициализациялауға арналған clock_manager құрамдас бөлігін қосу үшін қолданба жобасын пайдаланушы нұсқаулығында берілген нұсқауларға сәйкес сәйкесінше жаңартыңыз.

Silicon Laboratories Inc.
400 Батыс Сезар Чавес
Остин, TX 78701
АҚШ
www.silabs.com

IoT портфолиосы
www.silabs.com/IoT

БҚ/ЖҚ
www.silabs.com/simplicity

Сапасы
www.silabs.com/quality

Қолдау және қауымдастық
www.silabs.com/community

Құжаттар / Ресурстар

SILICON LABS Bluetooth Mesh SDK енгізілген бағдарламалық құрал [pdf] Пайдаланушы нұсқаулығы Bluetooth Mesh SDK ендірілген бағдарламалық құрал, Mesh SDK ендірілген бағдарламалық құрал, SDK ендірілген бағдарламалық құрал, ендірілген бағдарламалық құрал, бағдарламалық құрал

Анықтамалар

• Пайдаланушы нұсқаулығы