

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

# Memecahkan masalah kesalahan
<a name="dt-afr-troubleshooting"></a>

Setiap eksekusi test suite memiliki ID eksekusi unik yang digunakan untuk membuat folder bernama `results/{{execution-id}}` dalam `results` direktori. Log grup pengujian individu berada di bawah `results/{{execution-id}}/logs` direktori. Gunakan keluaran konsol IDT untuk FreeRTOS untuk menemukan id eksekusi, id kasus uji, dan id grup uji dari kasus uji yang gagal lalu buka file log untuk kasus uji yang bernama. `results/{{execution-id}}/logs/{{test_group_id}}__{{test_case_id}}.log` Informasi dalam file ini meliputi: 
+ Output perintah build dan flash penuh.
+ Uji output eksekusi.
+ IDT lebih verbose untuk keluaran konsol FreeRTOS.

Kami merekomendasikan alur kerja berikut untuk pemecahan masalah:

1. Jika Anda melihat kesalahan "tidak {{user/role}} diizinkan untuk mengakses sumber daya ini”, pastikan Anda mengonfigurasi izin seperti yang ditentukan dalam[Membuat dan mengkonfigurasi AWS akun](dev-tester-prereqs.md#config-aws-account).

1. Baca output konsol untuk menemukan informasi, seperti eksekusi UUID dan tugas yang sedang dijalankan.

1. Lihat di `FRQ_Report.xml` file untuk pernyataan kesalahan dari setiap pengujian. Direktori ini berisi log eksekusi dari setiap kelompok uji.

1. Lihat di file log di bawah`/results/{{execution-id}}/logs`.

1. Selidiki salah satu bidang masalah berikut:
   + Konfigurasi perangkat, seperti file konfigurasi JSON di `/configs/` folder.
   + Antarmuka perangkat. Periksa log untuk menentukan antarmuka mana yang gagal.
   + Perkakas perangkat. Pastikan bahwa rantai alat untuk membangun dan mem-flash perangkat diinstal dan dikonfigurasi dengan benar.
   + Untuk FRQ 1.xx pastikan bahwa versi kode sumber FreeRTOS yang bersih dan kloning tersedia. Rilis FreeRTOS ditandai sesuai dengan versi FreeRTOS. Untuk mengkloning versi kode tertentu, gunakan perintah berikut:

     ```
     git clone --branch {{version-number}} https://github.com/aws/amazon-freertos.git
     cd amazon-freertos
     git submodule update --checkout --init --recursive
     ```

## Memecahkan masalah konfigurasi perangkat
<a name="troubleshoot-device-config"></a>

Ketika Anda menggunakan IDT untuk FreeRTOS, Anda harus mendapatkan file konfigurasi yang benar di tempat sebelum Anda menjalankan biner. Jika Anda mendapatkan kesalahan penguraian dan konfigurasi, langkah pertama Anda adalah menemukan dan menggunakan templat konfigurasi yang sesuai dengan lingkungan Anda. Template ini terletak di `{{IDT_ROOT}}/configs` direktori.

Jika Anda masih mengalami masalah, lihat proses debugging berikut.

### Di mana saya melihat?
<a name="where-to-look"></a>

Mulailah dengan membaca output konsol untuk menemukan informasi, seperti eksekusi UUID, yang direferensikan seperti `execution-id` dalam dokumentasi ini.

Selanjutnya, lihat `FRQ_Report.xml` file di `/results/{{execution-id}}` direktori. File ini berisi semua kasus uji yang dijalankan dan cuplikan kesalahan untuk setiap kegagalan. Untuk mendapatkan semua log eksekusi, cari file `/results/{{execution-id}}/logs/{{test_group_id}}__{{test_case_id}}.log` untuk setiap kasus uji.

### Kode kesalahan IDT
<a name="idt-error-codes"></a>

Tabel berikut menjelaskan kode kesalahan yang dihasilkan oleh IDT untuk FreeRTOS:


