[PATCH i-g-t 0/4] tools/displaytop: Series to add Display Top tool

Adith Narein T adith.narein.t at intel.com
Thu May 29 14:23:39 UTC 2025


This patch series introduces the Display Top tool — a terminal-based
monitoring utility focused on the display pipeline.

Display Top reads real-time display metrics from debugfs, DPCD registers,
and ftrace logs to help developers and testers analyze display behavior,
bottlenecks, and event sequences.

The series adds:
 - A curses-based terminal UI tool
 - A debugfs entry to expose display pipeline stats
 - DPCD register read integration
 - Basic ftrace parsing support
 - Provides the ability to dump data for all of the above features

Adith Narein T (4):
  tools/displaytop: Add Display Top - a terminal-based display pipeline
    monitor
  tools/displaytop: Add Display debugfs entry for display top
  tools/displaytop: Add DPCD register read support
  tools/displaytop: Add ftrace support to Display Top

 tools/displaytop/README.md                    |   81 +
 tools/displaytop/data/dpcd.json               | 4661 +++++++++++++++++
 tools/displaytop/include/data.h               |   53 +
 tools/displaytop/include/display.h            |   54 +
 tools/displaytop/include/log.h                |   45 +
 tools/displaytop/include/node.h               |  126 +
 tools/displaytop/include/populate.h           |   40 +
 tools/displaytop/include/utils.h              |  126 +
 tools/displaytop/meson.build                  |  113 +
 tools/displaytop/src/data.c                   |   42 +
 tools/displaytop/src/display.c                |  480 ++
 tools/displaytop/src/display_DPCD.c           |  277 +
 tools/displaytop/src/display_configuration.c  |  877 ++++
 tools/displaytop/src/display_debugfs.c        |  133 +
 tools/displaytop/src/display_dump.c           |  215 +
 tools/displaytop/src/display_dump_tracing.c   |  135 +
 tools/displaytop/src/display_filter_tracing.c |  318 ++
 tools/displaytop/src/display_ftrace.c         |   97 +
 tools/displaytop/src/display_live_tracing.c   |  124 +
 tools/displaytop/src/display_search_bar.c     |  281 +
 tools/displaytop/src/display_summary.c        |  308 ++
 tools/displaytop/src/log.c                    |   84 +
 tools/displaytop/src/main.c                   |   63 +
 tools/displaytop/src/node.c                   |  140 +
 tools/displaytop/src/populate.c               |   35 +
 tools/displaytop/src/populate_DPCD.c          |  250 +
 .../displaytop/src/populate_display_config.c  |  295 ++
 .../displaytop/src/populate_display_debugfs.c |   99 +
 tools/displaytop/src/populate_ftrace.c        |   78 +
 tools/displaytop/src/utils.c                  |  168 +
 tools/displaytop/src/utils_cli.c              |   70 +
 tools/displaytop/src/utils_display.c          |  195 +
 tools/displaytop/src/utils_driver.c           |  243 +
 tools/displaytop/src/utils_drm.c              |  585 +++
 tools/displaytop/src/utils_registers.c        |   97 +
 tools/displaytop/src/utils_search.c           |   49 +
 tools/displaytop/src/utils_trace.c            |   67 +
 tools/meson.build                             |    1 +
 38 files changed, 11105 insertions(+)
 create mode 100644 tools/displaytop/README.md
 create mode 100644 tools/displaytop/data/dpcd.json
 create mode 100644 tools/displaytop/include/data.h
 create mode 100644 tools/displaytop/include/display.h
 create mode 100644 tools/displaytop/include/log.h
 create mode 100644 tools/displaytop/include/node.h
 create mode 100644 tools/displaytop/include/populate.h
 create mode 100644 tools/displaytop/include/utils.h
 create mode 100644 tools/displaytop/meson.build
 create mode 100644 tools/displaytop/src/data.c
 create mode 100644 tools/displaytop/src/display.c
 create mode 100644 tools/displaytop/src/display_DPCD.c
 create mode 100644 tools/displaytop/src/display_configuration.c
 create mode 100644 tools/displaytop/src/display_debugfs.c
 create mode 100644 tools/displaytop/src/display_dump.c
 create mode 100644 tools/displaytop/src/display_dump_tracing.c
 create mode 100644 tools/displaytop/src/display_filter_tracing.c
 create mode 100644 tools/displaytop/src/display_ftrace.c
 create mode 100644 tools/displaytop/src/display_live_tracing.c
 create mode 100644 tools/displaytop/src/display_search_bar.c
 create mode 100644 tools/displaytop/src/display_summary.c
 create mode 100644 tools/displaytop/src/log.c
 create mode 100644 tools/displaytop/src/main.c
 create mode 100644 tools/displaytop/src/node.c
 create mode 100644 tools/displaytop/src/populate.c
 create mode 100644 tools/displaytop/src/populate_DPCD.c
 create mode 100644 tools/displaytop/src/populate_display_config.c
 create mode 100644 tools/displaytop/src/populate_display_debugfs.c
 create mode 100644 tools/displaytop/src/populate_ftrace.c
 create mode 100644 tools/displaytop/src/utils.c
 create mode 100644 tools/displaytop/src/utils_cli.c
 create mode 100644 tools/displaytop/src/utils_display.c
 create mode 100644 tools/displaytop/src/utils_driver.c
 create mode 100644 tools/displaytop/src/utils_drm.c
 create mode 100644 tools/displaytop/src/utils_registers.c
 create mode 100644 tools/displaytop/src/utils_search.c
 create mode 100644 tools/displaytop/src/utils_trace.c

-- 
2.43.0



More information about the igt-dev mailing list