1 // SPDX-License-Identifier: GPL-2.0 2 /* 3 * SCMI Message Protocol driver header 4 * 5 * Copyright (C) 2018 ARM Ltd. 6 */ 7 #include <linux/device.h> 8 #include <linux/types.h> 9 10 #define SCMI_MAX_STR_SIZE 16 11 #define SCMI_MAX_NUM_RATES 16 12 13 /** 14 * struct scmi_revision_info - version information structure 15 * 16 * @major_ver: Major ABI version. Change here implies risk of backward 17 * compatibility break. 18 * @minor_ver: Minor ABI version. Change here implies new feature addition, 19 * or compatible change in ABI. 20 * @num_protocols: Number of protocols that are implemented, excluding the 21 * base protocol. 22 * @num_agents: Number of agents in the system. 23 * @impl_ver: A vendor-specific implementation version. 24 * @vendor_id: A vendor identifier(Null terminated ASCII string) 25 * @sub_vendor_id: A sub-vendor identifier(Null terminated ASCII string) 26 */ 27 struct scmi_revision_info { 28 u16 major_ver; 29 u16 minor_ver; 30 u8 num_protocols; 31 u8 num_agents; 32 u32 impl_ver; 33 char vendor_id[SCMI_MAX_STR_SIZE]; 34 char sub_vendor_id[SCMI_MAX_STR_SIZE]; 35 }; 36 37 struct scmi_clock_info { 38 char name[SCMI_MAX_STR_SIZE]; 39 bool rate_discrete; 40 union { 41 struct { 42 int num_rates; 43 u64 rates[SCMI_MAX_NUM_RATES]; 44 } list; 45 struct { 46 u64 min_rate; 47 u64 max_rate; 48 u64 step_size; 49 } range; 50 }; 51 }; 52 53 struct scmi_handle; 54 55 /** 56 * struct scmi_clk_ops - represents the various operations provided 57 * by SCMI Clock Protocol 58 * 59 * @count_get: get the count of clocks provided by SCMI 60 * @info_get: get the information of the specified clock 61 * @rate_get: request the current clock rate of a clock 62 * @rate_set: set the clock rate of a clock 63 * @enable: enables the specified clock 64 * @disable: disables the specified clock 65 */ 66 struct scmi_clk_ops { 67 int (*count_get)(const struct scmi_handle *handle); 68 69 const struct scmi_clock_info *(*info_get) 70 (const struct scmi_handle *handle, u32 clk_id); 71 int (*rate_get)(const struct scmi_handle *handle, u32 clk_id, 72 u64 *rate); 73 int (*rate_set)(const struct scmi_handle *handle, u32 clk_id, 74 u32 config, u64 rate); 75 int (*enable)(const struct scmi_handle *handle, u32 clk_id); 76 int (*disable)(const struct scmi_handle *handle, u32 clk_id); 77 }; 78 79 /** 80 * struct scmi_perf_ops - represents the various operations provided 81 * by SCMI Performance Protocol 82 * 83 * @limits_set: sets limits on the performance level of a domain 84 * @limits_get: gets limits on the performance level of a domain 85 * @level_set: sets the performance level of a domain 86 * @level_get: gets the performance level of a domain 87 * @device_domain_id: gets the scmi domain id for a given device 88 * @transition_latency_get: gets the DVFS transition latency for a given device 89 * @device_opps_add: adds all the OPPs for a given device 90 * @freq_set: sets the frequency for a given device using sustained frequency 91 * to sustained performance level mapping 92 * @freq_get: gets the frequency for a given device using sustained frequency 93 * to sustained performance level mapping 94 * @est_power_get: gets the estimated power cost for a given performance domain 95 * at a given frequency 96 */ 97 struct scmi_perf_ops { 98 int (*limits_set)(const struct scmi_handle *handle, u32 domain, 99 u32 max_perf, u32 min_perf); 100 int (*limits_get)(const struct scmi_handle *handle, u32 domain, 101 u32 *max_perf, u32 *min_perf); 102 int (*level_set)(const struct scmi_handle *handle, u32 domain, 103 u32 level, bool poll); 104 int (*level_get)(const struct scmi_handle *handle, u32 domain, 105 u32 *level, bool poll); 106 int (*device_domain_id)(struct device *dev); 107 int (*transition_latency_get)(const struct scmi_handle *handle, 108 struct device *dev); 109 int (*device_opps_add)(const struct scmi_handle *handle, 110 struct device *dev); 111 int (*freq_set)(const struct scmi_handle *handle, u32 domain, 112 unsigned long rate, bool poll); 113 int (*freq_get)(const struct scmi_handle *handle, u32 domain, 114 unsigned long *rate, bool poll); 115 int (*est_power_get)(const struct scmi_handle *handle, u32 domain, 116 unsigned long *rate, unsigned long *power); 117 }; 118 119 /** 120 * struct scmi_power_ops - represents the various operations provided 121 * by SCMI Power Protocol 122 * 123 * @num_domains_get: get the count of power domains provided by SCMI 124 * @name_get: gets the name of a power domain 125 * @state_set: sets the power state of a power domain 126 * @state_get: gets the power state of a power domain 127 */ 128 struct scmi_power_ops { 129 int (*num_domains_get)(const struct scmi_handle *handle); 130 char *(*name_get)(const struct scmi_handle *handle, u32 domain); 131 #define SCMI_POWER_STATE_TYPE_SHIFT 30 132 #define SCMI_POWER_STATE_ID_MASK (BIT(28) - 1) 133 #define SCMI_POWER_STATE_PARAM(type, id) \ 134 ((((type) & BIT(0)) << SCMI_POWER_STATE_TYPE_SHIFT) | \ 135 ((id) & SCMI_POWER_STATE_ID_MASK)) 136 #define SCMI_POWER_STATE_GENERIC_ON SCMI_POWER_STATE_PARAM(0, 0) 137 #define SCMI_POWER_STATE_GENERIC_OFF SCMI_POWER_STATE_PARAM(1, 0) 138 int (*state_set)(const struct scmi_handle *handle, u32 domain, 139 u32 state); 140 int (*state_get)(const struct scmi_handle *handle, u32 domain, 141 u32 *state); 142 }; 143 144 struct scmi_sensor_info { 145 u32 id; 146 u8 type; 147 char name[SCMI_MAX_STR_SIZE]; 148 }; 149 150 /* 151 * Partial list from Distributed Management Task Force (DMTF) specification: 152 * DSP0249 (Platform Level Data Model specification) 153 */ 154 enum scmi_sensor_class { 155 NONE = 0x0, 156 TEMPERATURE_C = 0x2, 157 VOLTAGE = 0x5, 158 CURRENT = 0x6, 159 POWER = 0x7, 160 ENERGY = 0x8, 161 }; 162 163 /** 164 * struct scmi_sensor_ops - represents the various operations provided 165 * by SCMI Sensor Protocol 166 * 167 * @count_get: get the count of sensors provided by SCMI 168 * @info_get: get the information of the specified sensor 169 * @configuration_set: control notifications on cross-over events for 170 * the trip-points 171 * @trip_point_set: selects and configures a trip-point of interest 172 * @reading_get: gets the current value of the sensor 173 */ 174 struct scmi_sensor_ops { 175 int (*count_get)(const struct scmi_handle *handle); 176 177 const struct scmi_sensor_info *(*info_get) 178 (const struct scmi_handle *handle, u32 sensor_id); 179 int (*configuration_set)(const struct scmi_handle *handle, 180 u32 sensor_id); 181 int (*trip_point_set)(const struct scmi_handle *handle, u32 sensor_id, 182 u8 trip_id, u64 trip_value); 183 int (*reading_get)(const struct scmi_handle *handle, u32 sensor_id, 184 bool async, u64 *value); 185 }; 186 187 /** 188 * struct scmi_handle - Handle returned to ARM SCMI clients for usage. 189 * 190 * @dev: pointer to the SCMI device 191 * @version: pointer to the structure containing SCMI version information 192 * @power_ops: pointer to set of power protocol operations 193 * @perf_ops: pointer to set of performance protocol operations 194 * @clk_ops: pointer to set of clock protocol operations 195 * @sensor_ops: pointer to set of sensor protocol operations 196 * @perf_priv: pointer to private data structure specific to performance 197 * protocol(for internal use only) 198 * @clk_priv: pointer to private data structure specific to clock 199 * protocol(for internal use only) 200 * @power_priv: pointer to private data structure specific to power 201 * protocol(for internal use only) 202 * @sensor_priv: pointer to private data structure specific to sensors 203 * protocol(for internal use only) 204 */ 205 struct scmi_handle { 206 struct device *dev; 207 struct scmi_revision_info *version; 208 struct scmi_perf_ops *perf_ops; 209 struct scmi_clk_ops *clk_ops; 210 struct scmi_power_ops *power_ops; 211 struct scmi_sensor_ops *sensor_ops; 212 /* for protocol internal use */ 213 void *perf_priv; 214 void *clk_priv; 215 void *power_priv; 216 void *sensor_priv; 217 }; 218 219 enum scmi_std_protocol { 220 SCMI_PROTOCOL_BASE = 0x10, 221 SCMI_PROTOCOL_POWER = 0x11, 222 SCMI_PROTOCOL_SYSTEM = 0x12, 223 SCMI_PROTOCOL_PERF = 0x13, 224 SCMI_PROTOCOL_CLOCK = 0x14, 225 SCMI_PROTOCOL_SENSOR = 0x15, 226 }; 227 228 struct scmi_device { 229 u32 id; 230 u8 protocol_id; 231 struct device dev; 232 struct scmi_handle *handle; 233 }; 234 235 #define to_scmi_dev(d) container_of(d, struct scmi_device, dev) 236 237 struct scmi_device * 238 scmi_device_create(struct device_node *np, struct device *parent, int protocol); 239 void scmi_device_destroy(struct scmi_device *scmi_dev); 240 241 struct scmi_device_id { 242 u8 protocol_id; 243 }; 244 245 struct scmi_driver { 246 const char *name; 247 int (*probe)(struct scmi_device *sdev); 248 void (*remove)(struct scmi_device *sdev); 249 const struct scmi_device_id *id_table; 250 251 struct device_driver driver; 252 }; 253 254 #define to_scmi_driver(d) container_of(d, struct scmi_driver, driver) 255 256 #ifdef CONFIG_ARM_SCMI_PROTOCOL 257 int scmi_driver_register(struct scmi_driver *driver, 258 struct module *owner, const char *mod_name); 259 void scmi_driver_unregister(struct scmi_driver *driver); 260 #else 261 static inline int 262 scmi_driver_register(struct scmi_driver *driver, struct module *owner, 263 const char *mod_name) 264 { 265 return -EINVAL; 266 } 267 268 static inline void scmi_driver_unregister(struct scmi_driver *driver) {} 269 #endif /* CONFIG_ARM_SCMI_PROTOCOL */ 270 271 #define scmi_register(driver) \ 272 scmi_driver_register(driver, THIS_MODULE, KBUILD_MODNAME) 273 #define scmi_unregister(driver) \ 274 scmi_driver_unregister(driver) 275 276 /** 277 * module_scmi_driver() - Helper macro for registering a scmi driver 278 * @__scmi_driver: scmi_driver structure 279 * 280 * Helper macro for scmi drivers to set up proper module init / exit 281 * functions. Replaces module_init() and module_exit() and keeps people from 282 * printing pointless things to the kernel log when their driver is loaded. 283 */ 284 #define module_scmi_driver(__scmi_driver) \ 285 module_driver(__scmi_driver, scmi_register, scmi_unregister) 286 287 typedef int (*scmi_prot_init_fn_t)(struct scmi_handle *); 288 int scmi_protocol_register(int protocol_id, scmi_prot_init_fn_t fn); 289 void scmi_protocol_unregister(int protocol_id); 290