From patchwork Sat Sep 23 14:14:01 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Martin Blumenstingl X-Patchwork-Id: 9967573 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 BC93C60353 for ; Sat, 23 Sep 2017 14:17:21 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id AFDB6280FC for ; Sat, 23 Sep 2017 14:17:21 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id A4F5228438; Sat, 23 Sep 2017 14:17:21 +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 3729428501 for ; Sat, 23 Sep 2017 14:17:20 +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=fm/Rdv2rWg+HT9Tn5gdOOXuUjla3a2up164Z6nC4+k4=; b=UyAdNsa4PaWaK74F7sHxvg0OV6 zVDbTCwxUQdw/ZLQZtqmdtbjfqxxBsrR/SEc+SUCh7a9dk1Ano/rM08JL8tGkYKSYH6SJJfWoiPGk +aC1c4FP79gDsFS8iaQJKT3kVKE4eu+OQZBn3VA3pCqcfKv3EmcaF3smh3QsEMFyTSiS/qOZUfR38 UtjId6TcSUiodi9lLKeOP45mTb0jUMgKkYfa7LOKBc10+EUzlPE6TR1wcADgj5XRoXNE6e3ErIAwd pb0eoi7h6wJsAm0fcSAXQRdhBS2p2Tl5MkY85jwvmxBznjg57ghPvM55lvo2P/MghRJqujAXJANKn k3zQjQaQ==; 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 1dvlEs-0005WI-Oj; Sat, 23 Sep 2017 14:17:02 +0000 Received: from mail-wm0-x241.google.com ([2a00:1450:400c:c09::241]) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1dvlCe-0002nf-RM; Sat, 23 Sep 2017 14:14:48 +0000 Received: by mail-wm0-x241.google.com with SMTP id m127so3531773wmm.0; Sat, 23 Sep 2017 07:14:24 -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=oSEq/+kWNuxTYYYJXQ5QQEzgC+jMECJYrWRO6gczpB0=; b=YRewF1vXDevV832Gh0nZA1lOyjKA2xe/OQV3AxNK3UaWVb3avOAY972Pc7IQZ7MLUZ iXNQSiuhjPki8dZwo+XCARx7Mzusvn4Z+irZkWAzZGvdTLJnh0Yoz/hO6MoE833Un3sk ts98/xI2ak3WpGTq8MhKU+xUb8hfBKbas5v6GEw4kYQa7Po3OE1hV4PAi6bDsvGYw0ar UfaLZxjO04ohJuhQwsPpURrHPfT76f6Dz1xN4LCzCbB9g/6Rth/WlxG4MYj36VZRHI/L a4YBjVJwAzoaAWx86S0fKshkkpAcLVZ+Elix2NiyAyd+om3IARP5tFKw9paqS0lbrWiz HUrw== 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=oSEq/+kWNuxTYYYJXQ5QQEzgC+jMECJYrWRO6gczpB0=; b=cUoJ25OQfWMSMnZLxAFUsa7R2xRemkP/MmdpsibZb9NJyjq9Oc++gfpuK4WbRc/IiI CrFK0l/rCi5nuolvb6CnDSuAtycKVBY0ZDrCH8s0nCJ7pZLp7uW5que4hZ6Dgv09zeT2 Uk4ApjRUvy6mT3BKfNp0jkWpmjsbjM/KTCJifbVS6F1S1AoocicBaSKFKXkplFw2jhRs meNRuM/0Z4PNXO3tunjzwEAR2swBB9eVddUfegLTC7hmc2z6PpWigEyq8s/vZ/i1HU9v 9gmK4quJzhyqbO6tZRNTZsrKA625DMVRBAdsUG/ZPm7Xp2XhPvPX/yCMtGMlmt+bRwYo khRA== X-Gm-Message-State: AHPjjUhmiziGTrn0b61HVEryQY4hEKHYA4Uv97wk9gBrOyWEb7zAdTRj /D6mJjH29XqL7ntynt+kbPY= X-Google-Smtp-Source: AOwi7QCMSkOiwW6Ol/qzabKz1DRdlbj3K0R4FmtB5j5gdPv/7pkGyJth5f1qz6vRsbVntAsM7OrLLA== X-Received: by 10.28.131.131 with SMTP id f125mr5668193wmd.137.1506176062575; Sat, 23 Sep 2017 07:14:22 -0700 (PDT) Received: from blackbox.darklights.net (p200300DCD3F644048154F1156768CB50.dip0.t-ipconnect.de. [2003:dc:d3f6:4404:8154:f115:6768:cb50]) by smtp.googlemail.com with ESMTPSA id t36sm3719702wrc.28.2017.09.23.07.14.21 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 23 Sep 2017 07:14:21 -0700 (PDT) From: Martin Blumenstingl To: carlo@caione.org, khilman@baylibre.com, linux-arm-kernel@lists.infradead.org, linux-amlogic@lists.infradead.org, robh+dt@kernel.org, devicetree@vger.kernel.org Subject: [PATCH 1/3] dt-bindings: Amlogic: add documentation for the SoC info register areas Date: Sat, 23 Sep 2017 16:14:01 +0200 Message-Id: <20170923141403.20882-2-martin.blumenstingl@googlemail.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20170923141403.20882-1-martin.blumenstingl@googlemail.com> References: <20170923141403.20882-1-martin.blumenstingl@googlemail.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20170923_071445_128633_90B69D0E X-CRM114-Status: GOOD ( 12.33 ) 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: mark.rutland@arm.com, Martin Blumenstingl , linux@armlinux.org.uk, narmstrong@baylibre.com 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 There are three register areas which contain information about the SoC version and revision: - the assist registers contain the SoC's "major version" which encodes the SoC generation and part number. this is available on Meson6, Meson8 and Meson8b SoCs. - the bootrom register contains at least the SoCs "misc version". this is avilable on Meson6, Meson8 and Meson8b - the analog top registers contain information about the SoC revision. this is only available on Meson8 and Meson8b Not much else is currently known about these registers. Signed-off-by: Martin Blumenstingl Acked-by: Rob Herring --- .../devicetree/bindings/arm/amlogic/analog-top.txt | 20 ++++++++++++++++++++ .../devicetree/bindings/arm/amlogic/assist.txt | 17 +++++++++++++++++ .../devicetree/bindings/arm/amlogic/bootrom.txt | 17 +++++++++++++++++ 3 files changed, 54 insertions(+) create mode 100644 Documentation/devicetree/bindings/arm/amlogic/analog-top.txt create mode 100644 Documentation/devicetree/bindings/arm/amlogic/assist.txt create mode 100644 Documentation/devicetree/bindings/arm/amlogic/bootrom.txt diff --git a/Documentation/devicetree/bindings/arm/amlogic/analog-top.txt b/Documentation/devicetree/bindings/arm/amlogic/analog-top.txt new file mode 100644 index 000000000000..101dc21014ec --- /dev/null +++ b/Documentation/devicetree/bindings/arm/amlogic/analog-top.txt @@ -0,0 +1,20 @@ +Amlogic Meson8 and Meson8b "analog top" registers: +-------------------------------------------------- + +The analog top registers contain information about the so-called +"metal revision" (which encodes the "minor version") of the SoC. + +Required properties: +- reg: the register range of the analog top registers +- compatible: depending on the SoC this should be one of: + - "amlogic,meson8-analog-top" + - "amlogic,meson8b-analog-top" + along with "syscon" + + +Example: + + analog_top: analog-top@81a8 { + compatible = "amlogic,meson8-analog-top", "syscon"; + reg = <0x81a8 0x14>; + }; diff --git a/Documentation/devicetree/bindings/arm/amlogic/assist.txt b/Documentation/devicetree/bindings/arm/amlogic/assist.txt new file mode 100644 index 000000000000..7656812b67b9 --- /dev/null +++ b/Documentation/devicetree/bindings/arm/amlogic/assist.txt @@ -0,0 +1,17 @@ +Amlogic Meson6/Meson8/Meson8b assist registers: +----------------------------------------------- + +The assist registers contain basic information about the SoC, +for example the encoded SoC part number. + +Required properties: +- reg: the register range of the assist registers +- compatible: should be "amlogic,meson-mx-assist" along with "syscon" + + +Example: + + assist: assist@7c00 { + compatible = "amlogic,meson-mx-assist", "syscon"; + reg = <0x7c00 0x200>; + }; diff --git a/Documentation/devicetree/bindings/arm/amlogic/bootrom.txt b/Documentation/devicetree/bindings/arm/amlogic/bootrom.txt new file mode 100644 index 000000000000..407e27f230ab --- /dev/null +++ b/Documentation/devicetree/bindings/arm/amlogic/bootrom.txt @@ -0,0 +1,17 @@ +Amlogic Meson6/Meson8/Meson8b bootrom: +-------------------------------------- + +The bootrom register area can be used to access SoC specific +information, such as the "misc version". + +Required properties: +- reg: the register range of the bootrom registers +- compatible: should be "amlogic,meson-mx-bootrom" along with "syscon" + + +Example: + + bootrom: bootrom@d9040000 { + compatible = "amlogic,meson-mx-bootrom", "syscon"; + reg = <0xd9040000 0x10000>; + };