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
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
|
#ifndef _IPXE_ACPI_H
#define _IPXE_ACPI_H
/** @file
*
* ACPI data structures
*
*/
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
#include <stdint.h>
#include <byteswap.h>
#include <ipxe/refcnt.h>
#include <ipxe/list.h>
#include <ipxe/interface.h>
#include <ipxe/uaccess.h>
#include <ipxe/tables.h>
#include <ipxe/api.h>
#include <config/general.h>
/** An ACPI small resource descriptor header */
struct acpi_small_resource {
/** Tag byte */
uint8_t tag;
} __attribute__ (( packed ));
/** ACPI small resource length mask */
#define ACPI_SMALL_LEN_MASK 0x03
/** An ACPI end resource descriptor */
#define ACPI_END_RESOURCE 0x78
/** An ACPI end resource descriptor */
struct acpi_end_resource {
/** Header */
struct acpi_small_resource hdr;
/** Checksum */
uint8_t checksum;
} __attribute__ (( packed ));
/** An ACPI large resource descriptor header */
struct acpi_large_resource {
/** Tag byte */
uint8_t tag;
/** Length of data items */
uint16_t len;
} __attribute__ (( packed ));
/** ACPI large resource flag */
#define ACPI_LARGE 0x80
/** An ACPI QWORD address space resource descriptor */
#define ACPI_QWORD_ADDRESS_SPACE_RESOURCE 0x8a
/** An ACPI QWORD address space resource descriptor */
struct acpi_qword_address_space_resource {
/** Header */
struct acpi_large_resource hdr;
/** Resource type */
uint8_t type;
/** General flags */
uint8_t general;
/** Type-specific flags */
uint8_t specific;
/** Granularity */
uint64_t granularity;
/** Minimum address */
uint64_t min;
/** Maximum address */
uint64_t max;
/** Translation offset */
uint64_t offset;
/** Length */
uint64_t len;
} __attribute__ (( packed ));
/** A memory address space type */
#define ACPI_ADDRESS_TYPE_MEM 0x00
/** A bus number address space type */
#define ACPI_ADDRESS_TYPE_BUS 0x02
/** An ACPI resource descriptor */
union acpi_resource {
/** Tag byte */
uint8_t tag;
/** Small resource descriptor */
struct acpi_small_resource small;
/** End resource descriptor */
struct acpi_end_resource end;
/** Large resource descriptor */
struct acpi_large_resource large;
/** QWORD address space resource descriptor */
struct acpi_qword_address_space_resource qword;
};
/**
* Get ACPI resource tag
*
* @v res ACPI resource descriptor
* @ret tag Resource tag
*/
static inline unsigned int acpi_resource_tag ( union acpi_resource *res ) {
return ( ( res->tag & ACPI_LARGE ) ?
res->tag : ( res->tag & ~ACPI_SMALL_LEN_MASK ) );
}
/**
* Get length of ACPI small resource descriptor
*
* @v res Small resource descriptor
* @ret len Length of descriptor
*/
static inline size_t acpi_small_len ( struct acpi_small_resource *res ) {
return ( sizeof ( *res ) + ( res->tag & ACPI_SMALL_LEN_MASK ) );
}
/**
* Get length of ACPI large resource descriptor
*
* @v res Large resource descriptor
* @ret len Length of descriptor
*/
static inline size_t acpi_large_len ( struct acpi_large_resource *res ) {
return ( sizeof ( *res ) + le16_to_cpu ( res->len ) );
}
/**
* Get length of ACPI resource descriptor
*
* @v res ACPI resource descriptor
* @ret len Length of descriptor
*/
static inline size_t acpi_resource_len ( union acpi_resource *res ) {
return ( ( res->tag & ACPI_LARGE ) ?
acpi_large_len ( &res->large ) :
acpi_small_len ( &res->small ) );
}
/**
* Get next ACPI resource descriptor
*
* @v res ACPI resource descriptor
* @ret next Next ACPI resource descriptor
*/
static inline union acpi_resource *
acpi_resource_next ( union acpi_resource *res ) {
return ( ( ( void * ) res ) + acpi_resource_len ( res ) );
}
/**
* An ACPI description header
*
* This is the structure common to the start of all ACPI system
* description tables.
*/
struct acpi_header {
/** ACPI signature (4 ASCII characters) */
uint32_t signature;
/** Length of table, in bytes, including header */
uint32_t length;
/** ACPI Specification minor version number */
uint8_t revision;
/** To make sum of entire table == 0 */
uint8_t checksum;
/** OEM identification */
char oem_id[6];
/** OEM table identification */
char oem_table_id[8];
/** OEM revision number */
uint32_t oem_revision;
/** ASL compiler vendor ID */
char asl_compiler_id[4];
/** ASL compiler revision number */
uint32_t asl_compiler_revision;
} __attribute__ (( packed ));
/**
* Transcribe ACPI table signature (for debugging)
*
* @v signature ACPI table signature
* @ret name ACPI table signature name
*/
static inline const char * acpi_name ( uint32_t signature ) {
static union {
uint32_t signature;
char name[5];
} u;
u.signature = cpu_to_le32 ( signature );
return u.name;
}
/**
* Build ACPI signature
*
* @v a First character of ACPI signature
* @v b Second character of ACPI signature
* @v c Third character of ACPI signature
* @v d Fourth character of ACPI signature
* @ret signature ACPI signature
*/
#define ACPI_SIGNATURE( a, b, c, d ) \
( ( (a) << 0 ) | ( (b) << 8 ) | ( (c) << 16 ) | ( (d) << 24 ) )
/** Root System Description Pointer signature */
#define RSDP_SIGNATURE { 'R', 'S', 'D', ' ', 'P', 'T', 'R', ' ' }
/** Root System Description Pointer */
struct acpi_rsdp {
/** Signature */
char signature[8];
/** To make sum of entire table == 0 */
uint8_t checksum;
/** OEM identification */
char oem_id[6];
/** Revision */
uint8_t revision;
/** Physical address of RSDT */
uint32_t rsdt;
} __attribute__ (( packed ));
/** Root System Description Table (RSDT) signature */
#define RSDT_SIGNATURE ACPI_SIGNATURE ( 'R', 'S', 'D', 'T' )
/** ACPI Root System Description Table (RSDT) */
struct acpi_rsdt {
/** ACPI header */
struct acpi_header acpi;
/** ACPI table entries */
uint32_t entry[0];
} __attribute__ (( packed ));
/** Fixed ACPI Description Table (FADT) signature */
#define FADT_SIGNATURE ACPI_SIGNATURE ( 'F', 'A', 'C', 'P' )
/** Fixed ACPI Description Table (FADT) */
struct acpi_fadt {
/** ACPI header */
struct acpi_header acpi;
/** Physical address of FACS */
uint32_t facs;
/** Physical address of DSDT */
uint32_t dsdt;
/** Unused by iPXE */
uint8_t unused[20];
/** PM1a Control Register Block */
uint32_t pm1a_cnt_blk;
/** PM1b Control Register Block */
uint32_t pm1b_cnt_blk;
/** PM2 Control Register Block */
uint32_t pm2_cnt_blk;
/** PM Timer Control Register Block */
uint32_t pm_tmr_blk;
} __attribute__ (( packed ));
/** ACPI PM1 Control Register (within PM1a_CNT_BLK or PM1A_CNT_BLK) */
#define ACPI_PM1_CNT 0
#define ACPI_PM1_CNT_SLP_TYP(x) ( (x) << 10 ) /**< Sleep type */
#define ACPI_PM1_CNT_SLP_EN ( 1 << 13 ) /**< Sleep enable */
/** ACPI PM Timer Register (within PM_TMR_BLK) */
#define ACPI_PM_TMR 0
/** Differentiated System Description Table (DSDT) signature */
#define DSDT_SIGNATURE ACPI_SIGNATURE ( 'D', 'S', 'D', 'T' )
/** Secondary System Description Table (SSDT) signature */
#define SSDT_SIGNATURE ACPI_SIGNATURE ( 'S', 'S', 'D', 'T' )
/** An ACPI descriptor (used to construct ACPI tables) */
struct acpi_descriptor {
/** Reference count of containing object */
struct refcnt *refcnt;
/** Table model */
struct acpi_model *model;
/** List of ACPI descriptors for this model */
struct list_head list;
};
/**
* Initialise ACPI descriptor
*
* @v desc ACPI descriptor
* @v model Table model
* @v refcnt Reference count
*/
static inline __attribute__ (( always_inline )) void
acpi_init ( struct acpi_descriptor *desc, struct acpi_model *model,
struct refcnt *refcnt ) {
desc->refcnt = refcnt;
desc->model = model;
INIT_LIST_HEAD ( &desc->list );
}
/** An ACPI table model */
struct acpi_model {
/** List of descriptors */
struct list_head descs;
/**
* Check if ACPI descriptor is complete
*
* @v desc ACPI descriptor
* @ret rc Return status code
*/
int ( * complete ) ( struct acpi_descriptor *desc );
/**
* Install ACPI tables
*
* @v install Installation method
* @ret rc Return status code
*/
int ( * install ) ( int ( * install ) ( struct acpi_header *acpi ) );
};
/** ACPI models */
#define ACPI_MODELS __table ( struct acpi_model, "acpi_models" )
/** Declare an ACPI model */
#define __acpi_model __table_entry ( ACPI_MODELS, 01 )
/**
* Calculate static inline ACPI API function name
*
* @v _prefix Subsystem prefix
* @v _api_func API function
* @ret _subsys_func Subsystem API function
*/
#define ACPI_INLINE( _subsys, _api_func ) \
SINGLE_API_INLINE ( ACPI_PREFIX_ ## _subsys, _api_func )
/**
* Provide an ACPI API implementation
*
* @v _prefix Subsystem prefix
* @v _api_func API function
* @v _func Implementing function
*/
#define PROVIDE_ACPI( _subsys, _api_func, _func ) \
PROVIDE_SINGLE_API ( ACPI_PREFIX_ ## _subsys, _api_func, _func )
/**
* Provide a static inline ACPI API implementation
*
* @v _prefix Subsystem prefix
* @v _api_func API function
*/
#define PROVIDE_ACPI_INLINE( _subsys, _api_func ) \
PROVIDE_SINGLE_API_INLINE ( ACPI_PREFIX_ ## _subsys, _api_func )
extern userptr_t acpi_find_via_rsdt ( uint32_t signature, unsigned int index );
/* Include all architecture-independent ACPI API headers */
#include <ipxe/null_acpi.h>
#include <ipxe/efi/efi_acpi.h>
#include <ipxe/linux/linux_acpi.h>
/* Include all architecture-dependent ACPI API headers */
#include <bits/acpi.h>
/**
* Locate ACPI root system description table
*
* @ret rsdt ACPI root system description table, or UNULL
*/
userptr_t acpi_find_rsdt ( void );
/**
* Locate ACPI table
*
* @v signature Requested table signature
* @v index Requested index of table with this signature
* @ret table Table, or UNULL if not found
*/
userptr_t acpi_find ( uint32_t signature, unsigned int index );
extern struct acpi_descriptor *
acpi_describe ( struct interface *interface );
#define acpi_describe_TYPE( object_type ) \
typeof ( struct acpi_descriptor * ( object_type ) )
extern userptr_t ( * acpi_finder ) ( uint32_t signature, unsigned int index );
extern void acpi_fix_checksum ( struct acpi_header *acpi );
extern userptr_t acpi_table ( uint32_t signature, unsigned int index );
extern int acpi_extract ( uint32_t signature, void *data,
int ( * extract ) ( userptr_t zsdt, size_t len,
size_t offset, void *data ) );
extern void acpi_add ( struct acpi_descriptor *desc );
extern void acpi_del ( struct acpi_descriptor *desc );
extern int acpi_install ( int ( * install ) ( struct acpi_header *acpi ) );
#endif /* _IPXE_ACPI_H */
|