Re: [PATCH v6 05/16] dt-bindings: net: wireless: describe the ath12k PCI module

From: Kalle Valo
Date: Mon Mar 25 2024 - 12:14:36 EST


Bartosz Golaszewski <brgl@xxxxxxxx> writes:

> From: Bartosz Golaszewski <bartosz.golaszewski@xxxxxxxxxx>
>
> Add device-tree bindings for the ATH12K module found in the WCN7850
> package.
>
> Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@xxxxxxxxxx>
> ---
> .../bindings/net/wireless/qcom,ath12k.yaml | 100 ++++++++++++++++++
> 1 file changed, 100 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/net/wireless/qcom,ath12k.yaml
>
> diff --git a/Documentation/devicetree/bindings/net/wireless/qcom,ath12k.yaml b/Documentation/devicetree/bindings/net/wireless/qcom,ath12k.yaml
> new file mode 100644
> index 000000000000..c0aad4815953
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/net/wireless/qcom,ath12k.yaml
> @@ -0,0 +1,100 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +# Copyright (c) 2024 Linaro Limited
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/net/wireless/qcom,ath12k.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Qualcomm Technologies ath12k wireless devices (PCIe)
> +
> +maintainers:
> + - Bartosz Golaszewski <bartosz.golaszewski@xxxxxxxxxx>

IMHO it would be better to have just driver maintainers listed here.

> + - Jeff Johnson <quic_jjohnson@xxxxxxxxxxx>
> + - Kalle Valo <kvalo@xxxxxxxxxx>
> +
> +description:
> + Qualcomm Technologies IEEE 802.11ax PCIe devices.
> +
> +properties:
> + compatible:
> + enum:
> + - pci17cb,1107 # WCN7850
> +
> + reg:
> + maxItems: 1
> +
> + vddaon-supply:
> + description: VDD_AON supply regulator handle
> +
> + vddwlcx-supply:
> + description: VDD_WLCX supply regulator handle
> +
> + vddwlmx-supply:
> + description: VDD_WLMX supply regulator handle
> +
> + vddrfacmn-supply:
> + description: VDD_RFA_CMN supply regulator handle
> +
> + vddrfa0p8-supply:
> + description: VDD_RFA_0P8 supply regulator handle
> +
> + vddrfa1p2-supply:
> + description: VDD_RFA_1P2 supply regulator handle
> +
> + vddrfa1p8-supply:
> + description: VDD_RFA_1P8 supply regulator handle
> +
> + vddpcie0p9-supply:
> + description: VDD_PCIE_0P9 supply regulator handle
> +
> + vddpcie1p8-supply:
> + description: VDD_PCIE_1P8 supply regulator handle
> +
> +required:
> + - compatible
> + - reg
> + - vddaon-supply
> + - vddwlcx-supply
> + - vddwlmx-supply
> + - vddrfacmn-supply
> + - vddrfa0p8-supply
> + - vddrfa1p2-supply
> + - vddrfa1p8-supply
> + - vddpcie0p9-supply
> + - vddpcie1p8-supply

Same comment here as in patch 4. There are also ath12k PCI devices which
don't need DT at all. I don't know if that should be reflected in the
bindings doc but I want to point out this.

--
https://patchwork.kernel.org/project/linux-wireless/list/

https://wireless.wiki.kernel.org/en/developers/documentation/submittingpatches