OSDN Git Service

hw/misc: Introduce AMD/Xilix Versal TRNG device
authorTong Ho <tong.ho@amd.com>
Tue, 31 Oct 2023 18:46:09 +0000 (11:46 -0700)
committerPeter Maydell <peter.maydell@linaro.org>
Thu, 2 Nov 2023 14:42:03 +0000 (14:42 +0000)
commit921923583fb2583a277e3b3d6cb8e8e13c622d48
tree7d4915fcda65a1770319412fdbe3ee5cf96c83ce
parent4c09abeae8704970ff03bf2196973f6bf08ab6f9
hw/misc: Introduce AMD/Xilix Versal TRNG device

This adds a non-cryptographic grade implementation of the
model for the True Random Number Generator (TRNG) component
in AMD/Xilinx Versal device family.

This implements all 3 modes defined by the actual hardware
specs, all of which selectable by guest software at will
at anytime:
1) PRNG mode, in which the generated sequence is required to
   be reproducible after reseeded by the same 384-bit value
   as supplied by guest software.
2) Test mode, in which the generated sequence is required to
   be reproducible ater reseeded by the same 128-bit test
   seed supplied by guest software.
3) TRNG mode, in which non-reproducible sequence is generated
   based on periodic reseed by a suitable entropy source.

This model is only intended for non-real world testing of
guest software, where cryptographically strong PRNG or TRNG
is not needed.

This model supports versions 1 & 2 of the device, with
default to be version 2; the 'hw-version' uint32 property
can be set to 0x0100 to override the default.

Other implemented properties:
- 'forced-prng', uint64
  When set to non-zero, mode 3's entropy source is implemented
  as a deterministic sequence based on the given value and other
  deterministic parameters.
  This option allows the emulation to test guest software using
  mode 3 and to reproduce data-dependent defects.

- 'fips-fault-events', uint32, bit-mask
  bit 3: Triggers the SP800-90B entropy health test fault irq
  bit 1: Triggers the FIPS 140-2 continuous test fault irq

Signed-off-by: Tong Ho <tong.ho@amd.com>
Message-id: 20231031184611.3029156-2-tong.ho@amd.com
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
hw/misc/Kconfig
hw/misc/meson.build
hw/misc/xlnx-versal-trng.c [new file with mode: 0644]
include/hw/misc/xlnx-versal-trng.h [new file with mode: 0644]