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.

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

In diesem Abschnitt erfahren Sie, wie Sie die IDT-FreeRTOS Benutzeroberfläche verwenden, um Ihre Konfiguration zu erstellen oder zu ändern, und zeigt Ihnen anschließend, wie Sie Tests ausführen. 

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

## Konfiguration AWS Anmeldedaten
<a name="configure-aws-credentials"></a>

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

### Konfiguration 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, achten Sie darauf, den Profilnamen in der IDT-FreeRTOS Benutzeroberfläche anzugeben. 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.

### Konfiguration 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 AWS Anmeldeinformationen zu speichern.

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 in 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 zum Ausführen von Tests IDT-FreeRTOS erforderlich sind. 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).

**So erstellen Sie eine neue Konfiguration **

1. Öffnen Sie in der IDT-FreeRTOS Benutzeroberfläche das Navigationsmenü und wählen Sie dann Neue Konfiguration ** erstellen aus**.
**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 Benutzeroberflächen-Browserfenster, folgen Sie den Schritten [Konfiguration AWS Anmeldedaten](#configure-aws-credentials) unter, und öffnen Sie die IDT-FreeRTOS Benutzeroberfläche erneut.

1. Folgen Sie dem Konfigurationsassistenten, um die IDT-Konfigurationseinstellungen einzugeben, die zur 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 Einstellungen ** — Die AWS-Konto Informationen, die zur Erstellung von AWS Ressourcen bei Testläufen IDT-FreeRTOS verwendet werden. Diese Einstellungen werden in der `config.json` Datei konfiguriert.
   + **FreeRTOS-Repository ** — Der absolute Pfad zum FreeRTOS-Repository und zum portierten Code sowie die Art der Qualifizierung, die Sie durchführen möchten. Diese Einstellungen werden 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-Portierungshandbuch ](https://docs.aws.amazon.com/freertos/latest/portingguide/)
   + **Build und Flash ** — Die Build- und Flash-Befehle für Ihre Hardware, die es IDT ermöglichen, Tests automatisch zu erstellen und auf Ihrem Board zu installieren. Diese Einstellungen werden 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 konfiguriert, und der `devices` Block für den Gerätepool befindet sich in der `device.json` Datei.
   + **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` Und-Blöcken in der `userdata.json` Datei konfiguriert. `clientWifiConfig`
   + **Echo-Server ** — Die Echo-Server-Konfigurationseinstellungen für Secure-Socket-Tests. Diese Einstellungen werden in der `userdata.json` Datei konfiguriert.

     Weitere Hinweise zur Konfiguration des Echo-Servers 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 zum Ausführen von CMake Build-Funktionstests. Diese Konfiguration ist nur erforderlich, wenn Sie CMake als Build-System verwenden. Diese Einstellungen werden in der `userdata.json` Datei konfiguriert.
   + **BLE ** —Die Einstellungen für die Ausfü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 zum Ausführen 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. 

Nachdem Sie die Überprüfung Ihrer Konfiguration abgeschlossen haben, wählen Sie Tests ** ausführen aus, um Ihre Qualifikationstests durchzuführen**.

## Ändern Sie eine vorhandene 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 `{{devicetester-extract-location}}/config` Verzeichnis verfügbar sind.

**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 vorhandene 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 bestehen. Wenn der Status für jede Konfigurationseinstellung lautet`Valid`, können Sie Ihre Qualifikationstests mit dieser Konfiguration ausführen.

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

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

**Um Qualifikationstests durchzuführen **

1. Validieren 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 Stellen einsehen: 
+ Die Testergebnisse befinden sich im `{{devicetester-extract-location}}/results/{{execution-id}}` Verzeichnis.
+ Die Testprotokolle befinden sich im `{{devicetester-extract-location}}/results/{{execution-id}}/logs` Verzeichnis.

Weitere Hinweise zu Testergebnissen und Protokollen finden Sie unter [Sehen Sie sich die Ergebnisse von IDT für FreeRTOS an](view-results-frq.md) und[Sehen Sie sich die IDT für FreeRTOS-Logs an](view-logs-frq.md).