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 [mulai di sini](freertos-getting-started-modular.md) ketika Anda membuat proyek baru. Jika Anda sudah memiliki proyek FreeRTOS yang ada berdasarkan repositori yang sekarang tidak digunakan lagi, Amazon-FreeRTOS lihat. [Amazon-FreeRTOS Panduan Migrasi Repositori Github](github-repo-migration.md)
Untuk mulai menggunakan FreeRTOS AWS IoT dengan, 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**
Jika Anda menggunakan Espressif ESP32-DevKitC,, atau ESP-WROVER-KIT ESP32-WROOM-32SE, lewati langkah-langkah ini dan pergi ke. [Memulai dengan Espressif ESP32-DevKitC dan ESP-WROVER-KIT](getting_started_espressif.md)
Jika Anda menggunakan Nordic nRF52840-DK, lewati langkah-langkah ini dan pergi ke[Memulai dengan Nordic n RF52840-DK](getting_started_nordic.md).
1. [Menyiapkan Anda AWS akun dan izin](#freertos-account-and-permissions)
1. [Mendaftarkan papan MCU Anda dengan AWS IoT](#get-started-freertos-thing)
1. [Mengunduh FreeRTOS](#freertos-download)
1. [Mengkonfigurasi demo FreeRTOS](#freertos-configure)
## Menyiapkan Anda AWS akun dan izin
### Mendaftar untuk Akun AWS
Untuk memulai AWS, Anda membutuhkan Akun AWS. Untuk informasi tentang membuat Akun AWS, lihat [Memulai dengan Akun AWS](https://docs.aws.amazon.com//accounts/latest/reference/getting-started.html) di *Panduan AWS Account Management Referensi*.
Untuk memberikan akses dan menambahkan izin bagi pengguna, grup, atau peran Anda:
+ Pengguna dan grup di AWS IAM Identity Center:
Buat rangkaian izin. Ikuti instruksi di [Buat rangkaian izin](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) dalam *Panduan Pengguna AWS IAM Identity Center *.
+ Pengguna yang dikelola di IAM melalui penyedia identitas:
Buat peran untuk federasi identitas. Ikuti instruksi dalam [Buat peran untuk penyedia identitas pihak ketiga (federasi)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) dalam *Panduan Pengguna IAM*.
+ Pengguna IAM:
+ Buat peran yang dapat diambil pengguna Anda. Ikuti instruksi dalam [Buat peran untuk pengguna IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) dalam *Panduan Pengguna IAM*.
+ (Tidak disarankan) Lampirkan kebijakan langsung ke pengguna atau tambahkan pengguna ke grup pengguna. Ikuti petunjuk dalam [Menambahkan izin ke pengguna (konsol)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) dalam *Panduan Pengguna IAM*.
## 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.
** AWS IoT Sesuatu**
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 mengautentikasi AWS IoT.
Untuk mendaftarkan papan Anda, ikuti prosedur di bawah ini.
**Untuk membuat sebuah AWS IoT kebijakan**
1. Untuk membuat kebijakan IAM, Anda harus mengetahui AWS Wilayah dan nomor AWS akun Anda.
**Untuk menemukan nomor AWS akun Anda, buka [Konsol AWS Manajemen](https://console.aws.amazon.com/), 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html). 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 titik akhir ATS seperti yang terlihat pada contoh.
1. Jelajahi ke [AWS IoT konsol](https://console.aws.amazon.com/iotv2/).
1. Di panel navigasi, pilih **Aman**, pilih **Kebijakan**, lalu pilih **Buat**.
1. Masukkan nama untuk mengidentifikasi kebijakan Anda.
1. Di bagian **Tambahkan pernyataan**, pilih **Mode lanjutan**. Salin dan tempel JSON berikut ke jendela editor kebijakan. Ganti `{{aws-region}}` dan `{{aws-account}}` dengan AWS Wilayah 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 mempublikasikan 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 tentang topik MQTT apa pun.
1. Pilih **Buat**.
**Untuk membuat IoT, kunci pribadi, dan sertifikat untuk perangkat Anda**
1. Jelajahi ke [AWS IoT konsol](https://console.aws.amazon.com/iotv2/).
1. Di panel navigasi, pilih **Kelola**, lalu pilih **Things**.
1. 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 **Daftar sesuatu**. Jika tidak, pilih **Buat**.
1. Pada halaman **Creating AWS IoT things**, pilih **Create a single**.
1. Pada halaman **Tambahkan perangkat Anda ke hal registri**, masukkan nama untuk barang Anda, lalu pilih **Berikutnya**.
1. Pada halaman **Tambahkan sertifikat untuk hal Anda**, di bawah **pembuatan One-click sertifikat**, pilih **Buat sertifikat**.
1. Unduh kunci pribadi dan sertifikat Anda dengan memilih tautan **Unduh** untuk masing-masing.
1. Pilih **Aktifkan** untuk mengaktifkan sertifikat Anda. Sertifikat harus diaktifkan sebelum digunakan.
1. Pilih **Lampirkan kebijakan** untuk melampirkan kebijakan ke sertifikat yang memberi perangkat Anda akses ke AWS IoT operasi.
1. Pilih kebijakan yang baru saja Anda buat dan pilih **Daftar hal**.
Setelah papan Anda terdaftar AWS IoT, Anda dapat melanjutkan[Mengunduh FreeRTOS](#freertos-download).
## Mengunduh FreeRTOS
[Anda dapat mengunduh FreeRTOS dari repositori FreeRTOS. GitHub ](https://github.com/freertos/freertos)
Setelah Anda mengunduh FreeRTOS, Anda dapat melanjutkan. [Mengkonfigurasi demo FreeRTOS](#freertos-configure)
## 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 mengkonfigurasi AWS IoT titik akhir**
Anda harus menyediakan FreeRTOS dengan titik akhir AWS IoT Anda sehingga aplikasi yang berjalan di papan Anda dapat mengirim permintaan ke titik akhir yang benar.
1. Jelajahi ke [AWS IoT konsol](https://console.aws.amazon.com/iotv2/).
1. Pada panel navigasi kiri, pilih **Pengaturan**.
AWS IoT Titik akhir Anda ditampilkan di titik **akhir data Perangkat**. Itu seharusnya terlihat seperti `{{1234567890123}}-ats.iot.{{us-east-1}}.amazonaws.com`. Catat titik akhir ini.
1. Di panel navigasi, pilih **Kelola**, lalu pilih **Things**.
Perangkat Anda harus memiliki nama AWS IoT benda. Catat nama ini.
1. Buka `demos/include/aws_clientcredential.h`.
1. 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**
Jika papan Anda terhubung ke internet melalui Wi-Fi koneksi, Anda harus memberikan FreeRTOS kredenal untuk Wi-Fi terhubung ke jaringan. Jika papan Anda tidak mendukung Wi-Fi, Anda dapat melewati langkah-langkah ini.
1. `demos/include/aws_clientcredential.h`.
1. 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 Anda AWS IoT credentials**
FreeRTOS harus memiliki AWS IoT sertifikat dan kunci pribadi yang terkait dengan barang terdaftar Anda dan kebijakan izinnya untuk berhasil berkomunikasi AWS IoT dengan atas nama perangkat Anda.
**catatan**
Untuk mengonfigurasi AWS IoT kredensyal 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.
FreeRTOS adalah proyek bahasa C, dan sertifikat dan kunci pribadi harus diformat khusus untuk ditambahkan ke proyek.
1. Di jendela browser, buka`tools/certificate_configuration/CertificateConfigurator.html`.
1. Di bawah **file PEM Sertifikat**, pilih `{{ID}}-certificate.pem.crt` yang Anda unduh dari AWS IoT konsol.
1. Di bawah **file PEM Kunci Pribadi**, pilih `{{ID}}-private.pem.key` yang Anda unduh dari AWS IoT konsol.
1. 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. Production-level aplikasi harus menyimpan file-file ini di lokasi yang aman.
Setelah Anda mengonfigurasi 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](getting-started-guides.md) Aplikasi demo yang digunakan dalam tutorial Memulai adalah demo CoreMQTT Mutual Authentication, yang terletak di. `demos/coreMQTT/mqtt_demo_mutual_auth.c`