1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * SCPI Message Protocol driver header 4 * 5 * Copyright (C) 2014 ARM Ltd. 6 */ 7 8 #ifndef _LINUX_SCPI_PROTOCOL_H 9 #define _LINUX_SCPI_PROTOCOL_H 10 11 #include <linux/types.h> 12 13 struct scpi_opp { 14 u32 freq; 15 u32 m_volt; 16 } __packed; 17 18 struct scpi_dvfs_info { 19 unsigned int count; 20 unsigned int latency; /* in nanoseconds */ 21 struct scpi_opp *opps; 22 }; 23 24 enum scpi_sensor_class { 25 TEMPERATURE, 26 VOLTAGE, 27 CURRENT, 28 POWER, 29 ENERGY, 30 }; 31 32 struct scpi_sensor_info { 33 u16 sensor_id; 34 u8 class; 35 u8 trigger_type; 36 char name[20]; 37 } __packed; 38 39 /** 40 * struct scpi_ops - represents the various operations provided 41 * by SCP through SCPI message protocol 42 * @get_version: returns the major and minor revision on the SCPI 43 * message protocol 44 * @clk_get_range: gets clock range limit(min - max in Hz) 45 * @clk_get_val: gets clock value(in Hz) 46 * @clk_set_val: sets the clock value, setting to 0 will disable the 47 * clock (if supported) 48 * @dvfs_get_idx: gets the Operating Point of the given power domain. 49 * OPP is an index to the list return by @dvfs_get_info 50 * @dvfs_set_idx: sets the Operating Point of the given power domain. 51 * OPP is an index to the list return by @dvfs_get_info 52 * @dvfs_get_info: returns the DVFS capabilities of the given power 53 * domain. It includes the OPP list and the latency information 54 */ 55 struct scpi_ops { 56 u32 (*get_version)(void); 57 int (*clk_get_range)(u16, unsigned long *, unsigned long *); 58 unsigned long (*clk_get_val)(u16); 59 int (*clk_set_val)(u16, unsigned long); 60 int (*dvfs_get_idx)(u8); 61 int (*dvfs_set_idx)(u8, u8); 62 struct scpi_dvfs_info *(*dvfs_get_info)(u8); 63 int (*device_domain_id)(struct device *); 64 int (*get_transition_latency)(struct device *); 65 int (*add_opps_to_device)(struct device *); 66 int (*sensor_get_capability)(u16 *sensors); 67 int (*sensor_get_info)(u16 sensor_id, struct scpi_sensor_info *); 68 int (*sensor_get_value)(u16, u64 *); 69 int (*device_get_power_state)(u16); 70 int (*device_set_power_state)(u16, u8); 71 }; 72 73 #if IS_REACHABLE(CONFIG_ARM_SCPI_PROTOCOL) 74 struct scpi_ops *get_scpi_ops(void); 75 #else get_scpi_ops(void)76 static inline struct scpi_ops *get_scpi_ops(void) { return NULL; } 77 #endif 78 79 #endif /* _LINUX_SCPI_PROTOCOL_H */ 80