SILICON LABS Bluetooth Mesh SDK Embedded Software User Guide

User Guide for SILICON LABS models including: Bluetooth Mesh SDK Embedded Software, Mesh SDK Embedded Software, SDK Embedded Software, Embedded Software, Software

Silicon Labs Blluetooth Mesh Release Notes

Silicon Labs Silicon Labs

Bluetooth mesh SDK 7.0.0.0 GA

2 days ago — x Quick-Start Guide. 7.1 Installation and Use. The Bluetooth mesh SDK is ... Installation instructions are provided in the online Simplicity Studio 5 User's Guide ...

2 giorni fa — x Quick-Start Guide. 7.1 Installation and Use. The Bluetooth mesh SDK is ... Installation instructions are provided in the online Simplicity Studio 5 User's Guide ...

Version 7.0.0.0

Simplicity Software Development Kit - Silicon Labs

File Info : application/pdf, 11 Pages, 826.53KB

bt-mesh-software-release-notes-7.0.0.0

Bluetooth® mesh SDK 7.0.0.0 GA
Simplicity SDK Suite 2024.6.0 June 5, 2024

Bluetooth mesh is a new topology available for Bluetooth Low Energy (LE) devices that enables many-to-many (m:m) communication. It's optimized for creating large-scale device networks, and is ideally suited for building automation, sensor networks, and asset tracking. Our software and SDK for Bluetooth development supports Bluetooth Mesh and Bluetooth functionality. Developers can add mesh networking communication to LE devices such as connected lights, home automation, and asset tracking systems. The software also supports Bluetooth beaconing, beacon scanning, and GATT connections so Bluetooth mesh can connect to smart phones, tablets, and other Bluetooth LE devices.
This release includes features supported by the Bluetooth mesh specification version 1.1.
These release notes cover SDK versions:

KEY FEATURES
· Migration to Simplicity SDK Suite · Removed support for Series 0/1

7.0.0.0 released June 5, 2024

Compatibility and Use Notices
For more information about security updates and notices, see the Security chapter of the Platform Release Notes installed with this SDK or on the Silicon Labs Release Notes page. Silicon Labs also strongly recommends that you subscribe to Security Advisories for up-to-date information. For instructions, or if you are new to the Silicon Labs Bluetooth mesh SDK, see Using This Release.
Compatible Compilers:
IAR Embedded Workbench for ARM (IAR-EWARM) version 9.40.1 · Using wine to build with the IarBuild.exe command line utility or IAR Embedded Workbench GUI on macOS or Linux could result in
incorrect files being used due to collisions in wine's hashing algorithm for generating short file names. · Customers on macOS or Linux are advised not to build with IAR outside of Simplicity Studio. Customers who do should carefully
verify that the correct files are being used.
GCC (The GNU Compiler Collection) version 12.2.1, provided with Simplicity Studio. · Link-time optimization feature of GCC has been disabled, resulting in a slight increase of image size.

silabs.com | Building a more connected world.

Bluetooth Mesh 7.0.0.0

Contents
Contents
1 New Items .......................................................................................................................................................................................... 3 1.1 New Features ............................................................................................................................................................................. 3 1.2 New APIs.................................................................................................................................................................................... 3
2 Improvements..................................................................................................................................................................................... 4 3 Fixed Issues ....................................................................................................................................................................................... 5 4 Known Issues in the Current Release ................................................................................................................................................ 6 5 Deprecated Items ............................................................................................................................................................................... 7 6 Removed Items .................................................................................................................................................................................. 8 7 Using This Release ............................................................................................................................................................................ 9
7.1 Installation and Use .................................................................................................................................................................... 9 7.2 Security Information.................................................................................................................................................................... 9 7.3 Support ..................................................................................................................................................................................... 10

silabs.com | Building a more connected world.

Bluetooth Mesh 7.0.0.0 | 2

New Items
1 New Items
Simplicity SDK is an embedded software development platform for building IoT products based on our Series 2 and Series 3 wireless and MCU devices. It integrates wireless protocol stacks, middleware, peripheral drivers, a bootloader, and application examples a solid framework for building power-optimized and secure IoT devices. The Simplicity SDK offers powerful features such as ultra-low power consumption, strong network reliability, support for a large number of nodes, and abstraction of complex requirements like multiprotocol and pre-certification. Additionally, Silicon Labs provides over-the-air (OTA) software and security updates to remotely update devices, minimize maintenance costs, and enhance the end-user product experience. Simplicity SDK is a follow-on from our popular Gecko SDK, which will continue to be available providing long-term support for our Series 0 and Series 1 devices. For additional information on the Series 0 and Series 1 devices please reference: Series 0 and Series 1 EFM32/EZR32/EFR32 device (silabs.com).
1.1 New Features
Added in release 7.0.0.0 Support for Clock Manager has been added. The stack components no longer use device_init() for clock initialization. Instead, the application project must now include the clock_manager component which does the clock initialization. Support for Common Memory Manager has been added.
1.2 New APIs
Added in release 7.0.0.0 None.

