Delen via

Fabricageprocesvoorbereiding

Belangrijk

Dit is de Documentatie voor Azure Sphere (verouderd). Azure Sphere (verouderd) wordt op 27 september 2027 buiten gebruik gesteld en gebruikers moeten tegen deze tijd migreren naar Azure Sphere (geïntegreerd). Gebruik de versiekiezer boven de inhoudsweergave om de Documentatie van Azure Sphere (geïntegreerd) weer te geven.

Het productieproces omvat zowel taken op de fabrieksvloer als cloudconfiguratietaken. Voorbereiding is noodzakelijk om ervoor te zorgen dat deze taken zonder onderbreking kunnen worden voltooid.

De volgende voorbereidingsstappen helpen ervoor te zorgen dat uw productieproces soepel verloopt:

  • Apparatuur instellen en pc-software installeren
  • Toepassingen ontwikkelen voor functionele tests
  • Controleren of toepassingen en scripts werken
  • Voorbereiden op een update van het besturingssysteem
  • Id's en andere gegevens vastleggen
  • Door productie ondertekende installatiekopieën ophalen

Belangrijk

Voor sommige voorbereidingsstappen is de Azure Sphere CLI nodig. U hebt een pc met een internetverbinding en de Azure Sphere SDK nodig om deze stappen uit te voeren. Zie De Azure Sphere SDK voor Windows installeren of de Azure Sphere SDK voor Linux installeren voor instructies voor sdk-installatie.

Apparatuur instellen en pc-software installeren

Voor zowel taken op de fabrieksvloer als voor cloudconfiguratietaken is een pc vereist. Andere benodigde apparatuur is afhankelijk van welke set taken wordt uitgevoerd, zoals beschreven in deze sectie. Voor de meeste productietaken zijn ook enkele softwarehulpprogramma's vereist, die moeten worden geïnstalleerd op de pc die voor deze taken wordt gebruikt.

Apparatuur voor fabriekstaken

Voor de fabriekstaken zijn de volgende apparatuur vereist:

  • Een pc op fabrieksvloer. Elk Azure Sphere-apparaat moet zijn verbonden met een pc op de fabrieksvloer. Op deze pc moet Windows 11, Windows 10 Jubileumupdate (of hoger) of Linux (Ubuntu 24.04 LTS of Ubuntu 22.04 LTS) worden uitgevoerd.

    U kunt tegelijkertijd zoveel Azure Sphere-apparaten aansluiten op uw pc als het USB-subsysteem van de pc ondersteunt. De pc-softwarehulpprogramma's beperken niet het aantal apparaten dat tegelijk kan worden verbonden.

  • Een chip-naar-pc-interface. Deze interface is vereist voor de pc-softwarehulpprogramma's voor USB-UART-communicatie tussen de pc en het aangesloten apparaat.

    Pc-interface naar Azure Sphere

    U kiest hoe u deze interface implementeert:

    • Ontwerp een interfacebord dat tijdens de productie verbinding maakt met uw pc.

    • Ontwerp een interface die is ingebouwd in elk verbonden apparaat. Het MT3620 reference board design (RDB) bevat bijvoorbeeld een dergelijke interface.

    Zie de MCU-programmeer- en foutopsporingsinterface voor meer informatie over de ontwerpvereisten voor de interface van chip-naar-pc.

  • Een Wi-Fi-toegangspunt. Een apparaat moet verbinding kunnen maken met Wi-Fi om te controleren of uw klanttoepassing via Wi-Fi kan communiceren. De Wi-Fi-verbinding mag geen internettoegang hebben, omdat er een over-the-air-update kan optreden als de chip verbinding maakt met een toegangspunt met internet.

  • Externe testapparatuur (optioneel). Voor functionele tests kunt u de randapparatuur-UARTs op de MT3620 (ISU0, ISU1, ISU2 of ISU3) verbinden met externe testapparatuur via een geschikt circuit van uw eigen ontwerp. Als u een chip-naar-pc-interface op een apart bord hebt gemaakt, zoals beschreven in het tweede item met opsommingstekens, kunt u dit circuit toevoegen aan dat bord.

  • Testapparatuur voor radiofrequentie (RF). Deze apparatuur is alleen nodig als u RF-tests en kalibratie in uw fabriekstaken opneemt. Zie Apparatuur en software voor RF-testen en kalibratie voor meer informatie.

Apparatuur voor cloudconfiguratietaken

