O que há de novo no Azure Sphere

Importante

Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (Integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).

O Azure Sphere é atualizado continuamente. As versões de recursos oferecem suporte a novas funcionalidades e podem incluir atualizações para o sistema operacional Azure Sphere, SDK e/ou Serviços. As versões de qualidade incluem apenas correções de bugs e atualizações de segurança e, muitas vezes, podem incluir apenas o sistema operacional Azure Sphere. Os números de lançamento normalmente estão no formato ano.mês , portanto, 22.04 identifica o lançamento em abril de 2022.

Ser notificado de atualizações

Quando ocorrerem novas versões, publicaremos notificações nas Atualizações do Azure e no blog da Comunidade IoT Tech.

Receber atualizações

Quando o sistema operacional é atualizado, ele é baixado automaticamente da nuvem para dispositivos do Azure Sphere conectados à Internet.

Para verificar a versão do sistema operacional instalada em um dispositivo conectado, use o seguinte comando:

azsphere device show-os-version

As atualizações do SDK e as extensões do Visual Studio / Visual Studio Code precisam ser instaladas manualmente - consulte estas instruções para Windows ou Linux. Para verificar qual versão do SDK está instalada no seu computador, use o seguinte comando:

azsphere show-version

Versões do Retail Evaluation OS

O programa Avaliação de Varejo permite testes de compatibilidade com versões anteriores para aplicativos duas semanas antes de o sistema operacional ser atualizado para todos os dispositivos. Recomendamos vivamente que todos os utilizadores de produção utilizem esta instalação de teste. Consulte Configurar dispositivos para avaliação do SO para saber como participar.

Comunicar vulnerabilidades

O Azure Sphere incentiva os investigadores de segurança a procurar quaisquer vulnerabilidades e a reportá-las de forma responsável com base no princípio de Divulgação Coordenada de Vulnerabilidades da Microsoft ao Portal MSRC. Os relatórios de vulnerabilidades podem incluir recompensas através do Programa de Recompensas do Microsoft Azure. Consulte CVEs do Azure Sphere para obter informações gerais sobre CVEs do Azure Sphere. Você pode encontrar informações sobre CVEs já publicadas no Guia de Atualização de Segurança do MSRC e nos detalhes específicos da versão neste artigo.

Setembro de 2024

27 setembro 2024

Anúncio da desativação das interfaces de serviço do Azure Sphere (Legacy) em setembro de 2027

As interfaces do Azure Sphere (Legado), incluindo a API do Azure Sphere (Legado) (também conhecida como PAPI) e a CLI do Azure Sphere (Legado) (também conhecida como azsphere), serão desativadas em 27 de setembro de 2027. De agora até 27 de setembro de 2027, o Azure Sphere (Legado) terá suporte total e você poderá continuar a usar a API do Azure Sphere (Legado) e as interfaces da CLI. No entanto, até 27 de setembro de 2027, você deve migrar para o Azure Sphere (Integrado) e começar a gerenciar seus dispositivos do Azure Sphere no portal do Azure e na CLI do Azure, e deve atualizar qualquer automação e aplicativos personalizados para usar a API do Azure Sphere (Integrada).

O Azure Sphere (Integrado) dá suporte a todos os recursos do Azure Sphere (Legado) e permite que você use outros serviços poderosos do Azure ao gerenciar seus dispositivos do Azure Sphere, incluindo o Microsoft Entra ID, o controle de acesso baseado em função do Azure e o Azure Monitor.

Para obter mais informações sobre a desativação e como migrar para o Azure Sphere (Integrado), consulte esta postagem de blog.

Agosto de 2024

19 agosto 2024

Serviços (Legado): API de usuário convidado preterida

Por motivos de segurança, removemos a API "convidar-usuário" da API Pública do Azure Sphere (Legado). Essa API foi utilizada pelo comando azsphere register-userCLI, que agora resultará em uma mensagem de erro. Métodos alternativos devem ser usados para registrar usuários do Azure Sphere (Legado).

Serviços (integrados): novo recurso para localizar um dispositivo

Agora você pode pesquisar por um ID de dispositivo em todos os catálogos aos quais você tem acesso. Se você tiver permissões do Reader ou superiores do Azure RBAC para o dispositivo, o resultado da pesquisa exibirá um link para o dispositivo, bem como para o grupo de dispositivos pai, o produto e o catálogo do dispositivo. Se você não tiver privilégios de Leitor ou de acesso maiores, a pesquisa retornará um erro de dispositivo não encontrado.

Novo projeto de galeria: Azure Event Grid MQTT-C

Um novo Projeto da Galeria do Azure Sphere está disponível, demonstrando como conectar um dispositivo do Azure Sphere a um namespace da Grade de Eventos do Azure sobre MQTT com a biblioteca de cliente MQTT-C . Este projeto usa a biblioteca wolfSSL TLS do Azure Sphere e o mecanismo de certificado de autenticação e atestado de dispositivo (DAA) para formar conexões de maneira segura, autenticada e atestada.

Julho de 2024

31 de julho de 2024

O Serviço de Segurança do Azure Sphere começa a usar o novo certificado de assinatura de imagem para assinar todos os aplicativos e recursos assinados pela produção de imagens. Como os dispositivos de produção receberam esse novo certificado no keystore confiável em 10 de julho (veja abaixo), não há impacto nos dispositivos de produção. Em certos cenários de fabricação ou desenvolvimento, o impacto é menor.

10 julho 2024

Esta versão inclui uma atualização para o keystore confiável de dispositivos do Azure Sphere que resultará em todos os dispositivos (independentemente de estarem no feed Retail ou Retail Eval) instalando essa atualização e reinicializando. Para obter mais informações, consulte a postagem do blog, Azure Sphere – Atualização do certificado de assinatura de imagem.

O que há de novo na versão 24.06

25 junho 2024

A versão 24.06 do Azure Sphere inclui uma correção de bug somente no sistema operacional Azure Sphere; ele não inclui um SDK atualizado. Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud.

Corrigidos bugs e vulnerabilidades comuns na versão 24.06

A versão 24.06 inclui atualizações para mitigar as vulnerabilidades e exposições comuns (CVEs):

• CVE-2023-52160

O que há de novo na versão 24.03

26 março 2024

A versão do Azure Sphere 24.03 já está disponível e inclui os seguintes componentes:

• Disponibilidade geral do Azure Sphere (Integrado)
• SO do Azure Sphere atualizado
• SDK do Azure Sphere atualizado para Windows e Linux
• Extensões do Azure Sphere atualizadas para o Visual Studio e Visual Studio Code
• Amostras atualizadas

Os destaques nesta versão incluem a disponibilidade geral do Azure Sphere (Integrado), suporte para certificados personalizados para se conectar ao Azure IoT, uma versão atualizada do cURL para o sistema operacional Azure Sphere, correções de segurança, suporte ao SDK para o pré-lançamento do Ubuntu 24.04 e simplificações para a cadeia de ferramentas CMake.

Disponibilidade geral do Azure Sphere (Integrado)

Temos o prazer de anunciar que o Azure Sphere (Integrado), uma nova interface de gerenciamento para dispositivos Azure Sphere, está disponível para uso em produção a partir de hoje. O Azure Sphere (Integrado) agora é a interface recomendada para os serviços do Azure Sphere e não é mais rotulado como Visualização no portal do Azure.

Com o Azure Sphere (Integrado), você pode gerenciar seus dispositivos do Azure Sphere diretamente no portal do Azure e na extensão do Azure Sphere para CLI do Azure. O Azure Sphere (Integrado) baseia-se na nova API REST do Azure Sphere (Integrada), criada na plataforma Azure Resource Manager, e inclui suporte incorporado para outros serviços poderosos do Azure, incluindo o Azure RBAC e o Azure Monitor.

Atualizações para o Azure Sphere (Integrado) desde a Pré-visualização Pública:

• Uma nova função pré-criada do Azure RBAC está disponível: Azure Sphere Owner. A função Proprietário da Esfera do Azure fornece privilégios completos para os recursos do Azure Sphere, mas, ao contrário da função de Colaborador do Azure Sphere, que também fornece privilégios completos, a função Proprietário da Esfera do Azure também inclui a capacidade de configurar o acesso RBAC do Azure para recursos do Azure Sphere.

• Para facilitar a navegação ao visualizar um produto, grupo de dispositivos ou dispositivo individual, agora você acessa informações gerais específicas de recursos, controle de acesso, tarefas e configurações de propriedade no menu à esquerda atualizado.

• Você pode usar o Azure Monitor para ser alertado quando precisar tomar medidas devido ao rolo de certificado bienal do seu certificado de CA de catálogo. Para obter detalhes, consulte Monitorando a integridade da frota e do dispositivo do Azure Sphere.

Se ainda não começou a utilizar o Azure Sphere (Integrado), recomendamos que o faça agora.

Uma etapa única de integração permite gerenciar seus locatários existentes do Azure Sphere (Legado) no Azure Sphere (Integrado). Depois que um locatário é integrado, você pode executar tarefas de gerenciamento usando o Azure Sphere (Integrado) ou o Azure Sphere (Legado). Você pode preparar a adoção do Azure Sphere (Integrado) começando com atividades de teste e desenvolvimento no Azure Sphere (Integrado) enquanto continua a usar o Azure Sphere (Legado) para fluxos de trabalho de gerenciamento de produção até estar pronto para migrar totalmente. Embora a interface do Azure Sphere (Legado) continue a ter suporte total, recomendamos a migração para aproveitar ao máximo os recursos do Azure Sphere (Integrado) e aprimoramentos futuros.

Para obter mais informações, consulte a postagem do blog Azure Sphere (Integrado) está disponível em geral

Recursos novos e alterados no sistema operacional 24.03

A versão 24.03 do sistema operacional Azure Sphere inclui as seguintes alterações:

Corrigidos bugs e vulnerabilidades comuns na versão 24.03 do SO

A versão cURL incluída no sistema operacional Azure Sphere foi atualizada da versão 7.69.1 para 7.87.0. A versão 24.03 do SO inclui atualizações para mitigar estas vulnerabilidades e exposições comuns (CVEs):

Vulnerabilidades e exposições comuns (CVEs)
CVE-2022-27774	CVE-2022-27776
CVE-2022-32205	CVE-2022-32207
CVE-2022-32208	CVE-2022-32221
CVE-2022-35252	CVE-2022-35260
CVE-2022-43551	CVE-2022-43552
CVE-2023-23914	CVE-2023-23916
CVE-2023-27533	CVE-2023-27534
CVE-2023-27535	CVE-2023-27536
CVE-2023-27538	CVE-2023-27538
CVE-2023-28319	CVE-2023-28320
CVE-2023-28321	CVE-2023-28322

