xref: /openbmc/u-boot/include/video_bridge.h (revision 014a953c)
1 /*
2  * Copyright (C) 2015 Google, Inc
3  * Written by Simon Glass <sjg@chromium.org>
4  *
5  * SPDX-License-Identifier:	GPL-2.0+
6  */
7 
8 #ifndef __VIDEO_BRIDGE
9 #define __VIDEO_BRIDGE
10 
11 #include <asm/gpio.h>
12 
13 /**
14  * struct video_bridge_priv - uclass information for video bridges
15  *
16  * @sleep:	GPIO to assert to power down the bridge
17  * @reset:	GPIO to assert to reset the bridge
18  * @hotplug:	Optional GPIO to check if bridge is connected
19  */
20 struct video_bridge_priv {
21 	struct gpio_desc sleep;
22 	struct gpio_desc reset;
23 	struct gpio_desc hotplug;
24 };
25 
26 /**
27  * Operations for video bridges
28  */
29 struct video_bridge_ops {
30 	/**
31 	 * attach() - attach a video bridge
32 	 *
33 	 * @return 0 if OK, -ve on error
34 	 */
35 	int (*attach)(struct udevice *dev);
36 
37 	/**
38 	 * check_attached() - check if a bridge is correctly attached
39 	 *
40 	 * This method is optional - if not provided then the hotplug GPIO
41 	 * will be checked instead.
42 	 *
43 	 * @dev:	Device to check
44 	 * @return 0 if attached, -EENOTCONN if not, or other -ve error
45 	 */
46 	int (*check_attached)(struct udevice *dev);
47 
48 	/**
49 	 * set_backlight() - Set the backlight brightness
50 	 *
51 	 * @dev:	device to adjust
52 	 * @percent:	brightness percentage (0=off, 100=full brightness)
53 	 * @return 0 if OK, -ve on error
54 	 */
55 	int (*set_backlight)(struct udevice *dev, int percent);
56 
57 	/**
58 	 * read_edid() - Read information from EDID
59 	 *
60 	 * @dev:	Device to read from
61 	 * @buf:	Buffer to read into
62 	 * @buf_size:	Buffer size
63 	 * @return number of bytes read, <=0 for error
64 	 */
65 	int (*read_edid)(struct udevice *dev, u8 *buf, int buf_size);
66 };
67 
68 #define video_bridge_get_ops(dev) \
69 		((struct video_bridge_ops *)(dev)->driver->ops)
70 
71 /**
72  * video_bridge_attach() - attach a video bridge
73  *
74  * @return 0 if OK, -ve on error
75  */
76 int video_bridge_attach(struct udevice *dev);
77 
78 /**
79  * video_bridge_set_backlight() - Set the backlight brightness
80  *
81  * @percent:	brightness percentage (0=off, 100=full brightness)
82  * @return 0 if OK, -ve on error
83  */
84 int video_bridge_set_backlight(struct udevice *dev, int percent);
85 
86 /**
87  * video_bridge_set_active() - take the bridge in/out of reset/powerdown
88  *
89  * @dev:	Device to adjust
90  * @active:	true to power up and reset, false to power down
91  */
92 int video_bridge_set_active(struct udevice *dev, bool active);
93 
94 /**
95  * check_attached() - check if a bridge is correctly attached
96  *
97  * @dev:	Device to check
98  * @return 0 if attached, -EENOTCONN if not, or other -ve error
99  */
100 int video_bridge_check_attached(struct udevice *dev);
101 
102 /**
103  * video_bridge_read_edid() - Read information from EDID
104  *
105  * @dev:	Device to read from
106  * @buf:	Buffer to read into
107  * @buf_size:	Buffer size
108  * @return number of bytes read, <=0 for error
109  */
110 int video_bridge_read_edid(struct udevice *dev, u8 *buf, int buf_size);
111 
112 #endif
113