Убудаванае праграмнае забеспячэнне SILICON LABS Bluetooth Mesh SDK

Тэхнічныя характарыстыкі прадукту

• Назва прадукту: Пакет Simplicity SDK
• Версія: 2024.6.0
• Дата выпуску: 5 чэрвеня 2024 г
• Версія спецыфікацыі Bluetooth Mesh: 1.1

Інструкцыя па ўжыванні прадукту

Bluetooth mesh - гэта новая тапалогія, даступная для прылад Bluetooth з нізкім энергаспажываннем (LE), якія забяспечваюць сувязь шмат-каму-многім (m:m). Ён аптымізаваны для стварэння буйнамаштабных сетак прылад і ідэальна падыходзіць для аўтаматызацыі будынкаў, сэнсарных сетак і адсочвання актываў. Наша праграмнае забеспячэнне і SDK для распрацоўкі Bluetooth падтрымліваюць функцыі Bluetooth Mesh і Bluetooth. Распрацоўшчыкі могуць дадаваць ячэістую сеткавую сувязь да такіх прылад LE, як падключаныя свяцільні, хатняя аўтаматызацыя і сістэмы адсочвання актываў. Праграмнае забеспячэнне таксама падтрымлівае Bluetooth-маякі, сканіраванне маякоў і злучэнні GATT, таму сетка Bluetooth можа падключацца да смартфонаў, планшэтаў і іншых прылад Bluetooth LE. Гэты выпуск уключае ў сябе функцыі, якія падтрымліваюцца сеткай спецыфікацыі Bluetooth версіі 1.1.

Гэтыя заўвагі да выпуску ахопліваюць версіі SDK:
7.0.0.0 выпушчана 5 чэрвеня 2024 г

Заўвагі аб сумяшчальнасці і выкарыстанні
Для атрымання дадатковай інфармацыі аб абнаўленнях сістэмы бяспекі і заўвагах глядзіце раздзел "Бяспека" Заўваг да выпуску платформы, усталяваных разам з гэтым SDK, або на старонцы Заўваг да выпуску Silicon Labs. Silicon Labs таксама настойліва рэкамендуе вам падпісацца на рэкамендацыі па бяспецы, каб атрымліваць актуальную інфармацыю. Каб атрымаць інструкцыі або калі вы пачатковец у Silicon Labs Bluetooth mesh SDK, гл. Выкарыстанне гэтага выпуску.

Сумяшчальныя кампілятары
IAR Embedded Workbench для ARM (IAR-EWARM) версія 9.40.1

• Выкарыстанне wine для стварэння з дапамогай утыліты каманднага радка IarBuild.exe або графічнага інтэрфейсу IAR Embedded Workbench у macOS або Linux можа прывесці да няправільнага files выкарыстоўваецца з-за сутыкненняў у алгарытме хэшавання wine для стварэння шорт file назвы.
• Кліентам macOS або Linux рэкамендуецца не ствараць з IAR па-за межамі Simplicity Studio. Кліенты, якія гэта робяць, павінны ўважліва пераканацца, што гэта правільна files выкарыстоўваюцца.

GCC (Калекцыя кампілятараў GNU) версія 12.2.1, пастаўляецца з Simplicity Studio.

• Функцыя аптымізацыі часу спасылкі GCC была адключана, што прывяло да нязначнага павелічэння памеру выявы.

Новыя прадметы
Simplicity SDK - гэта ўбудаваная платформа распрацоўкі праграмнага забеспячэння для стварэння прадуктаў IoT на аснове нашых бесправадных і MCU-прылад серыі 2 і 3. Ён аб'ядноўвае стэкі бесправадных пратаколаў, прамежкавае праграмнае забеспячэнне, драйверы перыферыйных прылад, загрузнік і прыкладанніamples – трывалая аснова для стварэння аптымізаваных па магутнасці і бяспечных прылад IoT. Simplicity SDK прапануе такія магутныя функцыі, як звышнізкае энергаспажыванне, высокая надзейнасць сеткі, падтрымка вялікай колькасці вузлоў і абстракцыя складаных патрабаванняў, такіх як мультыпратакольнасць і папярэдняя сертыфікацыя. Акрамя таго, Silicon Labs забяспечвае бесправадное (OTA) праграмнае забеспячэнне і абнаўленні бяспекі для дыстанцыйнага абнаўлення прылад, мінімізацыі выдаткаў на тэхнічнае абслугоўванне і павышэння якасці прадукту для канчатковага карыстальніка. Simplicity SDK з'яўляецца працягам нашага папулярнага Gecko SDK, які па-ранейшаму будзе даступны, забяспечваючы доўгатэрміновую падтрымку нашых прылад Series 0 і Series 1.

