4 * Copyright (c) 2006 Fabrice Bellard
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License version 2 as published by the Free Software Foundation.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, see <http://www.gnu.org/licenses/>
18 * Contributions after 2012-01-13 are licensed under the terms of the
19 * GNU GPL, version 2 or (at your option) any later version.
22 #include "qemu/osdep.h"
23 #include "sysemu/sysemu.h"
25 #include "hw/acpi/acpi.h"
26 #include "hw/nvram/fw_cfg.h"
27 #include "qemu/config-file.h"
28 #include "qapi/error.h"
29 #include "qapi/opts-visitor.h"
30 #include "qapi/qapi-events-run-state.h"
31 #include "qapi/qapi-visit-misc.h"
32 #include "qemu/error-report.h"
33 #include "qemu/option.h"
35 struct acpi_table_header
{
36 uint16_t _length
; /* our length, not actual part of the hdr */
37 /* allows easier parsing for fw_cfg clients */
38 char sig
[4]; /* ACPI signature (4 ASCII characters) */
39 uint32_t length
; /* Length of table, in bytes, including header */
40 uint8_t revision
; /* ACPI Specification minor version # */
41 uint8_t checksum
; /* To make sum of entire table == 0 */
42 char oem_id
[6]; /* OEM identification */
43 char oem_table_id
[8]; /* OEM table identification */
44 uint32_t oem_revision
; /* OEM revision number */
45 char asl_compiler_id
[4]; /* ASL compiler vendor ID */
46 uint32_t asl_compiler_revision
; /* ASL compiler revision number */
49 #define ACPI_TABLE_HDR_SIZE sizeof(struct acpi_table_header)
50 #define ACPI_TABLE_PFX_SIZE sizeof(uint16_t) /* size of the extra prefix */
52 static const char unsigned dfl_hdr
[ACPI_TABLE_HDR_SIZE
- ACPI_TABLE_PFX_SIZE
] =
53 "QEMU\0\0\0\0\1\0" /* sig (4), len(4), revno (1), csum (1) */
54 "QEMUQEQEMUQEMU\1\0\0\0" /* OEM id (6), table (8), revno (4) */
55 "QEMU\1\0\0\0" /* ASL compiler ID (4), version (4) */
58 char unsigned *acpi_tables
;
59 size_t acpi_tables_len
;
61 static QemuOptsList qemu_acpi_opts
= {
63 .implied_opt_name
= "data",
64 .head
= QTAILQ_HEAD_INITIALIZER(qemu_acpi_opts
.head
),
65 .desc
= { { 0 } } /* validated with OptsVisitor */
68 static void acpi_register_config(void)
70 qemu_add_opts(&qemu_acpi_opts
);
73 opts_init(acpi_register_config
);
75 static int acpi_checksum(const uint8_t *data
, int len
)
79 for (i
= 0; i
< len
; i
++) {
86 /* Install a copy of the ACPI table specified in @blob.
88 * If @has_header is set, @blob starts with the System Description Table Header
89 * structure. Otherwise, "dfl_hdr" is prepended. In any case, each header field
90 * is optionally overwritten from @hdrs.
92 * It is valid to call this function with
93 * (@blob == NULL && bloblen == 0 && !has_header).
95 * @hdrs->file and @hdrs->data are ignored.
97 * SIZE_MAX is considered "infinity" in this function.
99 * The number of tables that can be installed is not limited, but the 16-bit
100 * counter at the beginning of "acpi_tables" wraps around after UINT16_MAX.
102 static void acpi_table_install(const char unsigned *blob
, size_t bloblen
,
104 const struct AcpiTableOptions
*hdrs
,
108 const char unsigned *hdr_src
;
109 size_t body_size
, acpi_payload_size
;
110 struct acpi_table_header
*ext_hdr
;
111 unsigned changed_fields
;
113 /* Calculate where the ACPI table body starts within the blob, plus where
114 * to copy the ACPI table header from.
117 /* _length | ACPI header in blob | blob body
118 * ^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^
119 * ACPI_TABLE_PFX_SIZE sizeof dfl_hdr body_size
122 * ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
123 * acpi_payload_size == bloblen
125 body_start
= sizeof dfl_hdr
;
127 if (bloblen
< body_start
) {
128 error_setg(errp
, "ACPI table claiming to have header is too "
129 "short, available: %zu, expected: %zu", bloblen
,
135 /* _length | ACPI header in template | blob body
136 * ^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^
137 * ACPI_TABLE_PFX_SIZE sizeof dfl_hdr body_size
140 * ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
146 body_size
= bloblen
- body_start
;
147 acpi_payload_size
= sizeof dfl_hdr
+ body_size
;
149 if (acpi_payload_size
> UINT16_MAX
) {
150 error_setg(errp
, "ACPI table too big, requested: %zu, max: %u",
151 acpi_payload_size
, (unsigned)UINT16_MAX
);
155 /* We won't fail from here on. Initialize / extend the globals. */
156 if (acpi_tables
== NULL
) {
157 acpi_tables_len
= sizeof(uint16_t);
158 acpi_tables
= g_malloc0(acpi_tables_len
);
161 acpi_tables
= g_realloc(acpi_tables
, acpi_tables_len
+
162 ACPI_TABLE_PFX_SIZE
+
163 sizeof dfl_hdr
+ body_size
);
165 ext_hdr
= (struct acpi_table_header
*)(acpi_tables
+ acpi_tables_len
);
166 acpi_tables_len
+= ACPI_TABLE_PFX_SIZE
;
168 memcpy(acpi_tables
+ acpi_tables_len
, hdr_src
, sizeof dfl_hdr
);
169 acpi_tables_len
+= sizeof dfl_hdr
;
172 memcpy(acpi_tables
+ acpi_tables_len
, blob
+ body_start
, body_size
);
173 acpi_tables_len
+= body_size
;
176 /* increase number of tables */
177 stw_le_p(acpi_tables
, lduw_le_p(acpi_tables
) + 1u);
179 /* Update the header fields. The strings need not be NUL-terminated. */
181 ext_hdr
->_length
= cpu_to_le16(acpi_payload_size
);
184 strncpy(ext_hdr
->sig
, hdrs
->sig
, sizeof ext_hdr
->sig
);
188 if (has_header
&& le32_to_cpu(ext_hdr
->length
) != acpi_payload_size
) {
189 warn_report("ACPI table has wrong length, header says "
190 "%" PRIu32
", actual size %zu bytes",
191 le32_to_cpu(ext_hdr
->length
), acpi_payload_size
);
193 ext_hdr
->length
= cpu_to_le32(acpi_payload_size
);
196 ext_hdr
->revision
= hdrs
->rev
;
200 ext_hdr
->checksum
= 0;
202 if (hdrs
->has_oem_id
) {
203 strncpy(ext_hdr
->oem_id
, hdrs
->oem_id
, sizeof ext_hdr
->oem_id
);
206 if (hdrs
->has_oem_table_id
) {
207 strncpy(ext_hdr
->oem_table_id
, hdrs
->oem_table_id
,
208 sizeof ext_hdr
->oem_table_id
);
211 if (hdrs
->has_oem_rev
) {
212 ext_hdr
->oem_revision
= cpu_to_le32(hdrs
->oem_rev
);
215 if (hdrs
->has_asl_compiler_id
) {
216 strncpy(ext_hdr
->asl_compiler_id
, hdrs
->asl_compiler_id
,
217 sizeof ext_hdr
->asl_compiler_id
);
220 if (hdrs
->has_asl_compiler_rev
) {
221 ext_hdr
->asl_compiler_revision
= cpu_to_le32(hdrs
->asl_compiler_rev
);
225 if (!has_header
&& changed_fields
== 0) {
226 warn_report("ACPI table: no headers are specified");
229 /* recalculate checksum */
230 ext_hdr
->checksum
= acpi_checksum((const char unsigned *)ext_hdr
+
231 ACPI_TABLE_PFX_SIZE
, acpi_payload_size
);
234 void acpi_table_add(const QemuOpts
*opts
, Error
**errp
)
236 AcpiTableOptions
*hdrs
= NULL
;
238 char **pathnames
= NULL
;
241 char unsigned *blob
= NULL
;
246 v
= opts_visitor_new(opts
);
247 visit_type_AcpiTableOptions(v
, NULL
, &hdrs
, &err
);
254 if (hdrs
->has_file
== hdrs
->has_data
) {
255 error_setg(&err
, "'-acpitable' requires one of 'data' or 'file'");
259 pathnames
= g_strsplit(hdrs
->has_file
? hdrs
->file
: hdrs
->data
, ":", 0);
260 if (pathnames
== NULL
|| pathnames
[0] == NULL
) {
261 error_setg(&err
, "'-acpitable' requires at least one pathname");
265 /* now read in the data files, reallocating buffer as needed */
266 for (cur
= pathnames
; *cur
; ++cur
) {
267 int fd
= open(*cur
, O_RDONLY
| O_BINARY
);
270 error_setg(&err
, "can't open file %s: %s", *cur
, strerror(errno
));
275 char unsigned data
[8192];
278 r
= read(fd
, data
, sizeof data
);
282 blob
= g_realloc(blob
, bloblen
+ r
);
283 memcpy(blob
+ bloblen
, data
, r
);
285 } else if (errno
!= EINTR
) {
286 error_setg(&err
, "can't read file %s: %s",
287 *cur
, strerror(errno
));
296 acpi_table_install(blob
, bloblen
, hdrs
->has_file
, hdrs
, &err
);
300 g_strfreev(pathnames
);
301 qapi_free_AcpiTableOptions(hdrs
);
303 error_propagate(errp
, err
);
306 static bool acpi_table_builtin
= false;
308 void acpi_table_add_builtin(const QemuOpts
*opts
, Error
**errp
)
310 acpi_table_builtin
= true;
311 acpi_table_add(opts
, errp
);
314 unsigned acpi_table_len(void *current
)
316 struct acpi_table_header
*hdr
= current
- sizeof(hdr
->_length
);
321 void *acpi_table_hdr(void *h
)
323 struct acpi_table_header
*hdr
= h
;
327 uint8_t *acpi_table_first(void)
329 if (acpi_table_builtin
|| !acpi_tables
) {
332 return acpi_table_hdr(acpi_tables
+ ACPI_TABLE_PFX_SIZE
);
335 uint8_t *acpi_table_next(uint8_t *current
)
337 uint8_t *next
= current
+ acpi_table_len(current
);
339 if (next
- acpi_tables
>= acpi_tables_len
) {
342 return acpi_table_hdr(next
);
346 int acpi_get_slic_oem(AcpiSlicOem
*oem
)
350 for (u
= acpi_table_first(); u
; u
= acpi_table_next(u
)) {
351 struct acpi_table_header
*hdr
= (void *)(u
- sizeof(hdr
->_length
));
353 if (memcmp(hdr
->sig
, "SLIC", 4) == 0) {
354 oem
->id
= hdr
->oem_id
;
355 oem
->table_id
= hdr
->oem_table_id
;
362 static void acpi_notify_wakeup(Notifier
*notifier
, void *data
)
364 ACPIREGS
*ar
= container_of(notifier
, ACPIREGS
, wakeup
);
365 WakeupReason
*reason
= data
;
368 case QEMU_WAKEUP_REASON_RTC
:
370 (ACPI_BITMASK_WAKE_STATUS
| ACPI_BITMASK_RT_CLOCK_STATUS
);
372 case QEMU_WAKEUP_REASON_PMTIMER
:
374 (ACPI_BITMASK_WAKE_STATUS
| ACPI_BITMASK_TIMER_STATUS
);
376 case QEMU_WAKEUP_REASON_OTHER
:
377 /* ACPI_BITMASK_WAKE_STATUS should be set on resume.
378 Pretend that resume was caused by power button */
380 (ACPI_BITMASK_WAKE_STATUS
| ACPI_BITMASK_POWER_BUTTON_STATUS
);
388 uint16_t acpi_pm1_evt_get_sts(ACPIREGS
*ar
)
390 /* Compare ns-clock, not PM timer ticks, because
391 acpi_pm_tmr_update function uses ns for setting the timer. */
392 int64_t d
= qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL
);
393 if (d
>= muldiv64(ar
->tmr
.overflow_time
,
394 NANOSECONDS_PER_SECOND
, PM_TIMER_FREQUENCY
)) {
395 ar
->pm1
.evt
.sts
|= ACPI_BITMASK_TIMER_STATUS
;
397 return ar
->pm1
.evt
.sts
;
400 static void acpi_pm1_evt_write_sts(ACPIREGS
*ar
, uint16_t val
)
402 uint16_t pm1_sts
= acpi_pm1_evt_get_sts(ar
);
403 if (pm1_sts
& val
& ACPI_BITMASK_TIMER_STATUS
) {
404 /* if TMRSTS is reset, then compute the new overflow time */
405 acpi_pm_tmr_calc_overflow_time(ar
);
407 ar
->pm1
.evt
.sts
&= ~val
;
410 static void acpi_pm1_evt_write_en(ACPIREGS
*ar
, uint16_t val
)
412 ar
->pm1
.evt
.en
= val
;
413 qemu_system_wakeup_enable(QEMU_WAKEUP_REASON_RTC
,
414 val
& ACPI_BITMASK_RT_CLOCK_ENABLE
);
415 qemu_system_wakeup_enable(QEMU_WAKEUP_REASON_PMTIMER
,
416 val
& ACPI_BITMASK_TIMER_ENABLE
);
419 void acpi_pm1_evt_power_down(ACPIREGS
*ar
)
421 if (ar
->pm1
.evt
.en
& ACPI_BITMASK_POWER_BUTTON_ENABLE
) {
422 ar
->pm1
.evt
.sts
|= ACPI_BITMASK_POWER_BUTTON_STATUS
;
423 ar
->tmr
.update_sci(ar
);
427 void acpi_pm1_evt_reset(ACPIREGS
*ar
)
431 qemu_system_wakeup_enable(QEMU_WAKEUP_REASON_RTC
, 0);
432 qemu_system_wakeup_enable(QEMU_WAKEUP_REASON_PMTIMER
, 0);
435 static uint64_t acpi_pm_evt_read(void *opaque
, hwaddr addr
, unsigned width
)
437 ACPIREGS
*ar
= opaque
;
440 return acpi_pm1_evt_get_sts(ar
);
442 return ar
->pm1
.evt
.en
;
448 static void acpi_pm_evt_write(void *opaque
, hwaddr addr
, uint64_t val
,
451 ACPIREGS
*ar
= opaque
;
454 acpi_pm1_evt_write_sts(ar
, val
);
455 ar
->pm1
.evt
.update_sci(ar
);
458 acpi_pm1_evt_write_en(ar
, val
);
459 ar
->pm1
.evt
.update_sci(ar
);
464 static const MemoryRegionOps acpi_pm_evt_ops
= {
465 .read
= acpi_pm_evt_read
,
466 .write
= acpi_pm_evt_write
,
467 .valid
.min_access_size
= 2,
468 .valid
.max_access_size
= 2,
469 .endianness
= DEVICE_LITTLE_ENDIAN
,
472 void acpi_pm1_evt_init(ACPIREGS
*ar
, acpi_update_sci_fn update_sci
,
473 MemoryRegion
*parent
)
475 ar
->pm1
.evt
.update_sci
= update_sci
;
476 memory_region_init_io(&ar
->pm1
.evt
.io
, memory_region_owner(parent
),
477 &acpi_pm_evt_ops
, ar
, "acpi-evt", 4);
478 memory_region_add_subregion(parent
, 0, &ar
->pm1
.evt
.io
);
482 void acpi_pm_tmr_update(ACPIREGS
*ar
, bool enable
)
486 /* schedule a timer interruption if needed */
488 expire_time
= muldiv64(ar
->tmr
.overflow_time
, NANOSECONDS_PER_SECOND
,
490 timer_mod(ar
->tmr
.timer
, expire_time
);
492 timer_del(ar
->tmr
.timer
);
496 static inline int64_t acpi_pm_tmr_get_clock(void)
498 return muldiv64(qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL
), PM_TIMER_FREQUENCY
,
499 NANOSECONDS_PER_SECOND
);
502 void acpi_pm_tmr_calc_overflow_time(ACPIREGS
*ar
)
504 int64_t d
= acpi_pm_tmr_get_clock();
505 ar
->tmr
.overflow_time
= (d
+ 0x800000LL
) & ~0x7fffffLL
;
508 static uint32_t acpi_pm_tmr_get(ACPIREGS
*ar
)
510 uint32_t d
= acpi_pm_tmr_get_clock();
514 static void acpi_pm_tmr_timer(void *opaque
)
516 ACPIREGS
*ar
= opaque
;
518 qemu_system_wakeup_request(QEMU_WAKEUP_REASON_PMTIMER
, NULL
);
519 ar
->tmr
.update_sci(ar
);
522 static uint64_t acpi_pm_tmr_read(void *opaque
, hwaddr addr
, unsigned width
)
524 return acpi_pm_tmr_get(opaque
);
527 static void acpi_pm_tmr_write(void *opaque
, hwaddr addr
, uint64_t val
,
533 static const MemoryRegionOps acpi_pm_tmr_ops
= {
534 .read
= acpi_pm_tmr_read
,
535 .write
= acpi_pm_tmr_write
,
536 .valid
.min_access_size
= 4,
537 .valid
.max_access_size
= 4,
538 .endianness
= DEVICE_LITTLE_ENDIAN
,
541 void acpi_pm_tmr_init(ACPIREGS
*ar
, acpi_update_sci_fn update_sci
,
542 MemoryRegion
*parent
)
544 ar
->tmr
.update_sci
= update_sci
;
545 ar
->tmr
.timer
= timer_new_ns(QEMU_CLOCK_VIRTUAL
, acpi_pm_tmr_timer
, ar
);
546 memory_region_init_io(&ar
->tmr
.io
, memory_region_owner(parent
),
547 &acpi_pm_tmr_ops
, ar
, "acpi-tmr", 4);
548 memory_region_add_subregion(parent
, 8, &ar
->tmr
.io
);
551 void acpi_pm_tmr_reset(ACPIREGS
*ar
)
553 ar
->tmr
.overflow_time
= 0;
554 timer_del(ar
->tmr
.timer
);
558 static void acpi_pm1_cnt_write(ACPIREGS
*ar
, uint16_t val
)
560 ar
->pm1
.cnt
.cnt
= val
& ~(ACPI_BITMASK_SLEEP_ENABLE
);
562 if (val
& ACPI_BITMASK_SLEEP_ENABLE
) {
563 /* change suspend type */
564 uint16_t sus_typ
= (val
>> 10) & 7;
566 case 0: /* soft power off */
567 qemu_system_shutdown_request(SHUTDOWN_CAUSE_GUEST_SHUTDOWN
);
570 qemu_system_suspend_request();
573 if (sus_typ
== ar
->pm1
.cnt
.s4_val
) { /* S4 request */
574 qapi_event_send_suspend_disk();
575 qemu_system_shutdown_request(SHUTDOWN_CAUSE_GUEST_SHUTDOWN
);
582 void acpi_pm1_cnt_update(ACPIREGS
*ar
,
583 bool sci_enable
, bool sci_disable
)
585 /* ACPI specs 3.0, 4.7.2.5 */
587 ar
->pm1
.cnt
.cnt
|= ACPI_BITMASK_SCI_ENABLE
;
588 } else if (sci_disable
) {
589 ar
->pm1
.cnt
.cnt
&= ~ACPI_BITMASK_SCI_ENABLE
;
593 static uint64_t acpi_pm_cnt_read(void *opaque
, hwaddr addr
, unsigned width
)
595 ACPIREGS
*ar
= opaque
;
596 return ar
->pm1
.cnt
.cnt
;
599 static void acpi_pm_cnt_write(void *opaque
, hwaddr addr
, uint64_t val
,
602 acpi_pm1_cnt_write(opaque
, val
);
605 static const MemoryRegionOps acpi_pm_cnt_ops
= {
606 .read
= acpi_pm_cnt_read
,
607 .write
= acpi_pm_cnt_write
,
608 .valid
.min_access_size
= 2,
609 .valid
.max_access_size
= 2,
610 .endianness
= DEVICE_LITTLE_ENDIAN
,
613 void acpi_pm1_cnt_init(ACPIREGS
*ar
, MemoryRegion
*parent
,
614 bool disable_s3
, bool disable_s4
, uint8_t s4_val
)
618 ar
->pm1
.cnt
.s4_val
= s4_val
;
619 ar
->wakeup
.notify
= acpi_notify_wakeup
;
620 qemu_register_wakeup_notifier(&ar
->wakeup
);
623 * Register wake-up support in QMP query-current-machine API
625 qemu_register_wakeup_support();
627 memory_region_init_io(&ar
->pm1
.cnt
.io
, memory_region_owner(parent
),
628 &acpi_pm_cnt_ops
, ar
, "acpi-cnt", 2);
629 memory_region_add_subregion(parent
, 4, &ar
->pm1
.cnt
.io
);
631 fw_cfg
= fw_cfg_find();
633 uint8_t suspend
[6] = {128, 0, 0, 129, 128, 128};
634 suspend
[3] = 1 | ((!disable_s3
) << 7);
635 suspend
[4] = s4_val
| ((!disable_s4
) << 7);
637 fw_cfg_add_file(fw_cfg
, "etc/system-states", g_memdup(suspend
, 6), 6);
641 void acpi_pm1_cnt_reset(ACPIREGS
*ar
)
647 void acpi_gpe_init(ACPIREGS
*ar
, uint8_t len
)
650 /* Only first len / 2 bytes are ever used,
651 * but the caller in ich9.c migrates full len bytes.
652 * TODO: fix ich9.c and drop the extra allocation.
654 ar
->gpe
.sts
= g_malloc0(len
);
655 ar
->gpe
.en
= g_malloc0(len
);
658 void acpi_gpe_reset(ACPIREGS
*ar
)
660 memset(ar
->gpe
.sts
, 0, ar
->gpe
.len
/ 2);
661 memset(ar
->gpe
.en
, 0, ar
->gpe
.len
/ 2);
664 static uint8_t *acpi_gpe_ioport_get_ptr(ACPIREGS
*ar
, uint32_t addr
)
668 if (addr
< ar
->gpe
.len
/ 2) {
669 cur
= ar
->gpe
.sts
+ addr
;
670 } else if (addr
< ar
->gpe
.len
) {
671 cur
= ar
->gpe
.en
+ addr
- ar
->gpe
.len
/ 2;
679 void acpi_gpe_ioport_writeb(ACPIREGS
*ar
, uint32_t addr
, uint32_t val
)
683 cur
= acpi_gpe_ioport_get_ptr(ar
, addr
);
684 if (addr
< ar
->gpe
.len
/ 2) {
686 *cur
= (*cur
) & ~val
;
687 } else if (addr
< ar
->gpe
.len
) {
695 uint32_t acpi_gpe_ioport_readb(ACPIREGS
*ar
, uint32_t addr
)
700 cur
= acpi_gpe_ioport_get_ptr(ar
, addr
);
709 void acpi_send_gpe_event(ACPIREGS
*ar
, qemu_irq irq
,
710 AcpiEventStatusBits status
)
712 ar
->gpe
.sts
[0] |= status
;
713 acpi_update_sci(ar
, irq
);
716 void acpi_update_sci(ACPIREGS
*regs
, qemu_irq irq
)
718 int sci_level
, pm1a_sts
;
720 pm1a_sts
= acpi_pm1_evt_get_sts(regs
);
722 sci_level
= ((pm1a_sts
&
723 regs
->pm1
.evt
.en
& ACPI_BITMASK_PM1_COMMON_ENABLED
) != 0) ||
724 ((regs
->gpe
.sts
[0] & regs
->gpe
.en
[0]) != 0);
726 qemu_set_irq(irq
, sci_level
);
728 /* schedule a timer interruption if needed */
729 acpi_pm_tmr_update(regs
,
730 (regs
->pm1
.evt
.en
& ACPI_BITMASK_TIMER_ENABLE
) &&
731 !(pm1a_sts
& ACPI_BITMASK_TIMER_STATUS
));