silabs.com | Building a more connected world.

Bluetooth Mesh 7.0.0.0 | 3

Improvements
2 Improvements
Changed in release 7.0.0.0 BGAPI changes: A node BGAPI class command, sl_btmesh_node_test_identity, has been added for checking whether a received node identity advertisement originates from a given node or not.
Example application changes: Low Power Node feature has been added to Sensor server examples (btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_occupancy btmesh_soc_nlc_sensor_ambient_light), and Friend feature was added to the sensor server client example (btmesh_soc_sensor_client).

silabs.com | Building a more connected world.

Bluetooth Mesh 7.0.0.0 | 4

Fixed Issues

3 Fixed Issues

Fixed in release 7.0.0.0

ID # 356148 1250461 1258654 1274632
1284204

Description Avoids starting advertisement bearer if node is being provisioned using only PB-GATT. Made provisioning event reporting more robust on an overloaded device. Made DFU event reporting more robust on an overloaded device. DFU Distributor and Standalone Updater models will now report an error if Blob Transfer configuration on the node is not sufficient. Fixed saving replay protection to NVM3 when application uses the sl_btmesh_node_power_off() API.

silabs.com | Building a more connected world.

Bluetooth Mesh 7.0.0.0 | 5

Known Issues in the Current Release

4 Known Issues in the Current Release

Issues in bold were added since the previous release.

ID # 401550 454059 454061 624514 841360
1121605 1226127 1204017 1301325 1305041 1305928

Description No BGAPI event for segmented message handling failure.
A large number of key refresh state change events are generated at the end of KR process, and that may flood NCP queue. Slight performance degradation compared to 1.5 in round-trip latency tests was observed. Issue with re-establishing connectable advertising if all connections have been active and GATT proxy is in use. Poor performance of segmented message transmission over GATT bearer.
Rounding errors may cause scheduled events to trigger at very slightly different times than expected. Host provisioner example can be stuck when it starts to provision a second node. Distributor is not able to handle parallel self FW Update and FW Upload. Scheduler actions are not correctly stored to persistent storage. NCP communication from host to EFR32 may timeout. Setting up 10 or more updating nodes as DFU receivers may fail on the SoC distributor app.

Workaround Application needs to deduce failure from timeout / lack of application layer response; for vendor models an API has been provided. Increase NCP queue length in the project.
Allocate one more connection than is needed.
Ensure that the underlying BLE connection's Connection interval is short; ensure that ATT MTU is large enough to fit a full Mesh PDU; tune the minimum connection event length to allow multiple LL packets to be transmitted per connection event.
Restart the host provisioner app before provisioning the second node. Don't run self FW update and FW upload in parallel.
sl_simple_com_usart.c may be edited to correct a timeout value.

silabs.com | Building a more connected world.

Bluetooth Mesh 7.0.0.0 | 6

Deprecated Items
5 Deprecated Items
Deprecated in release 7.0.0.0 The BGAPI command sl_btmesh_prov_test_identity has been deprecated. Use sl_btmesh_node_test_identity instead.

silabs.com | Building a more connected world.

Bluetooth Mesh 7.0.0.0 | 7

6 Removed Items
Removed in release 7.0.0.0 Support for Series 1 hardware (xG12 and xG13) has been removed in this release.

Removed Items

silabs.com | Building a more connected world.

Bluetooth Mesh 7.0.0.0 | 8

7 Using This Release
This release contains the following · Silicon Labs Bluetooth mesh stack library · Bluetooth mesh sample applications If you are a first time user, see QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Quick-Start Guide.

Using This Release

7.1 Installation and Use
The Bluetooth mesh SDK is provided as part of the Simplicity SDK (GSDK), the suite of Silicon Labs SDKs. To quickly get started with the Simplicity SDK, install Simplicity Studio 5, which will set up your development environment and walk you through Simplicity SDK installation. Simplicity Studio 5 includes everything needed for IoT product development with Silicon Labs devices, including a resource and project launcher, software configuration tools, full IDE with GNU toolchain, and analysis tools. Installation instructions are provided in the online Simplicity Studio 5 User's Guide.
Alternatively, Simplicity SDK may be installed manually by downloading or cloning the latest from GitHub. See https://github.com/SiliconLabs/simplicity_sdk for more information .
Simplicity Studio installs the Simplicity SDK by default in: · Windows: C:\Users\<NAME>\SimplicityStudio\SDKs\simplicity_sdk · MacOS: /Users/<NAME>/SimplicityStudio/SDKs/simplicity_sdk
Documentation specific to the SDK version is installed with the SDK. Additional information can often be found in the knowledge base articles (KBAs). API references and other information about this and earlier releases is available on https://docs.silabs.com/.

