From 52c7100186f64784052df9e6626d9363be3fc200 Mon Sep 17 00:00:00 2001 From: Andres Lagar-Cavilla <1432143+andreslagarcavilla@users.noreply.github.com> Date: Thu, 2 Nov 2023 13:56:00 -0700 Subject: [PATCH] Update docs, index new specs, and add eTRNG disclaimer (#155) * Link the HW integration spec explicitly * Index the HW integration spec * Add eTRNG disclaimer * RNG -> TRNG language fix --- README.md | 2 ++ doc/Caliptra.md | 4 ++-- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 5eef49c..b1d0e80 100644 --- a/README.md +++ b/README.md @@ -26,6 +26,8 @@ marks](https://github.com/chipsalliance/Caliptra/blob/main/CaliptraTrademarkPoli ## Specifications * [Main Caliptra specification](https://github.com/chipsalliance/Caliptra/blob/main/doc/Caliptra.md) +* [Hardware Integration + Specification](https://github.com/chipsalliance/caliptra-rtl/blob/main/docs/CaliptraIntegrationSpecification.md) * [ROM](https://github.com/chipsalliance/caliptra-sw/blob/main/rom/dev/README.md) * [FMC](https://github.com/chipsalliance/caliptra-sw/blob/main/fmc/README.md) * [Firmware](https://github.com/chipsalliance/caliptra-sw/blob/main/runtime/README.md) diff --git a/doc/Caliptra.md b/doc/Caliptra.md index 1eaa9f5..b888e62 100644 --- a/doc/Caliptra.md +++ b/doc/Caliptra.md @@ -1060,8 +1060,8 @@ The following figure describes the Caliptra Core. * Chips Alliance is used for RISC-V. * APB is the choice for the SoC-facing interface. * JTAG is exported at the IP interface. -* TRNG is the digital logic and algorithms that are required for random number generation. It requires a physical entropy source input. See the Caliptra IP specification and integration specification for more information. - * For SoCs that want to use their own legacy TRNG, Caliptra provides a HW API to push the random number on the request/response handshake. See the Caliptra IP specification and integration specification for more information. +* TRNG is the digital logic and algorithms that are required for random number generation. It requires a physical entropy source input. See the Caliptra IP specification and [integration specification](https://github.com/chipsalliance/caliptra-rtl/blob/main/docs/CaliptraIntegrationSpecification.md) for more information. + * For SoCs that want to use their own legacy TRNG, Caliptra provides a HW API to push the random number on the request/response handshake. See the Caliptra IP specification and [integration specification](https://github.com/chipsalliance/caliptra-rtl/blob/main/docs/CaliptraIntegrationSpecification.md) for more information. **This mode is advised for early development but discouraged for production tape outs due to the lower security assurances of an external TRNG**. The following figure describes the Caliptra IP HW boot flow.