1426 lines · 40.2 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_init(fwnode, &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;	struct acpi_prmt_module_header prmt;	struct acpi_cedt_header cedt;}; 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); typedef int (*acpi_tbl_entry_handler_arg)(union acpi_subtable_headers *header,					  void *arg, 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;	acpi_tbl_entry_handler_arg handler_arg;	void *arg;	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_prepare (void);void acpi_boot_table_init (void);int acpi_mps_check (void);int acpi_numa_init (void); int acpi_locate_initial_tables (void);void acpi_reserve_initial_tables (void);void acpi_table_init_complete (void);int acpi_table_init (void); #ifdef CONFIG_ACPI_TABLE_LIB#define EXPORT_SYMBOL_ACPI_LIB(x) EXPORT_SYMBOL_NS_GPL(x, ACPI)#define __init_or_acpilib#define __initdata_or_acpilib#else#define EXPORT_SYMBOL_ACPI_LIB(x)#define __init_or_acpilib __init#define __initdata_or_acpilib __initdata#endif int acpi_table_parse(char *id, acpi_tbl_table_handler handler);int __init_or_acpilib acpi_table_parse_entries(char *id,		unsigned long table_size, int entry_id,		acpi_tbl_entry_handler handler, unsigned int max_entries);int __init_or_acpilib 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 __init_or_acpilibacpi_table_parse_cedt(enum acpi_cedt_type id,		      acpi_tbl_entry_handler_arg handler_arg, void *arg); 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) || defined(CONFIG_LOONGARCH)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);void acpi_arch_dma_setup(struct device *dev, u64 *dma_addr, u64 *dma_size);#elsestatic inline voidacpi_numa_gicc_affinity_init(struct acpi_srat_gicc_affinity *pa) { }static inline voidacpi_arch_dma_setup(struct device *dev, u64 *dma_addr, u64 *dma_size) { }#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);/* Processor _CTS control */struct acpi_processor_power; #ifdef CONFIG_ACPI_PROCESSOR_CSTATEbool acpi_processor_claim_cst_control(void);int acpi_processor_evaluate_cst(acpi_handle handle, u32 cpu,				struct acpi_processor_power *info);#elsestatic inline bool acpi_processor_claim_cst_control(void) { return false; }static inline int acpi_processor_evaluate_cst(acpi_handle handle, u32 cpu,					      struct acpi_processor_power *info){	return -ENODEV;}#endif #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_node(int pxm);int acpi_get_node(acpi_handle handle); /** * pxm_to_online_node - Map proximity ID to online node * @pxm: ACPI proximity ID * * This is similar to pxm_to_node(), but always returns an online * node.  When the mapped node from a given proximity ID is offline, it * looks up the node distance table and returns the nearest online node. * * ACPI device drivers, which are called after the NUMA initialization has * completed in the kernel, can call this interface to obtain their device * NUMA topology from ACPI tables.  Such drivers do not have to deal with * offline nodes.  A node may be offline when SRAT memory entry does not exist, * or NUMA is disabled, ex. "numa=off" on x86. */static inline int pxm_to_online_node(int pxm){	int node = pxm_to_node(pxm); 	return numa_map_to_online_node(node);}#elsestatic inline int 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); 

Lines 1–500 of 1426.