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 /* 79 * This function MUST only be called by GPU drivers to check if the driver 80 * should register a backlight class device. This function not only checks 81 * if a GPU native backlight device should be registered it *also* tells 82 * the ACPI video-detect code that native GPU backlight control is available. 83 * Therefor calling this from any place other then the GPU driver is wrong! 84 * To check if GPU native backlight control is used in other places instead use: 85 * if (acpi_video_get_backlight_type() == acpi_backlight_native) { ... } 86 */ 87 static inline bool acpi_video_backlight_use_native(void) 88 { 89 return __acpi_video_get_backlight_type(true, NULL) == acpi_backlight_native; 90 } 91 #else 92 static inline int acpi_video_register(void) { return -ENODEV; } 93 static inline void acpi_video_unregister(void) { return; } 94 static inline void acpi_video_register_backlight(void) { return; } 95 static inline int acpi_video_get_edid(struct acpi_device *device, int type, 96 int device_id, void **edid) 97 { 98 return -ENODEV; 99 } 100 static inline enum acpi_backlight_type acpi_video_get_backlight_type(void) 101 { 102 return acpi_backlight_vendor; 103 } 104 static inline bool acpi_video_backlight_use_native(void) 105 { 106 return true; 107 } 108 static inline bool acpi_video_handles_brightness_key_presses(void) 109 { 110 return false; 111 } 112 static inline int acpi_video_get_levels(struct acpi_device *device, 113 struct acpi_video_device_brightness **dev_br, 114 int *pmax_level) 115 { 116 return -ENODEV; 117 } 118 #endif 119 120 #endif 121