1 /* 2 * Copyright (c) 2017-2021, ARM Limited and Contributors. All rights reserved. 3 * 4 * SPDX-License-Identifier: BSD-3-Clause 5 */ 6 7 #ifndef SCMI_H 8 #define SCMI_H 9 10 #include <stddef.h> 11 #include <stdint.h> 12 13 #include <lib/bakery_lock.h> 14 #include <lib/psci/psci.h> 15 #include <lib/spinlock.h> 16 17 /* Supported SCMI Protocol Versions */ 18 #define SCMI_AP_CORE_PROTO_VER MAKE_SCMI_VERSION(1, 0) 19 #define SCMI_PWR_DMN_PROTO_VER MAKE_SCMI_VERSION(2, 0) 20 #define SCMI_SYS_PWR_PROTO_VER MAKE_SCMI_VERSION(1, 0) 21 22 #define GET_SCMI_MAJOR_VER(ver) (((ver) >> 16) & 0xffff) 23 #define GET_SCMI_MINOR_VER(ver) ((ver) & 0xffff) 24 25 #define MAKE_SCMI_VERSION(maj, min) \ 26 ((((maj) & 0xffff) << 16) | ((min) & 0xffff)) 27 28 /* Macro to check if the driver is compatible with the SCMI version reported */ 29 #define is_scmi_version_compatible(drv, scmi) \ 30 ((GET_SCMI_MAJOR_VER(drv) == GET_SCMI_MAJOR_VER(scmi)) && \ 31 (GET_SCMI_MINOR_VER(drv) <= GET_SCMI_MINOR_VER(scmi))) 32 33 /* SCMI Protocol identifiers */ 34 #define SCMI_PWR_DMN_PROTO_ID 0x11 35 #define SCMI_SYS_PWR_PROTO_ID 0x12 36 /* The AP core protocol is a CSS platform-specific extension */ 37 #define SCMI_AP_CORE_PROTO_ID 0x90 38 39 /* Mandatory messages IDs for all SCMI protocols */ 40 #define SCMI_PROTO_VERSION_MSG 0x0 41 #define SCMI_PROTO_ATTR_MSG 0x1 42 #define SCMI_PROTO_MSG_ATTR_MSG 0x2 43 44 /* SCMI power domain management protocol message IDs */ 45 #define SCMI_PWR_STATE_SET_MSG 0x4 46 #define SCMI_PWR_STATE_GET_MSG 0x5 47 48 /* SCMI system power management protocol message IDs */ 49 #define SCMI_SYS_PWR_STATE_SET_MSG 0x3 50 #define SCMI_SYS_PWR_STATE_GET_MSG 0x4 51 52 /* SCMI AP core protocol message IDs */ 53 #define SCMI_AP_CORE_RESET_ADDR_SET_MSG 0x3 54 #define SCMI_AP_CORE_RESET_ADDR_GET_MSG 0x4 55 56 /* Helper macros for system power management protocol commands */ 57 58 /* 59 * Macros to describe the bit-fields of the `attribute` of system power domain 60 * protocol PROTOCOL_MSG_ATTRIBUTE message. 61 */ 62 #define SYS_PWR_ATTR_WARM_RESET_SHIFT 31 63 #define SCMI_SYS_PWR_WARM_RESET_SUPPORTED (1U << SYS_PWR_ATTR_WARM_RESET_SHIFT) 64 65 #define SYS_PWR_ATTR_SUSPEND_SHIFT 30 66 #define SCMI_SYS_PWR_SUSPEND_SUPPORTED (1 << SYS_PWR_ATTR_SUSPEND_SHIFT) 67 68 /* 69 * Macros to describe the bit-fields of the `flags` parameter of system power 70 * domain protocol SYSTEM_POWER_STATE_SET message. 71 */ 72 #define SYS_PWR_SET_GRACEFUL_REQ_SHIFT 0 73 #define SCMI_SYS_PWR_GRACEFUL_REQ (1 << SYS_PWR_SET_GRACEFUL_REQ_SHIFT) 74 #define SCMI_SYS_PWR_FORCEFUL_REQ (0 << SYS_PWR_SET_GRACEFUL_REQ_SHIFT) 75 76 /* 77 * Macros to describe the `system_state` parameter of system power 78 * domain protocol SYSTEM_POWER_STATE_SET message. 79 */ 80 #define SCMI_SYS_PWR_SHUTDOWN 0x0 81 #define SCMI_SYS_PWR_COLD_RESET 0x1 82 #define SCMI_SYS_PWR_WARM_RESET 0x2 83 #define SCMI_SYS_PWR_POWER_UP 0x3 84 #define SCMI_SYS_PWR_SUSPEND 0x4 85 86 /* 87 * Macros to describe the bit-fields of the `attribute` of AP core protocol 88 * AP_CORE_RESET_ADDR set/get messages. 89 */ 90 #define SCMI_AP_CORE_LOCK_ATTR_SHIFT 0x0 91 #define SCMI_AP_CORE_LOCK_ATTR (1U << SCMI_AP_CORE_LOCK_ATTR_SHIFT) 92 93 /* SCMI Error code definitions */ 94 #define SCMI_E_QUEUED 1 95 #define SCMI_E_SUCCESS 0 96 #define SCMI_E_NOT_SUPPORTED -1 97 #define SCMI_E_INVALID_PARAM -2 98 #define SCMI_E_DENIED -3 99 #define SCMI_E_NOT_FOUND -4 100 #define SCMI_E_OUT_OF_RANGE -5 101 #define SCMI_E_BUSY -6 102 103 /* 104 * SCMI driver platform information. The details of the doorbell mechanism 105 * can be found in the SCMI specification. 106 */ 107 typedef struct scmi_channel_plat_info { 108 /* SCMI mailbox memory */ 109 uintptr_t scmi_mbx_mem; 110 /* The door bell register address */ 111 uintptr_t db_reg_addr; 112 /* The bit mask that need to be preserved when ringing doorbell */ 113 uint32_t db_preserve_mask; 114 /* The bit mask that need to be set to ring doorbell */ 115 uint32_t db_modify_mask; 116 /* The handler for ringing doorbell */ 117 void (*ring_doorbell)(struct scmi_channel_plat_info *plat_info); 118 /* cookie is unused now. But added for future enhancements. */ 119 void *cookie; 120 } scmi_channel_plat_info_t; 121 122 123 #if HW_ASSISTED_COHERENCY 124 typedef spinlock_t scmi_lock_t; 125 #else 126 typedef bakery_lock_t scmi_lock_t; 127 #endif 128 129 /* 130 * Structure to represent an SCMI channel. 131 */ 132 typedef struct scmi_channel { 133 scmi_channel_plat_info_t *info; 134 /* The lock for channel access */ 135 scmi_lock_t *lock; 136 /* Indicate whether the channel is initialized */ 137 int is_initialized; 138 } scmi_channel_t; 139 140 /* External Common API */ 141 void *scmi_init(scmi_channel_t *ch); 142 int scmi_proto_msg_attr(void *p, uint32_t proto_id, uint32_t command_id, 143 uint32_t *attr); 144 int scmi_proto_version(void *p, uint32_t proto_id, uint32_t *version); 145 146 /* 147 * Power domain protocol commands. Refer to the SCMI specification for more 148 * details on these commands. 149 */ 150 int scmi_pwr_state_set(void *p, uint32_t domain_id, uint32_t scmi_pwr_state); 151 int scmi_pwr_state_get(void *p, uint32_t domain_id, uint32_t *scmi_pwr_state); 152 153 /* 154 * System power management protocol commands. Refer SCMI specification for more 155 * details on these commands. 156 */ 157 int scmi_sys_pwr_state_set(void *p, uint32_t flags, uint32_t system_state); 158 int scmi_sys_pwr_state_get(void *p, uint32_t *system_state); 159 160 /* SCMI AP core configuration protocol commands. */ 161 int scmi_ap_core_set_reset_addr(void *p, uint64_t reset_addr, uint32_t attr); 162 int scmi_ap_core_get_reset_addr(void *p, uint64_t *reset_addr, uint32_t *attr); 163 164 /* API to get the platform specific SCMI channel information. */ 165 scmi_channel_plat_info_t *plat_css_get_scmi_info(int channel_id); 166 167 /* API to override default PSCI callbacks for platforms that support SCMI. */ 168 const plat_psci_ops_t *css_scmi_override_pm_ops(plat_psci_ops_t *ops); 169 170 #endif /* SCMI_H */ 171