coresight-tpda.rst 2.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  1. .. SPDX-License-Identifier: GPL-2.0
  2. =================================================================
  3. The trace performance monitoring and diagnostics aggregator(TPDA)
  4. =================================================================
  5. :Author: Jinlong Mao <quic_jinlmao@quicinc.com>
  6. :Date: January 2023
  7. Hardware Description
  8. --------------------
  9. TPDA - The trace performance monitoring and diagnostics aggregator or
  10. TPDA in short serves as an arbitration and packetization engine for the
  11. performance monitoring and diagnostics network specification.
  12. The primary use case of the TPDA is to provide packetization, funneling
  13. and timestamping of Monitor data.
  14. Sysfs files and directories
  15. ---------------------------
  16. Root: ``/sys/bus/coresight/devices/tpda<N>``
  17. Config details
  18. ---------------------------
  19. The tpdm and tpda nodes should be observed at the coresight path
  20. "/sys/bus/coresight/devices".
  21. e.g.
  22. /sys/bus/coresight/devices # ls -l | grep tpd
  23. tpda0 -> ../../../devices/platform/soc@0/6004000.tpda/tpda0
  24. tpdm0 -> ../../../devices/platform/soc@0/6c08000.mm.tpdm/tpdm0
  25. We can use the commands are similar to the below to validate TPDMs.
  26. Enable coresight sink first. The port of tpda which is connected to
  27. the tpdm will be enabled after commands below.
  28. echo 1 > /sys/bus/coresight/devices/tmc_etf0/enable_sink
  29. echo 1 > /sys/bus/coresight/devices/tpdm0/enable_source
  30. echo 1 > /sys/bus/coresight/devices/tpdm0/integration_test
  31. echo 2 > /sys/bus/coresight/devices/tpdm0/integration_test
  32. The test data will be collected in the coresight sink which is enabled.
  33. If rwp register of the sink is keeping updating when do
  34. integration_test (by cat tmc_etf0/mgmt/rwp), it means there is data
  35. generated from TPDM to sink.
  36. There must be a tpda between tpdm and the sink. When there are some
  37. other trace event hw components in the same HW block with tpdm, tpdm
  38. and these hw components will connect to the coresight funnel. When
  39. there is only tpdm trace hw in the HW block, tpdm will connect to
  40. tpda directly.