RF-ToolsRF tools

Die Tools für Hochfrequenztests (HF-Testtools) ermöglichen die Steuerung der Funkeinheit auf niedriger Ebene, wie es während der Entwurfsüberprüfung und Herstellung von Azure Sphere-basierter Hardware erforderlich ist.The Radio Frequency (RF) tools enable low-level control of the radio, as required during design verification and manufacturing of hardware based on Azure Sphere. Diese Tools umfassen interaktive Anwendungen für die Steuerung und Anzeige der Einstellungen für Hochfrequenz (HF). The tools include interactive applications for control and display of the RF settings.

Beim Entwerfen eines Boards oder Moduls mit einem MT3620-Chip müssen Sie die Funkeinheit testen und kalibrieren, bevor Sie das Board oder Modul ausliefern.If you are designing a board or module that incorporates an MT3620 chip, you must test and calibrate the radio before you ship the board or module. Wenn Sie ein verbundenes Gerät herstellen, das ein Board oder Modul eines anderen Anbieters enthält, sollte der Anbieter bereits einen HF-Test durchgeführt haben. Wenden Sie sich bei Fragen an Ihren Anbieter.If you are manufacturing a connected device that includes a board or module from another supplier, the supplier should already have performed RF testing; check with your supplier if you have any questions.

Informationen dazu, wie sich HF-Tests in den Herstellungsablauf einfügen, finden Sie unter Manufacturing connected devices (Herstellen von verbundenen Geräten).Manufacturing connected devices includes information on how RF testing fits into the manufacturing workflow.

Wichtig

Die RF-Tools erfordern die Funktion "RF-Testmodus aktivieren".The RF tools require the 'Enable RF test mode’ capability. Diese Funktion ist standardmäßig auf Boards verfügbar, die sich im leeren Fertigungszustandbefinden, aber nicht im Module1Complete -oder devicecomplete -Zustand sind.This capability is present by default on boards that are in the Blank manufacturing state, but is not available in the Module1Complete or DeviceComplete state.

Verwenden Sie den Befehl azsphere Device Capability Show-Attached , um zu bestimmen, ob diese Funktion auf Ihrem Gerät vorhanden ist.Use the azsphere device capability show-attached command to determine whether this capability is present on your device. Wenn Sie die RF-Tools auf einem Gerät ausführen müssen, das nicht über diese Funktion verfügt, befolgen Sie die Anweisungen unter anfordern der RF-Tools , um sich an Microsoft zu wenden.If you need to run the RF tools on a device that does not have this capability, please follow the instructions in Request the RF tools to contact Microsoft for assistance.

Anfordern der RF-ToolsRequest the RF tools

Microsoft stellt das RF-Tools-Paket nach Anforderung an Kunden, Partner und Sicherheitsexperten bereit.Microsoft supplies the RF Tools package upon request to customers, partners, and security researchers. Sie können Sie von Ihrem Technical Sales Professional (TSP) anfordern.You can request them from your technical sales professional (TSP). Wenn Sie nicht über einen TSP verfügen, senden Sie eine e-Mail azcommunity@microsoft.com mit den folgenden Informationen an:If you don't have a TSP, please send an email to azcommunity@microsoft.com with the following information:

  • Name, Organisation und Kontaktinformationen.Your name, organization, and contact information.

  • Wenden Sie sich ggf. an die Kontaktinformationen Ihres Microsoft-Konto Teams oder TSP.Contact information for your Microsoft account team or TSP, if you have one.

  • Wenn Sie ein Modul (anstatt ein Gerät, das MT3620-Chips direkt verwendet) entwickeln, ist dies der Grund für die Anforderung der RF-Tools.If you're building a module (rather than a device that uses MT3620 chips directly), your reason for requiring the RF tools.

  • Die Arten von Tests, die Sie mit den-Tools ausführen möchten.The kinds of tests you plan to run using the tools.

  • Geplante Zeitachse für die Produktion (Wann müssen Geräte hergestellt/zertifiziert werden).Projected timeline for manufacturing (when do devices need to be manufactured/certified).

Ein Microsoft-Mitarbeiter wird mit Ihnen zusammenarbeiten, um den entsprechenden Verteilungs Kanal zu ermitteln.A Microsoft representative will work with you to determine the appropriate distribution channel.

Setup und InstallationSetup and installation

Bevor Sie die HF-Tools ausführen können, müssen Sie Ihren PC und Ihr MT3620-Gerät mit der aktuellen Software einrichten und die Tools entzippen. Dies ist in den folgenden Abschnitten beschrieben.Before you can run the RF tools, you must set up your PC and your MT3620 device with the latest software and unzip the tools, as described in the following sections.

PC-EinrichtungPC setup

Richten Sie Ihren PC mit dem aktuellen Azure Sphere SDK ein.Set up your PC with the current Azure Sphere SDK.

