Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Führen Sie die FreeRTOS Qualification Suite aus
Sie verwenden die ausführbare Datei AWS IoT Device Tester for FreeRTOS, um mit IDT for FreeRTOS zu interagieren. In den folgenden Befehlszeilenbeispielen wird veranschaulicht, wie Sie die Qualifikationsprüfungen für einen Gerätepool (Satz identischer Geräte) durchführen.
------
#### [ IDT v3.0.0 and later ]
```
devicetester_[linux | mac | win] run-suite \
--suite-id suite-id \
--group-id group-id \
--pool-id your-device-pool \
--test-id test-id \
--upgrade-test-suite y|n \
--update-idt y|n \
--update-managed-policy y|n \
--userdata userdata.json
```
Führt eine Reihe von Tests in einem Pool von Geräten aus. Die Datei `userdata.json` muss sich im Verzeichnis `devicetester_extract_location/devicetester_afreertos_[win|mac|linux]/configs/` befinden.
**Anmerkung**
Wenn Sie IDT for FreeRTOS unter Windows ausführen, verwenden Sie Schrägstriche (/), um den Pfad zur Datei anzugeben. `userdata.json`
Verwenden Sie den folgenden Befehl zum Ausführen einer bestimmten Testgruppe:
```
devicetester_[linux | mac | win] run-suite \
--suite-id FRQ_1.0.1 \
--group-id group-id \
--pool-id pool-id \
--userdata userdata.json
```
Die Parameter `suite-id` und `pool-id` sind optional, wenn Sie eine einzige Testsuite in einem einzigen Gerätepool ausführen (d. h. in Ihrer `device.json`-Datei ist nur ein Gerätepool definiert).
Verwenden Sie den folgenden Befehl zum Ausführen eines bestimmten Testfalls in einer Testgruppe:
```
devicetester_[linux | mac | win_x86-64] run-suite \
--group-id group-id \
--test-id test-id
```
Mit dem Befehl `list-test-cases` können Sie die Testfälle in einer Testgruppe auflisten. IDT für FreeRTOS-Befehlszeilenoptionen
**group-id**
(Optional) Die auszuführenden Testgruppen als kommagetrennte Liste. Bei fehlender Angabe führt IDT alle Testgruppen in der Testsuite aus.
**pool-id**
(Optional) Der zu testende Gerätepool. Dies ist erforderlich, wenn Sie mehrere Gerätepools in `device.json` definieren. Wenn Sie nur einen Gerätepool haben, können Sie diese Option weglassen.
**suite-id**
(Optional) Die auszuführende Test-Suite-Version. Falls nicht angegeben, verwendet IDT die neueste Version im Verzeichnis der Tests auf Ihrem System.
Ab IDT v3.0.0 sucht IDT online nach neueren Testsuiten. Weitere Informationen finden Sie unter [Test-Suite-Versionen](idt-test-suite-versions.md).
**test-id**
(Optional) Die auszuführenden Tests als kommagetrennte Liste. Wenn angegeben, muss `group-id` eine einzelne Gruppe angeben.
**Example**
```
devicetester_[linux | mac | win_x86-64] run-suite --group-id mqtt --test-id mqtt_test
```
**update-idt**
(Optional) Wenn dieser Parameter nicht festgelegt ist und eine neuere IDT-Version verfügbar ist, werden Sie aufgefordert, IDT zu aktualisieren. Wenn dieser Parameter auf gesetzt ist`Y`, stoppt IDT die Testausführung, wenn festgestellt wird, dass eine neuere Version verfügbar ist. Wenn dieser Parameter auf gesetzt ist`N`, setzt IDT die Testausführung fort.
**update-managed-policy**
(Optional) Wenn dieser Parameter nicht verwendet wird und IDT feststellt, dass Ihre verwaltete Richtlinie nicht verwendet wird up-to-date, werden Sie aufgefordert, Ihre verwaltete Richtlinie zu aktualisieren. Wenn dieser Parameter auf gesetzt ist`Y`, stoppt IDT die Testausführung, wenn festgestellt wird, dass Ihre verwaltete Richtlinie dies nicht tut. up-to-date Wenn dieser Parameter auf gesetzt ist`N`, setzt IDT die Testausführung fort.
**upgrade-test-suite**
(Optional) Wenn diese Version nicht verwendet wird und eine neuere Test-Suite-Version verfügbar ist, werden Sie aufgefordert, sie herunterzuladen. Um die Eingabeaufforderung auszublenden, geben Sie `y` an, damit immer die neueste Testsuite heruntergeladen wird, oder `n`, damit die angegebene Testsuite oder die neueste Version auf Ihrem System verwendet wird.
**Example**
**Beispiel**
Verwenden Sie den folgenden Befehl, um immer die neueste Testsuite herunterzuladen und zu verwenden.
```
devicetester_[linux | mac | win_x86-64] run-suite --userdata userdata file --group-id group ID --upgrade-test-suite y
```
Verwenden Sie den folgenden Befehl, um die neueste Testsuite auf Ihrem System zu verwenden.
```
devicetester_[linux | mac | win_x86-64] run-suite --userdata userdata file --group-id group ID --upgrade-test-suite n
```
**h**
Verwenden Sie die Hilfe-Option, um mehr über `run-suite`-Optionen zu erfahren.
**Example**
**Beispiel**
```
devicetester_[linux | mac | win_x86-64] run-suite -h
```
------
#### [ IDT v1.7.0 and earlier ]
```
devicetester_[linux | mac | win] run-suite \
--suite-id suite-id \
--pool-id your-device-pool \
--userdata userdata.json
```
Die Datei `userdata.json` sollte sich im Verzeichnis `devicetester_extract_location/devicetester_afreertos_[win|mac|linux]/configs/` befinden.
**Anmerkung**
Wenn Sie IDT for FreeRTOS unter Windows ausführen, verwenden Sie Schrägstriche (/), um den Pfad zur Datei anzugeben. `userdata.json`
Verwenden Sie den folgenden Befehl zum Ausführen einer bestimmten Testgruppe.
```
devicetester_[linux | mac | win] run-suite \
--suite-id FRQ_1 --group-id group-id \
--pool-id pool-id \
--userdata userdata.json
```
`suite-id` und `pool-id` sind optional, wenn Sie eine einzige Testsuite in einem einzigen Gerätepool ausführen (d. h. Sie haben nur einen Gerätepool in Ihrer `device.json`-Datei definiert).IDT für FreeRTOS-Befehlszeilenoptionen
**group-id**
(Optional) Gibt die Testgruppe an.
**pool-id**
Gibt den Gerätepool an, der getestet werden soll. Wenn Sie nur einen Gerätepool haben, können Sie diese Option weglassen.
**suite-id**
(Optional) Gibt die Testsuite an, die ausgeführt werden soll.
------
## IDT für FreeRTOS-Befehle
Der Befehl IDT for FreeRTOS unterstützt die folgenden Operationen:
------
#### [ IDT v3.0.0 and later ]
**`help`**
Listet Informationen über den angegebenen Befehl auf.
**`list-groups`**
Listet die Gruppen in der jeweiligen Suite auf.
**`list-suites`**
Listet die verfügbaren Suites auf.
**`list-supported-products`**
Listet die unterstützten Produkte und Testsuiteversionen auf.
**`list-supported-versions`**
Listet die FreeRTOS- und Testsuite-Versionen auf, die von der aktuellen IDT-Version unterstützt werden.
**`list-test-cases`**
Listet die Testfälle in einer angegebenen Gruppe auf.
**`run-suite`**
Führt eine Reihe von Tests in einem Pool von Geräten aus.
Verwenden Sie die Option `--suite-id`, um eine Test-Suite-Version anzugeben, oder lassen Sie sie weg, um die neueste Version auf Ihrem System zu verwenden.
Verwenden Sie die `--test-id` um einen einzelnen Testfall auszuführen.
**Example**
```
devicetester_[linux | mac | win_x86-64] run-suite --group-id mqtt --test-id mqtt_test
```
Eine vollständige Liste der Optionen finden Sie unter [Führen Sie die FreeRTOS Qualification Suite aus](#run-tests).
Ab IDT v3.0.0 sucht IDT online nach neueren Testsuiten. Weitere Informationen finden Sie unter [Test-Suite-Versionen](idt-test-suite-versions.md).
------
#### [ IDT v1.7.0 and earlier ]
**`help`**
Listet Informationen über den angegebenen Befehl auf.
**`list-groups`**
Listet die Gruppen in der jeweiligen Suite auf.
**`list-suites`**
Listet die verfügbaren Suites auf.
**`run-suite`**
Führt eine Reihe von Tests in einem Pool von Geräten aus.
------
## Tests für erneute Qualifikationen
Sobald neue Versionen von IDT for FreeRTOS Qualifizierungstests veröffentlicht werden oder wenn Sie Ihre platinenspezifischen Pakete oder Gerätetreiber aktualisieren, können Sie IDT for FreeRTOS verwenden, um Ihre Mikrocontroller-Boards zu testen. Stellen Sie für nachfolgende Qualifikationen sicher, dass Sie über die neuesten Versionen von FreeRTOS und IDT for FreeRTOS verfügen, und führen Sie die Qualifizierungstests erneut durch.