Freigeben über

RF-Tools

  • Artikel

Wichtig

Dies ist die Dokumentation zu Azure Sphere (Legacy). Azure Sphere (Legacy) wird am 27. September 2027 eingestellt, und Benutzer müssen bis zu diesem Zeitpunkt zu Azure Sphere (integriert) migrieren. Verwenden Sie die Versionsauswahl oberhalb des Inhaltsverzeichniss, um die Dokumentation zu Azure Sphere (Integriert) anzuzeigen.

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. Diese Tools umfassen interaktive Anwendungen für die Steuerung und Anzeige der Einstellungen für Hochfrequenz (HF).

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

Informationen dazu, wie sich HF-Tests in den Herstellungsablauf einfügen, finden Sie unter Manufacturing connected devices (Herstellen von verbundenen Geräten).

Wichtig

Für die RF-Tools ist die Funktion "RF-Testmodus aktivieren" erforderlich. Diese Funktion ist standardmäßig auf Boards vorhanden, die sich im Zustand "Leere Fertigung" befinden, aber nicht im Status "Module1Complete " oder "DeviceComplete " verfügbar sind.

Verwenden Sie den befehl "azsphere device show-attached ", um zu bestimmen, ob diese Funktion auf Ihrem Gerät vorhanden ist. Wenn Sie die RF-Tools auf einem Gerät ausführen müssen, das nicht über diese Funktion verfügt, befolgen Sie die Anweisungen in den RF-Tools , um Unterstützung an Microsoft zu erhalten.

Die RF-Tools verwenden nur den Service UART-Anschluss, der an einen USB-Anschluss auf Ihrem PC angeschlossen sein muss. Die RF-Tools erfordern, dass die UART vom Future Technology Devices International (FTDI) FT4232HQ UART-to-USB-Schnittstellenchip verfügbar gemacht wird. Ausführliche Informationen zum Dienst-UART-Port finden Sie unter MCU-Programmier- und Debuggingschnittstelle.

Anfordern der RF-Tools

Microsoft liefert das RF Tools-Paket auf Anfrage an Kunden, Partner und Sicherheitsforscher. Sie können sie von Ihrem technischen Vertriebsmitarbeiter (TSP) anfordern. Wenn Sie keinen TSP haben, senden Sie bitte eine E-Mail azspheremfrsamplesup@microsoft.com an die folgenden Informationen:

  • Ihr Name, Ihre Organisation und Kontaktinformationen.

  • Kontaktinformationen für Ihr Microsoft-Kontoteam oder TSP, falls vorhanden.

  • Wenn Sie ein Modul erstellen (anstelle eines Geräts, das MT3620-Chips direkt verwendet), ist Der Grund für die Anforderung der RF-Tools.

  • Die Arten von Tests, die Sie mit den Tools ausführen möchten.

  • Projizierte Zeitachse für die Fertigung (wann müssen Geräte hergestellt/zertifiziert werden).

Ein Microsoft-Vertreter arbeitet mit Ihnen zusammen, um den entsprechenden Verteilungskanal zu ermitteln.

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

PC-Einrichtung

Richten Sie Ihren PC mit dem aktuellen Azure Sphere SDK ein.

Einrichtung des MT3620-Geräts

Stellen Sie nach dem Einrichten Ihres PC sicher, dass auf Ihrem MT3620-Gerät das aktuellste Azure Sphere-Betriebssystem ausgeführt wird. Befolgen Sie die Anleitung in den Versionshinweisen zur aktuellen Version.

Installation der HF-Testtools

Entzippen Sie das Paket mit den HF-Testtools in einem Verzeichnis auf Ihrem PC. Der resultierende Ordner enthält vier Unterordner:

  • „Configurations“ mit den Dateien für die Einstellungen für die Konfiguration der Funkeinheit

  • Bibliotheken, die die C-, C#- und Python-Bibliotheken zum Ausführen von RF-Tests enthalten

  • rftest-server, der das rftest-server.imagepackage enthält, das von vordefinierten Tools oder Anwendungen verwendet wird, die Sie mit den RF Tools-Bibliotheken erstellen.

  • Tools, die Prebuilt-Anwendungen (MacAddressTool, RfToolCli, RfSettingsTool, WiFiRegionUpdater) für Windows x86, x64 und Linux (x64) und Python (MacAddressTool, RfSettingsTool) Verzeichnisse enthalten.

