Driver Compiler Debug Methods
August 21, 2025 ยท View on GitHub
Logs
To change the compiler behavior, a configuration file can be used with the compilerTest tool. For example, to change the logging level, use -log_level LOG_TRACE in the command line or by using a configuration file. The content for the configuration file is as follows:
LOG_LEVEL LOG_TRACE
Other Tools
One can also use the tools from NPU-Plugin Project and OpenVINO Project.
compile_tool
compile_tool can compile a network into a blob. If you test it for Driver Compiler, you need to set the configuration option in the configuration file.
The general command on Git Bash is:
./compile_tool -m <model_path> -d NPU.4000 -c <config_file_path>
Example:
./compile_tool -m path/to/googlenet-v1.xml -d NPU.4000 -c /path/to/config.txt
where the content of config.txt is:
NPU_COMPILER_TYPE DRIVER
benchmark_app
benchmark_app is used to estimate inference performance. If you test it for Driver Compiler, you need to set the configuration option in the configuration file.
The general command in Git Bash is:
./benchmark_app -m <model_path> -load_config=<config_file_path> -d NPU.4000
Example:
./benchmark_app -m /path/to/mobilenet-v2.xml -load_config=/path/to/config.txt -d NPU.4000
where the content of config.txt is:
{
"NPU" : {
"NPU_COMPILER_TYPE" : "DRIVER", "NPU_PLATFORM" : "4000", "LOG_LEVEL" : "LOG_INFO"
}
}
timetest suite
timetest suite is used to measure both total and partial execution time. You can install the timetest suite by following the time_tests/README.md. If you test it for Driver Compiler, you need to set the configuration option in the configuration file.
The general command in Git Bash:
python3 ./scripts/run_timetest.py ../../bin/intel64/Release/timetest_infer_api_2.exe -m <model_path> -d NPU.4000 -f <config_file_path>
Example:
python3 scripts\run_timetest.py build\src\timetests\Release\timetest_infer.exe -m googlenet-v1.xml -d NPU.4000 -f config.txt
where the content of config.txt is:
NPU_COMPILER_TYPE DRIVER
Note: For more debug methods and details, refer to how to debug in the vpux_compiler section.