[PATCH v1 1/2] firmware: stratix10-svc: add FCS random-number command for Agilex 5

From: hang . suan . wang

Date: Fri Nov 20 2026 - 04:52:02 EST


From: Hang Suan Wang <hang.suan.wang@xxxxxxxxxx>

The Agilex 5 Secure Device Manager (SDM 1.5) exposes an FPGA Crypto
Service (FCS) random-number primitive over the existing SIP SMC
mailbox: a session-based interface, alongside SDOS encrypt/decrypt.
The service layer has no command to drive it yet.

Configure stratix10-svc about this interface so an in-kernel FCS client
can use it:

- add the asynchronous client command code
COMMAND_FCS_RANDOM_NUMBER_GEN_EXT

- add the matching SIP SMC function IDs
INTEL_SIP_SMC_FCS_RANDOM_NUMBER_EXT and
INTEL_SIP_SMC_ASYNC_FCS_RANDOM_NUMBER_EXT, with their register-usage
documentation

The transport is unchanged: Agilex 5 reuses the SIP SMC calling
convention and async mailbox ABI the driver already implements, so no
new transport mechanism is required.

COMMAND_FCS_RANDOM_NUMBER_GEN_EXT is dispatched as
INTEL_SIP_SMC_ASYNC_FCS_RANDOM_NUMBER_EXT. The session ID and context
ID are taken from the client message. The destination buffer is the
physical address of the service-layer payload, and the payload length is
the number of random bytes requested (4080 bytes at most). On completion
the value returned in a2 is passed back to the client, as for the other
asynchronous FCS commands.

This is a prerequisite for the SoCFPGA FCS hw_random driver, the in-tree
consumer of this command.

Signed-off-by: Hang Suan Wang <hang.suan.wang@xxxxxxxxxx>
---
drivers/firmware/stratix10-svc.c | 8 ++++
include/linux/firmware/intel/stratix10-smc.h | 46 +++++++++++++++++++
.../firmware/intel/stratix10-svc-client.h | 1 +
3 files changed, 55 insertions(+)

