Skip to content

Commit 5de83a0

Browse files
committed
fix(security): Clarify TRNG engine ownership by OPTEE
The SDK by default provides control of TRNG engine to OP-TEE, which also firewalls the associated MMR regions. Document this design choice for clarity. Signed-off-by: Shiva Tripathi <s-tripathi1@ti.com>
1 parent a1acc01 commit 5de83a0

2 files changed

Lines changed: 11 additions & 5 deletions

File tree

source/linux/Foundational_Components/Kernel/Kernel_Drivers/Crypto/DTHEv2.rst

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -216,10 +216,12 @@ software only implementation can be compared to the previous test.
216216
Using the True Random Number Generator (TRNG) Hardware Accelerator
217217
******************************************************************
218218

219-
The pre-built kernel included within the SDK already has the OP-TEE TRNG
220-
driver enabled. You do not need any further configuration.
219+
In the default SDK, OP-TEE controls the TRNG engine and firewalls its
220+
hardware registers, blocking outside access. To use TRNG from Linux instead,
221+
disable the OP-TEE driver and enable the RNG node in the Linux device tree.
221222

222-
Verify that the optee-rng driver is loaded:
223+
Using TRNG from OP-TEE requires no further configuration. Verify that the
224+
optee-rng driver is loaded:
223225

224226
.. code-block:: console
225227

source/linux/Foundational_Components/Kernel/Kernel_Drivers/Crypto/SA2UL_OMAP.rst

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -304,8 +304,12 @@ software only implementation can be compared to the previous test.
304304
Using the TRNG Hardware Accelerator
305305
***********************************
306306

307-
The pre built kernel that come with the SDK already has the TRNG driver
308-
built into the kernel. No further configuration is required.
307+
In the default SDK, OP-TEE controls the TRNG engine and firewalls its
308+
hardware registers, blocking outside access. To use TRNG from Linux instead,
309+
disable the OP-TEE driver and enable the RNG node in the Linux device tree.
310+
311+
Using TRNG from OP-TEE requires no further configuration. Verify that the
312+
optee-rng driver is loaded:
309313

310314
.. ifconfig:: CONFIG_crypto in ('sa2ul')
311315

0 commit comments

Comments
 (0)