€•è„      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ4/translations/zh_CN/trace/coresight/coresight-config”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ4/translations/zh_TW/trace/coresight/coresight-config”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ4/translations/it_IT/trace/coresight/coresight-config”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ4/translations/ja_JP/trace/coresight/coresight-config”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ4/translations/ko_KR/trace/coresight/coresight-config”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ4/translations/sp_SP/trace/coresight/coresight-config”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒN/var/lib/git/docbuild/linux/Documentation/trace/coresight/coresight-config.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ&CoreSight System Configuration Manager”h]”hŒ&CoreSight System Configuration Manager”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒblock_quote”“”)”}”(hŒF:Author:   Mike Leach <mike.leach@linaro.org>
:Date:     October 2020
”h]”hŒ
field_list”“”)”}”(hhh]”(hŒfield”“”)”}”(hhh]”(hŒ
field_name”“”)”}”(hŒAuthor”h]”hŒAuthor”…””}”(hhÛhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙhhÖhŸh³h K ubhŒ
field_body”“”)”}”(hŒ"Mike Leach <mike.leach@linaro.org>”h]”hŒ	paragraph”“”)”}”(hhíh]”(hŒMike Leach <”…””}”(hhñhžhhŸNh NubhŒ	reference”“”)”}”(hŒmike.leach@linaro.org”h]”hŒmike.leach@linaro.org”…””}”(hhúhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:mike.leach@linaro.org”uh1høhhñubhŒ>”…””}”(hhñhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Khhëubah}”(h]”h ]”h"]”h$]”h&]”uh1héhhÖubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÔhŸh³h KhhÑubhÕ)”}”(hhh]”(hÚ)”}”(hŒDate”h]”hŒDate”…””}”(hj#  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙhj   hŸh³h K ubhê)”}”(hŒOctober 2020
”h]”hð)”}”(hŒOctober 2020”h]”hŒOctober 2020”…””}”(hj5  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Khj1  ubah}”(h]”h ]”h"]”h$]”h&]”uh1héhj   ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÔhŸh³h KhhÑubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÏhhËubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhµ)”}”(hhh]”(hº)”}”(hŒIntroduction”h]”hŒIntroduction”…””}”(hj^  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj[  hžhhŸh³h Kubhð)”}”(hŒ¼The CoreSight System Configuration manager is an API that allows the
programming of the CoreSight system with pre-defined configurations that
can then be easily enabled from sysfs or perf.”h]”hŒ¼The CoreSight System Configuration manager is an API that allows the
programming of the CoreSight system with pre-defined configurations that
can then be easily enabled from sysfs or perf.”…””}”(hjl  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Khj[  hžhubhð)”}”(hX  Many CoreSight components can be programmed in complex ways - especially ETMs.
In addition, components can interact across the CoreSight system, often via
the cross trigger components such as CTI and CTM. These system settings can
be defined and enabled as named configurations.”h]”hX  Many CoreSight components can be programmed in complex ways - especially ETMs.
In addition, components can interact across the CoreSight system, often via
the cross trigger components such as CTI and CTM. These system settings can
be defined and enabled as named configurations.”…””}”(hjz  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Khj[  hžhubeh}”(h]”Œintroduction”ah ]”h"]”Œintroduction”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒBasic Concepts”h]”hŒBasic Concepts”…””}”(hj“  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj  hžhhŸh³h Kubhð)”}”(hŒOThis section introduces the basic concepts of a CoreSight system configuration.”h]”hŒOThis section introduces the basic concepts of a CoreSight system configuration.”…””}”(hj¡  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Khj  hžhubhµ)”}”(hhh]”(hº)”}”(hŒFeatures”h]”hŒFeatures”…””}”(hj²  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj¯  hžhhŸh³h Kubhð)”}”(hŒÂA feature is a named set of programming for a CoreSight device. The programming
is device dependent, and can be defined in terms of absolute register values,
resource usage and parameter values.”h]”hŒÂA feature is a named set of programming for a CoreSight device. The programming
is device dependent, and can be defined in terms of absolute register values,
resource usage and parameter values.”…””}”(hjÀ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K hj¯  hžhubhð)”}”(hŒàThe feature is defined using a descriptor. This descriptor is used to load onto
a matching device, either when the feature is loaded into the system, or when the
CoreSight device is registered with the configuration manager.”h]”hŒàThe feature is defined using a descriptor. This descriptor is used to load onto
a matching device, either when the feature is loaded into the system, or when the
CoreSight device is registered with the configuration manager.”…””}”(hjÎ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K$hj¯  hžhubhð)”}”(hX2  The load process involves interpreting the descriptor into a set of register
accesses in the driver - the resource usage and parameter descriptions
translated into appropriate register accesses. This interpretation makes it easy
and efficient for the feature to be programmed onto the device when required.”h]”hX2  The load process involves interpreting the descriptor into a set of register
accesses in the driver - the resource usage and parameter descriptions
translated into appropriate register accesses. This interpretation makes it easy
and efficient for the feature to be programmed onto the device when required.”…””}”(hjÜ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K(hj¯  hžhubhð)”}”(hŒÊThe feature will not be active on the device until the feature is enabled, and
the device itself is enabled. When the device is enabled then enabled features
will be programmed into the device hardware.”h]”hŒÊThe feature will not be active on the device until the feature is enabled, and
the device itself is enabled. When the device is enabled then enabled features
will be programmed into the device hardware.”…””}”(hjê  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K-hj¯  hžhubhð)”}”(hŒLA feature is enabled as part of a configuration being enabled on the system.”h]”hŒLA feature is enabled as part of a configuration being enabled on the system.”…””}”(hjø  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K1hj¯  hžhubhµ)”}”(hhh]”(hº)”}”(hŒParameter Value”h]”hŒParameter Value”…””}”(hj	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj  hžhhŸh³h K5ubhð)”}”(hŒ«A parameter value is a named value that may be set by the user prior to the
feature being enabled that can adjust the behaviour of the operation programmed
by the feature.”h]”hŒ«A parameter value is a named value that may be set by the user prior to the
feature being enabled that can adjust the behaviour of the operation programmed
by the feature.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K7hj  hžhubhð)”}”(hŒÇFor example, this could be a count value in a programmed operation that repeats
at a given rate. When the feature is enabled then the current value of the
parameter is used in programming the device.”h]”hŒÇFor example, this could be a count value in a programmed operation that repeats
at a given rate. When the feature is enabled then the current value of the
parameter is used in programming the device.”…””}”(hj%  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K;hj  hžhubhð)”}”(hŒvThe feature descriptor defines a default value for a parameter, which is used
if the user does not supply a new value.”h]”hŒvThe feature descriptor defines a default value for a parameter, which is used
if the user does not supply a new value.”…””}”(hj3  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K?hj  hžhubhð)”}”(hŒmUsers can update parameter values using the configfs API for the CoreSight
system - which is described below.”h]”hŒmUsers can update parameter values using the configfs API for the CoreSight
system - which is described below.”…””}”(hjA  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KBhj  hžhubhð)”}”(hŒhThe current value of the parameter is loaded into the device when the feature
is enabled on that device.”h]”hŒhThe current value of the parameter is loaded into the device when the feature
is enabled on that device.”…””}”(hjO  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KEhj  hžhubeh}”(h]”Œparameter-value”ah ]”h"]”Œparameter value”ah$]”h&]”uh1h´hj¯  hžhhŸh³h K5ubeh}”(h]”Œfeatures”ah ]”h"]”Œfeatures”ah$]”h&]”uh1h´hj  hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒConfigurations”h]”hŒConfigurations”…””}”(hjp  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjm  hžhhŸh³h KJubhð)”}”(hŒ³A configuration defines a set of features that are to be used in a trace
session where the configuration is selected. For any trace session only one
configuration may be selected.”h]”hŒ³A configuration defines a set of features that are to be used in a trace
session where the configuration is selected. For any trace session only one
configuration may be selected.”…””}”(hj~  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KLhjm  hžhubhð)”}”(hŒ÷The features defined may be on any type of device that is registered
to support system configuration. A configuration may select features to be
enabled on a class of devices - i.e. any ETMv4, or specific devices, e.g. a
specific CTI on the system.”h]”hŒ÷The features defined may be on any type of device that is registered
to support system configuration. A configuration may select features to be
enabled on a class of devices - i.e. any ETMv4, or specific devices, e.g. a
specific CTI on the system.”…””}”(hjŒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KPhjm  hžhubhð)”}”(hŒêAs with the feature, a descriptor is used to define the configuration.
This will define the features that must be enabled as part of the configuration
as well as any preset values that can be used to override default parameter
values.”h]”hŒêAs with the feature, a descriptor is used to define the configuration.
This will define the features that must be enabled as part of the configuration
as well as any preset values that can be used to override default parameter
values.”…””}”(hjš  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KUhjm  hžhubhµ)”}”(hhh]”(hº)”}”(hŒPreset Values”h]”hŒPreset Values”…””}”(hj«  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj¨  hžhhŸh³h K\ubhð)”}”(hŒåPreset values are easily selectable sets of parameter values for the features
that the configuration uses. The number of values in a single preset set, equals
the sum of parameter values in the features used by the configuration.”h]”hŒåPreset values are easily selectable sets of parameter values for the features
that the configuration uses. The number of values in a single preset set, equals
the sum of parameter values in the features used by the configuration.”…””}”(hj¹  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K^hj¨  hžhubhð)”}”(hŒ¯e.g. a configuration consists of 3 features, one has 2 parameters, one has
a single parameter, and another has no parameters. A single preset set will
therefore have 3 values.”h]”hŒ¯e.g. a configuration consists of 3 features, one has 2 parameters, one has
a single parameter, and another has no parameters. A single preset set will
therefore have 3 values.”…””}”(hjÇ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Kbhj¨  hžhubhð)”}”(hŒ¬Presets are optionally defined by the configuration, up to 15 can be defined.
If no preset is selected, then the parameter values defined in the feature
are used as normal.”h]”hŒ¬Presets are optionally defined by the configuration, up to 15 can be defined.
If no preset is selected, then the parameter values defined in the feature
are used as normal.”…””}”(hjÕ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Kfhj¨  hžhubeh}”(h]”Œpreset-values”ah ]”h"]”Œpreset values”ah$]”h&]”uh1h´hjm  hžhhŸh³h K\ubhµ)”}”(hhh]”(hº)”}”(hŒ	Operation”h]”hŒ	Operation”…””}”(hjî  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjë  hžhhŸh³h Klubhð)”}”(hŒCThe following steps take place in the operation of a configuration.”h]”hŒCThe following steps take place in the operation of a configuration.”…””}”(hjü  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Knhjë  hžhubhŒenumerated_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒƒIn this example, the configuration is 'autofdo', which has an
associated feature 'strobing' that works on ETMv4 CoreSight Devices.
”h]”hð)”}”(hŒ‚In this example, the configuration is 'autofdo', which has an
associated feature 'strobing' that works on ETMv4 CoreSight Devices.”h]”hŒŠIn this example, the configuration is â€˜autofdoâ€™, which has an
associated feature â€˜strobingâ€™ that works on ETMv4 CoreSight Devices.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Kphj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  hžhhŸh³h Nubj  )”}”(hŒÃThe configuration is enabled. For example 'perf' may select the
configuration as part of its command line::

 perf record -e cs_etm/autofdo/ myapp

which will enable the 'autofdo' configuration.
”h]”(hð)”}”(hŒkThe configuration is enabled. For example 'perf' may select the
configuration as part of its command line::”h]”hŒnThe configuration is enabled. For example â€˜perfâ€™ may select the
configuration as part of its command line:”…””}”(hj-  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Kshj)  ubhŒliteral_block”“”)”}”(hŒ$perf record -e cs_etm/autofdo/ myapp”h]”hŒ$perf record -e cs_etm/autofdo/ myapp”…””}”hj=  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h Kvhj)  ubhð)”}”(hŒ.which will enable the 'autofdo' configuration.”h]”hŒ2which will enable the â€˜autofdoâ€™ configuration.”…””}”(hjK  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Kxhj)  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  hžhhŸh³h Nubj  )”}”(hX  perf starts tracing on the system. As each ETMv4 that perf uses for
trace is enabled,  the configuration manager will check if the ETMv4
has a feature that relates to the currently active configuration.
In this case 'strobing' is enabled & programmed into the ETMv4.
”h]”hð)”}”(hX
  perf starts tracing on the system. As each ETMv4 that perf uses for
trace is enabled,  the configuration manager will check if the ETMv4
has a feature that relates to the currently active configuration.
In this case 'strobing' is enabled & programmed into the ETMv4.”h]”hX  perf starts tracing on the system. As each ETMv4 that perf uses for
trace is enabled,  the configuration manager will check if the ETMv4
has a feature that relates to the currently active configuration.
In this case â€˜strobingâ€™ is enabled & programmed into the ETMv4.”…””}”(hjc  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Kzhj_  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  hžhhŸh³h Nubj  )”}”(hŒ[When the ETMv4 is disabled, any registers marked as needing to be
saved will be read back.
”h]”hð)”}”(hŒZWhen the ETMv4 is disabled, any registers marked as needing to be
saved will be read back.”h]”hŒZWhen the ETMv4 is disabled, any registers marked as needing to be
saved will be read back.”…””}”(hj{  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Khjw  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  hžhhŸh³h Nubj  )”}”(hŒEAt the end of the perf session, the configuration will be disabled.

”h]”hð)”}”(hŒCAt the end of the perf session, the configuration will be disabled.”h]”hŒCAt the end of the perf session, the configuration will be disabled.”…””}”(hj“  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K‚hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ)”uh1j
  hjë  hžhhŸh³h Kpubeh}”(h]”Œ	operation”ah ]”h"]”Œ	operation”ah$]”h&]”uh1h´hjm  hžhhŸh³h Klubeh}”(h]”Œconfigurations”ah ]”h"]”Œconfigurations”ah$]”h&]”uh1h´hj  hžhhŸh³h KJubeh}”(h]”Œbasic-concepts”ah ]”h"]”Œbasic concepts”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒ#Viewing Configurations and Features”h]”hŒ#Viewing Configurations and Features”…””}”(hjÍ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjÊ  hžhhŸh³h K†ubhð)”}”(hŒvThe set of configurations and features that are currently loaded into the
