€•‘<      Œ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”Œ0/translations/zh_CN/trace/coresight/ultrasoc-smb”Œ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”Œ0/translations/zh_TW/trace/coresight/ultrasoc-smb”Œ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”Œ0/translations/it_IT/trace/coresight/ultrasoc-smb”Œ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”Œ0/translations/ja_JP/trace/coresight/ultrasoc-smb”Œ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”Œ0/translations/ko_KR/trace/coresight/ultrasoc-smb”Œ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”Œ0/translations/sp_SP/trace/coresight/ultrasoc-smb”Œ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ŸŒJ/var/lib/git/docbuild/linux/Documentation/trace/coresight/ultrasoc-smb.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ%UltraSoc - HW Assisted Tracing on SoC”h]”hŒ%UltraSoc - HW Assisted Tracing on SoC”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒblock_quote”“”)”}”(hŒ@:Author:   Qi Liu <liuqi115@huawei.com>
:Date:     January 2023
”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ŒQi Liu <liuqi115@huawei.com>”h]”hŒ	paragraph”“”)”}”(hhíh]”(hŒQi Liu <”…””}”(hhñhžhhŸNh NubhŒ	reference”“”)”}”(hŒliuqi115@huawei.com”h]”hŒliuqi115@huawei.com”…””}”(hhúhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:liuqi115@huawei.com”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ŒJanuary 2023
”h]”hð)”}”(hŒJanuary 2023”h]”hŒJanuary 2023”…””}”(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X  UltraSoc SMB is a per SCCL (Super CPU Cluster) hardware. It provides a
way to buffer and store CPU trace messages in a region of shared system
memory. The device acts as a coresight sink device and the
corresponding trace generators (ETM) are attached as source devices.”h]”hX  UltraSoc SMB is a per SCCL (Super CPU Cluster) hardware. It provides a
way to buffer and store CPU trace messages in a region of shared system
memory. The device acts as a coresight sink device and the
corresponding trace generators (ETM) are attached as source devices.”…””}”(hjl  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ŒSysfs files and directories”h]”hŒSysfs files and directories”…””}”(hj…  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj‚  hžhhŸh³h Kubhð)”}”(hŒNThe SMB devices appear on the existing coresight bus alongside other
devices::”h]”hŒMThe SMB devices appear on the existing coresight bus alongside other
devices:”…””}”(hj“  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Khj‚  hžhubhŒliteral_block”“”)”}”(hŒS$# ls /sys/bus/coresight/devices/
ultra_smb0   ultra_smb1   ultra_smb2   ultra_smb3”h]”hŒS$# ls /sys/bus/coresight/devices/
ultra_smb0   ultra_smb1   ultra_smb2   ultra_smb3”…””}”hj£  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j¡  hŸh³h Khj‚  hžhubhð)”}”(hŒ=The ``ultra_smb<N>`` names SMB device associated with SCCL.::”h]”(hŒThe ”…””}”(hj±  hžhhŸNh NubhŒliteral”“”)”}”(hŒ``ultra_smb<N>``”h]”hŒultra_smb<N>”…””}”(hj»  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¹  hj±  ubhŒ( names SMB device associated with SCCL.:”…””}”(hj±  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h Khj‚  hžhubj¢  )”}”(hŒ™$# ls /sys/bus/coresight/devices/ultra_smb0
enable_sink   mgmt
$# ls /sys/bus/coresight/devices/ultra_smb0/mgmt
buf_size  buf_status  read_pos  write_pos”h]”hŒ™$# ls /sys/bus/coresight/devices/ultra_smb0
enable_sink   mgmt
$# ls /sys/bus/coresight/devices/ultra_smb0/mgmt
buf_size  buf_status  read_pos  write_pos”…””}”hjÓ  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j¡  hŸh³h Khj‚  hžhubhð)”}”(hŒKey file items are:”h]”hŒKey file items are:”…””}”(hjá  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K!hj‚  hžhubhÊ)”}”(hX&  * ``read_pos``: Shows the value on the read pointer register.
* ``write_pos``: Shows the value on the write pointer register.
* ``buf_status``: Shows the value on the status register.
  BIT(0) is zero value which means the buffer is empty.
* ``buf_size``: Shows the buffer size of each device.
”h]”hŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ;``read_pos``: Shows the value on the read pointer register.”h]”hð)”}”(hjü  h]”(jº  )”}”(hŒ``read_pos``”h]”hŒread_pos”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¹  hjþ  ubhŒ/: Shows the value on the read pointer register.”…””}”(hjþ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K#hjú  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jø  hjõ  ubjù  )”}”(hŒ=``write_pos``: Shows the value on the write pointer register.”h]”hð)”}”(hj!  h]”(jº  )”}”(hŒ``write_pos``”h]”hŒ	write_pos”…””}”(hj&  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¹  hj#  ubhŒ0: Shows the value on the write pointer register.”…””}”(hj#  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K$hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jø  hjõ  ubjù  )”}”(hŒm``buf_status``: Shows the value on the status register.
BIT(0) is zero value which means the buffer is empty.”h]”hð)”}”(hŒm``buf_status``: Shows the value on the status register.
BIT(0) is zero value which means the buffer is empty.”h]”(jº  )”}”(hŒ``buf_status``”h]”hŒ
buf_status”…””}”(hjL  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¹  hjH  ubhŒ_: Shows the value on the status register.
BIT(0) is zero value which means the buffer is empty.”…””}”(hjH  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K%hjD  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jø  hjõ  ubjù  )”}”(hŒ4``buf_size``: Shows the buffer size of each device.
”h]”hð)”}”(hŒ3``buf_size``: Shows the buffer size of each device.”h]”(jº  )”}”(hŒ``buf_size``”h]”hŒbuf_size”…””}”(hjr  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¹  hjn  ubhŒ': Shows the buffer size of each device.”…””}”(hjn  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K'hjj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jø  hjõ  ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1jó  hŸh³h K#hjï  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K#hj‚  hžhubeh}”(h]”Œsysfs-files-and-directories”ah ]”h"]”Œsysfs files and directories”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒFirmware Bindings”h]”hŒFirmware Bindings”…””}”(hj©  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj¦  hžhhŸh³h K*ubhð)”}”(hŒzThe device is only supported with ACPI. Its binding describes device
identifier, resource information and graph structure.”h]”hŒzThe device is only supported with ACPI. Its binding describes device
identifier, resource information and graph structure.”…””}”(hj·  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K,hj¦  hžhubhð)”}”(hX  The device is identified as ACPI HID "HISI03A1". Device resources are allocated
using the _CRS method. Each device must present two base address; the first one
is the configuration base address of the device, the second one is the 32-bit
base address of shared system memory.”h]”hX  The device is identified as ACPI HID â€œHISI03A1â€. Device resources are allocated
using the _CRS method. Each device must present two base address; the first one
is the configuration base address of the device, the second one is the 32-bit
base address of shared system memory.”…””}”(hjÅ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K/hj¦  hžhubhð)”}”(hŒ	Example::”h]”hŒExample:”…””}”(hjÓ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhŸh³h K4hj¦  hžhubj¢  )”}”(hXj  Device(USMB) {                                               \
  Name(_HID, "HISI03A1")                                     \
  Name(_CRS, ResourceTemplate() {                            \
      QWordMemory (ResourceConsumer, , MinFixed, MaxFixed, NonCacheable, \
                   ReadWrite, 0x0, 0x95100000, 0x951FFFFF, 0x0, 0x100000) \
      QWordMemory (ResourceConsumer, , MinFixed, MaxFixed, Cacheable, \
                   ReadWrite, 0x0, 0x50000000, 0x53FFFFFF, 0x0, 0x4000000) \
  })                                                         \
  Name(_DSD, Package() {                                     \
    ToUUID("ab02a46b-74c7-45a2-bd68-f7d344ef2153"),          \
    /* Use CoreSight Graph ACPI bindings to describe connections topology */
    Package() {                                              \
      0,                                                     \
      1,                                                     \
      Package() {                                            \
        1,                                                   \
        ToUUID("3ecbc8b6-1d0e-4fb3-8107-e627f805c6cd"),      \
        8,                                                   \
        Package() {0x8, 0, \_SB.S00.SL11.CL28.F008, 0},       \
        Package() {0x9, 0, \_SB.S00.SL11.CL29.F009, 0},       \
        Package() {0xa, 0, \_SB.S00.SL11.CL2A.F010, 0},       \
        Package() {0xb, 0, \_SB.S00.SL11.CL2B.F011, 0},       \
        Package() {0xc, 0, \_SB.S00.SL11.CL2C.F012, 0},       \
        Package() {0xd, 0, \_SB.S00.SL11.CL2D.F013, 0},       \
        Package() {0xe, 0, \_SB.S00.SL11.CL2E.F014, 0},       \
        Package() {0xf, 0, \_SB.S00.SL11.CL2F.F015, 0},       \
      }                                                      \
    }                                                        \
  })                                                         \
}”h]”hXj  Device(USMB) {                                               \
  Name(_HID, "HISI03A1")                                     \
  Name(_CRS, ResourceTemplate() {                            \
      QWordMemory (ResourceConsumer, , MinFixed, MaxFixed, NonCacheable, \
                   ReadWrite, 0x0, 0x95100000, 0x951FFFFF, 0x0, 0x100000) \
      QWordMemory (ResourceConsumer, , MinFixed, MaxFixed, Cacheable, \
                   ReadWrite, 0x0, 0x50000000, 0x53FFFFFF, 0x0, 0x4000000) \
  })                                                         \
  Name(_DSD, Package() {                                     \
    ToUUID("ab02a46b-74c7-45a2-bd68-f7d344ef2153"),          \
    /* Use CoreSight Graph ACPI bindings to describe connections topology */
    Package() {                                              \
      0,                                                     \
      1,                                                     \
      Package() {                                            \
        1,                                                   \
        ToUUID("3ecbc8b6-1d0e-4fb3-8107-e627f805c6cd"),      \
        8,                                                   \
        Package() {0x8, 0, \_SB.S00.SL11.CL28.F008, 0},       \
        Package() {0x9, 0, \_SB.S00.SL11.CL29.F009, 0},       \
        Package() {0xa, 0, \_SB.S00.SL11.CL2A.F010, 0},       \
        Package() {0xb, 0, \_SB.S00.SL11.CL2B.F011, 0},       \
        Package() {0xc, 0, \_SB.S00.SL11.CL2C.F012, 0},       \
        Package() {0xd, 0, \_SB.S00.SL11.CL2D.F013, 0},       \
        Package() {0xe, 0, \_SB.S00.SL11.CL2E.F014, 0},       \
        Package() {0xf, 0, \_SB.S00.SL11.CL2F.F015, 0},       \
      }                                                      \
    }                                                        \
  })                                                         \
}”…””}”hjá  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j¡  hŸh³h K6hj¦  hžhubeh}”(h]”Œfirmware-bindings”ah ]”h"]”Œfirmware bindings”ah$]”h&]”uh1h´hh¶hžhhŸh³h K*ubeh}”(h]”Œ#ultrasoc-hw-assisted-tracing-on-soc”ah ]”h"]”Œ%ultrasoc - hw assisted tracing on soc”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”}”(jü  jù  j  j|  j£  j   jô  jñ  uŒ	nametypes”}”(jü  ‰j  ‰j£  ‰jô  ‰uh}”(jù  h¶j|  j[  j   j‚  jñ  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.