hc
2025-02-14 bbb9540dc49f70f6b703d1c8d1b85fa5f602d86e
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
/* SPDX-License-Identifier: GPL-2.0 */
/*
 * Intel Core SoC Power Management Controller Header File
 *
 * Copyright (c) 2016, Intel Corporation.
 * All Rights Reserved.
 *
 * Authors: Rajneesh Bhardwaj <rajneesh.bhardwaj@intel.com>
 *          Vishwanath Somayaji <vishwanath.somayaji@intel.com>
 */
 
#ifndef PMC_CORE_H
#define PMC_CORE_H
 
#include <linux/bits.h>
 
#define PMC_BASE_ADDR_DEFAULT            0xFE000000
 
/* Sunrise Point Power Management Controller PCI Device ID */
#define SPT_PMC_PCI_DEVICE_ID            0x9d21
#define SPT_PMC_BASE_ADDR_OFFSET        0x48
#define SPT_PMC_SLP_S0_RES_COUNTER_OFFSET    0x13c
#define SPT_PMC_PM_CFG_OFFSET            0x18
#define SPT_PMC_PM_STS_OFFSET            0x1c
#define SPT_PMC_MTPMC_OFFSET            0x20
#define SPT_PMC_MFPMC_OFFSET            0x38
#define SPT_PMC_LTR_IGNORE_OFFSET        0x30C
#define SPT_PMC_VRIC1_OFFSET            0x31c
#define SPT_PMC_MPHY_CORE_STS_0            0x1143
#define SPT_PMC_MPHY_CORE_STS_1            0x1142
#define SPT_PMC_MPHY_COM_STS_0            0x1155
#define SPT_PMC_MMIO_REG_LEN            0x1000
#define SPT_PMC_SLP_S0_RES_COUNTER_STEP        0x68
#define PMC_BASE_ADDR_MASK            ~(SPT_PMC_MMIO_REG_LEN - 1)
#define MTPMC_MASK                0xffff0000
#define PPFEAR_MAX_NUM_ENTRIES            12
#define SPT_PPFEAR_NUM_ENTRIES            5
#define SPT_PMC_READ_DISABLE_BIT        0x16
#define SPT_PMC_MSG_FULL_STS_BIT        0x18
#define NUM_RETRIES                100
#define SPT_NUM_IP_IGN_ALLOWED            17
 
#define SPT_PMC_LTR_CUR_PLT            0x350
#define SPT_PMC_LTR_CUR_ASLT            0x354
#define SPT_PMC_LTR_SPA                0x360
#define SPT_PMC_LTR_SPB                0x364
#define SPT_PMC_LTR_SATA            0x368
#define SPT_PMC_LTR_GBE                0x36C
#define SPT_PMC_LTR_XHCI            0x370
#define SPT_PMC_LTR_RESERVED            0x374
#define SPT_PMC_LTR_ME                0x378
#define SPT_PMC_LTR_EVA                0x37C
#define SPT_PMC_LTR_SPC                0x380
#define SPT_PMC_LTR_AZ                0x384
#define SPT_PMC_LTR_LPSS            0x38C
#define SPT_PMC_LTR_CAM                0x390
#define SPT_PMC_LTR_SPD                0x394
#define SPT_PMC_LTR_SPE                0x398
#define SPT_PMC_LTR_ESPI            0x39C
#define SPT_PMC_LTR_SCC                0x3A0
#define SPT_PMC_LTR_ISH                0x3A4
 
/* Sunrise Point: PGD PFET Enable Ack Status Registers */
enum ppfear_regs {
   SPT_PMC_XRAM_PPFEAR0A = 0x590,
   SPT_PMC_XRAM_PPFEAR0B,
   SPT_PMC_XRAM_PPFEAR0C,
   SPT_PMC_XRAM_PPFEAR0D,
   SPT_PMC_XRAM_PPFEAR1A,
};
 
