diff mbox

[v7,1/5] mmc: dt-bindings: add ZTE ZX296718 MMC bindings

Message ID 1480904976-7081-2-git-send-email-jun.nie@linaro.org
State Superseded
Headers show

Commit Message

Jun Nie Dec. 5, 2016, 2:29 a.m. UTC
Document the device-tree binding of ZTE MMC host on
ZX296718 SoC.

Signed-off-by: Jun Nie <jun.nie@linaro.org>

---
 .../devicetree/bindings/mmc/zx-dw-mshc.txt         | 35 ++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/mmc/zx-dw-mshc.txt

-- 
1.9.1

--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Comments

Jun Nie Dec. 13, 2016, 2:20 p.m. UTC | #1
2016-12-10 5:47 GMT+08:00 Rob Herring <robh@kernel.org>:
> On Mon, Dec 05, 2016 at 10:29:32AM +0800, Jun Nie wrote:

>> Document the device-tree binding of ZTE MMC host on

>> ZX296718 SoC.

>>

>> Signed-off-by: Jun Nie <jun.nie@linaro.org>

>> ---

>>  .../devicetree/bindings/mmc/zx-dw-mshc.txt         | 35 ++++++++++++++++++++++

>>  1 file changed, 35 insertions(+)

>>  create mode 100644 Documentation/devicetree/bindings/mmc/zx-dw-mshc.txt

>>

>> diff --git a/Documentation/devicetree/bindings/mmc/zx-dw-mshc.txt b/Documentation/devicetree/bindings/mmc/zx-dw-mshc.txt

>> new file mode 100644

>> index 0000000..c175c4b

>> --- /dev/null

>> +++ b/Documentation/devicetree/bindings/mmc/zx-dw-mshc.txt

>> @@ -0,0 +1,35 @@

>> +* ZTE specific extensions to the Synopsys Designware Mobile Storage

>> +  Host Controller

>> +

>> +The Synopsys designware mobile storage host controller is used to interface

>> +a SoC with storage medium such as eMMC or SD/MMC cards. This file documents

>> +differences between the core Synopsys dw mshc controller properties described

>> +by synopsys-dw-mshc.txt and the properties used by the ZTE specific

>> +extensions to the Synopsys Designware Mobile Storage Host Controller.

>> +

>> +Required Properties:

>> +

>> +* compatible: should be

>> +     - "zte,zx296718-dw-mshc": for ZX SoCs

>> +

>> +Example:

>> +

>> +     mmc1: mmc@1110000 {

>> +             compatible = "zte,zx296718-dw-mshc";

>

>> +             #address-cells = <1>;

>> +             #size-cells = <0>;

>

> These aren't needed unless you have child nodes with reg property. The

> DW binding says you should have at least one child.


Will remove them in next version.
>

>> +             reg = <0x01110000 0x1000>;

>> +             interrupts = <GIC_SPI 15 IRQ_TYPE_LEVEL_HIGH>;

>> +             fifo-depth = <32>;

>> +             data-addr = <0x200>;

>> +             fifo-watermark-aligned;

>

> Custom properties should have vendor prefix.


These properties are consumed by DW MMC driver, not by ZTE driver. And
they may reused by SoCs from other vendors that integrate DW MMC IP.
The names are OK in this case?

Jun

>

>> +             bus-width = <4>;

>> +             clock-frequency = <50000000>;

>> +             clocks = <&topcrm SD0_AHB>, <&topcrm SD0_WCLK>;

>> +             clock-names = "biu", "ciu";

>> +             num-slots = <1>;

>> +             max-frequency = <50000000>;

>> +             cap-sdio-irq;

>> +             cap-sd-highspeed;

>> +             status = "disabled";

>> +     };

>> --

>> 1.9.1

>>

--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
diff mbox

Patch

diff --git a/Documentation/devicetree/bindings/mmc/zx-dw-mshc.txt b/Documentation/devicetree/bindings/mmc/zx-dw-mshc.txt
new file mode 100644
index 0000000..c175c4b
--- /dev/null
+++ b/Documentation/devicetree/bindings/mmc/zx-dw-mshc.txt
@@ -0,0 +1,35 @@ 
+* ZTE specific extensions to the Synopsys Designware Mobile Storage
+  Host Controller
+
+The Synopsys designware mobile storage host controller is used to interface
+a SoC with storage medium such as eMMC or SD/MMC cards. This file documents
+differences between the core Synopsys dw mshc controller properties described
+by synopsys-dw-mshc.txt and the properties used by the ZTE specific
+extensions to the Synopsys Designware Mobile Storage Host Controller.
+
+Required Properties:
+
+* compatible: should be
+	- "zte,zx296718-dw-mshc": for ZX SoCs
+
+Example:
+
+	mmc1: mmc@1110000 {
+		compatible = "zte,zx296718-dw-mshc";
+		#address-cells = <1>;
+		#size-cells = <0>;
+		reg = <0x01110000 0x1000>;
+		interrupts = <GIC_SPI 15 IRQ_TYPE_LEVEL_HIGH>;
+		fifo-depth = <32>;
+		data-addr = <0x200>;
+		fifo-watermark-aligned;
+		bus-width = <4>;
+		clock-frequency = <50000000>;
+		clocks = <&topcrm SD0_AHB>, <&topcrm SD0_WCLK>;
+		clock-names = "biu", "ciu";
+		num-slots = <1>;
+		max-frequency = <50000000>;
+		cap-sdio-irq;
+		cap-sd-highspeed;
+		status = "disabled";
+	};