Instruções do SDK do SILICON LABS Zigbee EmberZ Net

A Silicon Labs é o fornecedor de escolha para OEMs que desenvolvem redes Zigbee em seus produtos. A plataforma Silicon Labs Zigbee é a solução Zigbee mais integrada, completa e rica em recursos disponível. O Silicon Labs EmberZNet SDK contém a implementação da Silicon Labs da especificação de pilha Zigbee.

PRINCIPAIS CARACTERÍSTICAS

Zigbee

-250+ entradas na tabela de chaves de link APS
Suporte ZigbeeD no Android 12 (v21.0.6113669) e Tizen (v0.1-13.1)

Suporte ao módulo xG26

Multiprotocolo

Suporte ZigbeeD e OTBR no OpenWRT – GA
DMP BLE + CMP ZB e Matter/OT com escuta simultânea no MG26 para SoC – GA

Componente de prioridade do agendador de rádio unificado 802.15.4
Suporte de empacotamento Debian para aplicativos de host MP – Alpha

Novos Itens

Mudanças importantes
O tamanho da tabela de chaves de link do APS (configurado usando SL_ZIGBEE_KEY_TABLE_SIZE) foi expandido de 127 para 254 entradas.

O suporte R23 é adicionado para a funcionalidade de comissionamento da ZDD Network. A funcionalidade de tunelamento está disponível sem suporte para casos de uso da Legacy Network.

Os componentes Network Steering e Network Creator foram atualizados para incluir suporte para junção R23. Isso inclui as seguintes alterações relacionadas.
- A política de solicitação padrão Trust Center Link Key (TCLK) foi atualizada para gerar novas chaves para cada dispositivo solicitante. Uma nova chave é gerada sempre que os dispositivos solicitantes tentam atualizar sua Trust Center Link Key.
- Devido à alteração anterior da política TCLK, o componente Network Creator Security agora requer o componente Security Link Keys. A atualização de aplicativos será atualizada para se adequar a esse novo requisito.
- Uma nova configuração,
  SL_ZIGBEE_AF_PLUGIN_NETWORK_CREATOR_SECURITY_ALLOW_TC_USING_HASHED_LINK_KEY foi adicionado para permitir a junção usando uma chave principal com hash. Essa configuração é encontrada no componente Network Creator Security. O uso dessa política permite que cada dispositivo de junção receba um TCLK exclusivo após a junção, mas tentativas repetidas de atualizar o TCLK não resultarão em uma nova chave para o dispositivo solicitante. Esse uso de chaves de link com hash era a política padrão antes desta versão, e o uso dessa política permite que o Trust Center evite trazer o componente Security Link Keys, que salva chaves no Flash.
  Observação: A Silicon Labs não recomenda o uso desta política, pois ela impede que os dispositivos participantes implementem ou atualizem seus TCLKs.

Um novo conjunto de configuração é adicionado ao componente zigbee_ezsp_spi para permitir a configuração do dispositivo SPI host e suas interfaces de pinos.
O exampos projetos, incluindo o projeto files (.slcps) e a pasta do projeto foram renomeados para diretrizes de nomenclatura do Silicon Labs e movidos para o diretório “projetos”.

Suporte a nova plataforma

Novos módulos
- MGM260PD32VNA2
- MGM260PD32VNN2
- MGM260PD22VNA2
- MGM260PB32VNA5
- MGM260PB32VNN5
- MGM260PB22VNA5
- BGM260PB22VNA2
- BGM260PB32VNA2
- Novas placas de rádio
- MGM260P-RB4350A
- MGM260P-RB4351A
Nova parte
- efr32xg27
Kit Explorador
- BRD2709A
- MGM260P-EK2713A

Nova documentação
Um novo guia do usuário EZSP UG600 para versões 8.1 e superiores.

Melhorias

