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 RTOS repositori Bebas Amazon yang tidak digunakan lagi. Kami menyarankan Anda mulai di sini ketika Anda membuat proyek baru. Jika Anda sudah memiliki RTOS proyek Gratis yang ada berdasarkan repositori Amazon-Free RTOS yang sekarang tidak digunakan lagi, lihat. Panduan Migrasi Repositori RTOS Github Bebas Amazon
Untuk mulai menggunakan Free RTOS with AWS IoT, Anda harus memiliki AWS akun, pengguna dengan izin untuk mengakses AWS IoT dan layanan RTOS cloud gratis. Anda juga harus mengunduh Gratis RTOS dan mengonfigurasi proyek RTOS demo Gratis papan Anda untuk bekerja dengannya AWS IoT. Bagian berikut memandu Anda melalui persyaratan ini.
catatan
-
Jika Anda menggunakan Espressif ESP32 - DevKit C,, atau ESP32 - WROOM -32SE ESP-WROVER-KIT, lewati langkah-langkah ini dan pergi ke. Memulai dengan Espressif ESP32 - DevKit C dan ESP-WROVER-KIT
-
Jika Anda menggunakan Nordic n RF5284 0-DK, lewati langkah-langkah ini dan pergi ke. Memulai dengan Nordic NRF52840-DK
Menyiapkan AWS akun dan izin
Mendaftar untuk Akun AWS
Jika Anda tidak memiliki Akun AWS, selesaikan langkah-langkah berikut untuk membuatnya.
Untuk mendaftar untuk Akun AWS
Buka https://portal.aws.amazon.com/billing/pendaftaran.
Ikuti petunjuk online.
Bagian dari prosedur pendaftaran melibatkan tindakan menerima panggilan telepon dan memasukkan kode verifikasi di keypad telepon.
Saat Anda mendaftar untuk sebuah Akun AWS, sebuah Pengguna root akun AWSdibuat. Pengguna root memiliki akses ke semua Layanan AWS dan sumber daya di akun. Sebagai praktik keamanan terbaik, tetapkan akses administratif ke pengguna, dan gunakan hanya pengguna root untuk melakukan tugas yang memerlukan akses pengguna root.
AWS mengirimi Anda email konfirmasi setelah proses pendaftaran selesai. Kapan saja, Anda dapat melihat aktivitas akun Anda saat ini dan mengelola akun Anda dengan masuk https://aws.amazon.com.rproxy.goskope.comke/
Buat pengguna dengan akses administratif
Setelah Anda mendaftar Akun AWS, amankan Pengguna root akun AWS, aktifkan AWS IAM Identity Center, dan buat pengguna administratif sehingga Anda tidak menggunakan pengguna root untuk tugas sehari-hari.
Amankan Pengguna root akun AWS
-
Masuk ke AWS Management Console
sebagai pemilik akun dengan memilih pengguna Root dan memasukkan alamat Akun AWS email Anda. Di laman berikutnya, masukkan kata sandi. Untuk bantuan masuk dengan menggunakan pengguna root, lihat Masuk sebagai pengguna root di AWS Sign-In Panduan Pengguna.
-
Aktifkan autentikasi multi-faktor (MFA) untuk pengguna root Anda.
Untuk petunjuk, lihat Mengaktifkan MFA perangkat virtual untuk pengguna Akun AWS root (konsol) Anda di Panduan IAM Pengguna.
Buat pengguna dengan akses administratif
-
Aktifkan Pusat IAM Identitas.
Untuk mendapatkan petunjuk, silakan lihat Mengaktifkan AWS IAM Identity Center di Panduan Pengguna AWS IAM Identity Center .
-
Di Pusat IAM Identitas, berikan akses administratif ke pengguna.
Untuk tutorial tentang menggunakan Direktori Pusat Identitas IAM sebagai sumber identitas Anda, lihat Mengkonfigurasi akses pengguna dengan default Direktori Pusat Identitas IAM di Panduan AWS IAM Identity Center Pengguna.
Masuk sebagai pengguna dengan akses administratif
-
Untuk masuk dengan pengguna Pusat IAM Identitas, gunakan login URL yang dikirim ke alamat email saat Anda membuat pengguna Pusat IAM Identitas.
Untuk bantuan masuk menggunakan pengguna Pusat IAM Identitas, lihat Masuk ke portal AWS akses di Panduan AWS Sign-In Pengguna.
Tetapkan akses ke pengguna tambahan
-
Di Pusat IAM Identitas, buat set izin yang mengikuti praktik terbaik menerapkan izin hak istimewa paling sedikit.
Untuk petunjuknya, lihat Membuat set izin di Panduan AWS IAM Identity Center Pengguna.
-
Tetapkan pengguna ke grup, lalu tetapkan akses masuk tunggal ke grup.
Untuk petunjuk, lihat Menambahkan grup di Panduan AWS IAM Identity Center Pengguna.
Untuk memberikan akses, menambahkan izin ke pengguna, grup, atau peran Anda:
-
Pengguna dan grup di AWS IAM Identity Center:
Buat rangkaian izin. Ikuti instruksi di Buat rangkaian izin di Panduan Pengguna AWS IAM Identity Center .
-
Pengguna yang dikelola IAM melalui penyedia identitas:
Buat peran untuk federasi identitas. Ikuti petunjuk di Membuat peran untuk penyedia identitas pihak ketiga (federasi) di Panduan IAM Pengguna.
-
IAMpengguna:
-
Buat peran yang dapat diambil pengguna Anda. Ikuti petunjuk di Buat peran untuk IAM pengguna di Panduan IAM Pengguna.
-
(Tidak disarankan) Pasang kebijakan langsung ke pengguna atau tambahkan pengguna ke grup pengguna. Ikuti petunjuk di Menambahkan izin ke pengguna (konsol) di Panduan IAM Pengguna.
-
Mendaftarkan MCU papan 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.
- AWS IoT Sesuatu
-
Suatu AWS IoT hal memungkinkan Anda untuk mengelola perangkat Anda AWS IoT. Itu disimpan di AWS Cloud.
- Kunci pribadi dan sertifikat X.509
-
Kunci pribadi dan sertifikat memungkinkan perangkat Anda untuk mengautentikasi AWS IoT.
Untuk mendaftarkan papan Anda, ikuti prosedur di bawah ini.
Untuk membuat AWS IoT kebijakan
-
Untuk membuat IAM kebijakan, Anda harus mengetahui AWS Wilayah 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, dan pilih Akun Saya. ID akun Anda ditampilkan di bawah Pengaturan 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 prompt perintah 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 adalah
us-west-2
.catatan
Sebaiknya gunakan ATS titik akhir seperti yang terlihat pada contoh.
-
Jelajahi ke AWS IoT konsol
. -
Di panel navigasi, pilih Aman, pilih Kebijakan, lalu pilih Buat.
-
Masukkan nama untuk mengidentifikasi kebijakan Anda.
-
Di bagian Tambahkan pernyataan, pilih Mode lanjutan. Salin dan tempel berikut ini JSON ke jendela editor kebijakan. Ganti
danaws-region
dengan AWS Wilayah dan ID akun Anda.aws-account
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iot:Connect", "Resource":"arn:aws:iot:
aws-region
:aws-account-id
:*" }, { "Effect": "Allow", "Action": "iot:Publish", "Resource": "arn:aws:iot:aws-region
:aws-account-id
:*" }, { "Effect": "Allow", "Action": "iot:Subscribe", "Resource": "arn:aws:iot:aws-region
:aws-account-id
:*" }, { "Effect": "Allow", "Action": "iot:Receive", "Resource": "arn:aws:iot:aws-region
:aws-account-id
:*" } ] }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 mempublikasikan MQTT pesan tentang MQTT topik apa pun.
iot:Subscribe
-
Memberi perangkat Anda izin untuk berlangganan filter MQTT topik apa pun.
iot:Receive
-
Memberi perangkat Anda izin untuk menerima pesan dari broker AWS IoT pesan tentang MQTT topik apa pun.
-
Pilih Buat.
Untuk membuat IoT, kunci pribadi, dan sertifikat untuk perangkat Anda
-
Jelajahi ke AWS IoT konsol
. -
Di panel navigasi, pilih Kelola, lalu pilih Things.
-
Jika Anda tidak memiliki hal-hal IoT yang terdaftar di akun Anda, halaman Anda belum memiliki hal apa pun akan ditampilkan. Jika Anda melihat halaman ini, pilih Daftarkan sesuatu. Jika tidak, pilih Buat.
-
Pada halaman Creating AWS IoT things, pilih Create a single.
-
Pada halaman Tambahkan perangkat Anda ke hal registri, masukkan nama untuk barang Anda, lalu pilih Berikutnya.
-
Pada halaman Tambahkan sertifikat untuk hal Anda, di bawah Pembuatan sertifikat sekali klik, pilih Buat sertifikat.
-
Unduh kunci pribadi dan sertifikat Anda dengan memilih tautan Unduh untuk masing-masing.
-
Pilih Aktifkan untuk mengaktifkan sertifikat Anda. Sertifikat harus diaktifkan sebelum digunakan.
-
Pilih Lampirkan kebijakan untuk melampirkan kebijakan ke sertifikat yang memberi perangkat Anda akses ke AWS IoT operasi.
-
Pilih kebijakan yang baru saja Anda buat dan pilih Daftar hal.
Setelah papan Anda terdaftar AWS IoT, Anda dapat melanjutkanDownload Gratis RTOS.
Download Gratis RTOS
Anda dapat mengunduh Gratis RTOS dari RTOS GitHub repositori Gratis
Setelah Anda mengunduh GratisRTOS, Anda dapat melanjutkan keMengkonfigurasi demo Gratis RTOS.
Mengkonfigurasi demo Gratis RTOS
Anda harus mengedit beberapa file konfigurasi di RTOS direktori Gratis Anda sebelum Anda dapat mengkompilasi dan menjalankan demo apa pun di papan Anda.
Untuk mengonfigurasi titik AWS IoT akhir
Anda harus memberikan Free RTOS dengan AWS IoT endpoint Anda sehingga aplikasi yang berjalan di papan Anda dapat mengirim permintaan ke titik akhir yang benar.
-
Jelajahi ke AWS IoT konsol
. -
Pada panel navigasi kiri, pilih Pengaturan.
AWS IoT Titik akhir Anda ditampilkan di titik akhir data Perangkat. Itu seharusnya terlihat seperti
. Catat titik akhir ini.1234567890123
-ats.iot.us-east-1
.amazonaws.com -
Di panel navigasi, pilih Kelola, lalu pilih Things.
Perangkat Anda harus memiliki nama AWS IoT benda. Catat nama ini.
-
Buka
demos/include/aws_clientcredential.h
. -
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 mengkonfigurasi Wi-Fi Anda
Jika papan Anda terhubung ke internet melalui koneksi Wi-Fi, Anda harus menyediakan gratis RTOS dengan kredenal Wi-Fi untuk terhubung ke jaringan. Jika papan Anda tidak mendukung Wi-Fi, Anda dapat melewati langkah-langkah ini.
-
demos/include/aws_clientcredential.h
. -
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
(WEPkeamanan) -
eWiFiSecurityWPA
(WPAkeamanan) -
eWiFiSecurityWPA2
(WPA2keamanan)
-
-
Untuk memformat AWS IoT kredensi Anda
Free RTOS harus memiliki AWS IoT sertifikat dan kunci pribadi yang terkait dengan barang terdaftar Anda dan kebijakan izinnya untuk berhasil berkomunikasi dengan AWS IoT atas nama perangkat Anda.
catatan
Untuk mengonfigurasi AWS IoT kredensi Anda, Anda harus memiliki kunci pribadi dan sertifikat yang Anda unduh dari AWS IoT konsol saat Anda mendaftarkan perangkat Anda. Setelah mendaftarkan perangkat sebagai AWS IoT sesuatu, Anda dapat mengambil sertifikat perangkat dari AWS IoT konsol, tetapi Anda tidak dapat mengambil kunci pribadi.
Gratis RTOS adalah proyek bahasa C, dan sertifikat dan kunci pribadi harus diformat secara khusus untuk ditambahkan ke proyek.
-
Di jendela browser, buka
tools/certificate_configuration/CertificateConfigurator.html
. -
Di bawah PEMFile sertifikat, pilih
yang Anda unduh dari AWS IoT konsol.ID
-certificate.pem.crt -
Di bawah PEMfile Kunci Pribadi, pilih
yang Anda unduh dari AWS IoT konsol.ID
-private.pem.key -
Pilih Generate dan save aws_clientcredential_keys.h, dan kemudian simpan file di.
demos/include
Ini menimpa file yang ada di direktori.catatan
Sertifikat dan kunci pribadi dikodekan keras untuk tujuan demonstrasi saja. Aplikasi tingkat produksi harus menyimpan file-file ini di lokasi yang aman.
Setelah Anda mengkonfigurasi GratisRTOS, 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. Panduan memulai khusus papan Aplikasi demo yang digunakan dalam tutorial Memulai adalah demo MQTT Mutual Authentication inti, yang terletak didemos/coreMQTT/mqtt_demo_mutual_auth.c
.