这个页面的最新开发版本可能比这个发布的 2.3-beta.2 版本新。

RNG

简介

W80x 支持产生真随机数。

功能列表

初始化——初始化驱动。

得到一个 32 位随机数。

得到多个字节的随机数。

得到多个字节的随机数——用户不需要初始化驱动。

初始化驱动

调用 wm_drv_rng_init() ，得到指向 rng 模块的设备指针，只有得到了这个指针才能调用其他的相关的 API。示例：
wm_device_t *dev;
dev = wm_drv_rng_init("rng");
函数参数指定设备名称，名称在设备表中定义。

得到一个 32 位随机数

调用 wm_drv_rng_read() ，得到一个 32 位随机数。示例：
wm_device_t *dev;
dev = wm_drv_rng_init("rng");
uint32_t rng_value = wm_drv_rng_read(dev);
函数参数是指向设备的指针

得到多个字节的随机数

调用 wm_drv_rng_read() ，得到多个字节的随机数。示例：
wm_device_t *dev;
dev = wm_drv_rng_init("rng");
uint8_t out[10];
wm_drv_rng_read_bytes(dev, out, 10);
第一个参数是：指向设备的指针

第二个参数是：指向随机数的指针

第三个参数是：产生的随机数的字节数

得到多个字节的随机数

调用 wm_drv_fill_random() 得到多个字节的随机数，函数内部已经含有 rng 驱动的初始化及上下文 ctx 的配置，用户只需要传两个参数，示例：
uint8_t out[16];
wm_drv_fill_random(out, 16);
第一个参数是：指向随机数的指针

第二个参数是：产生的随机数的字节数

应用实例

使用 RNG 基本示例请参考 examples/peripheral/rng

API 参考

查找 RNG 相关 API 请参考：

RNG API 参考