Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1/*
2 * acpi.h - ACPI Interface
3 *
4 * Copyright (C) 2001 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
5 *
6 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 *
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.
12 *
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.
17 *
18 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
19 */
20
21#ifndef _LINUX_ACPI_H
22#define _LINUX_ACPI_H
23
24#include <linux/errno.h>
25#include <linux/ioport.h> /* for struct resource */
26#include <linux/resource_ext.h>
27#include <linux/device.h>
28#include <linux/property.h>
29#include <linux/uuid.h>
30
31#ifndef _LINUX
32#define _LINUX
33#endif
34#include <acpi/acpi.h>
35
36#ifdef CONFIG_ACPI
37
38#include <linux/list.h>
39#include <linux/mod_devicetable.h>
40#include <linux/dynamic_debug.h>
41#include <linux/module.h>
42#include <linux/mutex.h>
43
44#include <acpi/acpi_bus.h>
45#include <acpi/acpi_drivers.h>
46#include <acpi/acpi_numa.h>
47#include <acpi/acpi_io.h>
48#include <asm/acpi.h>
49
50static inline acpi_handle acpi_device_handle(struct acpi_device *adev)
51{
52 return adev ? adev->handle : NULL;
53}
54
55#define ACPI_COMPANION(dev) to_acpi_device_node((dev)->fwnode)
56#define ACPI_COMPANION_SET(dev, adev) set_primary_fwnode(dev, (adev) ? \
57 acpi_fwnode_handle(adev) : NULL)
58#define ACPI_HANDLE(dev) acpi_device_handle(ACPI_COMPANION(dev))
59
60static inline struct fwnode_handle *acpi_alloc_fwnode_static(void)
61{
62 struct fwnode_handle *fwnode;
63
64 fwnode = kzalloc(sizeof(struct fwnode_handle), GFP_KERNEL);
65 if (!fwnode)
66 return NULL;
67
68 fwnode->ops = &acpi_static_fwnode_ops;
69
70 return fwnode;
71}
72
73static inline void acpi_free_fwnode_static(struct fwnode_handle *fwnode)
74{
75 if (WARN_ON(!is_acpi_static_node(fwnode)))
76 return;
77
78 kfree(fwnode);
79}
80
81/**
82 * ACPI_DEVICE_CLASS - macro used to describe an ACPI device with
83 * the PCI-defined class-code information
84 *
85 * @_cls : the class, subclass, prog-if triple for this device
86 * @_msk : the class mask for this device
87 *
88 * This macro is used to create a struct acpi_device_id that matches a
89 * specific PCI class. The .id and .driver_data fields will be left
90 * initialized with the default value.
91 */
92#define ACPI_DEVICE_CLASS(_cls, _msk) .cls = (_cls), .cls_msk = (_msk),
93
94static inline bool has_acpi_companion(struct device *dev)
95{
96 return is_acpi_device_node(dev->fwnode);
97}
98
99static inline void acpi_preset_companion(struct device *dev,
100 struct acpi_device *parent, u64 addr)
101{
102 ACPI_COMPANION_SET(dev, acpi_find_child_device(parent, addr, NULL));
103}
104
105static inline const char *acpi_dev_name(struct acpi_device *adev)
106{
107 return dev_name(&adev->dev);
108}
109
110struct device *acpi_get_first_physical_node(struct acpi_device *adev);
111
112enum acpi_irq_model_id {
113 ACPI_IRQ_MODEL_PIC = 0,
114 ACPI_IRQ_MODEL_IOAPIC,
115 ACPI_IRQ_MODEL_IOSAPIC,
116 ACPI_IRQ_MODEL_PLATFORM,
117 ACPI_IRQ_MODEL_GIC,
118 ACPI_IRQ_MODEL_COUNT
119};
120
121extern enum acpi_irq_model_id acpi_irq_model;
122
123enum acpi_interrupt_id {
124 ACPI_INTERRUPT_PMI = 1,
125 ACPI_INTERRUPT_INIT,
126 ACPI_INTERRUPT_CPEI,
127 ACPI_INTERRUPT_COUNT
128};
129
130#define ACPI_SPACE_MEM 0
131
132enum acpi_address_range_id {
133 ACPI_ADDRESS_RANGE_MEMORY = 1,
134 ACPI_ADDRESS_RANGE_RESERVED = 2,
135 ACPI_ADDRESS_RANGE_ACPI = 3,
136 ACPI_ADDRESS_RANGE_NVS = 4,
137 ACPI_ADDRESS_RANGE_COUNT
138};
139
140
141/* Table Handlers */
142
143typedef int (*acpi_tbl_table_handler)(struct acpi_table_header *table);
144
145typedef int (*acpi_tbl_entry_handler)(struct acpi_subtable_header *header,
146 const unsigned long end);
147
148/* Debugger support */
149
150struct acpi_debugger_ops {
151 int (*create_thread)(acpi_osd_exec_callback function, void *context);
152 ssize_t (*write_log)(const char *msg);
153 ssize_t (*read_cmd)(char *buffer, size_t length);
154 int (*wait_command_ready)(bool single_step, char *buffer, size_t length);
155 int (*notify_command_complete)(void);
156};
157
158struct acpi_debugger {
159 const struct acpi_debugger_ops *ops;
160 struct module *owner;
161 struct mutex lock;
162};
163
164#ifdef CONFIG_ACPI_DEBUGGER
165int __init acpi_debugger_init(void);
166int acpi_register_debugger(struct module *owner,
167 const struct acpi_debugger_ops *ops);
168void acpi_unregister_debugger(const struct acpi_debugger_ops *ops);
169int acpi_debugger_create_thread(acpi_osd_exec_callback function, void *context);
170ssize_t acpi_debugger_write_log(const char *msg);
171ssize_t acpi_debugger_read_cmd(char *buffer, size_t buffer_length);
172int acpi_debugger_wait_command_ready(void);
173int acpi_debugger_notify_command_complete(void);
174#else
175static inline int acpi_debugger_init(void)
176{
177 return -ENODEV;
178}
179
180static inline int acpi_register_debugger(struct module *owner,
181 const struct acpi_debugger_ops *ops)
182{
183 return -ENODEV;
184}
185
186static inline void acpi_unregister_debugger(const struct acpi_debugger_ops *ops)
187{
188}
189
190static inline int acpi_debugger_create_thread(acpi_osd_exec_callback function,
191 void *context)
192{
193 return -ENODEV;
194}
195
196static inline int acpi_debugger_write_log(const char *msg)
197{
198 return -ENODEV;
199}
200
201static inline int acpi_debugger_read_cmd(char *buffer, u32 buffer_length)
202{
203 return -ENODEV;
204}
205
206static inline int acpi_debugger_wait_command_ready(void)
207{
208 return -ENODEV;
209}
210
211static inline int acpi_debugger_notify_command_complete(void)
212{
213 return -ENODEV;
214}
215#endif
216
217#define BAD_MADT_ENTRY(entry, end) ( \
218 (!entry) || (unsigned long)entry + sizeof(*entry) > end || \
219 ((struct acpi_subtable_header *)entry)->length < sizeof(*entry))
220
221struct acpi_subtable_proc {
222 int id;
223 acpi_tbl_entry_handler handler;
224 int count;
225};
226
227void __iomem *__acpi_map_table(unsigned long phys, unsigned long size);
228void __acpi_unmap_table(void __iomem *map, unsigned long size);
229int early_acpi_boot_init(void);
230int acpi_boot_init (void);
231void acpi_boot_table_init (void);
232int acpi_mps_check (void);
233int acpi_numa_init (void);
234
235int acpi_table_init (void);
236int acpi_table_parse(char *id, acpi_tbl_table_handler handler);
237int __init acpi_table_parse_entries(char *id, unsigned long table_size,
238 int entry_id,
239 acpi_tbl_entry_handler handler,
240 unsigned int max_entries);
241int __init acpi_table_parse_entries_array(char *id, unsigned long table_size,
242 struct acpi_subtable_proc *proc, int proc_num,
243 unsigned int max_entries);
244int acpi_table_parse_madt(enum acpi_madt_type id,
245 acpi_tbl_entry_handler handler,
246 unsigned int max_entries);
247int acpi_parse_mcfg (struct acpi_table_header *header);
248void acpi_table_print_madt_entry (struct acpi_subtable_header *madt);
249
250/* the following numa functions are architecture-dependent */
251void acpi_numa_slit_init (struct acpi_table_slit *slit);
252
253#if defined(CONFIG_X86) || defined(CONFIG_IA64)
254void acpi_numa_processor_affinity_init (struct acpi_srat_cpu_affinity *pa);
255#else
256static inline void
257acpi_numa_processor_affinity_init(struct acpi_srat_cpu_affinity *pa) { }
258#endif
259
260void acpi_numa_x2apic_affinity_init(struct acpi_srat_x2apic_cpu_affinity *pa);
261
262#ifdef CONFIG_ARM64
263void acpi_numa_gicc_affinity_init(struct acpi_srat_gicc_affinity *pa);
264#else
265static inline void
266acpi_numa_gicc_affinity_init(struct acpi_srat_gicc_affinity *pa) { }
267#endif
268
269int acpi_numa_memory_affinity_init (struct acpi_srat_mem_affinity *ma);
270
271#ifndef PHYS_CPUID_INVALID
272typedef u32 phys_cpuid_t;
273#define PHYS_CPUID_INVALID (phys_cpuid_t)(-1)
274#endif
275
276static inline bool invalid_logical_cpuid(u32 cpuid)
277{
278 return (int)cpuid < 0;
279}
280
281static inline bool invalid_phys_cpuid(phys_cpuid_t phys_id)
282{
283 return phys_id == PHYS_CPUID_INVALID;
284}
285
286/* Validate the processor object's proc_id */
287bool acpi_duplicate_processor_id(int proc_id);
288
289#ifdef CONFIG_ACPI_HOTPLUG_CPU
290/* Arch dependent functions for cpu hotplug support */
291int acpi_map_cpu(acpi_handle handle, phys_cpuid_t physid, u32 acpi_id,
292 int *pcpu);
293int acpi_unmap_cpu(int cpu);
294#endif /* CONFIG_ACPI_HOTPLUG_CPU */
295
296#ifdef CONFIG_ACPI_HOTPLUG_IOAPIC
297int acpi_get_ioapic_id(acpi_handle handle, u32 gsi_base, u64 *phys_addr);
298#endif
299
300int acpi_register_ioapic(acpi_handle handle, u64 phys_addr, u32 gsi_base);
301int acpi_unregister_ioapic(acpi_handle handle, u32 gsi_base);
302int acpi_ioapic_registered(acpi_handle handle, u32 gsi_base);
303void acpi_irq_stats_init(void);
304extern u32 acpi_irq_handled;
305extern u32 acpi_irq_not_handled;
306extern unsigned int acpi_sci_irq;
307extern bool acpi_no_s5;
308#define INVALID_ACPI_IRQ ((unsigned)-1)
309static inline bool acpi_sci_irq_valid(void)
310{
311 return acpi_sci_irq != INVALID_ACPI_IRQ;
312}
313
314extern int sbf_port;
315extern unsigned long acpi_realmode_flags;
316
317int acpi_register_gsi (struct device *dev, u32 gsi, int triggering, int polarity);
318int acpi_gsi_to_irq (u32 gsi, unsigned int *irq);
319int acpi_isa_irq_to_gsi (unsigned isa_irq, u32 *gsi);
320
321void acpi_set_irq_model(enum acpi_irq_model_id model,
322 struct fwnode_handle *fwnode);
323
324#ifdef CONFIG_X86_IO_APIC
325extern int acpi_get_override_irq(u32 gsi, int *trigger, int *polarity);
326#else
327#define acpi_get_override_irq(gsi, trigger, polarity) (-1)
328#endif
329/*
330 * This function undoes the effect of one call to acpi_register_gsi().
331 * If this matches the last registration, any IRQ resources for gsi
332 * are freed.
333 */
334void acpi_unregister_gsi (u32 gsi);
335
336struct pci_dev;
337
338int acpi_pci_irq_enable (struct pci_dev *dev);
339void acpi_penalize_isa_irq(int irq, int active);
340bool acpi_isa_irq_available(int irq);
341void acpi_penalize_sci_irq(int irq, int trigger, int polarity);
342void acpi_pci_irq_disable (struct pci_dev *dev);
343
344extern int ec_read(u8 addr, u8 *val);
345extern int ec_write(u8 addr, u8 val);
346extern int ec_transaction(u8 command,
347 const u8 *wdata, unsigned wdata_len,
348 u8 *rdata, unsigned rdata_len);
349extern acpi_handle ec_get_handle(void);
350
351extern bool acpi_is_pnp_device(struct acpi_device *);
352
353#if defined(CONFIG_ACPI_WMI) || defined(CONFIG_ACPI_WMI_MODULE)
354
355typedef void (*wmi_notify_handler) (u32 value, void *context);
356
357extern acpi_status wmi_evaluate_method(const char *guid, u8 instance,
358 u32 method_id,
359 const struct acpi_buffer *in,
360 struct acpi_buffer *out);
361extern acpi_status wmi_query_block(const char *guid, u8 instance,
362 struct acpi_buffer *out);
363extern acpi_status wmi_set_block(const char *guid, u8 instance,
364 const struct acpi_buffer *in);
365extern acpi_status wmi_install_notify_handler(const char *guid,
366 wmi_notify_handler handler, void *data);
367extern acpi_status wmi_remove_notify_handler(const char *guid);
368extern acpi_status wmi_get_event_data(u32 event, struct acpi_buffer *out);
369extern bool wmi_has_guid(const char *guid);
370
371#endif /* CONFIG_ACPI_WMI */
372
373#define ACPI_VIDEO_OUTPUT_SWITCHING 0x0001
374#define ACPI_VIDEO_DEVICE_POSTING 0x0002
375#define ACPI_VIDEO_ROM_AVAILABLE 0x0004
376#define ACPI_VIDEO_BACKLIGHT 0x0008
377#define ACPI_VIDEO_BACKLIGHT_FORCE_VENDOR 0x0010
378#define ACPI_VIDEO_BACKLIGHT_FORCE_VIDEO 0x0020
379#define ACPI_VIDEO_OUTPUT_SWITCHING_FORCE_VENDOR 0x0040
380#define ACPI_VIDEO_OUTPUT_SWITCHING_FORCE_VIDEO 0x0080
381#define ACPI_VIDEO_BACKLIGHT_DMI_VENDOR 0x0100
382#define ACPI_VIDEO_BACKLIGHT_DMI_VIDEO 0x0200
383#define ACPI_VIDEO_OUTPUT_SWITCHING_DMI_VENDOR 0x0400
384#define ACPI_VIDEO_OUTPUT_SWITCHING_DMI_VIDEO 0x0800
385
386extern char acpi_video_backlight_string[];
387extern long acpi_is_video_device(acpi_handle handle);
388extern int acpi_blacklisted(void);
389extern void acpi_osi_setup(char *str);
390extern bool acpi_osi_is_win8(void);
391
392#ifdef CONFIG_ACPI_NUMA
393int acpi_map_pxm_to_online_node(int pxm);
394int acpi_get_node(acpi_handle handle);
395#else
396static inline int acpi_map_pxm_to_online_node(int pxm)
397{
398 return 0;
399}
400static inline int acpi_get_node(acpi_handle handle)
401{
402 return 0;
403}
404#endif
405extern int acpi_paddr_to_node(u64 start_addr, u64 size);
406
407extern int pnpacpi_disabled;
408
409#define PXM_INVAL (-1)
410
411bool acpi_dev_resource_memory(struct acpi_resource *ares, struct resource *res);
412bool acpi_dev_resource_io(struct acpi_resource *ares, struct resource *res);
413bool acpi_dev_resource_address_space(struct acpi_resource *ares,
414 struct resource_win *win);
415bool acpi_dev_resource_ext_address_space(struct acpi_resource *ares,
416 struct resource_win *win);
417unsigned long acpi_dev_irq_flags(u8 triggering, u8 polarity, u8 shareable);
418unsigned int acpi_dev_get_irq_type(int triggering, int polarity);
419bool acpi_dev_resource_interrupt(struct acpi_resource *ares, int index,
420 struct resource *res);
421
422void acpi_dev_free_resource_list(struct list_head *list);
423int acpi_dev_get_resources(struct acpi_device *adev, struct list_head *list,
424 int (*preproc)(struct acpi_resource *, void *),
425 void *preproc_data);
426int acpi_dev_get_dma_resources(struct acpi_device *adev,
427 struct list_head *list);
428int acpi_dev_filter_resource_type(struct acpi_resource *ares,
429 unsigned long types);
430
431static inline int acpi_dev_filter_resource_type_cb(struct acpi_resource *ares,
432 void *arg)
433{
434 return acpi_dev_filter_resource_type(ares, (unsigned long)arg);
435}
436
437struct acpi_device *acpi_resource_consumer(struct resource *res);
438
439int acpi_check_resource_conflict(const struct resource *res);
440
441int acpi_check_region(resource_size_t start, resource_size_t n,
442 const char *name);
443
444int acpi_resources_are_enforced(void);
445
446#ifdef CONFIG_HIBERNATION
447void __init acpi_no_s4_hw_signature(void);
448#endif
449
450#ifdef CONFIG_PM_SLEEP
451void __init acpi_old_suspend_ordering(void);
452void __init acpi_nvs_nosave(void);
453void __init acpi_nvs_nosave_s3(void);
454#endif /* CONFIG_PM_SLEEP */
455
456struct acpi_osc_context {
457 char *uuid_str; /* UUID string */
458 int rev;
459 struct acpi_buffer cap; /* list of DWORD capabilities */
460 struct acpi_buffer ret; /* free by caller if success */
461};
462
463acpi_status acpi_run_osc(acpi_handle handle, struct acpi_osc_context *context);
464
465/* Indexes into _OSC Capabilities Buffer (DWORDs 2 & 3 are device-specific) */
466#define OSC_QUERY_DWORD 0 /* DWORD 1 */
467#define OSC_SUPPORT_DWORD 1 /* DWORD 2 */
468#define OSC_CONTROL_DWORD 2 /* DWORD 3 */
469
470/* _OSC Capabilities DWORD 1: Query/Control and Error Returns (generic) */
471#define OSC_QUERY_ENABLE 0x00000001 /* input */
472#define OSC_REQUEST_ERROR 0x00000002 /* return */
473#define OSC_INVALID_UUID_ERROR 0x00000004 /* return */
474#define OSC_INVALID_REVISION_ERROR 0x00000008 /* return */
475#define OSC_CAPABILITIES_MASK_ERROR 0x00000010 /* return */
476
477/* Platform-Wide Capabilities _OSC: Capabilities DWORD 2: Support Field */
478#define OSC_SB_PAD_SUPPORT 0x00000001
479#define OSC_SB_PPC_OST_SUPPORT 0x00000002
480#define OSC_SB_PR3_SUPPORT 0x00000004
481#define OSC_SB_HOTPLUG_OST_SUPPORT 0x00000008
482#define OSC_SB_APEI_SUPPORT 0x00000010
483#define OSC_SB_CPC_SUPPORT 0x00000020
484#define OSC_SB_CPCV2_SUPPORT 0x00000040
485#define OSC_SB_PCLPI_SUPPORT 0x00000080
486#define OSC_SB_OSLPI_SUPPORT 0x00000100
487#define OSC_SB_CPC_DIVERSE_HIGH_SUPPORT 0x00001000
488
489extern bool osc_sb_apei_support_acked;
490extern bool osc_pc_lpi_support_confirmed;
491
492/* PCI Host Bridge _OSC: Capabilities DWORD 2: Support Field */
493#define OSC_PCI_EXT_CONFIG_SUPPORT 0x00000001
494#define OSC_PCI_ASPM_SUPPORT 0x00000002
495#define OSC_PCI_CLOCK_PM_SUPPORT 0x00000004
496#define OSC_PCI_SEGMENT_GROUPS_SUPPORT 0x00000008
497#define OSC_PCI_MSI_SUPPORT 0x00000010
498#define OSC_PCI_SUPPORT_MASKS 0x0000001f
499
500/* PCI Host Bridge _OSC: Capabilities DWORD 3: Control Field */
501#define OSC_PCI_EXPRESS_NATIVE_HP_CONTROL 0x00000001
502#define OSC_PCI_SHPC_NATIVE_HP_CONTROL 0x00000002
503#define OSC_PCI_EXPRESS_PME_CONTROL 0x00000004
504#define OSC_PCI_EXPRESS_AER_CONTROL 0x00000008
505#define OSC_PCI_EXPRESS_CAPABILITY_CONTROL 0x00000010
506#define OSC_PCI_CONTROL_MASKS 0x0000001f
507
508#define ACPI_GSB_ACCESS_ATTRIB_QUICK 0x00000002
509#define ACPI_GSB_ACCESS_ATTRIB_SEND_RCV 0x00000004
510#define ACPI_GSB_ACCESS_ATTRIB_BYTE 0x00000006
511#define ACPI_GSB_ACCESS_ATTRIB_WORD 0x00000008
512#define ACPI_GSB_ACCESS_ATTRIB_BLOCK 0x0000000A
513#define ACPI_GSB_ACCESS_ATTRIB_MULTIBYTE 0x0000000B
514#define ACPI_GSB_ACCESS_ATTRIB_WORD_CALL 0x0000000C
515#define ACPI_GSB_ACCESS_ATTRIB_BLOCK_CALL 0x0000000D
516#define ACPI_GSB_ACCESS_ATTRIB_RAW_BYTES 0x0000000E
517#define ACPI_GSB_ACCESS_ATTRIB_RAW_PROCESS 0x0000000F
518
519extern acpi_status acpi_pci_osc_control_set(acpi_handle handle,
520 u32 *mask, u32 req);
521
522/* Enable _OST when all relevant hotplug operations are enabled */
523#if defined(CONFIG_ACPI_HOTPLUG_CPU) && \
524 defined(CONFIG_ACPI_HOTPLUG_MEMORY) && \
525 defined(CONFIG_ACPI_CONTAINER)
526#define ACPI_HOTPLUG_OST
527#endif
528
529/* _OST Source Event Code (OSPM Action) */
530#define ACPI_OST_EC_OSPM_SHUTDOWN 0x100
531#define ACPI_OST_EC_OSPM_EJECT 0x103
532#define ACPI_OST_EC_OSPM_INSERTION 0x200
533
534/* _OST General Processing Status Code */
535#define ACPI_OST_SC_SUCCESS 0x0
536#define ACPI_OST_SC_NON_SPECIFIC_FAILURE 0x1
537#define ACPI_OST_SC_UNRECOGNIZED_NOTIFY 0x2
538
539/* _OST OS Shutdown Processing (0x100) Status Code */
540#define ACPI_OST_SC_OS_SHUTDOWN_DENIED 0x80
541#define ACPI_OST_SC_OS_SHUTDOWN_IN_PROGRESS 0x81
542#define ACPI_OST_SC_OS_SHUTDOWN_COMPLETED 0x82
543#define ACPI_OST_SC_OS_SHUTDOWN_NOT_SUPPORTED 0x83
544
545/* _OST Ejection Request (0x3, 0x103) Status Code */
546#define ACPI_OST_SC_EJECT_NOT_SUPPORTED 0x80
547#define ACPI_OST_SC_DEVICE_IN_USE 0x81
548#define ACPI_OST_SC_DEVICE_BUSY 0x82
549#define ACPI_OST_SC_EJECT_DEPENDENCY_BUSY 0x83
550#define ACPI_OST_SC_EJECT_IN_PROGRESS 0x84
551
552/* _OST Insertion Request (0x200) Status Code */
553#define ACPI_OST_SC_INSERT_IN_PROGRESS 0x80
554#define ACPI_OST_SC_DRIVER_LOAD_FAILURE 0x81
555#define ACPI_OST_SC_INSERT_NOT_SUPPORTED 0x82
556
557enum acpi_predicate {
558 all_versions,
559 less_than_or_equal,
560 equal,
561 greater_than_or_equal,
562};
563
564/* Table must be terminted by a NULL entry */
565struct acpi_platform_list {
566 char oem_id[ACPI_OEM_ID_SIZE+1];
567 char oem_table_id[ACPI_OEM_TABLE_ID_SIZE+1];
568 u32 oem_revision;
569 char *table;
570 enum acpi_predicate pred;
571 char *reason;
572 u32 data;
573};
574int acpi_match_platform_list(const struct acpi_platform_list *plat);
575
576extern void acpi_early_init(void);
577extern void acpi_subsystem_init(void);
578
579extern int acpi_nvs_register(__u64 start, __u64 size);
580
581extern int acpi_nvs_for_each_region(int (*func)(__u64, __u64, void *),
582 void *data);
583
584const struct acpi_device_id *acpi_match_device(const struct acpi_device_id *ids,
585 const struct device *dev);
586
587extern bool acpi_driver_match_device(struct device *dev,
588 const struct device_driver *drv);
589int acpi_device_uevent_modalias(struct device *, struct kobj_uevent_env *);
590int acpi_device_modalias(struct device *, char *, int);
591void acpi_walk_dep_device_list(acpi_handle handle);
592
593struct platform_device *acpi_create_platform_device(struct acpi_device *,
594 struct property_entry *);
595#define ACPI_PTR(_ptr) (_ptr)
596
597static inline void acpi_device_set_enumerated(struct acpi_device *adev)
598{
599 adev->flags.visited = true;
600}
601
602static inline void acpi_device_clear_enumerated(struct acpi_device *adev)
603{
604 adev->flags.visited = false;
605}
606
607enum acpi_reconfig_event {
608 ACPI_RECONFIG_DEVICE_ADD = 0,
609 ACPI_RECONFIG_DEVICE_REMOVE,
610};
611
612int acpi_reconfig_notifier_register(struct notifier_block *nb);
613int acpi_reconfig_notifier_unregister(struct notifier_block *nb);
614
615#ifdef CONFIG_ACPI_GTDT
616int acpi_gtdt_init(struct acpi_table_header *table, int *platform_timer_count);
617int acpi_gtdt_map_ppi(int type);
618bool acpi_gtdt_c3stop(int type);
619int acpi_arch_timer_mem_init(struct arch_timer_mem *timer_mem, int *timer_count);
620#endif
621
622#else /* !CONFIG_ACPI */
623
624#define acpi_disabled 1
625
626#define ACPI_COMPANION(dev) (NULL)
627#define ACPI_COMPANION_SET(dev, adev) do { } while (0)
628#define ACPI_HANDLE(dev) (NULL)
629#define ACPI_DEVICE_CLASS(_cls, _msk) .cls = (0), .cls_msk = (0),
630
631struct fwnode_handle;
632
633static inline bool acpi_dev_found(const char *hid)
634{
635 return false;
636}
637
638static inline bool acpi_dev_present(const char *hid, const char *uid, s64 hrv)
639{
640 return false;
641}
642
643static inline bool is_acpi_node(struct fwnode_handle *fwnode)
644{
645 return false;
646}
647
648static inline bool is_acpi_device_node(struct fwnode_handle *fwnode)
649{
650 return false;
651}
652
653static inline struct acpi_device *to_acpi_device_node(struct fwnode_handle *fwnode)
654{
655 return NULL;
656}
657
658static inline bool is_acpi_data_node(struct fwnode_handle *fwnode)
659{
660 return false;
661}
662
663static inline struct acpi_data_node *to_acpi_data_node(struct fwnode_handle *fwnode)
664{
665 return NULL;
666}
667
668static inline bool acpi_data_node_match(struct fwnode_handle *fwnode,
669 const char *name)
670{
671 return false;
672}
673
674static inline struct fwnode_handle *acpi_fwnode_handle(struct acpi_device *adev)
675{
676 return NULL;
677}
678
679static inline bool has_acpi_companion(struct device *dev)
680{
681 return false;
682}
683
684static inline void acpi_preset_companion(struct device *dev,
685 struct acpi_device *parent, u64 addr)
686{
687}
688
689static inline const char *acpi_dev_name(struct acpi_device *adev)
690{
691 return NULL;
692}
693
694static inline struct device *acpi_get_first_physical_node(struct acpi_device *adev)
695{
696 return NULL;
697}
698
699static inline void acpi_early_init(void) { }
700static inline void acpi_subsystem_init(void) { }
701
702static inline int early_acpi_boot_init(void)
703{
704 return 0;
705}
706static inline int acpi_boot_init(void)
707{
708 return 0;
709}
710
711static inline void acpi_boot_table_init(void)
712{
713 return;
714}
715
716static inline int acpi_mps_check(void)
717{
718 return 0;
719}
720
721static inline int acpi_check_resource_conflict(struct resource *res)
722{
723 return 0;
724}
725
726static inline int acpi_check_region(resource_size_t start, resource_size_t n,
727 const char *name)
728{
729 return 0;
730}
731
732struct acpi_table_header;
733static inline int acpi_table_parse(char *id,
734 int (*handler)(struct acpi_table_header *))
735{
736 return -ENODEV;
737}
738
739static inline int acpi_nvs_register(__u64 start, __u64 size)
740{
741 return 0;
742}
743
744static inline int acpi_nvs_for_each_region(int (*func)(__u64, __u64, void *),
745 void *data)
746{
747 return 0;
748}
749
750struct acpi_device_id;
751
752static inline const struct acpi_device_id *acpi_match_device(
753 const struct acpi_device_id *ids, const struct device *dev)
754{
755 return NULL;
756}
757
758static inline bool acpi_driver_match_device(struct device *dev,
759 const struct device_driver *drv)
760{
761 return false;
762}
763
764static inline union acpi_object *acpi_evaluate_dsm(acpi_handle handle,
765 const guid_t *guid,
766 int rev, int func,
767 union acpi_object *argv4)
768{
769 return NULL;
770}
771
772static inline int acpi_device_uevent_modalias(struct device *dev,
773 struct kobj_uevent_env *env)
774{
775 return -ENODEV;
776}
777
778static inline int acpi_device_modalias(struct device *dev,
779 char *buf, int size)
780{
781 return -ENODEV;
782}
783
784static inline bool acpi_dma_supported(struct acpi_device *adev)
785{
786 return false;
787}
788
789static inline enum dev_dma_attr acpi_get_dma_attr(struct acpi_device *adev)
790{
791 return DEV_DMA_NOT_SUPPORTED;
792}
793
794static inline int acpi_dma_get_range(struct device *dev, u64 *dma_addr,
795 u64 *offset, u64 *size)
796{
797 return -ENODEV;
798}
799
800static inline int acpi_dma_configure(struct device *dev,
801 enum dev_dma_attr attr)
802{
803 return 0;
804}
805
806static inline void acpi_dma_deconfigure(struct device *dev) { }
807
808#define ACPI_PTR(_ptr) (NULL)
809
810static inline void acpi_device_set_enumerated(struct acpi_device *adev)
811{
812}
813
814static inline void acpi_device_clear_enumerated(struct acpi_device *adev)
815{
816}
817
818static inline int acpi_reconfig_notifier_register(struct notifier_block *nb)
819{
820 return -EINVAL;
821}
822
823static inline int acpi_reconfig_notifier_unregister(struct notifier_block *nb)
824{
825 return -EINVAL;
826}
827
828static inline struct acpi_device *acpi_resource_consumer(struct resource *res)
829{
830 return NULL;
831}
832
833#endif /* !CONFIG_ACPI */
834
835#ifdef CONFIG_ACPI_HOTPLUG_IOAPIC
836int acpi_ioapic_add(acpi_handle root);
837#else
838static inline int acpi_ioapic_add(acpi_handle root) { return 0; }
839#endif
840
841#ifdef CONFIG_ACPI
842void acpi_os_set_prepare_sleep(int (*func)(u8 sleep_state,
843 u32 pm1a_ctrl, u32 pm1b_ctrl));
844
845acpi_status acpi_os_prepare_sleep(u8 sleep_state,
846 u32 pm1a_control, u32 pm1b_control);
847
848void acpi_os_set_prepare_extended_sleep(int (*func)(u8 sleep_state,
849 u32 val_a, u32 val_b));
850
851acpi_status acpi_os_prepare_extended_sleep(u8 sleep_state,
852 u32 val_a, u32 val_b);
853
854#ifdef CONFIG_X86
855void arch_reserve_mem_area(acpi_physical_address addr, size_t size);
856#else
857static inline void arch_reserve_mem_area(acpi_physical_address addr,
858 size_t size)
859{
860}
861#endif /* CONFIG_X86 */
862#else
863#define acpi_os_set_prepare_sleep(func, pm1a_ctrl, pm1b_ctrl) do { } while (0)
864#endif
865
866#if defined(CONFIG_ACPI) && defined(CONFIG_PM)
867int acpi_dev_runtime_suspend(struct device *dev);
868int acpi_dev_runtime_resume(struct device *dev);
869int acpi_subsys_runtime_suspend(struct device *dev);
870int acpi_subsys_runtime_resume(struct device *dev);
871struct acpi_device *acpi_dev_pm_get_node(struct device *dev);
872int acpi_dev_pm_attach(struct device *dev, bool power_on);
873#else
874static inline int acpi_dev_runtime_suspend(struct device *dev) { return 0; }
875static inline int acpi_dev_runtime_resume(struct device *dev) { return 0; }
876static inline int acpi_subsys_runtime_suspend(struct device *dev) { return 0; }
877static inline int acpi_subsys_runtime_resume(struct device *dev) { return 0; }
878static inline struct acpi_device *acpi_dev_pm_get_node(struct device *dev)
879{
880 return NULL;
881}
882static inline int acpi_dev_pm_attach(struct device *dev, bool power_on)
883{
884 return -ENODEV;
885}
886#endif
887
888#if defined(CONFIG_ACPI) && defined(CONFIG_PM_SLEEP)
889int acpi_dev_suspend_late(struct device *dev);
890int acpi_dev_resume_early(struct device *dev);
891int acpi_subsys_prepare(struct device *dev);
892void acpi_subsys_complete(struct device *dev);
893int acpi_subsys_suspend_late(struct device *dev);
894int acpi_subsys_resume_early(struct device *dev);
895int acpi_subsys_suspend(struct device *dev);
896int acpi_subsys_freeze(struct device *dev);
897#else
898static inline int acpi_dev_suspend_late(struct device *dev) { return 0; }
899static inline int acpi_dev_resume_early(struct device *dev) { return 0; }
900static inline int acpi_subsys_prepare(struct device *dev) { return 0; }
901static inline void acpi_subsys_complete(struct device *dev) {}
902static inline int acpi_subsys_suspend_late(struct device *dev) { return 0; }
903static inline int acpi_subsys_resume_early(struct device *dev) { return 0; }
904static inline int acpi_subsys_suspend(struct device *dev) { return 0; }
905static inline int acpi_subsys_freeze(struct device *dev) { return 0; }
906#endif
907
908#ifdef CONFIG_ACPI
909__printf(3, 4)
910void acpi_handle_printk(const char *level, acpi_handle handle,
911 const char *fmt, ...);
912#else /* !CONFIG_ACPI */
913static inline __printf(3, 4) void
914acpi_handle_printk(const char *level, void *handle, const char *fmt, ...) {}
915#endif /* !CONFIG_ACPI */
916
917#if defined(CONFIG_ACPI) && defined(CONFIG_DYNAMIC_DEBUG)
918__printf(3, 4)
919void __acpi_handle_debug(struct _ddebug *descriptor, acpi_handle handle, const char *fmt, ...);
920#else
921#define __acpi_handle_debug(descriptor, handle, fmt, ...) \
922 acpi_handle_printk(KERN_DEBUG, handle, fmt, ##__VA_ARGS__);
923#endif
924
925/*
926 * acpi_handle_<level>: Print message with ACPI prefix and object path
927 *
928 * These interfaces acquire the global namespace mutex to obtain an object
929 * path. In interrupt context, it shows the object path as <n/a>.
930 */
931#define acpi_handle_emerg(handle, fmt, ...) \
932 acpi_handle_printk(KERN_EMERG, handle, fmt, ##__VA_ARGS__)
933#define acpi_handle_alert(handle, fmt, ...) \
934 acpi_handle_printk(KERN_ALERT, handle, fmt, ##__VA_ARGS__)
935#define acpi_handle_crit(handle, fmt, ...) \
936 acpi_handle_printk(KERN_CRIT, handle, fmt, ##__VA_ARGS__)
937#define acpi_handle_err(handle, fmt, ...) \
938 acpi_handle_printk(KERN_ERR, handle, fmt, ##__VA_ARGS__)
939#define acpi_handle_warn(handle, fmt, ...) \
940 acpi_handle_printk(KERN_WARNING, handle, fmt, ##__VA_ARGS__)
941#define acpi_handle_notice(handle, fmt, ...) \
942 acpi_handle_printk(KERN_NOTICE, handle, fmt, ##__VA_ARGS__)
943#define acpi_handle_info(handle, fmt, ...) \
944 acpi_handle_printk(KERN_INFO, handle, fmt, ##__VA_ARGS__)
945
946#if defined(DEBUG)
947#define acpi_handle_debug(handle, fmt, ...) \
948 acpi_handle_printk(KERN_DEBUG, handle, fmt, ##__VA_ARGS__)
949#else
950#if defined(CONFIG_DYNAMIC_DEBUG)
951#define acpi_handle_debug(handle, fmt, ...) \
952do { \
953 DEFINE_DYNAMIC_DEBUG_METADATA(descriptor, fmt); \
954 if (unlikely(descriptor.flags & _DPRINTK_FLAGS_PRINT)) \
955 __acpi_handle_debug(&descriptor, handle, pr_fmt(fmt), \
956 ##__VA_ARGS__); \
957} while (0)
958#else
959#define acpi_handle_debug(handle, fmt, ...) \
960({ \
961 if (0) \
962 acpi_handle_printk(KERN_DEBUG, handle, fmt, ##__VA_ARGS__); \
963 0; \
964})
965#endif
966#endif
967
968struct acpi_gpio_params {
969 unsigned int crs_entry_index;
970 unsigned int line_index;
971 bool active_low;
972};
973
974struct acpi_gpio_mapping {
975 const char *name;
976 const struct acpi_gpio_params *data;
977 unsigned int size;
978};
979
980#if defined(CONFIG_ACPI) && defined(CONFIG_GPIOLIB)
981int acpi_dev_add_driver_gpios(struct acpi_device *adev,
982 const struct acpi_gpio_mapping *gpios);
983
984static inline void acpi_dev_remove_driver_gpios(struct acpi_device *adev)
985{
986 if (adev)
987 adev->driver_gpios = NULL;
988}
989
990int devm_acpi_dev_add_driver_gpios(struct device *dev,
991 const struct acpi_gpio_mapping *gpios);
992void devm_acpi_dev_remove_driver_gpios(struct device *dev);
993
994bool acpi_gpio_get_irq_resource(struct acpi_resource *ares,
995 struct acpi_resource_gpio **agpio);
996int acpi_dev_gpio_irq_get(struct acpi_device *adev, int index);
997#else
998static inline int acpi_dev_add_driver_gpios(struct acpi_device *adev,
999 const struct acpi_gpio_mapping *gpios)
1000{
1001 return -ENXIO;
1002}
1003static inline void acpi_dev_remove_driver_gpios(struct acpi_device *adev) {}
1004
1005static inline int devm_acpi_dev_add_driver_gpios(struct device *dev,
1006 const struct acpi_gpio_mapping *gpios)
1007{
1008 return -ENXIO;
1009}
1010static inline void devm_acpi_dev_remove_driver_gpios(struct device *dev) {}
1011
1012static inline bool acpi_gpio_get_irq_resource(struct acpi_resource *ares,
1013 struct acpi_resource_gpio **agpio)
1014{
1015 return false;
1016}
1017static inline int acpi_dev_gpio_irq_get(struct acpi_device *adev, int index)
1018{
1019 return -ENXIO;
1020}
1021#endif
1022
1023/* Device properties */
1024
1025#define MAX_ACPI_REFERENCE_ARGS 8
1026struct acpi_reference_args {
1027 struct acpi_device *adev;
1028 size_t nargs;
1029 u64 args[MAX_ACPI_REFERENCE_ARGS];
1030};
1031
1032#ifdef CONFIG_ACPI
1033int acpi_dev_get_property(const struct acpi_device *adev, const char *name,
1034 acpi_object_type type, const union acpi_object **obj);
1035int __acpi_node_get_property_reference(const struct fwnode_handle *fwnode,
1036 const char *name, size_t index, size_t num_args,
1037 struct acpi_reference_args *args);
1038
1039static inline int acpi_node_get_property_reference(
1040 const struct fwnode_handle *fwnode,
1041 const char *name, size_t index,
1042 struct acpi_reference_args *args)
1043{
1044 return __acpi_node_get_property_reference(fwnode, name, index,
1045 MAX_ACPI_REFERENCE_ARGS, args);
1046}
1047
1048int acpi_node_prop_get(const struct fwnode_handle *fwnode, const char *propname,
1049 void **valptr);
1050int acpi_dev_prop_read_single(struct acpi_device *adev,
1051 const char *propname, enum dev_prop_type proptype,
1052 void *val);
1053int acpi_node_prop_read(const struct fwnode_handle *fwnode,
1054 const char *propname, enum dev_prop_type proptype,
1055 void *val, size_t nval);
1056int acpi_dev_prop_read(const struct acpi_device *adev, const char *propname,
1057 enum dev_prop_type proptype, void *val, size_t nval);
1058
1059struct fwnode_handle *acpi_get_next_subnode(const struct fwnode_handle *fwnode,
1060 struct fwnode_handle *child);
1061struct fwnode_handle *acpi_node_get_parent(const struct fwnode_handle *fwnode);
1062
1063struct fwnode_handle *
1064acpi_graph_get_next_endpoint(const struct fwnode_handle *fwnode,
1065 struct fwnode_handle *prev);
1066int acpi_graph_get_remote_endpoint(const struct fwnode_handle *fwnode,
1067 struct fwnode_handle **remote,
1068 struct fwnode_handle **port,
1069 struct fwnode_handle **endpoint);
1070
1071struct acpi_probe_entry;
1072typedef bool (*acpi_probe_entry_validate_subtbl)(struct acpi_subtable_header *,
1073 struct acpi_probe_entry *);
1074
1075#define ACPI_TABLE_ID_LEN 5
1076
1077/**
1078 * struct acpi_probe_entry - boot-time probing entry
1079 * @id: ACPI table name
1080 * @type: Optional subtable type to match
1081 * (if @id contains subtables)
1082 * @subtable_valid: Optional callback to check the validity of
1083 * the subtable
1084 * @probe_table: Callback to the driver being probed when table
1085 * match is successful
1086 * @probe_subtbl: Callback to the driver being probed when table and
1087 * subtable match (and optional callback is successful)
1088 * @driver_data: Sideband data provided back to the driver
1089 */
1090struct acpi_probe_entry {
1091 __u8 id[ACPI_TABLE_ID_LEN];
1092 __u8 type;
1093 acpi_probe_entry_validate_subtbl subtable_valid;
1094 union {
1095 acpi_tbl_table_handler probe_table;
1096 acpi_tbl_entry_handler probe_subtbl;
1097 };
1098 kernel_ulong_t driver_data;
1099};
1100
1101#define ACPI_DECLARE_PROBE_ENTRY(table, name, table_id, subtable, valid, data, fn) \
1102 static const struct acpi_probe_entry __acpi_probe_##name \
1103 __used __section(__##table##_acpi_probe_table) \
1104 = { \
1105 .id = table_id, \
1106 .type = subtable, \
1107 .subtable_valid = valid, \
1108 .probe_table = (acpi_tbl_table_handler)fn, \
1109 .driver_data = data, \
1110 }
1111
1112#define ACPI_PROBE_TABLE(name) __##name##_acpi_probe_table
1113#define ACPI_PROBE_TABLE_END(name) __##name##_acpi_probe_table_end
1114
1115int __acpi_probe_device_table(struct acpi_probe_entry *start, int nr);
1116
1117#define acpi_probe_device_table(t) \
1118 ({ \
1119 extern struct acpi_probe_entry ACPI_PROBE_TABLE(t), \
1120 ACPI_PROBE_TABLE_END(t); \
1121 __acpi_probe_device_table(&ACPI_PROBE_TABLE(t), \
1122 (&ACPI_PROBE_TABLE_END(t) - \
1123 &ACPI_PROBE_TABLE(t))); \
1124 })
1125#else
1126static inline int acpi_dev_get_property(struct acpi_device *adev,
1127 const char *name, acpi_object_type type,
1128 const union acpi_object **obj)
1129{
1130 return -ENXIO;
1131}
1132
1133static inline int
1134__acpi_node_get_property_reference(const struct fwnode_handle *fwnode,
1135 const char *name, size_t index, size_t num_args,
1136 struct acpi_reference_args *args)
1137{
1138 return -ENXIO;
1139}
1140
1141static inline int
1142acpi_node_get_property_reference(const struct fwnode_handle *fwnode,
1143 const char *name, size_t index,
1144 struct acpi_reference_args *args)
1145{
1146 return -ENXIO;
1147}
1148
1149static inline int acpi_node_prop_get(const struct fwnode_handle *fwnode,
1150 const char *propname,
1151 void **valptr)
1152{
1153 return -ENXIO;
1154}
1155
1156static inline int acpi_dev_prop_get(const struct acpi_device *adev,
1157 const char *propname,
1158 void **valptr)
1159{
1160 return -ENXIO;
1161}
1162
1163static inline int acpi_dev_prop_read_single(const struct acpi_device *adev,
1164 const char *propname,
1165 enum dev_prop_type proptype,
1166 void *val)
1167{
1168 return -ENXIO;
1169}
1170
1171static inline int acpi_node_prop_read(const struct fwnode_handle *fwnode,
1172 const char *propname,
1173 enum dev_prop_type proptype,
1174 void *val, size_t nval)
1175{
1176 return -ENXIO;
1177}
1178
1179static inline int acpi_dev_prop_read(const struct acpi_device *adev,
1180 const char *propname,
1181 enum dev_prop_type proptype,
1182 void *val, size_t nval)
1183{
1184 return -ENXIO;
1185}
1186
1187static inline struct fwnode_handle *
1188acpi_get_next_subnode(const struct fwnode_handle *fwnode,
1189 struct fwnode_handle *child)
1190{
1191 return NULL;
1192}
1193
1194static inline struct fwnode_handle *
1195acpi_node_get_parent(const struct fwnode_handle *fwnode)
1196{
1197 return NULL;
1198}
1199
1200static inline struct fwnode_handle *
1201acpi_graph_get_next_endpoint(const struct fwnode_handle *fwnode,
1202 struct fwnode_handle *prev)
1203{
1204 return ERR_PTR(-ENXIO);
1205}
1206
1207static inline int
1208acpi_graph_get_remote_endpoint(const struct fwnode_handle *fwnode,
1209 struct fwnode_handle **remote,
1210 struct fwnode_handle **port,
1211 struct fwnode_handle **endpoint)
1212{
1213 return -ENXIO;
1214}
1215
1216#define ACPI_DECLARE_PROBE_ENTRY(table, name, table_id, subtable, valid, data, fn) \
1217 static const void * __acpi_table_##name[] \
1218 __attribute__((unused)) \
1219 = { (void *) table_id, \
1220 (void *) subtable, \
1221 (void *) valid, \
1222 (void *) fn, \
1223 (void *) data }
1224
1225#define acpi_probe_device_table(t) ({ int __r = 0; __r;})
1226#endif
1227
1228#ifdef CONFIG_ACPI_TABLE_UPGRADE
1229void acpi_table_upgrade(void);
1230#else
1231static inline void acpi_table_upgrade(void) { }
1232#endif
1233
1234#if defined(CONFIG_ACPI) && defined(CONFIG_ACPI_WATCHDOG)
1235extern bool acpi_has_watchdog(void);
1236#else
1237static inline bool acpi_has_watchdog(void) { return false; }
1238#endif
1239
1240#ifdef CONFIG_ACPI_SPCR_TABLE
1241extern bool qdf2400_e44_present;
1242int parse_spcr(bool earlycon);
1243#else
1244static inline int parse_spcr(bool earlycon) { return 0; }
1245#endif
1246
1247#if IS_ENABLED(CONFIG_ACPI_GENERIC_GSI)
1248int acpi_irq_get(acpi_handle handle, unsigned int index, struct resource *res);
1249#else
1250static inline
1251int acpi_irq_get(acpi_handle handle, unsigned int index, struct resource *res)
1252{
1253 return -EINVAL;
1254}
1255#endif
1256
1257#endif /*_LINUX_ACPI_H*/