Einrichtung des MT3620-GerätsMT3620 device setup

Stellen Sie nach dem Einrichten Ihres PC sicher, dass auf Ihrem MT3620-Gerät das aktuellste Azure Sphere-Betriebssystem ausgeführt wird.After you set up your PC, make sure that your MT3620 device is running the most recent Azure Sphere OS. Befolgen Sie die Anleitung in den Versionshinweisen zur aktuellen Version.Follow the instructions in the Release Notes for the current release.

Installation der HF-TesttoolsRF tool installation

Entzippen Sie das Paket mit den HF-Testtools in einem Verzeichnis auf Ihrem PC.Unzip the RF Tools Package into a directory on your PC. Der resultierende Ordner enthält drei Unterordner:The resulting folder contains three subfolders:

  • „Configurations“ mit den Dateien für die Einstellungen für die Konfiguration der FunkeinheitConfigurations, which contains files to facilitate radio configuration settings

  • „Libraries“ mit den C-Bibliotheken zum Durchführen von HF-TestsLibraries, which contains the C libraries for performing RF testing

  • Rftoolcli, die die interaktive Befehlszeilen-rftoolcli und den schreibgeschützten rfsettingstool enthältRfToolCli, which contains the interactive command-line RfToolCli and the read-only RfSettingsTool

HF-Konfiguration und -Kalibrierung für MT3620MT3620 RF configuration and calibration

Auf dem MT3620-Gerät werden die Daten für die Konfiguration und Kalibrierung der Funkeinheit auf e-fuse-Chips gespeichert, die programmiert werden können (Anzahl der Programmierungen ist begrenzt).The MT3620 stores radio configuration and calibration data in e-fuses, which can be programmed a limited number of times. Diese Daten umfassen die Frequenzbänder (z.B. 2,4 GHz oder 5 GHz), die vom Chip unterstützt werden sollten, Anpassungen der Übertragungsleistung und die Antennenkonfiguration auf dem Gerät.This data includes the radio bands (such as 2.4GHz or 5GHz) that the chip should support, adjustments to transmit power, and the antenna configuration on the device. Ausführliche Informationen zur e-fuse-Konfiguration finden Sie in den Richtlinien für den MT3620 N9 e-fuse-Inhalt, die über MediaTek verfügbar sind.For detailed information about e-fuse configuration, see the MT3620 N9 E-fuse content guidelines, which are available from MediaTek.

AntennendiversitätAntenna diversity

Funksignale werden von Umgebungsobjekten abgelenkt.Radio signals bounce off objects in the environment. Aus diesem Grund wird ein Funksignal auf unterschiedlichen Wegen vom Sender zum Empfänger übertragen.As a result, a single radio signal takes multiple paths from transmitter to receiver. Da diese Funksignale unterschiedliche Entfernungen zurücklegen, treffen sie zu unterschiedlichen Zeitpunkten beim Empfänger ein.Because these radio signals travel different distances, they arrive at the receiver at different times. Gelegentlich kommt es vor, dass die eintreffenden Signale sich gegenseitig so stark stören, dass die Antenne kein Signal erkennen kann.Occasionally, the arriving signals interfere destructively and the antenna does not see any signal. Eine Möglichkeit zur Behebung dieses Problems ist die Antennendiversität.One way to address this problem is through antenna diversity. Antennendiversität wird erzielt, indem eine zweite Antenne mit einer anderen Ausrichtung in der Nähe der ersten Antenne aufgestellt wird (Abstand von mindestens einem Viertel der Wellenlänge).To provide antenna diversity, a second antenna that has a different orientation is placed a short distance (at least a quarter wavelength) away from the first.

Das MT3620-Gerät unterstützt zwei Konfigurationen für Antennendiversität, die mit e-fuse-Funkchips konfiguriert werden.The MT3620 supports two antenna diversity configurations, which are configured using radio e-fuses. In der Abbildung sind die beiden Konfigurationen dargestellt.The figure shows the two configurations.

Antennendiversität

Die Konfiguration auf der linken Seite veranschaulicht die Empfangsdiversität (RX-Diversität).The configuration on the left shows receive diversity (RX diversity). Bei dieser Konfiguration wird an den Hilfsantennenanschluss eine zweite Antenne angeschlossen.In this configuration, a second antenna is attached to the auxiliary antenna port. Sobald der Empfangssignalpegel am Hauptantennenanschluss unter einen bestimmten Schwellenwert fällt, wechselt das MT3620-Gerät automatisch zur zweiten Antenne, wenn Daten empfangen werden.If the received signal level on the main antenna port drops below a certain threshold, the MT3620 automatically switches to the second antenna when receiving data. Bei dieser Konfiguration muss für Übertragungen weiterhin die Hauptantenne genutzt werden.In this configuration, transmissions must still use the primary antenna.