diff --git a/drivers/firmware/stratix10-svc.c b/drivers/firmware/stratix10-svc.c
index 386673bc093f..d6d1cf19d5a5 100644
--- a/drivers/firmware/stratix10-svc.c
+++ b/drivers/firmware/stratix10-svc.c
@@ -1643,6 +1643,13 @@ int stratix10_svc_async_send(struct stratix10_svc_chan *chan, void *msg,
args.a0 = INTEL_SIP_SMC_ASYNC_FCS_CLOSE_CS_SESSION;
args.a2 = p_msg->arg[0];
break;
+ case COMMAND_FCS_RANDOM_NUMBER_GEN_EXT:
+ args.a0 = INTEL_SIP_SMC_ASYNC_FCS_RANDOM_NUMBER_EXT;
+ args.a2 = p_msg->arg[0];
+ args.a3 = p_msg->arg[1];
+ args.a4 = svc_va_to_pa(ctrl, p_msg->payload);
+ args.a5 = p_msg->payload_length;
+ break;
case COMMAND_FCS_SDOS_DATA_EXT:
args.a0 = INTEL_SIP_SMC_ASYNC_FCS_CRYPTION_EXT;
args.a2 = p_msg->arg[0];
@@ -1757,6 +1764,7 @@ static int stratix10_svc_async_prepare_response(struct stratix10_svc_chan *chan,
case COMMAND_RSU_NOTIFY:
break;
case COMMAND_FCS_CRYPTO_OPEN_SESSION:
+ case COMMAND_FCS_RANDOM_NUMBER_GEN_EXT:
case COMMAND_FCS_SDOS_DATA_EXT:
data->kaddr1 = (void *)&handle->res.a2;
break;
diff --git a/include/linux/firmware/intel/stratix10-smc.h b/include/linux/firmware/intel/stratix10-smc.h
index fb01116c1cb9..601f14bc8e29 100644
--- a/include/linux/firmware/intel/stratix10-smc.h
+++ b/include/linux/firmware/intel/stratix10-smc.h
@@ -669,6 +669,52 @@ INTEL_SIP_SMC_FAST_CALL_VAL(INTEL_SIP_SMC_FUNCID_FPGA_CONFIG_COMPLETED_WRITE)
#define INTEL_SIP_SMC_FCS_GET_PROVISION_DATA \
INTEL_SIP_SMC_STD_CALL_VAL(INTEL_SIP_SMC_FUNCID_FCS_GET_PROVISION_DATA)

+/**
+ * Request INTEL_SIP_SMC_FCS_RANDOM_NUMBER_EXT
+ *
+ * Call used to query the random number generated by the firmware.
+ * The maximum random number is 4080 bytes.
+ *
+ * Call register usage:
+ * a0 INTEL_SIP_SMC_FCS_RANDOM_NUMBER_EXT
+ * a1 session ID
+ * a2 context ID
+ * a3 size of the requested random data
+ * a4-a7 not used
+ *
+ * Return status:
+ * a0 INTEL_SIP_SMC_STATUS_OK, INTEL_SIP_SMC_STATUS_NOT_SUPPORTED or
+ * INTEL_SIP_SMC_STATUS_ERROR
+ * a1-a3 not used
+ */
+#define INTEL_SIP_SMC_FUNCID_FCS_RANDOM_NUMBER_EXT 143
+#define INTEL_SIP_SMC_FCS_RANDOM_NUMBER_EXT \
+ INTEL_SIP_SMC_STD_CALL_VAL(INTEL_SIP_SMC_FUNCID_FCS_RANDOM_NUMBER_EXT)
+
+/**
+ * Request INTEL_SIP_SMC_ASYNC_FCS_RANDOM_NUMBER_EXT
+ *
+ * Async call used to query the random number generated by the firmware.
+ * The maximum random number is 4080 bytes.
+ *
+ * Call register usage:
+ * a0 INTEL_SIP_SMC_ASYNC_FCS_RANDOM_NUMBER_EXT
+ * a1 transaction job id
+ * a2 session ID
+ * a3 context ID
+ * a4 buffer pointer for random data
+ * a5 size of the requested random data
+ * a6-a17 not used
+ *
+ * Return status:
+ * a0 INTEL_SIP_SMC_STATUS_OK ,INTEL_SIP_SMC_STATUS_REJECTED
+ * or INTEL_SIP_SMC_STATUS_BUSY
+ * a1-a17 not used
+ */
+#define INTEL_SIP_SMC_ASYNC_FUNC_ID_FCS_RANDOM_NUMBER_EXT (0x12D)
+#define INTEL_SIP_SMC_ASYNC_FCS_RANDOM_NUMBER_EXT \
+ INTEL_SIP_SMC_ASYNC_VAL(INTEL_SIP_SMC_ASYNC_FUNC_ID_FCS_RANDOM_NUMBER_EXT)
+
/**
* Request INTEL_SIP_SMC_ASYNC_FCS_CRYPTION_EXT
* Async call to perform encryption/decryption
diff --git a/include/linux/firmware/intel/stratix10-svc-client.h b/include/linux/firmware/intel/stratix10-svc-client.h
index edd7953d5d08..c924dc9a6ef2 100644
--- a/include/linux/firmware/intel/stratix10-svc-client.h
+++ b/include/linux/firmware/intel/stratix10-svc-client.h
@@ -202,6 +202,7 @@ enum stratix10_svc_command_code {
/* for crypto service */
COMMAND_FCS_CRYPTO_OPEN_SESSION = 50,
COMMAND_FCS_CRYPTO_CLOSE_SESSION,
+ COMMAND_FCS_RANDOM_NUMBER_GEN_EXT = 81,
/* for extended SDOS encrypt/decrypt */
COMMAND_FCS_SDOS_DATA_EXT = 82,
/* for generic mailbox send command */
--
2.43.7