Voor de cloudconfiguratietaken zijn de volgende apparatuur vereist:

  • Een pc voor cloudconfiguratie. Azure Sphere-apparaten hoeven niet te worden verbonden met de cloudconfiguratie-pc. Op deze pc moet Windows 11, Windows 10 Jubileumupdate (of hoger) of Linux worden uitgevoerd.

  • Een internetverbinding. De pc die wordt gebruikt voor cloudconfiguratie moet zijn verbonden met internet.

Apparatuur en software voor RF-tests en kalibratie

De vereisten en het ontwerp van uw product bepalen of u RF-tests en kalibratie moet opnemen in uw fabrieksvloertaken. Als voor uw product Wi-Fi is vereist en een van de volgende onderdelen is opgenomen, moet u RF-tests en kalibratie uitvoeren voor elk apparaat:

  • Een chip-down ontwerp

  • Een module die nog niet rf-gecertificeerd is, neem contact op met uw leverancier als u vragen hebt.

De volgende apparatuur en pc-software zijn vereist voor RF-tests en kalibratie:

  • RF-testapparatuur. Deze apparatuur wordt gebruikt met het RF tools-pakket, dat wordt beschreven in het volgende item met opsommingstekens.

    Integratie tussen de RF-hulpprogramma's C, C# of Python en de testapparatuur is uw verantwoordelijkheid. Momenteel heeft Microsoft samengewerkt met LitePoint om een kant-en-klare oplossing te bieden die de Azure Sphere RF-testbibliotheek integreert met de LitePoint-apparatuur.

    RF testen met Litepoint

  • RF Tools-pakket. Deze pc-software bevat hulpprogramma's en C-, C#- en Python API-bibliotheken voor gebruik bij het testen en kalibreren van RF-bewerkingen. Met de API-bibliotheken kunt u aangepaste toepassingen maken voor RF-tests en kalibratie.

    Neem contact op met uw Microsoft-vertegenwoordiger om dit pakket te downloaden. Installeer het op uw pc op de fabrieksvloer. Als uw testhuis het hulpprogramma moet gebruiken om uw apparaat te certificeren, neemt u contact op met uw Microsoft-vertegenwoordiger voordat u de software met hen deelt.

Hulpprogramma's voor pc-software

Verschillende taken op de fabriek en cloudconfiguratietaken kunnen gebruikmaken van de volgende pc-softwarehulpprogramma's. Deze softwarehulpprogramma's moeten worden geïnstalleerd op de pc die voor deze taken wordt gebruikt.

  • Azure Sphere SDK. De SDK bevat de Azure Sphere CLI en andere hulpprogramma's voor het bouwen en beheren van toepassingen en implementaties. De CLI-opdrachten kunnen bewerkingen uitvoeren, zoals het laden van software op een gekoppeld apparaat, het claimen van een apparaat en het ophalen van details over een gekoppeld apparaat. De SDK is nodig voor zowel fabrieks- als cloudconfiguratietaken.

    Installeer de SDK voor Windows of voor Linux, afhankelijk van wat uw pc uitvoert.

  • Productievoorbeelden. De productievoorbeelden bieden ondersteuning voor zowel fabrieks- als cloudconfiguratietaken, en omvatten:

    • Python- en C#-clientbibliotheken voor de Device Rest API die directe pc-naar-apparaatcommunicatie implementeren voor geoptimaliseerde productiebewerkingen. Deze zijn ook beschikbaar via PyPI en NuGet.
    • Een set productiehulpprogramma's die Python-scripts zijn die verschillende fasen van de productie automatiseren, waaronder apparaatgereedheidscontroles, herstel van meerdere borden en multi-board OTA-configuratie.

  • RF Tools-pakket. Dit pakket is alleen nodig als u RF-tests en kalibratie in uw fabriekstaken opneemt. Zie Apparatuur en software voor RF-testen en kalibratie voor meer informatie.

Toepassingen ontwikkelen voor functionele tests

Functionele tests controleren of uw product correct werkt. De specifieke tests die u moet uitvoeren, zijn afhankelijk van uw afzonderlijke hardware. Functionele tests moeten worden opgenomen in de fabriekstaken.

U kunt uw tests organiseren als één toepassing of als een reeks toepassingen. Het overzicht van Azure Sphere-toepassingen, de Azure Sphere-voorbeelden en de sjablonen in de Azure Sphere SDK bieden informatie over het toepassingsontwerp. Welk ontwerp u ook kiest, uw functionele testtoepassingen moeten worden ondertekend door productie, zoals beschreven in de voorbereidingsstap Voor productieondertekende installatiekopieën ophalen en vervolgens geïmplementeerd als onderdeel van het fabrieksproces.

