Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Received-SPF: Pass (protection.outlook.com: domain of xilinx.com designates
 20.83.241.18 as permitted sender) receiver=protection.outlook.com;
 client-ip=20.83.241.18;
 helo=mailrelay000001.14r1f435wfvunndds3vy4cdalc.xx.internal.cloudapp.net;
 pr=C
Envelope-to: git@xilinx.com,
 robh+dt@kernel.org,
 krzysztof.kozlowski+dt@linaro.org,
 devicetree@vger.kernel.org,
 linux-kernel@vger.kernel.org,
 arnd@arndb.de,
 gregkh@linuxfoundation.org,
 linux-arm-kernel@lists.infradead.org,
 git@amd.com
From:   Appana Durga Kedareswara rao <appana.durga.rao@xilinx.com>
To:     <robh+dt@kernel.org>, <krzysztof.kozlowski+dt@linaro.org>,
        <devicetree@vger.kernel.org>, <linux-kernel@vger.kernel.org>,
        <appana.durga.rao@xilinx.com>, <michal.simek@xilinx.com>,
        <derek.kiernan@xilinx.com>, <dragan.cvetic@xilinx.com>,
        <arnd@arndb.de>, <gregkh@linuxfoundation.org>,
        <linux-arm-kernel@lists.infradead.org>
