From patchwork Sun Sep 24 19:05:27 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Martin Blumenstingl X-Patchwork-Id: 9968165 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 BE99B602D8 for ; Sun, 24 Sep 2017 19:07:16 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id AAAE028931 for ; Sun, 24 Sep 2017 19:07:16 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 9F6E828945; Sun, 24 Sep 2017 19:07:16 +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=-4.2 required=2.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED, DKIM_VALID, FREEMAIL_FROM, RCVD_IN_DNSWL_MED 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 EA75128931 for ; Sun, 24 Sep 2017 19:07:14 +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=H7Zn73MIqNvb32QJvNj8g8XMGIn+m1/HGFaFHtQTFig=; b=iInib95r+iRPCBcSyvFYMijfe6 dLGlQ+SdHOQe3N22QIZg7WgnTualJqTLX4iP0EOvYLHHAxtS1kh4D3lpSaD2Cq89BzlSRVq3k+tZq 1TSEy7pY0DDa5/JKTtkZXcyj8a2x0zt5RQ9L9NkNrJBT+5wa7w8fkLNqYU6jpzg4DW9Vpc93/TWHA GC3YlVf5SoAN8LDwVm9cECzVbxekx3h4I9LgdqUeZu1DUo3A8uv0/4l/lYMqhVx+FGejHkfT++ECO 4tubTq9Rsw1JAz8P6aucB6jUDjFNI5i1TSAe2zZBZnG2Njeu4qIj9Nel1GmOi8gMsvBzj9+zhtLPD RDbK0aXQ==; 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 1dwCEW-0007ID-1a; Sun, 24 Sep 2017 19:06:28 +0000 Received: from mail-wr0-x243.google.com ([2a00:1450:400c:c0c::243]) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1dwCE5-0006Ma-RT; Sun, 24 Sep 2017 19:06:04 +0000 Received: by mail-wr0-x243.google.com with SMTP id g50so227032wra.3; Sun, 24 Sep 2017 12:05:42 -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=JgSIOeOBXVp6n4nYEsny/yXMg0AZBO3Mk4Mc2u8cmRM=; b=baxo6sFXL5ESPVVR2j+6HFv/uA0Eb3+CujugI2AyyvnxgYAreyRm8b41Fo9AjT7JPR tvxziMhL1Ary4LOXWUwcDvhamYq5O8W7b2MhE/uVr2i005VeKw+LsSnCtkpFEyuwrJbS of7AsqGH/SmM++fwzQk7VvMgaZgHofVQe3lZ47jXSJG9F3P4ig4wt44zZ/hKgGTMf2+H lMuowbFQZbdhE6ER9FPFDCqG99wce7VeqoIfuBjgqu8AxrslOUdSypKTfXJ0suVJkQ8O YAiWaBHyRq1dVnSfEt9nQazypcz6ltNiSrd9576NnhFHes2MsIAZZfgHQm8z0nNIARe9 aYRA== 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=JgSIOeOBXVp6n4nYEsny/yXMg0AZBO3Mk4Mc2u8cmRM=; b=MAqzAmxDd2EAwObQEgzdzruO5Y+XIQ8h4tkLiW9b4d9OZRP90lo+Sj2xWkNlu7OXKr 6/eMImDtAcwjM/sxPKX7anzU5auet6VKHInADyl8ECiiDDFJtZOjN8xyrCyHdWtAcdab 5Ye8LOunLM7e12PzjVCZSDNTUt641+64yo5qkbxRh9hXENRIL+9b2SGNsopHkY7HCLDv pvs/UeXG67y8hDi2tkYWq6t+wmZ9DryxG3EOKt7nIf44LUp85A7w7bQXaxH7oPBwSf12 VMu+Y45GjzWlg4hLV4IlIFzQUSnyQiBbZGJzQPGarIDZrcdBoVdqsfhc2+db0LzU9OZH 20Mw== X-Gm-Message-State: AHPjjUjF0WZ6Kz5mIoIRbddh8Cbc3XHusOOFwDDIkb3TURNMJQ+eGZn6 hHKEc9/YG5fl2/oa4u+jKKI= X-Google-Smtp-Source: AOwi7QDMk4+QB1VONNVXcQC0+MltnD3bpdTNAGUN1IeH5mXkNiTElpZ6L5ZNqTBG2zbl4/NRvjuGHg== X-Received: by 10.223.161.212 with SMTP id v20mr4581998wrv.195.1506279940722; Sun, 24 Sep 2017 12:05:40 -0700 (PDT) Received: from blackbox.darklights.net (p200300DCD3F64404C87FF7F0485B6A54.dip0.t-ipconnect.de. [2003:dc:d3f6:4404:c87f:f7f0:485b:6a54]) by smtp.googlemail.com with ESMTPSA id v78sm2402039wmv.48.2017.09.24.12.05.39 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 24 Sep 2017 12:05:40 -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 v2 1/2] dt-bindings: mmc: Document the Amlogic Meson8 and Meson8b SDIO bindings Date: Sun, 24 Sep 2017 21:05:27 +0200 Message-Id: <20170924190528.21841-2-martin.blumenstingl@googlemail.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20170924190528.21841-1-martin.blumenstingl@googlemail.com> References: <20170924190528.21841-1-martin.blumenstingl@googlemail.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20170924_120602_136268_C330E959 X-CRM114-Status: GOOD ( 13.50 ) 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 | 52 ++++++++++++++++++++++ 1 file changed, 52 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..124ea362eec9 --- /dev/null +++ b/Documentation/devicetree/bindings/mmc/amlogic,meson-mx-sdio.txt @@ -0,0 +1,52 @@ +* 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 slot 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): + - compatible : must be "mmc-slot" (see mmc.txt within this directory) + - 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 { + compatible = "mmc-slot"; + reg = <1>; + + bus-width = <4>; + }; + };