HF-Konfiguration und -Kalibrierung für MT3620

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). 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. Ausführliche Informationen zur Konfiguration von E-Fuse finden Sie in den Inhaltsrichtlinien für MT3620 N9 E-Fuse, die von MediaTek zur Verfügung stehen.

Antennendiversität

Funksignale werden von Umgebungsobjekten abgelenkt. Aus diesem Grund wird ein Funksignal auf unterschiedlichen Wegen vom Sender zum Empfänger übertragen. Da diese Funksignale unterschiedliche Entfernungen zurücklegen, treffen sie zu unterschiedlichen Zeitpunkten beim Empfänger ein. Gelegentlich kommt es vor, dass die eintreffenden Signale sich gegenseitig so stark stören, dass die Antenne kein Signal erkennen kann. Eine Möglichkeit zur Behebung dieses Problems ist die Antennendiversität. Um die Antennenvielfalt bereitzustellen, wird eine zweite Antenne, die eine andere Ausrichtung hat, einen kurzen Abstand (mindestens eine Viertel Wellenlänge) von der ersten entfernt platziert.

Das MT3620-Gerät unterstützt zwei Konfigurationen für Antennendiversität, die mit e-fuse-Funkchips konfiguriert werden. In der Abbildung sind die beiden Konfigurationen dargestellt.

Antennendiversität

Die Konfiguration auf der linken Seite veranschaulicht die Empfangsdiversität (RX-Diversität). Bei dieser Konfiguration wird an den Hilfsantennenanschluss eine zweite Antenne angeschlossen. Sobald der Empfangssignalpegel am Hauptantennenanschluss unter einen bestimmten Schwellenwert fällt, wechselt das MT3620-Gerät automatisch zur zweiten Antenne, wenn Daten empfangen werden. Bei dieser Konfiguration muss für Übertragungen weiterhin die Hauptantenne genutzt werden.

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. 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. Bei der Konfiguration mit Übertragungs- und Empfangsdiversität wird der Hilfsantennenanschluss nicht genutzt. Das MT3620-Gerät verfügt über zwei dedizierte Pins für die Antennenauswahl, mit denen dieser externe Schalter gesteuert werden kann.

Pufferbehälter

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. Der veränderliche Speicher, der zum Speichern dieser Einstellungen verwendet wird, wird als "Puffercontainer" bezeichnet. Nachdem der Testoperator oder die Ausrüstung sicher ist, dass die Werte im Puffercontainer korrekt sind, kann der Zustand des Puffercontainers dauerhaft in E-Fuses geschrieben werden.

Beim Eingeben des RF-Testmodus ist es möglich, den Inhalt des Puffercontainers auf bekannte, vordefinierte Werte festzulegen, indem eine "Standardpuffercontainer"-Datei geladen wird. Das Testpersonal bzw. die Ausrüstung kann dann je nach Bedarf weitere Konfigurations- oder Kalibrierungswerte festlegen.

Das RF Tools-Paket enthält mehrere Standardpuffercontainerdateien im Verzeichnis "Configurations\MT3620". 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.

Die folgenden Pufferbehälterdateien unterstützen die Übertragung mit der Hauptantenne:

  • MT3620_eFuse_N9_V5_20180321_24G_5G_NoDpdt.bin legt das Funkgerät so fest, dass sowohl 2,4 GHz als auch 5GHz-Betrieb unterstützt werden.

  • MT3620_eFuse_N9_V5_20180321_24G_Only_NoDpdt.bin legt fest, dass das Radio nur 2,4 GHz-Betrieb unterstützt.

Die folgenden Pufferbehälterdateien unterstützen die Übertragung per Hilfsantenne:

  • MT3620_eFuse_N9_V5_20180321_24G_5G_Dpdt.bin unterstützt den Betrieb von 2,4 GHz und 5 GHz mit dem DPDT-Schalter.

  • MT3620_eFuse_N9_V5_20180321_24G_Only_Dpdt.bin unterstützt den Betrieb von 2,4 GHz mit dem DPDT-Schalter.

