From patchwork Fri Jun 9 09:49:10 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Neil Armstrong X-Patchwork-Id: 9777805 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 E102960350 for ; Fri, 9 Jun 2017 09:50:12 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id C83D628421 for ; Fri, 9 Jun 2017 09:50:12 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id BCF412855A; Fri, 9 Jun 2017 09:50:12 +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=ham 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 3DBE028421 for ; Fri, 9 Jun 2017 09:50:12 +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=CDxNEPsBW1jWHEddUDH0XmpnIa 68gC0gXpf23JB2oK1zkkPEV39tEMeuMihB9OpfoowiA5Op7PKXHF7oYAuAJrfctJtqPA2/0ms7K0w n/CfD+tp7oggdVXmt5ncFv6Y3OpgkLDfXEIWyfnzNCsAXhXuWU5Qlzm4im1QZbPnj5rVvN7cXGcTL la0lZgjqcrU3Lo+hehF3Wr46i+rcotaIUmK2ISMly8BB8EwMLERi3dp5U4KdoYClOBkILbRuyDOak EnGWu6Jbj7IWkDGANhWHw7sWlq39FKS+Xd56NU2IyKRzc6cFAraQ7R7o8XXmIdYXCyK3pqHEGWzWF vq5rH9ZQ==; 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 1dJGYV-0007UA-0O; Fri, 09 Jun 2017 09:50:11 +0000 Received: from mail-wm0-x22f.google.com ([2a00:1450:400c:c09::22f]) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1dJGY9-0006Hi-Nq for linux-arm-kernel@lists.infradead.org; Fri, 09 Jun 2017 09:49:52 +0000 Received: by mail-wm0-x22f.google.com with SMTP id n195so46509417wmg.1 for ; Fri, 09 Jun 2017 02:49:29 -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=qBbwpt1LcK3/Neug+N3P1bXHTXE28ILFY7uNCmTNnQymiClKUqCUkF0VZ8Gl6x4u/6 VoJKAMpPHF9D41jbD7oqoGv06zq4H/NYWWr2ViYptFtfEMCKS11ebnaJyGnUH4zt8KUz Dcd/t9b/57s0Yb1LZU71yrvmpIOfTf7HZ65/U04FSCD9Up4lbbQ83n5EMATE8MKLQ9Zg kez0XJ+zb8C5+TeIJ3JhgLQjJa+fXAZCoUhv4vv/s1YE0xVXu+d5DzQO/vcOGYsQi7vY hiRyWW3jtiFpePF5fdEPR+0FAXpWzlSTAgkIUWikT91Y5VMU/Fdv3y56wz8U6ZLrB6fw pNLg== 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=XBSamM3Y8k3WHRFFGMMc5iJ+cIk0ALlsGiBsVEbAEHK+xrx1rmDHxJb4oLVdR0tJan oLSsEfBhWQI3peU+Y/EiL0HGWq/ELURyXmlpHCClQu5n0ey/U3gbeb1PYbgWG82WpJdQ WXaZJpLeCUywOHoJLfdyBenbUd6F0dZ146dWY5kR1mS7utm4tJ8VtPLam/Rmy4D7nXXp Hwnb1cRd6XwRvDkO7+yOutHxPGWY1i98uSp+CfFpBJs8KKqPoex2DmEK7kTf5xli1rut s7F641LRBcO8WdHt13/aMd9DSwkzTd5zUXyAg2YC3KAsLsbhNCvq0GQqaj7GTe0cFubc eNlg== X-Gm-Message-State: AODbwcA2BexB5i0iSKkhgY7vXunsJq9nkmSmxWNF644fbC8TUw16kuwE FQhKPV2OXOv1UAh6 X-Received: by 10.28.32.8 with SMTP id g8mr6219148wmg.117.1497001768028; Fri, 09 Jun 2017 02:49:28 -0700 (PDT) Received: from localhost.localdomain ([90.63.244.31]) by smtp.gmail.com with ESMTPSA id n92sm968983wrb.62.2017.06.09.02.49.27 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Fri, 09 Jun 2017 02:49:27 -0700 (PDT) From: Neil Armstrong To: gregkh@linuxfoundation.org, khilman@baylibre.com Subject: [PATCH v4 1/7] dt-bindings: serial: Add bindings for the Amlogic Meson UARTs Date: Fri, 9 Jun 2017 11:49:10 +0200 Message-Id: <1497001756-942-2-git-send-email-narmstrong@baylibre.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1497001756-942-1-git-send-email-narmstrong@baylibre.com> References: <1497001756-942-1-git-send-email-narmstrong@baylibre.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20170609_024949_936902_58BDC627 X-CRM114-Status: GOOD ( 15.17 ) 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 --- .../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"; +};