by Rob Herring (Arm)

[permalink] [raw]

Subject: Re: [PATCH v6 5/9] dt-bindings: phy: Add bindings for HiKey 970 PCIe PHY

On Tue, 20 Jul 2021 10:09:07 +0200, Mauro Carvalho Chehab wrote:
> Document the bindings for HiKey 970 (hi3670) PCIe PHY
> interface, supported via the pcie-kirin driver.
>
> Signed-off-by: Mauro Carvalho Chehab <[email protected]>
> ---
> .../phy/hisilicon,phy-hi3670-pcie.yaml | 98 +++++++++++++++++++
> 1 file changed, 98 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/phy/hisilicon,phy-hi3670-pcie.yaml
>

My bot found errors running 'make DT_CHECKER_FLAGS=-m dt_binding_check'
on your patch (DT_CHECKER_FLAGS is new in v5.13):

yamllint warnings/errors:

dtschema/dtc warnings/errors:
/builds/robherring/linux-dt-review/Documentation/devicetree/bindings/phy/hisilicon,phy-hi3670-pcie.example.dt.yaml: pcie-phy@fc000000: 'reg-names' does not match any of the regexes: 'pinctrl-[0-9]+'
From schema: /builds/robherring/linux-dt-review/Documentation/devicetree/bindings/phy/hisilicon,phy-hi3670-pcie.yaml
\ndoc reference errors (make refcheckdocs):

See https://patchwork.ozlabs.org/patch/1507427

This check can fail if there are any dependencies. The base for a patch
series is generally the most recent rc1.

If you already ran 'make dt_binding_check' and didn't see the above
error(s), then make sure 'yamllint' is installed and dt-schema is up to
date:

pip3 install dtschema --upgrade

Please check and re-submit.

2021-07-20 23:29:00

by Bjorn Helgaas

[permalink] [raw]

Subject: Re: [PATCH v6 2/9] PCI: kirin: add support for a PHY layer

In subject:

PCI: kirin: Add support for a PHY later

(s/add/Add/)

On Tue, Jul 20, 2021 at 10:09:04AM +0200, Mauro Carvalho Chehab wrote:
> While it is too late to remove the Kirin 960 PHY, the driver
> should be able to support different PHYs used by other devices.

Commit log doesn't actually say what this patch does.

