Delen via

RF-hulpprogramma's

  • Artikel

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.

Met de rf-hulpprogramma's (Radio Frequency) kunt u de radio op laag niveau beheren, zoals vereist tijdens de ontwerpverificatie en de productie van hardware op basis van Azure Sphere. De hulpprogramma's omvatten interactieve toepassingen voor beheer en weergave van de RF-instellingen.

Als u een board of module ontwerpt die een MT3620-chip bevat, moet u de radio testen en kalibreren voordat u het bord of de module verzendt. Als u een verbonden apparaat maakt dat een bord of module van een andere leverancier bevat, moet de leverancier al RF-tests hebben uitgevoerd; neem contact op met uw leverancier als u vragen hebt.

De productie van verbonden apparaten bevat informatie over hoe RF-tests in de productiewerkstroom passen.

Belangrijk

Voor de RF-hulpprogramma's is de mogelijkheid rf-testmodus inschakelen vereist. Deze mogelijkheid is standaard aanwezig op borden met de status Leeg, maar is niet beschikbaar in de status Module1Complete of DeviceComplete .

Gebruik de opdracht azsphere device capability show-attached om te bepalen of deze mogelijkheid aanwezig is op uw apparaat. Als u de RF-hulpprogramma's wilt uitvoeren op een apparaat dat deze mogelijkheid niet heeft, volgt u de instructies in Rf-hulpprogramma's aanvragen om contact op te nemen met Microsoft voor hulp.

De RF-hulpprogramma's gebruiken alleen de Service UART-poort die moet worden aangesloten op een USB-poort op uw pc. De RF-hulpprogramma's vereisen dat de UART beschikbaar wordt gesteld door de Future Technology Devices International (FTDI) FT4232HQ UART-naar-USB-interfacechip. Zie de MCU-programmeer- en foutopsporingsinterface voor meer informatie over de Service UART-poort.

De RF-hulpprogramma's aanvragen

Microsoft levert het RF Tools-pakket op verzoek aan klanten, partners en beveiligingsonderzoekers. U kunt deze aanvragen bij uw technische verkoopprofessional (TSP). Als u geen TSP hebt, stuurt u een e-mail naar azspheremfrsamplesup@microsoft.com met de volgende informatie:

  • Uw naam, organisatie en contactgegevens.

  • Contactgegevens voor uw Microsoft-accountteam of TSP, als u er een hebt.

  • Als u een module bouwt (in plaats van een apparaat dat rechtstreeks MT3620-chips gebruikt), is uw reden voor het vereisen van de RF-hulpprogramma's.

  • De soorten tests die u wilt uitvoeren met behulp van de hulpprogramma's.

  • Verwachte tijdlijn voor productie (wanneer moeten apparaten worden vervaardigd/gecertificeerd).

Een Microsoft-vertegenwoordiger werkt samen met u om het juiste distributiekanaal te bepalen.

Instellingen en installatie

Voordat u de RF-hulpprogramma's kunt uitvoeren, moet u uw pc en uw MT3620-apparaat instellen met de nieuwste software en de hulpprogramma's uitpakken, zoals beschreven in de volgende secties.

Pc-installatie

Stel uw pc in met de huidige Azure Sphere SDK.

MT3620-apparaat instellen

Nadat u uw pc hebt ingesteld, controleert u of het MT3620-apparaat het meest recente Azure Sphere-besturingssysteem uitvoert. Volg de instructies in de releaseopmerkingen voor de huidige release.

INSTALLATIE van RF-hulpprogramma

Pak het RF Tools-pakket uit in een map op uw pc. De resulterende map bevat vier submappen:

  • Configuraties, die bestanden bevatten om de configuratie-instellingen voor radio's te vergemakkelijken

  • Bibliotheken, die de C-, C#- en Python-bibliotheken bevatten voor het uitvoeren van RF-tests

  • rftest-server, die het rftest-server.imagepackage bevat dat wordt gebruikt door vooraf gebouwde hulpprogramma's of toepassingen die u bouwt met behulp van de RF Tools-bibliotheken.

  • Hulpprogramma's, die vooraf gedefinieerde toepassingen (MacAddressTool, RfToolCli, RfSettingsTool, WiFiRegionUpdater) voor Windows x86, x64 en Linux (x64) en Python -mappen (MacAddressTool, RfSettingsTool) bevatten.