Die Konfiguration auf der rechten Seite veranschaulicht die Übertragungs- und Empfangsdiversität (TX- und RX-Diversität). Hierbei wird die zweite Antenne sowohl zum Übertragen als auch zum Empfangen verwendet.The configuration on the right shows transmit and receive diversity (TX and RX diversity), uses the secondary antenna to both transmit and receive. Für das MT3620-Gerät wird dies durch die Nutzung eines externen zweipoligen, doppelseitigen Schalters (Double-Pole, Double-Throw, DPDT) erreicht, um das Signal an eine der Antennen zu leiten.The MT3620 achieves this through the use of an external double-pole, double-throw (DPDT) switch, which allows the signal to be routed to either antenna. Bei der Konfiguration mit Übertragungs- und Empfangsdiversität wird der Hilfsantennenanschluss nicht genutzt.In the transmit and receive diversity configuration, the auxiliary antenna port is unused. Das MT3620-Gerät verfügt über zwei dedizierte Pins für die Antennenauswahl, mit denen dieser externe Schalter gesteuert werden kann.The MT3620 has two dedicated antenna selection pins for controlling this external switch.

PufferbehälterBuffer bins

Bei HF-Tests können für das MT3620-Gerät anstelle der dauerhaften e-fuse-Chips auch Werte im flüchtigen Speicher genutzt werden, damit diese Einstellungen durch Testpersonal und für die Ausrüstung angepasst werden können, ohne dass die e-fuse-Chips ständig geändert werden müssen.During RF testing, the MT3620 can use values in volatile memory instead of the permanent e-fuses, so that test operators and equipment can adjust these settings without permanently changing the e-fuses. Der flüchtige Speicher, der zum Speichern dieser Einstellungen verwendet wird, wird als "Pufferbehälter" (Buffer Bin) bezeichnet. Wenn für das Testpersonal bzw. die Ausrüstung sichergestellt ist, dass die Werte im Pufferbehälter korrekt sind, kann der Zustand des Pufferbehälters dauerhaft in e-fuse-Chips geschrieben werden.The volatile memory used to store these settings is referred to as the "buffer bin." After the test operator or equipment is sure that the values in the buffer bin are correct, the state of the buffer bin can be permanently written to e-fuses.

Beim Aktivieren des HF-Testmodus kann der Inhalt des Pufferbehälters auf bekannte, voreingestellte Werte festgelegt werden, indem eine Datei als "Standardpufferbehälter" geladen wird.When entering RF test mode, it is possible to set the contents of the buffer bin to known, pre-set values by loading a "default buffer bin" file. Das Testpersonal bzw. die Ausrüstung kann dann je nach Bedarf weitere Konfigurations- oder Kalibrierungswerte festlegen.The test operator or equipment can then set additional configuration or calibration values as necessary.

Das Paket mit den HF-Testtools enthält im Verzeichnis „Configurations\MT3620“ mehrere Standardpufferbehälter-Dateien.The RF Tools package provides several default buffer bin files in the Configurations\MT3620 directory. Diese Dateien können zum Initialisieren des Geräts in einem vorkonfigurierten Zustand oder zum Außerkraftsetzen von Kalibrierungseinstellungen verwendet werden, die für die dauerhaften e-fuse-Chips auf den zu testenden Geräten (Devices under test, DUT) programmiert wurden.These files can be used to initialize the device to a pre-configured state or to override any calibration settings that have previously been programmed into the permanent e-fuses on the device under test (DUT).

Die folgenden Pufferbehälterdateien unterstützen die Übertragung mit der Hauptantenne:The following buffer bin files support transmission with the main antenna:

  • MT3620_eFuse_N9_V5_20180321_24G_5G_NoDpdt.bin: Legt für die Funkeinheit fest, dass sowohl der Betrieb mit 2,4 GHz als auch mit 5 GHz unterstützt wird.MT3620_eFuse_N9_V5_20180321_24G_5G_NoDpdt.bin sets the radio to support both 2.4GHz and 5GHz operation.

  • MT3620_eFuse_N9_V5_20180321_24G_Only_NoDpdt.bin: Legt für die Funkeinheit fest, dass nur der Betrieb mit 2,4 GHz unterstützt wird.MT3620_eFuse_N9_V5_20180321_24G_Only_NoDpdt.bin sets the radio to support 2.4GHz operation only.

Die folgenden Pufferbehälterdateien unterstützen die Übertragung per Hilfsantenne:The following buffer bin files support transmitting with an auxiliary antenna:

  • MT3620_eFuse_N9_V5_20180321_24G_5G_Dpdt.bin: Unterstützt den Betrieb mit 2,4 GHz und 5 GHz mit dem DPDT-Schalter.MT3620_eFuse_N9_V5_20180321_24G_5G_Dpdt.bin supports 2.4GHz and 5GHz operation with the DPDT switch.

  • MT3620_eFuse_N9_V5_20180321_24G_Only_Dpdt.bin: Unterstützt den Betrieb mit 2,4 GHz mit dem DPDT-Schalter.MT3620_eFuse_N9_V5_20180321_24G_Only_Dpdt.bin supports 2.4GHz operation with the DPDT switch.

