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 acpi_backlight_dell_uart,
54 };
55
56 #if IS_ENABLED(CONFIG_ACPI_VIDEO)
57 extern int acpi_video_register(void);
58 extern void acpi_video_unregister(void);
59 extern void acpi_video_register_backlight(void);
60 extern int acpi_video_get_edid(struct acpi_device *device, int type,
61 int device_id, void **edid);
62 /*
63 * Note: The value returned by acpi_video_handles_brightness_key_presses()
64 * may change over time and should not be cached.
65 */
66 extern bool acpi_video_handles_brightness_key_presses(void);
67 extern int acpi_video_get_levels(struct acpi_device *device,
68 struct acpi_video_device_brightness **dev_br,
69 int *pmax_level);
70
71 extern enum acpi_backlight_type __acpi_video_get_backlight_type(bool native,
72 bool *auto_detect);
73
acpi_video_get_backlight_type(void)74 static inline enum acpi_backlight_type acpi_video_get_backlight_type(void)
75 {
76 return __acpi_video_get_backlight_type(false, NULL);
77 }
78
79 /*
80 * This function MUST only be called by GPU drivers to check if the driver
81 * should register a backlight class device. This function not only checks
82 * if a GPU native backlight device should be registered it *also* tells
83 * the ACPI video-detect code that native GPU backlight control is available.
84 * Therefor calling this from any place other then the GPU driver is wrong!
85 * To check if GPU native backlight control is used in other places instead use:
86 * if (acpi_video_get_backlight_type() == acpi_backlight_native) { ... }
87 */
acpi_video_backlight_use_native(void)88 static inline bool acpi_video_backlight_use_native(void)
89 {
90 return __acpi_video_get_backlight_type(true, NULL) == acpi_backlight_native;
91 }
92 #else
acpi_video_register(void)93 static inline int acpi_video_register(void) { return -ENODEV; }
acpi_video_unregister(void)94 static inline void acpi_video_unregister(void) { return; }
acpi_video_register_backlight(void)95 static inline void acpi_video_register_backlight(void) { return; }
acpi_video_get_edid(struct acpi_device * device,int type,int device_id,void ** edid)96 static inline int acpi_video_get_edid(struct acpi_device *device, int type,
97 int device_id, void **edid)
98 {
99 return -ENODEV;
100 }
acpi_video_get_backlight_type(void)101 static inline enum acpi_backlight_type acpi_video_get_backlight_type(void)
102 {
103 return acpi_backlight_vendor;
104 }
acpi_video_backlight_use_native(void)105 static inline bool acpi_video_backlight_use_native(void)
106 {
107 return true;
108 }
acpi_video_handles_brightness_key_presses(void)109 static inline bool acpi_video_handles_brightness_key_presses(void)
110 {
111 return false;
112 }
acpi_video_get_levels(struct acpi_device * device,struct acpi_video_device_brightness ** dev_br,int * pmax_level)113 static inline int acpi_video_get_levels(struct acpi_device *device,
114 struct acpi_video_device_brightness **dev_br,
115 int *pmax_level)
116 {
117 return -ENODEV;
118 }
119 #endif
120
121 #endif
122