MT3620 RF-configuratie en kalibratie

De MT3620 slaat radioconfiguratie- en kalibratiegegevens op in e-fuses, die een beperkt aantal keren kunnen worden geprogrammeerd. Deze gegevens omvatten de radiobanden (zoals 2,4GHz of 5GHz) die de chip moet ondersteunen, aanpassingen aan het verzenden van stroom en de antenneconfiguratie op het apparaat. Zie voor gedetailleerde informatie over de configuratie van e-fuse de MT3620 N9 E-fuse-inhoudsrichtlijnen, die beschikbaar zijn via MediaTek.

Antennediversiteit

Radiosignalen stuiteren uit objecten in de omgeving. Als gevolg hiervan neemt één radiosignaal meerdere paden van zender naar ontvanger. Omdat deze radiosignalen op verschillende afstanden reizen, komen ze op verschillende tijdstippen bij de ontvanger aan. Af en toe verstoren de aankomende signalen destructief en ziet de antenne geen signaal. Een manier om dit probleem op te lossen is door antennediversiteit. Om de diversiteit van antennes te bieden, wordt een tweede antenne met een andere oriëntatie geplaatst op korte afstand (ten minste een kwart golflengte) weg van de eerste.

De MT3620 ondersteunt twee configuraties voor antennediversiteit, die zijn geconfigureerd met behulp van radio-e-fuses. In de afbeelding ziet u de twee configuraties.

antennediversiteit

De configuratie aan de linkerkant toont de ontvangstdiversiteit (RX-diversiteit). In deze configuratie wordt een tweede antenne aangesloten op de hulpantennepoort. Als het ontvangen signaalniveau op de hoofdantennepoort onder een bepaalde drempelwaarde daalt, schakelt de MT3620 automatisch over naar de tweede antenne bij het ontvangen van gegevens. In deze configuratie moeten transmissies nog steeds gebruikmaken van de primaire antenne.

De configuratie aan de rechterkant toont zend- en ontvangstdiversiteit (TX- en RX-diversiteit), gebruikt de secundaire antenne om zowel te verzenden als ontvangen. De MT3620 bereikt dit door gebruik te maken van een externe dubbelpool, double-throw (DPDT) schakelaar, waardoor het signaal naar beide antennes kan worden gerouteerd. In de configuratie van de zend- en ontvangstdiversiteit wordt de hulpantennepoort niet gebruikt. De MT3620 heeft twee speciale antenneselectiepins voor het bedienen van deze externe switch.

Bufferlocaties

Tijdens rf-tests kan de MT3620 waarden in vluchtig geheugen gebruiken in plaats van de permanente e-fuses, zodat testoperators en apparatuur deze instellingen kunnen aanpassen zonder de e-zekeringen permanent te wijzigen. Het vluchtige geheugen dat wordt gebruikt om deze instellingen op te slaan, wordt de 'bufferbak' genoemd. Nadat de testoperator of apparatuur zeker weet dat de waarden in de bufferbak juist zijn, kan de status van de bufferbak permanent naar e-fuses worden geschreven.

Wanneer u de RF-testmodus invoert, is het mogelijk om de inhoud van de bufferlocatie in te stellen op bekende, vooraf ingestelde waarden door een 'standaardbuffer bin'-bestand te laden. De testoperator of apparatuur kan vervolgens indien nodig aanvullende configuratie- of kalibratiewaarden instellen.

Het RF Tools-pakket biedt verschillende standaard buffer bin-bestanden in de map Configurations\MT3620. Deze bestanden kunnen worden gebruikt om het apparaat te initialiseren naar een vooraf geconfigureerde status of om kalibratie-instellingen te overschrijven die eerder zijn geprogrammeerd in de permanente e-fuses op het apparaat onder test (DUT).

