Skip to main content

Power (Power Management)

LibXR::PowerManager provides a unified interface for power management, suitable for implementing system reset, shutdown, or entering low-power modes. It is intended for implementation by platform or power control drivers.

Interface Definition​

class PowerManager {
public:
  PowerManager() = default;
  virtual ~PowerManager() = default;

  // System reset operation (to be implemented by subclass)
  virtual void Reset() = 0;

  // System shutdown operation (to be implemented by subclass)
  virtual void Shutdown() = 0;

  // Jump to bootloader (falls back to Reset by default)
  virtual void JumpToBootloader() { Reset(); }
};

Usage Notes​

  • Reset() can be used to perform a soft reset, restart the system, etc.;
  • Shutdown() is used for power-off, entering sleep, or other low-power control;
  • JumpToBootloader() falls back to Reset() by default, and platform implementations may replace it with a real bootloader jump;
  • Can be applied in scenarios such as power button handling, remote commands, low battery strategies, etc.;
  • The specific behavior is implemented by the platform, while the interface remains consistent to facilitate portability and abstraction.

Current interface boundaries​

  • PowerManager is currently a very narrow abstraction surface: only Reset(), Shutdown(), and JumpToBootloader() with the default fallback to Reset().
  • It does not currently define richer common policy surfaces such as state queries, event callbacks, or standardized low-power mode enums. If a platform offers those capabilities, they still belong to the concrete implementation or to a higher-level policy layer rather than to this base-class contract.