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/driver-api/wbrfmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/zh_TW/driver-api/wbrfmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/it_IT/driver-api/wbrfmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ja_JP/driver-api/wbrfmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ko_KR/driver-api/wbrfmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/pt_BR/driver-api/wbrfmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/sp_SP/driver-api/wbrfmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h)SPDX-License-Identifier: GPL-2.0-or-laterh]h)SPDX-License-Identifier: GPL-2.0-or-later}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh=/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf.rsthKubhsection)}(hhh](htitle)}(h WBRF - Wifi Band RFI Mitigationsh]h WBRF - Wifi Band RFI Mitigations}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hDue to electrical and mechanical constraints in certain platform designs there may be likely interference of relatively high-powered harmonics of the GPU memory clocks with local radio module frequency bands used by certain Wifi bands.h]hDue to electrical and mechanical constraints in certain platform designs there may be likely interference of relatively high-powered harmonics of the GPU memory clocks with local radio module frequency bands used by certain Wifi bands.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hTo mitigate possible RFI interference producers can advertise the frequencies in use and consumers can use this information to avoid using these frequencies for sensitive features.h]hTo mitigate possible RFI interference producers can advertise the frequencies in use and consumers can use this information to avoid using these frequencies for sensitive features.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hXnWhen a platform is known to have this issue with any contained devices, the platform designer will advertise the availability of this feature via ACPI devices with a device specific method (_DSM). * Producers with this _DSM will be able to advertise the frequencies in use. * Consumers with this _DSM will be able to register for notifications of frequencies in use.h]hXnWhen a platform is known to have this issue with any contained devices, the platform designer will advertise the availability of this feature via ACPI devices with a device specific method (_DSM). * Producers with this _DSM will be able to advertise the frequencies in use. * Consumers with this _DSM will be able to register for notifications of frequencies in use.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(hSome general termsh]hSome general terms}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKubh)}(hProducer: such component who can produce high-powered radio frequency Consumer: such component who can adjust its in-use frequency in response to the radio frequencies of other components to mitigate the possible RFI.h]hProducer: such component who can produce high-powered radio frequency Consumer: such component who can adjust its in-use frequency in response to the radio frequencies of other components to mitigate the possible RFI.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(hTo make the mechanism function, those producers should notify active use of their particular frequencies so that other consumers can make relative internal adjustments as necessary to avoid this resonance.h]hTo make the mechanism function, those producers should notify active use of their particular frequencies so that other consumers can make relative internal adjustments as necessary to avoid this resonance.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubeh}(h]some-general-termsah ]h"]some general termsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hACPI interfaceh]hACPI interface}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hhhhhK$ubh)}(hAlthough initially used by for wifi + dGPU use cases, the ACPI interface can be scaled to any type of device that a platform designer discovers can cause interference.h]hAlthough initially used by for wifi + dGPU use cases, the ACPI interface can be scaled to any type of device that a platform designer discovers can cause interference.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK&hj>hhubh)}(hCThe GUID used for the _DSM is 7B7656CF-DC3D-4C1C-83E9-66E721DE3070.h]hCThe GUID used for the _DSM is 7B7656CF-DC3D-4C1C-83E9-66E721DE3070.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK*hj>hhubh)}(h'3 functions are available in this _DSM:h]h'3 functions are available in this _DSM:}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK,hj>hhubh bullet_list)}(hhh](h list_item)}(h$0: discover # of functions availableh]h)}(hjh]h$0: discover # of functions available}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hjubah}(h]h ]h"]h$]h&]uh1j~hj{hhhhhNubj)}(h1: record RF bands in useh]h)}(hjh]h1: record RF bands in use}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjubah}(h]h ]h"]h$]h&]uh1j~hj{hhhhhNubj)}(h2: retrieve RF bands in use h]h)}(h2: retrieve RF bands in useh]h2: retrieve RF bands in use}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjubah}(h]h ]h"]h$]h&]uh1j~hj{hhhhhNubeh}(h]h ]h"]h$]h&]bullet*uh1jyhhhK.hj>hhubeh}(h]acpi-interfaceah ]h"]acpi interfaceah$]h&]uh1hhhhhhhhK$ubh)}(hhh](h)}(hDriver programming interfaceh]hDriver programming interface}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK3ubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](single%acpi_amd_wbrf_add_remove (C function)c.acpi_amd_wbrf_add_removehNtauh1jhjhhhNhNubhdesc)}(hhh](hdesc_signature)}(h`int acpi_amd_wbrf_add_remove (struct device *dev, uint8_t action, struct wbrf_ranges_in_out *in)h]hdesc_signature_line)}(h_int acpi_amd_wbrf_add_remove(struct device *dev, uint8_t action, struct wbrf_ranges_in_out *in)h](hdesc_sig_keyword_type)}(hinth]hint}(hj hhhNhNubah}(h]h ]ktah"]h$]h&]uh1j hjhhh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKyubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhKyubh desc_name)}(hacpi_amd_wbrf_add_removeh]h desc_sig_name)}(hacpi_amd_wbrf_add_removeh]hacpi_amd_wbrf_add_remove}(hj4hhhNhNubah}(h]h ]nah"]h$]h&]uh1j2hj.ubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1j,hjhhhjhKyubhdesc_parameterlist)}(hC(struct device *dev, uint8_t action, struct wbrf_ranges_in_out *in)h](hdesc_parameter)}(hstruct device *devh](hdesc_sig_keyword)}(hstructh]hstruct}(hjYhhhNhNubah}(h]h ]kah"]h$]h&]uh1jWhjSubj)}(h h]h }(hjhhhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjSubh)}(hhh]j3)}(hdeviceh]hdevice}(hjyhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjvubah}(h]h ]h"]h$]h&] refdomaincreftype identifier reftargetj{modnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}jj6sbc.acpi_amd_wbrf_add_removeasbuh1hhjSubj)}(h h]h }(hjhhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjSubhdesc_sig_punctuation)}(hjh]h*}(hjhhhNhNubah}(h]h ]pah"]h$]h&]uh1jhjSubj3)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjSubeh}(h]h ]h"]h$]h&]noemphhhuh1jQhjMubjR)}(huint8_t actionh](h)}(hhh]j3)}(huint8_th]huint8_t}(hjhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]jc.acpi_amd_wbrf_add_removeasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjubj3)}(hactionh]haction}(hjhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjubeh}(h]h ]h"]h$]h&]noemphhhuh1jQhjMubjR)}(hstruct wbrf_ranges_in_out *inh](jX)}(hj[h]hstruct}(hj!hhhNhNubah}(h]h ]jdah"]h$]h&]uh1jWhjubj)}(h h]h }(hj.hhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjubh)}(hhh]j3)}(hwbrf_ranges_in_outh]hwbrf_ranges_in_out}(hj?hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj<ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjAmodnameN classnameNjj)}j]jc.acpi_amd_wbrf_add_removeasbuh1hhjubj)}(h h]h }(hj]hhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj3)}(hinh]hin}(hjxhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjubeh}(h]h ]h"]h$]h&]noemphhhuh1jQhjMubeh}(h]h ]h"]h$]h&]hhuh1jKhjhhhjhKyubeh}(h]h ]h"]h$]h&]hhƌ add_permalinkuh1jsphinx_line_type declaratorhjhhhjhKyubah}(h]jah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhKyhjhhubh desc_content)}(hhh]h)}(h4add or remove the frequency band the device is usingh]h4add or remove the frequency band the device is using}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKyhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKyubeh}(h]h ](jfunctioneh"]h$]h&]domainjobjtypejdesctypejnoindex noindexentrynocontentsentryuh1jhhhjhNhNubh container)}(hX**Parameters** ``struct device *dev`` device pointer ``uint8_t action`` remove or add the frequency band into bios ``struct wbrf_ranges_in_out *in`` input structure containing the frequency band the device is using **Description** Broadcast to other consumers the frequency band the device starts to use. Underneath the surface the information is cached into an internal buffer first. Then a notification is sent to all those registered consumers. So then they can retrieve that buffer to know the latest active frequency bands. Consumers that haven't yet been registered can retrieve the information from the cache when they register. **Return** 0 for success add/remove wifi frequency band. Returns a negative error code for failure.h](h)}(h**Parameters**h]hstrong)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chK}hjubhdefinition_list)}(hhh](hdefinition_list_item)}(h&``struct device *dev`` device pointer h](hterm)}(h``struct device *dev``h]hliteral)}(hjh]hstruct device *dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chK{hjubh definition)}(hhh]h)}(hdevice pointerh]hdevice pointer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK{hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK{hjubj)}(h>``uint8_t action`` remove or add the frequency band into bios h](j)}(h``uint8_t action``h]j)}(hj:h]huint8_t action}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chK|hj4ubj)}(hhh]h)}(h*remove or add the frequency band into biosh]h*remove or add the frequency band into bios}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhjOhK|hjPubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhjOhK|hjubj)}(hd``struct wbrf_ranges_in_out *in`` input structure containing the frequency band the device is using h](j)}(h!``struct wbrf_ranges_in_out *in``h]j)}(hjsh]hstruct wbrf_ranges_in_out *in}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chK}hjmubj)}(hhh]h)}(hAinput structure containing the frequency band the device is usingh]hAinput structure containing the frequency band the device is using}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK}hjubah}(h]h ]h"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]uh1jhjhK}hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubh)}(hXBroadcast to other consumers the frequency band the device starts to use. Underneath the surface the information is cached into an internal buffer first. Then a notification is sent to all those registered consumers. So then they can retrieve that buffer to know the latest active frequency bands. Consumers that haven't yet been registered can retrieve the information from the cache when they register.h]hXBroadcast to other consumers the frequency band the device starts to use. Underneath the surface the information is cached into an internal buffer first. Then a notification is sent to all those registered consumers. So then they can retrieve that buffer to know the latest active frequency bands. Consumers that haven’t yet been registered can retrieve the information from the cache when they register.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chK~hjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubh)}(hX0 for success add/remove wifi frequency band. Returns a negative error code for failure.h]hX0 for success add/remove wifi frequency band. Returns a negative error code for failure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j-acpi_amd_wbrf_supported_producer (C function)"c.acpi_amd_wbrf_supported_producerhNtauh1jhjhhhNhNubj)}(hhh](j)}(h:bool acpi_amd_wbrf_supported_producer (struct device *dev)h]j)}(h9bool acpi_amd_wbrf_supported_producer(struct device *dev)h](j )}(hboolh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1j hjhhh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKubj)}(h h]h }(hj)hhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjhhhj(hKubj-)}(h acpi_amd_wbrf_supported_producerh]j3)}(h acpi_amd_wbrf_supported_producerh]h acpi_amd_wbrf_supported_producer}(hj;hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj7ubah}(h]h ](jFjGeh"]h$]h&]hhuh1j,hjhhhj(hKubjL)}(h(struct device *dev)h]jR)}(hstruct device *devh](jX)}(hj[h]hstruct}(hjWhhhNhNubah}(h]h ]jdah"]h$]h&]uh1jWhjSubj)}(h h]h }(hjdhhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjSubh)}(hhh]j3)}(hdeviceh]hdevice}(hjuhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjrubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjwmodnameN classnameNjj)}j]j)}jj=sb"c.acpi_amd_wbrf_supported_producerasbuh1hhjSubj)}(h h]h }(hjhhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjSubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubj3)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjSubeh}(h]h ]h"]h$]h&]noemphhhuh1jQhjOubah}(h]h ]h"]h$]h&]hhuh1jKhjhhhj(hKubeh}(h]h ]h"]h$]h&]hhjuh1jjjhjhhhj(hKubah}(h]j ah ](jjeh"]h$]h&]jj)jhuh1jhj(hKhjhhubj)}(hhh]h)}(hAdetermine if the WBRF can be enabled for the device as a producerh]hAdetermine if the WBRF can be enabled for the device as a producer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhj(hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct device *dev`` device pointer **Description** Check if the platform equipped with necessary implementations to support WBRF for the device as a producer. **Return** true if WBRF is supported, otherwise returns falseh](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubj)}(hhh]j)}(h&``struct device *dev`` device pointer h](j)}(h``struct device *dev``h]j)}(hjh]hstruct device *dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubj)}(hhh]h)}(hdevice pointerh]hdevice pointer}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hKhj1ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj0hKhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjVh]h Description}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubh)}(hkCheck if the platform equipped with necessary implementations to support WBRF for the device as a producer.h]hkCheck if the platform equipped with necessary implementations to support WBRF for the device as a producer.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubh)}(h **Return**h]j)}(hj}h]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubh)}(h2true if WBRF is supported, otherwise returns falseh]h2true if WBRF is supported, otherwise returns false}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j-acpi_amd_wbrf_supported_consumer (C function)"c.acpi_amd_wbrf_supported_consumerhNtauh1jhjhhhNhNubj)}(hhh](j)}(h:bool acpi_amd_wbrf_supported_consumer (struct device *dev)h]j)}(h9bool acpi_amd_wbrf_supported_consumer(struct device *dev)h](j )}(hjh]hbool}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1j hjhhh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKubj)}(h h]h }(hjhhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjhhhjhKubj-)}(h acpi_amd_wbrf_supported_consumerh]j3)}(h acpi_amd_wbrf_supported_consumerh]h acpi_amd_wbrf_supported_consumer}(hjhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjubah}(h]h ](jFjGeh"]h$]h&]hhuh1j,hjhhhjhKubjL)}(h(struct device *dev)h]jR)}(hstruct device *devh](jX)}(hj[h]hstruct}(hjhhhNhNubah}(h]h ]jdah"]h$]h&]uh1jWhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjubh)}(hhh]j3)}(hdeviceh]hdevice}(hjhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsb"c.acpi_amd_wbrf_supported_consumerasbuh1hhjubj)}(h h]h }(hj<hhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj3)}(hdevh]hdev}(hjWhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjubeh}(h]h ]h"]h$]h&]noemphhhuh1jQhjubah}(h]h ]h"]h$]h&]hhuh1jKhjhhhjhKubeh}(h]h ]h"]h$]h&]hhjuh1jjjhjhhhjhKubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jhjhKhjhhubj)}(hhh]h)}(hAdetermine if the WBRF can be enabled for the device as a consumerh]hAdetermine if the WBRF can be enabled for the device as a consumer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhj~hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jhhhjhNhNubj)}(h**Parameters** ``struct device *dev`` device pointer **Description** Determine if the platform equipped with necessary implementations to support WBRF for the device as a consumer. **Return** true if WBRF is supported, otherwise returns false.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubj)}(hhh]j)}(h&``struct device *dev`` device pointer h](j)}(h``struct device *dev``h]j)}(hjh]hstruct device *dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubj)}(hhh]h)}(hdevice pointerh]hdevice pointer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubh)}(hoDetermine if the platform equipped with necessary implementations to support WBRF for the device as a consumer.h]hoDetermine if the platform equipped with necessary implementations to support WBRF for the device as a consumer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubh)}(h **Return**h]j)}(hj$h]hReturn}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubh)}(h3true if WBRF is supported, otherwise returns false.h]h3true if WBRF is supported, otherwise returns false.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j(amd_wbrf_retrieve_freq_band (C function)c.amd_wbrf_retrieve_freq_bandhNtauh1jhjhhhNhNubj)}(hhh](j)}(hTint amd_wbrf_retrieve_freq_band (struct device *dev, struct wbrf_ranges_in_out *out)h]j)}(hSint amd_wbrf_retrieve_freq_band(struct device *dev, struct wbrf_ranges_in_out *out)h](j )}(hinth]hint}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1j hjehhh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKubj)}(h h]h }(hjxhhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjehhhjwhKubj-)}(hamd_wbrf_retrieve_freq_bandh]j3)}(hamd_wbrf_retrieve_freq_bandh]hamd_wbrf_retrieve_freq_band}(hjhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjubah}(h]h ](jFjGeh"]h$]h&]hhuh1j,hjehhhjwhKubjL)}(h4(struct device *dev, struct wbrf_ranges_in_out *out)h](jR)}(hstruct device *devh](jX)}(hj[h]hstruct}(hjhhhNhNubah}(h]h ]jdah"]h$]h&]uh1jWhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjubh)}(hhh]j3)}(hdeviceh]hdevice}(hjhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.amd_wbrf_retrieve_freq_bandasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj3)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hjubeh}(h]h ]h"]h$]h&]noemphhhuh1jQhjubjR)}(hstruct wbrf_ranges_in_out *outh](jX)}(hj[h]hstruct}(hj hhhNhNubah}(h]h ]jdah"]h$]h&]uh1jWhj ubj)}(h h]h }(hj% hhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhj ubh)}(hhh]j3)}(hwbrf_ranges_in_outh]hwbrf_ranges_in_out}(hj6 hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj3 ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj8 modnameN classnameNjj)}j]jc.amd_wbrf_retrieve_freq_bandasbuh1hhj ubj)}(h h]h }(hjT hhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhj ubj)}(hjh]h*}(hjb hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj3)}(houth]hout}(hjo hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jQhjubeh}(h]h ]h"]h$]h&]hhuh1jKhjehhhjwhKubeh}(h]h ]h"]h$]h&]hhjuh1jjjhjahhhjwhKubah}(h]j\ah ](jjeh"]h$]h&]jj)jhuh1jhjwhKhj^hhubj)}(hhh]h)}(h'retrieve current active frequency bandsh]h'retrieve current active frequency bands}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhj hhubah}(h]h ]h"]h$]h&]uh1jhj^hhhjwhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1jhhhjhNhNubj)}(hX**Parameters** ``struct device *dev`` device pointer ``struct wbrf_ranges_in_out *out`` output structure containing all the active frequency bands **Description** Retrieve the current active frequency bands which were broadcasted by other producers. The consumer who calls this API should take proper actions if any of the frequency band may cause RFI with its own frequency band used. **Return** 0 for getting wifi freq band successfully. Returns a negative error code for failure.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhj ubj)}(hhh](j)}(h&``struct device *dev`` device pointer h](j)}(h``struct device *dev``h]j)}(hj h]hstruct device *dev}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhj ubj)}(hhh]h)}(hdevice pointerh]hdevice pointer}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhj ubj)}(h^``struct wbrf_ranges_in_out *out`` output structure containing all the active frequency bands h](j)}(h"``struct wbrf_ranges_in_out *out``h]j)}(hj h]hstruct wbrf_ranges_in_out *out}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhj ubj)}(hhh]h)}(h:output structure containing all the active frequency bandsh]h:output structure containing all the active frequency bands}(hj, hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj( hKhj) ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj( hKhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hjN h]h Description}(hjP hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjL ubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhj ubh)}(hRetrieve the current active frequency bands which were broadcasted by other producers. The consumer who calls this API should take proper actions if any of the frequency band may cause RFI with its own frequency band used.h]hRetrieve the current active frequency bands which were broadcasted by other producers. The consumer who calls this API should take proper actions if any of the frequency band may cause RFI with its own frequency band used.}(hjd hhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhj ubh)}(h **Return**h]j)}(hju h]hReturn}(hjw hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjs ubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhj ubh)}(hU0 for getting wifi freq band successfully. Returns a negative error code for failure.h]hU0 for getting wifi freq band successfully. Returns a negative error code for failure.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chKhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'amd_wbrf_register_notifier (C function)c.amd_wbrf_register_notifierhNtauh1jhjhhhNhNubj)}(hhh](j)}(h:int amd_wbrf_register_notifier (struct notifier_block *nb)h]j)}(h9int amd_wbrf_register_notifier(struct notifier_block *nb)h](j )}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1j hj hhh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chMubj)}(h h]h }(hj hhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhj hhhj hMubj-)}(hamd_wbrf_register_notifierh]j3)}(hamd_wbrf_register_notifierh]hamd_wbrf_register_notifier}(hj hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj ubah}(h]h ](jFjGeh"]h$]h&]hhuh1j,hj hhhj hMubjL)}(h(struct notifier_block *nb)h]jR)}(hstruct notifier_block *nbh](jX)}(hj[h]hstruct}(hj hhhNhNubah}(h]h ]jdah"]h$]h&]uh1jWhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhj ubh)}(hhh]j3)}(hnotifier_blockh]hnotifier_block}(hj hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]j)}jj sbc.amd_wbrf_register_notifierasbuh1hhj ubj)}(h h]h }(hj5 hhhNhNubah}(h]h ]j(ah"]h$]h&]uh1jhj ubj)}(hjh]h*}(hjC hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj3)}(hnbh]hnb}(hjP hhhNhNubah}(h]h ]j?ah"]h$]h&]uh1j2hj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jQhj ubah}(h]h ]h"]h$]h&]hhuh1jKhj hhhj hMubeh}(h]h ]h"]h$]h&]hhjuh1jjjhj hhhj hMubah}(h]j ah ](jjeh"]h$]h&]jj)jhuh1jhj hMhj hhubj)}(hhh]h)}(h3register for notifications of frequency band updateh]h3register for notifications of frequency band update}(hjz hhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chMhjw hhubah}(h]h ]h"]h$]h&]uh1jhj hhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1jhhhjhNhNubj)}(hXB**Parameters** ``struct notifier_block *nb`` driver notifier block **Description** The consumer should register itself via this API so that it can get notified on the frequency band updates from other producers. **Return** 0 for registering a consumer driver successfully. Returns a negative error code for failure.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chMhj ubj)}(hhh]j)}(h4``struct notifier_block *nb`` driver notifier block h](j)}(h``struct notifier_block *nb``h]j)}(hj h]hstruct notifier_block *nb}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chMhj ubj)}(hhh]h)}(hdriver notifier blockh]hdriver notifier block}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chMhj ubh)}(hThe consumer should register itself via this API so that it can get notified on the frequency band updates from other producers.h]hThe consumer should register itself via this API so that it can get notified on the frequency band updates from other producers.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chMhj ubh)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chMhj ubh)}(h\0 for registering a consumer driver successfully. Returns a negative error code for failure.h]h\0 for registering a consumer driver successfully. Returns a negative error code for failure.}(hj3 hhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j)amd_wbrf_unregister_notifier (C function)c.amd_wbrf_unregister_notifierhNtauh1jhjhhhNhNubj)}(hhh](j)}(h ubj)}(hhh]j)}(h4``struct notifier_block *nb`` driver notifier block h](j)}(h``struct notifier_block *nb``h]j)}(hjc h]hstruct notifier_block *nb}(hje hhhNhNubah}(h]h ]h"]h$]h&]uh1jhja ubah}(h]h ]h"]h$]h&]uh1jh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chM)hj] ubj)}(hhh]h)}(hdriver notifier blockh]hdriver notifier block}(hj| hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjx hM)hjy ubah}(h]h ]h"]h$]h&]uh1jhj] ubeh}(h]h ]h"]h$]h&]uh1jhjx hM)hjZ ubah}(h]h ]h"]h$]h&]uh1jhj> ubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chM+hj> ubh)}(hThe consumer should call this API when it is longer interested with the frequency band updates from other producers. Usually, this should be performed during driver cleanup.h]hThe consumer should call this API when it is longer interested with the frequency band updates from other producers. Usually, this should be performed during driver cleanup.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chM*hj> ubh)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chM.hj> ubh)}(hQ0 for unregistering a consumer driver. Returns a negative error code for failure.h]hQ0 for unregistering a consumer driver. Returns a negative error code for failure.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh_/var/lib/git/docbuild/linux/Documentation/driver-api/wbrf:53: ./drivers/platform/x86/amd/wbrf.chM/hj> ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhNhNubeh}(h]driver-programming-interfaceah ]h"]driver programming interfaceah$]h&]uh1hhhhhhhhK3ubh)}(hhh](h)}(h Sample Usageh]h Sample Usage}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhK8ubh)}(hXThe expected flow for the producers: 1. During probe, call `acpi_amd_wbrf_supported_producer` to check if WBRF can be enabled for the device. 2. On using some frequency band, call `acpi_amd_wbrf_add_remove` with 'add' param to get other consumers properly notified. 3. Or on stopping using some frequency band, call `acpi_amd_wbrf_add_remove` with 'remove' param to get other consumers notified.h](h;The expected flow for the producers: 1. During probe, call }(hj hhhNhNubhtitle_reference)}(h"`acpi_amd_wbrf_supported_producer`h]h acpi_amd_wbrf_supported_producer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhW to check if WBRF can be enabled for the device. 2. On using some frequency band, call }(hj hhhNhNubj)}(h`acpi_amd_wbrf_add_remove`h]hacpi_amd_wbrf_add_remove}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhr with ‘add’ param to get other consumers properly notified. 3. Or on stopping using some frequency band, call }(hj hhhNhNubj)}(h`acpi_amd_wbrf_add_remove`h]hacpi_amd_wbrf_add_remove}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh9 with ‘remove’ param to get other consumers notified.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK:hj hhubh)}(hXThe expected flow for the consumers: 1. During probe, call `acpi_amd_wbrf_supported_consumer` to check if WBRF can be enabled for the device. 2. Call `amd_wbrf_register_notifier` to register for notification of frequency band change(add or remove) from other producers. 3. Call the `amd_wbrf_retrieve_freq_band` initially to retrieve current active frequency bands considering some producers may broadcast such information before the consumer is up. 4. On receiving a notification for frequency band change, run `amd_wbrf_retrieve_freq_band` again to retrieve the latest active frequency bands. 5. During driver cleanup, call `amd_wbrf_unregister_notifier` to unregister the notifier.h](h;The expected flow for the consumers: 1. During probe, call }(hjPhhhNhNubj)}(h"`acpi_amd_wbrf_supported_consumer`h]h acpi_amd_wbrf_supported_consumer}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubh9 to check if WBRF can be enabled for the device. 2. Call }(hjPhhhNhNubj)}(h`amd_wbrf_register_notifier`h]hamd_wbrf_register_notifier}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubhh to register for notification of frequency band change(add or remove) from other producers. 3. Call the }(hjPhhhNhNubj)}(h`amd_wbrf_retrieve_freq_band`h]hamd_wbrf_retrieve_freq_band}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubh initially to retrieve current active frequency bands considering some producers may broadcast such information before the consumer is up. 4. On receiving a notification for frequency band change, run }(hjPhhhNhNubj)}(h`amd_wbrf_retrieve_freq_band`h]hamd_wbrf_retrieve_freq_band}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubhU again to retrieve the latest active frequency bands. 5. During driver cleanup, call }(hjPhhhNhNubj)}(h`amd_wbrf_unregister_notifier`h]hamd_wbrf_unregister_notifier}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubh to unregister the notifier.}(hjPhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKBhj hhubeh}(h] sample-usageah ]h"] sample usageah$]h&]uh1hhhhhhhhK8ubeh}(h]wbrf-wifi-band-rfi-mitigationsah ]h"] wbrf - wifi band rfi mitigationsah$]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_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _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}nameids}(jjj;j8jjj j jju nametypes}(jj;jj juh}(jhj8j jj>j jjjj jjjj\jaj j jU jZ jj 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] transformerN include_log] decorationNhhub.