Standardpufferbehälter-Dateien können weiter an Ihre jeweilige Geräteanwendung angepasst werden.Default buffer bin files can be further customized to your specific device application. Wenden Sie sich an MediaTek oder Microsoft, um weitere Anpassungsoptionen zu erhalten.Please contact MediaTek or Microsoft for other customization options.

RfToolCliRfToolCli

RfToolCli ist ein interaktives Befehlszeilentool, das eine Steuerung der MT3620-Funkeinheit auf niedriger Ebene zu Test- und Diagnosezwecken ermöglicht.RfToolCli is an interactive command-line tool that allows low-level control of the MT3620 radio for testing and diagnostic purposes. Stellen Sie vor dem Ausführen dieses Tools sicher, dass das zu testende Gerät verbunden ist und dass darauf das aktuelle Azure Sphere-Betriebssystem ausgeführt wird.Before you run this tool, ensure that the device under test (DUT) is connected and is running the latest Azure Sphere OS.

Öffnen Sie zum Verwenden des Tools ein Eingabeaufforderungsfenster, wechseln Sie zu dem Verzeichnis, dass die Datei „RfToolCli.exe“ enthält, und führen Sie RfToolCli aus.To use the tool, open a Command prompt window, go to the directory that contains RfToolCli.exe, and run RfToolCli. Der Befehl verfügt über zwei Startoptionen:The command has two start-up options:

rftoolcli [-BufferBin <filename>] [-Image <filename>]

Mit der Option „-BufferBin“ wird der Pfad zu einer benutzerdefinierten Datei für die Konfiguration eines Standardpufferbehälters übergeben.The -BufferBin option passes the path to a custom default buffer-bin configuration file. Standardmäßig werden für RfToolCli Funkeinstellungen verwendet, die auf dem Gerät programmiert sind.By default, RfToolCli uses radio settings that are programmed onto the device. Diese Einstellungen umfassen Anpassungen der Übertragungsleistung, die zulässigen Frequenzbänder sowie Antennenkonfigurationen.These settings include any transmit power adjustments, allowed frequency bands, and antenna configurations. Geben Sie den Pfad zur Datei mit der Option „-BufferBin“ an, wenn Sie eine Datei mit alternativen Einstellungen verwenden möchten.To use an alternative settings file, supply the path to the file with the -BufferBin option.

Mit der Option „-Image“ wird der Pfad an die Datei „rftest-server.imagepackage“ übergeben.The -Image option passes the path to the rftest-server.imagepackage file. Diese Imagepaketdatei muss auf das zu testende Gerät geladen werden, um das Gerät in den HF-Testmodus zu versetzen.This image package file must be loaded onto the DUT to put the device into RF test mode. „rftest-server“ wird in demselben Ordner wie die ausführbare RfToolCli-Datei bereitgestellt, und in den meisten Fällen kann diese Datei von RfToolCli gefunden werden.The rftest-server is provided in the same folder as the RfToolCli executable and in most circumstances RfToolCli can locate this file. Falls Sie RfToolCli von einem anderen Speicherort ausführen, müssen Sie unter Umständen die Option „-Image“ verwenden, um den Pfad an diese Datei zu übergeben.If you are running RfToolCli from a different location, you might need to use the -Image option to pass the path to this file.

Beim Starten wird das Gerät von RfToolCli vorbereitet, und anschließend wird eine interaktive Eingabeaufforderung angezeigt:At startup, RfToolCli prepares the device and then displays an interactive prompt:

C:\Rf\RfToolCli> .\RfToolCli.exe
Preparing DUT...
>

Mit RFToolCli werden die Befehle bereitgestellt, die in der folgenden Tabelle enthalten sind.RFToolCli provides the commands listed in the following table.

