1310 lines · 36.7 KB · C
RawDownload
/* SPDX-License-Identifier: GPL-2.0-or-later *//* * acpi.h - ACPI Interface * * Copyright (C) 2001 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com> */ #ifndef _LINUX_ACPI_H#define _LINUX_ACPI_H #include <linux/errno.h>#include <linux/ioport.h>	/* for struct resource */#include <linux/irqdomain.h>#include <linux/resource_ext.h>#include <linux/device.h>#include <linux/property.h>#include <linux/uuid.h> #ifndef _LINUX#define _LINUX#endif#include <acpi/acpi.h> #ifdef	CONFIG_ACPI #include <linux/list.h>#include <linux/mod_devicetable.h>#include <linux/dynamic_debug.h>#include <linux/module.h>#include <linux/mutex.h> #include <acpi/acpi_bus.h>#include <acpi/acpi_drivers.h>#include <acpi/acpi_numa.h>#include <acpi/acpi_io.h>#include <asm/acpi.h> static inline acpi_handle acpi_device_handle(struct acpi_device *adev){	return adev ? adev->handle : NULL;} #define ACPI_COMPANION(dev)		to_acpi_device_node((dev)->fwnode)#define ACPI_COMPANION_SET(dev, adev)	set_primary_fwnode(dev, (adev) ? \	acpi_fwnode_handle(adev) : NULL)#define ACPI_HANDLE(dev)		acpi_device_handle(ACPI_COMPANION(dev))#define ACPI_HANDLE_FWNODE(fwnode)	\				acpi_device_handle(to_acpi_device_node(fwnode)) static inline struct fwnode_handle *acpi_alloc_fwnode_static(void){	struct fwnode_handle *fwnode; 	fwnode = kzalloc(sizeof(struct fwnode_handle), GFP_KERNEL);	if (!fwnode)		return NULL; 	fwnode->ops = &acpi_static_fwnode_ops; 	return fwnode;} static inline void acpi_free_fwnode_static(struct fwnode_handle *fwnode){	if (WARN_ON(!is_acpi_static_node(fwnode)))		return; 	kfree(fwnode);} /** * ACPI_DEVICE_CLASS - macro used to describe an ACPI device with * the PCI-defined class-code information * * @_cls : the class, subclass, prog-if triple for this device * @_msk : the class mask for this device * * This macro is used to create a struct acpi_device_id that matches a * specific PCI class. The .id and .driver_data fields will be left * initialized with the default value. */#define ACPI_DEVICE_CLASS(_cls, _msk)	.cls = (_cls), .cls_msk = (_msk), static inline bool has_acpi_companion(struct device *dev){	return is_acpi_device_node(dev->fwnode);} static inline void acpi_preset_companion(struct device *dev,					 struct acpi_device *parent, u64 addr){	ACPI_COMPANION_SET(dev, acpi_find_child_device(parent, addr, false));} static inline const char *acpi_dev_name(struct acpi_device *adev){	return dev_name(&adev->dev);} struct device *acpi_get_first_physical_node(struct acpi_device *adev); enum acpi_irq_model_id {	ACPI_IRQ_MODEL_PIC = 0,	ACPI_IRQ_MODEL_IOAPIC,	ACPI_IRQ_MODEL_IOSAPIC,	ACPI_IRQ_MODEL_PLATFORM,	ACPI_IRQ_MODEL_GIC,	ACPI_IRQ_MODEL_COUNT}; extern enum acpi_irq_model_id	acpi_irq_model; enum acpi_interrupt_id {	ACPI_INTERRUPT_PMI	= 1,	ACPI_INTERRUPT_INIT,	ACPI_INTERRUPT_CPEI,	ACPI_INTERRUPT_COUNT}; #define	ACPI_SPACE_MEM		0 enum acpi_address_range_id {	ACPI_ADDRESS_RANGE_MEMORY = 1,	ACPI_ADDRESS_RANGE_RESERVED = 2,	ACPI_ADDRESS_RANGE_ACPI = 3,	ACPI_ADDRESS_RANGE_NVS	= 4,	ACPI_ADDRESS_RANGE_COUNT};  /* Table Handlers */union acpi_subtable_headers {	struct acpi_subtable_header common;	struct acpi_hmat_structure hmat;}; typedef int (*acpi_tbl_table_handler)(struct acpi_table_header *table); typedef int (*acpi_tbl_entry_handler)(union acpi_subtable_headers *header,				      const unsigned long end); /* Debugger support */ struct acpi_debugger_ops {	int (*create_thread)(acpi_osd_exec_callback function, void *context);	ssize_t (*write_log)(const char *msg);	ssize_t (*read_cmd)(char *buffer, size_t length);	int (*wait_command_ready)(bool single_step, char *buffer, size_t length);	int (*notify_command_complete)(void);}; struct acpi_debugger {	const struct acpi_debugger_ops *ops;	struct module *owner;	struct mutex lock;}; #ifdef CONFIG_ACPI_DEBUGGERint __init acpi_debugger_init(void);int acpi_register_debugger(struct module *owner,			   const struct acpi_debugger_ops *ops);void acpi_unregister_debugger(const struct acpi_debugger_ops *ops);int acpi_debugger_create_thread(acpi_osd_exec_callback function, void *context);ssize_t acpi_debugger_write_log(const char *msg);ssize_t acpi_debugger_read_cmd(char *buffer, size_t buffer_length);int acpi_debugger_wait_command_ready(void);int acpi_debugger_notify_command_complete(void);#elsestatic inline int acpi_debugger_init(void){	return -ENODEV;} static inline int acpi_register_debugger(struct module *owner,					 const struct acpi_debugger_ops *ops){	return -ENODEV;} static inline void acpi_unregister_debugger(const struct acpi_debugger_ops *ops){} static inline int acpi_debugger_create_thread(acpi_osd_exec_callback function,					      void *context){	return -ENODEV;} static inline int acpi_debugger_write_log(const char *msg){	return -ENODEV;} static inline int acpi_debugger_read_cmd(char *buffer, u32 buffer_length){	return -ENODEV;} static inline int acpi_debugger_wait_command_ready(void){	return -ENODEV;} static inline int acpi_debugger_notify_command_complete(void){	return -ENODEV;}#endif #define BAD_MADT_ENTRY(entry, end) (					    \		(!entry) || (unsigned long)entry + sizeof(*entry) > end ||  \		((struct acpi_subtable_header *)entry)->length < sizeof(*entry)) struct acpi_subtable_proc {	int id;	acpi_tbl_entry_handler handler;	int count;}; void __iomem *__acpi_map_table(unsigned long phys, unsigned long size);void __acpi_unmap_table(void __iomem *map, unsigned long size);int early_acpi_boot_init(void);int acpi_boot_init (void);void acpi_boot_table_init (void);int acpi_mps_check (void);int acpi_numa_init (void); int acpi_table_init (void);int acpi_table_parse(char *id, acpi_tbl_table_handler handler);int __init acpi_table_parse_entries(char *id, unsigned long table_size,			      int entry_id,			      acpi_tbl_entry_handler handler,			      unsigned int max_entries);int __init acpi_table_parse_entries_array(char *id, unsigned long table_size,			      struct acpi_subtable_proc *proc, int proc_num,			      unsigned int max_entries);int acpi_table_parse_madt(enum acpi_madt_type id,			  acpi_tbl_entry_handler handler,			  unsigned int max_entries);int acpi_parse_mcfg (struct acpi_table_header *header);void acpi_table_print_madt_entry (struct acpi_subtable_header *madt); /* the following numa functions are architecture-dependent */void acpi_numa_slit_init (struct acpi_table_slit *slit); #if defined(CONFIG_X86) || defined(CONFIG_IA64)void acpi_numa_processor_affinity_init (struct acpi_srat_cpu_affinity *pa);#elsestatic inline voidacpi_numa_processor_affinity_init(struct acpi_srat_cpu_affinity *pa) { }#endif void acpi_numa_x2apic_affinity_init(struct acpi_srat_x2apic_cpu_affinity *pa); #ifdef CONFIG_ARM64void acpi_numa_gicc_affinity_init(struct acpi_srat_gicc_affinity *pa);#elsestatic inline voidacpi_numa_gicc_affinity_init(struct acpi_srat_gicc_affinity *pa) { }#endif int acpi_numa_memory_affinity_init (struct acpi_srat_mem_affinity *ma); #ifndef PHYS_CPUID_INVALIDtypedef u32 phys_cpuid_t;#define PHYS_CPUID_INVALID (phys_cpuid_t)(-1)#endif static inline bool invalid_logical_cpuid(u32 cpuid){	return (int)cpuid < 0;} static inline bool invalid_phys_cpuid(phys_cpuid_t phys_id){	return phys_id == PHYS_CPUID_INVALID;} /* Validate the processor object's proc_id */bool acpi_duplicate_processor_id(int proc_id); #ifdef CONFIG_ACPI_HOTPLUG_CPU/* Arch dependent functions for cpu hotplug support */int acpi_map_cpu(acpi_handle handle, phys_cpuid_t physid, u32 acpi_id,		 int *pcpu);int acpi_unmap_cpu(int cpu);#endif /* CONFIG_ACPI_HOTPLUG_CPU */ #ifdef CONFIG_ACPI_HOTPLUG_IOAPICint acpi_get_ioapic_id(acpi_handle handle, u32 gsi_base, u64 *phys_addr);#endif int acpi_register_ioapic(acpi_handle handle, u64 phys_addr, u32 gsi_base);int acpi_unregister_ioapic(acpi_handle handle, u32 gsi_base);int acpi_ioapic_registered(acpi_handle handle, u32 gsi_base);void acpi_irq_stats_init(void);extern u32 acpi_irq_handled;extern u32 acpi_irq_not_handled;extern unsigned int acpi_sci_irq;extern bool acpi_no_s5;#define INVALID_ACPI_IRQ	((unsigned)-1)static inline bool acpi_sci_irq_valid(void){	return acpi_sci_irq != INVALID_ACPI_IRQ;} extern int sbf_port;extern unsigned long acpi_realmode_flags; int acpi_register_gsi (struct device *dev, u32 gsi, int triggering, int polarity);int acpi_gsi_to_irq (u32 gsi, unsigned int *irq);int acpi_isa_irq_to_gsi (unsigned isa_irq, u32 *gsi); void acpi_set_irq_model(enum acpi_irq_model_id model,			struct fwnode_handle *fwnode); struct irq_domain *acpi_irq_create_hierarchy(unsigned int flags,					     unsigned int size,					     struct fwnode_handle *fwnode,					     const struct irq_domain_ops *ops,					     void *host_data); #ifdef CONFIG_X86_IO_APICextern int acpi_get_override_irq(u32 gsi, int *trigger, int *polarity);#elsestatic inline int acpi_get_override_irq(u32 gsi, int *trigger, int *polarity){	return -1;}#endif/* * This function undoes the effect of one call to acpi_register_gsi(). * If this matches the last registration, any IRQ resources for gsi * are freed. */void acpi_unregister_gsi (u32 gsi); struct pci_dev; int acpi_pci_irq_enable (struct pci_dev *dev);void acpi_penalize_isa_irq(int irq, int active);bool acpi_isa_irq_available(int irq);#ifdef CONFIG_PCIvoid acpi_penalize_sci_irq(int irq, int trigger, int polarity);#elsestatic inline void acpi_penalize_sci_irq(int irq, int trigger,					int polarity){}#endifvoid acpi_pci_irq_disable (struct pci_dev *dev); extern int ec_read(u8 addr, u8 *val);extern int ec_write(u8 addr, u8 val);extern int ec_transaction(u8 command,                          const u8 *wdata, unsigned wdata_len,                          u8 *rdata, unsigned rdata_len);extern acpi_handle ec_get_handle(void); extern bool acpi_is_pnp_device(struct acpi_device *); #if defined(CONFIG_ACPI_WMI) || defined(CONFIG_ACPI_WMI_MODULE) typedef void (*wmi_notify_handler) (u32 value, void *context); extern acpi_status wmi_evaluate_method(const char *guid, u8 instance,					u32 method_id,					const struct acpi_buffer *in,					struct acpi_buffer *out);extern acpi_status wmi_query_block(const char *guid, u8 instance,					struct acpi_buffer *out);extern acpi_status wmi_set_block(const char *guid, u8 instance,					const struct acpi_buffer *in);extern acpi_status wmi_install_notify_handler(const char *guid,					wmi_notify_handler handler, void *data);extern acpi_status wmi_remove_notify_handler(const char *guid);extern acpi_status wmi_get_event_data(u32 event, struct acpi_buffer *out);extern bool wmi_has_guid(const char *guid);extern char *wmi_get_acpi_device_uid(const char *guid); #endif	/* CONFIG_ACPI_WMI */ #define ACPI_VIDEO_OUTPUT_SWITCHING			0x0001#define ACPI_VIDEO_DEVICE_POSTING			0x0002#define ACPI_VIDEO_ROM_AVAILABLE			0x0004#define ACPI_VIDEO_BACKLIGHT				0x0008#define ACPI_VIDEO_BACKLIGHT_FORCE_VENDOR		0x0010#define ACPI_VIDEO_BACKLIGHT_FORCE_VIDEO		0x0020#define ACPI_VIDEO_OUTPUT_SWITCHING_FORCE_VENDOR	0x0040#define ACPI_VIDEO_OUTPUT_SWITCHING_FORCE_VIDEO		0x0080#define ACPI_VIDEO_BACKLIGHT_DMI_VENDOR			0x0100#define ACPI_VIDEO_BACKLIGHT_DMI_VIDEO			0x0200#define ACPI_VIDEO_OUTPUT_SWITCHING_DMI_VENDOR		0x0400#define ACPI_VIDEO_OUTPUT_SWITCHING_DMI_VIDEO		0x0800 extern char acpi_video_backlight_string[];extern long acpi_is_video_device(acpi_handle handle);extern int acpi_blacklisted(void);extern void acpi_osi_setup(char *str);extern bool acpi_osi_is_win8(void); #ifdef CONFIG_ACPI_NUMAint acpi_map_pxm_to_online_node(int pxm);int acpi_map_pxm_to_node(int pxm);int acpi_get_node(acpi_handle handle);#elsestatic inline int acpi_map_pxm_to_online_node(int pxm){	return 0;}static inline int acpi_map_pxm_to_node(int pxm){	return 0;}static inline int acpi_get_node(acpi_handle handle){	return 0;}#endifextern int acpi_paddr_to_node(u64 start_addr, u64 size); extern int pnpacpi_disabled; #define PXM_INVAL	(-1) bool acpi_dev_resource_memory(struct acpi_resource *ares, struct resource *res);bool acpi_dev_resource_io(struct acpi_resource *ares, struct resource *res);bool acpi_dev_resource_address_space(struct acpi_resource *ares,				     struct resource_win *win);bool acpi_dev_resource_ext_address_space(struct acpi_resource *ares,					 struct resource_win *win);unsigned long acpi_dev_irq_flags(u8 triggering, u8 polarity, u8 shareable);unsigned int acpi_dev_get_irq_type(int triggering, int polarity);bool acpi_dev_resource_interrupt(struct acpi_resource *ares, int index,				 struct resource *res); void acpi_dev_free_resource_list(struct list_head *list);int acpi_dev_get_resources(struct acpi_device *adev, struct list_head *list,			   int (*preproc)(struct acpi_resource *, void *),			   void *preproc_data);int acpi_dev_get_dma_resources(struct acpi_device *adev,			       struct list_head *list);int acpi_dev_filter_resource_type(struct acpi_resource *ares,				  unsigned long types); static inline int acpi_dev_filter_resource_type_cb(struct acpi_resource *ares,						   void *arg){	return acpi_dev_filter_resource_type(ares, (unsigned long)arg);} struct acpi_device *acpi_resource_consumer(struct resource *res); int acpi_check_resource_conflict(const struct resource *res); int acpi_check_region(resource_size_t start, resource_size_t n,		      const char *name); acpi_status acpi_release_memory(acpi_handle handle, struct resource *res,				u32 level); int acpi_resources_are_enforced(void); #ifdef CONFIG_HIBERNATIONvoid __init acpi_no_s4_hw_signature(void);#endif #ifdef CONFIG_PM_SLEEPvoid __init acpi_old_suspend_ordering(void);void __init acpi_nvs_nosave(void);void __init acpi_nvs_nosave_s3(void);void __init acpi_sleep_no_blacklist(void);#endif /* CONFIG_PM_SLEEP */ struct acpi_osc_context {	char *uuid_str;			/* UUID string */	int rev;	struct acpi_buffer cap;		/* list of DWORD capabilities */	struct acpi_buffer ret;		/* free by caller if success */}; acpi_status acpi_run_osc(acpi_handle handle, struct acpi_osc_context *context); /* Indexes into _OSC Capabilities Buffer (DWORDs 2 & 3 are device-specific) */#define OSC_QUERY_DWORD				0	/* DWORD 1 */#define OSC_SUPPORT_DWORD			1	/* DWORD 2 */#define OSC_CONTROL_DWORD			2	/* DWORD 3 */ /* _OSC Capabilities DWORD 1: Query/Control and Error Returns (generic) */#define OSC_QUERY_ENABLE			0x00000001  /* input */#define OSC_REQUEST_ERROR			0x00000002  /* return */#define OSC_INVALID_UUID_ERROR			0x00000004  /* return */#define OSC_INVALID_REVISION_ERROR		0x00000008  /* return */#define OSC_CAPABILITIES_MASK_ERROR		0x00000010  /* return */ /* Platform-Wide Capabilities _OSC: Capabilities DWORD 2: Support Field */#define OSC_SB_PAD_SUPPORT			0x00000001#define OSC_SB_PPC_OST_SUPPORT			0x00000002#define OSC_SB_PR3_SUPPORT			0x00000004

Lines 1–500 of 1310.