Bagikan melalui

Langkah 4: Sistem Onboard Mobile/IoT Test

Catatan

Dimulai dengan versi HLK yang di-refresh (dirilis pada Oktober 2024) untuk Windows 11 24H2 dan Windows Server 2025, Klien Proksi HLK tidak lagi didukung. Ke depannya, silakan onboard klien menggunakan proses yang dirinci dalam "Panduan Memulai HLK" sebagai gantinya.

Setelah Anda menginstal Windows Hardware Lab Kit (Windows HLK) pada sistem Pengontrol, dan Klien Proksi Windows HLK pada sistem Proksi, Anda siap untuk menambahkan sistem pengujian seluler/IoT ke lingkungan.

Masalah yang Diketahui

Masalah Solusi Sementara
Nama perangkat dilaporkan dalam HLK sebagai Windows Phone alih-alih nama perangkat yang sebenarnya. Boot ulang perangkat.

Onboarding perangkat yang terhubung dengan USB

  1. Pada sistem Proksi, luncurkan jendela prompt perintah yang ditingkatkan.

  2. Navigasi ke %ProgramFiles(x86)%\WTTMobile\Tools\

  3. Dapatkan DeviceGUID untuk perangkat yang terhubung:

    1. Letakkan perangkat dalam mode berkedip.

    2. Dari prompt perintah yang ditingkatkan, jalankan perintah berikut:

      ffutool.exe -list

      Catatan

      FFUTool.exe disertakan dalam HLK di \\<ControllerName>\HLKInstall\ProxyClient\FfuTool.

      Salin seluruh isi direktori ini ke server proksi Anda.

      Untuk informasi selengkapnya tentang alat dan utilitas pengujian seluler HLK, lihat Alat dan Utilitas Pengujian Seluler HLK

      FFUTool.exe juga dapat diinstal dengan ADK, dengan memilih opsi Pencitraan dan Perancang Konfigurasi selama penginstalan kit. Untuk informasi selengkapnya tentang ADK, lihat Mengunduh Windows ADK

  4. Jalankan perintah berikut dari prompt perintah yang ditingkatkan untuk menempatkan perangkat ke dalam mode penyimpanan massal:

    ffutool -MassStorage

  5. Cabut perangkat dari sistem proksi, lalu colokkan kembali. Kemudian akan diberi huruf kandar pada sistem Proksi.  Gunakan ini sebagai <drive> perangkat di langkah berikutnya.

  6. Aktifkan protokol USB EEM pada opsi boot. Dari prompt perintah yang ditingkatkan, jalankan perintah berikut: 

    BCDEdit /store <device drive>:\EFIESP\efi\Microsoft\Boot\BCD /set {default} loadoptions "EEM"

    Contoh:

    BCDEdit /store G:\EFIESP\efi\Microsoft\Boot\BCD /set {default} loadoptions "EEM"

  7. Hidupkan ulang perangkat (jika gambar yang diinstal pada DUT adalah lab atau gambar kesehatan, letakkan perangkat dalam mode berkedip).

  8. Untuk onboarding perangkat, dari prompt perintah yang ditingkatkan, jalankan perintah berikut:

    KitsDeviceDetector.exe /Physical:Fake_PC.dll /DeviceName:<DeviceName> /DeviceId:<DeviceGUID> /machinepool:<machine pool>

    Contoh:

    KitsDeviceDetector.exe /Physical:Fake_PC.dll /DeviceName:mydevice /DeviceId:00000015-c0fb-79c3-0000-000000000000 /machinepool:$\mypool

    - Jika pengujian dengan gambar Kesehatan, sertakan parameter berikut: /imageprofile:health

    • Jika gambar yang diinstal pada DUT bukan lab atau gambar kesehatan, sertakan parameter berikut: /SkipFFUCheck

    • Log KitsDeviceDetector dapat ditemukan di %ProgramFiles(x86)%\WTTMobile\Tools\KitsDeviceDetector.log

  9. Mulai ulang layanan proksi dalam mode yang ditingkatkan.

    1. Di jendela prompt perintah Layanan Proksi, tekan CTRL + C untuk menghentikan layanan.

    2. Mulai ulang Layanan Proksi dengan mengklik ganda pintasan "Proksi WTT" di desktop Sistem Proksi, atau dengan menavigasi ke %ProgramFiles(X86)%\WTTMobile\Client\ dan jalankan perintah berikut dari prompt perintah yang ditingkatkan:

      WTTProxy.exe -console

  10. Validasi: Setelah menjalankan detektor perangkat (langkah-langkah di atas), perangkat harus di-boot ke OS yang valid, dan menjadi target terlihat yang ditampilkan sebagai Siap di Manajer HLK dan HLK Studio.

