€•®(      Œ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”Œ%/translations/zh_CN/gpu/amdgpu/gc/mes”Œ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”Œ%/translations/zh_TW/gpu/amdgpu/gc/mes”Œ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”Œ%/translations/it_IT/gpu/amdgpu/gc/mes”Œ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”Œ%/translations/ja_JP/gpu/amdgpu/gc/mes”Œ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”Œ%/translations/ko_KR/gpu/amdgpu/gc/mes”Œ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”Œ%/translations/sp_SP/gpu/amdgpu/gc/mes”Œ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Œtarget”“”)”}”(hŒ.. _amdgpu-mes:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œ
amdgpu-mes”uh1h¡h KhhhžhhŸŒ?/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/gc/mes.rst”ubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒMicroEngine Scheduler (MES)”h]”hŒMicroEngine Scheduler (MES)”…””}”(hh·hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hµhh²hžhhŸh¯h KubhŒnote”“”)”}”(hŒ/Queue and ring buffer are used as a synonymous.”h]”hŒ	paragraph”“”)”}”(hhÉh]”hŒ/Queue and ring buffer are used as a synonymous.”…””}”(hhÍhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËhŸh¯h KhhÇubah}”(h]”h ]”h"]”h$]”h&]”uh1hÅhh²hžhhŸh¯h NubhÆ)”}”(hŒïThis section assumes that you are familiar with the concept of Pipes, Queues, and GC.
If not, check :ref:`GFX, Compute, and SDMA Overall Behavior<pipes-and-queues-description>`
and :ref:`drm/amdgpu - Graphics and Compute (GC) <amdgpu-gc>`.”h]”hÌ)”}”(hŒïThis section assumes that you are familiar with the concept of Pipes, Queues, and GC.
If not, check :ref:`GFX, Compute, and SDMA Overall Behavior<pipes-and-queues-description>`
and :ref:`drm/amdgpu - Graphics and Compute (GC) <amdgpu-gc>`.”h]”(hŒdThis section assumes that you are familiar with the concept of Pipes, Queues, and GC.
If not, check ”…””}”(hhähžhhŸNh Nubh)”}”(hŒL:ref:`GFX, Compute, and SDMA Overall Behavior<pipes-and-queues-description>`”h]”hŒinline”“”)”}”(hhîh]”hŒ'GFX, Compute, and SDMA Overall Behavior”…””}”(hhòhžhhŸNh Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1hðhhìubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œgpu/amdgpu/gc/mes”Œ	refdomain”hýŒreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆŒ	reftarget”Œpipes-and-queues-description”uh1hhŸh¯h KhhäubhŒ
and ”…””}”(hhähžhhŸNh Nubh)”}”(hŒ9:ref:`drm/amdgpu - Graphics and Compute (GC) <amdgpu-gc>`”h]”hñ)”}”(hj  h]”hŒ&drm/amdgpu - Graphics and Compute (GC)”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”(hüŒstd”Œstd-ref”eh"]”h$]”h&]”uh1hðhj  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j	  Œ	refdomain”j#  Œreftype”Œref”Œrefexplicit”ˆŒrefwarn”ˆj  Œ	amdgpu-gc”uh1hhŸh¯h K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²hžhhŸh¯h NubhÌ)”}”(hXu  Every GFX has a pipe component with one or more hardware queues. Pipes can
switch between queues depending on certain conditions, and one of the
components that can request a queue switch to a pipe is the MicroEngine
Scheduler (MES). Whenever the driver is initialized, it creates one MQD per
hardware queue, and then the MQDs are handed to the MES firmware for mapping
to:”h]”hXu  Every GFX has a pipe component with one or more hardware queues. Pipes can
switch between queues depending on certain conditions, and one of the
components that can request a queue switch to a pipe is the MicroEngine
Scheduler (MES). Whenever the driver is initialized, it creates one MQD per
hardware queue, and then the MQDs are handed to the MES firmware for mapping
to:”…””}”(hjE  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËhŸh¯h Khh²hžhubhŒenumerated_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hX¡  Kernel Queues (legacy): This queue is statically mapped to HQDs and never
preempted. Even though this is a legacy feature, it is the current default, and
most existing hardware supports it. When an application submits work to the
kernel driver, it submits all of the application command buffers to the kernel
queues. The CS IOCTL takes the command buffer from the applications and
schedules them on the kernel queue.
”h]”hÌ)”}”(hX   Kernel Queues (legacy): This queue is statically mapped to HQDs and never
preempted. Even though this is a legacy feature, it is the current default, and
most existing hardware supports it. When an application submits work to the
kernel driver, it submits all of the application command buffers to the kernel
queues. The CS IOCTL takes the command buffer from the applications and
schedules them on the kernel queue.”h]”hX   Kernel Queues (legacy): This queue is statically mapped to HQDs and never
preempted. Even though this is a legacy feature, it is the current default, and
most existing hardware supports it. When an application submits work to the
kernel driver, it submits all of the application command buffers to the kernel
queues. The CS IOCTL takes the command buffer from the applications and
schedules them on the kernel queue.”…””}”(hj^  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËhŸh¯h KhjZ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jX  hjU  hžhhŸh¯h NubjY  )”}”(hX   User Queues: These queues are dynamically mapped to the HQDs. Regarding the
utilization of User Queues, the userspace application will create its user
queues and submit work directly to its user queues with no need to IOCTL for
each submission and no need to share a single kernel queue.
”h]”hÌ)”}”(hX  User Queues: These queues are dynamically mapped to the HQDs. Regarding the
utilization of User Queues, the userspace application will create its user
queues and submit work directly to its user queues with no need to IOCTL for
each submission and no need to share a single kernel queue.”h]”hX  User Queues: These queues are dynamically mapped to the HQDs. Regarding the
utilization of User Queues, the userspace application will create its user
queues and submit work directly to its user queues with no need to IOCTL for
each submission and no need to share a single kernel queue.”…””}”(hjv  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËhŸh¯h Khjr  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jX  hjU  hžhhŸh¯h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1jS  hh²hžhhŸh¯h KubhÌ)”}”(hXY  In terms of User Queues, MES can dynamically map them to the HQD. If there are
more MQDs than HQDs, the MES firmware will preempt other user queues to make
sure each queues get a time slice; in other words, MES is a microcontroller
that handles the mapping and unmapping of MQDs into HQDs, as well as the
priorities and oversubscription of MQDs.”h]”hXY  In terms of User Queues, MES can dynamically map them to the HQD. If there are
more MQDs than HQDs, the MES firmware will preempt other user queues to make
sure each queues get a time slice; in other words, MES is a microcontroller
that handles the mapping and unmapping of MQDs into HQDs, as well as the
priorities and oversubscription of MQDs.”…””}”(hj•  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËhŸh¯h K"hh²hžhubeh}”(h]”(Œmicroengine-scheduler-mes”h®eh ]”h"]”(Œmicroengine scheduler (mes)”Œ
amdgpu-mes”eh$]”h&]”uh1h°hhhžhhŸh¯h KŒexpect_referenced_by_name”}”j©  h£sŒexpect_referenced_by_id”}”h®h£subeh}”(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”}”(j©  h®j¨  j¥  uŒ	nametypes”}”(j©  ˆj¨  ‰uh}”(h®h²j¥  h²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”]”hŒsystem_message”“”)”}”(hhh]”hÌ)”}”(hhh]”hŒ0Hyperlink target "amdgpu-mes" is not referenced.”…””}”hj=  sbah}”(h]”h ]”h"]”h$]”h&]”uh1hËhj:  ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h¯Œline”Kuh1j8  ubaŒtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.