[Cryptech-Commits] [test/external_avalanche_entropy] 01/01: Adding a short README that describes, purpose and how the design works.

[git at cryptech.is]

This is an automated email from the git hooks/post-receive script.

joachim at secworks.se pushed a commit to branch master
in repository test/external_avalanche_entropy.

commit 436c4946f637fa3977f7744be0a1fb2b750a8f7d
Author: Joachim Strömbergson <joachim at secworks.se>
Date:   Thu Aug 21 15:34:44 2014 +0200

    Adding a short README that describes, purpose and how the design works.
---
 README.txt | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..017d5ae
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,20 @@
+
+External Avalanche Entropy
+--------------------------
+This is a test project of an entropy provider that collects entropy from
+an avalanche noise based source.
+
+The design expects a one bit digital input noise signal. The collector
+observes positive flank events in the input noise signa and measures the
+time between these events using a counter. The counter is free running
+and increases once for each clock cycle (currently running av 50 MHz).
+
+The LSB of the counter is added to a 32-bit entropy register at each
+event.
+
+As debug output the entropy register is sampled at a given rate
+(currently a few times per second). The debug output is connected to LED
+on the FPGA development board.
+
+The project also contains project files, pin assignments and clock
+definition neded to implement the design on a TerasIC DE0-Nano board.