De volgende bufferbakbestanden ondersteunen transmissie met de hoofdantenne:

  • MT3620_eFuse_N9_V5_20180321_24G_5G_NoDpdt.bin stelt de radio in voor de ondersteuning van zowel 2,4GHz als 5GHz.

  • MT3620_eFuse_N9_V5_20180321_24G_Only_NoDpdt.bin stelt de radio alleen in ter ondersteuning van 2,4 GHz.

De volgende bufferbakbestanden ondersteunen het verzenden met een hulpantenne:

  • MT3620_eFuse_N9_V5_20180321_24G_5G_Dpdt.bin ondersteunt de werking van 2,4 GHz en 5GHz met de DPDT-switch.

  • MT3620_eFuse_N9_V5_20180321_24G_Only_Dpdt.bin ondersteunt 2,4GHz-bewerking met de DPDT-switch.

Standaardbufferopslagbestanden kunnen verder worden aangepast aan uw specifieke apparaattoepassing. Neem contact op met MediaTek of Microsoft voor andere aanpassingsopties.

Na voltooiing van RF Tools-gebruik

Nadat de RF-tests en kalibratie op een vervaardigd apparaat zijn voltooid, moet de rftest_server.imagepackage van het apparaat worden verwijderd en moet de productiestatus van het apparaat worden ingesteld om verdere wijzigingen in RF-instellingen te voorkomen.

Verwijderen van rftest_server.imagepackage

Nadat u de RF-hulpprogramma's hebt gebruikt, kan er een pakket met de naam rftest_server.imagepackage op het apparaat worden achtergelaten. Met dit besturingssysteempakket hebt u toegang via de FTDI-interface tot de RF-configuratie op laag niveau. Dit pakket wordt automatisch verwijderd door AS3 wanneer het apparaat vervolgens verbinding maakt met AS3. Fabrikanten die de RF Tools gebruiken, moeten dit pakket echter verwijderen wanneer RF-tests zijn voltooid.

Het pakket verwijderen:

  1. Voer de opdracht azsphere device image als volgt uit:

    azsphere device image list-installed --full

  2. Controleer of er een onderdeel met de naam rftest_server is geïnstalleerd. Zo ja, voer dan de opdracht azsphere device sideload uit, gevolgd door de opdracht azsphere device image als volgt:

    azsphere device sideload delete -component-id 508eddf2-b8c3-4a99-93d9-a045d9a060eb

    Het apparaat wordt opnieuw opgestart na het uitvoeren van deze opdracht.

    azsphere device image list-installed --full

    U ziet dat het rftest_server imagepackage niet meer aanwezig is na het uitvoeren van deze opdracht.

Notitie

Als u RfTools op Linux uitvoert, moet u mogelijk uitvoeringsmachtigingen instellen voor de RfTool-programma's In de map Tools/Prebuilt/Linux-x64, voert u deze opdracht uit om machtigingen in te stellen voor RfToolCli.

chmod +x RfToolCli

Verdere rf-instellingen wijzigen voorkomen

Als u verdere rf-instellingen wilt voorkomen, moet u de productiestatus van het apparaat instellen als Module1Complete.

Houd er rekening mee dat als het apparaat onmiddellijk overstapt op het laden van de toepassing (bijvoorbeeld een chip down-ontwerp waarbij RF-tests en het laden van apparaatsoftware op één productielijn worden uitgevoerd), kan deze stap worden overgeslagen. Aan het einde van het laad- en testproces van de toepassing wordt het apparaat verplaatst naar de status DeviceComplete , waardoor rf-instellingen ook worden gewijzigd.

RfToolCli

RfToolCli is een interactief opdrachtregelprogramma waarmee de MT3620-radio op laag niveau kan worden gecontroleerd voor test- en diagnostische doeleinden. Voordat u dit hulpprogramma uitvoert, moet u ervoor zorgen dat het apparaat onder test (DUT) is verbonden en het nieuwste Azure Sphere-besturingssysteem uitvoert.

Als u het hulpprogramma wilt gebruiken, opent u een opdrachtprompt/terminalvenster, gaat u naar de map met de RfToolCli-toepassing en voert u RfToolCli uit. RfToolCli heeft de volgende opstartopties:

