HDMI2USB by timvideos

A version of the HDMI2USB firmware based around LiteX tools produced by @Enjoy-Digital (based on misoc+migen created by @M-Labs)

LiteX Build Environment

The LiteX Build Environment is a tool for easily developing LiteX based systems. It was originally designed to make the TimVideos' HDMI2USB easy to develop, but has now expanded to support multiple projects.

Quick Links


Important Terminology

  • Gateware - The FPGA configuration.
  • Soft CPU - A CPU running inside the FPGA.
  • Firmware - The software running on the soft CPU inside the FPGA.

Structure

LiteX BuildEnv Structure Image

Boards

The LiteX Build Environment supports a large number of FPGA boards, but not all boards can be used for all projects.

Firmware

  • HDMI2USB - The firmware currently used for the HDMI2USB project.
  • Bare Metal - Your own firmware running directly on the soft CPU in the FPGA.
  • Zephyr - Support for Zephyr RTOS.
  • Linux - Support for Linux.

Gateware

The Gateware is the configuration which generates our FPGA bitstream. It is generally defined by a platform and a target. You can find details for these under the platform and target directories in this project.

  • Platform - Represents the FPGA platform/devboard for which we will build the bitstream. (i.e. sim (Verilator Simulator), arty , opsis)
  • Target - There are multiple targets for each platform, this represents an SoC configuration for our target application. (i.e. base, net, video)

Environment

The environment is the shell setup and software packages provided by litex-buildenv which allow for litex based FPGA development. It provides development, build and troubleshooting capabilities.

To bootstrap or update your environment one generally does:

# Download the debian packages needed to support litex environment.  Usually
# we only do this once.
./scripts/download-env-root.sh

# Download/update the litex specific packages (python, verilator, submodules etc)
./scripts/download-env.sh

# Enter the Dev/Debug/Build environment
export PLATFORM=arty TARGET=net CPU=or1k
source ./scripts/enter-env.sh

Applications

FIXME: Put stuff here.

LiteX Application Relationship

Other Topics

FIXME: Put stuff here.


License

This code was developed by the people found in the AUTHORS file (including major contributions from EnjoyDigital) and released under a BSD/MIT license.

Code under the third_party directory comes from external sources and is available in their own licenses.

Contact

TimVideo.us:

EnjoyDigital:

Copyright 2017 The Authors. 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.

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 OWNER 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.

Project Meta

  • Registered 2 years ago
  • Started 4 years ago
  • Last commit 2 years ago

Commits

{"labels":[2015,2016,2017,2018,2019],"series":[[531,712,354,0,0]]}

Commits per year

Contributors

{"labels":[2015,2016,2017,2018,2019],"series":[[8,13,10,0,0]]}

Unique contributors per year

Releases

v0.0.4 is is the latest of 5 releases.

  • v0.0.4
    Jan 4, 2018 2b63ffa
  • v0.0.3
    Feb 7, 2017 60b1bc6
  • v0.0.1
    Jun 8, 2016 96b208d
  • v0.0.2
    Jun 8, 2016 fe5d74a
  • v0.0.0
    Jul 5, 2015 02c9827

Languages

{"labels":[],"series":[]}

Share of languages used

Data Sheet
Project Web Site
https://github.com/timvideos/HDMI2USB-litex-firmware.git
Issue Tracker
Last updated 2 years ago
v0.0.4 released 1 year ago
142 open issues
7 open pull requests
61 forks
24 watchers
91 stars
1597 commits by 21 contributors
Tim 'mithro' Ansell Florent Kermarrec Joel Stanley Ryan Verner Joel Addison

Activity in last 1 year

Updated 3 months ago