€•Ê=Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ 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”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ0/translations/zh_TW/trace/coresight/ultrasoc-smb”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ0/translations/it_IT/trace/coresight/ultrasoc-smb”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ0/translations/ja_JP/trace/coresight/ultrasoc-smb”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ0/translations/ko_KR/trace/coresight/ultrasoc-smb”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ0/translations/pt_BR/trace/coresight/ultrasoc-smb”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ0/translations/sp_SP/trace/coresight/ultrasoc-smb”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1hµhhh²hh³ŒJ/var/lib/git/docbuild/linux/Documentation/trace/coresight/ultrasoc-smb.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ%UltraSoc - HW Assisted Tracing on SoC”h]”hŒ%UltraSoc - HW Assisted Tracing on SoC”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒ block_quote”“”)”}”(hŒ@:Author: Qi Liu :Date: January 2023 ”h]”hŒ field_list”“”)”}”(hhh]”(hŒfield”“”)”}”(hhh]”(hŒ field_name”“”)”}”(hŒAuthor”h]”hŒAuthor”…””}”(hhïh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1híhhêh³hÇh´KubhŒ field_body”“”)”}”(hŒQi Liu ”h]”hŒ paragraph”“”)”}”(hjh]”(hŒQi Liu <”…””}”(hjh²hh³Nh´NubhŒ reference”“”)”}”(hŒliuqi115@huawei.com”h]”hŒliuqi115@huawei.com”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:liuqi115@huawei.com”uh1j hjubhŒ>”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Khhÿubah}”(h]”h ]”h"]”h$]”h&]”uh1hýhhêubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèh³hÇh´Khhåubhé)”}”(hhh]”(hî)”}”(hŒDate”h]”hŒDate”…””}”(hj7h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1híhj4h³hÇh´Kubhþ)”}”(hŒ January 2023 ”h]”j)”}”(hŒ January 2023”h]”hŒ January 2023”…””}”(hjIh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KhjEubah}”(h]”h ]”h"]”h$]”h&]”uh1hýhj4ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèh³hÇh´Khhåubeh}”(h]”h ]”h"]”h$]”h&]”uh1hãhhßubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒ Introduction”h]”hŒ Introduction”…””}”(hjrh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjoh²hh³hÇh´K ubj)”}”(hXUltraSoc 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]”hXUltraSoc 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.”…””}”(hj€h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K hjoh²hubeh}”(h]”Œ introduction”ah ]”h"]”Œ introduction”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K ubhÉ)”}”(hhh]”(hÎ)”}”(hŒSysfs files and directories”h]”hŒSysfs files and directories”…””}”(hj™h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj–h²hh³hÇh´Kubj)”}”(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:”…””}”(hj§h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Khj–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”…””}”hj·sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1jµh³hÇh´Khj–h²hubj)”}”(hŒ=The ``ultra_smb`` names SMB device associated with SCCL.::”h]”(hŒThe ”…””}”(hjÅh²hh³Nh´NubhŒliteral”“”)”}”(hŒ``ultra_smb``”h]”hŒ ultra_smb”…””}”(hjÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍhjÅubhŒ( names SMB device associated with SCCL.:”…””}”(hjÅh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Khj–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”…””}”hjçsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1jµh³hÇh´Khj–h²hubj)”}”(hŒKey file items are:”h]”hŒKey file items are:”…””}”(hjõh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K!hj–h²hubhÞ)”}”(hX&* ``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”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒ;``read_pos``: Shows the value on the read pointer register.”h]”j)”}”(hjh]”(jÎ)”}”(hŒ ``read_pos``”h]”hŒread_pos”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍhjubhŒ/: Shows the value on the read pointer register.”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K#hjubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj ubj )”}”(hŒ=``write_pos``: Shows the value on the write pointer register.”h]”j)”}”(hj5h]”(jÎ)”}”(hŒ ``write_pos``”h]”hŒ write_pos”…””}”(hj:h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍhj7ubhŒ0: Shows the value on the write pointer register.”…””}”(hj7h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K$hj3ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj ubj )”}”(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Œ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”…””}”(hj`h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍhj\ubhŒ_: Shows the value on the status register. BIT(0) is zero value which means the buffer is empty.”…””}”(hj\h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K%hjXubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj ubj )”}”(hŒ4``buf_size``: Shows the buffer size of each device. ”h]”j)”}”(hŒ3``buf_size``: Shows the buffer size of each device.”h]”(jÎ)”}”(hŒ ``buf_size``”h]”hŒbuf_size”…””}”(hj†h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍhj‚ubhŒ': Shows the buffer size of each device.”…””}”(hj‚h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K'hj~ubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1jh³hÇh´K#hjubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K#hj–h²hubeh}”(h]”Œsysfs-files-and-directories”ah ]”h"]”Œsysfs files and directories”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒFirmware Bindings”h]”hŒFirmware Bindings”…””}”(hj½h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjºh²hh³hÇh´K*ubj)”}”(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.”…””}”(hjËh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K,hjºh²hubj)”}”(hXThe 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]”hXThe 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.”…””}”(hjÙh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K/hjºh²hubj)”}”(hŒ Example::”h]”hŒExample:”…””}”(hjçh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K4hjºh²hubj¶)”}”(hXjDevice(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]”hXjDevice(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}, \ } \ } \ }) \ }”…””}”hjõsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1jµh³hÇh´K6hjºh²hubeh}”(h]”Œfirmware-bindings”ah ]”h"]”Œfirmware bindings”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K*ubeh}”(h]”Œ#ultrasoc-hw-assisted-tracing-on-soc”ah ]”h"]”Œ%ultrasoc - hw assisted tracing on soc”ah$]”h&]”uh1hÈhhh²hh³hÇh´Kubeh}”(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”j6Œ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”}”(jj j“jj·j´jjuŒ nametypes”}”(j‰j“‰j·‰j‰uh}”(j hÊjjoj´j–jjº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.