#define SPT_PMC_BIT_PMC                BIT(0)
#define SPT_PMC_BIT_OPI                BIT(1)
#define SPT_PMC_BIT_SPI                BIT(2)
#define SPT_PMC_BIT_XHCI            BIT(3)
#define SPT_PMC_BIT_SPA                BIT(4)
#define SPT_PMC_BIT_SPB                BIT(5)
#define SPT_PMC_BIT_SPC                BIT(6)
#define SPT_PMC_BIT_GBE                BIT(7)
 
#define SPT_PMC_BIT_SATA            BIT(0)
#define SPT_PMC_BIT_HDA_PGD0            BIT(1)
#define SPT_PMC_BIT_HDA_PGD1            BIT(2)
#define SPT_PMC_BIT_HDA_PGD2            BIT(3)
#define SPT_PMC_BIT_HDA_PGD3            BIT(4)
#define SPT_PMC_BIT_RSVD_0B            BIT(5)
#define SPT_PMC_BIT_LPSS            BIT(6)
#define SPT_PMC_BIT_LPC                BIT(7)
 
#define SPT_PMC_BIT_SMB                BIT(0)
#define SPT_PMC_BIT_ISH                BIT(1)
#define SPT_PMC_BIT_P2SB            BIT(2)
#define SPT_PMC_BIT_DFX                BIT(3)
#define SPT_PMC_BIT_SCC                BIT(4)
#define SPT_PMC_BIT_RSVD_0C            BIT(5)
#define SPT_PMC_BIT_FUSE            BIT(6)
#define SPT_PMC_BIT_CAMREA            BIT(7)
 
#define SPT_PMC_BIT_RSVD_0D            BIT(0)
#define SPT_PMC_BIT_USB3_OTG            BIT(1)
#define SPT_PMC_BIT_EXI                BIT(2)
#define SPT_PMC_BIT_CSE                BIT(3)
#define SPT_PMC_BIT_CSME_KVM            BIT(4)
#define SPT_PMC_BIT_CSME_PMT            BIT(5)
#define SPT_PMC_BIT_CSME_CLINK            BIT(6)
#define SPT_PMC_BIT_CSME_PTIO            BIT(7)
 
#define SPT_PMC_BIT_CSME_USBR            BIT(0)
#define SPT_PMC_BIT_CSME_SUSRAM            BIT(1)
#define SPT_PMC_BIT_CSME_SMT            BIT(2)
#define SPT_PMC_BIT_RSVD_1A            BIT(3)
#define SPT_PMC_BIT_CSME_SMS2            BIT(4)
#define SPT_PMC_BIT_CSME_SMS1            BIT(5)
#define SPT_PMC_BIT_CSME_RTC            BIT(6)
#define SPT_PMC_BIT_CSME_PSF            BIT(7)
 
#define SPT_PMC_BIT_MPHY_LANE0            BIT(0)
#define SPT_PMC_BIT_MPHY_LANE1            BIT(1)
#define SPT_PMC_BIT_MPHY_LANE2            BIT(2)
#define SPT_PMC_BIT_MPHY_LANE3            BIT(3)
#define SPT_PMC_BIT_MPHY_LANE4            BIT(4)
#define SPT_PMC_BIT_MPHY_LANE5            BIT(5)
#define SPT_PMC_BIT_MPHY_LANE6            BIT(6)
#define SPT_PMC_BIT_MPHY_LANE7            BIT(7)
 
#define SPT_PMC_BIT_MPHY_LANE8            BIT(0)
#define SPT_PMC_BIT_MPHY_LANE9            BIT(1)
#define SPT_PMC_BIT_MPHY_LANE10            BIT(2)
#define SPT_PMC_BIT_MPHY_LANE11            BIT(3)
#define SPT_PMC_BIT_MPHY_LANE12            BIT(4)
#define SPT_PMC_BIT_MPHY_LANE13            BIT(5)
#define SPT_PMC_BIT_MPHY_LANE14            BIT(6)
#define SPT_PMC_BIT_MPHY_LANE15            BIT(7)
 