CC:     <git@amd.com>, <git@xilinx.com>
Subject: [PATCH 1/4] dt-bindings: misc: tmr-manager: Add device-tree binding for TMR Manager
Date:   Tue, 28 Jun 2022 11:13:35 +0530
Message-ID: <20220628054338.1631516-2-appana.durga.rao@xilinx.com>
In-Reply-To: <20220628054338.1631516-1-appana.durga.rao@xilinx.com>
References: <20220628054338.1631516-1-appana.durga.rao@xilinx.com>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
X-Microsoft-Antispam-Message-Info-Original: St25eJ0ApQHa+4DVwhmt9P9nFpmhrEdse/Bfz58QlVX8mCiHDRfWK4Ui7KJthDbJXWfwEOFja+ZPfXV4nv34QiqGODPE3gwaO6UMSzmyV/Kx7RTrySFxhUUYhVzELjOQtp1tc4D3vswVtQC6F9J5yJlXMc7VcyhIN7wUMBGH184mD+S1GZPXxqDPc4NxzR15klDN2pFxpR9VWMtqXfwS/45+5ysNTd0wGDsT/sMiio/GbcpTQ6i/gkA7ljBnYSZmteCZL85NQIcDBegmsWFxzmA8jThk90aQiMl3YRnVrLf2ulTxMiwupw06rz37xo0cNr9bEX7akCeko6+YQ9oTnvcRlID4XM46syjGyOqaO9aWmpBa+8lw9J+SNm3z1JImjWEaMj+wIppmfAHAu+hzQrnrndtzsvrcqxOZKxXy6hlFwZluj/fZFdoBnmjvIV76mtYzqHUeruOnA9pP1xWGdeWRXVlpFATsBEKsW4Bzq3d3lAuyS7HNWe2LXuFzteKT+lnq9iHNOo6ewDmtAqJyEU1V8GfX2+YVug4YHkmr7rOtaKESR3h7ceeeoUvl6BBDW9LKC7SxpEG3oESn8W0fGHSJ4a4urMRrk/Pnn3ulBjkhh3aim3sNBVeW61mqF78Aqp2CRF1Aa7ufRhZABgifnEJcO7eA0ShPfFn1wL4T4mx9QnuItJFPyOLm15altCdkUgugSI1Xbm3uvjUaQqPB7xIxe5q/wIzpDu3O8DnxyTs67ylPa2xbtxpeTgYI6bxNEhAN4KVqcCZjxppLyDtZjIwg5ROAVFKZJoMfT54s7UvEWWEbMm7ZdJdu7E1hUIU1y8kSmYESuT7SQqMVXJSn3spTi44s1BIHT2uj7nM1Tn7HHgtc+KRkWmp7ZzbYN4Jn1+T+hl3+IK1hPW5z3TEXLiGgKlpwAdggyzYrqOrPkjg=
X-Forefront-Antispam-Report-Untrusted: CIP:149.199.62.198;CTRY:US;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:xsj-pvapexch02.xlnx.xilinx.com;PTR:unknown-62-198.xilinx.com;CAT:NONE;SFS:(13230016)(4636009)(136003)(39860400002)(376002)(396003)(346002)(46966006)(36840700001)(40470700004)(103116003)(4326008)(7636003)(921005)(8676002)(426003)(26005)(83380400001)(47076005)(356005)(40480700001)(70586007)(70206006)(7696005)(82740400003)(186003)(8936002)(478600001)(40460700003)(336012)(36860700001)(6666004)(1076003)(54906003)(2906002)(966005)(316002)(36756003)(107886003)(9786002)(5660300002)(110136005)(41300700001)(82310400005)(2616005)(102446001);DIR:OUT;SFP:1101;
X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN6PR02MB4975
X-MS-Exchange-Transport-CrossTenantHeadersStripped: BN1NAM02FT048.eop-nam02.prod.protection.outlook.com
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-Correlation-Id-Prvs: e2a6ce12-d1b9-4b47-2b70-08da58c92d30
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?SNr67rePmUgZYoSxgmm4rqd6j6Dhw1drkF6Mp3TMQjhVpVpszaHg910FF8m1?=
 =?us-ascii?Q?axyG5qoYFAfsYhhv81lmLiGePCTvuSuBa1UZuf5gm3vvHxVzKE8keA/vGz83?=
 =?us-ascii?Q?kK2PPggsBAaRaGIYQEsM4Ad1YWruKsGtN4Ra8oYsPq6gG5d2TltHxIrCeBxU?=
 =?us-ascii?Q?71OEDg4pXB3LOY3RZkRkI6X6J/9SZgoIWeif6BHmm4okiEZvBtlkWp5JyfFS?=
 =?us-ascii?Q?on2X4uNQk/j00cEgXxRRznxyxJO3MtqjNsZkXqSKssObbO1Z2SUzHpH+RkIa?=
 =?us-ascii?Q?AstNI/Lxa9yqTIeGyamc1oKN4uLUZmaACqDB8FToHMStC+oxMgm3pGr3nbXl?=
 =?us-ascii?Q?SkxYW9j1FsayuVz+Cmjx1YboBojJEoM88CpTwXCjd424PszMddaHGyHyMzqD?=
 =?us-ascii?Q?InNnSbKxKTTO3JCfKKwwIRB6kuVYT/P/RkEo0VXpRayi2gnblXmfyqXQP14V?=
 =?us-ascii?Q?xOkbJeyGSvBADNspxSQqjCetKEaJ8/3Obf6tossDScxBY1ZLIz8+HhPTfyAo?=
 =?us-ascii?Q?cj2o31/j7PG3iEXitVt07UOvXolvU1qnCEGc06x1GpFgkk4OtZQYEhiqyV4k?=
 =?us-ascii?Q?Jwba0K19UFDiR4YLhuS+HbGIe9PDyUAvHRvguAhHl1gswpb2DozcaHnJd/+G?=
 =?us-ascii?Q?x4LesZPSmZYjSOc6hZi18nTQxw9+EFa2qC1EYybEAHXbwg5UdvcWP5AaKxTt?=
 =?us-ascii?Q?CwU9kX2LQbXLqbcgoj2lt7F1sUzKsD387T2i5g6E51gbO7aJwGRmgoBLheSo?=
 =?us-ascii?Q?9QDON54+oayrAxxkjQWHdFUJxkXm69e8no+z6yEIcDO2FOfC+sFpc3mHb2NX?=
 =?us-ascii?Q?0LHHeUHZ2t09rPAJmiJr8SxWOF3Xof/Axz7HqSyR2skma354FD+yMx7lacNE?=
 =?us-ascii?Q?ffewRUN6Q/wsY83WnC1aXmnYN5qdsww3OT451gh2SMOftd6Il07WqBhQcwL0?=
 =?us-ascii?Q?SRSUeNcf46/qjkcnByV93w=3D=3D?=