Befehlsoptionen (Abkürzung)Command (abbreviation) options BESCHREIBUNGDescription
antenna {aux | main}antenna {aux | main} Dient zum Auswählen der Hilfs- oder Hauptantenne.Selects the auxiliary or main antenna.
channel Nummerchannel number Dient zum Auswählen eines Kanals.Selects a channel.
config readconfig read
{macaddress | data}{macaddress | data}
Dient zum Abrufen der MAC-Adresse des Geräts und der Pufferbehälterdaten.Gets device MAC address and buffer bin data.
config writeconfig write
{macaddress | data}{macaddress | data}
Dient zum Festlegen der MAC-Adresse des Geräts und der Pufferbehälterdaten.Sets device MAC address and buffer bin data.
config saveconfig save Dient zum Speichern von Änderungen an der MAC-Adresse oder den Pufferbehälterdaten auf dauerhaften e-fuse-Chips.Saves changes to MAC address or buffer bin data to permanent e-fuses.
exitexit Dient zum Beenden des Programms.Exits from the program.
help Befehlsnamehelp command-name Dient zum Anzeigen der Hilfe für einen Befehl.Displays help on a command.
receive (rx)receive (rx)
{start | stop | stats}{start | stop | stats}
Dient zum Starten oder Beenden des Empfangs oder zum Anzeigen von Statistiken zu empfangenen Paketen.Starts or stops receiving, or displays statistics about received packets.
settingssettings Dient zum Anzeigen aktueller Funkeinstellungen.Displays current radio settings.
showchannel (sc)showchannel (sc) Dient zum Auflisten der Kanäle, die vom Gerät unterstützt werden.Lists the channels that the device supports.
transmit (tx) {frame | mode | power | rate | start}transmit (tx) {frame | mode | power | rate | start} Dient zum Konfigurieren und Übertragen von Paketen.Configures and transmits packets.
Mit den Optionen „frame“, „mode“, „power“ und „rate“ werden die Pakete konfiguriert. Sie verfügen jeweils über Parameter zum Definieren der relevanten Konfigurationseinstellung.The frame, mode, power, and rate options configure the packets; each has parameters that define the relevant configuration setting.
Mit der Option „start“ wird die Übertragung gestartet.The start option starts transmission.

Sie können Hilfe für jeden Befehl erhalten, indem Sie „help“ gefolgt vom Befehlsnamen und ggf. einer Option eingeben.You can get help for any command by typing help followed by the command name and, if applicable, an option. Beispiel:For example:

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)

Beispiel: Anzeigen von StarteinstellungenExample: View start-up settings

Beim Starten werden mit RfToolCli mehrere Standardwerte festgelegt, z.B. Übertragungsmodi, Datenrate und Kanal.At startup, RfToolCli sets several defaults including transmit modes, data rate and channel. Verwenden Sie zum Anzeigen dieser Starteinstellungen den Befehl settings.To view these startup settings, use the settings command.

 > 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

Beispiel: Festlegen des Kanals und Abrufen von Statistiken zu empfangenen PaketenExample: Set channel and get received packet statistics

Mit dieser Befehlssequenz wird die Funkeinheit in den Empfangsmodus über den angegebenen 802.11-Kanal versetzt, und anschließend werden Statistiken zu den empfangenen Paketen abgerufen:This command sequence puts the radio into receive mode on the specified 802.11 channel and then gets statistics about the packets received:

> 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
>

Beispiel: Übertragen von Paketen über den aktuellen KanalExample: Transmit packets on current channel

Dieser Befehl bewirkt, dass die Funkeinheit Pakete über den aktuellen Kanal überträgt:This command causes the radio to transmit packets on the current channel:

> transmit start
Starting transmit
Press any key to stop transmission

Beispiel: Übertragen von Paketen im fortlaufenden Modus über den aktuellen KanalExample: Transmit packets in continuous mode on current channel

Dieser Befehl bewirkt, dass die Funkeinheit Pakete über den aktuellen Kanal im fortlaufenden Modus überträgt, bis Sie die Übertragung beenden oder einen anderen Modus festlegen:This command causes the radio to transmit packets on the current channel in continuous mode until you stop transmission or set a different the mode:

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

Wenn das Gerät die Übertragung im fortlaufenden Modus durchführt, besteht zwischen den Paketen keine Lücke. Dies ist bei Strommessungen hilfreich.When the device transmits in continuous mode, there is no gap between packets, which is useful for power measurements.

Beispiel: Übertragen eines Dauertons über den aktuellen KanalExample: Transmit a continuous tone on the current channel

Diese Befehlssequenz bewirkt, dass die Funkeinheit einen Ton über den aktuellen Kanal überträgt, bis Sie eine Taste drücken.This command sequence causes the radio to transmit a tone on the current channel until you press a key.

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

Beispiel: Abrufen der derzeit konfigurierten MAC-Adresse des GerätsExample: Get the device's currently configured MAC address

Mit diesem Befehl wird die derzeit konfigurierte MAC-Adresse des Geräts ausgelesen.This command reads the currently configured MAC address on the device.

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

Beispiel: Festlegen der MAC-Adresse des GerätsExample: Set the device's MAC address

Mit diesem Befehl wird eine neue MAC-Adresse in den Pufferbehälter des Geräts geschrieben.This command writes a new MAC address to the device's buffer bin. Falls für das Gerät bereits eine MAC-Adresse festgelegt ist, werden Sie aufgefordert, die Änderung zu bestätigen.If a MAC address is already set for the device, you will be asked to confirm the change.