Voor het rapporteren van fouten, logboekgegevens of reekstests is voor sommige functionele tests communicatie vereist met de chip die wordt getest. Als u dergelijke communicatie wilt inschakelen, kunt u de randapparatuur-UARTs op mt3620 (ISU0, ISU1, ISU2 of ISU3) gebruiken. Verbind deze UARTs met uw fabrieksvloer pc of externe testapparatuur via een geschikt circuit van uw eigen ontwerp. Als u een interfacebord hebt gemaakt ter ondersteuning van chip-naar-pc-communicatie, kunt u dit circuit toevoegen aan dat bord.

Controleren of toepassingen en scripts werken

U moet uw voltooide producttoepassingen grondig testen, toepassingen testen en scripts testen. Opnieuw testen wordt aanbevolen wanneer u de Azure Sphere SDK, het Azure Sphere-besturingssysteem of uw software bijwerkt.

Volg deze richtlijnen:

  • Controleer of uw testtoepassingen en voltooide producttoepassingen kunnen worden geïnstalleerd, uitgevoerd en verwijderd.

  • Controleer of uw testscripts, testtoepassingen en voltooide producttoepassingen werken met de nieuwste versies van de Azure Sphere SDK en het Azure Sphere-besturingssysteem.

Voorbereiden op een update van het besturingssysteem

Een bijgewerkte Versie van het Azure Sphere-besturingssysteem moet mogelijk tijdens de productie worden geladen op apparaten wanneer een sideloaded toepassing updates bevat waarvoor besturingssysteemfuncties zijn vereist die alleen aanwezig zijn in een nieuwere versie van het besturingssysteem of wanneer Microsoft een besturingssysteem met beveiligingsupdates publiceert.

Ga als volgt te werk om een update van het Azure Sphere-besturingssysteem tijdens de productie voor te bereiden:

Id's en andere gegevens vastleggen

Voor productietaken moet u mogelijk een installatiekopieën, onderdelen, producten of apparaatgroep opgeven. Een record van de id's en namen die worden gebruikt om deze items te identificeren, moeten worden gemaakt en opgeslagen op de juiste pc's voor later gebruik tijdens taken op de fabrieksvloer en in de cloud. In deze sectie wordt uitgelegd hoe u de identificatiegegevens voor elk item kunt ophalen.

Afbeeldings-id en onderdeel-id

Elke toepassing heeft een onderdeel-id en een installatiekopieën-id. Noteer de installatiekopieën-id en onderdeel-id tijdens de voorbereidingstaak installatiekopieën ophalen die zijn ondertekend door de productie. De afbeeldings-id en onderdeel-id worden beide weergegeven in de uitvoer van de opdracht azsphere image add , die wordt gebruikt in die voorbereidingstaak.

Productnaam en apparaatgroep

Noteer de namen van producten en apparaatgroepen wanneer u ze maakt. Elk Azure Sphere-apparaat moet worden toegewezen aan een product en een apparaatgroep als onderdeel van de cloudconfiguratietaken.

Een fabrikant moet een product maken voor elk model van een aangesloten apparaat, zoals een vaatwasser of koffiemachine. Elk verbonden apparaat heeft één product, maar één product kan aan veel apparaten worden gekoppeld. Wanneer u een product maakt, worden standaardapparaatgroepen gemaakt binnen het product. U kunt de standaardapparaatgroepen gebruiken of uw eigen apparaatgroepen maken.

Als u een product wilt maken, gebruikt u de opdracht azsphere product create als volgt. Vervang <product-name> respectievelijk <product description> door een naam en beschrijving die geschikt zijn voor uw product.

azsphere product create --name <product-name> --description <product description>

Voor cloudconfiguratie kunt u de standaardapparaatgroep Productie gebruiken of uw eigen apparaatgroep maken. Als u uw eigen apparaatgroep wilt maken, gebruikt u de opdracht azsphere device-group create als volgt. Vervang door <device-group-name> een naam van uw keuze; vervang <product-name> door de naam van het product waarin u de apparaatgroep wilt maken.

azsphere device-group create --name <device-group-name> --product <product-name>

Door productie ondertekende installatiekopieën ophalen

