Documentation/trace/coresight/coresight-tpda.rst

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