{"id":817802,"url":"http://patchwork.ozlabs.org/api/patches/817802/?format=json","web_url":"http://patchwork.ozlabs.org/project/devicetree-bindings/patch/20170923141403.20882-2-martin.blumenstingl@googlemail.com/","project":{"id":37,"url":"http://patchwork.ozlabs.org/api/projects/37/?format=json","name":"Devicetree Bindings","link_name":"devicetree-bindings","list_id":"devicetree.vger.kernel.org","list_email":"devicetree@vger.kernel.org","web_url":"","scm_url":"","webscm_url":"","list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<20170923141403.20882-2-martin.blumenstingl@googlemail.com>","list_archive_url":null,"date":"2017-09-23T14:14:01","name":"[1/3] dt-bindings: Amlogic: add documentation for the SoC info register areas","commit_ref":null,"pull_url":null,"state":"not-applicable","archived":true,"hash":"b81dea8e037ddef7cc845d0071c1d81dcd58a28d","submitter":{"id":66366,"url":"http://patchwork.ozlabs.org/api/people/66366/?format=json","name":"Martin Blumenstingl","email":"martin.blumenstingl@googlemail.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/devicetree-bindings/patch/20170923141403.20882-2-martin.blumenstingl@googlemail.com/mbox/","series":[{"id":4764,"url":"http://patchwork.ozlabs.org/api/series/4764/?format=json","web_url":"http://patchwork.ozlabs.org/project/devicetree-bindings/list/?series=4764","date":"2017-09-23T14:14:00","name":"soc: amlogic: Add Meson6/8/8b SoC Information driver","version":1,"mbox":"http://patchwork.ozlabs.org/series/4764/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/817802/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/817802/checks/","tags":{},"related":[],"headers":{"Return-Path":"","X-Original-To":"incoming-dt@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming-dt@bilbo.ozlabs.org","Authentication-Results":["ozlabs.org;\n\tspf=none (mailfrom) smtp.mailfrom=vger.kernel.org\n\t(client-ip=209.132.180.67; helo=vger.kernel.org;\n\tenvelope-from=devicetree-owner@vger.kernel.org; receiver=)","ozlabs.org;\n\tdkim=fail reason=\"signature verification failed\" (2048-bit key;\n\tunprotected) header.d=googlemail.com header.i=@googlemail.com\n\theader.b=\"YRewF1vX\"; dkim-atps=neutral"],"Received":["from vger.kernel.org (vger.kernel.org [209.132.180.67])\n\tby ozlabs.org (Postfix) with ESMTP id 3xzsmM1MD0z9t42\n\tfor ;\n\tSun, 24 Sep 2017 00:14:27 +1000 (AEST)","(majordomo@vger.kernel.org) by vger.kernel.org via listexpand\n\tid S1751030AbdIWOOZ (ORCPT\n\t);\n\tSat, 23 Sep 2017 10:14:25 -0400","from mail-wm0-f66.google.com ([74.125.82.66]:36992 \"EHLO\n\tmail-wm0-f66.google.com\" rhost-flags-OK-OK-OK-OK) by vger.kernel.org\n\twith ESMTP id S1750913AbdIWOOX (ORCPT\n\t); Sat, 23 Sep 2017 10:14:23 -0400","by mail-wm0-f66.google.com with SMTP id f4so3512045wmh.4\n\tfor ;\n\tSat, 23 Sep 2017 07:14:23 -0700 (PDT)","from blackbox.darklights.net\n\t(p200300DCD3F644048154F1156768CB50.dip0.t-ipconnect.de.\n\t[2003:dc:d3f6:4404:8154:f115:6768:cb50])\n\tby smtp.googlemail.com with ESMTPSA id\n\tt36sm3719702wrc.28.2017.09.23.07.14.21\n\t(version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);\n\tSat, 23 Sep 2017 07:14:21 -0700 (PDT)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=googlemail.com; s=20161025;\n\th=from:to:cc:subject:date:message-id:in-reply-to:references;\n\tbh=oSEq/+kWNuxTYYYJXQ5QQEzgC+jMECJYrWRO6gczpB0=;\n\tb=YRewF1vXDevV832Gh0nZA1lOyjKA2xe/OQV3AxNK3UaWVb3avOAY972Pc7IQZ7MLUZ\n\tiXNQSiuhjPki8dZwo+XCARx7Mzusvn4Z+irZkWAzZGvdTLJnh0Yoz/hO6MoE833Un3sk\n\tts98/xI2ak3WpGTq8MhKU+xUb8hfBKbas5v6GEw4kYQa7Po3OE1hV4PAi6bDsvGYw0ar\n\tUfaLZxjO04ohJuhQwsPpURrHPfT76f6Dz1xN4LCzCbB9g/6Rth/WlxG4MYj36VZRHI/L\n\ta4YBjVJwAzoaAWx86S0fKshkkpAcLVZ+Elix2NiyAyd+om3IARP5tFKw9paqS0lbrWiz\n\tHUrw==","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20161025;\n\th=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\n\t:references;\n\tbh=oSEq/+kWNuxTYYYJXQ5QQEzgC+jMECJYrWRO6gczpB0=;\n\tb=qFOdB6sqQlptpz4tQhxhZ8vdB7pCqDFfvPyxTByKpSIxCveC29Fomvk18s7PKPjpaO\n\t1d8kJC0obM+Wg7T7TNCjTrerjqosqdabc/BtY90vAQZNTuBATBKU+88VRpiT2eG3TfBu\n\tBgrNEUi/VTXe0qYH3Ddv86kTLsJXDGbT0HF0/2KHf6+B8f5bWFScCXlOXNiJoTkoA4O2\n\tAzb/9pGQ23Ypv44ZAybqBONM+fQ8WMO0squ1+V+Hg3q5xGD4PQxF2/fQtk18wNUR7d+J\n\tSvfmlqDD6GzO9hsqTZ82QOVVKL3TOdcDKE/e5gnjRce/uAqPvqi+NRHwUS7DgNrGyrrT\n\ty9Vw==","X-Gm-Message-State":"AHPjjUgY4sE9i6kjflii3fXmRhsz9mOW/ss7Bew6XLjboD9IkNcz4MWV\n\t2W8zeCOdPqo1QtEmS+7vifU=","X-Google-Smtp-Source":"AOwi7QCMSkOiwW6Ol/qzabKz1DRdlbj3K0R4FmtB5j5gdPv/7pkGyJth5f1qz6vRsbVntAsM7OrLLA==","X-Received":"by 10.28.131.131 with SMTP id f125mr5668193wmd.137.1506176062575;\n\tSat, 23 Sep 2017 07:14:22 -0700 (PDT)","From":"Martin Blumenstingl ","To":"carlo@caione.org, khilman@baylibre.com,\n\tlinux-arm-kernel@lists.infradead.org,\n\tlinux-amlogic@lists.infradead.org, robh+dt@kernel.org,\n\tdevicetree@vger.kernel.org","Cc":"mark.rutland@arm.com, linux@armlinux.org.uk, narmstrong@baylibre.com,\n\tMartin Blumenstingl ","Subject":"[PATCH 1/3] dt-bindings: Amlogic: add documentation for the SoC info\n\tregister 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>","Sender":"devicetree-owner@vger.kernel.org","Precedence":"bulk","List-ID":"","X-Mailing-List":"devicetree@vger.kernel.org"},"content":"There are three register areas which contain information about the SoC\nversion and revision:\n- the assist registers contain the SoC's \"major version\" which encodes\n the SoC generation and part number. this is available on Meson6,\n Meson8 and Meson8b SoCs.\n- the bootrom register contains at least the SoCs \"misc version\". this\n is avilable on Meson6, Meson8 and Meson8b\n- the analog top registers contain information about the SoC revision.\n this is only available on Meson8 and Meson8b\n\nNot much else is currently known about these registers.\n\nSigned-off-by: Martin Blumenstingl \n---\n .../devicetree/bindings/arm/amlogic/analog-top.txt | 20 ++++++++++++++++++++\n .../devicetree/bindings/arm/amlogic/assist.txt | 17 +++++++++++++++++\n .../devicetree/bindings/arm/amlogic/bootrom.txt | 17 +++++++++++++++++\n 3 files changed, 54 insertions(+)\n create mode 100644 Documentation/devicetree/bindings/arm/amlogic/analog-top.txt\n create mode 100644 Documentation/devicetree/bindings/arm/amlogic/assist.txt\n create mode 100644 Documentation/devicetree/bindings/arm/amlogic/bootrom.txt","diff":"diff --git a/Documentation/devicetree/bindings/arm/amlogic/analog-top.txt b/Documentation/devicetree/bindings/arm/amlogic/analog-top.txt\nnew file mode 100644\nindex 000000000000..101dc21014ec\n--- /dev/null\n+++ b/Documentation/devicetree/bindings/arm/amlogic/analog-top.txt\n@@ -0,0 +1,20 @@\n+Amlogic Meson8 and Meson8b \"analog top\" registers:\n+--------------------------------------------------\n+\n+The analog top registers contain information about the so-called\n+\"metal revision\" (which encodes the \"minor version\") of the SoC.\n+\n+Required properties:\n+- reg: the register range of the analog top registers\n+- compatible: depending on the SoC this should be one of:\n+\t\t- \"amlogic,meson8-analog-top\"\n+\t\t- \"amlogic,meson8b-analog-top\"\n+\t\talong with \"syscon\"\n+\n+\n+Example:\n+\n+\tanalog_top: analog-top@81a8 {\n+\t\tcompatible = \"amlogic,meson8-analog-top\", \"syscon\";\n+\t\treg = <0x81a8 0x14>;\n+\t};\ndiff --git a/Documentation/devicetree/bindings/arm/amlogic/assist.txt b/Documentation/devicetree/bindings/arm/amlogic/assist.txt\nnew file mode 100644\nindex 000000000000..7656812b67b9\n--- /dev/null\n+++ b/Documentation/devicetree/bindings/arm/amlogic/assist.txt\n@@ -0,0 +1,17 @@\n+Amlogic Meson6/Meson8/Meson8b assist registers:\n+-----------------------------------------------\n+\n+The assist registers contain basic information about the SoC,\n+for example the encoded SoC part number.\n+\n+Required properties:\n+- reg: the register range of the assist registers\n+- compatible: should be \"amlogic,meson-mx-assist\" along with \"syscon\"\n+\n+\n+Example:\n+\n+\tassist: assist@7c00 {\n+\t\tcompatible = \"amlogic,meson-mx-assist\", \"syscon\";\n+\t\treg = <0x7c00 0x200>;\n+\t};\ndiff --git a/Documentation/devicetree/bindings/arm/amlogic/bootrom.txt b/Documentation/devicetree/bindings/arm/amlogic/bootrom.txt\nnew file mode 100644\nindex 000000000000..407e27f230ab\n--- /dev/null\n+++ b/Documentation/devicetree/bindings/arm/amlogic/bootrom.txt\n@@ -0,0 +1,17 @@\n+Amlogic Meson6/Meson8/Meson8b bootrom:\n+--------------------------------------\n+\n+The bootrom register area can be used to access SoC specific\n+information, such as the \"misc version\".\n+\n+Required properties:\n+- reg: the register range of the bootrom registers\n+- compatible: should be \"amlogic,meson-mx-bootrom\" along with \"syscon\"\n+\n+\n+Example:\n+\n+\tbootrom: bootrom@d9040000 {\n+\t\tcompatible = \"amlogic,meson-mx-bootrom\", \"syscon\";\n+\t\treg = <0xd9040000 0x10000>;\n+\t};\n","prefixes":["1/3"]}