Software integrado SILICON LABS Bluetooth Mesh SDK

Especificacións do produto

• Nome do produto: Simplicity SDK Suite
• Versión: 2024.6.0
• Data de lanzamento: 5 de xuño de 2024
• Versión de especificación Bluetooth Mesh: 1.1

Instrucións de uso do produto

A malla Bluetooth é unha nova topoloxía dispoñible para dispositivos Bluetooth Low Energy (LE) que permite a comunicación de moitos a moitos (m:m). Está optimizado para crear redes de dispositivos a gran escala e é ideal para a automatización de edificios, redes de sensores e seguimento de activos. O noso software e SDK para o desenvolvemento de Bluetooth admiten a funcionalidade Bluetooth Mesh e Bluetooth. Os desenvolvedores poden engadir comunicación de rede de malla a dispositivos LE, como luces conectadas, domótica e sistemas de seguimento de activos. O software tamén admite a balizamento Bluetooth, a dixitalización de balizas e as conexións GATT para que a malla Bluetooth poida conectarse a teléfonos intelixentes, tabletas e outros dispositivos Bluetooth LE. Esta versión inclúe funcións compatibles coa especificación de malla Bluetooth versión 1.1.

Estas notas de publicación abarcan as versións do SDK:
7.0.0.0 lanzado o 5 de xuño de 2024

Avisos de compatibilidade e uso
Para obter máis información sobre as actualizacións de seguranza e os avisos, consulte o capítulo Seguridade das Notas da versión de plataforma instaladas con este SDK ou na páxina Notas da versión de Silicon Labs. Silicon Labs tamén recomenda encarecidamente que se subscriba aos Avisos de seguridade para obter información actualizada. Para obter instrucións ou se es novo no SDK de malla Bluetooth de Silicon Labs, consulta Usar esta versión.

Compiladores compatibles
IAR Embedded Workbench for ARM (IAR-EWARM) versión 9.40.1

• Usar wine para compilar coa utilidade de liña de comandos IarBuild.exe ou a GUI de IAR Embedded Workbench en macOS ou Linux pode producir un resultado incorrecto. files se está utilizando debido a colisións no algoritmo de hash do viño para xerar curtos file nomes.
• Recoméndase aos clientes en macOS ou Linux que non creen con IAR fóra de Simplicity Studio. Os clientes que o fagan deben verificar coidadosamente que o correcto files están sendo usados.

GCC (The GNU Compiler Collection) versión 12.2.1, proporcionada con Simplicity Studio.

• Desactivouse a función de optimización do tempo de ligazón de GCC, o que provocou un lixeiro aumento do tamaño da imaxe.

Novos Elementos
Simplicity SDK é unha plataforma de desenvolvemento de software integrado para construír produtos IoT baseados nos nosos dispositivos sen fíos e MCU das Series 2 e Series 3. Integra pilas de protocolos sen fíos, middleware, controladores de periféricos, un cargador de arranque e aplicacións, por exemploamples: un marco sólido para construír dispositivos IoT seguros e optimizados para potenciar. O SDK Simplicity ofrece poderosas funcións como un consumo de enerxía ultra baixo, unha forte fiabilidade da rede, soporte para un gran número de nodos e abstracción de requisitos complexos como multiprotocolo e precertificación. Ademais, Silicon Labs ofrece actualizacións de software e seguridade por vía aérea (OTA) para actualizar os dispositivos de forma remota, minimizar os custos de mantemento e mellorar a experiencia do produto do usuario final. Simplicity SDK é un complemento do noso popular SDK Gecko, que seguirá estando dispoñible proporcionando soporte a longo prazo para os nosos dispositivos da serie 0 e da serie 1.

Para obter información adicional sobre os dispositivos da Serie 0 e da Serie 1, consulte: Dispositivo EFM0/EZR1/EFR32 Serie 32 e Serie 32 (silabs.com).

Novas características

Engadido na versión 7.0.0.0
Engadiuse soporte para Clock Manager. Os compoñentes da pila xa non usan device_init() para a inicialización do reloxo. Pola contra, o proxecto da aplicación debe incluír agora o compoñente clock_manager que fai a inicialización do reloxo. Engadiuse o soporte para o Xestor de memoria común.

Novas API
Engadido na versión 7.0.0.0 Ningún.

Melloras

