ocelli: Camera-Based TRNG

Ocelli is a Rust application that generates high-quality entropy using a camera feed. The application supports two entropy generation methods (chop_and_tack and pick_and_flip) and optionally applies Van Neumann whitening for enhanced randomness. Generated entropy is saved as a binary file.

Features

Entropy Methods:
- chop_and_tack: Compares pixel values between frames.
- pick_and_flip: Processes pixel data and flips bits every second frame.
Van Neumann Whitening: Optional, enabled via the -w flag.
Shannon Entropy Test: Ensures the randomness quality of generated entropy.

Usage

cargo run --release -- <entropy_length_in_bytes> <resolution_width> <resolution_height> [-w]

Example

cargo run --release -- 1 1024 -w

This generates 1024 bytes of whitened entropy using camera 1.

Requirements

OpenCV 4.x

Installation

Install Rust: https://www.rust-lang.org/tools/install
Install OpenCV: Follow the official guide.

Clone the repository:

git clone <repository_url>
cd ocelli-entropy-generator

Run the application:
```
cargo run --release -- <arguments>
```

Output

Generated entropy files are saved in the current directory with a name format:

<method>[_whitened]_YYYYMMDD_HHMMSS.bin

1.4 KiB Raw Blame History