Page MenuHomeFreeBSD

Random bit generator (RBG) driver for RPi and RPi2.

Authored by stevek on Jun 18 2016, 10:34 AM.
Referenced Files
Unknown Object (File)
Sat, Mar 30, 6:20 AM
Unknown Object (File)
Thu, Mar 28, 9:30 AM
Unknown Object (File)
Mar 3 2024, 7:32 AM
Unknown Object (File)
Mar 3 2024, 7:07 AM
Unknown Object (File)
Feb 20 2024, 12:52 PM
Unknown Object (File)
Feb 18 2024, 7:46 AM
Unknown Object (File)
Dec 20 2023, 1:37 PM
Unknown Object (File)
Dec 20 2023, 1:07 AM



This driver supports the following methods to trigger gathering random bits from the hardware:

  1. interrupt when the FIFO is full (default) fed into the harvest queue
  2. callout (when BCM2835_RNG_USE_CALLOUT is defined) every second if hz is less than 100, otherwise hz / 100, feeding the random bits into the harvest queue

If the kernel is booted with verbose enabled, the contents of the registers will be dumped after the RBG is started during the attach routine.

Test Plan

Built RPI2 kernel and booted on board. Tested the different methods to feed the harvest queue (callout, interrupt) and the interrupt driven approach seems best. However, keeping the other method for people to be able to experiment with.

Diff Detail

rS FreeBSD src repository - subversion
Lint Skipped
Tests Skipped

Event Timeline

stevek retitled this revision from to Random bit generator (RBG) driver for RPi and RPi2..
stevek updated this object.
stevek edited the test plan for this revision. (Show Details)
stevek added a reviewer: ARM.
stevek set the repository for this revision to rS FreeBSD src repository - subversion.
stevek added subscribers: jtl, sjg.
markm requested changes to this revision.Jun 18 2016, 11:25 AM
markm edited edge metadata.
markm added inline comments.

This mode looks like it may be a liability? Should the callout/interrupt-using method not be the default?


There is a mix of tabs and spaces in these defines giving a ragged indentation. Please check style(9) and use only one form for uniformity.


This define looks a little spare here.


An inline function gives slightly better type-safety and better readability, not to mention consistency with the functions below.


Is this right? The general pattern suggests the constant should be 0x1.

Also, can the whole block not be done with some arithmetic, rather than having a bunch of nearly identical constant strings?


It might be a good idea to make this tweekable, like a sysctl, instead of a hard constant.

A panic is quite harsh, so I agree with the #ifdef defaulting to "off".


Yuk :-) A delay here s a no-no. The interrupt/callout method needs to be the default/only method, and this delay needs to go.


Can this also be a sysctl?


Yuk. I know there is precedent for goto's in the BSD kernel, but I'd prefer not to see any new ones. (Preference not insistence).


"optional random" not "standard" please.

This revision now requires changes to proceed.Jun 18 2016, 11:25 AM

Yes, this bled in from my testing.


Okay, I'll just remove the source registration pieces. Makes sense to just axe them since the RBG is not able to keep up with requests as a pure entropy source.


There is a per-device sysctl. See farther below in this function.

stevek edited edge metadata.

I'm not sure what Phabricator is doing with the indentation in bcm2835_rng.c, but it is properly tab indented and the web interface is mutilating the formatting output for the #defines.

The changes in this diff are as follows:
Clean up formatting of some #define(s) to match style(9).
Remove entropy source registration (the RBG cannot keep up, so no sense trying that mode.)
Make the stats incrementing for underruns a static inline function.
Try to detect stalls and reset the device if it happens. If the device stalls twice in one harvest attempt, just disable the device rather than causing potential issues with the rest of the system.
Make the RNG optional, enabling only with the random device is configured.
Add sysctl and tunable for setting stall count.

stevek edited edge metadata.

Updated to eliminate the goto in the attach method.

stevek edited the test plan for this revision. (Show Details)
adrian added a reviewer: adrian.
adrian added a subscriber: adrian.

I think this looks pretty good now.

delphij edited edge metadata.

Looks good to me (consider this as a secteam@ approval).

I've got this ready to commit.

We are in code freeze, but I'll see if RE@ buys it, otherwise I'll do it after the freeze is lifted.

@markm The freeze has thawed for head (, but for MFC RE will need to approve.

This revision was automatically updated to reflect the committed changes.