Вбудоване програмне забезпечення SILICON LABS Bluetooth Mesh SDK

Технічні характеристики продукту

• Назва продукту: Simplicity SDK Suite
• Версія: 2024.6.0
• Дата виходу: 5 червня 2024 р
• Версія специфікації Bluetooth Mesh: 1.1

Інструкція з використання продукту

Bluetooth mesh — це нова топологія, доступна для пристроїв Bluetooth Low Energy (LE), які забезпечують зв’язок «багато-до-багатьох» (m:m). Він оптимізований для створення великомасштабних мереж пристроїв і ідеально підходить для автоматизації будівель, сенсорних мереж і відстеження активів. Наше програмне забезпечення та SDK для розробки Bluetooth підтримують функції Bluetooth Mesh і Bluetooth. Розробники можуть додавати мережевий зв’язок до таких пристроїв LE, як під’єднані світильники, домашня автоматизація та системи відстеження активів. Програмне забезпечення також підтримує Bluetooth-маяки, сканування маяків і з’єднання GATT, щоб сітка Bluetooth могла підключатися до смартфонів, планшетів та інших пристроїв Bluetooth LE. Цей випуск містить функції, які підтримуються специфікацією Bluetooth mesh версії 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

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

GCC (Колекція компіляторів GNU) версії 12.2.1, надається разом із Simplicity Studio.

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

Нові предмети
Simplicity SDK — це вбудована платформа розробки програмного забезпечення для створення продуктів IoT на основі наших бездротових пристроїв Series 2 і Series 3 і MCU. Він інтегрує стеки бездротових протоколів, проміжне програмне забезпечення, периферійні драйвери, завантажувач і додатки examples – надійна основа для створення безпечних пристроїв IoT з оптимізованою потужністю. Simplicity SDK пропонує такі потужні функції, як наднизьке енергоспоживання, висока надійність мережі, підтримка великої кількості вузлів і абстракція складних вимог, таких як багатопротокольність і попередня сертифікація. Крім того, Silicon Labs надає бездротове (OTA) програмне забезпечення та оновлення безпеки для віддаленого оновлення пристроїв, мінімізації витрат на технічне обслуговування та покращення взаємодії з продуктом для кінцевого користувача. Simplicity SDK є продовженням нашого популярного Gecko SDK, який і надалі буде доступним, надаючи довгострокову підтримку для наших пристроїв Series 0 і Series 1.

Щоб отримати додаткову інформацію про пристрої Series 0 і Series 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 додана до сервера датчиків, напрampлес.
• До клієнта сервера датчиків додано функцію «Друг», напрample.

Змінено у версії 7.0.0.0

• Зміни BGAPI:
  Додано команду класу вузла BGAPI, sl_btmesh_node_test_identity, щоб перевірити, чи походить отримане оголошення про ідентифікацію вузла від даного вузла чи ні.
• Exampзміни програми:
  Функцію Low Power Node додано до сервера Sensor examples (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 та автономного засобу оновлення.
• Виправлено збереження захисту від відтворення в NVM3 під час використання API sl_btmesh_node_power_off().

ID №	опис
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.

ID №	опис	Обхідний шлях
401550	Немає події BGAPI для помилки обробки сегментованого повідомлення.	Додатку потрібно визначити помилку через тайм-аут/відсутність відповіді прикладного рівня; для моделей постачальників надано API.
454059	Велика кількість подій зміни стану оновлення ключа генерується в кінці процесу KR, і це може переповнити чергу NCP.	Збільшити довжину черги NCP у проекті.
454061	Спостерігалося невелике зниження продуктивності порівняно з 1.5 у тестах затримки в обидві сторони.
624514	Проблема з повторним встановленням підключеної реклами, якщо всі з’єднання були активними та використовується проксі GATT.	Виділіть ще одне підключення, ніж потрібно.
841360	Низька продуктивність передачі сегментованого повідомлення через носій GATT.	Переконайтеся, що інтервал підключення базового підключення BLE короткий; переконайтеся, що ATT MTU достатньо великий, щоб помістити повний Mesh PDU; налаштувати мінімальну довжину події з’єднання, щоб дозволити передачу кількох пакетів LL на подію з’єднання.
1121605	Помилки округлення можуть спричинити запуск запланованих подій у трохи інший час, ніж очікувалося.
1226127	Постачальник хосту напрampфайл може застрягти, коли він починає надавати другий вузол.	Перезапустіть програму надання хосту перед наданням другого вузла.
1204017	Розповсюджувач не може обробляти паралельне самостійне оновлення програмного забезпечення та завантаження програмного забезпечення.	Не запускайте самостійне оновлення ПЗ і завантаження ПЗ паралельно.
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
У цьому випуску припинено підтримку апаратного забезпечення Series 1 (xG12 і xG13).

Використання цього випуску
Цей випуск містить наступне

• Бібліотека сітчастих стеків Bluetooth Silicon Labs
• Bluetooth mesh sampле додатків

Якщо ви користуєтеся вперше, перегляньте 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	Примітки
Ключ мережі	Можна експортувати	Можна експортувати	Похідні мережеві ключі існують лише в оперативній пам’яті, тоді як мережеві ключі зберігаються на флеш-пам’яті
Ключ програми	Не підлягає експорту	Можна експортувати
Ключ пристрою	Не підлягає експорту	Можна експортувати	У випадку Provisionerr, застосовується до власного ключа пристрою Provisionerr, а також до ключів інших пристроїв

Безпечна інтеграція сховища
Ця версія стеку інтегрована з Secure Vault Key Management. Під час розгортання на пристроях Secure Vault High ключі шифрування mesh захищені за допомогою функції керування ключами Secure Vault. У таблиці нижче наведено захищені ключі та характеристики захисту їх зберігання.

• Ключі, позначені як «Не експортовані», можна використовувати, але не можна viewed або спільний доступ під час виконання.
• Ключі, позначені як «Експортовані», можна використовувати або ділитися під час виконання, але залишаються зашифрованими, зберігаючи у флеш-пам’яті.
• Щоб отримати додаткові відомості про функцію керування ключами безпечного сховища, див. 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 не несе відповідальності за наслідки використання інформації, наданої в цьому документі. Цей документ не означає та не надає прямо жодної ліцензії на розробку чи виготовлення будь-яких інтегральних схем. Продукти не розроблені та не дозволені для використання в будь-яких пристроях FDA Class III, програмах, для яких потрібне схвалення 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®, 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

ПЗ/АПП
www.silabs.com/simplicity

якість
www.silabs.com/quality

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

Документи / Ресурси

Вбудоване програмне забезпечення SILICON LABS Bluetooth Mesh SDK [pdfПосібник користувача Вбудоване програмне забезпечення Bluetooth Mesh SDK, вбудоване програмне забезпечення Mesh SDK, вбудоване програмне забезпечення SDK, вбудоване програмне забезпечення, програмне забезпечення

Список літератури

• Посібник користувача