# fuchsia.power.profile

<br />

Added: 7

## **PROTOCOLS**

## Watcher

*Defined in [fuchsia.power.profile/profile.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.power.profile/profile.fidl;l=26)*

Protocol for observing changes to the system power profile.

<br />

### Watch

Watches for changes to the system power profile.

On a given connection, the first call will return immediately with the current system power
profile, while subsequent calls will only return a new `profile` as the system power profile
changes. This follows the
[hanging get](https://fuchsia.dev/fuchsia-src/concepts/api/fidl#hanging-get) pattern. Any
errors are considered fatal and will result in the channel being closed.

#### Request

\<EMPTY\>

#### Response

| Name | Type |
|---|---|
| `profile` | `https://fuchsia.dev/reference/fidl/fuchsia.power.profile#Profile` |

## **ENUMS**

### Profile [strict](https://fuchsia.dev/fuchsia-src/reference/fidl/language/language#strict-vs-flexible)

Type: `uint32`

*Defined in [fuchsia.power.profile/profile.fidl](https://cs.opensource.google/fuchsia/fuchsia/+/main:sdk/fidl/fuchsia.power.profile/profile.fidl;l=9)*

System power profiles that may be returned by \[Watcher.Watch\].

<br />

| Name | Value | Description |
|---|---|---|
| ### IDLE | `1` | There is no active work in the system. On a system that supports it, the device may be put into a lower-power or suspended state at any time. |
| ### BACKGROUND_ACTIVE | `2` | Some background activity is occurring that should prevent the system from dropping into a non-running or suspended state (example: downloading an OTA, performing a backup, or CPU-based hotword monitoring). |
| ### USER_ACTIVE | `3` | The device is providing some user-visible experience such as running an app in the foreground or streaming audio, or has recently received interaction from a user. |