1 /* Support for generating ACPI tables and passing them to Guests
3 * Copyright (C) 2015 Red Hat Inc
5 * Author: Michael S. Tsirkin <mst@redhat.com>
6 * Author: Igor Mammedov <imammedo@redhat.com>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License along
19 * with this program; if not, see <http://www.gnu.org/licenses/>.
22 #include "qemu/osdep.h"
23 #include <glib/gprintf.h>
24 #include "hw/acpi/aml-build.h"
25 #include "qemu/bswap.h"
26 #include "qemu/bitops.h"
28 static GArray
*build_alloc_array(void)
30 return g_array_new(false, true /* clear */, 1);
33 static void build_free_array(GArray
*array
)
35 g_array_free(array
, true);
38 static void build_prepend_byte(GArray
*array
, uint8_t val
)
40 g_array_prepend_val(array
, val
);
43 static void build_append_byte(GArray
*array
, uint8_t val
)
45 g_array_append_val(array
, val
);
48 static void build_append_array(GArray
*array
, GArray
*val
)
50 g_array_append_vals(array
, val
->data
, val
->len
);
53 #define ACPI_NAMESEG_LEN 4
56 build_append_nameseg(GArray
*array
, const char *seg
)
61 assert(len
<= ACPI_NAMESEG_LEN
);
63 g_array_append_vals(array
, seg
, len
);
64 /* Pad up to ACPI_NAMESEG_LEN characters if necessary. */
65 g_array_append_vals(array
, "____", ACPI_NAMESEG_LEN
- len
);
68 static void GCC_FMT_ATTR(2, 0)
69 build_append_namestringv(GArray
*array
, const char *format
, va_list ap
)
76 s
= g_strdup_vprintf(format
, ap
);
77 segs
= g_strsplit(s
, ".", 0);
87 * ACPI 5.0 spec: 20.2.2 Name Objects Encoding:
88 * "SegCount can be from 1 to 255"
90 assert(seg_count
> 0 && seg_count
<= 255);
92 /* handle RootPath || PrefixPath */
94 while (*s
== '\\' || *s
== '^') {
95 build_append_byte(array
, *s
);
102 build_append_byte(array
, 0x00); /* NullName */
104 build_append_nameseg(array
, s
);
109 build_append_byte(array
, 0x2E); /* DualNamePrefix */
110 build_append_nameseg(array
, s
);
111 build_append_nameseg(array
, segs
[1]);
114 build_append_byte(array
, 0x2F); /* MultiNamePrefix */
115 build_append_byte(array
, seg_count
);
117 /* handle the 1st segment manually due to prefix/root path */
118 build_append_nameseg(array
, s
);
120 /* add the rest of segments */
121 segs_iter
= segs
+ 1;
123 build_append_nameseg(array
, *segs_iter
);
132 static void build_append_namestring(GArray
*array
, const char *format
, ...)
136 va_start(ap
, format
);
137 build_append_namestringv(array
, format
, ap
);
141 /* 5.4 Definition Block Encoding */
143 PACKAGE_LENGTH_1BYTE_SHIFT
= 6, /* Up to 63 - use extra 2 bits. */
144 PACKAGE_LENGTH_2BYTE_SHIFT
= 4,
145 PACKAGE_LENGTH_3BYTE_SHIFT
= 12,
146 PACKAGE_LENGTH_4BYTE_SHIFT
= 20,
150 build_prepend_package_length(GArray
*package
, unsigned length
, bool incl_self
)
153 unsigned length_bytes
;
155 if (length
+ 1 < (1 << PACKAGE_LENGTH_1BYTE_SHIFT
)) {
157 } else if (length
+ 2 < (1 << PACKAGE_LENGTH_3BYTE_SHIFT
)) {
159 } else if (length
+ 3 < (1 << PACKAGE_LENGTH_4BYTE_SHIFT
)) {
166 * NamedField uses PkgLength encoding but it doesn't include length
167 * of PkgLength itself.
171 * PkgLength is the length of the inclusive length of the data
172 * and PkgLength's length itself when used for terms with
175 length
+= length_bytes
;
178 switch (length_bytes
) {
181 build_prepend_byte(package
, byte
);
184 byte
= length
>> PACKAGE_LENGTH_4BYTE_SHIFT
;
185 build_prepend_byte(package
, byte
);
186 length
&= (1 << PACKAGE_LENGTH_4BYTE_SHIFT
) - 1;
189 byte
= length
>> PACKAGE_LENGTH_3BYTE_SHIFT
;
190 build_prepend_byte(package
, byte
);
191 length
&= (1 << PACKAGE_LENGTH_3BYTE_SHIFT
) - 1;
194 byte
= length
>> PACKAGE_LENGTH_2BYTE_SHIFT
;
195 build_prepend_byte(package
, byte
);
196 length
&= (1 << PACKAGE_LENGTH_2BYTE_SHIFT
) - 1;
200 * Most significant two bits of byte zero indicate how many following bytes
201 * are in PkgLength encoding.
203 byte
= ((length_bytes
- 1) << PACKAGE_LENGTH_1BYTE_SHIFT
) | length
;
204 build_prepend_byte(package
, byte
);
208 build_append_pkg_length(GArray
*array
, unsigned length
, bool incl_self
)
210 GArray
*tmp
= build_alloc_array();
212 build_prepend_package_length(tmp
, length
, incl_self
);
213 build_append_array(array
, tmp
);
214 build_free_array(tmp
);
217 static void build_package(GArray
*package
, uint8_t op
)
219 build_prepend_package_length(package
, package
->len
, true);
220 build_prepend_byte(package
, op
);
223 static void build_extop_package(GArray
*package
, uint8_t op
)
225 build_package(package
, op
);
226 build_prepend_byte(package
, 0x5B); /* ExtOpPrefix */
229 static void build_append_int_noprefix(GArray
*table
, uint64_t value
, int size
)
233 for (i
= 0; i
< size
; ++i
) {
234 build_append_byte(table
, value
& 0xFF);
239 static void build_append_int(GArray
*table
, uint64_t value
)
242 build_append_byte(table
, 0x00); /* ZeroOp */
243 } else if (value
== 0x01) {
244 build_append_byte(table
, 0x01); /* OneOp */
245 } else if (value
<= 0xFF) {
246 build_append_byte(table
, 0x0A); /* BytePrefix */
247 build_append_int_noprefix(table
, value
, 1);
248 } else if (value
<= 0xFFFF) {
249 build_append_byte(table
, 0x0B); /* WordPrefix */
250 build_append_int_noprefix(table
, value
, 2);
251 } else if (value
<= 0xFFFFFFFF) {
252 build_append_byte(table
, 0x0C); /* DWordPrefix */
253 build_append_int_noprefix(table
, value
, 4);
255 build_append_byte(table
, 0x0E); /* QWordPrefix */
256 build_append_int_noprefix(table
, value
, 8);
261 * Build NAME(XXXX, 0x00000000) where 0x00000000 is encoded as a dword,
262 * and return the offset to 0x00000000 for runtime patching.
264 * Warning: runtime patching is best avoided. Only use this as
265 * a replacement for DataTableRegion (for guests that don't
269 build_append_named_dword(GArray
*array
, const char *name_format
, ...)
274 build_append_byte(array
, 0x08); /* NameOp */
275 va_start(ap
, name_format
);
276 build_append_namestringv(array
, name_format
, ap
);
279 build_append_byte(array
, 0x0C); /* DWordPrefix */
282 build_append_int_noprefix(array
, 0x00000000, 4);
283 assert(array
->len
== offset
+ 4);
288 static GPtrArray
*alloc_list
;
290 static Aml
*aml_alloc(void)
292 Aml
*var
= g_new0(typeof(*var
), 1);
294 g_ptr_array_add(alloc_list
, var
);
295 var
->block_flags
= AML_NO_OPCODE
;
296 var
->buf
= build_alloc_array();
300 static Aml
*aml_opcode(uint8_t op
)
302 Aml
*var
= aml_alloc();
305 var
->block_flags
= AML_OPCODE
;
309 static Aml
*aml_bundle(uint8_t op
, AmlBlockFlags flags
)
311 Aml
*var
= aml_alloc();
314 var
->block_flags
= flags
;
318 static void aml_free(gpointer data
, gpointer user_data
)
321 build_free_array(var
->buf
);
325 Aml
*init_aml_allocator(void)
328 alloc_list
= g_ptr_array_new();
332 void free_aml_allocator(void)
334 g_ptr_array_foreach(alloc_list
, aml_free
, NULL
);
335 g_ptr_array_free(alloc_list
, true);
339 /* pack data with DefBuffer encoding */
340 static void build_buffer(GArray
*array
, uint8_t op
)
342 GArray
*data
= build_alloc_array();
344 build_append_int(data
, array
->len
);
345 g_array_prepend_vals(array
, data
->data
, data
->len
);
346 build_free_array(data
);
347 build_package(array
, op
);
350 void aml_append(Aml
*parent_ctx
, Aml
*child
)
352 GArray
*buf
= build_alloc_array();
353 build_append_array(buf
, child
->buf
);
355 switch (child
->block_flags
) {
357 build_append_byte(parent_ctx
->buf
, child
->op
);
359 case AML_EXT_PACKAGE
:
360 build_extop_package(buf
, child
->op
);
363 build_package(buf
, child
->op
);
365 case AML_RES_TEMPLATE
:
366 build_append_byte(buf
, 0x79); /* EndTag */
368 * checksum operations are treated as succeeded if checksum
369 * field is zero. [ACPI Spec 1.0b, 6.4.2.8 End Tag]
371 build_append_byte(buf
, 0);
372 /* fall through, to pack resources in buffer */
374 build_buffer(buf
, child
->op
);
382 build_append_array(parent_ctx
->buf
, buf
);
383 build_free_array(buf
);
386 /* ACPI 1.0b: 16.2.5.1 Namespace Modifier Objects Encoding: DefScope */
387 Aml
*aml_scope(const char *name_format
, ...)
390 Aml
*var
= aml_bundle(0x10 /* ScopeOp */, AML_PACKAGE
);
391 va_start(ap
, name_format
);
392 build_append_namestringv(var
->buf
, name_format
, ap
);
397 /* ACPI 1.0b: 16.2.5.3 Type 1 Opcodes Encoding: DefReturn */
398 Aml
*aml_return(Aml
*val
)
400 Aml
*var
= aml_opcode(0xA4 /* ReturnOp */);
401 aml_append(var
, val
);
405 /* ACPI 1.0b: 16.2.6.3 Debug Objects Encoding: DebugObj */
408 Aml
*var
= aml_alloc();
409 build_append_byte(var
->buf
, 0x5B); /* ExtOpPrefix */
410 build_append_byte(var
->buf
, 0x31); /* DebugOp */
415 * ACPI 1.0b: 16.2.3 Data Objects Encoding:
416 * encodes: ByteConst, WordConst, DWordConst, QWordConst, ZeroOp, OneOp
418 Aml
*aml_int(const uint64_t val
)
420 Aml
*var
= aml_alloc();
421 build_append_int(var
->buf
, val
);
426 * helper to construct NameString, which returns Aml object
427 * for using with aml_append or other aml_* terms
429 Aml
*aml_name(const char *name_format
, ...)
432 Aml
*var
= aml_alloc();
433 va_start(ap
, name_format
);
434 build_append_namestringv(var
->buf
, name_format
, ap
);
439 /* ACPI 1.0b: 16.2.5.1 Namespace Modifier Objects Encoding: DefName */
440 Aml
*aml_name_decl(const char *name
, Aml
*val
)
442 Aml
*var
= aml_opcode(0x08 /* NameOp */);
443 build_append_namestring(var
->buf
, "%s", name
);
444 aml_append(var
, val
);
448 /* ACPI 1.0b: 16.2.6.1 Arg Objects Encoding */
449 Aml
*aml_arg(int pos
)
451 uint8_t op
= 0x68 /* ARG0 op */ + pos
;
454 return aml_opcode(op
);
457 /* ACPI 2.0a: 17.2.4.4 Type 2 Opcodes Encoding: DefToInteger */
458 Aml
*aml_to_integer(Aml
*arg
)
460 Aml
*var
= aml_opcode(0x99 /* ToIntegerOp */);
461 aml_append(var
, arg
);
462 build_append_byte(var
->buf
, 0x00 /* NullNameOp */);
466 /* ACPI 2.0a: 17.2.4.4 Type 2 Opcodes Encoding: DefToHexString */
467 Aml
*aml_to_hexstring(Aml
*src
, Aml
*dst
)
469 Aml
*var
= aml_opcode(0x98 /* ToHexStringOp */);
470 aml_append(var
, src
);
472 aml_append(var
, dst
);
474 build_append_byte(var
->buf
, 0x00 /* NullNameOp */);
479 /* ACPI 2.0a: 17.2.4.4 Type 2 Opcodes Encoding: DefToBuffer */
480 Aml
*aml_to_buffer(Aml
*src
, Aml
*dst
)
482 Aml
*var
= aml_opcode(0x96 /* ToBufferOp */);
483 aml_append(var
, src
);
485 aml_append(var
, dst
);
487 build_append_byte(var
->buf
, 0x00 /* NullNameOp */);
492 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefStore */
493 Aml
*aml_store(Aml
*val
, Aml
*target
)
495 Aml
*var
= aml_opcode(0x70 /* StoreOp */);
496 aml_append(var
, val
);
497 aml_append(var
, target
);
502 * build_opcode_2arg_dst:
506 * @dst: optional target to store to, set to NULL if it's not required
508 * An internal helper to compose AML terms that have
509 * "Op Operand Operand Target"
512 * Returns: The newly allocated and composed according to patter Aml object.
515 build_opcode_2arg_dst(uint8_t op
, Aml
*arg1
, Aml
*arg2
, Aml
*dst
)
517 Aml
*var
= aml_opcode(op
);
518 aml_append(var
, arg1
);
519 aml_append(var
, arg2
);
521 aml_append(var
, dst
);
523 build_append_byte(var
->buf
, 0x00 /* NullNameOp */);
528 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefAnd */
529 Aml
*aml_and(Aml
*arg1
, Aml
*arg2
, Aml
*dst
)
531 return build_opcode_2arg_dst(0x7B /* AndOp */, arg1
, arg2
, dst
);
534 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefOr */
535 Aml
*aml_or(Aml
*arg1
, Aml
*arg2
, Aml
*dst
)
537 return build_opcode_2arg_dst(0x7D /* OrOp */, arg1
, arg2
, dst
);
540 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefLOr */
541 Aml
*aml_lor(Aml
*arg1
, Aml
*arg2
)
543 Aml
*var
= aml_opcode(0x91 /* LOrOp */);
544 aml_append(var
, arg1
);
545 aml_append(var
, arg2
);
549 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefShiftLeft */
550 Aml
*aml_shiftleft(Aml
*arg1
, Aml
*count
)
552 return build_opcode_2arg_dst(0x79 /* ShiftLeftOp */, arg1
, count
, NULL
);
555 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefShiftRight */
556 Aml
*aml_shiftright(Aml
*arg1
, Aml
*count
, Aml
*dst
)
558 return build_opcode_2arg_dst(0x7A /* ShiftRightOp */, arg1
, count
, dst
);
561 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefLLess */
562 Aml
*aml_lless(Aml
*arg1
, Aml
*arg2
)
564 Aml
*var
= aml_opcode(0x95 /* LLessOp */);
565 aml_append(var
, arg1
);
566 aml_append(var
, arg2
);
570 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefAdd */
571 Aml
*aml_add(Aml
*arg1
, Aml
*arg2
, Aml
*dst
)
573 return build_opcode_2arg_dst(0x72 /* AddOp */, arg1
, arg2
, dst
);
576 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefSubtract */
577 Aml
*aml_subtract(Aml
*arg1
, Aml
*arg2
, Aml
*dst
)
579 return build_opcode_2arg_dst(0x74 /* SubtractOp */, arg1
, arg2
, dst
);
582 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefIncrement */
583 Aml
*aml_increment(Aml
*arg
)
585 Aml
*var
= aml_opcode(0x75 /* IncrementOp */);
586 aml_append(var
, arg
);
590 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefDecrement */
591 Aml
*aml_decrement(Aml
*arg
)
593 Aml
*var
= aml_opcode(0x76 /* DecrementOp */);
594 aml_append(var
, arg
);
598 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefIndex */
599 Aml
*aml_index(Aml
*arg1
, Aml
*idx
)
601 return build_opcode_2arg_dst(0x88 /* IndexOp */, arg1
, idx
, NULL
);
604 /* ACPI 1.0b: 16.2.5.3 Type 1 Opcodes Encoding: DefNotify */
605 Aml
*aml_notify(Aml
*arg1
, Aml
*arg2
)
607 Aml
*var
= aml_opcode(0x86 /* NotifyOp */);
608 aml_append(var
, arg1
);
609 aml_append(var
, arg2
);
613 /* helper to call method with 1 argument */
614 Aml
*aml_call0(const char *method
)
616 Aml
*var
= aml_alloc();
617 build_append_namestring(var
->buf
, "%s", method
);
621 /* helper to call method with 1 argument */
622 Aml
*aml_call1(const char *method
, Aml
*arg1
)
624 Aml
*var
= aml_alloc();
625 build_append_namestring(var
->buf
, "%s", method
);
626 aml_append(var
, arg1
);
630 /* helper to call method with 2 arguments */
631 Aml
*aml_call2(const char *method
, Aml
*arg1
, Aml
*arg2
)
633 Aml
*var
= aml_alloc();
634 build_append_namestring(var
->buf
, "%s", method
);
635 aml_append(var
, arg1
);
636 aml_append(var
, arg2
);
640 /* helper to call method with 3 arguments */
641 Aml
*aml_call3(const char *method
, Aml
*arg1
, Aml
*arg2
, Aml
*arg3
)
643 Aml
*var
= aml_alloc();
644 build_append_namestring(var
->buf
, "%s", method
);
645 aml_append(var
, arg1
);
646 aml_append(var
, arg2
);
647 aml_append(var
, arg3
);
651 /* helper to call method with 4 arguments */
652 Aml
*aml_call4(const char *method
, Aml
*arg1
, Aml
*arg2
, Aml
*arg3
, Aml
*arg4
)
654 Aml
*var
= aml_alloc();
655 build_append_namestring(var
->buf
, "%s", method
);
656 aml_append(var
, arg1
);
657 aml_append(var
, arg2
);
658 aml_append(var
, arg3
);
659 aml_append(var
, arg4
);
663 /* helper to call method with 5 arguments */
664 Aml
*aml_call5(const char *method
, Aml
*arg1
, Aml
*arg2
, Aml
*arg3
, Aml
*arg4
,
667 Aml
*var
= aml_alloc();
668 build_append_namestring(var
->buf
, "%s", method
);
669 aml_append(var
, arg1
);
670 aml_append(var
, arg2
);
671 aml_append(var
, arg3
);
672 aml_append(var
, arg4
);
673 aml_append(var
, arg5
);
678 * ACPI 5.0: 6.4.3.8.1 GPIO Connection Descriptor
679 * Type 1, Large Item Name 0xC
682 static Aml
*aml_gpio_connection(AmlGpioConnectionType type
,
683 AmlConsumerAndProducer con_and_pro
,
684 uint8_t flags
, AmlPinConfig pin_config
,
685 uint16_t output_drive
,
686 uint16_t debounce_timeout
,
687 const uint32_t pin_list
[], uint32_t pin_count
,
688 const char *resource_source_name
,
689 const uint8_t *vendor_data
,
690 uint16_t vendor_data_len
)
692 Aml
*var
= aml_alloc();
693 const uint16_t min_desc_len
= 0x16;
694 uint16_t resource_source_name_len
, length
;
695 uint16_t pin_table_offset
, resource_source_name_offset
, vendor_data_offset
;
698 assert(resource_source_name
);
699 resource_source_name_len
= strlen(resource_source_name
) + 1;
700 length
= min_desc_len
+ resource_source_name_len
+ vendor_data_len
;
701 pin_table_offset
= min_desc_len
+ 1;
702 resource_source_name_offset
= pin_table_offset
+ pin_count
* 2;
703 vendor_data_offset
= resource_source_name_offset
+ resource_source_name_len
;
705 build_append_byte(var
->buf
, 0x8C); /* GPIO Connection Descriptor */
706 build_append_int_noprefix(var
->buf
, length
, 2); /* Length */
707 build_append_byte(var
->buf
, 1); /* Revision ID */
708 build_append_byte(var
->buf
, type
); /* GPIO Connection Type */
709 /* General Flags (2 bytes) */
710 build_append_int_noprefix(var
->buf
, con_and_pro
, 2);
711 /* Interrupt and IO Flags (2 bytes) */
712 build_append_int_noprefix(var
->buf
, flags
, 2);
713 /* Pin Configuration 0 = Default 1 = Pull-up 2 = Pull-down 3 = No Pull */
714 build_append_byte(var
->buf
, pin_config
);
715 /* Output Drive Strength (2 bytes) */
716 build_append_int_noprefix(var
->buf
, output_drive
, 2);
717 /* Debounce Timeout (2 bytes) */
718 build_append_int_noprefix(var
->buf
, debounce_timeout
, 2);
719 /* Pin Table Offset (2 bytes) */
720 build_append_int_noprefix(var
->buf
, pin_table_offset
, 2);
721 build_append_byte(var
->buf
, 0); /* Resource Source Index */
722 /* Resource Source Name Offset (2 bytes) */
723 build_append_int_noprefix(var
->buf
, resource_source_name_offset
, 2);
724 /* Vendor Data Offset (2 bytes) */
725 build_append_int_noprefix(var
->buf
, vendor_data_offset
, 2);
726 /* Vendor Data Length (2 bytes) */
727 build_append_int_noprefix(var
->buf
, vendor_data_len
, 2);
728 /* Pin Number (2n bytes)*/
729 for (i
= 0; i
< pin_count
; i
++) {
730 build_append_int_noprefix(var
->buf
, pin_list
[i
], 2);
733 /* Resource Source Name */
734 build_append_namestring(var
->buf
, "%s", resource_source_name
);
735 build_append_byte(var
->buf
, '\0');
737 /* Vendor-defined Data */
738 if (vendor_data
!= NULL
) {
739 g_array_append_vals(var
->buf
, vendor_data
, vendor_data_len
);
747 * GpioInt(GPIO Interrupt Connection Resource Descriptor Macro)
749 Aml
*aml_gpio_int(AmlConsumerAndProducer con_and_pro
,
750 AmlLevelAndEdge edge_level
,
751 AmlActiveHighAndLow active_level
, AmlShared shared
,
752 AmlPinConfig pin_config
, uint16_t debounce_timeout
,
753 const uint32_t pin_list
[], uint32_t pin_count
,
754 const char *resource_source_name
,
755 const uint8_t *vendor_data
, uint16_t vendor_data_len
)
757 uint8_t flags
= edge_level
| (active_level
<< 1) | (shared
<< 3);
759 return aml_gpio_connection(AML_INTERRUPT_CONNECTION
, con_and_pro
, flags
,
760 pin_config
, 0, debounce_timeout
, pin_list
,
761 pin_count
, resource_source_name
, vendor_data
,
766 * ACPI 1.0b: 6.4.3.4 32-Bit Fixed Location Memory Range Descriptor
767 * (Type 1, Large Item Name 0x6)
769 Aml
*aml_memory32_fixed(uint32_t addr
, uint32_t size
,
770 AmlReadAndWrite read_and_write
)
772 Aml
*var
= aml_alloc();
773 build_append_byte(var
->buf
, 0x86); /* Memory32Fixed Resource Descriptor */
774 build_append_byte(var
->buf
, 9); /* Length, bits[7:0] value = 9 */
775 build_append_byte(var
->buf
, 0); /* Length, bits[15:8] value = 0 */
776 build_append_byte(var
->buf
, read_and_write
); /* Write status, 1 rw 0 ro */
778 /* Range base address */
779 build_append_byte(var
->buf
, extract32(addr
, 0, 8)); /* bits[7:0] */
780 build_append_byte(var
->buf
, extract32(addr
, 8, 8)); /* bits[15:8] */
781 build_append_byte(var
->buf
, extract32(addr
, 16, 8)); /* bits[23:16] */
782 build_append_byte(var
->buf
, extract32(addr
, 24, 8)); /* bits[31:24] */
785 build_append_byte(var
->buf
, extract32(size
, 0, 8)); /* bits[7:0] */
786 build_append_byte(var
->buf
, extract32(size
, 8, 8)); /* bits[15:8] */
787 build_append_byte(var
->buf
, extract32(size
, 16, 8)); /* bits[23:16] */
788 build_append_byte(var
->buf
, extract32(size
, 24, 8)); /* bits[31:24] */
793 * ACPI 5.0: 6.4.3.6 Extended Interrupt Descriptor
794 * Type 1, Large Item Name 0x9
796 Aml
*aml_interrupt(AmlConsumerAndProducer con_and_pro
,
797 AmlLevelAndEdge level_and_edge
,
798 AmlActiveHighAndLow high_and_low
, AmlShared shared
,
799 uint32_t *irq_list
, uint8_t irq_count
)
802 Aml
*var
= aml_alloc();
803 uint8_t irq_flags
= con_and_pro
| (level_and_edge
<< 1)
804 | (high_and_low
<< 2) | (shared
<< 3);
805 const int header_bytes_in_len
= 2;
806 uint16_t len
= header_bytes_in_len
+ irq_count
* sizeof(uint32_t);
808 assert(irq_count
> 0);
810 build_append_byte(var
->buf
, 0x89); /* Extended irq descriptor */
811 build_append_byte(var
->buf
, len
& 0xFF); /* Length, bits[7:0] */
812 build_append_byte(var
->buf
, len
>> 8); /* Length, bits[15:8] */
813 build_append_byte(var
->buf
, irq_flags
); /* Interrupt Vector Information. */
814 build_append_byte(var
->buf
, irq_count
); /* Interrupt table length */
816 /* Interrupt Number List */
817 for (i
= 0; i
< irq_count
; i
++) {
818 build_append_int_noprefix(var
->buf
, irq_list
[i
], 4);
823 /* ACPI 1.0b: 6.4.2.5 I/O Port Descriptor */
824 Aml
*aml_io(AmlIODecode dec
, uint16_t min_base
, uint16_t max_base
,
825 uint8_t aln
, uint8_t len
)
827 Aml
*var
= aml_alloc();
828 build_append_byte(var
->buf
, 0x47); /* IO port descriptor */
829 build_append_byte(var
->buf
, dec
);
830 build_append_byte(var
->buf
, min_base
& 0xff);
831 build_append_byte(var
->buf
, (min_base
>> 8) & 0xff);
832 build_append_byte(var
->buf
, max_base
& 0xff);
833 build_append_byte(var
->buf
, (max_base
>> 8) & 0xff);
834 build_append_byte(var
->buf
, aln
);
835 build_append_byte(var
->buf
, len
);
840 * ACPI 1.0b: 6.4.2.1.1 ASL Macro for IRQ Descriptor
842 * More verbose description at:
843 * ACPI 5.0: 19.5.64 IRQNoFlags (Interrupt Resource Descriptor Macro)
844 * 6.4.2.1 IRQ Descriptor
846 Aml
*aml_irq_no_flags(uint8_t irq
)
849 Aml
*var
= aml_alloc();
852 build_append_byte(var
->buf
, 0x22); /* IRQ descriptor 2 byte form */
854 irq_mask
= 1U << irq
;
855 build_append_byte(var
->buf
, irq_mask
& 0xFF); /* IRQ mask bits[7:0] */
856 build_append_byte(var
->buf
, irq_mask
>> 8); /* IRQ mask bits[15:8] */
860 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefLNot */
861 Aml
*aml_lnot(Aml
*arg
)
863 Aml
*var
= aml_opcode(0x92 /* LNotOp */);
864 aml_append(var
, arg
);
868 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefLEqual */
869 Aml
*aml_equal(Aml
*arg1
, Aml
*arg2
)
871 Aml
*var
= aml_opcode(0x93 /* LequalOp */);
872 aml_append(var
, arg1
);
873 aml_append(var
, arg2
);
877 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefLGreater */
878 Aml
*aml_lgreater(Aml
*arg1
, Aml
*arg2
)
880 Aml
*var
= aml_opcode(0x94 /* LGreaterOp */);
881 aml_append(var
, arg1
);
882 aml_append(var
, arg2
);
886 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefLGreaterEqual */
887 Aml
*aml_lgreater_equal(Aml
*arg1
, Aml
*arg2
)
889 /* LGreaterEqualOp := LNotOp LLessOp */
890 Aml
*var
= aml_opcode(0x92 /* LNotOp */);
891 build_append_byte(var
->buf
, 0x95 /* LLessOp */);
892 aml_append(var
, arg1
);
893 aml_append(var
, arg2
);
897 /* ACPI 1.0b: 16.2.5.3 Type 1 Opcodes Encoding: DefIfElse */
898 Aml
*aml_if(Aml
*predicate
)
900 Aml
*var
= aml_bundle(0xA0 /* IfOp */, AML_PACKAGE
);
901 aml_append(var
, predicate
);
905 /* ACPI 1.0b: 16.2.5.3 Type 1 Opcodes Encoding: DefElse */
908 Aml
*var
= aml_bundle(0xA1 /* ElseOp */, AML_PACKAGE
);
912 /* ACPI 1.0b: 16.2.5.3 Type 1 Opcodes Encoding: DefWhile */
913 Aml
*aml_while(Aml
*predicate
)
915 Aml
*var
= aml_bundle(0xA2 /* WhileOp */, AML_PACKAGE
);
916 aml_append(var
, predicate
);
920 /* ACPI 1.0b: 16.2.5.2 Named Objects Encoding: DefMethod */
921 Aml
*aml_method(const char *name
, int arg_count
, AmlSerializeFlag sflag
)
923 Aml
*var
= aml_bundle(0x14 /* MethodOp */, AML_PACKAGE
);
928 * bit 0-2: ArgCount (0-7)
929 * bit 3: SerializeFlag
932 * bit 4-7: reserved (must be 0)
934 assert(arg_count
< 8);
935 methodflags
= arg_count
| (sflag
<< 3);
937 build_append_namestring(var
->buf
, "%s", name
);
938 build_append_byte(var
->buf
, methodflags
); /* MethodFlags: ArgCount */
942 /* ACPI 1.0b: 16.2.5.2 Named Objects Encoding: DefDevice */
943 Aml
*aml_device(const char *name_format
, ...)
946 Aml
*var
= aml_bundle(0x82 /* DeviceOp */, AML_EXT_PACKAGE
);
947 va_start(ap
, name_format
);
948 build_append_namestringv(var
->buf
, name_format
, ap
);
953 /* ACPI 1.0b: 6.4.1 ASL Macros for Resource Descriptors */
954 Aml
*aml_resource_template(void)
956 /* ResourceTemplate is a buffer of Resources with EndTag at the end */
957 Aml
*var
= aml_bundle(0x11 /* BufferOp */, AML_RES_TEMPLATE
);
961 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefBuffer
962 * Pass byte_list as NULL to request uninitialized buffer to reserve space.
964 Aml
*aml_buffer(int buffer_size
, uint8_t *byte_list
)
967 Aml
*var
= aml_bundle(0x11 /* BufferOp */, AML_BUFFER
);
969 for (i
= 0; i
< buffer_size
; i
++) {
970 if (byte_list
== NULL
) {
971 build_append_byte(var
->buf
, 0x0);
973 build_append_byte(var
->buf
, byte_list
[i
]);
980 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefPackage */
981 Aml
*aml_package(uint8_t num_elements
)
983 Aml
*var
= aml_bundle(0x12 /* PackageOp */, AML_PACKAGE
);
984 build_append_byte(var
->buf
, num_elements
);
988 /* ACPI 1.0b: 16.2.5.2 Named Objects Encoding: DefOpRegion */
989 Aml
*aml_operation_region(const char *name
, AmlRegionSpace rs
,
990 Aml
*offset
, uint32_t len
)
992 Aml
*var
= aml_alloc();
993 build_append_byte(var
->buf
, 0x5B); /* ExtOpPrefix */
994 build_append_byte(var
->buf
, 0x80); /* OpRegionOp */
995 build_append_namestring(var
->buf
, "%s", name
);
996 build_append_byte(var
->buf
, rs
);
997 aml_append(var
, offset
);
998 build_append_int(var
->buf
, len
);
1002 /* ACPI 1.0b: 16.2.5.2 Named Objects Encoding: NamedField */
1003 Aml
*aml_named_field(const char *name
, unsigned length
)
1005 Aml
*var
= aml_alloc();
1006 build_append_nameseg(var
->buf
, name
);
1007 build_append_pkg_length(var
->buf
, length
, false);
1011 /* ACPI 1.0b: 16.2.5.2 Named Objects Encoding: ReservedField */
1012 Aml
*aml_reserved_field(unsigned length
)
1014 Aml
*var
= aml_alloc();
1015 /* ReservedField := 0x00 PkgLength */
1016 build_append_byte(var
->buf
, 0x00);
1017 build_append_pkg_length(var
->buf
, length
, false);
1021 /* ACPI 1.0b: 16.2.5.2 Named Objects Encoding: DefField */
1022 Aml
*aml_field(const char *name
, AmlAccessType type
, AmlLockRule lock
,
1025 Aml
*var
= aml_bundle(0x81 /* FieldOp */, AML_EXT_PACKAGE
);
1026 uint8_t flags
= rule
<< 5 | type
;
1028 flags
|= lock
<< 4; /* LockRule at 4 bit offset */
1030 build_append_namestring(var
->buf
, "%s", name
);
1031 build_append_byte(var
->buf
, flags
);
1036 Aml
*create_field_common(int opcode
, Aml
*srcbuf
, Aml
*index
, const char *name
)
1038 Aml
*var
= aml_opcode(opcode
);
1039 aml_append(var
, srcbuf
);
1040 aml_append(var
, index
);
1041 build_append_namestring(var
->buf
, "%s", name
);
1045 /* ACPI 1.0b: 16.2.5.2 Named Objects Encoding: DefCreateField */
1046 Aml
*aml_create_field(Aml
*srcbuf
, Aml
*bit_index
, Aml
*num_bits
,
1049 Aml
*var
= aml_alloc();
1050 build_append_byte(var
->buf
, 0x5B); /* ExtOpPrefix */
1051 build_append_byte(var
->buf
, 0x13); /* CreateFieldOp */
1052 aml_append(var
, srcbuf
);
1053 aml_append(var
, bit_index
);
1054 aml_append(var
, num_bits
);
1055 build_append_namestring(var
->buf
, "%s", name
);
1059 /* ACPI 1.0b: 16.2.5.2 Named Objects Encoding: DefCreateDWordField */
1060 Aml
*aml_create_dword_field(Aml
*srcbuf
, Aml
*index
, const char *name
)
1062 return create_field_common(0x8A /* CreateDWordFieldOp */,
1063 srcbuf
, index
, name
);
1066 /* ACPI 2.0a: 17.2.4.2 Named Objects Encoding: DefCreateQWordField */
1067 Aml
*aml_create_qword_field(Aml
*srcbuf
, Aml
*index
, const char *name
)
1069 return create_field_common(0x8F /* CreateQWordFieldOp */,
1070 srcbuf
, index
, name
);
1073 /* ACPI 1.0b: 16.2.3 Data Objects Encoding: String */
1074 Aml
*aml_string(const char *name_format
, ...)
1076 Aml
*var
= aml_opcode(0x0D /* StringPrefix */);
1081 va_start(ap
, name_format
);
1082 len
= g_vasprintf(&s
, name_format
, ap
);
1085 g_array_append_vals(var
->buf
, s
, len
+ 1);
1091 /* ACPI 1.0b: 16.2.6.2 Local Objects Encoding */
1092 Aml
*aml_local(int num
)
1094 uint8_t op
= 0x60 /* Local0Op */ + num
;
1097 return aml_opcode(op
);
1100 /* ACPI 2.0a: 17.2.2 Data Objects Encoding: DefVarPackage */
1101 Aml
*aml_varpackage(uint32_t num_elements
)
1103 Aml
*var
= aml_bundle(0x13 /* VarPackageOp */, AML_PACKAGE
);
1104 build_append_int(var
->buf
, num_elements
);
1108 /* ACPI 1.0b: 16.2.5.2 Named Objects Encoding: DefProcessor */
1109 Aml
*aml_processor(uint8_t proc_id
, uint32_t pblk_addr
, uint8_t pblk_len
,
1110 const char *name_format
, ...)
1113 Aml
*var
= aml_bundle(0x83 /* ProcessorOp */, AML_EXT_PACKAGE
);
1114 va_start(ap
, name_format
);
1115 build_append_namestringv(var
->buf
, name_format
, ap
);
1117 build_append_byte(var
->buf
, proc_id
); /* ProcID */
1118 build_append_int_noprefix(var
->buf
, pblk_addr
, sizeof(pblk_addr
));
1119 build_append_byte(var
->buf
, pblk_len
); /* PblkLen */
1123 static uint8_t Hex2Digit(char c
)
1126 return c
- 'A' + 10;
1132 /* ACPI 1.0b: 15.2.3.6.4.1 EISAID Macro - Convert EISA ID String To Integer */
1133 Aml
*aml_eisaid(const char *str
)
1135 Aml
*var
= aml_alloc();
1138 g_assert(strlen(str
) == 7);
1139 id
= (str
[0] - 0x40) << 26 |
1140 (str
[1] - 0x40) << 21 |
1141 (str
[2] - 0x40) << 16 |
1142 Hex2Digit(str
[3]) << 12 |
1143 Hex2Digit(str
[4]) << 8 |
1144 Hex2Digit(str
[5]) << 4 |
1147 build_append_byte(var
->buf
, 0x0C); /* DWordPrefix */
1148 build_append_int_noprefix(var
->buf
, bswap32(id
), sizeof(id
));
1152 /* ACPI 1.0b: 6.4.3.5.5 Word Address Space Descriptor: bytes 3-5 */
1153 static Aml
*aml_as_desc_header(AmlResourceType type
, AmlMinFixed min_fixed
,
1154 AmlMaxFixed max_fixed
, AmlDecode dec
,
1157 uint8_t flags
= max_fixed
| min_fixed
| dec
;
1158 Aml
*var
= aml_alloc();
1160 build_append_byte(var
->buf
, type
);
1161 build_append_byte(var
->buf
, flags
);
1162 build_append_byte(var
->buf
, type_flags
); /* Type Specific Flags */
1166 /* ACPI 1.0b: 6.4.3.5.5 Word Address Space Descriptor */
1167 static Aml
*aml_word_as_desc(AmlResourceType type
, AmlMinFixed min_fixed
,
1168 AmlMaxFixed max_fixed
, AmlDecode dec
,
1169 uint16_t addr_gran
, uint16_t addr_min
,
1170 uint16_t addr_max
, uint16_t addr_trans
,
1171 uint16_t len
, uint8_t type_flags
)
1173 Aml
*var
= aml_alloc();
1175 build_append_byte(var
->buf
, 0x88); /* Word Address Space Descriptor */
1176 /* minimum length since we do not encode optional fields */
1177 build_append_byte(var
->buf
, 0x0D);
1178 build_append_byte(var
->buf
, 0x0);
1181 aml_as_desc_header(type
, min_fixed
, max_fixed
, dec
, type_flags
));
1182 build_append_int_noprefix(var
->buf
, addr_gran
, sizeof(addr_gran
));
1183 build_append_int_noprefix(var
->buf
, addr_min
, sizeof(addr_min
));
1184 build_append_int_noprefix(var
->buf
, addr_max
, sizeof(addr_max
));
1185 build_append_int_noprefix(var
->buf
, addr_trans
, sizeof(addr_trans
));
1186 build_append_int_noprefix(var
->buf
, len
, sizeof(len
));
1190 /* ACPI 1.0b: 6.4.3.5.3 DWord Address Space Descriptor */
1191 static Aml
*aml_dword_as_desc(AmlResourceType type
, AmlMinFixed min_fixed
,
1192 AmlMaxFixed max_fixed
, AmlDecode dec
,
1193 uint32_t addr_gran
, uint32_t addr_min
,
1194 uint32_t addr_max
, uint32_t addr_trans
,
1195 uint32_t len
, uint8_t type_flags
)
1197 Aml
*var
= aml_alloc();
1199 build_append_byte(var
->buf
, 0x87); /* DWord Address Space Descriptor */
1200 /* minimum length since we do not encode optional fields */
1201 build_append_byte(var
->buf
, 23);
1202 build_append_byte(var
->buf
, 0x0);
1206 aml_as_desc_header(type
, min_fixed
, max_fixed
, dec
, type_flags
));
1207 build_append_int_noprefix(var
->buf
, addr_gran
, sizeof(addr_gran
));
1208 build_append_int_noprefix(var
->buf
, addr_min
, sizeof(addr_min
));
1209 build_append_int_noprefix(var
->buf
, addr_max
, sizeof(addr_max
));
1210 build_append_int_noprefix(var
->buf
, addr_trans
, sizeof(addr_trans
));
1211 build_append_int_noprefix(var
->buf
, len
, sizeof(len
));
1215 /* ACPI 1.0b: 6.4.3.5.1 QWord Address Space Descriptor */
1216 static Aml
*aml_qword_as_desc(AmlResourceType type
, AmlMinFixed min_fixed
,
1217 AmlMaxFixed max_fixed
, AmlDecode dec
,
1218 uint64_t addr_gran
, uint64_t addr_min
,
1219 uint64_t addr_max
, uint64_t addr_trans
,
1220 uint64_t len
, uint8_t type_flags
)
1222 Aml
*var
= aml_alloc();
1224 build_append_byte(var
->buf
, 0x8A); /* QWord Address Space Descriptor */
1225 /* minimum length since we do not encode optional fields */
1226 build_append_byte(var
->buf
, 0x2B);
1227 build_append_byte(var
->buf
, 0x0);
1230 aml_as_desc_header(type
, min_fixed
, max_fixed
, dec
, type_flags
));
1231 build_append_int_noprefix(var
->buf
, addr_gran
, sizeof(addr_gran
));
1232 build_append_int_noprefix(var
->buf
, addr_min
, sizeof(addr_min
));
1233 build_append_int_noprefix(var
->buf
, addr_max
, sizeof(addr_max
));
1234 build_append_int_noprefix(var
->buf
, addr_trans
, sizeof(addr_trans
));
1235 build_append_int_noprefix(var
->buf
, len
, sizeof(len
));
1240 * ACPI 1.0b: 6.4.3.5.6 ASL Macros for WORD Address Descriptor
1242 * More verbose description at:
1243 * ACPI 5.0: 19.5.141 WordBusNumber (Word Bus Number Resource Descriptor Macro)
1245 Aml
*aml_word_bus_number(AmlMinFixed min_fixed
, AmlMaxFixed max_fixed
,
1246 AmlDecode dec
, uint16_t addr_gran
,
1247 uint16_t addr_min
, uint16_t addr_max
,
1248 uint16_t addr_trans
, uint16_t len
)
1251 return aml_word_as_desc(AML_BUS_NUMBER_RANGE
, min_fixed
, max_fixed
, dec
,
1252 addr_gran
, addr_min
, addr_max
, addr_trans
, len
, 0);
1256 * ACPI 1.0b: 6.4.3.5.6 ASL Macros for WORD Address Descriptor
1258 * More verbose description at:
1259 * ACPI 5.0: 19.5.142 WordIO (Word IO Resource Descriptor Macro)
1261 Aml
*aml_word_io(AmlMinFixed min_fixed
, AmlMaxFixed max_fixed
,
1262 AmlDecode dec
, AmlISARanges isa_ranges
,
1263 uint16_t addr_gran
, uint16_t addr_min
,
1264 uint16_t addr_max
, uint16_t addr_trans
,
1268 return aml_word_as_desc(AML_IO_RANGE
, min_fixed
, max_fixed
, dec
,
1269 addr_gran
, addr_min
, addr_max
, addr_trans
, len
,
1274 * ACPI 1.0b: 6.4.3.5.4 ASL Macros for DWORD Address Descriptor
1276 * More verbose description at:
1277 * ACPI 5.0: 19.5.33 DWordIO (DWord IO Resource Descriptor Macro)
1279 Aml
*aml_dword_io(AmlMinFixed min_fixed
, AmlMaxFixed max_fixed
,
1280 AmlDecode dec
, AmlISARanges isa_ranges
,
1281 uint32_t addr_gran
, uint32_t addr_min
,
1282 uint32_t addr_max
, uint32_t addr_trans
,
1286 return aml_dword_as_desc(AML_IO_RANGE
, min_fixed
, max_fixed
, dec
,
1287 addr_gran
, addr_min
, addr_max
, addr_trans
, len
,
1292 * ACPI 1.0b: 6.4.3.5.4 ASL Macros for DWORD Address Space Descriptor
1294 * More verbose description at:
1295 * ACPI 5.0: 19.5.34 DWordMemory (DWord Memory Resource Descriptor Macro)
1297 Aml
*aml_dword_memory(AmlDecode dec
, AmlMinFixed min_fixed
,
1298 AmlMaxFixed max_fixed
, AmlCacheable cacheable
,
1299 AmlReadAndWrite read_and_write
,
1300 uint32_t addr_gran
, uint32_t addr_min
,
1301 uint32_t addr_max
, uint32_t addr_trans
,
1304 uint8_t flags
= read_and_write
| (cacheable
<< 1);
1306 return aml_dword_as_desc(AML_MEMORY_RANGE
, min_fixed
, max_fixed
,
1307 dec
, addr_gran
, addr_min
, addr_max
,
1308 addr_trans
, len
, flags
);
1312 * ACPI 1.0b: 6.4.3.5.2 ASL Macros for QWORD Address Space Descriptor
1314 * More verbose description at:
1315 * ACPI 5.0: 19.5.102 QWordMemory (QWord Memory Resource Descriptor Macro)
1317 Aml
*aml_qword_memory(AmlDecode dec
, AmlMinFixed min_fixed
,
1318 AmlMaxFixed max_fixed
, AmlCacheable cacheable
,
1319 AmlReadAndWrite read_and_write
,
1320 uint64_t addr_gran
, uint64_t addr_min
,
1321 uint64_t addr_max
, uint64_t addr_trans
,
1324 uint8_t flags
= read_and_write
| (cacheable
<< 1);
1326 return aml_qword_as_desc(AML_MEMORY_RANGE
, min_fixed
, max_fixed
,
1327 dec
, addr_gran
, addr_min
, addr_max
,
1328 addr_trans
, len
, flags
);
1331 /* ACPI 1.0b: 6.4.2.2 DMA Format/6.4.2.2.1 ASL Macro for DMA Descriptor */
1332 Aml
*aml_dma(AmlDmaType typ
, AmlDmaBusMaster bm
, AmlTransferSize sz
,
1335 Aml
*var
= aml_alloc();
1336 uint8_t flags
= sz
| bm
<< 2 | typ
<< 5;
1338 assert(channel
< 8);
1339 build_append_byte(var
->buf
, 0x2A); /* Byte 0: DMA Descriptor */
1340 build_append_byte(var
->buf
, 1U << channel
); /* Byte 1: _DMA - DmaChannel */
1341 build_append_byte(var
->buf
, flags
); /* Byte 2 */
1345 /* ACPI 1.0b: 16.2.5.3 Type 1 Opcodes Encoding: DefSleep */
1346 Aml
*aml_sleep(uint64_t msec
)
1348 Aml
*var
= aml_alloc();
1349 build_append_byte(var
->buf
, 0x5B); /* ExtOpPrefix */
1350 build_append_byte(var
->buf
, 0x22); /* SleepOp */
1351 aml_append(var
, aml_int(msec
));
1355 static uint8_t Hex2Byte(const char *src
)
1359 hi
= Hex2Digit(src
[0]);
1363 lo
= Hex2Digit(src
[1]);
1366 return (hi
<< 4) | lo
;
1370 * ACPI 3.0: 17.5.124 ToUUID (Convert String to UUID Macro)
1371 * e.g. UUID: aabbccdd-eeff-gghh-iijj-kkllmmnnoopp
1372 * call aml_touuid("aabbccdd-eeff-gghh-iijj-kkllmmnnoopp");
1374 Aml
*aml_touuid(const char *uuid
)
1376 Aml
*var
= aml_bundle(0x11 /* BufferOp */, AML_BUFFER
);
1378 assert(strlen(uuid
) == 36);
1379 assert(uuid
[8] == '-');
1380 assert(uuid
[13] == '-');
1381 assert(uuid
[18] == '-');
1382 assert(uuid
[23] == '-');
1384 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 6)); /* dd - at offset 00 */
1385 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 4)); /* cc - at offset 01 */
1386 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 2)); /* bb - at offset 02 */
1387 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 0)); /* aa - at offset 03 */
1389 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 11)); /* ff - at offset 04 */
1390 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 9)); /* ee - at offset 05 */
1392 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 16)); /* hh - at offset 06 */
1393 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 14)); /* gg - at offset 07 */
1395 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 19)); /* ii - at offset 08 */
1396 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 21)); /* jj - at offset 09 */
1398 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 24)); /* kk - at offset 10 */
1399 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 26)); /* ll - at offset 11 */
1400 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 28)); /* mm - at offset 12 */
1401 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 30)); /* nn - at offset 13 */
1402 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 32)); /* oo - at offset 14 */
1403 build_append_byte(var
->buf
, Hex2Byte(uuid
+ 34)); /* pp - at offset 15 */
1409 * ACPI 2.0b: 16.2.3.6.4.3 Unicode Macro (Convert Ascii String To Unicode)
1411 Aml
*aml_unicode(const char *str
)
1414 Aml
*var
= aml_bundle(0x11 /* BufferOp */, AML_BUFFER
);
1417 build_append_byte(var
->buf
, str
[i
]);
1418 build_append_byte(var
->buf
, 0);
1420 } while (i
<= strlen(str
));
1425 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefRefOf */
1426 Aml
*aml_refof(Aml
*arg
)
1428 Aml
*var
= aml_opcode(0x71 /* RefOfOp */);
1429 aml_append(var
, arg
);
1433 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefDerefOf */
1434 Aml
*aml_derefof(Aml
*arg
)
1436 Aml
*var
= aml_opcode(0x83 /* DerefOfOp */);
1437 aml_append(var
, arg
);
1441 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefSizeOf */
1442 Aml
*aml_sizeof(Aml
*arg
)
1444 Aml
*var
= aml_opcode(0x87 /* SizeOfOp */);
1445 aml_append(var
, arg
);
1449 /* ACPI 1.0b: 16.2.5.2 Named Objects Encoding: DefMutex */
1450 Aml
*aml_mutex(const char *name
, uint8_t sync_level
)
1452 Aml
*var
= aml_alloc();
1453 build_append_byte(var
->buf
, 0x5B); /* ExtOpPrefix */
1454 build_append_byte(var
->buf
, 0x01); /* MutexOp */
1455 build_append_namestring(var
->buf
, "%s", name
);
1456 assert(!(sync_level
& 0xF0));
1457 build_append_byte(var
->buf
, sync_level
);
1461 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefAcquire */
1462 Aml
*aml_acquire(Aml
*mutex
, uint16_t timeout
)
1464 Aml
*var
= aml_alloc();
1465 build_append_byte(var
->buf
, 0x5B); /* ExtOpPrefix */
1466 build_append_byte(var
->buf
, 0x23); /* AcquireOp */
1467 aml_append(var
, mutex
);
1468 build_append_int_noprefix(var
->buf
, timeout
, sizeof(timeout
));
1472 /* ACPI 1.0b: 16.2.5.3 Type 1 Opcodes Encoding: DefRelease */
1473 Aml
*aml_release(Aml
*mutex
)
1475 Aml
*var
= aml_alloc();
1476 build_append_byte(var
->buf
, 0x5B); /* ExtOpPrefix */
1477 build_append_byte(var
->buf
, 0x27); /* ReleaseOp */
1478 aml_append(var
, mutex
);
1482 /* ACPI 1.0b: 16.2.5.1 Name Space Modifier Objects Encoding: DefAlias */
1483 Aml
*aml_alias(const char *source_object
, const char *alias_object
)
1485 Aml
*var
= aml_opcode(0x06 /* AliasOp */);
1486 aml_append(var
, aml_name("%s", source_object
));
1487 aml_append(var
, aml_name("%s", alias_object
));
1491 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefConcat */
1492 Aml
*aml_concatenate(Aml
*source1
, Aml
*source2
, Aml
*target
)
1494 return build_opcode_2arg_dst(0x73 /* ConcatOp */, source1
, source2
,
1498 /* ACPI 1.0b: 16.2.5.4 Type 2 Opcodes Encoding: DefObjectType */
1499 Aml
*aml_object_type(Aml
*object
)
1501 Aml
*var
= aml_opcode(0x8E /* ObjectTypeOp */);
1502 aml_append(var
, object
);
1507 build_header(BIOSLinker
*linker
, GArray
*table_data
,
1508 AcpiTableHeader
*h
, const char *sig
, int len
, uint8_t rev
,
1509 const char *oem_id
, const char *oem_table_id
)
1511 unsigned tbl_offset
= (char *)h
- table_data
->data
;
1512 unsigned checksum_offset
= (char *)&h
->checksum
- table_data
->data
;
1513 memcpy(&h
->signature
, sig
, 4);
1514 h
->length
= cpu_to_le32(len
);
1518 strncpy((char *)h
->oem_id
, oem_id
, sizeof h
->oem_id
);
1520 memcpy(h
->oem_id
, ACPI_BUILD_APPNAME6
, 6);
1524 strncpy((char *)h
->oem_table_id
, oem_table_id
, sizeof(h
->oem_table_id
));
1526 memcpy(h
->oem_table_id
, ACPI_BUILD_APPNAME4
, 4);
1527 memcpy(h
->oem_table_id
+ 4, sig
, 4);
1530 h
->oem_revision
= cpu_to_le32(1);
1531 memcpy(h
->asl_compiler_id
, ACPI_BUILD_APPNAME4
, 4);
1532 h
->asl_compiler_revision
= cpu_to_le32(1);
1533 /* Checksum to be filled in by Guest linker */
1534 bios_linker_loader_add_checksum(linker
, ACPI_BUILD_TABLE_FILE
,
1535 tbl_offset
, len
, checksum_offset
);
1538 void *acpi_data_push(GArray
*table_data
, unsigned size
)
1540 unsigned off
= table_data
->len
;
1541 g_array_set_size(table_data
, off
+ size
);
1542 return table_data
->data
+ off
;
1545 unsigned acpi_data_len(GArray
*table
)
1547 assert(g_array_get_element_size(table
) == 1);
1551 void acpi_add_table(GArray
*table_offsets
, GArray
*table_data
)
1553 uint32_t offset
= table_data
->len
;
1554 g_array_append_val(table_offsets
, offset
);
1557 void acpi_build_tables_init(AcpiBuildTables
*tables
)
1559 tables
->rsdp
= g_array_new(false, true /* clear */, 1);
1560 tables
->table_data
= g_array_new(false, true /* clear */, 1);
1561 tables
->tcpalog
= g_array_new(false, true /* clear */, 1);
1562 tables
->linker
= bios_linker_loader_init();
1565 void acpi_build_tables_cleanup(AcpiBuildTables
*tables
, bool mfre
)
1567 bios_linker_loader_cleanup(tables
->linker
);
1568 g_array_free(tables
->rsdp
, true);
1569 g_array_free(tables
->table_data
, true);
1570 g_array_free(tables
->tcpalog
, mfre
);
1573 /* Build rsdt table */
1575 build_rsdt(GArray
*table_data
, BIOSLinker
*linker
, GArray
*table_offsets
,
1576 const char *oem_id
, const char *oem_table_id
)
1579 unsigned rsdt_entries_offset
;
1580 AcpiRsdtDescriptorRev1
*rsdt
;
1581 const unsigned table_data_len
= (sizeof(uint32_t) * table_offsets
->len
);
1582 const unsigned rsdt_entry_size
= sizeof(rsdt
->table_offset_entry
[0]);
1583 const size_t rsdt_len
= sizeof(*rsdt
) + table_data_len
;
1585 rsdt
= acpi_data_push(table_data
, rsdt_len
);
1586 rsdt_entries_offset
= (char *)rsdt
->table_offset_entry
- table_data
->data
;
1587 for (i
= 0; i
< table_offsets
->len
; ++i
) {
1588 uint32_t ref_tbl_offset
= g_array_index(table_offsets
, uint32_t, i
);
1589 uint32_t rsdt_entry_offset
= rsdt_entries_offset
+ rsdt_entry_size
* i
;
1591 /* rsdt->table_offset_entry to be filled by Guest linker */
1592 bios_linker_loader_add_pointer(linker
,
1593 ACPI_BUILD_TABLE_FILE
, rsdt_entry_offset
, rsdt_entry_size
,
1594 ACPI_BUILD_TABLE_FILE
, ref_tbl_offset
);
1596 build_header(linker
, table_data
,
1597 (void *)rsdt
, "RSDT", rsdt_len
, 1, oem_id
, oem_table_id
);
1600 void build_srat_memory(AcpiSratMemoryAffinity
*numamem
, uint64_t base
,
1601 uint64_t len
, int node
, MemoryAffinityFlags flags
)
1603 numamem
->type
= ACPI_SRAT_MEMORY
;
1604 numamem
->length
= sizeof(*numamem
);
1605 numamem
->proximity
= cpu_to_le32(node
);
1606 numamem
->flags
= cpu_to_le32(flags
);
1607 numamem
->base_addr
= cpu_to_le64(base
);
1608 numamem
->range_length
= cpu_to_le64(len
);