HDMI2USB by timvideos
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
-
Dependency documentation
-
Projects using LiteX Build Environment:
- HDMI2USB - The HDMI2USB project develops affordable hardware options to record and stream HD videos (from HDMI & DisplayPort sources) for conferences, meetings and user groups.
- FuPy - The aim of the FuPy project is to make MicroPython run on FPGAs using the LiteX & Migen+MiSoC technologies. This allows you to do full stack development (FPGA gateware & soft CPU firmware) in Python!
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
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:
# Install system wide dependencies;
# * wget
# * bash
# * make
# * udev rules from https://github.com/litex-hub/litex-buildenv-udev
#
# On Debian you can use the ./scripts/debian-setup.sh script.
# 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.
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:
-
Mailing List:
-
IRC:
- irc://irc.freenode.net/#timvideos [Web Interface]
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.
https://github.com/timvideos/HDMI2USB-litex-firmware.git
Issue Tracker
Last activity 1 year ago
v0.0.4 released 4 years ago
Primary language: C/C++ Header
143 open issues
7 open pull requests
65 forks
26 watchers
107 stars
2684 commits by 59 contributors
activity over the last year
LibreCores data updated 1 year ago