Add on-chip voltage regulator (VREG) voltage setting function

rp2040-hal/src/lib.rs

@@ -72,6 +72,7 @@ pub mod typelevel;
 pub mod uart;
 pub mod usb;
 pub mod vector_table;
+pub mod vreg;
 pub mod watchdog;
 pub mod xosc;
 

rp2040-hal/src/vreg.rs

@@ -0,0 +1,47 @@
+//! On-chip voltage regulator (VREG)
+//!
+//! See [Chapter 2, Section 10](https://datasheets.raspberrypi.com/rp2040/rp2040-datasheet.pdf) of the datasheet for more details
+//!
+//! ## Usage
+//! ```no_run
+//! use rp2040_hal::{vreg::{VregVoltage, vreg_set_voltage}, pac};
+//! let mut pac = pac::Peripherals::take().unwrap();
+//! // Set voltage to 1.20V
+//! vreg_set_voltage(&mut pac.VREG_AND_CHIP_RESET, VregVoltage::Voltage1_20);
+//! ```
+
+use crate::pac::VREG_AND_CHIP_RESET;
+
+#[repr(u8)]
+/// Possible voltage values that can be applied to the on-chip voltage regulator
+pub enum VregVoltage {
+    /// 0.85V
+    Voltage0_85 = 0b0110u8,
+    /// 0.90V   
+    Voltage0_90 = 0b0111u8,
+    /// 0.95V
+    Voltage0_95 = 0b1000u8,
+    /// 1.00V
+    Voltage1_00 = 0b1001u8,
+    /// 1.05V
+    Voltage1_05 = 0b1010u8,
+    /// 1.10V (default)
+    Voltage1_10 = 0b1011u8,
+    /// 1.15V
+    Voltage1_15 = 0b1100u8,
+    /// 1.20V
+    Voltage1_20 = 0b1101u8,
+    /// 1.25V
+    Voltage1_25 = 0b1110u8,
+    /// 1.30V
+    Voltage1_30 = 0b1111u8,
+}
+
+/// Set voltage to the on-chip voltage regulator
+///
+/// * `voltage` - The voltage (from enumeration \ref vreg_voltage) to apply to the voltage regulator
+pub fn vreg_set_voltage(vreg_dev: &mut VREG_AND_CHIP_RESET, voltage: VregVoltage) {
+    vreg_dev
+        .vreg
+        .write(|w| unsafe { w.vsel().bits(voltage as u8) });
+}