Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
torvalds
GitHub Repository: torvalds/linux
 Path: blob/master/Documentation/devicetree/bindings/arm/arm,embedded-trace-extension.yaml
26308 views
1
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause

2
# Copyright 2021, Arm Ltd

3
%YAML 1.2

4
---

5
$id: http://devicetree.org/schemas/arm/arm,embedded-trace-extension.yaml#

6
$schema: http://devicetree.org/meta-schemas/core.yaml#

7


8
title: ARM Embedded Trace Extensions

9


10
maintainers:

11
  - Suzuki K Poulose <suzuki.poulose@arm.com>

12
  - Mathieu Poirier <mathieu.poirier@linaro.org>

13


14
description: |

15
  Arm Embedded Trace Extension(ETE) is a per CPU trace component that

16
  allows tracing the CPU execution. It overlaps with the CoreSight ETMv4

17
  architecture and has extended support for future architecture changes.

18
  The trace generated by the ETE could be stored via legacy CoreSight

19
  components (e.g, TMC-ETR) or other means (e.g, using a per CPU buffer

20
  Arm Trace Buffer Extension (TRBE)). Since the ETE can be connected to

21
  legacy CoreSight components, a node must be listed per instance, along

22
  with any optional connection graph as per the coresight bindings.

23


24
properties:

25
  $nodename:

26
    pattern: "^ete(-[0-9]+)?$"

27
  compatible:

28
    items:

29
      - const: arm,embedded-trace-extension

30


31
  cpu:

32
    description: |

33
      Handle to the cpu this ETE is bound to.

34
    $ref: /schemas/types.yaml#/definitions/phandle

35


36
  power-domains:

37
    maxItems: 1

38


39
  out-ports:

40
    description: |

41
      Output connections from the ETE to legacy CoreSight trace bus.

42
    $ref: /schemas/graph.yaml#/properties/ports

43
    properties:

44
      port:

45
        description: Output connection from the ETE to legacy CoreSight Trace bus.

46
        $ref: /schemas/graph.yaml#/properties/port

47


48
required:

49
  - compatible

50
  - cpu

51


52
additionalProperties: false

53


54
examples:

55


56
# An ETE node without legacy CoreSight connections

57
  - |

58
    ete-0 {

59
      compatible = "arm,embedded-trace-extension";

60
      cpu = <&cpu_0>;

61
    };

62
# An ETE node with legacy CoreSight connections

63
  - |

64
   ete-1 {

65
      compatible = "arm,embedded-trace-extension";

66
      cpu = <&cpu_1>;

67


68
      out-ports {        /* legacy coresight connection */

69
         port {

70
             ete1_out_port: endpoint {

71
                remote-endpoint = <&funnel_in_port0>;

72
             };

73
         };

74
      };

75
   };

76


77
...

78


79