X-Forefront-Antispam-Report: CIP:20.83.241.18;CTRY:US;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:mailrelay000001.14r1f435wfvunndds3vy4cdalc.xx.internal.cloudapp.net;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(13230016)(4636009)(39860400002)(396003)(136003)(346002)(376002)(40470700004)(36840700001)(46966006)(36860700001)(921005)(41300700001)(8936002)(7696005)(103116003)(5660300002)(2906002)(82740400003)(6666004)(4326008)(83380400001)(70206006)(8676002)(9786002)(1076003)(26005)(966005)(40480700001)(107886003)(478600001)(54906003)(316002)(2616005)(40460700003)(36756003)(82310400005)(81166007)(186003)(336012)(110136005)(426003)(47076005)(102446001)(36900700001);DIR:OUT;SFP:1101;
X-OriginatorOrg: xilinx.com
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Jun 2022 05:43:52.7703
 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: e27eb48e-f3e5-4019-6b5e-08da58c92f35
X-MS-Exchange-CrossTenant-Id: 657af505-d5df-48d0-8300-c31994686c5c
X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=657af505-d5df-48d0-8300-c31994686c5c;Ip=[20.83.241.18];Helo=[mailrelay000001.14r1f435wfvunndds3vy4cdalc.xx.internal.cloudapp.net]
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: TreatMessagesAsInternal-BN1NAM02FT048.eop-nam02.prod.protection.outlook.com
X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR02MB3846
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS,
        T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

This commit adds documentation for Triple Modular Redundancy(TMR) Manager
IP. The Triple Modular Redundancy(TMR) Manager is responsible for handling
the TMR subsystem state, including fault detection and error recovery
provides soft error detection, correction and recovery features.

Signed-off-by: Appana Durga Kedareswara rao <appana.durga.rao@xilinx.com>
---
 .../bindings/misc/xlnx,tmr-manager.yaml       | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/misc/xlnx,tmr-manager.yaml

diff --git a/Documentation/devicetree/bindings/misc/xlnx,tmr-manager.yaml b/Documentation/devicetree/bindings/misc/xlnx,tmr-manager.yaml
new file mode 100644
index 000000000000..f6cb4d235981
--- /dev/null
+++ b/Documentation/devicetree/bindings/misc/xlnx,tmr-manager.yaml
@@ -0,0 +1,48 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/misc/xlnx,tmr-manager.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Xilinx TMR Microblaze Device Tree Bindings
+
+maintainers:
+  - Appana Durga Kedareswara rao <appana.durga.rao@xilinx.com>
+
+description: |
+  The Triple Modular Redundancy(TMR) Manager is responsible for handling the
+  TMR subsystem state, including fault detection and error recovery. The core
+  is triplicated in each of the sub-blocks in the TMR subsystem, and provides
+  majority voting of its internal state.
+
+properties:
+  compatible:
+    enum:
+      - xlnx,tmr-manager-1.0
+
+  reg:
+    maxItems: 1
+
+  xlnx,magic1:
+    minimum: 0
+    maximum: 255
+    description:
+      Magic number 1, When writing to the control register the first write data
+      byte (bits 7:0) must match this value in order to have any effect on the
+      nominal recovery function.
+    $ref: /schemas/types.yaml#/definitions/uint32
+
+required:
+  - compatible
+  - reg
+  - xlnx,magic1
+
+additionalProperties: false
+
+examples:
+  - |
+    tmr-manager@44a10000 {
+            compatible = "xlnx,tmr-manager-1.0";
+            reg = <0x44a10000 0x10000>;
+            xlnx,magic1 = <0x46>;
+    };
-- 
2.25.1