€•s•      Œ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”Œ3/translations/zh_CN/gpu/amdgpu/display/dcn-overview”Œ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”Œ3/translations/zh_TW/gpu/amdgpu/display/dcn-overview”Œ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”Œ3/translations/it_IT/gpu/amdgpu/display/dcn-overview”Œ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”Œ3/translations/ja_JP/gpu/amdgpu/display/dcn-overview”Œ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”Œ3/translations/ko_KR/gpu/amdgpu/display/dcn-overview”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ3/translations/pt_BR/gpu/amdgpu/display/dcn-overview”Œ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”Œ3/translations/sp_SP/gpu/amdgpu/display/dcn-overview”Œ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Œ.. _dcn_overview:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œdcn-overview”uh1hµh´Khhh²hh³ŒM/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/display/dcn-overview.rst”ubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒDisplay Core Next (DCN)”h]”hŒDisplay Core Next (DCN)”…””}”(hhËh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhhÆh²hh³hÃh´KubhŒ	paragraph”“”)”}”(hX  To equip our readers with the basic knowledge of how AMD Display Core Next
(DCN) works, we need to start with an overview of the hardware pipeline. Below
you can see a picture that provides a DCN overview, keep in mind that this is a
generic diagram, and we have variations per ASIC.”h]”hX  To equip our readers with the basic knowledge of how AMD Display Core Next
(DCN) works, we need to start with an overview of the hardware pipeline. Below
you can see a picture that provides a DCN overview, keep in mind that this is a
generic diagram, and we have variations per ASIC.”…””}”(hhÛh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KhhÆh²hubŒkfigure”Œkernel_figure”“”)”}”(hhh]”hŒfigure”“”)”}”(hhh]”hŒimage”“”)”}”(hŒ,.. kernel-figure:: dc_pipeline_overview.svg
”h]”h}”(h]”h ]”h"]”h$]”h&]”Œuri”Œ+gpu/amdgpu/display/dc_pipeline_overview.svg”Œ
candidates”}”Œ*”j  suh1hôhhñh³hÃh´K ubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhhìubah}”(h]”h ]”h"]”h$]”h&]”uh1hêhhÆh²hh³hÃh´KubhÚ)”}”(hŒPBased on this diagram, we can pass through each block and briefly describe
them:”h]”hŒPBased on this diagram, we can pass through each block and briefly describe
them:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KhhÆh²hubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒË**Display Controller Hub (DCHUB)**: This is the gateway between the Scalable
Data Port (SDP) and DCN. This component has multiple features, such as memory
arbitration, rotation, and cursor manipulation.
”h]”hÚ)”}”(hŒÊ**Display Controller Hub (DCHUB)**: This is the gateway between the Scalable
Data Port (SDP) and DCN. This component has multiple features, such as memory
arbitration, rotation, and cursor manipulation.”h]”(hŒstrong”“”)”}”(hŒ"**Display Controller Hub (DCHUB)**”h]”hŒDisplay Controller Hub (DCHUB)”…””}”(hj0  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hj*  ubhŒ¨: This is the gateway between the Scalable
Data Port (SDP) and DCN. This component has multiple features, such as memory
arbitration, rotation, and cursor manipulation.”…””}”(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!  h²hh³hÃh´Nubj%  )”}”(hŒ¯**Display Pipe and Plane (DPP)**: This block provides pre-blend pixel
processing such as color space conversion, linearization of pixel data, tone
mapping, and gamut mapping.
”h]”hÚ)”}”(hŒ®**Display Pipe and Plane (DPP)**: This block provides pre-blend pixel
processing such as color space conversion, linearization of pixel data, tone
mapping, and gamut mapping.”h]”(j/  )”}”(hŒ **Display Pipe and Plane (DPP)**”h]”hŒDisplay Pipe and Plane (DPP)”…””}”(hjV  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hjR  ubhŒŽ: This block provides pre-blend pixel
processing such as color space conversion, linearization of pixel data, tone
mapping, and gamut mapping.”…””}”(hjR  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KhjN  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj!  h²hh³hÃh´Nubj%  )”}”(hŒ~**Multiple Pipe/Plane Combined (MPC)**: This component performs blending of
multiple planes, using global or per-pixel alpha.
”h]”hÚ)”}”(hŒ}**Multiple Pipe/Plane Combined (MPC)**: This component performs blending of
multiple planes, using global or per-pixel alpha.”h]”(j/  )”}”(hŒ&**Multiple Pipe/Plane Combined (MPC)**”h]”hŒ"Multiple Pipe/Plane Combined (MPC)”…””}”(hj|  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hjx  ubhŒW: This component performs blending of
multiple planes, using global or per-pixel alpha.”…””}”(hjx  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Khjt  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj!  h²hh³hÃh´Nubj%  )”}”(hŒX**Output Pixel Processing (OPP)**: Process and format pixels to be sent to
the display.
”h]”hÚ)”}”(hŒW**Output Pixel Processing (OPP)**: Process and format pixels to be sent to
the display.”h]”(j/  )”}”(hŒ!**Output Pixel Processing (OPP)**”h]”hŒOutput Pixel Processing (OPP)”…””}”(hj¢  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hjž  ubhŒ6: Process and format pixels to be sent to
the display.”…””}”(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!  h²hh³hÃh´Nubj%  )”}”(hŒ”**Output Pipe Timing Combiner (OPTC)**: It generates time output to combine
streams or divide capabilities. CRC values are generated in this block.
”h]”hÚ)”}”(hŒ“**Output Pipe Timing Combiner (OPTC)**: It generates time output to combine
streams or divide capabilities. CRC values are generated in this block.”h]”(j/  )”}”(hŒ&**Output Pipe Timing Combiner (OPTC)**”h]”hŒ"Output Pipe Timing Combiner (OPTC)”…””}”(hjÈ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hjÄ  ubhŒm: It generates time output to combine
streams or divide capabilities. CRC values are generated in this block.”…””}”(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!  h²hh³hÃh´Nubj%  )”}”(hŒQ**Display Output (DIO)**: Codify the output to the display connected to our
GPU.
”h]”hÚ)”}”(hŒP**Display Output (DIO)**: Codify the output to the display connected to our
GPU.”h]”(j/  )”}”(hŒ**Display Output (DIO)**”h]”hŒDisplay Output (DIO)”…””}”(hjî  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hjê  ubhŒ8: Codify the output to the display connected to our
GPU.”…””}”(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!  h²hh³hÃh´Nubj%  )”}”(hŒ}**Display Writeback (DWB)**: It provides the ability to write the output of
the display pipe back to memory as video frames.
”h]”hÚ)”}”(hŒ|**Display Writeback (DWB)**: It provides the ability to write the output of
the display pipe back to memory as video frames.”h]”(j/  )”}”(hŒ**Display Writeback (DWB)**”h]”hŒDisplay Writeback (DWB)”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hj  ubhŒa: It provides the ability to write the output of
the display pipe back to memory as video frames.”…””}”(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!  h²hh³hÃh´Nubj%  )”}”(hŒq**Multi-Media HUB (MMHUBBUB)**: Memory controller interface for DMCUB and DWB
(Note that DWB is not hooked yet).
”h]”hÚ)”}”(hŒp**Multi-Media HUB (MMHUBBUB)**: Memory controller interface for DMCUB and DWB
(Note that DWB is not hooked yet).”h]”(j/  )”}”(hŒ**Multi-Media HUB (MMHUBBUB)**”h]”hŒMulti-Media HUB (MMHUBBUB)”…””}”(hj:  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hj6  ubhŒR: Memory controller interface for DMCUB and DWB
(Note that DWB is not hooked yet).”…””}”(hj6  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K(hj2  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj!  h²hh³hÃh´Nubj%  )”}”(hŒñ**DCN Management Unit (DMU)**: It provides registers with access control and
interrupts the controller to the SOC host interrupt unit. This block includes
the Display Micro-Controller Unit - version B (DMCUB), which is handled via
firmware.
”h]”hÚ)”}”(hŒð**DCN Management Unit (DMU)**: It provides registers with access control and
interrupts the controller to the SOC host interrupt unit. This block includes
the Display Micro-Controller Unit - version B (DMCUB), which is handled via
firmware.”h]”(j/  )”}”(hŒ**DCN Management Unit (DMU)**”h]”hŒDCN Management Unit (DMU)”…””}”(hj`  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hj\  ubhŒÓ: It provides registers with access control and
interrupts the controller to the SOC host interrupt unit. This block includes
the Display Micro-Controller Unit - version B (DMCUB), which is handled via
firmware.”…””}”(hj\  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K+hjX  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj!  h²hh³hÃh´Nubj%  )”}”(hŒy**DCN Clock Generator Block (DCCG)**: It provides the clocks and resets
for all of the display controller clock domains.
”h]”hÚ)”}”(hŒx**DCN Clock Generator Block (DCCG)**: It provides the clocks and resets
for all of the display controller clock domains.”h]”(j/  )”}”(hŒ$**DCN Clock Generator Block (DCCG)**”h]”hŒ DCN Clock Generator Block (DCCG)”…””}”(hj†  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hj‚  ubhŒT: It provides the clocks and resets
for all of the display controller clock domains.”…””}”(hj‚  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K0hj~  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj!  h²hh³hÃh´Nubj%  )”}”(hŒ**Azalia (AZ)**: Audio engine.
”h]”hÚ)”}”(hŒ**Azalia (AZ)**: Audio engine.”h]”(j/  )”}”(hŒ**Azalia (AZ)**”h]”hŒAzalia (AZ)”…””}”(hj¬  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hj¨  ubhŒ: Audio engine.”…””}”(hj¨  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K3hj¤  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj!  h²hh³hÃh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”j  uh1j  h³hÃh´KhhÆh²hubhÚ)”}”(hX,  The above diagram is an architecture generalization of DCN, which means that
every ASIC has variations around this base model. Notice that the display
pipeline is connected to the Scalable Data Port (SDP) via DCHUB; you can see
the SDP as the element from our Data Fabric that feeds the display pipe.”h]”hX,  The above diagram is an architecture generalization of DCN, which means that
every ASIC has variations around this base model. Notice that the display
pipeline is connected to the Scalable Data Port (SDP) via DCHUB; you can see
the SDP as the element from our Data Fabric that feeds the display pipe.”…””}”(hjÑ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K5hhÆh²hubhÚ)”}”(hXo  Always approach the DCN architecture as something flexible that can be
configured and reconfigured in multiple ways; in other words, each block can be
setup or ignored accordingly with userspace demands. For example, if we
want to drive an 8k@60Hz with a DSC enabled, our DCN may require 4 DPP and 2
OPP. It is DC's responsibility to drive the best configuration for each
specific scenario. Orchestrate all of these components together requires a
sophisticated communication interface which is highlighted in the diagram by
the edges that connect each block; from the chart, each connection between
these blocks represents:”h]”(hŒðAlways approach the DCN architecture as something flexible that can be
configured and reconfigured in multiple ways; in other words, each block can be
setup or ignored accordingly with userspace demands. For example, if we
want to drive an ”…””}”(hjß  h²hh³Nh´NubhŒ	reference”“”)”}”(hŒ8k@60Hz”h]”hŒ8k@60Hz”…””}”(hjé  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:8k@60Hz”uh1jç  hjß  ubhXz   with a DSC enabled, our DCN may require 4 DPP and 2
OPP. It is DCâ€™s responsibility to drive the best configuration for each
specific scenario. Orchestrate all of these components together requires a
sophisticated communication interface which is highlighted in the diagram by
the edges that connect each block; from the chart, each connection between
these blocks represents:”…””}”(hjß  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K:hhÆh²hubhŒenumerated_list”“”)”}”(hhh]”(j%  )”}”(hŒ;Pixel data interface (red): Represents the pixel data flow;”h]”hÚ)”}”(hj
  h]”hŒ;Pixel data interface (red): Represents the pixel data flow;”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KDhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj  h²hh³hÃh´Nubj%  )”}”(hŒnGlobal sync signals (green): It is a set of synchronization signals composed
by VStartup, VUpdate, and VReady;”h]”hÚ)”}”(hŒnGlobal sync signals (green): It is a set of synchronization signals composed
by VStartup, VUpdate, and VReady;”h]”hŒnGlobal sync signals (green): It is a set of synchronization signals composed
by VStartup, VUpdate, and VReady;”…””}”(hj#  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KEhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj  h²hh³hÃh´Nubj%  )”}”(hŒ2Config interface: Responsible to configure blocks;”h]”hÚ)”}”(hj9  h]”hŒ2Config interface: Responsible to configure blocks;”…””}”(hj;  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KGhj7  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj  h²hh³hÃh´Nubj%  )”}”(hŒFSideband signals: All other signals that do not fit the previous one.
”h]”hÚ)”}”(hŒESideband signals: All other signals that do not fit the previous one.”h]”hŒESideband signals: All other signals that do not fit the previous one.”…””}”(hjR  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KHhjN  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj  h²hh³hÃh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1j  hhÆh²hh³hÃh´KDubhÚ)”}”(hŒThese signals are essential and play an important role in DCN. Nevertheless,
the Global Sync deserves an extra level of detail described in the next
section.”h]”hŒThese signals are essential and play an important role in DCN. Nevertheless,
the Global Sync deserves an extra level of detail described in the next
section.”…””}”(hjq  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KJhhÆh²hubhÚ)”}”(hXµ  All of these components are represented by a data structure named dc_state.
From DCHUB to MPC, we have a representation called dc_plane; from MPC to OPTC,
we have dc_stream, and the output (DIO) is handled by dc_link. Keep in mind
that HUBP accesses a surface using a specific format read from memory, and our
dc_plane should work to convert all pixels in the plane to something that can
be sent to the display via dc_stream and dc_link.”h]”hXµ  All of these components are represented by a data structure named dc_state.
From DCHUB to MPC, we have a representation called dc_plane; from MPC to OPTC,
we have dc_stream, and the output (DIO) is handled by dc_link. Keep in mind
that HUBP accesses a surface using a specific format read from memory, and our
dc_plane should work to convert all pixels in the plane to something that can
be sent to the display via dc_stream and dc_link.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KNhhÆh²hubhÅ)”}”(hhh]”(hÊ)”}”(hŒFront End and Back End”h]”hŒFront End and Back End”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhj  h²hh³hÃh´KVubhÚ)”}”(hŒ”Display pipeline can be broken down into two components that are usually
referred as **Front End (FE)** and **Back End (BE)**, where FE consists of:”h]”(hŒUDisplay pipeline can be broken down into two components that are usually
referred as ”…””}”(hjž  h²hh³Nh´Nubj/  )”}”(hŒ**Front End (FE)**”h]”hŒFront End (FE)”…””}”(hj¦  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hjž  ubhŒ and ”…””}”(hjž  h²hh³Nh´Nubj/  )”}”(hŒ**Back End (BE)**”h]”hŒBack End (BE)”…””}”(hj¸  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hjž  ubhŒ, where FE consists of:”…””}”(hjž  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KXhj  h²hubj   )”}”(hhh]”(j%  )”}”(hŒ5DCHUB (Mainly referring to a subcomponent named HUBP)”h]”hÚ)”}”(hjÕ  h]”hŒ5DCHUB (Mainly referring to a subcomponent named HUBP)”…””}”(hj×  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K[hjÓ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hjÐ  h²hh³hÃh´Nubj%  )”}”(hŒDPP”h]”hÚ)”}”(hjì  h]”hŒDPP”…””}”(hjî  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K\hjê  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hjÐ  h²hh³hÃh´Nubj%  )”}”(hŒMPC
”h]”hÚ)”}”(hŒMPC”h]”hŒMPC”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K]hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hjÐ  h²hh³hÃh´Nubeh}”(h]”h ]”h"]”h$]”h&]”jÐ  j  uh1j  h³hÃh´K[hj  h²hubhÚ)”}”(hŒ On the other hand, BE consist of”h]”hŒ On the other hand, BE consist of”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K_hj  h²hubj   )”}”(hhh]”(j%  )”}”(hŒOPP”h]”hÚ)”}”(hj2  h]”hŒOPP”…””}”(hj4  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Kahj0  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj-  h²hh³hÃh´Nubj%  )”}”(hŒOPTC”h]”hÚ)”}”(hjI  h]”hŒOPTC”…””}”(hjK  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KbhjG  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj-  h²hh³hÃh´Nubj%  )”}”(hŒ.DIO (DP/HDMI stream encoder and link encoder)
”h]”hÚ)”}”(hŒ-DIO (DP/HDMI stream encoder and link encoder)”h]”hŒ-DIO (DP/HDMI stream encoder and link encoder)”…””}”(hjb  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Kchj^  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j$  hj-  h²hh³hÃh´Nubeh}”(h]”h ]”h"]”h$]”h&]”jÐ  j  uh1j  h³hÃh´Kahj  h²hubhÚ)”}”(hXo  OPP and OPTC are two joining blocks between FE and BE. On a side note, this is
a one-to-one mapping of the link encoder to PHY, but we can configure the DCN
to choose which link encoder to connect to which PHY. FE's main responsibility
is to change, blend and compose pixel data, while BE's job is to frame a
generic pixel stream to a specific display's pixel stream.”h]”hXu  OPP and OPTC are two joining blocks between FE and BE. On a side note, this is
a one-to-one mapping of the link encoder to PHY, but we can configure the DCN
to choose which link encoder to connect to which PHY. FEâ€™s main responsibility
is to change, blend and compose pixel data, while BEâ€™s job is to frame a
generic pixel stream to a specific displayâ€™s pixel stream.”…””}”(hj|  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Kehj  h²hubeh}”(h]”Œfront-end-and-back-end”ah ]”h"]”Œfront end and back end”ah$]”h&]”uh1hÄhhÆh²hh³hÃh´KVubhÅ)”}”(hhh]”(hÊ)”}”(hŒ	Data Flow”h]”hŒ	Data Flow”…””}”(hj•  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhj’  h²hh³hÃh´KlubhÚ)”}”(hX  Initially, data is passed in from VRAM through Data Fabric (DF) in native pixel
formats. Such data format stays through till HUBP in DCHUB, where HUBP unpacks
different pixel formats and outputs them to DPP in uniform streams through 4
channels (1 for alpha + 3 for colors).”h]”hX  Initially, data is passed in from VRAM through Data Fabric (DF) in native pixel
formats. Such data format stays through till HUBP in DCHUB, where HUBP unpacks
different pixel formats and outputs them to DPP in uniform streams through 4
channels (1 for alpha + 3 for colors).”…””}”(hj£  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Knhj’  h²hubhÚ)”}”(hX¡  The Converter and Cursor (CNVC) in DPP would then normalize the data
representation and convert them to a DCN specific floating-point format (i.e.,
different from the IEEE floating-point format). In the process, CNVC also
applies a degamma function to transform the data from non-linear to linear
space to relax the floating-point calculations following. Data would stay in
this floating-point format from DPP to OPP.”h]”hX¡  The Converter and Cursor (CNVC) in DPP would then normalize the data
representation and convert them to a DCN specific floating-point format (i.e.,
different from the IEEE floating-point format). In the process, CNVC also
applies a degamma function to transform the data from non-linear to linear
space to relax the floating-point calculations following. Data would stay in
this floating-point format from DPP to OPP.”…””}”(hj±  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Kshj’  h²hubhÚ)”}”(hX´  Starting OPP, because color transformation and blending have been completed
(i.e alpha can be dropped), and the end sinks do not require the precision and
dynamic range that floating points provide (i.e. all displays are in integer
depth format), bit-depth reduction/dithering would kick in. In OPP, we would
also apply a regamma function to introduce the gamma removed earlier back.
Eventually, we output data in integer format at DIO.”h]”hX´  Starting OPP, because color transformation and blending have been completed
(i.e alpha can be dropped), and the end sinks do not require the precision and
dynamic range that floating points provide (i.e. all displays are in integer
depth format), bit-depth reduction/dithering would kick in. In OPP, we would
also apply a regamma function to introduce the gamma removed earlier back.
Eventually, we output data in integer format at DIO.”…””}”(hj¿  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Kzhj’  h²hubeh}”(h]”Œ	data-flow”ah ]”h"]”Œ	data flow”ah$]”h&]”uh1hÄhhÆh²hh³hÃh´KlubhÅ)”}”(hhh]”(hÊ)”}”(hŒAMD Hardware Pipeline”h]”hŒAMD Hardware Pipeline”…””}”(hjØ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhjÕ  h²hh³hÃh´K‚ubhÚ)”}”(hX  When discussing graphics on Linux, the **pipeline** term can sometimes be
overloaded with multiple meanings, so it is important to define what we mean
when we say **pipeline**. In the DCN driver, we use the term **hardware
pipeline** or **pipeline** or just **pipe** as an abstraction to indicate a
sequence of DCN blocks instantiated to address some specific configuration. DC
core treats DCN blocks as individual resources, meaning we can build a pipeline
by taking resources for all individual hardware blocks to compose one pipeline.
In actuality, we can't connect an arbitrary block from one pipe to a block from
another pipe; they are routed linearly, except for DSC, which can be
arbitrarily assigned as needed. We have this pipeline concept for trying to
optimize bandwidth utilization.”h]”(hŒ'When discussing graphics on Linux, the ”…””}”(hjæ  h²hh³Nh´Nubj/  )”}”(hŒ**pipeline**”h]”hŒpipeline”…””}”(hjî  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hjæ  ubhŒp term can sometimes be
overloaded with multiple meanings, so it is important to define what we mean
when we say ”…””}”(hjæ  h²hh³Nh´Nubj/  )”}”(hŒ**pipeline**”h]”hŒpipeline”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hjæ  ubhŒ%. In the DCN driver, we use the term ”…””}”(hjæ  h²hh³Nh´Nubj/  )”}”(hŒ**hardware
pipeline**”h]”hŒhardware
pipeline”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hjæ  ubhŒ or ”…””}”(hjæ  h²hh³Nh´Nubj/  )”}”(hŒ**pipeline**”h]”hŒpipeline”…””}”(hj$  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hjæ  ubhŒ	 or just ”…””}”(hjæ  h²hh³Nh´Nubj/  )”}”(hŒ**pipe**”h]”hŒpipe”…””}”(hj6  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hjæ  ubhX   as an abstraction to indicate a
sequence of DCN blocks instantiated to address some specific configuration. DC
core treats DCN blocks as individual resources, meaning we can build a pipeline
by taking resources for all individual hardware blocks to compose one pipeline.
In actuality, we canâ€™t connect an arbitrary block from one pipe to a block from
another pipe; they are routed linearly, except for DSC, which can be
arbitrarily assigned as needed. We have this pipeline concept for trying to
optimize bandwidth utilization.”…””}”(hjæ  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K„hjÕ  h²hubhë)”}”(hhh]”hð)”}”(hhh]”hõ)”}”(hŒ,.. kernel-figure:: pipeline_4k_no_split.svg
”h]”h}”(h]”h ]”h"]”h$]”h&]”Œuri”Œ+gpu/amdgpu/display/pipeline_4k_no_split.svg”j  }”j  j_  suh1hôhjQ  h³hÃh´K ubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhjN  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hêhjÕ  h²hh³hÃh´K‘ubhÚ)”}”(hŒÒAdditionally, let's take a look at parts of the DTN log (see
'Documentation/gpu/amdgpu/display/dc-debug.rst' for more information) since
this log can help us to see part of this pipeline behavior in real-time::”h]”hŒ×Additionally, letâ€™s take a look at parts of the DTN log (see
â€˜Documentation/gpu/amdgpu/display/dc-debug.rstâ€™ for more information) since
this log can help us to see part of this pipeline behavior in real-time:”…””}”(hjm  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K’hjÕ  h²hubhŒliteral_block”“”)”}”(hX  HUBP:  format  addr_hi  width  height ...
[ 0]:      8h      81h   3840    2160
[ 1]:      0h       0h      0       0
[ 2]:      0h       0h      0       0
[ 3]:      0h       0h      0       0
[ 4]:      0h       0h      0       0
...
MPCC:  OPP  DPP ...
[ 0]:   0h   0h ...”h]”hX  HUBP:  format  addr_hi  width  height ...
[ 0]:      8h      81h   3840    2160
[ 1]:      0h       0h      0       0
[ 2]:      0h       0h      0       0
[ 3]:      0h       0h      0       0
[ 4]:      0h       0h      0       0
...
MPCC:  OPP  DPP ...
[ 0]:   0h   0h ...”…””}”hj}  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1j{  h³hÃh´K–hjÕ  h²hubhÚ)”}”(hX†  The first thing to notice from the diagram and DTN log it is the fact that we
have different clock domains for each part of the DCN blocks. In this example,
we have just a single **pipeline** where the data flows from DCHUB to DIO, as
we intuitively expect. Nonetheless, DCN is flexible, as mentioned before, and
we can split this single pipe differently, as described in the below diagram:”h]”(hŒ³The first thing to notice from the diagram and DTN log it is the fact that we
have different clock domains for each part of the DCN blocks. In this example,
we have just a single ”…””}”(hj  h²hh³Nh´Nubj/  )”}”(hŒ**pipeline**”h]”hŒpipeline”…””}”(hj•  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j.  hj  ubhŒÇ where the data flows from DCHUB to DIO, as
we intuitively expect. Nonetheless, DCN is flexible, as mentioned before, and
we can split this single pipe differently, as described in the below diagram:”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K hjÕ  h²hubhë)”}”(hhh]”hð)”}”(hhh]”hõ)”}”(hŒ).. kernel-figure:: pipeline_4k_split.svg
”h]”h}”(h]”h ]”h"]”h$]”h&]”Œuri”Œ(gpu/amdgpu/display/pipeline_4k_split.svg”j  }”j  j¾  suh1hôhj°  h³hÃh´K ubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhj­  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hêhjÕ  h²hh³hÃh´K§ubhÚ)”}”(hŒJNow, if we inspect the DTN log again we can see some interesting changes::”h]”hŒINow, if we inspect the DTN log again we can see some interesting changes:”…””}”(hjÌ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K¨hjÕ  h²hubj|  )”}”(hŒëHUBP:  format  addr_hi  width  height ...
[ 0]:      8h      81h   1920    2160 ...
...
[ 4]:      0h       0h      0       0 ...
[ 5]:      8h      81h   1920    2160 ...
...
MPCC:  OPP  DPP ...
[ 0]:   0h   0h ...
[ 5]:   0h   5h ...”h]”hŒëHUBP:  format  addr_hi  width  height ...
[ 0]:      8h      81h   1920    2160 ...
...
[ 4]:      0h       0h      0       0 ...
[ 5]:      8h      81h   1920    2160 ...
...
MPCC:  OPP  DPP ...
[ 0]:   0h   0h ...
[ 5]:   0h   5h ...”…””}”hjÚ  sbah}”(h]”h ]”h"]”h$]”h&]”j‹  jŒ  uh1j{  h³hÃh´KªhjÕ  h²hubhÚ)”}”(hX  From the above example, we now split the display pipeline into two vertical
parts of 1920x2160 (i.e., 3440x2160), and as a result, we could reduce the
clock frequency in the DPP part. This is not only useful for saving power but
also to better handle the required throughput. The idea to keep in mind here is
that the pipe configuration can vary a lot according to the display
configuration, and it is the DML's responsibility to set up all required
configuration parameters for multiple scenarios supported by our hardware.”h]”hX  From the above example, we now split the display pipeline into two vertical
parts of 1920x2160 (i.e., 3440x2160), and as a result, we could reduce the
clock frequency in the DPP part. This is not only useful for saving power but
also to better handle the required throughput. The idea to keep in mind here is
that the pipe configuration can vary a lot according to the display
configuration, and it is the DMLâ€™s responsibility to set up all required
configuration parameters for multiple scenarios supported by our hardware.”…””}”(hjè  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K´hjÕ  h²hubeh}”(h]”Œamd-hardware-pipeline”ah ]”h"]”Œamd hardware pipeline”ah$]”h&]”uh1hÄhhÆh²hh³hÃh´K‚ubhÅ)”}”(hhh]”(hÊ)”}”(hŒGlobal Sync”h]”hŒGlobal Sync”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhjþ  h²hh³hÃh´K½ubhÚ)”}”(hŒçMany DCN registers are double buffered, most importantly the surface address.
This allows us to update DCN hardware atomically for page flips, as well as
for most other updates that don't require enabling or disabling of new pipes.”h]”hŒéMany DCN registers are double buffered, most importantly the surface address.
This allows us to update DCN hardware atomically for page flips, as well as
for most other updates that donâ€™t require enabling or disabling of new pipes.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´K¿hjþ  h²hubhÚ)”}”(hŒ¨(Note: There are many scenarios when DC will decide to reserve extra pipes
in order to support outputs that need a very high pixel clock, or for
power saving purposes.)”h]”hŒ¨(Note: There are many scenarios when DC will decide to reserve extra pipes
in order to support outputs that need a very high pixel clock, or for
power saving purposes.)”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KÃhjþ  h²hubhÚ)”}”(hŒøThese atomic register updates are driven by global sync signals in DCN. In
order to understand how atomic updates interact with DCN hardware, and how DCN
signals page flip and vblank events it is helpful to understand how global sync
is programmed.”h]”hŒøThese atomic register updates are driven by global sync signals in DCN. In
order to understand how atomic updates interact with DCN hardware, and how DCN
signals page flip and vblank events it is helpful to understand how global sync
is programmed.”…””}”(hj+  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KÇhjþ  h²hubhÚ)”}”(hXº  Global sync consists of three signals, VSTARTUP, VUPDATE, and VREADY. These are
calculated by the Display Mode Library - DML (drivers/gpu/drm/amd/display/dc/dml)
based on a large number of parameters and ensure our hardware is able to feed
the DCN pipeline without underflows or hangs in any given system configuration.
The global sync signals always happen during VBlank, are independent from the
VSync signal, and do not overlap each other.”h]”hXº  Global sync consists of three signals, VSTARTUP, VUPDATE, and VREADY. These are
calculated by the Display Mode Library - DML (drivers/gpu/drm/amd/display/dc/dml)
based on a large number of parameters and ensure our hardware is able to feed
the DCN pipeline without underflows or hangs in any given system configuration.
The global sync signals always happen during VBlank, are independent from the
VSync signal, and do not overlap each other.”…””}”(hj9  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KÌhjþ  h²hubhÚ)”}”(hX{  VUPDATE is the only signal that is of interest to the rest of the driver stack
or userspace clients as it signals the point at which hardware latches to
atomically programmed (i.e. double buffered) registers. Even though it is
independent of the VSync signal we use VUPDATE to signal the VSync event as it
provides the best indication of how atomic commits and hardware interact.”h]”hX{  VUPDATE is the only signal that is of interest to the rest of the driver stack
or userspace clients as it signals the point at which hardware latches to
atomically programmed (i.e. double buffered) registers. Even though it is
independent of the VSync signal we use VUPDATE to signal the VSync event as it
provides the best indication of how atomic commits and hardware interact.”…””}”(hjG  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KÓhjþ  h²hubhÚ)”}”(hŒrSince DCN hardware is double-buffered the DC driver is able to program the
hardware at any point during the frame.”h]”hŒrSince DCN hardware is double-buffered the DC driver is able to program the
hardware at any point during the frame.”…””}”(hjU  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KÙhjþ  h²hubhÚ)”}”(hŒ6The below picture illustrates the global sync signals:”h]”hŒ6The below picture illustrates the global sync signals:”…””}”(hjc  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´KÜhjþ  h²hubhë)”}”(hhh]”hð)”}”(hhh]”hõ)”}”(hŒ*.. kernel-figure:: global_sync_vblank.svg
”h]”h}”(h]”h ]”h"]”h$]”h&]”Œuri”Œ)gpu/amdgpu/display/global_sync_vblank.svg”j  }”j  j‚  suh1hôhjt  h³hÃh´K ubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhjq  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hêhjþ  h²hh³hÃh´KßubhÚ)”}”(hŒ•These signals affect core DCN behavior. Programming them incorrectly will lead
to a number of negative consequences, most of them quite catastrophic.”h]”hŒ•These signals affect core DCN behavior. Programming them incorrectly will lead
to a number of negative consequences, most of them quite catastrophic.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Kàhjþ  h²hubhÚ)”}”(hŒñThe following picture shows how global sync allows for a mailbox style of
updates, i.e. it allows for multiple re-configurations between VUpdate
events where only the last configuration programmed before the VUpdate signal
becomes effective.”h]”hŒñThe following picture shows how global sync allows for a mailbox style of
updates, i.e. it allows for multiple re-configurations between VUpdate
events where only the last configuration programmed before the VUpdate signal
becomes effective.”…””}”(hjž  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÙh³hÃh´Kãhjþ  h²hubhë)”}”(hhh]”hð)”}”(hhh]”hõ)”}”(hŒ%.. kernel-figure:: config_example.svg”h]”h}”(h]”h ]”h"]”h$]”h&]”Œuri”Œ%gpu/amdgpu/display/config_example.svg”j  }”j  j½  suh1hôhj¯  h³hÃh´K ubah}”(h]”h ]”h"]”h$]”h&]”uh1hïhj¬  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hêhjþ  h²hh³hÃh´Kèubeh}”(h]”Œglobal-sync”ah ]”h"]”Œglobal sync”ah$]”h&]”uh1hÄhhÆh²hh³hÃh´K½ubeh}”(h]”(Œdisplay-core-next-dcn”hÂeh ]”h"]”(Œdisplay core next (dcn)”Œdcn_overview”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Õ  j  jŒ  jÒ  jÏ  jû  jø  jÐ  jÍ  uŒ	nametypes”}”(jÙ  ˆjØ  ‰j  ‰jÒ  ‰jû  ‰jÐ  ‰uh}”(hÂhÆjÕ  hÆjŒ  j  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”]”hŒsystem_message”“”)”}”(hhh]”hÚ)”}”(hhh]”hŒ2Hyperlink target "dcn-overview" is not referenced.”…””}”hjm  sbah}”(h]”h ]”h"]”h$]”h&]”uh1hÙhjj  ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”hÃŒline”Kuh1jh  ubaŒtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.