> 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

Hinweis

Verwenden Sie den Befehl config save, um Änderungen am Pufferbehälter oder MAC-Adressen dauerhaft zu speichern.To make buffer bin or MAC addresses changes permanent, use the config save command.

Beispiel: Festlegen von 1 Byte mit KonfigurationsdatenExample: Set one byte of configuration data

Mit dem Befehl „config write data“ kann 1 Byte an Daten unter der angegebenen Pufferbehälteradresse festgelegt werden.The config write data command can be used to set one byte of data at the specified buffer bin address.

> config write data 0x34 0xDD

Beispiel: Anzeigen der Daten für die GerätekonfigurationExample: Display device configuration data

Mit dem Befehl „config read data“ wird der gesamte Inhalt des Gerätepufferbehälters ausgegeben.The config read data command outputs the entire contents of the device buffer bin.

> 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
...

Beispiel: Speichern von Konfigurationsdaten auf e-fuse-ChipsExample: Save configuration data to e-fuses

Mit dem Befehl „config save“ werden Änderungen am Pufferbehälter dauerhaft auf nicht flüchtigen e-fuse-Chips gespeichert.The config save command permanently writes any changes to the buffer bin to the non-volatile e-fuses. Da die Anzahl von Schreibvorgängen auf e-fuse-Chips begrenzt ist, empfehlen wir Ihnen dringend Folgendes: Führen Sie zuerst alle Änderungen von Pufferbehältern durch, und schreiben Sie diese Änderungen dann in einem gemeinsamen Schritt auf die e-fuse-Chips.The e-fuses can only be written a limited number of times, so we strongly recommend that you perform all buffer bin changes first and then write these changes to e-fuses in a single step.

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

Tool für HF-EinstellungenRF settings tool

Das Tool "RF-Einstellungen" zeigt MT3620 e-fuse-Einstellungen an, damit Sie überprüfen können, ob Sie ordnungsgemäß festgelegt wurden.The RF settings tool displays MT3620 e-fuse settings so that you can validate that they have been set correctly. Anders als bei rftoolcli ist das Tool für die RF-Einstellungen schreibgeschützt.Unlike RfToolCli, the RF settings tool is read-only. Daher kann es auch dann zum Untersuchen von Geräteeinstellungen verwendet werden, nachdem die Funktion zum Testen der Funkeinheit auf einem bestimmten Gerät deaktiviert wurde.Therefore, it can be used to inspect device settings even after radio testing functionality has been disabled on a particular device.

Öffnen Sie zum Verwenden des Tools ein Eingabeaufforderungsfenster, wechseln Sie zum Ordner „RfToolCli“, und führen Sie das RfSettingsTool aus.To use the tool, open a Command prompt window, go to the RfToolCli folder, and run RfSettingsTool. Das Tool verfügt über zwei Befehle und zwei Startoptionen:The tool has two commands and has two start-up options:

rfsettingstool <command> [--image <filename>] [--usefile <filename>]

Die folgenden Befehle werden unterstützt:The following commands are supported:

Befehl (Abkürzung)Command (abbreviation) BESCHREIBUNGDescription
check (c)check (c) Überprüfen der Konfigurationsdaten des MT3620-GerätsValidates MT3620 device configuration data
help ( ? )help (?) Anzeigen von HilfeinformationenShows help information
show (s)show (s) Dient zum Anzeigen der MT3620-Konfigurationsdaten.Shows MT3620 configuration data.

RfSettingsTool-Befehl „check“RfSettingsTool check command

Mit dem RfSettingsTool-Befehl check wird die Konfiguration aus dem angeschlossenen Gerät ausgelesen und mit einer Pufferbehälter-Konfigurationsdatei verglichen, die die erwarteten Einstellungen enthält.The RfSettingsTool check command reads the configuration from the attached device and compares it against a buffer bin configuration file that contains the expected settings. Der Befehl check hat das folgende Format:The check command has the following format:

rfSettingsTool.exe check --expected <filename> [--image <filename>] [--nomacaddress] [--showconfig] [--usefile <filename>] [--verbose]
Parameter (Abkürzung)Parameters (abbreviation) BESCHREIBUNGDescription
--expected filename (-e)--expected filename (-e) Pfad zur Pufferbehälterdatei, die die erwarteten e-fuse-Einstellungen für die Überprüfung enthält.Path to the buffer bin file that contains the expected e-fuse settings to check against. Erforderlich.Required.
--image filename (-i)--image filename (-i) Pfad zum HF-Testimage.Path to RF test image. Wenn Sie dies weglassen, wird standardmäßig „rftest-server.imagepackage“ verwendet.If omitted, defaults to rftest-server.imagepackage. Optional.Optional.
--nomacaddress (-n)--nomacaddress (-n) Gibt an, dass auf dem Gerät keine MAC-Adresse festgelegt werden soll.Indicates that no MAC address should be set on the device. Optional.Optional.
--showconfig (-s)--showconfig (-s) Dient zum Anzeigen der Gerätekonfiguration nach der Überprüfung.Shows device configuration after check. Optional.Optional.
--usefile filename (-u)--usefile filename (-u) Dient zum Lesen von Konfigurationsdaten aus der angegebenen Datei (anstatt vom angeschlossenen Gerät).Reads configuration data from the specified file instead of the attached device. Optional.Optional.
--verbose (-v)--verbose (-v) Dient zum Anzeigen von zusätzlichen Ausgabeinformationen.Shows extra output information.

