Re: [PATCH v10 01/14] PCI: imx6: Simplify clock handling by using clk_bulk*() function

From: Lorenzo Pieralisi
Date: Tue Feb 13 2024 - 11:20:40 EST


On Tue, Feb 13, 2024 at 10:58:01AM -0500, Frank Li wrote:
> On Tue, Feb 13, 2024 at 04:31:22PM +0100, Lorenzo Pieralisi wrote:
> > On Mon, Feb 05, 2024 at 12:33:22PM -0500, Frank Li wrote:
> > > Refector the clock handling logic. Add 'clk_names' define in drvdata. Use
> > > clk_bulk*() api simplify the code.
> > >
> > > Reviewed-by: Manivannan Sadhasivam <manivannan.sadhasivam@xxxxxxxxxx>
> > > Signed-off-by: Frank Li <Frank.Li@xxxxxxx>
> > > ---
> > >
> > > Notes:
> > > Change from v9 to v10
> > > - fixed missed delete a case, which need failthrough to next one.
> > > Change from v8 to v9
> > > - change clks names
> > > - Add Manivannan's review tag
> > >
> > > Change from v7 to v8
> > > - update comment message
> > > - using ARRAY_SIZE to count clk_names.
> > > Change from v6 to v7
> > > - none
> > > Change from v4 to v5
> > > - update commit message
> > > - direct using clk name list, instead of macro
> > > - still keep caculate clk list count because sizeof return pre allocated
> > > array size.
> > >
> > > Change from v3 to v4
> > > - using clk_bulk_*() API
> > > Change from v1 to v3
> > > - none
> > >
> > > Change from v4 to v5
> > > - update commit message
> > > - direct using clk name list, instead of macro
> > > - still keep caculate clk list count because sizeof return pre allocated
> > > array size.
> > >
> > > Change from v3 to v4
> > > - using clk_bulk_*() API
> > > Change from v1 to v3
> > > - none
> > >
> > > Change from v8 to v9
> > > - change clks names
> > > - Add Manivannan's review tag
> > >
> > > Change from v7 to v8
> > > - update comment message
> > > - using ARRAY_SIZE to count clk_names.
> > > Change from v6 to v7
> > > - none
> > > Change from v4 to v5
> > > - update commit message
> > > - direct using clk name list, instead of macro
> > > - still keep caculate clk list count because sizeof return pre allocated
> > > array size.
> > >
> > > Change from v3 to v4
> > > - using clk_bulk_*() API
> > > Change from v1 to v3
> > > - none
> > >
> > > Change from v4 to v5
> > > - update commit message
> > > - direct using clk name list, instead of macro
> > > - still keep caculate clk list count because sizeof return pre allocated
> > > array size.
> > >
> > > Change from v3 to v4
> > > - using clk_bulk_*() API
> > > Change from v1 to v3
> > > - none
> > >
> > > drivers/pci/controller/dwc/pci-imx6.c | 138 ++++++++++----------------
> > > 1 file changed, 50 insertions(+), 88 deletions(-)
> > >
> > > diff --git a/drivers/pci/controller/dwc/pci-imx6.c b/drivers/pci/controller/dwc/pci-imx6.c
> > > index 74703362aeec7..82854e94c5621 100644
> > > --- a/drivers/pci/controller/dwc/pci-imx6.c
> > > +++ b/drivers/pci/controller/dwc/pci-imx6.c
> > > @@ -61,12 +61,16 @@ enum imx6_pcie_variants {
> > > #define IMX6_PCIE_FLAG_IMX6_SPEED_CHANGE BIT(1)
> > > #define IMX6_PCIE_FLAG_SUPPORTS_SUSPEND BIT(2)
> > >
> > > +#define IMX6_PCIE_MAX_CLKS 6
> > > +
> > > struct imx6_pcie_drvdata {
> > > enum imx6_pcie_variants variant;
> > > enum dw_pcie_device_mode mode;
> > > u32 flags;
> > > int dbi_length;
> > > const char *gpr;
> > > + const char * const *clk_names;
> > > + const u32 clks_cnt;
> > > };
> > >
> > > struct imx6_pcie {
> > > @@ -74,11 +78,7 @@ struct imx6_pcie {
> > > int reset_gpio;
> > > bool gpio_active_high;
> > > bool link_is_up;
> > > - struct clk *pcie_bus;
> > > - struct clk *pcie_phy;
> > > - struct clk *pcie_inbound_axi;
> > > - struct clk *pcie;
> > > - struct clk *pcie_aux;
> > > + struct clk_bulk_data clks[IMX6_PCIE_MAX_CLKS];
> >
> > Why can't you allocate this dynamically ?
>
> Engineer choose. clk_bulk_data is small data struct, two pointers (16byte
> in 64bit system). clks in imx is 3-4, Over half already used(compared 6).
> waste case only wast 48byte.
>
> Dynamically allocate can't save much memory, there are some extra manage
> meta data for dynamical memory, which may bigger than 48byte.
>
> Frank
>
> >
> > > struct regmap *iomuxc_gpr;
> > > u16 msi_ctrl;
> > > u32 controller_id;
> > > @@ -407,13 +407,18 @@ static void imx7d_pcie_wait_for_phy_pll_lock(struct imx6_pcie *imx6_pcie)
> > >
> > > static int imx6_setup_phy_mpll(struct imx6_pcie *imx6_pcie)
> > > {
> > > - unsigned long phy_rate = clk_get_rate(imx6_pcie->pcie_phy);
> > > + unsigned long phy_rate = 0;
> > > int mult, div;
> > > u16 val;
> > > + int i;
> > >
> > > if (!(imx6_pcie->drvdata->flags & IMX6_PCIE_FLAG_IMX6_PHY))
> > > return 0;
> > >
> > > + for (i = 0; i < imx6_pcie->drvdata->clks_cnt; i++)
> > > + if (strncmp(imx6_pcie->clks[i].id, "pcie_phy", 8) == 0)
> > > + phy_rate = clk_get_rate(imx6_pcie->clks[i].clk);
> > > +
> > > switch (phy_rate) {
> > > case 125000000:
> > > /*
> > > @@ -550,19 +555,11 @@ static int imx6_pcie_attach_pd(struct device *dev)
> > >
> > > static int imx6_pcie_enable_ref_clk(struct imx6_pcie *imx6_pcie)
> > > {
> > > - struct dw_pcie *pci = imx6_pcie->pci;
> > > - struct device *dev = pci->dev;
> > > unsigned int offset;
> > > int ret = 0;
> > >
> > > switch (imx6_pcie->drvdata->variant) {
> > > case IMX6SX:
> > > - ret = clk_prepare_enable(imx6_pcie->pcie_inbound_axi);
> > > - if (ret) {
> > > - dev_err(dev, "unable to enable pcie_axi clock\n");
> > > - break;
> > > - }
> > > -
> > > regmap_update_bits(imx6_pcie->iomuxc_gpr, IOMUXC_GPR12,
> > > IMX6SX_GPR12_PCIE_TEST_POWERDOWN, 0);
> > > break;
> > > @@ -589,12 +586,6 @@ static int imx6_pcie_enable_ref_clk(struct imx6_pcie *imx6_pcie)
> > > case IMX8MQ_EP:
> > > case IMX8MP:
> > > case IMX8MP_EP:
> > > - ret = clk_prepare_enable(imx6_pcie->pcie_aux);
> > > - if (ret) {
> > > - dev_err(dev, "unable to enable pcie_aux clock\n");
> > > - break;
> > > - }
> > > -
> > > offset = imx6_pcie_grp_offset(imx6_pcie);
> > > /*
> > > * Set the over ride low and enabled
> > > @@ -615,9 +606,6 @@ static int imx6_pcie_enable_ref_clk(struct imx6_pcie *imx6_pcie)
> > > static void imx6_pcie_disable_ref_clk(struct imx6_pcie *imx6_pcie)
> > > {
> > > switch (imx6_pcie->drvdata->variant) {
> > > - case IMX6SX:
> > > - clk_disable_unprepare(imx6_pcie->pcie_inbound_axi);
> > > - break;
> > > case IMX6QP:
> > > case IMX6Q:
> > > regmap_update_bits(imx6_pcie->iomuxc_gpr, IOMUXC_GPR1,
> > > @@ -631,14 +619,6 @@ static void imx6_pcie_disable_ref_clk(struct imx6_pcie *imx6_pcie)
> > > IMX7D_GPR12_PCIE_PHY_REFCLK_SEL,
> > > IMX7D_GPR12_PCIE_PHY_REFCLK_SEL);
> > > break;
> > > - case IMX8MM:
> > > - case IMX8MM_EP:
> > > - case IMX8MQ:
> > > - case IMX8MQ_EP:
> > > - case IMX8MP:
> > > - case IMX8MP_EP:
> > > - clk_disable_unprepare(imx6_pcie->pcie_aux);
> > > - break;
> > > default:
> > > break;
> > > }
> > > @@ -650,23 +630,9 @@ static int imx6_pcie_clk_enable(struct imx6_pcie *imx6_pcie)
> > > struct device *dev = pci->dev;
> > > int ret;
> > >
> > > - ret = clk_prepare_enable(imx6_pcie->pcie_phy);
> > > - if (ret) {
> > > - dev_err(dev, "unable to enable pcie_phy clock\n");
> > > + ret = clk_bulk_prepare_enable(imx6_pcie->drvdata->clks_cnt, imx6_pcie->clks);
> > > + if (ret)
> > > return ret;
> > > - }
> > > -
> > > - ret = clk_prepare_enable(imx6_pcie->pcie_bus);
> > > - if (ret) {
> > > - dev_err(dev, "unable to enable pcie_bus clock\n");
> > > - goto err_pcie_bus;
> > > - }
> > > -
> > > - ret = clk_prepare_enable(imx6_pcie->pcie);
> > > - if (ret) {
> > > - dev_err(dev, "unable to enable pcie clock\n");
> > > - goto err_pcie;
> > > - }
> > >
> > > ret = imx6_pcie_enable_ref_clk(imx6_pcie);
> > > if (ret) {
> > > @@ -679,11 +645,7 @@ static int imx6_pcie_clk_enable(struct imx6_pcie *imx6_pcie)
> > > return 0;
> > >
> > > err_ref_clk:
> > > - clk_disable_unprepare(imx6_pcie->pcie);
> > > -err_pcie:
> > > - clk_disable_unprepare(imx6_pcie->pcie_bus);
> > > -err_pcie_bus:
> > > - clk_disable_unprepare(imx6_pcie->pcie_phy);
> > > + clk_bulk_disable_unprepare(imx6_pcie->drvdata->clks_cnt, imx6_pcie->clks);
> > >
> > > return ret;
> > > }
> > > @@ -691,9 +653,7 @@ static int imx6_pcie_clk_enable(struct imx6_pcie *imx6_pcie)
> > > static void imx6_pcie_clk_disable(struct imx6_pcie *imx6_pcie)
> > > {
> > > imx6_pcie_disable_ref_clk(imx6_pcie);
> > > - clk_disable_unprepare(imx6_pcie->pcie);
> > > - clk_disable_unprepare(imx6_pcie->pcie_bus);
> > > - clk_disable_unprepare(imx6_pcie->pcie_phy);
> > > + clk_bulk_disable_unprepare(imx6_pcie->drvdata->clks_cnt, imx6_pcie->clks);
> > > }
> > >
> > > static void imx6_pcie_assert_core_reset(struct imx6_pcie *imx6_pcie)
> > > @@ -1252,6 +1212,7 @@ static int imx6_pcie_probe(struct platform_device *pdev)
> > > struct device_node *node = dev->of_node;
> > > int ret;
> > > u16 val;
> > > + int i;
> > >
> > > imx6_pcie = devm_kzalloc(dev, sizeof(*imx6_pcie), GFP_KERNEL);
> > > if (!imx6_pcie)
> > > @@ -1305,32 +1266,20 @@ static int imx6_pcie_probe(struct platform_device *pdev)
> > > return imx6_pcie->reset_gpio;
> > > }
> > >
> > > - /* Fetch clocks */
> > > - imx6_pcie->pcie_bus = devm_clk_get(dev, "pcie_bus");
> > > - if (IS_ERR(imx6_pcie->pcie_bus))
> > > - return dev_err_probe(dev, PTR_ERR(imx6_pcie->pcie_bus),
> > > - "pcie_bus clock source missing or invalid\n");
> > > + if (imx6_pcie->drvdata->clks_cnt >= IMX6_PCIE_MAX_CLKS)
> > > + return dev_err_probe(dev, -ENOMEM, "clks_cnt is too big\n");
> >
> > Same question as above, this should not fail if the clks array is
> > dynamically allocated according to imx6_pcie->drvdata->clks_cnt.
>
> Devm_kzalloc also may return NULL. Still need check. This safe check only
> meanful when add new platform. imx6_pcie->drvdata->clks_cnt is static data.
>
> It should never failure at running time. But, devm_kzalloc may failure
> at run time.
>
> It is not big deal. It's most likely personal tast. For small static data,
> I perfer use static memory.

It is fine to keep the static data (but meanful, tast and perfer aren't
English words, a spell checker would fix them, if I may suggest).

Thanks,
Lorenzo