Received-SPF: pass (google.com: domain of linux-kernel+bounces-175823-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) client-ip=2604:1380:45d1:ec00::1;
From: Pankaj Gupta <pankaj.gupta@nxp.com>
Subject: [PATCH 0/4] Communication Interface to NXP secure-enclave HW IP
 like Edgelock Enclave
Date: Fri, 10 May 2024 18:57:26 +0530
Message-Id: <20240510-imx-se-if-v1-0-27c5a674916d@nxp.com>
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
To: Jonathan Corbet <corbet@lwn.net>, Rob Herring <robh+dt@kernel.org>, 
 Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>, 
 Conor Dooley <conor+dt@kernel.org>, Shawn Guo <shawnguo@kernel.org>, 
 Sascha Hauer <s.hauer@pengutronix.de>, 
 Pengutronix Kernel Team <kernel@pengutronix.de>, 
 Fabio Estevam <festevam@gmail.com>
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, Pankaj Gupta <pankaj.gupta@nxp.com>
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?utf-8?B?V2FlNEdTeVF4L0ZueHNKY3pxRVRBYmtZY0NRcEppNE0xbGJXMXBCOXMvclV1?=
 =?utf-8?B?N1o2SzFnekpOR2NuY2xQUWJSYklEWWRTRGJFOEJkSytjMTRtZFNMWCtiSDdP?=
 =?utf-8?B?ajJRcDJsVVhpSmJvclRsWGxSWG92aTF0U0ZEbzFKY1RxZTBLamJ0UmxqZFBF?=
 =?utf-8?B?dFdpc2dLQzhNV1Vsd2htbjV2TXFTWXNaUk1aZU9MMm9JcmhpY3k1SlZjelNI?=
 =?utf-8?B?ak1BUW14KzRCTU92QmxwODQ5MXA0KzdicVN6ZmRwUGJLTnVPVWRSeUhZSFhG?=
 =?utf-8?B?WU01c0Rwckg5ZVlFbG5hK0d4NDkvK1NaMUxJT29FNndLSzZWMmNweC9DQjNI?=
 =?utf-8?B?dGF1MjVFRXgvMjYyVHFxWUpwMlVmdFZJVjBEL1pucDM3K28vTDB1RURzajFj?=
 =?utf-8?B?d3pWVVdXMm1CSGVvUU1CL0l2Ymo5cVNId0haZnlFdDVBVFY1T0F2KzkxQnBj?=
 =?utf-8?B?RVN4NjRyaGovOVNjZ0czUWpCNkpMQ1dIb3A5NFYrb2hBT3NQQzVpaHlZZ3RC?=
 =?utf-8?B?clJJQ1U2b1RvQlNuQmoyb3lkTU9GZXdVQ3RMUGliUHhIYlkrdHhDelY4T0Vq?=
 =?utf-8?B?aXZrbkJhVUE5UUNIQm4rK2RNL3FHQnU2SFNJckxrWmVDdktMMVNuOXFRSEhO?=
 =?utf-8?B?M1J0ZHFvS2pIeUFwVUNwTFkwRkpRZzZ4Nm5BSDZEbThDSWNERHFFOCs0bjU3?=
 =?utf-8?B?dWJHam90QkFETUVjU2trM241cUM2QnRzbXFjSzBrcHVVWnBORC91dkxweW5H?=
 =?utf-8?B?TWRwMTRGeVdmb1dyamZLVDQ2L2NEZXJuN0U5ZGtvQlJCUkw4T2xtUlpkakI4?=
 =?utf-8?B?aXBuR0ZRdVFHc0VvUHM1WW5qZFk1dkkxZGRFajllbDdRc3Y0SEgyWFhxSXlq?=
 =?utf-8?B?REQyY0JUdU8zT2F0SEdsMWZPNXBBdThBc3NGYjF1UEpXSGRwOHJRRjFyb0xX?=
 =?utf-8?B?dHJqZWJJUFMxVmR4Slo2V0twYmJGUTAzSkdKekoxZmlFeFdjNE8yQkdpUHAr?=
 =?utf-8?B?ci8yanZYSXpzRzBlc0IrRU4xcE9OZG5Pb3NzTi9UR0NESkpDS1phZDJLSEh4?=
 =?utf-8?B?eFVIZmRFenZZY1dlL1pVMTVJcmlsUWU5b095ZGlUaGM5dmYydlZMRW1IcU1B?=
 =?utf-8?B?UHAxN0RmTjV1bkZjUm93TElQOWtKbHlLNDZJenFGaXBPNS96VWRTK2REMVJs?=
 =?utf-8?B?dkhuTWtMV1o1MFpZTGNjdkZvVG5NQWdpeHBWYWtuNTd3SU0xZGNvM2EycStP?=
 =?utf-8?B?MExacmJtWDJlU2Z5b1BwdHJkcUtvUUhBb0FmNWg2eE1qblNsVEc3MlFpeFRL?=
 =?utf-8?B?MHVpc1M3a1Z6d1FCUUxlWGFFOVVKNmF6aWxpMzBlU2t4Z2pVNXl6R2tqU1Jk?=
 =?utf-8?B?NC81OWs2bnZONjVpLzVQZmVGVWNOY1Q1endYZnpCM3pVUnlSSHFiTTVaL0w0?=
 =?utf-8?B?UUtTdzJ5SlhFSnZFeCtYeGc5aUowL1RCNHhucUQvUWNvTWFsYTRqdVhpeTBD?=
 =?utf-8?B?TWwvclNlVHMzRlBXM3lrdEw1NlhueGttVjZ3bno4aFhlNitlcW5GMlNjRGUv?=
 =?utf-8?B?bGE1d1RBODBrRCtTb2FEUHZ0WVhlUm84WHc5eWJ2SnErSlU5Y3NHTE51RzhG?=
 =?utf-8?B?R2c0UGhDcnpzRVJEcElwYm84TzYzM3Y2YTA0MDFoNEtEMjZCY2hqaGlBZllT?=
 =?utf-8?B?MFhHakhhYUoyOHBaMGROOStuaXNTMmh4MWN4aEY0ZUFLMC8vOUVHTllQcFcw?=
 =?utf-8?B?dU1EaFFKZEtUTGdORUxHS1gwWVNoeEVTM2NRYTg3SUg5eGFBa21pcE1nMjBB?=
 =?utf-8?B?LzRidGY3R3dMK3ArL09tbExHS1Vua3RsYVhuVnZWR1czY1E1Z0I5VVRyMVZs?=
 =?utf-8?B?V3RhVERMZ0kxRmhuQVlsZ3RSdi9ZU0pVM3h3cUk3M1R4K3l0Nlg0Vk0xOFpk?=
 =?utf-8?B?M2tncW1YcTJHK3I3VWNKSC9ZbktnTm5hNDN5aUZVZW9BRmxkUmhPMTkrd21K?=
 =?utf-8?B?am9lQjQvVzNPTTRHNmhJYVlNeXMxbk5OeFVodG5vdXZhSHV3cENmSWhqeVA2?=
 =?utf-8?B?M3VzckRwcTVRTzdQQmczL0IrTHd6Lys2NnV2WXNqSVNqNnBVRWZaMERkbFZF?=
 =?utf-8?Q?Jh5dJIGA1jAum3UjRZizuJiu8?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 22e4ffe6-5ccb-41ce-fb63-08dc70f548d8
