HLK ARM64 Getting Started Guide
Setup and testing for ARM64 desktop machines largely follows the guidelines found in the HLK Getting Started Guide. Instructions specific to ARM64 are described in this topic.
This topic provides a basic introduction to using the Windows Hardware Lab Kit (HLK). Once you are familiar with the tools and process, you can review the HLK User's Guide for additional information.
Windows HLK Prerequisites
Prerequisites are the same for all desktop machines. See the HLK Prerequisites topic for more information.
Step 1: Install Controller and Studio on the test server
Test server setup is the same for all desktop testing. See Step 1: Install Controller and Studio on the test server for more information.
Step 2: Install Client on the test system(s)
After you install the HLK on the test server, you are ready to add test systems to the environment. You must install the HLK Client software on each test system. The HLK Client software is stored on the Windows HLK test server.
Testing for ARM64 Desktop requires the client systems to be set up differently than testing for x86/x64. ARM64 Desktop testing uses a different setup path. Also, a complete submission package requires testing to be done in two modes -- native ARM64 and x86 on ARM64. Testing can be done with multiple machines or a single machine, but using a single machine requires the HLK client to be uninstalled and reinstalled using the directions below to change the modes.
Depending on the scenario, it may be required that testing be done in native ARM64 mode, x86 on ARM64, or a combination of the two. The scenarios below will outline which mode(s) are required for testing.
Testing can be done with multiple machines or a single machine, but using a single machine requires the HLK client to be uninstalled and reinstalled using the directions below to change the modes.
|Wireless Lan||Native and x86 on ARM64 mode|
|System||Native and x86 on ARM64 mode|
The mode required may change with new releases of the kit.
Once the mode for testing is identified the following instructions will walk you through client setup.
If you are testing software, be sure to install the product on the test system first, and then install the HLK Client software.
It is recommended that the client system is on A/C (plugged in) and that the Power Options are set to Never for Put the computer to sleep settings.
To install the Windows HLK Client
Run client setup
For x86/x64 client systems, on the test system, run the following:
For ARM64 Desktop client systems, there are two different install paths depending on the mode the client is being set up to test in.
Because of the dual-mode nature of ARM64, a best practice is to use two (2) clients, one in native mode and one in emulated mode per the instructions below.
On the test system, run the following:
x86 on ARM64 Mode:
On the test system, start a command prompt with administrator privileges, and run the following:
(Replace <ControllerName> with the name of the test server.)
The Windows Hardware Lab Kit Client Setup wizard appears. To start the wizard, choose Next.
On the Internet Connection Firewall Agreement page, select Yes I will allow a port to be opened, and then choose Next.
If the Internet Connection Firewall Agreement page doesn't appear, either Windows Firewall isn't installed, or another software firewall or hardware firewall is installed on the computer. If another firewall is installed, you must manually open TCP port 1771 to proceed with installation. Refer to the instructions that came with your firewall product to manually open a TCP port. If you continue without opening port 1771, the installation may fail or the Client software might not function properly.
When the Ready to Install page appears, select Install.
Click Finish to exit the wizard.
When installation completes, confirm its success by going to the Control Panel and choosing Uninstall a program. Windows Hardware Lab Kit Client should appear in the program list.
Repeat steps 1-5 for each test system.
Step 3: Create a machine pool
Machine pool creation is the same for all desktop testing. See Step 3: Create a machine pool for more information.
Step 4: Create a project
x86/x64 instructions: Step 4: Create a project
After you setup your test server and clients, you're ready to create a project. A project defines what you want to test. The most common project corresponds to the device you want to submit for certification.
You can create large projects that represent a wide range of scenarios. You can also create several smaller projects and merge the results into one package.
For ARM64 Desktop testing, multiple projects are required to form a complete submission package (one for each mode). When testing is complete for each mode, create hlkx packages and then merge the packages together to make a single package for submission.
In the remaining examples, you create a project for a device and run all associated certification tests. Then, you create a single package for submission that contains all of the passing test results.
The following image shows the Studio Project tab.
Creating a project
In Windows HLK Studio, choose the Project tab, and then choose Create project.
Replace the default project name with the name of your project, and then press Enter.
A project should have a meaningful name that indicates its contents, for example, Fabrikam Multi-function Device Model Z.
When the project name appears on the page, the project is created.
The right pane displays project details. More information is displayed here once you start testing your device. You can check the status of any project by loading it and referring to this pane.
Step 5: Select target to test
Selecting targets is the same for all desktop testing. See Step 5: Select target to test for more information.
Step 6: Select and run tests
The Tests tab displays all of the tests that are associated with the features found on your device. In the HLK, test categories replace the level classifications previously used with the HCK. The HLK can be used throughout the product life cycle to test and measure quality at each stage of development. You can filter and sort the listed tests in the following ways:
- Test Phase Categorization
- Bring Up
- Development and Integration
- Tuning and Validation
- Test Name
- Type (manual, non-distributed, special configuration, multiple machine)
- You can hover over the test type icons with your mouse for more information about the test types. - Manual tests that require user input can interrupt the test process. We recommend that you run manual tests separately from automated tests. - Some tests require additional input before running. Windows HLK Studio prompts you for more info as needed.
The following image shows the Studio Tests tab.
Playlists are collections of tests that you can use to define various scenarios in which to test your device. The Windows Hardware Compatibility Program uses an official playlist to determine which devices meet the requirements for compatibility with Windows 10.
You can load a playlist by choosing Load Playlist from within the Tests tab. You can load only one playlist at a time. To choose a different playlist, you must first unload the current playlist by choosing Unload Playlist from the Tests tab.
The following image shows the Load Playlist File dialog.
Once a playlist is loaded, only tests that are applicable to each target are shown in the UI.
Test results against all playlists for a specific target are kept until the target is removed from the project. When a playlist is loaded, any previous test results against that playlist are also loaded.
You can save an existing collection of tests as a playlist by choosing Save Selected as Playlist.
When using an official playlist, you must use the version of the playlist that matches the version of the kit you are using. For example, if using version 1607 of the HLK, you must also use version 1607 of the playlist.
ARM64 Desktop testing: There are two playlists, one for tests that run in Native mode and one for tests that run in x86 on ARM64 mode. Ensure that the appropriate playlist is being applied to the project that has the HLK client installation which matches the mode intended for testing.
Running a test
If using a playlist, be sure to load it before proceeding.
- Filter the test results by using the View By dropdown list.
- Check the box next to each test that you want to run.
- Run the selected tests by choosing Run Selected.
If any additional input is needed, Windows HLK Studio will prompt you.
A progress bar appears. A slight delay occurs when you run a test.
To learn more about any test, select the test from the list, and press F1 key, or right-click, and select Test Description. To cancel any running test, right-click it and select Cancel.
As tests complete, the results are displayed in the Status column. A green checkmark means that it passed, while a red X means that it failed. The pane on the right displays project summary information, including target(s) selected, operating systems being tested, product types you qualify for, and status of all tests.
To learn more about the different options on this page, see HLK Studio - Tests Tab.
Step 7: View test results and log files
x86/x64 instructions: Step 7: View test results and log files
Due to ARM64 Desktop having scenarios that involve multiple projects, it will be required that these projects be merged to have a complete HLK package for submission. For information on merging packages, see Merge packages.
Step 8: Create a submission package
Once any merging is complete, submitting packages is the same for all desktop machines. See Step 8: Create a submission package topic for more information.