#define SPT_PMC_BIT_MPHY_CMN_LANE0        BIT(0)
#define SPT_PMC_BIT_MPHY_CMN_LANE1        BIT(1)
#define SPT_PMC_BIT_MPHY_CMN_LANE2        BIT(2)
#define SPT_PMC_BIT_MPHY_CMN_LANE3        BIT(3)
 
#define SPT_PMC_VRIC1_SLPS0LVEN            BIT(13)
#define SPT_PMC_VRIC1_XTALSDQDIS        BIT(22)
 
/* Cannonlake Power Management Controller register offsets */
#define CNP_PMC_SLPS0_DBG_OFFSET        0x10B4
#define CNP_PMC_PM_CFG_OFFSET            0x1818
#define CNP_PMC_SLP_S0_RES_COUNTER_OFFSET    0x193C
#define CNP_PMC_LTR_IGNORE_OFFSET        0x1B0C
/* Cannonlake: PGD PFET Enable Ack Status Register(s) start */
#define CNP_PMC_HOST_PPFEAR0A            0x1D90
 
#define CNP_PMC_LATCH_SLPS0_EVENTS        BIT(31)
 
#define CNP_PMC_MMIO_REG_LEN            0x2000
#define CNP_PPFEAR_NUM_ENTRIES            8
#define CNP_PMC_READ_DISABLE_BIT        22
#define CNP_NUM_IP_IGN_ALLOWED            19
#define CNP_PMC_LTR_CUR_PLT            0x1B50
#define CNP_PMC_LTR_CUR_ASLT            0x1B54
#define CNP_PMC_LTR_SPA                0x1B60
#define CNP_PMC_LTR_SPB                0x1B64
#define CNP_PMC_LTR_SATA            0x1B68
#define CNP_PMC_LTR_GBE                0x1B6C
#define CNP_PMC_LTR_XHCI            0x1B70
#define CNP_PMC_LTR_RESERVED            0x1B74
#define CNP_PMC_LTR_ME                0x1B78
#define CNP_PMC_LTR_EVA                0x1B7C
#define CNP_PMC_LTR_SPC                0x1B80
#define CNP_PMC_LTR_AZ                0x1B84
#define CNP_PMC_LTR_LPSS            0x1B8C
#define CNP_PMC_LTR_CAM                0x1B90
#define CNP_PMC_LTR_SPD                0x1B94
#define CNP_PMC_LTR_SPE                0x1B98
#define CNP_PMC_LTR_ESPI            0x1B9C
#define CNP_PMC_LTR_SCC                0x1BA0
#define CNP_PMC_LTR_ISH                0x1BA4
#define CNP_PMC_LTR_CNV                0x1BF0
#define CNP_PMC_LTR_EMMC            0x1BF4
#define CNP_PMC_LTR_UFSX2            0x1BF8
 
#define LTR_DECODED_VAL                GENMASK(9, 0)
#define LTR_DECODED_SCALE            GENMASK(12, 10)
#define LTR_REQ_SNOOP                BIT(15)
#define LTR_REQ_NONSNOOP            BIT(31)
 
#define ICL_PPFEAR_NUM_ENTRIES            9
#define ICL_NUM_IP_IGN_ALLOWED            20
#define ICL_PMC_LTR_WIGIG            0x1BFC
#define ICL_PMC_SLP_S0_RES_COUNTER_STEP        0x64
 
#define TGL_NUM_IP_IGN_ALLOWED            22
#define TGL_PMC_SLP_S0_RES_COUNTER_STEP        0x7A
 
/*
 * Tigerlake Power Management Controller register offsets
 */
#define TGL_LPM_EN_OFFSET            0x1C78
#define TGL_LPM_RESIDENCY_OFFSET        0x1C80
 
/* Tigerlake Low Power Mode debug registers */
#define TGL_LPM_STATUS_OFFSET            0x1C3C
#define TGL_LPM_LIVE_STATUS_OFFSET        0x1C5C
 