Standardpufferbehälter-Dateien können weiter an Ihre jeweilige Geräteanwendung angepasst werden. Wenden Sie sich an MediaTek oder Microsoft, um weitere Anpassungsoptionen anzuzeigen.

Nach Abschluss der Nutzung von RF-Tools

Nachdem die RF-Tests und -Kalibrierung auf einem hergestellten Gerät abgeschlossen wurden, sollte das rftest_server.imagepackage vom Gerät entfernt werden, und der Herstellungszustand des Geräts sollte festgelegt werden, um weitere Änderungen der RF-Einstellungen zu verhindern.

Entfernen von rftest_server.imagepackage

Nach Der Verwendung der RF-Tools kann ein Paket mit dem Namen rftest_server.imagepackage auf dem Gerät verbleiben. Dieses Betriebssystempaket ermöglicht den Zugriff über die FTDI-Schnittstelle auf die Rf-Konfiguration auf niedriger Ebene. Dieses Paket wird automatisch von AS3 entfernt, wenn das Gerät als Nächstes eine Verbindung mit AS3 herstellt. Hersteller, die die RF-Tools verwenden, sollten dieses Paket jedoch löschen, wenn die RF-Tests abgeschlossen sind.

So löschen Sie das Paket:

  1. Führen Sie den Azsphere-Gerätebildbefehl wie folgt aus:

    azsphere device image list-installed --full

  2. Überprüfen Sie, ob eine Komponente mit dem Namen rftest_server installiert ist. Führen Sie in diesem Fall den Befehl zum Querladen des Azsphere-Geräts gefolgt von dem Azsphere-Gerätebildbefehl wie folgt aus:

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

    Das Gerät wird nach dem Ausführen dieses Befehls neu gestartet.

    azsphere device image list-installed --full

    Beachten Sie, dass das rftest_server Imagepackage nach dem Ausführen dieses Befehls nicht mehr vorhanden ist.

Hinweis

Wenn Sie RfTools unter Linux ausführen, müssen Sie möglicherweise Die Ausführungsberechtigungen für die RfTool-Programme im Ordner "Tools/Prebuilt/Linux-x64" festlegen, führen Sie diesen Befehl aus, um Berechtigungen für RfToolCli festzulegen.

chmod +x RfToolCli

Weitere Änderung der RF-Einstellungen verhindern

Um weitere Änderungen der RF-Einstellungen zu verhindern, sollten Sie den Herstellungszustand des Geräts als Module1Complete festlegen.

Beachten Sie, dass, wenn das Gerät sofort auf die Anwendung geladen wird (z. B. ein Chip-down-Design, bei dem RF-Tests und Gerätesoftwareladevorgang in einer einzigen Produktionslinie durchgeführt werden), kann dieser Schritt übersprungen werden. Am Ende des Lade- und Testprozesses der Anwendung wird das Gerät in den Zustand "DeviceComplete " verschoben, der auch die Änderung von RF-Einstellungen verhindert.

RfToolCli

RfToolCli ist ein interaktives Befehlszeilentool, das eine Steuerung der MT3620-Funkeinheit auf niedriger Ebene zu Test- und Diagnosezwecken ermöglicht. 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.

Um das Tool zu verwenden, öffnen Sie ein Eingabeaufforderungsterminalfenster/, wechseln Sie zu dem Verzeichnis, das die RfToolCli-Anwendung enthält, und führen Sie RfToolCli aus. RfToolCli verfügt über die folgenden Startoptionen:

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

Mit der Option „-BufferBin“ wird der Pfad zu einer benutzerdefinierten Datei für die Konfiguration eines Standardpufferbehälters übergeben. Standardmäßig werden für RfToolCli Funkeinstellungen verwendet, die auf dem Gerät programmiert sind. Diese Einstellungen umfassen Anpassungen der Übertragungsleistung, die zulässigen Frequenzbänder sowie Antennenkonfigurationen. Geben Sie den Pfad zur Datei mit der Option „-BufferBin“ an, wenn Sie eine Datei mit alternativen Einstellungen verwenden möchten.

