RIOT/tests/rng

RNG

Test application for the RNG sources.

Supported commands

• distributions [N] — Take N samples and print a bit distribution graph on the terminal.
• dump [N][A B] — Take N samples and print them on the terminal. If A and B are set, the PRNG returns values in the [A,B)-interval.
• 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][A B] — Run a PRNG for N seconds and print the number of KiB/sec afterwards. If A and B are set, the PRNG returns values in the [A,B)-interval.

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.