Struct PTMSysM

pub struct PTMSysM { /* private fields */ }

Handle to the PTM:SysM service.

Implementations

impl PTMSysM

pub fn new() -> Result<Self>

Initialize a new service handle.

Errors

This function will return an error if the service was unable to be initialized. Since this service requires no special or elevated permissions, errors are rare in practice.

Example

use ctru::services::ptm::sysm::PTMSysM;

let ptm_sysm = PTMSysM::new()?;

pub fn request_sleep(&self) -> Result<()>

Try putting the console in sleep mode.

Notes

This request can be denied for various reasons. This does not “force” the console to sleep.

Example

use ctru::services::ptm::sysm::PTMSysM;
use std::time::Duration;

let ptm_sysm = PTMSysM::new()?;

// Request the activation of sleep mode.
ptm_sysm.request_sleep().unwrap();

pub fn request_shutdown(&self, timeout: Duration) -> Result<()>

Request a system shutdown within the given timeout.

Example

use ctru::services::ptm::sysm::PTMSysM;
use std::time::Duration;

let ptm_sysm = PTMSysM::new()?;

// Shutdown the system (usually the request succeeds immediately).
ptm_sysm.request_shutdown(Duration::from_nanos(0)).unwrap();

pub fn request_reboot(&self, timeout: Duration) -> Result<()>

Request a system reboot within the given timeout.

Example

use ctru::services::ptm::sysm::PTMSysM;
use std::time::Duration;

let ptm_sysm = PTMSysM::new()?;

// Reboot the system.
ptm_sysm.request_reboot(Duration::from_nanos(0)).unwrap();