xref: /linux/include/acpi/video.h (revision 34dc1baba215b826e454b8d19e4f24adbeb7d00d)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __ACPI_VIDEO_H
3 #define __ACPI_VIDEO_H
4 
5 #include <linux/errno.h> /* for ENODEV */
6 #include <linux/types.h> /* for bool */
7 
8 struct acpi_video_brightness_flags {
9 	u8 _BCL_no_ac_battery_levels:1;	/* no AC/Battery levels in _BCL */
10 	u8 _BCL_reversed:1;		/* _BCL package is in a reversed order */
11 	u8 _BQC_use_index:1;		/* _BQC returns an index value */
12 };
13 
14 struct acpi_video_device_brightness {
15 	int curr;
16 	int count;
17 	int *levels;
18 	struct acpi_video_brightness_flags flags;
19 };
20 
21 struct acpi_device;
22 
23 #define ACPI_VIDEO_CLASS	"video"
24 
25 #define ACPI_VIDEO_DISPLAY_CRT  1
26 #define ACPI_VIDEO_DISPLAY_TV   2
27 #define ACPI_VIDEO_DISPLAY_DVI  3
28 #define ACPI_VIDEO_DISPLAY_LCD  4
29 
30 #define ACPI_VIDEO_DISPLAY_LEGACY_MONITOR 0x0100
31 #define ACPI_VIDEO_DISPLAY_LEGACY_PANEL   0x0110
32 #define ACPI_VIDEO_DISPLAY_LEGACY_TV      0x0200
33 
34 #define ACPI_VIDEO_NOTIFY_SWITCH		0x80
35 #define ACPI_VIDEO_NOTIFY_PROBE			0x81
36 #define ACPI_VIDEO_NOTIFY_CYCLE			0x82
37 #define ACPI_VIDEO_NOTIFY_NEXT_OUTPUT		0x83
38 #define ACPI_VIDEO_NOTIFY_PREV_OUTPUT		0x84
39 #define ACPI_VIDEO_NOTIFY_CYCLE_BRIGHTNESS	0x85
40 #define ACPI_VIDEO_NOTIFY_INC_BRIGHTNESS	0x86
41 #define ACPI_VIDEO_NOTIFY_DEC_BRIGHTNESS	0x87
42 #define ACPI_VIDEO_NOTIFY_ZERO_BRIGHTNESS	0x88
43 #define ACPI_VIDEO_NOTIFY_DISPLAY_OFF		0x89
44 
45 enum acpi_backlight_type {
46 	acpi_backlight_undef = -1,
47 	acpi_backlight_none = 0,
48 	acpi_backlight_video,
49 	acpi_backlight_vendor,
50 	acpi_backlight_native,
51 	acpi_backlight_nvidia_wmi_ec,
52 	acpi_backlight_apple_gmux,
53 };
54 
55 #if IS_ENABLED(CONFIG_ACPI_VIDEO)
56 extern int acpi_video_register(void);
57 extern void acpi_video_unregister(void);
58 extern void acpi_video_register_backlight(void);
59 extern int acpi_video_get_edid(struct acpi_device *device, int type,
60 			       int device_id, void **edid);
61 /*
62  * Note: The value returned by acpi_video_handles_brightness_key_presses()
63  * may change over time and should not be cached.
64  */
65 extern bool acpi_video_handles_brightness_key_presses(void);
66 extern int acpi_video_get_levels(struct acpi_device *device,
67 				 struct acpi_video_device_brightness **dev_br,
68 				 int *pmax_level);
69 
70 extern enum acpi_backlight_type __acpi_video_get_backlight_type(bool native,
71 								bool *auto_detect);
72 
73 static inline enum acpi_backlight_type acpi_video_get_backlight_type(void)
74 {
75 	return __acpi_video_get_backlight_type(false, NULL);
76 }
77 
78 static inline bool acpi_video_backlight_use_native(void)
79 {
80 	return __acpi_video_get_backlight_type(true, NULL) == acpi_backlight_native;
81 }
82 #else
83 static inline int acpi_video_register(void) { return -ENODEV; }
84 static inline void acpi_video_unregister(void) { return; }
85 static inline void acpi_video_register_backlight(void) { return; }
86 static inline int acpi_video_get_edid(struct acpi_device *device, int type,
87 				      int device_id, void **edid)
88 {
89 	return -ENODEV;
90 }
91 static inline enum acpi_backlight_type acpi_video_get_backlight_type(void)
92 {
93 	return acpi_backlight_vendor;
94 }
95 static inline bool acpi_video_backlight_use_native(void)
96 {
97 	return true;
98 }
99 static inline bool acpi_video_handles_brightness_key_presses(void)
100 {
101 	return false;
102 }
103 static inline int acpi_video_get_levels(struct acpi_device *device,
104 			struct acpi_video_device_brightness **dev_br,
105 			int *pmax_level)
106 {
107 	return -ENODEV;
108 }
109 #endif
110 
111 #endif
112