From patchwork Wed Jun 14 08:29:14 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Neil Armstrong X-Patchwork-Id: 9785771 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 9010060325 for ; Wed, 14 Jun 2017 08:33:55 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 74B7E1FF81 for ; Wed, 14 Jun 2017 08:33:55 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 67DF728385; Wed, 14 Jun 2017 08:33:55 +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_SIGNED, DKIM_VALID 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 3CCD51FF81 for ; Wed, 14 Jun 2017 08:33:54 +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=7N9CeyxqxMenL4P2a46XD8gtsqxDNU7Cn5doJBVs6cU=; b=aRE+utB+MMX+d13F/mBuHbn02W R59eqJH/Cfyen934y3NZaPehUjHdzxtL1yhLyf/7z0EOJEAeIcCfJRPDZ2Bom56ET+TzKltrPA597 nOf6imDR2+F3xsfIZhRIDO3OxA9/U2Inr8rkask+wLVDYMVRdjJ0lcrIyYxiO4zFkEFiG8jZgo+5D udV1lDnKpmtrVEa5vfPME/tWQ30D4zINk2QIVq7JkJuXIXbRP8EAYb5VjpRWo/W9DLT4gmPDc6liS 9/VCGwcaZn0Th3il0vwVAj9sn3XaesGHbzM1toU3ScmhmymtEPZen3e67CpCXBpWC6JSZC/BKZHB3 Q1GwLXJw==; 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 1dL3kJ-0001g3-UT; Wed, 14 Jun 2017 08:33:47 +0000 Received: from mail-wr0-x22a.google.com ([2a00:1450:400c:c0c::22a]) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1dL3gP-0006Ul-GA for linux-arm-kernel@lists.infradead.org; Wed, 14 Jun 2017 08:29:49 +0000 Received: by mail-wr0-x22a.google.com with SMTP id 77so30768295wrb.1 for ; Wed, 14 Jun 2017 01:29:24 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=/seBp2vlJQatwyQKxUJapEk5CRsCG7A5jKxObb7bBjE=; b=zanN++ECeI3A7hTDpC5OFvoR9aB72tX6TLF4hIydAI4UySLXpPkE+hexCqBJkaJYci N3NsbQONPhSIqAX2DFWCBnukovs+QQFJQIeruT7d1zKRoFUcihPrGSWlokkc0nYaI0CI Y5DWHd2NMS2HNMjDJkaOgSWzXAhLL+fWi479XoLNb0fLMCmubPnX7mNRXSJHdthmFriO lbx+o10A2zRQejzgrVaMktcBrJrzp48SsLkyBDdjQCJgtAW8AlZATnE891fZF2WusXP4 /mIFp+543WGjjaAaFwE35FqsjN5WNgaKHylkvAPaYOXxP4oqintjBnuKKFrvhaJtfj1o kyXg== 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=/seBp2vlJQatwyQKxUJapEk5CRsCG7A5jKxObb7bBjE=; b=UKkgfhW9SLWCN1iynL0CMvscu6k1taKdx29lP5RsytTuMFFmiSlCq6z7xmkM9ooDHS EQC0JDWiHNocbMgQFkTmBGd22cviNYCalACOSiKbGNB8NEgW1Tp2U5WugnThfE+6HzIu wLOdh3+PJclwhr+476JE6jGAZ2T87Tyy4E1rAQjwXu31OoPy8ozB7yIaCjxk8T7Ycdcv 7KRBDmocwkF6NLPIKcN8Frebgjj91uKhFkRiGwHIMBKC3u6Rmy/zLyZBBPGsxXiVXWcO FM5XYamj/jnWAu4I9z8pwp32NFi7prr/7ze/nTQnMSIq+zOTqT4H5HW1jJKFepkuuXhq Pppg== X-Gm-Message-State: AKS2vOybiGgTiQiqnWom6FZmr30S3q7/p685V/epfzsjX5q/aO9OPifa 3xbCM4dQopIoYE4m X-Received: by 10.223.163.11 with SMTP id c11mr5568772wrb.185.1497428963603; Wed, 14 Jun 2017 01:29:23 -0700 (PDT) Received: from localhost.localdomain (home.amouriers.starnux.net. [82.228.250.61]) by smtp.gmail.com with ESMTPSA id 62sm321192wra.44.2017.06.14.01.29.22 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 14 Jun 2017 01:29:23 -0700 (PDT) From: Neil Armstrong To: gregkh@linuxfoundation.org, khilman@baylibre.com Subject: [PATCH v5 1/4] dt-bindings: serial: Add bindings for the Amlogic Meson UARTs Date: Wed, 14 Jun 2017 10:29:14 +0200 Message-Id: <1497428957-19942-2-git-send-email-narmstrong@baylibre.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1497428957-19942-1-git-send-email-narmstrong@baylibre.com> References: <1497428957-19942-1-git-send-email-narmstrong@baylibre.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20170614_012945_685291_B4862D69 X-CRM114-Status: GOOD ( 15.02 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: devicetree@vger.kernel.org, Neil Armstrong , linux-kernel@vger.kernel.org, Helmut Klein , linux-serial@vger.kernel.org, linux-amlogic@lists.infradead.org, linux-arm-kernel@lists.infradead.org MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP From: Helmut Klein Add the documentation for the device tree binding of Amlogic Meson Serial UART. Signed-off-by: Helmut Klein Signed-off-by: Neil Armstrong Acked-by: Rob Herring --- .../bindings/serial/amlogic,meson-uart.txt | 38 ++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 Documentation/devicetree/bindings/serial/amlogic,meson-uart.txt diff --git a/Documentation/devicetree/bindings/serial/amlogic,meson-uart.txt b/Documentation/devicetree/bindings/serial/amlogic,meson-uart.txt new file mode 100644 index 0000000..8ff65fa --- /dev/null +++ b/Documentation/devicetree/bindings/serial/amlogic,meson-uart.txt @@ -0,0 +1,38 @@ +Amlogic Meson SoC UART Serial Interface +======================================= + +The Amlogic Meson SoC UART Serial Interface is present on a large range +of SoCs, and can be present either in the "Always-On" power domain or the +"Everything-Else" power domain. + +The particularity of the "Always-On" Serial Interface is that the hardware +is active since power-on and does not need any clock gating and is usable +as very early serial console. + +Required properties: +- compatible : compatible: value should be different for each SoC family as : + - Meson6 : "amlogic,meson6-uart" + - Meson8 : "amlogic,meson8-uart" + - Meson8b : "amlogic,meson8b-uart" + - GX (GXBB, GXL, GXM) : "amlogic,meson-gx-uart" + eventually followed by : "amlogic,meson-ao-uart" if this UART interface + is in the "Always-On" power domain. +- reg : offset and length of the register set for the device. +- interrupts : identifier to the device interrupt +- clocks : a list of phandle + clock-specifier pairs, one for each + entry in clock names. +- clocks-names : + * "xtal" for external xtal clock identifier + * "pclk" for the bus core clock, either the clk81 clock or the gate clock + * "baud" for the source of the baudrate generator, can be either the xtal + or the pclk. + +e.g. +uart_A: serial@84c0 { + compatible = "amlogic,meson-gx-uart"; + reg = <0x0 0x84c0 0x0 0x14>; + interrupts = ; + /* Use xtal as baud rate clock source */ + clocks = <&xtal>, <&clkc CLKID_UART0>, <&xtal>; + clock-names = "xtal", "pclk", "baud"; +};