Onboarding perangkat yang terhubung dengan Aries

  1. Pada sistem Proksi, luncurkan prompt perintah yang ditingkatkan.

  2. Navigasi ke %ProgramFiles(x86)%\WTTMobile\Tools\

  3. Untuk melakukan onboarding perangkat, jalankan perintah berikut dari prompt perintah yang ditingkatkan:

    KitsDeviceDetector.exe /devicefilters:<aries name> /machinepool:<machine pool>

    Contoh:

    KitsDeviceDetector.exe /devicefilters:myaries  /machinepool:$\mypool

    • Gambar pada perangkat harus berupa gambar lab atau gambar kesehatan.

    - Jika pengujian dengan gambar Kesehatan, sertakan parameter berikut: /imageprofile:health

    - Untuk mem-flash gambar di perangkat Anda sebagai bagian dari proses onboarding, sertakan parameter berikut /ImagePath:<full path to the flash_lab.ffu image>

    Contoh:

    /ImagePath:C:\flash_lab.ffu

    • Untuk menemukan nama dongle Aries di jaringan, gunakan %ProgramFiles(x86)%\WTTMobile\Tools\AriesUtil.exe . Perintah AriesUtil.exe Discover akan mengembalikan daftar lengkap perangkat yang tersedia. Pengecualian firewall harus ditambahkan untuk AriesUtil.exe sebelum digunakan. Jika tidak ada perangkat yang terdeteksi, Anda mungkin perlu menggunakan parameter /Adapter . Jenis adaptor dapat ditentukan dengan membuka Jaringan dan Pusat Berbagi pada pengontrol, Adapter tercantum di bawah Koneksi. Nilai Adapter yang paling umum adalah Ethernet. Gunakan perintah AriesUtil.exe /? untuk daftar lengkap perintah yang tersedia.

    • Log KitsDeviceDetector dapat ditemukan di %ProgramFiles(x86)> %\WTTMobile\Tools\KitsDeviceDetector.log

    Untuk informasi selengkapnya tentang alat dan utilitas pengujian seluler HLK, lihat Alat dan Utilitas Pengujian Seluler HLK

  4. Mulai ulang layanan proksi dalam mode yang ditingkatkan.

    1. Di jendela prompt perintah Layanan Proksi, tekan CTRL + C untuk menghentikan layanan.

    2. Mulai ulang Layanan Proksi dengan mengklik ganda pintasan "Proksi WTT" di desktop Sistem Proksi, atau dengan menavigasi ke %ProgramFiles(X86)%\WTTMobile\Client\ dan jalankan perintah berikut dari prompt perintah yang ditingkatkan:

      WTTProxy.exe -console

  5. [Hanya untuk gambar Kesehatan] - Setelah KitDeviceDetector selesai, jalankan perintah berikut dari %ProgramFiles(x86)%\WTTMobile\Tools\

    AriesUtil.exe ResetDevice /Aries:<aries-name> [/Autoskip:true]

  6. Validasi: Setelah menjalankan detektor perangkat (langkah-langkah di atas), perangkat harus di-boot ke OS yang valid, dan menjadi target terlihat yang ditampilkan sebagai Siap di Manajer HLK dan HLK Studio.

Onboarding perangkat yang terhubung dengan Ethernet

  1. Pada sistem Proksi, luncurkan prompt perintah yang ditingkatkan.

  2. Navigasi ke %ProgramFiles(x86)%\WTTMobile\Tools\

  3. Dapatkan string koneksi untuk perangkat Anda:

    1. Boot perangkat dan temukan alamat IP.

    2. Dari prompt perintah yang ditingkatkan, jalankan perintah berikut:

      KitsDeviceDetector.exe /rundevicediscovery

      Perintah ini akan menghasilkan semua perangkat pada subnet yang menjalankan Sirep. Setiap string akan terlihat seperti ini:

      Nama: 8CAE4CF5D6A5 | UniqueId: 00000000-0000-0000-0000-8cae4cf5d6a5 | Alamat: 10.131.2.211 | Koneksi: SirepBroadcast1 | Tempat:

  4. Temukan string perangkat Anda (cocok dengan alamat IP Anda, dan catat bidang berikut:

    1. "Nama:"
    2. "UniqueId:"

  5. Untuk onboarding perangkat, jalankan perintah dari prompt perintah yang ditingkatkan:

    KitsDeviceDetector.exe /machinepool:$\Pool /Physical:Fake_PC.dll /DeviceName:NAME_OF_DEVICE /DeviceId:<DeviceGUID> /SkipFFUCheck

    Contoh:

    KitsDeviceDetector.exe /machinepool:$\Test_Pool /Physical:Fake_PC.dll /DeviceName:8CAE4CF5D6A5 /DeviceId:00000000-0000-0000-0000-8CAE4CF5D6A5 /SkipFFUCheck

  6. Mulai ulang layanan proksi dalam mode yang ditingkatkan.

    1. Di jendela prompt perintah Layanan Proksi, tekan CTRL + C untuk menghentikan layanan.

    2. Mulai ulang Layanan Proksi dengan mengklik ganda pintasan "Proksi WTT" di desktop Sistem Proksi, atau dengan menavigasi ke %ProgramFiles(X86)%\WTTMobile\Client\ dan jalankan perintah berikut dari prompt perintah yang ditingkatkan:

      WTTProxy.exe -console

  7. Validasi: Setelah menjalankan detektor perangkat (langkah-langkah di atas), perangkat harus di-boot ke OS yang valid, dan menjadi target terlihat yang ditampilkan sebagai Siap di Manajer HLK dan HLK Studio.