X-MS-Exchange-CrossTenant-AuthSource: AM9PR04MB8604.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 May 2024 13:29:57.2321
 (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: aNhcbg4xuE9KVK5CWEQAZA3oDl7d9e25szDIzlSvaNSNhbZfpsA3sSr2L32HXTuiQ/6AkiliL88urfEHm0eajg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS5PR04MB10041

Hardware interface of the NXP Secure Enclave  HW IP(s) like EdgeLock Enclave,
V2X, SHE etc, is based on the Messaging Unit module that enables processing
elements like ARMv8 core, RISC V core, within the SoC to communicate and
coordinate by passing messages (e.g., data, status and control) through 
these interfaces.

The NXP i.MX secure enclaves hardware interface kernel driver, is specifically
targeted for use between application core and NXP secure-enclave(s) HW. It allows
to send/receive messages to/from the secure-enclave.

Patch-set adds the kernel driver for communication interface to secure-enclave,
for exchanging messages with NXP secure enclave HW IP(s) like EdgeLock Enclave,
both from:
- User-Space Applications via character driver.
- Kernel-space, used by kernel management layers like DM-Crypt.

Signed-off-by: Pankaj Gupta <pankaj.gupta@nxp.com>
---
Pankaj Gupta (4):
      Documentation/firmware: add imx/se to other_interfaces
      dt-bindings: arm: fsl: add imx-se-fw binding doc
      arm64: dts: imx8ulp-evk: add nxp secure enclave firmware
      firmware: imx: add driver for NXP EdgeLock Enclave

 Documentation/ABI/testing/se-cdev                  |   42 +
 .../devicetree/bindings/firmware/fsl,imx-se.yaml   |  186 +++
 .../driver-api/firmware/other_interfaces.rst       |  126 ++
 arch/arm64/boot/dts/freescale/imx8ulp-evk.dts      |   17 +-
 arch/arm64/boot/dts/freescale/imx8ulp.dtsi         |   18 +-
 drivers/firmware/imx/Kconfig                       |   12 +
 drivers/firmware/imx/Makefile                      |    2 +
 drivers/firmware/imx/ele_base_msg.c                |  287 +++++
 drivers/firmware/imx/ele_base_msg.h                |   70 +
 drivers/firmware/imx/ele_common.c                  |  341 +++++
 drivers/firmware/imx/ele_common.h                  |   43 +
 drivers/firmware/imx/se_ctrl.c                     | 1339 ++++++++++++++++++++
 drivers/firmware/imx/se_ctrl.h                     |  151 +++
 include/linux/firmware/imx/se_api.h                |   14 +
 include/uapi/linux/se_ioctl.h                      |   88 ++
 15 files changed, 2733 insertions(+), 3 deletions(-)
---
base-commit: e8f897f4afef0031fe618a8e94127a0934896aba
change-id: 20240507-imx-se-if-a40055093dc6

Best regards,
-- 
Pankaj Gupta <pankaj.gupta@nxp.com>