blob: 214394860632c09bb040d4f8326aaec35566cdd4 [file] [log] [blame]
b.liue9582032025-04-17 19:18:16 +08001/* 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
13enum telemetry_unit {
14 TELEM_PSS = 0,
15 TELEM_IOSS,
16 TELEM_UNIT_NONE
17};
18
19struct telemetry_evtlog {
20 u32 telem_evtid;
21 u64 telem_evtlog;
22};
23
24struct telemetry_evtconfig {
25 /* Array of Event-IDs to Enable */
26 u32 *evtmap;
27
28 /* Number of Events (<29) in evtmap */
29 u8 num_evts;
30
31 /* Sampling period */
32 u8 period;
33};
34
35struct telemetry_evtmap {
36 const char *name;
37 u32 evt_id;
38};
39
40struct telemetry_unit_config {
41 struct telemetry_evtmap *telem_evts;
42 void __iomem *regmap;
43 u32 ssram_base_addr;
44 u8 ssram_evts_used;
45 u8 curr_period;
46 u8 max_period;
47 u8 min_period;
48 u32 ssram_size;
49
50};
51
52struct telemetry_plt_config {
53 struct telemetry_unit_config pss_config;
54 struct telemetry_unit_config ioss_config;
55 struct mutex telem_trace_lock;
56 struct mutex telem_lock;
57 bool telem_in_use;
58};
59
60struct telemetry_core_ops {
61 int (*get_sampling_period)(u8 *pss_min_period, u8 *pss_max_period,
62 u8 *ioss_min_period, u8 *ioss_max_period);
63
64 int (*get_eventconfig)(struct telemetry_evtconfig *pss_evtconfig,
65 struct telemetry_evtconfig *ioss_evtconfig,
66 int pss_len, int ioss_len);
67
68 int (*update_events)(struct telemetry_evtconfig pss_evtconfig,
69 struct telemetry_evtconfig ioss_evtconfig);
70
71 int (*set_sampling_period)(u8 pss_period, u8 ioss_period);
72
73 int (*get_trace_verbosity)(enum telemetry_unit telem_unit,
74 u32 *verbosity);
75
76 int (*set_trace_verbosity)(enum telemetry_unit telem_unit,
77 u32 verbosity);
78
79 int (*raw_read_eventlog)(enum telemetry_unit telem_unit,
80 struct telemetry_evtlog *evtlog,
81 int len, int log_all_evts);
82
83 int (*read_eventlog)(enum telemetry_unit telem_unit,
84 struct telemetry_evtlog *evtlog,
85 int len, int log_all_evts);
86
87 int (*add_events)(u8 num_pss_evts, u8 num_ioss_evts,
88 u32 *pss_evtmap, u32 *ioss_evtmap);
89
90 int (*reset_events)(void);
91};
92
93int telemetry_set_pltdata(const struct telemetry_core_ops *ops,
94 struct telemetry_plt_config *pltconfig);
95
96int telemetry_clear_pltdata(void);
97
98int telemetry_pltconfig_valid(void);
99
100int telemetry_get_evtname(enum telemetry_unit telem_unit,
101 const char **name, int len);
102
103int telemetry_update_events(struct telemetry_evtconfig pss_evtconfig,
104 struct telemetry_evtconfig ioss_evtconfig);
105
106int telemetry_add_events(u8 num_pss_evts, u8 num_ioss_evts,
107 u32 *pss_evtmap, u32 *ioss_evtmap);
108
109int telemetry_reset_events(void);
110
111int telemetry_get_eventconfig(struct telemetry_evtconfig *pss_config,
112 struct telemetry_evtconfig *ioss_config,
113 int pss_len, int ioss_len);
114
115int telemetry_read_events(enum telemetry_unit telem_unit,
116 struct telemetry_evtlog *evtlog, int len);
117
118int telemetry_raw_read_events(enum telemetry_unit telem_unit,
119 struct telemetry_evtlog *evtlog, int len);
120
121int telemetry_read_eventlog(enum telemetry_unit telem_unit,
122 struct telemetry_evtlog *evtlog, int len);
123
124int telemetry_raw_read_eventlog(enum telemetry_unit telem_unit,
125 struct telemetry_evtlog *evtlog, int len);
126
127int telemetry_get_sampling_period(u8 *pss_min_period, u8 *pss_max_period,
128 u8 *ioss_min_period, u8 *ioss_max_period);
129
130int telemetry_set_sampling_period(u8 pss_period, u8 ioss_period);
131
132int telemetry_set_trace_verbosity(enum telemetry_unit telem_unit,
133 u32 verbosity);
134
135int telemetry_get_trace_verbosity(enum telemetry_unit telem_unit,
136 u32 *verbosity);
137
138#endif /* INTEL_TELEMETRY_H */