Power Domain Protocol

Power domain state management via SCMI. More...

Files
file	power.h
	Header file for the SCMI Power Domain Protocol.

Data Structures
struct	scmi_power_state_config
	Describes the parameters for the POWER_STATE_SET command. More...

Macros
#define	SCMI_POWER_STATE_SET_FLAGS_ASYNC   BIT(0)
#define	SCMI_POWER_DOMAIN_PROTOCOL_SUPPORTED_VERSION   0x30001

Enumerations
enum	scmi_power_domain_message {   SCMI_POWER_DOMAIN_MSG_PROTOCOL_VERSION = 0x0 , SCMI_POWER_DOMAIN_MSG_PROTOCOL_ATTRIBUTES = 0x1 , SCMI_POWER_DOMAIN_MSG_PROTOCOL_MESSAGE_ATTRIBUTES = 0x2 , SCMI_POWER_DOMAIN_MSG_POWER_DOMAIN_ATTRIBUTES = 0x3 ,   SCMI_POWER_DOMAIN_MSG_POWER_STATE_SET = 0x4 , SCMI_POWER_DOMAIN_MSG_POWER_STATE_GET = 0x5 , SCMI_POWER_DOMAIN_MSG_POWER_STATE_NOTIFY = 0x6 , SCMI_POWER_DOMAIN_MSG_POWER_STATE_CHANGE_REQEUSTED_NOTIFY = 0x7 ,   SCMI_POWER_DOMAIN_MSG_POWER_DOMAIN_NAME_GET = 0x8 , SCMI_POWER_DOMAIN_MSG_NEGOTIATE_PROTOCOL_VERSION = 0x10 }
	Power domain protocol command message IDs. More...

Functions
int	scmi_power_state_set (struct scmi_power_state_config *cfg)
	Send the POWER_STATE_SET command and get its reply.
int	scmi_power_state_get (uint32_t domain_id, uint32_t *power_state)
	Query the power domain state.

SCMI power domain state parameters
#define	SCMI_POWER_STATE_TYPE_SHIFT   30U
	Power state type field bit shift.
#define	SCMI_POWER_STATE_ID_MASK   (BIT(28) - 1)
	Power state ID field mask.
#define	SCMI_POWER_STATE_PARAM(type, id)
	Construct SCMI power state parameter.

SCMI power domain generic states
#define	SCMI_POWER_STATE_GENERIC_ON   SCMI_POWER_STATE_PARAM(0, 0)
	Power domain is in ON state.
#define	SCMI_POWER_STATE_GENERIC_OFF   SCMI_POWER_STATE_PARAM(1, 0)
	Power domain is in OFF state.

Detailed Description

Power domain state management via SCMI.

Macro Definition Documentation

SCMI_POWER_DOMAIN_PROTOCOL_SUPPORTED_VERSION

#define SCMI_POWER_DOMAIN_PROTOCOL_SUPPORTED_VERSION   0x30001

#include <zephyr/drivers/firmware/scmi/power.h>

SCMI_POWER_STATE_GENERIC_OFF

#define SCMI_POWER_STATE_GENERIC_OFF   SCMI_POWER_STATE_PARAM(1, 0)

#include <zephyr/drivers/firmware/scmi/power.h>

Power domain is in OFF state.

SCMI_POWER_STATE_GENERIC_ON

#define SCMI_POWER_STATE_GENERIC_ON   SCMI_POWER_STATE_PARAM(0, 0)

#include <zephyr/drivers/firmware/scmi/power.h>

Power domain is in ON state.

SCMI_POWER_STATE_ID_MASK

#define SCMI_POWER_STATE_ID_MASK   (BIT(28) - 1)

#include <zephyr/drivers/firmware/scmi/power.h>

Power state ID field mask.

SCMI_POWER_STATE_PARAM

#define SCMI_POWER_STATE_PARAM	(		type,
			id )

#include <zephyr/drivers/firmware/scmi/power.h>

Value:

        ((((type) & BIT(0)) << SCMI_POWER_STATE_TYPE_SHIFT) | \
         ((id) & SCMI_POWER_STATE_ID_MASK))

Construct SCMI power state parameter.

Parameters

type	Power state type
id	Power state ID

SCMI_POWER_STATE_SET_FLAGS_ASYNC

#define SCMI_POWER_STATE_SET_FLAGS_ASYNC   BIT(0)

#include <zephyr/drivers/firmware/scmi/power.h>

SCMI_POWER_STATE_TYPE_SHIFT

#define SCMI_POWER_STATE_TYPE_SHIFT   30U

#include <zephyr/drivers/firmware/scmi/power.h>

Power state type field bit shift.

Enumeration Type Documentation

scmi_power_domain_message

enum scmi_power_domain_message

#include <zephyr/drivers/firmware/scmi/power.h>

Power domain protocol command message IDs.

Enumerator
SCMI_POWER_DOMAIN_MSG_PROTOCOL_VERSION
SCMI_POWER_DOMAIN_MSG_PROTOCOL_ATTRIBUTES
SCMI_POWER_DOMAIN_MSG_PROTOCOL_MESSAGE_ATTRIBUTES
SCMI_POWER_DOMAIN_MSG_POWER_DOMAIN_ATTRIBUTES
SCMI_POWER_DOMAIN_MSG_POWER_STATE_SET
SCMI_POWER_DOMAIN_MSG_POWER_STATE_GET
SCMI_POWER_DOMAIN_MSG_POWER_STATE_NOTIFY
SCMI_POWER_DOMAIN_MSG_POWER_STATE_CHANGE_REQEUSTED_NOTIFY
SCMI_POWER_DOMAIN_MSG_POWER_DOMAIN_NAME_GET
SCMI_POWER_DOMAIN_MSG_NEGOTIATE_PROTOCOL_VERSION

Function Documentation

scmi_power_state_get()

int scmi_power_state_get	(	uint32_t	domain_id,
		uint32_t *	power_state )

#include <zephyr/drivers/firmware/scmi/power.h>

Query the power domain state.

Parameters

domain_id	ID of the power domain for which the query is done
power_state	pointer to be set via this command

Return values

0	if successful
negative	errno if failure

scmi_power_state_set()

int scmi_power_state_set

(

struct scmi_power_state_config *

cfg

)

#include <zephyr/drivers/firmware/scmi/power.h>

Send the POWER_STATE_SET command and get its reply.

Parameters

cfg	pointer to structure containing configuration to be set

Return values

0	if successful
negative	errno if failure