From patchwork Tue Oct 3 11:24:16 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Martin Blumenstingl X-Patchwork-Id: 9982271 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 C9B6E60375 for ; Tue, 3 Oct 2017 11:24:31 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id B43FC287E0 for ; Tue, 3 Oct 2017 11:24:31 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id A8DD6287EC; Tue, 3 Oct 2017 11:24: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 7B803287E0 for ; Tue, 3 Oct 2017 11:24:30 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751421AbdJCLY3 (ORCPT ); Tue, 3 Oct 2017 07:24:29 -0400 Received: from mail-wm0-f65.google.com ([74.125.82.65]:50976 "EHLO mail-wm0-f65.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750720AbdJCLY2 (ORCPT ); Tue, 3 Oct 2017 07:24:28 -0400 Received: by mail-wm0-f65.google.com with SMTP id u138so15907225wmu.5; Tue, 03 Oct 2017 04:24:27 -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=nN8FR0acL/pXKY1gHJeyLVEKN6fa3EtNxsWjfPfOHsU=; b=crxoIr//BmJr6Sx+dA9qBhXn3QkwpGoHj7jb+nIHuUnIQ4v3L01uUL5wtKdfhjC0QO NISNrtN1Mb+eDPVbuUkFJr/SXIxhBOkMP6Edt4vkZSsWfJGut8/JQytHZmaOahcyjz6Q EgeO32D3IFrnIox1IE8J54C9IcP0PmuqmiN0Ti0O1WN2QplDUhzbEEe/h8xDbfOTjVGQ u81BXREHfMbcjkjNAS2OlFAl0JWIPXkesgzzbWI5O7LG+KH4eYQVvQFl25PAn6XFFqeE xyNGWVtmyxkCcqgyY3YdOxFhOFtfiEBXZb4/O/8KCqNrkad7Oz6knEuobNnvIvlE66Pc u1qA== 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=nN8FR0acL/pXKY1gHJeyLVEKN6fa3EtNxsWjfPfOHsU=; b=EyCZA8+OLpEVN3rsJ3MDQnPTqwfy14/pOWBqJl/QyJf3QUwS+THSWHJchUj9dxyVve fK1qUjO/ZiB7FzsjGGmojC6m/74jEv1SLLVyJLnQGAEzO/feXcUT1NsHSZIOGAXmXqqj RASvsBJeesQUtUlNncgX4ndqrRhoGxkOuc7+OYM0LGIfLgBP57G2HUhy/2MssyG4F3Pu Vp5MMnMsSgsWoPFmRfL3j/gZrC2S3+0NYnMg4hNETcKkAbVMo0WQFu4sdtkF9tL3+udc oimU1rrqhjFLb3QGfUwugDW50+NddaBh4yHbM46Op64bPbR+VpgBSFWHSQZZgIZJfksl qa/g== X-Gm-Message-State: AMCzsaWmU7vV2C+RazrlUdQU2ounnxlqUbt22zY1hB1e5C6DZLN1kwoT 41XfSKggDDOSqUGeD0Kjp50= X-Google-Smtp-Source: AOwi7QD07uPJkGo0aNpJK4wriG8yN0IvH13DfFvculsUg4c84dje9Hj+sVlUtwlGJZfVyAG32xKmlA== X-Received: by 10.28.196.79 with SMTP id u76mr10092205wmf.95.1507029865906; Tue, 03 Oct 2017 04:24:25 -0700 (PDT) Received: from blackbox.darklights.net (p5DD9B1F6.dip0.t-ipconnect.de. [93.217.177.246]) by smtp.googlemail.com with ESMTPSA id k126sm24567234wmd.1.2017.10.03.04.24.24 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 03 Oct 2017 04:24:25 -0700 (PDT) From: Martin Blumenstingl To: ulf.hansson@linaro.org, linux-mmc@vger.kernel.org Cc: robh+dt@kernel.org, mark.rutland@arm.com, carlo@caione.org, khilman@baylibre.com, devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-amlogic@lists.infradead.org, Carlo Caione , Martin Blumenstingl Subject: [PATCH v3 1/2] dt-bindings: mmc: Document the Amlogic Meson8 and Meson8b SDIO bindings Date: Tue, 3 Oct 2017 13:24:16 +0200 Message-Id: <20171003112417.31860-2-martin.blumenstingl@googlemail.com> X-Mailer: git-send-email 2.14.2 In-Reply-To: <20171003112417.31860-1-martin.blumenstingl@googlemail.com> References: <20171003112417.31860-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 | 54 ++++++++++++++++++++++ 1 file changed, 54 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..8765c605e6bc --- /dev/null +++ b/Documentation/devicetree/bindings/mmc/amlogic,meson-mx-sdio.txt @@ -0,0 +1,54 @@ +* 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. +NOTE: due to a driver limitation currently only one slot (= child node) + is supported! + +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>; + }; + };