Wanneer u een afbeelding uploadt naar de Azure Sphere-beveiligingsservice (AS3), wordt de afbeelding ondertekend, zodat deze kan worden gedistribueerd naar apparaten op een manier die wordt vertrouwd. Apparaten die in productie zijn geïmplementeerd, accepteren alleen door productie ondertekende installatiekopieën als onderdeel van de beveiligingsbelofte van Azure Sphere. Tijdens de productie wilt u mogelijk door productie ondertekende installatiekopieën laden op apparaten. Om de noodzaak van internetverbinding tijdens het fabrieksproces te voorkomen, maakt u de door de productie ondertekende installatiekopieën eenmaal, downloadt u ze van AS3 en slaat u ze vervolgens op een pc op de fabrieksvloer op voor sideloading tijdens de productie.

Toepassingen die alleen bedoeld zijn voor gebruik tijdens het fabrieksproces, moeten expliciet worden geïdentificeerd als tijdelijke installatiekopieën. Dit zorgt ervoor dat deze toepassingen aan het einde van het testproces kunnen worden verwijderd. Gebruik geen tijdelijke installatiekopieën voor toepassingen die na de vervaardiging op het apparaat blijven staan; anders werkt het over-the-air-updateproces niet correct.

De stappen voor het ophalen van een door productie ondertekende installatiekopieën zijn als volgt:

  1. Upload de afbeelding naar de AS3. Gebruik de opdracht azsphere image add als volgt, waarbij <path-to-image-package> u het pad en de naam vervangt van het installatiekopieënpakket dat uw software bevat. Voeg de parameter toe om de --temporary afbeelding als tijdelijk te markeren, anders laat u deze weg.

    azsphere image add --image <path-to-image-package> --temporary

  2. Sla de installatiekopieën-id en de onderdeel-id op die door de opdracht azsphere image add worden weergegeven in de uitvoer in stap 1. U hebt deze later nodig voor sommige taken op de fabrieksvloer en voor cloudconfiguratietaken. De afbeeldings-id is ook nodig in de volgende stap.

  3. Download de door de productie ondertekende installatiekopieën. Gebruik de opdracht azsphere image download , waarbij u vervangt door de id van de installatiekopieën <image-id> die u wilt downloaden en <file-path> door het pad en de bestandsnaam waarin u de gedownloade afbeelding wilt opslaan.

    azsphere image download --image <image-id> --destination <file-path>

Belangrijk

Als een apparaat kan worden geclaimd in een andere tenant dan het apparaat dat tijdens de stappen wordt gebruikt om een door de productie ondertekende installatiekopieën op te halen, moet u de exacte oorspronkelijke (voordat u uploadt) afbeeldingsbestanden behouden zodat u ze kunt uploaden naar de werkelijke tenant waarnaar een apparaat wordt geclaimd. Deze vereiste wordt uitgebreid beschreven in cloudconfiguratietaken.

Een bijgewerkt vertrouwd sleutelarchief ophalen

In sommige gevallen hebt u mogelijk een nieuwere door productie ondertekende installatiekopieën die u moet toepassen op een ouder besturingssysteem. Dit kan gebeuren als u bijvoorbeeld de installatiekopieën van uw toepassing bijwerkt om een fout op te lossen.

Dit kan echter een probleem veroorzaken. Het besturingssysteem bevat een 'vertrouwde sleutelarchief' die ervoor zorgt dat deze een set sleutels vertrouwt die worden gebruikt bij het ondertekenen van door productie ondertekende installatiekopieën. Als uw door de productie ondertekende installatiekopieën nieuwer zijn dan het besturingssysteem en als as3 ondertussen de ondertekeningssleutel van de installatiekopieën heeft bijgewerkt, vertrouwt het besturingssysteem mogelijk niet de sleutel die wordt gebruikt om uw installatiekopieën te ondertekenen. U kunt bepalen of dit probleem van invloed is op een bepaalde combinatie van door het besturingssysteem en productie ondertekende installatiekopieën door de taken op de fabrieksvloer te volgen.

Het probleem kan worden opgelost door het besturingssysteem dat in productie wordt gebruikt bij te werken, raadpleegt u Voorbereiden voor een update van het besturingssysteem. Als u echter om een of andere reden het besturingssysteem niet wilt bijwerken, kunt u in plaats daarvan het oudere besturingssysteem gebruiken en alleen het vertrouwde sleutelarchief bijwerken.

Hiervoor accepteert u de licentievoorwaarden en downloadt u vervolgens de herstelinstallatiekopieën en haalt u uit dit zip-bestand alleen het bestand 'trusted-keystore.bin'. In de taken op de fabrieksvloer wordt beschreven hoe u dit 'trusted-keystore.bin'-bestand gebruikt om alleen het vertrouwde sleutelarchief bij te werken.