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 (*get_eventconfig)(struct telemetry_evtconfig *pss_evtconfig,
66  			       struct telemetry_evtconfig *ioss_evtconfig,
67  			       int pss_len, int ioss_len);
68  
69  	int (*update_events)(struct telemetry_evtconfig pss_evtconfig,
70  			     struct telemetry_evtconfig ioss_evtconfig);
71  
72  	int (*set_sampling_period)(u8 pss_period, u8 ioss_period);
73  
74  	int (*get_trace_verbosity)(enum telemetry_unit telem_unit,
75  				   u32 *verbosity);
76  
77  	int (*set_trace_verbosity)(enum telemetry_unit telem_unit,
78  				   u32 verbosity);
79  
80  	int (*raw_read_eventlog)(enum telemetry_unit telem_unit,
81  				 struct telemetry_evtlog *evtlog,
82  				 int len, int log_all_evts);
83  
84  	int (*read_eventlog)(enum telemetry_unit telem_unit,
85  			     struct telemetry_evtlog *evtlog,
86  			     int len, int log_all_evts);
87  
88  	int (*add_events)(u8 num_pss_evts, u8 num_ioss_evts,
89  			  u32 *pss_evtmap, u32 *ioss_evtmap);
90  
91  	int (*reset_events)(void);
92  };
93  
94  int telemetry_set_pltdata(const struct telemetry_core_ops *ops,
95  			  struct telemetry_plt_config *pltconfig);
96  
97  int telemetry_clear_pltdata(void);
98  
99  struct telemetry_plt_config *telemetry_get_pltdata(void);
100  
101  int telemetry_get_evtname(enum telemetry_unit telem_unit,
102  			  const char **name, int len);
103  
104  int telemetry_update_events(struct telemetry_evtconfig pss_evtconfig,
105  			    struct telemetry_evtconfig ioss_evtconfig);
106  
107  int telemetry_add_events(u8 num_pss_evts, u8 num_ioss_evts,
108  			 u32 *pss_evtmap, u32 *ioss_evtmap);
109  
110  int telemetry_reset_events(void);
111  
112  int telemetry_get_eventconfig(struct telemetry_evtconfig *pss_config,
113  			      struct telemetry_evtconfig *ioss_config,
114  			      int pss_len, int ioss_len);
115  
116  int telemetry_read_events(enum telemetry_unit telem_unit,
117  			  struct telemetry_evtlog *evtlog, int len);
118  
119  int telemetry_raw_read_events(enum telemetry_unit telem_unit,
120  			      struct telemetry_evtlog *evtlog, int len);
121  
122  int telemetry_read_eventlog(enum telemetry_unit telem_unit,
123  			    struct telemetry_evtlog *evtlog, int len);
124  
125  int telemetry_raw_read_eventlog(enum telemetry_unit telem_unit,
126  				struct telemetry_evtlog *evtlog, int len);
127  
128  int telemetry_get_sampling_period(u8 *pss_min_period, u8 *pss_max_period,
129  				  u8 *ioss_min_period, u8 *ioss_max_period);
130  
131  int telemetry_set_sampling_period(u8 pss_period, u8 ioss_period);
132  
133  int telemetry_set_trace_verbosity(enum telemetry_unit telem_unit,
134  				  u32 verbosity);
135  
136  int telemetry_get_trace_verbosity(enum telemetry_unit telem_unit,
137  				  u32 *verbosity);
138  
139  #endif /* INTEL_TELEMETRY_H */
140