Suporte para usar certificados personalizados para se conectar aos Serviços IoT do Azure

Os dispositivos do Azure Sphere agora podem utilizar cadeias de certificados personalizadas para se conectar aos Serviços IoT do Azure. A utilização de cadeias de certificados que não sejam do Azure Sphere é útil com aplicativos que têm requisitos organizacionais adicionais em relação ao uso de certificados. As diretrizes sobre como se conectar com o Azure IoT foram atualizadas para descrever melhor esse caso de uso. Todos os clientes que usam a versão da API Beta desse recurso lançada com o sistema operacional 23.05 devem migrar para as novas APIs baixando o SDK mais recente e recompilando seu aplicativo, observando que as assinaturas de função foram alteradas para promover a aplicação de produção desse recurso.

Recursos novos e alterados nas extensões SDK 24.03 e Visual Studio/Visual Studio Code

A versão 24.03 do SDK do Azure Sphere e das extensões de código do Visual Studio/Visual Studio inclui as seguintes alterações:

Fim do suporte para Ubuntu 18.04 LTS

O Ubuntu 18.04 está agora fora do acordo de suporte padrão de longo prazo da Canonical. Como tal, o SDK 23.05 foi o último SDK do Azure Sphere a suportar esta versão do SO. 24.03 e futuros SDKs não suportarão o Ubuntu 18.04.

Adicionado suporte SDK para o pré-lançamento do Ubuntu 24.04

O SDK 24.03 adiciona suporte para a versão de pré-lançamento do Ubuntu 24.04, adicionando ao suporte existente do Ubuntu 20.04 e 22.04. Isto é para fins de desenvolvimento e teste do Ubuntu 24.04 antes de ser lançado ao público.

Mudanças no CMake Toolchain

No SDK versão 23.05 e anteriores, o conjunto de API de destino (sysroot) usado pelos aplicativos do Azure Sphere tinha que ser especificado nos arquivos CMakePresets.json e CMakeLists.txt, que era duplicado e, às vezes, exigia atualização manual após cada versão do SDK.

Para simplificar esse processo e agilizar atualizações futuras, as azsphere_configure_tools entradas e azsphere_configure_api CMakeLists.txt foram tornadas desnecessárias e obsoletas. O processo de compilação agora usa apenas o valor AZURE_SPHERE_TARGET_API_SET em CMakePresets.json como a fonte da verdade para a versão da API de destino.

Por padrão, o AZURE_SPHERE_TARGET_API_SET valor do parâmetro é definido como "latest-lts" em CMakePresets.json o que significa que, quando o SDK é atualizado, o projeto direciona automaticamente a versão mais recente da API. Se você quiser fixar a versão da API em uma versão específica (por exemplo, ao criar aplicativos para fabricação de produtos com uma versão específica do sistema operacional), defina o AZURE_SPHERE_TARGET_API_SET parâmetro para essa versão.

Os projetos existentes continuarão a ser compilados com o novo SDK, embora uma mensagem de aviso informe ao usuário que ele pode remover as entradas CMakeLists.json preteridas. Novos projetos criados com base nos exemplos do GitHub exigirão as extensões SDK e VS/VS Code 24.03 ou posteriores.

Amostras atualizadas para 24.03

A versão 24.03 inclui as seguintes alterações nos exemplos:

Atualizações para o exemplo do Azure Sphere HTTPS cURL Multi

O exemplo anterior do Azure Sphere HTTPS cURL Multi não seguia mais as práticas recomendadas de cURL atualmente recomendadas, que podem ser vistas com mais detalhes aqui. Embora tenhamos preservado a compatibilidade com a abordagem antiga, atualizamos nosso exemplo e recomendamos incorporar a abordagem mais recente em quaisquer atualizações de software ou novos trabalhos de desenvolvimento que você possa estar realizando.

Atualizações para exemplos para usar a extensão azure-sphere para a CLI do Azure

Recomendamos o uso da interface do Azure Sphere (Integrada) agora disponível ao público para trabalhos de desenvolvimento futuros. As instruções nos arquivos README de exemplo foram atualizadas para usar comandos na extensão azure-sphere para a CLI do Azure.

Versão do Azure Sphere (Integrado) Public Preview

8 de agosto de 2023

Temos o prazer de anunciar a Pré-visualização Pública do Azure Sphere (Integrado), uma nova interface de gestão para os serviços do Azure Sphere que está nativamente integrada com o Azure através do Azure Resource Manager.

Este Azure Sphere (Integrado) Public Preview inclui:

• Uma nova API REST para os Serviços de Segurança do Azure Sphere, integrada com o Azure Resource Manager
• Integração do Portal do Azure e da CLI do Azure
• Integração do Azure Monitor
• Integração do Azure RBAC

Leia este artigo para saber mais sobre segurança, observabilidade, usabilidade, acesso simplificado ao suporte e outros benefícios dessas integrações.

Durante a Pré-visualização Pública, recomenda-se utilizar o Azure Sphere (Integrado) para fins de desenvolvimento e teste. Como prática recomendada, os casos de uso de produção (por exemplo, durante fluxos de trabalho de fabricação ou operações) não devem usar um produto de visualização. Portanto, para casos de uso de produção, recomendamos que você continue a usar a interface existente do Serviço de Segurança do Azure Sphere, agora conhecida como Azure Sphere (Legado), que continua a ter suporte total e disponibilidade geral.

Para saber mais sobre o Azure Sphere (Integrado) e o Azure Sphere (Legado), incluindo como começar, consulte este documento.

Não há nenhuma atualização do sistema operacional ou SDK como parte desta versão. As ferramentas de linha de comando do Azure Sphere (Integrado) são fornecidas por uma nova extensão da CLI do Azure que requer que o SDK do Azure Sphere 23.05 seja instalado ao usar comandos que interagem com um dispositivo conectado.

O que há de novo na versão 23.05

26 de outubro de 2023

A versão do Azure Sphere 23.05 Update 1 inclui as seguintes atualizações para as extensões do Azure Sphere para Visual Studio e para Visual Studio Code:

• Um novo atalho para o gerenciamento de catálogo do Azure Sphere (Integrado)
• Correções de erros

Ele não inclui um sistema operacional ou SDK atualizado.

20 de junho de 2023

A versão de recursos do Azure Sphere 23.05 inclui os seguintes componentes:

• SO do Azure Sphere atualizado
• SDK do Azure Sphere atualizado para Windows e Linux
• Atualizações para as extensões do Azure Sphere para Visual Studio e Visual Studio Code

Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud. Você será solicitado a instalar o SDK atualizado no próximo uso ou poderá instalá-lo agora. Para instalar o SDK mais recente, consulte o Guia de início rápido de instalação para Windows ou Linux.

Os destaques nesta versão incluem novas bibliotecas criptográficas, fallback NTP padrão, novas APIs beta no Windows para conexões IoT do Azure usando seu próprio certificado, testes de fábrica mais rápidos e aprimorados, suporte a vários dispositivos para Linux, um novo repositório de ferramentas e graduação do projeto Galeria de autoajuda Parse Device Logs para status totalmente suportado.

Recursos novos e alterados no sistema operacional 23.05

A versão 23.05 do sistema operacional Azure Sphere inclui as seguintes alterações:

Bibliotecas criptográficas integradas gerenciadas pela Microsoft

Como parte da versão 23.05, o Azure Sphere tem bibliotecas criptográficas incorporadas ao SO. Através da nossa parceria com a wolfSSL, pode agora chamar APIs selecionadas da wolfCrypt na sua aplicação que lhe permitem executar encriptação e desencriptação ECC ou xChaCha, geração e gestão de certificados e muito mais, sem incorrer num impacto RAM ou flash para as criar na sua aplicação. Em vez disso, você será atendido pelas bibliotecas internas do sistema operacional Azure Sphere, que podem ser corrigidas e mantidas atualizadas pela Microsoft. Esta nova funcionalidade faz parte da nossa promessa de compatibilidade ABI para a vida útil do produto, e você pode ver as promessas de longo prazo da ABI da wolfSSL em seu site, onde eles também fornecem exemplos de como usar essas APIs wolfCrypt, como ECC.

Robustez NTP expandida

Caso os servidores de tempo NTP da Microsoft estejam enfrentando uma interrupção, os dispositivos do Azure Sphere agora tentarão fazer fallback para um servidor NTP NIST depois de tentar vários pontos de extremidade regionais da Microsoft, a menos que um NTP personalizado esteja sendo usado com configurações de fallback personalizadas. Isso expande a robustez de conectividade dos dispositivos Azure Sphere, dando-lhes mais opções para sincronizar a comunicação com a nuvem e outros servidores. Os administradores de dispositivos do Azure Sphere protegidos por firewalls podem consultar os detalhes do ponto de extremidade atualizados aqui.

Suporte a certificados de terceiros 3rd para Azure IoT (Beta) no Windows

O SO do Azure Sphere inclui o Azure IoT C SDK. Novidade para este sistema operacional, no Windows, estamos visualizando APIs como parte de nosso programa Beta para utilizar certificados fornecidos pelo aplicativo para se conectar ao Azure IoT, esses certificados não precisam estar enraizados no dispositivo Azure Sphere. Isso permite uma conexão fácil com os recursos do Azure IoT com certificados que se enraízam em sistemas existentes. Essas APIs Beta são otimizadas para testes atualmente, mas serão atualizadas para dar suporte a operações de produção em escala. Se você tiver comentários sobre essas APIs, incluindo os requisitos do ambiente de produção, entre em contato conosco pelo e-mail AZSPPGSUP@microsoft.com. As novas APIs são AzureIoT_OverrideAzureSphereAuthCert e AzureIoT_OverrideAzureSphereAuthPrivateKey.

Atualize o suporte ao RF Tools OS e melhore o desempenho das ferramentas

As ferramentas de RF foram atualizadas para incluir:

• Suporte para plataformas Windows e Linux x86, incluindo multi-dispositivo.
• Melhorias de desempenho para leitura e gravação de dados de bufferbin e eFuse, através de novas chamadas de SO em lote.
• Uma biblioteca Python, auxiliando os usuários Python com o desenvolvimento de seus próprios scripts e aplicativos.

Recursos novos e alterados no SDK 23.05

A versão 23.05 do SDK do Azure Sphere inclui as seguintes alterações:

Suporte a vários dispositivos Linux

