View a markdown version of this page

Langkah pertama - FreeRTOS

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

Langkah pertama

penting

Halaman ini mengacu pada Amazon-FreeRTOS repositori yang tidak digunakan lagi. Kami menyarankan Anda memulai di sini ketika Anda membuat proyek baru. Jika Anda sudah memiliki proyek FreeRTOS yang ada berdasarkan Amazon-FreeRTOS repositori yang sekarang tidak digunakan lagi, lihat. Amazon-FreeRTOS Panduan Migrasi Repositori Github

Untuk mulai menggunakan FreeRTOS AWS IoT, Anda harus memiliki AWS akun, pengguna dengan izin untuk mengakses AWS IoT dan layanan cloud FreeRTOS. Anda juga harus mengunduh FreeRTOS dan mengonfigurasi proyek demo FreeRTOS papan Anda untuk bekerja dengannya. AWS IoT Bagian berikut memandu Anda melalui persyaratan ini.

catatan

Menyiapkan AWS akun dan izin

Mendaftar untuk Akun AWS

Untuk memulainya AWS, Anda membutuhkan Akun AWS. Untuk informasi tentang membuat Akun AWS, lihat Mem ulai dengan an Akun AWS di Panduan AWS Account Management Referensi.

Untuk memberikan akses dan menambahkan izin bagi pengguna, grup, atau peran Anda:

Mendaftarkan papan MCU Anda dengan AWS IoT

Papan Anda harus terdaftar AWS IoT untuk berkomunikasi dengan AWS Cloud. Untuk mendaftarkan papan Anda AWS IoT, Anda harus memiliki:

Sebuah AWS IoT kebijakan

AWS IoT Kebijakan ini memberikan izin perangkat Anda untuk mengakses AWS IoT sumber daya. Itu disimpan di AWS Cloud.

Suatu AWS IoT hal

Suatu AWS IoT hal memungkinkan Anda untuk mengelola perangkat Anda AWS IoT. Itu disimpan di AWS Cloud.

Kunci pribadi dan X.509 sertifikat

Kunci pribadi dan sertifikat memungkinkan perangkat Anda untuk melakukan otentikasi. AWS IoT

Untuk mendaftarkan papan Anda, ikuti prosedur di bawah ini.

Untuk membuat AWS IoT kebijakan
  1. Untuk membuat kebijakan IAM, Anda harus mengetahui Wil AWS ayah dan nomor AWS akun Anda.

    Untuk menemukan nomor AWS akun Anda, buka Konsol AWS Manajemen, cari dan perluas menu di bawah nama akun Anda di sudut kanan atas, lalu pilih Akun Saya. ID akun Anda ditampilkan di bawah Peng aturan Akun.

    Untuk menemukan AWS wilayah untuk AWS akun Anda, gunakan AWS Command Line Interface. Untuk menginstal AWS CLI, ikuti petunjuk di Panduan AWS Command Line Interface Pengguna. Setelah Anda menginstal AWS CLI, buka jendela command prompt dan masukkan perintah berikut:

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

    Outputnya akan terlihat seperti ini:

    { "endpointAddress": "xxxxxxxxxxxxxx-ats.iot.us-west-2.amazonaws.com" }

    Dalam contoh ini, wilayahnya adalahus-west-2.

    catatan

    Sebaiknya gunakan titik akhir ATS seperti yang terlihat dalam contoh.

  2. Jelajahi ke AWS IoT konsol.

  3. Di panel navigasi, pilih A man, pilih Kebijakan, lalu pilih Buat.

  4. Masukkan nama untuk mengidentifikasi kebijakan Anda.

  5. Di bagian Tambahkan pernyataan, pilih Mode lanjutan. Salin dan tempel JSON berikut ke jendela editor kebijakan. Ganti aws-region dan aws-account dengan Wil AWS ayah dan ID akun Anda.

    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:*" } ] }

    Kebijakan ini memberikan izin berikut:

    iot:Connect

    Memberi perangkat Anda izin untuk terhubung ke broker AWS IoT pesan dengan ID klien apa pun.

    iot:Publish

    Memberi perangkat Anda izin untuk menerbitkan pesan MQTT pada topik MQTT apa pun.

    iot:Subscribe

    Memberi perangkat Anda izin untuk berlangganan filter topik MQTT apa pun.

    iot:Receive

    Memberi perangkat Anda izin untuk menerima pesan dari broker AWS IoT pesan pada topik MQTT apa pun.

  6. Pilih Buat.

Untuk membuat benda IoT, kunci pribadi, dan sertifikat untuk perangkat Anda
  1. Jelajahi ke AWS IoT konsol.

  2. Di panel navigasi, pilih Kelola, lalu pilih Th ings.

  3. Jika Anda tidak memiliki hal-hal IoT yang terdaftar di akun Anda, halaman Anda belum memiliki hal-hal apa pun ditampilkan. Jika Anda melihat halaman ini, pilih Daftarkan sesuatu. Jika tidak, pilih Buat.

  4. Pada halaman Cre AWS IoT ating things, pilih Create a single thing.

  5. Pada halaman Tambahkan perangkat Anda ke registri hal, masukkan nama untuk item Anda, lalu pilih Ber ikutnya.

  6. Pada halaman Tambahkan sertifikat untuk barang Anda, di bawah pembuatan One-click sertifikat, pilih Buat sertifikat.

  7. Unduh kunci pribadi dan sertifikat Anda dengan memilih tautan Unduh untuk masing-masing.

  8. Pilih Aktif kan untuk mengaktifkan sertifikat Anda. Sertifikat harus diaktifkan sebelum digunakan.

  9. Pilih Lampirkan kebijakan untuk melampirkan kebijakan ke sertifikat yang memberikan akses perangkat ke AWS IoT operasi.

  10. Pilih kebijakan yang baru saja Anda buat dan pilih Daftar hal.

