€•ˆ1Œ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”Œ/translations/zh_CN/gpu/panthor”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/zh_TW/gpu/panthor”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/it_IT/gpu/panthor”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/ja_JP/gpu/panthor”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/ko_KR/gpu/panthor”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ/translations/sp_SP/gpu/panthor”Œ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ŸŒ9/var/lib/git/docbuild/linux/Documentation/gpu/panthor.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒdrm/Panthor CSF driver”h]”hŒdrm/Panthor CSF driver”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒtarget”“”)”}”(hŒ.. _panthor-usage-stats:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œpanthor-usage-stats”uh1hÉh Khh¶hžhhŸh³ubhµ)”}”(hhh]”(hº)”}”(hŒ-Panthor DRM client usage stats implementation”h]”hŒ-Panthor DRM client usage stats implementation”…””}”(hhÚhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh×hžhhŸh³h K ubhŒ paragraph”“”)”}”(hŒzThe drm/Panthor driver implements the DRM client usage stats specification as documented in :ref:`drm-client-usage-stats`.”h]”(hŒ\The drm/Panthor driver implements the DRM client usage stats specification as documented in ”…””}”(hhêhžhhŸNh Nubh)”}”(hŒ:ref:`drm-client-usage-stats`”h]”hŒinline”“”)”}”(hhôh]”hŒdrm-client-usage-stats”…””}”(hhøhžhhŸNh Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1höhhòubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œ gpu/panthor”Œ refdomain”jŒreftype”Œref”Œ refexplicit”‰Œrefwarn”ˆŒ reftarget”Œdrm-client-usage-stats”uh1hhŸh³h K hhêubhŒ.”…””}”(hhêhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K hh×hžhubhé)”}”(hŒtExample of the output showing the implemented key value pairs and entirety of the currently possible format options:”h]”hŒtExample of the output showing the implemented key value pairs and entirety of the currently possible format options:”…””}”(hj!hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khh×hžhubhŒdefinition_list”“”)”}”(hhh]”hŒdefinition_list_item”“”)”}”(hXÞ:: pos: 0 flags: 02400002 mnt_id: 29 ino: 491 drm-driver: panthor drm-client-id: 10 drm-engine-panthor: 111110952750 ns drm-cycles-panthor: 94439687187 drm-maxfreq-panthor: 1000000000 Hz drm-curfreq-panthor: 1000000000 Hz panthor-resident-memory: 10396 KiB panthor-active-memory: 10396 KiB drm-total-memory: 16480 KiB drm-shared-memory: 0 drm-active-memory: 16200 KiB drm-resident-memory: 16480 KiB drm-purgeable-memory: 0 ”h]”(hŒterm”“”)”}”(hŒ::”h]”hŒ::”…””}”(hj<hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j:hŸh³h K#hj6ubhŒ definition”“”)”}”(hhh]”hé)”}”(hXÚpos: 0 flags: 02400002 mnt_id: 29 ino: 491 drm-driver: panthor drm-client-id: 10 drm-engine-panthor: 111110952750 ns drm-cycles-panthor: 94439687187 drm-maxfreq-panthor: 1000000000 Hz drm-curfreq-panthor: 1000000000 Hz panthor-resident-memory: 10396 KiB panthor-active-memory: 10396 KiB drm-total-memory: 16480 KiB drm-shared-memory: 0 drm-active-memory: 16200 KiB drm-resident-memory: 16480 KiB drm-purgeable-memory: 0”h]”hXÚpos: 0 flags: 02400002 mnt_id: 29 ino: 491 drm-driver: panthor drm-client-id: 10 drm-engine-panthor: 111110952750 ns drm-cycles-panthor: 94439687187 drm-maxfreq-panthor: 1000000000 Hz drm-curfreq-panthor: 1000000000 Hz panthor-resident-memory: 10396 KiB panthor-active-memory: 10396 KiB drm-total-memory: 16480 KiB drm-shared-memory: 0 drm-active-memory: 16200 KiB drm-resident-memory: 16480 KiB drm-purgeable-memory: 0”…””}”(hjOhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KhjLubah}”(h]”h ]”h"]”h$]”h&]”uh1jJhj6ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j4hŸh³h K#hj1ubah}”(h]”h ]”h"]”h$]”h&]”uh1j/hh×hžhhŸh³h Nubhé)”}”(hŒ~Possible `drm-engine-` key names are: `panthor`. `drm-curfreq-` values convey the current operating frequency for that engine.”h]”(hŒ Possible ”…””}”(hjohžhhŸNh NubhŒtitle_reference”“”)”}”(hŒ `drm-engine-`”h]”hŒ drm-engine-”…””}”(hjyhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jwhjoubhŒ key names are: ”…””}”(hjohžhhŸNh Nubjx)”}”(hŒ `panthor`”h]”hŒpanthor”…””}”(hj‹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jwhjoubhŒ. ”…””}”(hjohžhhŸNh Nubjx)”}”(hŒ`drm-curfreq-`”h]”hŒ drm-curfreq-”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jwhjoubhŒ? values convey the current operating frequency for that engine.”…””}”(hjohžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K%hh×hžhubhé)”}”(hX$Users must bear in mind that engine and cycle sampling are disabled by default, because of power saving concerns. `fdinfo` users and benchmark applications which query the fdinfo file must make sure to toggle the job profiling status of the driver by writing into the appropriate sysfs node::”h]”(hŒrUsers must bear in mind that engine and cycle sampling are disabled by default, because of power saving concerns. ”…””}”(hjµhžhhŸNh Nubjx)”}”(hŒ`fdinfo`”h]”hŒfdinfo”…””}”(hj½hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jwhjµubhŒ© users and benchmark applications which query the fdinfo file must make sure to toggle the job profiling status of the driver by writing into the appropriate sysfs node:”…””}”(hjµhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K(hh×hžhubhŒ literal_block”“”)”}”(hŒDecho > /sys/bus/platform/drivers/panthor/[a-f0-9]*.gpu/profiling”h]”hŒDecho > /sys/bus/platform/drivers/panthor/[a-f0-9]*.gpu/profiling”…””}”hj×sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jÕhŸh³h K-hh×hžhubhé)”}”(hŒqWhere `N` is a bit mask where cycle and timestamp sampling are respectively enabled by the first and second bits.”h]”(hŒWhere ”…””}”(hjåhžhhŸNh Nubjx)”}”(hŒ`N`”h]”hŒN”…””}”(hjíhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jwhjåubhŒh is a bit mask where cycle and timestamp sampling are respectively enabled by the first and second bits.”…””}”(hjåhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K/hh×hžhubhé)”}”(hXPossible `panthor-*-memory` keys are: `active` and `resident`. These values convey the sizes of the internal driver-owned shmem BO's that aren't exposed to user-space through a DRM handle, like queue ring buffers, sync object arrays and heap chunks. Because they are all allocated and pinned at creation time, only `panthor-resident-memory` is necessary to tell us their size. `panthor-active-memory` shows the size of kernel BO's associated with VM's and groups currently being scheduled for execution by the GPU.”h]”(hŒ Possible ”…””}”(hjhžhhŸNh Nubjx)”}”(hŒ`panthor-*-memory`”h]”hŒpanthor-*-memory”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jwhjubhŒ keys are: ”…””}”(hjhžhhŸNh Nubjx)”}”(hŒ`active`”h]”hŒactive”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jwhjubhŒ and ”…””}”(hjhžhhŸNh Nubjx)”}”(hŒ `resident`”h]”hŒresident”…””}”(hj1hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jwhjubhX. These values convey the sizes of the internal driver-owned shmem BO’s that aren’t exposed to user-space through a DRM handle, like queue ring buffers, sync object arrays and heap chunks. Because they are all allocated and pinned at creation time, only ”…””}”(hjhžhhŸNh Nubjx)”}”(hŒ`panthor-resident-memory`”h]”hŒpanthor-resident-memory”…””}”(hjChžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jwhjubhŒ% is necessary to tell us their size. ”…””}”(hjhžhhŸNh Nubjx)”}”(hŒ`panthor-active-memory`”h]”hŒpanthor-active-memory”…””}”(hjUhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jwhjubhŒv shows the size of kernel BO’s associated with VM’s and groups currently being scheduled for execution by the GPU.”…””}”(hjhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K2hh×hžhubeh}”(h]”(Œ-panthor-drm-client-usage-stats-implementation”hÖeh ]”h"]”(Œ-panthor drm client usage stats implementation”Œpanthor-usage-stats”eh$]”h&]”uh1h´hh¶hžhhŸh³h K Œexpect_referenced_by_name”}”jshËsŒexpect_referenced_by_id”}”hÖhËsubeh}”(h]”Œdrm-panthor-csf-driver”ah ]”h"]”Œdrm/panthor csf driver”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”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”}”hÖ]”hËasŒnameids”}”(jj|jshÖjrjouŒ nametypes”}”(j‰jsˆjr‰uh}”(j|h¶hÖh×joh×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”]”(hŒsystem_message”“”)”}”(hhh]”hé)”}”(hŒ`Possible incomplete section title. Treating the overline as ordinary text because it's so short.”h]”hŒbPossible incomplete section title. Treating the overline as ordinary text because it’s so short.”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhj ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œline”KŒsource”h³uh1jhh×hžhhŸh³h Kubj )”}”(hhh]”hé)”}”(hŒ`Blank line missing before literal block (after the "::")? Interpreted as a definition list item.”h]”hŒdBlank line missing before literal block (after the “::â€)? Interpreted as a definition list item.”…””}”(hj)hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhj&ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”j#Œline”K$Œsource”h³uh1jhjLubeŒtransform_messages”]”j )”}”(hhh]”hé)”}”(hhh]”hŒ9Hyperlink target "panthor-usage-stats" is not referenced.”…””}”hjFsbah}”(h]”h ]”h"]”h$]”h&]”uh1hèhjCubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”j#Œsource”h³Œline”Kuh1jubaŒ transformer”NŒ include_log”]”Œ decoration”Nhžhub.