RfToolCli [-BufferBin <filename>] [-Image <filename>] [-Device <IP address of device to use [Default: 192.168.35.2]>]

Met de optie -BufferBin wordt het pad doorgegeven aan een aangepast standaardconfiguratiebestand voor bufferopslag. RfToolCli maakt standaard gebruik van radio-instellingen die op het apparaat zijn geprogrammeerd. Deze instellingen omvatten eventuele aanpassingen van de transmissiekracht, toegestane frequentiebanden en antenneconfiguraties. Als u een alternatief instellingenbestand wilt gebruiken, geeft u het pad naar het bestand op met de optie -BufferBin.

Met de optie -Image wordt het pad doorgegeven aan het bestand rftest-server.imagepackage. Dit installatiekopieënpakketbestand moet worden geladen op de DUT om het apparaat in de RF-testmodus te plaatsen. De rftest-server wordt geleverd in dezelfde map als het RfToolCli-programma en in de meeste gevallen kan RfToolCli dit bestand vinden. Als u RfToolCli vanaf een andere locatie uitvoert, moet u mogelijk de optie -Image gebruiken om het pad naar dit bestand door te geven.

Bij het opstarten bereidt RfToolCli het apparaat voor en wordt vervolgens een interactieve prompt weergegeven:

RfToolCli
Preparing DUT...
>

RFToolCli biedt de opdrachten die worden vermeld in de volgende tabel.

Opdrachtopties (afkorting) Beschrijving
antenne {aux | main} Selecteert de hulp- of hoofdantenne.
kanaalnummer Selecteert een kanaal.
config read
{macaddress | data}		 Hiermee haalt u MAC-adres- en bufferopslaggegevens van het apparaat op.
configuratie schrijven
{macaddress | data}		 Hiermee stelt u mac-adres- en bufferopslaggegevens van het apparaat in.
configuratie opslaan Wijzigingen in MAC-adres- of bufferopslaggegevens worden opgeslagen in permanente e-fuses.
uitgang Sluit het programma af.
Help-opdrachtnaam Geeft help weer voor een opdracht.
ontvangen (rx)
{start | stop | stats}		 Begint of stopt met ontvangen of geeft statistieken weer over ontvangen pakketten.
Instellingen Hiermee worden de huidige radio-instellingen weergegeven.
showchannel (sc) Geeft een lijst weer van de kanalen die door het apparaat worden ondersteund.
verzenden (tx) {frame | modus | vermogen | snelheid | start} Hiermee configureert en verzendt u pakketten.
De opties voor frame, modus, vermogen en frequentie configureren de pakketten; elk heeft parameters waarmee de relevante configuratie-instelling wordt gedefinieerd.
De startoptie start de overdracht.

U kunt hulp krijgen voor elke opdracht door help te typen, gevolgd door de opdrachtnaam en, indien van toepassing, een optie. Voorbeeld:

help transmit frame
Usage:
Transmit Frame [-BSS <Str>] [-Destination <Str>] [-Duration
<UInt16>]
[-FrameControl <UInt16>] [-Source <Str>]
Configure transmit frame header
Optional Parameters:
-BSS <Str> - BSS MAC address (in colon-delimited format)
-Destination <Str> - Destination MAC address (in colon-delimited
format)
-Duration <UInt16> - Frame duration [Alias: -D]
-FrameControl <UInt16> - Frame Control Number [Alias: -F]
-Source <Str> - Source MAC address (in colon-delimited format)

Voorbeeld: Opstartinstellingen weergeven

Bij het opstarten stelt RfToolCli verschillende standaardwaarden in, waaronder verzendmodi, gegevenssnelheid en kanaal. Gebruik de opdracht Instellingen om deze opstartinstellingen weer te geven.

 > settings
 ------Radio------

 Mode: Normal
 Power: 16.0
 Channel: 1
 Rate: Ofdm54M

---TX Frame Header---

Frame Control: 8000
Duration: 2000
BSS MAC: 62:45:8D:72:06:18
Source MAC: AC:AC:AC:AC:AC:AC
Destination MAC: 62:45:8D:72:06:18

---TX Frame Data---

