HRNG#

sl_si91x_hrng_mode#

sl_si91x_hrng_mode

Enumeration for HRNG modes.

This enumeration defines the modes in which the Hardware Random Number Generator (HRNG) can operate.

sl_si91x_hrng_mode_t#

typedef enum sl_si91x_hrng_mode sl_si91x_hrng_mode_t

Enumeration for HRNG modes.

This enumeration defines the modes in which the Hardware Random Number Generator (HRNG) can operate.

sl_si91x_hrng_init#

sl_status_t sl_si91x_hrng_init (void )

Initialize the HRNG peripheral.

This function initializes the HRNG peripheral, setting up the necessary configurations for random number generation. It must be called before any HRNG functionality can be utilized.

Returns

• • SL_STATUS_OK - if the initialization was successful.

  • SL_STATUS_FAIL - if the initialization failed due to an error.

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_hrng_start#

sl_status_t sl_si91x_hrng_start (sl_si91x_hrng_mode_t hrng_mode)

Start the Hardware Random Number Generator (HRNG).

This function starts the HRNG in the specified mode, allowing either true random or pseudo-random number generation based on the selected mode. It prepares the HRNG hardware to generate random numbers.

• Pre-conditions:

  • The HRNG peripheral clocks must be enabled using sl_si91x_hrng_init.

Returns

• • SL_STATUS_OK: Successfully started the HRNG.

  • SL_STATUS_INVALID_PARAMETER: Invalid mode or pointer.

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_hrng_get_bytes#

sl_status_t sl_si91x_hrng_get_bytes (uint32_t * random_bytes, uint8_t number_of_bytes)

Retrieve random bytes generated by the HRNG.

This function reads a specified number of random bytes from the HRNG hardware and stores them in the provided buffer. It ensures that the requested number of bytes is fetched from the HRNG peripheral.

• Pre-conditions:

  • The HRNG peripheral clocks must be enabled using sl_si91x_hrng_init.

  • The HRNG must be started using sl_si91x_hrng_start.

Returns

• • SL_STATUS_OK: Successfully retrieved the random bytes.

  • SL_STATUS_INVALID_PARAMETER: Invalid pointer or number of bytes.

  • SL_STATUS_FAIL: Failed to retrieve random bytes.

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_hrng_read_lfsr_input#

sl_status_t sl_si91x_hrng_read_lfsr_input (uint8_t number_of_bytes, uint32_t * random_bytes)

Reads random data from the HRNG using the LFSR (Linear-Feedback Shift Register) input latch.

This function reads random data from the HRNG using the LFSR input latch register. It first enables the LFSR, reads the specified number of bytes, and then disables the LFSR. Note

• Data is valid only when the LFSR_32_BIT_INPUT_VALID bit is set.

• Pre-conditions:

  • The HRNG peripheral clocks must be enabled using sl_si91x_hrng_init.

  • The HRNG must be started using sl_si91x_hrng_start.

Returns

• • SL_STATUS_OK: If the random data was read successfully.

  • SL_STATUS_FAIL: If there was an error reading the random data.

For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_hrng_stop#

sl_status_t sl_si91x_hrng_stop (void )

Stop the Hardware Random Number Generator (HRNG).

This function disables the HRNG by stopping the random number generation process and halting any ongoing operations within the HRNG peripheral.

• Pre-conditions:

  • The HRNG peripheral clocks must be enabled using sl_si91x_hrng_init.

  • The HRNG must be started using sl_si91x_hrng_start.

Returns

• • SL_STATUS_OK: If the HRNG stopped successfully. For more information on status codes, see SL STATUS DOCUMENTATION.

sl_si91x_hrng_deinit#

sl_status_t sl_si91x_hrng_deinit (void )

Disable the HRNG peripheral clocks.

This function disables the HRNG clocks, effectively shutting down the HRNG peripheral to conserve power or halt its operations when not in use.

• Pre-conditions:

  • The HRNG peripheral clocks must be enabled using sl_si91x_hrng_init.

  • The HRNG must be stopped using sl_si91x_hrng_stop.

Returns

• SL_STATUS_OK if the operation was successful. SL_STATUS_FAIL indicates that the operation failed due to an error.

For more information on status codes, see SL STATUS DOCUMENTATION.

SL_SI91X_HWRNG_CLK_ENABLE#

#define SL_SI91X_HWRNG_CLK_ENABLE

HWRNG_CLK_ENABLE

Enable clock for HWRNG.

SL_SI91X_HWRNG_MAX_BYTES#

#define SL_SI91X_HWRNG_MAX_BYTES

254

Maximum number of bytes that can be generated by the HWRNG.

SL_SI91X_HWRNG_MIN_BYTES#

#define SL_SI91X_HWRNG_MIN_BYTES

1

Minimum number of bytes that can be generated by the HWRNG.