

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.

# Erste Schritte mit der IDT-FreeRTOS-Benutzeroberfläche
<a name="dev-tester-ui-getting-started"></a>

Dieser Abschnitt zeigt Ihnen, wie Sie die IDT-FreeRTOS-Benutzeroberfläche verwenden, um Ihre Konfiguration zu erstellen oder zu ändern, und zeigt Ihnen dann, wie Sie Tests ausführen. 

**Topics**
+ [Anmeldeinformationen konfigurieren AWS](#configure-aws-credentials)
+ [Öffnen Sie die IDT-FreeRTOS-Benutzeroberfläche](#open-idt-ui)
+ [Erstellen Sie eine neue Konfiguration](#create-new-configuration)
+ [Ändern Sie eine bestehende Konfiguration](#modify-existing-configuration)
+ [Führen Sie Qualifizierungstests durch](#run-tests-from-ui)

## Anmeldeinformationen konfigurieren AWS
<a name="configure-aws-credentials"></a>

Sie müssen die Anmeldeinformationen für den AWS Benutzer konfigurieren, den Sie in erstellt haben[Erstellen und konfigurieren Sie ein Konto AWS](dev-tester-ui-prereqs.md#ui-config-aws-account). Sie können Ihre Anmeldeinformationen auf zwei Arten angeben:
+ In einer Anmeldeinformationsdatei
+ Als Umgebungsvariablen

### Konfigurieren Sie AWS Anmeldeinformationen mit einer Anmeldeinformationsdatei
<a name="config-cred-file"></a>

IDT verwendet die gleiche Anmeldeinformationsdatei wie das AWS CLI. Weitere Informationen finden Sie unter [Konfigurations- und Anmeldeinformationsdateien](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html).

Der Speicherort der Anmeldeinformationsdatei variiert je nach verwendetem Betriebssystem:
+ macOS Linux: `~/.aws/credentials`
+ Windows: `C:\Users\UserName\.aws\credentials`

Fügen Sie der `credentials` Datei Ihre AWS Anmeldeinformationen im folgenden Format hinzu:

```
[default]
aws_access_key_id = <your_access_key_id>
aws_secret_access_key = <your_secret_access_key>
```

**Anmerkung**  
Wenn Sie das `default` AWS Profil nicht verwenden, geben Sie unbedingt den Profilnamen in der IDT-FreeRTOS-Benutzeroberfläche an. Weitere Informationen zu Profilen finden Sie unter [Konfiguration und Einstellungen](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html) für Anmeldeinformationsdateien.

### Konfigurieren Sie AWS Anmeldeinformationen mit Umgebungsvariablen
<a name="config-env-vars"></a>

Umgebungsvariablen sind Variablen, die vom Betriebssystem gepflegt und von Systembefehlen verwendet werden. Sie werden nicht gespeichert, wenn Sie die SSH-Sitzung schließen. Die IDT-FreeRTOS-Benutzeroberfläche verwendet die `AWS_SECRET_ACCESS_KEY` Umgebungsvariablen `AWS_ACCESS_KEY_ID` und, um Ihre Anmeldeinformationen zu speichern. AWS 

Um diese Variablen auf Linux, macOS oder Unix festzulegen, verwenden Sie **export**:

```
export AWS_ACCESS_KEY_ID=<your_access_key_id>
export AWS_SECRET_ACCESS_KEY=<your_secret_access_key>
```

In Windows können Sie die Variablen mit **set** festlegen:

```
set AWS_ACCESS_KEY_ID=<your_access_key_id>
set AWS_SECRET_ACCESS_KEY=<your_secret_access_key>
```

## Öffnen Sie die IDT-FreeRTOS-Benutzeroberfläche
<a name="open-idt-ui"></a>

**Um die IDT-FreeRTOS-Benutzeroberfläche zu öffnen**

1. Laden Sie eine unterstützte IDT-FreeRTOS-Version herunter und extrahieren Sie das heruntergeladene Archiv an einen Speicherort auf Ihrem Dateisystem, für den Sie Lese- und Schreibberechtigungen haben.

1. Führen Sie den folgenden Befehl aus, um zum IDT-FreeRTOS-Installationsverzeichnis zu navigieren:

   ```
   cd devicetester-extract-location/bin 
   ```

1. Führen Sie den folgenden Befehl aus, um die IDT-FreeRTOS-Benutzeroberfläche zu öffnen:

------
#### [ Linux ]

   ```
   .devicetestergui_linux_x86-64.exe
   ```

------
#### [ Windows ]

   ```
   ./devicetestergui_win_x64-64
   ```

------
#### [ macOS ]

   ```
   ./devicetestergui_mac_x86-64
   ```

**Anmerkung**  
Gehen Sie auf einem Mac zu **Systemeinstellungen -> Sicherheit und Datenschutz, damit Ihr System** die Benutzeroberfläche ausführen kann. Wenn Sie die Tests ausführen, müssen Sie dies möglicherweise noch dreimal tun.

------

   Die IDT-FreeRTOS-Benutzeroberfläche wird in Ihrem Standardbrowser geöffnet. Informationen zu unterstützten Browsern finden Sie unter. [Verwenden Sie einen unterstützten Webbrowser](dev-tester-ui-prereqs.md#idt-ui-supported-web-browser)

## Erstellen Sie eine neue Konfiguration
<a name="create-new-configuration"></a>

Wenn Sie zum ersten Mal Benutzer sind, müssen Sie eine neue Konfiguration erstellen, um die JSON-Konfigurationsdateien einzurichten, die IDT-FreeRTOS zum Ausführen von Tests benötigt. Anschließend können Sie Tests ausführen oder die erstellte Konfiguration ändern.

Beispiele für die `userdata.json` Dateien `config.json``device.json`, und finden Sie unter[Erster Test Ihres Mikrocontroller-Boards](qual-steps.md). Ein Beispiel für die `resource.json` Datei, die nur für die Ausführung von Bluetooth Low Energy (BLE) -Tests verwendet wird, finden Sie unter[Führen Sie Bluetooth Low Energy-Tests durch](afr-bridgekeeper-dt-bt.md).

**Um eine neue Konfiguration zu erstellen**

1. **Öffnen Sie in der IDT-FreeRTOS-Benutzeroberfläche das Navigationsmenü und wählen Sie dann Neue Konfiguration erstellen.**
**Wichtig**  
Sie müssen Ihre AWS Anmeldeinformationen konfigurieren, bevor Sie die Benutzeroberfläche öffnen. Wenn Sie Ihre Anmeldeinformationen nicht konfiguriert haben, schließen Sie das IDT-FreeRTOS-UI-Browserfenster, folgen Sie den Schritten unter[Anmeldeinformationen konfigurieren AWS](#configure-aws-credentials), und öffnen Sie dann die IDT-FreeRTOS-Benutzeroberfläche erneut.

1. Folgen Sie dem Konfigurationsassistenten, um die IDT-Konfigurationseinstellungen einzugeben, die für die Durchführung von Qualifikationstests verwendet werden. Der Assistent konfiguriert die folgenden Einstellungen in JSON-Konfigurationsdateien, die sich im `devicetester-extract-location/config` Verzeichnis befinden.
   + **AWS settings** — Die AWS-Konto Informationen, die IDT-FreeRTOS verwendet, um AWS Ressourcen während Testläufen zu erstellen. Diese Einstellungen sind in der Datei konfiguriert. `config.json`
   + **FreeRTOS-Repository** — Der absolute Pfad zum FreeRTOS-Repository und zum portierten Code sowie die Art der Qualifikation, die Sie durchführen möchten. Diese Einstellungen sind in der Datei konfiguriert. `userdata.json`

     Sie müssen FreeRTOS für Ihr Gerät portieren, bevor Sie Qualifikationstests durchführen können. Weitere Informationen finden Sie im [FreeRTOS](https://docs.aws.amazon.com/freertos/latest/portingguide/) Porting Guide
   + **Build and Flash** — Die Build- und Flash-Befehle für Ihre Hardware, mit denen IDT automatisch Tests auf Ihrem Board erstellen und flashen kann. Diese Einstellungen sind in der `userdata.json` Datei konfiguriert.
   + **Geräte** — Die Gerätepool-Einstellungen für die zu testenden Geräte. Diese Einstellungen werden in den `sku` Feldern `id` und und im `devices` Block für den Gerätepool in der `device.json` Datei konfiguriert.
   + **Netzwerk** — Die Einstellungen zum Testen der Netzwerkkommunikationsunterstützung für Ihre Geräte. Diese Einstellungen werden im `features` Block der `device.json` Datei und in den `testWifiConfig` Blöcken `clientWifiConfig` und in der `userdata.json` Datei konfiguriert.
   + **Echo-Server** — Die Echo-Server-Konfigurationseinstellungen für Secure-Socket-Tests. Diese Einstellungen sind in der `userdata.json` Datei konfiguriert.

     Weitere Hinweise zur Echo-Serverkonfiguration finden Sie unter[https://docs.aws.amazon.com/freertos/latest/portingguide/afr-echo-server.html](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-echo-server.html).
   + **CMake**— (Optional) Die Einstellungen für die Ausführung von CMake Build-Funktionstests. Diese Konfiguration ist nur erforderlich, wenn Sie sie CMake als Build-System verwenden. Diese Einstellungen sind in der `userdata.json` Datei konfiguriert.
   + **BLE** — Die Einstellungen für die Durchführung von Bluetooth Low Energy-Funktionstests. Diese Einstellungen werden im `features` Block der `device.json` Datei und in der `resource.json` Datei konfiguriert.
   + **OTA** — Die Einstellungen für die Ausführung von OTA-Funktionstests. Diese Einstellungen werden im `features` Block der `device.json` Datei und in der `userdata.json` Datei konfiguriert.

1.  Überprüfen Sie auf der Seite **„**Überprüfen“ Ihre Konfigurationsinformationen. 

Wenn Sie mit der Überprüfung Ihrer Konfiguration fertig sind, wählen Sie Tests **ausführen aus, um Ihre Qualifizierungstests durchzuführen**.

## Ändern Sie eine bestehende Konfiguration
<a name="modify-existing-configuration"></a>

Wenn Sie bereits Konfigurationsdateien für IDT eingerichtet haben, können Sie die IDT-FreeRTOS-Benutzeroberfläche verwenden, um Ihre bestehende Konfiguration zu ändern. Stellen Sie sicher, dass Ihre vorhandenen Konfigurationsdateien im Verzeichnis verfügbar sind. `devicetester-extract-location/config`

**Um eine neue Konfiguration zu ändern**

1. **Öffnen Sie in der IDT-FreeRTOS-Benutzeroberfläche das Navigationsmenü und wählen Sie dann Bestehende Konfiguration bearbeiten aus.**

   Das Konfigurations-Dashboard zeigt Informationen zu Ihren vorhandenen Konfigurationseinstellungen an. Wenn eine Konfiguration falsch oder nicht verfügbar ist, lautet der Status für diese Konfiguration`Error validating configuration`.

1. Gehen Sie wie folgt vor, um eine bestehende Konfigurationseinstellung zu ändern: 

   1. Wählen Sie den Namen einer Konfigurationseinstellung, um die zugehörige Einstellungsseite zu öffnen.

   1. Ändern Sie die Einstellungen und wählen Sie dann **Speichern**, um die entsprechende Konfigurationsdatei neu zu generieren.

Nachdem Sie die Änderung Ihrer Konfiguration abgeschlossen haben, stellen Sie sicher, dass alle Ihre Konfigurationseinstellungen die Validierung bestanden haben. Wenn der Status für jede Konfigurationseinstellung lautet`Valid`, können Sie Ihre Qualifizierungstests mit dieser Konfiguration ausführen.

## Führen Sie Qualifizierungstests durch
<a name="run-tests-from-ui"></a>

Nachdem Sie eine Konfiguration für IDT-FreerTOS erstellt haben, können Sie Ihre Qualifizierungstests ausführen.

**Um Qualifizierungstests durchzuführen**

1. Überprüfen Sie Ihre Konfiguration.

1. Wählen Sie im Navigationsmenü die Option **Tests ausführen aus**.

1. Um den Testlauf zu starten, wählen Sie **Tests starten**.

**IDT-FreerTOS führt die Qualifikationstests aus und zeigt die Zusammenfassung des Testlaufs sowie alle Fehler in der Test Runner-Konsole an.** Nach Abschluss des Testlaufs können Sie die Testergebnisse und Protokolle an den folgenden Orten einsehen: 
+ Die Testergebnisse befinden sich im `devicetester-extract-location/results/execution-id` Verzeichnis.
+ Testprotokolle befinden sich im `devicetester-extract-location/results/execution-id/logs` Verzeichnis.

Weitere Informationen zu Testergebnissen und Protokollen finden Sie unter [Sehen Sie sich die Ergebnisse von IDT for FreeRTOS an](view-results-frq.md) und[Die IDT for FreeRTOS-Protokolle anzeigen](view-logs-frq.md).