From 0b59372eb0c32464cde8cd7da786e487d355ce48 Mon Sep 17 00:00:00 2001 From: Martine Lenders <mail@martine-lenders.eu> Date: Fri, 2 Sep 2016 13:34:44 +0200 Subject: [PATCH] at86rf2xx: document operation mode concerns for --- drivers/at86rf2xx/include/at86rf2xx_internal.h | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/drivers/at86rf2xx/include/at86rf2xx_internal.h b/drivers/at86rf2xx/include/at86rf2xx_internal.h index 44694c87af..ef65570c49 100644 --- a/drivers/at86rf2xx/include/at86rf2xx_internal.h +++ b/drivers/at86rf2xx/include/at86rf2xx_internal.h @@ -163,10 +163,18 @@ void at86rf2xx_hardware_reset(at86rf2xx_t *dev); */ void at86rf2xx_configure_phy(at86rf2xx_t *dev); -#if defined MODULE_AT86RF233 || defined MODULE_AT86RF231 +#if defined(MODULE_AT86RF233) || defined(MODULE_AT86RF231) || defined(DOXYGEN) /** * @brief Read random data from the RNG * + * @note According to the data sheet this function only works properly in + * Basic Operation Mode. However, sporadic testing has shown that even + * in Extended Operation Mode this returns random enough data to be + * used as a seed for @ref sys_random if no cryptographically secure + * randomness is required. + * Any further use-case needs to be evaluated, especially if + * crypto-relevant randomness is required. + * * @param[in] dev device to configure * @param[out] data buffer to copy the random data to * @param[in] len number of random bytes to store in data -- GitLab