From patchwork Thu Dec 19 18:57:22 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Pankaj Gupta X-Patchwork-Id: 13915095 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 4A7D1E77184 for ; Thu, 19 Dec 2024 13:35:44 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:MIME-Version:Cc:To: In-Reply-To:References:Message-Id:Content-Transfer-Encoding:Content-Type: Subject:Date:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=rydjPSyjFpE1b+KVUJhSPw9jPLhoKfIzwxtGoWGJhg4=; b=tlIO2s+o1MIPOkWSEtFqef82ru scyxl8YVhG6QRd4p4oEfan8F5gUOBR1dgZji1irsW63FLJKTGdA04xe0KWzh/v+eyixy1b89uggkv o6Yb36viBqbi7W1BWouMfVchTLtfozBnTEhAbaAC68PUI8SqRB1FvgH7b/Z/8QQtCrP33W0+nxgtz +PBAVbN5YSuaG9P+s2/Op/XVgKTS1mES2pRI+mWQkHphikXVSZEuTkDYllFXNACADDSs7bh49kY0Q sKdicO4xQ1sxwlSGozsRGmOjz2uAHs+QIYe689hAoYrNRni8RfZZ/UCXXd9m66kUpRqzSKuUmlcT/ JiAvh9OA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98 #2 (Red Hat Linux)) id 1tOGgd-00000001xi4-1fZ0; Thu, 19 Dec 2024 13:35:31 +0000 Received: from mail-am6eur05on20623.outbound.protection.outlook.com ([2a01:111:f403:2612::623] helo=EUR05-AM6-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.98 #2 (Red Hat Linux)) id 1tOGee-00000001xGx-1lFO for linux-arm-kernel@lists.infradead.org; Thu, 19 Dec 2024 13:33:29 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=n6yaFlaSOH80c5bQcMygDWRL5iOEaCcA5ORqtuCIAhzognZWar83lDprz10p0Xpr9Y29jhK/ntVZwZ/gYnkOsECLEx2eSoolKDSQLFcMrPxbpqxVEf9bhrVxyP/GzTXSbFFGYzlIlTaIHGl6gXKtBTcBXn6CKfBmOBfOQQJt5U3A5JqX2COaeWmtOkHaeSNBKNgcVyENP414fCvU9x7k3J3XM2WcExIebwFa49Cj0iY0apkbOls4kec7UcoiqRPmwoUSw+MvWt14WSXfmfWSmf4+lh/CTLMP+oaurUFvOHztBPpj2Yb7A7xoasqtw6ERmrg8+p7+KOMFcunh0dde4w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=rydjPSyjFpE1b+KVUJhSPw9jPLhoKfIzwxtGoWGJhg4=; b=d6oMa3B47XRxFPp+Eo67qPPlDitzpzdMRLZXUvY7PBPK/335HP0ORxXxQY57camsNilhMrJld0jrnsBzupn5yt5+9gma8Jk2gA6/Ky0AAvdhDNGztUn3fe5ncWm6qZ9nDHM00LQh1iKs25/n5kZQYbSjjf+YpnPVrFVrza+WXf1i/KxTFYf2Jd3yXESqU4eVP5nWry0Q9I2sUUjdpw48N6FUxF+Ck85OLoV9o91KQlapE7Pxs/LPqefgljuyyNHrvt/7i8Wuj2anQUpHQIKaWuy03rZ65QmkVBS5JsDNXDd4VThtP0M5vXjKYbr2JiHk5fz9yjB9LOqiwydNFEwsJQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=rydjPSyjFpE1b+KVUJhSPw9jPLhoKfIzwxtGoWGJhg4=; b=hWimqy5PWINeC/BUscdkGW71x1E5m0q1s3NDk//cGUMCT0qeA+tbBzOIdUbw5At2pjfIv1swe2fQtadabgxL40r4iU2AxfJi4UxzF61A7DoeXY3rLy1ZRDqAeNwCC+j5XqWyKoB204W3IQQkj2PY+ODt/XDb7z304qAC8vJiuuaFD5aKQw8Q5AYaU7pQC3QNLZHauTpJZDJnPUIN9OvlX5J6ys3r3QY/UU4CapKM0rQgmU6J1jM6b93gAdzOJdcjfIDULWaNB1dVJdymm5BjI6DUGGgsSzbm2dIDhOJx95arTUx4G9290MvNLFiyBjAvuiOULaCjUCWbw2rI+iByZQ== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from AM9PR04MB8604.eurprd04.prod.outlook.com (2603:10a6:20b:43b::21) by DUZPR04MB9919.eurprd04.prod.outlook.com (2603:10a6:10:4d9::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8272.13; Thu, 19 Dec 2024 13:33:25 +0000 Received: from AM9PR04MB8604.eurprd04.prod.outlook.com ([fe80::e751:223e:aa3d:5827]) by AM9PR04MB8604.eurprd04.prod.outlook.com ([fe80::e751:223e:aa3d:5827%4]) with mapi id 15.20.8272.013; Thu, 19 Dec 2024 13:33:25 +0000 From: Pankaj Gupta Date: Fri, 20 Dec 2024 00:27:22 +0530 Subject: [PATCH v11 1/5] Documentation/firmware: add imx/se to other_interfaces Message-Id: <20241220-imx-se-if-v11-1-0c7e65d7ae7b@nxp.com> References: <20241220-imx-se-if-v11-0-0c7e65d7ae7b@nxp.com> In-Reply-To: <20241220-imx-se-if-v11-0-0c7e65d7ae7b@nxp.com> To: Jonathan Corbet , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Shawn Guo , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , Pankaj Gupta Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org X-Mailer: b4 0.13.0 X-Developer-Signature: v=1; a=ed25519-sha256; t=1734634652; l=6679; i=pankaj.gupta@nxp.com; s=20240523; h=from:subject:message-id; bh=FwHu8HOgjdeesS4jBLvkey7Y+WnnBYkcgUp1hGR75ZU=; b=uOfJCs2uqohNFlKFXi5wpmFQWkW1t+bdDE8E7GgpDJMclASvmVndXPz4YplsCo2mH5msuQuPd d0WHmpUya04Dlg8UJRvcWTL3zeFs9Nc2GKZEeVjFlTlgkoNpkCcFexv X-Developer-Key: i=pankaj.gupta@nxp.com; a=ed25519; pk=OA0pBQoupy5lV0XfKzD8B0OOBVB6tpAoIf+0x1bYGRg= X-ClientProxiedBy: SG2P153CA0012.APCP153.PROD.OUTLOOK.COM (2603:1096::22) To AM9PR04MB8604.eurprd04.prod.outlook.com (2603:10a6:20b:43b::21) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AM9PR04MB8604:EE_|DUZPR04MB9919:EE_ X-MS-Office365-Filtering-Correlation-Id: 4ab33ec8-a56d-4d0f-7953-08dd2031afcb X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|52116014|7416014|376014|366016|38350700014; X-Microsoft-Antispam-Message-Info: =?utf-8?q?KHZkVYcYl0WmjBFOg8jUAv2emdEYqdP?= =?utf-8?q?gOoUNOXNO07+aHlvxHgF8rXdSD5b+cCV39cPuSgQRQZbCwW5SokYVtGFywTJdp6yv?= =?utf-8?q?Z3uUDq+L5OCwdH2P6f0s7av/Qsy+vkTHkD3QGvrwsbtlGngWOHb0J3DngdSlIPaWM?= =?utf-8?q?IB43XTPrmbcXjCy6aMbKuSFiZJQRjUT3TSLJFHRDwKWvtRkoXSNFqVhklpHegTcVG?= =?utf-8?q?i/998USj0eFYEr0mSNduC19lAUgZ0b46IVSpRLGrEIGlP8zDPNt7mUY4JbqKgOR/f?= =?utf-8?q?9qUs4XSHd8nH7tuV2eL3TBBhOj5ETutKO4xJw/a2K+DirQO+GD2mwqqNdaP07xLtv?= =?utf-8?q?HlVmCEqCh5Z2QHFWRXVhePUPXL2bZHNaEgju5PVxk1ipLQ/6oQQjqj2L6fkXiQoEW?= =?utf-8?q?eZvi5EztuW48UwuQ2MLf7kfUz1LGPAJIPnxABwgNoOiRddqHA0606lmAY/txhLfGl?= =?utf-8?q?GATEE5vYNRZQkBoGyibeB759y0oHTBCc9OhhCA8hlME2tf0jkjub1LsOqmefA6kph?= =?utf-8?q?dYaTf5Ybl//lioSNlwzaykPk7Wj/lhez0CUJ5IxwtdhHdswkelE/xvhAQp9KZ09uv?= =?utf-8?q?meogciTMsqp5TwIfBhd59lc96GGpl4QFIScJs18kK9uGQXLGcDmSUM7sa5GN97snP?= =?utf-8?q?PGQHW0ah/pAszJEeWw3kc9wIzdK4eo1/qNDYK3IsjsEFhwQDrXQjEculIlbPLe4DZ?= =?utf-8?q?tzmjYIIpbLraX4+/TWPrAbe+rdDO2zqzUa7Ggjh/vbFUdVu5ptpHVfqy3yoBokvX8?= =?utf-8?q?oTUyprsKunjuP1UJVZDhfDj8R5AHorKoMCgkC6YxbbOby+7ocoLTG+otfsmntwaq5?= =?utf-8?q?wifIPq7uPl/hLoON4RmWMretjxJw63sSSG20v8Wuc81nlzR6ycjTCbPgwmS1YOxGq?= =?utf-8?q?V0CBL3Bdnu1fOn8zAf+mGrTkWM58rPPKhtLE4wcE7F1Gi4IgKAQzLG7D/pVjPSpk2?= =?utf-8?q?t2RjbeEJT0UUUbKCO95MUThAzV2PylDuhTOmqnmkAmzas/yeY05YT8DMzoAaSEO1h?= =?utf-8?q?U0wrud3huzMgxzXqsz4lMan9NW0ZCmOsXqf+ucrdDBoRTUtbodSh8gTaL+3QRpUE7?= =?utf-8?q?f2KbLImcoi4n9N3/zPlnLfeg7QsCh/r5E/fcUFjoShSdcKn6PtSloIgEeQDM7h4Ky?= =?utf-8?q?qK7CqoQurqGp2HWU1Lcub2mSAMNk6kqNx115ECR+fQhm9GWR2XF7xJ13h8Ndy0IbK?= =?utf-8?q?N0pGXbSdDWrgzp48/+x04s1+EoRacegfJ3DeB9FUcECzR0pJIZD6pTYUiNp1Mvjyz?= =?utf-8?q?AFN07TO+yPkStlQQbBUq8VIuZgUpK7NEN4xpnyGsZV9EA3spDGkQ5crVSLtCETmoj?= =?utf-8?q?SKb1Wrh3LkgWwUJY6sbcgs0Hc2DeGHpQPBbhCEWGt/atIAQoDmfZPXQ=3D?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AM9PR04MB8604.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(1800799024)(52116014)(7416014)(376014)(366016)(38350700014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?GeF+evIxYk2XNFlGRYm9mqGtIgO1?= =?utf-8?q?SDNQf355SUL1jMNY7N+Dkh0JehvVbhGholBGgX1CWs3v7I5uHJ2j7JVEblJkmMwci?= =?utf-8?q?rKeQiOIOc50yB81RZueXm4EnuM7xjw8QitOoGRCFwwkVUfEUp5otS2mjJAo6mqYd8?= =?utf-8?q?DZVCqL4WQjsC9ExXZn2RWmH/zmPoHzBrPeJVI8GvC5XJSzzrpt8jO3/xC4mWuzElE?= =?utf-8?q?66mCQ7ukj/YUgsYzie3AaN85Hqd0uEiD4zhyhNcjIGBOF8gjontWp8eaIgoDme8GW?= =?utf-8?q?YjwtDvS59oqgBYrT0bu5Bb4DF8mRaTb8yxJ1YdNtzK1oaYxBSaphFxwVjgayS1VX1?= =?utf-8?q?+L3+VB8jpdR+YS4wsNXw+zww1OuQXP1aZaIhqvluUwi8cHnUeM7VUac21cx8LuNW6?= =?utf-8?q?yAKzhlm2ORQiWqFhUPCWv8VTS0tzFTWkfhT17Vc7sIcHKbBANKcpV3Pci7SM2lssq?= =?utf-8?q?5PDwsUbwOqpn5DkHvqH2+q+1bXJN92gauzc99LTcEucJH67ah1g4261IemIQPb3jX?= =?utf-8?q?oa5GyVJevBq6BLlWzHyvMwYxRngJmQL/BTHArhd5L/oIjir/rwMHO3RnyW4I5liGC?= =?utf-8?q?lfKQrtyQKQB9LDHxKMm1fvXWRbSO+aq8Q/IOmzHiMkOgaLelLGPLZlsMpAMDsZ9a+?= =?utf-8?q?uyGBPxNXcm0pNjVEoItLrNraMTZ837r57L1nyxZ+4RVNUysp1qtAcYKE2SyEqpbc3?= =?utf-8?q?jtoQWEp7V8TfViAoPqNo+fJK9ZzRXy1NVwvEdjFBVaMAIYIwbgUbCRXhJR8G97Wa1?= =?utf-8?q?bLWI5SzGX96eWhtIDeVcbAizr7iIlghEz7rQac9ZbNO66LVpmw+tiHAVSFNg5AWDm?= =?utf-8?q?LaHN/PbN0eOTPJgsn5E83Mq871mJ3XaDPtefoqoePpD6cSK1VLXwvHDXlAPUBaD18?= =?utf-8?q?iyoAjE56sUI3fJhsOfS2QTY4Gk36v/zlI7KAWQv/9hVVDeXeFVDKOx+B3b63qvNiT?= =?utf-8?q?YNkjRX+NBOcLOaaaAM/NO6z7fwGC/HOqLL/lLb+emIA6SKfZPbk7HfyWoV8gBRKdz?= =?utf-8?q?qnygCni2BzFKil0B4wuLmW8zZy4cBJuvU9Z+DsrNUv/a1PqT/V9UuP1ANE4jcSXTk?= =?utf-8?q?cirsVqNjtUQ7flrQHnSsCTSfF59iesnNGCZXKXQ2vH5CzggGgdff69nmNtpvfhd+2?= =?utf-8?q?MzfGZE/4b1ZT1PEqAwvkaIGxk7bIVfCaq5wQk5MYESl+46OD2VqCbmRJ54APEax+r?= =?utf-8?q?SekgNR6+qH9PaA0RITenJbJlaBJOBp1ucfBWCwTqZnQYPir7kzQhzD4t8WnyNfRK/?= =?utf-8?q?FkiADxdKNVFN2S8luZ2rD3olYgAZXcnPUr4VuY057ewK2NLc3YdKD+BsSFaZXnDGV?= =?utf-8?q?mkZc2JtpKCQBGPjD1CKCnIddvwGOqhUJSdrFqKR2ywK5mEKdgyGSNeNUkXsyt+KV2?= =?utf-8?q?CK0L1xn877iVKe8QAxbNmd3OqxiwDRmfwLKj/atQlCWlYshGjE1KCnX+f/brXXi2Q?= =?utf-8?q?Q56WnB4yUdd55VQzKDON2KezTcwakH4/C8lJkXnuOXMEE33VyMe1gV6bLLxONSE9j?= =?utf-8?q?WeGX8rc7qtrC?= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 4ab33ec8-a56d-4d0f-7953-08dd2031afcb X-MS-Exchange-CrossTenant-AuthSource: AM9PR04MB8604.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Dec 2024 13:33:21.7287 (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: Pgy4w0txBD3/3XwSRUl0nBov9kiHTxTtKXQPS3vu92nM+whezLOe5MydyE8yJZ/4OL5t9h7+o/c9PdF9Hyosyg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DUZPR04MB9919 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20241219_053328_613275_E11E375D X-CRM114-Status: GOOD ( 13.94 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Documents i.MX SoC's Service layer and C_DEV driver for selected SoC(s) that contains the NXP hardware IP(s) for Secure Enclaves(se) like: - NXP EdgeLock Enclave on i.MX93 & i.MX8ULP Signed-off-by: Pankaj Gupta --- .../driver-api/firmware/other_interfaces.rst | 121 +++++++++++++++++++++ 1 file changed, 121 insertions(+) diff --git a/Documentation/driver-api/firmware/other_interfaces.rst b/Documentation/driver-api/firmware/other_interfaces.rst index 06ac89adaafb..a3a95b54a174 100644 --- a/Documentation/driver-api/firmware/other_interfaces.rst +++ b/Documentation/driver-api/firmware/other_interfaces.rst @@ -49,3 +49,124 @@ of the requests on to a secure monitor (EL3). .. kernel-doc:: drivers/firmware/stratix10-svc.c :export: + +NXP Secure Enclave Firmware Interface +===================================== + +Introduction +------------ +The NXP's i.MX HW IP like EdgeLock Enclave, V2X etc., creates an embedded secure +enclave within the SoC boundary to enable features like + - Hardware Security Module (HSM) + - Security Hardware Extension (SHE) + - Vehicular to Anything (V2X) + +Each of the above feature is enabled through dedicated NXP H/W IP on the SoC. +On a single SoC, multiple hardware IP (or can say more than one secure enclave) +can exist. + +NXP SoCs enabled with the such secure enclaves(SEs) IPs are: +i.MX93, i.MX8ULP + +To communicate with one or more co-existing SE(s) on SoC, there is/are dedicated +messaging units(MU) per SE. Each co-existing SE can have one or multiple exclusive +MUs, dedicated to itself. None of the MU is shared between two SEs. +Communication of the MU is realized using the Linux mailbox driver. + +NXP Secure Enclave(SE) Interface +-------------------------------- +Although MU(s) is/are not shared between SE(s). But for SoC like i.MX95 which has +multiple SE(s) like HSM, V2X-HSM, V2X-SHE; all the SE(s) and their interfaces 'se-if' +that is/are dedicated to a particular SE will be enumerated and provisioned using the +single compatible node("fsl,imx95-se"). + +Each 'se-if' comprise of twp layers: +- (C_DEV Layer) User-Space software-access interface. +- (Service Layer) OS-level software-access interface. + + +--------------------------------------------+ + | Character Device(C_DEV) | + | | + | +---------+ +---------+ +---------+ | + | | misc #1 | | misc #2 | ... | misc #n | | + | | dev | | dev | | dev | | + | +---------+ +---------+ +---------+ | + | +-------------------------+ | + | | Misc. Dev Synchr. Logic | | + | +-------------------------+ | + | | + +--------------------------------------------+ + + +--------------------------------------------+ + | Service Layer | + | | + | +-----------------------------+ | + | | Message Serialization Logic | | + | +-----------------------------+ | + | +---------------+ | + | | imx-mailbox | | + | | mailbox.c | | + | +---------------+ | + | | + +--------------------------------------------+ + +- service layer: + This layer is responsible for ensuring the communication protocol that is defined + for communication with firmware. + + FW Communication protocol ensures two things: + - Serializing the messages to be sent over an MU. + + - FW can handle one command message at a time. + +- c_dev: + This layer offers character device contexts, created as '/dev/_mux_chx'. + Using these multiple device contexts that are getting multiplexed over a single MU, + userspace application(s) can call fops like write/read to send the command message, + and read back the command response message to/from Firmware. + fops like read & write use the above defined service layer API(s) to communicate with + Firmware. + + Misc-device(/dev/_mux_chn) synchronization protocol: + + Non-Secure + Secure + | + | + +---------+ +-------------+ | + | se_fw.c +<---->+imx-mailbox.c| | + | | | mailbox.c +<-->+------+ +------+ + +---+-----+ +-------------+ | MU X +<-->+ ELE | + | +------+ +------+ + +----------------+ | + | | | + v v | + logical logical | + receiver waiter | + + + | + | | | + | | | + | +----+------+ | + | | | | + | | | | + device_ctx device_ctx device_ctx | + | + User 0 User 1 User Y | + +------+ +------+ +------+ | + |misc.c| |misc.c| |misc.c| | + kernel space +------+ +------+ +------+ | + | + +------------------------------------------------------ | + | | | | + userspace /dev/ele_muXch0 | | | + /dev/ele_muXch1 | | + /dev/ele_muXchY | + | + +When a user sends a command to the firmware, it registers its device_ctx +as waiter of a response from firmware. + +Enclave's Firmware owns the storage management, over Linux filesystem. +For this c_dev provisions a dedicated slave device called "receiver". + +.. kernel-doc:: drivers/firmware/imx/se_fw.c + :export: From patchwork Thu Dec 19 18:57:23 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Pankaj Gupta X-Patchwork-Id: 13915096 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id A1DACE77184 for ; Thu, 19 Dec 2024 13:36:49 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:MIME-Version:Cc:To: In-Reply-To:References:Message-Id:Content-Transfer-Encoding:Content-Type: Subject:Date:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=dZoRgTn45yJn+Pnp3LFTUwhkGYSMYn5cLf7fH4YbYkY=; b=I9AfzCyc0+d662BPGL4I071IJ/ Imu6Ev39Uqp4XedQgwIYWXoE8Fd9MLA9LNbM1wuVVmmcbJU1HxNf5mNe96d8VNatn3rHdhFqMnP0w JJyzZTTBh5PRuXLgoxT35RH1S0zO2c/X9f1eyI3osxsBvUx8xIW0xd+pLGXJiYyA5z/XXnbj+7YKM v6l3/cqKdOvUSrGhWBPiFp1EROquUrpzb5Bkf7d1qYesoDrqQqDl/KItDWJPLm7BvUKbrWNfeRptU /CNeCag3dfb3ekfncNHGeOg1mkD99Be1uxuyuMNINqdRYdB7HN20R3JiqMUsnDV+gc7A/qT450oQS c9cnrUqw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98 #2 (Red Hat Linux)) id 1tOGhh-00000001xy7-4BKl; Thu, 19 Dec 2024 13:36:38 +0000 Received: from mail-vi1eur05on2061b.outbound.protection.outlook.com ([2a01:111:f403:2613::61b] helo=EUR05-VI1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.98 #2 (Red Hat Linux)) id 1tOGen-00000001xIe-1PSy for linux-arm-kernel@lists.infradead.org; Thu, 19 Dec 2024 13:33:38 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=CD45as02TCU/t4b0rpJobTAk+1hzYJB7i/PKC6Ae/WiA0PFWsEZpvqYulTJCIUn4upZXy2RryhPSa5Lwi0wpu+HAwTb7mS7GL7T/gYMIoBfvNR0ug9CzTHaX7d0IxHlfIbruXzI+Ddq/5G2VdK1kGNcxh4KjYDGfZEEVOTkKGE9p+3PGUAJjFsCkvSLd+kjEAWU8/fI95XXiI1foP5iAkKVhOE6kMNMGW/Dn9nq4yCNrVKSQl87wbfchcZCNWsUXIQZrdGheKS/jMcp0PmJ0sx5cG/pzRGXsjlHyG+OHN3AhIU3Xxg1fJg4O4SQXAYVha1Wy4JgW068yAJQj/UCYdw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=dZoRgTn45yJn+Pnp3LFTUwhkGYSMYn5cLf7fH4YbYkY=; b=AFD7datj2AjtgaXUnEle2kwN3NfF9t8ZTh6Fvqf9/HulO229Bk/GxsrJaNy7Fd4+gQcJZhbJYpPO2Pum5DtSUn5zIDwU6UV07BDEVmgVk0NYHQZYULh/m5mxbUMWu+XWvpMfHBBV7iYiclwu0SQuOVLF/NN7H09ec7z3Y+7a5Y80kSv6n5cisV8TKsGabUOiTwsS2YeR+vyNpIee+zKMfNJEXbRpUORX9vwfg31aCDPHIhUhEB3KlkpBuys3VNjkGgDBV5Z5Ij1GuBsCUMLeHj2tx+aegYZDpgdmWcd9dNa5Efcb6EmccWeF0fVNoLEAfXklYIcuB3a8WcJGJqzoVQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=dZoRgTn45yJn+Pnp3LFTUwhkGYSMYn5cLf7fH4YbYkY=; b=SOQuAKs3rZzFRO1v8C6Bw0zbcf/v9XnbXP/sAFtosAcIt9UpHYYapyBTx61/jPRej9eslLA4yxeXu8pD6YZDvARmwQWty6uaFK4C3l7Zbfxfr9epKODlfbUiTH+2l6uwutl43xAop8hv1BkpsrKkzznbMFxfuKnIvBXtf/AJ9b0gwPpYDDh70L8qlwROkuW6BVCg4hRFTnbhlEbe19WKpKfXkgYvFq63I9GbsjlriEiJ/tmRdXPIAXUwPVevN/LS48F4BL9TaSaGYpyTw9u5KfewyZYq2KT3v9EYnUFF2FW/2YyAYO59a0xwYUb8Jbcz0Bgt1+KBoh12BIPZYGxEYA== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from AM9PR04MB8604.eurprd04.prod.outlook.com (2603:10a6:20b:43b::21) by DUZPR04MB9919.eurprd04.prod.outlook.com (2603:10a6:10:4d9::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8272.13; Thu, 19 Dec 2024 13:33:32 +0000 Received: from AM9PR04MB8604.eurprd04.prod.outlook.com ([fe80::e751:223e:aa3d:5827]) by AM9PR04MB8604.eurprd04.prod.outlook.com ([fe80::e751:223e:aa3d:5827%4]) with mapi id 15.20.8272.013; Thu, 19 Dec 2024 13:33:32 +0000 From: Pankaj Gupta Date: Fri, 20 Dec 2024 00:27:23 +0530 Subject: [PATCH v11 2/5] dt-bindings: arm: fsl: add imx-se-fw binding doc Message-Id: <20241220-imx-se-if-v11-2-0c7e65d7ae7b@nxp.com> References: <20241220-imx-se-if-v11-0-0c7e65d7ae7b@nxp.com> In-Reply-To: <20241220-imx-se-if-v11-0-0c7e65d7ae7b@nxp.com> To: Jonathan Corbet , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Shawn Guo , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , Pankaj Gupta Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org, Conor Dooley X-Mailer: b4 0.13.0 X-Developer-Signature: v=1; a=ed25519-sha256; t=1734634652; l=3191; i=pankaj.gupta@nxp.com; s=20240523; h=from:subject:message-id; bh=8bCTvi7AgU4MQ5HET0AOHmcMvn388Mh4NN86zRFZhtg=; b=VAJYddXTAlOSyd4TLOYji985bpJz92SwYQb77PtfJVTetaNBhq40OQZF8vG5i2wKGtQdlUcNC z42rHmmlCZYDSEhy0knJ62WFnAODEsZLVWrhhNUEktorezdatYVHj4O X-Developer-Key: i=pankaj.gupta@nxp.com; a=ed25519; pk=OA0pBQoupy5lV0XfKzD8B0OOBVB6tpAoIf+0x1bYGRg= X-ClientProxiedBy: SG2P153CA0012.APCP153.PROD.OUTLOOK.COM (2603:1096::22) To AM9PR04MB8604.eurprd04.prod.outlook.com (2603:10a6:20b:43b::21) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AM9PR04MB8604:EE_|DUZPR04MB9919:EE_ X-MS-Office365-Filtering-Correlation-Id: e7fa9c80-2c5f-4775-6f28-08dd2031bb3f X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|52116014|7416014|376014|366016|38350700014; X-Microsoft-Antispam-Message-Info: =?utf-8?q?DChTI5cNUPUpkcHnjMwpFXUTeL7PAEW?= =?utf-8?q?UckzqEEtOXzDYekrsSSCDc71mkIvwTFt26rQxBddKrnSmbGI3/U717x/IOwnq8WAC?= =?utf-8?q?0zl0ANDcqOhepEEB6DvUaBg8BKMK5bXKWlzb2d+LyZ9sRtP7u3/UTzE3xjcfmWio5?= =?utf-8?q?V8m/go/QtnmXtkWK3AMSESLGd7X2sVOtZmx30k5bhB6CWP3VNYhmzxxxcVyfFffhC?= =?utf-8?q?G6CnHVTP1eZhqClOI4MO1BLvAb/KeBrwAq+HZtE9SNrrhoSQVBBALFBoywsByDY7a?= =?utf-8?q?VCmn/D6luUQlT+G0eYGVsjUryC2n14LXNBFi5EOdQhE9kHNqwZXlWVNlEfHOKRqBB?= =?utf-8?q?swHKOJG3L6GjJfnL54USTAJP3C3d2+Ip//NOC2//cxe09MSN5zLK/mT6BGcNX9IiP?= =?utf-8?q?sy6jTtKR5F9BF0cBzcKxnrC9puPl0Vl7yVhVkTh2PC+KY4aiXr1YOIoEdLDZ60OsS?= =?utf-8?q?3sl9IF9Q4QE3l0O/GJOPZUES6RqzqfeVlBGQTTamwCAoNP4Cp+FuuDfYChwlOSrau?= =?utf-8?q?KYwGRyU3CkR6vLcG1Em7z0T/Zfmczf14HyMA44IDxas8gumInhjLn6Cma7jJwWeG2?= =?utf-8?q?OT/GqZCFILosJ2ow5BkDKojww3A4JluZpxshgpwJfrl0cYfvgY8OM/avBDgigZtMc?= =?utf-8?q?SwI7c5NzcU3gy+PXlr8HmdU8dIbDWxyU+DMqK4mPvd9nyIkbiDbk05qNn/AkBjz+b?= =?utf-8?q?NTk5E4pIGItNQjnBb/8nCAQuyf1cbuhx/hjHx2TLzUMV2qphOEO3geo/1B0aCPcVr?= =?utf-8?q?dGGTxf3DAgfHa9uXvsXOhHsSve1vXmdOoOzc464DRcbj1qcDslcVDHe3MUIOVX3Ju?= =?utf-8?q?MOSCt0vYoFA5mSjXLSQEeVkt0UvuI1E6p913K7FX9w7K+yCGyDO+on9SqSb72Wq74?= =?utf-8?q?e12J4/0gbTyzwJKT/JYEgDCSFWjwg9xbdr1lwv/l/GWsYeygE1mVyTsnojHb6iKks?= =?utf-8?q?4Ggq23wfHbkfMcERlTs5cog2ETCwZ0lriWaw8g6OKmkBe+ESSNMg00r4dCuZpG+ER?= =?utf-8?q?KhY3A10C4bkSNLRjaef/KXkiiqiZAl1/PKgY0/SmYwayVkfEFtTCcrY6uNpmfT4/8?= =?utf-8?q?hflzDKIVw+G3xPT4xSIyvMIb0oR16F3Ec/ANMX2DG0ee9Zu4Otj1eJTwxpFxfSpdg?= =?utf-8?q?b0EFdhvTqfHHLQs8uOqVLG1gTbdUaG09MntDCf46WclSsYd3I0iG2PlxozAabJi9b?= =?utf-8?q?P+jAwLhwc1Gijwi10T35WJSqOWMEvMafcgdVW+QuQzHtZkdXSlobmgGlKTHrE4ikb?= =?utf-8?q?qK+bNeU04HlQGTGRUMrZVuPzqn0L1I4sVhvJBizVxOyIQLzupJIcJUp+uwFKv9uTp?= =?utf-8?q?wzZXBdQ3m4X9?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AM9PR04MB8604.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(1800799024)(52116014)(7416014)(376014)(366016)(38350700014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?3hQJoKuiRG5P8/5QE+97flBJu4Jl?= =?utf-8?q?z0Cg7R2IlrSZ9I2bnEvT8d50X1YJAhEd5VUVer/VTAKnKAavdfKD4CQhtYX5O4Lrh?= =?utf-8?q?hwAx21MlcGsvPNFwv46rbev3s4HzDMMJFcZ6eVYCy6UL46YIbSHYSFTYCD6M0WcW7?= =?utf-8?q?Xpu7q/dFOJ3U3uglD0kB35EqpY7cjsnm7+CHmle/1zPJPacBmpE1E0KNE6IwyU7M/?= =?utf-8?q?OjWt3lWaSkAqyxEc3ZuZPLK+RdXRtz1Hv+PoCc7sRZQJv4HV+BssO/uIGeRGFMZny?= =?utf-8?q?Lx+yweYcXLEMY/F6k/dSAs2F+UXWZ4Y6aBLL7dDuNYYA5BriBEKc7rKIUqnAUCimX?= =?utf-8?q?3KzUym8Rc+3Kq6onRrxdvrCKo4KvUsqbsaT4gwTze3wY8pspAbO/AtiMkm7qbd6sk?= =?utf-8?q?p6n6NBeA51WhgRfVkp4JKE/qtPod4XKA2uD6O4imR/ZFcW2pBgBi4CK920HEiqU5v?= =?utf-8?q?aRLWS+mxDu5KUwzwHr6AMOptqlp9WST7ogFQ64SSRjQEco7aPfRlt0kcIy2HpLwyd?= =?utf-8?q?Lk44s70OEcFAg01aX1r7XgPx86UdPwbMYw5MQdSNVbgvlsfkEk1DpP6+KZeZ1W2S3?= =?utf-8?q?VPg6wFMKx8CxYyUE7lWqNmi5h8T/9nhlxM9sZS9DXK7/76cLaeFNNgG1G2q3WxItG?= =?utf-8?q?JEy/KfKMVAPU4vGzX/8kyG3sfQvDauhDuHd1y5fsJPKNUoSU8DQmMIUSEjuQRJgz/?= =?utf-8?q?2NC5HLEOo1jE+0+vqSrM8ATR+ErVHOFPGm8F3zv+xDUT8wD+PCSZz6XGrOpg+0qer?= =?utf-8?q?ca9ES8GOqOqm2SPvoaH9Z0NmwrU0Fkudt+OKFfnj1sIATKe7ueKCJXv8XJjoKRbrz?= =?utf-8?q?xVMQwqlEmvreoErP4SiWtC83I2h95LLD/NlavvnZkdQhrB8WTsQ3IkHnzqUhS8d+P?= =?utf-8?q?FafdGXj/s8X/vTgPPu/R0xj2jiIw59paDB9kowSH4ezQaShsK/3ytJEpIK/LSCwwl?= =?utf-8?q?TZzxpytkbx8SoEavtXw2P9lTce9njYLpnAIpPygRcStWBfqnGr95qhNYWHWCC22b/?= =?utf-8?q?IxL8DBCYK2mcyHtQa9tfsa/GHzxF1XYOLSDI+h5lV1eb+haDUijPUm6TfGnpsEZdp?= =?utf-8?q?zoj/FQnMr8DlYJvvAlZ1JVC5KTdt88iNwvJNi2UAaDPDTLE7JyerYWgUbfGhib0qd?= =?utf-8?q?yy2U4LQ43zNU1XWONgsOaPR95negxOKpNCwyyMKflmwjBqNnL0uqcp+vNihvJpSVN?= =?utf-8?q?ngI8m/zkX5iz5L8OfE83ViB8HE0yCaQV2IFG99bmjEny+lZIYqbXTPeq1esP+tzBQ?= =?utf-8?q?uUw6T9iA39bzJOpb7kHjE/KYb/96F8ht1tMuUT1JJvXwqjoA4Nzwql2yCeQqLgxtY?= =?utf-8?q?KdFrVjHC7Cn0ssF197ccAU9yohRQZEuPQjwhXI+8FJqxfzajwe06RkELz9Edfh72y?= =?utf-8?q?sCcvqieRwkKsW78MRvD5RF8UVWD2SJTN0DU175+cSpC48W+uoN7JYxR4Mhdl0nRX5?= =?utf-8?q?VxG3hVX+jAkpvpeSaH9QSUCp9kSXhhNplRLDnZiw3bXYiLMMZYVkaqtQj/l1lsRtX?= =?utf-8?q?i+3ilvUKwKEE?= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: e7fa9c80-2c5f-4775-6f28-08dd2031bb3f X-MS-Exchange-CrossTenant-AuthSource: AM9PR04MB8604.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Dec 2024 13:33:32.4308 (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: S62r3u3lL1CFFqtXCWpgRalJQNiqR85ol1C1fW0LMSWLwGyvSXsi1ohdYi79nJwwF/L1Hq8ufCS6VCNQGrC6Hg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DUZPR04MB9919 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20241219_053337_380111_DA7D8756 X-CRM114-Status: GOOD ( 13.13 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org The NXP security hardware IP(s) like: i.MX EdgeLock Enclave, V2X etc., creates an embedded secure enclave within the SoC boundary to enable features like: - HSM - SHE - V2X Secure-Enclave(s) communication interface are typically via message unit, i.e., based on mailbox linux kernel driver. This driver enables communication ensuring well defined message sequence protocol between Application Core and enclave's firmware. Driver configures multiple misc-device on the MU, for multiple user-space applications, to be able to communicate over single MU. It exists on some i.MX processors. e.g. i.MX8ULP, i.MX93 etc. Signed-off-by: Pankaj Gupta Reviewed-by: Rob Herring (Arm) Reviewed-by: Conor Dooley --- .../devicetree/bindings/firmware/fsl,imx-se.yaml | 91 ++++++++++++++++++++++ 1 file changed, 91 insertions(+) diff --git a/Documentation/devicetree/bindings/firmware/fsl,imx-se.yaml b/Documentation/devicetree/bindings/firmware/fsl,imx-se.yaml new file mode 100644 index 000000000000..0b617f61640f --- /dev/null +++ b/Documentation/devicetree/bindings/firmware/fsl,imx-se.yaml @@ -0,0 +1,91 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/firmware/fsl,imx-se.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: NXP i.MX HW Secure Enclave(s) EdgeLock Enclave + +maintainers: + - Pankaj Gupta + +description: | + NXP's SoC may contain one or multiple embedded secure-enclave HW + IP(s) like i.MX EdgeLock Enclave, V2X etc. These NXP's HW IP(s) + enables features like + - Hardware Security Module (HSM), + - Security Hardware Extension (SHE), and + - Vehicular to Anything (V2X) + + Communication interface to the secure-enclaves(se) is based on the + messaging unit(s). + +properties: + compatible: + enum: + - fsl,imx8ulp-se + - fsl,imx93-se + - fsl,imx95-se + + mboxes: + items: + - description: mailbox phandle to send message to se firmware + - description: mailbox phandle to receive message from se firmware + + mbox-names: + items: + - const: tx + - const: rx + + memory-region: + maxItems: 1 + + sram: + maxItems: 1 + +required: + - compatible + - mboxes + - mbox-names + +allOf: + # memory-region + - if: + properties: + compatible: + contains: + enum: + - fsl,imx8ulp-se + - fsl,imx93-se + then: + required: + - memory-region + else: + properties: + memory-region: false + + # sram + - if: + properties: + compatible: + contains: + enum: + - fsl,imx8ulp-se + then: + required: + - sram + + else: + properties: + sram: false + +additionalProperties: false + +examples: + - | + secure-enclave { + compatible = "fsl,imx95-se"; + mboxes = <&ele_mu0 0 0>, <&ele_mu0 1 0>; + mbox-names = "tx", "rx"; + }; +... From patchwork Thu Dec 19 18:57:24 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Pankaj Gupta X-Patchwork-Id: 13915097 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 7D450E77184 for ; Thu, 19 Dec 2024 13:37:55 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:MIME-Version:Cc:To: In-Reply-To:References:Message-Id:Content-Transfer-Encoding:Content-Type: Subject:Date:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=wK/QCHsvwxI5jajMDK5bmLW2wqApLKVfmMXXvNmjNTE=; b=LjRA6ZpB6Ze52yVgyIVQGuZ41y yWQgRqhg29BB+tCC4WE5t5y6bg8uE+wvE5fi7Hm51qkcpXvnfgeqdEpB2CigIuB7m4yzJMDOUCl6I 5ungY7t6LVmy6hOeY+Sj8p7h4Hr552wmSjBJTdPKxT/fhHpbUY9UXUMJh3yNeP3g68qePATsWxqOw zGtP37tvwfzLUfQXr/dHTWHPOw3QynawzmNEt/bcjlAUJ8kLkfhPEvHEL1LCQjXjFKPn+Db0JOzyb 51DyG1uE7pskMu3KbtWm5e9LNX/32hcQLeb2deUI02Hsyz+zEyOJjdpl4U4xfDj7wOnDGWjLP7qri FSyMlm+A==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98 #2 (Red Hat Linux)) id 1tOGin-00000001yBF-2bSp; Thu, 19 Dec 2024 13:37:45 +0000 Received: from mail-db8eur05on2060b.outbound.protection.outlook.com ([2a01:111:f403:2614::60b] helo=EUR05-DB8-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.98 #2 (Red Hat Linux)) id 1tOGes-00000001xK1-2eiK for linux-arm-kernel@lists.infradead.org; Thu, 19 Dec 2024 13:33:43 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=cS/CpqPd0wfj2v1mY1vYaaU6eyJmyRYE9Er27Tx0v8wJpC0PmFPYTy8kkh/vqma9rOeliMIn9h4V9GI/r6TGfGvwJXH7N9t4tEfjgbHUcIBGGvN1l2YcnfQa68gboQQJxLXq0w/OYsHh6rZtV/tS3QScrFJGToa3BkiYJ4BrczOdO/sZUwmoakhz/PvSFPJ0iuU6HHNEocxlQ4akkZb+sKh5OvmOecUQI3q3mW+TPCbjenG+UbwbujhrUfF7yhL+OGJzakertZ1LlPfVbiF80huWA31Whb2XO6mLGk1ksRWInMja5GK9xwhq7k+4C/qNcggwznFKB6za1AMK+jtUYQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=wK/QCHsvwxI5jajMDK5bmLW2wqApLKVfmMXXvNmjNTE=; b=iJVvFFIMOaFqQq1umNxmjl2RAawlRvv/6CcV83y6wWdwrFxeUSOJR5enPuQ+RCMB6rT3x2XsKW/gLxA1I5YS1cZ9gawNn80PlzMxTkbNU9wasFWK8Gs26ND2e9cVcmZ1zpp+weA0e83u0bruLscMiFb3lwm8kFGkjQIRKM4G4q5+M11igH02LeGMJxRhPwTEX7xAaJm3KQYRg+7msNj47yNrqVERUZD44bC6OhtxwoAvO2PC+WPA+aRROUqnU/+7kxKtNZo/iJ27sUmIAoKmDRBNmtVpB6UrAgjjeQ3Luo520jVed/IMXIjDp8Af29dB0CzOx0+VYntVwQ49YTPM7w== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=wK/QCHsvwxI5jajMDK5bmLW2wqApLKVfmMXXvNmjNTE=; b=RXDx1PgzxQst3N9czrEYrT5mFuuVjKwLCvhHq457qUtBVPLo269avDrXkrp6dUEOiyYnAWw1gs+sgL6SY48LykSqgy+k4j9eEHu3Jxi4mWXLI/Hrz6YibFbA8IAAAfIPQk8H8znAaeP3wgct5C8NmYjft3kPdLFfWQy04zYieA3+/Ma7oszy1lG6VeGF96X1mU0F+z+rKgUyDO4vTE5HYFOBDIZEPpZtBL0bC1jKs1ebWJu2VxZBhmlxxIvAFO9m8agwl6iCYXdN8AXjS5HLVp/aYTD4pwfKoTJL30Z3M0pmEZeyHPyHQJl5z7AKMESCdoj9h+gDV7t320zN0cLoqw== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from AM9PR04MB8604.eurprd04.prod.outlook.com (2603:10a6:20b:43b::21) by DUZPR04MB9919.eurprd04.prod.outlook.com (2603:10a6:10:4d9::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8272.13; Thu, 19 Dec 2024 13:33:40 +0000 Received: from AM9PR04MB8604.eurprd04.prod.outlook.com ([fe80::e751:223e:aa3d:5827]) by AM9PR04MB8604.eurprd04.prod.outlook.com ([fe80::e751:223e:aa3d:5827%4]) with mapi id 15.20.8272.013; Thu, 19 Dec 2024 13:33:39 +0000 From: Pankaj Gupta Date: Fri, 20 Dec 2024 00:27:24 +0530 Subject: [PATCH v11 3/5] arm64: dts: imx8ulp-evk: add nxp secure enclave firmware Message-Id: <20241220-imx-se-if-v11-3-0c7e65d7ae7b@nxp.com> References: <20241220-imx-se-if-v11-0-0c7e65d7ae7b@nxp.com> In-Reply-To: <20241220-imx-se-if-v11-0-0c7e65d7ae7b@nxp.com> To: Jonathan Corbet , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Shawn Guo , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , Pankaj Gupta Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org X-Mailer: b4 0.13.0 X-Developer-Signature: v=1; a=ed25519-sha256; t=1734634652; l=2640; i=pankaj.gupta@nxp.com; s=20240523; h=from:subject:message-id; bh=mAzNbzRWOh6wFu0SMI2UVtcJ4QuBAqfaQJrwAklpA20=; b=D69ghsza+3fqjFdbQ/2Jt1XXY29m8aWZFIPUjWGn2Gf5k057rT8Suquc3XtiiP9PpapJjli6l k1F9RYGpCgtAZqD5piVd1SzKL0LX3i54lb/WpNDg7gDLu/jB5ER0ysr X-Developer-Key: i=pankaj.gupta@nxp.com; a=ed25519; pk=OA0pBQoupy5lV0XfKzD8B0OOBVB6tpAoIf+0x1bYGRg= X-ClientProxiedBy: SG2P153CA0012.APCP153.PROD.OUTLOOK.COM (2603:1096::22) To AM9PR04MB8604.eurprd04.prod.outlook.com (2603:10a6:20b:43b::21) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AM9PR04MB8604:EE_|DUZPR04MB9919:EE_ X-MS-Office365-Filtering-Correlation-Id: 00a87e63-aa67-41eb-efd0-08dd2031bf4a X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|52116014|7416014|376014|366016|38350700014; X-Microsoft-Antispam-Message-Info: =?utf-8?q?BlCvMIj6u9qfOKoo/fI6aFHzN4319Rx?= =?utf-8?q?xrOorcVYGilYs+89S4b6m+e4ODTC+Tr3P8Wa0HU2p4JWpTSJrV9YVyJjJWPXxn4nJ?= =?utf-8?q?etqmXTYle54pJ9BArl2Uzn7vcC2MiwY0FMPsGm046Sw19wmK7ZK6DsMka+bCqrVS8?= =?utf-8?q?Q3UyIHz96e8s+C/LqGirYqv39JVMQD00gjOlinMpXBI+xicHzxKY/evdiSO4ERIPW?= =?utf-8?q?H/M8kdcAGaz4Wu7rthEpvzLbptyUds97uAwcDizzlhdqyUSIYmkzvuFjmUe/5RFBh?= =?utf-8?q?NhwtN4ld4CHAVmkVqgmSk2l0WekWky8ErR7wncrkhziZQ0ckegYeaSX+9cwKcFvOL?= =?utf-8?q?VEbFpLMXJ7mdmProhYeEHh68MC7QvbUAZ9qbnIWAc03szQQsOAuxqR/HIy5s1NkoA?= =?utf-8?q?OI7LUFWWL/QX6fj7T6oDwmpyiNQ0rMrqRerBGWPDsMXfHSYpskRn25Y52PMxaFbiM?= =?utf-8?q?7fpYWEwxwsoxXzMhEnnJDfe+ARPNHmSTkfyiWtLZAbezo+TpEN/IEB1Vvx/0mjk0C?= =?utf-8?q?4aP3j+BoWUBhr6s4SFAgmRBc9HgkKqZq62bkmuGg5TigWi/uck+LT5cVmimytGbaC?= =?utf-8?q?LvlML6upTJVEIqnRpFfmzNgtloBqqeskROQFRq8Pnocqf65DduhbC69my1Qh17/aU?= =?utf-8?q?RU0fkcltYSnZ/Ue/xuj0AWeo7lig7tUfbg4Rljcx3163h34Y5hKYxcd9rWfcfQnUE?= =?utf-8?q?KWs3twDi41PjqpC7riCwH4oJ+uGr8B3sP4nTdvTVmAomsT4DMeF7rxSxIdbaLqyXg?= =?utf-8?q?xhmBi73Mx3dQ4afZ1dwhkWD6NChYe/7BADbZgJzZ3R3dqnieFDArZadC/9GceW4K4?= =?utf-8?q?PQ033QdRb48V+Mpd48xwMBVYVl0gbgLQizxHSsltulZsWyV37xBzqxOCnWGryMqze?= =?utf-8?q?cSjLlatPI71c2C7so1+VcYvDmEtu2MW8xnrSEc5aQIKD7D3zM+ywrEZ9WH6TviQSp?= =?utf-8?q?6WZXhyKRmQUnoKvsmLNtrcS8ZFP8UV39LMEi3M7n2t4+lQamlqrJsYuqhBUUYRnSD?= =?utf-8?q?WnsJYqGKJRXy1AAdkJl0CdMxALo2dtSlRDO9D2yRYK9CMSMsUkOjBBCzedRNb+lu2?= =?utf-8?q?ww6OCqBASiEmCK3Qtkv5/c0rrKJaJEXSthNJhV7ZSL0USYTUl04/2kBVtiOOOq09q?= =?utf-8?q?CfT5ChCBYIcaAi/AKa34U+7YprwBl3e0/hoL3yfg50zaBs0B7q8rIE2cdcfdqqID5?= =?utf-8?q?NnWtF7EdxZ1ZYLeGXE+MyCqbsGiuuD+Phb1sTh13wIs6hbnVTFsl76ot+/Ze5BVb2?= =?utf-8?q?IcePtiCgIzpqVLuqx2qxpgVekXpO94TCFbzvMxrLZXizunZFkVwaKIg74w1G5jeiI?= =?utf-8?q?ceBZEyIaGKE1VhzOuciWccsC9WyAq/gNkDHQ2mvP41qH1tlfcxVgD1fOjPoTGpbN2?= =?utf-8?q?GIYN7L+wcGI?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AM9PR04MB8604.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(1800799024)(52116014)(7416014)(376014)(366016)(38350700014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?iccVqGE4EcmoEAIGPlsoPH2WmFgb?= =?utf-8?q?tP3rRjZYQmS8UqFGXEKBXRuphwEDcqIYrtv4DozRof2L4CQgJFA24G90o/lulYXH/?= =?utf-8?q?nW6Yod1AHOKmeL2vxp89L/DC95C6X2su9g8BUDhGtzOl/3cxXfmO6CcW4MnkdKfRf?= =?utf-8?q?ublq0OZsZ+Dgv6sJK7tTJ+/m5Se+El1aoWkAPiuGrFoKCXPQ9nxU3H2jf4SR/IQP9?= =?utf-8?q?GNqTtuW2Ap2jdjvP0qCQRTDesUWXScu3vgtRHumy3N9ZasrcB/kZTRmzcBtcNucD9?= =?utf-8?q?3r/pIvHcNfkagkTc7J8kXvq3j0nxU9b4r6aB1EMdpS6cl9KLEpKWYltrFRUxH7GJg?= =?utf-8?q?c8JBQX/lsjd6WDJUSnhSjOhb/gRIAczAAIn7I/C8ZURbG39Fx6WXlrw2jm7bYg9jT?= =?utf-8?q?2v9Ci+yo9yGYO+C0UFZT67FGWi8QVzF8XaH8LpYMm1eFhcRf20kxoq6WTIIPZqk1E?= =?utf-8?q?azh0/sWChpvEMtPoV01lIGWqqgC7/xS9GOxSwMrn4/cRiwdzi9mJTMkGH+V64KLiR?= =?utf-8?q?+d7pogXFfhHh7a/ZHp22mE4BdPlCjfecbXGLDs8QAngM17XuOlPETJVPVLDNMXcaw?= =?utf-8?q?oZIy0cAcx+pI1rRKtmoUNPdp4TKoXI/xGgy+LQqn+WLfolJQOCz+O/PWJVk4EvN2f?= =?utf-8?q?BFnQIOri4EcIgMokXhRkFnAo0OJO3QMvVY4zlJXnvA4xoGOQlod7QCY2gNqknYncY?= =?utf-8?q?iN2Cnx5ogaUyd0O2AZR3cE6l0a47m8Ng9eByATSgAI2Cu7T56a9zoDHpljGJqlnwK?= =?utf-8?q?3Kqx4MNnk+2th8/fEhFBsB5gLmD/++WlbVjQsrs77teFysaJycXdybL+3Ctk7AwJy?= =?utf-8?q?zTknszK4N2Ic6s2RdW3c+OcbtMqtOaVQK7KXip6IiSBElR7POEkKhJbHOlHwOEquA?= =?utf-8?q?TPxPOg53oUL5yg5Ord7LZPvr63LlpWkaFQXEm7EkiBVoyKN2ovhVKiuY0f+6YjgpB?= =?utf-8?q?hgq4uFj8JYOHx+QIT1Pm2GMAtCdY7M8q/orMbH2lhWLWg8fgWFQPqq2NVQ93Br5JS?= =?utf-8?q?Jhjh+xxDPCrBO9Om/NnBCkxgP2XnAs6/2faXjROkBn9Is4xgHnv4TIVaYjOk8bBSk?= =?utf-8?q?CDNKbApiBLUJ8pEAapzervXcGasH8Qr4d166SibEpDh138bjqQw4t3TztxUIL451K?= =?utf-8?q?2q3vWlHFI/WYT7s3uzS5/F2MupruoJe1urb+Mc6aoHlsE9d/2tc1f8q2HqbU1p2N2?= =?utf-8?q?0KgM/l8WVWaAMa5JiqQHSm/6xnKurfcd3FraI+TO4FKO1EtCFvmd1qvft+/b2zv/y?= =?utf-8?q?MDIJa2N0XST9X09gRAbi3wwfhmKqAR16i/0PPd7XnrlfKuau3hMLeyjxCrBcT3fu+?= =?utf-8?q?noi8ui+mPd/d1Bh/Wt6R+JYFCxpfpVW2XNbzxWmBhol774SQp0mCPY/jjIar37g2x?= =?utf-8?q?nESLHv00t4FqzmYipM5q2wXZPF/ujyZNzyGWCwE1NyVa6wz4k4yAGekJnYm+z12es?= =?utf-8?q?7vCMCh344M9PXj6RPRxS8COPsUPZo2SywfLLRLV1Xv2NOogSTt5eGfX04owAY4ABm?= =?utf-8?q?a7SOO7Hfv2JK?= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 00a87e63-aa67-41eb-efd0-08dd2031bf4a X-MS-Exchange-CrossTenant-AuthSource: AM9PR04MB8604.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Dec 2024 13:33:39.2590 (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: 0HgpmLA50sPUGNszbU/x+vdGntIIAiDWPY5HO1ZHV2A1NNwSQLltB0Up5zseu0OCL6H/1c1Q+spcyoECDyE5qw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DUZPR04MB9919 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20241219_053342_677405_AB646D00 X-CRM114-Status: GOOD ( 12.58 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Add support for NXP secure enclave called EdgeLock Enclave firmware (se-fw) for imx8ulp-evk. EdgeLock Enclave has a hardware limitation of restricted access to DDR address: 0x80000000 to 0xAFFFFFFF, so reserve 1MB of DDR memory region from 0x80000000. Signed-off-by: Pankaj Gupta --- arch/arm64/boot/dts/freescale/imx8ulp-evk.dts | 17 ++++++++++++++++- arch/arm64/boot/dts/freescale/imx8ulp.dtsi | 13 +++++++++++-- 2 files changed, 27 insertions(+), 3 deletions(-) diff --git a/arch/arm64/boot/dts/freescale/imx8ulp-evk.dts b/arch/arm64/boot/dts/freescale/imx8ulp-evk.dts index e937e5f8fa8b..f5963f4043c4 100644 --- a/arch/arm64/boot/dts/freescale/imx8ulp-evk.dts +++ b/arch/arm64/boot/dts/freescale/imx8ulp-evk.dts @@ -1,6 +1,6 @@ // SPDX-License-Identifier: (GPL-2.0+ OR MIT) /* - * Copyright 2021 NXP + * Copyright 2021, 2024 NXP */ /dts-v1/; @@ -19,6 +19,17 @@ memory@80000000 { device_type = "memory"; reg = <0x0 0x80000000 0 0x80000000>; }; + reserved-memory { + #address-cells = <2>; + #size-cells = <2>; + ranges; + + ele_reserved: ele-reserved@90000000 { + compatible = "shared-dma-pool"; + reg = <0 0x90000000 0 0x100000>; + no-map; + }; + }; reserved-memory { #address-cells = <2>; @@ -204,6 +215,10 @@ &usdhc0 { status = "okay"; }; +&ele_if0 { + memory-region = <&ele_reserved>; +}; + &fec { pinctrl-names = "default", "sleep"; pinctrl-0 = <&pinctrl_enet>; diff --git a/arch/arm64/boot/dts/freescale/imx8ulp.dtsi b/arch/arm64/boot/dts/freescale/imx8ulp.dtsi index e32d5afcf4a9..f98629b7f4cc 100644 --- a/arch/arm64/boot/dts/freescale/imx8ulp.dtsi +++ b/arch/arm64/boot/dts/freescale/imx8ulp.dtsi @@ -1,6 +1,6 @@ // SPDX-License-Identifier: (GPL-2.0+ OR MIT) /* - * Copyright 2021 NXP + * Copyright 2021, 2024 NXP */ #include @@ -152,7 +152,7 @@ sosc: clock-sosc { #clock-cells = <0>; }; - sram@2201f000 { + sram0: sram@2201f000 { compatible = "mmio-sram"; reg = <0x0 0x2201f000 0x0 0x1000>; @@ -167,6 +167,8 @@ scmi_buf: scmi-sram-section@0 { }; firmware { + #address-cells = <1>; + #size-cells = <0>; scmi { compatible = "arm,scmi-smc"; arm,smc-id = <0xc20000fe>; @@ -184,6 +186,13 @@ scmi_sensor: protocol@15 { #thermal-sensor-cells = <1>; }; }; + + ele_if0: secure-enclave { + compatible = "fsl,imx8ulp-se"; + mbox-names = "tx", "rx"; + mboxes = <&s4muap 0 0>, <&s4muap 1 0>; + sram = <&sram0>; + }; }; cm33: remoteproc-cm33 { From patchwork Thu Dec 19 18:57:25 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Pankaj Gupta X-Patchwork-Id: 13915105 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 2BBDFE77184 for ; Thu, 19 Dec 2024 13:39:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:MIME-Version:Cc:To: In-Reply-To:References:Message-Id:Content-Transfer-Encoding:Content-Type: Subject:Date:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=mRf2evG6/XfPAByIdKn5B26/94AArGTgUdKYFFEYhkc=; b=g333vIzLuP0VJf0kHSPRAGHa6h sd7Mq4ZbrLvn9skqqN7QCv1gs++2cXKcgB2475jn8rIYOQR5GX3dsuw6JC+C4wphHYogwwsHyOtCh GlJ4dBG8Q705jiAOk1v/C0e4DRlwFcv4MRjchjJ/nOoTCBjHN7DJRBqu7tDohMHiKYx+WD11ZEln/ LeDnMFEZbQvG3mG4inl+lbqqM3JEw/g2jNdfAc3wy4h0SKq9YuyRHIqkVFRZpMHlkqvsmQTU9vBxm 0ir4VbjB03/i8Wd6Vp0HVnboovTPqOEDzmIztViNf/pKFrJd5m/ETvbqoEaccVp4d7Kh45bz/l5Lm +tdBO22Q==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98 #2 (Red Hat Linux)) id 1tOGjs-00000001yJL-0yLl; Thu, 19 Dec 2024 13:38:52 +0000 Received: from mail-vi1eur05on2062f.outbound.protection.outlook.com ([2a01:111:f403:2613::62f] helo=EUR05-VI1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.98 #2 (Red Hat Linux)) id 1tOGex-00000001xLV-2QS5 for linux-arm-kernel@lists.infradead.org; Thu, 19 Dec 2024 13:33:49 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=keSMcl1KR4cuN/X2Nw6Sr4jXCEEROcXoYKZwj6SCuX9Do+qcLCiQeTVhNfKUNF0oQxqSMk4srNBUigW8OPkv95eXwtNQI+O3uHaFXWPXMlpNpT09nhymFaOynRrRhQ7n3LdA5qPSUtVErwYeSKdJXBWS11VheHWBhBnG+GBxnykHnebw6ZSk4azUHZXhQ7PZ+XLfuzJFu91Xg4AlNMS8FCzNskuK9UTWxFYCf2+PrxXu1OUyfMyToQL9PpJgMUjkqtaFKahtgAIH4D5+p6kyJ5dzlwwHtjkTYx+JOeBkeof3Gx4JKY2kg2kMMMUA+uHQGkxbsxe9i4S6NSYXY8yNaQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=mRf2evG6/XfPAByIdKn5B26/94AArGTgUdKYFFEYhkc=; b=nfo5TID01LxWG6PF0hRMfboV6TkyXEtN/602M0okvzx7oWZ5Lx841iiPD49b4UtrHWlAUVoFgLtYhb/k2P2kk/AS7B1NNMAR7pEUC4LCLAf/uZydy4XOj/+tWUBepqIZXAn2vfl19qpEBan+6Qa3rYbT2UOMg3rTI2J/l4qLM/1Mhld3l5pT4/9FHXJA2sSGjDmpXpEJbR+t7IoZiA4CSLmBRJ2DGgwMbXcWkgGtNu8EMN6mX2yOInKGnYrhNL9cITQ+skG7ROT5Ob0SBt6mZZMasKPqsdsYyRmQ3VTml6ySRt1Uk/Qrhgaj3IHuOyvlK7fW4PwsU9L0zpzNY6qkNg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=mRf2evG6/XfPAByIdKn5B26/94AArGTgUdKYFFEYhkc=; b=lehJT0jldF2FW+Df76eajssEKR+zAUDxIb5gougYjppmi3oeJROnwFlvDVrNTeZGfWxpG8WOtjuXfXhqCNgvem/hm/Chk3YMWyY4FhTNVf/JQ7u7wrx0SFZ/3gSA1WQjRH/SRBmvrSDkrn8ahWX5HgL1AoGTv7nKZjc/jOcd0vkFqjdx+IN0npQ1fXRk7cAyji/bu/HDgA0QJ1FSyRXtedMNJfp57JKbqQ6jrnu8Ua6/EoYzwIpmiElWtZbdwQpS2/ATdapfAGKbt4JZ9rErdxc2v14J+3LYWJ0siYeRRaOdWiwxxquuHD55oGDk2ald8o63/XCjytmqvi+KUgOUBw== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from AM9PR04MB8604.eurprd04.prod.outlook.com (2603:10a6:20b:43b::21) by DUZPR04MB9919.eurprd04.prod.outlook.com (2603:10a6:10:4d9::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8272.13; Thu, 19 Dec 2024 13:33:43 +0000 Received: from AM9PR04MB8604.eurprd04.prod.outlook.com ([fe80::e751:223e:aa3d:5827]) by AM9PR04MB8604.eurprd04.prod.outlook.com ([fe80::e751:223e:aa3d:5827%4]) with mapi id 15.20.8272.013; Thu, 19 Dec 2024 13:33:43 +0000 From: Pankaj Gupta Date: Fri, 20 Dec 2024 00:27:25 +0530 Subject: [PATCH v11 4/5] firmware: imx: add driver for NXP EdgeLock Enclave Message-Id: <20241220-imx-se-if-v11-4-0c7e65d7ae7b@nxp.com> References: <20241220-imx-se-if-v11-0-0c7e65d7ae7b@nxp.com> In-Reply-To: <20241220-imx-se-if-v11-0-0c7e65d7ae7b@nxp.com> To: Jonathan Corbet , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Shawn Guo , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , Pankaj Gupta Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org X-Mailer: b4 0.13.0 X-Developer-Signature: v=1; a=ed25519-sha256; t=1734634652; l=38921; i=pankaj.gupta@nxp.com; s=20240523; h=from:subject:message-id; bh=3xmB0szs/RkBGwPS3pBtBdA3jIJUlMVqR19c3Nqhn/A=; b=V1aAo9w8cM/FnVNsu/3wMf9nbe/Zt0ghCMZ+lgR1PCiYphvMDQ/yGtkdq0N1nVlC7K8jqbouM 7VrCZstbZc2Dse8mTm66KUwapMSIzTduK5CLoygeO5uKiExKza8jfQ+ X-Developer-Key: i=pankaj.gupta@nxp.com; a=ed25519; pk=OA0pBQoupy5lV0XfKzD8B0OOBVB6tpAoIf+0x1bYGRg= X-ClientProxiedBy: SG2P153CA0012.APCP153.PROD.OUTLOOK.COM (2603:1096::22) To AM9PR04MB8604.eurprd04.prod.outlook.com (2603:10a6:20b:43b::21) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AM9PR04MB8604:EE_|DUZPR04MB9919:EE_ X-MS-Office365-Filtering-Correlation-Id: a09592d1-86e7-4d1b-cf07-08dd2031c1ca X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|52116014|7416014|376014|366016|38350700014; X-Microsoft-Antispam-Message-Info: =?utf-8?q?ukXY2k9L+pxE+5zRnJPZLTjfHgsmFQg?= =?utf-8?q?ackiZaSikvRoGHCPc43BH0SKoaiPXLcqYxYtUu+TrFLSS+nlukveBNSSKELPBMiCp?= =?utf-8?q?Wu47nWe45ULLMTIWptvibfojp9ZgFNzASs/jemw42ezuwh3wsZw+AguoTPyP5Bt9N?= =?utf-8?q?bt00QOxZbmSECfPEJTOVu7UpL14Ic/ZSxKiA1O7VLEvJFxyeZ1Bqtkd3PzD6PV6KD?= =?utf-8?q?gnuuegMBLS9q4jF2sy6Ps13Lxerfla/jt+W5i8OWRBh4y20NIYpSOW/w0B/Wabg+k?= =?utf-8?q?4g86DY53kxDv0zZi1NXjaM1fO1UAoaD2SiBvY1CAIe+pgpi/CSWnHIdpq5GFfuruL?= =?utf-8?q?AB1bgeUs4PLSv3kpBcqOHAFZOt28pegVkq/7BEZAnmYk/LriOCK2xYmZjIaw22L9p?= =?utf-8?q?ZYvRYM5gayBhiCKR3RVsAMa5Bpi2gtrkpIXAReqLKuxhw7JNC0N6Ie8FwwbgVY0+s?= =?utf-8?q?wPD2Q1aDmU9lJ9TiET+DRgL5itejpOl2H1Kbb29BZxlnbaDgYLx1crwdTKgtUqpWc?= =?utf-8?q?R5O7kzAJ0MYWdMzvbvAK2ERhgfV65p49YXy8om3TcbXRfB5YPRyqKNMuo9IJEE0R3?= =?utf-8?q?3AZ7g7diBSzBue5nkXrEYwHRRttbg2NQxMfRA+ZCNuJDMYnAdbVIt+qx0/xdvNzYA?= =?utf-8?q?8er1SU/3dtLDV5tKn+7y7OARSIVdVMD0I+/woqQQb9XxWq44uQlwCqc8hJ9iIEiMR?= =?utf-8?q?AgVmjgGAfZPnxQSa2i7n3PpG5I9qy+xeCbSQtdtyB++UR1ysE8I5qfwz6f19JyHtN?= =?utf-8?q?PIyZ2bNVJlI3hFElBoRpPUKlFRyYR1yAocn0Iai0LXP+hzoIGnKFC1rGs3diFg8Zo?= =?utf-8?q?DcVluijgqfA2PD9DYEEpwj84ciO6VNUvpokZ2mJjdRAYIl+1rbHdQCt1nGyXlogBA?= =?utf-8?q?eMQQDFMrzENZytcrmC8UnxPBDIHmZW7Ib79HcfvBplrgKk5008TxVXYXSJ5x6ceZg?= =?utf-8?q?2vU5VQ05WlfhLMaiP0K9x8u9haNcx7VvnUSbIFU462aMNbRP4zxcz4sFK+EfnDurp?= =?utf-8?q?gjGiHESWccG/igQpmL2aa3zz9gQJF78VBWWhR8kT8aVZNO62F3JqTIPUZZ6L+gwcX?= =?utf-8?q?vaKgI7nRv9rR2Tpx5/GX7j02WKd+tV/nj+AJzSulx9Xqv+d0vn93TxXig0pwI7ITR?= =?utf-8?q?fpheahXlM9zDeoGdvdJ9kfUdhsC46VDCjobmY7sLqrfJZZ9DXeHkuAjM0lB00M4cu?= =?utf-8?q?h/AxMpKlZRsvUtISFag5JTDvepZ0nx6B6ToOVHmbxkkg4eHOlTl5Gs9FRNLoe8OoD?= =?utf-8?q?xSSwbcvkPyktaHVRg1zFK4kXSBt0/EWjbGfOofOHQq6hohtiY0xTWT3tYQI3+/bpI?= =?utf-8?q?56c9afMHIgXhfD0ly9NiQAfyWFntAFfYrIe12afd3PsfJxCgjkUWehWoKKtvwP/oX?= =?utf-8?q?xGKMlTNkwot?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AM9PR04MB8604.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(1800799024)(52116014)(7416014)(376014)(366016)(38350700014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?ZAcP1tZv0QMfnj6Ocn63JvvSPUBR?= =?utf-8?q?HuRDtXLeZJQP2+lSGb5PTU5Xj9ua0keTeRA35Gx0jHiKNnfXjP9ZNl7kGXZ3GzY5V?= =?utf-8?q?564dAZR8M8Sw2ggZYoqiD1HxWsTC93vqMa4rI/9jPHp2JFD7e1MnQnW0vSMIqC1Yz?= =?utf-8?q?SffGRkoAxtJcgn1Ey4uBOFmi9bBces/fTG+OJgIjEPMf52ZZuFlNzyx36q4Jqun0N?= =?utf-8?q?9fzfIP/DWL65Ve856CPOwyXHbk+uBO4tbXTZ7pcX6xJ2mwLC6uDHo64RhtX1CIMK6?= =?utf-8?q?3nv/+TCFa3ERgWMZc+sVXcaznOCSjXU9mvTuduRJm2qV6Yk+hx6MK7mGvx5DrfZhc?= =?utf-8?q?XXhyy4jktH1/x4j5lZlo6XWAbtDmv+YnC7dbLYYQR7c4eqdLddoX1TICRCgkPfXxJ?= =?utf-8?q?fuxCk9FPOnGpL9kKB3J1c+FFVPtmpKnE86Be18IuNT1YsxFDJG0ckBa2o+TBpkPs0?= =?utf-8?q?H78ssJpj1HKzRQbVzce40ZKmoe/DT+bc3Nd3pEQQ8/eRUry4wa6R24jZRjZiVyxyJ?= =?utf-8?q?oqpxz1gz8lTnQd6ffVI/o3oUa2dbyYzHnX1X0n6OLpye7q9gVdQU4hu0QItGxOAnW?= =?utf-8?q?DGUOzNNJ9/z2c9uUH+22/H6A/WnCBwYvVoQUVtP+5FFAWaVB/S+Hr/NeMeTDQicx9?= =?utf-8?q?ibGnOoQ5w9VgTPeASAXMcqrf3H8hlYN9oiyiAtJdmPPMV0Gosw2cCuATaWd6HCqLS?= =?utf-8?q?nWBQ7dhVp6LJW4OiKDXlQAQujyGnuUo93HwHnAR2WM+T/nZjpCfdvNQtPYooeYcyK?= =?utf-8?q?6L1duHd9l+fdzbQLTBF3fYKOZXNf60xdmYU7Bcq6FPie7HIP7pi2BkvXJKMWfq4Xe?= =?utf-8?q?g7E/qGkrD3FgEKCI7jR7pr/XkfNomqkxfei3dLMd2omPFRmBSYGaHIfDL+ZuCMcAp?= =?utf-8?q?jz7oco4Ust+otBBgH1viMNKvZ4GKrzUzQS7YYTUHvRQKF3P9pjDZPLbwFLez6eUMo?= =?utf-8?q?dUhbF/KiU+7QiKQw9C8eAvg4I50/+PdpdX6FAITgFexqZ+wqVtua3iFvBMt6EA/Fn?= =?utf-8?q?0s3jAFaoPArSn70RX9OWB+6FHiCI4KxEOe2+AvtBUFZFjIdNCzXyjxzQTR9EcYTgg?= =?utf-8?q?MP6Gd7hWSiHDPEcvWEYdbJJCwe8KzQSf9q4Ipt5JcOWLWk4gL4sd1bUlm4W3uA1OL?= =?utf-8?q?yPztlP3xjWjwNV+5fLP3qWmw2GHYDbhJ3bdLHl6+1Och1aJuWYis3+n1sZSOLv1wg?= =?utf-8?q?9qVwa/kv86D2WA5m5NamaprhmpNPr7n7T+flM7cUyM4JKFzBiRn9YHCkMnYGQiHk+?= =?utf-8?q?2uS71d9DamFULQlWHmoC1dxhuKh9WSZ1Qmb809b2RW5CEakvFxcl7H3Rbpkx4YQBS?= =?utf-8?q?mka1uz1lTMlIYpUHHsFO+PvSWYtHZ0FqSdyMY7YaFpGwt4jv2dWCr5otJyOuFEUQQ?= =?utf-8?q?H8z8YdeEgOqMO4WkPmhrdytwvdX+MHpjXoVVEaPmI5TgsaOajlZkVcYOk1x3vxVRO?= =?utf-8?q?Wnh3DKkP6jLreJ9IMTwJS3p9ujtWUVtT+dlBkDLnGH/eEdOuWVvf8LLfMIIhZF2wa?= =?utf-8?q?xwCzLV5eD4fo?= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: a09592d1-86e7-4d1b-cf07-08dd2031c1ca X-MS-Exchange-CrossTenant-AuthSource: AM9PR04MB8604.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Dec 2024 13:33:43.4656 (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: F4c1zaCPcmOAzo3sOvfQAEI4lBnO6uw8gzeTmbIBYiwPSQRd8lHQUOvPApksT90G8g4VimGKaulJdC7RBm2BqQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DUZPR04MB9919 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20241219_053347_975762_67953288 X-CRM114-Status: GOOD ( 22.26 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org NXP hardware IP(s) for secure-enclaves like Edgelock Enclave(ELE), are embedded in the SoC to support the features like HSM, SHE & V2X, using message based communication interface. The secure enclave FW communicates on a dedicated messaging unit(MU) based interface(s) with application core, where kernel is running. It exists on specific i.MX processors. e.g. i.MX8ULP, i.MX93. This patch adds the driver for communication interface to secure-enclave, for exchanging messages with NXP secure enclave HW IP(s) like EdgeLock Enclave (ELE) from Kernel-space, used by kernel management layers like - DM-Crypt. Signed-off-by: Pankaj Gupta --- drivers/firmware/imx/Kconfig | 13 + drivers/firmware/imx/Makefile | 2 + drivers/firmware/imx/ele_base_msg.c | 273 ++++++++++++++++++ drivers/firmware/imx/ele_base_msg.h | 94 +++++++ drivers/firmware/imx/ele_common.c | 323 ++++++++++++++++++++++ drivers/firmware/imx/ele_common.h | 51 ++++ drivers/firmware/imx/se_ctrl.c | 538 ++++++++++++++++++++++++++++++++++++ drivers/firmware/imx/se_ctrl.h | 94 +++++++ include/linux/firmware/imx/se_api.h | 14 + 9 files changed, 1402 insertions(+) diff --git a/drivers/firmware/imx/Kconfig b/drivers/firmware/imx/Kconfig index 477d3f32d99a..ccd9f9e0652e 100644 --- a/drivers/firmware/imx/Kconfig +++ b/drivers/firmware/imx/Kconfig @@ -33,3 +33,16 @@ config IMX_SCMI_MISC_DRV core that could provide misc functions such as board control. This driver can also be built as a module. + +config IMX_SEC_ENCLAVE + tristate "i.MX Embedded Secure Enclave - EdgeLock Enclave Firmware driver." + depends on IMX_MBOX && ARCH_MXC && ARM64 + select FW_LOADER + default m if ARCH_MXC + + help + It is possible to use APIs exposed by the iMX Secure Enclave HW IP called: + - EdgeLock Enclave Firmware (for i.MX8ULP, i.MX93), + like base, HSM, V2X & SHE using the SAB protocol via the shared Messaging + Unit. This driver exposes these interfaces via a set of file descriptors + allowing to configure shared memory, send and receive messages. diff --git a/drivers/firmware/imx/Makefile b/drivers/firmware/imx/Makefile index 8d046c341be8..4e1d2706535d 100644 --- a/drivers/firmware/imx/Makefile +++ b/drivers/firmware/imx/Makefile @@ -2,3 +2,5 @@ obj-$(CONFIG_IMX_DSP) += imx-dsp.o obj-$(CONFIG_IMX_SCU) += imx-scu.o misc.o imx-scu-irq.o rm.o imx-scu-soc.o obj-${CONFIG_IMX_SCMI_MISC_DRV} += sm-misc.o +sec_enclave-objs = se_ctrl.o ele_common.o ele_base_msg.o +obj-${CONFIG_IMX_SEC_ENCLAVE} += sec_enclave.o diff --git a/drivers/firmware/imx/ele_base_msg.c b/drivers/firmware/imx/ele_base_msg.c new file mode 100644 index 000000000000..aa00e95d6aee --- /dev/null +++ b/drivers/firmware/imx/ele_base_msg.c @@ -0,0 +1,273 @@ +// SPDX-License-Identifier: GPL-2.0+ +/* + * Copyright 2024 NXP + */ + +#include + +#include +#include +#include + +#include "ele_base_msg.h" +#include "ele_common.h" + +int ele_get_info(struct se_if_priv *priv, struct ele_dev_info *s_info) +{ + struct se_api_msg *tx_msg __free(kfree) = NULL; + struct se_api_msg *rx_msg __free(kfree) = NULL; + dma_addr_t get_info_addr = 0; + u32 *get_info_data = NULL; + int ret = 0; + + if (!priv) { + ret = -EINVAL; + return ret; + } + + memset(s_info, 0x0, sizeof(*s_info)); + + if (priv->mem_pool) + get_info_data = gen_pool_dma_alloc(priv->mem_pool, + ELE_GET_INFO_BUFF_SZ, + &get_info_addr); + else + get_info_data = dma_alloc_coherent(priv->dev, + ELE_GET_INFO_BUFF_SZ, + &get_info_addr, + GFP_KERNEL); + if (!get_info_data) { + ret = -ENOMEM; + dev_dbg(priv->dev, + "%s: Failed to allocate get_info_addr.\n", + __func__); + return ret; + } + + tx_msg = kzalloc(ELE_GET_INFO_REQ_MSG_SZ, GFP_KERNEL); + if (!tx_msg) { + ret = -ENOMEM; + goto exit; + } + + rx_msg = kzalloc(ELE_GET_INFO_RSP_MSG_SZ, GFP_KERNEL); + if (!rx_msg) { + ret = -ENOMEM; + goto exit; + } + + ret = se_fill_cmd_msg_hdr(priv, + (struct se_msg_hdr *)&tx_msg->header, + ELE_GET_INFO_REQ, + ELE_GET_INFO_REQ_MSG_SZ, + true); + if (ret) + goto exit; + + tx_msg->data[0] = upper_32_bits(get_info_addr); + tx_msg->data[1] = lower_32_bits(get_info_addr); + tx_msg->data[2] = sizeof(*s_info); + ret = ele_msg_send_rcv(priv, + tx_msg, + ELE_GET_INFO_REQ_MSG_SZ, + rx_msg, + ELE_GET_INFO_RSP_MSG_SZ); + if (ret < 0) + goto exit; + + ret = se_val_rsp_hdr_n_status(priv, + rx_msg, + ELE_GET_INFO_REQ, + ELE_GET_INFO_RSP_MSG_SZ, + true); + + memcpy(s_info, get_info_data, sizeof(*s_info)); + +exit: + if (priv->mem_pool) + gen_pool_free(priv->mem_pool, + (u64) get_info_data, + ELE_GET_INFO_BUFF_SZ); + else + dma_free_coherent(priv->dev, + ELE_GET_INFO_BUFF_SZ, + get_info_data, + get_info_addr); + + return ret; +} + +int ele_fetch_soc_info(struct se_if_priv *priv, void *data) +{ + int err; + + err = ele_get_info(priv, data); + if (err < 0) + return err; + + return err; +} + +int ele_ping(struct se_if_priv *priv) +{ + struct se_api_msg *tx_msg __free(kfree) = NULL; + struct se_api_msg *rx_msg __free(kfree) = NULL; + int ret = 0; + + if (!priv) { + ret = -EINVAL; + goto exit; + } + + tx_msg = kzalloc(ELE_PING_REQ_SZ, GFP_KERNEL); + if (!tx_msg) { + ret = -ENOMEM; + goto exit; + } + + rx_msg = kzalloc(ELE_PING_RSP_SZ, GFP_KERNEL); + if (!rx_msg) { + ret = -ENOMEM; + goto exit; + } + + ret = se_fill_cmd_msg_hdr(priv, + (struct se_msg_hdr *)&tx_msg->header, + ELE_PING_REQ, ELE_PING_REQ_SZ, true); + if (ret) { + dev_err(priv->dev, "Error: se_fill_cmd_msg_hdr failed.\n"); + goto exit; + } + + ret = ele_msg_send_rcv(priv, + tx_msg, + ELE_PING_REQ_SZ, + rx_msg, + ELE_PING_RSP_SZ); + if (ret < 0) + goto exit; + + ret = se_val_rsp_hdr_n_status(priv, + rx_msg, + ELE_PING_REQ, + ELE_PING_RSP_SZ, + true); +exit: + return ret; +} + +int ele_service_swap(struct se_if_priv *priv, + phys_addr_t addr, + u32 addr_size, u16 flag) +{ + struct se_api_msg *tx_msg __free(kfree) = NULL; + struct se_api_msg *rx_msg __free(kfree) = NULL; + int ret = 0; + + if (!priv) { + ret = -EINVAL; + goto exit; + } + + tx_msg = kzalloc(ELE_SERVICE_SWAP_REQ_MSG_SZ, GFP_KERNEL); + if (!tx_msg) { + ret = -ENOMEM; + goto exit; + } + + rx_msg = kzalloc(ELE_SERVICE_SWAP_RSP_MSG_SZ, GFP_KERNEL); + if (!rx_msg) { + ret = -ENOMEM; + goto exit; + } + + ret = se_fill_cmd_msg_hdr(priv, + (struct se_msg_hdr *)&tx_msg->header, + ELE_SERVICE_SWAP_REQ, + ELE_SERVICE_SWAP_REQ_MSG_SZ, true); + if (ret) + goto exit; + + tx_msg->data[0] = flag; + tx_msg->data[1] = addr_size; + tx_msg->data[2] = ELE_NONE_VAL; + tx_msg->data[3] = lower_32_bits(addr); + tx_msg->data[4] = se_add_msg_crc((uint32_t *)&tx_msg[0], + ELE_SERVICE_SWAP_REQ_MSG_SZ); + ret = ele_msg_send_rcv(priv, + tx_msg, + ELE_SERVICE_SWAP_REQ_MSG_SZ, + rx_msg, + ELE_SERVICE_SWAP_RSP_MSG_SZ); + if (ret < 0) + goto exit; + + ret = se_val_rsp_hdr_n_status(priv, + rx_msg, + ELE_SERVICE_SWAP_REQ, + ELE_SERVICE_SWAP_RSP_MSG_SZ, + true); + if (ret) + goto exit; + + if (flag == ELE_IMEM_EXPORT) + ret = rx_msg->data[1]; + else + ret = 0; + +exit: + + return ret; +} + +int ele_fw_authenticate(struct se_if_priv *priv, phys_addr_t addr) +{ + struct se_api_msg *tx_msg __free(kfree) = NULL; + struct se_api_msg *rx_msg __free(kfree) = NULL; + int ret = 0; + + if (!priv) { + ret = -EINVAL; + goto exit; + } + + tx_msg = kzalloc(ELE_FW_AUTH_REQ_SZ, GFP_KERNEL); + if (!tx_msg) { + ret = -ENOMEM; + goto exit; + } + + rx_msg = kzalloc(ELE_FW_AUTH_RSP_MSG_SZ, GFP_KERNEL); + if (!rx_msg) { + ret = -ENOMEM; + goto exit; + } + + ret = se_fill_cmd_msg_hdr(priv, + (struct se_msg_hdr *)&tx_msg->header, + ELE_FW_AUTH_REQ, + ELE_FW_AUTH_REQ_SZ, + true); + if (ret) + goto exit; + + tx_msg->data[1] = upper_32_bits(addr); + tx_msg->data[0] = lower_32_bits(addr); + tx_msg->data[2] = addr; + + ret = ele_msg_send_rcv(priv, + tx_msg, + ELE_FW_AUTH_REQ_SZ, + rx_msg, + ELE_FW_AUTH_RSP_MSG_SZ); + if (ret < 0) + goto exit; + + ret = se_val_rsp_hdr_n_status(priv, + rx_msg, + ELE_FW_AUTH_REQ, + ELE_FW_AUTH_RSP_MSG_SZ, + true); +exit: + return ret; +} diff --git a/drivers/firmware/imx/ele_base_msg.h b/drivers/firmware/imx/ele_base_msg.h new file mode 100644 index 000000000000..ef9eb8155167 --- /dev/null +++ b/drivers/firmware/imx/ele_base_msg.h @@ -0,0 +1,94 @@ +/* SPDX-License-Identifier: GPL-2.0+ */ +/* + * Copyright 2024 NXP + * + * Header file for the EdgeLock Enclave Base API(s). + */ + +#ifndef ELE_BASE_MSG_H +#define ELE_BASE_MSG_H + +#include +#include + +#include "se_ctrl.h" + +#define ELE_NONE_VAL 0x0 + +#define ELE_GET_INFO_REQ 0xDA +#define ELE_GET_INFO_REQ_MSG_SZ 0x10 +#define ELE_GET_INFO_RSP_MSG_SZ 0x08 + +#define SOC_ID_MASK 0x0000FFFF + +#define MAX_UID_SIZE (16) +#define DEV_GETINFO_ROM_PATCH_SHA_SZ (32) +#define DEV_GETINFO_FW_SHA_SZ (32) +#define DEV_GETINFO_OEM_SRKH_SZ (64) +#define DEV_GETINFO_MIN_VER_MASK 0xFF +#define DEV_GETINFO_MAJ_VER_MASK 0xFF00 +#define ELE_DEV_INFO_EXTRA_SZ 0x60 + +struct dev_info { + uint8_t cmd; + uint8_t ver; + uint16_t length; + uint16_t soc_id; + uint16_t soc_rev; + uint16_t lmda_val; + uint8_t ssm_state; + uint8_t dev_atts_api_ver; + uint8_t uid[MAX_UID_SIZE]; + uint8_t sha_rom_patch[DEV_GETINFO_ROM_PATCH_SHA_SZ]; + uint8_t sha_fw[DEV_GETINFO_FW_SHA_SZ]; +}; + +struct dev_addn_info { + uint8_t oem_srkh[DEV_GETINFO_OEM_SRKH_SZ]; + uint8_t trng_state; + uint8_t csal_state; + uint8_t imem_state; + uint8_t reserved2; +}; + +struct ele_dev_info { + struct dev_info d_info; + struct dev_addn_info d_addn_info; +}; + +#define ELE_GET_INFO_BUFF_SZ (sizeof(struct ele_dev_info) \ + + ELE_DEV_INFO_EXTRA_SZ) + +#define GET_SERIAL_NUM_FROM_UID(x, uid_word_sz) \ + (((u64)(((u32 *)(x))[(uid_word_sz) - 1]) << 32) | ((u32 *)(x))[0]) + +#define ELE_DEBUG_DUMP_REQ 0x21 +#define ELE_DEBUG_DUMP_RSP_SZ 0x17 + +#define ELE_PING_REQ 0x01 +#define ELE_PING_REQ_SZ 0x04 +#define ELE_PING_RSP_SZ 0x08 + +#define ELE_SERVICE_SWAP_REQ 0xDF +#define ELE_SERVICE_SWAP_REQ_MSG_SZ 0x18 +#define ELE_SERVICE_SWAP_RSP_MSG_SZ 0x0C +#define ELE_IMEM_SIZE 0x10000 +#define ELE_IMEM_STATE_OK 0xCA +#define ELE_IMEM_STATE_BAD 0xFE +#define ELE_IMEM_STATE_WORD 0x27 +#define ELE_IMEM_STATE_MASK 0x00ff0000 +#define ELE_IMEM_EXPORT 0x1 +#define ELE_IMEM_IMPORT 0x2 + +#define ELE_FW_AUTH_REQ 0x02 +#define ELE_FW_AUTH_REQ_SZ 0x10 +#define ELE_FW_AUTH_RSP_MSG_SZ 0x08 + +int ele_get_info(struct se_if_priv *priv, struct ele_dev_info *s_info); +int ele_fetch_soc_info(struct se_if_priv *priv, void *data); +int ele_ping(struct se_if_priv *priv); +int ele_service_swap(struct se_if_priv *priv, + phys_addr_t addr, + u32 addr_size, u16 flag); +int ele_fw_authenticate(struct se_if_priv *priv, phys_addr_t addr); +#endif diff --git a/drivers/firmware/imx/ele_common.c b/drivers/firmware/imx/ele_common.c new file mode 100644 index 000000000000..923eaa90cdd4 --- /dev/null +++ b/drivers/firmware/imx/ele_common.c @@ -0,0 +1,323 @@ +// SPDX-License-Identifier: GPL-2.0+ +/* + * Copyright 2024 NXP + */ + +#include "ele_base_msg.h" +#include "ele_common.h" + +u32 se_add_msg_crc(u32 *msg, u32 msg_len) +{ + u32 nb_words = msg_len / (u32)sizeof(u32); + u32 crc = 0; + u32 i; + + for (i = 0; i < nb_words - 1; i++) + crc ^= *(msg + i); + + return crc; +} + +int ele_msg_rcv(struct se_if_priv *priv, + struct se_clbk_handle *se_clbk_hdl) +{ + int err = 0; + + do { + /* If callback is executed before entrying to wait state, + * it will immediately come out after entering the wait state, + * but completion_done(&se_clbk_hdl->done), will return false + * after exiting the wait state, with err = 0. + */ + err = wait_for_completion_interruptible(&se_clbk_hdl->done); + if (err == -ERESTARTSYS) { + if (priv->waiting_rsp_clbk_hdl.rx_msg) { + priv->waiting_rsp_clbk_hdl.signal_rcvd = true; + continue; + } + dev_err(priv->dev, + "Err[0x%x]:Interrupted by signal.\n", + err); + err = -EINTR; + break; + } + } while (err != 0); + + return err ? err : se_clbk_hdl->rx_msg_sz; +} + +int ele_msg_send(struct se_if_priv *priv, + void *tx_msg, + int tx_msg_sz) +{ + struct se_msg_hdr *header; + int err; + + header = tx_msg; + + /* + * Check that the size passed as argument matches the size + * carried in the message. + */ + if (header->size << 2 != tx_msg_sz) { + err = -EINVAL; + dev_err(priv->dev, + "User buf hdr: 0x%x, sz mismatced with input-sz (%d != %d).", + *(u32 *)header, + header->size << 2, tx_msg_sz); + goto exit; + } + + err = mbox_send_message(priv->tx_chan, tx_msg); + if (err < 0) { + dev_err(priv->dev, "Error: mbox_send_message failure.\n"); + return err; + } + err = tx_msg_sz; + +exit: + return err; +} + +/* API used for send/receive blocking call. */ +int ele_msg_send_rcv(struct se_if_priv *priv, + void *tx_msg, + int tx_msg_sz, + void *rx_msg, + int exp_rx_msg_sz) +{ + int err; + + guard(mutex)(&priv->se_if_cmd_lock); + + priv->waiting_rsp_clbk_hdl.rx_msg_sz = exp_rx_msg_sz; + priv->waiting_rsp_clbk_hdl.rx_msg = rx_msg; + + err = ele_msg_send(priv, tx_msg, tx_msg_sz); + if (err < 0) + goto exit; + + err = ele_msg_rcv(priv, &priv->waiting_rsp_clbk_hdl); + + if (priv->waiting_rsp_clbk_hdl.signal_rcvd) { + err = -EINTR; + priv->waiting_rsp_clbk_hdl.signal_rcvd = false; + dev_err(priv->dev, + "Err[0x%x]:Interrupted by signal.\n", + err); + } + +exit: + return err; +} + +static bool exception_for_size(struct se_if_priv *priv, + struct se_msg_hdr *header) +{ + /* List of API(s) that can be accepte variable length + * response buffer. + */ + if (header->command == ELE_DEBUG_DUMP_REQ && + header->ver == priv->if_defs->base_api_ver && + header->size >= 0 && + header->size <= ELE_DEBUG_DUMP_RSP_SZ) + return true; + + return false; +} + +/* + * Callback called by mailbox FW, when data is received. + */ +void se_if_rx_callback(struct mbox_client *mbox_cl, void *msg) +{ + struct se_clbk_handle *se_clbk_hdl; + struct device *dev = mbox_cl->dev; + struct se_msg_hdr *header; + struct se_if_priv *priv; + u32 rx_msg_sz; + + priv = dev_get_drvdata(dev); + + /* The function can be called with NULL msg */ + if (!msg) { + dev_err(dev, "Message is invalid\n"); + return; + } + + header = msg; + rx_msg_sz = header->size << 2; + + /* Incoming command: wake up the receiver if any. */ + if (header->tag == priv->if_defs->cmd_tag) { + se_clbk_hdl = &priv->cmd_receiver_clbk_hdl; + dev_dbg(dev, + "Selecting cmd receiver for mesg header:0x%x.", + *(u32 *) header); + + /* Pre-allocated buffer of MAX_NVM_MSG_LEN + * as the NVM command are initiated by FW. + * Size is revealed as part of this call function. + */ + if (rx_msg_sz > MAX_NVM_MSG_LEN) { + dev_err(dev, + "CMD-RCVER NVM: hdr(0x%x) with different sz(%d != %d).\n", + *(u32 *) header, + rx_msg_sz, se_clbk_hdl->rx_msg_sz); + + se_clbk_hdl->rx_msg_sz = MAX_NVM_MSG_LEN; + } + se_clbk_hdl->rx_msg_sz = rx_msg_sz; + + } else if (header->tag == priv->if_defs->rsp_tag) { + se_clbk_hdl = &priv->waiting_rsp_clbk_hdl; + dev_dbg(dev, + "Selecting resp waiter for mesg header:0x%x.", + *(u32 *) header); + + if (rx_msg_sz != se_clbk_hdl->rx_msg_sz + && !exception_for_size(priv, header)) { + dev_err(dev, + "Rsp to CMD: hdr(0x%x) with different sz(%d != %d).\n", + *(u32 *) header, + rx_msg_sz, se_clbk_hdl->rx_msg_sz); + + se_clbk_hdl->rx_msg_sz = min(rx_msg_sz, se_clbk_hdl->rx_msg_sz); + } + } else { + dev_err(dev, "Failed to select a device for message: %.8x\n", + *((u32 *) header)); + return; + } + + memcpy(se_clbk_hdl->rx_msg, msg, se_clbk_hdl->rx_msg_sz); + + /* Allow user to read */ + complete(&se_clbk_hdl->done); +} + +int se_val_rsp_hdr_n_status(struct se_if_priv *priv, + struct se_api_msg *msg, + uint8_t msg_id, + uint8_t sz, + bool is_base_api) +{ + u32 status; + struct se_msg_hdr *header = &msg->header; + + if (header->tag != priv->if_defs->rsp_tag) { + dev_err(priv->dev, + "MSG[0x%x] Hdr: Resp tag mismatch. (0x%x != 0x%x)", + msg_id, header->tag, priv->if_defs->rsp_tag); + return -EINVAL; + } + + if (header->command != msg_id) { + dev_err(priv->dev, + "MSG Header: Cmd id mismatch. (0x%x != 0x%x)", + header->command, msg_id); + return -EINVAL; + } + + if (header->size != (sz >> 2) && !exception_for_size(priv, header)) { + dev_err(priv->dev, + "MSG[0x%x] Hdr: Cmd size mismatch. (0x%x != 0x%x)", + msg_id, header->size, (sz >> 2)); + return -EINVAL; + } + + if (is_base_api && (header->ver != priv->if_defs->base_api_ver)) { + dev_err(priv->dev, + "MSG[0x%x] Hdr: Base API Vers mismatch. (0x%x != 0x%x)", + msg_id, header->ver, priv->if_defs->base_api_ver); + return -EINVAL; + } else if (!is_base_api && header->ver != priv->if_defs->fw_api_ver) { + dev_err(priv->dev, + "MSG[0x%x] Hdr: FW API Vers mismatch. (0x%x != 0x%x)", + msg_id, header->ver, priv->if_defs->fw_api_ver); + return -EINVAL; + } + + status = RES_STATUS(msg->data[0]); + if (status != priv->if_defs->success_tag) { + dev_err(priv->dev, "Command Id[%x], Response Failure = 0x%x", + header->command, status); + return -EPERM; + } + + return 0; +} + +int se_save_imem_state(struct se_if_priv *priv, struct se_imem_buf *imem) +{ + int ret; + + /* EXPORT command will save encrypted IMEM to given address, + * so later in resume, IMEM can be restored from the given + * address. + * + * Size must be at least 64 kB. + */ + ret = ele_service_swap(priv, + imem->phyaddr, + ELE_IMEM_SIZE, + ELE_IMEM_EXPORT); + if (ret < 0) + dev_err(priv->dev, "Failed to export IMEM\n"); + else + dev_info(priv->dev, + "Exported %d bytes of encrypted IMEM\n", + ret); + + return ret; +} + +int se_restore_imem_state(struct se_if_priv *priv, struct se_imem_buf *imem) +{ + struct ele_dev_info s_info; + int ret; + + /* get info from ELE */ + ret = ele_get_info(priv, &s_info); + if (ret) { + dev_err(priv->dev, "Failed to get info from ELE.\n"); + return ret; + } + imem->state = s_info.d_addn_info.imem_state; + + /* Get IMEM state, if 0xFE then import IMEM */ + if (s_info.d_addn_info.imem_state == ELE_IMEM_STATE_BAD) { + /* IMPORT command will restore IMEM from the given + * address, here size is the actual size returned by ELE + * during the export operation + */ + ret = ele_service_swap(priv, + imem->phyaddr, + imem->size, + ELE_IMEM_IMPORT); + if (ret) { + dev_err(priv->dev, "Failed to import IMEM\n"); + goto exit; + } + } else + goto exit; + + /* After importing IMEM, check if IMEM state is equal to 0xCA + * to ensure IMEM is fully loaded and + * ELE functionality can be used. + */ + ret = ele_get_info(priv, &s_info); + if (ret) { + dev_err(priv->dev, "Failed to get info from ELE.\n"); + goto exit; + } + imem->state = s_info.d_addn_info.imem_state; + + if (s_info.d_addn_info.imem_state == ELE_IMEM_STATE_OK) + dev_info(priv->dev, "Successfully restored IMEM\n"); + else + dev_err(priv->dev, "Failed to restore IMEM\n"); + +exit: + return ret; +} diff --git a/drivers/firmware/imx/ele_common.h b/drivers/firmware/imx/ele_common.h new file mode 100644 index 000000000000..3d8b6f83fb9d --- /dev/null +++ b/drivers/firmware/imx/ele_common.h @@ -0,0 +1,51 @@ +/* SPDX-License-Identifier: GPL-2.0+ */ +/* + * Copyright 2024 NXP + */ + + +#ifndef __ELE_COMMON_H__ +#define __ELE_COMMON_H__ + +#include "se_ctrl.h" + +#define ELE_SUCCESS_IND 0xD6 + +#define IMX_ELE_FW_DIR "imx/ele/" + +uint32_t se_add_msg_crc(uint32_t *msg, uint32_t msg_len); +int ele_msg_rcv(struct se_if_priv *priv, + struct se_clbk_handle *se_clbk_hdl); +int ele_msg_send(struct se_if_priv *priv, + void *tx_msg, + int tx_msg_sz); +int ele_msg_send_rcv(struct se_if_priv *priv, + void *tx_msg, + int tx_msg_sz, + void *rx_msg, + int exp_rx_msg_sz); +void se_if_rx_callback(struct mbox_client *mbox_cl, void *msg); +int se_val_rsp_hdr_n_status(struct se_if_priv *priv, + struct se_api_msg *msg, + uint8_t msg_id, + uint8_t sz, + bool is_base_api); + +/* Fill a command message header with a given command ID and length in bytes. */ +static inline int se_fill_cmd_msg_hdr(struct se_if_priv *priv, + struct se_msg_hdr *hdr, + u8 cmd, u32 len, + bool is_base_api) +{ + hdr->tag = priv->if_defs->cmd_tag; + hdr->ver = (is_base_api) ? priv->if_defs->base_api_ver : priv->if_defs->fw_api_ver; + hdr->command = cmd; + hdr->size = len >> 2; + + return 0; +} + +int se_save_imem_state(struct se_if_priv *priv, struct se_imem_buf *imem); +int se_restore_imem_state(struct se_if_priv *priv, struct se_imem_buf *imem); + +#endif /*__ELE_COMMON_H__ */ diff --git a/drivers/firmware/imx/se_ctrl.c b/drivers/firmware/imx/se_ctrl.c new file mode 100644 index 000000000000..7260a9f93e06 --- /dev/null +++ b/drivers/firmware/imx/se_ctrl.c @@ -0,0 +1,538 @@ +// SPDX-License-Identifier: GPL-2.0+ +/* + * Copyright 2024 NXP + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "ele_base_msg.h" +#include "ele_common.h" +#include "se_ctrl.h" + +#define MAX_SOC_INFO_DATA_SZ 256 +#define MBOX_TX_NAME "tx" +#define MBOX_RX_NAME "rx" +#define SE_TYPE_STR_HSM "hsm" +#define SE_TYPE_ID_HSM 0x2 + +struct se_fw_img_name { + const u8 *prim_fw_nm_in_rfs; + const u8 *seco_fw_nm_in_rfs; +}; + +struct se_fw_load_info { + const struct se_fw_img_name *se_fw_img_nm; + bool is_fw_loaded; + bool handle_susp_resm; + struct se_imem_buf imem; +}; + +struct se_if_node_info { + u8 se_if_id; + u8 se_if_did; + struct se_if_defines if_defs; + u8 *pool_name; + bool reserved_dma_ranges; +}; + +/* contains fixed information */ +struct se_if_node_info_list { + const u8 num_mu; + const u16 soc_id; + bool soc_register; + int (*se_fetch_soc_info)(struct se_if_priv *priv, void *data); + const struct se_fw_img_name se_fw_img_nm; + const struct se_if_node_info info[]; +}; + +struct se_var_info { + u16 soc_rev; + struct se_fw_load_info load_fw; +}; + +static struct se_var_info var_se_info = { + .soc_rev = 0, + .load_fw = { + .is_fw_loaded = true, + .handle_susp_resm = false, + }, +}; + +static struct se_if_node_info_list imx8ulp_info = { + .num_mu = 1, + .soc_id = SOC_ID_OF_IMX8ULP, + .soc_register = true, + .se_fetch_soc_info = ele_fetch_soc_info, + .se_fw_img_nm = { + .prim_fw_nm_in_rfs = IMX_ELE_FW_DIR + "mx8ulpa2-ahab-container.img", + .seco_fw_nm_in_rfs = IMX_ELE_FW_DIR + "mx8ulpa2ext-ahab-container.img", + }, + .info = { + { + .se_if_id = 0, + .se_if_did = 7, + .if_defs = { + .se_if_type = SE_TYPE_ID_HSM, + .se_instance_id = 0, + .cmd_tag = 0x17, + .rsp_tag = 0xe1, + .success_tag = ELE_SUCCESS_IND, + .base_api_ver = MESSAGING_VERSION_6, + .fw_api_ver = MESSAGING_VERSION_7, + }, + .pool_name = "sram", + .reserved_dma_ranges = true, + }, + }, +}; + +static struct se_if_node_info_list imx93_info = { + .num_mu = 1, + .soc_id = SOC_ID_OF_IMX93, + .soc_register = false, + .se_fetch_soc_info = ele_fetch_soc_info, + .se_fw_img_nm = { + .prim_fw_nm_in_rfs = NULL, + .seco_fw_nm_in_rfs = NULL, + }, + .info = { + { + .se_if_id = 2, + .se_if_did = 3, + .if_defs = { + .se_if_type = SE_TYPE_ID_HSM, + .se_instance_id = 0, + .cmd_tag = 0x17, + .rsp_tag = 0xe1, + .success_tag = ELE_SUCCESS_IND, + .base_api_ver = MESSAGING_VERSION_6, + .fw_api_ver = MESSAGING_VERSION_7, + }, + .reserved_dma_ranges = true, + }, + }, +}; + +static const struct of_device_id se_match[] = { + { .compatible = "fsl,imx8ulp-se", .data = (void *)&imx8ulp_info}, + { .compatible = "fsl,imx93-se", .data = (void *)&imx93_info}, + {}, +}; + +static int se_soc_info(struct se_if_priv *priv) +{ + const struct se_if_node_info_list *info_list + = device_get_match_data(priv->dev); + struct soc_device_attribute *attr; + struct ele_dev_info *s_info; + struct soc_device *sdev; + u8 data[MAX_SOC_INFO_DATA_SZ]; + int err = 0; + + /* This function should be called once. + * Check if the se_soc_rev is zero to continue. + */ + if (var_se_info.soc_rev) + return err; + + if (info_list->se_fetch_soc_info) { + err = info_list->se_fetch_soc_info(priv, &data); + if (err < 0) { + dev_err(priv->dev, "Failed to fetch SoC Info."); + return err; + } + s_info = (void *)data; + var_se_info.soc_rev = s_info->d_info.soc_rev; + } else { + dev_err(priv->dev, "Failed to fetch SoC revision."); + if (info_list->soc_register) + dev_err(priv->dev, "Failed to do SoC registration."); + err = -EINVAL; + return err; + } + + if (!info_list->soc_register) + return 0; + + attr = devm_kzalloc(priv->dev, sizeof(*attr), GFP_KERNEL); + if (!attr) + return -ENOMEM; + + if (FIELD_GET(DEV_GETINFO_MIN_VER_MASK, var_se_info.soc_rev)) + attr->revision = devm_kasprintf(priv->dev, GFP_KERNEL, "%x.%x", + FIELD_GET(DEV_GETINFO_MIN_VER_MASK, + var_se_info.soc_rev), + FIELD_GET(DEV_GETINFO_MAJ_VER_MASK, + var_se_info.soc_rev)); + else + attr->revision = devm_kasprintf(priv->dev, GFP_KERNEL, "%x", + FIELD_GET(DEV_GETINFO_MAJ_VER_MASK, + var_se_info.soc_rev)); + + switch (info_list->soc_id) { + case SOC_ID_OF_IMX8ULP: + attr->soc_id = devm_kasprintf(priv->dev, GFP_KERNEL, + "i.MX8ULP"); + break; + case SOC_ID_OF_IMX93: + attr->soc_id = devm_kasprintf(priv->dev, GFP_KERNEL, + "i.MX93"); + break; + } + + err = of_property_read_string(of_root, "model", + &attr->machine); + if (err) + return -EINVAL; + + attr->family = devm_kasprintf(priv->dev, GFP_KERNEL, "Freescale i.MX"); + + attr->serial_number + = devm_kasprintf(priv->dev, GFP_KERNEL, "%016llX", + GET_SERIAL_NUM_FROM_UID(s_info->d_info.uid, MAX_UID_SIZE >> 2)); + + sdev = soc_device_register(attr); + if (IS_ERR(sdev)) + return PTR_ERR(sdev); + + return 0; +} + +static struct se_fw_load_info *get_load_fw_instance(struct se_if_priv *priv) +{ + return &var_se_info.load_fw; +} + +static int se_load_firmware(struct se_if_priv *priv) +{ + struct se_fw_load_info *load_fw = get_load_fw_instance(priv); + const struct firmware *fw; + phys_addr_t se_fw_phyaddr; + const u8 *se_img_file_to_load; + u8 *se_fw_buf; + int ret; + + if (load_fw->is_fw_loaded) + return 0; + + se_img_file_to_load = load_fw->se_fw_img_nm->seco_fw_nm_in_rfs; + if (load_fw->se_fw_img_nm->prim_fw_nm_in_rfs) { + /* allocate buffer where SE store encrypted IMEM */ + load_fw->imem.buf = dmam_alloc_coherent(priv->dev, ELE_IMEM_SIZE, + &load_fw->imem.phyaddr, + GFP_KERNEL); + if (!load_fw->imem.buf) { + dev_err(priv->dev, + "dmam-alloc-failed: To store encr-IMEM.\n"); + ret = -ENOMEM; + goto exit; + } + if (load_fw->imem.state == ELE_IMEM_STATE_BAD) + se_img_file_to_load + = load_fw->se_fw_img_nm->prim_fw_nm_in_rfs; + } + + do { + ret = request_firmware(&fw, se_img_file_to_load, priv->dev); + if (ret) + goto exit; + + dev_info(priv->dev, "loading firmware %s\n", se_img_file_to_load); + + /* allocate buffer to store the SE FW */ + se_fw_buf = dma_alloc_coherent(priv->dev, fw->size, + &se_fw_phyaddr, GFP_KERNEL); + if (!se_fw_buf) { + ret = -ENOMEM; + goto exit; + } + + memcpy(se_fw_buf, fw->data, fw->size); + ret = ele_fw_authenticate(priv, se_fw_phyaddr); + if (ret < 0) { + dev_err(priv->dev, + "Error %pe: Authenticate & load SE firmware %s.\n", + ERR_PTR(ret), + se_img_file_to_load); + ret = -EPERM; + } + + dma_free_coherent(priv->dev, + fw->size, + se_fw_buf, + se_fw_phyaddr); + + release_firmware(fw); + + if (!ret && load_fw->imem.state == ELE_IMEM_STATE_BAD && + se_img_file_to_load == load_fw->se_fw_img_nm->prim_fw_nm_in_rfs) + se_img_file_to_load = load_fw->se_fw_img_nm->seco_fw_nm_in_rfs; + else + se_img_file_to_load = NULL; + + } while (se_img_file_to_load); + + if (!ret) + load_fw->is_fw_loaded = true; + +exit: + return ret; +} + +/* interface for managed res to free a mailbox channel */ +static void if_mbox_free_channel(void *mbox_chan) +{ + mbox_free_channel(mbox_chan); +} + +static int se_if_request_channel(struct device *dev, + struct mbox_chan **chan, + struct mbox_client *cl, + const char *name) +{ + struct mbox_chan *t_chan; + int ret = 0; + + t_chan = mbox_request_channel_byname(cl, name); + if (IS_ERR(t_chan)) { + ret = PTR_ERR(t_chan); + return dev_err_probe(dev, ret, + "Failed to request %s channel.", name); + } + + ret = devm_add_action(dev, if_mbox_free_channel, t_chan); + if (ret) { + dev_err(dev, "failed to add devm removal of mbox %s\n", name); + goto exit; + } + + *chan = t_chan; + +exit: + return ret; +} + +static void se_if_probe_cleanup(void *plat_dev) +{ + struct platform_device *pdev = plat_dev; + struct device *dev = &pdev->dev; + struct se_fw_load_info *load_fw; + struct se_if_priv *priv; + + priv = dev_get_drvdata(dev); + load_fw = get_load_fw_instance(priv); + + /* In se_if_request_channel(), passed the clean-up functional + * pointer reference as action to devm_add_action(). + * No need to free the mbox channels here. + */ + + /* free the buffer in se remove, previously allocated + * in se probe to store encrypted IMEM + */ + if (load_fw && load_fw->imem.buf) { + dmam_free_coherent(dev, + ELE_IMEM_SIZE, + load_fw->imem.buf, + load_fw->imem.phyaddr); + load_fw->imem.buf = NULL; + } + + /* No need to check, if reserved memory is allocated + * before calling for its release. Or clearing the + * un-set bit. + */ + of_reserved_mem_device_release(dev); +} + +static int se_if_probe(struct platform_device *pdev) +{ + const struct se_if_node_info_list *info_list; + const struct se_if_node_info *info; + struct device *dev = &pdev->dev; + struct se_fw_load_info *load_fw; + struct se_if_priv *priv; + u32 idx; + int ret; + + idx = GET_IDX_FROM_DEV_NODE_NAME(dev->of_node); + info_list = device_get_match_data(dev); + if (idx >= info_list->num_mu) { + dev_err(dev, + "Incorrect node name :%s\n", + dev->of_node->full_name); + dev_err(dev, + "%s-, acceptable index range is 0..%d\n", + dev->of_node->name, + info_list->num_mu - 1); + ret = -EINVAL; + return ret; + } + + info = &info_list->info[idx]; + if (!info) { + ret = -EINVAL; + goto exit; + } + + priv = devm_kzalloc(dev, sizeof(*priv), GFP_KERNEL); + if (!priv) { + ret = -ENOMEM; + goto exit; + } + + priv->dev = dev; + priv->if_defs = &info->if_defs; + dev_set_drvdata(dev, priv); + + ret = devm_add_action(dev, se_if_probe_cleanup, pdev); + if (ret) + goto exit; + + + /* Mailbox client configuration */ + priv->se_mb_cl.dev = dev; + priv->se_mb_cl.tx_block = false; + priv->se_mb_cl.knows_txdone = true; + priv->se_mb_cl.rx_callback = se_if_rx_callback; + + ret = se_if_request_channel(dev, &priv->tx_chan, + &priv->se_mb_cl, MBOX_TX_NAME); + if (ret) + goto exit; + + ret = se_if_request_channel(dev, &priv->rx_chan, + &priv->se_mb_cl, MBOX_RX_NAME); + if (ret) + goto exit; + + mutex_init(&priv->se_if_cmd_lock); + + init_completion(&priv->waiting_rsp_clbk_hdl.done); + init_completion(&priv->cmd_receiver_clbk_hdl.done); + + if (info->pool_name) { + priv->mem_pool = of_gen_pool_get(dev->of_node, + info->pool_name, 0); + if (!priv->mem_pool) { + dev_err(dev, + "Unable to get sram pool = %s\n", + info->pool_name); + goto exit; + } + } + + if (info->reserved_dma_ranges) { + ret = of_reserved_mem_device_init(dev); + if (ret) { + dev_err(dev, + "failed to init reserved memory region %d\n", + ret); + goto exit; + } + } + + if (info->if_defs.se_if_type == SE_TYPE_ID_HSM) { + ret = se_soc_info(priv); + if (ret) { + dev_err(dev, + "failed[%pe] to fetch SoC Info\n", ERR_PTR(ret)); + goto exit; + } + } + + /* By default, there is no pending FW to be loaded.*/ + if (info_list->se_fw_img_nm.prim_fw_nm_in_rfs || + info_list->se_fw_img_nm.seco_fw_nm_in_rfs) { + load_fw = get_load_fw_instance(priv); + load_fw->se_fw_img_nm = &info_list->se_fw_img_nm; + + load_fw->is_fw_loaded = false; + } + dev_info(dev, "i.MX secure-enclave: %s%d interface to firmware, configured.\n", + SE_TYPE_STR_HSM, + priv->if_defs->se_instance_id); + return ret; + +exit: + /* if execution control reaches here, if probe fails. + */ + return dev_err_probe(dev, ret, "%s: Probe failed.", __func__); +} + +static void se_if_remove(struct platform_device *pdev) +{ + se_if_probe_cleanup(pdev); +} + +static int se_suspend(struct device *dev) +{ + struct se_if_priv *priv = dev_get_drvdata(dev); + struct se_fw_load_info *load_fw; + int ret = 0; + + load_fw = get_load_fw_instance(priv); + + if (load_fw->handle_susp_resm) { + ret = se_save_imem_state(priv, &load_fw->imem); + if (ret < 0) + goto exit; + load_fw->imem.size = ret; + } +exit: + return ret; +} + +static int se_resume(struct device *dev) +{ + struct se_if_priv *priv = dev_get_drvdata(dev); + struct se_fw_load_info *load_fw; + + load_fw = get_load_fw_instance(priv); + + if (load_fw->handle_susp_resm) + se_restore_imem_state(priv, &load_fw->imem); + + return 0; +} + +static const struct dev_pm_ops se_pm = { + SET_SYSTEM_SLEEP_PM_OPS(se_suspend, se_resume) +}; + +static struct platform_driver se_driver = { + .driver = { + .name = "fsl-se", + .of_match_table = se_match, + .pm = &se_pm, + }, + .probe = se_if_probe, + .remove = se_if_remove, +}; +MODULE_DEVICE_TABLE(of, se_match); + +module_platform_driver(se_driver); +MODULE_AUTHOR("Pankaj Gupta "); +MODULE_DESCRIPTION("iMX Secure Enclave Driver."); +MODULE_LICENSE("GPL"); diff --git a/drivers/firmware/imx/se_ctrl.h b/drivers/firmware/imx/se_ctrl.h new file mode 100644 index 000000000000..12c201b503b1 --- /dev/null +++ b/drivers/firmware/imx/se_ctrl.h @@ -0,0 +1,94 @@ +/* SPDX-License-Identifier: GPL-2.0+ */ +/* + * Copyright 2024 NXP + */ + +#ifndef SE_MU_H +#define SE_MU_H + +#include +#include +#include + +#define MAX_FW_LOAD_RETRIES 50 + +#define RES_STATUS(x) FIELD_GET(0x000000ff, x) +#define MAX_NVM_MSG_LEN (256) +#define MESSAGING_VERSION_6 0x6 +#define MESSAGING_VERSION_7 0x7 +#define NODE_NAME "secure-enclave" + +#define GET_ASCII_TO_U8(diff, tens_chr, ones_chr) \ + ((diff > 2) ? (((tens_chr - '0') * 10) + (ones_chr - '0')) :\ + (tens_chr - '0')) + +#define GET_IDX_FROM_DEV_NODE_NAME(dev_of_node) \ + ((strlen(dev_of_node->full_name) > strlen(NODE_NAME)) ?\ + GET_ASCII_TO_U8((strlen(dev_of_node->full_name) - strlen(NODE_NAME)),\ + dev_of_node->full_name[strlen(NODE_NAME) + 1], \ + dev_of_node->full_name[strlen(NODE_NAME) + 2]) : 0) + +struct se_clbk_handle { + struct completion done; + bool signal_rcvd; + u32 rx_msg_sz; + /* Assignment of the rx_msg buffer to held till the + * received content as part callback function, is copied. + */ + struct se_api_msg *rx_msg; +}; + +struct se_imem_buf { + u8 *buf; + phys_addr_t phyaddr; + u32 size; + u32 state; +}; + +/* Header of the messages exchange with the EdgeLock Enclave */ +struct se_msg_hdr { + u8 ver; + u8 size; + u8 command; + u8 tag; +} __packed; + +#define SE_MU_HDR_SZ 4 + +struct se_api_msg { + struct se_msg_hdr header; + u32 data[]; +}; + +struct se_if_defines { + const u8 se_if_type; + const u8 se_instance_id; + u8 cmd_tag; + u8 rsp_tag; + u8 success_tag; + u8 base_api_ver; + u8 fw_api_ver; +}; + +struct se_if_priv { + struct device *dev; + + struct se_clbk_handle cmd_receiver_clbk_hdl; + /* Update to the waiting_rsp_dev, to be protected + * under se_if_cmd_lock. + */ + struct se_clbk_handle waiting_rsp_clbk_hdl; + /* + * prevent new command to be sent on the se interface while previous + * command is still processing. (response is awaited) + */ + struct mutex se_if_cmd_lock; + + struct mbox_client se_mb_cl; + struct mbox_chan *tx_chan, *rx_chan; + + struct gen_pool *mem_pool; + const struct se_if_defines *if_defs; +}; + +#endif diff --git a/include/linux/firmware/imx/se_api.h b/include/linux/firmware/imx/se_api.h new file mode 100644 index 000000000000..c47f84906837 --- /dev/null +++ b/include/linux/firmware/imx/se_api.h @@ -0,0 +1,14 @@ +/* SPDX-License-Identifier: GPL-2.0+ */ +/* + * Copyright 2024 NXP + */ + +#ifndef __SE_API_H__ +#define __SE_API_H__ + +#include + +#define SOC_ID_OF_IMX8ULP 0x084D +#define SOC_ID_OF_IMX93 0x9300 + +#endif /* __SE_API_H__ */ From patchwork Thu Dec 19 18:57:26 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Pankaj Gupta X-Patchwork-Id: 13915106 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id F267DE77184 for ; Thu, 19 Dec 2024 13:40:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:MIME-Version:Cc:To: In-Reply-To:References:Message-Id:Content-Transfer-Encoding:Content-Type: Subject:Date:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=DxXI30d9wpW5/u2bSBk64wjtQjM3kSqg51v8qMan0DA=; b=u0UUI9PzDThLT5VRRNdSAEreQB M91OS1Za3iQqdUcefZmcMBjY6OEIFD/M3TK2gTfR5/OgQNhWyprGzYrYWaCeToA199QVk4uUQDCAI nuFy+HD6dQWjLc5Nle2Lgj0IDjhYA6g+CJA/VugSK2NWyIroR+/0CIvc6twjinXv84dPK4Ed7t0ir vnXjcUKI3IM4IrNokdRmca+j5esXNDfdcyKeSAdTFP2yYzSTOL1LVMokS4UQqKJSluZzHYP42fogj ZcJlxbhfheKwfe8E06vb5LgAAue+17f+sMjP/BrlQjSjZrFNXWC/az4DkKxKZ+wReuz5EjtOgLUfU G//f/Dlg==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98 #2 (Red Hat Linux)) id 1tOGkw-00000001yPe-49nq; Thu, 19 Dec 2024 13:39:59 +0000 Received: from mail-vi1eur05on2062f.outbound.protection.outlook.com ([2a01:111:f403:2613::62f] helo=EUR05-VI1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.98 #2 (Red Hat Linux)) id 1tOGez-00000001xLV-3zX1 for linux-arm-kernel@lists.infradead.org; Thu, 19 Dec 2024 13:33:51 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=MKRY8e+6NItiAEqrqzIn32K8PNu2aPlY13O6BZ5+ghCSNsF+iT+5K+fx5BtUUNJXZaicyekMRDuiaEBjxKuJaAmSVPoBkDWQsxeqXCRzvJfJITgTC1wQpxK/u7x43+QCR/jWNpwYcfPib1/OaqKbIaS3eaDwGjI/KiuWgqbxSVSJhti89Mvf7AH0AkpJllJ/NclsPTvRUiybQ+KwOpmSHY/AVIAZQA+s22x75Kc/eRgQdPZed24fKC614D89DZQYQ24b3rBpHMgJzFFnNhMHq6s70xrF2efmgrq1MtKVb6vTq7ba2fjEuUfVCLzG0x41j35M/aUWNGAVmywmw+4K1w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=DxXI30d9wpW5/u2bSBk64wjtQjM3kSqg51v8qMan0DA=; b=HKPLG0txhubs6IAwgV6YF/xA3OWqVQ0n9i2OweHEbaGKPwygAjPp1ou0B8DcrbPy3E28u9Z282HKRitkF+t7j4sWcDussRErwXp2TGVdwNH9xNcvhN2oONxxuMgdcHOMjgw0lPTlZp8vHB+IU6cEL201v9f0k+HP3fzhyC1DcMVS0l25VRJJFoQlC3n2xB3tRk6Qo05wrlEDaL1EVdJnCHonvMK5gWCShhzEjIsrutMiL8bBR8AVEDw/iUDtOkfalvYH64qwA56ucjmBgjl0DvVgycjJCHfgGlrBgQRyBTXt/J1qCHjjboG3GPGDgF1uVymKSX/DICXABwoFiO4tQw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=DxXI30d9wpW5/u2bSBk64wjtQjM3kSqg51v8qMan0DA=; b=DVNp6COV+oE1rx/1IhKuTpVFIYwHkVk/Co5x0nHSi+bJ787Xf/bwbL5VCb4Tre43HV1O5RgX7IIEH+NkxfwKt5IUc6R1VpGjd+obMMuTBIuzzw/tMcz3udSMRVlPIv+paL4WFUmD1VJeCSQisc9aNklFutcDeyybRL3JIfQDGuNecO4kktJfE7AWobsObXXbEhIJc0A41yQpNAoe67TpUeQD7b4jN8Zngdu+lXo8c39wrQ3tME8gfXGtPK/YygpBwfhbSwSjBJ1K6NUn3R4/8RvvzBuDcAOHlYr0kHCpQ9gjphQfnIjPfk2aTLdF8tEOQceQMJsabYazMAnV1qw+dA== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from AM9PR04MB8604.eurprd04.prod.outlook.com (2603:10a6:20b:43b::21) by DUZPR04MB9919.eurprd04.prod.outlook.com (2603:10a6:10:4d9::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8272.13; Thu, 19 Dec 2024 13:33:47 +0000 Received: from AM9PR04MB8604.eurprd04.prod.outlook.com ([fe80::e751:223e:aa3d:5827]) by AM9PR04MB8604.eurprd04.prod.outlook.com ([fe80::e751:223e:aa3d:5827%4]) with mapi id 15.20.8272.013; Thu, 19 Dec 2024 13:33:47 +0000 From: Pankaj Gupta Date: Fri, 20 Dec 2024 00:27:26 +0530 Subject: [PATCH v11 5/5] firmware: imx: adds miscdev Message-Id: <20241220-imx-se-if-v11-5-0c7e65d7ae7b@nxp.com> References: <20241220-imx-se-if-v11-0-0c7e65d7ae7b@nxp.com> In-Reply-To: <20241220-imx-se-if-v11-0-0c7e65d7ae7b@nxp.com> To: Jonathan Corbet , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Shawn Guo , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , Pankaj Gupta Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org X-Mailer: b4 0.13.0 X-Developer-Signature: v=1; a=ed25519-sha256; t=1734634652; l=39237; i=pankaj.gupta@nxp.com; s=20240523; h=from:subject:message-id; bh=G35evSFW+rPtqODxz4pjLI2IX9pmRdlAfzoyAILTke8=; b=0kIfRr29rFSgonf/KsSLxBOlmHhBfYwrfwtSmcNd6l3qbV6BPHx2AsZaFjtcIMhfYKR0ZVDov 4cNsfwF+09wBgmX8WMfcWxkp5zEPdp2ZJxBRY4LSMSbM8isD7BNg6Di X-Developer-Key: i=pankaj.gupta@nxp.com; a=ed25519; pk=OA0pBQoupy5lV0XfKzD8B0OOBVB6tpAoIf+0x1bYGRg= X-ClientProxiedBy: SG2P153CA0012.APCP153.PROD.OUTLOOK.COM (2603:1096::22) To AM9PR04MB8604.eurprd04.prod.outlook.com (2603:10a6:20b:43b::21) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AM9PR04MB8604:EE_|DUZPR04MB9919:EE_ X-MS-Office365-Filtering-Correlation-Id: b8029a6a-5336-4a71-7ff1-08dd2031c43c X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|52116014|7416014|376014|366016|38350700014; X-Microsoft-Antispam-Message-Info: =?utf-8?q?M8pkwg/LGhF/U17eFCkTmz1yPfHRDWw?= =?utf-8?q?b1tpC9aaArioiqT79S2wop6BrKxQOI4xjswBddl18EOXyp+9mk79KEI3paDO/hggT?= =?utf-8?q?lPsvX7drWhN4hIPXk44KWRmloPxJo0t3h3nc2lc08U0vghX4J6hd9786iiFyWXdKZ?= =?utf-8?q?pC7qrhSTDBtOdx6qli+CpYzF3yFudb4WMIB0lxD+qrKy7OxZn/A5Tl4PK6RYOdW+S?= =?utf-8?q?46X2XFMjJj11q4RfdZFp56EzTBnGxBJGXhypz4l3h1sBszQz0O1CMuO8zBuy8bJcd?= =?utf-8?q?LZjWQ6vEqdHFIBY0qpsDcCXkIoKDw23U6YQIKY+OSumnHKYRhe19E3Dgi1alI57Lc?= =?utf-8?q?IjaBnt4hbhUNux7C8u6Y3eSaWEocFR6iz4jhtUKy48i/vPk3lR90iuY6CePJiJE8D?= =?utf-8?q?8GZRw/gozq8xrcvT5RrD4+TewuYet2LzKuir+L13b62jg7HywuNWRtvAt4ujBHbi/?= =?utf-8?q?O5lbnYLx1kPF+2OzdqaJJkCxHJdkJOSJoOVMaMxSII6CUz3NXaYt3B1bB/oS7zfCs?= =?utf-8?q?FrjkFuZ1sRfJRbSje9Bom98RSZ3qbWi0zmEgaMkKCVPnb7mO+IoAt40o/kmjgA82A?= =?utf-8?q?RtjXGs65tK8xyoUN8jvoLJxBe4Z/xD/PgOUsovkwdnv7M8j8bbuy0XfOrUJXLxWar?= =?utf-8?q?tqt89h55GMh8CsISqaKkZ1gmPgRqLHvdxsPKMJyIf7EQytN7rCq1GAd8+YaSS33ze?= =?utf-8?q?OqTjU/xe8z9sFNrTDP8lTU64nMpXEFMkVEU4tQavJIGb6QpWffSOReGTFhy7yqMwv?= =?utf-8?q?K5oVTNhblN58Wr/tICeImn/AUkE4joaU/Y0ylGw8xNxL84Nhvy92qPsLoc0d8q77c?= =?utf-8?q?cC0DYWID9dAh7KsFMfWRvpZth5FpG3vgNRV5phj8OAqvSjRyVdhOc/+sV3A+Hfx8E?= =?utf-8?q?d1vdEqB1oiT2pIVhMYCuRZhLW6EEAlY1BZ/K7LkOg/WoFIku3RMYb7pKAfiRCOlVa?= =?utf-8?q?WunccVXXBvJFlWH+AYvPeqQGP6H7NbwraQGouVjMjQAruqINLJxL3uHqD1od14HYx?= =?utf-8?q?VrIPtryYw2b76l07NQZJe0TvQS1rmoL0AAJiN9IH2QT/wdw8RAE1/hc75/rEbPSvG?= =?utf-8?q?NoUwFf7V4LJjKDv+urqjC/UzqIeLM70GJIcDvSHCM0oIpeU25u+lblGivplz0+qVF?= =?utf-8?q?TxUDUf3pShB6ZMCKzRKU0VaTSxUGoWrJAg74OCTuImpLhCI0DsU9RkTSGuPlNJ4Px?= =?utf-8?q?+2Nt4j4Lx4mWefqUFAsBpXe4KNwxJZjP8IBypThjxKTpvETxzHVa74uNJakG1mn1L?= =?utf-8?q?Tr7Iw11v0crJEuyR3cBnwEZBRlzHROeu5MxD01YfAvJQq9w5AA/S/UYiXko0TJ8O0?= =?utf-8?q?n1p0kyQTz6WnnlPq2Cbjv22YTdMAdhgiHpXsEBnPfMFs+Z5fCUkK7G5iCCf6PCRJV?= =?utf-8?q?2JsvZ2esLfF?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AM9PR04MB8604.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(1800799024)(52116014)(7416014)(376014)(366016)(38350700014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?+aJ/VA/UIn1HX+hq88W54z4EjVdp?= =?utf-8?q?gJ/uj9TfSJubSLT5bO5e8FGxARVS5hXRonDdRE8sZNrsehsR5Og1vX1XysYDIED0Z?= =?utf-8?q?C9G705nzwT+tWAf9TNpkWrhkNuDeyoRLQ7P8slH0rEHzkJcyG0wYbo8ZDT/0UDM61?= =?utf-8?q?+/H4qLdJ+BVp8vhZeNn4+Y/P7Gm3snUKazlWlrcgvMEOCXce3libwIpAiMIYLycjw?= =?utf-8?q?1m//8ruw8dDytyD8/KQbHQUYCwarY/onsm+8DQA0wpdgQnA+GZRUMhgx7T5XR8WaJ?= =?utf-8?q?z3ZWhH1DAiaDN1ZgBm36XsGXnIk2i06qNFxH9TVtUyuiwi2p8ZiG3fhPdggpIKF/z?= =?utf-8?q?fAQrNf9RyCzSfJxkb6KGqmkLZEWjmBNEFskzRJbj87Y76pbHHy6v8dHBvsBuHPg3C?= =?utf-8?q?SkN0xWP+NR0EH4zzXz0k+sisnFoF8qKzPSGoT1IcRGHuFGU5l1NeNGJ8XGrBXqNwA?= =?utf-8?q?gws51LS2eNfACyXPys2z9PgWrMtgXNb2ZTE2k0CmbZ4T+4iwdEsmHEwdGM3DmUe71?= =?utf-8?q?pG5rvvaO82cUnwNoBoi8qUWytCfO7j8rtBRlakB+3D39wi/1D77k+cNKIuaQoXVsD?= =?utf-8?q?d0EAmyLEok58/KvzCFjNXgLtnrGDdAA1l7u+IIrX5vV7WiSCYNo+qPGeX+6+yhg4X?= =?utf-8?q?dBEVdvAo/5ZlxAvHr2t/pGGAqPwGceLlZftgx2Ks6de8oE+Q2Zt8V5Omlwlu/0cq2?= =?utf-8?q?TbTWYXsZiyjcB2AV4zw37OPs/A8fSQcJsvZwGkg1AgYFSfAMQyvF73T+NvN6rVgYK?= =?utf-8?q?H49NPgYu6FDYpyGW0pzLi94TnawLY86ScDiuqhlRBFtecryXZ0EKzmJWadQgIdUFM?= =?utf-8?q?SLTZCRE0teiPJd2NeT+fmvAsXj/xX6lFeqxim8v7fWJx+QuSkB61DJ8jU5nMax4t6?= =?utf-8?q?HEg/3KAbR3Ht2aMPwT3slOtphZXXLHPj1DBoV0SnG2OjAy8LrwN54otIVzGhwy+UA?= =?utf-8?q?knyrE4cyZRsGW4OkNlk1HcBoPzqhZ3GbuaOKnIDl+MwmNEZkP7/QKbhRNLyr15gaJ?= =?utf-8?q?t296TFLeMEeTekrzTmvWrc0MNgAkAByMoyV1pyEGRR06jZcaP8wnfwSxjscluaxkt?= =?utf-8?q?3e3uxDhPa+DPZb5WcqVGXv2XbVPYl4f9Bcxi+0OSXBoSwku9LddjooAZtHg1LBbV5?= =?utf-8?q?YBK8djU3SamFAnjB+pKd6Rrb0ZSSx47t/u/yydFpa/ahM1GRhdC5M0OPN1MjQxwzZ?= =?utf-8?q?NVZ/M4ZjcqAkA1iZNmuecrq4Qz8ZrizicRdhEiTJDtK+UxCKft2BW3bWJnuCTlDhF?= =?utf-8?q?1tgk9TpltS3CnVTyKY4x11R8R4dCJQNbvR1FkJgH/cA4dgn106uHFb+TPxABulEM5?= =?utf-8?q?so1PrCzRJBZrtoVBVMy57Vsb7lytaWhjOoew0FUDMFbovWhwIwC/nNCo38vJVNW0A?= =?utf-8?q?pRl+hdb7/mYlJuevMv800Pw7OK/FqXGkDzJSKmVmXOEgW8WxB1r6tzrVcEPXK/X3w?= =?utf-8?q?FuT8sIvICC1U/owsvKBw/BwP0vvrydPsg1EUYqDFoMobQALCdMsU0fmfVl7xelD3+?= =?utf-8?q?7oVxUnPfTIRU?= X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: b8029a6a-5336-4a71-7ff1-08dd2031c43c X-MS-Exchange-CrossTenant-AuthSource: AM9PR04MB8604.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Dec 2024 13:33:47.6186 (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: x/zukncH5odH0rlEpd4m1iyLhEfpERlzRyfIlkuBnKojrQXY20Y0c4eANEWSqJtsFkbEwnTINWMZdtV15N/QIw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DUZPR04MB9919 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20241219_053350_183155_7ABBB75E X-CRM114-Status: GOOD ( 21.63 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Adds the driver for communication interface to secure-enclave, for exchanging messages with NXP secure enclave HW IP(s) like EdgeLock Enclave from: - User-Space Applications via character driver. ABI documentation for the NXP secure-enclave driver. User-space library using this driver: - i.MX Secure Enclave library: -- URL: https://github.com/nxp-imx/imx-secure-enclave.git, - i.MX Secure Middle-Ware: -- URL: https://github.com/nxp-imx/imx-smw.git Signed-off-by: Pankaj Gupta --- Documentation/ABI/testing/se-cdev | 43 ++ drivers/firmware/imx/ele_base_msg.c | 8 +- drivers/firmware/imx/ele_common.c | 85 ++-- drivers/firmware/imx/ele_common.h | 6 +- drivers/firmware/imx/se_ctrl.c | 791 +++++++++++++++++++++++++++++++++++- drivers/firmware/imx/se_ctrl.h | 42 ++ include/uapi/linux/se_ioctl.h | 101 +++++ 7 files changed, 1041 insertions(+), 35 deletions(-) diff --git a/Documentation/ABI/testing/se-cdev b/Documentation/ABI/testing/se-cdev new file mode 100644 index 000000000000..3451c909ccc4 --- /dev/null +++ b/Documentation/ABI/testing/se-cdev @@ -0,0 +1,43 @@ +What: /dev/_mu[0-9]+_ch[0-9]+ +Date: May 2024 +KernelVersion: 6.8 +Contact: linux-imx@nxp.com, pankaj.gupta@nxp.com +Description: + NXP offers multiple hardware IP(s) for secure enclaves like EdgeLock- + Enclave(ELE), SECO. The character device file descriptors + /dev/_mu*_ch* are the interface between userspace NXP's secure- + enclave shared library and the kernel driver. + + The ioctl(2)-based ABI is defined and documented in + [include]. + ioctl(s) are used primarily for: + - shared memory management + - allocation of I/O buffers + - getting mu info + - setting a dev-ctx as receiver to receive all the commands from FW + - getting SoC info + - send command and receive command response + + The following file operations are supported: + + open(2) + Currently the only useful flags are O_RDWR. + + read(2) + Every read() from the opened character device context is waiting on + wait_event_interruptible, that gets set by the registered mailbox callback + function, indicating a message received from the firmware on message- + unit. + + write(2) + Every write() to the opened character device context needs to acquire + mailbox_lock before sending message on to the message unit. + + close(2) + Stops and frees up the I/O contexts that were associated + with the file descriptor. + +Users: https://github.com/nxp-imx/imx-secure-enclave.git, + https://github.com/nxp-imx/imx-smw.git + crypto/skcipher, + drivers/nvmem/imx-ocotp-ele.c diff --git a/drivers/firmware/imx/ele_base_msg.c b/drivers/firmware/imx/ele_base_msg.c index aa00e95d6aee..ff9a39530fa9 100644 --- a/drivers/firmware/imx/ele_base_msg.c +++ b/drivers/firmware/imx/ele_base_msg.c @@ -67,7 +67,7 @@ int ele_get_info(struct se_if_priv *priv, struct ele_dev_info *s_info) tx_msg->data[0] = upper_32_bits(get_info_addr); tx_msg->data[1] = lower_32_bits(get_info_addr); tx_msg->data[2] = sizeof(*s_info); - ret = ele_msg_send_rcv(priv, + ret = ele_msg_send_rcv(priv->priv_dev_ctx, tx_msg, ELE_GET_INFO_REQ_MSG_SZ, rx_msg, @@ -139,7 +139,7 @@ int ele_ping(struct se_if_priv *priv) goto exit; } - ret = ele_msg_send_rcv(priv, + ret = ele_msg_send_rcv(priv->priv_dev_ctx, tx_msg, ELE_PING_REQ_SZ, rx_msg, @@ -194,7 +194,7 @@ int ele_service_swap(struct se_if_priv *priv, tx_msg->data[3] = lower_32_bits(addr); tx_msg->data[4] = se_add_msg_crc((uint32_t *)&tx_msg[0], ELE_SERVICE_SWAP_REQ_MSG_SZ); - ret = ele_msg_send_rcv(priv, + ret = ele_msg_send_rcv(priv->priv_dev_ctx, tx_msg, ELE_SERVICE_SWAP_REQ_MSG_SZ, rx_msg, @@ -255,7 +255,7 @@ int ele_fw_authenticate(struct se_if_priv *priv, phys_addr_t addr) tx_msg->data[0] = lower_32_bits(addr); tx_msg->data[2] = addr; - ret = ele_msg_send_rcv(priv, + ret = ele_msg_send_rcv(priv->priv_dev_ctx, tx_msg, ELE_FW_AUTH_REQ_SZ, rx_msg, diff --git a/drivers/firmware/imx/ele_common.c b/drivers/firmware/imx/ele_common.c index 923eaa90cdd4..acabbccf3e36 100644 --- a/drivers/firmware/imx/ele_common.c +++ b/drivers/firmware/imx/ele_common.c @@ -18,38 +18,62 @@ u32 se_add_msg_crc(u32 *msg, u32 msg_len) return crc; } -int ele_msg_rcv(struct se_if_priv *priv, +int ele_msg_rcv(struct se_if_device_ctx *dev_ctx, struct se_clbk_handle *se_clbk_hdl) { - int err = 0; + struct se_if_priv *priv = dev_ctx->priv; + bool wait_timeout_enabled = true; + unsigned int wait; + int err; do { - /* If callback is executed before entrying to wait state, - * it will immediately come out after entering the wait state, - * but completion_done(&se_clbk_hdl->done), will return false - * after exiting the wait state, with err = 0. - */ - err = wait_for_completion_interruptible(&se_clbk_hdl->done); + if (priv->cmd_receiver_clbk_hdl.dev_ctx == dev_ctx) { + /* For NVM-D that are slaves of SE-FW, are waiting indefinitly + * to receive the command from SE-FW. + */ + wait_timeout_enabled = false; + + /* If callback is executed before entrying to wait state, + * it will immediately come out after entering the wait state, + * but completion_done(&se_clbk_hdl->done), will return false + * after exiting the wait state, with err = 0. + */ + err = wait_for_completion_interruptible(&se_clbk_hdl->done); + } else { + /* FW must send the message response to application in a finite + * time. + */ + wait = msecs_to_jiffies(10000); + err = wait_for_completion_interruptible_timeout(&se_clbk_hdl->done, wait); + } if (err == -ERESTARTSYS) { - if (priv->waiting_rsp_clbk_hdl.rx_msg) { + if (priv->waiting_rsp_clbk_hdl.dev_ctx) { priv->waiting_rsp_clbk_hdl.signal_rcvd = true; continue; } - dev_err(priv->dev, - "Err[0x%x]:Interrupted by signal.\n", - err); err = -EINTR; break; } - } while (err != 0); + if (err == 0) { + if (wait_timeout_enabled) { + err = -ETIMEDOUT; + dev_err(priv->dev, + "Fatal Error: SE interface: %s%d, hangs indefinitely.\n", + get_se_if_name(priv->if_defs->se_if_type), + priv->if_defs->se_instance_id); + } + break; + } + } while (err < 0); - return err ? err : se_clbk_hdl->rx_msg_sz; + return (err >= 0) ? se_clbk_hdl->rx_msg_sz : err; } -int ele_msg_send(struct se_if_priv *priv, +int ele_msg_send(struct se_if_device_ctx *dev_ctx, void *tx_msg, int tx_msg_sz) { + struct se_if_priv *priv = dev_ctx->priv; struct se_msg_hdr *header; int err; @@ -62,7 +86,8 @@ int ele_msg_send(struct se_if_priv *priv, if (header->size << 2 != tx_msg_sz) { err = -EINVAL; dev_err(priv->dev, - "User buf hdr: 0x%x, sz mismatced with input-sz (%d != %d).", + "%s: User buf hdr: 0x%x, sz mismatced with input-sz (%d != %d).", + dev_ctx->devname, *(u32 *)header, header->size << 2, tx_msg_sz); goto exit; @@ -70,7 +95,9 @@ int ele_msg_send(struct se_if_priv *priv, err = mbox_send_message(priv->tx_chan, tx_msg); if (err < 0) { - dev_err(priv->dev, "Error: mbox_send_message failure.\n"); + dev_err(priv->dev, + "%s: Error: mbox_send_message failure.", + dev_ctx->devname); return err; } err = tx_msg_sz; @@ -80,32 +107,36 @@ int ele_msg_send(struct se_if_priv *priv, } /* API used for send/receive blocking call. */ -int ele_msg_send_rcv(struct se_if_priv *priv, +int ele_msg_send_rcv(struct se_if_device_ctx *dev_ctx, void *tx_msg, int tx_msg_sz, void *rx_msg, int exp_rx_msg_sz) { int err; + struct se_if_priv *priv = dev_ctx->priv; guard(mutex)(&priv->se_if_cmd_lock); + priv->waiting_rsp_clbk_hdl.dev_ctx = dev_ctx; priv->waiting_rsp_clbk_hdl.rx_msg_sz = exp_rx_msg_sz; priv->waiting_rsp_clbk_hdl.rx_msg = rx_msg; - err = ele_msg_send(priv, tx_msg, tx_msg_sz); + err = ele_msg_send(dev_ctx, tx_msg, tx_msg_sz); if (err < 0) goto exit; - err = ele_msg_rcv(priv, &priv->waiting_rsp_clbk_hdl); + err = ele_msg_rcv(dev_ctx, &priv->waiting_rsp_clbk_hdl); if (priv->waiting_rsp_clbk_hdl.signal_rcvd) { err = -EINTR; priv->waiting_rsp_clbk_hdl.signal_rcvd = false; dev_err(priv->dev, - "Err[0x%x]:Interrupted by signal.\n", + "%s: Err[0x%x]:Interrupted by signal.\n", + dev_ctx->devname, err); } + priv->waiting_rsp_clbk_hdl.dev_ctx = NULL; exit: return err; @@ -152,7 +183,8 @@ void se_if_rx_callback(struct mbox_client *mbox_cl, void *msg) if (header->tag == priv->if_defs->cmd_tag) { se_clbk_hdl = &priv->cmd_receiver_clbk_hdl; dev_dbg(dev, - "Selecting cmd receiver for mesg header:0x%x.", + "Selecting cmd receiver:%s for mesg header:0x%x.", + se_clbk_hdl->dev_ctx->devname, *(u32 *) header); /* Pre-allocated buffer of MAX_NVM_MSG_LEN @@ -161,7 +193,8 @@ void se_if_rx_callback(struct mbox_client *mbox_cl, void *msg) */ if (rx_msg_sz > MAX_NVM_MSG_LEN) { dev_err(dev, - "CMD-RCVER NVM: hdr(0x%x) with different sz(%d != %d).\n", + "%s: CMD-RCVER NVM: hdr(0x%x) with different sz(%d != %d).\n", + se_clbk_hdl->dev_ctx->devname, *(u32 *) header, rx_msg_sz, se_clbk_hdl->rx_msg_sz); @@ -172,13 +205,15 @@ void se_if_rx_callback(struct mbox_client *mbox_cl, void *msg) } else if (header->tag == priv->if_defs->rsp_tag) { se_clbk_hdl = &priv->waiting_rsp_clbk_hdl; dev_dbg(dev, - "Selecting resp waiter for mesg header:0x%x.", + "Selecting resp waiter:%s for mesg header:0x%x.", + se_clbk_hdl->dev_ctx->devname, *(u32 *) header); if (rx_msg_sz != se_clbk_hdl->rx_msg_sz && !exception_for_size(priv, header)) { dev_err(dev, - "Rsp to CMD: hdr(0x%x) with different sz(%d != %d).\n", + "%s: Rsp to CMD: hdr(0x%x) with different sz(%d != %d).\n", + se_clbk_hdl->dev_ctx->devname, *(u32 *) header, rx_msg_sz, se_clbk_hdl->rx_msg_sz); diff --git a/drivers/firmware/imx/ele_common.h b/drivers/firmware/imx/ele_common.h index 3d8b6f83fb9d..9bded800c103 100644 --- a/drivers/firmware/imx/ele_common.h +++ b/drivers/firmware/imx/ele_common.h @@ -14,12 +14,12 @@ #define IMX_ELE_FW_DIR "imx/ele/" uint32_t se_add_msg_crc(uint32_t *msg, uint32_t msg_len); -int ele_msg_rcv(struct se_if_priv *priv, +int ele_msg_rcv(struct se_if_device_ctx *dev_ctx, struct se_clbk_handle *se_clbk_hdl); -int ele_msg_send(struct se_if_priv *priv, +int ele_msg_send(struct se_if_device_ctx *dev_ctx, void *tx_msg, int tx_msg_sz); -int ele_msg_send_rcv(struct se_if_priv *priv, +int ele_msg_send_rcv(struct se_if_device_ctx *dev_ctx, void *tx_msg, int tx_msg_sz, void *rx_msg, diff --git a/drivers/firmware/imx/se_ctrl.c b/drivers/firmware/imx/se_ctrl.c index 7260a9f93e06..ae90538af390 100644 --- a/drivers/firmware/imx/se_ctrl.c +++ b/drivers/firmware/imx/se_ctrl.c @@ -23,6 +23,7 @@ #include #include #include +#include #include "ele_base_msg.h" #include "ele_common.h" @@ -31,8 +32,6 @@ #define MAX_SOC_INFO_DATA_SZ 256 #define MBOX_TX_NAME "tx" #define MBOX_RX_NAME "rx" -#define SE_TYPE_STR_HSM "hsm" -#define SE_TYPE_ID_HSM 0x2 struct se_fw_img_name { const u8 *prim_fw_nm_in_rfs; @@ -140,6 +139,25 @@ static const struct of_device_id se_match[] = { {}, }; +char *get_se_if_name(u8 se_if_id) +{ + switch (se_if_id) { + case SE_TYPE_ID_DBG: return SE_TYPE_STR_DBG; + case SE_TYPE_ID_HSM: return SE_TYPE_STR_HSM; + } + + return NULL; +} + +static uint32_t get_se_soc_id(struct se_if_priv *priv) +{ + const struct se_if_node_info_list *info_list + = device_get_match_data(priv->dev); + + return info_list->soc_id; + +} + static int se_soc_info(struct se_if_priv *priv) { const struct se_if_node_info_list *info_list @@ -300,6 +318,756 @@ static int se_load_firmware(struct se_if_priv *priv) return ret; } +static int init_se_shared_mem(struct se_if_device_ctx *dev_ctx) +{ + struct se_shared_mem_mgmt_info *se_shared_mem_mgmt = &dev_ctx->se_shared_mem_mgmt; + struct se_if_priv *priv = dev_ctx->priv; + + INIT_LIST_HEAD(&se_shared_mem_mgmt->pending_out); + INIT_LIST_HEAD(&se_shared_mem_mgmt->pending_in); + + /* + * Allocate some memory for data exchanges with S40x. + * This will be used for data not requiring secure memory. + */ + se_shared_mem_mgmt->non_secure_mem.ptr + = dma_alloc_coherent(priv->dev, + MAX_DATA_SIZE_PER_USER, + &se_shared_mem_mgmt->non_secure_mem.dma_addr, + GFP_KERNEL); + if (!se_shared_mem_mgmt->non_secure_mem.ptr) + return -ENOMEM; + + se_shared_mem_mgmt->non_secure_mem.size = MAX_DATA_SIZE_PER_USER; + se_shared_mem_mgmt->non_secure_mem.pos = 0; + + return 0; +} + +static void cleanup_se_shared_mem(struct se_if_device_ctx *dev_ctx) +{ + struct se_shared_mem_mgmt_info *se_shared_mem_mgmt = &dev_ctx->se_shared_mem_mgmt; + struct se_if_priv *priv = dev_ctx->priv; + + /* Unmap secure memory shared buffer. */ + if (se_shared_mem_mgmt->secure_mem.ptr) + devm_iounmap(priv->dev, + (void __iomem *)se_shared_mem_mgmt->secure_mem.ptr); + + se_shared_mem_mgmt->secure_mem.ptr = NULL; + se_shared_mem_mgmt->secure_mem.dma_addr = 0; + se_shared_mem_mgmt->secure_mem.size = 0; + se_shared_mem_mgmt->secure_mem.pos = 0; + + /* Free non-secure shared buffer. */ + dma_free_coherent(priv->dev, MAX_DATA_SIZE_PER_USER, + se_shared_mem_mgmt->non_secure_mem.ptr, + se_shared_mem_mgmt->non_secure_mem.dma_addr); + + se_shared_mem_mgmt->non_secure_mem.ptr = NULL; + se_shared_mem_mgmt->non_secure_mem.dma_addr = 0; + se_shared_mem_mgmt->non_secure_mem.size = 0; + se_shared_mem_mgmt->non_secure_mem.pos = 0; +} + +/* Need to copy the output data to user-device context. + */ +static int se_dev_ctx_cpy_out_data(struct se_if_device_ctx *dev_ctx) +{ + struct se_shared_mem_mgmt_info *se_shared_mem_mgmt = &dev_ctx->se_shared_mem_mgmt; + struct se_if_priv *priv = dev_ctx->priv; + struct se_buf_desc *b_desc, *temp; + bool do_cpy = true; + + list_for_each_entry_safe(b_desc, temp, &se_shared_mem_mgmt->pending_out, link) { + if (b_desc->usr_buf_ptr && b_desc->shared_buf_ptr && do_cpy) { + + dev_dbg(priv->dev, + "Copying output data to user."); + if (do_cpy && copy_to_user(b_desc->usr_buf_ptr, + b_desc->shared_buf_ptr, + b_desc->size)) { + dev_err(priv->dev, + "Failure copying output data to user."); + do_cpy = false; + } + } + + if (b_desc->shared_buf_ptr) + memset(b_desc->shared_buf_ptr, 0, b_desc->size); + + list_del(&b_desc->link); + kfree(b_desc); + } + + return do_cpy ? 0 : -EFAULT; +} + +/* + * Clean the used Shared Memory space, + * whether its Input Data copied from user buffers, or + * Data received from FW. + */ +static void se_dev_ctx_shared_mem_cleanup(struct se_if_device_ctx *dev_ctx) +{ + struct se_shared_mem_mgmt_info *se_shared_mem_mgmt = &dev_ctx->se_shared_mem_mgmt; + struct list_head *pending_lists[] = {&se_shared_mem_mgmt->pending_in, + &se_shared_mem_mgmt->pending_out}; + struct se_buf_desc *b_desc, *temp; + int i; + + for (i = 0; i < 2; i++) { + list_for_each_entry_safe(b_desc, temp, + pending_lists[i], link) { + + if (b_desc->shared_buf_ptr) + memset(b_desc->shared_buf_ptr, 0, b_desc->size); + + list_del(&b_desc->link); + kfree(b_desc); + } + } + se_shared_mem_mgmt->secure_mem.pos = 0; + se_shared_mem_mgmt->non_secure_mem.pos = 0; +} + +static int add_b_desc_to_pending_list(void *shared_ptr_with_pos, + struct se_ioctl_setup_iobuf *io, + struct se_if_device_ctx *dev_ctx) +{ + struct se_shared_mem_mgmt_info *se_shared_mem_mgmt = &dev_ctx->se_shared_mem_mgmt; + struct se_buf_desc *b_desc = NULL; + + b_desc = kzalloc(sizeof(*b_desc), GFP_KERNEL); + if (!b_desc) + return -ENOMEM; + + b_desc->shared_buf_ptr = shared_ptr_with_pos; + b_desc->usr_buf_ptr = io->user_buf; + b_desc->size = io->length; + + if (io->flags & SE_IO_BUF_FLAGS_IS_INPUT) { + /* + * buffer is input: + * add an entry in the "pending input buffers" list so + * that copied data can be cleaned from shared memory + * later. + */ + list_add_tail(&b_desc->link, &se_shared_mem_mgmt->pending_in); + } else { + /* + * buffer is output: + * add an entry in the "pending out buffers" list so data + * can be copied to user space when receiving Secure-Enclave + * response. + */ + list_add_tail(&b_desc->link, &se_shared_mem_mgmt->pending_out); + } + + return 0; +} + +/* interface for managed res to unregister a character device */ +static void if_misc_deregister(void *miscdevice) +{ + misc_deregister(miscdevice); +} + +static int init_device_context(struct se_if_priv *priv, int ch_id, + struct se_if_device_ctx **new_dev_ctx, + const struct file_operations *se_if_fops) +{ + struct se_if_device_ctx *dev_ctx; + int ret = 0; + + if (ch_id) + dev_ctx = kzalloc(sizeof(*dev_ctx), GFP_KERNEL); + else + dev_ctx = devm_kzalloc(priv->dev, sizeof(*dev_ctx), GFP_KERNEL); + + if (!dev_ctx) { + ret = -ENOMEM; + return ret; + } + + dev_ctx->priv = priv; + + if (ch_id) + dev_ctx->devname = kasprintf(GFP_KERNEL, "%s%d_ch%d", + get_se_if_name(priv->if_defs->se_if_type), + priv->if_defs->se_instance_id, + ch_id); + else + dev_ctx->devname = devm_kasprintf(priv->dev, GFP_KERNEL, "%s%d_ch%d", + get_se_if_name(priv->if_defs->se_if_type), + priv->if_defs->se_instance_id, + ch_id); + if (!dev_ctx->devname) { + ret = -ENOMEM; + if (ch_id) + kfree(dev_ctx); + + return ret; + } + + mutex_init(&dev_ctx->fops_lock); + + *new_dev_ctx = dev_ctx; + + if (ch_id) { + list_add_tail(&dev_ctx->link, &priv->dev_ctx_list); + priv->active_devctx_count++; + + ret = init_se_shared_mem(dev_ctx); + if (ret < 0) { + kfree(dev_ctx->devname); + kfree(dev_ctx); + *new_dev_ctx = NULL; + return ret; + } + + return ret; + } + + /* Only for ch_id = 0: + * - register the misc device. + * - add action + */ + dev_ctx->miscdev = devm_kzalloc(priv->dev, sizeof(*dev_ctx->miscdev), GFP_KERNEL); + if (!dev_ctx->miscdev) { + ret = -ENOMEM; + *new_dev_ctx = NULL; + return ret; + } + + dev_ctx->miscdev->name = dev_ctx->devname; + dev_ctx->miscdev->minor = MISC_DYNAMIC_MINOR; + dev_ctx->miscdev->fops = se_if_fops; + dev_ctx->miscdev->parent = priv->dev; + ret = misc_register(dev_ctx->miscdev); + if (ret) { + dev_err(priv->dev, "failed to register misc device %d\n", + ret); + return ret; + } + + ret = devm_add_action(priv->dev, if_misc_deregister, + dev_ctx->miscdev); + if (ret) { + dev_err(priv->dev, + "failed[%d] to add action to the misc-dev\n", + ret); + misc_deregister(dev_ctx->miscdev); + } + + return ret; +} + +static int se_ioctl_cmd_snd_rcv_rsp_handler(struct se_if_device_ctx *dev_ctx, + u64 arg) +{ + struct se_ioctl_cmd_snd_rcv_rsp_info cmd_snd_rcv_rsp_info; + struct se_if_priv *priv = dev_ctx->priv; + struct se_api_msg *tx_msg __free(kfree) = NULL; + struct se_api_msg *rx_msg __free(kfree) = NULL; + int err = 0; + + if (copy_from_user(&cmd_snd_rcv_rsp_info, (u8 __user *)arg, + sizeof(cmd_snd_rcv_rsp_info))) { + dev_err(priv->dev, + "%s: Failed to copy cmd_snd_rcv_rsp_info from user\n", + dev_ctx->devname); + err = -EFAULT; + goto exit; + } + + if (cmd_snd_rcv_rsp_info.tx_buf_sz < SE_MU_HDR_SZ) { + dev_err(priv->dev, + "%s: User buffer too small(%d < %d)\n", + dev_ctx->devname, + cmd_snd_rcv_rsp_info.tx_buf_sz, + SE_MU_HDR_SZ); + err = -ENOSPC; + goto exit; + } + + rx_msg = kzalloc(cmd_snd_rcv_rsp_info.rx_buf_sz, GFP_KERNEL); + if (!rx_msg) { + err = -ENOMEM; + goto exit; + } + + tx_msg = memdup_user(cmd_snd_rcv_rsp_info.tx_buf, + cmd_snd_rcv_rsp_info.tx_buf_sz); + if (IS_ERR(tx_msg)) { + err = PTR_ERR(tx_msg); + goto exit; + } + + if (tx_msg->header.tag != priv->if_defs->cmd_tag) { + err = -EINVAL; + goto exit; + } + + if (tx_msg->header.ver == priv->if_defs->fw_api_ver && + !get_load_fw_instance(priv)->is_fw_loaded) { + err = se_load_firmware(priv); + if (err) { + dev_err(priv->dev, "Could not send the message as FW is not loaded."); + err = -EPERM; + goto exit; + } + } + err = ele_msg_send_rcv(dev_ctx, + tx_msg, + cmd_snd_rcv_rsp_info.tx_buf_sz, + rx_msg, + cmd_snd_rcv_rsp_info.rx_buf_sz); + if (err < 0) + goto exit; + + dev_dbg(priv->dev, + "%s: %s %s\n", + dev_ctx->devname, + __func__, + "message received, start transmit to user"); + + /* We may need to copy the output data to user before + * delivering the completion message. + */ + err = se_dev_ctx_cpy_out_data(dev_ctx); + if (err < 0) + goto exit; + + /* Copy data from the buffer */ + print_hex_dump_debug("to user ", DUMP_PREFIX_OFFSET, 4, 4, + rx_msg, + cmd_snd_rcv_rsp_info.rx_buf_sz, false); + + if (copy_to_user(cmd_snd_rcv_rsp_info.rx_buf, rx_msg, + cmd_snd_rcv_rsp_info.rx_buf_sz)) { + dev_err(priv->dev, + "%s: Failed to copy to user\n", + dev_ctx->devname); + err = -EFAULT; + } + +exit: + se_dev_ctx_shared_mem_cleanup(dev_ctx); + + if (copy_to_user((void __user *)arg, &cmd_snd_rcv_rsp_info, + sizeof(cmd_snd_rcv_rsp_info))) { + dev_err(priv->dev, + "%s: Failed to copy cmd_snd_rcv_rsp_info from user\n", + dev_ctx->devname); + err = -EFAULT; + } + + return err; +} + +static int se_ioctl_get_mu_info(struct se_if_device_ctx *dev_ctx, + u64 arg) +{ + struct se_if_priv *priv = dev_ctx->priv; + struct se_if_node_info *info; + struct se_ioctl_get_if_info if_info; + int err = 0; + + info = container_of(priv->if_defs, typeof(*info), if_defs); + + if_info.se_if_id = 0; + if_info.interrupt_idx = 0; + if_info.tz = 0; + if_info.did = info->se_if_did; + if_info.cmd_tag = priv->if_defs->cmd_tag; + if_info.rsp_tag = priv->if_defs->rsp_tag; + if_info.success_tag = priv->if_defs->success_tag; + if_info.base_api_ver = priv->if_defs->base_api_ver; + if_info.fw_api_ver = priv->if_defs->fw_api_ver; + + dev_dbg(priv->dev, + "%s: info [se_if_id: %d, irq_idx: %d, tz: 0x%x, did: 0x%x]\n", + dev_ctx->devname, + if_info.se_if_id, if_info.interrupt_idx, + if_info.tz, if_info.did); + + if (copy_to_user((u8 __user *)arg, &if_info, sizeof(if_info))) { + dev_err(priv->dev, + "%s: Failed to copy mu info to user\n", + dev_ctx->devname); + err = -EFAULT; + goto exit; + } + +exit: + return err; +} + +/* + * Copy a buffer of data to/from the user and return the address to use in + * messages + */ +static int se_ioctl_setup_iobuf_handler(struct se_if_device_ctx *dev_ctx, + u64 arg) +{ + struct se_shared_mem *shared_mem = NULL; + struct se_ioctl_setup_iobuf io = {0}; + int err = 0; + u32 pos; + + if (copy_from_user(&io, (u8 __user *)arg, sizeof(io))) { + dev_err(dev_ctx->priv->dev, + "%s: Failed copy iobuf config from user\n", + dev_ctx->devname); + err = -EFAULT; + goto exit; + } + + dev_dbg(dev_ctx->priv->dev, + "%s: io [buf: %p(%d) flag: %x]\n", + dev_ctx->devname, + io.user_buf, io.length, io.flags); + + if (io.length == 0 || !io.user_buf) { + /* + * Accept NULL pointers since some buffers are optional + * in FW commands. In this case we should return 0 as + * pointer to be embedded into the message. + * Skip all data copy part of code below. + */ + io.ele_addr = 0; + goto copy; + } + + /* No specific requirement for this buffer. */ + shared_mem = &dev_ctx->se_shared_mem_mgmt.non_secure_mem; + + /* Check there is enough space in the shared memory. */ + dev_dbg(dev_ctx->priv->dev, + "%s: req_size = %d, max_size= %d, curr_pos = %d", + dev_ctx->devname, + round_up(io.length, 8u), + shared_mem->size, shared_mem->pos); + + if (shared_mem->size < shared_mem->pos || + round_up(io.length, 8u) > (shared_mem->size - shared_mem->pos)) { + dev_err(dev_ctx->priv->dev, + "%s: Not enough space in shared memory\n", + dev_ctx->devname); + err = -ENOMEM; + goto exit; + } + + /* Allocate space in shared memory. 8 bytes aligned. */ + pos = shared_mem->pos; + shared_mem->pos += round_up(io.length, 8u); + io.ele_addr = (u64)shared_mem->dma_addr + pos; + + memset(shared_mem->ptr + pos, 0, io.length); + if ((io.flags & SE_IO_BUF_FLAGS_IS_INPUT) || + (io.flags & SE_IO_BUF_FLAGS_IS_IN_OUT)) { + /* + * buffer is input: + * copy data from user space to this allocated buffer. + */ + if (copy_from_user(shared_mem->ptr + pos, io.user_buf, + io.length)) { + dev_err(dev_ctx->priv->dev, + "%s: Failed copy data to shared memory\n", + dev_ctx->devname); + err = -EFAULT; + goto exit; + } + } + + err = add_b_desc_to_pending_list(shared_mem->ptr + pos, + &io, + dev_ctx); + if (err < 0) + dev_err(dev_ctx->priv->dev, + "%s: Failed to allocate/link b_desc.", + dev_ctx->devname); + +copy: + /* Provide the EdgeLock Enclave address to user space only if success.*/ + if (copy_to_user((u8 __user *)arg, &io, sizeof(io))) { + dev_err(dev_ctx->priv->dev, + "%s: Failed to copy iobuff setup to user.", + dev_ctx->devname); + err = -EFAULT; + goto exit; + } +exit: + return err; +} + +/* IOCTL to provide SoC information */ +static int se_ioctl_get_se_soc_info_handler(struct se_if_device_ctx *dev_ctx, + u64 arg) +{ + struct se_ioctl_get_soc_info soc_info; + int err = -EINVAL; + + soc_info.soc_id = get_se_soc_id(dev_ctx->priv); + soc_info.soc_rev = var_se_info.soc_rev; + + err = (int)copy_to_user((u8 __user *)arg, (u8 *)(&soc_info), sizeof(soc_info)); + if (err) { + dev_err(dev_ctx->priv->dev, + "%s: Failed to copy soc info to user\n", + dev_ctx->devname); + err = -EFAULT; + goto exit; + } + +exit: + return err; +} + +/* + * File operations for user-space + */ + +/* Write a message to the MU. */ +static ssize_t se_if_fops_write(struct file *fp, const char __user *buf, + size_t size, loff_t *ppos) +{ + struct se_if_device_ctx *dev_ctx = fp->private_data; + struct se_api_msg *tx_msg __free(kfree) = NULL; + struct se_if_priv *priv = dev_ctx->priv; + int err; + + dev_dbg(priv->dev, + "%s: write from buf (%p)%zu, ppos=%lld\n", + dev_ctx->devname, + buf, size, ((ppos) ? *ppos : 0)); + + if (mutex_lock_interruptible(&dev_ctx->fops_lock)) + return -EBUSY; + + if (dev_ctx != priv->cmd_receiver_clbk_hdl.dev_ctx) { + err = -EINVAL; + goto exit; + } + + if (size < SE_MU_HDR_SZ) { + dev_err(priv->dev, + "%s: User buffer too small(%zu < %d)\n", + dev_ctx->devname, + size, SE_MU_HDR_SZ); + err = -ENOSPC; + goto exit; + } + + tx_msg = memdup_user(buf, size); + if (IS_ERR(tx_msg)) { + err = PTR_ERR(tx_msg); + goto exit; + } + + print_hex_dump_debug("from user ", DUMP_PREFIX_OFFSET, 4, 4, + tx_msg, size, false); + + err = ele_msg_send(dev_ctx, tx_msg, size); + if (err < 0) + goto exit; +exit: + mutex_unlock(&dev_ctx->fops_lock); + return err; +} + +/* + * Read a message from the MU. + * Blocking until a message is available. + */ +static ssize_t se_if_fops_read(struct file *fp, char __user *buf, + size_t size, loff_t *ppos) +{ + struct se_if_device_ctx *dev_ctx = fp->private_data; + struct se_if_priv *priv = dev_ctx->priv; + int err; + + dev_dbg(priv->dev, + "%s: read to buf %p(%zu), ppos=%lld\n", + dev_ctx->devname, + buf, size, ((ppos) ? *ppos : 0)); + + if (mutex_lock_interruptible(&dev_ctx->fops_lock)) + return -EBUSY; + + if (dev_ctx != priv->cmd_receiver_clbk_hdl.dev_ctx) { + err = -EINVAL; + goto exit; + } + + err = ele_msg_rcv(dev_ctx, &priv->cmd_receiver_clbk_hdl); + if (err < 0) { + dev_err(priv->dev, + "%s: Err[0x%x]:Interrupted by signal.\n", + dev_ctx->devname, err); + dev_dbg(priv->dev, + "Current active dev-ctx count = %d.\n", + dev_ctx->priv->active_devctx_count); + goto exit; + } + + /* We may need to copy the output data to user before + * delivering the completion message. + */ + err = se_dev_ctx_cpy_out_data(dev_ctx); + if (err < 0) + goto exit; + + /* Copy data from the buffer */ + print_hex_dump_debug("to user ", DUMP_PREFIX_OFFSET, 4, 4, + priv->cmd_receiver_clbk_hdl.rx_msg, + priv->cmd_receiver_clbk_hdl.rx_msg_sz, + false); + + if (copy_to_user(buf, priv->cmd_receiver_clbk_hdl.rx_msg, + priv->cmd_receiver_clbk_hdl.rx_msg_sz)) { + dev_err(priv->dev, + "%s: Failed to copy to user\n", + dev_ctx->devname); + err = -EFAULT; + } + err = priv->cmd_receiver_clbk_hdl.rx_msg_sz; +exit: + priv->cmd_receiver_clbk_hdl.rx_msg_sz = 0; + + se_dev_ctx_shared_mem_cleanup(dev_ctx); + + mutex_unlock(&dev_ctx->fops_lock); + return err; +} + +/* Open a character device. */ +static int se_if_fops_open(struct inode *nd, struct file *fp) +{ + struct miscdevice *miscdev = fp->private_data; + struct se_if_priv *priv = dev_get_drvdata(miscdev->parent); + struct se_if_device_ctx *misc_dev_ctx = priv->priv_dev_ctx; + struct se_if_device_ctx *dev_ctx; + int err = 0; + + if (mutex_lock_interruptible(&misc_dev_ctx->fops_lock)) + return -EBUSY; + + priv->dev_ctx_mono_count++; + err = init_device_context(priv, + priv->dev_ctx_mono_count ? + priv->dev_ctx_mono_count + : priv->dev_ctx_mono_count++, + &dev_ctx, NULL); + if (err) { + dev_err(priv->dev, + "Failed[0x%x] to create device contexts.\n", + err); + goto exit; + } + + fp->private_data = dev_ctx; + +exit: + mutex_unlock(&misc_dev_ctx->fops_lock); + return err; +} + +/* Close a character device. */ +static int se_if_fops_close(struct inode *nd, struct file *fp) +{ + struct se_if_device_ctx *dev_ctx = fp->private_data; + struct se_if_priv *priv = dev_ctx->priv; + + if (mutex_lock_interruptible(&dev_ctx->fops_lock)) + return -EBUSY; + + /* check if this device was registered as command receiver. */ + if (priv->cmd_receiver_clbk_hdl.dev_ctx == dev_ctx) { + priv->cmd_receiver_clbk_hdl.dev_ctx = NULL; + kfree(priv->cmd_receiver_clbk_hdl.rx_msg); + priv->cmd_receiver_clbk_hdl.rx_msg = NULL; + } + + se_dev_ctx_shared_mem_cleanup(dev_ctx); + cleanup_se_shared_mem(dev_ctx); + + priv->active_devctx_count--; + list_del(&dev_ctx->link); + + mutex_unlock(&dev_ctx->fops_lock); + kfree(dev_ctx->devname); + kfree(dev_ctx); + + return 0; +} + +/* IOCTL entry point of a character device */ +static long se_ioctl(struct file *fp, unsigned int cmd, unsigned long arg) +{ + struct se_if_device_ctx *dev_ctx = fp->private_data; + struct se_if_priv *priv = dev_ctx->priv; + int err; + + /* Prevent race during change of device context */ + if (mutex_lock_interruptible(&dev_ctx->fops_lock)) + return -EBUSY; + + switch (cmd) { + case SE_IOCTL_ENABLE_CMD_RCV: + if (!priv->cmd_receiver_clbk_hdl.dev_ctx) { + if (!priv->cmd_receiver_clbk_hdl.rx_msg) { + priv->cmd_receiver_clbk_hdl.rx_msg + = kzalloc(MAX_NVM_MSG_LEN, + GFP_KERNEL); + if (!priv->cmd_receiver_clbk_hdl.rx_msg) { + err = -ENOMEM; + break; + } + } + priv->cmd_receiver_clbk_hdl.rx_msg_sz = MAX_NVM_MSG_LEN; + priv->cmd_receiver_clbk_hdl.dev_ctx = dev_ctx; + err = 0; + } else { + err = -EBUSY; + } + break; + case SE_IOCTL_GET_MU_INFO: + err = se_ioctl_get_mu_info(dev_ctx, arg); + break; + case SE_IOCTL_SETUP_IOBUF: + err = se_ioctl_setup_iobuf_handler(dev_ctx, arg); + break; + case SE_IOCTL_GET_SOC_INFO: + err = se_ioctl_get_se_soc_info_handler(dev_ctx, arg); + break; + case SE_IOCTL_CMD_SEND_RCV_RSP: + err = se_ioctl_cmd_snd_rcv_rsp_handler(dev_ctx, arg); + break; + default: + err = -EINVAL; + dev_dbg(priv->dev, + "%s: IOCTL %.8x not supported\n", + dev_ctx->devname, + cmd); + } + + mutex_unlock(&dev_ctx->fops_lock); + + return (long)err; +} + +/* Char driver setup */ +static const struct file_operations se_if_fops = { + .open = se_if_fops_open, + .owner = THIS_MODULE, + .release = se_if_fops_close, + .unlocked_ioctl = se_ioctl, + .read = se_if_fops_read, + .write = se_if_fops_write, +}; + /* interface for managed res to free a mailbox channel */ static void if_mbox_free_channel(void *mbox_chan) { @@ -335,6 +1103,7 @@ static int se_if_request_channel(struct device *dev, static void se_if_probe_cleanup(void *plat_dev) { + struct se_if_device_ctx *dev_ctx, *t_dev_ctx; struct platform_device *pdev = plat_dev; struct device *dev = &pdev->dev; struct se_fw_load_info *load_fw; @@ -359,6 +1128,13 @@ static void se_if_probe_cleanup(void *plat_dev) load_fw->imem.buf = NULL; } + if (priv->dev_ctx_mono_count) { + list_for_each_entry_safe(dev_ctx, t_dev_ctx, &priv->dev_ctx_list, link) { + list_del(&dev_ctx->link); + priv->active_devctx_count--; + } + } + /* No need to check, if reserved memory is allocated * before calling for its release. Or clearing the * un-set bit. @@ -442,6 +1218,7 @@ static int se_if_probe(struct platform_device *pdev) goto exit; } } + INIT_LIST_HEAD(&priv->dev_ctx_list); if (info->reserved_dma_ranges) { ret = of_reserved_mem_device_init(dev); @@ -453,6 +1230,14 @@ static int se_if_probe(struct platform_device *pdev) } } + ret = init_device_context(priv, 0, &priv->priv_dev_ctx, &se_if_fops); + if (ret) { + dev_err(dev, + "Failed[0x%x] to create device contexts.\n", + ret); + goto exit; + } + if (info->if_defs.se_if_type == SE_TYPE_ID_HSM) { ret = se_soc_info(priv); if (ret) { @@ -471,7 +1256,7 @@ static int se_if_probe(struct platform_device *pdev) load_fw->is_fw_loaded = false; } dev_info(dev, "i.MX secure-enclave: %s%d interface to firmware, configured.\n", - SE_TYPE_STR_HSM, + get_se_if_name(priv->if_defs->se_if_type), priv->if_defs->se_instance_id); return ret; diff --git a/drivers/firmware/imx/se_ctrl.h b/drivers/firmware/imx/se_ctrl.h index 12c201b503b1..91a2f084b1f4 100644 --- a/drivers/firmware/imx/se_ctrl.h +++ b/drivers/firmware/imx/se_ctrl.h @@ -13,6 +13,7 @@ #define MAX_FW_LOAD_RETRIES 50 #define RES_STATUS(x) FIELD_GET(0x000000ff, x) +#define MAX_DATA_SIZE_PER_USER (65 * 1024) #define MAX_NVM_MSG_LEN (256) #define MESSAGING_VERSION_6 0x6 #define MESSAGING_VERSION_7 0x7 @@ -31,6 +32,7 @@ struct se_clbk_handle { struct completion done; bool signal_rcvd; + struct se_if_device_ctx *dev_ctx; u32 rx_msg_sz; /* Assignment of the rx_msg buffer to held till the * received content as part callback function, is copied. @@ -45,6 +47,40 @@ struct se_imem_buf { u32 state; }; +struct se_buf_desc { + u8 *shared_buf_ptr; + void __user *usr_buf_ptr; + u32 size; + struct list_head link; +}; + +struct se_shared_mem { + dma_addr_t dma_addr; + u32 size; + u32 pos; + u8 *ptr; +}; + +struct se_shared_mem_mgmt_info { + struct list_head pending_in; + struct list_head pending_out; + + struct se_shared_mem secure_mem; + struct se_shared_mem non_secure_mem; +}; + +/* Private struct for each char device instance. */ +struct se_if_device_ctx { + struct se_if_priv *priv; + struct miscdevice *miscdev; + const char *devname; + + struct mutex fops_lock; + + struct se_shared_mem_mgmt_info se_shared_mem_mgmt; + struct list_head link; +}; + /* Header of the messages exchange with the EdgeLock Enclave */ struct se_msg_hdr { u8 ver; @@ -89,6 +125,12 @@ struct se_if_priv { struct gen_pool *mem_pool; const struct se_if_defines *if_defs; + + struct se_if_device_ctx *priv_dev_ctx; + struct list_head dev_ctx_list; + u32 active_devctx_count; + u32 dev_ctx_mono_count; }; +char *get_se_if_name(u8 se_if_id); #endif diff --git a/include/uapi/linux/se_ioctl.h b/include/uapi/linux/se_ioctl.h new file mode 100644 index 000000000000..5cf3d56734f4 --- /dev/null +++ b/include/uapi/linux/se_ioctl.h @@ -0,0 +1,101 @@ +/* SPDX-License-Identifier: (GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause*/ +/* + * Copyright 2024 NXP + */ + +#ifndef SE_IOCTL_H +#define SE_IOCTL_H + +#include + +#define SE_TYPE_STR_DBG "dbg" +#define SE_TYPE_STR_HSM "hsm" +#define SE_TYPE_ID_UNKWN 0x0 +#define SE_TYPE_ID_DBG 0x1 +#define SE_TYPE_ID_HSM 0x2 +/* IOCTL definitions. */ + +struct se_ioctl_setup_iobuf { + void __user *user_buf; + __u32 length; + __u32 flags; + __u64 ele_addr; +}; + +struct se_ioctl_shared_mem_cfg { + __u32 base_offset; + __u32 size; +}; + +struct se_ioctl_get_if_info { + __u8 se_if_id; + __u8 interrupt_idx; + __u8 tz; + __u8 did; + __u8 cmd_tag; + __u8 rsp_tag; + __u8 success_tag; + __u8 base_api_ver; + __u8 fw_api_ver; +}; + +struct se_ioctl_cmd_snd_rcv_rsp_info { + __u32 __user *tx_buf; + int tx_buf_sz; + __u32 __user *rx_buf; + int rx_buf_sz; +}; + +struct se_ioctl_get_soc_info { + __u16 soc_id; + __u16 soc_rev; +}; + +/* IO Buffer Flags */ +#define SE_IO_BUF_FLAGS_IS_OUTPUT (0x00u) +#define SE_IO_BUF_FLAGS_IS_INPUT (0x01u) +#define SE_IO_BUF_FLAGS_USE_SEC_MEM (0x02u) +#define SE_IO_BUF_FLAGS_USE_SHORT_ADDR (0x04u) +#define SE_IO_BUF_FLAGS_IS_IN_OUT (0x10u) + +/* IOCTLS */ +#define SE_IOCTL 0x0A /* like MISC_MAJOR. */ + +/* + * ioctl to designated the current fd as logical-reciever. + * This is ioctl is send when the nvm-daemon, a slave to the + * firmware is started by the user. + */ +#define SE_IOCTL_ENABLE_CMD_RCV _IO(SE_IOCTL, 0x01) + +/* + * ioctl to get the buffer allocated from the memory, which is shared + * between kernel and FW. + * Post allocation, the kernel tagged the allocated memory with: + * Output + * Input + * Input-Output + * Short address + * Secure-memory + */ +#define SE_IOCTL_SETUP_IOBUF _IOWR(SE_IOCTL, 0x03, \ + struct se_ioctl_setup_iobuf) + +/* + * ioctl to get the mu information, that is used to exchange message + * with FW, from user-spaced. + */ +#define SE_IOCTL_GET_MU_INFO _IOR(SE_IOCTL, 0x04, \ + struct se_ioctl_get_if_info) +/* + * ioctl to get SoC Info from user-space. + */ +#define SE_IOCTL_GET_SOC_INFO _IOR(SE_IOCTL, 0x06, \ + struct se_ioctl_get_soc_info) + +/* + * ioctl to send command and receive response from user-space. + */ +#define SE_IOCTL_CMD_SEND_RCV_RSP _IOWR(SE_IOCTL, 0x07, \ + struct se_ioctl_cmd_snd_rcv_rsp_info) +#endif