micropython/stmhal/rng.c
Damien George 8d09640b22 stmhal: Add documentation in comments, and script to generate HTML.
Decided to write own script to pull documentation from comments in C code.
Style for writing auto generated documentation is: start line with ///
and then use standard markdown to write the comment.  Keywords
recognised by the scraper begin with backslash.  See code for examples.

Running: python gendoc.py modpyb.c accel.c adc.c dac.c extint.c i2c.c
led.c pin.c rng.c servo.c spi.c uart.c usrsw.c, will generate a HTML
structure in gendoc-out/.

gendoc.py is crude but functional.  Needed something quick, and this was
it.
2014-04-29 22:55:34 +01:00

47 lines
964 B
C

#include <string.h>
#include "stm32f4xx_hal.h"
#include "misc.h"
#include "mpconfig.h"
#include "qstr.h"
#include "obj.h"
#include "rng.h"
#if MICROPY_HW_ENABLE_RNG
/// \moduleref pyb
STATIC RNG_HandleTypeDef RNGHandle = {.Instance = NULL};
void rng_init0(void) {
// reset the RNG handle
memset(&RNGHandle, 0, sizeof(RNG_HandleTypeDef));
RNGHandle.Instance = RNG;
}
void rng_init(void) {
__RNG_CLK_ENABLE();
HAL_RNG_Init(&RNGHandle);
}
uint32_t rng_get(void) {
if (RNGHandle.State == HAL_RNG_STATE_RESET) {
rng_init();
}
return HAL_RNG_GetRandomNumber(&RNGHandle);
}
/// \function rng()
/// Return a 30-bit hardware generated random number.
STATIC mp_obj_t pyb_rng_get(void) {
if (RNGHandle.State == HAL_RNG_STATE_RESET) {
rng_init();
}
return mp_obj_new_int(HAL_RNG_GetRandomNumber(&RNGHandle) >> 2);
}
MP_DEFINE_CONST_FUN_OBJ_0(pyb_rng_get_obj, pyb_rng_get);
#endif // MICROPY_HW_ENABLE_RNG