__ _____  __  _______  ___    __  _________
       / // / _ \/  |/  /  _/ |_  |  / / / / __/ _ )
      / _  / // / /|_/ // /  / __/  / /_/ /\ \/ _  |
     /_//_/____/_/  /_/___/ /____/  \____/___/____/
                      alternative

            Copyright 2015 / EnjoyDigital
              florent@enjoy-digital.fr

    Alternative HDMI2USB gateware and firmware based on Migen/MiSoC

[> Supported Boards
------------------

This firmware is supported on the following to boards;

 * Digilent Atlys - http://digilentinc.com/atlys/
   The original board used for HDMI2USB prototyping.
   Use `BOARD=atlys` with this board.

 * Numato Opsis
   The first production board made in conjunction with TimVideos.us project.
   Use `BOARD=opsis` with this board.

[> Getting started
------------------
1. Follow MiSoC Quick start guide
	https://github.com/m-labs/misoc

2. Clone https://github.com/timvideos/HDMI2USB-misoc-firmware into same directory as misoc

3. Follow instructions to build the gateware and software:
	# In the HDMI2USB-misoc-firmware directory
	make help

[> Status:
atlys_base:
* BaseSoC working (CPU + DDR2 + UART)
* MiniSoC working (BaseSoC + 10/100Mbps Ethernet MAC handled by the CPU)

opsis_base:
* BaseSoC working (CPU + DDR3 + UART)
* MiniSoC working (BaseSoC + 1Gbps Ethernet MAC handled by the CPU)

atlys_hdmi2ethernet:
* EtherboneSoC working (BaseSoC + 10/100Mbps HW Ethernet UDP/IP stack and Etherbone)
* VideomixerSoC working (EtherboneSoC + HDMI in + Framebuffer + Hdmi out)
* HDMI2EthernetSoC working (VideomixerSoC + JPEG encoder + UDP streamer)

atlys_hdmi2usb:
* VideomixerSoC working (MiniSoC + HDMI in + Framebuffer + Hdmi out)
* HDMI2USB working (VideomixerSoCerSoC + JPEG encoder + USB streamer)

[> Other Docs
USB UART - Use Linux drivers at https://github.com/shenki/exar-uart-driver

Original HDMI2USB firmware can be found at http://github.com/timvideos/HDMI2USB

 * The HDMI2USB wiki (http://github.com/timvideos/HDMI2USB/wiki) has lots of
   information about the Digilent Atlys board.

 * The HDMI2USB Developer Documentation - http://j.mp/hdmi2usb-dev-gdoc

[> Contact

Mailing List:
 * https://groups.google.com/forum/#!forum/hdmi2usb
 * hdmi2usb@googlegroups.com