O SDK 23.05 adiciona suporte para vários dispositivos Azure Sphere conectados simultaneamente no Linux, alinhando esse recurso com o suporte existente no Windows. Isso tem particular relevância para cenários de fabricação baseados em Linux.

Além disso, não há mais necessidade de chamar o script ao conectar um novo dispositivo - a conexão agora ocorre automaticamente em paridade com o azsphere_connect.sh suporte existente do Windows. Consulte a documentação atualizada sobre a instalação do SDK do Linux.

Adicionar suporte SDK para Ubuntu 22.04 LTS

O SDK 23.05 adiciona suporte para o Ubuntu 22.04, adicionando ao suporte existente do Ubuntu 18.04 e 20.04. O instalador do SDK do Linux pode determinar a versão LTS do Ubuntu que você está executando e baixar ou instalar o SDK apropriado.

Aviso de fim de suporte para Ubuntu 18.04 LTS

O Ubuntu 18.04 está agora fora do acordo de suporte padrão de longo prazo da Canonical. Como tal, o SDK 23.05 será o último SDK do Azure Sphere a suportar esta versão do SO. SDKs futuros não suportarão o Ubuntu 18.04.

Recursos novos e alterados na versão 23.05 para Visual Studio ou extensões de código do Visual Studio para o Azure Sphere

A versão 23.05 das extensões Azure Sphere Visual Studio e Visual Studio Code inclui as seguintes alterações:

• Experiência de depuração aprimorada ao depurar aplicativos com capacidade em tempo real e ao depurar vários aplicativos.
• Novos modelos de projeto atualizados.

Novo repositório GitHub de ferramentas

Um novo repositório GitHub, Azure Sphere Tools, foi introduzido. Este repositório conterá ferramentas adicionais oficialmente suportadas relacionadas à fabricação, suporte e diagnóstico. A pasta de fabricação foi realocada do repositório de amostras, colocando as ferramentas de fabricação em um único local fácil de encontrar, ao mesmo tempo em que reduz a pegada do repositório de amostras.

Projetos de galeria novos e atualizados para 23.05

A versão 23.05 dos exemplos do Azure Sphere, trechos de código e projetos da Galeria inclui as seguintes alterações:

A versão 23.05 do Azure Sphere inclui o projeto Parse Device Logs que se formou na Galeria e agora é um projeto oficialmente suportado localizado no novo repositório do Azure Sphere Tools .

O que há de novo na versão 23.02

21 fevereiro 2023

A versão do Azure Sphere 23.02 inclui correções de bugs apenas no sistema operacional Azure Sphere; ele não inclui um SDK atualizado. Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud.

Erros corrigidos e vulnerabilidades comuns na versão 23.02

A versão 23.02 inclui atualizações para mitigar as seguintes Vulnerabilidades e Exposições Comuns (CVEs):

• CVE-2022-37434 zlib
• CVE-2018-25032 zlib

Projetos de Galeria novos e atualizados para 23.02

A versão 23.02 dos exemplos do Azure Sphere, fragmentos de código e projetos da Galeria inclui as seguintes alterações:

Projeto da Galeria de descoberta de serviço DNS Unicast

O projeto Galeria de descoberta de serviço DNS Unicast demonstra como executar a descoberta de serviço DNS enviando consultas DNS-SD para um servidor DNS configurado. Ao contrário da deteção de serviço multicast, este mecanismo pode ser utilizado para abrir dinamicamente o acesso não só a pontos finais locais, mas também a pontos finais remotos na firewall do dispositivo no runtime.

O que há de novo na versão 22.11

1 de dezembro de 2022

A versão de recursos do Azure Sphere 22.11 inclui os seguintes componentes:

• Atualizar para as chaves de assinatura de imagem usadas pelo Serviço de Segurança do Azure Sphere
• SO do Azure Sphere atualizado
• SDK do Azure Sphere atualizado para Windows e Linux
• Extensões atualizadas do Azure Sphere para Visual Studio e Visual Studio Code

Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud. Você será solicitado a instalar o SDK atualizado no próximo uso ou poderá instalá-lo agora. Para instalar o SDK mais recente, consulte o Guia de início rápido de instalação para Windows ou Linux:

• Guia de início rápido: instalar o SDK do Azure Sphere para Windows
• Guia de início rápido: instalar o SDK do Azure Sphere para Linux

Os destaques nesta versão incluem uma nova versão do Malloc, um SDK do Azure IoT C atualizado, uma redução do tempo limite do DHCP e o suporte da Visualização Pública do Azure Sphere para o Limite de Dados Europeu.

Novas chaves de assinatura de imagem sendo usadas pelo Serviço de Segurança do Azure Sphere

O Serviço de Segurança do Azure Sphere agora usa novas chaves de assinatura de imagem. Essas chaves são usadas pelo nosso serviço para assinar quaisquer imagens de aplicativos recém-carregadas e novos arquivos de recursos (por exemplo, ao ativar o modo de desenvolvimento em dispositivos). O sistema operacional 22.11 foi assinado usando as chaves antigas, mas os futuros sistemas operacionais serão assinados usando as novas chaves. Todas as chaves existentes continuam a ser confiáveis pelos dispositivos do Azure Sphere.

Para que os dispositivos do Azure Sphere aceitem assinaturas usando as novas chaves, uma atualização de armazenamento de chaves confiável (TKS) foi lançada em 14 de novembro de 2022. Nenhuma ação do usuário é necessária para dispositivos de produção. Para determinados cenários de fabricação, desenvolvimento ou manutenção de campo em que o sistema operacional Azure Sphere não está atualizado, talvez seja necessário executar etapas adicionais para garantir que as imagens recém-assinadas sejam confiáveis pelo dispositivo – consulte esta postagem de blog para obter detalhes completos.

Recursos novos e alterados no sistema operacional 22.11

A versão 22.11 do sistema operacional Azure Sphere inclui as seguintes alterações:

Nova versão Malloc

O SO Azure Sphere continua a suportar o modelo malloc existente sem quaisquer alterações necessárias a uma aplicação e é binário compatível com versões anteriores para todas as aplicações criadas anteriormente. No entanto, uma nova opção de manifesto do aplicativo permite que os desenvolvedores optem por MallocVersion=2, que introduz o modelo malloc MUSL v1.2.1+, mallocng. Esta versão malloc é mais eficiente e mais segura e melhora significativamente o livre de memória. Exemplos e tutoriais foram atualizados para usar esta versão por padrão e recomendamos adicioná-la a qualquer novo aplicativo que esteja sendo desenvolvido. Para alguns cenários de aplicativos, espera-se que o pico de uso de memória seja menor ao usar essa nova versão do malloc.

Azure IoT C SDK atualizado

Atualizámos o Azure IoT C SDK para a versão mais recente. Este SDK inclui correções de bugs e melhorias de estabilidade e é binário compatível com versões anteriores. Todos os aplicativos existentes se beneficiarão de melhorias nos bastidores administradas pelo sistema operacional Azure Sphere.

Redução do tempo limite do DHCP

O tempo limite de repetição do DHCP foi reduzido de 10s para 1s. Esta redução melhora o consumo de bateria quando um dispositivo está à espera de uma concessão DHCP, o que se espera que ocorra com algumas configurações de rede e cenários de tráfego.

Recursos novos e alterados no SDK 22.11

A versão 22.11 do SDK do Azure Sphere inclui as seguintes alterações:

Suporte para outros formatos de saída de comando CLI

Como parte do esforço contínuo para introduzir a saída JSON nos comandos da CLI, facilitando o script e a automatização, o azsphere image add e o azsphere device show-os-version foram atualizados para suportar a saída JSON. Consulte Comandos suportados para obter a lista de comandos que atualmente suportam vários formatos de saída.

Exemplos novos e atualizados, fragmentos de código e projetos da Galeria

A versão 22.11 dos exemplos do Azure Sphere, trechos de código e projetos da Galeria inclui as seguintes alterações:

Registrando no projeto de exemplo do Azure

O projeto de Exemplo de Registro em Log no Azure demonstra como usar o Hub IoT em conjunto com o Azure Data Explorer para capturar logs no nível do aplicativo de uma forma que seja escalável e consultável.

Projeto PWM Audio Gallery

O projeto PWM Audio Gallery demonstra como usar os periféricos PWM de hardware do MT3620 para gerar sons tonais para uso com um buzzer ou outro dispositivo gerador de áudio, um caso de uso comum do produto.

Pré-visualização Pública: Suporte do Azure Sphere para Limite de Dados Europeu

Em conformidade com a missão da Microsoft de processar e armazenar dados da UE exclusivamente no espaço da UE (veja Limite de Dados da UE para a Microsoft Cloud), o Serviço de Segurança do Azure Sphere agora permite que os clientes da UE processem e armazenem ficheiros de imagem e ficheiros de informação de falha de sistema de dispositivos no espaço da UE, conforme pretendiam. A nova definição Limite de Dados Regional é um parâmetro opcional que pode ser utilizado com a imagem do azsphere e os comandos do grupo de dispositivos do azsphere.

Para obter mais informações, consulte:

• Comando do grupo de dispositivos da CLI do Azure Sphere | Microsoft Learn
• Comando da imagem da CLI do Azure Sphere | Microsoft Learn

Convidamos os clientes sediados na UE a experimentar esta nova funcionalidade e a enviar qualquer feedback por correio eletrónico para AZSPPGSUP@microsoft.coma .

Documentação nova e revisada na versão 22.11

Artigo	Alterações
Formatos de saída suportados para a CLI do Azure Sphere	Lista atualizada de comandos que suportam vários formatos de saída.

Sobre a versão de qualidade 22.10

25 outubro 2022

A versão 22.10 inclui apenas correções de bugs no sistema operacional Azure Sphere; ele não inclui um SDK atualizado. Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud.

Erros corrigidos e vulnerabilidades comuns na versão 22.10 

Esta versão inclui melhorias gerais que podem causar um reinício duplo esperado em alguns dispositivos.

A versão 22.10 não inclui atualizações para mitigar Vulnerabilidades e Exposições Comuns (CVEs).

O que há de novo na versão 22.09

26 setembro 2022

A versão de recursos do Azure Sphere 22.09 inclui os seguintes componentes:

• SO do Azure Sphere atualizado
• SDK do Azure Sphere atualizado para Windows e Linux
• Extensões atualizadas do Azure Sphere para Visual Studio e Visual Studio Code

Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud. Você será solicitado a instalar o SDK atualizado no próximo uso ou poderá instalá-lo agora. Para instalar o SDK mais recente, consulte o Guia de início rápido de instalação para Windows ou Linux:

• Guia de início rápido: instalar o SDK do Azure Sphere para Windows
• Guia de início rápido: instalar o SDK do Azure Sphere para Linux

Os destaques nesta versão incluem uma diminuição no tempo de inicialização a frio para se conectar à nuvem para o sistema operacional, resultando em menor uso de energia; Orientação de práticas recomendadas para solução remota de problemas e scripts de fabricação otimizados.

Recursos novos e alterados no sistema operacional 22.09

A versão 22.09 do sistema operacional Azure Sphere inclui as seguintes alterações:

Suporte expandido a NIC Ethernet

O Azure Sphere agora suporta o adaptador de interface de rede Ethernet WIZnet W5500 10/100 para conexões voltadas para a Internet. Esta peça de hardware pode aumentar o desempenho e a disponibilidade no mercado para aplicações ethernet com fios.

Proteções de segurança para ataques de reversão

Como parte de nossa defesa profunda contra ataques de reversão, a recuperação e a reversão para versões anteriores do sistema operacional Azure Sphere anteriores à 22.07 não estarão disponíveis em dispositivos que já atualizaram para a versão 22.09.

Depois que um dispositivo for atualizado para a versão 22.09, ele não poderá mais executar uma versão do sistema operacional Azure Sphere anterior à 22.07. Isso significa que você não poderá recuperar um dispositivo para uma versão anterior depois que ele receber a atualização 22.09. A versão 22.07 se tornará a versão mais antiga que pode ser instalada no dispositivo.

Recursos novos e alterados no SDK 22.09

A versão 22.09 do SDK do Azure Sphere inclui as seguintes alterações:

Suporte para outros formatos de saída de comando CLI

Comandos adicionais da CLI agora suportam saída JSON. Esse formato de saída facilita o script e a automação em relação à saída da CLI. Consulte Comandos suportados para obter a lista de comandos que atualmente suportam vários formatos de saída.

Recursos novos e alterados na versão 22.09 para Visual Studio ou extensões de código do Visual Studio para o Azure Sphere

A versão 22.09 das extensões Azure Sphere Visual Studio e Visual Studio Code inclui as seguintes alterações:

Configuração simplificada para aplicações com capacidade em tempo real

A versão 22.09 do Azure Sphere fornece um processo de configuração mais simples usando artefatos vcpkg para inicializar seu ambiente de desenvolvimento para criar aplicativos capazes em tempo real. Para obter mais informações, consulte Tutorial: Criar um aplicativo capaz em tempo real.

Exemplos novos e atualizados, fragmentos de código e projetos da Galeria

A versão 22.09 do Azure Sphere inclui as seguintes alterações nos exemplos, trechos de código e projetos da Galeria:

Solução de problemas de autoajuda durante o desenvolvimento de aplicativos

A análise de log get-support-data permite a autoajuda para solução de problemas durante o desenvolvimento de aplicativos. Quando conectado localmente a um dispositivo, use azsphere get-support-data para baixar um pacote de logs, erros e status de um dispositivo Azure Sphere. Use o projeto de galeria de análise de log para converter dados de log binários em formato legível por humanos para exibir eventos registrados no sistema do sistema operacional Azure Sphere.

Versão v1.0.0 das ferramentas de fabricação

Publicamos ferramentas de fabricação atualizadas. Essas ferramentas permitem que os clientes integrem comandos da API REST do dispositivo, normalmente acessados via CLI, diretamente em seus aplicativos de fabricação na forma de pacotes Python PyPy e C# NuGet. Uma definição YAML OpenAPI também é fornecida, permitindo que os clientes gerem suas próprias bibliotecas de clientes em um idioma de sua escolha por meio de ferramentas como o AutoRest.

Como essas ferramentas se comunicam diretamente com a API REST de dispositivos Azure Sphere conectados, muitos comandos podem ver acelerações de até 5x em comparação com scripts contra azsphere CLI.

Projeto Azure Sphere Squirrel Gallery

O projeto Azure Sphere Squirrel Gallery demonstra a execução de uma linguagem de script de nível superior no chip MT3620.

Documentação nova e revisada na versão 22.09

Artigo	Alterações
Adaptadores Ethernet e placas de desenvolvimento suportados	Tópico atualizado para documentar o suporte para controladores Ethernet baseados em WIZnet W5500.
Tutorial: Crie um aplicativo capaz de trabalhar em tempo real	Atualizado para documentar uma opção para que os artefatos vcpkg instalem e configurem automaticamente o GNU Arm Embedded Toolchain.
Práticas recomendadas para solução de problemas remota	Novo tópico que inclui uma lista de perguntas e fluxogramas para ajudá-lo a triar problemas do dispositivo.
Formatos de saída suportados para a CLI do Azure Sphere	Lista atualizada de comandos que suportam vários formatos de saída.

Problemas conhecidos na versão 22.09

Ao usar o W5500 para se conectar a uma rede com fio, se o cabo de rede estiver desconectado, a interface ainda poderá ser relatada como "ativada" pela CLI e por APIs internas. Isso será corrigido em uma versão futura do sistema operacional.

Corrigidos bugs e vulnerabilidades comuns na versão 22.09

A versão 22.09 inclui as seguintes atualizações para mitigar as seguintes vulnerabilidades e exposições comuns (CVEs):

• wolfSSL CVE-2022-34293

O que há de novo na versão 22.07

26 julho 2022

A versão do Azure Sphere 22.07 inclui os seguintes componentes:

• SO do Azure Sphere atualizado
• SDK do Azure Sphere atualizado para Windows e Linux
• Extensões atualizadas do Azure Sphere para Visual Studio e Visual Studio Code

Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud. Para instalar o SDK mais recente, consulte o Guia de início rápido de instalação para Windows ou Linux:

• Guia de início rápido: instalar o SDK do Azure Sphere para Windows
• Guia de início rápido: instalar o SDK do Azure Sphere para Linux

Os destaques nesta versão incluem uma diminuição no tempo de conexão à nuvem para o sistema operacional, resultando em menor uso de energia, publicação de orientações de práticas recomendadas para aplicativos prontos para produção e publicação de scripts de fabricação otimizados.

Recursos novos e alterados no sistema operacional 22.07

A versão 22.07 do sistema operacional Azure Sphere inclui:

• O sistema operacional agora suporta o cache do certificado DAA (cliente) no armazenamento persistente. Isso resulta em menor consumo de energia na inicialização a frio e menor tempo para se conectar à nuvem após a inicialização a frio ou desligamento.
• O sistema operacional tem uma nova função API, Applications_GetOSVersion(), em Applibs applications.h que retorna uma cadeia de caracteres imprimível contendo a versão atual do sistema operacional.

Recursos novos e alterados no SDK 22.07

A versão 22.07 do SDK do Azure Sphere inclui as seguintes alterações.

Suporte para saída CLI monocromática

A CLI do Azure Sphere agora oferece suporte à saída monocromática por motivos de acessibilidade. Usando este comando, você pode gerenciar a configuração de cores para mensagens na CLI do Azure Sphere. Se você habilitar o parâmetro, as no-color mensagens coloridas serão removidas e as mensagens coloridas originalmente serão prefixadas com DEBUG, INFO, WARNING, ou ERROR.

Autenticação clássica da CLI do Azure Sphere migrada da ADAL para a MSAL

A CLI clássica do Azure Sphere agora usa a Biblioteca de Autenticação da Microsoft (MSAL) em vez da Biblioteca de Autenticação do Ative Directory (ADAL), que está sendo desativada. Não há nenhuma alteração no uso da CLI clássica do Azure Sphere como resultado da migração para MSAL e nenhuma ação do cliente é necessária.

Suporte para outros formatos de saída

Os seguintes comandos da CLI do Azure Sphere agora oferecem suporte ao --output parâmetro or -o para especificar o formato da saída da CLI. Consulte Comandos suportados para obter a lista de comandos que atualmente suportam vários formatos de saída.

• Status de exibição do aplicativo de dispositivo Azsphere
• Exclusão de sideload do dispositivo Azsphere
• Implantação de sideload do dispositivo Azsphere

Recursos novos e alterados nas extensões 22.07 Visual Studio e Visual Studio Code

CMakePresets agora são suportados pelo Visual Studio e Visual Studio Code. O arquivo CMakePresets.json permite especificar opções comuns de configuração, compilação e teste e, em seguida, compartilhá-las com desenvolvedores usando outros ambientes de desenvolvimento.

Exemplos novos e atualizados, trechos de código e itens da Galeria

A versão 22.07 inclui as seguintes alterações nos exemplos, trechos de código e itens da Galeria.

Atualizações de exemplos para usar APIs sem bloqueio para o Azure IoT

Os exemplos do Azure IoT e ExternalMcuLowPower foram atualizados para evitar o uso de APIs de bloqueio para o Azure IoT e, em vez disso, usar APIs sem bloqueio. Se o código do seu aplicativo usa IoTHubDeviceClient_LL_CreateWithAzureSphereDeviceAuthProvisioning recomendamos que você examine os exemplos atualizados e considere se um padrão de API sem bloqueio atenderia melhor às suas necessidades.

Amostras de fabricação

Publicamos amostras de fabricação atualizadas. Anteriormente, as amostras de fabricação eram distribuídas de forma privada, mas a partir desta versão as amostras serão mantidas no GitHub. Como parte disso, publicamos as APIs REST do dispositivo (permitindo ignorar a CLI para se comunicar diretamente com a API REST do dispositivo) com suporte a C# e Python, aplicativos de exemplo e testes. Os scripts de fabricação são portados para usar essas APIs REST. Esse uso direto de APIs REST do dispositivo permite aumentar a velocidade de fabricação. Para obter mais informações, consulte Guia de fabricação para dispositivos conectados.

Atualizações na orientação da interface FTDI e projetos de hardware

Fizemos algumas pequenas alterações em nossa orientação de hardware MT3620 relacionadas a como a interface de programação e depuração FTDI lida com o despertar de modos de baixo consumo de energia. Isso melhora a compatibilidade com o módulo Avnet MT3620 V2. Alguns valores de resistor foram atualizados na interface de programação e depuração MT3620. O exemplo de MCU para nuvem de baixo consumo de energia foi atualizado para refletir essa orientação, e emitimos novos exemplos de hardware para MCU de baixo consumo de energia para hardware em nuvem v2.0 e placa de interface FTDI v2.0 que refletem essa orientação atualizada. As atualizações da placa de interface FTDI v2.0 também adicionam pegadas duplas para conectores Service/Debug, Recovery e SWD.