Frame Size: 1000
Use Random Data: True

Voorbeeld: Kanaal instellen en ontvangen pakketstatistieken ophalen

Deze opdrachtreeks plaatst de radio in de ontvangstmodus op het opgegeven 802.11-kanaal en haalt vervolgens statistieken op over de ontvangen pakketten:

> channel 9
Setting channel to 9
> rx start
Starting receive
> rx stats
Total packets received: 2578
Data packets received: 4
Unicast packets received: 0
Other packets received: 4
>

Voorbeeld: Pakketten verzenden op huidig kanaal

Deze opdracht zorgt ervoor dat de radio pakketten verzendt op het huidige kanaal:

> transmit start
Starting transmit
Press any key to stop transmission

Voorbeeld: Pakketten verzenden in continue modus op huidig kanaal

Deze opdracht zorgt ervoor dat de radio pakketten verzendt op het huidige kanaal in continue modus totdat u de overdracht stopt of een andere modus instelt:

> tx mode continuous
> tx start
Starting transmit
Press any key to stop transmission

Wanneer het apparaat in continue modus verzendt, is er geen tussenruimte tussen pakketten, wat handig is voor energiemetingen.

Voorbeeld: Een doorlopende toon verzenden op het huidige kanaal

Deze opdrachtreeks zorgt ervoor dat de radio een toon op het huidige kanaal verzendt totdat u op een toets drukt.

> tx mode continuouswave
> tx start
Starting transmit
Press any key to stop transmission

Voorbeeld: Het momenteel geconfigureerde MAC-adres van het apparaat ophalen

Met deze opdracht wordt het momenteel geconfigureerde MAC-adres op het apparaat gelezen.

> config read MacAddress
Device MAC address: 4E:FB:C4:1C:4F:0C

Voorbeeld: het MAC-adres van het apparaat instellen

Met deze opdracht wordt een nieuw MAC-adres naar de bufferlocatie van het apparaat geschreven. Als er al een MAC-adres is ingesteld voor het apparaat, wordt u gevraagd de wijziging te bevestigen.

> config write MacAddress 02:12:ab:cd:ef:11
Device already has MAC address 4E:FB:C4:1C:4F:0C
Are you sure you want to modify this? (y/N):y

Notitie

Gebruik de opdracht voor het opslaan van configuratie om buffercontainers of MAC-adressen permanent te wijzigen.

Voorbeeld: Één byte van configuratiegegevens instellen

De opdracht voor het schrijven van gegevens voor configuratie kan worden gebruikt om één byte met gegevens in te stellen op het opgegeven bin-adres van de buffer.

> config write data 0x34 0xDD

Voorbeeld: Apparaatconfiguratiegegevens weergeven

Met de configuratie van de opdracht Gegevens lezen wordt de volledige inhoud van de opslaglocatie van de apparaatbuffer uitgevoerd.

> config read data
Current configuration data:
0x0000: 20 36 04 00 B2 EE D2 16 E5 73 00 00 00 00 00 00
0x0010: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x0020: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x0030: 00 00 00 00 00 00 00 00 FF FF 20 00 60 00 CC 00
...

Voorbeeld: Configuratiegegevens opslaan in e-fuses

De opdracht voor het opslaan van configuratie schrijft permanent wijzigingen in de bufferopslaglocatie naar de niet-vluchtige e-fuses. De e-fuses kunnen slechts een beperkt aantal keren worden geschreven, dus we raden u ten zeerste aan eerst alle wijzigingen in de bufferbak uit te voeren en deze wijzigingen vervolgens in één stap naar e-fuses te schrijven.

> config save
About to commit data to non-volatile storage
Changes will be permanent. Continue? (y/N):y
Done

Hulpprogramma voor RF-instellingen

Het hulpprogramma RF-instellingen geeft MT3620 e-fuse-instellingen weer, zodat u kunt controleren of ze correct zijn ingesteld. In tegenstelling tot RfToolCli is het hulpprogramma RF-instellingen alleen-lezen. Daarom kan het worden gebruikt om apparaatinstellingen te controleren, zelfs nadat de functionaliteit voor radiotests op een bepaald apparaat is uitgeschakeld.