Limites SL_ZIGBEE_KEY_TABLE_SIZE expandidos para até 254 entradas.
Adicionado zigbee_security_link_keys ao Z3Light.
Adicionado zigbee_security_link_keys para zigbee_mp_z3_tc_z3_tc. Atualizado também o tamanho da tabela de chaves.
Aumentou o tamanho da tabela de chaves do Z3 Gateway (que será definida como ncp) para 20.

Problemas corrigidos

Problemas conhecidos na versão atual

Os problemas em negrito foram adicionados desde a versão anterior. Se você perdeu uma versão, as notas de versão recentes estão disponíveis em https://www.silabs.com/developers/zigbee-emberznet na guia Documentos técnicos.

Itens obsoletos

O componente zigbee_watchdog_periodic_refresh não é mais usado na estrutura do aplicativo Zigbee e está obsoleto nesta versão. O watchdog timer é desabilitado por padrão para todos os sample applications. Haverá um componente watchdog aprimorado adicionado ao SDK no futuro.
Observação: Habilite o watchdog timer com o item de configuração SL_LEGACY_HAL_DISABLE_WATCHDOG definido como 0 em seu aplicativo

Limitações e considerações da rede

Os aplicativos padrão do Trust Center que vêm com esta versão do EmberZNet são capazes de suportar vários dispositivos na rede. Esse número é determinado com base em vários fatores, incluindo tamanhos de tabela configurados, uso de NVM e outros valores de tempo de geração e tempo de execução. Usuários que buscam criar grandes redes podem enfrentar problemas de recursos ao aumentar a rede além do que o aplicativo pode suportar. Por ex.ample, um dispositivo solicitando uma Trust Center Link Key do Trust Center pode disparar um retorno de chamada sl_zigbee_af_zigbee_key_establishment_cb no Trust Center com h status definido como SL_ZIGBEE_KEY_TABLE_FULL, indicando que a tabela de chaves não tem espaço para adicionar uma nova chave para o dispositivo solicitante ou que o NVM3 não tem espaço disponível. A Silicon Labs fornece as seguintes recomendações para usuários que buscam criar grandes redes. Para aplicativos do Trust Center, as seguintes configurações são recomendadas. Essas recomendações não são exaustivas e servem como uma linha de base para aplicativos que pretendem expandir grandes redes.

Inclusão do componente Tabela de Endereços (zigbee_address_table), com
- o item de configuração SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_SIZE definido para o tamanho da rede desejada
- o valor SL_ZIGBEE_AF_PLUGIN_ADDRESS_TABLE_TRUST_CENTER_CACHE_SIZE definido como o máximo (4)

Inclusão do componente Security Link Keys (zigbee_security_link_keys), com
- O valor SL_ZIGBEE_KEY_TABLE_SIZE é definido como o tamanho da rede
Os seguintes itens de configuração são definidos para o tamanho da rede desejada
- SL_ZIGBEE_BROADCAST_TABLE_SIZE, conforme encontrado no componente Zigbee Pro Stack
- SL_ZIGBEE_SOURCE_ROUTE_TABLE_SIZE, conforme encontrado no componente de roteamento de origem, se o roteamento de origem for usado
Ajuste de NVM3_DEFAULT_NVM_SIZE e NVM3_DEFAULT_CACHE_SIZE de acordo com o uso do NVM3
- Por exemplo, tamanhos de rede maiores que 65 nós provavelmente requerem um tamanho NVM3 de 64K. O tamanho NVM3 padrão no Silicon Labs Zigbee sample applications é 32K. Aplicativos que usam NVM mais intensamente podem exigir um ajuste desse valor ainda maior.
- Grandes redes de até 65 nós podem precisar de um tamanho de cache NVM3 de 1200 bytes; redes maiores que isso podem exigir a duplicação desse valor para 2400 bytes.

Esses ajustes se aplicam apenas ao Trust Center

Gateway Multiprotocolo e RCP

