From patchwork Sat May 6 17:18:56 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Martin Blumenstingl X-Patchwork-Id: 9715061 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id D10EF60387 for ; Sat, 6 May 2017 17:19:31 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id BC34E28616 for ; Sat, 6 May 2017 17:19:31 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id B0E7628621; Sat, 6 May 2017 17:19:31 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.3 required=2.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED, FREEMAIL_FROM, RCVD_IN_DNSWL_HI, RCVD_IN_SORBS_SPAM, T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 2831728616 for ; Sat, 6 May 2017 17:19:31 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751658AbdEFRTa (ORCPT ); Sat, 6 May 2017 13:19:30 -0400 Received: from mail-wm0-f67.google.com ([74.125.82.67]:34355 "EHLO mail-wm0-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751440AbdEFRT2 (ORCPT ); Sat, 6 May 2017 13:19:28 -0400 Received: by mail-wm0-f67.google.com with SMTP id z129so7023871wmb.1; Sat, 06 May 2017 10:19:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=6f5xh+Ik8vJr7SuNw3B6lGV3/3MwZZucw/VMVonnwys=; b=ZzU9vp1hJk7UjL8RiCm+/vdT6w91X2VFGi9NMwMNrrLc/UhvPJodL4Q4nfpYIWhDgA u/UbN1qmqz/aEMOJdW83hQDUR6Jae1Mwj2FVsdSyQZZluDnLm/jWk/8ADfLBFbpV4Qg6 qu0e2Jz0pTlvIDMnfvduJpDWzUtPLUGECN8F79dEvTHGdRI+oqSVHJRKzM6FH9VVyMTN FwpVnY2Y2coFZn+9hbp7rG5UcshbCKSRsbAV3noqXKJD0wHaj1aoSJcm3h/iFv5B205k HCKPnINHZ7Wtbv5wz6w316rgery/zJO5108T/MIZmaj+jEBzGd4htj0RUGF+iZ93wwhu Wasg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=6f5xh+Ik8vJr7SuNw3B6lGV3/3MwZZucw/VMVonnwys=; b=pJMTMBXXi3lMitcbgIHLKSJ76PjX97yC9q/V6iKIuGpwgd0Hd/r3MI0eso3wOL4wd1 2BxXpok6wJuH/l9aV46trdoPsvFw4eR2Y6WLYmdYcVcm8jgfxhSf4fcQgLbN0D4slA47 UAs9gMuDMsZe9YfLJiu2g9lOxvozrIVYMibvuem28PHbc4cp12Vur6h/YV0M9lrHbY0R WmyIpRy1gfmaKvIAs77NvxYy6V8I+s5sLlwWTxFI/ObknH4/+98odIjpdntyH2RjPMm0 +GJMQmuv7hHSiYAJ1MMeKHT+Edi7zBeOSM4wSalHpZgzvsimzK9XhZc9NoR2BvPiaEsq GXrQ== X-Gm-Message-State: AN3rC/5SHSO1H1STceoBxvnKQITR0BkY/jXIsFMYudh9uvr0p+lNoeMF eqodhArsxwaWSA== X-Received: by 10.28.24.8 with SMTP id 8mr8040931wmy.23.1494091167219; Sat, 06 May 2017 10:19:27 -0700 (PDT) Received: from blackbox.darklights.net (p200300DCD3E78B041DCA91B6F8D469E4.dip0.t-ipconnect.de. [2003:dc:d3e7:8b04:1dca:91b6:f8d4:69e4]) by smtp.googlemail.com with ESMTPSA id 8sm8440512wrb.55.2017.05.06.10.19.26 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 06 May 2017 10:19:26 -0700 (PDT) From: Martin Blumenstingl To: ulf.hansson@linaro.org, robh+dt@kernel.org, mark.rutland@arm.com, carlo@caione.org, khilman@baylibre.com, linux-mmc@vger.kernel.org, devicetree@vger.kernel.org Cc: linux-arm-kernel@lists.infradead.org, linux-amlogic@lists.infradead.org, Carlo Caione , Martin Blumenstingl Subject: [RFC 1/2] dt-bindings: mmc: Document the Amlogic Meson8 and Meson8b SDIO bindings Date: Sat, 6 May 2017 19:18:56 +0200 Message-Id: <20170506171857.16492-2-martin.blumenstingl@googlemail.com> X-Mailer: git-send-email 2.12.2 In-Reply-To: <20170506171857.16492-1-martin.blumenstingl@googlemail.com> References: <20170506171857.16492-1-martin.blumenstingl@googlemail.com> Sender: linux-mmc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-mmc@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP From: Carlo Caione This documents the devicetree bindings for the SDIO/MMC host found in Amlogic Meson8 and Meson8b SoCs. It supports the SD specification v2.0 and the eMMC specification v4.41. It has an internal "mux" which allows connecting up to three MMC devices to it. The maximum supported bus-width is 4-bits. Amlogic's GPL kernel sources call it "SDIO" to differentiate it from the other MMC controller in (at least the Meson8 and Meson8b) the SoCs (they call the other one "SDHC", which supports a bus-width of up to 8-bits). Signed-off-by: Carlo Caione Signed-off-by: Martin Blumenstingl Acked-by: Rob Herring --- .../bindings/mmc/amlogic,meson-mx-sdio.txt | 50 ++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 Documentation/devicetree/bindings/mmc/amlogic,meson-mx-sdio.txt diff --git a/Documentation/devicetree/bindings/mmc/amlogic,meson-mx-sdio.txt b/Documentation/devicetree/bindings/mmc/amlogic,meson-mx-sdio.txt new file mode 100644 index 000000000000..991c43a602bd --- /dev/null +++ b/Documentation/devicetree/bindings/mmc/amlogic,meson-mx-sdio.txt @@ -0,0 +1,50 @@ +* Amlogic Meson6, Meson8 and Meson8b SDIO/MMC controller + +The highspeed MMC host controller on Amlogic SoCs provides an interface +for MMC, SD, SDIO and SDHC types of memory cards. + +Supported maximum speeds are the ones of the eMMC standard 4.41 as well +as the speed of SD standard 2.0. + +The hardware provides an internal "mux" which allows up to three slots +to be controlled. Only one device can be accessed at a time. + +Required properties: + - compatible : must be one of + - "amlogic,meson8-sdio" + - "amlogic,meson8b-sdio" + along with the generic "amlogic,meson-mx-sdio" + - reg : mmc controller base registers + - interrupts : mmc controller interrupt + - #address-cells : must be 1 + - size-cells : must be 0 + - clocks : phandle to clock providers + - clock-names : must contain "core" and "clkin" + +Required child nodes: +A node for each slot provided by the MMC controller is required. + +Required properties on each child node (= slot): + - reg : the slot (or "port") ID + +Optional properties on each child node (= slot): + - bus-width : must be 1 or 4 (8-bit bus is not supported) + - for cd and all other additional generic mmc parameters + please refer to mmc.txt within this directory + +Examples: + mmc@c1108c20 { + compatible = "amlogic,meson8-sdio", "amlogic,meson-mx-sdio"; + reg = <0xc1108c20 0x20>; + interrupts = <0 28 1>; + #address-cells = <1>; + #size-cells = <0>; + clocks = <&clkc CLKID_SDIO>, <&clkc CLKID_CLK81>; + clock-names = "core", "clkin"; + + slot@1 { + reg = <1>; + + bus-width = <4>; + }; + };