View a markdown version of this page

Tutorial: Menggunakan AWS IoT Device SDK for Embedded C - AWS IoT Core

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tutorial: Menggunakan AWS IoT Device SDK for Embedded C

Bagian ini menjelaskan cara menjalankan AWS IoT Device SDK for Embedded C.

Langkah1: Instal AWS IoT Device SDK for Embedded C

Um AWS IoT Device SDK for Embedded C umnya ditargetkan pada perangkat terbatas sumber daya yang memerlukan runtime bahasa C yang dioptimalkan. Anda dapat menggunakan SDK pada sistem operasi apa pun dan meng-hostingnya pada jenis prosesor apa pun (misalnya, MCU dan MPU). Jika Anda memiliki lebih banyak memori dan sumber daya pemrosesan yang tersedia, sebaiknya gunakan salah satu SDK AWS IoT Perangkat dan Seluler tingkat tinggi (misalnya, C++, Java JavaScript, dan Python).

Secara umum, ini AWS IoT Device SDK for Embedded C ditujukan untuk sistem yang menggunakan MCU atau MPU low-end yang menjalankan sistem operasi tertanam. Untuk contoh pemrograman di bagian ini, kami menganggap perangkat Anda menggunakan Linux.

contoh
  1. Unduh AWS IoT Device SDK for Embedded C ke perangkat Anda dari GitHub.

    git clone https://github.com/aws/aws-iot-device-sdk-embedded-c.git --recurse-submodules

    Ini membuat direktori bernama aws-iot-device-sdk-embedded-c di direktori saat ini.

  2. Arahkan ke direktori itu dan periksa rilis terbaru. Silakan lihat github. com/aws/aws-iot-device- C/tags sdk-embedded- untuk tag rilis terbaru.

    cd aws-iot-device-sdk-embedded-c git checkout latest-release-tag
  3. Instal OpenSSL versi 1.1.0 atau yang lebih baru. Pustaka pengembangan OpenSSL biasanya disebut “libssl-dev” atau “openssl-devel” ketika diinstal melalui manajer paket.

    sudo apt-get install libssl-dev

Langkah 2: Konfigurasikan aplikasi sampel

Ter AWS IoT Device SDK for Embedded C masuk contoh aplikasi untuk Anda coba. Untuk kesederhanaan, tutorial ini menggunakan mqtt_demo_mutual_auth aplikasi, yang menggambarkan cara terhubung ke broker AWS IoT Core pesan dan berlangganan dan menerbitkan topik MQTT.

  1. Salin sertifikat dan kunci pribadi yang Anda buat Memulai dengan AWS IoT Core tutorial ke build/bin/certificates direktori.

    catatan

    Sertifikat CA perangkat dan root dapat kedaluwarsa atau dicabut. Jika sertifikat ini kedaluwarsa atau dicabut, Anda harus menyalin sertifikat CA baru atau kunci pribadi dan sertifikat perangkat ke perangkat Anda.

  2. Anda harus mengonfigurasi sampel dengan AWS IoT Core titik akhir pribadi, kunci pribadi, sertifikat, dan sertifikat CA root. Buka direktori aws-iot-device-sdk-embedded-c/demos/mqtt/mqtt_demo_mutual_auth tersebut.

    Jika Anda telah AWS CLI menginstal, Anda dapat menggunakan perintah ini untuk menemukan URL titik akhir akun Anda.

    aws iot describe-endpoint --endpoint-type iot:Data-ATS

    Jika Anda belum meng AWS CLI instalnya, buka AWS IoT konsol Anda. Dari panel navigasi, pilih Kelola, lalu pilih Th ings. Pilih hal IoT untuk perangkat Anda, lalu pilih Inter act. Titik akhir Anda ditampilkan di bagian HTTPS dari halaman detail hal.

  3. Buka demo_config.h file dan perbarui nilai-nilai untuk berikut ini:

    AWS_IOT_ENDPOINT

    Titik akhir pribadi Anda.

    JALUR_CERT_KLIEN

    Jalur file sertifikat Anda, misalnyacertificates/device.pem.crt".

    JALUR KUNCI_PRIBADI_KLIEN

    Nama file kunci pribadi Anda, misalnyacertificates/private.pem.key.

    Contoh:

    // 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. Periksa untuk melihat apakah Anda telah menginstal CMake di perangkat Anda dengan menggunakan perintah ini.

    cmake --version

    Jika Anda melihat informasi versi untuk kompiler, Anda dapat melanjutkan ke bagian berikutnya.

    Jika Anda mendapatkan kesalahan atau tidak melihat informasi apa pun, maka Anda harus menginstal paket cmake menggunakan perintah ini.

    sudo apt-get install cmake

    Jalan cmake --version kan perintah lagi dan konfirmasikan bahwa CMake telah diinstal dan Anda siap untuk melanjutkan.

  5. Periksa untuk melihat apakah Anda memiliki alat pengembangan yang diinstal pada perangkat Anda dengan menggunakan perintah ini.

    gcc --version

    Jika Anda melihat informasi versi untuk kompiler, Anda dapat melanjutkan ke bagian berikutnya.

    Jika Anda mendapatkan kesalahan atau tidak melihat informasi kompiler apa pun, Anda harus menginstal build-essential paket menggunakan perintah ini.

    sudo apt-get install build-essential

    Jalan gcc --version kan perintah lagi dan konfirmasikan bahwa alat build telah diinstal dan Anda siap untuk melanjutkan.

Langkah 3: Membangun dan menjalankan aplikasi sampel

Prosedur ini menjelaskan cara membuat mqtt_demo_mutual_auth aplikasi di perangkat Anda dan menghubungkannya ke AWS IoT konsol menggunakan. AWS IoT Device SDK for Embedded C

Untuk menjalankan AWS IoT Device SDK for Embedded C contoh aplikasi
  1. Arahkan ke aws-iot-device-sdk-embedded-c dan buat direktori build.

    mkdir build && cd build
  2. Masukkan perintah CMake berikut untuk menghasilkan Makefiles yang diperlukan untuk membangun.

    cmake ..
  3. Masukkan perintah berikut untuk membangun file aplikasi yang dapat dieksekusi.

    make
  4. Jalan mqtt_demo_mutual_auth kan aplikasi dengan perintah ini.

    cd bin ./mqtt_demo_mutual_auth

    Anda akan melihat output yang serupa dengan yang berikut:

    Output baris perintah untuk menjalankan aplikasi AWS IoT Device SDK for Embedded C sampel.

Perangkat Anda sekarang terhubung untuk AWS IoT menggunakan AWS IoT Device SDK for Embedded C.

Anda juga dapat menggunakan AWS IoT konsol untuk melihat pesan MQTT yang diterbitkan aplikasi sampel. Untuk informasi tentang cara menggunakan klien MQTT di AWS IoT konsol, lihatLihat pesan MQTT dengan AWS IoT Klien MQTT.