Tutorial: Verwenden der AWS IoT Device SDK for Embedded C - AWS IoT Core

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 der AWS IoT Device SDK for Embedded C

In diesem Abschnitt wird beschrieben, wie Sie die ausführen AWS IoT Device SDK for Embedded C.

Step1: Installieren der AWS IoT Device SDK for Embedded C

Die AWS IoT Device SDK for Embedded C ist im Allgemeinen auf Geräte mit eingeschränkten Ressourcen ausgerichtet, die eine optimierte C-Sprachlaufzeit erfordern. 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 Ihnen, eines der AWS IoT Geräte- und Mobil-SDKs höherer Reihenfolge zu verwenden (z. B. C++ JavaScript, Java und Python).

Im Allgemeinen AWS IoT Device SDK for Embedded C ist die für Systeme gedacht, 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.

Beispiel
  1. Laden Sie die von AWS IoT Device SDK for Embedded C auf Ihr Gerät herunterGitHub.

    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.

  2. Navigieren Sie zu diesem Verzeichnis und machen Sie sich mit der neuesten Version vertraut. Das neueste Release-Tag finden Sie unter github.com/aws/aws-iot-device-sdk-embeded-C/tags.

    cd aws-iot-device-sdk-embedded-c git checkout latest-release-tag
  3. 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

Die AWS IoT Device SDK for Embedded C enthält Beispielanwendungen, die Sie ausprobieren können. Der Einfachheit halber verwendet dieses Tutorial die mqtt_demo_mutual_auth Anwendung , 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 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.

  2. Sie müssen das Beispiel mit Ihrem persönlichen AWS IoT Core Endpunkt, privaten Schlüssel, Zertifikat und Stammzertifizierungsstellenzertifikat konfigurieren. Navigieren Sie zum aws-iot-device-sdk-embedded-c/demos/mqtt/mqtt_demo_mutual_auth Verzeichnis .

    Wenn Sie die 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 die nicht AWS CLI installiert haben, öffnen Sie Ihre AWS IoT -Konsole. 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.

  3. Ö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.

    Beispielsweise:

    // 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" // =================================================
  4. Ü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.

  5. Ü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

So führen Sie die AWS IoT Device SDK for Embedded C Beispielanwendungen aus
  1. Navigieren Sie zu aws-iot-device-sdk-embedded-c und erstellen Sie ein Build-Verzeichnis.

    mkdir build && cd build
  2. Geben Sie den folgenden Befehl ein, um die zum Erstellen benötigten Makefiles zu generieren:

    cmake ..
  3. Geben Sie den folgenden Befehl ein, um die ausführbare App-Datei zu erstellen:

    make
  4. 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.

Ihr Gerät ist jetzt AWS IoT mit über die verbunden AWS IoT Device SDK for Embedded C.

Sie können auch die AWS IoT Konsole verwenden, um die MQTT-Nachrichten anzuzeigen, die die Beispiel-App veröffentlicht. Weitere Informationen zur Verwendung des MQTT-Clients in der AWS IoT -Konsole finden Sie unter MQTT-Nachrichten mit dem AWS IoT MQTT-Client anzeigen.