Novo trecho para a API Applications_GetOSVersion

A nova Versão do SO Get Azure Sphere Device mostra como obter a Versão do SO do Dispositivo Azure Sphere numa aplicação de Alto Nível.

Documentação nova e revisada na versão 22.07

Artigo	Alterações
Configurar compilações usando o CMake	Tópico atualizado para incluir informações sobre como configurar CMakePresets.json com Visual Studio e Visual Studio Code.
Crie um aplicativo capaz de trabalhar em tempo real	Tópico atualizado para descrever novas configurações do CMake e comandos de compilação.
Recomendações para o desenvolvimento de aplicativos prontos para produção	Novos tópicos para fornecer práticas recomendadas para verificar se seus aplicativos Azure Sphere de alto nível ou em tempo real estão prontos para implantação piloto ou de produção.
Configuração do Azsphere	Novo tópico que fornece detalhes sobre o azure setting comando.
Formatos de saída suportados para a CLI do Azure Sphere	Lista atualizada de comandos que suportam vários formatos de saída.
Applications_GetOsVersion função	Adicionado tópico para a nova função API.
Guia de fabrico	Atualizado para refletir novas amostras de fabricação publicadas no GitHub.

Problemas conhecidos na versão 22.07

Se a interface de rede Wi-Fi estiver desativada e, em seguida, o dispositivo for reinicializado, um valor arbitrário para o endereço de hardware da interface (endereço MAC) será apresentado quando você executar o azsphere device network list-interfaces comando CLI ou ao usar a Networking_GetHardwareAddress API. Para resolver isso, reative a interface Wi-Fi e execute novamente o comando ou a API da CLI para receber o endereço de hardware correto.

Corrigidos bugs e vulnerabilidades comuns na versão 22.07

• O azsphere tenant create comando agora funciona quando um dispositivo Azure Sphere conectado localmente está disponível. Nas versões 21.10 e posteriores foi reportado um erro mesmo que o dispositivo esteja ligado. A correção agora identifica automaticamente o dispositivo conectado ao criar um locatário.

• A versão 22.07 inclui as seguintes atualizações para mitigar as seguintes vulnerabilidades e exposições comuns (CVEs):

  • cURL CVE-2022-22576
  • cURL CVE-2022-27775
  • cURL CVE-2022-27778
  • cURL CVE-2022-27779
  • cURL CVE-2022-27780
  • cURL CVE-2022-27782
  • cURL CVE-2022-30115
  • CVE-2022-35821

Sobre a versão de qualidade 22.04

11 abril 2022

A versão 22.04 inclui uma atualização para o kernel Linux (5.10.103) e correções de bugs no sistema operacional Azure Sphere; ele não inclui um SDK atualizado. Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud.

Corrigidos bugs e vulnerabilidades comuns na versão 22.04

A versão 22.04 inclui atualizações para mitigar as seguintes vulnerabilidades e exposições comuns (CVEs):

• wolfSSL CVE-2022-25638
• wolfSSL CVE-2022-25640
• C-Ares CVE-2021-3672
• Linux CVE-2022-0847 ("tubo sujo")

Projetos de galeria novos e atualizados para 22.04

O novo projeto Gallery AzureFunctionApp_AzureSpherePublicAPI demonstra como usar a API Pública do Azure Sphere em um aplicativo Python Azure Function.

Documentação nova e revisada na versão 22.04

Artigo	Alterações
Pare o Serviço de Comunicação de Dispositivo do Azure Sphere	Adicionada uma seção de solução de problemas relacionada ao instalador suspenso durante a instalação.
Conectar o Azure Sphere por meio de um servidor proxy	Adicionados requisitos de manifesto do aplicativo e informações sobre como usar o MQTT para se conectar ao Hub IoT do Azure.
Configurar um Hub IoT do Azure para o Azure Sphere	Atualizado para tornar a experiência do usuário clara e correta.
Configurar um Hub IoT do Azure para o Azure Sphere com o Serviço de Provisionamento de Dispositivo	Atualizado para tornar a experiência do usuário clara e correta.
Configurar o Azure IoT Edge para o Azure Sphere	Atualizado para esclarecer o texto e corresponder à interface do usuário do Azure.
Configurar o Azure IoT Central para funcionar com o Azure Sphere	Atualizado para tornar a experiência do usuário clara e correta.
Feeds do SO Azure Sphere - Configurar dispositivos para avaliação do SO	Atualizado para esclarecer como o sistema operacional Azure Sphere é implantado no feed de avaliação de varejo.
Guia de fabrico	Atualizado para esclarecer o que está envolvido em um processo de fabricação de dispositivos.
Preparação do processo de fabrico	Novo tópico que fornece detalhes sobre tarefas que devem ser feitas antes de executar tarefas de chão de fábrica e tarefas de configuração de nuvem.
Tarefas de chão de fábrica	Atualizado para maior clareza. Transferiu as tarefas de preparação para o novo tópico de preparação de manufatura.
Tarefas de configuração na nuvem	Atualizado para maior clareza. Transferiu as tarefas de preparação para o novo tópico de preparação de manufatura.
Ferramentas de RF	Adicionada uma nova seção, Após a conclusão do uso de ferramentas de RF, para descrever as tarefas a serem feitas depois que você terminar de usar as ferramentas de RF.

Sobre a versão 22.02 Update 1

17 março 2022

A versão do Azure Sphere 22.02 Update 1 inclui os seguintes componentes:

• SDK do Azure Sphere atualizado para Windows e Linux
• Extensão do Azure Sphere atualizada para o Visual Studio Code

Ele não inclui um sistema operacional atualizado ou uma extensão atualizada do Visual Studio.

Atualizações no SDK da Atualização 1 22.02

O SDK atualizado resolve um problema anunciado no blog Tech Community IoT relacionado ao suporte de tempo de 64 bits do cabeçalho sys/socket.h que afeta o conjunto de API 12. Se você instalou a versão 22.02 original do SDK, instale a versão atualizada.

Gorjeta

Você pode usar o comando azsphere show-version Azure Sphere CLI para determinar qual versão do SDK você tem. O SDK 22.02 original tem o número de versão completa 22.02.3.34006; o 22.02 Update 1 SDK tem o número de versão completa 22.02.3.41775. Observe que a CLI do Azure Sphere Classic mostra apenas a versão no formato 22.02.

Para instalar o SDK mais recente, consulte o Guia de início rápido de instalação para Windows ou Linux:

• Guia de início rápido: instalar o SDK do Azure Sphere para Windows
• Guia de início rápido: instalar o SDK do Azure Sphere para Linux

Atualizações na extensão 22.02 Update 1 Visual Studio Code

No Linux, o explorador de locatários na extensão de código do Visual Studio para o Azure Sphere exibiu anteriormente um erro. A extensão atualizada exibe os resultados corretamente.

Atualizações no contêiner do ambiente de compilação da Atualização 1 22.02

O contêiner do ambiente de compilação do Azure Sphere foi atualizado para o SDK da Atualização 1 22.02.

O que há de novo na versão 22.02

A versão de recursos do Azure Sphere 22.02 inclui os seguintes componentes:

• SO do Azure Sphere atualizado
• SDK do Azure Sphere atualizado para Windows e Linux
• Extensões do Azure Sphere atualizadas para o Visual Studio e Visual Studio Code

Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud. Para instalar o SDK mais recente, consulte o Guia de início rápido de instalação para Windows ou Linux:

• Guia de início rápido: instalar o SDK do Azure Sphere para Windows
• Guia de início rápido: instalar o SDK do Azure Sphere para Linux

Há também exemplos atualizados , trechos de código, projetos da Galeria e atualizações de documentação.

Importante

08 março 2022

O SDK 22.02 tem um problema relacionado ao cabeçalho sys/socket.h e ao suporte de tempo musl de 64 bits incluídos no conjunto de API 12. O problema será resolvido em uma próxima atualização do SDK. Nenhuma alteração do sistema operacional é necessária para resolver esse problema. No entanto, por enquanto, se você estiver usando a função setsockopt() definida em sys/socket.h, não deve criar seus aplicativos de produção com o conjunto de API 12. Recomendamos o uso do conjunto de API 11 com a versão 22.02.

Isso afeta apenas aplicativos recém-compilados criados com a versão 22.02. Não afeta :

• Binários compilados existentes ou aplicativos implantados.
• Aplicativos criados com SDKs diferentes da versão 22.02 recente.
• Aplicativos criados com SDK 22.02, mas usando conjuntos de API diferentes da versão 12.

Recursos novos e alterados no sistema operacional 22.02

A versão 22.02 do SO Azure Sphere inclui uma atualização para o kernel Linux (5.10.70) e suporte para a versão e renovação DHCP.

Lançamento e renovação do DHCP

O SO Azure Sphere suporta agora a versão DHCP e a renovação através de novas APIs para que as aplicações de alto nível possam controlar as concessões IP dos seus dispositivos.

O novo exemplo de DHCP demonstra como usar essas novas APIs.

Recursos novos e alterados no SDK 22.02

A versão 22.02 do SDK do Azure Sphere inclui suporte para o Windows 11, atualizações para suporte de tempo de 64 bits, uma alteração no comportamento de log padrão da CLI e uma atualização da biblioteca de autenticação para a CLI.

Suporte para Windows 11

O Windows 11 agora tem suporte para o desenvolvimento do Azure Sphere. Se estiver a utilizar o Windows 11, instale o SDK 22.02 (ou posterior).

Suporte de tempo de 64 bits

A versão 22.02 do SDK atualiza o suporte para o tempo de 64 bits para aplicativos de alto nível. Isso corrige comportamentos inesperados introduzidos com suporte para tempo de 64 bits na versão 20.10.

O código do aplicativo que não faz suposições sobre o tamanho de um time_t valor não é afetado. No entanto, o código do time_t aplicativo que explícita ou implicitamente espera ser de 32 bits precisa ser reescrito para ser usado time32_t .

Gorjeta

Para garantir que seus aplicativos continuem a funcionar conforme o esperado após a reconstrução, verifique o uso de pilha e heap e o tamanho binário em seus aplicativos. Eles podem crescer, como time_t é agora 8 bytes em vez de 4.

Consulte a seção C type time_t do tópico APIs básicas para obter informações mais detalhadas.

Configurar o log da CLI do Azure Sphere

A CLI do Azure Sphere não grava mais arquivos de log no disco local por padrão. Consulte Gerenciar arquivos de log para obter detalhes sobre como habilitar e configurar o registro em log.

