]> git.sur5r.net Git - u-boot/blob - include/video_bridge.h
dm: video: bridge: add operation to read EDID
[u-boot] / include / video_bridge.h
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