jki757 / truerng

Scripts, Drivers, and Utilities for the TrueRNG and TrueRNGpro Random Number Generators

TrueRNG Utilities

Scrips and Utilities for the TrueRNG and TrueRNGpro Random Number Generators

Devices and information available at: https://ubld.it/products/

Tools (Windows and Linux)

• truerng_find.py: Scans COM ports and identifies all connected TrueRNG devices
• truerng_generate_password.py: Example of how to create random passwords from TrueRNG devices
• truerng_generate_words.py: Example of how to create random word lists from TrueRNG devices
• truerng_mode.py: Example of how to change modes on TrueRNGpro and TrueRNGproV2 devices
• truerng_read_example.py: Example of how to read from a TrueRNG device
• truerng_test.py: Finds and performs testing on connected TrueRNG devices

Tools (Linux Only)

• truerng_fulltest.py: Reads a large block of data (14GB) and runs ent, rngtest, and dieharder (takes ~9 hours on the TrueRNGpro / TrueRNGproV2)
• run_rngtest: Linux script to run rngtest since it doensn't like to be called directly from Python - this is a "helper" for truerng_fulltest.py and isn't meant to be used directly

Windows INSTRUCTIONS

1. Install Python 64-bit for Windows from: https://www.python.org/ftp/python/3.8.3/python-3.8.3-amd64.exe

2. Put all files in the same directory - recommend c:\users\YOUR_USERNAME\TrueRNGutils or similar that you can remember

3. Open a command prompt (run the cmd command in Windows)

4. Change to the directory you created above and run:

install_python_libs.bat

5. Plug in a single TrueRNG V1, V2, V3, Pro, or ProV2

6. Run the python TrueRNG test app

py truerng_test.py

OR

truerng_test.py (if .py is associated with python3)

This app should detect the device, run tests, and display results both in text and a graph of the performance.

Linux Instructions (Ubuntu / Debian-based)

1. Install Python3

sudo apt install python3

2. Put all of the TrueRNGutils files in one directory (recommend /home/USERNAME/TrueRNGutils)

3. Install the required Python libraries

python3 -m pip install pyserial pyusb matplotlib numpy nltk

4. Run the python TrueRNG test app

python3 truerng_test.py

OR

./truerng_test.py (if your file permissions will allow execution)

This app should detect the device, run tests, and display results both in text and a graph of the performance.

More Python Tools and info at: https://cockrum.net

What the Results of truerng_test.py should look like

TrueRNGv1/v2/v3

TrueRNGpro (replaced by TrueRNGproV2)

TrueRNGproV2 (Current Amazon sales of the TrueRNGpro are shipping this unit)

Output of truerng_generate_password.py and truerng_generate_words.py