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

# Memulai dengan IDT-FreeRTOS UI
<a name="dev-tester-ui-getting-started"></a>

Bagian ini menunjukkan cara menggunakan IDT-FreeRTOS UI untuk membuat atau memodifikasi konfigurasi Anda, dan kemudian menunjukkan cara menjalankan pengujian. 

**Topics**
+ [Konfigurasi AWS credentials](#configure-aws-credentials)
+ [Buka IDT-FreeRTOS UI](#open-idt-ui)
+ [Buat konfigurasi baru](#create-new-configuration)
+ [Ubah konfigurasi yang ada](#modify-existing-configuration)
+ [Jalankan tes kualifikasi](#run-tests-from-ui)

## Konfigurasi AWS credentials
<a name="configure-aws-credentials"></a>

Anda harus mengonfigurasi kredenSIAL 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

### Konfigurasi AWS kredenSIAL dengan file kredenSIAL
<a name="config-cred-file"></a>

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 kredenSIAL Anda ke `credentials` file dalam format berikut:

```
[default]
aws_access_key_id = {{<your_access_key_id>}}
aws_secret_access_key = {{<your_secret_access_key>}}
```

**catatan**  
Jika Anda tidak menggunakan `default` AWS profil, pastikan untuk menentukan nama profil di IDT-FreeRTOS UI. Untuk informasi selengkapnya tentang profil, lihat [ Konfigurasi dan pengaturan ](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html) file kredensia.

### Konfigurasi AWS kredenSIAL dengan variabel lingkungan
<a name="config-env-vars"></a>

Variabel lingkungan adalah variabel yang dikelola oleh sistem operasi dan digunakan oleh perintah sistem. Mereka tidak disimpan jika Anda menutup sesi SSH. IDT-FreeRTOS UI menggunakan variabel `AWS_ACCESS_KEY_ID` dan `AWS_SECRET_ACCESS_KEY` lingkungan untuk menyimpan AWS kredenSIAL Anda.

Untuk mengatur variabel ini di Linux, macOS, atau Unix, gunakan **export**:

```
export AWS_ACCESS_KEY_ID={{<your_access_key_id>}}
export AWS_SECRET_ACCESS_KEY={{<your_secret_access_key>}}
```

Untuk menetapkan variabel ini di Windows, gunakan **set**:

```
set AWS_ACCESS_KEY_ID={{<your_access_key_id>}}
set AWS_SECRET_ACCESS_KEY={{<your_secret_access_key>}}
```

## Buka IDT-FreeRTOS UI
<a name="open-idt-ui"></a>

**Untuk membuka IDT-FreeRTOS UI **

1. Unduh IDT-FreeRTOS versi yang didukung dan ekstrak arsip yang diunduh ke lokasi di sistem file Anda tempat Anda memiliki izin baca dan tulis.

1. Jalankan perintah berikut untuk menavigasi ke direktori IDT-FreeRTOS instalasi:

   ```
   cd {{devicetester-extract-location}}/bin 
   ```

1. Jalankan perintah berikut untuk membuka IDT-FreeRTOS UI:

------
#### [ Linux ]

   ```
   .devicetestergui_linux_x86-64.exe
   ```

------
#### [ Windows ]

   ```
   ./devicetestergui_win_x64-64
   ```

------
#### [ macOS ]

   ```
   ./devicetestergui_mac_x86-64
   ```

**catatan**  
Di Mac, untuk mengizinkan sistem Anda menjalankan UI, buka ** System Preferences -> Security & Privacy**. Ketika Anda menjalankan tes, Anda mungkin perlu melakukan ini tiga kali lagi.

------

    IDT-FreeRTOS UI 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
<a name="create-new-configuration"></a>

Jika Anda pengguna pertama kali, maka Anda harus membuat konfigurasi baru untuk mengatur file konfigurasi JSON yang diperlukan IDT-FreeRTOS untuk menjalankan pengujian. Anda kemudian dapat menjalankan pengujian atau memodifikasi konfigurasi yang telah dibuat.

Untuk contoh `userdata.json` file`config.json`,`device.json`, dan, lihat[Tes pertama papan mikrokontroler Anda](qual-steps.md). Untuk contoh `resource.json` file yang hanya digunakan untuk menjalankan pengujian Bluetooth Low Energy (BLE), lihat[Jalankan tes Energi Rendah Bluetooth](afr-bridgekeeper-dt-bt.md).

**Untuk membuat konfigurasi baru **

1. Di IDT-FreeRTOS UI, buka menu navigasi, lalu pilih ** Buat konfigurasi baru**.
**penting**  
Anda harus mengonfigurasi AWS kredensibilitas Anda sebelum membuka UI. Jika Anda belum mengonfigurasi kredensialnya, tutup jendela browser IDT-FreeRTOS UI, ikuti langkah-langkah di[Konfigurasi AWS credentials](#configure-aws-credentials), lalu buka kembali IDT-FreeRTOS UI.

1. Ikuti panduan konfigurasi untuk memasukkan pengaturan konfigurasi IDT yang digunakan untuk menjalankan tes kualifikasi. Wizard mengonfigurasi pengaturan berikut dalam file konfigurasi JSON yang terletak di `{{devicetester-extract-location}}/config` direktori.
   + **AWS pengaturan ** — Akun AWS Informasi yang IDT-FreeRTOS digunakan untuk membuat AWS sumber daya selama uji coba. Pengaturan ini dikonfigurasi dalam `config.json` file.
   + **Repositori FreeRTOS ** —Jalur absolut ke repositori FreeRTOS dan kode yang di-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 selengkapnya, lihat Panduan Por [ ting FreeRTOS ](https://docs.aws.amazon.com/freertos/latest/portingguide/)
   + **Build and flash ** —Perintah build dan flash untuk perangkat keras Anda yang memungkinkan IDT 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 `sku` bidang `id` dan, 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 `testWifiConfig` blok `clientWifiConfig` dan dalam `userdata.json` file.
   + **Echo server ** —Pengaturan konfigurasi server echo untuk pengujian soket aman. Pengaturan ini dikonfigurasi dalam `userdata.json` file.

     Untuk informasi selengkapnya tentang konfigurasi server echo, 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 build CMake. Konfigurasi ini diperlukan hanya jika Anda menggunakan CMake sebagai sistem build Anda. 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 di `resource.json` file.
   + **OTA ** —Pengaturan untuk menjalankan tes fungsionalitas OTA. Pengaturan ini dikonfigurasi di `features` blok `device.json` file dan di `userdata.json` file.

1.  Pada ** halaman ** Tinjauan, verifikasi informasi konfigurasi Anda. 

Setelah selesai meninjau konfigurasi, untuk menjalankan tes kualifikasi, pilih J ** alankan pengujian**.

## Ubah konfigurasi yang ada
<a name="modify-existing-configuration"></a>

Jika Anda telah menyiapkan file konfigurasi untuk IDT, maka Anda dapat menggunakan IDT-FreeRTOS UI untuk mengubah konfigurasi yang ada. Pastikan file konfigurasi yang ada tersedia di `{{devicetester-extract-location}}/config` direktori.

**Untuk memodifikasi konfigurasi baru **

1. Di IDT-FreeRTOS UI, 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 S ** impan ** untuk membuat ulang file konfigurasi yang sesuai.

Setelah Anda selesai memodifikasi konfigurasi, verifikasi bahwa semua pengaturan konfigurasi Anda lulus validasi. Jika status untuk setiap pengaturan konfigurasi adalah`Valid`, Anda dapat menjalankan pengujian kualifikasi menggunakan konfigurasi ini.

## Jalankan tes kualifikasi
<a name="run-tests-from-ui"></a>

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 J ** alankan tes**.

1. Untuk memulai uji coba, pilih ** Mulai pengujian**.

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 lebih lanjut 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).