Mit der Option „-Image“ wird der Pfad an die Datei „rftest-server.imagepackage“ übergeben. Diese Imagepaketdatei muss auf das zu testende Gerät geladen werden, um das Gerät in den HF-Testmodus zu versetzen. Der Rftest-Server wird in demselben Ordner wie das RfToolCli-Programm bereitgestellt, und in den meisten Fällen kann RfToolCli diese Datei finden. 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.

Beim Starten wird das Gerät von RfToolCli vorbereitet, und anschließend wird eine interaktive Eingabeaufforderung angezeigt:

RfToolCli
Preparing DUT...
>

Mit RFToolCli werden die Befehle bereitgestellt, die in der folgenden Tabelle enthalten sind.

Befehlsoptionen (Abkürzung) Beschreibung
Antenne {aux | main} Dient zum Auswählen der Hilfs- oder Hauptantenne.
channel Nummer Dient zum Auswählen eines Kanals.
config read
{macaddress | data}		 Dient zum Abrufen der MAC-Adresse des Geräts und der Pufferbehälterdaten.
config write
{macaddress | data}		 Dient zum Festlegen der MAC-Adresse des Geräts und der Pufferbehälterdaten.
config save Dient zum Speichern von Änderungen an der MAC-Adresse oder den Pufferbehälterdaten auf dauerhaften e-fuse-Chips.
exit Dient zum Beenden des Programms.
help Befehlsname Dient zum Anzeigen der Hilfe für einen Befehl.
receive (rx)
{start | stop | stats}		 Dient zum Starten oder Beenden des Empfangs oder zum Anzeigen von Statistiken zu empfangenen Paketen.
Einstellungen Dient zum Anzeigen aktueller Funkeinstellungen.
showchannel (sc) Dient zum Auflisten der Kanäle, die vom Gerät unterstützt werden.
transmission (tx) {frame | mode | power | rate | start} Dient zum Konfigurieren und Übertragen von Paketen.
Mit den Optionen „frame“, „mode“, „power“ und „rate“ werden die Pakete konfiguriert. Sie verfügen jeweils über Parameter zum Definieren der relevanten Konfigurationseinstellung.
Mit der Option „start“ wird die Übertragung gestartet.

Sie können Hilfe für jeden Befehl erhalten, indem Sie „help“ gefolgt vom Befehlsnamen und ggf. einer Option eingeben. Zum Beispiel:

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 Starteinstellungen

Beim Starten werden mit RfToolCli mehrere Standardwerte festgelegt, z.B. Übertragungsmodi, Datenrate und Kanal. Verwenden Sie zum Anzeigen dieser Starteinstellungen den Befehl settings.

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

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:

> 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 auf dem aktuellen Kanal

Dieser Befehl bewirkt, dass die Funkeinheit Pakete über den aktuellen Kanal überträgt:

> transmit start
Starting transmit
Press any key to stop transmission

Beispiel: Übertragen von Paketen im fortlaufenden Modus im aktuellen Kanal

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:

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

Beispiel: Übertragen eines fortlaufenden Tons auf dem aktuellen Kanal

Diese Befehlssequenz bewirkt, dass die Funkeinheit einen Ton über den aktuellen Kanal überträgt, bis Sie eine Taste drücken.

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

Beispiel: Abrufen der aktuell konfigurierten MAC-Adresse des Geräts

Mit diesem Befehl wird die derzeit konfigurierte MAC-Adresse des Geräts ausgelesen.

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

Beispiel: Festlegen der MAC-Adresse des Geräts

Mit diesem Befehl wird eine neue MAC-Adresse in den Pufferbehälter des Geräts geschrieben. Falls für das Gerät bereits eine MAC-Adresse festgelegt ist, werden Sie aufgefordert, die Änderung zu bestätigen.

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

Beispiel: Festlegen eines Byte von Konfigurationsdaten

Mit dem Befehl „config write data“ kann 1 Byte an Daten unter der angegebenen Pufferbehälteradresse festgelegt werden.

> config write data 0x34 0xDD

