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
**Wichtig**
Diese Seite bezieht sich auf das Amazon-FreeRTOS Repository, das veraltet ist. Wir empfehlen, dass Sie [hier beginnen](freertos-getting-started-modular.md), wenn Sie ein neues Projekt erstellen. Wenn Sie bereits ein bestehendes FreeRTOS-Projekt haben, das auf dem inzwischen veralteten Amazon-FreeRTOS Repository basiert, finden Sie weitere Informationen unter. [Amazon-FreeRTOS Leitfaden zur Migration zum Github-Repository](github-repo-migration.md)
Um mit der Nutzung von FreeRTOS zu beginnen AWS IoT, benötigen Sie ein AWS Konto, einen Benutzer mit Zugriffsberechtigungen AWS IoT und FreeRTOS-Cloud-Dienste. Sie müssen auch FreeRTOS herunterladen und das FreeRTOS-Demo-Projekt Ihres Boards so konfigurieren, dass es funktioniert. AWS IoT In den folgenden Abschnitten finden Sie schrittweise Anleitungen, um diese Anforderungen zu erfüllen.
**Anmerkung**
Wenn du den Espressif oder den verwendest ESP32-DevKitC ESP-WROVER-KIT, überspringe diese Schritte ESP32-WROOM-32SE und gehe zu. [Erste Schritte mit dem Espressif ESP32-DevKitC und dem ESP-WROVER-KIT](getting_started_espressif.md)
Wenn Sie den Nordic n verwendenRF52840-DK, überspringen Sie diese Schritte und fahren Sie mit. [Erste Schritte mit dem Nordic n RF52840-DK](getting_started_nordic.md)
1. [Einrichtung Ihres AWS Konto und Berechtigungen](#freertos-account-and-permissions)
1. [Registrieren Sie Ihr MCU-Board bei AWS IoT](#get-started-freertos-thing)
1. [FreeRTOS wird heruntergeladen](#freertos-download)
1. [Konfiguration der FreeRTOS-Demos](#freertos-configure)
## Einrichtung Ihres AWS Konto und Berechtigungen
### Melde dich an für ein AWS-Konto
Um loszulegen AWS, benötigen Sie eine AWS-Konto. Informationen zum Erstellen eines AWS-Konto finden Sie unter [Erste Schritte mit einem AWS-Konto](https://docs.aws.amazon.com//accounts/latest/reference/getting-started.html) im *AWS -Kontenverwaltung Referenzhandbuch*.
Um Zugriff zu gewähren, fügen Sie Ihren Benutzern, Gruppen oder Rollen Berechtigungen hinzu:
+ Benutzer und Gruppen in AWS IAM Identity Center:
Erstellen Sie einen Berechtigungssatz. Befolgen Sie die Anweisungen unter [Erstellen eines Berechtigungssatzes](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) im *AWS IAM Identity Center -Benutzerhandbuch*.
+ Benutzer, die in IAM über einen Identitätsanbieter verwaltet werden:
Erstellen Sie eine Rolle für den Identitätsverbund. Befolgen Sie die Anleitung unter [Eine Rolle für einen externen Identitätsanbieter (Verbund) erstellen](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) im *IAM-Benutzerhandbuch*.
+ IAM-Benutzer:
+ Erstellen Sie eine Rolle, die Ihr Benutzer annehmen kann. Befolgen Sie die Anleitung unter [Eine Rolle für einen IAM-Benutzer erstellen](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) im *IAM-Benutzerhandbuch*.
+ (Nicht empfohlen) Weisen Sie einem Benutzer eine Richtlinie direkt zu oder fügen Sie einen Benutzer zu einer Benutzergruppe hinzu. Befolgen Sie die Anweisungen unter [Hinzufügen von Berechtigungen zu einem Benutzer (Konsole)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) im *IAM-Benutzerhandbuch*.
## Registrieren Sie Ihr MCU-Board bei AWS IoT
Ihr Board muss registriert sein, AWS IoT um mit der AWS Cloud kommunizieren zu können. Um dein Board zu registrieren AWS IoT, benötigst du:
**Eine AWS IoT Richtlinie**
Die AWS IoT Richtlinie gewährt Ihrem Gerät Berechtigungen für den Zugriff auf AWS IoT Ressourcen. Es wird in der AWS Cloud gespeichert.
**Irgendein AWS IoT Ding**
Jedes AWS IoT Ding ermöglicht es Ihnen, Ihre Geräte in zu verwalten AWS IoT. Es ist in der AWS Cloud gespeichert.
**Ein privater Schlüssel und ein X.509 Zertifikat**
Mit dem privaten Schlüssel und dem Zertifikat kann sich Ihr Gerät authentifizieren. AWS IoT
Gehen Sie wie folgt vor, um Ihr Board zu registrieren.
**Um ein zu erstellen AWS IoT policy**
1. Um eine IAM-Richtlinie zu erstellen, müssen Sie Ihre AWS Region und AWS Kontonummer kennen.
**Um Ihre AWS Kontonummer zu finden, öffnen Sie die [AWS Management Console](https://console.aws.amazon.com/), suchen und erweitern Sie das Menü unter Ihrem Kontonamen in der oberen rechten Ecke und wählen Sie Mein Konto aus.** Ihre Konto-ID wird unter **Kontoeinstellungen** angezeigt.
Um die AWS Region für Ihr AWS Konto zu finden, verwenden Sie die. AWS Command Line Interface Folgen Sie den Anweisungen im [AWS Command Line Interface Benutzerhandbuch AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html), um das zu installieren. Öffnen Sie nach der AWS CLI Installation von ein Befehlszeilenfenster und geben Sie den folgenden Befehl ein:
```
aws iot describe-endpoint --endpoint-type=iot:Data-ATS
```
Die Ausgabe sollte in etwa wie folgt aussehen:
```
{
"endpointAddress": "xxxxxxxxxxxxxx-ats.iot.us-west-2.amazonaws.com"
}
```
In diesem Beispiel ist die Region `us-west-2`.
**Anmerkung**
Wir empfehlen die Verwendung von ATS-Endpunkten, wie im Beispiel gezeigt.
1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iotv2/).
1. Wählen Sie im Navigationsbereich erst **Sicher**, dann **Richtlinien** und anschließend **Erstellen** aus.
1. Geben Sie einen Namen zur Identifizierung Ihrer Richtlinie ein.
1. Wählen Sie im Abschnitt **Anweisungen hinzufügen** die Option **Erweiterter Modus** aus. Kopieren Sie die folgende JSON und fügen Sie sie in das Fenster des Richtlinien-Editors ein. Ersetzen Sie `{{aws-region}}` und `{{aws-account}}` durch Ihre AWS Region und Konto-ID.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iot:Connect",
"Resource": "arn:aws:iot:{{us-east-1}}:{{123456789012}}:*"
},
{
"Effect": "Allow",
"Action": "iot:Publish",
"Resource": "arn:aws:iot:{{us-east-1}}:{{123456789012}}:*"
},
{
"Effect": "Allow",
"Action": "iot:Subscribe",
"Resource": "arn:aws:iot:{{us-east-1}}:{{123456789012}}:*"
},
{
"Effect": "Allow",
"Action": "iot:Receive",
"Resource": "arn:aws:iot:{{us-east-1}}:{{123456789012}}:*"
}
]
}
```
------
Durch diese Richtlinie werden die folgenden Berechtigungen gewährt:
**`iot:Connect`**
Erteilt Ihrem Gerät die Erlaubnis, mit einer beliebigen Client-ID eine Verbindung zum AWS IoT Message Broker herzustellen.
**`iot:Publish`**
Erteilt Ihrem Gerät die Berechtigung für die Veröffentlichung einer MQTT-Nachricht zu jedem MQTT-Thema.
**`iot:Subscribe`**
Erteilt Ihrem Gerät die Berechtigung für die Abonnierung eines MQTT-Themenfilters.
**`iot:Receive`**
Erteilt Ihrem Gerät die Berechtigung zum Erhalt von Mitteilungen aus dem AWS IoT -Message Broker zu jedem MQTT-Thema.
1. Wählen Sie **Erstellen** aus.
**So erstellen Sie ein IoT-Objekt, einen privaten Schlüssel und ein Zertifikat für Ihr Gerät:**
1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iotv2/).
1. Wählen Sie im Navigationsbereich **Verwalten** und dann **Objekte** aus.
1. Wenn keine IoT-Objekte in Ihrem Konto registriert sind, wird die Seite **Sie haben noch keine Objekte** angezeigt. Wenn Sie diese Seite sehen, wählen Sie **Ein Objekt registrieren** aus. Wählen Sie andernfalls **Erstellen**.
1. Wählen Sie auf der Seite „** AWS IoT Dinge erstellen****“ die Option Eine einzelne Sache** erstellen aus.
1. Geben Sie auf der Seite **Fügen Sie Ihr Gerät zur Objektregistrierung hinzu** einen Namen für Ihr Objekt ein und klicken Sie dann auf **Weiter**.
1. Wählen Sie auf der Seite **Zertifikat für Ihr Ding hinzufügen** unter **One-click Zertifikatserstellung** die Option **Zertifikat erstellen** aus.
1. Laden Sie Ihren privaten Schlüssel und das Zertifikat herunter, indem Sie die Links zum **Herunterladen** für jeden Vorgang auswählen.
1. Wählen Sie **Aktivieren** aus, um Ihr Zertifikat zu aktivieren. Die Zertifikate müssen aktiviert werden, bevor Sie sie verwenden können.
1. Wählen Sie **Richtlinie anhängen**, um Ihrem Zertifikat eine Richtlinie anzuhängen, die Ihrem Gerät Zugriff auf AWS IoT Vorgänge gewährt.
1. Wählen Sie die soeben erstellte Richtlinie und dann **Objekt registrieren** aus.
Nachdem dein Board registriert wurde AWS IoT, kannst du damit fortfahren[FreeRTOS wird heruntergeladen](#freertos-download).
## FreeRTOS wird heruntergeladen
[Sie können FreeRTOS aus dem FreeRTOS-Repository herunterladen. GitHub ](https://github.com/freertos/freertos)
Nachdem Sie FreeRTOS heruntergeladen haben, können Sie fortfahren. [Konfiguration der FreeRTOS-Demos](#freertos-configure)
## Konfiguration der FreeRTOS-Demos
Sie müssen einige Konfigurationsdateien in Ihrem FreeRTOS-Verzeichnis bearbeiten, bevor Sie Demos auf Ihrem Board kompilieren und ausführen können.
**Um deine zu konfigurieren AWS IoT Endpunkt**
Sie müssen FreeRTOS Ihren AWS IoT Endpunkt angeben, damit die auf Ihrem Board laufende Anwendung Anfragen an den richtigen Endpunkt senden kann.
1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iotv2/).
1. Wählen Sie im linken Navigationsbereich die Option **Einstellungen** aus.
Ihr AWS IoT Endpunkt wird unter **Gerätedatenendpunkt** angezeigt. Sie sollte wie folgt aussehen: `{{1234567890123}}-ats.iot.{{us-east-1}}.amazonaws.com`. Notieren Sie sich diesen Endpunkt.
1. Wählen Sie im Navigationsbereich **Verwalten** und dann **Objekte** aus.
Ihr Gerät sollte einen AWS IoT Namen haben. Notieren Sie sich diesen Namen.
1. Öffnen Sie `demos/include/aws_clientcredential.h`.
1. Geben Sie für die folgenden -Konstanten Werte an:
+ `#define clientcredentialMQTT_BROKER_ENDPOINT "{{Your AWS IoT endpoint}}";`
+ `#define clientcredentialIOT_THING_NAME "{{The AWS IoT thing name of your board}}"`
**Um deine zu konfigurieren Wi-Fi**
Wenn Ihr Board über eine Wi-Fi Verbindung mit dem Internet verbunden ist, müssen Sie FreeRTOS Wi-Fi Anmeldeinformationen zur Verfügung stellen, um eine Verbindung zum Netzwerk herzustellen. Wenn Ihr Board dies nicht unterstützt Wi-Fi, können Sie diese Schritte überspringen.
1. `demos/include/aws_clientcredential.h`.
1. Geben Sie für die folgenden `#define`-Konstanten Werte an:
+ `#define clientcredentialWIFI_SSID "{{The SSID for your Wi-Fi network}}"`
+ `#define clientcredentialWIFI_PASSWORD "{{The password for your Wi-Fi network}}"`
+ `#define clientcredentialWIFI_SECURITY` {{The security type of your Wi-Fi network}}
Gültige Sicherheitstypen sind:
+ `eWiFiSecurityOpen` (Open, no security (Offen, keine Sicherheit)
+ `eWiFiSecurityWEP` (WEP-Sicherheit)
+ `eWiFiSecurityWPA` (WPA-Sicherheit)
+ `eWiFiSecurityWPA2` (WPA2-Sicherheit)
**Um deine zu formatieren AWS IoT Anmeldedaten**
FreeRTOS muss über das AWS IoT Zertifikat und die privaten Schlüssel verfügen, die mit Ihrem registrierten Ding verknüpft sind, sowie über dessen Berechtigungsrichtlinien, um erfolgreich im Namen Ihres Geräts mit AWS IoT FreeRTOS kommunizieren zu können.
**Anmerkung**
Um Ihre AWS IoT Anmeldeinformationen zu konfigurieren, benötigen Sie den privaten Schlüssel und das Zertifikat, die Sie bei der Registrierung Ihres Geräts von der AWS IoT Konsole heruntergeladen haben. Nachdem Sie Ihr Gerät als Objekt registriert haben AWS IoT , können Sie Gerätezertifikate von der AWS IoT Konsole abrufen, aber Sie können keine privaten Schlüssel abrufen.
FreeRTOS ist ein Projekt in C-Sprache, und das Zertifikat und der private Schlüssel müssen speziell formatiert sein, um dem Projekt hinzugefügt zu werden.
1. Öffnen Sie `tools/certificate_configuration/CertificateConfigurator.html` im Browserfenster.
1. Wählen Sie unter **Certificate PEM file (PEM-Datei für Zertifikat)** die Option `{{ID}}-certificate.pem.crt` aus, die Sie von der AWS IoT -Konsole heruntergeladen haben.
1. Wählen Sie unter **Private Key PEM file (PEM-Datei für privaten Schlüssel)** die Option `{{ID}}-private.pem.key` aus, die Sie von der AWS IoT -Konsole heruntergeladen haben.
1. Wählen Sie **Generate and save aws\_clientcredential\_keys.h (aws\_clientcredential\_keys.h generieren und speichern)** aus und speichern Sie die Datei in `demos/include`. Diese Einstellung überschreibt die vorhandene Datei im Verzeichnis.
**Anmerkung**
Das Zertifikat und der private Schlüssel sind nur zu Demonstrationszwecken fest codiert. Production-level Anwendungen sollten diese Dateien an einem sicheren Ort speichern.
Nachdem Sie FreeRTOS konfiguriert haben, können Sie mit dem Handbuch Erste Schritte für Ihr Board fortfahren, um die Hardware und die Softwareentwicklungsumgebung Ihrer Plattform einzurichten, und dann die Demo kompilieren und auf Ihrem Board ausführen. Board-spezifische Anweisungen finden Sie unter [Board-specific Anleitungen für die ersten Schritte](getting-started-guides.md). Die Demo-Anwendung, die im Getting Started-Tutorial verwendet wird, ist die CoreMQTT Mutual Authentication-Demo, die sich unter befindet. `demos/coreMQTT/mqtt_demo_mutual_auth.c`