Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Gunakan antarmuka pengguna IDT untuk menjalankan rangkaian kualifikasi FreeRTOS
Dimulai dengan IDT v4.3.0, untuk AWS IoT Device Tester FreeRTOS (IDT-FreeRTOS) termasuk antarmuka pengguna berbasis web yang memungkinkan Anda untuk berinteraksi dengan baris perintah IDT executable dan file konfigurasi terkait. Anda dapat menggunakan UI IDT-Freertos untuk membuat konfigurasi baru untuk menjalankan pengujian IDT, atau untuk memodifikasi konfigurasi yang ada. Anda juga dapat menggunakan UI untuk memanggil IDT executable dan menjalankan tes.
IDT-Freertos UI menyediakan fungsi-fungsi berikut:
+ Sederhanakan pengaturan file konfigurasi untuk tes IDT-Freertos.
+ Sederhanakan menggunakan IDT-Freertos untuk menjalankan tes kualifikasi.
Untuk informasi tentang menggunakan baris perintah untuk menjalankan tes kualifikasi, lihat[Tes pertama papan mikrokontroler Anda](qual-steps.md).
Bagian ini menjelaskan prasyarat untuk menggunakan UI IDT-Freertos, dan menunjukkan cara memulai menjalankan pengujian kualifikasi di UI.
**Topics**
+ [Siapkan prasyarat untuk menjalankan suite kualifikasi FreeRTOS](dev-tester-ui-prereqs.md)
+ [Memulai dengan IDT-Freertos UI](dev-tester-ui-getting-started.md)
# Siapkan prasyarat untuk menjalankan suite kualifikasi FreeRTOS
Bagian ini menjelaskan prasyarat untuk menguji mikrokontroler dengan. AWS IoT Device Tester
**Topics**
+ [Gunakan browser web yang didukung](#idt-ui-supported-web-browser)
+ [Unduh FreeRTOS](#ui-download-afr)
+ [Unduh IDT untuk FreeRTOS](#ui-download-dev-tester-afr)
+ [Buat dan konfigurasikan AWS akun](#ui-config-aws-account)
+ [AWS IoT Device Tester kebijakan terkelola](#ui-managed-policy)
## Gunakan browser web yang didukung
UI IDT-Freertos mendukung browser web berikut.
| Peramban | Versi |
| --- | --- |
| Google Chrome | Tiga versi utama terbaru |
| Mozilla Firefox | Tiga versi utama terbaru |
| Microsoft Edge | Tiga versi utama terbaru |
| Apple Safari untuk macOS | Tiga versi utama terbaru |
Kami menyarankan Anda menggunakan Google Chrome atau Mozilla Firefox untuk pengalaman yang lebih baik.
**catatan**
UI IDT-Freertos tidak mendukung Microsoft Internet Explorer.
## Unduh FreeRTOS
Anda dapat mengunduh rilis FreeRTOS [GitHub](https://github.com/aws/amazon-freertos)dari dengan perintah berikut:
```
git clone --branch --recurse-submodules https://github.com/aws/amazon-freertos.git
cd amazon-freertos
git submodule update --checkout --init --recursive
```
di mana adalah versi FreeRTOS (misalnya, 202007.00) sesuai dengan versi IDT yang tercantum dalam. [Versi yang didukung AWS IoT Device Tester](dev-test-versions-afr.md) Ini memastikan Anda memiliki kode sumber lengkap, termasuk submodul, dan menggunakan versi IDT yang benar untuk versi FreeRTOS Anda, dan sebaliknya.
Windows memiliki batasan panjang jalur 260 karakter. Struktur jalur FreeRTOS memiliki banyak level dalam, jadi jika Anda menggunakan Windows, pertahankan jalur file Anda di bawah batas 260 karakter. Misalnya, kloning `C:\FreeRTOS` FreeRTOS ke bukan. `C:\Users\username\programs\projects\myproj\FreeRTOS\`
### Pertimbangan untuk kualifikasi LTS (kualifikasi untuk FreeRTOS yang menggunakan perpustakaan LTS)
+ Agar mikrokontroler Anda ditetapkan sebagai mendukung versi FreeRTOS berbasis dukungan jangka panjang (LTS) di Katalog Perangkat AWS Mitra, Anda harus menyediakan file manifes. *Untuk informasi lebih lanjut, lihat Daftar Periksa Kualifikasi [FreerTOS di Panduan Kualifikasi](https://docs.aws.amazon.com/freertos/latest/qualificationguide/afq-checklist.html) FreerTOS.*
+ Untuk memvalidasi bahwa mikrokontroler Anda mendukung versi FreeRTOS berbasis LTS dan memenuhi syarat untuk diserahkan ke Katalog Perangkat AWS Mitra, Anda harus menggunakan ( AWS IoT Device Tester IDT) dengan FreeRTOS Qualification (FRQ) test suite versi v1.4.x.
+ Support untuk FreeRTOS versi berbasis LTS terbatas pada FreeRTOS versi 202012.xx.
## 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 yang didukung AWS IoT Device Tester](dev-test-versions-afr.md)
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**
Kami menyarankan Anda mengekstrak paket IDT ke drive lokal. Mengizinkan beberapa pengguna menjalankan IDT dari lokasi bersama, seperti direktori NFS atau folder bersama jaringan Windows, dapat mengakibatkan sistem tidak merespons atau korupsi data.
## Buat dan konfigurasikan AWS akun
### Mendaftar untuk Akun AWS
Jika Anda tidak memiliki Akun AWS, selesaikan langkah-langkah berikut untuk membuatnya.
**Untuk mendaftar untuk Akun AWS**
1. Buka [https://portal.aws.amazon.com/billing/pendaftaran.](https://portal.aws.amazon.com/billing/signup)
1. Ikuti petunjuk online.
Bagian dari prosedur pendaftaran melibatkan menerima panggilan telepon atau pesan teks dan memasukkan kode verifikasi pada keypad telepon.
Saat Anda mendaftar untuk sebuah Akun AWS, sebuah *Pengguna root akun AWS*dibuat. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
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.govskope.cake/](https://aws.amazon.com/) dan memilih **Akun Saya**.
### 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 Anda Pengguna root akun AWS**
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/)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](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) di *AWS Sign-In Panduan Pengguna*.
1. Mengaktifkan autentikasi multi-faktor (MFA) untuk pengguna root Anda.
Untuk petunjuk, lihat [Mengaktifkan perangkat MFA virtual untuk pengguna Akun AWS root (konsol) Anda](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) di Panduan Pengguna *IAM*.
**Buat pengguna dengan akses administratif**
1. Aktifkan Pusat Identitas IAM.
Untuk mendapatkan petunjuk, silakan lihat [Mengaktifkan AWS IAM Identity Center](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-set-up-for-idc.html) di *Panduan Pengguna AWS IAM Identity Center *.
1. Di Pusat Identitas IAM, 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](https://docs.aws.amazon.com//singlesignon/latest/userguide/quick-start-default-idc.html) di *Panduan AWS IAM Identity Center Pengguna*.
**Masuk sebagai pengguna dengan akses administratif**
+ Untuk masuk dengan pengguna Pusat Identitas IAM, gunakan URL masuk yang dikirim ke alamat email saat Anda membuat pengguna Pusat Identitas IAM.
Untuk bantuan masuk menggunakan pengguna Pusat Identitas IAM, lihat [Masuk ke portal AWS akses](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html) di *Panduan AWS Sign-In Pengguna*.
**Tetapkan akses ke pengguna tambahan**
1. Di Pusat Identitas IAM, buat set izin yang mengikuti praktik terbaik menerapkan izin hak istimewa paling sedikit.
Untuk petunjuknya, lihat [Membuat set izin](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-started-create-a-permission-set.html) di *Panduan AWS IAM Identity Center Pengguna*.
1. Tetapkan pengguna ke grup, lalu tetapkan akses masuk tunggal ke grup.
Untuk petunjuk, lihat [Menambahkan grup](https://docs.aws.amazon.com//singlesignon/latest/userguide/addgroups.html) di *Panduan AWS IAM Identity Center Pengguna*.
## AWS IoT Device Tester kebijakan terkelola
Untuk mengaktifkan penguji perangkat menjalankan dan mengumpulkan metrik, kebijakan `AWSIoTDeviceTesterForFreeRTOSFullAccess` terkelola berisi izin berikut:
+ `iot-device-tester:SupportedVersion`
Memberikan izin untuk mendapatkan daftar versi FreeRTOS dan versi suite pengujian yang didukung oleh IDT, sehingga tersedia dari versi. AWS CLI
+ `iot-device-tester:LatestIdt`
Memberikan izin untuk mendapatkan AWS IoT Device Tester versi terbaru yang tersedia untuk diunduh.
+ `iot-device-tester:CheckVersion`
Memberikan izin untuk memeriksa apakah kombinasi produk, rangkaian pengujian, dan AWS IoT Device Tester versi kompatibel.
+ `iot-device-tester:DownloadTestSuite`
Memberikan izin AWS IoT Device Tester untuk mengunduh suite pengujian.
+ `iot-device-tester:SendMetrics`
Memberikan izin untuk mempublikasikan data metrik AWS IoT Device Tester penggunaan.
# Memulai dengan IDT-Freertos UI
Bagian ini menunjukkan cara menggunakan UI IDT-Freertos untuk membuat atau memodifikasi konfigurasi Anda, dan kemudian menunjukkan cara menjalankan pengujian.
**Topics**
+ [Konfigurasikan AWS kredensional](#configure-aws-credentials)
+ [Buka UI IDT-Freertos](#open-idt-ui)
+ [Buat konfigurasi baru](#create-new-configuration)
+ [Memodifikasi konfigurasi yang ada](#modify-existing-configuration)
+ [Jalankan tes kualifikasi](#run-tests-from-ui)
## Konfigurasikan AWS kredensional
Anda harus mengonfigurasi kredensi untuk AWS pengguna yang Anda buat. [Buat dan konfigurasikan AWS akun](dev-tester-ui-prereqs.md#ui-config-aws-account) Anda dapat menentukan kredensial Anda dengan salah satu dari dua cara berikut:
+ Di file kredensial
+ Sebagai variabel lingkungan
### Konfigurasikan AWS kredensional dengan file kredensial
IDT menggunakan file kredensials yang sama sebagai AWS CLI. Untuk informasi selengkapnya, lihat [File konfigurasi dan kredensial](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html).
Lokasi file kredensial bervariasi, tergantung pada sistem operasi yang Anda gunakan:
+ macOS, Linux: `~/.aws/credentials`
+ Windows: `C:\Users\UserName\.aws\credentials`
Tambahkan AWS kredensi Anda ke `credentials` file dalam format berikut:
```
[default]
aws_access_key_id =
aws_secret_access_key =
```
**catatan**
Jika Anda tidak menggunakan `default` AWS profil, pastikan untuk menentukan nama profil di UI IDT-Freertos. Untuk informasi selengkapnya tentang profil, lihat [Konfigurasi dan setelan file kredensi](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html).
### Konfigurasikan AWS kredensional dengan variabel lingkungan
Variabel lingkungan adalah variabel yang dikelola oleh sistem operasi dan digunakan oleh perintah sistem. Mereka tidak disimpan jika Anda menutup sesi SSH. UI IDT-Freertos menggunakan variabel `AWS_ACCESS_KEY_ID` dan `AWS_SECRET_ACCESS_KEY` lingkungan untuk menyimpan kredensil Anda. AWS
Untuk mengatur variabel ini di Linux, macOS, atau Unix, gunakan **export**:
```
export AWS_ACCESS_KEY_ID=
export AWS_SECRET_ACCESS_KEY=
```
Untuk menetapkan variabel ini di Windows, gunakan **set**:
```
set AWS_ACCESS_KEY_ID=
set AWS_SECRET_ACCESS_KEY=
```
## Buka UI IDT-Freertos
**Untuk membuka UI IDT-Freertos**
1. Unduh versi IDT-Freertos yang didukung dan ekstrak arsip yang diunduh ke lokasi di sistem file tempat Anda telah membaca dan menulis izin.
1. Jalankan perintah berikut untuk menavigasi ke direktori instalasi IDT-Freertos:
```
cd devicetester-extract-location/bin
```
1. Jalankan perintah berikut untuk membuka UI IDT-Freertos:
------
#### [ Linux ]
```
.devicetestergui_linux_x86-64.exe
```
------
#### [ Windows ]
```
./devicetestergui_win_x64-64
```
------
#### [ macOS ]
```
./devicetestergui_mac_x86-64
```
**catatan**
Di Mac, untuk memungkinkan sistem Anda menjalankan UI, buka **System Preferences -> Security & Privacy**. Ketika Anda menjalankan tes, Anda mungkin perlu melakukan ini tiga kali lagi.
------
UI IDT-Freertos terbuka di browser default Anda. Untuk informasi tentang browser yang didukung, lihat[Gunakan browser web yang didukung](dev-tester-ui-prereqs.md#idt-ui-supported-web-browser).
## Buat konfigurasi baru
Jika Anda adalah pengguna pertama kali, maka Anda harus membuat konfigurasi baru untuk menyiapkan file konfigurasi JSON yang diperlukan IDT-Freertos untuk menjalankan pengujian. Anda kemudian dapat menjalankan tes atau memodifikasi konfigurasi yang telah dibuat.
Untuk contoh`config.json`,`device.json`, dan `userdata.json` file, lihat[Tes pertama papan mikrokontroler Anda](qual-steps.md). Untuk contoh `resource.json` file yang hanya digunakan untuk menjalankan tes Bluetooth Low Energy (BLE), lihat[Jalankan tes Bluetooth Low Energy](afr-bridgekeeper-dt-bt.md).
**Untuk membuat konfigurasi baru**
1. **Di UI IDT-Freertos, buka menu navigasi, lalu pilih Buat konfigurasi baru.**
**penting**
Anda harus mengonfigurasi AWS kredensialnya sebelum membuka UI. Jika Anda belum mengonfigurasi kredensialnya, tutup jendela browser IDT-Freertos UI, ikuti langkah-langkahnya, lalu buka kembali UI IDT-Freertos. [Konfigurasikan AWS kredensional](#configure-aws-credentials)
1. Ikuti panduan konfigurasi untuk masuk ke pengaturan konfigurasi IDT yang digunakan untuk menjalankan tes kualifikasi. Wizard mengkonfigurasi pengaturan berikut dalam file konfigurasi JSON yang terletak di direktori. `devicetester-extract-location/config`
+ **AWS pengaturan** Akun AWS —Informasi yang digunakan IDT-Freertos untuk membuat AWS sumber daya selama pengujian dijalankan. Pengaturan ini dikonfigurasi dalam `config.json` file.
+ Repositori **FreerTOS** —Jalur absolut ke repositori FreerTOS dan kode porting, dan jenis kualifikasi yang ingin Anda lakukan. Pengaturan ini dikonfigurasi dalam `userdata.json` file.
Anda harus mem-port FreeRTOS untuk perangkat Anda sebelum Anda dapat menjalankan tes kualifikasi. Untuk informasi lebih lanjut, lihat Panduan Porting [FreerTOS](https://docs.aws.amazon.com/freertos/latest/portingguide/)
+ **Build dan flash** —Perintah build dan flash untuk perangkat keras Anda yang memungkinkan IDT untuk membangun dan mem-flash tes ke papan Anda secara otomatis. Pengaturan ini dikonfigurasi dalam `userdata.json` file.
+ **Perangkat** —Pengaturan kumpulan perangkat untuk perangkat yang akan diuji. Pengaturan ini dikonfigurasi di `id` dan `sku` bidang, dan `devices` blok untuk kumpulan perangkat dalam `device.json` file.
+ **Jaringan** —Pengaturan untuk menguji dukungan komunikasi jaringan untuk perangkat Anda. Pengaturan ini dikonfigurasi di `features` blok `device.json` file, dan di `clientWifiConfig` dan `testWifiConfig` blok dalam `userdata.json` file.
+ **Echo server** —Pengaturan konfigurasi server gema untuk tes soket aman. Pengaturan ini dikonfigurasi dalam `userdata.json` file.
Untuk informasi selengkapnya tentang konfigurasi server gema, lihat[https://docs.aws.amazon.com/freertos/latest/portingguide/afr-echo-server.html](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-echo-server.html).
+ **CMake**— (Opsional) Pengaturan untuk menjalankan pengujian fungsionalitas CMake build. Konfigurasi ini hanya diperlukan jika Anda menggunakannya CMake sebagai sistem build. Pengaturan ini dikonfigurasi dalam `userdata.json` file.
+ **BLE** —Pengaturan untuk menjalankan tes fungsionalitas Bluetooth Low Energy. Pengaturan ini dikonfigurasi di `features` blok `device.json` file dan dalam `resource.json` file.
+ **OTA** —Pengaturan untuk menjalankan tes fungsionalitas OTA. Pengaturan ini dikonfigurasi di `features` blok `device.json` file dan dalam `userdata.json` file.
1. Pada halaman **Tinjauan**, verifikasi informasi konfigurasi Anda.
Setelah Anda selesai meninjau konfigurasi Anda, untuk menjalankan tes kualifikasi Anda, pilih **Jalankan tes**.
## Memodifikasi konfigurasi yang ada
Jika Anda telah menyiapkan file konfigurasi untuk IDT, maka Anda dapat menggunakan UI IDT-Freertos untuk memodifikasi konfigurasi yang ada. Pastikan bahwa file konfigurasi yang ada tersedia di `devicetester-extract-location/config` direktori.
**Untuk memodifikasi konfigurasi baru**
1. **Di UI IDT-Freertos, buka menu navigasi, lalu pilih Edit konfigurasi yang ada.**
Dasbor konfigurasi menampilkan informasi tentang pengaturan konfigurasi yang ada. Jika konfigurasi salah atau tidak tersedia, status untuk konfigurasi tersebut adalah`Error validating configuration`.
1. Untuk mengubah pengaturan konfigurasi yang ada, selesaikan langkah-langkah berikut:
1. Pilih nama pengaturan konfigurasi untuk membuka halaman pengaturannya.
1. Ubah pengaturan, lalu pilih **Simpan** untuk membuat ulang file konfigurasi yang sesuai.
Setelah Anda selesai memodifikasi konfigurasi Anda, verifikasi bahwa semua pengaturan konfigurasi Anda lulus validasi. Jika status untuk setiap pengaturan konfigurasi adalah`Valid`, Anda dapat menjalankan tes kualifikasi menggunakan konfigurasi ini.
## Jalankan tes kualifikasi
Setelah Anda membuat konfigurasi untuk IDT-Freertos, Anda dapat menjalankan tes kualifikasi Anda.
**Untuk menjalankan tes kualifikasi**
1. Validasi konfigurasi Anda.
1. Di menu navigasi, pilih **Jalankan tes**.
1. Untuk memulai uji coba, pilih **Mulai tes**.
**IDT-Freertos menjalankan tes kualifikasi, dan menampilkan ringkasan uji coba dan kesalahan apa pun di konsol Test runner.** Setelah uji coba selesai, Anda dapat melihat hasil pengujian dan log dari lokasi berikut:
+ Hasil tes terletak di `devicetester-extract-location/results/execution-id` direktori.
+ Log uji terletak di `devicetester-extract-location/results/execution-id/logs` direktori.
Untuk informasi selengkapnya tentang hasil pengujian dan log, lihat [Lihat IDT untuk hasil FreeRTOS](view-results-frq.md) dan[Lihat IDT untuk log FreeRTOS](view-logs-frq.md).