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. # Tutorial: Verwenden des AWS IoT Device SDK for Embedded C In diesem Abschnitt wird beschrieben, wie Sie den ausführen AWS IoT Device SDK for Embedded C. **Topics** + [Schritt 1: Installieren Sie das AWS IoT Device SDK for Embedded C](#install-embedded-c-sdk) + [Schritt 2: Konfigurieren der Beispielanwendung](#iot-c-sdk-app-config) + [Schritt 3: So laden Sie die Beispielanwendung herunter und führen sie aus](#iot-c-sdk-app-run) ## Schritt 1: Installieren Sie das AWS IoT Device SDK for Embedded C Das AWS IoT Device SDK for Embedded C richtet sich im Allgemeinen an Geräte mit eingeschränkten Ressourcen, die eine optimierte Laufzeit in C-Sprache benötigen. Sie können das SDK auf jedem Betriebssystem verwenden und es auf jedem Prozessortyp hosten (z. B. MCUs und MPUs). Wenn Sie mehr Speicher- und Verarbeitungsressourcen zur Verfügung haben, empfehlen wir, eines der AWS IoT Geräte- und Mobile-SDKs höherer Ordnung zu verwenden (z. B. C\+\+ JavaScript, Java und Python). Im Allgemeinen AWS IoT Device SDK for Embedded C ist das für Systeme vorgesehen, die MCUs oder Low-End-MPUs verwenden, auf denen eingebettete Betriebssysteme ausgeführt werden. Für das Programmierbeispiel in diesem Abschnitt gehen wir davon aus, dass Ihr Gerät Linux verwendet. **Example** 1. Laden Sie das von AWS IoT Device SDK for Embedded C auf Ihr Gerät herunter. [GitHub](https://github.com/aws/aws-iot-device-sdk-embedded-C) ``` git clone https://github.com/aws/aws-iot-device-sdk-embedded-c.git --recurse-submodules ``` Dadurch wird ein Verzeichnis mit dem Namen `aws-iot-device-sdk-embedded-c` im aktuellen Verzeichnis erstellt. 1. Navigieren Sie zu diesem Verzeichnis und machen Sie sich mit der neuesten Version vertraut. Bitte sehen Sie sich [Github an. com/awsC/tags/aws-iot-device-sdk-embedded-](https://github.com/aws/aws-iot-device-sdk-embedded-C/tags) für das neueste Release-Tag. ``` cd aws-iot-device-sdk-embedded-c git checkout {{latest-release-tag}} ``` 1. Installieren Sie die OpenSSL-Version 1.1.0 oder höher. Die OpenSSL-Entwicklungsbibliotheken werden in der Regel „libssl-dev“ oder „openssl-devel“ genannt, wenn sie über einen Paketmanager installiert werden. ``` sudo apt-get install libssl-dev ``` ## Schritt 2: Konfigurieren der Beispielanwendung Das beinhaltet Beispielanwendungen, die Sie AWS IoT Device SDK for Embedded C ausprobieren können. Der Einfachheit halber wird in diesem Tutorial die `mqtt_demo_mutual_auth` Anwendung verwendet, die veranschaulicht, wie Sie eine Verbindung zum AWS IoT Core Message Broker herstellen und MQTT-Themen abonnieren und veröffentlichen. 1. Kopieren Sie das Zertifikat und den privaten Schlüssel, den Sie in [Erste Schritte mit AWS IoT Core   Tutorials](iot-gs.md) erstellt haben, in das Verzeichnis `build/bin/certificates`. **Anmerkung** Geräte- und CA-Stammzertifikate laufen ab oder können widerrufen werden. Wenn diese Zertifikate ablaufen oder widerrufen werden, müssen Sie ein neues CA-Zertifikat oder einen privaten Schlüssel und ein Gerätezertifikat auf Ihr Gerät kopieren. 1. Sie müssen das Beispiel mit Ihrem persönlichen AWS IoT Core Endpunkt, Ihrem privaten Schlüssel, Ihrem Zertifikat und Ihrem Root-CA-Zertifikat konfigurieren. Navigieren Sie zum `aws-iot-device-sdk-embedded-c/demos/mqtt/mqtt_demo_mutual_auth` Verzeichnis . Wenn Sie das AWS CLI installiert haben, können Sie diesen Befehl verwenden, um die Endpunkt-URL Ihres Kontos zu finden. ``` aws iot describe-endpoint --endpoint-type iot:Data-ATS ``` Wenn Sie den nicht AWS CLI installiert haben, öffnen Sie Ihre [AWS IoT Konsole](https://console.aws.amazon.com/iot/home). Wählen Sie im Navigationsbereich **Verwalten** und dann **Objekte** aus. Wählen Sie das IoT-Objekt für Ihr Gerät und dann **Interagieren** aus. Ihr Endpunkt wird im Abschnitt **HTTPS** auf der Seite mit den Objektdetails angezeigt. 1. Öffnen Sie die Datei `demo_config.h` und aktualisieren Sie die Werte für Folgendes: AWS\_IOT\_ENDPOINT Ihr persönlicher Endpunkt. CLIENT\_CERT\_PATH Der Dateipfad Ihres Zertifikats, zum Beispiel `certificates/device.pem.crt"`. CLIENT\_PRIVATE\_KEY\_PATH Der Dateiname Ihres privaten Schlüssels, zum Beispiel `certificates/private.pem.key`. Beispiel: ``` // Get from demo_config.h // ================================================= #define AWS_IOT_ENDPOINT "{{my-endpoint}}-ats.iot.us-east-1.amazonaws.com" #define AWS_MQTT_PORT 8883 #define CLIENT_IDENTIFIER "testclient" #define ROOT_CA_CERT_PATH "certificates/AmazonRootCA1.crt" #define CLIENT_CERT_PATH "certificates/{{my-device-cert}}.pem.crt" #define CLIENT_PRIVATE_KEY_PATH "certificates/{{my-device-private-key}}.pem.key" // ================================================= ``` 1. Überprüfen Sie mithilfe dieses Befehls, ob CMake auf Ihrem Gerät installiert ist. ``` cmake --version ``` Wenn die Versionsinformationen für den Compiler angezeigt werden, können Sie mit dem nächsten Abschnitt fortfahren. Wenn Sie eine Fehlermeldung erhalten oder keine Informationen angezeigt werden, müssen Sie das CMake-Paket mit diesem Befehl installieren. ``` sudo apt-get install cmake ``` Führen Sie den Befehl **cmake --version** erneut aus und vergewissern Sie sich, dass CMake installiert wurde und Sie fortfahren können. 1. Überprüfen Sie mithilfe dieses Befehls, ob die Entwicklungstools auf Ihrem Gerät installiert sind. ``` gcc --version ``` Wenn die Versionsinformationen für den Compiler angezeigt werden, können Sie mit dem nächsten Abschnitt fortfahren. Wenn Sie eine Fehlermeldung erhalten oder keine Compilerinformationen angezeigt werden, müssen Sie das Paket `build-essential` mit diesem Befehl installieren. ``` sudo apt-get install build-essential ``` Führen Sie den Befehl **gcc --version** erneut aus und vergewissern Sie sich, dass die Build-Tools installiert wurden und Sie fortfahren können. ## Schritt 3: So laden Sie die Beispielanwendung herunter und führen sie aus In diesem Verfahren wird erklärt, wie Sie die `mqtt_demo_mutual_auth` Anwendung auf Ihrem Gerät generieren und sie mithilfe von mit der [AWS IoT Konsole](https://console.aws.amazon.com/iot/home) verbinden. AWS IoT Device SDK for Embedded C **Um das auszuführen AWS IoT Device SDK for Embedded C Beispielanwendungen** 1. Navigieren Sie zu `aws-iot-device-sdk-embedded-c` und erstellen Sie ein Build-Verzeichnis. ``` mkdir build && cd build ``` 1. Geben Sie den folgenden Befehl ein, um die zum Erstellen benötigten Makefiles zu generieren: ``` cmake .. ``` 1. Geben Sie den folgenden Befehl ein, um die ausführbare App-Datei zu erstellen: ``` make ``` 1. Führen Sie die App `mqtt_demo_mutual_auth` mit diesem Befehl aus. ``` cd bin ./mqtt_demo_mutual_auth ``` Die Ausgabe sollte folgendermaßen oder ähnlich aussehen: ![Befehlszeilenausgabe zum Ausführen der AWS IoT Device SDK for Embedded C Beispielanwendung.](http://docs.aws.amazon.com/de_de/iot/latest/developerguide/images/successful-run2.png) Ihr Gerät ist jetzt AWS IoT mit dem verbunden AWS IoT Device SDK for Embedded C. Sie können die AWS IoT Konsole auch verwenden, um die MQTT-Nachrichten anzuzeigen, die die Beispiel-App veröffentlicht. Weitere Informationen zur Verwendung des MQTT-Clients in der [AWS IoT -Konsole](https://console.aws.amazon.com/iot/home) finden Sie unter [MQTT-Nachrichten anzeigen mit dem AWS IoT MQTT-Client](view-mqtt-messages.md).