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 #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