• Engadiuse un comando de clase BGAPI de nodos, sl_btmesh_node_test_identity, para comprobar as fontes de anuncios de identidade de nodos.
• Engadiuse a función de nodo de baixa potencia ao servidor de sensores, por exemploamples.
• Engadiuse a función Friend ao cliente do servidor de sensores, por exemploample.

Modificado na versión 7.0.0.0

• Cambios no BGAPI:
  Engadiuse un comando de clase BGAPI de nodo, sl_btmesh_node_test_identity, para comprobar se un anuncio de identidade de nodo recibido se orixina dun determinado nodo ou non.
• Exampcambios na aplicación:
  Engadiuse a función de nodo de baixa potencia ao servidor de sensores, por exemploamp(btmesh_soc_sensor_thermometer, btmesh_soc_nlc_sensor_oc-cupancy btmesh_soc_nlc_sensor_ambient_light) e engadiuse a función Friend ao cliente do servidor de sensoresample (btmesh_soc_sen-sor_client).

Problemas solucionados
Corrixido na versión 7.0.0.0

• Evite iniciar o portador de anuncios se o nodo está a ser aprovisionado usando só PB-GATT.
• Informes de eventos de aprovisionamento mellorados nun dispositivo sobrecargado.
• Informes de eventos DFU mellorados nun dispositivo sobrecargado.
• Engadíronse informes de erros se a configuración de Blob Transfer no nodo é insuficiente para os modelos DFU Distributor e Standalone Updater.
• Corrixiuse o gardado da protección de reprodución en NVM3 ao usar a API sl_btmesh_node_power_off().

número de identificación	Descrición
356148	Evita iniciar o portador de anuncios se o nodo está a ser aprovisionado usando só PB-GATT.
1250461	Fixo os informes de eventos de aprovisionamento máis sólidos nun dispositivo sobrecargado.
1258654	Fixo os informes de eventos de DFU máis sólidos nun dispositivo sobrecargado.
1274632	Os modelos DFU Distributor e Standalone Updater agora informarán dun erro se a configuración de Blob Transfer no nodo non é suficiente.
1284204	Corrixiuse o gardar a protección de reprodución en NVM3 cando a aplicación usa a API sl_btmesh_node_power_off().

Problemas coñecidos na versión actual
Engadíronse problemas en negra desde a versión anterior.

• Non hai ningún evento BGAPI por falla de tratamento de mensaxes segmentadas.
• Potencial inundación da cola NCP con eventos de cambio de estado de actualización da clave.
• Lixeira degradación do rendemento nas probas de latencia de ida e volta en comparación coa versión 1.5.
• Produciuse un problema ao restablecer a publicidade conectable se todas as conexións están activas e o proxy GATT está en uso.
• Mal rendemento da transmisión de mensaxes segmentadas a través do portador GATT.

número de identificación	Descrición	Solución alternativa
401550	Non hai ningún evento BGAPI por falla de tratamento de mensaxes segmentadas.	A aplicación debe deducir o fallo do tempo de espera/falta de resposta da capa de aplicación; para os modelos de provedores proporcionouse unha API.
454059	Un gran número de eventos de cambio de estado de actualización de claves xéranse ao final do proceso KR, e iso pode inundar a cola NCP.	Aumenta a lonxitude da cola NCP no proxecto.
454061	Observouse unha lixeira degradación do rendemento en comparación con 1.5 nas probas de latencia de ida e volta.
624514	Produciuse un problema ao restablecer a publicidade conectable se todas as conexións estiveron activas e o proxy GATT está en uso.	Asigne unha conexión máis da necesaria.
841360	Mal rendemento da transmisión de mensaxes segmentadas a través do portador GATT.	Asegúrese de que o intervalo de conexión da conexión BLE subxacente sexa curto; asegúrese de que ATT MTU sexa o suficientemente grande como para caber unha PDU Mesh completa; axuste a lonxitude mínima do evento de conexión para permitir que se transmitan varios paquetes LL por evento de conexión.
1121605	Os erros de redondeo poden provocar que os eventos programados se activen en momentos moi diferentes aos esperados.
1226127	Provedor de host exampO ficheiro pode quedar atascado cando comeza a proporcionar un segundo nodo.	Reinicie a aplicación de aprovisionamento de host antes de aprovisionar o segundo nodo.
1204017	O distribuidor non é capaz de xestionar a actualización de FW e a carga de FW en paralelo.	Non executes a actualización automática de FW e a carga de FW en paralelo.
1301325	As accións do programador non se almacenan correctamente no almacenamento persistente.
1305041	A comunicación NCP do host a EFR32 pode esgotar o tempo de espera.	sl_simple_com_usart.c pódese editar para corrixir un valor de tempo de espera.
1305928	A configuración de 10 ou máis nodos de actualización como receptores DFU pode fallar na aplicación do distribuidor de SoC.