| Kode Kesalahan | Nama Kode Kesalahan | Kemungkinan Akar Penyebab | Pemecahan masalah | 
| --- | --- | --- | --- | 
| 201 | InvalidInputError | Bidang dalam `device.json``config.json`,, atau `userdata.json` hilang atau dalam format yang salah. | Pastikan bidang yang diperlukan tidak hilang dan dalam format wajib dalam file yang terdaftar. Untuk informasi selengkapnya, lihat [Tes pertama papan mikrokontroler Anda](qual-steps.md).  | 
| 202 | ValidationError | Bidang di`device.json`,`config.json`, atau `userdata.json` berisi nilai yang tidak valid. | Periksa pesan kesalahan di sisi kanan kode kesalahan dalam laporan:[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/dt-afr-troubleshooting.html) | 
| 203 | CopySourceCodeError | Tidak dapat menyalin kode sumber FreeRTOS ke direktori tertentu. | Verifikasi item berikut:[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/dt-afr-troubleshooting.html) | 
| 204 | BuildSourceError | Tidak dapat mengkompilasi kode sumber FreeRTOS. | Verifikasi item berikut:[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/dt-afr-troubleshooting.html) | 
| 205 | FlashOrRunTestError | IDT FreeRTOS tidak dapat mem-flash atau menjalankan FreeRTOS di DUT Anda. | Verifikasi informasi `flashTool` di bawah dalam `userdata.json` file Anda benar. Untuk informasi selengkapnya, lihat [Konfigurasikan pengaturan build, flash, dan uji](cfg-dt-ud.md). | 
| 206 | StartEchoServerError | IDT FreeRTOS tidak dapat memulai server gema untuk tes soket atau aman. WiFi  | Verifikasi port yang dikonfigurasi `echoServerConfiguration` di bawah `userdata.json` file Anda tidak digunakan atau diblokir oleh firewall atau pengaturan jaringan. | 

### Kesalahan penguraian file konfigurasi debug
<a name="parse-error"></a>

Kadang-kadang, eror ketik dalam konfigurasi JSON dapat menyebabkan penguraian eror. Sebagian besar waktu, masalahnya adalah akibat dari menghilangkan tanda kurung, koma, atau kutipan dari file JSON Anda. IDT untuk FreeRTOS melakukan validasi JSON dan mencetak informasi debugging. IDT mencetak garis di mana kesalahan terjadi, nomor baris, dan nomor kolom kesalahan sintaks. Informasi ini seharusnya cukup untuk membantu Anda memperbaiki kesalahan, tetapi jika Anda masih mengalami masalah dalam menemukan kesalahan, Anda dapat melakukan validasi secara manual di IDE Anda, editor teks seperti Atom atau Sublime, atau melalui alat online seperti JSONLint.

