Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Siapkan prasyarat kualifikasi LTS
Bagian ini menjelaskan prasyarat untuk menguji mikrokontroler dengan. AWS IoT Device Tester
## Mempersiapkan kualifikasi FreeRTOS
**catatan**
AWS IoT Device Tester untuk FreeRTOS sangat merekomendasikan menggunakan rilis patch terbaru dari versi Freertos-LTS terbaru.
IDT untuk FRQ 2.0 adalah kualifikasi untuk FreeRTOS. *Sebelum menjalankan IDT FRQ 2.0 untuk kualifikasi, Anda harus menyelesaikan Kualifikasi [papan Anda di Panduan Kualifikasi](https://docs.aws.amazon.com/freertos/latest/qualificationguide/freertos-qualification.html) FreeRTOS.* *Untuk mem-port pustaka, pengujian, dan penyiapan`manifest.yml`, lihat [Mem-porting pustaka FreeRTOS di Panduan Porting FreeRTOS](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-porting.html).* FRQ 2.0 berisi proses kualifikasi yang berbeda. Lihat [Perubahan terbaru dalam kualifikasi dalam panduan kualifikasi](https://docs.aws.amazon.com/freertos/latest/qualificationguide/latest-changes.html) *FreeRTOS untuk detailnya*.
Repositori [Freertos-Libraries-Integration-Tests](https://github.com/FreeRTOS/FreeRTOS-Libraries-Integration-Tests) harus ada agar IDT dapat dijalankan. Lihat [README.md](https://github.com/FreeRTOS/FreeRTOS-Libraries-Integration-Tests/blob/main/README.md) tentang cara mengkloning dan mem-port repositori ini ke proyek sumber Anda. FreeRTOS-Libraries-Integration-Testsharus menyertakan yang `manifest.yml` terletak di root proyek Anda, agar IDT dapat berjalan.
**catatan**
IDT tergantung pada implementasi repositori pengujian. `UNITY_OUTPUT_CHAR` Log keluaran pengujian dan log perangkat tidak boleh saling bertautan. Lihat [Menerapkan bagian makro logging pustaka](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-library-logging-macros.html) di Panduan *Porting FreeRTOS untuk detail lebih lanjut*.
## Unduh IDT untuk FreeRTOS
Setiap versi FreeRTOS memiliki versi IDT yang sesuai untuk FreerTOS untuk melakukan tes kualifikasi. Unduh versi IDT yang sesuai untuk FreeRTOS [dari versi](https://docs.aws.amazon.com/freertos/latest/userguide/dev-test-versions-afr.html) yang didukung untuk FreeRTOS. AWS IoT Device Tester
Ekstrak IDT untuk FreeRTOS ke lokasi pada sistem file tempat Anda telah membaca dan menulis izin. Karena Microsoft Windows memiliki batas karakter untuk panjang jalur, ekstrak IDT untuk FreeRTOS ke direktori root seperti atau. `C:\` `D:\`
**catatan**
Beberapa pengguna tidak boleh menjalankan IDT dari lokasi bersama, seperti direktori NFS atau folder bersama jaringan Windows. Ini akan mengakibatkan crash atau korupsi data. Kami menyarankan Anda mengekstrak paket IDT ke drive lokal.
## Unduh Git
IDT harus menginstal Git sebagai prasyarat untuk memastikan integritas kode sumber.
Ikuti petunjuk dalam [GitHub](https://github.com/git-guides/install-git)panduan untuk menginstal Git. Untuk memverifikasi versi Git yang diinstal saat ini, masukkan perintah `git --version` di terminal.
**Awas**
IDT menggunakan Git untuk menyelaraskan dengan status direktori bersih atau kotor. Jika Git tidak diinstal, grup `FreeRTOSIntegrity` pengujian akan gagal, atau tidak akan berjalan seperti yang diharapkan. Jika IDT mengembalikan kesalahan seperti `git executable not found` atau`git command not found`, instal atau instal ulang Git dan coba lagi.
**Topics**
+ [Mempersiapkan kualifikasi FreeRTOS](#idt-preparing-qualification)
+ [Unduh IDT untuk FreeRTOS](#idt-download-dev-tester-afr)
+ [Unduh Git](#idt-download-git)
+ [Buat AWS akun](#lts-config-aws-account)
+ [AWS IoT Device Tester kebijakan terkelola](#managed-policy)
+ [(Opsional) Instal AWS Command Line Interface](#install-cli)
## Buat AWS akun
**catatan**
Suite kualifikasi IDT lengkap hanya didukung dalam hal berikut Wilayah AWS
AS Timur (Virginia Utara)
AS Barat (Oregon)
Asia Pasifik (Tokyo)
Eropa (Irlandia)
Untuk menguji perangkat Anda, IDT untuk FreeRTOS membuat sumber daya seperti AWS IoT hal-hal, grup FreeRTOS, dan fungsi Lambda. Untuk membuat sumber daya tersebut, IDT untuk FreeRTOS mengharuskan Anda membuat dan mengonfigurasi AWS akun, dan kebijakan IAM yang memberikan izin IDT untuk FreeRTOS untuk mengakses sumber daya atas nama Anda saat menjalankan pengujian.
Langkah-langkah berikut adalah membuat dan mengkonfigurasi AWS akun Anda.
1. Jika Anda sudah memiliki AWS akun, lompat ke langkah berikutnya. Lain buat [AWS akun](https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/).
1. Ikuti langkah-langkah dalam [Membuat peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html). Jangan menambahkan izin atau kebijakan saat ini.
1. Untuk menjalankan tes kualifikasi OTA, lanjutkan ke Langkah 4. Lain pergi ke Langkah 5.
1. Lampirkan kebijakan inline izin IAM OTA ke peran IAM Anda.
1.
**penting**
Templat kebijakan berikut memberikan izin IDT untuk membuat peran, membuat kebijakan, dan melampirkan kebijakan ke peran. IDT untuk FreeRTOS menggunakan izin ini untuk pengujian yang membuat peran. Meskipun templat kebijakan tidak memberikan hak administrator kepada pengguna, izin tersebut dapat digunakan untuk mendapatkan akses administrator ke akun Anda AWS .
1. Ikuti langkah-langkah di bawah ini untuk melampirkan izin yang diperlukan ke peran IAM Anda:
1. Pada halaman **Izin**, pilih **Tambahkan izin**.
1. Pilih **Buat kebijakan sebaris**.
1. Pilih tab **JSON** dan salin izin berikut ke kotak teks **JSON**. Gunakan template di bawah **Sebagian Besar Wilayah** jika Anda tidak berada di wilayah Tiongkok. Jika Anda berada di wilayah Tiongkok, gunakan templat **di bawah Wilayah Beijing dan Ningxia**.
------
#### [ Most Regions ]
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iotdeviceadvisor:*",
"Resource": [
"arn:aws:iotdeviceadvisor:*:*:suiterun/*/*",
"arn:aws:iotdeviceadvisor:*:*:suitedefinition/*"
]
},
{
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::*:role/idt*",
"Condition": {
"StringEquals": {
"iam:PassedToService": "iotdeviceadvisor.amazonaws.com"
}
}
},
{
"Effect": "Allow",
"Action": [
"execute-api:Invoke*",
"iam:ListRoles",
"iot:Connect",
"iot:CreateJob",
"iot:DeleteJob",
"iot:DescribeCertificate",
"iot:DescribeEndpoint",
"iot:DescribeJobExecution",
"iot:DescribeJob",
"iot:DescribeThing",
"iot:GetPolicy",
"iot:ListAttachedPolicies",
"iot:ListCertificates",
"iot:ListPrincipalPolicies",
"iot:ListThingPrincipals",
"iot:ListThings",
"iot:Publish",
"iot:UpdateThingShadow",
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:DescribeLogGroups",
"logs:DescribeLogStreams",
"logs:PutLogEvents",
"logs:PutRetentionPolicy"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "iotdeviceadvisor:*",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "logs:DeleteLogGroup",
"Resource": "arn:aws:logs:*:*:log-group:/aws/iot/deviceadvisor/*"
},
{
"Effect": "Allow",
"Action": "logs:GetLogEvents",
"Resource": "arn:aws:logs:*:*:log-group:/aws/iot/deviceadvisor/*:log-stream:*"
},
{
"Effect": "Allow",
"Action": [
"iam:CreatePolicy",
"iam:DetachRolePolicy",
"iam:DeleteRolePolicy",
"iam:DeletePolicy",
"iam:CreateRole",
"iam:DeleteRole",
"iam:AttachRolePolicy"
],
"Resource": [
"arn:aws:iam::*:policy/idt*",
"arn:aws:iam::*:role/idt*"
]
},
{
"Effect": "Allow",
"Action": [
"ssm:GetParameters"
],
"Resource": [
"arn:aws:ssm:*::parameter/aws/service/ami-amazon-linux-latest/amzn2-ami-hvm-x86_64-gp2"
]
},
{
"Effect": "Allow",
"Action": [
"ec2:DescribeInstances",
"ec2:RunInstances",
"ec2:CreateSecurityGroup",
"ec2:CreateTags",
"ec2:DeleteTags"
],
"Resource": [
"*"
]
},
{
"Effect": "Allow",
"Action": [
"ec2:CreateKeyPair",
"ec2:DeleteKeyPair"
],
"Resource": [
"arn:aws:ec2:*:*:key-pair/idt-ec2-ssh-key-*"
]
},
{
"Effect": "Allow",
"Condition": {
"StringEqualsIgnoreCase": {
"aws:ResourceTag/Owner": "IoTDeviceTester"
}
},
"Action": [
"ec2:TerminateInstances",
"ec2:DeleteSecurityGroup",
"ec2:AuthorizeSecurityGroupIngress",
"ec2:RevokeSecurityGroupIngress"
],
"Resource": [
"*"
]
}
]
}
```
------
------
#### [ Beijing and Ningxia Regions ]
Template kebijakan berikut dapat digunakan di Wilayah Beijing dan Ningxia.
------
1. Setelah selesai, pilih **Tinjau kebijakan**.
1. Masukkan **IDTFreeRTOSIAMPermissions**sebagai nama kebijakan.
1. Pilih **Buat kebijakan**.
1. Lampirkan **AWSIoTDeviceTesterForFreeRTOSFullAkses** ke peran IAM Anda.
1. Untuk melampirkan izin yang diperlukan ke peran IAM Anda:
1. Pada halaman **Izin**, pilih **Tambahkan izin**.
1. Pilih **Lampirkan kebijakan**.
1. Cari kebijakan **AWSIoTDeviceTesterForFreeRTOSFullAkses**. Centang kotaknya.
1. Pilih **Tambahkan izin**.
1. Ekspor kredensi untuk IDT. Lihat [Mendapatkan kredensi peran IAM untuk akses CLI untuk detailnya](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html).
## AWS IoT Device Tester kebijakan terkelola
Kebijakan `AWSIoTDeviceTesterForFreeRTOSFullAccess` terkelola berisi AWS IoT Device Tester izin berikut untuk pemeriksaan versi, fitur pembaruan otomatis, dan kumpulan metrik.
+ `iot-device-tester:SupportedVersion`
Memberikan AWS IoT Device Tester izin untuk mengambil daftar produk yang didukung, rangkaian pengujian, dan versi IDT.
+ `iot-device-tester:LatestIdt`
Memberikan AWS IoT Device Tester izin untuk mengambil versi IDT terbaru yang tersedia untuk diunduh.
+ `iot-device-tester:CheckVersion`
Memberikan AWS IoT Device Tester izin untuk memeriksa kompatibilitas versi untuk IDT, suite pengujian, dan produk.
+ `iot-device-tester:DownloadTestSuite`
Memberikan AWS IoT Device Tester izin untuk mengunduh pembaruan rangkaian pengujian.
+ `iot-device-tester:SendMetrics`
Memberikan AWS izin untuk mengumpulkan metrik tentang penggunaan AWS IoT Device Tester internal.
## (Opsional) Instal AWS Command Line Interface
Anda mungkin lebih suka menggunakan AWS CLI untuk melakukan beberapa operasi. Jika Anda belum AWS CLI menginstal, ikuti petunjuk di [Install the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html).
Konfigurasikan AWS CLI untuk AWS Wilayah yang ingin Anda gunakan dengan menjalankan **aws configure** dari baris perintah. [Untuk informasi tentang AWS Wilayah yang mendukung IDT untuk FreeRTOS,AWS lihat Wilayah dan Titik Akhir.](https://docs.aws.amazon.com/general/latest/gr/rande.html#amazon-freertos-ota-control) Untuk informasi selengkapnya, **aws configure** lihat [Konfigurasi cepat dengan **aws configure**](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config).