Collapse power_off and power_reboot into one function with an argument.

Makes it easier to add new power modes later on.

Author: jonathanpallant

src/lib.rs

@@ -598,18 +598,12 @@ pub struct Api {
 	/// On a microcontroller, this will wait for interrupts. Running in an
 	/// emulator, this will sleep the thread for a while.
 	pub power_idle: extern "C" fn(),
-	/// The OS will call this function to turn the power off.
+	/// The OS will call this function to control power on this system.
 	///
 	/// This function will not return, because the system will be switched off
 	/// before it can return. In the event on an error, this function will hang
 	/// instead.
-	pub power_off: extern "C" fn() -> !,
-	/// The OS will call this function to reboot the system.
-	///
-	/// This function will not return, because the system will be rebooted
-	/// before it can return. In the event on an error, this function will hang
-	/// instead.
-	pub power_reboot: extern "C" fn() -> !,
+	pub power_control: extern "C" fn(mode: PowerMode) -> !,
 
 	// ========================================================================
 	// Mutex functions

src/types.rs

@@ -105,6 +105,21 @@ pub struct MemoryRegion {
 	pub kind: MemoryKind,
 }
 
+/// The kinds of power control we can do.
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub enum PowerMode {
+	/// Turn the system power off
+	Off,
+	/// Reboot the main processor
+	Reset,
+	/// Reboot the main processor, but tell it to enter a bootloader mode for
+	/// programming. Precisely what this will do will depend upon the BIOS. Some
+	/// BIOSes will not have a bootloader mode and this will do a regular
+	/// reboot.
+	Bootloader,
+}
+
 // ============================================================================
 // Impls
 // ============================================================================