xref: /OK3568_Linux_fs/kernel/include/linux/wmi.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-only */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * wmi.h - ACPI WMI interface
4*4882a593Smuzhiyun  *
5*4882a593Smuzhiyun  * Copyright (c) 2015 Andrew Lutomirski
6*4882a593Smuzhiyun  */
7*4882a593Smuzhiyun 
8*4882a593Smuzhiyun #ifndef _LINUX_WMI_H
9*4882a593Smuzhiyun #define _LINUX_WMI_H
10*4882a593Smuzhiyun 
11*4882a593Smuzhiyun #include <linux/device.h>
12*4882a593Smuzhiyun #include <linux/acpi.h>
13*4882a593Smuzhiyun #include <linux/mod_devicetable.h>
14*4882a593Smuzhiyun #include <uapi/linux/wmi.h>
15*4882a593Smuzhiyun 
16*4882a593Smuzhiyun struct wmi_device {
17*4882a593Smuzhiyun 	struct device dev;
18*4882a593Smuzhiyun 
19*4882a593Smuzhiyun 	 /* True for data blocks implementing the Set Control Method */
20*4882a593Smuzhiyun 	bool setable;
21*4882a593Smuzhiyun };
22*4882a593Smuzhiyun 
23*4882a593Smuzhiyun /* evaluate the ACPI method associated with this device */
24*4882a593Smuzhiyun extern acpi_status wmidev_evaluate_method(struct wmi_device *wdev,
25*4882a593Smuzhiyun 					  u8 instance, u32 method_id,
26*4882a593Smuzhiyun 					  const struct acpi_buffer *in,
27*4882a593Smuzhiyun 					  struct acpi_buffer *out);
28*4882a593Smuzhiyun 
29*4882a593Smuzhiyun /* Caller must kfree the result. */
30*4882a593Smuzhiyun extern union acpi_object *wmidev_block_query(struct wmi_device *wdev,
31*4882a593Smuzhiyun 					     u8 instance);
32*4882a593Smuzhiyun 
33*4882a593Smuzhiyun extern int set_required_buffer_size(struct wmi_device *wdev, u64 length);
34*4882a593Smuzhiyun 
35*4882a593Smuzhiyun struct wmi_driver {
36*4882a593Smuzhiyun 	struct device_driver driver;
37*4882a593Smuzhiyun 	const struct wmi_device_id *id_table;
38*4882a593Smuzhiyun 
39*4882a593Smuzhiyun 	int (*probe)(struct wmi_device *wdev, const void *context);
40*4882a593Smuzhiyun 	int (*remove)(struct wmi_device *wdev);
41*4882a593Smuzhiyun 	void (*notify)(struct wmi_device *device, union acpi_object *data);
42*4882a593Smuzhiyun 	long (*filter_callback)(struct wmi_device *wdev, unsigned int cmd,
43*4882a593Smuzhiyun 				struct wmi_ioctl_buffer *arg);
44*4882a593Smuzhiyun };
45*4882a593Smuzhiyun 
46*4882a593Smuzhiyun extern int __must_check __wmi_driver_register(struct wmi_driver *driver,
47*4882a593Smuzhiyun 					      struct module *owner);
48*4882a593Smuzhiyun extern void wmi_driver_unregister(struct wmi_driver *driver);
49*4882a593Smuzhiyun #define wmi_driver_register(driver) __wmi_driver_register((driver), THIS_MODULE)
50*4882a593Smuzhiyun 
51*4882a593Smuzhiyun #define module_wmi_driver(__wmi_driver) \
52*4882a593Smuzhiyun 	module_driver(__wmi_driver, wmi_driver_register, \
53*4882a593Smuzhiyun 		      wmi_driver_unregister)
54*4882a593Smuzhiyun 
55*4882a593Smuzhiyun #endif
56