diff mbox series

[RFC,01/18] dt-bindings: net: wireless: describe the ath12k AHB module

Message ID 20240814094323.3927603-2-quic_rajkbhag@quicinc.com
State New
Headers show
Series wifi: ath12k: add Ath12k AHB driver support for IPQ5332 | expand

Commit Message

Raj Kumar Bhagat Aug. 14, 2024, 9:43 a.m. UTC
Add device-tree bindings for the ATH12K module found in the IPQ5332
device.

Signed-off-by: Raj Kumar Bhagat <quic_rajkbhag@quicinc.com>
---
 .../net/wireless/qcom,ath12k-ahb.yaml         | 325 ++++++++++++++++++
 1 file changed, 325 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/net/wireless/qcom,ath12k-ahb.yaml

Comments

Krzysztof Kozlowski Aug. 16, 2024, 5:42 a.m. UTC | #1
On 14/08/2024 11:43, Raj Kumar Bhagat wrote:
> Add device-tree bindings for the ATH12K module found in the IPQ5332
> device.
> 
> Signed-off-by: Raj Kumar Bhagat <quic_rajkbhag@quicinc.com>

<form letter>
Please use scripts/get_maintainers.pl to get a list of necessary people
and lists to CC. It might happen, that command when run on an older
kernel, gives you outdated entries. Therefore please be sure you base
your patches on recent Linux kernel.

