mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00

History

Joakim Nohlgård 2bf1068c72 tests/rng: Clean up includes		2018-02-07 10:24:33 +01:00
..
tests	tests/rng/tests: fix flake8 F401 issue	2017-12-20 16:42:59 +01:00
main.c	tests/rng: Clean up includes	2018-02-07 10:24:33 +01:00
Makefile	tests/rng: make Makefile adhere to conventions	2017-12-21 13:23:23 +01:00
README.md	tests: rng: add test suite for RNG sources (PRNG, HWRNG)	2017-12-17 17:02:59 +01:00
test.c	tests/rng: Clean up includes	2018-02-07 10:24:33 +01:00
test.h	tests/rng: Clean up includes	2018-02-07 10:24:33 +01:00

README.md

RNG

Test application for the RNG sourcs.

Supported commands

distributions [N] — Take N samples and print a bit distribution graph on the terminal.
dump [N] — Take N samples and print them on the terminal.
fips — Run the FIPS 140-2 random number tests.
entropy [N] — Calculate Shannon's entropy from N samples.
seed [N] — Set the random seed to use.
source [N] — Select the RNG source, or list them all.
speed [N] — Run a PRNG for N seconds and print the number of KiB/sec afterwards.

Sources

The following sources are supported:

PRNG
HW RNG (if available)
Constant number (uses the seed)

The PRNG is re-initialized before every test, using the given seed (default is 0).

A constant number source is useful to see if the test itself work, e.g. indicate failures.

Warning

The tools available in this test do not garruantee that a given RNG source is secure. It should, however, rule out basic failures using statistical tests.