Skip to content

Latest commit

 

History

History
119 lines (87 loc) · 3.45 KB

README.md

File metadata and controls

119 lines (87 loc) · 3.45 KB
Raw

DkVideo

Chisel translation of TangNano-4K-example/dk_video

Build this Chisel3 project

Dependencies

JDK 8 or newer

We recommend LTS releases Java 8 and Java 11. You can install the JDK as recommended by your operating system, or use the prebuilt binaries from AdoptOpenJDK.

JDK setup on Debian/Ubuntu
sudo apt-get update
sudo apt install openjdk-11-jdk

SBT or mill

SBT is the most common built tool in the Scala community. You can download it here.
mill is another Scala/Java build tool without obscure DSL like SBT. You can download it here

SBT setup on Debian/Ubuntu
sudo apt-get update
sudo apt-get install apt-transport-https curl gnupg -yqq
echo "deb https://repo.scala-sbt.org/scalasbt/debian all main" | sudo tee /etc/apt/sources.list.d/sbt.list
echo "deb https://repo.scala-sbt.org/scalasbt/debian /" | sudo tee /etc/apt/sources.list.d/sbt_old.list
curl -sL "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x2EE0EA64E40A89B84B2DF73499E82A75642AC823" | sudo -H gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/scalasbt-release.gpg --import
sudo chmod 644 /etc/apt/trusted.gpg.d/scalasbt-release.gpg
sudo apt-get update
sudo apt-get install sbt

openFPGALoader

openFPGALoader Universal utility for programming FPGAs.
You can use prebuilt binaries from OSS CAD Suite:

wget -N "https://github.com/YosysHQ/oss-cad-suite-build/releases/download/2022-02-05/oss-cad-suite-linux-x64-20220205.tgz"
tar xzf oss-cad-suite-linux-x64-20220205.tgz
source ./oss-cad-suite/environment

Libraries

To generate the core some additionnal Chisel libraries are required to be published locally:

git clone https://github.com/Martoni/fpgamacro
cd fpgamacro
sbt publishLocal
cd ..
git clone https://github.com/Martoni/HdmiCore
cd HdmiCore
sbt publishLocal
cd ..

How to get started

Clone this repository

git clone https://github.com/scpcom/DkVideo
cd DkVideo

Build the project

To generate core with gowin DviTx encrypted ip do:

sbt -J-Xss256m "runMain dkvideo.video_topGen"

To use opensource HdmiCore:

sbt -J-Xss256m "runMain dkvideo.video_topGen noGowinDviTx"

Other options:
device type: tangnano4k tangnano9k
memory type: hpram psram noram
window size/screen resolution: vga svga sd hd (and more)
window position: center top left right bottom
camera type: ov2640 gc0328 nocam
Example:

sbt -J-Xss256m "runMain dkvideo.video_topGen noGowinDviTx vga out hd center bottom"

Currently the fix-verilog.sh is used as workaround for one bit array [0:0] until a real solution is found.

Generate the binary fs

Since the project still uses HyperRAM, VFB and PLL IP you can not use open source tools to build the binary.
Only DVI_TX can be replaced with open source HdmiCore at this moment.
Open the project in GOWIN FPGA Designer.
If you use use opensource HdmiCore disable the file src/verilog/dvi_tx.v.
Push the "Run All" button

Upload to the device

openFPGALoader -b tangnano4k impl/pnr/DkVideo.fs