Novos Itens
Suporte GA SoC habilitado para BLE DMP com Zigbee + Openthread CMP com escuta simultânea em partes xG26. Suporte alfa Debian foi adicionado para aplicativos Zigbeed, OTBR e Z3Gateway. Zigbeed e OTBR são fornecidos no formato de pacote DEB para a plataforma de referência escolhida (Raspberry PI 4) também. Veja Executando Zigbee, OpenThread e Bluetooth simultaneamente em um host Linux com um coprocessador multiprotocolo, encontrado em docs.silabs.com, para detalhes. Adicionado suporte Zigbeed para Tizen-0.1-13.1 para arm32 e aarch64, bem como Android 12 para aarch64. Mais informações sobre Zigbeed podem ser encontradas em docs.silabs.com. Adicionado o novo componente “802.15.4 Unified radio scheduler priority”. Este componente é usado para configurar as prioridades de rádio de uma pilha 15.4. O componente também requer o novo componente “radio_priority_configurator”. Este componente permite que os projetos usem a ferramenta Radio Priority Configurator no Simplicity Studio para configurar os níveis de prioridade de rádio das pilhas que a exigem.

Melhorias
Nota de aplicação Executar Zigbee, OpenThread e Bluetooth simultaneamente em um host Linux com um coprocessador multiprotocolo (AN1333) foi movido para docs.silabs.com. O suporte OpenWRT agora é qualidade GA. O suporte OpenWRT foi adicionado para aplicativos Zigbee, OTBR e Z3Gateway. Zigbeed e OTBR são fornecidos no formato de pacote IPK para a plataforma de referência (Raspberry PI 4) também. Veja Executando Zigbee, OpenThread e Bluetooth Simultaneamente em um Host Linux com um Coprocessador Multiprotocolo, encontrado em docs.silabs.com, para detalhes.

Problemas corrigidos

Problemas conhecidos na versão atual
Os problemas em negrito foram adicionados desde a versão anterior. Se você perdeu uma versão, as notas de versão recentes estão disponíveis emhttps://www.silabs.com/developers/simplicity-software-development-kit.

Itens obsoletos
O “Multiprotocol Container” que está atualmente disponível no DockerHub (siliconlabsinc/multiprotocol) será descontinuado em uma próxima versão. O container não será mais atualizado e não poderá ser extraído do DockerHub. Os pacotes baseados em Debian para cpcd, ZigBee e ot-br-posix, juntamente com projetos gerados e compilados nativamente, substituirão a funcionalidade perdida com a remoção do container.

Usando esta versão

Esta versão contém o seguinte:

Pilha Zigbee
Estrutura de aplicativo Zigbee
Zigbee Sample aplicativos

Para obter mais informações sobre o Zigbee e o EmberZNet SDK, consulte UG103.02: Fundamentos do Zigbee. Se você for um usuário iniciante, consulte QSG180: Guia de início rápido Zigbee EmberZNet para SDK 7.0 e superior, para obter instruções sobre como configurar seu ambiente de desenvolvimento, construir e atualizar comoampo aplicativo e referências de documentação apontando para as etapas ext.

Instalação e uso
O Zigbee EmberZNet SDK é fornecido como parte do Simplicity SDK, o conjunto de SDKs do Silicon Labs. Para começar rapidamente com o Simplicity SDK, instale o Simplicity Studio 5, que configurará seu ambiente de desenvolvimento e o guiará pela instalação do Simplicity SDK. O Simplicity Studio 5 inclui tudo o que é necessário para o desenvolvimento de produtos de IoT com dispositivos do Silicon Labs, incluindo um iniciador de recursos e projetos, ferramentas de configuração de software, IDE completo com cadeia de ferramentas GNU e ferramentas de análise. As instruções de instalação são fornecidas no Guia do usuário do Simplicity Studio 5 online. Como alternativa, o Simplicity SDK pode ser instalado manualmente baixando ou clonando a versão mais recente do GitHub. Veja https://github.com/SiliconLabs/simplicity_sdk para mais informações. O Simplicity Studio instala o Simplicity SDK por padrão em:

(Windows): C:\Usuários\\SimplicityStudio\SDKs\simplicity_sdk