Mit dem folgenden Befehl wird beispielsweise überprüft, ob die Funkeinstellungen mit den Einstellungen in der angegebenen Pufferbehälterdatei übereinstimmen:For example, the following command verifies that the radio setting match those in the specified buffer bin file:

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

Als Reaktion auf diesen Befehl werden mit dem RfSettingsTool die folgenden Elemente überprüft.In response to this command, RfSettingsTool checks the following items. Damit der Befehl erfolgreich ist, muss das Ergebnis jeweils „true“ lauten:All must be true for the command to succeed:

  • Regionscode ist mit der erwarteten Einstellung identischRegion code is identical to expected setting

  • Vorhandener externer Antennenschalter ist mit erwarteter Einstellung identischExternal antenna switch present identical to expected setting

  • Antennenkonfiguration ist mit erwarteter Einstellung identischAntenna configuration identical to expected setting

  • Zielleistung ist mit erwarteter Einstellung identischTarget power identical to expected setting

  • Betriebsbänder sind mit erwarteter Einstellung identischOperating bands identical to expected setting

  • MAC-Adresse wurde festgelegtMAC address has been set

Der Leistungsversatz der Funkeinheit ist gerätespezifisch und wird nicht überprüft.Radio power offsets, which are device-specific, are not checked.

RfSettingsTool-Befehl „show“RfSettingsTool show command

Mit dem RfSettingsTool-Befehl show werden die Einstellungen der Funkeinheit angezeigt, die auf den e-fuse-Chips des MT3620-Geräts in einem für Menschen lesbaren Format festgelegt wurden.The RfSettingsTool show command displays the radio settings that have been set on the MT3620 e-fuses in a human-readable way. Die angezeigten Felder sind die für Benutzer konfigurierbaren Einstellungen der Funkeinheit. Der Befehl check hat das folgende Format:The fields displayed are the user-configurable radio settings.The check command has the following format:

rfSettingsTool.exe show [--hexdump] [--image <filename>] [--usefile <filename>] [--verbose]
Parameter (Abkürzung)Parameters (abbreviation) BESCHREIBUNGDescription
--hexdump (-x)--hexdump (-x) Dient zum Anzeigen des unformatierten hexadezimalen Inhalts von e-fuse-Chips.Shows the raw hexadecimal contents of e-fuses. Optional.Optional.
--image filename (-i)--image filename (-i) Pfad zum HF-Testimage.Path to RF test image. Wenn Sie dies weglassen, wird standardmäßig „rftest-server.imagepackage“ verwendet.If omitted, defaults to rftest-server.imagepackage. Optional.Optional.
--usefile filename (-u)--usefile filename (-u) Dient zum Lesen von Konfigurationsdaten aus der angegebenen Datei (anstatt vom angeschlossenen Gerät).Reads configuration data from the specified file instead of the attached device. Optional.Optional.
--verbose (-v)--verbose (-v) Dient zum Anzeigen von zusätzlichen Ausgabeinformationen.Shows extra output information.

Im folgenden Beispiel ist eine Teilausgabe des Befehls show dargestellt:The following example shows partial output from the show command:

> RfSettingsTool.exe 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
.
.
.

C-Bibliothek für RF-TestsRF test C library

Das Paket mit den HF-Tools enthält eine C-Bibliothek, die Sie nutzen können, um Ihre eigenen Testprogramme zu entwickeln.The RF Tools package includes a C library that you can use to develop your own test programs. Die C-Bibliothek ist im Verzeichnis „libraries\C“ enthalten.The C library is in the libraries\C directory. Headerdateien für die C-API finden Sie im Ordner „libraries\C\Include“, und Binärdateien, die für die Verwendung der Bibliothek benötigt werden, sind im Ordner „libraries\C\Bin“ enthalten.Header files for the C API are available in the libraries\C\Include folder, and binary files that are required to use the library are provided in the libraries\C\Bin folder. Wenden Sie sich wegen der Dokumentation an Microsoft, wenn Sie die Bibliothek nutzen möchten.If you want to use the library, please contact Microsoft for documentation.