7.2 Security Information
Secure Vault Integration
This version of the stack is integrated with Secure Vault Key Management. When deployed to Secure Vault High devices, mesh encryption keys are protected using the Secure Vault Key Management functionality. The table below shows the protected keys and their storage protection characteristics.

Key
Network key Application key Device key

Exportability on a node
Exportable
Non-exportable
Non-exportable

Exportability on Provisioner
Exportable
Exportable
Exportable

Notes
Derivations of the network key exist only in RAM while network keys are stored on flash
In Provisioner's case, applied to Provisionerr's own device key as well as other devices' keys

Keys that are marked as "Non-Exportable" can be used but cannot be viewed or shared at runtime. Keys that are marked as "Exportable" can be used or shared at runtime but remain encrypted while stored in flash.

For more information on Secure Vault Key Management functionality, see AN1271: Secure Key Storage.

silabs.com | Building a more connected world.

Bluetooth Mesh 7.0.0.0 | 9

Using This Release
Security Advisories
To subscribe to Security Advisories, log in to the Silicon Labs customer portal, then select Account Home. Click HOME to go to the portal home page and then click the Manage Notifications tile. Make sure that `Software/Security Advisory Notices & Product Change Notices (PCNs)' is checked, and that you are subscribed at minimum for your platform and protocol. Click Save to save any changes.

7.3 Support
Development Kit customers are eligible for training and technical support. Use the Silicon Labs Bluetooth mesh web page to obtain information about all Silicon Labs Bluetooth products and services, and to sign up for product support.
Contact Silicon Laboratories support at http://www.silabs.com/support.

silabs.com | Building a more connected world.

Bluetooth Mesh 7.0.0.0 | 10

Simplicity Studio
One-click access to MCU and wireless tools, documentation, software, source code libraries & more. Available for Windows, Mac and Linux!

IoT Portfolio
www.silabs.com/IoT

SW/HW
www.silabs.com/simplicity

Quality
www.silabs.com/quality

Support & Community
www.silabs.com/community

Disclaimer Silicon Labs intends to provide customers with the latest, accurate, and in-depth documentation of all peripherals and modules available for system and software implementers using or intending to use the Silicon Labs products. Characterization data, available modules and peripherals, memory sizes and memory addresses refer to each specific device, and "Typical" parameters provided can and do vary in different applications. Application examples described herein are for illustrative purposes only. Silicon Labs reserves the right to make changes without further notice to the product information, specifications, and descriptions herein, and does not give warranties as to the accuracy or completeness of the included information. Without prior notification, Silicon Labs may update product firmware during the manufacturing process for security or reliability reasons. Such changes will not alter the specifications or the performance of the product. Silicon Labs shall have no liability for the consequences of use of the information supplied in this document. This document does not imply or expressly grant any license to design or fabricate any integrated circuits. The products are not designed or authorized to be used within any FDA Class III devices, applications for which FDA premarket approval is required or Life Support Systems without the specific written consent of Silicon Labs. A "Life Support System" is any product or system intended to support or sustain life and/or health, which, if it fails, can be reasonably expected to result in significant personal injury or death. Silicon Labs products are not designed or authorized for military applications. Silicon Labs products shall under no circumstances be used in weapons of mass destruction including (but not limited to) nuclear, biological or chemical weapons, or missiles capable of delivering such weapons. Silicon Labs disclaims all express and implied warranties and shall not be responsible or liable for any injuries or damages related to use of a Silicon Labs product in such unauthorized applications. Note: This content may contain offensive terminology that is now obsolete. Silicon Labs is replacing these terms with inclusive language wherever possible. For more information, visit www.silabs.com/about-us/inclusive-lexicon-project
Trademark Information Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® and the Silicon Labs logo®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo and combinations thereof, "the world's most energy friendly microcontrollers", Redpine Signals®, WiSeConnect , n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, the Telegesis Logo®, USBXpress® , Zentri, the Zentri logo and Zentri DMS, Z-Wave®, and others are trademarks or registered trademarks of Silicon Labs. ARM, CORTEX, Cortex-M3 and THUMB are trademarks or registered trademarks of ARM Holdings. Keil is a registered trademark of ARM Limited. Wi-Fi is a registered trademark of the Wi-Fi Alliance. All other products or brand names mentioned herein are trademarks of their respective holders.
Silicon Laboratories Inc. 400 West Cesar Chavez Austin, TX 78701 USA
www.silabs.com

References

Silicon Labs Adobe PDF Library 24.2.23