const char *tgl_lpm_modes[] = {
   "S0i2.0",
   "S0i2.1",
   "S0i2.2",
   "S0i3.0",
   "S0i3.1",
   "S0i3.2",
   "S0i3.3",
   "S0i3.4",
   NULL
};
 
struct pmc_bit_map {
   const char *name;
   u32 bit_mask;
};
 
/**
 * struct pmc_reg_map - Structure used to define parameter unique to a
           PCH family
 * @pfear_sts:        Maps name of IP block to PPFEAR* bit
 * @mphy_sts:        Maps name of MPHY lane to MPHY status lane status bit
 * @pll_sts:        Maps name of PLL to corresponding bit status
 * @slps0_dbg_maps:    Array of SLP_S0_DBG* registers containing debug info
 * @ltr_show_sts:    Maps PCH IP Names to their MMIO register offsets
 * @slp_s0_offset:    PWRMBASE offset to read SLP_S0 residency
 * @ltr_ignore_offset:    PWRMBASE offset to read/write LTR ignore bit
 * @regmap_length:    Length of memory to map from PWRMBASE address to access
 * @ppfear0_offset:    PWRMBASE offset to to read PPFEAR*
 * @ppfear_buckets:    Number of 8 bits blocks to read all IP blocks from
 *            PPFEAR
 * @pm_cfg_offset:    PWRMBASE offset to PM_CFG register
 * @pm_read_disable_bit: Bit index to read PMC_READ_DISABLE
 * @slps0_dbg_offset:    PWRMBASE offset to SLP_S0_DEBUG_REG*
 *
 * Each PCH has unique set of register offsets and bit indexes. This structure
 * captures them to have a common implementation.
 */
struct pmc_reg_map {
   const struct pmc_bit_map **pfear_sts;
   const struct pmc_bit_map *mphy_sts;
   const struct pmc_bit_map *pll_sts;
   const struct pmc_bit_map **slps0_dbg_maps;
   const struct pmc_bit_map *ltr_show_sts;
   const struct pmc_bit_map *msr_sts;
   const struct pmc_bit_map **lpm_sts;
   const u32 slp_s0_offset;
   const int slp_s0_res_counter_step;
   const u32 ltr_ignore_offset;
   const int regmap_length;
   const u32 ppfear0_offset;
   const int ppfear_buckets;
   const u32 pm_cfg_offset;
   const int pm_read_disable_bit;
   const u32 slps0_dbg_offset;
   const u32 ltr_ignore_max;
   const u32 pm_vric1_offset;
   /* Low Power Mode registers */
   const char **lpm_modes;
   const u32 lpm_en_offset;
   const u32 lpm_residency_offset;
   const u32 lpm_status_offset;
   const u32 lpm_live_status_offset;
};
 
/**
 * struct pmc_dev - pmc device structure
 * @base_addr:        contains pmc base address
 * @regbase:        pointer to io-remapped memory location
 * @map:        pointer to pmc_reg_map struct that contains platform
 *            specific attributes
 * @dbgfs_dir:        path to debugfs interface
 * @pmc_xram_read_bit:    flag to indicate whether PMC XRAM shadow registers
 *            used to read MPHY PG and PLL status are available
 * @mutex_lock:        mutex to complete one transcation
 * @check_counters:    On resume, check if counters are getting incremented
 * @pc10_counter:    PC10 residency counter
 * @s0ix_counter:    S0ix residency (step adjusted)
 *
 * pmc_dev contains info about power management controller device.
 */
struct pmc_dev {
   u32 base_addr;
   void __iomem *regbase;
   const struct pmc_reg_map *map;
   struct dentry *dbgfs_dir;
   int pmc_xram_read_bit;
   struct mutex lock; /* generic mutex lock for PMC Core */
 
   bool check_counters; /* Check for counter increments on resume */
   u64 pc10_counter;
   u64 s0ix_counter;
};
 
#endif /* PMC_CORE_H */