sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget'/translations/zh_CN/gpu/amdgpu/flashingmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/zh_TW/gpu/amdgpu/flashingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/it_IT/gpu/amdgpu/flashingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/ja_JP/gpu/amdgpu/flashingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/ko_KR/gpu/amdgpu/flashingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/pt_BR/gpu/amdgpu/flashingmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/sp_SP/gpu/amdgpu/flashingmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(hdGPU firmware flashingh]hdGPU firmware flashing}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhA/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing.rsthKubh)}(hhh](h)}(hIFWIh]hIFWI}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hFlashing the dGPU integrated firmware image (IFWI) is supported by GPUs that use the PSP to orchestrate the update (Navi3x or newer GPUs). For supported GPUs, `amdgpu` will export a series of sysfs files that can be used for the flash process.h](hFlashing the dGPU integrated firmware image (IFWI) is supported by GPUs that use the PSP to orchestrate the update (Navi3x or newer GPUs). For supported GPUs, }(hhhhhNhNubhtitle_reference)}(h`amdgpu`h]hamdgpu}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhubhL will export a series of sysfs files that can be used for the flash process.}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hThe IFWI flash process is:h]hThe IFWI flash process is:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubhenumerated_list)}(hhh](h list_item)}(h=Ensure the IFWI image is intended for the dGPU on the system.h]h)}(hjh]h=Ensure the IFWI image is intended for the dGPU on the system.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h["Write" the IFWI image to the sysfs file `psp_vbflash`. This will stage the IFWI in memory.h]h)}(hj.h](h-“Write” the IFWI image to the sysfs file }(hj0hhhNhNubh)}(h `psp_vbflash`h]h psp_vbflash}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0ubh%. This will stage the IFWI in memory.}(hj0hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj,ubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hG"Read" from the `psp_vbflash` sysfs file to initiate the flash process.h]h)}(hjWh](h“Read” from the }(hjYhhhNhNubh)}(h `psp_vbflash`h]h psp_vbflash}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjYubh* sysfs file to initiate the flash process.}(hjYhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjUubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hXPoll the `psp_vbflash_status` sysfs file to determine when the flash process completes. h]h)}(hWPoll the `psp_vbflash_status` sysfs file to determine when the flash process completes.h](h Poll the }(hjhhhNhNubh)}(h`psp_vbflash_status`h]hpsp_vbflash_status}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubh: sysfs file to determine when the flash process completes.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj~ubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1jhhhhhhhKubeh}(h]ifwiah ]h"]ifwiah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h USB-C PD F/Wh]h USB-C PD F/W}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hxOn GPUs that support flashing an updated USB-C PD firmware image, the process is done using the `usbc_pd_fw` sysfs file.h](h`On GPUs that support flashing an updated USB-C PD firmware image, the process is done using the }(hjhhhNhNubh)}(h `usbc_pd_fw`h]h usbc_pd_fw}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubh sysfs file.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh bullet_list)}(hhh](j)}(h;Reading the file will provide the current firmware version.h]h)}(hjh]h;Reading the file will provide the current firmware version.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h{Writing the name of a firmware payload stored in `/lib/firmware/amdgpu` to the sysfs file will initiate the flash process. h]h)}(hzWriting the name of a firmware payload stored in `/lib/firmware/amdgpu` to the sysfs file will initiate the flash process.h](h1Writing the name of a firmware payload stored in }(hj hhhNhNubh)}(h`/lib/firmware/amdgpu`h]h/lib/firmware/amdgpu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ubh3 to the sysfs file will initiate the flash process.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]bullet*uh1jhhhKhjhhubh)}(hThe firmware payload stored in `/lib/firmware/amdgpu` can be named any name as long as it doesn't conflict with other existing binaries that are used by `amdgpu`.h](hThe firmware payload stored in }(hj:hhhNhNubh)}(h`/lib/firmware/amdgpu`h]h/lib/firmware/amdgpu}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:ubhf can be named any name as long as it doesn’t conflict with other existing binaries that are used by }(hj:hhhNhNubh)}(h`amdgpu`h]hamdgpu}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:ubh.}(hj:hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h] usb-c-pd-f-wah ]h"] usb-c pd f/wah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h sysfs filesh]h sysfs files}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjthhhhhK ubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](single(amdgpu_psp_irq_mgr_dispatch (C function)c.amdgpu_psp_irq_mgr_dispatchhNtauh1jhjthhhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chNubhdesc)}(hhh](hdesc_signature)}(h`void amdgpu_psp_irq_mgr_dispatch (struct amdgpu_psp_irq_mgr *mgr, struct amdgpu_iv_entry *entry)h]hdesc_signature_line)}(h_void amdgpu_psp_irq_mgr_dispatch(struct amdgpu_psp_irq_mgr *mgr, struct amdgpu_iv_entry *entry)h](hdesc_sig_keyword_type)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhjhhhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chM ubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhM ubh desc_name)}(hamdgpu_psp_irq_mgr_dispatchh]h desc_sig_name)}(hamdgpu_psp_irq_mgr_dispatchh]hamdgpu_psp_irq_mgr_dispatch}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&] xml:spacepreserveuh1jhjhhhjhM ubhdesc_parameterlist)}(h?(struct amdgpu_psp_irq_mgr *mgr, struct amdgpu_iv_entry *entry)h](hdesc_parameter)}(hstruct amdgpu_psp_irq_mgr *mgrh](hdesc_sig_keyword)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hamdgpu_psp_irq_mgrh]hamdgpu_psp_irq_mgr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomaincreftype identifier reftargetjmodnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j6 ASTIdentifier)}j1jsbc.amdgpu_psp_irq_mgr_dispatchasbuh1hhjubj)}(h h]h }(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubhdesc_sig_punctuation)}(hj9h]h*}(hjShhhNhNubah}(h]h ]pah"]h$]h&]uh1jQhjubj)}(hmgrh]hmgr}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hstruct amdgpu_iv_entry *entryh](j)}(hjh]hstruct}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubh)}(hhh]j)}(hamdgpu_iv_entryh]hamdgpu_iv_entry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj/reftypej1 reftargetjmodnameN classnameNj5j8)}j;]j?c.amdgpu_psp_irq_mgr_dispatchasbuh1hhjvubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubjR)}(hj9h]h*}(hjhhhNhNubah}(h]h ]j]ah"]h$]h&]uh1jQhjvubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhjhhhjhM ubeh}(h]h ]h"]h$]h&]jj add_permalinkuh1jsphinx_line_type declaratorhjhhhjhM ubah}(h]jah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhM hjhhubh desc_content)}(hhh]h)}(h*run the registered handler for a PSP eventh]h*run the registered handler for a PSP event}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chM hjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhM ubeh}(h]h ](j/functioneh"]h$]h&]domainj/objtypejdesctypejnoindex noindexentrynocontentsentryuh1jhhhjthjhNubh container)}(hX,**Parameters** ``struct amdgpu_psp_irq_mgr *mgr`` IRQ manager ``struct amdgpu_iv_entry *entry`` IH entry from the PSP soft ring **Description** Invokes the handler for the entry's event id (or the default handler) in process context. Call from the .process callback for PSP soft ring entries.h](h)}(h**Parameters**h]hstrong)}(hj/h]h Parameters}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1j1hj-ubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMhj)ubhdefinition_list)}(hhh](hdefinition_list_item)}(h/``struct amdgpu_psp_irq_mgr *mgr`` IRQ manager h](hterm)}(h"``struct amdgpu_psp_irq_mgr *mgr``h]hliteral)}(hjVh]hstruct amdgpu_psp_irq_mgr *mgr}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jXhjTubah}(h]h ]h"]h$]h&]uh1jRhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chM hjNubh definition)}(hhh]h)}(h IRQ managerh]h IRQ manager}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmhM hjpubah}(h]h ]h"]h$]h&]uh1jnhjNubeh}(h]h ]h"]h$]h&]uh1jLhjmhM hjIubjM)}(hB``struct amdgpu_iv_entry *entry`` IH entry from the PSP soft ring h](jS)}(h!``struct amdgpu_iv_entry *entry``h]jY)}(hjh]hstruct amdgpu_iv_entry *entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jXhjubah}(h]h ]h"]h$]h&]uh1jRhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chM hjubjo)}(hhh]h)}(hIH entry from the PSP soft ringh]hIH entry from the PSP soft ring}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jnhjubeh}(h]h ]h"]h$]h&]uh1jLhjhM hjIubeh}(h]h ]h"]h$]h&]uh1jGhj)ubh)}(h**Description**h]j2)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hjubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMhj)ubh)}(hInvokes the handler for the entry's event id (or the default handler) in process context. Call from the .process callback for PSP soft ring entries.h]hInvokes the handler for the entry’s event id (or the default handler) in process context. Call from the .process callback for PSP soft ring entries.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chM hj)ubeh}(h]h ] kernelindentah"]h$]h&]uh1j'hjthhhjhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j(amdgpu_psp_irq_mgr_register (C function)c.amdgpu_psp_irq_mgr_registerhNtauh1jhjthhhjhNubj)}(hhh](j)}(hint amdgpu_psp_irq_mgr_register (struct amdgpu_psp_irq_mgr *mgr, const struct amdgpu_psp_irq_handler *handlers, int count, const struct amdgpu_psp_irq_handler *default_handler)h]j)}(hint amdgpu_psp_irq_mgr_register(struct amdgpu_psp_irq_mgr *mgr, const struct amdgpu_psp_irq_handler *handlers, int count, const struct amdgpu_psp_irq_handler *default_handler)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMBubj)}(h h]h }(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj!hMBubj)}(hamdgpu_psp_irq_mgr_registerh]j)}(hamdgpu_psp_irq_mgr_registerh]hamdgpu_psp_irq_mgr_register}(hj4hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhj!hMBubj)}(h(struct amdgpu_psp_irq_mgr *mgr, const struct amdgpu_psp_irq_handler *handlers, int count, const struct amdgpu_psp_irq_handler *default_handler)h](j)}(hstruct amdgpu_psp_irq_mgr *mgrh](j)}(hjh]hstruct}(hjPhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubj)}(h h]h }(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubh)}(hhh]j)}(hamdgpu_psp_irq_mgrh]hamdgpu_psp_irq_mgr}(hjnhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&] refdomainj/reftypej1 reftargetjpmodnameN classnameNj5j8)}j;]j>)}j1j6sbc.amdgpu_psp_irq_mgr_registerasbuh1hhjLubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubjR)}(hj9h]h*}(hjhhhNhNubah}(h]h ]j]ah"]h$]h&]uh1jQhjLubj)}(hmgrh]hmgr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjHubj)}(h-const struct amdgpu_psp_irq_handler *handlersh](j)}(hconsth]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hamdgpu_psp_irq_handlerh]hamdgpu_psp_irq_handler}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj/reftypej1 reftargetjmodnameN classnameNj5j8)}j;]jc.amdgpu_psp_irq_mgr_registerasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjR)}(hj9h]h*}(hj(hhhNhNubah}(h]h ]j]ah"]h$]h&]uh1jQhjubj)}(hhandlersh]hhandlers}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjHubj)}(h int counth](j)}(hinth]hint}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(h h]h }(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(hcounth]hcount}(hjjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjHubj)}(h4const struct amdgpu_psp_irq_handler *default_handlerh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hamdgpu_psp_irq_handlerh]hamdgpu_psp_irq_handler}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj/reftypej1 reftargetjmodnameN classnameNj5j8)}j;]jc.amdgpu_psp_irq_mgr_registerasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjR)}(hj9h]h*}(hjhhhNhNubah}(h]h ]j]ah"]h$]h&]uh1jQhjubj)}(hdefault_handlerh]hdefault_handler}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjHubeh}(h]h ]h"]h$]h&]jjuh1jhjhhhj!hMBubeh}(h]h ]h"]h$]h&]jjjuh1jjjhj hhhj!hMBubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhj!hMBhjhhubj)}(hhh]h)}(h+register PSP interrupt handlers by event idh]h+register PSP interrupt handlers by event id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMBhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhj!hMBubeh}(h]h ](j/functioneh"]h$]h&]j!j/j"j7j#j7j$j%j&uh1jhhhjthjhNubj()}(hX**Parameters** ``struct amdgpu_psp_irq_mgr *mgr`` PSP interrupt manager ``const struct amdgpu_psp_irq_handler *handlers`` per-event handlers, or NULL ``int count`` number of **handlers** ``const struct amdgpu_psp_irq_handler *default_handler`` fallback for unregistered event ids, or NULL **Description** Handlers must be statically allocated and stay valid until psp_irq_mgr_fini(). **Return** 0 on success, negative error from xa_insert (e.g. duplicate event_id).h](h)}(h**Parameters**h]j2)}(hjAh]h Parameters}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j1hj?ubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMFhj;ubjH)}(hhh](jM)}(h9``struct amdgpu_psp_irq_mgr *mgr`` PSP interrupt manager h](jS)}(h"``struct amdgpu_psp_irq_mgr *mgr``h]jY)}(hj`h]hstruct amdgpu_psp_irq_mgr *mgr}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jXhj^ubah}(h]h ]h"]h$]h&]uh1jRhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMChjZubjo)}(hhh]h)}(hPSP interrupt managerh]hPSP interrupt manager}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjuhMChjvubah}(h]h ]h"]h$]h&]uh1jnhjZubeh}(h]h ]h"]h$]h&]uh1jLhjuhMChjWubjM)}(hN``const struct amdgpu_psp_irq_handler *handlers`` per-event handlers, or NULL h](jS)}(h1``const struct amdgpu_psp_irq_handler *handlers``h]jY)}(hjh]h-const struct amdgpu_psp_irq_handler *handlers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jXhjubah}(h]h ]h"]h$]h&]uh1jRhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMDhjubjo)}(hhh]h)}(hper-event handlers, or NULLh]hper-event handlers, or NULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMDhjubah}(h]h ]h"]h$]h&]uh1jnhjubeh}(h]h ]h"]h$]h&]uh1jLhjhMDhjWubjM)}(h%``int count`` number of **handlers** h](jS)}(h ``int count``h]jY)}(hjh]h int count}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jXhjubah}(h]h ]h"]h$]h&]uh1jRhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMEhjubjo)}(hhh]h)}(hnumber of **handlers**h](h number of }(hjhhhNhNubj2)}(h **handlers**h]hhandlers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hjubeh}(h]h ]h"]h$]h&]uh1hhjhMEhjubah}(h]h ]h"]h$]h&]uh1jnhjubeh}(h]h ]h"]h$]h&]uh1jLhjhMEhjWubjM)}(hf``const struct amdgpu_psp_irq_handler *default_handler`` fallback for unregistered event ids, or NULL h](jS)}(h8``const struct amdgpu_psp_irq_handler *default_handler``h]jY)}(hjh]h4const struct amdgpu_psp_irq_handler *default_handler}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jXhjubah}(h]h ]h"]h$]h&]uh1jRhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMFhjubjo)}(hhh]h)}(h,fallback for unregistered event ids, or NULLh]h,fallback for unregistered event ids, or NULL}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hMFhj/ubah}(h]h ]h"]h$]h&]uh1jnhjubeh}(h]h ]h"]h$]h&]uh1jLhj.hMFhjWubeh}(h]h ]h"]h$]h&]uh1jGhj;ubh)}(h**Description**h]j2)}(hjTh]h Description}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1j1hjRubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMHhj;ubh)}(hNHandlers must be statically allocated and stay valid until psp_irq_mgr_fini().h]hNHandlers must be statically allocated and stay valid until psp_irq_mgr_fini().}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMGhj;ubh)}(h **Return**h]j2)}(hj{h]hReturn}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1j1hjyubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMIhj;ubh)}(hF0 on success, negative error from xa_insert (e.g. duplicate event_id).h]hF0 on success, negative error from xa_insert (e.g. duplicate event_id).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMJhj;ubeh}(h]h ] kernelindentah"]h$]h&]uh1j'hjthhhjhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j(parse_psp_v1_bin_descriptor (C function)c.parse_psp_v1_bin_descriptorhNtauh1jhjthhhjhNubj)}(hhh](j)}(hgint parse_psp_v1_bin_descriptor (struct psp_bin_desc *desc, const struct psp_firmware_header_v1_0 *hdr)h]j)}(hfint parse_psp_v1_bin_descriptor(struct psp_bin_desc *desc, const struct psp_firmware_header_v1_0 *hdr)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMTubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMTubj)}(hparse_psp_v1_bin_descriptorh]j)}(hparse_psp_v1_bin_descriptorh]hparse_psp_v1_bin_descriptor}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhjhMTubj)}(hG(struct psp_bin_desc *desc, const struct psp_firmware_header_v1_0 *hdr)h](j)}(hstruct psp_bin_desc *desch](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(h psp_bin_desch]h psp_bin_desc}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainj/reftypej1 reftargetj modnameN classnameNj5j8)}j;]j>)}j1jsbc.parse_psp_v1_bin_descriptorasbuh1hhjubj)}(h h]h }(hj; hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjR)}(hj9h]h*}(hjI hhhNhNubah}(h]h ]j]ah"]h$]h&]uh1jQhjubj)}(hdesch]hdesc}(hjV hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h*const struct psp_firmware_header_v1_0 *hdrh](j)}(hjh]hconst}(hjo hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk ubj)}(h h]h }(hj| hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk ubj)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk ubh)}(hhh]j)}(hpsp_firmware_header_v1_0h]hpsp_firmware_header_v1_0}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainj/reftypej1 reftargetj modnameN classnameNj5j8)}j;]j7 c.parse_psp_v1_bin_descriptorasbuh1hhjk ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk ubjR)}(hj9h]h*}(hj hhhNhNubah}(h]h ]j]ah"]h$]h&]uh1jQhjk ubj)}(hhdrh]hhdr}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjk ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhjhhhjhMTubeh}(h]h ]h"]h$]h&]jjjuh1jjjhjhhhjhMTubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhMThjhhubj)}(hhh]h)}(hdPopulate struct psp_bin_desc from a v1.0 PSP firmware header (standalone images such as ASD or TOC).h]hdPopulate struct psp_bin_desc from a v1.0 PSP firmware header (standalone images such as ASD or TOC).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMThj hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMTubeh}(h]h ](j/functioneh"]h$]h&]j!j/j"j# j#j# j$j%j&uh1jhhhjthjhNubj()}(h}**Parameters** ``struct psp_bin_desc *desc`` *undescribed* ``const struct psp_firmware_header_v1_0 *hdr`` *undescribed*h](h)}(h**Parameters**h]j2)}(hj- h]h Parameters}(hj/ hhhNhNubah}(h]h ]h"]h$]h&]uh1j1hj+ ubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMXhj' ubjH)}(hhh](jM)}(h,``struct psp_bin_desc *desc`` *undescribed* h](jS)}(h``struct psp_bin_desc *desc``h]jY)}(hjL h]hstruct psp_bin_desc *desc}(hjN hhhNhNubah}(h]h ]h"]h$]h&]uh1jXhjJ ubah}(h]h ]h"]h$]h&]uh1jRhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chKhjF ubjo)}(hhh]h)}(h *undescribed*h]hemphasis)}(hjg h]h undescribed}(hjk hhhNhNubah}(h]h ]h"]h$]h&]uh1ji hje ubah}(h]h ]h"]h$]h&]uh1hhja hKhjb ubah}(h]h ]h"]h$]h&]uh1jnhjF ubeh}(h]h ]h"]h$]h&]uh1jLhja hKhjC ubjM)}(h<``const struct psp_firmware_header_v1_0 *hdr`` *undescribed*h](jS)}(h.``const struct psp_firmware_header_v1_0 *hdr``h]jY)}(hj h]h*const struct psp_firmware_header_v1_0 *hdr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jXhj ubah}(h]h ]h"]h$]h&]uh1jRhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chKhj ubjo)}(hhh]h)}(h *undescribed*h]jj )}(hj h]h undescribed}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1ji hj ubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chKhj ubah}(h]h ]h"]h$]h&]uh1jnhj ubeh}(h]h ]h"]h$]h&]uh1jLhj hKhjC ubeh}(h]h ]h"]h$]h&]uh1jGhj' ubeh}(h]h ] kernelindentah"]h$]h&]uh1j'hjthhhjhNubhtarget)}(h.. _usbc_pd_fw:h]h}(h]h ]h"]h$]h&]refid usbc-pd-fwuh1j hKAhjthhhjubh)}(h**usbc_pd_fw**h]j2)}(hj h]h usbc_pd_fw}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j1hj ubah}(h]j ah ]h"] usbc_pd_fwah$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chKhjthhexpect_referenced_by_name}j j sexpect_referenced_by_id}j j subh)}(hyReading from this file will retrieve the USB-C PD firmware version. Writing to this file will trigger the update process.h]hyReading from this file will retrieve the USB-C PD firmware version. Writing to this file will trigger the update process.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chM7hjthhubj )}(h.. _PTL sysfs attributes:h]h}(h]h ]h"]h$]h&]j ptl-sysfs-attributesuh1j hKIhjthhhjubh)}(h**PTL sysfs attributes**h]j2)}(hj! h]hPTL sysfs attributes}(hj# hhhNhNubah}(h]h ]h"]h$]h&]uh1j1hj ubah}(h]j ah ]h"]ptl sysfs attributesah$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chM=hjthhj }j4 j sj }j j subh)}(hThese sysfs files under /sys/class/drm/cardX/device/ptl allow users to enable or disable the Peak Tops Limiter (PTL), configure preferred PTL data formats, and query supported formats for each GPU.h]hThese sysfs files under /sys/class/drm/cardX/device/ptl allow users to enable or disable the Peak Tops Limiter (PTL), configure preferred PTL data formats, and query supported formats for each GPU.}(hj: hhhNhNubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chM?hjthhubj )}(h.. _psp_vbflash:h]h}(h]h ]h"]h$]h&]j psp-vbflashuh1j hKRhjthhhjubh)}(h**psp_vbflash**h]j2)}(hjV h]h psp_vbflash}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1j1hjT ubah}(h]jS ah ]h"] psp_vbflashah$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMFhjthhj }ji jI sj }jS jI subh)}(hkWriting to this file will stage an IFWI for update. Reading from this file will trigger the update process.h]hkWriting to this file will stage an IFWI for update. Reading from this file will trigger the update process.}(hjo hhhNhNubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMhjthhubj )}(h.. _psp_vbflash_status:h]h}(h]h ]h"]h$]h&]j psp-vbflash-statusuh1j hKZhjthhhjubh)}(h**psp_vbflash_status**h]j2)}(hj h]hpsp_vbflash_status}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j1hj ubah}(h]j ah ]h"]psp_vbflash_statusah$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMhjthhj }j j~ sj }j j~ subh)}(hTThe status of the flash process. 0: IFWI flash not complete. 1: IFWI flash complete.h]hTThe status of the flash process. 0: IFWI flash not complete. 1: IFWI flash complete.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhk/var/lib/git/docbuild/linux/Documentation/gpu/amdgpu/flashing:33: ./drivers/gpu/drm/amd/amdgpu/amdgpu_psp.chMhjthhubeh}(h] sysfs-filesah ]h"] sysfs filesah$]h&]uh1hhhhhhhhK ubeh}(h]dgpu-firmware-flashingah ]h"]dgpu firmware flashingah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehʌ _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}(j ]j aj ]j ajS ]jI aj ]j~ aunameids}(j j jjjqjnj j j j j4 j ji jS j j u nametypes}(j jjqj j j4 ji j uh}(j hjhjnjj jtjjjj jjj j j j jS jT j j u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages](hsystem_message)}(hhh]h)}(hhh]h0Hyperlink target "usbc-pd-fw" is not referenced.}hjS sbah}(h]h ]h"]h$]h&]uh1hhjP ubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcejlineKAuh1jN ubjO )}(hhh]h)}(hhh]h:Hyperlink target "ptl-sysfs-attributes" is not referenced.}hjn sbah}(h]h ]h"]h$]h&]uh1hhjk ubah}(h]h ]h"]h$]h&]levelKtypejh sourcejlineKIuh1jN ubjO )}(hhh]h)}(hhh]h1Hyperlink target "psp-vbflash" is not referenced.}hj sbah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]levelKtypejh sourcejlineKRuh1jN ubjO )}(hhh]h)}(hhh]h8Hyperlink target "psp-vbflash-status" is not referenced.}hj sbah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]levelKtypejh sourcejlineKZuh1jN ube transformerN include_log] decorationNhhub.