Als u het hulpprogramma wilt gebruiken, opent u een opdrachtprompt/terminalvenster, gaat u naar hulpprogramma's/vooraf samengesteld/<Win-x86 | Win-x64 | Linux-x64-map> en voer RfSettingsTool uit. Het hulpprogramma heeft twee opdrachten en heeft twee opstartopties:

RfSettingsTool <command> [--image <filename>] [--usefile <filename>] [-Device <IP address of device to use [Default: 192.168.35.2]>]

De volgende opdrachten worden ondersteund:

Opdracht (afkorting) Beschrijving
controle (c) Valideert mt3620-apparaatconfiguratiegegevens
help (?) Geeft help-informatie weer
weergeven (s) Toont MT3620-configuratiegegevens.

Controleopdracht RfSettingsTool

De controleopdracht RfSettingsTool leest de configuratie van het gekoppelde apparaat en vergelijkt deze met een buffer bin-configuratiebestand dat de verwachte instellingen bevat. De controleopdracht heeft de volgende indeling:

RfSettingsTool check --expected <filename> [--image <filename>] [--nomacaddress] [--showconfig] [--usefile <filename>] [--verbose]
Parameters (afkorting) Beschrijving
--verwachte bestandsnaam (-e) Pad naar het buffer bin-bestand met de verwachte e-fuse-instellingen waarop moet worden gecontroleerd. Vereist.
--image bestandsnaam (-i) Pad naar RF-testafbeelding. Als u dit weglaat, wordt standaard rftest-server.imagepackage gebruikt. Optioneel.
--nomacaddress (-n) Geeft aan dat er geen MAC-adres moet worden ingesteld op het apparaat. Optioneel.
--showconfig (-s) Geeft de apparaatconfiguratie weer na controle. Optioneel.
--usefile bestandsnaam (-u) Leest configuratiegegevens uit het opgegeven bestand in plaats van het gekoppelde apparaat. Optioneel.
--uitgebreide (-v) Geeft extra uitvoergegevens weer.

Met de volgende opdracht wordt bijvoorbeeld gecontroleerd of de keuzerondjes overeenkomen met die in het opgegeven buffer bin-bestand:

> RfSettingsTool check --expected ..\Configurations\MT3620\
MT3620_eFuse_N9_V5_20180321_24G_5G_DPDT.bin

Als reactie op deze opdracht controleert RfSettingsTool de volgende items. Alle waarden moeten waar zijn om de opdracht te laten slagen:

  • Regiocode is identiek aan de verwachte instelling

  • Externe antenneschakelaar aanwezig identiek aan verwachte instelling

  • Antenneconfiguratie identiek aan verwachte instelling

  • Doelstroom identiek aan verwachte instelling

  • Operationele banden die identiek zijn aan de verwachte instelling

  • MAC-adres is ingesteld

Verschuivingen van radiovermogen, die apparaatspecifiek zijn, worden niet gecontroleerd.

Opdracht RfSettingsTool weergeven

De opdracht RfSettingsTool toont de radio-instellingen die zijn ingesteld op de MT3620 e-fuses op een door mensen leesbare manier. De weergegeven velden zijn de door de gebruiker configureerbare radio-instellingen. De controleopdracht heeft de volgende indeling:

RfSettingsTool show [--hexdump] [--image <filename>] [--usefile <filename>] [--verbose]
Parameters (afkorting) Beschrijving
--hexdump (-x) Toont de onbewerkte hexadecimale inhoud van e-fuses. Optioneel.
--image bestandsnaam (-i) Pad naar RF-testafbeelding. Als u dit weglaat, wordt standaard rftest-server.imagepackage gebruikt. Optioneel.
--usefile bestandsnaam (-u) Leest configuratiegegevens uit het opgegeven bestand in plaats van het gekoppelde apparaat. Optioneel.
--uitgebreide (-v) Geeft extra uitvoergegevens weer.

In het volgende voorbeeld ziet u gedeeltelijke uitvoer van de opdracht Show :

