Received-SPF: pass (google.com: domain of linux-kernel+bounces-173978-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249;
From: Vabhav Sharma <vabhav.sharma@nxp.com>
Date: Thu, 09 May 2024 02:45:32 +0200
Subject: [PATCH 1/4] dt-bindings: firmware: secvio: Add device tree
 bindings
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
Message-Id: <20240509-secvio-v1-1-90fbe2baeda2@nxp.com>
References: <20240509-secvio-v1-0-90fbe2baeda2@nxp.com>
In-Reply-To: <20240509-secvio-v1-0-90fbe2baeda2@nxp.com>
To: Rob Herring <robh@kernel.org>, Krzysztof Kozlowski <krzk+dt@kernel.org>, 
 Conor Dooley <conor+dt@kernel.org>, 
 Franck LENORMAND <franck.lenormand@nxp.com>, 
 Dong Aisheng <aisheng.dong@nxp.com>, Shawn Guo <shawnguo@kernel.org>, 
 Sascha Hauer <s.hauer@pengutronix.de>, 
 Pengutronix Kernel Team <kernel@pengutronix.de>, 
 Fabio Estevam <festevam@gmail.com>, Peng Fan <peng.fan@nxp.com>
Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, 
 imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org, 
 Varun Sethi <V.Sethi@nxp.com>, Silvano Di Ninno <silvano.dininno@nxp.com>, 
 Pankaj Gupta <pankaj.gupta@nxp.com>, frank.li@nxp.com, 
 daniel.baluta@nxp.com, Vabhav Sharma <vabhav.sharma@nxp.com>
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?utf-8?B?R0xteHZJOCs0OU9FUURoVXRaR1RJTWFiMmVTdkpTdWVnVmYycVB5VXVPblV1?=
 =?utf-8?B?QWl3RTVsdldSVXZyRUlkN2pBaDZFNDYvMHB4YjJuaXBuQ3hYTlRLRXh4dUhP?=
 =?utf-8?B?b3I1V0RlL201OVI2Nkt6WWRxUE9mVUhxRXdDVkpIcnE1UlVyTGpvT3BZcDVS?=
 =?utf-8?B?THlUa2xXVnd3YTd2YmwyMVZFZHdULzZhTU0yRnRRbmNSaDY0SzBtRFFRY1NC?=
 =?utf-8?B?MCtYVGR3cEVRRG5vanREclJrWXVnOGNQa3RPQ05waG1yOFljdVZCQldReDJO?=
 =?utf-8?B?dzBWdTg2TEZSTklKUEJvQmx3RndNeFlzNlU4MFJwMXpyVkZnbkREZlBmeGdx?=
 =?utf-8?B?SkpReHNmUXdiS1hOdWZJL1RGT0JkQVBvTEUxc2pQOUFzRGpwVUdXS1NoME9o?=
 =?utf-8?B?OHQyQi9DWjFFZ0lGa0UxYWU1WW04TytsQ1MveS9ic2hGWWxKQ0NaN2FDV0Uv?=
 =?utf-8?B?VmExRTlHb3pZN1EvUUpjTTVLSEdNRlJVSHJuWGl4SHBlSEtlSlZFU2hmUWgy?=
 =?utf-8?B?b2JKVG9lMm52am4xZ2dDWm5lNHVKTmx5b2hoZE14N2RORlp6QVo0SWVEekVQ?=
 =?utf-8?B?NlZMbHN0azl3R2VZQjVaYU9vaDV4UW1oU29vdmVETUlubGJvKzBlZFN1R2ZC?=
 =?utf-8?B?R0JJNFdvcWgwT2piYi9wd09ubUg4ZkhoQ2Y3bkZiZnoyTldJUjlTb2NwZml3?=
 =?utf-8?B?V21UZkdPa0wyeEUzUUF0TUNoYmtWbkp2SU9SS2R4NzFmK0VGTVVwQkZhNVlG?=
 =?utf-8?B?MzdHVktCejJ6ZWxlSjVPUWhmUVdKUU8rS3Z2N1gzdDZOTE1TeklhN285OUVP?=
 =?utf-8?B?QUt1TjRDK2RPaGZCdm1LakNkQUZNK2Izc0E4djdxVjNDUVlEcnpTUFk1MDZM?=
 =?utf-8?B?Q2x3L1FmZ3JGNVRWNG1NYW9lSkl0K29PWi9BMzlZUXlidHFtazhPbUwxczV6?=
 =?utf-8?B?K2dFTmtBZXN2cTNKSkY2eUdRa2ZEZEIyNGdoWDRrSXJRV1FaT29VR25zNGNz?=
 =?utf-8?B?MDZja1AvMjZJZFlVdmVoS0dZc3ladVNIMGRvblkrRkJ5ZXJYMm16eEZCcmtZ?=
 =?utf-8?B?b3pqd2xGeWJjQ0tHQk5WWVdGUGt4b0R1MFI1SXBydUE0VWNOL0tsODFVdnp4?=
 =?utf-8?B?Z0E4bFFEc3dzdTFaUU50RGNSMDZCMmJTdDBJUzlTckt2cEdLNnhuU3o2cHdx?=
 =?utf-8?B?ZDFXSk9hREV3K3FOYUtRSDhxazdZNFJFSllkMVBaSENuKzBTL1NJN24yUUpY?=
 =?utf-8?B?UmJQNmVZQjY1YnFOVmVnZEVwN2FQVkRnbThGM2ZodlozZFJsLzYvdjltOFdN?=
 =?utf-8?B?aU5sK3Rvazl2Y0FUSGJEVWNNWGtLUjBjblNSMEo1eWcwNUlqdmVTT0VDVkY5?=
 =?utf-8?B?OUI5QitMd3l0eFBkNjNFbmxIb2t1Qm9tcDNjYnNsT2VxcVZJZVFjNkJzcDhi?=
 =?utf-8?B?NjJmakZuMDJGRnljRkRXcDM5V0xJUFRTdER1YUhCc013c0pqYnRDMkEzTTNR?=
 =?utf-8?B?VFR2TDJ4c0xaUzVGRWJ3WnVCNVpyWFlIbkExZy94b1BCTnRDRGxlb3UyalEw?=
 =?utf-8?B?YlZTM29MMXZhbHdJQUdIa3VFSFdRR25pQXhEcW5RaGo1cm1yTFZsY2xzRXcx?=
 =?utf-8?B?NHRhSEt3RWg1SURRMXhQWHdYaS9zOFdWNngxWmoxdk8yUmN0NVRXVDdQZ05u?=
 =?utf-8?B?WW1FZFRrU0ZMcFdHN3p3WnB3Ni9GOHUvV3Z5Ui9HOGFNS2R1d3dTdzgvZFVZ?=
 =?utf-8?B?eDA5b2ZIbHRJMEtmblBJYU8wWlltS01xVk9nNEV6MXYwTVNLTVFxOGxTcEFm?=
 =?utf-8?B?cFBXL1AwV0FIYzFFOUZ5dUdxNHVHN1VDZ250UGp2YWM4RXZtSUJTYkhlQ2Rn?=
 =?utf-8?B?eG9UM0VNaVpyWjVCcE05bUdwa3RKZmdXRzc4aTl2b1BLa3VIY0sxdEV6TlN5?=
 =?utf-8?B?a1FEUk4yMDZzZlAxUWNFdStCNXFHRDZpaWJaSEdXRzdFNVB4Yjk2TlREdlY2?=
 =?utf-8?B?RE1FK0tlNitXaVhYVFAwKzR1NjZmRml0QWNxajVGNks1b0ZXWS9ZMjFDYXVJ?=
 =?utf-8?B?dUR5empXL241NGtacmY4UjUxV3pvbzVjVmg0RGhqRkhMSWdwT3BFeGRINEt5?=
 =?utf-8?Q?yMqlyfyuOmysLeCM0DXwko6MZ?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 5da18fb3-c361-4791-1a91-08dc6fc158f4
X-MS-Exchange-CrossTenant-AuthSource: AS1PR04MB9358.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 May 2024 00:45:39.2836
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: g4AxLtI2odJMYrAoPy3MSqb62RdVvlT3q8YkgwevqdWf/Um79ESyFnkvkNa0enuF8iMiI6YREPLEEWvjAV0Apg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM9PR04MB8273

Document the secvio device tree bindings.

The tampers are security feature available on i.MX products and
managed by SNVS block.The tamper goal is to detect the variation
of hardware or physical parameters, which can indicate an attack.

The SNVS, which provides secure non-volatile storage, allows to
detect some hardware attacks against the SoC.They are connected
to the security-violation ports, which send an alert when an
out-of-range value is detected.

The "imx-secvio-sc" module is designed to report security violations
and tamper triggering via SCU firmware to the user.

Add the imx-scu secvio sub node and secvio sub node description.

Signed-off-by: Franck LENORMAND <franck.lenormand@nxp.com>
Signed-off-by: Vabhav Sharma <vabhav.sharma@nxp.com>
---
 .../bindings/arm/freescale/fsl,scu-secvio.yaml     | 35 ++++++++++++++++++++++
 .../devicetree/bindings/firmware/fsl,scu.yaml      | 10 +++++++
 2 files changed, 45 insertions(+)

diff --git a/Documentation/devicetree/bindings/arm/freescale/fsl,scu-secvio.yaml b/Documentation/devicetree/bindings/arm/freescale/fsl,scu-secvio.yaml
new file mode 100644
index 000000000000..30dc1e21f903
--- /dev/null
+++ b/Documentation/devicetree/bindings/arm/freescale/fsl,scu-secvio.yaml
@@ -0,0 +1,35 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/arm/freescale/fsl,scu-secvio.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: NXP i.MX Security Violation driver
+
+maintainers:
+  - Franck LENORMAND <franck.lenormand@nxp.com>
+
+description: |
+  Receive security violation from the SNVS via the SCU firmware. Allow to
+  register notifier for additional processing
+
+properties:
+  compatible:
+    enum:
+      - fsl,imx-sc-secvio
+
+  nvmem:
+    maxItems: 1
+
+required:
+  - compatible
+  - nvmem
+
+additionalProperties: false
+
+examples:
+  - |
+    secvio {
+        compatible = "fsl,imx-sc-secvio";
+        nvmem = <&ocotp>;
+    };
diff --git a/Documentation/devicetree/bindings/firmware/fsl,scu.yaml b/Documentation/devicetree/bindings/firmware/fsl,scu.yaml
index 557e524786c2..b40e127fdc88 100644
--- a/Documentation/devicetree/bindings/firmware/fsl,scu.yaml
+++ b/Documentation/devicetree/bindings/firmware/fsl,scu.yaml
@@ -129,6 +129,11 @@ properties:
       RTC controller provided by the SCU
     $ref: /schemas/rtc/fsl,scu-rtc.yaml
 
+  secvio:
+    description:
+      Receive security violation from the SNVS via the SCU firmware
+    $ref: /schemas/arm/freescale/fsl,scu-secvio.yaml
+
   thermal-sensor:
     description:
       Thermal sensor provided by the SCU
@@ -197,6 +202,11 @@ examples:
                 compatible = "fsl,imx8qxp-sc-rtc";
             };
 
+            secvio {
+                compatible = "fsl,imx-sc-secvio";
+                nvmem = <&ocotp>;
+            };
+
             keys {
                 compatible = "fsl,imx8qxp-sc-key", "fsl,imx-sc-key";
                 linux,keycodes = <KEY_POWER>;

-- 
2.25.1