Tools like b4 or scripts/get_maintainer.pl provide you proper list of
people, so fix your workflow. Tools might also fail if you work on some
ancient tree (don't, instead use mainline) or work on fork of kernel
(don't, instead use mainline). Just use b4 and everything should be
fine, although remember about `b4 prep --auto-to-cc` if you added new
patches to the patchset.

You missed at least devicetree list (maybe more), so this won't be
tested by automated tooling. Performing review on untested code might be
a waste of time.

Please kindly resend and include all necessary To/Cc entries.
</form letter>

> ---
>  .../net/wireless/qcom,ath12k-ahb.yaml         | 325 ++++++++++++++++++
>  1 file changed, 325 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/net/wireless/qcom,ath12k-ahb.yaml
> 
> diff --git a/Documentation/devicetree/bindings/net/wireless/qcom,ath12k-ahb.yaml b/Documentation/devicetree/bindings/net/wireless/qcom,ath12k-ahb.yaml
> new file mode 100644
> index 000000000000..8cecc50b6341
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/net/wireless/qcom,ath12k-ahb.yaml
> @@ -0,0 +1,325 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +# Copyright (c) 2024 Qualcomm Innovation Center, Inc. All rights reserved.
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/net/wireless/qcom,ath12k-ahb.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Qualcomm Technologies ath12k wireless devices (AHB)
> +
> +maintainers:
> +  - Kalle Valo <kvalo@kernel.org>
> +  - Jeff Johnson <jjohnson@kernel.org>
> +
> +description:
> +  Qualcomm Technologies IEEE 802.11be AHB devices.
> +
> +properties:
> +  compatible:
> +    enum:
> +      - qcom,ipq5332-wifi
> +
> +  reg:
> +    maxItems: 1
> +
> +  clocks:
> +    minItems: 1
> +    maxItems: 2
> +
> +  clock-names:
> +    minItems: 1
> +    maxItems: 2
> +
> +  interrupts:
> +    minItems: 32
> +    maxItems: 56
> +
> +  interrupt-names:
> +    minItems: 32
> +    maxItems: 56
> +
> +  memory-region:
> +    minItems: 1
> +    description:
> +      phandle to a node describing reserved memory (System RAM memory)
> +      used by ath12k firmware (see bindings/reserved-memory/reserved-memory.txt)
> +
> +  qcom,bdf-addr:
> +    $ref: /schemas/types.yaml#/definitions/uint32
> +    description:
> +      System RAM memory address reserved for board data.
> +
> +  qcom,board_id:
> +    $ref: /schemas/types.yaml#/definitions/uint32
> +    description:
> +      Board id value, it identifies the variant of ath12k WiFi device.

Please do not upstream whatever you have in your vendor tree... You even
copied its style! There is no such property in upstream.

NAK, you are duplicating compatibles.



> +
> +  qcom,rproc:
> +    $ref: /schemas/types.yaml#/definitions/phandle
> +    description:
> +      DT entry of a WCSS node. WCSS node is the child node of q6 remoteproc driver.
> +      (see bindings/remoteproc/qcom,multipd-pil.yaml)
> +
> +required:
> +  - compatible
> +  - reg
> +  - memory-region
> +  - qcom,board_id
> +  - qcom,rproc
> +
> +additionalProperties: false
> +
> +allOf:
> +  - $ref: ieee80211.yaml#
> +  - if:
> +      properties:
> +        compatible:
> +          contains:
> +            enum:
> +              - qcom,ipq5332-wifi

Why? You have only one variant, why this if?
> +    then:
> +      properties:
> +        clocks:
> +          items:
> +            - description: gcc_xo_clk used for copy engine
> +            - description: gcc_im_sleep_clk used for q6.
> +
> +        clock-names:
> +          items:
> +            - const: gcc_xo_clk
> +            - const: gcc_im_sleep_clk
> +
> +        interrupts:
> +          items:
> +            - description: misc-pulse1 interrupt events
> +            - description: misc-latch interrupt events
> +            - description: sw exception interrupt events
> +            - description: interrupt event for ring CE0
> +            - description: interrupt event for ring CE1
> +            - description: interrupt event for ring CE2
> +            - description: interrupt event for ring CE3
> +            - description: interrupt event for ring CE4
> +            - description: interrupt event for ring CE5
> +            - description: interrupt event for ring CE6
> +            - description: interrupt event for ring CE7
> +            - description: interrupt event for ring CE8
> +            - description: interrupt event for ring CE9
> +            - description: interrupt event for ring CE10
> +            - description: interrupt event for ring CE11
> +            - description: interrupt event for ring host2wbm-desc-feed
> +            - description: interrupt event for ring host2reo-re-injection
> +            - description: interrupt event for ring host2reo-command
> +            - description: interrupt event for ring host2rxdma-monitor-ring1
> +            - description: interrupt event for ring reo2ost-exception
> +            - description: interrupt event for ring wbm2host-rx-release
> +            - description: interrupt event for ring reo2host-status
> +            - description: interrupt event for ring reo2host-destination-ring4
> +            - description: interrupt event for ring reo2host-destination-ring3
> +            - description: interrupt event for ring reo2host-destination-ring2
> +            - description: interrupt event for ring reo2host-destination-ring1
> +            - description: interrupt event for ring rxdma2host-monitor-destination-mac3
> +            - description: interrupt event for ring rxdma2host-monitor-destination-mac2
> +            - description: interrupt event for ring rxdma2host-monitor-destination-mac1
> +            - description: interrupt event for ring host2rxdma-host-buf-ring-mac3
> +            - description: interrupt event for ring host2rxdma-host-buf-ring-mac2
> +            - description: interrupt event for ring host2rxdma-host-buf-ring-mac1
> +            - description: interrupt event for ring host2tcl-input-ring4
> +            - description: interrupt event for ring host2tcl-input-ring3
> +            - description: interrupt event for ring host2tcl-input-ring2
> +            - description: interrupt event for ring host2tcl-input-ring1
> +            - description: interrupt event for ring wbm2host-tx-completions-ring4
> +            - description: interrupt event for ring wbm2host-tx-completions-ring3
> +            - description: interrupt event for ring wbm2host-tx-completions-ring2
> +            - description: interrupt event for ring wbm2host-tx-completions-ring1
> +            - description: interrupt event for ring host2tx-monitor-ring1
> +            - description: interrupt event for ring txmon2host-monitor-destination-mac3
> +            - description: interrupt event for ring txmon2host-monitor-destination-mac2
> +            - description: interrupt event for ring txmon2host-monitor-destination-mac1
> +            - description: interrupt event for umac_reset
> +        interrupt-names:
> +          items:
> +            - const: misc-pulse1
> +            - const: misc-latch
> +            - const: sw-exception
> +            - const: ce0
> +            - const: ce1
> +            - const: ce2
> +            - const: ce3
> +            - const: ce4
> +            - const: ce5
> +            - const: ce6
> +            - const: ce7
> +            - const: ce8
> +            - const: ce9
> +            - const: ce10
> +            - const: ce11
> +            - const: host2wbm-desc-feed
> +            - const: host2reo-re-injection
> +            - const: host2reo-command
> +            - const: host2rxdma-monitor-ring1
> +            - const: reo2ost-exception
> +            - const: wbm2host-rx-release
> +            - const: reo2host-status
> +            - const: reo2host-destination-ring4
> +            - const: reo2host-destination-ring3
> +            - const: reo2host-destination-ring2
> +            - const: reo2host-destination-ring1
> +            - const: rxdma2host-monitor-destination-mac3
> +            - const: rxdma2host-monitor-destination-mac2
> +            - const: rxdma2host-monitor-destination-mac1
> +            - const: host2rxdma-host-buf-ring-mac3
> +            - const: host2rxdma-host-buf-ring-mac2
> +            - const: host2rxdma-host-buf-ring-mac1
> +            - const: host2tcl-input-ring4
> +            - const: host2tcl-input-ring3
> +            - const: host2tcl-input-ring2
> +            - const: host2tcl-input-ring1
> +            - const: wbm2host-tx-completions-ring4
> +            - const: wbm2host-tx-completions-ring3
> +            - const: wbm2host-tx-completions-ring2
> +            - const: wbm2host-tx-completions-ring1
> +            - const: host2tx-monitor-ring1
> +            - const: txmon2host-monitor-destination-mac3
> +            - const: txmon2host-monitor-destination-mac2
> +            - const: txmon2host-monitor-destination-mac1
> +            - const: umac_reset
> +
> +  - if:
> +      properties:
> +        compatible:
> +          contains:
> +            enum:
> +              - qcom,ipq5332-wifi
> +    then:
> +      required:
> +        - clocks
> +        - clock-names
> +        - interrupts
> +        - interrupt-names
> +        - qcom,bdf-addr
> +
> +examples:
> +  - |
> +
> +    #include <dt-bindings/interrupt-controller/arm-gic.h>
> +    #include <dt-bindings/clock/qcom,ipq5332-gcc.h>
> +
> +    reserved-memory {
> +        #address-cells = <2>;
> +        #size-cells = <2>;
> +
> +        q6_region: wcnss@4a900000 {
> +            no-map;
> +            reg = <0x0 0x4a900000 0x0 0x02300000>;
> +        };
> +
> +        m3_dump: m3_dump@4cc00000 {
> +            no-map;
> +            reg = <0x0 0x4CC00000 0x0 0x100000>;
> +        };
> +    };

Drop

> +
> +    wifi0: wifi@c0000000 {
> +        compatible = "qcom,ipq5332-wifi";
> +        reg = <0xc000000 0x1000000>;
> +        clocks = <&gcc GCC_XO_CLK>,
> +                 <&gcc GCC_IM_SLEEP_CLK>;
> +        clock-names = "gcc_xo_clk",
> +                      "gcc_im_sleep_clk";
> +        interrupts = <GIC_SPI 559 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 560 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 561 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 422 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 423 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 424 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 425 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 426 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 427 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 428 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 429 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 430 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 431 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 432 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 433 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 491 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 495 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 493 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 544 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 457 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 466 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 497 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 454 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 453 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 452 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 451 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 488 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 488 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 484 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 554 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 554 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 549 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 507 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 500 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 499 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 498 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 450 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 449 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 448 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 447 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 543 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 486 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 486 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 482 IRQ_TYPE_EDGE_RISING>,
> +                     <GIC_SPI 419 IRQ_TYPE_EDGE_RISING>;
> +        interrupt-names = "misc-pulse1",
> +                          "misc-latch",
> +                          "sw-exception",
> +                          "ce0",
> +                          "ce1",
> +                          "ce2",
> +                          "ce3",
> +                          "ce4",
> +                          "ce5",
> +                          "ce6",
> +                          "ce7",
> +                          "ce8",
> +                          "ce9",
> +                          "ce10",
> +                          "ce11",
> +                          "host2wbm-desc-feed",
> +                          "host2reo-re-injection",
> +                          "host2reo-command",
> +                          "host2rxdma-monitor-ring1",
> +                          "reo2ost-exception",
> +                          "wbm2host-rx-release",
> +                          "reo2host-status",
> +                          "reo2host-destination-ring4",
> +                          "reo2host-destination-ring3",
> +                          "reo2host-destination-ring2",
> +                          "reo2host-destination-ring1",
> +                          "rxdma2host-monitor-destination-mac3",
> +                          "rxdma2host-monitor-destination-mac2",
> +                          "rxdma2host-monitor-destination-mac1",
> +                          "host2rxdma-host-buf-ring-mac3",
> +                          "host2rxdma-host-buf-ring-mac2",
> +                          "host2rxdma-host-buf-ring-mac1",
> +                          "host2tcl-input-ring4",
> +                          "host2tcl-input-ring3",
> +                          "host2tcl-input-ring2",
> +                          "host2tcl-input-ring1",
> +                          "wbm2host-tx-completions-ring4",
> +                          "wbm2host-tx-completions-ring3",
> +                          "wbm2host-tx-completions-ring2",
> +                          "wbm2host-tx-completions-ring1",
> +                          "host2tx-monitor-ring1",
> +                          "txmon2host-monitor-destination-mac3",
> +                          "txmon2host-monitor-destination-mac2",
> +                          "txmon2host-monitor-destination-mac1",
> +                          "umac_reset";
> +
> +        memory-region = <&q6_region>;
> +        qcom,bdf-addr = <0x4B500000>;
> +        qcom,board_id = <0x12>;
> +        qcom,rproc = <&q6_wcss_pd1>;
> +        status = "okay";

Drop

> +    };

Best regards,
Krzysztof
Krzysztof Kozlowski Aug. 16, 2024, 5:44 a.m. UTC | #2
On 14/08/2024 11:43, Raj Kumar Bhagat wrote:
> +  qcom,bdf-addr:
> +    $ref: /schemas/types.yaml#/definitions/uint32
> +    description:
> +      System RAM memory address reserved for board data.

Also drop. We do not store RAM offsets in DT.

Best regards,
Krzysztof
Raj Kumar Bhagat Sept. 4, 2024, 7:23 a.m. UTC | #3
On 8/16/2024 11:12 AM, Krzysztof Kozlowski wrote:
> On 14/08/2024 11:43, Raj Kumar Bhagat wrote:
>> Add device-tree bindings for the ATH12K module found in the IPQ5332
>> device.
>>
>> Signed-off-by: Raj Kumar Bhagat <quic_rajkbhag@quicinc.com>
> 
> <form letter>
> Please use scripts/get_maintainers.pl to get a list of necessary people
> and lists to CC. It might happen, that command when run on an older
> kernel, gives you outdated entries. Therefore please be sure you base
> your patches on recent Linux kernel.
> 
> Tools like b4 or scripts/get_maintainer.pl provide you proper list of
> people, so fix your workflow. Tools might also fail if you work on some
> ancient tree (don't, instead use mainline) or work on fork of kernel
> (don't, instead use mainline). Just use b4 and everything should be
> fine, although remember about `b4 prep --auto-to-cc` if you added new
> patches to the patchset.
> 
> You missed at least devicetree list (maybe more), so this won't be
> tested by automated tooling. Performing review on untested code might be
> a waste of time.
> 
> Please kindly resend and include all necessary To/Cc entries.
> </form letter>
> 
Thanks for the information. In next version we will use the script
"scripts/get_maintainers.pl" to get the list.

>> ---
>>  .../net/wireless/qcom,ath12k-ahb.yaml         | 325 ++++++++++++++++++
>>  1 file changed, 325 insertions(+)
>>  create mode 100644 Documentation/devicetree/bindings/net/wireless/qcom,ath12k-ahb.yaml
>>
>> diff --git a/Documentation/devicetree/bindings/net/wireless/qcom,ath12k-ahb.yaml b/Documentation/devicetree/bindings/net/wireless/qcom,ath12k-ahb.yaml
>> new file mode 100644
>> index 000000000000..8cecc50b6341
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/net/wireless/qcom,ath12k-ahb.yaml
>> @@ -0,0 +1,325 @@
>> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
>> +# Copyright (c) 2024 Qualcomm Innovation Center, Inc. All rights reserved.
>> +%YAML 1.2
>> +---
>> +$id: http://devicetree.org/schemas/net/wireless/qcom,ath12k-ahb.yaml#
>> +$schema: http://devicetree.org/meta-schemas/core.yaml#
>> +
>> +title: Qualcomm Technologies ath12k wireless devices (AHB)
>> +
>> +maintainers:
>> +  - Kalle Valo <kvalo@kernel.org>
>> +  - Jeff Johnson <jjohnson@kernel.org>
>> +
>> +description:
>> +  Qualcomm Technologies IEEE 802.11be AHB devices.
>> +
>> +properties:
>> +  compatible:
>> +    enum:
>> +      - qcom,ipq5332-wifi
>> +
>> +  reg:
>> +    maxItems: 1
>> +
>> +  clocks:
>> +    minItems: 1
>> +    maxItems: 2
>> +
>> +  clock-names:
>> +    minItems: 1
>> +    maxItems: 2
>> +
>> +  interrupts:
>> +    minItems: 32
>> +    maxItems: 56
>> +
>> +  interrupt-names:
>> +    minItems: 32
>> +    maxItems: 56
>> +
>> +  memory-region:
>> +    minItems: 1
>> +    description:
>> +      phandle to a node describing reserved memory (System RAM memory)
>> +      used by ath12k firmware (see bindings/reserved-memory/reserved-memory.txt)
>> +
>> +  qcom,bdf-addr:
>> +    $ref: /schemas/types.yaml#/definitions/uint32
>> +    description:
>> +      System RAM memory address reserved for board data.
>> +
>> +  qcom,board_id:
>> +    $ref: /schemas/types.yaml#/definitions/uint32
>> +    description:
>> +      Board id value, it identifies the variant of ath12k WiFi device.
> 
> Please do not upstream whatever you have in your vendor tree... You even
> copied its style! There is no such property in upstream.
> 
> NAK, you are duplicating compatibles.
> 
> 

qcom,board_id is a new parameter introduced to distinguish between different variants
of ath12k devices that share the same compatible value. This differentiation is crucial
as these variants have different qcom,board_id values (with the same compatible) based
on WiFi frequency bands capability. For example, 2 GHz, 5 GHz, 6 GHz, or multi-band
variants of ath12k devices have different qcom,board_id values.

In the next version, I will include the above information in the qcom,board_id
description.

> 
>> +
>> +  qcom,rproc:
>> +    $ref: /schemas/types.yaml#/definitions/phandle
>> +    description:
>> +      DT entry of a WCSS node. WCSS node is the child node of q6 remoteproc driver.
>> +      (see bindings/remoteproc/qcom,multipd-pil.yaml)
>> +
>> +required:
>> +  - compatible
>> +  - reg
>> +  - memory-region
>> +  - qcom,board_id
>> +  - qcom,rproc
>> +
>> +additionalProperties: false
>> +
>> +allOf:
>> +  - $ref: ieee80211.yaml#
>> +  - if:
>> +      properties:
>> +        compatible:
>> +          contains:
>> +            enum:
>> +              - qcom,ipq5332-wifi
> 
> Why? You have only one variant, why this if?

sure, in next version we will remove the if handing as we are currently
adding only one compatible.

>> +    then:
>> +      properties:
>> +        clocks:
>> +          items:
>> +            - description: gcc_xo_clk used for copy engine
>> +            - description: gcc_im_sleep_clk used for q6.
>> +
>> +        clock-names:
>> +          items:
>> +            - const: gcc_xo_clk
>> +            - const: gcc_im_sleep_clk
>> +
>> +        interrupts:
>> +          items:
>> +            - description: misc-pulse1 interrupt events
>> +            - description: misc-latch interrupt events
>> +            - description: sw exception interrupt events
>> +            - description: interrupt event for ring CE0
>> +            - description: interrupt event for ring CE1
>> +            - description: interrupt event for ring CE2
>> +            - description: interrupt event for ring CE3
>> +            - description: interrupt event for ring CE4
>> +            - description: interrupt event for ring CE5
>> +            - description: interrupt event for ring CE6
>> +            - description: interrupt event for ring CE7
>> +            - description: interrupt event for ring CE8
>> +            - description: interrupt event for ring CE9
>> +            - description: interrupt event for ring CE10
>> +            - description: interrupt event for ring CE11
>> +            - description: interrupt event for ring host2wbm-desc-feed
>> +            - description: interrupt event for ring host2reo-re-injection
>> +            - description: interrupt event for ring host2reo-command
>> +            - description: interrupt event for ring host2rxdma-monitor-ring1
>> +            - description: interrupt event for ring reo2ost-exception
>> +            - description: interrupt event for ring wbm2host-rx-release
>> +            - description: interrupt event for ring reo2host-status
>> +            - description: interrupt event for ring reo2host-destination-ring4
>> +            - description: interrupt event for ring reo2host-destination-ring3
>> +            - description: interrupt event for ring reo2host-destination-ring2
>> +            - description: interrupt event for ring reo2host-destination-ring1
>> +            - description: interrupt event for ring rxdma2host-monitor-destination-mac3
>> +            - description: interrupt event for ring rxdma2host-monitor-destination-mac2
>> +            - description: interrupt event for ring rxdma2host-monitor-destination-mac1
>> +            - description: interrupt event for ring host2rxdma-host-buf-ring-mac3
>> +            - description: interrupt event for ring host2rxdma-host-buf-ring-mac2
>> +            - description: interrupt event for ring host2rxdma-host-buf-ring-mac1
>> +            - description: interrupt event for ring host2tcl-input-ring4
>> +            - description: interrupt event for ring host2tcl-input-ring3
>> +            - description: interrupt event for ring host2tcl-input-ring2
>> +            - description: interrupt event for ring host2tcl-input-ring1
>> +            - description: interrupt event for ring wbm2host-tx-completions-ring4
>> +            - description: interrupt event for ring wbm2host-tx-completions-ring3
>> +            - description: interrupt event for ring wbm2host-tx-completions-ring2
>> +            - description: interrupt event for ring wbm2host-tx-completions-ring1
>> +            - description: interrupt event for ring host2tx-monitor-ring1
>> +            - description: interrupt event for ring txmon2host-monitor-destination-mac3
>> +            - description: interrupt event for ring txmon2host-monitor-destination-mac2
>> +            - description: interrupt event for ring txmon2host-monitor-destination-mac1
>> +            - description: interrupt event for umac_reset
>> +        interrupt-names:
>> +          items:
>> +            - const: misc-pulse1
>> +            - const: misc-latch
>> +            - const: sw-exception
>> +            - const: ce0
>> +            - const: ce1
>> +            - const: ce2
>> +            - const: ce3
>> +            - const: ce4
>> +            - const: ce5
>> +            - const: ce6
>> +            - const: ce7
>> +            - const: ce8
>> +            - const: ce9
>> +            - const: ce10
>> +            - const: ce11
>> +            - const: host2wbm-desc-feed
>> +            - const: host2reo-re-injection
>> +            - const: host2reo-command
>> +            - const: host2rxdma-monitor-ring1
>> +            - const: reo2ost-exception
>> +            - const: wbm2host-rx-release
>> +            - const: reo2host-status
>> +            - const: reo2host-destination-ring4
>> +            - const: reo2host-destination-ring3
>> +            - const: reo2host-destination-ring2
>> +            - const: reo2host-destination-ring1
>> +            - const: rxdma2host-monitor-destination-mac3
>> +            - const: rxdma2host-monitor-destination-mac2
>> +            - const: rxdma2host-monitor-destination-mac1
>> +            - const: host2rxdma-host-buf-ring-mac3
>> +            - const: host2rxdma-host-buf-ring-mac2
>> +            - const: host2rxdma-host-buf-ring-mac1
>> +            - const: host2tcl-input-ring4
>> +            - const: host2tcl-input-ring3
>> +            - const: host2tcl-input-ring2
>> +            - const: host2tcl-input-ring1
>> +            - const: wbm2host-tx-completions-ring4
>> +            - const: wbm2host-tx-completions-ring3
>> +            - const: wbm2host-tx-completions-ring2
>> +            - const: wbm2host-tx-completions-ring1
>> +            - const: host2tx-monitor-ring1
>> +            - const: txmon2host-monitor-destination-mac3
>> +            - const: txmon2host-monitor-destination-mac2
>> +            - const: txmon2host-monitor-destination-mac1
>> +            - const: umac_reset
>> +
>> +  - if:
>> +      properties:
>> +        compatible:
>> +          contains:
>> +            enum:
>> +              - qcom,ipq5332-wifi
>> +    then:
>> +      required:
>> +        - clocks
>> +        - clock-names
>> +        - interrupts
>> +        - interrupt-names
>> +        - qcom,bdf-addr
>> +
>> +examples:
>> +  - |
>> +
>> +    #include <dt-bindings/interrupt-controller/arm-gic.h>
>> +    #include <dt-bindings/clock/qcom,ipq5332-gcc.h>
>> +
>> +    reserved-memory {
>> +        #address-cells = <2>;
>> +        #size-cells = <2>;
>> +
>> +        q6_region: wcnss@4a900000 {
>> +            no-map;
>> +            reg = <0x0 0x4a900000 0x0 0x02300000>;
>> +        };
>> +
>> +        m3_dump: m3_dump@4cc00000 {
>> +            no-map;
>> +            reg = <0x0 0x4CC00000 0x0 0x100000>;
>> +        };
>> +    };
> 
> Drop
> 
Sure, will drop reserved-memory for example.

>> +
>> +    wifi0: wifi@c0000000 {
>> +        compatible = "qcom,ipq5332-wifi";
>> +        reg = <0xc000000 0x1000000>;
>> +        clocks = <&gcc GCC_XO_CLK>,
>> +                 <&gcc GCC_IM_SLEEP_CLK>;
>> +        clock-names = "gcc_xo_clk",
>> +                      "gcc_im_sleep_clk";
>> +        interrupts = <GIC_SPI 559 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 560 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 561 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 422 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 423 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 424 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 425 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 426 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 427 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 428 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 429 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 430 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 431 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 432 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 433 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 491 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 495 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 493 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 544 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 457 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 466 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 497 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 454 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 453 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 452 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 451 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 488 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 488 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 484 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 554 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 554 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 549 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 507 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 500 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 499 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 498 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 450 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 449 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 448 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 447 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 543 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 486 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 486 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 482 IRQ_TYPE_EDGE_RISING>,
>> +                     <GIC_SPI 419 IRQ_TYPE_EDGE_RISING>;
>> +        interrupt-names = "misc-pulse1",
>> +                          "misc-latch",
>> +                          "sw-exception",
>> +                          "ce0",
>> +                          "ce1",
>> +                          "ce2",
>> +                          "ce3",
>> +                          "ce4",
>> +                          "ce5",
>> +                          "ce6",
>> +                          "ce7",
>> +                          "ce8",
>> +                          "ce9",
>> +                          "ce10",
>> +                          "ce11",
>> +                          "host2wbm-desc-feed",
>> +                          "host2reo-re-injection",
>> +                          "host2reo-command",
>> +                          "host2rxdma-monitor-ring1",
>> +                          "reo2ost-exception",
>> +                          "wbm2host-rx-release",
>> +                          "reo2host-status",
>> +                          "reo2host-destination-ring4",
>> +                          "reo2host-destination-ring3",
>> +                          "reo2host-destination-ring2",
>> +                          "reo2host-destination-ring1",
>> +                          "rxdma2host-monitor-destination-mac3",
>> +                          "rxdma2host-monitor-destination-mac2",
>> +                          "rxdma2host-monitor-destination-mac1",
>> +                          "host2rxdma-host-buf-ring-mac3",
>> +                          "host2rxdma-host-buf-ring-mac2",
>> +                          "host2rxdma-host-buf-ring-mac1",
>> +                          "host2tcl-input-ring4",
>> +                          "host2tcl-input-ring3",
>> +                          "host2tcl-input-ring2",
>> +                          "host2tcl-input-ring1",
>> +                          "wbm2host-tx-completions-ring4",
>> +                          "wbm2host-tx-completions-ring3",
>> +                          "wbm2host-tx-completions-ring2",
>> +                          "wbm2host-tx-completions-ring1",
>> +                          "host2tx-monitor-ring1",
>> +                          "txmon2host-monitor-destination-mac3",
>> +                          "txmon2host-monitor-destination-mac2",
>> +                          "txmon2host-monitor-destination-mac1",
>> +                          "umac_reset";
>> +
>> +        memory-region = <&q6_region>;
>> +        qcom,bdf-addr = <0x4B500000>;
>> +        qcom,board_id = <0x12>;
>> +        qcom,rproc = <&q6_wcss_pd1>;
>> +        status = "okay";
> 
> Drop
> 
sure will drop the status.

>> +    };
> 
> Best regards,
> Krzysztof
> 
>
Raj Kumar Bhagat Sept. 4, 2024, 7:27 a.m. UTC | #4
On 8/16/2024 11:14 AM, Krzysztof Kozlowski wrote:
> On 14/08/2024 11:43, Raj Kumar Bhagat wrote:
>> +  qcom,bdf-addr:
>> +    $ref: /schemas/types.yaml#/definitions/uint32
>> +    description:
>> +      System RAM memory address reserved for board data.
> 
> Also drop. We do not store RAM offsets in DT.
> 

Sure, we will move this to driver hardware parameter.

> Best regards,
> Krzysztof
> 
>
Krzysztof Kozlowski Sept. 4, 2024, 7:38 a.m. UTC | #5
On 04/09/2024 09:23, Raj Kumar Bhagat wrote:
>>> +  qcom,board_id:
>>> +    $ref: /schemas/types.yaml#/definitions/uint32
>>> +    description:
>>> +      Board id value, it identifies the variant of ath12k WiFi device.
>>
>> Please do not upstream whatever you have in your vendor tree... You even
>> copied its style! There is no such property in upstream.
>>
>> NAK, you are duplicating compatibles.
>>
>>
> 
> qcom,board_id is a new parameter introduced to distinguish between different variants
> of ath12k devices that share the same compatible value. This differentiation is crucial
> as these variants have different qcom,board_id values (with the same compatible) based

You must explain why compatible cannot be used for that.

> on WiFi frequency bands capability. For example, 2 GHz, 5 GHz, 6 GHz, or multi-band
> variants of ath12k devices have different qcom,board_id values.
> 
> In the next version, I will include the above information in the qcom,board_id
> description.

Please follow DTS coding style. And style of existing properties like
this. Did you look for them? I claim you just sent whatever you had in
downstream.


Best regards,
Krzysztof
Raj Kumar Bhagat Sept. 4, 2024, 11:28 a.m. UTC | #6
On 9/4/2024 1:08 PM, Krzysztof Kozlowski wrote:
> On 04/09/2024 09:23, Raj Kumar Bhagat wrote:
>>>> +  qcom,board_id:
>>>> +    $ref: /schemas/types.yaml#/definitions/uint32
>>>> +    description:
>>>> +      Board id value, it identifies the variant of ath12k WiFi device.
>>>
>>> Please do not upstream whatever you have in your vendor tree... You even
>>> copied its style! There is no such property in upstream.
>>>
>>> NAK, you are duplicating compatibles.
>>>
>>>
>>
>> qcom,board_id is a new parameter introduced to distinguish between different variants
>> of ath12k devices that share the same compatible value. This differentiation is crucial
>> as these variants have different qcom,board_id values (with the same compatible) based
> 
> You must explain why compatible cannot be used for that.
> 

The compatible property is used to define the variant of the Ath12k device. However, the
Ath12k device variant does not change with different capabilities or configurations
(e.g., operating band). The qcom,board_id parameter is introduced to define these
configurations, not the device variant itself.

>> on WiFi frequency bands capability. For example, 2 GHz, 5 GHz, 6 GHz, or multi-band
>> variants of ath12k devices have different qcom,board_id values.
>>
>> In the next version, I will include the above information in the qcom,board_id
>> description.
> 
> Please follow DTS coding style. And style of existing properties like
> this. Did you look for them? I claim you just sent whatever you had in
> downstream.
> 

Checked "Devicetree Specification, Release v0.4", section 4.1.1,
seems "_" to be avoided for property name and hyphen "-" to be used. Also, qcom,board-id
is already taken in "Documentation/devicetree/bindings/arm/qcom.yaml". In the next
version will change this property name.

> 
> Best regards,
> Krzysztof
>
Krzysztof Kozlowski Sept. 4, 2024, 11:42 a.m. UTC | #7
On 04/09/2024 13:28, Raj Kumar Bhagat wrote:
> On 9/4/2024 1:08 PM, Krzysztof Kozlowski wrote:
>> On 04/09/2024 09:23, Raj Kumar Bhagat wrote:
>>>>> +  qcom,board_id:
>>>>> +    $ref: /schemas/types.yaml#/definitions/uint32
>>>>> +    description:
>>>>> +      Board id value, it identifies the variant of ath12k WiFi device.
>>>>
>>>> Please do not upstream whatever you have in your vendor tree... You even
>>>> copied its style! There is no such property in upstream.
>>>>
>>>> NAK, you are duplicating compatibles.
>>>>
>>>>
>>>
>>> qcom,board_id is a new parameter introduced to distinguish between different variants
>>> of ath12k devices that share the same compatible value. This differentiation is crucial
>>> as these variants have different qcom,board_id values (with the same compatible) based
>>
>> You must explain why compatible cannot be used for that.
>>
> 
> The compatible property is used to define the variant of the Ath12k device. However, the
> Ath12k device variant does not change with different capabilities or configurations
> (e.g., operating band). The qcom,board_id parameter is introduced to define these
> configurations, not the device variant itself.

operating aspects are run-time, so not suitable here. It's all still
vague for me.

> 
>>> on WiFi frequency bands capability. For example, 2 GHz, 5 GHz, 6 GHz, or multi-band
>>> variants of ath12k devices have different qcom,board_id values.
>>>
>>> In the next version, I will include the above information in the qcom,board_id
>>> description.
>>
>> Please follow DTS coding style. And style of existing properties like
>> this. Did you look for them? I claim you just sent whatever you had in
>> downstream.
>>
> 
> Checked "Devicetree Specification, Release v0.4", section 4.1.1,
> seems "_" to be avoided for property name and hyphen "-" to be used. Also, qcom,board-id
> is already taken in "Documentation/devicetree/bindings/arm/qcom.yaml". In the next
> version will change this property name.

Look at existing bindings and see how they are doing it. Sorry, you
still did not give any good rationale why compatibles cannot be used. If
this is board specific implementation, then the board compatible defines
differences.

You need to be specific, not so vague, about problem you are solving.
Don't answer with half-baked explanations just to get rid of reviewer.

Best regards,
Krzysztof
Kalle Valo Sept. 5, 2024, 6:33 p.m. UTC | #8
Krzysztof Kozlowski <krzk@kernel.org> writes:

> On 04/09/2024 13:28, Raj Kumar Bhagat wrote:
>
>> On 9/4/2024 1:08 PM, Krzysztof Kozlowski wrote:
>>> On 04/09/2024 09:23, Raj Kumar Bhagat wrote:
>>>>>> +  qcom,board_id:
>>>>>> +    $ref: /schemas/types.yaml#/definitions/uint32
>>>>>> +    description:
>>>>>> +      Board id value, it identifies the variant of ath12k WiFi device.
>>>>>
>>>>> Please do not upstream whatever you have in your vendor tree... You even
>>>>> copied its style! There is no such property in upstream.
>>>>>
>>>>> NAK, you are duplicating compatibles.
>>>>>
>>>>>
>>>>
>>>> qcom,board_id is a new parameter introduced to distinguish between different variants
>>>> of ath12k devices that share the same compatible value. This differentiation is crucial
>>>> as these variants have different qcom,board_id values (with the same compatible) based
>>>
>>> You must explain why compatible cannot be used for that.
>>>
>> 
>> The compatible property is used to define the variant of the Ath12k device. However, the
>> Ath12k device variant does not change with different capabilities or configurations
>> (e.g., operating band). The qcom,board_id parameter is introduced to define these
>> configurations, not the device variant itself.
>
> operating aspects are run-time, so not suitable here. It's all still
> vague for me.

Yeah, this is weird and I would hope there is a better way to do it.
Unfortunately I'm not able to study this in detail right now but, like
you said, most likely this is just directly copied from QSDK (their
downstream).
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/net/wireless/qcom,ath12k-ahb.yaml b/Documentation/devicetree/bindings/net/wireless/qcom,ath12k-ahb.yaml
new file mode 100644
index 000000000000..8cecc50b6341
--- /dev/null
+++ b/Documentation/devicetree/bindings/net/wireless/qcom,ath12k-ahb.yaml
@@ -0,0 +1,325 @@ 
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+# Copyright (c) 2024 Qualcomm Innovation Center, Inc. All rights reserved.
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/net/wireless/qcom,ath12k-ahb.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Qualcomm Technologies ath12k wireless devices (AHB)
+
+maintainers:
+  - Kalle Valo <kvalo@kernel.org>
+  - Jeff Johnson <jjohnson@kernel.org>
+
+description:
+  Qualcomm Technologies IEEE 802.11be AHB devices.
+
+properties:
+  compatible:
+    enum:
+      - qcom,ipq5332-wifi
+
+  reg:
+    maxItems: 1
+
+  clocks:
+    minItems: 1
+    maxItems: 2
+
+  clock-names:
+    minItems: 1
+    maxItems: 2
+
+  interrupts:
+    minItems: 32
+    maxItems: 56
+
+  interrupt-names:
+    minItems: 32
+    maxItems: 56
+
+  memory-region:
+    minItems: 1
+    description:
+      phandle to a node describing reserved memory (System RAM memory)
+      used by ath12k firmware (see bindings/reserved-memory/reserved-memory.txt)
+
+  qcom,bdf-addr:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description:
+      System RAM memory address reserved for board data.
+
+  qcom,board_id:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description:
+      Board id value, it identifies the variant of ath12k WiFi device.
+
+  qcom,rproc:
+    $ref: /schemas/types.yaml#/definitions/phandle
+    description:
+      DT entry of a WCSS node. WCSS node is the child node of q6 remoteproc driver.
+      (see bindings/remoteproc/qcom,multipd-pil.yaml)
+
+required:
+  - compatible
+  - reg
+  - memory-region
+  - qcom,board_id
+  - qcom,rproc
+
+additionalProperties: false
+
+allOf:
+  - $ref: ieee80211.yaml#
+  - if:
+      properties:
+        compatible:
+          contains:
+            enum:
+              - qcom,ipq5332-wifi
+    then:
+      properties:
+        clocks:
+          items:
+            - description: gcc_xo_clk used for copy engine
+            - description: gcc_im_sleep_clk used for q6.
+
+        clock-names:
+          items:
+            - const: gcc_xo_clk
+            - const: gcc_im_sleep_clk
+
+        interrupts:
+          items:
+            - description: misc-pulse1 interrupt events
+            - description: misc-latch interrupt events
+            - description: sw exception interrupt events
+            - description: interrupt event for ring CE0
+            - description: interrupt event for ring CE1
+            - description: interrupt event for ring CE2
+            - description: interrupt event for ring CE3
+            - description: interrupt event for ring CE4
+            - description: interrupt event for ring CE5
+            - description: interrupt event for ring CE6
+            - description: interrupt event for ring CE7
+            - description: interrupt event for ring CE8
+            - description: interrupt event for ring CE9
+            - description: interrupt event for ring CE10
+            - description: interrupt event for ring CE11
+            - description: interrupt event for ring host2wbm-desc-feed
+            - description: interrupt event for ring host2reo-re-injection
+            - description: interrupt event for ring host2reo-command
+            - description: interrupt event for ring host2rxdma-monitor-ring1
+            - description: interrupt event for ring reo2ost-exception
+            - description: interrupt event for ring wbm2host-rx-release
+            - description: interrupt event for ring reo2host-status
+            - description: interrupt event for ring reo2host-destination-ring4
+            - description: interrupt event for ring reo2host-destination-ring3
+            - description: interrupt event for ring reo2host-destination-ring2
+            - description: interrupt event for ring reo2host-destination-ring1
+            - description: interrupt event for ring rxdma2host-monitor-destination-mac3
+            - description: interrupt event for ring rxdma2host-monitor-destination-mac2
+            - description: interrupt event for ring rxdma2host-monitor-destination-mac1
+            - description: interrupt event for ring host2rxdma-host-buf-ring-mac3
+            - description: interrupt event for ring host2rxdma-host-buf-ring-mac2
+            - description: interrupt event for ring host2rxdma-host-buf-ring-mac1
+            - description: interrupt event for ring host2tcl-input-ring4
+            - description: interrupt event for ring host2tcl-input-ring3
+            - description: interrupt event for ring host2tcl-input-ring2
+            - description: interrupt event for ring host2tcl-input-ring1
+            - description: interrupt event for ring wbm2host-tx-completions-ring4
+            - description: interrupt event for ring wbm2host-tx-completions-ring3
+            - description: interrupt event for ring wbm2host-tx-completions-ring2
+            - description: interrupt event for ring wbm2host-tx-completions-ring1
+            - description: interrupt event for ring host2tx-monitor-ring1
+            - description: interrupt event for ring txmon2host-monitor-destination-mac3
+            - description: interrupt event for ring txmon2host-monitor-destination-mac2
+            - description: interrupt event for ring txmon2host-monitor-destination-mac1
+            - description: interrupt event for umac_reset
+        interrupt-names:
+          items:
+            - const: misc-pulse1
+            - const: misc-latch
+            - const: sw-exception
+            - const: ce0
+            - const: ce1
+            - const: ce2
+            - const: ce3
+            - const: ce4
+            - const: ce5
+            - const: ce6
+            - const: ce7
+            - const: ce8
+            - const: ce9
+            - const: ce10
+            - const: ce11
+            - const: host2wbm-desc-feed
+            - const: host2reo-re-injection
+            - const: host2reo-command
+            - const: host2rxdma-monitor-ring1
+            - const: reo2ost-exception
+            - const: wbm2host-rx-release
+            - const: reo2host-status
+            - const: reo2host-destination-ring4
+            - const: reo2host-destination-ring3
+            - const: reo2host-destination-ring2
+            - const: reo2host-destination-ring1
+            - const: rxdma2host-monitor-destination-mac3
+            - const: rxdma2host-monitor-destination-mac2
+            - const: rxdma2host-monitor-destination-mac1
+            - const: host2rxdma-host-buf-ring-mac3
+            - const: host2rxdma-host-buf-ring-mac2
+            - const: host2rxdma-host-buf-ring-mac1
+            - const: host2tcl-input-ring4
+            - const: host2tcl-input-ring3
+            - const: host2tcl-input-ring2
+            - const: host2tcl-input-ring1
+            - const: wbm2host-tx-completions-ring4
+            - const: wbm2host-tx-completions-ring3
+            - const: wbm2host-tx-completions-ring2
+            - const: wbm2host-tx-completions-ring1
+            - const: host2tx-monitor-ring1
+            - const: txmon2host-monitor-destination-mac3
+            - const: txmon2host-monitor-destination-mac2
+            - const: txmon2host-monitor-destination-mac1
+            - const: umac_reset
+
+  - if:
+      properties:
+        compatible:
+          contains:
+            enum:
+              - qcom,ipq5332-wifi
+    then:
+      required:
+        - clocks
+        - clock-names
+        - interrupts
+        - interrupt-names
+        - qcom,bdf-addr
+
+examples:
+  - |
+
+    #include <dt-bindings/interrupt-controller/arm-gic.h>
+    #include <dt-bindings/clock/qcom,ipq5332-gcc.h>
+
+    reserved-memory {
+        #address-cells = <2>;
+        #size-cells = <2>;
+
+        q6_region: wcnss@4a900000 {
+            no-map;
+            reg = <0x0 0x4a900000 0x0 0x02300000>;
+        };
+
+        m3_dump: m3_dump@4cc00000 {
+            no-map;
+            reg = <0x0 0x4CC00000 0x0 0x100000>;
+        };
+    };
+
+    wifi0: wifi@c0000000 {
+        compatible = "qcom,ipq5332-wifi";
+        reg = <0xc000000 0x1000000>;
+        clocks = <&gcc GCC_XO_CLK>,
+                 <&gcc GCC_IM_SLEEP_CLK>;
+        clock-names = "gcc_xo_clk",
+                      "gcc_im_sleep_clk";
+        interrupts = <GIC_SPI 559 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 560 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 561 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 422 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 423 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 424 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 425 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 426 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 427 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 428 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 429 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 430 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 431 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 432 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 433 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 491 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 495 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 493 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 544 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 457 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 466 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 497 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 454 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 453 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 452 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 451 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 488 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 488 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 484 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 554 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 554 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 549 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 507 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 500 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 499 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 498 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 450 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 449 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 448 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 447 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 543 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 486 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 486 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 482 IRQ_TYPE_EDGE_RISING>,
+                     <GIC_SPI 419 IRQ_TYPE_EDGE_RISING>;
+        interrupt-names = "misc-pulse1",
+                          "misc-latch",
+                          "sw-exception",
+                          "ce0",
+                          "ce1",
+                          "ce2",
+                          "ce3",
+                          "ce4",
+                          "ce5",
+                          "ce6",
+                          "ce7",
+                          "ce8",
+                          "ce9",
+                          "ce10",
+                          "ce11",
+                          "host2wbm-desc-feed",
+                          "host2reo-re-injection",
+                          "host2reo-command",
+                          "host2rxdma-monitor-ring1",
+                          "reo2ost-exception",
+                          "wbm2host-rx-release",
+                          "reo2host-status",
+                          "reo2host-destination-ring4",
+                          "reo2host-destination-ring3",
+                          "reo2host-destination-ring2",
+                          "reo2host-destination-ring1",
+                          "rxdma2host-monitor-destination-mac3",
+                          "rxdma2host-monitor-destination-mac2",
+                          "rxdma2host-monitor-destination-mac1",
+                          "host2rxdma-host-buf-ring-mac3",
+                          "host2rxdma-host-buf-ring-mac2",
+                          "host2rxdma-host-buf-ring-mac1",
+                          "host2tcl-input-ring4",
+                          "host2tcl-input-ring3",
+                          "host2tcl-input-ring2",
+                          "host2tcl-input-ring1",
+                          "wbm2host-tx-completions-ring4",
+                          "wbm2host-tx-completions-ring3",
+                          "wbm2host-tx-completions-ring2",
+                          "wbm2host-tx-completions-ring1",
+                          "host2tx-monitor-ring1",
+                          "txmon2host-monitor-destination-mac3",
+                          "txmon2host-monitor-destination-mac2",
+                          "txmon2host-monitor-destination-mac1",
+                          "umac_reset";
+
+        memory-region = <&q6_region>;
+        qcom,bdf-addr = <0x4B500000>;
+        qcom,board_id = <0x12>;
+        qcom,rproc = <&q6_wcss_pd1>;
+        status = "okay";
+    };