> RfSettingsTool show
Reading configuration data from device.
--------------------------------------------------------------------------------
MAC Address : C6:76:EC:79:1D:6B
--------------------------------------------------------------------------------
Region : GB
--------------------------------------------------------------------------------
External RF switch : Present
2.4GHz Diversity : MainOnly
5GHz Diversity : MainOnly
.
.
.

RF-test C-bibliotheek

Het RF Tools-pakket bevat een C-bibliotheek die u kunt gebruiken om uw eigen testprogramma's te ontwikkelen. De C-bibliotheek bevindt zich in de map bibliotheken\C. Headerbestanden voor de C-API zijn beschikbaar in de bibliotheken\C\Include folder, en binaire bestanden die vereist zijn voor het gebruik van de bibliotheek zijn beschikbaar in de bibliotheken\C\Bin map. Als u de bibliotheek wilt gebruiken, neemt u contact op met Microsoft voor documentatie.

De rf-testserverinstallatiekopieën (rftest-server.imagepackage) zijn ook beschikbaar in de map Bin. Deze afbeelding moet worden geladen op het apparaat dat wordt getest voordat het apparaat de RF-testmodus kan inschakelen. De functie mt3620rf_load_rf_test_server_image() in de C-bibliotheek laadt het installatiekopieënpakket programmatisch.

Als u een toepassing die gebruikmaakt van de C-bibliotheek opnieuw distribueren, moet u de DLL-bestanden uit bibliotheken\C\Bin en het rftest-server.imagepackage-bestand opnemen.

Compatibiliteit van RF-hulpprogramma's in verschillende versies van het besturingssysteem

Er is geen garantie dat RF-hulpprogramma's voor één besturingssysteemrelease compatibel zijn in alle besturingssysteemversies. Over het algemeen raden we u aan de versie van de hulpprogramma's (en de bijbehorende C-bibliotheek) te gebruiken die is uitgegeven met het productiepakket voor het besturingssysteem dat wordt uitgevoerd op het apparaat dat wordt getest.

De volgende tabel bevat een overzicht van de compatibiliteit van hulpprogrammareleases met Azure Sphere-besturingssysteemreleases.

RF Tools Release Release van besturingssysteem
23.05 22.02 en hoger
21.01 21.01 en hoger
20.10 20.07 of 20.10
20.07 20.07
20.04 20.04 of 20.01
20.01 20.04 of 20.01

Belangrijk

Mogelijk moet u het besturingssysteem van uw apparaat bijwerken of een bijgewerkte trusted-keystore.bin implementeren om de 23.05-versie van RF Tools te kunnen gebruiken. Meer informatie vindt u hier.

Bekijk wat er nieuw is in Azure Sphere voor meer informatie over eventuele aanvullende wijzigingen in de huidige release.

Errata

De volgende errata is van toepassing op alle versies van de RF-hulpprogramma's op MT3620-hardware. Aanvullende releasespecifieke problemen worden vermeld in het README-bestand dat deel uitmaakt van het hulpprogrammapakket.

  • De MT3620 Wi-Fi-firmware heeft een kleine fout:

    Als u overschakelt naar continue transmissie (tx-modus continu) en de transmissie (tx start) direct na het stoppen van een normale modus transmissie, zal er geen signaaluitgang zijn.

    Om dit te omzeilen, stopt u de transmissie van de continue modus en start het opnieuw voordat de transmissie begint. Hierna werkt continue-modustransmissie correct.

    Het probleem treedt niet op wanneer u overschakelt van continue modus naar de normale modus.

  • Bij het overschakelen van de continue golftransmissiemodus naar de normale of continue transmissiemodi, neemt het vermogen ten onrechte toe met +6 dB. U moet de radio opnieuw initialiseren om het energieniveau weer normaal te geven.

    • Als u het interactieve hulpmiddel RfToolCli gebruikt, initialiseert u de radio opnieuw door het hulpprogramma af te sluiten en vervolgens opnieuw op te starten.
    • Als u de C-, C#- of Python-bibliotheken gebruikt, roept u de functie mt3620_reinitialize_buffer_bin() aan. Dit zal ook de radio opnieuw initialiseren en kan worden gebruikt om dit probleem te omzeilen.