Autenticação da CLI do Azure Sphere migrada da ADAL para a MSAL

A CLI do Azure Sphere agora usa a Biblioteca de Autenticação da Microsoft (MSAL) em vez da Biblioteca de Autenticação do Ative Directory (ADAL), que está sendo desativada. Não há nenhuma alteração no uso da CLI do Azure Sphere como resultado da migração para MSAL e nenhuma ação do cliente é necessária.

A CLI do Azure Sphere Classic ainda usa a ADAL, mas será atualizada antes da data de desativação da ADAL de 30 de junho de 2022. Continuamos a recomendar que você migre para a nova CLI do Azure Sphere.

Recursos novos e alterados na versão 22.02 para Visual Studio ou extensões de código do Visual Studio para o Azure Sphere

Uma extensão do Azure Sphere para Visual Studio 2022 agora está disponível, além da extensão existente para Visual Studio 2019. A versão mínima suportada do Visual Studio 2019 agora é 16.11.

As extensões Visual Studio e Visual Studio Code para Azure Sphere agora fornecem estes recursos:

• Configure o Wi-Fi no Azure Sphere Explorer.
• Exiba o histórico de implantação no Azure Sphere Explorer.
• Abra o modo de exibição de desmontagem no Visual Studio Code durante a depuração.

Configurar Wi-Fi no Azure Sphere Explorer

Agora você pode adicionar redes Wi-Fi, conectar-se a elas, habilitá-las ou desabilitá-las e esquecê-las na interface gráfica do Azure Sphere Explorer.

Ver o histórico de implementações

Agora você pode exibir todas as implantações de um determinado grupo de dispositivos usando o Azure Sphere Explorer, incluindo a data e a ID do componente de cada implantação.

Abrir a vista de desmontagem durante a depuração

A visualização de desmontagem fornece uma visão de baixo nível do seu código nativo e aumenta o depurador passo a passo usual. Essa alteração na extensão de código do Visual Studio agora fornece a mesma experiência de desmontagem como no Visual Studio.

Exemplos novos e atualizados, trechos de código e projetos da Galeria para 22.02

• O novo exemplo de DHCP demonstra como usar as novas APIs para liberar ou renovar o endereço IP que um servidor DHCP atribuiu a um dispositivo.
• O exemplo de descoberta de serviço DNS foi atualizado para ser mais resiliente à desconexão de rede.
• O exemplo de comunicação entre núcleos foi atualizado para que ele não mostre uma caixa de diálogo adicional quando você abri-lo com versões mais recentes do Visual Studio.
• O novo trecho de código Get Azure Sphere Device ID mostra como usar a API do Azure Sphere para obter a ID do dispositivo em um aplicativo de alto nível.
• O novo projeto Industrial Device Controller na Galeria do Azure Sphere demonstra como conectar o Azure Sphere a vários dispositivos Modbus downstream para coletar dados de telemetria em tempo real.

Documentação nova e revisada na versão 22.02

Artigo	Alterações
Guia de início rápido: configurar a rede e atualizar o sistema operacional do dispositivo	Inclui instruções para configurar o Wi-Fi com o Azure Sphere Explorer.
Exibir informações de dispositivo e locatário no Azure Sphere Explorer	Atualizado para incluir novos recursos.
Use o GitHub Codespaces para criar e depurar	Novo tópico sobre como usar o Visual Studio Code para desenvolver aplicativos com o GitHub Codespaces.
Uso de memória em aplicativos de alto nível	Atualizado para incluir instruções para criar e executar scripts em lote para monitoramento de memória em um prompt de comando.
Depurar um aplicativo de alto nível	Atualizado para incluir instruções para abrir a vista de desmontagem.
Depurar um aplicativo com capacidade em tempo real	Atualizado para incluir instruções para abrir a vista de desmontagem.
Depurar aplicativo de parceiro	Atualizado para incluir instruções para abrir a vista de desmontagem.
Configurar compilações usando o CMake	Atualizado para descrever o novo arquivo de CMakeWorkspaceSettings.json necessário para projetos com várias raízes.
Identidade e segurança do dispositivo	Novo tópico sobre considerações de segurança e práticas recomendadas sugeridas para o uso de IDs de dispositivo.
Ver o histórico de implementações	Atualizado para incluir instruções para exibir o histórico de implantação no Azure Sphere Explorer.
Gerenciar arquivos de log	Novo tópico sobre como configurar o log usando a CLI.

Corrigidos bugs na versão 22.02

A versão 22.02 inclui as seguintes correções de bugs:

• WifiConfig_GetNetworkDiagnostics retornou um valor inesperado depois de tentar uma conexão WiFi com credenciais inválidas. A correção retorna a mensagem de erro correta.
• O timesync NTP pode ser lento e errático se um servidor NTP personalizado for especificado. A correção normaliza o processo de timesync para servidores personalizados.
• Os dispositivos que usam Ethernet ocasionalmente não conseguiram restabelecer a conectividade de rede quando ocorreu um erro de driver. Uma correção para o driver de interface de rede Ethernet restabelece a conectividade de rede de forma mais consistente nesses casos.

Problema conhecido na versão 22.02

Uma mensagem No section: 'sphere' de erro é exibida na CLI do Azure Sphere se o usuário não estiver autenticado. Para resolver isso, autentique-se na CLI do Azure Sphere usando o azsphere login comando.

Sobre a versão de qualidade 22.01

O Azure Sphere não lançou um sistema operacional ou SDK atualizado para 22.01. Veja a postagem do blog sobre o cancelamento da versão 22.01 para obter mais detalhes.

As atualizações para a versão 22.01 incluem dois novos projetos na Galeria e atualizações de documentação.

Nota

Na versão anterior, informamos que a CLI do Azure Sphere Classic seria removida do SDK a partir de abril de 2022. O prazo para a sua aposentadoria foi prorrogado. Pretendemos aposentar a CLI clássica em uma data futura, embora não antes do final de 2022. Continuamos a recomendar que você migre seus processos e scripts para a CLIv2.

Exemplos novos e atualizados e projetos da Galeria para 22.01

OpenSourceProjectsSupportingExternalPeripherals é uma lista de projetos de código aberto que usam hardware externo com o Azure Sphere e o chip MT3620.

ToggleClassicCLI fornece scripts para Windows e Linux que permitem testar a remoção da CLI do Azure Sphere Classic (e restaurá-la). A CLI do Azure Sphere Classic foi substituída pela CLIv2 e será removida do SDK do Azure Sphere em uma data futura. Esses scripts ajudarão a identificar dependências que você pode ter na CLI clássica.

Documentação nova e revisada na versão 22.01

Artigo	Alterações
Solucionar problemas do Azure Sphere	Adicionadas etapas de solução de problemas para a mensagem de erro "O Serviço de Comunicação de Dispositivo do Azure Sphere não pôde ser interrompido".
Usar tags de serviço para restringir o acesso ao Serviço de Segurança do Azure Sphere	Novo tópico sobre como usar a marca de serviço AzureSphere para permitir ou negar tráfego para o Serviço de Segurança do Azure Sphere.
Recursos do dispositivo e sessões de manutenção	Esclarecimento adicional sobre como os dispositivos adquirem capacidades e o que você pode fazer com o recurso fieldServicing .
Azure Sphere CVEs	Esclarecimento adicional sobre nossa participação com o Programa CVE e o impacto no cliente dos CVEs do Azure Sphere.
Módulos Guardian	Links atualizados, informações esclarecidas ao longo do tópico e seções reorganizadas.

Sobre a versão de qualidade 21.11

O Azure Sphere não lançou um sistema operacional ou SDK atualizado para 21.11.

As atualizações para a versão 21.11 incluem as seguintes alterações na documentação e outras edições menores:

Artigo	Alterações
Recursos do dispositivo e sessões de manutenção	Esclarecimentos e correções sobre quando as capacidades são necessárias e que ações permitem.
Configurar o Azure IoT Edge para o Azure Sphere	Atualizado para incluir instruções para trabalhar com o IoT Edge 1.2 e o IoT Edge 1.1.
Azure Sphere CVEs	Adicionadas informações sobre o conteúdo e o tempo das vulnerabilidades e exposições comuns (CVEs) do Azure Sphere publicadas.
Tarefas de chão de fábrica	Adicionadas informações sobre estados de fabricação e recursos do dispositivo.
dispositivo	Esclarecimentos e correções sobre as capacidades do dispositivo.
Visão geral da CLI do Azure Sphere	Esclarecimentos e correções sobre as capacidades do dispositivo.

O que há de novo na versão 21.10

A versão de recursos do Azure Sphere 21.10 inclui os seguintes componentes:

• SO do Azure Sphere atualizado
• SDK do Azure Sphere atualizado para Windows e Linux
• Extensões do Azure Sphere atualizadas para o Visual Studio e Visual Studio Code

Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud. Para instalar o SDK e as extensões mais recentes para Visual Studio e Visual Studio Code, consulte o Guia de início rápido de instalação para Windows ou Linux:

• Guia de início rápido: instalar o SDK do Azure Sphere para Windows
• Guia de início rápido: instalar o SDK do Azure Sphere para Linux

Importante

A CLI do Azure Sphere Classic não será incluída nas versões do SDK a partir de abril de 2022. A CLI clássica foi marcada como aposentada em fevereiro de 2021. Se você ainda tiver uma dependência da CLI clássica, deverá migrar seus processos e scripts antes de abril de 2022 para evitar interrupções.

Recursos novos e alterados na versão 21.10

A versão 21.10 inclui:

• Suporte para conexão a uma rede através de um servidor proxy.
• correções de segurança e melhorias de desempenho no wolfSSL versão 4.8.1.
• melhorias na conexão ao Hub IoT do Azure com o Serviço de Provisionamento de Dispositivo (DPS).
• a capacidade de renomear um locatário.
• suporte para especificar o formato de saída dos comandos Wi-Fi na CLI.
• orientação para usar o MT3620 em cenários onde o Wi-Fi não é necessário.

Suporte a proxy da Web

Os dispositivos do Azure Sphere agora podem se conectar a uma rede por meio de um servidor proxy. Você pode configurar um proxy com comandos applibs ou com a CLI. Para obter mais informações, consulte Conectar o Azure Sphere por meio de um servidor proxy.

Para obter mais informações sobre os comandos da CLI disponíveis, consulte proxy de rede.

wolfSSL atualizado para a versão 4.8.1

