IOCTL_HAL_GET_DEVICE_INFO Test (Compact 7)
3/12/2014
The IOCTL_HAL_GET_DEVICE_INFO Test verifies the correct implementation of IOCTL_HAL_GET_DEVICE_INFO.
Test Prerequisites
Your device must meet the following requirements before you run this test.
As with the other OAL IOCTL tests, the IOCTL_HAL_GET_DEVICE_INFO Test requires no additional hardware.
- The test should be run on a minimal OS design, such as the "BTS Minimum OAL" image.
- The run-time image must implement IOCTL_HAL_GET_DEVICE_INFO.
The following table shows the software requirements for the test:
| Requirements | Description |
|---|---|
Tux.exe |
Tux test harness, required for executing the test |
kato.dll |
Kato logging engine, required for logging test data |
oaltestioctls.dll |
Library containing OAL IOCTL Test files |
Subtests
The table below lists the subtests included in this test.
| SubTest ID | Description |
|---|---|
5000 |
Prints out the usage message for the IOCTL_HAL_GET_DEVICE_INFO tests. |
5001 |
Prints out the output of IOCTL_HAL_GET_DEVICE_INFO::SPI_GETPLATFORMNAME. Verify the platform name output manually. |
5002 |
Prints out the output of IOCTL_HAL_GET_DEVICE_INFO::SPI_GETPROJECTNAME. Verify the project name output manually. |
5003 |
Prints out the output of IOCTL_HAL_GET_DEVICE_INFO::SPI_GETBOOTMENAME. Verify the bootme name output manually. |
5004 |
Prints out the output of IOCTL_HAL_GET_DEVICE_INFO::SPI_GETOEMINFO. Verify the OEM info output manually. |
5006 |
Prints out the output of IOCTL_HAL_GET_DEVICE_INFO::SPI_GETUUID. Verify the UUID output manually. |
5007 |
Prints out the output of IOCTL_HAL_GET_DEVICE_INFO::SPI_GETGUIDPATTERN. Verify the GUID pattern output manually. |
5008 |
Prints out the output of IOCTL_HAL_GET_DEVICE_INFO::SPI_GETPLATFORMMANUFACTURER. Verify platform manufacturer output manually. |
5020 |
Checks IOCTL_HAL_GET_DEVICE_INFO using expected and unexpected inbound parameters. |
5021 |
Checks IOCTL_HAL_GET_DEVICE_INFO using expected and unexpected outbound parameters. |
5022 |
Checks IOCTL_HAL_GET_DEVICE_INFO using different alignments of the input buffer, and also input buffer overflow. |
5023 |
Checks IOCTL_HAL_GET_DEVICE_INFO using different alignments of the output buffer, and also output buffer overflow. |
Setting Up the Test
This test has no additional requirements, beyond the standard test environment setup.
Running the Test
The default command line for this test is:
tux.exe -o -d oalTestIoctls.dll -x 5000-5023
Verifying the Test
- When the test completes running, verify that "PASS" appears in the test log for all sub-tests.
- For test cases that print device-specific output values (5001, 5002, 5003, 5004, 5006, 5007, 5008), the user must manually verify the test output.
Troubleshooting the Test
- Verify the implementation of the IOCTL_HAL_GET_DEVICE_INFO IOCTL and the various SPI sub-codes.
- Determine the point of failure and record the exact error message. If the source code is available, examine the point of failure in code to see if any additional information can be gathered about the failure domain.
For additional platform specific issues, consult the CTK articles on the TechNet wiki.