3 This file is part of the Crypto-avr-lib/microcrypt-lib.
4 Copyright (C) 2008 Daniel Otte (daniel.otte@rub.de)
6 This program is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>.
25 * \brief This file contains an implementaition of a pseudo-random-number generator.
28 * rndCore is expanded to 512 bits for more security.
31 * ################################################################################################
33 * # +---------------------------+ #
37 * +---------------+ # o---------o (xor)+---------+ o---------o | o----o o---------o # +--------------+
38 * | entropy Block | -----> | sha-256 | --(offset)-< | rndCore | ---> | sha-256 | --+--+-| +1 |---> | sha-256 | -----> | random Block |
39 * +---------------+ # o---------o (xor)+---------+ o---------o | o----o o---------o # +--------------+
43 * # (offset)---------------------+ #
45 * ################################################################################################
50 * ################################################################################################
52 * # +---------------------------+ #
56 * +---------------+ # o---------o (xor)+---------+ o---------o | o----o o---------o # +--------------+
57 * | entropy Block | -----> | sha-256 | --(offset)-< | rndCore | ---> | sha-256 | --+--+-| +1 |---> | sha-256 | -----> | random Block |
58 * +---------------+ # o---------o (xor)+---------+ o---------o | o----o o---------o # +--------------+
62 * # (offset)---------------------+ #
64 * ################################################################################################
71 #include "entropium.h"
74 * \brief secret entropy pool.
75 * This is the core of the random which is generated
79 /*************************************************************************/
82 * \brief This function adds entropy to the central entropy pool
84 * @param length This ist the length of the random data in BITS.
85 * @param data This is the random data which should be added to the entropy pool
87 /* idea is: hash the message and add it via xor to rndCore
91 * we simply first "hash" rndCore, then entropy.
93 void entropium_addEntropy(unsigned length_b, const void* data){
95 static uint8_t offset=0; /* selects if higher or lower half gets updated */
97 sha256_nextBlock(&s, rndCore);
98 while (length_b>=512){
99 sha256_nextBlock(&s, data);
100 data = (uint8_t*)data+ 512/8;
103 sha256_lastBlock(&s, data, length_b);
106 rndCore[i+offset] ^= s.h[i];
108 offset ^= 8; /* hehe */
111 /*************************************************************************/
113 * \brief This function fills a given buffer with 32 random bytes
114 * @param b Pointer to buffer wich is to fill
116 void entropium_getRandomBlock(void *b){
121 sha256_lastBlock(&s, rndCore, 512); /* remeber the byte order! */
124 rndCore[i+offset] ^= s.h[i];
126 offset ^= 8; /* hehe */
127 memcpy(b, s.h, 32); /* back up first hash in b */
128 ((uint8_t*)b)[*((uint8_t*)b)&31]++; /* the important increment step */
130 sha256_lastBlock(&s, b, 256);
134 /*************************************************************************/
137 * \brief This function simply returns a random byte
138 * @return a random byte
140 uint8_t entropium_getRandomByte(void){
141 static uint8_t block[32];
145 entropium_getRandomBlock((void*)block);
151 /*************************************************************************/
154 * \brief This function fills the given bock with length random bytes
155 * @return a random byte
158 void entropium_fillBlockRandom(void* block, unsigned length_B){
159 while(length_B>ENTROPIUM_RANDOMBLOCK_SIZE){
160 entropium_getRandomBlock(block);
161 block = (uint8_t*)block + ENTROPIUM_RANDOMBLOCK_SIZE;
162 length_B -= ENTROPIUM_RANDOMBLOCK_SIZE;
165 *((uint8_t*)block) = entropium_getRandomByte();
166 block= (uint8_t*)block +1; --length_B;