Nyheter i Azure Sphere
Viktigt!
Det här är dokumentationen om Azure Sphere (Legacy). Azure Sphere (Legacy) upphör den 27 september 2027 och användarna måste migrera till Azure Sphere (integrerad) vid den här tiden. Använd versionsväljaren ovanför TOC för att visa dokumentationen om Azure Sphere (integrerad).
Azure Sphere uppdateras kontinuerligt. Funktionsutgåvor stöder nya funktioner och kan innehålla uppdateringar av Azure Sphere OS, SDK och/eller Tjänster. Kvalitetsutgåvor inkluderar endast felkorrigeringar och säkerhetsuppdateringar, och kan ofta bara innehålla Azure Sphere OS. Versionsnummer är vanligtvis i year.month-format , så 22.04 identifierar versionen i april 2022.
Meddelas om uppdateringar
När nya versioner inträffar kommer vi att publicera meddelanden på Azure Updates och IoT Tech Community-bloggen .
Ta emot uppdateringar
När operativsystemet uppdateras hämtas det automatiskt från molnet till Azure Sphere-enheter som är anslutna till Internet.
Använd följande kommando för att verifiera den installerade operativsystemversionen på en ansluten enhet:
azsphere device show-os-version
SDK-uppdateringar och Visual Studio/Visual Studio Code-tillägg måste installeras manuellt – se de här anvisningarna för Windows eller Linux. Om du vill kontrollera vilken version av SDK som är installerad på datorn använder du följande kommando:
azsphere show-version
Os-versioner för detaljhandelsutvärdering
Retail Evaluation-programmet möjliggör bakåtkompatibilitetstestning för program två veckor innan operativsystemet uppdateras för alla enheter. Vi rekommenderar starkt att alla produktionsanvändare använder den här testanläggningen. Se Konfigurera enheter för OS-utvärdering för att ta reda på hur du deltar.
Rapportera sårbarheter
Azure Sphere uppmuntrar säkerhetsforskare att söka efter eventuella sårbarheter och rapportera dem på ett ansvarsfullt sätt baserat på Microsofts princip för samordnad sårbarhetsutlämnande till MSRC-portalen. Rapporter om sårbarheter kan innehålla belöningar via Microsoft Azure Bounty-programmet. Se Azure Sphere-CVE:er för allmän information om Azure Sphere-CVE:er. Du hittar information om CVE:er som redan har publicerats i säkerhetsuppdateringsguiden för MSRC och i den versionsspecifika informationen i den här artikeln.
September 2024
den 27 september 2024
Meddelande om tillbakadragning av Azure Sphere-tjänstgränssnitt (äldre) i september 2027
Azure Sphere-gränssnitten (Legacy), inklusive Azure Sphere (Legacy) API (även kallat PAPI) och Azure Sphere (Legacy) CLI (även kallat azsphere
), kommer att dras tillbaka den 27 september 2027. Från och med nu till och med den 27 september 2027 stöds Azure Sphere (Legacy) fullt ut och du kan fortsätta att använda API:et för Azure Sphere (äldre) och CLI-gränssnitten. Senast den 27 september 2027 måste du dock migrera till Azure Sphere (integrerad) och börja hantera dina Azure Sphere-enheter i Azure Portal och Azure CLI, och du måste uppdatera alla anpassade automatiseringar och program för att använda Azure Sphere-API:et (integrerat).
Azure Sphere (integrerad) stöder alla Azure Sphere-funktioner (äldre) och gör att du kan använda andra kraftfulla Azure-tjänster när du hanterar dina Azure Sphere-enheter, inklusive Microsoft Entra ID, rollbaserad åtkomstkontroll i Azure och Azure Monitor.
Mer information om pensionering och hur du migrerar till Azure Sphere (integrerad) finns i det här blogginlägget.
Augusti 2024
den 19 augusti 2024
Tjänster (äldre): API för inbjudningsanvändare inaktuellt
Av säkerhetsskäl har vi tagit bort API:et "invite-user" från det offentliga API:et Azure Sphere (Legacy). Det här API:et användes av CLI-kommandot azsphere register-user
, vilket nu resulterar i ett felmeddelande. Alternativa metoder bör användas för att registrera Azure Sphere-användare (äldre).
Tjänster (integrerade): Ny funktion för att hitta en enhet
Nu kan du söka efter ett enhets-ID i alla kataloger som du har åtkomst till. Om du har läsare eller större Azure RBAC-behörigheter för enheten visar sökresultatet en länk till enheten samt till enhetens överordnade enhetsgrupp, produkt och katalog. Om du inte har läsbehörighet eller högre åtkomstbehörighet returnerar sökningen ett fel som inte hittades på enheten.
Nytt galleriprojekt: Azure Event Grid MQTT-C
Det finns ett nytt Azure Sphere-galleriprojekt som visar hur du ansluter en Azure Sphere-enhet till ett Azure Event Grid-namnområde via MQTT med MQTT-C-klientbiblioteket . Det här projektet använder Azure Spheres wolfSSL TLS-bibliotek och daa-certifikatmekanismen (Device Authentication and Attestation) för att skapa anslutningar på ett säkert, autentiserat och intygat sätt.
Juli 2024
den 31 juli 2024
Azure Sphere Security Service börjar använda ett nytt certifikat för avbildningssignering för signering av alla avbildningars produktionssignerade program och funktioner. Eftersom produktionsenheter tog emot det nya certifikatet i det betrodda nyckelarkivet den 10 juli (se nedan) påverkas inte produktionsenheterna. I vissa tillverknings- eller utvecklingsscenarier finns det en mindre inverkan.
den 10 juli 2024
Den här versionen innehåller en uppdatering av det betrodda nyckelarkivet för Azure Sphere-enheter, vilket resulterar i att alla enheter (oavsett om de finns i Retail- eller Retail Eval-flödet) installerar den här uppdateringen och startar om. Mer information finns i blogginlägget Azure Sphere – Uppdatering av avbildningssigneringscertifikat.
Nyheter i 24.06-versionen
den 25 juni 2024
Azure Sphere 24.06-versionen innehåller en felkorrigering endast i Azure Sphere OS. den innehåller inte något uppdaterat SDK. Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet.
Buggar och vanliga sårbarheter har åtgärdats i 24.06-versionen
24.06-versionen innehåller uppdateringar för att minimera vanliga sårbarheter och exponeringar (CVE):
- CVE-2023-52160
Nyheter i 24.03-versionen
den 26 mars 2024
Azure Sphere 24.03-versionen är nu tillgänglig och innehåller följande komponenter:
- Allmän tillgänglighet för Azure Sphere (integrerad)
- Uppdaterade Azure Sphere-operativsystemet
- Uppdaterade Azure Sphere SDK för Windows och Linux
- Uppdaterade Azure Sphere-tillägg för Visual Studio och Visual Studio Code
- Uppdaterade exempel
Höjdpunkterna i den här versionen omfattar allmän tillgänglighet för Azure Sphere (integrerad), stöd för anpassade certifikat för att ansluta till Azure IoT, en uppdaterad version av cURL för Azure Sphere OS, säkerhetskorrigeringar, SDK-stöd för förhandsversionen av Ubuntu 24.04 och förenklingar av CMake-verktygskedjan.
Allmän tillgänglighet för Azure Sphere (integrerad)
Vi är glada över att kunna meddela att Azure Sphere (Integrated), ett nytt hanteringsgränssnitt för Azure Sphere-enheter, är allmänt tillgängligt för produktionsanvändning från och med idag. Azure Sphere (integrerad) är nu det rekommenderade gränssnittet för Azure Sphere-tjänster och är inte längre märkt som förhandsversion i Azure Portal.
Med Azure Sphere (integrerad) kan du hantera dina Azure Sphere-enheter direkt i Azure Portal och Azure Sphere-tillägget för Azure CLI. Azure Sphere (integrerat) baseras på det nya REST-API:et för Azure Sphere (integrerat) som bygger på Azure Resource Manager-plattformen och innehåller inbyggt stöd för andra kraftfulla Azure-tjänster, inklusive Azure RBAC och Azure Monitor.
Uppdateringar av Azure Sphere (integrerad) sedan offentlig förhandsversion:
En ny azure RBAC-fördefinierad roll är tillgänglig: Azure Sphere-ägare. Rollen Azure Sphere-ägare ger fullständig behörighet för Azure Sphere-resurser, men till skillnad från rollen Azure Sphere-deltagare som också ger fullständig behörighet innehåller rollen Azure Sphere-ägare även möjligheten att konfigurera Azure RBAC-åtkomst för Azure Sphere-resurser.
För enklare navigering när du visar en enskild produkt, enhetsgrupp eller enhet får du nu åtkomst till resursspecifik översiktsinformation, åtkomstkontroll, uppgifter och egenskapsinställningar på den uppdaterade vänstra menyn.
Du kan använda Azure Monitor för att få aviseringar när du behöver vidta åtgärder på grund av den tvååriga certifikatrullen för ditt katalogcertifikatutfärdarcertifikat. Mer information finns i Övervaka Azure Sphere-flottan och enhetens hälsa..
Om du inte redan har börjat använda Azure Sphere (integrerad) rekommenderar vi att du gör det nu.
Med ett engångsintegreringssteg kan du hantera dina befintliga Azure Sphere-klientorganisationer (äldre) i Azure Sphere (integrerad). När en klientorganisation har integrerats kan du utföra hanteringsuppgifter med antingen Azure Sphere (integrerad) eller Azure Sphere (äldre). Du kan mellanlagra implementeringen av Azure Sphere (integrerad) genom att börja med test- och utvecklingsaktiviteter i Azure Sphere (integrerad) samtidigt som du fortsätter att använda Azure Sphere (Legacy) för arbetsflöden för produktionshantering tills du är redo att migrera helt. Även om Azure Sphere-gränssnittet (äldre) fortfarande stöds fullt ut rekommenderar vi migrering för att dra full nytta av Azure Sphere-funktioner (integrerade) och framtida förbättringar.
Mer information finns i blogginlägget azure sphere (integrerad) är allmänt tillgängligt
Nya och ändrade funktioner i 24.03 OS
24.03-versionen av Azure Sphere OS innehåller följande ändringar:
Åtgärdade buggar och vanliga sårbarheter i 24.03 OS-versionen
CURL-versionen som ingår i Azure Sphere OS uppdaterades från version 7.69.1 till 7.87.0. 24.03 OS-versionen innehåller uppdateringar för att minimera dessa vanliga sårbarheter och exponeringar (CVE):
Vanliga sårbarheter och exponeringar (CVE) | |
---|---|
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 |
Stöd för att använda anpassade certifikat för att ansluta till Azure IoT Services
Azure Sphere-enheter kan nu använda anpassade certifikatkedjor för att ansluta till Azure IoT Services. Användning av icke-Azure Sphere-certifikatkedjor är användbart med program som har ytterligare organisatoriska krav kring certifikatanvändning. Vägledningen för att ansluta till Azure IoT har uppdaterats för att beskriva det här användningsfallet ytterligare. Alla kunder som använder beta-API-versionen av den här funktionen som släpps med 23.05-operativsystemet bör migrera till de nya API:erna genom att ladda ned den senaste SDK:n och kompilera om sitt program, och notera att funktionssignaturer har ändrats för att främja produktion av den här funktionen.
Nya och ändrade funktioner i tilläggen 24.03 SDK och Visual Studio/Visual Studio Code
24.03-versionen av Tilläggen Azure Sphere SDK och Visual Studio/Visual Studio Code innehåller följande ändringar:
Slut på support för Ubuntu 18.04 LTS
Ubuntu 18.04 ligger nu utanför Canonicals långsiktiga standardstöd. Därför var 23.05 SDK den sista Azure Sphere SDK som stödde den här OS-versionen. 24.03 och framtida SDK:er stöder inte Ubuntu 18.04.
SDK-stöd har lagts till för förhandsversionen av Ubuntu 24.04
24.03 SDK lägger till stöd för förhandsversionen av Ubuntu 24.04 och lägger till det befintliga Ubuntu 20.04- och 22.04-stödet. Detta är för utveckling och testning av Ubuntu 24.04 innan det släpps till allmänheten.
Ändringar i CMake-verktygskedjan
I SDK version 23.05 och tidigare måste mål-API-uppsättningen (sysroot) som används av Azure Sphere-program anges i både CMakePresets.json- och CMakeLists.txt-filerna, vilket var duplicerande och ibland krävde manuell uppdatering efter varje SDK-version.
För att förenkla den här processen och effektivisera framtida uppdateringar har posterna azsphere_configure_tools
och azsphere_configure_api
CMakeLists.txt gjorts onödiga och inaktuella. Byggprocessen använder nu bara värdet AZURE_SPHERE_TARGET_API_SET i CMakePresets.json som sanningskälla för den riktade API-versionen.
Som standard anges värdet för parametern AZURE_SPHERE_TARGET_API_SET
till "latest-lts" i CMakePresets.json vilket innebär att projektet automatiskt riktar sig mot den senaste API-versionen när SDK:n uppdateras. Om du vill fästa API-versionen på en viss version (t.ex. när du skapar appar för tillverkning av produkter med en specifik OS-version) bör du ange parametern till den AZURE_SPHERE_TARGET_API_SET
versionen.
Befintliga projekt fortsätter att kompileras med den nya SDK:n, även om ett varningsmeddelande informerar användaren om att de kan ta bort de inaktuella CMakeLists.json posterna. Nya projekt som skapats baserat på GitHub-exemplen kräver tilläggen 24.03 eller senare SDK och VS/VS Code.
Uppdaterade exempel för 24.03
24.03-versionen innehåller följande ändringar i exemplen:
Uppdateringar av Azure Sphere HTTPS cURL Multi Sample
Det tidigare Azure Sphere HTTPS cURL Multi-exemplet följde för närvarande inte längre rekommenderade cURL-metodtips, vilket kan visas mer detaljerat här. Även om vi har bevarat kompatibiliteten med den gamla metoden har vi uppdaterat vårt exempel och rekommenderar att du införlivar den senaste metoden i alla programuppdateringar eller nya utvecklingsarbete som du kanske utför.
Uppdateringar av exempel för användning av azure-sphere-tillägget för Azure CLI
Vi rekommenderar att du använder det nu allmänt tillgängliga Azure Sphere-gränssnittet (integrerat) för framtida utvecklingsarbete. Instruktionerna i README-exempelfilerna har uppdaterats för att använda kommandon i azure-sphere-tillägget för Azure CLI.
Offentlig förhandsversion av Azure Sphere (integrerad)
den 8 augusti 2023
Vi är glada över att kunna presentera den offentliga förhandsversionen av Azure Sphere (integrerad), ett nytt hanteringsgränssnitt för Azure Sphere-tjänster som är inbyggt integrerat med Azure via Azure Resource Manager.
Den här offentliga förhandsversionen av Azure Sphere (integrerad) består av:
- Ett nytt REST-API för Azure Sphere Security Services, integrerat med Azure Resource Manager
- Azure Portal och Azure CLI-integrering
- Azure Monitor-integrering
- Azure RBAC-integrering
Läs den här artikeln om du vill veta mer om säkerhet, observerbarhet, användbarhet, förenklad åtkomst till support och andra fördelar med dessa integreringar.
Under den offentliga förhandsversionen rekommenderar vi att du använder Azure Sphere (integrerad) för utveckling och testning. Som bästa praxis bör produktionsanvändningsfall (t.ex. under tillverknings- eller driftarbetsflöden) inte använda en förhandsversionsprodukt. För produktionsanvändningsfall rekommenderar vi därför att du fortsätter att använda det befintliga Azure Sphere Security Service-gränssnittet, som nu kallas Azure Sphere (Legacy), som fortfarande stöds fullt ut och är allmänt tillgängligt.
Mer information om Azure Sphere (integrerad) och Azure Sphere (äldre), inklusive hur du kommer igång, finns i det här dokumentet.
Det finns ingen os- eller SDK-uppdatering som en del av den här versionen. Kommandoradsverktyg för Azure Sphere (integrerad) tillhandahålls av ett nytt Azure CLI-tillägg som kräver att 23.05 Azure Sphere SDK installeras när du använder kommandon som interagerar med en ansluten enhet.
Nyheter i 23.05-versionen
den 26 oktober 2023
Versionen av Azure Sphere 23.05 Update 1 innehåller följande uppdateringar av Azure Sphere-tilläggen för Visual Studio och Visual Studio Code:
- En ny genväg till kataloghantering i Azure Sphere (integrerad)
- Felkorrigeringar
Den innehåller inte ett uppdaterat operativsystem eller SDK.
den 20 juni 2023
Azure Sphere 23.05-funktionsversionen innehåller följande komponenter:
- Uppdaterade Azure Sphere-operativsystemet
- Uppdaterade Azure Sphere SDK för Windows och Linux
- Uppdateringar av Azure Sphere-tilläggen för Visual Studio och Visual Studio Code
Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet. Du uppmanas att installera det uppdaterade SDK:t vid nästa användning, eller så kan du installera det nu. Information om hur du installerar den senaste SDK:t finns i snabbstarten för installation för Windows eller Linux.
Höjdpunkterna i den här versionen inkluderar nya kryptografiska bibliotek, standardåterställning av NTP, nya beta-API:er i Windows för Azure IoT-anslutningar med ditt eget certifikat, snabbare och förbättrad fabrikstestning, stöd för flera enheter för Linux, en ny lagringsplats för verktyg och examen av självhjälpsgalleriprojektet Parse Device Logs till fullständigt stödd status.
Nya och ändrade funktioner i 23.05 OS
23.05-versionen av Azure Sphere OS innehåller följande ändringar:
Kryptografiska bibliotek för Microsoft-hanterade registreringar
Som en del av 23.05-versionen har Azure Sphere inbyggda kryptografiska bibliotek i operativsystemet. Genom vårt samarbete med wolfSSL kan du nu anropa select wolfCrypt-API:er i ditt program som gör att du kan utföra ECC- eller xChaCha-kryptering och dekryptering, certifikatgenerering och hantering, och mer utan att drabbas av ram- eller blixtpåverkan för att skapa dessa i ditt program. I stället kommer du att betjänas av Azure Sphere OS:s inbyggda bibliotek, som kan korrigeras och hållas uppdaterade av Microsoft. Den här nya funktionen är en del av vårt ABI-kompatibilitetslöfte för produktens livslängd, och du kan se wolfSSL:s långsiktiga ABI-löften på deras webbplats, där de också ger exempel på hur du använder dessa wolfCrypt-API:er, till exempel ECC.
Utökad NTP-robusthet
Om Microsoft NTP-tidservrar drabbas av ett avbrott försöker Azure Sphere-enheter nu återställa till en NIST NTP-server efter att ha provat flera regionala Microsoft-slutpunkter, såvida inte en anpassad NTP används med anpassade återställningskonfigurationer. Detta utökar anslutningens robusthet för Azure Sphere-enheter genom att ge dem fler alternativ att synkronisera för kommunikation till molnet och andra servrar. Administratörer av Azure Sphere-enheter bakom brandväggar kan läsa den uppdaterade slutpunktsinformationen här.
Certifikatsupport från tredje part för Azure IoT (Beta) i Windows
Azure Spheres operativsystem innehåller Azure IoT C SDK. För det här operativsystemet, i Windows, förhandsgranskar vi API:er som en del av vårt Beta-program för att använda certifikat som tillhandahålls av programmet för att ansluta till Azure IoT. Dessa certifikat behöver inte vara rotade i Azure Sphere-enheten. På så sätt kan du enkelt ansluta till Azure IoT-resurser med certifikat som rotar till befintliga system. Dessa Beta-API:er är optimerade för testning för närvarande, men uppdateras för att stödja produktionsåtgärder i stor skala. Om du har feedback om dessa API:er, inklusive krav för produktionsmiljön, kontaktar du oss på AZSPPGSUP@microsoft.com. De nya API:erna är AzureIoT_OverrideAzureSphereAuthCert och AzureIoT_OverrideAzureSphereAuthPrivateKey.
Uppdatera RF Tools OS-stöd och förbättra verktygens prestanda
RF-verktyg har uppdaterats så att de omfattar:
- Stöd för både Windows- och Linux x86-plattformar, inklusive flera enheter.
- Prestandaförbättringar för att läsa och skriva bufferbin- och eFuse-data via nya anrop till batchoperativsystemet.
- Ett Python-bibliotek som hjälper Python-användare att utveckla egna skript och program.
Nya och ändrade funktioner i 23.05 SDK
23.05-versionen av Azure Sphere SDK innehåller följande ändringar:
Stöd för flera Linux-enheter
23.05 SDK lägger till stöd för flera samtidigt anslutna Azure Sphere-enheter i Linux, vilket gör att den här funktionen överensstämmer med befintlig support i Windows. Detta har särskild relevans för Linux-baserade tillverkningsscenarier.
Dessutom finns det inte längre något behov av att anropa skriptet azsphere_connect.sh
när du ansluter en ny enhet – anslutningen sker nu automatiskt i paritet med befintligt Windows-stöd. Se den uppdaterade dokumentationen om Linux SDK-installation.
Lägga till SDK-stöd för Ubuntu 22.04 LTS
23.05 SDK lägger till stöd för Ubuntu 22.04 och lägger till det befintliga Ubuntu 18.04- och 20.04-stödet. Linux SDK-installationsprogrammet kan fastställa den LTS-version av Ubuntu som du kör och ladda ned eller installera lämplig SDK.
Meddelande om att support upphör för Ubuntu 18.04 LTS
Ubuntu 18.04 ligger nu utanför Canonicals långsiktiga standardstöd. Därför är 23.05 SDK den sista Azure Sphere SDK som stöder den här OS-versionen. Framtida SDK:er stöder inte Ubuntu 18.04.
Nya och ändrade funktioner i 23.05 för Visual Studio- eller Visual Studio Code-tillägg för Azure Sphere
23.05-versionen av Tilläggen Azure Sphere Visual Studio och Visual Studio Code innehåller följande ändringar:
- Förbättrad felsökningsupplevelse vid felsökning av realtidskompatibla program och felsökning av flera program.
- Nya projektmallar har uppdaterats.
GitHub-lagringsplats för nya verktyg
En ny GitHub-lagringsplats, Azure Sphere Tools, har introducerats. Den här lagringsplatsen innehåller ytterligare verktyg som stöds officiellt för tillverkning, support och diagnostik. Tillverkningsmappen har flyttats från lagringsplatsen Exempel , vilket placerar tillverkningsverktyg på en enda plats som är lätt att hitta, samtidigt som du minskar fotavtrycket för lagringsplatsen för exempel.
Nya och uppdaterade galleriprojekt för 23.05
23.05-versionen av Azure Sphere-exempel, kodfragment och galleriprojekt innehåller följande ändringar:
23.05-versionen av Azure Sphere innehåller projektet Parsa enhetsloggar som har tagit examen från galleriet och som nu är ett officiellt stödt projekt som finns i den nya Azure Sphere Tools-lagringsplatsen .
Nyheter i 23.02-versionen
den 21 februari 2023
Azure Sphere 23.02-versionen innehåller endast felkorrigeringar i Azure Sphere OS. den innehåller inte något uppdaterat SDK. Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet.
Åtgärdade buggar och vanliga sårbarheter i version 23.02
Version 23.02 innehåller uppdateringar för att minimera följande standardiserade namn på sårbarheter och exponeringar (CVE:er):
- CVE-2022-37434 zlib
- CVE-2018-25032 zlib
Nya och uppdaterade galleriprojekt för 23.02
Version 23.02 av exempel, kodfragment och galleriprojekt i Azure Sphere innehåller följande ändringar:
Unicast DNS-tjänstidentifieringsgalleriprojekt
Unicast DNS-tjänstens identifieringsgalleriprojekt visar hur du utför DNS-tjänstidentifiering genom att skicka DNS-SD-frågor till en konfigurerad DNS-server. Till skillnad från identifiering av multicast-tjänster kan den här mekanismen användas för att dynamiskt öppna åtkomsten till inte bara lokala slutpunkter, utan även fjärrslutpunkter i enhetens brandvägg vid körning.
Nyheter i 22.11-versionen
den 1 december 2022
Azure Sphere 22.11-funktionsversionen innehåller följande komponenter:
- Uppdatera till de avbildningssigneringsnycklar som används av Azure Sphere Security Service
- Uppdaterade Azure Sphere-operativsystemet
- Uppdaterade Azure Sphere SDK för Windows och Linux
- Azure Sphere-tillägg för Visual Studio och Visual Studio Code har uppdaterats
Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet. Du uppmanas att installera det uppdaterade SDK:t vid nästa användning, eller så kan du installera det nu. Information om hur du installerar den senaste SDK:t finns i snabbstarten för installation för Windows eller Linux:
- Snabbstart: Installera Azure Sphere SDK för Windows
- Snabbstart: Installera Azure Sphere SDK för Linux
Bland höjdpunkterna i den här versionen finns en ny Malloc-version, en uppgraderad Azure IoT C SDK, en DHCP-timeoutreducering och den offentliga förhandsversionen av Azure Sphere-stödet för den europeiska datagränsen.
Nya avbildningssigneringsnycklar som används av Azure Sphere Security Service
Azure Sphere Security Service använder nu nya avbildningssigneringsnycklar. Dessa nycklar används av vår tjänst för att signera eventuella nyligen uppladdade programbilder och nya funktionsfiler (till exempel när du aktiverar utvecklingsläge på enheter). 22.11-operativsystemet signerades med de gamla nycklarna, men framtida operativsystem signeras med hjälp av de nya nycklarna. Alla befintliga nycklar fortsätter att vara betrodda av Azure Sphere-enheter.
För att Azure Sphere-enheter ska kunna acceptera signaturer med hjälp av de nya nycklarna distribuerades en TKS-uppdatering (Trusted KeyStore) den 14 november 2022. Ingen användaråtgärd krävs för produktionsenheter. För vissa tillverknings-, utvecklings- eller fältservicescenarier där Azure Sphere OS inte är uppdaterat kan du behöva vidta extra åtgärder för att säkerställa att nyligen signerade avbildningar är betrodda av enheten – se det här blogginlägget för fullständig information.
Nya och ändrade funktioner i 22.11-operativsystemet
22.11-versionen av Azure Sphere OS innehåller följande ändringar:
Ny Malloc-version
Azure Sphere OS fortsätter att stödja den befintliga malloc-modellen utan ändringar som krävs för ett program och är binär bakåtkompatibel för alla tidigare byggda program. Ett nytt alternativ för programmanifest gör det dock möjligt för utvecklare att välja MallocVersion=2, som introducerar MALLOC-modellen MUSL v1.2.1+ mallocng. Den här malloc-versionen är mer effektiv och säkrare och förbättrar minnesfriing avsevärt. Exempel och självstudier har uppdaterats för att använda den här versionen som standard och vi rekommenderar att du lägger till den i alla nya program som utvecklas. I vissa programscenarier förväntas den högsta minnesanvändningen vara lägre när du använder den här nya malloc-versionen.
Uppgraderad Azure IoT C SDK
Vi har uppdaterat Azure IoT C SDK till den senaste versionen. Denna SDK innehåller felkorrigeringar och stabilitetsförbättringar och är binärkompatibel med tidigare versioner. Alla befintliga appar kommer att dra nytta av förbättringar bakom kulisserna som administreras av Azure Sphere OS.
Minskning av DHCP-timeout
Tidsgränsen för DHCP-återförsök har minskats från 10-talet till 1:e. Den här minskningen förbättrar batteriförbrukningen när en enhet väntar på ett DHCP-lån, vilket förväntas ske med vissa nätverkskonfigurationer och trafikscenarier.
Nya och ändrade funktioner i SDK:n 22.11
22.11-versionen av Azure Sphere SDK innehåller följande ändringar:
Stöd för andra CLI-kommandoutdataformat
Som en del av det pågående arbetet med att introducera JSON-utdata till CLI-kommandon, vilket gör det enklare att skripta och automatisera mot, har azsphere image add och azsphere device show-os-version uppdaterats för att stödja JSON-utdata. Se Kommandon som stöds för listan över kommandon som för närvarande stöder flera utdataformat.
Nya och uppdaterade exempel, kodfragment och galleriprojekt
22.11-versionen av Azure Sphere-exempel, kodfragment och galleriprojekt innehåller följande ändringar:
Loggning till Azure-exempelprojekt
Projektet Loggning till Azure-exempel visar hur du använder IoT Hub tillsammans med Azure Data Explorer för att samla in loggar på programnivå på ett sätt som är både skalbart och frågebart.
PWM-ljudgalleriprojekt
PWM Audio Gallery-projektet visar hur du använder PWM-kringutrustning för MT3620-maskinvara för att generera tonljud för användning med en summer eller annan ljudgenererande enhet, ett vanligt produktanvändningsfall.
Offentlig förhandsversion: Azure Sphere-stöd för europeisk datagräns
I enlighet med Microsofts mål att bearbeta och lagra EU-data exklusivt inom EU (se Europeiska datagränser för Microsoft Cloud) kan kunder inom EU som använder Azure Sphere Security Service nu välja att bearbeta och lagra avbildningsfiler och kraschdumpfiler inom EU. Den nya inställningen Regional datagräns är en valfri parameter som kan användas med kommandona azsphere image och azsphere device-group.
Mer information finns i:
- Kommando för enhetsgrupper i Azure Sphere CLI | Microsoft Learn
- Kommando för avbildningar i Azure Sphere CLI | Microsoft Learn
Vi bjuder in EU-baserade kunder att prova den här nya funktionen och ge feedback via e-post till AZSPPGSUP@microsoft.com.
Ny och reviderad dokumentation i 22.11-versionen
Artikel | Ändringar |
---|---|
Utdataformat som stöds för Azure Sphere CLI | Uppdaterad lista över kommandon som stöder flera utdataformat. |
Om 22.10-kvalitetsversionen
den 25 oktober 2022
Versionen 22.10 innehåller endast felkorrigeringar i Azure Sphere OS. den innehåller inte något uppdaterat SDK. Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet.
Åtgärdade buggar och vanliga sårbarheter i version 22.10
Den här versionen innehåller allmänna förbättringar som kan resultera i en förväntad dubbel omstart för vissa enheter.
Version 22.10 innehåller inte uppdateringar för att minimera eventuella vanliga sårbarheter och exponeringar (CVE).
Nyheter i 22.09-versionen
den 26 september 2022
Funktionsversionen av Azure Sphere 22.09 innehåller följande komponenter:
- Uppdaterade Azure Sphere-operativsystemet
- Uppdaterade Azure Sphere SDK för Windows och Linux
- Azure Sphere-tillägg för Visual Studio och Visual Studio Code har uppdaterats
Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet. Du uppmanas att installera det uppdaterade SDK:t vid nästa användning, eller så kan du installera det nu. Information om hur du installerar den senaste SDK:t finns i snabbstarten för installation för Windows eller Linux:
- Snabbstart: Installera Azure Sphere SDK för Windows
- Snabbstart: Installera Azure Sphere SDK för Linux
Höjdpunkterna i den här versionen inkluderar en minskning av den kalla starttiden för att ansluta till molnet för operativsystemet, vilket resulterar i lägre energianvändning. vägledning för bästa praxis för fjärrfelsökning och optimerade tillverkningsskript.
Nya och ändrade funktioner i 22.09-operativsystemet
22.09-versionen av Azure Sphere OS innehåller följande ändringar:
Utökat Ethernet NIC-stöd
Azure Sphere stöder nu WIZnet W5500 10/100 Ethernet-nätverksgränssnittskort för internetuppkopplade anslutningar. Den här maskinvarudelen kan öka prestanda och marknadstillgänglighet för kabelanslutna Ethernet-program.
Säkerhetsskydd för återställningsattacker
Som en del av vårt skydd på djupet mot återställningsattacker kommer återställning och återställning till tidigare versioner av Azure Sphere OS före 22.07 inte att vara tillgängliga på enheter som redan har uppdaterats till 22.09-versionen.
När en enhet har uppdaterats till 22.09-versionen kan den inte längre köra en version av Azure Sphere OS tidigare än 22.07. Det innebär att du inte kan återställa en enhet till en tidigare version efter att den har fått uppdateringen 22.09. 22.07-versionen blir den tidigaste versionen som kan installeras på enheten.
Nya och ändrade funktioner i 22.09 SDK
22.09-versionen av Azure Sphere SDK innehåller följande ändringar:
Stöd för andra CLI-kommandoutdataformat
Ytterligare CLI-kommandon stöder nu JSON-utdata. Det här utdataformatet gör det enklare att skripta och automatisera mot CLI-utdata. Se Kommandon som stöds för listan över kommandon som för närvarande stöder flera utdataformat.
Nya och ändrade funktioner i 22.09 för Visual Studio- eller Visual Studio Code-tillägg för Azure Sphere
22.09-versionen av Azure Sphere Visual Studio- och Visual Studio Code-tilläggen innehåller följande ändringar:
Effektiviserad installation för realtidskompatibla program
22.09 Azure Sphere-versionen ger en enklare installationsprocess med hjälp av vcpkg-artefakter för att starta din utvecklingsmiljö för att skapa realtidskompatibla program. Mer information finns i Självstudie: Skapa ett realtidskompatibelt program.
Nya och uppdaterade exempel, kodfragment och galleriprojekt
22.09-versionen av Azure Sphere innehåller följande ändringar i exemplen, kodfragmenten och galleriprojekten:
Självhjälpsfelsökning under apputveckling
Med parsning av get-support-data-logg kan du självhjälp för felsökning under apputveckling. När du är lokalt ansluten till en enhet använder du azsphere get-support-data för att ladda ned ett paket med loggar, fel och status från en Azure Sphere-enhet. Använd loggparsningsgalleriprojektet för att konvertera binära loggdata till mänskligt läsbart format för att visa systemloggade händelser från Azure Sphere-operativsystemet.
Version av tillverkningsverktyg v1.0.0
Vi har publicerat uppdaterade tillverkningsverktyg. De här verktygen gör det möjligt för kunder att integrera REST API-kommandon för enheter, som normalt används via CLI, direkt i sina tillverkningsprogram i form av Python PyPy- och C# NuGet-paket. En YAML OpenAPI-definition tillhandahålls också, vilket gör det möjligt för kunder att generera sina egna klientbibliotek på ett språk som de väljer via verktyg som AutoRest.
Eftersom dessa verktyg kommunicerar direkt med REST-API:et för anslutna Azure Sphere-enheter kan många kommandon se upp till 5 gånger snabbare än skript mot azsphere CLI.
Azure Sphere Squirrel Gallery-projekt
Projektet Azure Sphere Squirrel Gallery visar hur du kör ett skriptspråk på högre nivå ovanpå MT3620-chipet.
Ny och reviderad dokumentation i 22.09-versionen
Artikel | Ändringar |
---|---|
Ethernet-kort och utvecklingskort som stöds | Ämne uppdaterat till dokumentstöd för WIZnet W5500-baserade Ethernet-styrenheter. |
Självstudie: Skapa ett realtidskompatibelt program | Har uppdaterats för att dokumentera ett alternativ för vcpkg-artefakter för att automatiskt installera och konfigurera GNU Arm Embedded Toolchain. |
Metodtips för fjärrfelsökning | Nytt ämne som innehåller en lista med frågor och flödesscheman som hjälper dig att sortera enhetsproblem. |
Utdataformat som stöds för Azure Sphere CLI | Uppdaterad lista över kommandon som stöder flera utdataformat. |
Kända problem i 22.09-versionen
När du använder W5500 för att ansluta till ett kabelanslutet nätverk, om nätverkskabeln är urkopplad, kan gränssnittet fortfarande rapporteras vara "upp" av CLI och via interna API:er. Detta kommer att åtgärdas i en framtida version av operativsystemet.
Åtgärdade buggar och vanliga sårbarheter i 22.09-versionen
22.09-versionen innehåller följande uppdateringar för att undvika följande vanliga sårbarheter och exponeringar (CVE):
- wolfSSL CVE-2022-34293
Nyheter i 22.07-versionen
den 26 juli 2022
Azure Sphere 22.07-versionen innehåller följande komponenter:
- Uppdaterade Azure Sphere-operativsystemet
- Uppdaterade Azure Sphere SDK för Windows och Linux
- Azure Sphere-tillägg för Visual Studio och Visual Studio Code har uppdaterats
Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet. Information om hur du installerar den senaste SDK:t finns i snabbstarten för installation för Windows eller Linux:
- Snabbstart: Installera Azure Sphere SDK för Windows
- Snabbstart: Installera Azure Sphere SDK för Linux
Höjdpunkterna i den här versionen inkluderar en minskning av tiden för att ansluta till molnet för operativsystemet, vilket resulterar i lägre energianvändning, publicering av metodtips för produktionsklara program och publicering av optimerade tillverkningsskript.
Nya och ändrade funktioner i 22.07 OS
22.07-versionen av Azure Sphere OS innehåller:
- Operativsystemet stöder nu cachelagring av DAA-certifikatet (kund) i beständig lagring. Detta resulterar i minskad energiförbrukning vid kall start och minskad tid för att ansluta till molnet efter kall start eller strömavbrott.
- Operativsystemet har en ny API-funktion,
Applications_GetOSVersion()
, i Applibs applications.h som returnerar en utskrivbar sträng som innehåller den aktuella OS-versionen.
Nya och ändrade funktioner i 22.07 SDK
22.07-versionen av Azure Sphere SDK innehåller följande ändringar.
Stöd för monokroma CLI-utdata
Azure Sphere CLI stöder nu monokroma utdata av hjälpmedelsskäl. Med det här kommandot kan du hantera färginställningen för meddelanden i Azure Sphere CLI. Om du aktiverar parametern no-color
tas färgade meddelanden bort och de ursprungligen färgade meddelandena prefixeras med DEBUG
, INFO
, WARNING
eller ERROR
.
Klassisk CLI-autentisering i Azure Sphere migrerad från ADAL till MSAL
Den klassiska Azure Sphere CLI använder nu Microsoft Authentication Library (MSAL) i stället för Active Directory Authentication Library (ADAL), som dras tillbaka. Det finns ingen ändring i användningen av det klassiska Azure Sphere CLI som ett resultat av migreringen till MSAL, och ingen kundåtgärd krävs.
Stöd för andra utdataformat
Följande Azure Sphere CLI-kommandon stöder nu parametern --output
eller -o
för att ange formatet för CLI-utdata. Se Kommandon som stöds för listan över kommandon som för närvarande stöder flera utdataformat.
Nya och ändrade funktioner i tilläggen 22.07 Visual Studio och Visual Studio Code
CMakePresets stöds nu av både Visual Studio och Visual Studio Code. Med CMakePresets.json-filen kan du ange vanliga konfigurations-, bygg- och testalternativ och sedan dela dem med utvecklare med hjälp av andra utvecklingsmiljöer.
Nya och uppdaterade exempel, kodfragment och galleriobjekt
22.07-versionen innehåller följande ändringar i exemplen, kodfragmenten och galleriobjekten.
Uppdateringar av exempel för användning av icke-blockerande API:er för Azure IoT
Azure IoT- och ExternalMcuLowPower-exemplen har uppdaterats för att undvika att blockera API:er för Azure IoT och i stället använda icke-blockerande API:er. Om programkoden använder IoTHubDeviceClient_LL_CreateWithAzureSphereDeviceAuthProvisioning rekommenderar vi att du tittar på de uppdaterade exemplen och överväger om ett icke-blockerande API-mönster bättre skulle uppfylla dina behov.
Tillverkningsexempel
Vi har publicerat uppdaterade tillverkningsexempel. Tidigare distribuerades tillverkningsexempel privat, men från och med den här versionen kommer exemplen att underhållas på GitHub. Som en del av detta har vi publicerat REST-API:er för enheter (vilket gör det möjligt att kringgå CLI för att kommunicera direkt med enhetens REST API) med både C# och Python-stöd, exempelprogram och tester. Tillverkningsskripten portas till med hjälp av dessa REST-API:er. Den här direkta användningen av REST-API:er för enheter möjliggör ökad tillverkningshastighet. Mer information finns i Tillverkningsguide för anslutna enheter.
Uppdateringar av vägledning och maskinvarudesign för FTDI-gränssnitt
Vi har gjort några mindre ändringar i vår vägledning för MT3620-maskinvara som rör hur FTDI-programmerings- och felsökningsgränssnittet hanterar aktivering från lågeffektlägen. Detta förbättrar kompatibiliteten med Modulen Avnet MT3620 V2. Vissa resistorvärden har uppdaterats i programmerings- och felsökningsgränssnittet för MT3620. McU till molnexemplet med låg effekt har uppdaterats för att återspegla den här vägledningen, och vi har utfärdat nya maskinvaruexempel för MCU med låg effekt till molnmaskinvara v2.0 och FTDI-gränssnittskort v2.0 som återspeglar den här uppdaterade vägledningen. FTDI-gränssnittskortet v2.0-uppdateringar lägger även till dubbla fotavtryck för Service/Debug-, Recovery- och SWD-anslutningsappar.
Nytt kodfragment för Applications_GetOSVersion-API:et
Den nya versionen av Get Azure Sphere Device OS visar hur du hämtar Azure Sphere Device OS-versionen i ett högnivåprogram.
Ny och reviderad dokumentation i 22.07-versionen
Artikel | Ändringar |
---|---|
Konfigurera versioner med hjälp av CMake | Artikeln har uppdaterats med information om hur du konfigurerar CMakePresets.json med Visual Studio och Visual Studio Code. |
Skapa ett realtidskompatibelt program | Uppdaterat ämne för att beskriva nya CMake-konfigurationer och kompileringskommandon. |
Rekommendationer för utveckling av produktionsklara program | Nya avsnitt som ger metodtips för att kontrollera att dina Azure Sphere-program på hög nivå eller i realtid är redo för pilot- eller produktionsdistribution. |
azsphere-inställning | Nytt ämne som innehåller information om azure setting kommandot. |
Utdataformat som stöds för Azure Sphere CLI | Uppdaterad lista över kommandon som stöder flera utdataformat. |
funktionen Applications_GetOsVersion | Ämne har lagts till för ny API-funktion. |
Tillverkningsguide | Har uppdaterats för att återspegla nya tillverkningsexempel som publicerats på GitHub. |
Kända problem i 22.07-versionen
Om Wi-Fi-nätverksgränssnittet är inaktiverat och enheten startas om visas ett godtyckligt värde för gränssnittets maskinvaruadress (MAC-adress) när du kör azsphere device network list-interfaces
CLI-kommandot eller när du använder API:et Networking_GetHardwareAddress
. Lös problemet genom att återaktivera Wi-Fi-gränssnittet och köra CLI-kommandot eller API:et igen för att få rätt maskinvaruadress.
Åtgärdade buggar och vanliga sårbarheter i 22.07-versionen
Kommandot
azsphere tenant create
fungerar nu när en lokalt ansluten Azure Sphere-enhet är tillgänglig. I 21.10 och senare versioner rapporterades ett fel även om enheten är ansluten. Korrigeringen identifierar nu automatiskt den anslutna enheten när du skapar en klientorganisation.22.07-versionen innehåller följande uppdateringar för att undvika följande vanliga sårbarheter och exponeringar (CVE):
- 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
Om 22.04-kvalitetsversionen
den 11 april 2022
22.04-versionen innehåller en uppgradering till Linux-kerneln (5.10.103) och buggkorrigeringar i Azure Sphere-operativsystemet. den innehåller inte något uppdaterat SDK. Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet.
Åtgärdade buggar och vanliga sårbarheter i 22.04-versionen
22.04-versionen innehåller uppdateringar för att undvika följande vanliga sårbarheter och exponeringar (CVE):
- wolfSSL CVE-2022-25638
- wolfSSL CVE-2022-25640
- C-Ares CVE-2021-3672
- Linux CVE-2022-0847 ("dirty pipe")
Nya och uppdaterade galleriprojekt för 22.04
Det nya galleriprojektet AzureFunctionApp_AzureSpherePublicAPI visar hur du använder det offentliga AZURE Sphere-API:et i en Python Azure-funktionsapp.
Ny och reviderad dokumentation i 22.04-versionen
Artikel | Ändringar |
---|---|
Stoppa Azure Sphere Device Communication Service | Lade till ett felsökningsavsnitt som rör installationsprogrammet som hänger sig under installationen. |
Ansluta Azure Sphere via en proxyserver | Krav på programmanifest har lagts till och information om hur du använder MQTT för att ansluta till Azure IoT Hub. |
Konfigurera en Azure IoT Hub för Azure Sphere | Uppdaterad för att göra användarupplevelsen tydlig och korrekt. |
Konfigurera en Azure IoT Hub för Azure Sphere med device provisioning-tjänsten | Uppdaterad för att göra användarupplevelsen tydlig och korrekt. |
Konfigurera Azure IoT Edge för Azure Sphere | Uppdaterad för att förtydliga text och matcha Azure-användargränssnittet. |
Konfigurera Azure IoT Central för användning av Azure Sphere | Uppdaterad för att göra användarupplevelsen tydlig och korrekt. |
Azure Sphere OS-feeds - Konfigurera enheter för OS-utvärdering |
Har uppdaterats för att klargöra hur Azure Sphere-operativsystemet distribueras i retailutvärderingsflödet. |
Tillverkningsguide | Uppdaterad för att klargöra vad som ingår i en enhetstillverkningsprocess. |
Förberedelse av tillverkningsprocessen | Nytt ämne som innehåller information om uppgifter som ska utföras innan du utför uppgifter på fabriksgolvet och molnkonfigurationsuppgifter. |
Uppgifter på fabriksgolvet | Uppdaterad för tydlighetens skull. Flyttade förberedelseuppgifter till det nya avsnittet Om tillverkningsförberedelse . |
Molnkonfigurationsuppgifter | Uppdaterad för tydlighetens skull. Flyttade förberedelseuppgifter till det nya avsnittet Om tillverkningsförberedelse . |
RF-verktyg | Ett nytt avsnitt har lagts till, När användningen av RF-verktyg har slutförts, för att beskriva uppgifter som ska utföras när du är klar med rf-verktyg. |
Om versionen 22.02 Update 1
den 17 mars 2022
Versionen av Azure Sphere 22.02 Update 1 innehåller följande komponenter:
- Uppdaterade Azure Sphere SDK för Windows och Linux
- Uppdaterat Azure Sphere-tillägg för Visual Studio Code
Det innehåller inte ett uppdaterat operativsystem eller ett uppdaterat Visual Studio-tillägg.
Uppdateringar i 22.02 Update 1 SDK
Den uppdaterade SDK:n löser ett problem som har meddelats på Tech Community IoT-bloggen som rör stöd för sys/socket.h-huvud musl 64-bitars tid som påverkar API-uppsättningen 12. Om du har installerat den ursprungliga versionen av SDK:et 22.02 installerar du den uppdaterade versionen.
Dricks
Du kan använda Azure Sphere CLI-kommandot azsphere show-version
för att avgöra vilken version av SDK du har. Den ursprungliga SDK:en för 22.02 har det fullständiga versionsnumret 22.02.3.34006; 22.02 Update 1 SDK har det fullständiga versionsnumret 22.02.3.41775. Observera att den klassiska Azure Sphere CLI endast visar versionen i formatet 22.02.
Information om hur du installerar den senaste SDK:t finns i snabbstarten för installation för Windows eller Linux:
- Snabbstart: Installera Azure Sphere SDK för Windows
- Snabbstart: Installera Azure Sphere SDK för Linux
Uppdateringar i Visual Studio Code-tillägget 22.02 Update 1
I Linux visade klientutforskaren i Visual Studio Code-tillägget för Azure Sphere tidigare ett fel. Det uppdaterade tillägget visar resultatet korrekt.
Uppdateringar i 22.02 Update 1-byggmiljöcontainern
Containern för Azure Sphere-byggmiljön har uppdaterats till SDK:et 22.02 Update 1.
Nyheter i 22.02-funktionsversionen
Funktionsversionen av Azure Sphere 22.02 innehåller följande komponenter:
- Uppdaterade Azure Sphere-operativsystemet
- Uppdaterade Azure Sphere SDK för Windows och Linux
- Uppdaterade Azure Sphere-tillägg för Visual Studio och Visual Studio Code
Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet. Information om hur du installerar den senaste SDK:t finns i snabbstarten för installation för Windows eller Linux:
- Snabbstart: Installera Azure Sphere SDK för Windows
- Snabbstart: Installera Azure Sphere SDK för Linux
Det finns även uppdaterade exempel, kodfragment, galleriprojekt och dokumentationsuppdateringar.
Viktigt!
den 8 mars 2022
22.02 SDK har ett problem som rör sys/socket.h-huvudet och stöd för musl 64-bitars tid som ingår i API-uppsättningen 12. Problemet kommer att lösas i en kommande uppdatering av SDK:et. Ingen os-ändring krävs för att åtgärda problemet. Men för tillfället, om du använder funktionen setsockopt() som definierats i sys/socket.h, bör du inte skapa dina produktionsprogram med API-uppsättningen 12. Vi rekommenderar att du använder API set 11 med 22.02-versionen.
Detta påverkar endast nyligen kompilerade program som skapats med versionen 22.02. Det påverkar inte :
- Befintliga kompilerade binärfiler eller distribuerade program.
- Program som skapats med andra SDK:er än den senaste versionen av 22.02.
- Program som skapats med 22.02 SDK men som använder andra API-uppsättningar än version 12.
Nya och ändrade funktioner i 22.02 OS
22.02-versionen av Azure Sphere OS innehåller en uppgradering till Linux-kerneln (5.10.70) och stöd för DHCP-version och förnyelse.
DHCP-version och förnyelse
Azure Sphere OS stöder nu DHCP-version och förnyelse via nya API:er så att appar på hög nivå kan styra sina enhets-IP-lån.
Det nya DHCP-exemplet visar hur du använder dessa nya API:er.
Nya och ändrade funktioner i SDK 22.02
22.02-versionen av Azure Sphere SDK innehåller stöd för Windows 11, uppdateringar av 64-bitars tidsstöd, en ändring av standardloggningsbeteendet för CLI och en uppdatering av autentiseringsbiblioteket till CLI.
Stöd för Windows 11
Windows 11 stöds nu för Azure Sphere-utveckling. Om du använder Windows 11 installerar du SDK:t 22.02 (eller senare).
Stöd för 64-bitars tid
22.02 SDK-versionen uppdaterar stöd för 64-bitars tid för appar på hög nivå. Detta åtgärdar oväntade beteenden som introduceras med stöd för 64-bitars tid i 20.10-versionen.
Programkod som inte gör några antaganden om storleken på ett time_t
värde påverkas inte. Programkod som uttryckligen eller implicit förväntar sig time_t
att vara 32-bitars måste dock skrivas om för att kunna användas time32_t
i stället.
Dricks
Kontrollera stack- och heapanvändningen och binärstorleken i dina program för att säkerställa att dina program fortsätter att fungera som förväntat efter återskapande. De kan växa, liksom time_t
nu är 8 byte i stället för 4.
Mer detaljerad information finns i avsnittet C-typ time_t i avsnittet Grundläggande API:er.
Konfigurera Azure Sphere CLI-loggning
Azure Sphere CLI skriver inte längre loggfiler till den lokala disken som standard. Mer information om hur du aktiverar och konfigurerar loggning finns i Hantera loggfiler .
Azure Sphere CLI-autentisering migrerad från ADAL till MSAL
Azure Sphere CLI använder nu Microsoft Authentication Library (MSAL) i stället för Active Directory Authentication Library (ADAL), som dras tillbaka. Användningen av Azure Sphere CLI ändras inte till följd av migreringen till MSAL och ingen kundåtgärd krävs.
Klassiska Azure Sphere CLI använder fortfarande ADAL, men uppdateras före ADAL-tillbakadragningsdatumet den 30 juni 2022. Vi rekommenderar fortfarande att du migrerar till nya Azure Sphere CLI.
Nya och ändrade funktioner i 22.02 för Visual Studio- eller Visual Studio Code-tillägg för Azure Sphere
Ett Azure Sphere-tillägg för Visual Studio 2022 är nu tillgängligt utöver det befintliga tillägget för Visual Studio 2019. Den lägsta versionen av Visual Studio 2019 som stöds är nu 16.11.
Visual Studio- och Visual Studio Code-tilläggen för Azure Sphere tillhandahåller nu följande funktioner:
- Konfigurera Wi-Fi i Azure Sphere Explorer.
- Visa distributionshistorik i Azure Sphere Explorer.
- Öppna demonteringsvyn i Visual Studio Code vid felsökning.
Konfigurera Wi-Fi i Azure Sphere Explorer
Nu kan du lägga till Wi-Fi-nätverk, ansluta till dem, aktivera eller inaktivera dem och glömma dem från det grafiska gränssnittet i Azure Sphere Explorer.
Visa distributionshistorik
Nu kan du visa alla distributioner för en viss enhetsgrupp med hjälp av Azure Sphere Explorer, inklusive datum och komponent-ID för varje distribution.
Öppna demonteringsvyn vid felsökning
Disassembly-vyn ger en lågnivåvy över din interna kod och utökar det vanliga stegvisa felsökningsprogrammet. Den här ändringen i Visual Studio Code-tillägget ger nu samma demonteringsupplevelse som i Visual Studio.
Nya och uppdaterade exempel, kodfragment och galleriprojekt för 22.02
- Det nya DHCP-exemplet visar hur du använder de nya API:erna för att släppa eller förnya IP-adressen som en DHCP-server har tilldelat till en enhet.
- Dns-tjänstidentifieringsexemplet uppdaterades för att vara mer motståndskraftigt mot nätverksfrånkoppling.
- Kommunikationsexemplet mellan kärnor uppdaterades så att det inte visar någon ytterligare dialogruta när du öppnar det med nyare versioner av Visual Studio.
- Det nya kodfragmentet Hämta Azure Sphere-enhets-ID visar hur du använder Azure Sphere-API:et för att hämta enhets-ID:t i ett högnivåprogram.
- Det nya projektet Industriell enhetsstyrenhet i Azure Sphere-galleriet visar hur du ansluter Azure Sphere till olika nedströms Modbus-enheter för att samla in telemetridata i realtid.
Ny och reviderad dokumentation i 22.02-versionen
Artikel | Ändringar |
---|---|
Snabbstart: Konfigurera nätverk och uppdatera enhetens operativsystem | Innehåller instruktioner för att konfigurera Wi-Fi med Azure Sphere Explorer. |
Visa information om enheter och klientorganisationer i Azure Sphere Explorer | Har uppdaterats för att inkludera nya funktioner. |
Använda GitHub Codespaces för att skapa och felsöka | Nytt avsnitt om hur du använder Visual Studio Code för att utveckla program med GitHub Codespaces. |
Minnesanvändning i högnivåprogram | Har uppdaterats med instruktioner för att skapa och köra batchskript för minnesövervakning i en kommandotolk. |
Felsöka ett högnivåprogram | Har uppdaterats med instruktioner för att öppna vyn demontering. |
Felsöka ett realtidskompatibelt program | Har uppdaterats med instruktioner för att öppna vyn demontering. |
Felsöka partnerprogram | Har uppdaterats med instruktioner för att öppna vyn demontering. |
Konfigurera versioner med hjälp av CMake | Uppdaterad för att beskriva den nya CMakeWorkspaceSettings.json fil som behövs för projekt med flera rötter. |
Enhetsidentitet och säkerhet | Nytt avsnitt om säkerhetsöverväganden och rekommenderade metodtips för att använda enhets-ID:n. |
Visa distributionshistorik | Har uppdaterats med instruktioner för att visa distributionshistorik i Azure Sphere Explorer. |
Hantera loggfiler | Nytt avsnitt om hur du konfigurerar loggning med hjälp av CLI. |
Buggar i 22.02-versionen har åtgärdats
Versionen 22.02 innehåller följande felkorrigeringar:
- WifiConfig_GetNetworkDiagnostics returnerade ett oväntat värde efter att ha försökt ansluta till wi-fi med ogiltiga autentiseringsuppgifter. Korrigeringen returnerar rätt felmeddelande.
- NTP-tidssynkronisering kan vara långsam och oberäknelig om en anpassad NTP-server har angetts. Korrigeringen normaliserar tidssynkroniseringsprocessen för anpassade servrar.
- Enheter som använder Ethernet kunde ibland inte återupprätta nätverksanslutningen när ett drivrutinsfel inträffade. En korrigering av Ethernet-nätverksgränssnittsdrivrutinen återupprättar mer konsekvent nätverksanslutningen i dessa fall.
Känt problem i 22.02-versionen
Ett felmeddelande No section: 'sphere'
visas i Azure Sphere CLI om användaren inte autentiseras. Lös problemet genom att autentisera till Azure Sphere CLI med hjälp av azsphere login
kommandot .
Om 22.01-kvalitetsversionen
Azure Sphere släppte inte ett uppdaterat operativsystem eller SDK för 22.01. Mer information finns i blogginlägget om 22.01-versionens annullering.
Uppdateringar för 22.01 innehåller två nya projekt i galleriet och dokumentationsuppdateringar.
Kommentar
I den tidigare versionen informerade vi dig om att det klassiska Azure Sphere CLI skulle tas bort från SDK:et från och med april 2022. Tidslinjen för dess pensionering har förlängts. Vi har för avsikt att dra tillbaka det klassiska CLI:et vid ett framtida datum, men inte före slutet av 2022. Vi rekommenderar fortfarande att du migrerar dina processer och skript till CLIv2.
Nya och uppdaterade exempel och galleriprojekt för 22.01
OpenSourceProjectsSupportingExternalPeripherals är en lista över projekt med öppen källkod som använder extern maskinvara med Azure Sphere och MT3620-chipet.
ToggleClassicCLI innehåller skript för Windows och Linux som gör att du kan testa borttagningen av klassiska Azure Sphere CLI (och sedan återställa det). Det klassiska Azure Sphere CLI har ersatts av CLIv2 och tas bort från Azure Sphere SDK vid ett framtida datum. De här skripten hjälper dig att identifiera beroenden som du kan ha på det klassiska CLI.
Ny och reviderad dokumentation i 22.01-versionen
Artikel | Ändringar |
---|---|
Felsöka Azure Sphere-problem | Felsökningsstegen för felmeddelandet "Azure Sphere Device Communication Service kunde inte stoppas" har lagts till. |
Använda tjänsttaggar för att begränsa åtkomsten till Azure Sphere Security Service | Nytt avsnitt om hur du använder AzureSphere-tjänsttaggen för att tillåta eller neka trafik till Azure Sphere Security Service. |
Enhetsfunktioner och servicesessioner | Ett förtydligande har lagts till om hur enheter hämtar funktioner och vad du kan göra med funktionen fieldServicing . |
Azure Sphere CVEs | Ett förtydligande har lagts till om vårt deltagande i CVE-programmet och kundpåverkan från Azure Sphere-CVE:er. |
Skyddsmoduler | Uppdaterade länkar, förtydligade information i hela ämnet och omorganiserade avsnitt. |
Om kvalitetsversionen av 21.11
Azure Sphere släppte inte ett uppdaterat operativsystem eller SDK för 21.11.
Uppdateringar för 21.11 innehåller följande dokumentationsändringar och andra mindre ändringar:
Artikel | Ändringar |
---|---|
Enhetsfunktioner och servicesessioner | Förtydliganden och korrigeringar av när funktioner behövs och vilka åtgärder de tillåter. |
Konfigurera Azure IoT Edge för Azure Sphere | Har uppdaterats med instruktioner för att arbeta med både IoT Edge 1.2 och IoT Edge 1.1. |
Azure Sphere CVEs | Lade till information om innehållet och tidpunkten för publicerade Vanliga säkerhetsrisker och exponeringar i Azure Sphere (CVE). |
Uppgifter på fabriksgolvet | Information om tillverkningstillstånd och enhetsfunktioner har lagts till. |
apparat | Förtydliganden och korrigeringar av enhetsfunktioner. |
Översikt över Azure Sphere CLI | Förtydliganden och korrigeringar av enhetsfunktioner. |
Nyheter i 21.10-funktionsversionen
Azure Sphere 21.10-funktionsversionen innehåller följande komponenter:
- Uppdaterade Azure Sphere-operativsystemet
- Uppdaterade Azure Sphere SDK för Windows och Linux
- Uppdaterade Azure Sphere-tillägg för Visual Studio och Visual Studio Code
Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet. Information om hur du installerar de senaste SDK:erna och tilläggen för Visual Studio och Visual Studio Code finns i snabbstarten för installation för Windows eller Linux:
- Snabbstart: Installera Azure Sphere SDK för Windows
- Snabbstart: Installera Azure Sphere SDK för Linux
Viktigt!
Azure Sphere Classic CLI kommer inte att ingå i SDK-versioner från och med april 2022. Klassiska CLI markerades som pensionerad i februari 2021. Om du fortfarande är beroende av det klassiska CLI:et måste du migrera dina processer och skript före april 2022 för att undvika avbrott.
Nya och ändrade funktioner i 21.10-versionen
21.10-versionen innehåller:
- stöd för att ansluta till ett nätverk via en proxyserver.
- säkerhetskorrigeringar och prestandaförbättringar i wolfSSL version 4.8.1.
- förbättringar i anslutning till Azure IoT Hub med Device Provisioning Service (DPS).
- möjligheten att byta namn på en klientorganisation.
- stöd för att ange utdataformatet från Wi-Fi-kommandon i CLI.
- vägledning för att använda MT3620 i scenarier där Wi-Fi inte krävs.
Stöd för webbproxy
Azure Sphere-enheter kan nu ansluta till ett nätverk via en proxyserver. Du kan konfigurera en proxy med applibs-kommandon eller med CLI. Mer information finns i Ansluta Azure Sphere via en proxyserver.
Mer information om tillgängliga CLI-kommandon finns i nätverksproxy.
wolfSSL uppdaterad till version 4.8.1
Azure Sphere OS innehåller nu wolfSSL 4.8.1. Den här uppdateringen innehåller de senaste säkerhetskorrigeringarna och prestandaförbättringarna från wolfSSL. Dessutom exponeras en ny ABI via operativsystemet för att förhindra man-in-the-middle-attacker i vissa TLS-konfigurationer. När du använder wolfSSL i ditt program (som visas i wolfSSL-exemplet) rekommenderar vi att du använder wolfSSL_CTX_set_verify
för att verifiera värden när det är tillämpligt.
Se mer information om hur du använder wolfSSL_CTX_set_verify på wolfSSL-webbplatsen.
Verifiera ca-certifikatet för klientorganisationen automatiskt på Azure IoT Hub
Vi har uppdaterat vägledningen om hur du konfigurerar Azure IoT Hub och DPS med Azure Sphere-klientcertifikat för att inkludera en förenklad process som inte kräver ett verifieringssteg för bevis på innehav. Mer information finns i Konfigurera en Azure IoT Hub för Azure Sphere och Konfigurera en Azure IoT Hub för Azure Sphere med device provisioning-tjänsten.
Stöd för klientbyte
Med azsphere tenant update
Azure Sphere CLI-kommandot kan du byta namn på en befintlig klientorganisation. Mer information finns i referensavsnittet för klientkommandot .
Ange utdataformat för Wi-Fi-kommandon
Kommandona azsphere device wifi
stöder nu parametern --output
eller -o
för att ange formatet för CLI-utdata. Mer information finns i Utdataformat som stöds.
Använda MT3620 i scenarier där Wi-Fi inte krävs
Vi har gett uppdaterad vägledning för programvara och maskinvara för scenarier där Wi-Fi antingen tillfälligt eller permanent inte krävs, som visar hur du kan minska energiförbrukningen och förenkla maskinvarudesignen i sådana scenarier. Mer information finns i Wi-Fi-anslutningar och MT3620-maskinvaruanteckningar .
Nya och uppdaterade exempel och galleriprojekt för 21.10
Följande Azure Sphere-exempel har uppdaterats för 21.10:
- Ytterligare ett skrivskydd har lagts till i AzureIoT-exemplet för att visa hur du lägger till stöd för webbproxy.
- HTTPS/cURL-exemplen har uppdaterats för att visa hur du lägger till proxystöd.
Följande projekt i Azure Sphere-galleriet har lagts till eller uppdaterats för 21.10:
- Azure IoT Store och Forward visar hur du lägger till telemetrilagring och vidarebefordran i AzureIoT-exemplet.
- CO2_MonitorHealthySpaces visar hur du integrerar en CO2-övervakare med IoT Central.
- EAP-TLS_Solution visar hur du ansluter Azure Sphere-enheter till EAP-TLS-nätverk.
- SimpleFileSystem_RemoteDisk visar hur du lägger till stöd för filsystem i ett Azure Sphere-projekt.
Ny och reviderad dokumentation i 21.10-versionen
Artikel | Ändringar |
---|---|
Ansluta Azure Sphere via en proxyserver | Nytt avsnitt som beskriver hur du konfigurerar en Azure Sphere-enhet för att ansluta till Internet via en proxyserver. |
Konfigurera en Azure IoT Hub för Azure Sphere | Uppdaterat ämne med information om automatisk och manuell verifiering av ett klientcertifikatutfärdarcertifikat på Azure IoT Hub. |
Konfigurera en Azure IoT Hub för Azure Sphere med device provisioning-tjänsten | Uppdaterat avsnitt med information om automatisk och manuell verifiering av ett klientcertifikatutfärdarcertifikat på Device Provisioning Service. |
Uppdatera en befintlig klientorganisation | Information om hur du byter namn på en befintlig klientorganisation har lagts till. |
Maskinvaruanteckningar för MT3620 | Uppdaterad med information om hur du inaktiverar Wi-Fi i vissa scenarier. |
apparat | – Information om azsphere device network proxy kommandot har lagts till. – Uppdaterade exempel för kommandona azsphere device wifi . |
klientuppdatering | Information om kommandot har lagts till azure sphere tenant update . |
Referens för Applibs-nätverk | Api:er för proxyklientstöd har lagts till. |
Känt problem i 21.10-versionen
Alla program som skapats med hjälp av 21.10 SDK som använder spårning av heapminnesallokering kan inte skapas med följande fel:
azsphere_target_add_image_package tog emot en oväntad begäran om att ange DEBUG_LIB: libmalloc som inte är tillgänglig i den valda mål-API-uppsättningen. Välj version 10 eller senare i CMakeLists.txt.
För att åtgärda felet måste du göra en liten ändring i en av SDK CMake-filerna. Du måste vara administratör för att kunna ändra den här filen.
- I Windows: C:\Program Files (x86)\Microsoft Azure Sphere SDK\CMakeFiles\AzureSphereToolchainBase.cmake
- På Linux: /opt/azurespheresdk/CMakeFiles/AzureSphereToolchainBase.cmake
Ändra rad 13 i AzureSphereToolchainBase.cmake till följande:
set(libmalloc_10_or_later "10" "11" )
Det här problemet åtgärdas i nästa version av Azure Sphere SDK.
- Ett fel rapporteras när du skapar en klientorganisation med kommandot
azsphere tenant create
. Det beror på att den anslutna Azure Sphere-enheten inte identifieras automatiskt. Du kan åtgärda detta genom att ange enheten när du kör kommandot . Exempel:azsphere tenant create --device <device-ID> --name <tenant-name>
Korrigeringen kommer att tillhandahållas i en framtida version.
Åtgärdade buggar och vanliga sårbarheter i 21.10-versionen
21.10-versionen innehåller uppdateringar för att minimera mot följande CVE:er:
- 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
Om 21.09-kvalitetsversionen
21.09-versionen innehåller uppdateringar av Azure Sphere OS; den innehåller inte något uppdaterat SDK. Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet.
Uppdateringar av Azure Sphere-operativsystemet omfattar:
- Uppgraderade Linux Kernel till 5.10.60.
- Förbättringar av kraschhantering för att förhindra låsning.
Nya och uppdaterade galleriprojekt för 21.09
- RS-485-realtidsdrivrutin visar hur du använder en M4F-kärna på MT3620 för att implementera tillförlitlig RS-485-kommunikation med kommunikation mellan kärnor till högnivåappen på A7-kärnan.
Ny och reviderad dokumentation i 21.09-versionen
Artikel | Ändringar |
---|---|
Felsöka moln- och distributionsproblem | Felsökningsinformation som rör anspråk på en enhet har lagts till. |
Om 21.08-kvalitetsversionen
21.08-versionen innehåller följande förbättringar och felkorrigeringar i Azure Sphere OS; den innehåller inte något uppdaterat SDK.
- Säkerhetsuppdateringar
- Förbättrad stabilitet för Ethernet-stöd
- Förbättrad stabilitet för I2C-enheter
Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet.
Det finns också nya Azure Sphere-galleriexempel och dokumentationsuppdateringar.
Buggar och vanliga sårbarheter har åtgärdats i 21.08-versionen
21.08-versionen innehåller uppdateringar för att undvika följande vanliga sårbarheter och exponeringar (CVE):
- CVE-2021-22924
- CVE-2021-36956
Nya galleriexempel
Följande nya eller uppdaterade exempel har lagts till i Azure Sphere-galleriet, en samling ej använda skript, verktyg och funktioner:
- Littlefs SD-kort visar hur du lägger till stöd för filsystem och SD-kort i en Azure Sphere-implementering.
- AzureIoTMessageWithProperties visar hur du lägger till anpassade egenskaper i ett telemetrimeddelande som skickas till Azure IoT Hub.
Ny och reviderad dokumentation i 21.08-versionen
Artikel | Ändringar |
---|---|
azsphere-enhet | Referensavsnittet har uppdaterats för tillbakadragande av --cert-id och --interface-name . |
Viktiga ändringar (tillbakadragna funktioner) i Azure Sphere CLI | Nytt ämne som beskriver funktioner, kommandon eller parametrar som har dragits tillbaka eller tas bort från Azure Sphere CLI. |
Nyheter i 21.07-funktionsversionen
Azure Sphere 21.07-funktionsversionen innehåller följande komponenter:
Uppdaterade Azure Sphere-operativsystemet
Uppdaterade Azure Sphere SDK för Windows och Linux
Uppdaterade Azure Sphere-tillägg för Visual Studio och Visual Studio Code
Det finns även uppdaterade exempel, självstudier, galleriobjekt och dokumentationsuppdateringar.
Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet. Du uppmanas att installera det uppdaterade SDK:t vid nästa användning, eller så kan du installera det nu. Information om hur du installerar den senaste SDK:t finns i snabbstarten för installation för Windows eller Linux:
Viktigt!
den 30 september 2021
Uppdatering 2 för 21.07 SDK för Windows är nu tillgänglig. Den här uppdateringen åtgärdar ett installationsfel som förhindrar avinstallation av Azure Sphere SDK efter uppgradering till Windows 11.
den 28 juli 2021
Uppdatering 1 för 21.07 SDK är nu tillgänglig. Om du hade installerat den tidigare versionen av 21.07 SDK kan du installera om för att hämta den uppdaterade versionen. 21.07 SDK-versionen tog felaktigt bort några tillbakadragna parametrar från Azure Sphere CLI. 21.07 Update 1 SDK återställer dessa tillbakadragna parametrar till CLI för bakåtkompatibilitet. Mer information finns i Viktiga ändringar (tillbakadragna funktioner) i Azure Sphere CLI.
Nya och ändrade funktioner i 21.07-versionen
21.07-versionen innehåller en förbättring av hur tidssynkronisering hanteras, möjligheten att spåra användning av delade biblioteks heapminne under utveckling och nya sätt att autentisera med Hjälp av Azure Active Directory. Den här versionen innehåller även vissa felsökningsförbättringar i Visual Studio- och Visual Studio Code-tilläggen, utökat stöd för parametern --output
i CLI och möjligheten att hämta ytterligare enhetsinformation från vissa kommandon i CLI och public API (PAPI).
Tidssynkroniseringsändringar
Tidssynkroniseringsprocessen har ändrats i 21.07-versionen för att ge en mer robust process när den primära tidsservern misslyckas eller inte kan nås. Tidigare kunde tjänster som är beroende av slutförande av tidssynkronisering misslyckas med att starta om återförsök för tidssynkronisering förhindrade att tidssynkroniseringen slutfördes. Ändringen lägger till en återställningsmekanism för att få korrekt tid så att återförsök för tidssynkronisering inte fortsätter på obestämd tid.
Spårning av heapminnesallokering
Funktionen för spårning av heapminnesallokering ger utvecklare ett bekvämt sätt att se minnesallokeringar från bibliotek som ingår i Azure Sphere SDK under utvecklingen av ett program. Funktionen lägger till en ny programfunktion, HeapMemStats, och ett nytt Azure Sphere SDK-bibliotek, libmalloc. Funktionen innehåller också ändringar i utdata från Azure Sphere CLI-kommandot azsphere device app show-memory-stats och Visual Studio-tillägget. Med dessa ändringar kan utvecklare lägga till HeapMemStats-funktionen i sitt högnivåprogram, distribuera appen till en utvecklingsaktiverad enhet och använda Visual Studios Prestandaprofiler för att visa det minne som används av SDK-biblioteken som anropas av deras app.
Autentiseringsmetoder med Azure Active Directory
Azure Sphere Public API (PAPI) stöder flera metoder för användarautentisering och auktorisering i Azure Active Directory (AAD).
Med Azure Active Directory kan en programtoken användas för att autentisera och bevilja åtkomst till specifika Azure-resurser från en användarapp, tjänst eller automationsverktyg med hjälp av tjänstens huvudnamn eller den hanterade identitetsmetoden för autentisering.
Följande autentiseringsmetoder stöds nu med Hjälp av Azure Active Directory:
- Få åtkomst till Offentligt API för Azure Sphere med AAD-hanterad identitet
- Få åtkomst till Offentligt API för Azure Sphere med AAD-programtjänstens huvudnamn
- Få åtkomst till Offentligt API för Azure Sphere med din AAD-användaridentitet
Ytterligare information om uppdateringsstatus från CLI- och PAPI-kommandon
Det offentliga API:et för Azure Sphere har utökats till att omfatta ytterligare enhetsinformation om operativsystemet och uppdateringsstatus. Nu kan du se vilken version av systemoperativsystemet som är installerat på enheten, den senaste tillgängliga operativsystemversionen, när enheten senast uppdaterades och när enheten senast sökte efter uppdateringar. Den ytterligare informationen kan vara till hjälp för att hantera uppdateringar av dina enheter.
Följande Azure Sphere API-referenssidor förklarar API-svarsändringarna mer detaljerat:
Kommando | beskrivning |
---|---|
Enheter – Hämta | Hämtar information för en enhet. |
Enheter – lista | Hämtar alla enheter som begärs till den angivna klientorganisationen. |
Enheter – lista i grupp | Hämtar alla enheter som har tilldelats till den angivna enhetsgruppen. |
Enheter – lista i produkt | Hämtar alla enheter som tillhör den angivna produkten. |
Dessutom har Azure Sphere CLI uppdaterats för att inkludera dessa ytterligare enhetsinformation i azsphere device list
kommandona , azsphere device show
och azsphere device update
med hjälp av parametern --query
eller de utdataformat som stöds. Exempel: azsphere device show --output json
Nya och ändrade funktioner i Visual Studio- eller Visual Studio Code-tillägg för Azure Sphere
Visual Studio- och Visual Studio Code-tilläggen innehåller fler beskrivande namn för felsökningsmål. Visual Studio-tillägget innehåller även stöd för spårning av heapminnesallokering.
Fler beskrivande namn för felsökningsmål
Visual Studio-tillägget använder nu projektnamnet för felsökningsmålnamnet. Visual Studio Code-tillägget visar projektnamnet som tidigare, men förenklar den beskrivande texten.
Stöd för andra utdataformat
Ytterligare Azure Sphere CLI-kommandon stöder nu parametern --output
eller -o
för att ange formatet för CLI-utdata. Mer information finns i Kommandon som stöds.
Nya och uppdaterade kommandon och parametrar
Uppdateringar av kommandon:
Kommando | beskrivning |
---|---|
azsphere device network enable | Aktiverar ett nätverksgränssnitt på den anslutna enheten. |
azsphere device network disable | Inaktiverar ett nätverksgränssnitt på den anslutna enheten. |
Uppdateringar av parametrar:
Parameter | Description |
---|---|
azsphere device network show-diagnostics | Parametern --id ändras till --network . |
azsphere device network update-interface | Parametern --interface-name ändras till --interface . |
azsphere device certificate delete | Parametern --cert-id ändras till --certificate . |
azsphere device certificate show | Parametern --cert-id ändras till --certificate . |
azsphere tenant create | Parametern --force ändras till --force-additional . |
azsphere tenant create | Parametern är ny. Den --disable-confirm-prompt inaktiverar uppmaningen om användarbekräftelse. |
Kommentar
21.07 SDK-versionen tog felaktigt bort de tillbakadragna parametrarna som nämns här från Azure Sphere CLI helt och hållet. 21.07 Update 1 SDK återställer dessa tillbakadragna parametrar till CLI för bakåtkompatibilitet. Mer information finns i Viktiga ändringar (tillbakadragna funktioner) i Azure Sphere CLI.
Ny och reviderad dokumentation i 21.07-versionen
Artikel | Ändringar |
---|---|
Minnesanvändning i högnivåprogram | Uppdaterat ämne för att inkludera diskussion om spårning av heapminnesallokering. |
Använda Visual Studio Code med Secure Shell (SSH) på en fjärrvärd | Nytt ämne som beskriver hur du skapar och felsöker Azure Sphere-program på en fjärrvärd via Secure Shell. |
Autentiseringsmetoder med Azure Active Directory | Nytt avsnitt som ger en översikt över de autentiseringsmetoder som stöds. |
Få åtkomst till Offentligt API för Azure Sphere med AAD-hanterad identitet | Nytt ämne som ger en översikt och steg för att få åtkomst till Azure Sphere Public API med AAD-hanterad identitet. |
Få åtkomst till Offentligt API för Azure Sphere med AAD-programtjänstens huvudnamn | Nytt ämne som ger en översikt och steg för att få åtkomst till Azure Sphere Public API med AAD-tjänstens huvudnamn. |
Få åtkomst till Offentligt API för Azure Sphere med din AAD-användaridentitet | Nytt ämne som innehåller en översikt och steg för att få åtkomst till Azure Sphere Public API med AAD-användaridentitet. |
Kommandon som stöds | Listan över kommandon som stöder utdataformat har uppdaterats. |
apparat | Uppdateringar av kommandon och parameterbeskrivningar och exempel. |
klientorganisation | Uppdateringar av parameterbeskrivningar och exempel. |
roll | Uppdaterat ämne eftersom värdet för parametern --role inte är skiftlägeskänsligt. |
Nya och uppdaterade exempel och galleriobjekt
Versionen 21.07 innehåller en uppdaterad självstudie om minnesanvändning, uppdateringar av Azure IoT-exemplet och tre nya eller uppdaterade projekt i Azure Sphere-galleriet.
Självstudie om uppdaterad minnesanvändning
Självstudien MemoryUsage har uppdaterats för att demonstrera spårning av heapminnesallokering.
Azure IoT-exempel har uppdaterats
Vi har gjort några mindre förbättringar av Azure IoT-exemplet, inklusive att ändra avsökningshastigheten IoTHubDeviceClient_LL_DoWork
på till var 100:e minut i stället för var 1:e, enligt den här bästa metoden för IoT Hub-klienten. Vi rekommenderar att du antar den här ändringen i dina befintliga appar.
Nya eller uppdaterade galleriexempel
Följande nya eller uppdaterade exempel har lagts till i Azure Sphere-galleriet, en samling ej använda skript, verktyg och funktioner:
VS1053AudioStreaming visar hur du spelar upp ljud via en VS1053 codec-tavla.
WebHookPublicAPIServicePrincipal visar hur du använder tjänsthuvudnamnsbaserad autentisering för det offentliga API:et för Azure Sphere Security Service.
AzureSphereTenantDeviceTwinSync uppdaterades för att använda det nya offentliga API-stödet för Azure Sphere för att fråga operativsystemversionen för enheter.
Kända problem i 21.07-versionen
De nya uppdateringsstatusfälten visas inte i standardformatet för CLI-utdata
Cli-kommandona azsphere device list
, azsphere device show
och azsphere device update
exponerar endast de fyra nya uppdateringsrelaterade fälten när du använder JSON eller något annat utdataformat som stöds. De nya fälten visas inte när du använder standardtabellformatet. Du kan använda --query
argumentet för att ange de ytterligare fälten för utdata till en tabell, men enhets-ID:t kan trunkeras om tabellen är för bred. Vi rekommenderar att du minskar antalet kolumner i tabellen så att enhets-ID:t inte trunkeras. Exempel: azsphere device show --query '{DeviceId:deviceId, LastAvailableOSVersion:lastAvailableOSVersion, LastInstalledOSVersion:lastInstalledOSVersion, LastOSUpdateUTC:lastOSUpdateUTC, LastUpdateRequestUTC:lastUpdateRequestUTC}'
Buggar och vanliga sårbarheter har åtgärdats i 21.07-versionen
21.07-versionen innehåller uppdateringar för att undvika följande vanliga sårbarheter och exponeringar (CVE):
CVE-2021-26428
CVE-2021-26429
CVE-2021-26430
Om 21.06-kvalitetsversionen
21.06-versionen innehåller felkorrigeringar i Azure Sphere OS; den innehåller inte något uppdaterat SDK. Om dina enheter är anslutna till Internet kommer de att få det uppdaterade operativsystemet från molnet.
Ny och reviderad dokumentation i 21.06-versionen
Artikel | Ändringar |
---|---|
Hantera klientorganisationer | Effektiviserat innehåll om att skapa, hantera eller hitta Azure Sphere-klienter |
Felsöka moln- och distributionsproblem | Nya anteckningar i avsnittet Felsöka OS-uppdateringar och avsnittet Felsöka distributionsuppdateringar |
Logga in med Azure Sphere CLI | Nytt ämne som beskriver standardinloggningen med CLI och hur du loggar in med en webbläsare. |
Nya galleriexempel i 21.06-versionen
Tre nya exempel har lagts till i Azure Sphere-galleriet, en samling ej använda skript, verktyg och funktioner:
WiFiConfigurationviaNfc visar hur du konfigurerar WiFi-autentiseringsuppgifter från en telefon via NFC (Near-Field Communication).
TranslatorCognitiveServices visar hur du använder Azure Sphere för att kommunicera med en Azure Cognitive Service, i det här fallet för att översätta text.
Grove_16x2_RGB_LCD tillhandahåller drivrutinskod för en LCD RGB-skärm.