NPU Management Interface#
NOTE: This feature is currently in the early access stage.
The xbutil
utility is a command-line interface to monitor and manage the NPU. It is installed in C:\Windows\System32\AMD
and it can be directly invoked from within the conda environment created by tge Ryzen AI Software installer.
The xbutil
utility currently supports three primary commands:
examine: Examines the state of the AI PC and the NPU.
validate: Executes sanity tests on the NPU.
configure: Manages the performance level of the NPU.
You can use --help
with any command, such as xbutil examine --help
, to view all supported subcommands and their details.
Examining the AI PC and the NPU#
To provide OS/system information of the AI PC and informs about the presence of the NPU:
xbutil examine
To provide more detailed information about the NPU, such as its architecture and performance mode:
xbutil examine -d --report platform
To provide information about the NPU Binary loaded during model inference:
xbutil examine -d --report dynamic-regions
To provide information about the column occupancy on the NPU, allowing you to determine if more models can run in parallel:
xbutil examine -d --report aie-partitions
Executing a Sanity Check on the NPU#
To run a built-in test on the NPU to ensure it is in a deployable state:
xbutil validate -d --run verify
Managing the Performance Level of the NPU#
To set the performance level of the NPU. You can choose powersaver mode, balanced mode, performance mode, or use the default:
xbutil configure -d --performance <powersaver | balanced | performance | default>