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 dem MediaTek MT7697 Hx Development Kit
**Wichtig**
Diese Referenzintegration wird im Amazon-FreeRTOS-Repository gehostet, das veraltet ist. Wir empfehlen, dass Sie [hier beginnen](freertos-getting-started-modular.md), wenn Sie ein neues Projekt erstellen. Wenn Sie bereits ein vorhandenes FreeRTOS-Projekt haben, das auf dem inzwischen veralteten Amazon-FreeRTOS-Repository basiert, finden Sie weitere Informationen unter. [Leitfaden zur Migration des Amazon-FreerTOS Github-Repositorys](github-repo-migration.md)
Dieses Tutorial enthält Anweisungen für die ersten Schritte mit dem Hx Development Kit. MediaTek MT7697 [Wenn Sie das MediaTek MT7697 Hx Development Kit nicht haben, besuchen Sie den AWS Partner-Gerätekatalog, um eines von unserem Partner zu erwerben.](https://devices.amazonaws.com/detail/a3G0L00000AAOmPUAX/MT7697Hx-Development-Kit)
Bevor Sie beginnen, müssen Sie FreeRTOS konfigurieren AWS IoT und herunterladen, um Ihr Gerät mit der AWS Cloud zu verbinden. Detaillierte Anweisungen finden Sie unter [Erste Schritte](freertos-prereqs.md). In diesem Tutorial wird der Pfad zum FreeRTOS-Download-Verzeichnis als bezeichnet. `freertos`
## -Übersicht
Dieses Tutorial enthält Anweisungen für die folgenden ersten Schritte:
1. Installieren von Software auf dem Host-Computer zum Entwickeln und Debuggen eingebetteter Anwendungen für Ihr Mikrocontroller-Board.
1. Cross-Compilierung einer FreeRTOS-Demo-Anwendung zu einem Binär-Image.
1. Laden des binären Anwendungs-Image auf Ihr Board und Ausführen der Anwendung.
1. Interaktion mit der Anwendung, die auf Ihrem Board über eine serielle Verbindung ausgeführt wird, zu Überwachungs- und Debuggingzwecken.
## Einrichten Ihrer Entwicklungsumgebung
Bevor Sie Ihre Umgebung einrichten, schließen Sie Ihren Computer an den USB-Anschluss des MediaTek MT7697 Hx Development Kit an.
### Herunterladen und Installieren von Keil MDK
Sie können das GUI-basierte Keil Microcontroller Development Kit (MDK) verwenden, um FreeRTOS-Projekte auf Ihrem Board zu konfigurieren, zu erstellen und auszuführen. Keil MDK beinhaltet die μVision IDE und den μVision Debugger.
**Anmerkung**
Keil MDK wird ausschließlich auf 64-Bit-Computern mit Windows 7, Windows 8 oder Windows 10 unterstützt.
**So laden Sie das Keil MDK herunter und installieren es**
1. Rufen Sie die Seite [Erste Schritte mit Keil MDK](http://www2.keil.com/mdk5/install/) auf und wählen Sie **Download MDK-Core (MDK-Core herunterladen)**.
1. Geben Sie Ihre Daten ein und senden Sie sie, um sich bei Keil zu registrieren.
1. Klicken Sie mit der rechten Maustaste auf die ausführbare MDK-Datei und speichern Sie das Keil MDK-Installationsprogramm auf Ihrem Computer.
1. Öffnen Sie das Keil MDK-Installationsprogramm und befolgen Sie die Schritte zum Abschluss der Installation. Stellen Sie sicher, dass Sie das MediaTek Gerätepaket (Serie) installieren. MT76x7
## Herstellen einer seriellen Verbindung
Connect das Board mit einem USB-Kabel mit Ihrem Host-Computer. Im Windows-Geräte-Manager wird ein COM-Anschluss angezeigt. Zum Debuggen können Sie mit einem Terminal-Hilfsprogramm wie HyperTerminal oder TeraTerm eine Sitzung für den Port öffnen.
## Überwachung von MQTT-Nachrichten in der Cloud
Bevor Sie das FreeRTOS-Demoprojekt ausführen, können Sie den MQTT-Client in der AWS IoT Konsole so einrichten, dass er die Nachrichten überwacht, die Ihr Gerät an die Cloud sendet. AWS
**Um das MQTT-Thema mit dem MQTT-Client zu abonnieren AWS IoT**
1. Melden Sie sich bei der [AWS IoT-Konsole](https://console.aws.amazon.com/iotv2/) an.
1. Wählen Sie im Navigationsbereich Test und dann **MQTT-Testclient** aus, um den **MQTT-Client** zu öffnen.
1. Geben Sie im Feld **Subscription topic (Abonnementthema)** die Option ***your-thing-name*example/topic** ein und wählen Sie dann **Subscribe to topic (Thema abonnieren)**.
Wenn das Demo-Projekt erfolgreich auf Ihrem Gerät ausgeführt wird, sehen Sie „Hello World\$1“ mehrfach zu dem Thema gesendet, das Sie abonniert haben.
## Erstellen und starten Sie das FreeRTOS-Demoprojekt mit Keil MDK
**Um das FreeRTOS-Demo-Projekt in Keil μVision zu erstellen**
1. Öffnen **Sie im Startmenü** Keil μVision 5.
1. Öffnen Sie die Projektdatei `projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/aws_demos.uvprojx`.
1. Wählen Sie im Menü **Project (Projekt)** aus und wählen Sie dann **Build target (Ziel erstellen)**.
Nachdem der Code erstellt wurde, sehen Sie die ausführbare Datei der Demo als `projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/out/Objects/aws_demo.axf`.
**Um das FreeRTOS-Demo-Projekt auszuführen**
1. Stellen Sie das MediaTek MT7697 Hx Development Kit in den PROGRAMM-Modus.
Um den Modus PROGRAM festzulegen, halten Sie die **PROG**-Taste gedrückt. Halten Sie die **PROG**-Taste weiterhin gedrückt, drücken Sie die **RESET**-Taste und lassen Sie sie wieder los und lassen Sie anschließend die **PROG**-Taste los.
1. Wählen Sie im Menü **Flash** und anschließend **Configure Flash Tools (Flash-Tools konfigurieren)** aus.
1. Wählen Sie in **Options for Target (Optionen für Ziel) '`aws_demo`'** die Registerkarte **Debug (Debuggen)** aus. Wählen Sie **Use (Verwenden)**, legen Sie als Debugger **CMSIS-DAP Debugger** fest und wählen Sie dann **OK**.
1. Wählen Sie im Menü die Option **Flash** und anschließend **Download (Herunterladen)** aus.
μVision benachrichtigt Sie, wenn der Download abgeschlossen ist.
1. Verwenden Sie ein Terminal-Dienstprogramm, um das Fenster der seriellen Konsole zu öffnen. Legen Sie den seriellen Port auf 115200 bps, keine Parität, 8 Bits und 1 Stoppbit fest.
1. Wählen Sie die **RESET-Taste** auf Ihrem MediaTek MT7697 Hx Development Kit.
## Fehlerbehebung
### Debuggen von FreeRTOS-Projekten in Keil μVision
Derzeit müssen Sie das in Keil μVision enthaltene MediaTek Paket bearbeiten, bevor Sie das FreeRTOS-Demoprojekt für mit Keil μVision debuggen können. MediaTek
**Um das MediaTek Paket zum Debuggen von FreeRTOS-Projekten zu bearbeiten**
1. Suchen und öffnen Sie die Datei `Keil_v5\ARM\PACK\.Web\MediaTek.MTx.pdsc` in Ihrem Keil-MDK-Installationsordner.
1. Ersetzen Sie alle Instances von `flag = Read32(0x20000000);` mit `flag = Read32(0x0010FBFC);`.
1. Ersetzen Sie alle Instances von `Write32(0x20000000, 0x76877697);` mit `Write32(0x0010FBFC, 0x76877697);`.
**So starten Sie das Debugging des Projekts**
1. Wählen Sie im Menü **Flash** und anschließend **Configure Flash Tools (Flash-Tools konfigurieren)** aus.
1. Wählen Sie die Registerkarte **Target (Ziel)** und wählen Sie dann **Read/Write Memory Areas (Speicherbereiche lesen/Auf Speicherbereiche schreiben)** aus. Bestätigen Sie das IRAM1 und beide IRAM2 sind ausgewählt.
1. Wählen Sie die Registerkarte **Debug (Debuggen)** und anschließend **CMSIS-DAP Debugger**.
1. Öffnen Sie `vendors/mediatek/boards/mt7697hx-dev-kit/aws_demos/application_code/main.c` und legen Sie das Makro `MTK_DEBUGGER` auf `1` fest.
1. Erstellen Sie das Demo-Projekt in μVision neu.
1. Stellen Sie das MediaTek MT7697 Hx Development Kit in den PROGRAMM-Modus.
Um den Modus PROGRAM festzulegen, halten Sie die **PROG**-Taste gedrückt. Halten Sie die **PROG**-Taste weiterhin gedrückt, drücken Sie die **RESET**-Taste und lassen Sie sie wieder los und lassen Sie anschließend die **PROG**-Taste los.
1. Wählen Sie im Menü die Option **Flash** und anschließend **Download (Herunterladen)** aus.
μVision benachrichtigt Sie, wenn der Download abgeschlossen ist.
1. Drücken Sie die **RESET-Taste** an Ihrem MediaTek MT7697 Hx Development Kit.
1. Wählen Sie im μVision-Menü **Debug und anschließend Debug-Sitzung** **starten/beenden**. Das Fenster **Call Stack \$1 Locals (Aufrufstapel und Lokale)** öffnet sich, wenn Sie eine Debug-Sitzung starten.
1. Wählen Sie im Menü **Debug**, und dann **Stop (Anhalten)** aus, um die Codeausführung anzuhalten. Der Programmzähler stoppt an der folgenden Zeile:
```
{ volatile int wait_ice = 1 ; while ( wait_ice ) ; }
```
1. Ändern Sie im Fenster **Call Stack \$1 Locals (Aufrufstapel und Lokale)** den Wert für `wait_ice` in `0`.
1. Legen Sie Haltepunkte im Quellcode Ihres Projekts fest und führen Sie den Code aus.
### Fehlerbehebung für die IDE-Debugger-Einstellungen
Wenn Sie Probleme beim Debuggen einer Anwendung haben, sind Ihre Debugger-Einstellungen möglicherweise nicht korrekt.
**So überprüfen Sie, ob Ihre Debugger-Einstellungen korrekt sind**
1. Öffnen Sie Keil µVision.
1. Klicken Sie mit der rechten Maustaste auf das Projekt `aws_demos`, wählen Sie **Options (Optionen)** und auf der Registerkarte **Utilities (Dienstprogramme)** **Settings (Einstellungen)** aus, neben **-- Use Debug Driver -- (Debug-Treiber verwenden)**.
1. Überprüfen Sie, ob die Einstellungen auf der Registerkarte **Debug (Debuggen)** wie folgt angezeigt werden:
![\[CMSIS-DAP Cortex-M-Zieltreiber-Setup-Dialog mit Seriennummer, Firmware-Version, Adaptertyp, SW-Geräteoptionen und Konfigurationseinstellungen.\]](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/mediatek-debug-2.png)
1. Überprüfen Sie, ob die Einstellungen auf der Registerkarte **Flash Download (Flash-Download9** wie folgt angezeigt werden:
![\[Fenster zur Einrichtung des Cortex-M Target-Treibers mit Optionen für Download-Funktion, RAM für Algorithmus, Beschreibung des Programmieralgorithmus und Gerätedetails.\]](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/mediatek-debug-3.png)
Allgemeine Informationen zur Problembehandlung bei Getting Started with FreeRTOS finden Sie unter. [Fehlerbehebung – Erste Schritte](gsg-troubleshooting.md)