Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JulianKemmerer/PipelineC-Graphics
Graphics demos
https://github.com/JulianKemmerer/PipelineC-Graphics
Last synced: about 1 month ago
JSON representation
Graphics demos
- Host: GitHub
- URL: https://github.com/JulianKemmerer/PipelineC-Graphics
- Owner: JulianKemmerer
- Created: 2021-11-09T23:34:23.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-03-22T15:22:47.000Z (10 months ago)
- Last Synced: 2024-08-10T14:22:26.137Z (5 months ago)
- Language: Verilog
- Size: 5.26 MB
- Stars: 96
- Watchers: 7
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PipelineC-Graphics
Graphics demos implemented using [PipelineC](https://github.com/JulianKemmerer/PipelineC).
This primarily consists of a ray tracing demo created using [CflexHDL](https://github.com/suarezvictor/CflexHDL) C++ code.
Work contained in these repositories is experimental and in active development. Please [report any issues](https://github.com/JulianKemmerer/PipelineC-Graphics/issues) that are encountered.
# Sphery vs. Shapes:
A fully working interactive raytraced game written in C and translated to a circuit. No CPU is used, and the few resources used run at an outstanding power efficiency. Check out a [demo video](https://youtu.be/hn3sr3VMJQU) of gameplay on real hardware!
A detailed article describing this work is [here](https://github.com/JulianKemmerer/PipelineC-Graphics/blob/main/doc/Sphery-vs-Shapes.pdf)
# Install
* Install clang 14
```
wget https://apt.llvm.org/llvm.sh
chmod +x llvm.sh
sudo ./llvm.sh 14
# Copy/link specific .so file to generic .so to avoid missing .so file error
sudo cp /usr/lib/x86_64-linux-gnu/libclang-14.so.14.0.6 /usr/lib/x86_64-linux-gnu/libclang-14.so
```
* Install sdl2 lib, OpenMP, Un-If-Def Tool
```
sudo apt install libsdl2-dev
sudo apt install libomp-dev
sudo apt install unifdef
```
* Clone repos adjacent to each other in one dir
```
git clone https://github.com/JulianKemmerer/PipelineC-Graphics
git clone https://github.com/suarezvictor/CflexHDL
git clone https://github.com/JulianKemmerer/PipelineC
```
* Install open source EDA tools
* https://github.com/YosysHQ/oss-cad-suite-build/releases
```
export PATH="/oss-cad-suite/bin:$PATH"
```
* Make CFlexHDL cflexparser
```
cd CflexHDL/cflexparser
make
# may need to add '-fno-lto' to makefile to avoid
# fatal error: bytecode stream in file libpython3.8.a generated with LTO version 6.0 instead of the expected 8.1
```
* Install [Litex](https://github.com/enjoy-digital/litex/wiki/Installation)
* `TODO` more info...
# Building
Boards supported are the [Digilent Arty-100T](https://digilent.com/reference/programmable-logic/arty-a7/start) and the [OrangeCrab 85F v0.2](https://1bitsquared.com/products/orangecrab).
For the Arty: `make clean BOARD=digilent_arty FRAME_WIDTH=1920 FRAME_HEIGHT=1080 load`
For the OrangeCrab: `make clean BOARD=gsd_orangecrab load` (default 640x480 resolution, uses open source toolchain for synthesis)
You need to select `DVI=True` or `DVI=False` in [litex_soc.py](https://github.com/JulianKemmerer/PipelineC-Graphics/blob/main/litex_soc.py#L19) to output digital video or analog video with a VGA PMOD
Full pipelining can take some hours, for faster processing you can try simulation options like `make sim`, `make gen`, or `make verilator`
# Contact
Social Media:
[@pipelinec_hdl](https://fosstodon.org/@pipelinec)
[@suarezvictor](https://twitter.com/suarezvictor)
Talk on Discord:
* [Sphery vs. Shapes](https://discord.gg/cGfAt4HpJW)
* [PipelineC](https://discord.gg/Aupm3DDrK2)
* [Digital Design HQ](https://discord.gg/pY2wJvnCMY)
* `#hdl-other`
* `#project-chat`
* `#fpga`