684952d172
Add base support for discovering and changing parent clocks This is the part of SCMI platform design document version 3.2, which introduces SCMI clock protocol version 3.0 Add mandatory support for CLOCK_CONFIG_GET which is needed for SCMI clock protocol version 3.0 Also, add support for clock_enable_delay parameter which got introduced as new parameter in return values for command CLOCK_ATTRIBUTES in same SCMI Platform design document v3.2 Change-Id: Ie5cba83dad27bf1e3b51c11c0218259a44c1af59 Signed-off-by: Kamlesh Gurudasani <kamlesh@ti.com>
280 lines
8.4 KiB
C
280 lines
8.4 KiB
C
/* SPDX-License-Identifier: BSD-3-Clause */
|
|
/*
|
|
* Copyright (c) 2015-2019, Arm Limited and Contributors. All rights reserved.
|
|
* Copyright (c) 2019, Linaro Limited
|
|
*/
|
|
|
|
#ifndef SCMI_MSG_H
|
|
#define SCMI_MSG_H
|
|
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
/* Minimum size expected for SMT based shared memory message buffers */
|
|
#define SMT_BUF_SLOT_SIZE 128U
|
|
|
|
/* A channel abstract a communication path between agent and server */
|
|
struct scmi_msg_channel;
|
|
|
|
/*
|
|
* struct scmi_msg_channel - Shared memory buffer for a agent-to-server channel
|
|
*
|
|
* @shm_addr: Address of the shared memory for the SCMI channel
|
|
* @shm_size: Byte size of the shared memory for the SCMI channel
|
|
* @busy: True when channel is busy, false when channel is free
|
|
* @agent_name: Agent name, SCMI protocol exposes 16 bytes max, or NULL
|
|
*/
|
|
struct scmi_msg_channel {
|
|
uintptr_t shm_addr;
|
|
size_t shm_size;
|
|
bool busy;
|
|
const char *agent_name;
|
|
};
|
|
|
|
/*
|
|
* Initialize SMT memory buffer, called by platform at init for each
|
|
* agent channel using the SMT header format.
|
|
*
|
|
* @chan: Pointer to the channel shared memory to be initialized
|
|
*/
|
|
void scmi_smt_init_agent_channel(struct scmi_msg_channel *chan);
|
|
|
|
/*
|
|
* Process SMT formatted message in a fastcall SMC execution context.
|
|
* Called by platform on SMC entry. When returning, output message is
|
|
* available in shared memory for agent to read the response.
|
|
*
|
|
* @agent_id: SCMI agent ID the SMT belongs to
|
|
*/
|
|
void scmi_smt_fastcall_smc_entry(unsigned int agent_id);
|
|
|
|
/*
|
|
* Process SMT formatted message in a secure interrupt execution context.
|
|
* Called by platform interrupt handler. When returning, output message is
|
|
* available in shared memory for agent to read the response.
|
|
*
|
|
* @agent_id: SCMI agent ID the SMT belongs to
|
|
*/
|
|
void scmi_smt_interrupt_entry(unsigned int agent_id);
|
|
|
|
/* Platform callback functions */
|
|
|
|
/*
|
|
* Return the SCMI channel related to an agent
|
|
* @agent_id: SCMI agent ID
|
|
* Return a pointer to channel on success, NULL otherwise
|
|
*/
|
|
struct scmi_msg_channel *plat_scmi_get_channel(unsigned int agent_id);
|
|
|
|
/*
|
|
* Return how many SCMI protocols supported by the platform
|
|
* According to the SCMI specification, this function does not target
|
|
* a specific agent ID and shall return all platform known capabilities.
|
|
*/
|
|
size_t plat_scmi_protocol_count(void);
|
|
|
|
/*
|
|
* Get the count and list of SCMI protocols (but base) supported for an agent
|
|
*
|
|
* @agent_id: SCMI agent ID
|
|
* Return a pointer to a null terminated array supported protocol IDs.
|
|
*/
|
|
const uint8_t *plat_scmi_protocol_list(unsigned int agent_id);
|
|
|
|
/* Get the name of the SCMI vendor for the platform */
|
|
const char *plat_scmi_vendor_name(void);
|
|
|
|
/* Get the name of the SCMI sub-vendor for the platform */
|
|
const char *plat_scmi_sub_vendor_name(void);
|
|
|
|
/* Handlers for SCMI Clock protocol services */
|
|
|
|
/*
|
|
* Return number of clock controllers for an agent
|
|
* @agent_id: SCMI agent ID
|
|
* Return number of clock controllers
|
|
*/
|
|
size_t plat_scmi_clock_count(unsigned int agent_id);
|
|
|
|
/*
|
|
* Get clock controller string ID (aka name)
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* Return pointer to name or NULL
|
|
*/
|
|
const char *plat_scmi_clock_get_name(unsigned int agent_id,
|
|
unsigned int scmi_id);
|
|
|
|
/*
|
|
* Get clock enable delay in microseconds
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* Return delay or zero if not supported
|
|
*/
|
|
uint32_t plat_scmi_clock_get_enable_delay(unsigned int agent_id,
|
|
unsigned int scmi_id);
|
|
|
|
/*
|
|
* Get clock possible rate as an array of frequencies in Hertz.
|
|
*
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* @rates: If NULL, function returns, else output rates array
|
|
* @nb_elts: Array size of @rates.
|
|
* @start_idx: Start index of rates array
|
|
* Return an SCMI compliant error code
|
|
*/
|
|
int32_t plat_scmi_clock_rates_array(unsigned int agent_id, unsigned int scmi_id,
|
|
unsigned long *rates, size_t *nb_elts,
|
|
uint32_t start_idx);
|
|
|
|
/*
|
|
* Get clock possible rate as range with regular steps in Hertz
|
|
*
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* @min_max_step: 3 cell array for min, max and step rate data
|
|
* Return an SCMI compliant error code
|
|
*/
|
|
int32_t plat_scmi_clock_rates_by_step(unsigned int agent_id,
|
|
unsigned int scmi_id,
|
|
unsigned long *min_max_step);
|
|
/*
|
|
* Get clock possible parents as an array of parent ids
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* @plat_possible_parents: If NULL, function returns,
|
|
* else output possible parents array
|
|
* @nb_elts: Array size of @plat_possible_parents
|
|
* @skip_parents: Number of parents to skip for 2nd iteration onwards
|
|
* Return an SCMI compliant error code
|
|
*/
|
|
int32_t plat_scmi_clock_get_possible_parents(unsigned int agent_id,
|
|
unsigned int scmi_id,
|
|
unsigned int *plat_possible_parents,
|
|
size_t *nb_elts,
|
|
unsigned int skip_parents);
|
|
/*
|
|
* Get clock parent
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* @parent_id: Target parent id
|
|
* Return a compliant SCMI error code
|
|
*/
|
|
int32_t plat_scmi_clock_get_parent(unsigned int agent_id,
|
|
unsigned int scmi_id,
|
|
unsigned int *parent_id);
|
|
/*
|
|
* Set clock parent
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* @parent_id: Target parent id
|
|
* Return a compliant SCMI error code
|
|
*/
|
|
int32_t plat_scmi_clock_set_parent(unsigned int agent_id,
|
|
unsigned int scmi_id,
|
|
unsigned int parent_id);
|
|
|
|
/*
|
|
* Get clock rate in Hertz
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* Return clock rate or 0 if not supported
|
|
*/
|
|
unsigned long plat_scmi_clock_get_rate(unsigned int agent_id,
|
|
unsigned int scmi_id);
|
|
|
|
/*
|
|
* Set clock rate in Hertz
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* @rate: Target clock frequency in Hertz
|
|
* Return a compliant SCMI error code
|
|
*/
|
|
int32_t plat_scmi_clock_set_rate(unsigned int agent_id, unsigned int scmi_id,
|
|
unsigned long rate);
|
|
|
|
/*
|
|
* Get clock state (enabled or disabled)
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* Return 1 if clock is enabled, 0 if disables, or a negative SCMI error code
|
|
*/
|
|
int32_t plat_scmi_clock_get_state(unsigned int agent_id, unsigned int scmi_id);
|
|
|
|
/*
|
|
* Get clock state (enabled or disabled)
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* @enable_not_disable: Enable clock if true, disable clock otherwise
|
|
* Return a compliant SCMI error code
|
|
*/
|
|
int32_t plat_scmi_clock_set_state(unsigned int agent_id, unsigned int scmi_id,
|
|
bool enable_not_disable);
|
|
|
|
/*
|
|
* Get clock extended config
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* @extended_config_type: Type of Extended config value
|
|
* @extended_config_val: Value corresponding to extended configuration type
|
|
* Return a compliant SCMI error code
|
|
*/
|
|
int32_t plat_scmi_clock_get_extended_config(unsigned int agent_id,
|
|
unsigned int scmi_id,
|
|
unsigned char extended_config_type,
|
|
unsigned int *extended_config_val);
|
|
|
|
/*
|
|
* Set clock extended config
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI clock ID
|
|
* @extended_config_type: Type of Extended config value
|
|
* @extended_config_val: Value corresponding to extended configuration type
|
|
* Return a compliant SCMI error code
|
|
*/
|
|
int32_t plat_scmi_clock_set_extended_config(unsigned int agent_id,
|
|
unsigned int scmi_id,
|
|
unsigned char extended_config_type,
|
|
unsigned int extended_config_val);
|
|
|
|
/* Handlers for SCMI Reset Domain protocol services */
|
|
|
|
/*
|
|
* Return number of reset domains for the agent
|
|
* @agent_id: SCMI agent ID
|
|
* Return number of reset domains
|
|
*/
|
|
size_t plat_scmi_rstd_count(unsigned int agent_id);
|
|
|
|
/*
|
|
* Get reset domain string ID (aka name)
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI reset domain ID
|
|
* Return pointer to name or NULL
|
|
*/
|
|
const char *plat_scmi_rstd_get_name(unsigned int agent_id, unsigned int scmi_id);
|
|
|
|
/*
|
|
* Perform a reset cycle on a target reset domain
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI reset domain ID
|
|
* @state: Target reset state (see SCMI specification, 0 means context loss)
|
|
* Return a compliant SCMI error code
|
|
*/
|
|
int32_t plat_scmi_rstd_autonomous(unsigned int agent_id, unsigned int scmi_id,
|
|
unsigned int state);
|
|
|
|
/*
|
|
* Assert or deassert target reset domain
|
|
* @agent_id: SCMI agent ID
|
|
* @scmi_id: SCMI reset domain ID
|
|
* @assert_not_deassert: Assert domain if true, otherwise deassert domain
|
|
* Return a compliant SCMI error code
|
|
*/
|
|
int32_t plat_scmi_rstd_set_state(unsigned int agent_id, unsigned int scmi_id,
|
|
bool assert_not_deassert);
|
|
|
|
#endif /* SCMI_MSG_H */
|