QCNPUPERF_CLI(1)

NAME
qcnpuperf_cli - display live Qualcomm NPU performance metrics

SYNOPSIS
qcnpuperf_cli

DESCRIPTION
qcnpuperf_cli is a small ncurses sample application built on top of the libqcnpuperf library. It opens a full-screen terminal view that refreshes once per second and shows performance metrics collected from the Qualcomm NPU (the NPU0 / CDSP domain), including:

    •   Q6 utilization (percentage)

    •   Q6 clock frequency (KHz)

    •   HVX utilization (percentage)

    •   HMX utilization (percentage)

The program takes no command-line options and runs continuously until it is interrupted.

OPTIONS
This version accepts no command-line options.

USAGE
Press Ctrl-C to stop the program and return to the shell.

FILES

/dev/fastrpc*
    FastRPC device nodes used for CPU → DSP communication. These must be present for metric collection to work.

EXIT STATUS
Returns a non-zero status if the DSP cannot be initialised or if metric collection fails.

SEE ALSO
The libqcnpuperf library and API documentation at https://github.com/qualcomm/libqcnpuperf.

BUGS
Report bugs at https://github.com/qualcomm/libqcnpuperf/issues.

COPYRIGHT
Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries. Licensed under the BSD-3-Clause license.