Source code for pynq.lib.video.dvi

#   Copyright (c) 2018, Xilinx, Inc.
#   All rights reserved.
#
#   Redistribution and use in source and binary forms, with or without
#   modification, are permitted provided that the following conditions are met:
#
#   1.  Redistributions of source code must retain the above copyright notice,
#       this list of conditions and the following disclaimer.
#
#   2.  Redistributions in binary form must reproduce the above copyright
#       notice, this list of conditions and the following disclaimer in the
#       documentation and/or other materials provided with the distribution.
#
#   3.  Neither the name of the copyright holder nor the names of its
#       contributors may be used to endorse or promote products derived from
#       this software without specific prior written permission.
#
#   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
#   AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
#   THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
#   PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#   CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
#   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
#   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
#   OR BUSINESS INTERRUPTION). HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
#   WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
#   OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
#   ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

__author__ = "Giuseppe Natale, Yun Rock Qu, Peter Ogden"
__copyright__ = "Copyright 2018, Xilinx"
__email__ = "pynq_support@xilinx.com"

import warnings
from .frontend import VideoInFrontend, VideoOutFrontend
from .common import *
from pynq import DefaultHierarchy
from pynq.ps import CPU_ARCH, ZYNQ_ARCH

if CPU_ARCH == ZYNQ_ARCH:
    import pynq.lib._video
else:
    warnings.warn("DVI/HDMI subsystem only supported on Zynq-7000",
                  ResourceWarning)


[docs]class HDMIInFrontend(VideoInFrontend, DefaultHierarchy): """Class for interacting the with HDMI input frontend This class is used for enabling the HDMI input and retrieving the mode of the incoming video Attributes ---------- mode : VideoMode The detected mode of the incoming video stream """ def __init__(self, description): super().__init__(description)
[docs] def start(self, init_timeout=60): """Method that blocks until the video mode is successfully detected """ ip_dict = self.description gpio_description = ip_dict['ip']['axi_gpio_hdmiin'] gpio_dict = { 'BASEADDR': gpio_description['phys_addr'], 'INTERRUPT_PRESENT': 1, 'IS_DUAL': 1, } vtc_description = ip_dict['ip']['vtc_in'] vtc_capture_addr = vtc_description['phys_addr'] self._capture = pynq.lib._video._capture(gpio_dict, vtc_capture_addr, init_timeout)
[docs] def stop(self): """Currently empty function included for symmetry with the HDMIOutFrontend class """ pass
[docs] @staticmethod def checkhierarchy(description): return ('vtc_in' in description['ip'] and 'axi_gpio_hdmiin' in description['ip'])
@property def mode(self): return VideoMode(self._capture.frame_width(), self._capture.frame_height(), 24)
_outputmodes = { (640, 480): 0, (800, 600): 1, (1280, 720): 2, (1280, 1024): 3, (1920, 1080): 4 }
[docs]class HDMIOutFrontend(VideoOutFrontend, DefaultHierarchy): """Class for interacting the HDMI output frontend This class is used for enabling the HDMI output and setting the desired mode of the video stream Attributes ---------- mode : VideoMode Desired mode for the output video. Must be set prior to calling start """
[docs] @staticmethod def checkhierarchy(description): return ('vtc_out' in description['ip'] and 'axi_dynclk' in description['ip'])
def __init__(self, description): """Create the HDMI output front end Parameters ---------- vtc_description : dict The IP dictionary entry for the video timing controller to use clock_description : dict The IP dictionary entry for the clock generator to use """ super().__init__(description) ip_dict = self.description['ip'] vtc_description = ip_dict['vtc_out'] clock_description = ip_dict['axi_dynclk'] vtc_capture_addr = vtc_description['phys_addr'] clock_addr = clock_description['phys_addr'] self._display = pynq.lib._video._display(vtc_capture_addr, clock_addr, 1) self.start = self._display.start """Start the HDMI output - requires the that mode is already set""" self.stop = self._display.stop """Stop the HDMI output""" @property def mode(self): """Get or set the video mode for the HDMI output, must be set to one of the following resolutions: 640x480 800x600 1280x720 1280x1024 1920x1080 Any other resolution will result in a ValueError being raised. The bits per pixel will always be 24 when retrieved and ignored when set. """ return VideoMode(self._display.frame_width(), self._display.frame_height(), 24) @mode.setter def mode(self, value): resolution = (value.width, value.height) if resolution in _outputmodes: self._display.mode(_outputmodes[resolution]) else: raise ValueError("Invalid Output resolution {}x{}" .format(value.width, value.height))