(MacOS): /Usuários//SimplicityStudio/SDKs/simplicity_sdk

A documentação específica para a versão do SDK é instalada com o SDK. Informações adicionais podem ser encontradas frequentemente nos artigos da base de conhecimento (KBAs). Referências de API e outras informações sobre esta e versões anteriores estão disponíveis em https://docs.silabs.com/.

Informações de segurança
Integração segura do cofre
Para aplicativos que optam por armazenar chaves com segurança usando o componente Secure Key Storage em partes Secure Vault-High, a tabela a seguir mostra as chaves protegidas e suas características de proteção de armazenamento que o componente Zigbee Security Manager gerencia.Chaves encapsuladas marcadas como "Não exportáveis" podem ser usadas, mas não viewed ou compartilhado em tempo de execução. Chaves encapsuladas que são marcadas como “Exportáveis” podem ser usadas ou compartilhadas em tempo de execução, mas permanecem criptografadas enquanto armazenadas em Flash. Os aplicativos de usuário nunca precisam interagir com a maioria dessas chaves. As APIs existentes para gerenciar chaves da Tabela de Chaves de Link ou Chaves Transientes ainda estão disponíveis para o aplicativo de usuário e são roteadas por meio do componente Zigbee Security Manager.

Conselhos de segurança
Para se inscrever em Security Advisories, faça login no portal do cliente da Silicon Labs e selecione Account Home. Clique em INÍCIO para acessar a página inicial do portal e, em seguida, clique no bloco Gerenciar notificações. Certifique-se de que 'Software/Security Advisory Notices & Product Change Notices (PCNs)' está marcado e que você está inscrito no mínimo para sua plataforma e protocolo. Clique em Salvar para salvar as alterações.

Apoiar
Os clientes do Development Kit são elegíveis para treinamento e suporte técnico. Use o Zigbee dos Laboratórios de Silício web página para obter informações sobre todos os produtos e serviços da Silicon Labs Zigbee e para se inscrever para suporte ao produto. Você pode entrar em contato com o suporte da Silicon Laboratories em http://www.silabs.com/support.

Certificação Zigbee
A versão Ember ZNet 8.1 foi qualificada para a plataforma compatível com Zigbee para arquiteturas SoC, NC, P e RCP. Há um ID de certificação ZCP vinculado a esta versão. Verifique o CSA website aqui:
https://csa-iot.org/csa-iot_products/.

Observe que a certificação ZCP é filed publicar o comunicado e demora algumas semanas até ser refletido no CSA website. Para qualquer dúvida adicional, entre em contato com o suporte da Silicon Laboratories em http://www.silabs.com/support.

Perguntas frequentes

P: Como atualizo o tamanho da tabela de chaves de link do APS no SDK?
R: O tamanho da tabela de chaves de link APS pode ser configurado usando o parâmetro SL_ZIGBEE_KEY_TABLE_SIZE. Na versão 8.1, ele foi expandido de 127 para 254 entradas.

P: Quais são as melhorias na versão 8.1?
R: A versão 8.1 traz melhorias como expansão do tamanho da tabela de chaves de link do APS, renomeação de componentes, adição de proteção mutex para a fila de eventos do Athe pp Framework e muito mais. Consulte as notas de versão para uma lista detalhada de melhorias.

P: Como lidar com problemas corrigidos no SDK?
R: Problemas corrigidos no SDK, incluindo resolução de problemas potenciais com configuração de tamanho de tabela vizinha, renomeação de componentes, correção de sobrecarga de rota de origem, manipulação de comandos ZCL e muito mais. Certifique-se de atualizar para a versão mais recente para se beneficiar dessas correções.

Documentos / Recursos

SILICON LABS Zigbee EmberZ Net SDK [pdf] Instruções
Zigbee EmberZ Net SDK, EmberZ Net SDK, Net SDK, SDK

Referências

Manual do usuário

SILICON LABS Zigbee EmberZ Net SDK

Especificações

Informações do produto