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, lalu menunjukkan cara menjalankan pengujian. 

**Topics**
+ [Konfigurasi AWS credentials](#configure-aws-credentials)
+ [Buka IDT-FreeRTOS UI](#open-idt-ui)
+ [Buat konfigurasi baru](#create-new-configuration)
+ [Memodifikasi 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 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

### 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 kredensi 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 setelan file kredensi](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html).

### Konfigurasi AWS kredensional 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 kredensil 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 tempat Anda telah membaca dan menulis izin.

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 memungkinkan 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 adalah pengguna pertama kali, maka Anda harus membuat konfigurasi baru untuk mengatur file konfigurasi JSON yang IDT-FreeRTOS diperlukan 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 IDT-FreeRTOS UI, 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[Konfigurasi AWS credentials](#configure-aws-credentials), lalu buka kembali UI. IDT-FreeRTOS 

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 IDT-FreeRTOS digunakan 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 tes fungsionalitas build CMake. Konfigurasi ini hanya diperlukan 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 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
<a name="modify-existing-configuration"></a>

Jika Anda telah menyiapkan file konfigurasi untuk IDT, maka Anda dapat menggunakan IDT-FreeRTOS UI untuk memodifikasi konfigurasi yang ada. Pastikan bahwa 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 **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
<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 **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).