1 /* SPDX-License-Identifier: GPL-2.0-or-later */
3  * acpi.h - ACPI Interface
14 #include <linux/device.h>
54 	return adev ? adev->handle : NULL;  in acpi_device_handle()
57 #define ACPI_COMPANION(dev)		to_acpi_device_node((dev)->fwnode)
85 static inline bool has_acpi_companion(struct device *dev)  in has_acpi_companion()
87 	return is_acpi_device_node(dev->fwnode);  in has_acpi_companion()
90 static inline void acpi_preset_companion(struct device *dev,  in acpi_preset_companion()
98 	return dev_name(&adev->dev);  in acpi_dev_name()
101 struct device *acpi_get_first_physical_node(struct acpi_device *adev);
166 	return -ENODEV;  in acpi_debugger_init()
172 	return -ENODEV;  in acpi_register_debugger()
182 	return -ENODEV;  in acpi_debugger_create_thread()
187 	return -ENODEV;  in acpi_debugger_write_log()
192 	return -ENODEV;  in acpi_debugger_read_cmd()
197 	return -ENODEV;  in acpi_debugger_wait_command_ready()
202 	return -ENODEV;  in acpi_debugger_notify_command_complete()
208 		((struct acpi_subtable_header *)entry)->length < sizeof(*entry))
251 void acpi_arch_dma_setup(struct device *dev);
253 static inline void acpi_arch_dma_setup(struct device *dev) { }  in acpi_arch_dma_setup()
271 #define PHYS_CPUID_INVALID (phys_cpuid_t)(-1)
294 int acpi_processor_evaluate_cst(acpi_handle handle, u32 cpu,
298 static inline int acpi_processor_evaluate_cst(acpi_handle handle, u32 cpu,  in acpi_processor_evaluate_cst()  argument
301 	return -ENODEV;  in acpi_processor_evaluate_cst()
307 int acpi_map_cpu(acpi_handle handle, phys_cpuid_t physid, u32 acpi_id,
315 int acpi_get_ioapic_id(acpi_handle handle, u32 gsi_base, u64 *phys_addr);
318 int acpi_register_ioapic(acpi_handle handle, u64 phys_addr, u32 gsi_base);
319 int acpi_unregister_ioapic(acpi_handle handle, u32 gsi_base);
320 int acpi_ioapic_registered(acpi_handle handle, u32 gsi_base);
326 #define INVALID_ACPI_IRQ	((unsigned)-1)
335 int acpi_register_gsi (struct device *dev, u32 gsi, int triggering, int polarity);
354 	return -1;  in acpi_get_override_irq()
425 extern long acpi_is_video_device(acpi_handle handle);
443 	return -EOPNOTSUPP;  in acpi_get_genport_coordinates()
449 int acpi_get_node(acpi_handle handle);
452  * pxm_to_online_node - Map proximity ID to online node
459  * ACPI device drivers, which are called after the NUMA initialization has
460  * completed in the kernel, can call this interface to obtain their device
480 static inline int acpi_get_node(acpi_handle handle)  in acpi_get_node()  argument
487 #define PXM_INVAL	(-1)
548 acpi_status acpi_run_osc(acpi_handle handle, struct acpi_osc_context *context);
554 /* Indexes into _OSC Capabilities Buffer (DWORDs 2 to 5 are device-specific) */
568 /* Platform-Wide Capabilities _OSC: Capabilities DWORD 2: Support Field */
633 	u32 *ret = context->ret.pointer;  in acpi_osc_ctx_get_pci_control()
640 	u32 *ret = context->ret.pointer;  in acpi_osc_ctx_get_cxl_control()
722 					       const struct device *dev);
724 const void *acpi_device_get_match_data(const struct device *dev);
725 extern bool acpi_driver_match_device(struct device *dev,
727 int acpi_device_uevent_modalias(const struct device *, struct kobj_uevent_env *);
728 int acpi_device_modalias(struct device *, char *, int);
736 	adev->flags.visited = true;  in acpi_device_set_enumerated()
741 	adev->flags.visited = false;  in acpi_device_clear_enumerated()
772 int acpi_get_local_u64_address(acpi_handle handle, u64 *addr);
773 int acpi_get_local_address(acpi_handle handle, u32 *addr);
774 const char *acpi_get_subsystem_id(acpi_handle handle);
785 /* Get rid of the -Wunused-variable for adev */
805 	return -ENODEV;  in acpi_dev_uid_to_integer()
862 static inline bool has_acpi_companion(struct device *dev)  in has_acpi_companion()
867 static inline void acpi_preset_companion(struct device *dev,  in acpi_preset_companion()
877 static inline struct device *acpi_get_first_physical_node(struct acpi_device *adev)  in acpi_get_first_physical_node()
922 	return -ENODEV;  in acpi_table_parse()
945 	const struct acpi_device_id *ids, const struct device *dev)  in acpi_match_device()
950 static inline const void *acpi_device_get_match_data(const struct device *dev)  in acpi_device_get_match_data()
955 static inline bool acpi_driver_match_device(struct device *dev,  in acpi_driver_match_device()
961 static inline bool acpi_check_dsm(acpi_handle handle, const guid_t *guid,  in acpi_check_dsm()  argument
967 static inline union acpi_object *acpi_evaluate_dsm(acpi_handle handle,  in acpi_evaluate_dsm()  argument
975 static inline union acpi_object *acpi_evaluate_dsm_typed(acpi_handle handle,  in acpi_evaluate_dsm_typed()  argument
984 static inline int acpi_device_uevent_modalias(const struct device *dev,  in acpi_device_uevent_modalias()
987 	return -ENODEV;  in acpi_device_uevent_modalias()
990 static inline int acpi_device_modalias(struct device *dev,  in acpi_device_modalias()
993 	return -ENODEV;  in acpi_device_modalias()
1013 static inline int acpi_dma_get_range(struct device *dev, const struct bus_dma_region **map)  in acpi_dma_get_range()
1015 	return -ENODEV;  in acpi_dma_get_range()
1018 static inline int acpi_dma_configure(struct device *dev,  in acpi_dma_configure()
1024 static inline int acpi_dma_configure_id(struct device *dev,  in acpi_dma_configure_id()
1043 	return -EINVAL;  in acpi_reconfig_notifier_register()
1048 	return -EINVAL;  in acpi_reconfig_notifier_unregister()
1056 static inline int acpi_get_local_address(acpi_handle handle, u32 *addr)  in acpi_get_local_address()  argument
1058 	return -ENODEV;  in acpi_get_local_address()
1061 static inline const char *acpi_get_subsystem_id(acpi_handle handle)  in acpi_get_subsystem_id()  argument
1063 	return ERR_PTR(-ENODEV);  in acpi_get_subsystem_id()
1069 	return -ENXIO;  in acpi_register_wakeup_handler()
1129 static inline int acpi_get_lps0_constraint(struct device *dev)  in acpi_get_lps0_constraint()
1140 int acpi_dev_suspend(struct device *dev, bool wakeup);
1141 int acpi_dev_resume(struct device *dev);
1142 int acpi_subsys_runtime_suspend(struct device *dev);
1143 int acpi_subsys_runtime_resume(struct device *dev);
1144 int acpi_dev_pm_attach(struct device *dev, bool power_on);
1145 bool acpi_storage_d3(struct device *dev);
1146 bool acpi_dev_state_d0(struct device *dev);
1148 static inline int acpi_subsys_runtime_suspend(struct device *dev) { return 0; }  in acpi_subsys_runtime_suspend()
1149 static inline int acpi_subsys_runtime_resume(struct device *dev) { return 0; }  in acpi_subsys_runtime_resume()
1150 static inline int acpi_dev_pm_attach(struct device *dev, bool power_on)  in acpi_dev_pm_attach()
1154 static inline bool acpi_storage_d3(struct device *dev)  in acpi_storage_d3()
1158 static inline bool acpi_dev_state_d0(struct device *dev)  in acpi_dev_state_d0()
1165 int acpi_subsys_prepare(struct device *dev);
1166 void acpi_subsys_complete(struct device *dev);
1167 int acpi_subsys_suspend_late(struct device *dev);
1168 int acpi_subsys_suspend_noirq(struct device *dev);
1169 int acpi_subsys_suspend(struct device *dev);
1170 int acpi_subsys_freeze(struct device *dev);
1171 int acpi_subsys_poweroff(struct device *dev);
1172 int acpi_subsys_restore_early(struct device *dev);
1174 static inline int acpi_subsys_prepare(struct device *dev) { return 0; }  in acpi_subsys_prepare()
1175 static inline void acpi_subsys_complete(struct device *dev) {}  in acpi_subsys_complete()
1176 static inline int acpi_subsys_suspend_late(struct device *dev) { return 0; }  in acpi_subsys_suspend_late()
1177 static inline int acpi_subsys_suspend_noirq(struct device *dev) { return 0; }  in acpi_subsys_suspend_noirq()
1178 static inline int acpi_subsys_suspend(struct device *dev) { return 0; }  in acpi_subsys_suspend()
1179 static inline int acpi_subsys_freeze(struct device *dev) { return 0; }  in acpi_subsys_freeze()
1180 static inline int acpi_subsys_poweroff(struct device *dev) { return 0; }  in acpi_subsys_poweroff()
1181 static inline int acpi_subsys_restore_early(struct device *dev) { return 0; }  in acpi_subsys_restore_early()
1193 char *acpi_handle_path(acpi_handle handle);
1195 void acpi_handle_printk(const char *level, acpi_handle handle,
1197 void acpi_evaluation_failure_warn(acpi_handle handle, const char *name,
1201 acpi_handle_printk(const char *level, void *handle, const char *fmt, ...) {}  in acpi_handle_printk()  argument
1202 static inline void acpi_evaluation_failure_warn(acpi_handle handle,  in acpi_evaluation_failure_warn()  argument
1209 void __acpi_handle_debug(struct _ddebug *descriptor, acpi_handle handle, const char *fmt, ...);
1218 #define acpi_handle_emerg(handle, fmt, ...)				\  argument
1219 	acpi_handle_printk(KERN_EMERG, handle, fmt, ##__VA_ARGS__)
1220 #define acpi_handle_alert(handle, fmt, ...)				\  argument
1221 	acpi_handle_printk(KERN_ALERT, handle, fmt, ##__VA_ARGS__)
1222 #define acpi_handle_crit(handle, fmt, ...)				\  argument
1223 	acpi_handle_printk(KERN_CRIT, handle, fmt, ##__VA_ARGS__)
1224 #define acpi_handle_err(handle, fmt, ...)				\  argument
1225 	acpi_handle_printk(KERN_ERR, handle, fmt, ##__VA_ARGS__)
1226 #define acpi_handle_warn(handle, fmt, ...)				\  argument
1227 	acpi_handle_printk(KERN_WARNING, handle, fmt, ##__VA_ARGS__)
1228 #define acpi_handle_notice(handle, fmt, ...)				\  argument
1229 	acpi_handle_printk(KERN_NOTICE, handle, fmt, ##__VA_ARGS__)
1230 #define acpi_handle_info(handle, fmt, ...)				\  argument
1231 	acpi_handle_printk(KERN_INFO, handle, fmt, ##__VA_ARGS__)
1234 #define acpi_handle_debug(handle, fmt, ...)				\  argument
1235 	acpi_handle_printk(KERN_DEBUG, handle, fmt, ##__VA_ARGS__)
1238 #define acpi_handle_debug(handle, fmt, ...)				\  argument
1240 			   handle, pr_fmt(fmt), ##__VA_ARGS__)
1242 #define acpi_handle_debug(handle, fmt, ...)				\  argument
1245 		acpi_handle_printk(KERN_DEBUG, handle, fmt, ##__VA_ARGS__); \
1272 	return -ENXIO;  in acpi_dev_gpio_irq_wake_get_by()
1293 /* Device properties */
1313 	return !list_empty(&adev->data.properties);  in acpi_dev_has_props()
1333  * struct acpi_probe_entry - boot-time probing entry
1390 					  (&ACPI_PROBE_TABLE_END(t) -	\
1398 	return -ENXIO;  in acpi_dev_get_property()
1406 	return -ENXIO;  in __acpi_node_get_property_reference()
1414 	return -ENXIO;  in acpi_node_get_property_reference()
1421 	return -ENXIO;  in acpi_node_prop_get()
1435 	return ERR_PTR(-ENXIO);  in acpi_graph_get_next_endpoint()
1444 	return -ENXIO;  in acpi_graph_get_remote_endpoint()
1482 int acpi_irq_get(acpi_handle handle, unsigned int index, struct resource *res);
1485 int acpi_irq_get(acpi_handle handle, unsigned int index, struct resource *res)  in acpi_irq_get()  argument
1487 	return -EINVAL;  in acpi_irq_get()
1496 	return -EINVAL;  in lpit_read_residency_count_address()
1518 	return -EINVAL;  in acpi_pptt_cpu_is_thread()
1522 	return -EINVAL;  in find_acpi_cpu_topology()
1526 	return -EINVAL;  in find_acpi_cpu_topology_cluster()
1530 	return -EINVAL;  in find_acpi_cpu_topology_package()
1534 	return -EINVAL;  in find_acpi_cpu_topology_hetero_id()
1557 extern void acpi_device_notify(struct device *dev);
1558 extern void acpi_device_notify_remove(struct device *dev);
1560 static inline void acpi_device_notify(struct device *dev) { }  in acpi_device_notify()
1561 static inline void acpi_device_notify_remove(struct device *dev) { }  in acpi_device_notify_remove()
1564 static inline void acpi_use_parent_companion(struct device *dev)  in acpi_use_parent_companion()
1566 	ACPI_COMPANION_SET(dev, ACPI_COMPANION(dev->parent));  in acpi_use_parent_companion()
1577 	return -EOPNOTSUPP;  in hmat_update_target_coordinates()