O sistema operacional Azure Sphere agora inclui wolfSSL 4.8.1. Esta atualização traz as mais recentes correções de segurança e melhorias de desempenho da wolfSSL. Além disso, um novo ABI é exposto através do sistema operacional para evitar ataques man-in-the-middle em algumas configurações TLS. Ao usar wolfSSL em sua aplicação (como mostrado na amostra wolfSSL), recomendamos usar wolfSSL_CTX_set_verify para validar o host sempre que aplicável.

Veja mais informações sobre a utilização do wolfSSL_CTX_set_verify no site da wolfSSL.

Verificar o certificado da autoridade de certificação do locatário automaticamente no Hub IoT do Azure

Atualizámos as orientações sobre como configurar o Hub IoT do Azure e o DPS com certificados de inquilino do Azure Sphere para incluir um processo simplificado que não requer uma etapa de verificação de prova de posse. Para obter mais informações, consulte Configurar um Hub IoT do Azure para o Azure Sphere e Configurar um Hub IoT do Azure para o Azure Sphere com o Serviço de Provisionamento de Dispositivo.

Suporte para renomeação de locatário

O azsphere tenant update comando Azure Sphere CLI permite renomear um locatário existente. Para obter mais informações, consulte o tópico de referência do comando do locatário.

Especificar formato de saída para comandos Wi-Fi

Os azsphere device wifi comandos agora suportam o --output parâmetro or -o para especificar o formato da saída da CLI. Para obter mais informações, consulte Formatos de saída suportados.

Usando o MT3620 em cenários onde o Wi-Fi não é necessário

Fornecemos orientações atualizadas de software e hardware para cenários em que o Wi-Fi não é necessário temporária ou permanentemente, mostrando como reduzir o consumo de energia e simplificar os projetos de hardware nesses cenários. Consulte Conexões Wi-Fi e notas de hardware MT3620 para obter detalhes.

Exemplos novos e atualizados e projetos da Galeria para 21.10

Os seguintes exemplos do Azure Sphere foram atualizados para 21.10:

• Um Leiame adicional foi adicionado ao exemplo AzureIoT para mostrar como adicionar suporte a proxy da Web.
• Os exemplos HTTPS/cURL foram atualizados para mostrar como adicionar suporte a proxy.

Os seguintes projetos na Galeria do Azure Sphere foram adicionados ou atualizados para 21.10:

• Azure IoT Store and Forward mostra como adicionar armazenamento de telemetria e capacidade de encaminhamento ao exemplo AzureIoT.
• CO2_MonitorHealthySpaces mostra como integrar um monitor de CO2 com o IoT Central.
• EAP-TLS_Solution mostra como conectar dispositivos do Azure Sphere a redes EAP-TLS.
• SimpleFileSystem_RemoteDisk mostra como adicionar suporte ao sistema de arquivos a um projeto do Azure Sphere.

Documentação nova e revisada na versão 21.10

Artigo	Alterações
Conectar o Azure Sphere por meio de um servidor proxy	Novo tópico que descreve como configurar um dispositivo Azure Sphere para se conectar à Internet por meio de um servidor proxy.
Configurar um Hub IoT do Azure para o Azure Sphere	Tópico atualizado para incluir informações sobre a verificação automática e manual de um certificado de CA de locatário no Hub IoT do Azure.
Configurar um Hub IoT do Azure para o Azure Sphere com o Serviço de Provisionamento de Dispositivo	Tópico atualizado para incluir informações sobre a verificação automática e manual de um certificado de CA de locatário no Serviço de Provisionamento de Dispositivos.
Atualizar um locatário existente	Adicionadas informações sobre como renomear um locatário existente.
Notas de hardware MT3620	Atualizado para incluir informações sobre como desativar o Wi-Fi em determinados cenários.
dispositivo	- Adicionadas informações para azsphere device network proxy comando. - Exemplos atualizados para os azsphere device wifi comandos.
Atualização do locatário	Adicionadas informações para o azure sphere tenant update comando.
Referência de rede Applibs	Adicionadas APIs de suporte ao cliente proxy.

Problema conhecido na versão 21.10

Qualquer aplicativo criado usando o SDK 21.10 que usa o rastreamento de alocação de memória de pilha falhará ao criar com o seguinte erro:

azsphere_target_add_image_package recebeu uma solicitação inesperada para definir DEBUG_LIB: libmalloc que não está disponível no Conjunto de APIs de destino selecionado. Selecione a versão 10 ou posterior no CMakeLists.txt.

Para corrigir o erro, você precisa fazer uma pequena alteração em um dos arquivos CMake do SDK. Você precisa ser um administrador para alterar esse arquivo.

• No Windows: C:\Arquivos de Programas (x86)\Microsoft Azure Sphere SDK\CMakeFiles\AzureSphereToolchainBase.cmake
• No Linux: /opt/azurespheresdk/CMakeFiles/AzureSphereToolchainBase.cmake

Modifique a linha 13 do AzureSphereToolchainBase.cmake para o seguinte:

set(libmalloc_10_or_later "10" "11" )

Esse problema será corrigido na próxima versão do SDK do Azure Sphere.

• Um erro é relatado quando você cria um locatário usando o azsphere tenant create comando. Isso ocorre porque o dispositivo Azure Sphere anexado não é identificado automaticamente. Para corrigir isso, você pode fornecer o dispositivo ao executar o comando. Por exemplo, azsphere tenant create --device <device-ID> --name <tenant-name>. A correção será fornecida em uma versão futura.

Corrigidos bugs e vulnerabilidades comuns na versão 21.10

A versão 21.10 inclui atualizações para mitigar as seguintes CVEs:

• cURL CVE-2021-22922
• cURL CVE-2021-22923
• cURL CVE-2021-22925
• cURL CVE-2021-22926
• cURL CVE-2021-22946
• cURL CVE-2021-22947
• CVE-2021-41374
• CVE-2021-41375
• CVE-2021-42300
• CVE-2021-41376

Sobre a versão de qualidade 21.09

A versão 21.09 inclui atualizações para o sistema operacional Azure Sphere; ele não inclui um SDK atualizado. Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud.

As atualizações para o sistema operacional Azure Sphere incluem:

• Kernel Linux atualizado para 5.10.60.
• Melhorias no tratamento de colisões para evitar travamentos.

Projetos de Galeria novos e atualizados para 21.09

• O driver RS-485 em tempo real demonstra como usar um núcleo M4F na MT3620 para implementar comunicação RS-485 confiável com comunicação inter-core para o aplicativo de alto nível no núcleo A7.

Documentação nova e revisada na versão 21.09

Artigo	Alterações
Solucionar problemas de nuvem e implantação	Adicionadas informações de solução de problemas relacionadas à reivindicação de um dispositivo.

Sobre a versão de qualidade 21.08

A versão 21.08 inclui os seguintes aprimoramentos e correções de bugs no sistema operacional Azure Sphere; ele não inclui um SDK atualizado.

• Atualizações de segurança
• Estabilidade melhorada para suporte ethernet
• Estabilidade melhorada para dispositivos I2C

Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud.

Há também novos exemplos e atualizações de documentação da Galeria do Azure Sphere.

Corrigidos bugs e vulnerabilidades comuns na versão 21.08

A versão 21.08 inclui atualizações para mitigar as seguintes vulnerabilidades e exposições comuns (CVEs):

• CVE-2021-22924
• CVE-2021-36956

Novas amostras da Galeria

Os seguintes exemplos novos ou atualizados foram adicionados à Galeria do Azure Sphere, uma coleção de scripts, utilitários e funções não mantidos:

• Littlefs SD Card mostra como adicionar sistema de arquivos e suporte de cartão SD a uma implementação do Azure Sphere.
• AzureIoTMessageWithProperties mostra como adicionar propriedades personalizadas a uma mensagem de telemetria enviada ao Hub IoT do Azure.

Documentação nova e revisada na versão 21.08

Artigo	Alterações
Dispositivo Azsphere	Tópico de referência atualizado para a aposentadoria de --cert-id e --interface-name.
Alterações importantes (desativação de recursos) na CLI do Azure Sphere	Novo tópico que descreve recursos, comandos ou parâmetros que foram ou serão retirados ou removidos da CLI do Azure Sphere.

O que há de novo na versão 21.07

A versão de recursos do Azure Sphere 21.07 inclui os seguintes componentes:

• SO do Azure Sphere atualizado

• SDK do Azure Sphere atualizado para Windows e Linux

• Extensões do Azure Sphere atualizadas para o Visual Studio e Visual Studio Code

Há também exemplos atualizados , tutoriais, itens de galeria e atualizações de documentação.

Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud. Você será solicitado a instalar o SDK atualizado no próximo uso ou poderá instalá-lo agora. Para instalar o SDK mais recente, consulte o Guia de início rápido de instalação para Windows ou Linux:

• Guia de início rápido: instalar o SDK do Azure Sphere para Windows

• Guia de início rápido: instalar o SDK do Azure Sphere para Linux

Importante

30 setembro 2021

A atualização 2 para o SDK 21.07 para Windows já está disponível. Esta atualização corrige um bug do instalador que impede a desinstalação do SDK do Azure Sphere após a atualização para o Windows 11.

28 julho 2021

A atualização 1 para o SDK 21.07 já está disponível. Se você tiver instalado a versão anterior do SDK 21.07, poderá reinstalar para obter a versão atualizada. A versão 21.07 do SDK removeu incorretamente alguns parâmetros desativados da CLI do Azure Sphere. O SDK da Atualização 1 21.07 restabelece esses parâmetros desativados para a CLI para fins de compatibilidade com versões anteriores. Para obter mais informações, consulte Alterações importantes (desativação de recursos) na CLI do Azure Sphere.

Recursos novos e alterados na versão 21.07

A versão 21.07 inclui uma melhoria na forma como a sincronização de tempo é tratada, a capacidade de controlar o uso da memória de heap da biblioteca compartilhada durante o desenvolvimento e novas maneiras de autenticar usando o Azure Ative Directory. Esta versão também inclui alguns aprimoramentos de depuração nas extensões Visual Studio e Visual Studio Code, suporte expandido do parâmetro na CLI e a capacidade de obter informações adicionais do --output dispositivo de alguns comandos na CLI e API Pública (PAPI).

Alterações na sincronização de tempo

O processo de sincronização de tempo foi alterado na versão 21.07 para fornecer um processo mais robusto quando o servidor de tempo primário falha ou não pode ser alcançado. Anteriormente, os serviços que dependem da conclusão da sincronização de tempo podiam falhar ao iniciar se as novas tentativas de sincronização de tempo impedissem a conclusão da sincronização de tempo. A alteração adiciona um mecanismo de fallback para obter um tempo preciso para que as novas tentativas de sincronização de tempo não continuem indefinidamente.