Для атрымання дадатковай інфармацыі аб прыладах серыі 0 і серыі 1 звярніцеся да: Прылада серыі 0 і серыі 1 EFM32/EZR32/EFR32 (silabs.com).

Новыя функцыі

Дададзена ў выпуску 7.0.0.0
Дададзена падтрымка Clock Manager. Кампаненты стэка больш не выкарыстоўваюць device_init() для ініцыялізацыі гадзінніка. Замест гэтага праект прыкладання цяпер павінен уключаць кампанент clock_manager, які выконвае ініцыялізацыю гадзінніка. Дададзена падтрымка Common Memory Manager.

Новыя API
Дададзена ў выпуску 7.0.0.0 Няма.

Паляпшэнні

• Каманда класа вузла BGAPI, sl_btmesh_node_test_identity, была дададзена для праверкі крыніц рэкламы ідэнтыфікацыі вузла.
• Функцыя Low Power Node дададзена на сервер Sensor, напрampлес.
• Функцыя сябра дададзена да кліента сервера датчыкаў, напрampле.

Зменена ў выпуску 7.0.0.0

• Змены BGAPI:
  Каманда класа вузла BGAPI, sl_btmesh_node_test_identity, была дададзена для праверкі, ці паходзіць атрыманая рэклама ідэнтыфікацыі вузла з дадзенага вузла.
• Exampзмены прыкладання:
  Функцыя Low Power Node была дададзена на сервер Sensor, напр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 Transfer на вузле недастаткова для мадэляў DFU Distributor і Standalone Updater.
• Выпраўлена захаванне абароны ад прайгравання ў NVM3 пры выкарыстанні API sl_btmesh_node_power_off().

Ідэнтыфікатар №	Апісанне
356148	Пазбягае запуску рэкламнага носьбіта, калі вузел падрыхтаваны толькі з выкарыстаннем PB-GATT.
1250461	Зроблены больш надзейнымі справаздачы аб падзеях забеспячэння на перагружанай прыладзе.
1258654	Зроблены больш надзейнымі справаздачы аб падзеях DFU на перагружанай прыладзе.
1274632	Мадэлі DFU Distributor і Standalone Updater цяпер будуць паведамляць пра памылку, калі канфігурацыя Blob Transfer на вузле недастатковая.
1284204	Выпраўлена захаванне абароны ад прайгравання ў NVM3, калі праграма выкарыстоўвае API sl_btmesh_node_power_off().

Вядомыя праблемы ў бягучым выпуску
Праблемы, вылучаныя тлустым шрыфтам, былі дададзены пасля папярэдняга выпуску.

• Няма падзеі BGAPI для збою апрацоўкі сегментаванага паведамлення.
• Патэнцыйнае запаўненне чаргі NCP падзеямі змены стану абнаўлення ключа.
• Невялікае пагаршэнне прадукцыйнасці ў тэстах затрымкі туды і назад у параўнанні з версіяй 1.5.
• Праблемы з аднаўленнем падключаемай рэкламы, калі ўсе злучэнні актыўныя і выкарыстоўваецца проксі GATT.
• Нізкая прадукцыйнасць сегментаванай перадачы паведамленняў праз канал GATT.

