Domain Management Policy Tutorial

This section describes the steps for a domain management policy component to use the Domain Manager.

Domain management policy code interfaces with the domain manager through the RDmDomainManager class, which, in effect, controls the domain manager. Only one instance of this class can be connected to the domain manager at any one time.

Once connected through a call to Connect(), domain management policy can trigger power state transitions for specific domains and for the system:

  • it calls SystemShutDown() to trigger a system transition to the Off state. The call to this function never returns; the device powers down, and the system must then be re-booted.

  • it calls RequestSystemTransition() to trigger a system transition to the specified target power state. The target state can be Standby or Off. The implementation sends an asynchronous request to the domain manager. The request only completes when a wake-up event occurs triggering the system back into the Active state.

  • it calls RequestDomainTransition() to trigger a transition of the specified domain to the specified target power state. The target power state can be Active, Standby or Off. The implementation sends an asynchronous request to the domain manager. The request completes when the domain reaches the target state.