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: 9715069 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 055D960387 for ; Sat, 6 May 2017 17:20:31 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id E4AFB2861E for ; Sat, 6 May 2017 17:20:30 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id D975B28622; Sat, 6 May 2017 17:20:30 +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=-1.9 required=2.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED, DKIM_VALID, FREEMAIL_FROM autolearn=unavailable version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [65.50.211.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 947F62861E for ; Sat, 6 May 2017 17:20:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:MIME-Version:Cc:List-Subscribe: List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id:References: In-Reply-To:Message-Id:Date:Subject:To:From:Reply-To:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:List-Owner; bh=XaScFNRVj7X+7+iihaGnXud+8Yuajg8pQeDJEiRzwQo=; b=nwZZeA/asHQAwnhrKJ4L7Wpx7C cPzQbmBHRXEZKb4duaIhJPmOJ8cOBiQKXVMdVnPGoaCYELm1R+c/g8MkmWTb/n6vv0NngMZ6Kthq0 dtaMMm4m/AZumwaYjMzQtKOYm81lle91EatuHmj9Y3gqRSiBZSOLgV4zh60eR0DPKHYIZoTiVIglb YQTBkc+TIyboOj1ROYc8Bi3fzP4aLttrNQyg1iRsNvepoOV0AlNc5H12xgBGmCxWwzy8eVQciQy4y Qyre+v5rTg40uLS7Z3lrqrpVbHefK+hd5Cb/PA7niRGxZqcXRlBVBeRC1iocXjeilDdNVg6yHSRax CVsAPlAA==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.87 #1 (Red Hat Linux)) id 1d73NU-0000Hg-Jr; Sat, 06 May 2017 17:20:20 +0000 Received: from mail-wm0-x242.google.com ([2a00:1450:400c:c09::242]) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1d73My-0006vv-Mm; Sat, 06 May 2017 17:19:50 +0000 Received: by mail-wm0-x242.google.com with SMTP id v4so2124145wmb.2; 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=hvGLGIWE1wXuRpg8WhIw1r1GePc4PXWQHIjEktmmv2UuvHk8Fmkq1U9PXHiHR+1iZj XzuapQyVGOc7zT6/xfsATXDI7cUdHtDOB5dGV5s1j0PeCmWDBjDX82BMvxVTgUcfYLof wxnISAHGKz3hug8wMzxS1AODupMSBTVdFhx+J/e2peLXABCtZJDzTsET5pawRQJUbEkC R0wbo2CxPNlOHNVKOJbmRQy3MSBTJqn9740xioTPDCgPQvuUAeU+u/7kres6hiSsV9EU iV4kZUvUQ3Sw6bvsVBvcE0KcyozM1oQ/Ag6jzsTLdAXOUW18Q5BFNbJj776uquUxS28x nW8g== X-Gm-Message-State: AN3rC/74tPS2eXj0hf/mdTBU0xpQ1ZFZI6Nb9sRZuzMjPKxVCibom7yG i8dh7ILV/hRtKp6iNqY= 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 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> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20170506_101948_893627_8F4DC6EE X-CRM114-Status: GOOD ( 13.46 ) X-BeenThere: linux-amlogic@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Martin Blumenstingl , linux-amlogic@lists.infradead.org, Carlo Caione , linux-arm-kernel@lists.infradead.org MIME-Version: 1.0 Sender: "linux-amlogic" Errors-To: linux-amlogic-bounces+patchwork-linux-amlogic=patchwork.kernel.org@lists.infradead.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>; + }; + };