Beispiel: Anzeigen von Gerätekonfigurationsdaten

Mit dem Befehl „config read data“ wird der gesamte Inhalt des Gerätepufferbehälters ausgegeben.

> 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 in E-Fuses

Mit dem Befehl „config save“ werden Änderungen am Pufferbehälter dauerhaft auf nicht flüchtigen e-fuse-Chips gespeichert. 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.

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

Tool für HF-Einstellungen

Das RF-Einstellungstool zeigt MT3620 e-Fuse-Einstellungen an, sodass Sie überprüfen können, ob sie ordnungsgemäß festgelegt wurden. Im Gegensatz zu RfToolCli ist das RF-Einstellungstool schreibgeschützt. 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.

Um das Tool zu verwenden, öffnen Sie ein Eingabeaufforderungsterminal-Fenster/, wechseln Sie zu tools/Prebuilt/<Win-x86 | Win-x64 | Linux-x64-Ordner> und Ausführen von RfSettingsTool. Das Tool verfügt über zwei Befehle und zwei Startoptionen:

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

Die folgenden Befehle werden unterstützt:

Befehl (Abkürzung) Beschreibung
check (c) Überprüfen der Konfigurationsdaten des MT3620-Geräts
help (?) Anzeigen von Hilfeinformationen
show (s) Dient zum Anzeigen der MT3620-Konfigurationsdaten.

RfSettingsTool-Befehl „check“

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. Der Befehl check hat das folgende Format:

RfSettingsTool check --expected <filename> [--image <filename>] [--nomacaddress] [--showconfig] [--usefile <filename>] [--verbose]
Parameter (Abkürzung) Beschreibung
--expected filename (-e) Pfad zur Pufferbehälterdatei, die die erwarteten e-fuse-Einstellungen für die Überprüfung enthält. Erforderlich.
--image filename (-i) Pfad zum HF-Testimage. Wenn Sie dies weglassen, wird standardmäßig „rftest-server.imagepackage“ verwendet. Optional.
--nomacaddress (-n) Gibt an, dass auf dem Gerät keine MAC-Adresse festgelegt werden soll. Optional.
--showconfig (-s) Dient zum Anzeigen der Gerätekonfiguration nach der Überprüfung. Optional.
--usefile filename (-u) Dient zum Lesen von Konfigurationsdaten aus der angegebenen Datei (anstatt vom angeschlossenen Gerät). Optional.
--verbose (-v) Dient zum Anzeigen von zusätzlichen Ausgabeinformationen.

Mit dem folgenden Befehl wird beispielsweise überprüft, ob die Funkeinstellungen mit den Einstellungen in der angegebenen Pufferbehälterdatei übereinstimmen:

> RfSettingsTool 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. Damit der Befehl erfolgreich ist, muss das Ergebnis jeweils „true“ lauten:

  • Regionscode ist mit der erwarteten Einstellung identisch

  • Vorhandener externer Antennenschalter ist mit erwarteter Einstellung identisch

  • Antennenkonfiguration ist mit erwarteter Einstellung identisch

  • Zielleistung ist mit erwarteter Einstellung identisch

  • Betriebsbänder sind mit erwarteter Einstellung identisch

  • MAC-Adresse wurde festgelegt

Der Leistungsversatz der Funkeinheit ist gerätespezifisch und wird nicht überprüft.

RfSettingsTool-Befehl „show“

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. Die angezeigten Felder sind die für Benutzer konfigurierbaren Einstellungen der Funkeinheit. Der Befehl check hat das folgende Format:

RfSettingsTool show [--hexdump] [--image <filename>] [--usefile <filename>] [--verbose]
Parameter (Abkürzung) Beschreibung
--hexdump (-x) Dient zum Anzeigen des unformatierten hexadezimalen Inhalts von e-fuse-Chips. Optional.
--image filename (-i) Pfad zum HF-Testimage. Wenn Sie dies weglassen, wird standardmäßig „rftest-server.imagepackage“ verwendet. Optional.
--usefile filename (-u) Dient zum Lesen von Konfigurationsdaten aus der angegebenen Datei (anstatt vom angeschlossenen Gerät). Optional.
--verbose (-v) Dient zum Anzeigen von zusätzlichen Ausgabeinformationen.

