2 * acpi_osl.c - OS-dependent functions ($Revision: 83 $)
4 * Copyright (C) 2000 Andrew Henroid
5 * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com>
6 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
7 * Copyright (c) 2008 Intel Corporation
8 * Author: Matthew Wilcox <willy@linux.intel.com>
10 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
26 #include <linux/module.h>
27 #include <linux/kernel.h>
28 #include <linux/slab.h>
30 #include <linux/highmem.h>
31 #include <linux/pci.h>
32 #include <linux/interrupt.h>
33 #include <linux/kmod.h>
34 #include <linux/delay.h>
35 #include <linux/workqueue.h>
36 #include <linux/nmi.h>
37 #include <linux/acpi.h>
38 #include <linux/efi.h>
39 #include <linux/ioport.h>
40 #include <linux/list.h>
41 #include <linux/jiffies.h>
42 #include <linux/semaphore.h>
45 #include <linux/uaccess.h>
46 #include <linux/io-64-nonatomic-lo-hi.h>
48 #include "acpica/accommon.h"
49 #include "acpica/acnamesp.h"
52 #define _COMPONENT ACPI_OS_SERVICES
53 ACPI_MODULE_NAME("osl");
56 acpi_osd_exec_callback function
;
58 struct work_struct work
;
61 #ifdef ENABLE_DEBUGGER
62 #include <linux/kdb.h>
64 /* stuff for debugger support */
66 EXPORT_SYMBOL(acpi_in_debugger
);
67 #endif /*ENABLE_DEBUGGER */
69 static int (*__acpi_os_prepare_sleep
)(u8 sleep_state
, u32 pm1a_ctrl
,
71 static int (*__acpi_os_prepare_extended_sleep
)(u8 sleep_state
, u32 val_a
,
74 static acpi_osd_handler acpi_irq_handler
;
75 static void *acpi_irq_context
;
76 static struct workqueue_struct
*kacpid_wq
;
77 static struct workqueue_struct
*kacpi_notify_wq
;
78 static struct workqueue_struct
*kacpi_hotplug_wq
;
79 static bool acpi_os_initialized
;
80 unsigned int acpi_sci_irq
= INVALID_ACPI_IRQ
;
81 bool acpi_permanent_mmap
= false;
84 * This list of permanent mappings is for memory that may be accessed from
85 * interrupt context, where we can't do the ioremap().
88 struct list_head list
;
90 acpi_physical_address phys
;
92 unsigned long refcount
;
95 static LIST_HEAD(acpi_ioremaps
);
96 static DEFINE_MUTEX(acpi_ioremap_lock
);
98 static void __init
acpi_request_region (struct acpi_generic_address
*gas
,
99 unsigned int length
, char *desc
)
103 /* Handle possible alignment issues */
104 memcpy(&addr
, &gas
->address
, sizeof(addr
));
105 if (!addr
|| !length
)
108 /* Resources are never freed */
109 if (gas
->space_id
== ACPI_ADR_SPACE_SYSTEM_IO
)
110 request_region(addr
, length
, desc
);
111 else if (gas
->space_id
== ACPI_ADR_SPACE_SYSTEM_MEMORY
)
112 request_mem_region(addr
, length
, desc
);
115 static int __init
acpi_reserve_resources(void)
117 acpi_request_region(&acpi_gbl_FADT
.xpm1a_event_block
, acpi_gbl_FADT
.pm1_event_length
,
118 "ACPI PM1a_EVT_BLK");
120 acpi_request_region(&acpi_gbl_FADT
.xpm1b_event_block
, acpi_gbl_FADT
.pm1_event_length
,
121 "ACPI PM1b_EVT_BLK");
123 acpi_request_region(&acpi_gbl_FADT
.xpm1a_control_block
, acpi_gbl_FADT
.pm1_control_length
,
124 "ACPI PM1a_CNT_BLK");
126 acpi_request_region(&acpi_gbl_FADT
.xpm1b_control_block
, acpi_gbl_FADT
.pm1_control_length
,
127 "ACPI PM1b_CNT_BLK");
129 if (acpi_gbl_FADT
.pm_timer_length
== 4)
130 acpi_request_region(&acpi_gbl_FADT
.xpm_timer_block
, 4, "ACPI PM_TMR");
132 acpi_request_region(&acpi_gbl_FADT
.xpm2_control_block
, acpi_gbl_FADT
.pm2_control_length
,
135 /* Length of GPE blocks must be a non-negative multiple of 2 */
137 if (!(acpi_gbl_FADT
.gpe0_block_length
& 0x1))
138 acpi_request_region(&acpi_gbl_FADT
.xgpe0_block
,
139 acpi_gbl_FADT
.gpe0_block_length
, "ACPI GPE0_BLK");
141 if (!(acpi_gbl_FADT
.gpe1_block_length
& 0x1))
142 acpi_request_region(&acpi_gbl_FADT
.xgpe1_block
,
143 acpi_gbl_FADT
.gpe1_block_length
, "ACPI GPE1_BLK");
147 fs_initcall_sync(acpi_reserve_resources
);
149 void acpi_os_printf(const char *fmt
, ...)
153 acpi_os_vprintf(fmt
, args
);
156 EXPORT_SYMBOL(acpi_os_printf
);
158 void acpi_os_vprintf(const char *fmt
, va_list args
)
160 static char buffer
[512];
162 vsprintf(buffer
, fmt
, args
);
164 #ifdef ENABLE_DEBUGGER
165 if (acpi_in_debugger
) {
166 kdb_printf("%s", buffer
);
168 if (printk_get_level(buffer
))
169 printk("%s", buffer
);
171 printk(KERN_CONT
"%s", buffer
);
174 if (acpi_debugger_write_log(buffer
) < 0) {
175 if (printk_get_level(buffer
))
176 printk("%s", buffer
);
178 printk(KERN_CONT
"%s", buffer
);
184 static unsigned long acpi_rsdp
;
185 static int __init
setup_acpi_rsdp(char *arg
)
187 return kstrtoul(arg
, 16, &acpi_rsdp
);
189 early_param("acpi_rsdp", setup_acpi_rsdp
);
192 acpi_physical_address __init
acpi_os_get_root_pointer(void)
194 acpi_physical_address pa
;
200 pa
= acpi_arch_get_root_pointer();
204 if (efi_enabled(EFI_CONFIG_TABLES
)) {
205 if (efi
.acpi20
!= EFI_INVALID_TABLE_ADDR
)
207 if (efi
.acpi
!= EFI_INVALID_TABLE_ADDR
)
209 pr_err(PREFIX
"System description tables not found\n");
210 } else if (IS_ENABLED(CONFIG_ACPI_LEGACY_TABLES_LOOKUP
)) {
211 acpi_find_root_pointer(&pa
);
217 /* Must be called with 'acpi_ioremap_lock' or RCU read lock held. */
218 static struct acpi_ioremap
*
219 acpi_map_lookup(acpi_physical_address phys
, acpi_size size
)
221 struct acpi_ioremap
*map
;
223 list_for_each_entry_rcu(map
, &acpi_ioremaps
, list
)
224 if (map
->phys
<= phys
&&
225 phys
+ size
<= map
->phys
+ map
->size
)
231 /* Must be called with 'acpi_ioremap_lock' or RCU read lock held. */
232 static void __iomem
*
233 acpi_map_vaddr_lookup(acpi_physical_address phys
, unsigned int size
)
235 struct acpi_ioremap
*map
;
237 map
= acpi_map_lookup(phys
, size
);
239 return map
->virt
+ (phys
- map
->phys
);
244 void __iomem
*acpi_os_get_iomem(acpi_physical_address phys
, unsigned int size
)
246 struct acpi_ioremap
*map
;
247 void __iomem
*virt
= NULL
;
249 mutex_lock(&acpi_ioremap_lock
);
250 map
= acpi_map_lookup(phys
, size
);
252 virt
= map
->virt
+ (phys
- map
->phys
);
255 mutex_unlock(&acpi_ioremap_lock
);
258 EXPORT_SYMBOL_GPL(acpi_os_get_iomem
);
260 /* Must be called with 'acpi_ioremap_lock' or RCU read lock held. */
261 static struct acpi_ioremap
*
262 acpi_map_lookup_virt(void __iomem
*virt
, acpi_size size
)
264 struct acpi_ioremap
*map
;
266 list_for_each_entry_rcu(map
, &acpi_ioremaps
, list
)
267 if (map
->virt
<= virt
&&
268 virt
+ size
<= map
->virt
+ map
->size
)
274 #if defined(CONFIG_IA64) || defined(CONFIG_ARM64)
275 /* ioremap will take care of cache attributes */
276 #define should_use_kmap(pfn) 0
278 #define should_use_kmap(pfn) page_is_ram(pfn)
281 static void __iomem
*acpi_map(acpi_physical_address pg_off
, unsigned long pg_sz
)
285 pfn
= pg_off
>> PAGE_SHIFT
;
286 if (should_use_kmap(pfn
)) {
287 if (pg_sz
> PAGE_SIZE
)
289 return (void __iomem __force
*)kmap(pfn_to_page(pfn
));
291 return acpi_os_ioremap(pg_off
, pg_sz
);
294 static void acpi_unmap(acpi_physical_address pg_off
, void __iomem
*vaddr
)
298 pfn
= pg_off
>> PAGE_SHIFT
;
299 if (should_use_kmap(pfn
))
300 kunmap(pfn_to_page(pfn
));
306 * acpi_os_map_iomem - Get a virtual address for a given physical address range.
307 * @phys: Start of the physical address range to map.
308 * @size: Size of the physical address range to map.
310 * Look up the given physical address range in the list of existing ACPI memory
311 * mappings. If found, get a reference to it and return a pointer to it (its
312 * virtual address). If not found, map it, add it to that list and return a
315 * During early init (when acpi_permanent_mmap has not been set yet) this
316 * routine simply calls __acpi_map_table() to get the job done.
319 acpi_os_map_iomem(acpi_physical_address phys
, acpi_size size
)
321 struct acpi_ioremap
*map
;
323 acpi_physical_address pg_off
;
326 if (phys
> ULONG_MAX
) {
327 printk(KERN_ERR PREFIX
"Cannot map memory that high\n");
331 if (!acpi_permanent_mmap
)
332 return __acpi_map_table((unsigned long)phys
, size
);
334 mutex_lock(&acpi_ioremap_lock
);
335 /* Check if there's a suitable mapping already. */
336 map
= acpi_map_lookup(phys
, size
);
342 map
= kzalloc(sizeof(*map
), GFP_KERNEL
);
344 mutex_unlock(&acpi_ioremap_lock
);
348 pg_off
= round_down(phys
, PAGE_SIZE
);
349 pg_sz
= round_up(phys
+ size
, PAGE_SIZE
) - pg_off
;
350 virt
= acpi_map(pg_off
, pg_sz
);
352 mutex_unlock(&acpi_ioremap_lock
);
357 INIT_LIST_HEAD(&map
->list
);
363 list_add_tail_rcu(&map
->list
, &acpi_ioremaps
);
366 mutex_unlock(&acpi_ioremap_lock
);
367 return map
->virt
+ (phys
- map
->phys
);
369 EXPORT_SYMBOL_GPL(acpi_os_map_iomem
);
371 void *__ref
acpi_os_map_memory(acpi_physical_address phys
, acpi_size size
)
373 return (void *)acpi_os_map_iomem(phys
, size
);
375 EXPORT_SYMBOL_GPL(acpi_os_map_memory
);
377 static void acpi_os_drop_map_ref(struct acpi_ioremap
*map
)
379 if (!--map
->refcount
)
380 list_del_rcu(&map
->list
);
383 static void acpi_os_map_cleanup(struct acpi_ioremap
*map
)
385 if (!map
->refcount
) {
386 synchronize_rcu_expedited();
387 acpi_unmap(map
->phys
, map
->virt
);
393 * acpi_os_unmap_iomem - Drop a memory mapping reference.
394 * @virt: Start of the address range to drop a reference to.
395 * @size: Size of the address range to drop a reference to.
397 * Look up the given virtual address range in the list of existing ACPI memory
398 * mappings, drop a reference to it and unmap it if there are no more active
401 * During early init (when acpi_permanent_mmap has not been set yet) this
402 * routine simply calls __acpi_unmap_table() to get the job done. Since
403 * __acpi_unmap_table() is an __init function, the __ref annotation is needed
406 void __ref
acpi_os_unmap_iomem(void __iomem
*virt
, acpi_size size
)
408 struct acpi_ioremap
*map
;
410 if (!acpi_permanent_mmap
) {
411 __acpi_unmap_table(virt
, size
);
415 mutex_lock(&acpi_ioremap_lock
);
416 map
= acpi_map_lookup_virt(virt
, size
);
418 mutex_unlock(&acpi_ioremap_lock
);
419 WARN(true, PREFIX
"%s: bad address %p\n", __func__
, virt
);
422 acpi_os_drop_map_ref(map
);
423 mutex_unlock(&acpi_ioremap_lock
);
425 acpi_os_map_cleanup(map
);
427 EXPORT_SYMBOL_GPL(acpi_os_unmap_iomem
);
429 void __ref
acpi_os_unmap_memory(void *virt
, acpi_size size
)
431 return acpi_os_unmap_iomem((void __iomem
*)virt
, size
);
433 EXPORT_SYMBOL_GPL(acpi_os_unmap_memory
);
435 int acpi_os_map_generic_address(struct acpi_generic_address
*gas
)
440 if (gas
->space_id
!= ACPI_ADR_SPACE_SYSTEM_MEMORY
)
443 /* Handle possible alignment issues */
444 memcpy(&addr
, &gas
->address
, sizeof(addr
));
445 if (!addr
|| !gas
->bit_width
)
448 virt
= acpi_os_map_iomem(addr
, gas
->bit_width
/ 8);
454 EXPORT_SYMBOL(acpi_os_map_generic_address
);
456 void acpi_os_unmap_generic_address(struct acpi_generic_address
*gas
)
459 struct acpi_ioremap
*map
;
461 if (gas
->space_id
!= ACPI_ADR_SPACE_SYSTEM_MEMORY
)
464 /* Handle possible alignment issues */
465 memcpy(&addr
, &gas
->address
, sizeof(addr
));
466 if (!addr
|| !gas
->bit_width
)
469 mutex_lock(&acpi_ioremap_lock
);
470 map
= acpi_map_lookup(addr
, gas
->bit_width
/ 8);
472 mutex_unlock(&acpi_ioremap_lock
);
475 acpi_os_drop_map_ref(map
);
476 mutex_unlock(&acpi_ioremap_lock
);
478 acpi_os_map_cleanup(map
);
480 EXPORT_SYMBOL(acpi_os_unmap_generic_address
);
482 #ifdef ACPI_FUTURE_USAGE
484 acpi_os_get_physical_address(void *virt
, acpi_physical_address
* phys
)
487 return AE_BAD_PARAMETER
;
489 *phys
= virt_to_phys(virt
);
495 #ifdef CONFIG_ACPI_REV_OVERRIDE_POSSIBLE
496 static bool acpi_rev_override
;
498 int __init
acpi_rev_override_setup(char *str
)
500 acpi_rev_override
= true;
503 __setup("acpi_rev_override", acpi_rev_override_setup
);
505 #define acpi_rev_override false
508 #define ACPI_MAX_OVERRIDE_LEN 100
510 static char acpi_os_name
[ACPI_MAX_OVERRIDE_LEN
];
513 acpi_os_predefined_override(const struct acpi_predefined_names
*init_val
,
514 acpi_string
*new_val
)
516 if (!init_val
|| !new_val
)
517 return AE_BAD_PARAMETER
;
520 if (!memcmp(init_val
->name
, "_OS_", 4) && strlen(acpi_os_name
)) {
521 printk(KERN_INFO PREFIX
"Overriding _OS definition to '%s'\n",
523 *new_val
= acpi_os_name
;
526 if (!memcmp(init_val
->name
, "_REV", 4) && acpi_rev_override
) {
527 printk(KERN_INFO PREFIX
"Overriding _REV return value to 5\n");
528 *new_val
= (char *)5;
534 static irqreturn_t
acpi_irq(int irq
, void *dev_id
)
538 handled
= (*acpi_irq_handler
) (acpi_irq_context
);
544 acpi_irq_not_handled
++;
550 acpi_os_install_interrupt_handler(u32 gsi
, acpi_osd_handler handler
,
555 acpi_irq_stats_init();
558 * ACPI interrupts different from the SCI in our copy of the FADT are
561 if (gsi
!= acpi_gbl_FADT
.sci_interrupt
)
562 return AE_BAD_PARAMETER
;
564 if (acpi_irq_handler
)
565 return AE_ALREADY_ACQUIRED
;
567 if (acpi_gsi_to_irq(gsi
, &irq
) < 0) {
568 printk(KERN_ERR PREFIX
"SCI (ACPI GSI %d) not registered\n",
573 acpi_irq_handler
= handler
;
574 acpi_irq_context
= context
;
575 if (request_irq(irq
, acpi_irq
, IRQF_SHARED
, "acpi", acpi_irq
)) {
576 printk(KERN_ERR PREFIX
"SCI (IRQ%d) allocation failed\n", irq
);
577 acpi_irq_handler
= NULL
;
578 return AE_NOT_ACQUIRED
;
585 acpi_status
acpi_os_remove_interrupt_handler(u32 gsi
, acpi_osd_handler handler
)
587 if (gsi
!= acpi_gbl_FADT
.sci_interrupt
|| !acpi_sci_irq_valid())
588 return AE_BAD_PARAMETER
;
590 free_irq(acpi_sci_irq
, acpi_irq
);
591 acpi_irq_handler
= NULL
;
592 acpi_sci_irq
= INVALID_ACPI_IRQ
;
598 * Running in interpreter thread context, safe to sleep
601 void acpi_os_sleep(u64 ms
)
606 void acpi_os_stall(u32 us
)
614 touch_nmi_watchdog();
620 * Support ACPI 3.0 AML Timer operand. Returns a 64-bit free-running,
621 * monotonically increasing timer with 100ns granularity. Do not use
622 * ktime_get() to implement this function because this function may get
623 * called after timekeeping has been suspended. Note: calling this function
624 * after timekeeping has been suspended may lead to unexpected results
625 * because when timekeeping is suspended the jiffies counter is not
626 * incremented. See also timekeeping_suspend().
628 u64
acpi_os_get_timer(void)
630 return (get_jiffies_64() - INITIAL_JIFFIES
) *
631 (ACPI_100NSEC_PER_SEC
/ HZ
);
634 acpi_status
acpi_os_read_port(acpi_io_address port
, u32
* value
, u32 width
)
643 *(u8
*) value
= inb(port
);
644 } else if (width
<= 16) {
645 *(u16
*) value
= inw(port
);
646 } else if (width
<= 32) {
647 *(u32
*) value
= inl(port
);
655 EXPORT_SYMBOL(acpi_os_read_port
);
657 acpi_status
acpi_os_write_port(acpi_io_address port
, u32 value
, u32 width
)
661 } else if (width
<= 16) {
663 } else if (width
<= 32) {
672 EXPORT_SYMBOL(acpi_os_write_port
);
674 int acpi_os_read_iomem(void __iomem
*virt_addr
, u64
*value
, u32 width
)
679 *(u8
*) value
= readb(virt_addr
);
682 *(u16
*) value
= readw(virt_addr
);
685 *(u32
*) value
= readl(virt_addr
);
688 *(u64
*) value
= readq(virt_addr
);
698 acpi_os_read_memory(acpi_physical_address phys_addr
, u64
*value
, u32 width
)
700 void __iomem
*virt_addr
;
701 unsigned int size
= width
/ 8;
707 virt_addr
= acpi_map_vaddr_lookup(phys_addr
, size
);
710 virt_addr
= acpi_os_ioremap(phys_addr
, size
);
712 return AE_BAD_ADDRESS
;
719 error
= acpi_os_read_iomem(virt_addr
, value
, width
);
731 acpi_os_write_memory(acpi_physical_address phys_addr
, u64 value
, u32 width
)
733 void __iomem
*virt_addr
;
734 unsigned int size
= width
/ 8;
738 virt_addr
= acpi_map_vaddr_lookup(phys_addr
, size
);
741 virt_addr
= acpi_os_ioremap(phys_addr
, size
);
743 return AE_BAD_ADDRESS
;
749 writeb(value
, virt_addr
);
752 writew(value
, virt_addr
);
755 writel(value
, virt_addr
);
758 writeq(value
, virt_addr
);
774 acpi_os_read_pci_configuration(struct acpi_pci_id
* pci_id
, u32 reg
,
775 u64
*value
, u32 width
)
781 return AE_BAD_PARAMETER
;
797 result
= raw_pci_read(pci_id
->segment
, pci_id
->bus
,
798 PCI_DEVFN(pci_id
->device
, pci_id
->function
),
799 reg
, size
, &value32
);
802 return (result
? AE_ERROR
: AE_OK
);
806 acpi_os_write_pci_configuration(struct acpi_pci_id
* pci_id
, u32 reg
,
807 u64 value
, u32 width
)
825 result
= raw_pci_write(pci_id
->segment
, pci_id
->bus
,
826 PCI_DEVFN(pci_id
->device
, pci_id
->function
),
829 return (result
? AE_ERROR
: AE_OK
);
833 static void acpi_os_execute_deferred(struct work_struct
*work
)
835 struct acpi_os_dpc
*dpc
= container_of(work
, struct acpi_os_dpc
, work
);
837 dpc
->function(dpc
->context
);
841 #ifdef CONFIG_ACPI_DEBUGGER
842 static struct acpi_debugger acpi_debugger
;
843 static bool acpi_debugger_initialized
;
845 int acpi_register_debugger(struct module
*owner
,
846 const struct acpi_debugger_ops
*ops
)
850 mutex_lock(&acpi_debugger
.lock
);
851 if (acpi_debugger
.ops
) {
856 acpi_debugger
.owner
= owner
;
857 acpi_debugger
.ops
= ops
;
860 mutex_unlock(&acpi_debugger
.lock
);
863 EXPORT_SYMBOL(acpi_register_debugger
);
865 void acpi_unregister_debugger(const struct acpi_debugger_ops
*ops
)
867 mutex_lock(&acpi_debugger
.lock
);
868 if (ops
== acpi_debugger
.ops
) {
869 acpi_debugger
.ops
= NULL
;
870 acpi_debugger
.owner
= NULL
;
872 mutex_unlock(&acpi_debugger
.lock
);
874 EXPORT_SYMBOL(acpi_unregister_debugger
);
876 int acpi_debugger_create_thread(acpi_osd_exec_callback function
, void *context
)
879 int (*func
)(acpi_osd_exec_callback
, void *);
880 struct module
*owner
;
882 if (!acpi_debugger_initialized
)
884 mutex_lock(&acpi_debugger
.lock
);
885 if (!acpi_debugger
.ops
) {
889 if (!try_module_get(acpi_debugger
.owner
)) {
893 func
= acpi_debugger
.ops
->create_thread
;
894 owner
= acpi_debugger
.owner
;
895 mutex_unlock(&acpi_debugger
.lock
);
897 ret
= func(function
, context
);
899 mutex_lock(&acpi_debugger
.lock
);
902 mutex_unlock(&acpi_debugger
.lock
);
906 ssize_t
acpi_debugger_write_log(const char *msg
)
909 ssize_t (*func
)(const char *);
910 struct module
*owner
;
912 if (!acpi_debugger_initialized
)
914 mutex_lock(&acpi_debugger
.lock
);
915 if (!acpi_debugger
.ops
) {
919 if (!try_module_get(acpi_debugger
.owner
)) {
923 func
= acpi_debugger
.ops
->write_log
;
924 owner
= acpi_debugger
.owner
;
925 mutex_unlock(&acpi_debugger
.lock
);
929 mutex_lock(&acpi_debugger
.lock
);
932 mutex_unlock(&acpi_debugger
.lock
);
936 ssize_t
acpi_debugger_read_cmd(char *buffer
, size_t buffer_length
)
939 ssize_t (*func
)(char *, size_t);
940 struct module
*owner
;
942 if (!acpi_debugger_initialized
)
944 mutex_lock(&acpi_debugger
.lock
);
945 if (!acpi_debugger
.ops
) {
949 if (!try_module_get(acpi_debugger
.owner
)) {
953 func
= acpi_debugger
.ops
->read_cmd
;
954 owner
= acpi_debugger
.owner
;
955 mutex_unlock(&acpi_debugger
.lock
);
957 ret
= func(buffer
, buffer_length
);
959 mutex_lock(&acpi_debugger
.lock
);
962 mutex_unlock(&acpi_debugger
.lock
);
966 int acpi_debugger_wait_command_ready(void)
969 int (*func
)(bool, char *, size_t);
970 struct module
*owner
;
972 if (!acpi_debugger_initialized
)
974 mutex_lock(&acpi_debugger
.lock
);
975 if (!acpi_debugger
.ops
) {
979 if (!try_module_get(acpi_debugger
.owner
)) {
983 func
= acpi_debugger
.ops
->wait_command_ready
;
984 owner
= acpi_debugger
.owner
;
985 mutex_unlock(&acpi_debugger
.lock
);
987 ret
= func(acpi_gbl_method_executing
,
988 acpi_gbl_db_line_buf
, ACPI_DB_LINE_BUFFER_SIZE
);
990 mutex_lock(&acpi_debugger
.lock
);
993 mutex_unlock(&acpi_debugger
.lock
);
997 int acpi_debugger_notify_command_complete(void)
1001 struct module
*owner
;
1003 if (!acpi_debugger_initialized
)
1005 mutex_lock(&acpi_debugger
.lock
);
1006 if (!acpi_debugger
.ops
) {
1010 if (!try_module_get(acpi_debugger
.owner
)) {
1014 func
= acpi_debugger
.ops
->notify_command_complete
;
1015 owner
= acpi_debugger
.owner
;
1016 mutex_unlock(&acpi_debugger
.lock
);
1020 mutex_lock(&acpi_debugger
.lock
);
1023 mutex_unlock(&acpi_debugger
.lock
);
1027 int __init
acpi_debugger_init(void)
1029 mutex_init(&acpi_debugger
.lock
);
1030 acpi_debugger_initialized
= true;
1035 /*******************************************************************************
1037 * FUNCTION: acpi_os_execute
1039 * PARAMETERS: Type - Type of the callback
1040 * Function - Function to be executed
1041 * Context - Function parameters
1045 * DESCRIPTION: Depending on type, either queues function for deferred execution or
1046 * immediately executes function on a separate thread.
1048 ******************************************************************************/
1050 acpi_status
acpi_os_execute(acpi_execute_type type
,
1051 acpi_osd_exec_callback function
, void *context
)
1053 acpi_status status
= AE_OK
;
1054 struct acpi_os_dpc
*dpc
;
1055 struct workqueue_struct
*queue
;
1057 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
,
1058 "Scheduling function [%p(%p)] for deferred execution.\n",
1059 function
, context
));
1061 if (type
== OSL_DEBUGGER_MAIN_THREAD
) {
1062 ret
= acpi_debugger_create_thread(function
, context
);
1064 pr_err("Call to kthread_create() failed.\n");
1071 * Allocate/initialize DPC structure. Note that this memory will be
1072 * freed by the callee. The kernel handles the work_struct list in a
1073 * way that allows us to also free its memory inside the callee.
1074 * Because we may want to schedule several tasks with different
1075 * parameters we can't use the approach some kernel code uses of
1076 * having a static work_struct.
1079 dpc
= kzalloc(sizeof(struct acpi_os_dpc
), GFP_ATOMIC
);
1081 return AE_NO_MEMORY
;
1083 dpc
->function
= function
;
1084 dpc
->context
= context
;
1087 * To prevent lockdep from complaining unnecessarily, make sure that
1088 * there is a different static lockdep key for each workqueue by using
1089 * INIT_WORK() for each of them separately.
1091 if (type
== OSL_NOTIFY_HANDLER
) {
1092 queue
= kacpi_notify_wq
;
1093 INIT_WORK(&dpc
->work
, acpi_os_execute_deferred
);
1094 } else if (type
== OSL_GPE_HANDLER
) {
1096 INIT_WORK(&dpc
->work
, acpi_os_execute_deferred
);
1098 pr_err("Unsupported os_execute type %d.\n", type
);
1102 if (ACPI_FAILURE(status
))
1106 * On some machines, a software-initiated SMI causes corruption unless
1107 * the SMI runs on CPU 0. An SMI can be initiated by any AML, but
1108 * typically it's done in GPE-related methods that are run via
1109 * workqueues, so we can avoid the known corruption cases by always
1110 * queueing on CPU 0.
1112 ret
= queue_work_on(0, queue
, &dpc
->work
);
1114 printk(KERN_ERR PREFIX
1115 "Call to queue_work() failed.\n");
1119 if (ACPI_FAILURE(status
))
1124 EXPORT_SYMBOL(acpi_os_execute
);
1126 void acpi_os_wait_events_complete(void)
1129 * Make sure the GPE handler or the fixed event handler is not used
1130 * on another CPU after removal.
1132 if (acpi_sci_irq_valid())
1133 synchronize_hardirq(acpi_sci_irq
);
1134 flush_workqueue(kacpid_wq
);
1135 flush_workqueue(kacpi_notify_wq
);
1137 EXPORT_SYMBOL(acpi_os_wait_events_complete
);
1139 struct acpi_hp_work
{
1140 struct work_struct work
;
1141 struct acpi_device
*adev
;
1145 static void acpi_hotplug_work_fn(struct work_struct
*work
)
1147 struct acpi_hp_work
*hpw
= container_of(work
, struct acpi_hp_work
, work
);
1149 acpi_os_wait_events_complete();
1150 acpi_device_hotplug(hpw
->adev
, hpw
->src
);
1154 acpi_status
acpi_hotplug_schedule(struct acpi_device
*adev
, u32 src
)
1156 struct acpi_hp_work
*hpw
;
1158 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
,
1159 "Scheduling hotplug event (%p, %u) for deferred execution.\n",
1162 hpw
= kmalloc(sizeof(*hpw
), GFP_KERNEL
);
1164 return AE_NO_MEMORY
;
1166 INIT_WORK(&hpw
->work
, acpi_hotplug_work_fn
);
1170 * We can't run hotplug code in kacpid_wq/kacpid_notify_wq etc., because
1171 * the hotplug code may call driver .remove() functions, which may
1172 * invoke flush_scheduled_work()/acpi_os_wait_events_complete() to flush
1175 if (!queue_work(kacpi_hotplug_wq
, &hpw
->work
)) {
1182 bool acpi_queue_hotplug_work(struct work_struct
*work
)
1184 return queue_work(kacpi_hotplug_wq
, work
);
1188 acpi_os_create_semaphore(u32 max_units
, u32 initial_units
, acpi_handle
* handle
)
1190 struct semaphore
*sem
= NULL
;
1192 sem
= acpi_os_allocate_zeroed(sizeof(struct semaphore
));
1194 return AE_NO_MEMORY
;
1196 sema_init(sem
, initial_units
);
1198 *handle
= (acpi_handle
*) sem
;
1200 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX
, "Creating semaphore[%p|%d].\n",
1201 *handle
, initial_units
));
1207 * TODO: A better way to delete semaphores? Linux doesn't have a
1208 * 'delete_semaphore()' function -- may result in an invalid
1209 * pointer dereference for non-synchronized consumers. Should
1210 * we at least check for blocked threads and signal/cancel them?
1213 acpi_status
acpi_os_delete_semaphore(acpi_handle handle
)
1215 struct semaphore
*sem
= (struct semaphore
*)handle
;
1218 return AE_BAD_PARAMETER
;
1220 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX
, "Deleting semaphore[%p].\n", handle
));
1222 BUG_ON(!list_empty(&sem
->wait_list
));
1230 * TODO: Support for units > 1?
1232 acpi_status
acpi_os_wait_semaphore(acpi_handle handle
, u32 units
, u16 timeout
)
1234 acpi_status status
= AE_OK
;
1235 struct semaphore
*sem
= (struct semaphore
*)handle
;
1239 if (!acpi_os_initialized
)
1242 if (!sem
|| (units
< 1))
1243 return AE_BAD_PARAMETER
;
1248 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX
, "Waiting for semaphore[%p|%d|%d]\n",
1249 handle
, units
, timeout
));
1251 if (timeout
== ACPI_WAIT_FOREVER
)
1252 jiffies
= MAX_SCHEDULE_TIMEOUT
;
1254 jiffies
= msecs_to_jiffies(timeout
);
1256 ret
= down_timeout(sem
, jiffies
);
1260 if (ACPI_FAILURE(status
)) {
1261 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX
,
1262 "Failed to acquire semaphore[%p|%d|%d], %s",
1263 handle
, units
, timeout
,
1264 acpi_format_exception(status
)));
1266 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX
,
1267 "Acquired semaphore[%p|%d|%d]", handle
,
1275 * TODO: Support for units > 1?
1277 acpi_status
acpi_os_signal_semaphore(acpi_handle handle
, u32 units
)
1279 struct semaphore
*sem
= (struct semaphore
*)handle
;
1281 if (!acpi_os_initialized
)
1284 if (!sem
|| (units
< 1))
1285 return AE_BAD_PARAMETER
;
1290 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX
, "Signaling semaphore[%p|%d]\n", handle
,
1298 acpi_status
acpi_os_get_line(char *buffer
, u32 buffer_length
, u32
*bytes_read
)
1300 #ifdef ENABLE_DEBUGGER
1301 if (acpi_in_debugger
) {
1304 kdb_read(buffer
, buffer_length
);
1306 /* remove the CR kdb includes */
1307 chars
= strlen(buffer
) - 1;
1308 buffer
[chars
] = '\0';
1313 ret
= acpi_debugger_read_cmd(buffer
, buffer_length
);
1322 EXPORT_SYMBOL(acpi_os_get_line
);
1324 acpi_status
acpi_os_wait_command_ready(void)
1328 ret
= acpi_debugger_wait_command_ready();
1334 acpi_status
acpi_os_notify_command_complete(void)
1338 ret
= acpi_debugger_notify_command_complete();
1344 acpi_status
acpi_os_signal(u32 function
, void *info
)
1347 case ACPI_SIGNAL_FATAL
:
1348 printk(KERN_ERR PREFIX
"Fatal opcode executed\n");
1350 case ACPI_SIGNAL_BREAKPOINT
:
1353 * ACPI spec. says to treat it as a NOP unless
1354 * you are debugging. So if/when we integrate
1355 * AML debugger into the kernel debugger its
1356 * hook will go here. But until then it is
1357 * not useful to print anything on breakpoints.
1367 static int __init
acpi_os_name_setup(char *str
)
1369 char *p
= acpi_os_name
;
1370 int count
= ACPI_MAX_OVERRIDE_LEN
- 1;
1375 for (; count
-- && *str
; str
++) {
1376 if (isalnum(*str
) || *str
== ' ' || *str
== ':')
1378 else if (*str
== '\'' || *str
== '"')
1389 __setup("acpi_os_name=", acpi_os_name_setup
);
1392 * Disable the auto-serialization of named objects creation methods.
1394 * This feature is enabled by default. It marks the AML control methods
1395 * that contain the opcodes to create named objects as "Serialized".
1397 static int __init
acpi_no_auto_serialize_setup(char *str
)
1399 acpi_gbl_auto_serialize_methods
= FALSE
;
1400 pr_info("ACPI: auto-serialization disabled\n");
1405 __setup("acpi_no_auto_serialize", acpi_no_auto_serialize_setup
);
1407 /* Check of resource interference between native drivers and ACPI
1408 * OperationRegions (SystemIO and System Memory only).
1409 * IO ports and memory declared in ACPI might be used by the ACPI subsystem
1410 * in arbitrary AML code and can interfere with legacy drivers.
1411 * acpi_enforce_resources= can be set to:
1413 * - strict (default) (2)
1414 * -> further driver trying to access the resources will not load
1416 * -> further driver trying to access the resources will load, but you
1417 * get a system message that something might go wrong...
1420 * -> ACPI Operation Region resources will not be registered
1423 #define ENFORCE_RESOURCES_STRICT 2
1424 #define ENFORCE_RESOURCES_LAX 1
1425 #define ENFORCE_RESOURCES_NO 0
1427 static unsigned int acpi_enforce_resources
= ENFORCE_RESOURCES_STRICT
;
1429 static int __init
acpi_enforce_resources_setup(char *str
)
1431 if (str
== NULL
|| *str
== '\0')
1434 if (!strcmp("strict", str
))
1435 acpi_enforce_resources
= ENFORCE_RESOURCES_STRICT
;
1436 else if (!strcmp("lax", str
))
1437 acpi_enforce_resources
= ENFORCE_RESOURCES_LAX
;
1438 else if (!strcmp("no", str
))
1439 acpi_enforce_resources
= ENFORCE_RESOURCES_NO
;
1444 __setup("acpi_enforce_resources=", acpi_enforce_resources_setup
);
1446 /* Check for resource conflicts between ACPI OperationRegions and native
1448 int acpi_check_resource_conflict(const struct resource
*res
)
1450 acpi_adr_space_type space_id
;
1455 if (acpi_enforce_resources
== ENFORCE_RESOURCES_NO
)
1457 if (!(res
->flags
& IORESOURCE_IO
) && !(res
->flags
& IORESOURCE_MEM
))
1460 if (res
->flags
& IORESOURCE_IO
)
1461 space_id
= ACPI_ADR_SPACE_SYSTEM_IO
;
1463 space_id
= ACPI_ADR_SPACE_SYSTEM_MEMORY
;
1465 length
= resource_size(res
);
1466 if (acpi_enforce_resources
!= ENFORCE_RESOURCES_NO
)
1468 clash
= acpi_check_address_range(space_id
, res
->start
, length
, warn
);
1471 if (acpi_enforce_resources
!= ENFORCE_RESOURCES_NO
) {
1472 if (acpi_enforce_resources
== ENFORCE_RESOURCES_LAX
)
1473 printk(KERN_NOTICE
"ACPI: This conflict may"
1474 " cause random problems and system"
1476 printk(KERN_INFO
"ACPI: If an ACPI driver is available"
1477 " for this device, you should use it instead of"
1478 " the native driver\n");
1480 if (acpi_enforce_resources
== ENFORCE_RESOURCES_STRICT
)
1485 EXPORT_SYMBOL(acpi_check_resource_conflict
);
1487 int acpi_check_region(resource_size_t start
, resource_size_t n
,
1490 struct resource res
= {
1492 .end
= start
+ n
- 1,
1494 .flags
= IORESOURCE_IO
,
1497 return acpi_check_resource_conflict(&res
);
1499 EXPORT_SYMBOL(acpi_check_region
);
1501 static acpi_status
acpi_deactivate_mem_region(acpi_handle handle
, u32 level
,
1502 void *_res
, void **return_value
)
1504 struct acpi_mem_space_context
**mem_ctx
;
1505 union acpi_operand_object
*handler_obj
;
1506 union acpi_operand_object
*region_obj2
;
1507 union acpi_operand_object
*region_obj
;
1508 struct resource
*res
= _res
;
1511 region_obj
= acpi_ns_get_attached_object(handle
);
1515 handler_obj
= region_obj
->region
.handler
;
1519 if (region_obj
->region
.space_id
!= ACPI_ADR_SPACE_SYSTEM_MEMORY
)
1522 if (!(region_obj
->region
.flags
& AOPOBJ_SETUP_COMPLETE
))
1525 region_obj2
= acpi_ns_get_secondary_object(region_obj
);
1529 mem_ctx
= (void *)®ion_obj2
->extra
.region_context
;
1531 if (!(mem_ctx
[0]->address
>= res
->start
&&
1532 mem_ctx
[0]->address
< res
->end
))
1535 status
= handler_obj
->address_space
.setup(region_obj
,
1536 ACPI_REGION_DEACTIVATE
,
1537 NULL
, (void **)mem_ctx
);
1538 if (ACPI_SUCCESS(status
))
1539 region_obj
->region
.flags
&= ~(AOPOBJ_SETUP_COMPLETE
);
1545 * acpi_release_memory - Release any mappings done to a memory region
1546 * @handle: Handle to namespace node
1547 * @res: Memory resource
1548 * @level: A level that terminates the search
1550 * Walks through @handle and unmaps all SystemMemory Operation Regions that
1551 * overlap with @res and that have already been activated (mapped).
1553 * This is a helper that allows drivers to place special requirements on memory
1554 * region that may overlap with operation regions, primarily allowing them to
1555 * safely map the region as non-cached memory.
1557 * The unmapped Operation Regions will be automatically remapped next time they
1558 * are called, so the drivers do not need to do anything else.
1560 acpi_status
acpi_release_memory(acpi_handle handle
, struct resource
*res
,
1563 if (!(res
->flags
& IORESOURCE_MEM
))
1566 return acpi_walk_namespace(ACPI_TYPE_REGION
, handle
, level
,
1567 acpi_deactivate_mem_region
, NULL
, res
, NULL
);
1569 EXPORT_SYMBOL_GPL(acpi_release_memory
);
1572 * Let drivers know whether the resource checks are effective
1574 int acpi_resources_are_enforced(void)
1576 return acpi_enforce_resources
== ENFORCE_RESOURCES_STRICT
;
1578 EXPORT_SYMBOL(acpi_resources_are_enforced
);
1581 * Deallocate the memory for a spinlock.
1583 void acpi_os_delete_lock(acpi_spinlock handle
)
1589 * Acquire a spinlock.
1591 * handle is a pointer to the spinlock_t.
1594 acpi_cpu_flags
acpi_os_acquire_lock(acpi_spinlock lockp
)
1596 acpi_cpu_flags flags
;
1597 spin_lock_irqsave(lockp
, flags
);
1602 * Release a spinlock. See above.
1605 void acpi_os_release_lock(acpi_spinlock lockp
, acpi_cpu_flags flags
)
1607 spin_unlock_irqrestore(lockp
, flags
);
1610 #ifndef ACPI_USE_LOCAL_CACHE
1612 /*******************************************************************************
1614 * FUNCTION: acpi_os_create_cache
1616 * PARAMETERS: name - Ascii name for the cache
1617 * size - Size of each cached object
1618 * depth - Maximum depth of the cache (in objects) <ignored>
1619 * cache - Where the new cache object is returned
1623 * DESCRIPTION: Create a cache object
1625 ******************************************************************************/
1628 acpi_os_create_cache(char *name
, u16 size
, u16 depth
, acpi_cache_t
** cache
)
1630 *cache
= kmem_cache_create(name
, size
, 0, 0, NULL
);
1637 /*******************************************************************************
1639 * FUNCTION: acpi_os_purge_cache
1641 * PARAMETERS: Cache - Handle to cache object
1645 * DESCRIPTION: Free all objects within the requested cache.
1647 ******************************************************************************/
1649 acpi_status
acpi_os_purge_cache(acpi_cache_t
* cache
)
1651 kmem_cache_shrink(cache
);
1655 /*******************************************************************************
1657 * FUNCTION: acpi_os_delete_cache
1659 * PARAMETERS: Cache - Handle to cache object
1663 * DESCRIPTION: Free all objects within the requested cache and delete the
1666 ******************************************************************************/
1668 acpi_status
acpi_os_delete_cache(acpi_cache_t
* cache
)
1670 kmem_cache_destroy(cache
);
1674 /*******************************************************************************
1676 * FUNCTION: acpi_os_release_object
1678 * PARAMETERS: Cache - Handle to cache object
1679 * Object - The object to be released
1683 * DESCRIPTION: Release an object to the specified cache. If cache is full,
1684 * the object is deleted.
1686 ******************************************************************************/
1688 acpi_status
acpi_os_release_object(acpi_cache_t
* cache
, void *object
)
1690 kmem_cache_free(cache
, object
);
1695 static int __init
acpi_no_static_ssdt_setup(char *s
)
1697 acpi_gbl_disable_ssdt_table_install
= TRUE
;
1698 pr_info("ACPI: static SSDT installation disabled\n");
1703 early_param("acpi_no_static_ssdt", acpi_no_static_ssdt_setup
);
1705 static int __init
acpi_disable_return_repair(char *s
)
1707 printk(KERN_NOTICE PREFIX
1708 "ACPI: Predefined validation mechanism disabled\n");
1709 acpi_gbl_disable_auto_repair
= TRUE
;
1714 __setup("acpica_no_return_repair", acpi_disable_return_repair
);
1716 acpi_status __init
acpi_os_initialize(void)
1718 acpi_os_map_generic_address(&acpi_gbl_FADT
.xpm1a_event_block
);
1719 acpi_os_map_generic_address(&acpi_gbl_FADT
.xpm1b_event_block
);
1720 acpi_os_map_generic_address(&acpi_gbl_FADT
.xgpe0_block
);
1721 acpi_os_map_generic_address(&acpi_gbl_FADT
.xgpe1_block
);
1722 if (acpi_gbl_FADT
.flags
& ACPI_FADT_RESET_REGISTER
) {
1724 * Use acpi_os_map_generic_address to pre-map the reset
1725 * register if it's in system memory.
1729 rv
= acpi_os_map_generic_address(&acpi_gbl_FADT
.reset_register
);
1730 pr_debug(PREFIX
"%s: map reset_reg status %d\n", __func__
, rv
);
1732 acpi_os_initialized
= true;
1737 acpi_status __init
acpi_os_initialize1(void)
1739 kacpid_wq
= alloc_workqueue("kacpid", 0, 1);
1740 kacpi_notify_wq
= alloc_workqueue("kacpi_notify", 0, 1);
1741 kacpi_hotplug_wq
= alloc_ordered_workqueue("kacpi_hotplug", 0);
1743 BUG_ON(!kacpi_notify_wq
);
1744 BUG_ON(!kacpi_hotplug_wq
);
1749 acpi_status
acpi_os_terminate(void)
1751 if (acpi_irq_handler
) {
1752 acpi_os_remove_interrupt_handler(acpi_gbl_FADT
.sci_interrupt
,
1756 acpi_os_unmap_generic_address(&acpi_gbl_FADT
.xgpe1_block
);
1757 acpi_os_unmap_generic_address(&acpi_gbl_FADT
.xgpe0_block
);
1758 acpi_os_unmap_generic_address(&acpi_gbl_FADT
.xpm1b_event_block
);
1759 acpi_os_unmap_generic_address(&acpi_gbl_FADT
.xpm1a_event_block
);
1760 if (acpi_gbl_FADT
.flags
& ACPI_FADT_RESET_REGISTER
)
1761 acpi_os_unmap_generic_address(&acpi_gbl_FADT
.reset_register
);
1763 destroy_workqueue(kacpid_wq
);
1764 destroy_workqueue(kacpi_notify_wq
);
1765 destroy_workqueue(kacpi_hotplug_wq
);
1770 acpi_status
acpi_os_prepare_sleep(u8 sleep_state
, u32 pm1a_control
,
1774 if (__acpi_os_prepare_sleep
)
1775 rc
= __acpi_os_prepare_sleep(sleep_state
,
1776 pm1a_control
, pm1b_control
);
1780 return AE_CTRL_TERMINATE
;
1785 void acpi_os_set_prepare_sleep(int (*func
)(u8 sleep_state
,
1786 u32 pm1a_ctrl
, u32 pm1b_ctrl
))
1788 __acpi_os_prepare_sleep
= func
;
1791 #if (ACPI_REDUCED_HARDWARE)
1792 acpi_status
acpi_os_prepare_extended_sleep(u8 sleep_state
, u32 val_a
,
1796 if (__acpi_os_prepare_extended_sleep
)
1797 rc
= __acpi_os_prepare_extended_sleep(sleep_state
,
1802 return AE_CTRL_TERMINATE
;
1807 acpi_status
acpi_os_prepare_extended_sleep(u8 sleep_state
, u32 val_a
,
1814 void acpi_os_set_prepare_extended_sleep(int (*func
)(u8 sleep_state
,
1815 u32 val_a
, u32 val_b
))
1817 __acpi_os_prepare_extended_sleep
= func
;
1820 acpi_status
acpi_os_enter_sleep(u8 sleep_state
,
1821 u32 reg_a_value
, u32 reg_b_value
)
1825 if (acpi_gbl_reduced_hardware
)
1826 status
= acpi_os_prepare_extended_sleep(sleep_state
,
1830 status
= acpi_os_prepare_sleep(sleep_state
,
1831 reg_a_value
, reg_b_value
);