rng-rava 1.0.1

Python driver for the RAVA RNG device

RAVA Python Driver

The RAVA Python Driver implements the code for communicating with an RAVA Device running the RAVA Firmware. The computer running the driver assumes the role of the leader device, sending command requests and reading the data replies.

The RAVA_RNG class enables the request of pulse counts, random bits, random bytes, and random numbers (integers and floats). Additionally, it establishes the circuit's basic functionality encompassing key modules such as EEPROM, PWM, heath tests, peripherals, and interfaces.

The RAVA_RNG_AIO class offers the same functionality as RAVA_RNG but within an asynchronous framework.

The RAVA_RNG_LED class implements the code for controlling the LED and LAMP modules within the RAVA circuit. It allows users to adjust the color and the intensity of the attached LED. Users can also activate the LAMP mode and retrieve statistical information on its operation.

For a deeper understanding of how the driver operates, please refer to the documentation provided within the source files and the provided examples.

Installation

The driver code is available as the rng_rava PyPI package. To install it, run:

pip install rng_rava

Requirements:

• pyserial

Usage

import rng_rava as rava

# Find the serial number of the attached RAVA devices
rava_sns = rava.find_rava_sns()

# Create a RNG instance and connect to the first device
rng = rava.RAVA_RNG()
rng.connect(serial_number=rava_sns[0])

'''
The default PWM and RNG configuration parameters are stored in the EEPROM memory
and can be accessed with rng.get_eeprom_pwm() and rng.get_eeprom_rng(). If
desired, users can modify the default values using the respective snd_
functions. Additionally, it is possible to make non-permanent configuration
changes using the following commands:
'''

# Configure PWM
rng.snd_pwm_setup(freq_id=rava.D_PWM_FREQ['50_KHZ'], duty=20)

# Configure RNG
rng.snd_rng_setup(sampling_interval_us=10)

'''
Next, the generation of various random data types is demonstrated.
'''

# Measure 100 pulse counts
pc_a, pc_b = rng.get_rng_pulse_counts(n_counts=100)

# Generate a random bit XORing both channels
bit = rng.get_rng_bits(bit_source_id=rava.D_RNG_BIT_SRC['AB_XOR'])

# Generate 100 random bytes en each channel without post-processing
# Output as numpy array
bytes_a, bytes_b = rng.get_rng_bytes(n_bytes=100,
                                     postproc_id=rava.D_RNG_POSTPROC['NONE'],
                                     list_output=True)

# Generate 100 8-bit integers between 0 and 99
ints8 = rng.get_rng_int8s(n_ints=100, int_delta=100)

# Generate 100 16-bit integers between 0 and 9999
ints16 = rng.get_rng_int16s(n_ints=100, int_delta=10000)

# Generate 100 32-bit floats ranging between 0 and 1
floats = rng.get_rng_floats(n_floats=100)

Associated projects

• RAVA Device
• RAVA Firmware
• RAVA Python Diagnostics Tool

Contact

gabrielguerrer [at] gmail [dot] com