Table of Contents |
---|
This document describes first phase of WindowsPerf GUI design and implementation.
...
maximum number of events user can specify with
wperf stats
's-e <events>
command line switch.This can be mitigated to hard limit in GUI for now. In the future
wperf test
command will emit this value for GUI.
Extra description of the event.
Example of wperf commands that GUI should be able to “execute” with Phase 1
Code Block |
---|
>wperf stat -e inst_spec,vfp_spec,ase_spec,dp_spec sleep 1
>wperf stat -e inst_spec,vfp_spec,ase_spec,dp_spec,ld_spec,st_spec -c 0 sleep 2
>wperf stat -e inst_spec,vfp_spec,ase_spec,dp_spec,ld_spec,st_spec -c 0,1,3 sleep 3
>wperf stat -e {inst_spec,vfp_spec,ase_spec,dp_spec,ld_spec,st_spec},{br_immed_spec,crypto_spec} sleep 1
>wperf stat -e {inst_spec,vfp_spec,ase_spec,dp_spec,ld_spec,st_spec},{br_immed_spec,crypto_spec} -c 0 sleep 1
>wperf stat -e {inst_spec,vfp_spec,ase_spec,dp_spec,ld_spec,st_spec},{br_immed_spec,crypto_spec} -c 0,1,2 sleep 1
>wperf stat -m imix sleep 1
>wperf stat -m imix -c 0 sleep 1
>wperf stat -m imix -e l1i_cache -c 0 sleep 1
>wperf stat -m l3_cache -e l1i_cache -c 0,1,2 sleep 1
>wperf stat -m ddr_bw -e l1i_cache -c 0 sleep 1 |
Notes
wperf-relay is later called “relay”.
wperf-gui is later called “GUI”.
...
User Story | Description / TODO |
---|---|
n/a | |
Building widget to select host (IP/URL/port) to connect to. | |
Listing all available events and metrics ( | |
Listing of wperf version number (
| |
Listing additional data about host ( | |
Building widget to save/load host information. | |
Building widget to connect to host. This may include indicator if we are connected to host For example small “traffic lights” icon indicating if we are connected, connecting or disconnected). | |
n/a | |
Separate text window with scroll option to see consecutive outputs from wperf console. | |
Building widget to prepare list of events and event groups for
| |
Building widget to prepare list of metrics
| |
| |
| |
Widget which will show error messages from relay. This may include messages after each response from relay to GUI. It may be a widget, modal window etc. |
...
Building initial GUI (wperf-gui).
Building widget to select host (IP/URL/port) to connect to.
Building widget to save/load host information.
Building widget to prepare list of events and event groups for
wperf stat
command line option-e <events>
Build list of CORE events and event groups.
[Nice-to-have]Widget would also prepare list of DSU and DMC events.
Make sure events and groups are sent to relay (as protocol payload) in the same order as defined by user. Please note that group numbers are assigned by
wperf
from left to right. For example:-e {inst_spec,vfp_spec},ase_spec,{dp_spec,ld_spec,st_spec},br_immed_spec,crypto_spec
group 0 (
g0
) is{inst_spec,vfp_spec}
group 1 (
g1
) is{dp_spec,ld_spec,st_spec}
Building widget to prepare list of metrics
wperf stat
command line option-m <metrics>
Listing all available events and metrics (
wperf list
) - for example separate tab.Listing additional data about host (
wperf test
) - for example separate tab.Listing of wperf version number (
wperf -version -json
).For example in modal window “about” and
in bottom status bar.
Support visualization (table) of output of
wperf stat -e <events> -m <metrics> -c <cpu_list> sleep <N>
.
Support counting model (wperf pov) JSON output for (below all done):
wperf stat -e <events>
wperf stat -m <metrics>
wperf stat -e <events> -m <metrics>
Command line option
-c <cpu_list>
Command line option
sleep <N>
Establishing common protocol between relay and GUI.
Event and metrics list fetch. Output from
wperf list -json
.Host system and wperf application configuration. Output from
wperf test -json
.Counting with
wperf stat ... -json
.Basic “real time” wperf stdout logging in GUI.
We would like to see
wperf
screen output in GUI during counting execution.
Basic error handling by relay and GUI.
Relay-GUI protocol must be able to send error information to GUI.
Relay-GUI protocol must provide “busy” state to GUI from relay.
GUI should report errors but is not responsible to error recovery of the relay and wperf.
Note: relay will execute and have control over wperf process and will be responsible for executing, stopping and error handling wperf.
...