Setelah papan Anda terdaftar AWS IoT, Anda dapat melanjutkanMengunduh FreeRTOS.

Mengunduh FreeRTOS

Anda dapat mengunduh FreeRTOS dari repositori FreeRTOS GitHub .

Setelah Anda mengunduh FreeRTOS, Anda dapat melanjutkanMengkonfigurasi demo FreeRTOS.

Mengkonfigurasi demo FreeRTOS

Anda harus mengedit beberapa file konfigurasi di direktori FreeRTOS Anda sebelum Anda dapat mengkompilasi dan menjalankan demo apa pun di papan Anda.

Untuk mengonfigurasi AWS IoT titik akhir

Anda harus menyediakan FreeRTOS dengan AWS IoT titik akhir Anda sehingga aplikasi yang berjalan di papan Anda dapat mengirim permintaan ke titik akhir yang benar.

  1. Jelajahi ke AWS IoT konsol.

  2. Pada panel navigasi kiri, pilih Pengaturan.

    Titik AWS IoT akhir Anda ditampilkan di T itik akhir data perangkat. Itu seharusnya terlihat seperti 1234567890123-ats.iot.us-east-1.amazonaws.com. Catat titik akhir ini.

  3. Di panel navigasi, pilih Kelola, lalu pilih Th ings.

    Perangkat Anda harus memiliki nama AWS IoT benda. Catat nama ini.

  4. Buka demos/include/aws_clientcredential.h.

  5. Tentukan nilai untuk konstanta berikut:

    • #define clientcredentialMQTT_BROKER_ENDPOINT "Your AWS IoT endpoint";

    • #define clientcredentialIOT_THING_NAME "The AWS IoT thing name of your board"

Untuk mengonfigurasi Wi-Fi

Jika papan Anda terhubung ke internet melalui Wi-Fi koneksi, Anda harus memberikan FreeRTOS dengan Wi-Fi kredenSIAL untuk terhubung ke jaringan. Jika papan Anda tidak mendukung Wi-Fi, Anda dapat melewati langkah-langkah ini.

  1. demos/include/aws_clientcredential.h.

  2. Tentukan nilai untuk #define konstanta berikut:

    • #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

      Jenis keamanan yang valid adalah:

      • eWiFiSecurityOpen(Terbuka, tidak ada keamanan)

      • eWiFiSecurityWEP(Keamanan WEP)

      • eWiFiSecurityWPA(Keamanan WPA)

      • eWiFiSecurityWPA2(Keamanan WPA2)

Untuk memformat AWS IoT credentials

FreeRTOS harus memiliki AWS IoT sertifikat dan kunci pribadi yang terkait dengan barang terdaftar Anda dan kebijakan izinnya agar berhasil berkomunikasi AWS IoT atas nama perangkat Anda.

catatan

Untuk mengonfigurasi AWS IoT kredenSIAL Anda, Anda harus memiliki kunci pribadi dan sertifikat yang Anda unduh dari AWS IoT konsol saat mendaftarkan perangkat Anda. Setelah Anda mendaftarkan perangkat Anda sebagai AWS IoT sesuatu, Anda dapat mengambil sertifikat perangkat dari AWS IoT konsol, tetapi Anda tidak dapat mengambil kunci pribadi.

FreeRTOS adalah proyek bahasa C, dan sertifikat dan kunci pribadi harus diformat secara khusus untuk ditambahkan ke proyek.

  1. Di jendela browser, bukatools/certificate_configuration/CertificateConfigurator.html.

  2. Di bawah file PEM Sertifik ID-certificate.pem.crt at, pilih yang Anda unduh dari AWS IoT konsol.

  3. Di bawah file Private Key PEM, pilih file ID-private.pem.key yang Anda unduh dari AWS IoT konsol.

  4. Pilih H asilkan dan simpan aws_clientcredential_keys. h, lalu simpan file di. demos/include Ini mengganti file yang ada di direktori.

    catatan

    Sertifikat dan kunci pribadi dikodekan keras untuk tujuan demonstrasi saja. Production-level aplikasi harus menyimpan file-file ini di lokasi yang aman.

Setelah mengkonfigurasi FreeRTOS, Anda dapat melanjutkan ke panduan Memulai untuk papan Anda untuk mengatur perangkat keras platform Anda dan lingkungan pengembangan perangkat lunaknya, lalu mengkompilasi dan menjalankan demo di papan Anda. Untuk instruksi khusus papan, lihat. Board-specific panduan memulai Aplikasi demo yang digunakan dalam tutorial Memulai adalah demo CoreMQTT Mutual Authentication, yang terletak di. demos/coreMQTT/mqtt_demo_mutual_auth.c