Im folgenden Beispiel ist eine Teilausgabe des Befehls show dargestellt:

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

C-Bibliothek für RF-Tests

Das Paket mit den HF-Tools enthält eine C-Bibliothek, die Sie nutzen können, um Ihre eigenen Testprogramme zu entwickeln. Die C-Bibliothek ist im Verzeichnis „libraries\C“ enthalten. Headerdateien für die C-API sind in den Bibliotheken\C\Include-Ordner verfügbar, und Binärdateien, die für die Verwendung der Bibliothek erforderlich sind, werden im Ordner "libraries\C\Bin" bereitgestellt. Wenden Sie sich wegen der Dokumentation an Microsoft, wenn Sie die Bibliothek nutzen möchten.

Das RF-Testserverimage (rftest-server.imagepackage) ist auch im Ordner „Bin“ enthalten. Dieses Image muss auf dem zu testenden Gerät geladen sein, bevor das Gerät in den HF-Testmodus versetzt werden kann. Die funktion mt3620rf_load_rf_test_server_image() in der C-Bibliothek lädt das Bildpaket programmgesteuert.

Wenn Sie eine Anwendung, die die C-Bibliothek verwendet, erneut verteilen, müssen Sie die DLL-Dateien aus Bibliotheken\C\Bin sowie die Datei rftest-server.imagepackage einschließen.

Kompatibilität von RF-Tools in betriebssystemübergreifenden Versionen

Es gibt keine Garantie dafür, dass RF-Tools für eine Betriebssystemversion für alle Betriebssystemversionen kompatibel sind. Im Allgemeinen wird empfohlen, die Version der Tools (und der zugehörigen C-Bibliothek) zu verwenden, die mit dem Produktionspaket für das Betriebssystem ausgestellt wird, das auf dem Gerät unter Test ausgeführt wird.

In der folgenden Tabelle sind die Kompatibilität von Toolversionen mit Azure Sphere OS-Versionen zusammengefasst.

RF Tools Release Betriebssystemversion
23,05 22.02 und höher
21.01 21.01 und höher
20.10 20.07 oder 20.10
20.07 20.07
20.04 20.04 oder 20.01
20.01 20.04 oder 20.01

Wichtig

Beachten Sie, dass Sie ihr Gerätebetriebssystem möglicherweise aktualisieren oder eine aktualisierte trusted-keystore.bin bereitstellen müssen, um die Version 23.05 von RF Tools zu verwenden, weitere Informationen finden Sie hier.

Schauen Sie sich die Neuerungen in Azure Sphere an, um weitere Änderungen in der aktuellen Version zu erfahren.

Fehler

Die folgende Errata gelten für alle Versionen der RF-Tools auf MT3620-Hardware. Zusätzliche releasespezifische Probleme werden in der README-Datei aufgeführt, die Teil des Toolspakets ist.

  • Die MT3620-WLAN-Firmware enthält einen kleineren Fehler:

    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.

    Um dies zu umgehen, sollten Sie die Übertragung im fortlaufenden Modus beenden und dann wieder starten, damit die Übertragung beginnen kann. Anschließend funktioniert die Übertragung im fortlaufenden Modus richtig.

    Beim Wechseln vom fortlaufenden Modus in den normalen Modus tritt dieses Problem nicht auf.

  • Beim Wechseln von der Continuous Wave-Übertragung in den normalen oder fortlaufenden Übertragungsmodus erhöht sich die Übertragungsleistung fälschlicherweise um +6 dB. Sie müssen die Einstellungen der Funkeinheit erneut initialisieren, um die Leistungsstufe auf normal zurückzusetzen.

    • Wenn Sie das interaktive RfToolCli-Tool verwenden, initialisieren Sie die Funkeinheit erneut, indem Sie das Tool beenden und dann neu starten.
    • Wenn Sie die C-, C#- oder Python-Bibliotheken verwenden, rufen Sie die funktion mt3620_reinitialize_buffer_bin() auf. Dies wird auch das Radio neu initialisieren und kann verwendet werden, um dieses Problem zu umgehen.