Add nonblocking RNG trait

Author: austinbes

src/lib.rs

@@ -694,6 +694,8 @@ pub mod blocking;
 pub mod digital;
 pub mod fmt;
 pub mod prelude;
+#[cfg(feature = "unproven")]
+pub mod rng;
 pub mod serial;
 pub mod spi;
 pub mod timer;

src/prelude.rs

@@ -25,6 +25,8 @@ pub use digital::OutputPin as _embedded_hal_digital_OutputPin;
 #[cfg(feature = "unproven")]
 #[allow(deprecated)]
 pub use digital::ToggleableOutputPin as _embedded_hal_digital_ToggleableOutputPin;
+#[cfg(feature = "unproven")]
+pub use rng::Read as _embedded_hal_rng_Read;
 pub use serial::Read as _embedded_hal_serial_Read;
 pub use serial::Write as _embedded_hal_serial_Write;
 pub use spi::FullDuplex as _embedded_hal_spi_FullDuplex;

src/rng.rs

@@ -0,0 +1,16 @@
+//! Random Number Generator Interface
+
+use nb;
+
+/// Nonblocking stream of random bytes.
+#[cfg(feature = "unproven")]
+// reason: No implementation or users yet
+pub trait Read {
+    /// An enumeration of RNG errors.
+    ///
+    /// For infallible implementations, will be `Void`
+    type Error;
+
+    /// Get a number of bytes from the RNG.
+    fn read(&mut self, buf: &mut [u8]) -> nb::Result<usize, Self::Error>;
+}