Ідэнтыфікатар №	Апісанне	Абыходны шлях
401550	Няма падзеі BGAPI для збою апрацоўкі сегментаванага паведамлення.	Прыкладанне павінна вывесці збой з тайм-аўту / адсутнасці адказу прыкладнога ўзроўню; для мадэляў пастаўшчыкоў быў прадастаўлены API.
454059	У канцы працэсу KR генеруецца вялікая колькасць падзей змены стану ключавога абнаўлення, якія могуць запоўніць чаргу NCP.	Павялічце даўжыню чаргі NCP у праекце.
454061	Назіралася невялікае пагаршэнне прадукцыйнасці ў параўнанні з 1.5 у тэстах затрымкі туды-назад.
624514	Праблема з аднаўленнем падключаемай рэкламы, калі ўсе злучэнні былі актыўныя і выкарыстоўваецца проксі GATT.	Вылучыце на адно злучэнне больш, чым неабходна.
841360	Нізкая прадукцыйнасць сегментаванай перадачы паведамленняў праз канал GATT.	Пераканайцеся, што інтэрвал злучэння асноўнага злучэння BLE кароткі; пераканайцеся, што MTU ATT дастаткова вялікі, каб змясціць поўны Mesh PDU; наладзіць мінімальную даўжыню падзеі злучэння, каб дазволіць перадачу некалькіх пакетаў LL на адну падзею злучэння.
1121605	Памылкі акруглення могуць прывесці да запуску запланаваных падзей у час, які крыху адрозніваецца ад чаканага.
1226127	Арганізатар хоста, напрample можа затрымацца, калі ён пачынае прадастаўляць другі вузел.	Перазапусціце праграму забеспячэння хоста перад падрыхтоўкай другога вузла.
1204017	Дыстрыб'ютар не можа апрацоўваць паралельнае самастойнае абнаўленне FW і загрузку FW.	Не запускайце самастойнае абнаўленне FW і загрузку FW паралельна.
1301325	Дзеянні планавальніка няправільна захоўваюцца ў пастаянным сховішчы.
1305041	Звязка NCP ад хоста да EFR32 можа скончыцца.	sl_simple_com_usart.c можна рэдагаваць, каб выправіць значэнне тайм-аўту.
1305928	Наладжванне 10 або больш вузлоў абнаўлення ў якасці прымачоў DFU можа не атрымацца ў праграме-дыстрыбутары SoC.

Састарэлыя элементы
Састарэла ў выпуску 7.0.0.0
Каманда BGAPI sl_btmesh_prov_test_identity прызнана састарэлай. Замест гэтага выкарыстоўвайце sl_btmesh_node_test_identity.

Выдаленыя элементы
Выдалена ў выпуску 7.0.0.0
Падтрымка абсталявання серыі 1 (xG12 і xG13) была выдалена ў гэтым выпуску.

Выкарыстанне гэтага выпуску
Гэты выпуск змяшчае наступнае

• Бібліятэка сеткавых стэкаў Bluetooth Silicon Labs
• Bluetooth mesh sample прыкладанняў

Калі вы ўпершыню карыстаецеся, глядзіце QSG176: Кароткае кіраўніцтва Silicon Labs Bluetooth Mesh SDK v2.x.

Ўстаноўка і выкарыстанне
Bluetooth mesh SDK прадастаўляецца як частка Simplicity SDK (GSDK), набору SDK Silicon Labs. Каб хутка пачаць працу з Simplicity SDK, усталюйце Simplicity Studio 5, якая наладзіць ваша асяроддзе распрацоўкі і правядзе вас па ўсталёўцы Simplicity SDK. Simplicity Studio 5 уключае ўсё неабходнае для распрацоўкі прадуктаў IoT з прыладамі Silicon Labs, у тым ліку праграму запуску рэсурсаў і праектаў, інструменты канфігурацыі праграмнага забеспячэння, поўную IDE з ланцужком інструментаў GNU і інструменты аналізу. Інструкцыі па ўсталёўцы прадстаўлены ў онлайн-кіраўніцтве карыстальніка 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. Дадатковую інфармацыю часта можна знайсці ў артыкулах базы ведаў (KBA). Спасылкі на API і іншая інфармацыя пра гэты і больш раннія выпускі даступныя на https://docs.silabs.com/.

Інфармацыя аб бяспецы

ключ	Магчымасць экспарту на вузел	Магчымасць экспарту на Provisioner	Заўвагі
Сеткавы ключ	Экспартны	Экспартны	Вытворныя сеткавага ключа існуюць толькі ў аператыўнай памяці, а сеткавыя ключы захоўваюцца на флэш-памяці
Ключ прыкладання	Невывазныя	Экспартны
Ключ прылады	Невывазныя	Экспартны	У выпадку Provisioner прымяняецца да ключа ўласнай прылады Provisionerr, а таксама да ключоў іншых прылад

