€•ù=      Œ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/nouveau”Œ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/nouveau”Œ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/nouveau”Œ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/nouveau”Œ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/nouveau”Œ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/nouveau”Œ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+ OR MIT)”h]”hŒ*SPDX-License-Identifier: (GPL-2.0+ OR MIT)”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒ9/var/lib/git/docbuild/linux/Documentation/gpu/nouveau.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒdrm/nouveau NVIDIA GPU Driver”h]”hŒdrm/nouveau NVIDIA GPU Driver”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ	paragraph”“”)”}”(hŒ¾The drm/nouveau driver provides support for a wide range of NVIDIA GPUs,
covering GeForce, Quadro, and Tesla series, from the NV04 architecture up
to the latest Turing, Ampere, Ada families.”h]”hŒ¾The drm/nouveau driver provides support for a wide range of NVIDIA GPUs,
covering GeForce, Quadro, and Tesla series, from the NV04 architecture up
to the latest Turing, Ampere, Ada families.”…””}”(hhËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhµ)”}”(hhh]”(hº)”}”(hŒNVKM: NVIDIA Kernel Manager”h]”hŒNVKM: NVIDIA Kernel Manager”…””}”(hhÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hhÙhžhhŸh³h KubhÊ)”}”(hŒßThe NVKM component serves as the core abstraction layer within the nouveau
driver, responsible for managing NVIDIA GPU hardware at the kernel level.
NVKM provides a unified interface for handling various GPU  architectures.”h]”hŒßThe NVKM component serves as the core abstraction layer within the nouveau
driver, responsible for managing NVIDIA GPU hardware at the kernel level.
NVKM provides a unified interface for handling various GPU  architectures.”…””}”(hhêhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhhÙhžhubhÊ)”}”(hŒ£It enables resource management, power control, memory handling, and command
submission required for the proper functioning of NVIDIA GPUs under the
nouveau driver.”h]”hŒ£It enables resource management, power control, memory handling, and command
submission required for the proper functioning of NVIDIA GPUs under the
nouveau driver.”…””}”(hhøhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhhÙhžhubhÊ)”}”(hŒƒNVKM plays a critical role in abstracting hardware complexities and
providing a consistent API to upper layers of the driver stack.”h]”hŒƒNVKM plays a critical role in abstracting hardware complexities and
providing a consistent API to upper layers of the driver stack.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhhÙhžhubhµ)”}”(hhh]”(hº)”}”(hŒGSP Support”h]”hŒGSP Support”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj  hžhhŸh³h KubhÊ)”}”(hŒmhttps://github.com/NVIDIA/open-gpu-kernel-modules/blob/535/src/nvidia/inc/kernel/gpu/gsp/message_queue_priv.h”h]”hŒ	reference”“”)”}”(hj'  h]”hŒmhttps://github.com/NVIDIA/open-gpu-kernel-modules/blob/535/src/nvidia/inc/kernel/gpu/gsp/message_queue_priv.h”…””}”(hj+  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j'  uh1j)  hj%  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h KChj  hžhubhÊ)”}”(hŒåThe GSP command queue and status queue are message queues for the
communication between software and GSP. The software submits the GSP
RPC via the GSP command queue, GSP writes the status of the submitted
RPC in the status queue.”h]”hŒåThe GSP command queue and status queue are message queues for the
communication between software and GSP. The software submits the GSP
RPC via the GSP command queue, GSP writes the status of the submitted
RPC in the status queue.”…””}”(hj@  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h KEhj  hžhubhÊ)”}”(hŒ4A GSP message queue element consists of three parts:”h]”hŒ4A GSP message queue element consists of three parts:”…””}”(hjO  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h KJhj  hžhubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒkmessage element header (struct r535_gsp_msg), which mostly maintains
the metadata for queuing the element.
”h]”hÊ)”}”(hŒjmessage element header (struct r535_gsp_msg), which mostly maintains
the metadata for queuing the element.”h]”hŒjmessage element header (struct r535_gsp_msg), which mostly maintains
the metadata for queuing the element.”…””}”(hji  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h KLhje  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jc  hj`  ubjd  )”}”(hŒnRPC message header (struct nvfw_gsp_rpc), which maintains the info
of the RPC. E.g., the RPC function number.
”h]”hÊ)”}”(hŒmRPC message header (struct nvfw_gsp_rpc), which maintains the info
of the RPC. E.g., the RPC function number.”h]”hŒmRPC message header (struct nvfw_gsp_rpc), which maintains the info
of the RPC. E.g., the RPC function number.”…””}”(hj‚  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h KOhj~  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jc  hj`  ubjd  )”}”(hŒ¬The payload, where the RPC message stays. E.g. the params of a
specific RPC function. Some RPC functions also have their headers
in the payload. E.g. rm_alloc, rm_control.
”h]”hÊ)”}”(hŒ«The payload, where the RPC message stays. E.g. the params of a
specific RPC function. Some RPC functions also have their headers
in the payload. E.g. rm_alloc, rm_control.”h]”hŒ«The payload, where the RPC message stays. E.g. the params of a
specific RPC function. Some RPC functions also have their headers
in the payload. E.g. rm_alloc, rm_control.”…””}”(hj›  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h KRhj—  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jc  hj`  ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j^  hŸjw  h KLhj  hžhubhÊ)”}”(hŒEThe memory layout of a GSP message element can be illustrated below::”h]”hŒDThe memory layout of a GSP message element can be illustrated below:”…””}”(hj¸  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h KVhj  hžhubhŒliteral_block”“”)”}”(hXå  +------------------------+
| Message Element Header |
|    (r535_gsp_msg)      |
|                        |
| (r535_gsp_msg.data)    |
|          |             |
|----------V-------------|
|    GSP RPC Header      |
|    (nvfw_gsp_rpc)      |
|                        |
| (nvfw_gsp_rpc.data)    |
|          |             |
|----------V-------------|
|       Payload          |
|                        |
|   header(optional)     |
|        params          |
+------------------------+”h]”hXå  +------------------------+
| Message Element Header |
|    (r535_gsp_msg)      |
|                        |
| (r535_gsp_msg.data)    |
|          |             |
|----------V-------------|
|    GSP RPC Header      |
|    (nvfw_gsp_rpc)      |
|                        |
| (nvfw_gsp_rpc.data)    |
|          |             |
|----------V-------------|
|       Payload          |
|                        |
|   header(optional)     |
|        params          |
+------------------------+”…””}”hjÉ  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jÇ  hŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h KXhj  hžhubhÊ)”}”(hŒÌThe max size of a message queue element is 16 pages (including the
headers). When a GSP message to be sent is larger than 16 pages, the
message should be split into multiple elements and sent accordingly.”h]”hŒÌThe max size of a message queue element is 16 pages (including the
headers). When a GSP message to be sent is larger than 16 pages, the
message should be split into multiple elements and sent accordingly.”…””}”(hjØ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h Kkhj  hžhubhÊ)”}”(hŒÂIn the bunch of the split elements, the first element has the expected
function number, while the rest of the elements are sent with the
function number NV_VGPU_MSG_FUNCTION_CONTINUATION_RECORD.”h]”hŒÂIn the bunch of the split elements, the first element has the expected
function number, while the rest of the elements are sent with the
function number NV_VGPU_MSG_FUNCTION_CONTINUATION_RECORD.”…””}”(hjç  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h Kohj  hžhubhÊ)”}”(hŒƒGSP consumes the elements from the cmdq and always writes the result
back to the msgq. The result is also formed as split elements.”h]”hŒƒGSP consumes the elements from the cmdq and always writes the result
back to the msgq. The result is also formed as split elements.”…””}”(hjö  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h Kshj  hžhubhÊ)”}”(hŒTerminology:”h]”hŒTerminology:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h Kvhj  hžhubj_  )”}”(hhh]”(jd  )”}”(hŒMgsp_msg(msg): GSP message element (element header + GSP RPC header +
payload)”h]”hÊ)”}”(hŒMgsp_msg(msg): GSP message element (element header + GSP RPC header +
payload)”h]”hŒMgsp_msg(msg): GSP message element (element header + GSP RPC header +
payload)”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h Kxhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jc  hj  ubjd  )”}”(hŒ,gsp_rpc(rpc): GSP RPC (RPC header + payload)”h]”hÊ)”}”(hj2  h]”hŒ,gsp_rpc(rpc): GSP RPC (RPC header + payload)”…””}”(hj4  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h Kzhj0  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jc  hj  ubjd  )”}”(hŒ2gsp_rpc_buf: buffer for (GSP RPC header + payload)”h]”hÊ)”}”(hjJ  h]”hŒ2gsp_rpc_buf: buffer for (GSP RPC header + payload)”…””}”(hjL  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h K{hjH  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jc  hj  ubjd  )”}”(hŒ/gsp_rpc_len: size of (GSP RPC header + payload)”h]”hÊ)”}”(hjb  h]”hŒ/gsp_rpc_len: size of (GSP RPC header + payload)”…””}”(hjd  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h K|hj`  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jc  hj  ubjd  )”}”(hŒ*params_size: size of params in the payload”h]”hÊ)”}”(hjz  h]”hŒ*params_size: size of params in the payload”…””}”(hj|  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h K}hjx  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jc  hj  ubjd  )”}”(hŒApayload_size: size of (header if exists + params) in the payload
”h]”hÊ)”}”(hŒ@payload_size: size of (header if exists + params) in the payload”h]”hŒ@payload_size: size of (header if exists + params) in the payload”…””}”(hj”  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸŒj/var/lib/git/docbuild/linux/Documentation/gpu/nouveau:28: ./drivers/gpu/drm/nouveau/nvkm/subdev/gsp/r535.c”h K~hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jc  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”j¶  j·  uh1j^  hŸj)  h Kxhj  hžhubeh}”(h]”Œgsp-support”ah ]”h"]”Œgsp support”ah$]”h&]”uh1h´hhÙhžhhŸh³h Kubeh}”(h]”Œnvkm-nvidia-kernel-manager”ah ]”h"]”Œnvkm: nvidia kernel manager”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubeh}”(h]”Œdrm-nouveau-nvidia-gpu-driver”ah ]”h"]”Œdrm/nouveau nvidia gpu driver”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±  uŒ	nametypes”}”(jÄ  ‰j¼  ‰j´  ‰uh}”(jÁ  h¶j¹  hÙ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.