acpi_cpu.h revision 1.17 1 /* $NetBSD: acpi_cpu.h,v 1.17 2010/08/16 17:58:42 jruoho Exp $ */
2
3 /*-
4 * Copyright (c) 2010 Jukka Ruohonen <jruohonen (at) iki.fi>
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 *
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 * SUCH DAMAGE.
28 */
29
30 #ifndef _SYS_DEV_ACPI_ACPI_CPU_H
31 #define _SYS_DEV_ACPI_ACPI_CPU_H
32
33 /*
34 * The following _PDC values are based on:
35 *
36 * Intel Corporation: Intel Processor-Specific ACPI
37 * Interface Specification, September 2006, Revision 005.
38 */
39 #define ACPICPU_PDC_REVID 0x1
40 #define ACPICPU_PDC_SMP 0xA
41 #define ACPICPU_PDC_MSR 0x1
42
43 #define ACPICPU_PDC_P_FFH __BIT(0) /* SpeedStep MSRs */
44 #define ACPICPU_PDC_C_C1_HALT __BIT(1) /* C1 "I/O then halt" */
45 #define ACPICPU_PDC_T_FFH __BIT(2) /* OnDemand throttling MSRs */
46 #define ACPICPU_PDC_C_C1PT __BIT(3) /* SMP C1, Px, and Tx (same) */
47 #define ACPICPU_PDC_C_C2C3 __BIT(4) /* SMP C2 and C3 (same) */
48 #define ACPICPU_PDC_P_SW __BIT(5) /* SMP Px (different) */
49 #define ACPICPU_PDC_C_SW __BIT(6) /* SMP Cx (different) */
50 #define ACPICPU_PDC_T_SW __BIT(7) /* SMP Tx (different) */
51 #define ACPICPU_PDC_C_C1_FFH __BIT(8) /* SMP C1 native beyond halt */
52 #define ACPICPU_PDC_C_C2C3_FFH __BIT(9) /* SMP C2 and C2 native */
53 #define ACPICPU_PDC_P_HW __BIT(11) /* Px hardware coordination */
54
55 #define ACPICPU_PDC_GAS_HW __BIT(0) /* HW-coordinated state */
56 #define ACPICPU_PDC_GAS_BM __BIT(1) /* Bus master check required */
57
58 /*
59 * Notify values.
60 */
61 #define ACPICPU_P_NOTIFY 0x80 /* _PPC */
62 #define ACPICPU_C_NOTIFY 0x81 /* _CST */
63 #define ACPICPU_T_NOTIFY 0x82 /* _TPC */
64
65 /*
66 * C-states.
67 */
68 #define ACPICPU_C_C2_LATENCY_MAX 100 /* us */
69 #define ACPICPU_C_C3_LATENCY_MAX 1000 /* us */
70
71 #define ACPICPU_C_STATE_HALT 0x01
72 #define ACPICPU_C_STATE_FFH 0x02
73 #define ACPICPU_C_STATE_SYSIO 0x03
74
75 /*
76 * P-states.
77 */
78 #define ACPICPU_P_STATE_MAX 255 /* Arbitrary upper limit */
79 #define ACPICPU_P_STATE_RETRY 100
80 #define ACPICPU_P_STATE_UNKNOWN 0x0
81
82 /*
83 * T-states.
84 */
85 #define ACPICPU_T_STATE_MAX 0x8
86 #define ACPICPU_T_STATE_RETRY 0xA
87 #define ACPICPU_T_STATE_UNKNOWN 255
88
89 /*
90 * Flags.
91 */
92 #define ACPICPU_FLAG_C __BIT(0) /* C-states supported */
93 #define ACPICPU_FLAG_P __BIT(1) /* P-states supported */
94 #define ACPICPU_FLAG_T __BIT(2) /* T-states supported */
95
96 #define ACPICPU_FLAG_PIIX4 __BIT(3) /* Broken (quirk) */
97
98 #define ACPICPU_FLAG_C_FFH __BIT(4) /* Native C-states */
99 #define ACPICPU_FLAG_C_FADT __BIT(5) /* C-states with FADT */
100 #define ACPICPU_FLAG_C_BM __BIT(6) /* Bus master control */
101 #define ACPICPU_FLAG_C_BM_STS __BIT(7) /* Bus master check required */
102 #define ACPICPU_FLAG_C_ARB __BIT(8) /* Bus master arbitration */
103 #define ACPICPU_FLAG_C_C1E __BIT(9) /* AMD C1E detected */
104
105 #define ACPICPU_FLAG_P_FFH __BIT(10) /* Native P-states */
106 #define ACPICPU_FLAG_P_XPSS __BIT(11) /* Microsoft XPSS in use */
107
108 #define ACPICPU_FLAG_T_FFH __BIT(12) /* Native throttling */
109 #define ACPICPU_FLAG_T_FADT __BIT(13) /* Throttling with FADT */
110
111 /*
112 * This is AML_RESOURCE_GENERIC_REGISTER,
113 * included here separately for convenience.
114 */
115 struct acpicpu_reg {
116 uint8_t reg_desc;
117 uint16_t reg_reslen;
118 uint8_t reg_spaceid;
119 uint8_t reg_bitwidth;
120 uint8_t reg_bitoffset;
121 uint8_t reg_accesssize;
122 uint64_t reg_addr;
123 } __packed;
124
125 struct acpicpu_cstate {
126 struct evcnt cs_evcnt;
127 char cs_name[EVCNT_STRING_MAX];
128 uint64_t cs_addr;
129 uint32_t cs_power;
130 uint32_t cs_latency;
131 int cs_method;
132 int cs_flags;
133 };
134
135 /*
136 * This structure supports both the conventional _PSS and the
137 * so-called extended _PSS (XPSS). For the latter, refer to:
138 *
139 * Microsoft Corporation: Extended PSS ACPI
140 * Method Specification, April 2, 2007.
141 */
142 struct acpicpu_pstate {
143 struct evcnt ps_evcnt;
144 char ps_name[EVCNT_STRING_MAX];
145 uint32_t ps_freq;
146 uint32_t ps_power;
147 uint32_t ps_latency;
148 uint32_t ps_latency_bm;
149 uint64_t ps_control;
150 uint64_t ps_control_addr;
151 uint64_t ps_control_mask;
152 uint64_t ps_status;
153 uint64_t ps_status_addr;
154 uint64_t ps_status_mask;
155 int ps_flags;
156 };
157
158 struct acpicpu_tstate {
159 struct evcnt ts_evcnt;
160 char ts_name[EVCNT_STRING_MAX];
161 uint32_t ts_percent;
162 uint32_t ts_power;
163 uint32_t ts_latency;
164 uint32_t ts_control;
165 uint32_t ts_status;
166 };
167
168 struct acpicpu_object {
169 uint32_t ao_procid;
170 uint32_t ao_pblklen;
171 uint32_t ao_pblkaddr;
172 };
173
174 struct acpicpu_softc {
175 device_t sc_dev;
176 struct acpi_devnode *sc_node;
177 struct acpicpu_object sc_object;
178
179 struct acpicpu_cstate sc_cstate[ACPI_C_STATE_COUNT];
180 uint32_t sc_cstate_sleep;
181
182 struct acpicpu_pstate *sc_pstate;
183 struct acpicpu_reg sc_pstate_control;
184 struct acpicpu_reg sc_pstate_status;
185 uint32_t sc_pstate_current;
186 uint32_t sc_pstate_count;
187 uint32_t sc_pstate_max;
188
189 struct acpicpu_tstate *sc_tstate;
190 struct acpicpu_reg sc_tstate_control;
191 struct acpicpu_reg sc_tstate_status;
192 uint32_t sc_tstate_current;
193 uint32_t sc_tstate_count;
194 uint32_t sc_tstate_max;
195 uint32_t sc_tstate_min;
196
197 kmutex_t sc_mtx;
198 bus_space_tag_t sc_iot;
199 bus_space_handle_t sc_ioh;
200
201 uint32_t sc_cap;
202 uint32_t sc_flags;
203 cpuid_t sc_cpuid;
204 bool sc_cold;
205 bool sc_mapped;
206 };
207
208 void acpicpu_cstate_attach(device_t);
209 int acpicpu_cstate_detach(device_t);
210 void acpicpu_cstate_start(device_t);
211 bool acpicpu_cstate_suspend(device_t);
212 bool acpicpu_cstate_resume(device_t);
213 void acpicpu_cstate_callback(void *);
214 void acpicpu_cstate_idle(void);
215
216 void acpicpu_pstate_attach(device_t);
217 int acpicpu_pstate_detach(device_t);
218 void acpicpu_pstate_start(device_t);
219 bool acpicpu_pstate_suspend(device_t);
220 bool acpicpu_pstate_resume(device_t);
221 void acpicpu_pstate_callback(void *);
222 int acpicpu_pstate_get(struct acpicpu_softc *, uint32_t *);
223 int acpicpu_pstate_set(struct acpicpu_softc *, uint32_t);
224
225 void acpicpu_tstate_attach(device_t);
226 int acpicpu_tstate_detach(device_t);
227 void acpicpu_tstate_start(device_t);
228 bool acpicpu_tstate_suspend(device_t);
229 bool acpicpu_tstate_resume(device_t);
230 void acpicpu_tstate_callback(void *);
231 int acpicpu_tstate_get(struct acpicpu_softc *, uint32_t *);
232 int acpicpu_tstate_set(struct acpicpu_softc *, uint32_t);
233
234 uint32_t acpicpu_md_cap(void);
235 uint32_t acpicpu_md_quirks(void);
236 uint32_t acpicpu_md_cpus_running(void);
237 int acpicpu_md_idle_start(void);
238 int acpicpu_md_idle_stop(void);
239 void acpicpu_md_idle_enter(int, int);
240 int acpicpu_md_pstate_start(void);
241 int acpicpu_md_pstate_stop(void);
242 int acpicpu_md_pstate_get(struct acpicpu_softc *, uint32_t *);
243 int acpicpu_md_pstate_set(struct acpicpu_pstate *);
244 int acpicpu_md_tstate_get(struct acpicpu_softc *, uint32_t *);
245 int acpicpu_md_tstate_set(struct acpicpu_tstate *);
246
247 #endif /* !_SYS_DEV_ACPI_ACPI_CPU_H */
248