xref: /linux/arch/x86/include/asm/intel_telemetry.h (revision 3dd1e9c2a279cbc9c6a7f1e7961df08c76ecb464)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Intel SOC Telemetry Driver Header File
4  * Copyright (C) 2015, Intel Corporation.
5  * All Rights Reserved.
6  */
7 #ifndef INTEL_TELEMETRY_H
8 #define INTEL_TELEMETRY_H
9 
10 #define TELEM_MAX_EVENTS_SRAM		28
11 #define TELEM_MAX_OS_ALLOCATED_EVENTS	20
12 
13 #include <linux/platform_data/x86/intel_scu_ipc.h>
14 
15 enum telemetry_unit {
16 	TELEM_PSS = 0,
17 	TELEM_IOSS,
18 	TELEM_UNIT_NONE
19 };
20 
21 struct telemetry_evtlog {
22 	u32 telem_evtid;
23 	u64 telem_evtlog;
24 };
25 
26 struct telemetry_evtconfig {
27 	/* Array of Event-IDs to Enable */
28 	u32 *evtmap;
29 
30 	/* Number of Events (<29) in evtmap */
31 	u8 num_evts;
32 
33 	/* Sampling period */
34 	u8 period;
35 };
36 
37 struct telemetry_evtmap {
38 	const char *name;
39 	u32 evt_id;
40 };
41 
42 struct telemetry_unit_config {
43 	struct telemetry_evtmap *telem_evts;
44 	void __iomem *regmap;
45 	u8 ssram_evts_used;
46 	u8 curr_period;
47 	u8 max_period;
48 	u8 min_period;
49 };
50 
51 struct telemetry_plt_config {
52 	struct telemetry_unit_config pss_config;
53 	struct telemetry_unit_config ioss_config;
54 	struct mutex telem_trace_lock;
55 	struct mutex telem_lock;
56 	struct intel_pmc_dev *pmc;
57 	struct intel_scu_ipc_dev *scu;
58 	bool telem_in_use;
59 };
60 
61 struct telemetry_core_ops {
62 	int (*get_sampling_period)(u8 *pss_min_period, u8 *pss_max_period,
63 				   u8 *ioss_min_period, u8 *ioss_max_period);
64 
65 	int (*set_sampling_period)(u8 pss_period, u8 ioss_period);
66 
67 	int (*get_trace_verbosity)(enum telemetry_unit telem_unit,
68 				   u32 *verbosity);
69 
70 	int (*set_trace_verbosity)(enum telemetry_unit telem_unit,
71 				   u32 verbosity);
72 
73 	int (*raw_read_eventlog)(enum telemetry_unit telem_unit,
74 				 struct telemetry_evtlog *evtlog,
75 				 int len, int log_all_evts);
76 
77 	int (*read_eventlog)(enum telemetry_unit telem_unit,
78 			     struct telemetry_evtlog *evtlog,
79 			     int len, int log_all_evts);
80 };
81 
82 int telemetry_set_pltdata(const struct telemetry_core_ops *ops,
83 			  struct telemetry_plt_config *pltconfig);
84 
85 int telemetry_clear_pltdata(void);
86 
87 struct telemetry_plt_config *telemetry_get_pltdata(void);
88 
89 int telemetry_get_evtname(enum telemetry_unit telem_unit,
90 			  const char **name, int len);
91 
92 int telemetry_read_events(enum telemetry_unit telem_unit,
93 			  struct telemetry_evtlog *evtlog, int len);
94 
95 int telemetry_raw_read_events(enum telemetry_unit telem_unit,
96 			      struct telemetry_evtlog *evtlog, int len);
97 
98 int telemetry_read_eventlog(enum telemetry_unit telem_unit,
99 			    struct telemetry_evtlog *evtlog, int len);
100 
101 int telemetry_raw_read_eventlog(enum telemetry_unit telem_unit,
102 				struct telemetry_evtlog *evtlog, int len);
103 
104 int telemetry_get_sampling_period(u8 *pss_min_period, u8 *pss_max_period,
105 				  u8 *ioss_min_period, u8 *ioss_max_period);
106 
107 int telemetry_set_sampling_period(u8 pss_period, u8 ioss_period);
108 
109 int telemetry_set_trace_verbosity(enum telemetry_unit telem_unit,
110 				  u32 verbosity);
111 
112 int telemetry_get_trace_verbosity(enum telemetry_unit telem_unit,
113 				  u32 *verbosity);
114 
115 #endif /* INTEL_TELEMETRY_H */
116