DAC: Add wrapper around RIOTs DAC-interface

src/dac.rs

@@ -0,0 +1,60 @@
+use riot_sys::dac_t;
+
+#[derive(Debug)]
+pub struct DACLine {
+ line: dac_t,
+}
+
+#[derive(Debug)]
+pub enum DACError {
+ /// The given dac_t line did not exist
+ NoLine,
+ /// An unknown error did occur
+ Unknown,
+}
+
+impl DACLine {
+ /// Creates and intializes a new [`DACLine`] from the given
+ /// unitialized [`dac_t`].
+ ///
+ /// Returns an Error if the given line does not exist
+ /// on the board.
+ pub fn new(line: dac_t) -> Result<Self, DACError> {
+ let res = unsafe { riot_sys::dac_init(line) } as i32;
+
+ const DAC_OK: i32 = riot_sys::DAC_OK as i32;
+ const DAC_NOLINE: i32 = riot_sys::DAC_NOLINE as i32;
+
+ match res {
+ DAC_OK => Ok(DACLine { line }),
+ DAC_NOLINE => Err(DACError::NoLine),
+ _ => Err(DACError::Unknown),
+ }
+ }
+
+ /// Builds a [`DACLine`] from an already initialized [`dac_t`].
+ ///
+ /// Providing a not initialized [`dac_t`] results in undefined behavior.
+ pub unsafe fn new_without_init(line: dac_t) -> Self {
+ DACLine { line }
+ }
+
+ /// Writes the given value to this [`DACLine`]
+ ///
+ /// The `value` is internally scaled to the underlying
+ /// dac device so that the maximum voltage output
+ /// is always equivalent to [`u16::MAX`]
+ pub fn set(&self, value: u16) {
+ unsafe { riot_sys::dac_set(self.line, value) }
+ }
+
+ /// Turns the [`DACLine`] on after `DACLine::power_off`
+ pub fn power_on(&self) {
+ unsafe { riot_sys::dac_poweron(self.line) }
+ }
+
+ /// Turns the [`DACLine`] off
+ pub fn power_off(&self) {
+ unsafe { riot_sys::dac_poweroff(self.line) }
+ }
+}

src/lib.rs

@@ -118,6 +118,9 @@ pub mod spi;
 #[cfg(riot_module_periph_adc)]
 pub mod adc;
 
+#[cfg(riot_module_periph_dac)]
+pub mod dac;
+
 #[cfg(riot_module_ztimer)]
 pub mod ztimer;