From: hang.suan.wang@altera.com
To: Dinh Nguyen <dinguyen@kernel.org>,
linux-kernel@vger.kernel.org, Olivia Mackall <olivia@selenic.com>,
Herbert Xu <herbert@gondor.apana.org.au>,
Eric Biggers <ebiggers@kernel.org>,
Miquel Raynal <miquel.raynal@bootlin.com>,
Wolfram Sang <wsa+renesas@sang-engineering.com>,
Frank Li <Frank.Li@nxp.com>,
Jean-Michel Hautbois <jeanmichel.hautbois@yoseli.org>,
linux-crypto@vger.kernel.org
Cc: muhammad.nazim.amirul.nazle.asmade@altera.com,
tze.yee.ng@altera.com, chee.nouk.phoon@altera.com,
genevieve.chan@altera.com, adrian.ho.yin.ng@altera.com
Subject: [PATCH v1 1/2] firmware: stratix10-svc: add FCS random-number command for Agilex 5
Date: Fri, 20 Nov 2026 01:51:32 -0800 [thread overview]
Message-ID: <85200a2c0f9bf3196f6bc2972d4b8808d072262e.1795167624.git.hang.suan.wang@altera.com> (raw)
In-Reply-To: <cover.1795167624.git.hang.suan.wang@altera.com>
From: Hang Suan Wang <hang.suan.wang@altera.com>
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@altera.com>
---
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
next prev parent reply other threads:[~2026-11-20 9:51 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-20 9:51 [PATCH v1 0/2] Add FCS Random Number Generator (RNG) driver hang.suan.wang
2026-11-20 9:51 ` hang.suan.wang [this message]
2026-11-20 9:51 ` [PATCH v1 2/2] hwrng: socfpga-fcs - Add FCS random number generator driver hang.suan.wang
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=85200a2c0f9bf3196f6bc2972d4b8808d072262e.1795167624.git.hang.suan.wang@altera.com \
--to=hang.suan.wang@altera.com \
--cc=Frank.Li@nxp.com \
--cc=adrian.ho.yin.ng@altera.com \
--cc=chee.nouk.phoon@altera.com \
--cc=dinguyen@kernel.org \
--cc=ebiggers@kernel.org \
--cc=genevieve.chan@altera.com \
--cc=herbert@gondor.apana.org.au \
--cc=jeanmichel.hautbois@yoseli.org \
--cc=linux-crypto@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=miquel.raynal@bootlin.com \
--cc=muhammad.nazim.amirul.nazle.asmade@altera.com \
--cc=olivia@selenic.com \
--cc=tze.yee.ng@altera.com \
--cc=wsa+renesas@sang-engineering.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®