Elementos obsoletos
Obsoleto na versión 7.0.0.0
O comando BGAPI sl_btmesh_prov_test_identity quedou en desuso. Use sl_btmesh_node_test_identity no seu lugar.

Elementos eliminados
Eliminado na versión 7.0.0.0
A compatibilidade con hardware da serie 1 (xG12 e xG13) eliminouse nesta versión.

Usando esta versión
Esta versión contén o seguinte

• Biblioteca de pilas de malla Bluetooth de Silicon Labs
• Malla Bluetooth sampas aplicacións

Se es un usuario novato, consulta QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Quick-Start Guide.

Instalación e Uso
O SDK de malla Bluetooth ofrécese como parte do Simplicity SDK (GSDK), o conxunto de SDK de Silicon Labs. Para comezar rapidamente co Simplicity SDK, instala Simplicity Studio 5, que configurará o teu ambiente de desenvolvemento e guiarache pola instalación do Simplicity SDK. Simplicity Studio 5 inclúe todo o necesario para o desenvolvemento de produtos IoT con dispositivos de Silicon Labs, incluíndo un lanzador de recursos e proxectos, ferramentas de configuración de software, IDE completo con cadea de ferramentas GNU e ferramentas de análise. As instrucións de instalación ofrécense na Guía do usuario de Simplicity Studio 5 en liña. Alternativamente, Simplicity SDK pódese instalar manualmente descargando ou clonando o máis recente de GitHub. Vexa https://github.com/Sili-conLabs/simplicity_sdk para máis información.

Simplicity Studio instala o SDK de Simplicity de forma predeterminada en:

• Windows:
  • C:\Usuarios\ \SimplicityStudio\SDKs\simplicity_sdk
• MacOS: /Usuarios/ /SimplicityStudio/SDKs/simplicity_sdk
  A documentación específica da versión do SDK instálase co SDK. A miúdo pódese atopar información adicional nos artigos da base de coñecemento (KBA). As referencias da API e outra información sobre esta e versións anteriores están dispoñibles en https://docs.silabs.com/.

Información de seguridade

Chave	Exportabilidade nun nodo	Exportabilidade en Provisioner	Notas
Chave de rede	Exportable	Exportable	As derivacións da clave de rede só existen na RAM mentres as claves de rede se almacenan en flash
Clave de aplicación	Non exportables	Exportable
Chave do dispositivo	Non exportables	Exportable	No caso de Provisioner, aplícase á chave do propio dispositivo de Provisionerr, así como ás claves doutros dispositivos

Integración segura de Vault
Esta versión da pila está integrada con Secure Vault Key Management. Cando se implementan en dispositivos Secure Vault High, as chaves de cifrado de malla están protexidas mediante a funcionalidade de Secure Vault Key Management. A seguinte táboa mostra as claves protexidas e as súas características de protección de almacenamento.

• As claves marcadas como "Non exportables" pódense usar pero non vieweditado ou compartido en tempo de execución.
• As claves que están marcadas como "Exportábeis" pódense usar ou compartir durante a execución, pero permanecen cifradas mentres se almacenan en flash.
• Para obter máis información sobre a funcionalidade de Secure Vault Key Management, ver AN1271: Almacenamento seguro de chaves.

Avisos de seguridade
Para subscribirse a Avisos de seguridade, inicie sesión no portal de clientes de Silicon Labs e, a continuación, seleccione Inicio da conta. Fai clic en INICIO para ir á páxina de inicio do portal e, a continuación, fai clic no mosaico Xestionar notificacións. Asegúrese de que "Avisos de asesoramento de software/seguridade e avisos de cambio de produto (PCN)" estea marcado e de que estea subscrito como mínimo para a súa plataforma e protocolo. Fai clic en Gardar para gardar os cambios.

Apoio
Os clientes do kit de desenvolvemento poden recibir formación e soporte técnico. Usa a malla Bluetooth de Silicon Labs web páxina para obter información sobre todos os produtos e servizos Bluetooth de Silicon Labs e rexistrarte para obter asistencia do produto.
Contacte co soporte de Silicon Laboratories en http://www.silabs.com/support.

