Re: [PATCH v6 2/2] mmc: host: meson-mx-sdhc: new driver for the Amlogic Meson SDHC host

From: Jerome Brunet
Date: Thu Apr 30 2020 - 08:04:47 EST


On Thu 30 Apr 2020 at 13:10, Ulf Hansson <ulf.hansson@xxxxxxxxxx> wrote:

> + Stephen
>
> On Thu, 30 Apr 2020 at 11:47, Jerome Brunet <jbrunet@xxxxxxxxxxxx> wrote:
>>
>>
>> On Tue 28 Apr 2020 at 23:02, Martin Blumenstingl <martin.blumenstingl@xxxxxxxxxxxxxx> wrote:
>>
>> > The SDHC MMC host controller on Amlogic SoCs provides an eMMC and MMC
>> > card interface with 1/4/8-bit bus width.
>> > It supports eMMC spec 4.4x/4.5x including HS200 (up to 100MHz clock).
>> >
>> > The public S805 datasheet [0] contains a short documentation about the
>> > registers. Unfortunately it does not describe how to use the registers
>> > to make the hardware work. Thus this driver is based on reading (and
>> > understanding) the Amlogic 3.10 GPL kernel code.
>> >
>> > Some hardware details are not easy to see. Jianxin Pan was kind enough
>> > to answer my questions:
>> > The hardware has built-in busy timeout support. The maximum timeout is
>> > 30 seconds. This is only documented in Amlogic's internal
>> > documentation.
>> >
>> > The controller only works with very specific clock configurations. The
>> > details are not part of the public datasheet. In my own words the
>> > supported configurations are:
>> > - 399.812kHz: clkin = 850MHz div = 2126 sd_rx_phase = 63
>> > - 1MHz: clkin = 850MHz div = 850 sd_rx_phase = 55
>> > - 5.986MHz: clkin = 850MHz div = 142 sd_rx_phase = 24
>> > - 25MHz: clkin = 850MHz div = 34 sd_rx_phase = 15
>> > - 47.222MHz: clkin = 850MHz div = 18 sd_rx_phase = 11/15 (SDR50/HS)
>> > - 53.125MHz: clkin = 850MHz div = 16 sd_rx_phase = (tuning)
>> > - 70.833MHz: clkin = 850MHz div = 12 sd_rx_phase = (tuning)
>> > - 85MHz: clkin = 850MHz div = 10 sd_rx_phase = (tuning)
>> > - 94.44MHz: clkin = 850MHz div = 9 sd_rx_phase = (tuning)
>> > - 106.25MHz: clkin = 850MHz div = 8 sd_rx_phase = (tuning)
>> > - 127.5MHz: clkin = 1275MHz div = 10 sd_rx_phase = (tuning)
>> > - 141.667MHz: clkin = 850MHz div = 6 sd_rx_phase = (tuning)
>> > - 159.375MHz: clkin = 1275MHz div = 8 sd_rx_phase = (tuning)
>> > - 212.5MHz: clkin = 1275MHz div = 6 sd_rx_phase = (tuning)
>> > - (sd_tx_phase is always 1, 94.44MHz is not listed in the datasheet
>> > but this is what the 3.10 BSP kernel on Odroid-C1 actually uses)
>> >
>> > NOTE: CMD23 support is disabled for now because it results in command
>> > timeouts and thus decreases read performance.
>> >
>> > Tested-by: Wei Wang <lnykww@xxxxxxxxx>
>> > Tested-by: Xin Yin <yinxin_1989@xxxxxxxxxx>
>> > Reviewed-by: Xin Yin <yinxin_1989@xxxxxxxxxx>
>> > Tested-by: Anand Moon <linux.amoon@xxxxxxxxx>
>> > Signed-off-by: Martin Blumenstingl <martin.blumenstingl@xxxxxxxxxxxxxx>
>> > ---
>> > drivers/mmc/host/Kconfig | 14 +
>> > drivers/mmc/host/Makefile | 1 +
>> > drivers/mmc/host/meson-mx-sdhc-clkc.c | 188 ++++++
>> > drivers/mmc/host/meson-mx-sdhc.c | 916 ++++++++++++++++++++++++++
>> > drivers/mmc/host/meson-mx-sdhc.h | 138 ++++
>> > 5 files changed, 1257 insertions(+)
>> > create mode 100644 drivers/mmc/host/meson-mx-sdhc-clkc.c
>> > create mode 100644 drivers/mmc/host/meson-mx-sdhc.c
>> > create mode 100644 drivers/mmc/host/meson-mx-sdhc.h
>> >
>> > diff --git a/drivers/mmc/host/Kconfig b/drivers/mmc/host/Kconfig
>> > index 462b5352fea7..df3fc572f842 100644
>> > --- a/drivers/mmc/host/Kconfig
>> > +++ b/drivers/mmc/host/Kconfig
>> > @@ -405,6 +405,20 @@ config MMC_MESON_GX
>> >
>> > If you have a controller with this interface, say Y here.
>> >
>> > +config MMC_MESON_MX_SDHC
>> > + tristate "Amlogic Meson SDHC Host Controller support"
>> > + depends on (ARM && ARCH_MESON) || COMPILE_TEST
>> > + depends on COMMON_CLK
>> > + depends on OF
>> > + help
>> > + This selects support for the SDHC Host Controller on
>> > + Amlogic Meson6, Meson8, Meson8b and Meson8m2 SoCs.
>> > + The controller supports the SD/SDIO Spec 3.x and eMMC Spec 4.5x
>> > + with 1, 4, and 8 bit bus widths.
>> > +
>> > + If you have a controller with this interface, say Y or M here.
>> > + If unsure, say N.
>> > +
>> > config MMC_MESON_MX_SDIO
>> > tristate "Amlogic Meson6/Meson8/Meson8b SD/MMC Host Controller support"
>> > depends on ARCH_MESON || COMPILE_TEST
>> > diff --git a/drivers/mmc/host/Makefile b/drivers/mmc/host/Makefile
>> > index b929ef941208..8bcb420e071c 100644
>> > --- a/drivers/mmc/host/Makefile
>> > +++ b/drivers/mmc/host/Makefile
>> > @@ -68,6 +68,7 @@ obj-$(CONFIG_MMC_VUB300) += vub300.o
>> > obj-$(CONFIG_MMC_USHC) += ushc.o
>> > obj-$(CONFIG_MMC_WMT) += wmt-sdmmc.o
>> > obj-$(CONFIG_MMC_MESON_GX) += meson-gx-mmc.o
>> > +obj-$(CONFIG_MMC_MESON_MX_SDHC) += meson-mx-sdhc-clkc.o meson-mx-sdhc.o
>> > obj-$(CONFIG_MMC_MESON_MX_SDIO) += meson-mx-sdio.o
>> > obj-$(CONFIG_MMC_MOXART) += moxart-mmc.o
>> > obj-$(CONFIG_MMC_SUNXI) += sunxi-mmc.o
>> > diff --git a/drivers/mmc/host/meson-mx-sdhc-clkc.c b/drivers/mmc/host/meson-mx-sdhc-clkc.c
>> > new file mode 100644
>> > index 000000000000..1e9dea94f9dc
>> > --- /dev/null
>> > +++ b/drivers/mmc/host/meson-mx-sdhc-clkc.c
>> > @@ -0,0 +1,188 @@
>> > +// SPDX-License-Identifier: GPL-2.0+
>> > +/*
>> > + * Amlogic Meson SDHC clock controller
>> > + *
>> > + * Copyright (C) 2020 Martin Blumenstingl <martin.blumenstingl@xxxxxxxxxxxxxx>
>> > + */
>> > +
>> > +#include <dt-bindings/clock/meson-mx-sdhc-clkc.h>
>> > +
>> > +#include <linux/clk-provider.h>
>> > +#include <linux/device.h>
>> > +#include <linux/platform_device.h>
>> > +
>> > +#include "meson-mx-sdhc.h"
>> > +
>> > +#define MESON_SDHC_NUM_BUILTIN_CLKS 6
>> > +
>> > +struct meson_mx_sdhc_clkc {
>> > + struct clk_mux src_sel;
>> > + struct clk_divider div;
>> > + struct clk_gate mod_clk_en;
>> > + struct clk_gate tx_clk_en;
>> > + struct clk_gate rx_clk_en;
>> > + struct clk_gate sd_clk_en;
>> > + struct clk_hw_onecell_data hw_onecell_data;
>> > +};
>> > +
>> > +static const struct clk_div_table meson_mx_sdhc_div_table[] = {
>> > + { .div = 6, .val = 5, },
>> > + { .div = 8, .val = 7, },
>> > + { .div = 9, .val = 8, },
>> > + { .div = 10, .val = 9, },
>> > + { .div = 12, .val = 11, },
>> > + { .div = 16, .val = 15, },
>> > + { .div = 18, .val = 17, },
>> > + { .div = 34, .val = 33, },
>> > + { .div = 142, .val = 141, },
>> > + { .div = 850, .val = 849, },
>> > + { .div = 2126, .val = 2125, },
>> > + { .div = 4096, .val = 4095, },
>> > + { /* sentinel */ }
>> > +};
>> > +
>> > +static const struct meson_mx_sdhc_clkc meson_mx_sdhc_clkc_data = {
>> > + .src_sel = {
>> > + .mask = 0x3,
>> > + .shift = 16,
>> > + },
>> > + .div = {
>> > + .shift = 0,
>> > + .width = 12,
>> > + .table = meson_mx_sdhc_div_table,
>> > + },
>> > + .mod_clk_en = {
>> > + .bit_idx = 15,
>> > + },
>> > + .tx_clk_en = {
>> > + .bit_idx = 14,
>> > + },
>> > + .rx_clk_en = {
>> > + .bit_idx = 13,
>> > + },
>> > + .sd_clk_en = {
>> > + .bit_idx = 12,
>> > + },
>> > +};
>> > +
>> > +static const struct clk_init_data meson_mx_sdhc_clkc_init_data[] = {
>> > + [SDHC_CLKID_SRC_SEL] = {
>> > + .name = "sdhc_src_sel",
>> > + .ops = &clk_mux_ops,
>> > + .parent_data = (const struct clk_parent_data[]) {
>> > + { .fw_name = "clkin0" },
>> > + { .fw_name = "clkin1" },
>> > + { .fw_name = "clkin2" },
>> > + { .fw_name = "clkin3" },
>> > + },
>> > + .num_parents = 4,
>> > + },
>> > + [SDHC_CLKID_DIV] = {
>> > + .name = "sdhc_div",
>> > + .ops = &clk_divider_ops,
>> > + .parent_hws = (const struct clk_hw *[]) {
>> > + &meson_mx_sdhc_clkc_data.src_sel.hw,
>> > + },
>> > + .num_parents = 1,
>> > + .flags = CLK_SET_RATE_PARENT,
>> > + },
>> > + [SDHC_CLKID_MOD_CLK] = {
>> > + .name = "sdhc_mod_clk_on",
>> > + .ops = &clk_gate_ops,
>> > + .parent_hws = (const struct clk_hw *[]) {
>> > + &meson_mx_sdhc_clkc_data.div.hw,
>> > + },
>> > + .num_parents = 1,
>> > + .flags = CLK_SET_RATE_PARENT,
>> > + },
>> > + [SDHC_CLKID_SD_CLK] = {
>> > + .name = "sdhc_tx_clk_on",
>> > + .ops = &clk_gate_ops,
>> > + .parent_hws = (const struct clk_hw *[]) {
>> > + &meson_mx_sdhc_clkc_data.div.hw,
>> > + },
>> > + .num_parents = 1,
>> > + .flags = CLK_SET_RATE_PARENT,
>> > + },
>> > + [SDHC_CLKID_TX_CLK] = {
>> > + .name = "sdhc_rx_clk_on",
>> > + .ops = &clk_gate_ops,
>> > + .parent_hws = (const struct clk_hw *[]) {
>> > + &meson_mx_sdhc_clkc_data.div.hw,
>> > + },
>> > + .num_parents = 1,
>> > + .flags = CLK_SET_RATE_PARENT,
>> > + },
>> > + [SDHC_CLKID_RX_CLK] = {
>> > + .name = "sdhc_sd_clk_on",
>> > + .ops = &clk_gate_ops,
>> > + .parent_hws = (const struct clk_hw *[]) {
>> > + &meson_mx_sdhc_clkc_data.div.hw,
>> > + },
>> > + .num_parents = 1,
>> > + .flags = CLK_SET_RATE_PARENT,
>> > + },
>> > +};
>>
>> That quite lot of structures.
>> The interesting information is the parent and divider table mostly, and
>> a few defines for the bit_idx.
>>
>> I feel this could be simplified so it is easier to follow.
>> Maybe something in the same fashion as meson8b-dwmac driver ?
>>
>> > +
>> > +int meson_mx_sdhc_register_clkc(struct device *dev, void __iomem *base)
>> > +{
>> > + const struct clk_hw *div_parents[1], *gate_parents[1];
>> > + struct clk_hw_onecell_data *onecell_data;
>> > + struct meson_mx_sdhc_clkc *clkc_data;
>> > + struct clk_init_data init_data;
>> > + int i, ret;
>> > +
>> > + clkc_data = devm_kzalloc(dev, struct_size(clkc_data,
>> > + hw_onecell_data.hws,
>> > + MESON_SDHC_NUM_BUILTIN_CLKS),
>> > + GFP_KERNEL);
>> > + if (!clkc_data)
>> > + return -ENOMEM;
>> > +
>> > + memcpy(clkc_data, &meson_mx_sdhc_clkc_data,
>> > + sizeof(meson_mx_sdhc_clkc_data));
>> > +
>> > + div_parents[0] = &clkc_data->src_sel.hw;
>> > + gate_parents[0] = &clkc_data->div.hw;
>> > +
>> > + clkc_data->src_sel.reg = base + MESON_SDHC_CLKC;
>> > + clkc_data->div.reg = base + MESON_SDHC_CLKC;
>> > + clkc_data->mod_clk_en.reg = base + MESON_SDHC_CLKC;
>> > + clkc_data->sd_clk_en.reg = base + MESON_SDHC_CLKC;
>> > + clkc_data->tx_clk_en.reg = base + MESON_SDHC_CLKC;
>> > + clkc_data->rx_clk_en.reg = base + MESON_SDHC_CLKC;
>> > +
>> > + onecell_data = &clkc_data->hw_onecell_data;
>> > + onecell_data->hws[SDHC_CLKID_SRC_SEL] = &clkc_data->src_sel.hw;
>> > + onecell_data->hws[SDHC_CLKID_DIV] = &clkc_data->div.hw;
>> > + onecell_data->hws[SDHC_CLKID_MOD_CLK] = &clkc_data->mod_clk_en.hw;
>> > + onecell_data->hws[SDHC_CLKID_SD_CLK] = &clkc_data->sd_clk_en.hw;
>> > + onecell_data->hws[SDHC_CLKID_TX_CLK] = &clkc_data->tx_clk_en.hw;
>> > + onecell_data->hws[SDHC_CLKID_RX_CLK] = &clkc_data->rx_clk_en.hw;
>> > +
>> > + for (i = 0; i < MESON_SDHC_NUM_BUILTIN_CLKS; i++) {
>> > + init_data = meson_mx_sdhc_clkc_init_data[i];
>> > +
>> > + if (i == SDHC_CLKID_SRC_SEL)
>> > + /* uses clk_parent_data instead */
>> > + init_data.parent_hws = NULL;
>> > + else if (i == SDHC_CLKID_DIV)
>> > + init_data.parent_hws = div_parents;
>> > + else
>> > + init_data.parent_hws = gate_parents;
>> > +
>> > + onecell_data->hws[i]->init = &init_data;
>> > +
>> > + ret = devm_clk_hw_register(dev, onecell_data->hws[i]);
>> > + if (ret) {
>> > + dev_err(dev, "Registration of SDHC clock %d failed\n",
>> > + i);
>> > + return ret;
>> > + }
>> > + }
>> > +
>> > + onecell_data->num = MESON_SDHC_NUM_BUILTIN_CLKS;
>> > +
>> > + return devm_of_clk_add_hw_provider(dev, of_clk_hw_onecell_get,
>> > + onecell_data);
>>
>> I think registering a provider for a module that does not provide clocks
>> to any other device is a bit overkill.
>>
>> I understand the matter is getting the per-user clk* pointer.
>> Since this is the module registering the clock, you can use clk_hw->clk
>> to get it.
>>
>> Once you have the clk* of the leaf clocks, you don't even need to keep
>> track of the clk_hw* since you are using devm_
>>
>> Afterward, we should propably discuss with Stephen if something should
>> be added in CCF to get a struct clk* from struct clk_hw*.
>>
>
> [...]
>
> Hmm.
>
> I am not sure the above is a good idea, at all. Unless, I am
> misunderstanding your point, which may be the case.
>
> I think above "shortcuts" could lead to abuse of the clock framework
> and its internal data structures. When going forward, this could make
> it unnecessary harder to maintain the clock framework.
>
> I know, it's not my responsibility, but from my experience with MMC
> and SDIO interfaces, is that those have been too easy abuse - since
> most of the data structures and interfaces have been exported. Now,
> it's hard to roll back that, if you see what I mean.

Indeed, it worth clarifying this first.

With clk_register deprecated in favor of clk_hw_register, we are likely
to see that case rise elsewhere.

>
>> > +}
>> > diff --git a/drivers/mmc/host/meson-mx-sdhc.c b/drivers/mmc/host/meson-mx-sdhc.c
>> > new file mode 100644
>> > index 000000000000..3c54d5f91fbc
>> > --- /dev/null
>> > +++ b/drivers/mmc/host/meson-mx-sdhc.c
>> > @@ -0,0 +1,916 @@
>> > +// SPDX-License-Identifier: GPL-2.0+
>> > +/*
>> > + * Amlogic Meson6/Meson8/Meson8b/Meson8m2 SDHC MMC host controller driver.
>> > + *
>> > + * Copyright (C) 2020 Martin Blumenstingl <martin.blumenstingl@xxxxxxxxxxxxxx>
>> > + */
>
> [...]
>
> Kind regards
> Uffe