> Signed-off-by: Mauro Carvalho Chehab <[email protected]>
> ---
> drivers/pci/controller/dwc/pcie-kirin.c | 95 +++++++++++++++++++++----
> 1 file changed, 80 insertions(+), 15 deletions(-)
>
> diff --git a/drivers/pci/controller/dwc/pcie-kirin.c b/drivers/pci/controller/dwc/pcie-kirin.c
> index b4063a3434df..558188476372 100644
> --- a/drivers/pci/controller/dwc/pcie-kirin.c
> +++ b/drivers/pci/controller/dwc/pcie-kirin.c
> @@ -8,16 +8,18 @@
> * Author: Xiaowei Song <[email protected]>
> */
>
> -#include <linux/compiler.h>
> #include <linux/clk.h>
> +#include <linux/compiler.h>
> #include <linux/delay.h>
> #include <linux/err.h>
> #include <linux/gpio.h>
> #include <linux/interrupt.h>
> #include <linux/mfd/syscon.h>
> #include <linux/of_address.h>
> +#include <linux/of_device.h>
> #include <linux/of_gpio.h>
> #include <linux/of_pci.h>
> +#include <linux/phy/phy.h>
> #include <linux/pci.h>
> #include <linux/pci_regs.h>
> #include <linux/platform_device.h>
> @@ -50,11 +52,18 @@
> #define PCIE_DEBOUNCE_PARAM 0xF0F400
> #define PCIE_OE_BYPASS (0x3 << 28)
>
> +enum pcie_kirin_phy_type {
> + PCIE_KIRIN_INTERNAL_PHY,
> + PCIE_KIRIN_EXTERNAL_PHY
> +};
> +
> struct kirin_pcie {
> + enum pcie_kirin_phy_type type;
> +
> struct dw_pcie *pci;
> struct phy *phy;
> void __iomem *apb_base;
> - void *phy_priv; /* Needed for Kirin 960 PHY */
> + void *phy_priv; /* only for PCIE_KIRIN_INTERNAL_PHY */
> };
>
> /*
> @@ -476,8 +485,63 @@ static const struct dw_pcie_host_ops kirin_pcie_host_ops = {
> .host_init = kirin_pcie_host_init,
> };
>
> +static const struct of_device_id kirin_pcie_match[] = {
> + {
> + .compatible = "hisilicon,kirin960-pcie",
> + .data = (void *)PCIE_KIRIN_INTERNAL_PHY
> + },
> + {},
> +};

Is there a benefit to moving kirin_pcie_match[] up here? Seemed nice
to have it close to its use in kirin_pcie_driver, and would make the
diff easier to read. But if it helps to move it, no big deal.

> +static int kirin_pcie_power_on(struct platform_device *pdev,
> + struct kirin_pcie *kirin_pcie)
> +{
> + struct device *dev = &pdev->dev;
> + int ret;
> +
> + if (kirin_pcie->type == PCIE_KIRIN_INTERNAL_PHY) {
> + ret = hi3660_pcie_phy_init(pdev, kirin_pcie);
> + if (ret)
> + return ret;
> +
> + return hi3660_pcie_phy_power_on(kirin_pcie);
> + }
> +
> + kirin_pcie->phy = devm_of_phy_get(dev, dev->of_node, NULL);
> + if (IS_ERR(kirin_pcie->phy))
> + return PTR_ERR(kirin_pcie->phy);
> +
> + ret = phy_init(kirin_pcie->phy);
> + if (ret)
> + goto err;
> +
> + ret = phy_power_on(kirin_pcie->phy);
> + if (ret)
> + goto err;
> +
> + return 0;
> +err:
> + phy_exit(kirin_pcie->phy);
> + return ret;
> +}
> +
> +static int __exit kirin_pcie_remove(struct platform_device *pdev)
> +{
> + struct kirin_pcie *kirin_pcie = platform_get_drvdata(pdev);
> +
> + if (kirin_pcie->type == PCIE_KIRIN_INTERNAL_PHY)
> + return 0;
> +
> + phy_power_off(kirin_pcie->phy);
> + phy_exit(kirin_pcie->phy);
> +
> + return 0;
> +}
> +
> static int kirin_pcie_probe(struct platform_device *pdev)
> {
> + enum pcie_kirin_phy_type phy_type;
> + const struct of_device_id *of_id;
> struct device *dev = &pdev->dev;
> struct kirin_pcie *kirin_pcie;
> struct dw_pcie *pci;
> @@ -488,6 +552,14 @@ static int kirin_pcie_probe(struct platform_device *pdev)
> return -EINVAL;
> }
>
> + of_id = of_match_device(kirin_pcie_match, dev);
> + if (!of_id) {
> + dev_err(dev, "OF data missing\n");
> + return -EINVAL;
> + }
> +
> + phy_type = (enum pcie_kirin_phy_type)of_id->data;
> +
> kirin_pcie = devm_kzalloc(dev, sizeof(struct kirin_pcie), GFP_KERNEL);
> if (!kirin_pcie)
> return -ENOMEM;
> @@ -500,31 +572,24 @@ static int kirin_pcie_probe(struct platform_device *pdev)
> pci->ops = &kirin_dw_pcie_ops;
> pci->pp.ops = &kirin_pcie_host_ops;
> kirin_pcie->pci = pci;
> -
> - ret = hi3660_pcie_phy_init(pdev, kirin_pcie);
> - if (ret)
> - return ret;
> + kirin_pcie->type = phy_type;
>
> ret = kirin_pcie_get_resource(kirin_pcie, pdev);
> if (ret)
> return ret;
>
> - ret = hi3660_pcie_phy_power_on(kirin_pcie);
> - if (ret)
> - return ret;
> -
> platform_set_drvdata(pdev, kirin_pcie);
>
> + ret = kirin_pcie_power_on(pdev, kirin_pcie);
> + if (ret)
> + return ret;
> +
> return dw_pcie_host_init(&pci->pp);
> }
>
> -static const struct of_device_id kirin_pcie_match[] = {
> - { .compatible = "hisilicon,kirin960-pcie" },
> - {},
> -};
> -
> static struct platform_driver kirin_pcie_driver = {
> .probe = kirin_pcie_probe,
> + .remove = __exit_p(kirin_pcie_remove),
> .driver = {
> .name = "kirin-pcie",
> .of_match_table = kirin_pcie_match,
> --
> 2.31.1
>