Rastreamento de alocação de memória de pilha

O recurso de rastreamento de alocação de memória de pilha fornece aos desenvolvedores uma maneira conveniente de ver as alocações de memória de bibliotecas incluídas no SDK do Azure Sphere durante o desenvolvimento de um aplicativo. O recurso adiciona um novo recurso de aplicativo, HeapMemStats, e uma nova biblioteca do SDK do Azure Sphere, libmalloc. O recurso também inclui alterações na saída do comando da CLI do Azure Sphere: aplicativo de dispositivo azsphere, show-memory-stats e a extensão do Visual Studio. Com essas alterações, os desenvolvedores podem adicionar o recurso HeapMemStats ao seu aplicativo de alto nível, implantar o aplicativo em um dispositivo habilitado para desenvolvimento e usar o Performance Profiler do Visual Studio para exibir a memória usada pelas bibliotecas SDK chamadas pelo aplicativo.

Métodos de autenticação usando o Azure Ative Directory

A API Pública do Azure Sphere (PAPI) dá suporte a vários métodos de autenticação e autorização de usuário no Azure Ative Directory (AAD).

Com o Azure Ative Directory, um token de aplicativo pode ser usado para autenticar e conceder acesso a recursos específicos do Azure a partir de um aplicativo de usuário, serviço ou ferramenta de automação usando a entidade de serviço ou o método de identidade gerenciada para autenticação.

Os seguintes métodos de autenticação agora são suportados usando o Azure Ative Directory:

• Acessar a API Pública do Azure Sphere com identidade gerenciada do AAD
• Acessar a API Pública do Azure Sphere com a entidade de serviço de aplicativo do AAD
• Acessar a API Pública do Azure Sphere com sua identidade de usuário do AAD

Detalhes adicionais do status de atualização dos comandos CLI e PAPI

A API Pública do Azure Sphere foi estendida para incluir detalhes adicionais do dispositivo sobre o sistema operacional e o status da atualização. Agora você pode ver a versão do sistema operacional do sistema instalada no dispositivo, a versão mais recente do sistema operacional disponível, quando o dispositivo foi atualizado pela última vez e quando o dispositivo verificou atualizações pela última vez. As informações adicionais podem ser úteis para gerenciar atualizações em seus dispositivos.

As seguintes páginas de referência da API do Azure Sphere explicam as alterações de resposta da API com mais detalhes:

Comando	Description
Dispositivos - Obter	Obtém detalhes de um dispositivo.
Dispositivos - Lista	Obtém todos os dispositivos que são reivindicados para o locatário especificado.
Dispositivos - Lista no Grupo	Obtém todos os dispositivos atribuídos ao grupo de dispositivos especificado.
Dispositivos - Lista no produto	Obtém todos os dispositivos que pertencem ao produto especificado.

Além disso, a CLI do Azure Sphere foi atualizada para incluir esses detalhes adicionais do azsphere device listdispositivo nos comandos , azsphere device showe azsphere device update usando o --query parâmetro ou os formatos de saída suportados. Por exemplo, azsphere device show --output json.

Recursos novos e alterados no Visual Studio ou extensões de código do Visual Studio para o Azure Sphere

As extensões Visual Studio e Visual Studio Code incluem nomes mais descritivos para destinos de depuração. A extensão do Visual Studio também inclui suporte para rastreamento de alocação de memória de pilha.

Nomes mais descritivos para destinos de depuração

A extensão do Visual Studio agora usa o nome do projeto para o nome de destino de depuração. A extensão de código do Visual Studio mostra o nome do projeto como antes, mas simplifica o texto descritivo.

Suporte para outros formatos de saída

Comandos adicionais da CLI do Azure Sphere agora dão suporte ao --output parâmetro or -o para especificar o formato da saída da CLI. Para obter mais informações, consulte Comandos suportados.

Comandos e parâmetros novos e atualizados

Atualizações dos comandos:

Comando	Description
Ativação da rede de dispositivos Azsphere	Permite uma interface de rede no dispositivo conectado.
Desativar a rede do dispositivo Azsphere	Desativa uma interface de rede no dispositivo conectado.

Atualizações dos parâmetros:

Parâmetro	Description
Show-Diagnostics do Azsphere Device Network	O --id parâmetro é alterado para --network.
Interface de atualização de rede do dispositivo Azsphere	O --interface-name parâmetro é alterado para --interface.
Excluir certificado de dispositivo Azsphere	O --cert-id parâmetro é alterado para --certificate.
Certificado de dispositivo Azsphere mostrar	O --cert-id parâmetro é alterado para --certificate.
azsphere tenant create	O --force parâmetro é alterado para --force-additional.
azsphere tenant create	O --disable-confirm-prompt parâmetro é novo, desativa o prompt de confirmação do usuário.

Nota

A versão 21.07 do SDK removeu incorretamente os parâmetros desativados mencionados aqui da CLI do Azure Sphere completamente. O SDK da Atualização 1 21.07 restabelece esses parâmetros desativados para a CLI para fins de compatibilidade com versões anteriores. Para obter mais informações, consulte Alterações importantes (desativação de recursos) na CLI do Azure Sphere.

Documentação nova e revisada na versão 21.07

Artigo	Alterações
Uso de memória em aplicativos de alto nível	Tópico atualizado para incluir a discussão sobre o rastreamento de alocação de memória de pilha.
Usando o Visual Studio Code com Secure Shell (SSH) em um host remoto	Novo tópico que descreve como criar e depurar aplicativos do Azure Sphere em um host remoto por meio do Secure Shell.
Métodos de autenticação usando o Azure Ative Directory	Novo tópico que fornece uma visão geral dos métodos de autenticação suportados.
Acessar a API Pública do Azure Sphere com identidade gerenciada do AAD	Novo tópico que fornece uma visão geral e etapas para acessar a API Pública do Azure Sphere com identidade gerenciada do AAD.
Acessar a API Pública do Azure Sphere com a entidade de serviço de aplicativo do AAD	Novo tópico que fornece uma visão geral e etapas para acessar a API Pública do Azure Sphere com a entidade de serviço do AAD.
Acessar a API Pública do Azure Sphere com sua identidade de usuário do AAD	Novo tópico que fornece uma visão geral e etapas para acessar a API Pública do Azure Sphere com identidade de usuário do AAD.
Comandos suportados	Atualizada a lista de comandos que suportam formatos de saída.
dispositivo	Atualizações para os comandos e descrições de parâmetros e exemplos.
tenant	Atualizações para as descrições de parâmetros e exemplos.
Função	Tópico atualizado, pois o valor do parâmetro não diferencia maiúsculas --role de minúsculas.

Exemplos novos e atualizados e itens da Galeria

A versão 21.07 inclui um tutorial de uso de memória atualizado, atualizações para o exemplo do Azure IoT e três projetos novos ou atualizados na Galeria do Azure Sphere.

Tutorial de uso de memória atualizado

O tutorial MemoryUsage foi atualizado para demonstrar o rastreamento de alocação de memória de pilha.

Exemplo atualizado do Azure IoT

Fizemos alguns pequenos refinamentos no exemplo de IoT do Azure, incluindo a alteração da taxa de sondagem de para cada 100ms em vez de 1s, seguindo esta prática recomendada do IoTHubDeviceClient_LL_DoWork cliente do Hub IoT. Recomendamos que você adote essa alteração em seus aplicativos existentes.

Exemplos da Galeria novos ou atualizados

Os seguintes exemplos novos ou atualizados foram adicionados à Galeria do Azure Sphere, uma coleção de scripts, utilitários e funções não mantidos:

• VS1053AudioStreaming mostra como reproduzir áudio através de uma placa de codec VS1053.

• WebHookPublicAPIServicePrincipal mostra como usar a autenticação baseada na Entidade de Serviço para a API Pública do Serviço de Segurança do Azure Sphere.

• AzureSphereTenantDeviceTwinSync foi atualizado para utilizar o novo suporte à API Pública do Azure Sphere para consultar a versão do SO para dispositivos.

Problemas conhecidos na versão 21.07

Os novos campos de status de atualização não são exibidos no formato de saída padrão da CLI

Os azsphere device listcomandos , azsphere device show, e azsphere device update CLI exporão os quatro novos campos relacionados à atualização somente ao usar JSON ou outro formato de saída suportado, os novos campos não serão exibidos ao usar o formato de tabela padrão. Você pode usar o --query argumento para especificar esses campos adicionais para saída para uma tabela, mas a ID do dispositivo pode ser truncada se a tabela for muito grande. Recomendamos que você reduza o número de colunas na tabela para que a ID do dispositivo não fique truncada. Por exemplo, azsphere device show --query '{DeviceId:deviceId, LastAvailableOSVersion:lastAvailableOSVersion, LastInstalledOSVersion:lastInstalledOSVersion, LastOSUpdateUTC:lastOSUpdateUTC, LastUpdateRequestUTC:lastUpdateRequestUTC}'.

Corrigidos bugs e vulnerabilidades comuns na versão 21.07

A versão 21.07 inclui atualizações para mitigar as seguintes vulnerabilidades e exposições comuns (CVEs):

• CVE-2021-26428

• CVE-2021-26429

• CVE-2021-26430

Sobre a versão de qualidade 21.06

A versão 21.06 inclui correções de bugs no sistema operacional Azure Sphere; ele não inclui um SDK atualizado. Se os seus dispositivos estiverem ligados à Internet, receberão o SO atualizado a partir da cloud.

Documentação nova e revisada na versão 21.06

Artigo	Alterações
Gerir inquilinos	Conteúdo simplificado sobre como criar, gerenciar ou localizar locatários do Azure Sphere
Solucionar problemas de nuvem e implantação	Novas notas na seção Solucionar problemas de atualizações do sistema operacional e na seção Solucionar problemas de atualizações de implantação
Iniciar sessão com a CLI do Azure Sphere	Novo tópico que descreve o login padrão com a CLI e como fazer login usando um navegador.

Novos exemplos da Galeria na versão 21.06

Três novos exemplos foram adicionados à Galeria do Azure Sphere, uma coleção de scripts, utilitários e funções não mantidos:

• WiFiConfigurationviaNfc ilustra como configurar credenciais WiFi de um telefone via NFC (Near-Field Communication).

• TranslatorCognitiveServices mostra como usar o Azure Sphere para se comunicar com um Serviço Cognitivo do Azure, neste caso para traduzir texto.

• Grove_16x2_RGB_LCD fornece o código do driver para um monitor LCD RGB.