xref: /openbmc/u-boot/include/video_bridge.h (revision be059e88)
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 #define video_bridge_get_ops(dev) \
59 		((struct video_bridge_ops *)(dev)->driver->ops)
60 
61 /**
62  * video_bridge_attach() - attach a video bridge
63  *
64  * @return 0 if OK, -ve on error
65  */
66 int video_bridge_attach(struct udevice *dev);
67 
68 /**
69  * video_bridge_set_backlight() - Set the backlight brightness
70  *
71  * @percent:	brightness percentage (0=off, 100=full brightness)
72  * @return 0 if OK, -ve on error
73  */
74 int video_bridge_set_backlight(struct udevice *dev, int percent);
75 
76 /**
77  * video_bridge_set_active() - take the bridge in/out of reset/powerdown
78  *
79  * @dev:	Device to adjust
80  * @active:	true to power up and reset, false to power down
81  */
82 int video_bridge_set_active(struct udevice *dev, bool active);
83 
84 /**
85  * check_attached() - check if a bridge is correctly attached
86  *
87  * @dev:	Device to check
88  * @return 0 if attached, -EENOTCONN if not, or other -ve error
89  */
90 int video_bridge_check_attached(struct udevice *dev);
91 
92 #endif
93