system can be viewed using the configfs API.”h]”hŒvThe set of configurations and features that are currently loaded into the
system can be viewed using the configfs API.”…””}”(hjÛ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KˆhjÊ  hžhubhð)”}”(hŒDMount configfs as normal and the 'cs-syscfg' subsystem will appear::”h]”hŒGMount configfs as normal and the â€˜cs-syscfgâ€™ subsystem will appear:”…””}”(hjé  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K‹hjÊ  hžhubj<  )”}”(hŒ"$ ls /config
cs-syscfg  stp-policy”h]”hŒ"$ ls /config
cs-syscfg  stp-policy”…””}”hj÷  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h KhjÊ  hžhubhð)”}”(hŒThis has two sub-directories::”h]”hŒThis has two sub-directories:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KhjÊ  hžhubj<  )”}”(hŒ-$ cd cs-syscfg/
$ ls
configurations  features”h]”hŒ-$ cd cs-syscfg/
$ ls
configurations  features”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h K’hjÊ  hžhubhð)”}”(hŒTThe system has the configuration 'autofdo' built in. It may be examined as
follows::”h]”hŒWThe system has the configuration â€˜autofdoâ€™ built in. It may be examined as
follows:”…””}”(hj!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K–hjÊ  hžhubj<  )”}”(hX  $ cd configurations/
$ ls
autofdo
$ cd autofdo/
$ ls
description  feature_refs  preset1  preset3  preset5  preset7  preset9
enable       preset        preset2  preset4  preset6  preset8
$ cat description
Setup ETMs with strobing for autofdo
$ cat feature_refs
strobing”h]”hX  $ cd configurations/
$ ls
autofdo
$ cd autofdo/
$ ls
description  feature_refs  preset1  preset3  preset5  preset7  preset9
enable       preset        preset2  preset4  preset6  preset8
$ cat description
Setup ETMs with strobing for autofdo
$ cat feature_refs
strobing”…””}”hj/  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h K™hjÊ  hžhubhð)”}”(hŒiEach preset declared has a 'preset<n>' subdirectory declared. The values for
the preset can be examined::”h]”hŒlEach preset declared has a â€˜preset<n>â€™ subdirectory declared. The values for
the preset can be examined:”…””}”(hj=  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K¥hjÊ  hžhubj<  )”}”(hŒ‡$ cat preset1/values
strobing.window = 0x1388 strobing.period = 0x2
$ cat preset2/values
strobing.window = 0x1388 strobing.period = 0x4”h]”hŒ‡$ cat preset1/values
strobing.window = 0x1388 strobing.period = 0x2
$ cat preset2/values
strobing.window = 0x1388 strobing.period = 0x4”…””}”hjK  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h K¨hjÊ  hžhubhð)”}”(hŒeThe 'enable' and 'preset' files allow the control of a configuration when
using CoreSight with sysfs.”h]”hŒmThe â€˜enableâ€™ and â€˜presetâ€™ files allow the control of a configuration when
using CoreSight with sysfs.”…””}”(hjY  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K­hjÊ  hžhubhð)”}”(hŒXThe features referenced by the configuration can be examined in the features
directory::”h]”hŒWThe features referenced by the configuration can be examined in the features
directory:”…””}”(hjg  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K°hjÊ  hžhubj<  )”}”(hX%  $ cd ../../features/strobing/
$ ls
description  matches  nr_params  params
$ cat description
Generate periodic trace capture windows.
parameter 'window': a number of CPU cycles (W)
parameter 'period': trace enabled for W cycles every period x W cycles
$ cat matches
SRC_ETMV4
$ cat nr_params
2”h]”hX%  $ cd ../../features/strobing/
$ ls
description  matches  nr_params  params
$ cat description
Generate periodic trace capture windows.
parameter 'window': a number of CPU cycles (W)
parameter 'period': trace enabled for W cycles every period x W cycles
$ cat matches
SRC_ETMV4
$ cat nr_params
2”…””}”hju  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h K³hjÊ  hžhubhð)”}”(hŒ?Move to the params directory to examine and adjust parameters::”h]”hŒ>Move to the params directory to examine and adjust parameters:”…””}”(hjƒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K¿hjÊ  hžhubj<  )”}”(hŒocd params
$ ls
period  window
$ cd period
$ ls
value
$ cat value
0x2710
# echo 15000 > value
# cat value
0x3a98”h]”hŒocd params
$ ls
period  window
$ cd period
$ ls
value
$ cat value
0x2710
# echo 15000 > value
# cat value
0x3a98”…””}”hj‘  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h KÁhjÊ  hžhubhð)”}”(hŒcParameters adjusted in this way are reflected in all device instances that have
loaded the feature.”h]”hŒcParameters adjusted in this way are reflected in all device instances that have
loaded the feature.”…””}”(hjŸ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KÍhjÊ  hžhubeh}”(h]”Œ#viewing-configurations-and-features”ah ]”h"]”Œ#viewing configurations and features”ah$]”h&]”uh1h´hh¶hžhhŸh³h K†ubhµ)”}”(hhh]”(hº)”}”(hŒUsing Configurations in perf”h]”hŒUsing Configurations in perf”…””}”(hj¸  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjµ  hžhhŸh³h KÒubhð)”}”(hŒ¾The configurations loaded into the CoreSight configuration management are
also declared in the perf 'cs_etm' event infrastructure so that they can
be selected when running trace under perf::”h]”hŒÁThe configurations loaded into the CoreSight configuration management are
also declared in the perf â€˜cs_etmâ€™ event infrastructure so that they can
be selected when running trace under perf:”…””}”(hjÆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KÔhjµ  hžhubj<  )”}”(hŒ$ ls /sys/devices/cs_etm
cpu0  cpu2  events  nr_addr_filters         power  subsystem  uevent
cpu1  cpu3  format  perf_event_mux_interval_ms      sinks  type”h]”hŒ$ ls /sys/devices/cs_etm
cpu0  cpu2  events  nr_addr_filters         power  subsystem  uevent
cpu1  cpu3  format  perf_event_mux_interval_ms      sinks  type”…””}”hjÔ  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h KØhjµ  hžhubhð)”}”(hŒ¹The key directory here is 'events' - a generic perf directory which allows
selection on the perf command line. As with the sinks entries, this provides
a hash of the configuration name.”h]”hŒ½The key directory here is â€˜eventsâ€™ - a generic perf directory which allows
selection on the perf command line. As with the sinks entries, this provides
a hash of the configuration name.”…””}”(hjâ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KÜhjµ  hžhubhð)”}”(hŒŒThe entry in the 'events' directory uses perfs built in syntax generator
to substitute the syntax for the name when evaluating the command::”h]”hŒThe entry in the â€˜eventsâ€™ directory uses perfs built in syntax generator
to substitute the syntax for the name when evaluating the command:”…””}”(hjð  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Kàhjµ  hžhubj<  )”}”(hŒ=$ ls events/
autofdo
$ cat events/autofdo
configid=0xa7c3dddd”h]”hŒ=$ ls events/
autofdo
$ cat events/autofdo
configid=0xa7c3dddd”…””}”hjþ  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h Kãhjµ  hžhubhð)”}”(hŒFThe 'autofdo' configuration may be selected on the perf command line::”h]”hŒIThe â€˜autofdoâ€™ configuration may be selected on the perf command line:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Kèhjµ  hžhubj<  )”}”(hŒ<$ perf record -e cs_etm/autofdo/u --per-thread <application>”h]”hŒ<$ perf record -e cs_etm/autofdo/u --per-thread <application>”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h Kêhjµ  hžhubhð)”}”(hŒHA preset to override the current parameter values can also be selected::”h]”hŒGA preset to override the current parameter values can also be selected:”…””}”(hj(  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Kìhjµ  hžhubj<  )”}”(hŒE$ perf record -e cs_etm/autofdo,preset=1/u --per-thread <application>”h]”hŒE$ perf record -e cs_etm/autofdo,preset=1/u --per-thread <application>”…””}”hj6  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h Kîhjµ  hžhubhð)”}”(hŒaWhen configurations are selected in this way, then the trace sink used is
automatically selected.”h]”hŒaWhen configurations are selected in this way, then the trace sink used is
automatically selected.”…””}”(hjD  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Kðhjµ  hžhubeh}”(h]”Œusing-configurations-in-perf”ah ]”h"]”Œusing configurations in perf”ah$]”h&]”uh1h´hh¶hžhhŸh³h KÒubhµ)”}”(hhh]”(hº)”}”(hŒUsing Configurations in sysfs”h]”hŒUsing Configurations in sysfs”…””}”(hj]  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjZ  hžhhŸh³h Kôubhð)”}”(hŒ˜Coresight can be controlled using sysfs. When this is in use then a configuration
can be made active for the devices that are used in the sysfs session.”h]”hŒ˜Coresight can be controlled using sysfs. When this is in use then a configuration
can be made active for the devices that are used in the sysfs session.”…””}”(hjk  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KöhjZ  hžhubhð)”}”(hŒ9In a configuration there are 'enable' and 'preset' files.”h]”hŒAIn a configuration there are â€˜enableâ€™ and â€˜presetâ€™ files.”…””}”(hjy  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KùhjZ  hžhubhð)”}”(hŒ.To enable a configuration for use with sysfs::”h]”hŒ-To enable a configuration for use with sysfs:”…””}”(hj‡  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h KûhjZ  hžhubj<  )”}”(hŒ-$ cd configurations/autofdo
$ echo 1 > enable”h]”hŒ-$ cd configurations/autofdo
$ echo 1 > enable”…””}”hj•  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h KýhjZ  hžhubhð)”}”(hŒkThis will then use any default parameter values in the features - which can be
adjusted as described above.”h]”hŒkThis will then use any default parameter values in the features - which can be
adjusted as described above.”…””}”(hj£  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h M hjZ  hžhubhð)”}”(hŒ,To use a preset<n> set of parameter values::”h]”hŒ+To use a preset<n> set of parameter values:”…””}”(hj±  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h MhjZ  hžhubj<  )”}”(hŒ$ echo 3 > preset”h]”hŒ$ echo 3 > preset”…””}”hj¿  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j;  hŸh³h MhjZ  hžhubhð)”}”(hŒ©This will select preset3 for the configuration.
The valid values for preset are 0 - to deselect presets, and any value of
<n> where a preset<n> sub-directory is present.”h]”hŒ©This will select preset3 for the configuration.
The valid values for preset are 0 - to deselect presets, and any value of
<n> where a preset<n> sub-directory is present.”…””}”(hjÍ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h MhjZ  hžhubhð)”}”(hX4  Note that the active sysfs configuration is a global parameter, therefore
only a single configuration can be active for sysfs at any one time.
Attempting to enable a second configuration will result in an error.
Additionally, attempting to disable the configuration while in use will
also result in an error.”h]”hX4  Note that the active sysfs configuration is a global parameter, therefore
only a single configuration can be active for sysfs at any one time.
Attempting to enable a second configuration will result in an error.
Additionally, attempting to disable the configuration while in use will
also result in an error.”…””}”(hjÛ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h MhjZ  hžhubhð)”}”(hŒ^The use of the active configuration by sysfs is independent of the configuration
used in perf.”h]”hŒ^The use of the active configuration by sysfs is independent of the configuration
used in perf.”…””}”(hjé  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h MhjZ  hžhubeh}”(h]”Œusing-configurations-in-sysfs”ah ]”h"]”Œusing configurations in sysfs”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kôubhµ)”}”(hhh]”(hº)”}”(hŒ*Creating and Loading Custom Configurations”h]”hŒ*Creating and Loading Custom Configurations”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjÿ  hžhhŸh³h Mubhð)”}”(hŒmCustom configurations and / or features can be dynamically loaded into the
system by using a loadable module.”h]”hŒmCustom configurations and / or features can be dynamically loaded into the
system by using a loadable module.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Mhjÿ  hžhubhð)”}”(hŒEAn example of a custom configuration is found in ./samples/coresight.”h]”hŒEAn example of a custom configuration is found in ./samples/coresight.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Mhjÿ  hžhubhð)”}”(hŒ{This creates a new configuration that uses the existing built in
strobing feature, but provides a different set of presets.”h]”hŒ{This creates a new configuration that uses the existing built in
strobing feature, but provides a different set of presets.”…””}”(hj,  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Mhjÿ  hžhubhð)”}”(hŒ¦When the module is loaded, then the configuration appears in the configfs
file system and is selectable in the same way as the built in configuration
described above.”h]”hŒ¦When the module is loaded, then the configuration appears in the configfs
file system and is selectable in the same way as the built in configuration
described above.”…””}”(hj:  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h M hjÿ  hžhubhð)”}”(hŒÖConfigurations can use previously loaded features. The system will ensure
that it is not possible to unload a feature that is currently in use, by
enforcing the unload order as the strict reverse of the load order.”h]”hŒÖConfigurations can use previously loaded features. The system will ensure
that it is not possible to unload a feature that is currently in use, by
enforcing the unload order as the strict reverse of the load order.”…””}”(hjH  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h M$hjÿ  hžhubeh}”(h]”Œ*creating-and-loading-custom-configurations”ah ]”h"]”Œ*creating and loading custom configurations”ah$]”h&]”uh1h´hh¶hžhhŸh³h Mubeh}”(h]”Œ&coresight-system-configuration-manager”ah ]”h"]”Œ&coresight system configuration manager”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j‰  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jc  j`  j  jŠ  jÇ  jÄ  jj  jg  jb  j_  j¿  j¼  jè  jå  j·  j´  j²  j¯  jW  jT  jü  jù  j[  jX  uŒ	nametypes”}”(jc  ‰j  ‰jÇ  ‰jj  ‰jb  ‰j¿  ‰jè  ‰j·  ‰j²  ‰jW  ‰jü  ‰j[  ‰uh}”(j`  h¶jŠ  j[  jÄ  j  jg  j¯  j_  j  j¼  jm  jå  j¨  j´  jë  j¯  jÊ  jT  jµ  jù  jZ  jX  jÿ  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.