Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Membuat kumpulan perangkat di IDT untuk FreeRTOS
Perangkat yang akan diuji diatur dalam kumpulan perangkat. Setiap kumpulan perangkat terdiri dari satu atau lebih perangkat identik. Anda dapat mengonfigurasi IDT untuk FreeRTOS untuk menguji satu perangkat dalam kumpulan atau beberapa perangkat dalam kumpulan. Untuk mempercepat proses kualifikasi, IDT untuk FreeRTOS dapat menguji perangkat dengan spesifikasi yang sama secara paralel. Ini menggunakan metode round-robin untuk menjalankan grup pengujian yang berbeda pada setiap perangkat di kumpulan perangkat.
Anda dapat menambahkan satu atau lebih perangkat ke kumpulan perangkat dengan mengedit devices bagian device.json template di configs folder.
catatan
Semua perangkat di kolam yang sama harus memiliki spesifikasi teknis dan SKU yang sama.
Untuk mengaktifkan build paralel dari kode sumber untuk grup pengujian yang berbeda, IDT untuk FreeRTOS menyalin kode sumber ke folder hasil di dalam folder yang diekstrak IDT untuk FreeRTOS. Jalur kode sumber dalam perintah build atau flash Anda harus direferensikan menggunakan sdkPath variabel testdata.sourcePath or. IDT untuk FreeRTOS menggantikan variabel ini dengan jalur sementara dari kode sumber yang disalin. Untuk informasi selengkapnya, lihat IDT untuk variabel FreeRTOS.
Berikut ini adalah contoh device.json file yang digunakan untuk membuat kumpulan perangkat dengan beberapa perangkat.
[ { "id": "pool-id", "sku": "sku", "features": [ { "name": "WIFI", "value": "Yes | No" }, { "name": "Cellular", "value": "Yes | No" }, { "name": "OTA", "value": "Yes | No", "configs": [ { "name": "OTADataPlaneProtocol", "value": "HTTP | MQTT" } ] }, { "name": "BLE", "value": "Yes | No" }, { "name": "TCP/IP", "value": "On-chip | Offloaded | No" }, { "name": "TLS", "value": "Yes | No" }, { "name": "PKCS11", "value": "RSA | ECC | Both | No" }, { "name": "KeyProvisioning", "value": "Import | Onboard | No" } ], "devices": [ { "id": "device-id", "connectivity": { "protocol": "uart", "serialPort": "/dev/tty*" }, ***********Remove the section below if the device does not support onboard key generation*************** "secureElementConfig" : { "publicKeyAsciiHexFilePath": "absolute-path-to/public-key-txt-file: contains-the-hex-bytes-public-key-extracted-from-onboard-private-key", "secureElementSerialNumber": "secure-element-serialNo-value", "preProvisioned" : "Yes | No" }, ********************************************************************************************************** "identifiers": [ { "name": "serialNo", "value": "serialNo-value" } ] } ] } ]
Atribut berikut digunakan dalam device.json file:
id-
ID alfanumerik yang ditentukan pengguna yang secara unik mengidentifikasi kumpulan perangkat. Perangkat yang termasuk dalam kolam harus dari jenis yang sama. Saat rangkaian pengujian sedang berjalan, perangkat di kumpulan digunakan untuk memparalelkan beban kerja.
sku-
Nilai alfanumerik yang secara unik mengidentifikasi papan yang Anda uji. SKU digunakan untuk melacak forum yang berkualitas.
catatan
Jika Anda ingin mencantumkan papan Anda di Katalog Perangkat AWS Mitra, SKU yang Anda tentukan di sini harus sesuai dengan SKU yang Anda gunakan dalam proses listing.
features-
Array yang berisi fitur yang didukung perangkat. AWS IoT Device Tester menggunakan informasi ini untuk memilih tes kualifikasi yang akan dijalankan.
Nilai yang didukung adalah:
TCP/IP-
Menunjukkan apakah papan Anda mendukung TCP/IP tumpukan dan apakah itu didukung on-chip (MCU) atau diturunkan ke modul lain. TCP/IP diperlukan untuk kualifikasi.
WIFI-
Menunjukkan apakah papan Anda memiliki Wi-Fi kemampuan. Harus diatur ke
Noif disCellularetel keYes. Cellular-
Menunjukkan apakah papan Anda memiliki kemampuan seluler. Harus diatur ke
Noif disWIFIetel keYes. Ketika fitur ini disetel keYes, FullSecureSockets pengujian akan dijalankan menggunakan instans AWS t2.micro EC2 dan ini dapat menimbulkan biaya tambahan ke akun Anda. Untuk informasi selengkapnya, lihat Harga Amazon EC2. TLS-
Menunjukkan apakah papan Anda mendukung TLS. TLS diperlukan untuk kualifikasi.
PKCS11-
Menunjukkan algoritma kriptografi kunci publik yang didukung papan. PKCS11 diperlukan untuk kualifikasi. Nilai yang didukung adalah
ECC,RSA,BothdanNo.Bothmenunjukkan papan mendukungRSAalgoritmaECCdan. KeyProvisioning-
Menunjukkan metode penulisan sertifikat X.509 klien tepercaya ke papan Anda. Nilai yang valid adalah
Import,OnboarddanNo. Penyediaan kunci diperlukan untuk kualifikasi.-
Gunakan
Importjika papan Anda mengizinkan impor kunci pribadi. IDT akan membuat kunci pribadi dan membangun ini ke kode sumber FreeRTOS. -
Gunakan
Onboardjika papan Anda mendukung pembuatan kunci pribadi terpasang (misalnya, jika perangkat Anda memiliki elemen aman, atau jika Anda lebih suka membuat pasangan kunci dan sertifikat perangkat Anda sendiri). Pastikan Anda menambahkansecureElementConfigelemen di setiap bagian perangkat dan menempatkan jalur absolut ke file kunci publik dipublicKeyAsciiHexFilePathlapangan. -
Gunakan
Nojika papan Anda tidak mendukung penyediaan kunci.
-
OTA-
Menunjukkan apakah papan Anda mendukung fungsionalitas pembaruan over-the-air (OTA). A
OtaDataPlaneProtocoltribut menunjukkan protokol dataplane OTA mana yang didukung perangkat. Atribut diabaikan jika fitur OTA tidak didukung oleh perangkat. Ketika"Both"dipilih, waktu eksekusi tes OTA diperpanjang karena menjalankan tes MQTT, HTTP, dan campuran.catatan
Dimulai dengan IDT v4.1.0, hanya
OtaDataPlaneProtocolmenerimaHTTPdanMQTTsebagai nilai yang didukung. BLE-
Menunjukkan apakah papan Anda mendukung Bluetooth Low Energy (BLE).
devices.id-
Pengenal unik yang ditetapkan pengguna untuk perangkat yang sedang diuji.
devices.connectivity.protocol-
Protokol komunikasi yang digunakan untuk berkomunikasi dengan perangkat ini. Nilai yang didukung:
uart. devices.connectivity.serialPort-
Port serial komputer host yang digunakan untuk terhubung ke perangkat yang sedang diuji.
devices.secureElementConfig.PublicKeyAsciiHexFilePath-
Jalur absolut ke file yang berisi kunci publik hex byte yang diekstrak dari kunci pribadi onboard.
Contoh format:
3059 3013 0607 2a86 48ce 3d02 0106 082a 8648 ce3d 0301 0703 4200 04cd 6569 ceb8 1bb9 1e72 339f e8cf 60ef 0f9f b473 33ac 6f19 1813 6999 3fa0 c293 5fae 08f1 1ad0 41b7 345c e746 1046 228e 5a5f d787 d571 dcb2 4e8d 75b3 2586 e2cc 0cJika kunci publik Anda dalam format.der, Anda dapat mengkodekan kunci publik secara langsung untuk menghasilkan file hex.
Contoh perintah untuk kunci publik.der untuk menghasilkan file hex:
xxd -p pubkey.der > outFileJika kunci publik Anda dalam format.pem, Anda dapat mengekstrak bagian yang dikodekan base64, mendecode ke dalam format biner, dan kemudian mengkodekannya hex untuk menghasilkan file hex.
Misalnya, gunakan perintah ini untuk menghasilkan file hex untuk kunci publik.pem:
-
Keluarkan bagian kunci yang dikodekan base64 (lepaskan header dan footer) dan simpan dalam file, misalnya beri nama
base64key, jalankan perintah ini untuk mengubahnya menjadi format.der:base64 —decode base64key > pubkey.der -
Jalan
xxdkan perintah untuk mengubahnya menjadi format hex.xxd -p pubkey.der > outFile
-
devices.secureElementConfig.SecureElementSerialNumber-
(Opsional) Nomor seri elemen aman. Berikan bidang ini saat nomor seri dicetak bersama dengan kunci publik perangkat saat Anda menjalankan demo/test proyek FreeRTOS.
devices.secureElementConfig.preProvisioned-
(Opsional) Setel ke “Ya” jika perangkat memiliki elemen aman yang telah disediakan sebelumnya dengan kredenSIAL terkunci, yang tidak dapat mengimpor, membuat, atau menghancurkan objek. Konfigurasi ini berlaku hanya jika
featurestelah disetKeyProvisioningel ke “Onboard”, bersama dengan disPKCS11etel ke “ECC”. identifiers-
(Opsional) Array pasangan nama-nilai arbitrer. Anda dapat menggunakan nilai-nilai ini dalam perintah build dan flash yang dijelaskan di bagian berikutnya.