include/drivers/scmi-msg.h - filogic/atf - Gitiles

 /* 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 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.
  * 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);

 /*
  * 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 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);

 /* 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 */
	/* 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 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.
	* 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);

	/*
	* 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 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);

	/* 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 */