Das RF-Testserverimage (rftest-server.imagepackage) ist auch im Ordner „Bin“ enthalten.The RF testing server image (rftest-server.imagepackage) is also provided in the Bin folder. Dieses Image muss auf dem zu testenden Gerät geladen sein, bevor das Gerät in den HF-Testmodus versetzt werden kann.This image must be loaded on the device under test before the device can enter RF testing mode. Mit der Funktion „mt3620rf_load_rf_test_server_image() “ in der C-Bibliothek wird das Imagepaket programmgesteuert geladen.The mt3620rf_load_rf_test_server_image() function in the C library loads the image package programmatically.

Wenn Sie eine Anwendung neu verteilen, für die die C-Bibliothek verwendet wird, müssen Sie die DLL-Dateien aus „libraries\C\Bin“ und die Datei „rftest-server.imagepackage“ einbinden.If you redistribute an application that uses the C library, you must include the DLL files from libraries\C\Bin as well as the rftest-server.imagepackage file.

Kompatibilität von RF-Tools in BetriebssystemversionenCompatibility of RF tools across OS versions

Es gibt keine Garantie, dass die RF-Tools für ein Betriebssystem Release über alle Betriebssystemversionen hinweg kompatibel sind.There is no guarantee that RF tools for one OS release will be compatible across all OS versions. Im Allgemeinen wird empfohlen, dass Sie die Version der Tools (und der zugehörigen C-Bibliothek) verwenden, die zusammen mit dem Fertigungs Paket für das Betriebssystem auf dem getesteten Gerät ausgegeben wird.Generally, we recommend that you use the version of the tools (and associated C Library) that is issued with the manufacturing package for the OS running on the device under test.

In der folgenden Tabelle wird die Kompatibilität von Tool Releases mit Azure Sphere OS-Releases zusammengefasst.The following table summarizes the compatibility of tool releases with Azure Sphere OS releases.

Release von RF-ToolsRF Tools Release BetriebssystemversionOS Release
20,0720.07 20,0720.07
20,0420.04 20,04 oder 20,0120.04 or 20.01
20,0120.01 20,04 oder 20,0120.04 or 20.01

Weitere Informationen zu weiteren Änderungen in der aktuellen Version finden Sie unter Neues in Azure Sphere .See What's new in Azure Sphere to learn about any additional changes in the current release.

FehlerErrata

Die folgenden Errata gelten für alle Versionen der RF-Tools auf MT3620-Hardware.The following errata apply to all versions of the RF tools on MT3620 hardware. Weitere releasespezifische Probleme sind in der Infodatei aufgeführt, die im Toolpaket enthalten ist.Additional release-specific issues are listed in the README file that is part of the tools package.

  • Die MT3620-WLAN-Firmware enthält einen kleineren Fehler:The MT3620 Wi-Fi firmware has a minor bug:

    Wenn Sie zur Übertragung im fortlaufenden Modus (tx mode continuous) wechseln und die Übertragung unmittelbar nach dem Beenden einer Übertragung im normalen Modus starten (tx start), wird kein Signal ausgegeben.If you switch to Continuous mode transmission (tx mode continuous) and start transmission (tx start) immediately after stopping a Normal mode transmission, there will be no signal output.

    Um dies zu umgehen, sollten Sie die Übertragung im fortlaufenden Modus beenden und dann wieder starten, damit die Übertragung beginnen kann.To work around this, stop the Continuous mode transmission and start it again for the transmission to commence. Anschließend funktioniert die Übertragung im fortlaufenden Modus richtig.After this, Continuous mode transmission will work correctly.

    Beim Wechseln vom fortlaufenden Modus in den normalen Modus tritt dieses Problem nicht auf.The problem does not occur when switching from Continuous Mode to Normal mode.

  • Beim Wechseln von der Continuous Wave-Übertragung in den normalen oder fortlaufenden Übertragungsmodus erhöht sich die Übertragungsleistung fälschlicherweise um +6 dB.When switching from Continuous Wave transmission mode to Normal or Continuous transmission modes, transmit power will incorrectly increase by +6 dB. Sie müssen die Einstellungen der Funkeinheit erneut initialisieren, um die Leistungsstufe auf normal zurückzusetzen.You must re-initialize the radio to return the power level to normal.

    • Wenn Sie das interaktive RfToolCli-Tool verwenden, initialisieren Sie die Funkeinheit erneut, indem Sie das Tool beenden und dann neu starten.If using the RfToolCli interactive tool, reinitialize the radio by exiting and then and restarting the tool.
    • Wenn Sie die C-API zu verwenden, rufen Sie die Funktion mt3620_reinitialize_buffer_bin() auf.If using the C API, call the mt3620_reinitialize_buffer_bin() function. Dadurch wird auch die Funkeinheit neu initialisiert. Der Aufruf kann verwendet werden, um dieses Problem zu umgehen.This will also reinitialize the radio and can be used to work around this issue.