Інтэграцыя бяспечнага сховішча
Гэтая версія стэка інтэграваная з Secure Vault Key Management. Пры разгортванні на прыладах Secure Vault High ключы шыфравання mesh абаронены з дапамогай функцыі кіравання ключамі Secure Vault. У табліцы ніжэй паказаны абароненыя ключы і іх характарыстыкі абароны захоўвання.

• Ключы, пазначаныя як «Неэкспартаваныя», можна выкарыстоўваць, але нельга viewрэд. або агульны доступ падчас выканання.
• Ключы, пазначаныя як «Экспартабельныя», могуць выкарыстоўвацца або абагульвацца падчас выканання, але застаюцца зашыфраванымі падчас захоўвання ва флэш-памяці.
• Для атрымання дадатковай інфармацыі аб функцыянальнасці Secure Vault Key Management, гл. AN1271: Бяспечнае сховішча ключоў.

Рэкамендацыі па бяспецы
Каб падпісацца на рэкамендацыі па бяспецы, увайдзіце на партал кліентаў Silicon Labs, затым выберыце Галоўная старонка ўліковага запісу. Націсніце ГАЛОЎНАЯ, каб перайсці на галоўную старонку партала, а затым націсніце плітку Кіраванне апавяшчэннямі. Упэўніцеся, што адзначана "Паведамленні аб праграмным забеспячэнні/рэкамендацыі па бяспецы і паведамленні аб змене прадукту (PCN)", і што вы падпісаны як мінімум на сваю платформу і пратакол. Націсніце "Захаваць", каб захаваць змены.

Падтрымка
Кліенты Development Kit маюць права на навучанне і тэхнічную падтрымку. Выкарыстоўвайце Bluetooth-сетку Silicon Labs 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 не нясе адказнасці за наступствы выкарыстання інфармацыі, прадстаўленай у гэтым дакуменце. Гэты дакумент не прадугледжвае і не дае прама якой-небудзь ліцэнзіі на распрацоўку або выраб інтэгральных схем. Прадукты не прызначаныя і не дазволеныя для выкарыстання ў прыладах класа III FDA, прыкладаннях, для якіх патрабуецца адабрэнне FDA на рынку, або ў сістэмах жыццезабеспячэння без спецыяльнай пісьмовай згоды Silicon Labs. «Сістэма жыццезабеспячэння» - гэта любы прадукт або сістэма, прызначаная для падтрымання або падтрымання жыцця і/або здароўя, якая, калі яна выйдзе з ладу, можа разумна чакаць, што прывядзе да сур'ёзных цялесных пашкоджанняў або смерці. Прадукцыя 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, the 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. Усе іншыя прадукты або гандлёвыя маркі, згаданыя тут, з'яўляюцца гандлёвымі маркамі іх адпаведных уладальнікаў.

Часта задаюць пытанні (FAQ)

Пытанне: Дзе я магу знайсці дадатковую інфармацыю аб абнаўленнях бяспекі?
A: Звярніцеся да раздзела "Бяспека" Заўваг да выпуску платформы або наведайце старонку Заўваг да выпуску Silicon Labs для атрымання падрабязных абнаўленняў бяспекі.

Пытанне: Як уключыць кампанент clock_manager для ініцыялізацыі гадзінніка?
A: Каб уключыць кампанент clock_manager для ініцыялізацыі гадзінніка, не забудзьцеся абнавіць праект вашага прыкладання адпаведна ў адпаведнасці з інструкцыямі ў кіраўніцтве карыстальніка.

Кампанія Silicon Laboratories Inc.
400 Захад Сезар Чавес
Осцін, Тэхас 78701
ЗША
www.silabs.com

Партфоліо IoT
www.silabs.com/IoT

SW/HW
www.silabs.com/simplicity

Якасць
www.silabs.com/quality

Падтрымка і супольнасць
www.silabs.com/community

Дакументы / Рэсурсы

Убудаванае праграмнае забеспячэнне SILICON LABS Bluetooth Mesh SDK [pdfКіраўніцтва карыстальніка Убудаванае праграмнае забеспячэнне Bluetooth Mesh SDK, убудаванае праграмнае забеспячэнне Mesh SDK, убудаванае праграмнае забеспячэнне SDK, убудаванае праграмнае забеспячэнне, праграмнае забеспячэнне

Спасылкі

• Кіраўніцтва карыстальніка