Simplicity Studio
Acceso cun só clic a MCU e ferramentas sen fíos, documentación, software, bibliotecas de código fonte e moito máis. Dispoñible para Windows, Mac e Linux!

Exención de responsabilidade
Silicon Labs pretende proporcionar aos clientes a documentación máis recente, precisa e detallada de todos os periféricos e módulos dispoñibles para os implementadores de sistemas e software que utilicen ou teñan intención de utilizar os produtos de Silicon Labs. Os datos de caracterización, os módulos e periféricos dispoñibles, os tamaños de memoria e os enderezos de memoria refírense a cada dispositivo específico, e os parámetros "típicos" proporcionados poden variar en diferentes aplicacións. Aplicación exampOs aquí descritos son só para fins ilustrativos. Silicon Labs resérvase o dereito de facer cambios sen previo aviso na información do produto, especificacións e descricións aquí, e non ofrece garantías sobre a precisión ou integridade da información incluída. Sen notificación previa, Silicon Labs pode actualizar o firmware do produto durante o proceso de fabricación por motivos de seguridade ou fiabilidade. Tales cambios non alterarán as especificacións nin o rendemento do produto. Silicon Labs non terá ningunha responsabilidade polas consecuencias do uso da información proporcionada neste documento. Este documento non implica nin concede expresamente ningunha licenza para deseñar ou fabricar circuítos integrados. Os produtos non están deseñados nin autorizados para ser utilizados en ningún dispositivo da FDA Clase III, aplicacións para as que se require a aprobación previa da FDA ou sistemas de soporte vital sen o consentimento específico por escrito de Silicon Labs. Un "Sistema de Soporte Vital" é calquera produto ou sistema destinado a apoiar ou manter a vida e/ou a saúde que, se falla, pode esperarse razoablemente que resulte en danos persoais importantes ou a morte. Os produtos de Silicon Labs non están deseñados nin autorizados para aplicacións militares. Os produtos de Silicon Labs non se utilizarán en ningún caso en armas de destrución masiva incluídas (pero non limitadas a) armas nucleares, biolóxicas ou químicas ou mísiles capaces de lanzar tales armas. Silicon Labs renuncia a todas as garantías expresas e implícitas e non se fará responsable de ningunha lesión ou dano relacionado co uso dun produto de Silicon Labs nesas aplicacións non autorizadas.

Nota: Este contido pode conter terminoloxía ofensiva que xa está obsoleta. Silicon Labs está a substituír estes termos por linguaxe inclusiva sempre que sexa posible. Para máis información, visite www.silabs.com/about-us/inclusive-lexicon-project

Información da marca comercial
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® e o logotipo de Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo e combinacións dos mesmos , "os microcontroladores máis amigables coa enerxía do mundo", Redpine Signals®, WiSeConnect, n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, the Telegesis Logo®, USBXpress®, Zentri, o logotipo de Zentri e Zentri DMS, Z-Wave® e outros son marcas comerciais ou marcas rexistradas de Silicon Labs. ARM, CORTEX, Cortex-M3 e THUMB son marcas comerciais ou marcas rexistradas de ARM Holdings. Keil é unha marca rexistrada de ARM Limited. Wi-Fi é unha marca rexistrada de Wi-Fi Alliance. Todos os demais produtos ou marcas mencionadas aquí son marcas comerciais dos seus respectivos posuidores.

Preguntas frecuentes (FAQ)

P: Onde podo atopar máis información sobre as actualizacións de seguranza?
R: Consulte o capítulo Seguridade das Notas da versión da plataforma ou visite a páxina Notas da versión de Silicon Labs para obter actualizacións de seguranza detalladas.

P: Como podo incluír o compoñente clock_manager para a inicialización do reloxo?
R: Para incluír o compoñente clock_manager para a inicialización do reloxo, asegúrate de actualizar o teu proxecto de aplicación segundo as instrucións proporcionadas no manual do usuario.

Silicon Laboratories Inc.
400 Oeste César Chávez
Austin, TX 78701
EUA
www.silabs.com

Carteira IoT
www.silabs.com/IoT

SW/HW
www.silabs.com/simplicity

Calidade
www.silabs.com/quality

Soporte e comunidade
www.silabs.com/community

Documentos/Recursos

Software integrado SILICON LABS Bluetooth Mesh SDK [pdfGuía do usuario Software integrado Bluetooth Mesh SDK, Software integrado Mesh SDK, Software integrado SDK, Software integrado, Software

Referencias

• Manual de usuario