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