Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/microcontroleurmonde/esp32_rng
A Micro-python library which provides an interface to generate a random number using the ESP32's hardware RNG. It enables Wi-Fi temporarily to enhance entropic noise, reads a random value from the RNG_DATA_REG, and then disables Wi-Fi.
https://github.com/microcontroleurmonde/esp32_rng
esp32 micropython rng trng
Last synced: 7 days ago
JSON representation
A Micro-python library which provides an interface to generate a random number using the ESP32's hardware RNG. It enables Wi-Fi temporarily to enhance entropic noise, reads a random value from the RNG_DATA_REG, and then disables Wi-Fi.
- Host: GitHub
- URL: https://github.com/microcontroleurmonde/esp32_rng
- Owner: MicroControleurMonde
- License: cc0-1.0
- Created: 2024-11-10T08:13:33.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-12-15T22:47:08.000Z (about 1 month ago)
- Last Synced: 2025-01-20T12:06:25.053Z (7 days ago)
- Topics: esp32, micropython, rng, trng
- Language: Python
- Homepage:
- Size: 6.03 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ESP32 RNG
A Micro-python library which provides an interface to generate a TRUE random number using the ESP32's hardware RNG.
It enables Wi-Fi temporarily to enhance entropic noise, reads a random value from the **`RNG_DATA_REG`**, and then disables Wi-Fi.
* Library : **esp32_rng.py**
* Library test: **test_esp32_rng.py**
* Example: **esp32_rng_random_number.py**
**Source**: `Espressif ESP32 technical reference manual (Version 5.2) / Section 25.Random Number Generator (RNG) / Page #604`
[link:](https://www.espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf#page=604)
Example of "Classical" code **not using** the direct call to the ESP32 hardware and calling `urandom` lib instead (pseudo random number)
* esp32_random_number.py
The ESP32 RNG generates random integer numbers as 32-bit values.
## Edit (13.12.24)
I just had a look at the **ESP32-C3** technical documentation and **bingo** !
The method for reading the RNG is exactly the same. Same register.
Only the address of the **RNG_DATA_REG_ADD** register changes to **'0x600260B0'**
I will do the tests and the publication of the results in a while.
## Platform
The code was implemented for an Espressif ESP32 microcontroller on a NODEMCU ESP32 Development Board.
MicroPython v1.23.0 on 2024-06-02; Generic ESP32 module with ESP32
- Chip is ESP32-D0WD (revision v1.0)
## Performance:
- Time taken to generate 180000 values: 90 seconds (avg)
- Throughput: 7934 Bytes/sec
- 2000 random values / sec.
# TRNG validation
~~* Considering that the Espressif ESP32 chip has already been tested and approved using the Dieharder Random Number Test Suite (version 3.31.1),~~
~~I will not repeat the tests to validate the reliability of the generator.~~
### Update(24.11.24)
While testing my RNG on RP2040 [Link](https://github.com/MicroControleurMonde/RP2040-RNG), I became very aware of the entropy weakness provided by my MCU generator.
So the decision was to also test the Espressif ESP32 chip to confirm its reliability as a TRNG.
Testing tools used:
* Ent (28.01.2008)
* Dieharder version 3.31.1
# Ent Test Report
([www.fourmilab.ch](https://www.fourmilab.ch/random/)) John Walker
- Sample size: **13.4 MB**
- Total generated: **1'180'000 values**
- [Ent Report -Raw](https://github.com/MicroControleurMonde/ESP32_RNG/blob/main/Reports/Ent_Report_ESP32.txt)
- [Ent Report Analyse](https://github.com/MicroControleurMonde/ESP32_RNG/blob/main/Reports/Ent_Report_Analyse.md)
- [CAcert Test Report](https://github.com/MicroControleurMonde/ESP32_RNG/blob/main/Reports/CAcert%20result%20ESP32.png)
# Dieharder Test Report
(https://webhome.phy.duke.edu/~rgb/General/dieharder.php) Robert G. Brown
- Sample size: **13.4 MB**
- Total generated: **1'180'000 values**
- [Dieharder Report - Raw](https://github.com/MicroControleurMonde/ESP32_RNG/blob/main/Reports/DieHard_Tests_esp32%20%232.txt)
- [Dieharder Report Analyses](https://github.com/MicroControleurMonde/ESP32_RNG/blob/main/Reports/DieHard_Tests_Analyses.md)
---
# Special tribute:
## Passing of John Walker
We are deeply saddened to hear of the passing of John Walker, one of the founders of Autodesk. He died at home in Switzerland, on 2nd February 2024, aged 74.
[The announcement was shared here.](https://www.engineering.com/a-cad-legend-passes-autodesk-founder-john-walker-1949-to-2024/)