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 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 */ 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 93 static inline int acpi_video_register(void) { return -ENODEV; } 94 static inline void acpi_video_unregister(void) { return; } 95 static inline void acpi_video_register_backlight(void) { return; } 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 } 101 static inline enum acpi_backlight_type acpi_video_get_backlight_type(void) 102 { 103 return acpi_backlight_vendor; 104 } 105 static inline bool acpi_video_backlight_use_native(void) 106 { 107 return true; 108 } 109 static inline bool acpi_video_handles_brightness_key_presses(void) 110 { 111 return false; 112 } 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