1 #ifndef HW_ACPI_GEN_UTILS_H
2 #define HW_ACPI_GEN_UTILS_H
6 #include "qemu/compiler.h"
7 #include "hw/acpi/acpi-defs.h"
9 /* Reserve RAM space for tables: add another order of magnitude. */
10 #define ACPI_BUILD_TABLE_MAX_SIZE 0x200000
12 #define ACPI_BUILD_APPNAME6 "BOCHS "
13 #define ACPI_BUILD_APPNAME4 "BXPC"
15 #define ACPI_BUILD_TABLE_FILE "etc/acpi/tables"
16 #define ACPI_BUILD_RSDP_FILE "etc/acpi/rsdp"
17 #define ACPI_BUILD_TPMLOG_FILE "etc/tpm/log"
20 AML_NO_OPCODE
= 0,/* has only data */
21 AML_OPCODE
, /* has opcode optionally followed by data */
22 AML_PACKAGE
, /* has opcode and uses PkgLength for its length */
23 AML_EXT_PACKAGE
, /* Same as AML_PACKAGE but also has 'ExOpPrefix' */
24 AML_BUFFER
, /* data encoded as 'DefBuffer' */
25 AML_RES_TEMPLATE
, /* encoded as ResourceTemplate macro */
33 AmlBlockFlags block_flags
;
35 typedef struct Aml Aml
;
58 AML_WRITE_AS_ONES
= 1,
59 AML_WRITE_AS_ZEROS
= 2,
63 AML_SYSTEM_MEMORY
= 0X00,
70 AML_BUS_NUMBER_RANGE
= 2,
74 AML_SUB_DECODE
= 1 << 1,
79 AML_MAX_FIXED
= 1 << 3,
80 AML_MAX_NOT_FIXED
= 0,
84 AML_MIN_FIXED
= 1 << 2,
89 * ACPI 1.0b: Table 6-26 I/O Resource Flag (Resource Type = 1) Definitions
90 * _RNG field definition
99 * ACPI 1.0b: Table 6-25 Memory Resource Flag (Resource Type = 0) Definitions
100 * _MEM field definition
103 AML_NON_CACHEABLE
= 0,
105 AML_WRITE_COMBINING
= 2,
106 AML_PREFETCHABLE
= 3,
110 * ACPI 1.0b: Table 6-25 Memory Resource Flag (Resource Type = 0) Definitions
111 * _RW field definition
119 * ACPI 5.0: Table 6-187 Extended Interrupt Descriptor Definition
120 * Interrupt Vector Flags Bits[0] Consumer/Producer
123 AML_CONSUMER_PRODUCER
= 0,
125 } AmlConsumerAndProducer
;
128 * ACPI 5.0: Table 6-187 Extended Interrupt Descriptor Definition
129 * _HE field definition
137 * ACPI 5.0: Table 6-187 Extended Interrupt Descriptor Definition
138 * _LL field definition
143 } AmlActiveHighAndLow
;
146 * ACPI 5.0: Table 6-187 Extended Interrupt Descriptor Definition
147 * _SHR field definition
152 AML_EXCLUSIVE_AND_WAKE
= 2,
153 AML_SHARED_AND_WAKE
= 3,
156 /* ACPI 1.0b: 16.2.5.2 Named Objects Encoding: MethodFlags */
158 AML_NOTSERIALIZED
= 0,
163 * ACPI 5.0: Table 6-189 GPIO Connection Descriptor Definition
164 * GPIO Connection Type
167 AML_INTERRUPT_CONNECTION
= 0,
168 AML_IO_CONNECTION
= 1,
169 } AmlGpioConnectionType
;
172 * ACPI 5.0: Table 6-189 GPIO Connection Descriptor Definition
173 * _PPI field definition
176 AML_PULL_DEFAULT
= 0,
183 struct AcpiBuildTables
{
191 * init_aml_allocator:
193 * Called for initializing API allocator which allow to use
195 * Returns: toplevel container which accumulates all other
196 * AML elements for a table.
198 Aml
*init_aml_allocator(void);
201 * free_aml_allocator:
203 * Releases all elements used by AML API, frees associated memory
204 * and invalidates AML allocator. After this call @init_aml_allocator
205 * should be called again if AML API is to be used again.
207 void free_aml_allocator(void);
211 * @parent_ctx: context to which @child element is added
212 * @child: element that is copied into @parent_ctx context
214 * Joins Aml elements together and helps to construct AML tables
216 * Aml *table = aml_def_block("SSDT", ...);
217 * Aml *sb = aml_scope("\\_SB");
218 * Aml *dev = aml_device("PCI0");
220 * aml_append(dev, aml_name_decl("HID", aml_eisaid("PNP0A03")));
221 * aml_append(sb, dev);
222 * aml_append(table, sb);
224 void aml_append(Aml
*parent_ctx
, Aml
*child
);
226 /* non block AML object primitives */
227 Aml
*aml_name(const char *name_format
, ...) GCC_FMT_ATTR(1, 2);
228 Aml
*aml_name_decl(const char *name
, Aml
*val
);
229 Aml
*aml_return(Aml
*val
);
230 Aml
*aml_int(const uint64_t val
);
231 Aml
*aml_arg(int pos
);
232 Aml
*aml_to_integer(Aml
*arg
);
233 Aml
*aml_store(Aml
*val
, Aml
*target
);
234 Aml
*aml_and(Aml
*arg1
, Aml
*arg2
);
235 Aml
*aml_or(Aml
*arg1
, Aml
*arg2
);
236 Aml
*aml_lor(Aml
*arg1
, Aml
*arg2
);
237 Aml
*aml_shiftleft(Aml
*arg1
, Aml
*count
);
238 Aml
*aml_shiftright(Aml
*arg1
, Aml
*count
, Aml
*dst
);
239 Aml
*aml_lless(Aml
*arg1
, Aml
*arg2
);
240 Aml
*aml_add(Aml
*arg1
, Aml
*arg2
, Aml
*dst
);
241 Aml
*aml_subtract(Aml
*arg1
, Aml
*arg2
, Aml
*dst
);
242 Aml
*aml_increment(Aml
*arg
);
243 Aml
*aml_decrement(Aml
*arg
);
244 Aml
*aml_index(Aml
*arg1
, Aml
*idx
);
245 Aml
*aml_notify(Aml
*arg1
, Aml
*arg2
);
246 Aml
*aml_call0(const char *method
);
247 Aml
*aml_call1(const char *method
, Aml
*arg1
);
248 Aml
*aml_call2(const char *method
, Aml
*arg1
, Aml
*arg2
);
249 Aml
*aml_call3(const char *method
, Aml
*arg1
, Aml
*arg2
, Aml
*arg3
);
250 Aml
*aml_call4(const char *method
, Aml
*arg1
, Aml
*arg2
, Aml
*arg3
, Aml
*arg4
);
251 Aml
*aml_gpio_int(AmlConsumerAndProducer con_and_pro
,
252 AmlLevelAndEdge edge_level
,
253 AmlActiveHighAndLow active_level
, AmlShared shared
,
254 AmlPinConfig pin_config
, uint16_t debounce_timeout
,
255 const uint32_t pin_list
[], uint32_t pin_count
,
256 const char *resource_source_name
,
257 const uint8_t *vendor_data
, uint16_t vendor_data_len
);
258 Aml
*aml_memory32_fixed(uint32_t addr
, uint32_t size
,
259 AmlReadAndWrite read_and_write
);
260 Aml
*aml_interrupt(AmlConsumerAndProducer con_and_pro
,
261 AmlLevelAndEdge level_and_edge
,
262 AmlActiveHighAndLow high_and_low
, AmlShared shared
,
263 uint32_t *irq_list
, uint8_t irq_count
);
264 Aml
*aml_io(AmlIODecode dec
, uint16_t min_base
, uint16_t max_base
,
265 uint8_t aln
, uint8_t len
);
266 Aml
*aml_operation_region(const char *name
, AmlRegionSpace rs
,
267 uint32_t offset
, uint32_t len
);
268 Aml
*aml_irq_no_flags(uint8_t irq
);
269 Aml
*aml_named_field(const char *name
, unsigned length
);
270 Aml
*aml_reserved_field(unsigned length
);
271 Aml
*aml_local(int num
);
272 Aml
*aml_string(const char *name_format
, ...) GCC_FMT_ATTR(1, 2);
273 Aml
*aml_lnot(Aml
*arg
);
274 Aml
*aml_equal(Aml
*arg1
, Aml
*arg2
);
275 Aml
*aml_lgreater(Aml
*arg1
, Aml
*arg2
);
276 Aml
*aml_lgreater_equal(Aml
*arg1
, Aml
*arg2
);
277 Aml
*aml_processor(uint8_t proc_id
, uint32_t pblk_addr
, uint8_t pblk_len
,
278 const char *name_format
, ...) GCC_FMT_ATTR(4, 5);
279 Aml
*aml_eisaid(const char *str
);
280 Aml
*aml_word_bus_number(AmlMinFixed min_fixed
, AmlMaxFixed max_fixed
,
281 AmlDecode dec
, uint16_t addr_gran
,
282 uint16_t addr_min
, uint16_t addr_max
,
283 uint16_t addr_trans
, uint16_t len
);
284 Aml
*aml_word_io(AmlMinFixed min_fixed
, AmlMaxFixed max_fixed
,
285 AmlDecode dec
, AmlISARanges isa_ranges
,
286 uint16_t addr_gran
, uint16_t addr_min
,
287 uint16_t addr_max
, uint16_t addr_trans
,
289 Aml
*aml_dword_io(AmlMinFixed min_fixed
, AmlMaxFixed max_fixed
,
290 AmlDecode dec
, AmlISARanges isa_ranges
,
291 uint32_t addr_gran
, uint32_t addr_min
,
292 uint32_t addr_max
, uint32_t addr_trans
,
294 Aml
*aml_dword_memory(AmlDecode dec
, AmlMinFixed min_fixed
,
295 AmlMaxFixed max_fixed
, AmlCacheable cacheable
,
296 AmlReadAndWrite read_and_write
,
297 uint32_t addr_gran
, uint32_t addr_min
,
298 uint32_t addr_max
, uint32_t addr_trans
,
300 Aml
*aml_qword_memory(AmlDecode dec
, AmlMinFixed min_fixed
,
301 AmlMaxFixed max_fixed
, AmlCacheable cacheable
,
302 AmlReadAndWrite read_and_write
,
303 uint64_t addr_gran
, uint64_t addr_min
,
304 uint64_t addr_max
, uint64_t addr_trans
,
306 Aml
*aml_sleep(uint64_t msec
);
308 /* Block AML object primitives */
309 Aml
*aml_scope(const char *name_format
, ...) GCC_FMT_ATTR(1, 2);
310 Aml
*aml_device(const char *name_format
, ...) GCC_FMT_ATTR(1, 2);
311 Aml
*aml_method(const char *name
, int arg_count
, AmlSerializeFlag sflag
);
312 Aml
*aml_if(Aml
*predicate
);
314 Aml
*aml_while(Aml
*predicate
);
315 Aml
*aml_package(uint8_t num_elements
);
316 Aml
*aml_buffer(int buffer_size
, uint8_t *byte_list
);
317 Aml
*aml_resource_template(void);
318 Aml
*aml_field(const char *name
, AmlAccessType type
, AmlLockRule lock
,
320 Aml
*aml_mutex(const char *name
, uint8_t sync_level
);
321 Aml
*aml_acquire(Aml
*mutex
, uint16_t timeout
);
322 Aml
*aml_release(Aml
*mutex
);
323 Aml
*aml_alias(const char *source_object
, const char *alias_object
);
324 Aml
*aml_create_dword_field(Aml
*srcbuf
, Aml
*index
, const char *name
);
325 Aml
*aml_create_qword_field(Aml
*srcbuf
, Aml
*index
, const char *name
);
326 Aml
*aml_varpackage(uint32_t num_elements
);
327 Aml
*aml_touuid(const char *uuid
);
328 Aml
*aml_unicode(const char *str
);
329 Aml
*aml_derefof(Aml
*arg
);
330 Aml
*aml_sizeof(Aml
*arg
);
333 build_header(GArray
*linker
, GArray
*table_data
,
334 AcpiTableHeader
*h
, const char *sig
, int len
, uint8_t rev
,
335 const char *oem_table_id
);
336 void *acpi_data_push(GArray
*table_data
, unsigned size
);
337 unsigned acpi_data_len(GArray
*table
);
338 void acpi_add_table(GArray
*table_offsets
, GArray
*table_data
);
339 void acpi_build_tables_init(AcpiBuildTables
*tables
);
340 void acpi_build_tables_cleanup(AcpiBuildTables
*tables
, bool mfre
);
342 build_rsdt(GArray
*table_data
, GArray
*linker
, GArray
*table_offsets
);