### Kesalahan penguraian hasil tes debug
<a name="test-results-parse-error"></a>

 **Saat menjalankan grup uji dari [ FreeRTOS-Libraries-Integration-Tests](https://github.com/FreeRTOS/FreeRTOS-Libraries-Integration-Tests), seperti, **FullPKCS11\_CoreFullTransportInterfaceTLS, FullPKCS11\_, FullPKCS11\_, FullPKCS11\_ \_ECC, FullPKCS11\_ \_RSAOnboard\_ECC, atau OtaCoreOnboard\_RSA, IDT untuk Freertos mem-parsing hasil pengujian dari perangkat uji dengan koneksi PreProvisioned** serial. PreProvisioned** Terkadang, output serial tambahan pada perangkat dapat mengganggu penguraian hasil pengujian. 

 Dalam kasus yang disebutkan di atas, alasan kegagalan kasus uji aneh seperti string yang berasal dari output perangkat yang tidak terkait adalah output. File log kasus uji IDT untuk FreeRTOS (yang mencakup semua IDT keluaran serial untuk FreeRTOS telah diterima selama pengujian) dapat menunjukkan hal berikut:

```
<unrelated device output>
TEST(Full_PKCS11_Capabilities, PKCS11_Capabilities)<unrelated device output>
<unrelated device output>
 PASS
```

**Dalam contoh di atas, output perangkat yang tidak terkait mencegah IDT untuk FreeRTOS mendeteksi hasil pengujian yang LULUS.**

Periksa hal berikut untuk memastikan pengujian yang optimal.
+ Pastikan makro logging yang digunakan pada perangkat aman untuk utas. Lihat [Menerapkan makro logging pustaka](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-library-logging-macros.html) untuk informasi selengkapnya. 
+ Pastikan ada output minimal ke koneksi serial selama pengujian. Output perangkat lain dapat menjadi masalah bahkan jika makro logging Anda benar-benar aman untuk thread, karena hasil pengujian akan ditampilkan dalam panggilan terpisah selama pengujian. 

 Log kasus uji IDT untuk FreeRTOS idealnya akan menampilkan hasil tes yang tidak terputus seperti di bawah ini: 

```
---------STARTING TESTS---------
TEST(Full_OTA_PAL, otaPal_CloseFile_ValidSignature) PASS
TEST(Full_OTA_PAL, otaPal_CloseFile_InvalidSignatureBlockWritten) PASS
-----------------------
2 Tests 0 Failures 0 Ignored
```

### Kegagalan pemeriksaan integritas debug
<a name="integrity-check"></a>

Jika menggunakan FreeRTOS versi FRQ 1.xx, pemeriksaan integritas berikut berlaku.

Ketika Anda menjalankan grup uji FreertosIntegrity dan Anda mengalami kegagalan, pertama-tama pastikan bahwa Anda belum memodifikasi file direktori apa pun. `{{freertos}}` Jika Anda belum, dan masih melihat masalah, pastikan Anda menggunakan cabang yang benar. Jika Anda menjalankan `list-supported-products` perintah IDT, Anda dapat menemukan cabang `{{freertos}}` repo yang diberi tag mana yang harus Anda gunakan.

Jika Anda mengkloning cabang `freertos` repo yang diberi tag yang benar dan masih mengalami masalah, pastikan Anda juga menjalankan perintah. `submodule update` Alur kerja klon untuk `freertos` repo adalah sebagai berikut. 

```
git clone --branch version-number https://github.com/aws/amazon-freertos.git
cd amazon-freertos
git submodule update --checkout —init —recursive
```

Daftar file yang dicari pemeriksa integritas ada di `checksums.json` file di `{{freertos}}` direktori Anda. Untuk memenuhi syarat port FreeRTOS tanpa modifikasi apa pun pada file dan struktur folder, pastikan tidak ada file yang tercantum di bagian '' dan `exhaustive` `minimal` '' file yang telah dimodifikasi. `checksums.json` Untuk menjalankan dengan SDK yang dikonfigurasi, verifikasi bahwa tidak ada file di bawah bagian '`minimal`' yang telah dimodifikasi.

Jika Anda menjalankan IDT dengan SDK dan telah memodifikasi beberapa file di `{{freertos}}` direktori Anda, pastikan Anda mengonfigurasi SDK dengan benar di file Anda. `userdata` Jika tidak, pemeriksa Integritas akan memverifikasi semua file di `{{freertos}}` direktori.

### Kegagalan grup FullWiFi uji debug
<a name="full-wifi-failures"></a>

Jika Anda menggunakan FRQ 1.xx dan mengalami kegagalan dalam grup FullWiFi pengujian, dan pengujian "`AFQP_WiFiConnectMultipleAP`" gagal, ini bisa jadi karena kedua titik akses tidak berada dalam subnet yang sama dengan komputer host yang menjalankan IDT. Pastikan bahwa kedua titik akses berada di subnet yang sama dengan komputer host yang menjalankan IDT.

### Debug kesalahan “parameter yang diperlukan hilang”
<a name="param-missing"></a>

Karena fitur baru ditambahkan ke IDT untuk FreeRTOS, perubahan pada file konfigurasi mungkin diperkenalkan. Penggunaan file konfigurasi lama mungkin akan merusak konfigurasi Anda. Jika ini terjadi, `{{test_group_id}}__{{test_case_id}}.log` file di bawah `results/{{execution-id}}/logs` direktori secara eksplisit mencantumkan semua parameter yang hilang. IDT untuk FreeRTOS memvalidasi skema file konfigurasi JSON Anda untuk memastikan bahwa versi terbaru yang didukung telah digunakan.

### Debug kesalahan “tes tidak dapat memulai”
<a name="could-not-start-test"></a>

Anda mungkin melihat kesalahan yang mengarah ke kegagalan selama pengujian dimulai. Karena ada beberapa kemungkinan penyebab, periksa area berikut untuk kebenaran:
+ Pastikan bahwa nama pool yang Anda sertakan dalam perintah eksekusi Anda benar-benar ada. Ini direferensikan langsung dari `device.json` file Anda.
+ Pastikan perangkat atau perangkat di kolam Anda memiliki parameter konfigurasi yang benar.

### Debug kesalahan “tidak dapat menemukan awal hasil pengujian”
<a name="unable-to-find-start-of-test"></a>

Anda mungkin melihat kesalahan saat IDT mencoba mengurai hasil output oleh perangkat yang sedang diuji. Ada beberapa kemungkinan penyebab, jadi periksa area berikut untuk kebenaran: 
+ Pastikan perangkat yang diuji memiliki koneksi yang stabil ke mesin host Anda. Anda dapat memeriksa file log untuk pengujian yang menunjukkan kesalahan ini untuk melihat apa yang diterima IDT.
+ Jika menggunakan FRQ 1.xx, dan perangkat yang diuji terhubung melalui jaringan lambat atau antarmuka lain, atau Anda tidak melihat tanda “---------STARTING TESTS---------” di log grup uji FreeRTOS bersama dengan output grup uji FreeRTOS lainnya, Anda dapat mencoba meningkatkan nilai dalam konfigurasi data pengguna Anda. `testStartDelayms` Untuk informasi selengkapnya, lihat [Konfigurasikan pengaturan build, flash, dan uji](cfg-dt-ud.md).

### Debug kesalahan “Uji kegagalan: diharapkan \_\_ hasil tetapi melihat \_\_\_” kesalahan
<a name="expected-but-saw-different"></a>

Anda mungkin melihat kesalahan yang mengarah ke kegagalan pengujian selama pengujian. Tes mengharapkan sejumlah hasil tertentu, dan tidak melihatnya selama pengujian. Beberapa tes FreeRTOS berjalan sebelum IDT melihat output dari perangkat. Jika Anda melihat kesalahan ini, Anda dapat mencoba meningkatkan nilai `testStartDelayms` dalam konfigurasi *data pengguna* Anda. Untuk informasi selengkapnya, lihat [Konfigurasikan pengaturan build, flash, dan uji](lts-cfg-dt-ud.md). 

### Debug kesalahan “\_\_\_\_\_\_\_\_ tidak dipilih karena kendala” ConditionalTests
<a name="unselected-conditional-tests"></a>

Ini berarti Anda menjalankan pengujian pada kumpulan perangkat yang tidak kompatibel dengan pengujian. Ini mungkin terjadi dengan tes OTA E2E. Misalnya, saat menjalankan grup `OTADataplaneMQTT` pengujian dan di file `device.json` konfigurasi Anda, Anda telah memilih OTA sebagai **Tidak** atau `OTADataPlaneProtocol` sebagai **HTTP**. Kelompok uji yang dipilih untuk dijalankan harus sesuai dengan pilihan `device.json` kemampuan Anda. 

### Debug batas waktu IDT selama pemantauan keluaran perangkat
<a name="idt-timeout"></a>

IDT dapat timeout karena sejumlah alasan. Jika batas waktu terjadi selama fase pemantauan keluaran perangkat pengujian, dan Anda dapat melihat hasil di dalam log kasus uji IDT, itu berarti hasilnya salah diuraikan oleh IDT. Salah satu alasannya adalah pesan log yang disisipkan di tengah hasil tes. Jika ini masalahnya, silakan merujuk ke Panduan [Porting FreerTOS](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-porting-ota.html) untuk detail lebih lanjut tentang bagaimana log UNITY harus disiapkan.

 Alasan lain untuk batas waktu selama pemantauan keluaran perangkat bisa jadi perangkat reboot setelah kegagalan kasus uji TLS tunggal. Perangkat kemudian menjalankan gambar yang di-flash dan menyebabkan loop tak terbatas yang terlihat di log. Jika ini terjadi, pastikan perangkat Anda tidak reboot setelah kegagalan pengujian. 

### Debug kesalahan “tidak diizinkan untuk mengakses sumber daya”
<a name="not-authorized-to-access"></a>

Anda mungkin melihat kesalahan "tidak {{user/role}} diizinkan untuk mengakses sumber daya ini” di output terminal atau di `test_manager.log` file di bawah`/results/{{execution-id}}/logs`. Untuk mengatasi masalah ini, lampirkan `AWS IoTDeviceTesterForFreeRTOSFullAccess` kebijakan terkelola untuk pengguna pengetesan Anda. Untuk informasi selengkapnya, lihat [Membuat dan mengkonfigurasi AWS akun](dev-tester-prereqs.md#config-aws-account). 

### Kesalahan pengujian jaringan debug
<a name="network-test-errors"></a>

Untuk pengujian berbasis jaringan, IDT memulai server gema yang mengikat ke port yang tidak dicadangkan pada mesin host. Jika Anda mengalami kesalahan karena batas waktu atau koneksi yang tidak tersedia dalam pengujian soket WiFi atau aman, pastikan jaringan Anda dikonfigurasi untuk memungkinkan lalu lintas ke port yang dikonfigurasi dalam rentang 1024 - 49151.

Tes soket aman menggunakan port 33333 dan 33334 secara default. WiFi Tes menggunakan port 33335 secara default. Jika ketiga port ini sedang digunakan atau diblokir oleh firewall atau jaringan, Anda dapat memilih untuk menggunakan port yang berbeda di userdata.json untuk pengujian. Untuk informasi selengkapnya, lihat [Konfigurasikan pengaturan build, flash, dan uji](cfg-dt-ud.md). Anda dapat menggunakan perintah berikut untuk memeriksa apakah port tertentu sedang digunakan:
+ Windows: `netsh advfirewall firewall show rule name=all | grep port`
+ Linux: `sudo netstat -pan | grep port`
+ macOS: `netstat -nat | grep port`

### Kegagalan pembaruan OTA karena payload versi yang sama
<a name="ota-update-failure"></a>

Jika kasus pengujian OTA gagal karena versi yang sama ada di perangkat setelah OTA dilakukan, itu mungkin karena sistem build Anda (misalnya cmake) tidak memperhatikan perubahan IDT pada kode sumber FreeRTOS dan tidak membangun biner yang diperbarui. Hal ini menyebabkan OTA dilakukan dengan biner yang sama yang saat ini ada di perangkat, dan pengujian gagal. Untuk mengatasi masalah kegagalan pembaruan OTA, mulailah dengan memastikan bahwa Anda menggunakan versi terbaru yang didukung dari sistem build Anda. 

### Kegagalan uji OTA pada kasus `PresignedUrlExpired`uji
<a name="ota-test-failure"></a>

Salah satu prasyarat dari tes ini adalah bahwa waktu pembaruan OTA harus lebih dari 60 detik, jika tidak pengujian akan gagal. Jika ini terjadi, pesan kesalahan berikut ditemukan di log: “Tes membutuhkan waktu kurang dari 60 detik (waktu kedaluwarsa url) untuk selesai. Silakan hubungi kami.” 

### Debug antarmuka perangkat dan kesalahan port
<a name="device-interface"></a>

Bagian ini berisi informasi tentang antarmuka perangkat yang digunakan IDT untuk terhubung ke perangkat Anda.

#### Platform yang didukung
<a name="platform-differences"></a>

IDT mendukung Linux, macOS, dan Windows. Ketiga platform memiliki skema penamaan yang berbeda untuk perangkat serial yang melekat padanya:
+ Linux: `/dev/tty*`
+ macOS: atau `/dev/tty.*` `/dev/cu.*`
+ Jendela: COM\*

Untuk memeriksa port perangkat Anda:
+ Untuk Linux/macOS, buka terminal dan jalankan`ls /dev/tty*`.
+ Untuk macOS, buka terminal dan jalankan `ls /dev/tty.*` atau. `ls /dev/cu.*`
+ Untuk Windows, buka Device Manager dan perluas grup perangkat serial.

Untuk memverifikasi perangkat mana yang terhubung ke port:
+ Untuk Linux, pastikan bahwa `udev` paket diinstal, dan kemudian jalankan`udevadm info –name={{PORT}}`. Utilitas ini mencetak informasi driver perangkat yang membantu Anda memverifikasi bahwa Anda menggunakan port yang benar. 
+ Untuk macOS, buka Launchpad dan cari. **System Information**
+ Untuk Windows, buka Device Manager dan perluas grup perangkat serial.

#### Antarmuka perangkat
<a name="device-interfaces"></a>

Setiap perangkat yang disematkan berbeda, yang berarti mereka dapat memiliki satu atau lebih port serial. Adalah umum bagi perangkat untuk memiliki dua port saat terhubung ke mesin:
+ Port data untuk mem-flash perangkat.
+ Port baca untuk membaca output.

  Anda harus mengatur port baca yang benar di `device.json` file Anda. Jika tidak, membaca output dari perangkat mungkin gagal.

  Dalam kasus beberapa port, pastikan untuk menggunakan port baca perangkat di `device.json` file Anda. Misalnya, jika Anda mencolokkan perangkat Espressif Wrover dan dua port yang ditetapkan padanya adalah `/dev/ttyUSB0` dan`/dev/ttyUSB1`, gunakan `/dev/ttyUSB1` dalam file Anda. `device.json`

Untuk Windows, ikuti logika yang sama.

#### Membaca data perangkat
<a name="reading-device-data"></a>

IDT untuk FreeRTOS menggunakan build perangkat individual dan perkakas flash untuk menentukan konfigurasi port. Jika Anda menguji perangkat Anda dan tidak mendapatkan output, coba pengaturan default berikut:
+ Tingkat baud: 115200
+ Bit data: 8
+ Paritas: Tidak ada
+ Hentikan bit: 1
+ Kontrol aliran: Tidak ada

Pengaturan ini ditangani oleh IDT untuk FreeRTOS. Anda tidak harus mengaturnya. Namun, Anda dapat menggunakan metode yang sama untuk membaca output perangkat secara manual. Di Linux atau macOS, Anda dapat melakukan ini dengan perintah. `screen` Di Windows, Anda dapat menggunakan program seperti TeraTerm.

`Screen: screen /dev/cu.usbserial 115200`

`TeraTerm: Use the above-provided settings to set the fields explicitly in the GUI.`

### Masalah rantai alat pengembangan
<a name="dev-toolchain"></a>

Bagian ini membahas masalah yang dapat terjadi dengan toolchain Anda.

#### Code Composer Studio di Ubuntu
<a name="ccs-ubuntu"></a>

Versi Ubuntu yang lebih baru (17.10 dan 18.04) memiliki versi `glibc` paket yang tidak kompatibel dengan Code Composer Studio 7. *x* versi. Kami menyarankan Anda menginstal Code Composer Studio versi 8.2 atau yang lebih baru.

Gejala ketidakcocokan mungkin termasuk:
+ FreeRTOS gagal membangun atau mem-flash ke perangkat Anda.
+ Penginstal Code Composer Studio mungkin membeku.
+ Tidak ada output log yang ditampilkan di konsol selama proses build atau flash.
+ Build command mencoba untuk meluncurkan dalam mode GUI bahkan ketika dipanggil sebagai headless.

### Pencatatan log
<a name="dt-logging"></a>

IDT untuk log FreeRTOS ditempatkan di satu lokasi. Dari direktori root IDT, file-file ini tersedia di bawah`results/{{execution-id}}/`:
+ `FRQ_Report.xml`
+ `awsiotdevicetester_report.xml`
+ `logs/{{test_group_id}}__{{test_case_id}}.log`

`FRQ_Report.xml`dan `logs/{{test_group_id}}__{{test_case_id}}.log` merupakan log yang paling penting untuk diperiksa. `FRQ_Report.xml`berisi informasi tentang kasus uji mana yang gagal dengan pesan kesalahan tertentu. Anda kemudian dapat menggunakan `logs/{{test_group_id}}__{{test_case_id}}.log` untuk menggali lebih jauh ke dalam masalah untuk mendapatkan konteks yang lebih baik. 

#### Kesalahan konsol
<a name="err-console"></a>

Saat AWS IoT Device Tester dijalankan, kegagalan dilaporkan ke konsol dengan pesan singkat. Lihat `results/{{execution-id}}/logs/{{test_group_id}}__{{test_case_id}}.log` untuk mempelajari lebih lanjut tentang kesalahan.

#### Kesalahan log
<a name="err-log"></a>

Setiap eksekusi test suite memiliki ID eksekusi unik yang digunakan untuk membuat folder bernama`results/{{execution-id}}`. Log kasus uji individu berada di bawah `results/{{execution-id}}/logs` direktori. Gunakan output konsol IDT untuk FreeRTOS untuk menemukan id eksekusi, id kasus uji, dan id grup uji kasus uji yang gagal. Kemudian gunakan informasi ini untuk menemukan dan membuka file log untuk kasus uji yang bernama `results/{{execution-id}}/logs/{{test_group_id}}__{{test_case_id}}.log` Informasi dalam file ini mencakup output perintah build dan flash penuh, output eksekusi pengujian, dan lebih banyak keluaran AWS IoT Device Tester konsol verbose.

#### Masalah bucket S3
<a name="s3-bucket-issues"></a>

Jika Anda menekan CTRL\+C saat menjalankan IDT, IDT akan memulai proses pembersihan. Bagian dari pembersihan itu adalah menghapus sumber daya Amazon S3 yang telah dibuat sebagai bagian dari pengujian IDT. Jika pembersihan tidak dapat diselesaikan, Anda mungkin mengalami masalah di mana Anda memiliki terlalu banyak bucket Amazon S3 yang telah dibuat. Ini berarti lain kali Anda menjalankan IDT pengujian akan mulai gagal. 

Jika Anda menekan CTRL\+C untuk menghentikan IDT, Anda harus membiarkannya menyelesaikan proses pembersihan untuk menghindari masalah ini. Anda juga dapat menghapus bucket Amazon S3 dari akun Anda yang dibuat secara manual.

## Memecahkan masalah kesalahan batas waktu
<a name="troubleshoot-timeout"></a>

Jika Anda melihat kesalahan batas waktu saat menjalankan rangkaian pengujian, tingkatkan batas waktu dengan menentukan faktor pengganda batas waktu. Faktor ini diterapkan ke nilai batas waktu default. Nilai apa pun yang dikonfigurasi untuk bendera ini harus lebih besar dari atau sama dengan 1.0. Untuk menggunakan pengganda batas waktu, gunakan tanda `--timeout-multiplier` saat menjalankan rangkaian pengujian.

**Example**  

```
./devicetester_linux run-suite --suite-id FRQ_1.0.1 --pool-id DevicePool1 --timeout-multiplier 2.5
```

```
./devicetester_linux run-suite --suite-id FRQ_1 --pool-id DevicePool1 --timeout-multiplier 2.5
```

## Fitur seluler dan AWS biaya
<a name="troubleshoot-cellular-costs"></a>

Ketika `Cellular` fitur diatur ke `Yes` dalam `device.JSON` file Anda, FullSecureSockets akan menggunakan instans EC2 t.micro untuk menjalankan pengujian dan ini dapat menimbulkan biaya tambahan ke akun Anda. AWS Untuk informasi selengkapnya, lihat [Harga Amazon EC2](https://aws.amazon.com/ec2/pricing/).

## Kebijakan pembuatan laporan kualifikasi
<a name="troubleshoot-qualification-report-generation"></a>

Laporan kualifikasi hanya dihasilkan oleh versi AWS IoT Device Tester (IDT) yang mendukung versi FreeRTOS yang dirilis dalam dua tahun terakhir. Jika Anda memiliki pertanyaan tentang kebijakan dukungan, silakan hubungi [AWS Dukungan](https://aws.amazon.com/contact-us/).