Deep: Dark-Fantasy

Global Dark mode for ALL apps on ANY platforms.

:arrowdown: See the demo below :arrowdown:

:arrowup: See the demo above :arrowup:

How?

By putting an FPGA between your video card and monitor.

Prerequisite

• You need a video card and a monitor that supports HDMI.
• You need an FPGA develop board. For v2.0 we only support Digilent Zybo Z7-20.
• You need a microSD card with at least 8MiB of free space.

Note: For v1.0 we supported AX7Z100 but that was discontinued.

TL;DR

You can follow these steps get Deep: Dark-Fantasy running:

1. Get a Zybo Z7-20 if you don't have one.
2. Get a microSD card, format its first partition as FAT32.
3. Download our pre-built boot image file (BOOT.bin) from here.
4. Put the downloaded image file (BOOT.bin) into the microSD card. Do NOT modify its name.
5. Put the microSD card into the SD MICRO slot on the FPGA develop board.
6. On the Zybo Z7-20 board, locate jumper J4 and set it to SD. See "microSD Boot Mode" in the Reference Manual (page 13) for help.
7. Use a power adapter to supply the FPGA develop board.
8. Locate jumper JP6 and set it to WALL. See "Power Supplies" in the Reference Manual (page 9) for help.
9. Use an HDMI Cable connect your video source (video card / mother board video output) to the HDMI RX port of the board.
10. Use another HDMI Cable connect your video destination (monitor) to the HDMI TX port of the board.
11. Power on the board.
12. Make sure that all four switches are off (away from the LEDs.)

13. There are four LEDs. LED2~LED0 are used to indicate which Fantasy mode the devices is currently in. There are 8 Fantasy modes in total, so the LEDs are organized in binary form.

    | PCB Symbol | LED3 | LED2 | LED1 | LED0 | | ---------- | ---- | ---- | ---- | ---- | | Function | Video In | Fantasy Mode (MSB) | Fantasy Mode | Fantasy Mode (LSB) |

14. There are four contiguous black buttons on the board, which can be used to configure Deep: Dark-Fantasy to work in one of the 8 Fantasy modes. Try'em all and find the one that fits you best.

    | PCB Symbol | BTN3 | BTN2 | BTN1 | BTN0 | | ---------- | ---- | ---- | ---- | ---- | | Function | Reset | Previous Fantasy | Next Fantasy | Use Default Fantasy (3) |

Build Deep: Dark-Fantasy from source code

If the default settings don't work for you for some reason, you should try build the project from source code.

Note: You need Xilinx Vivado (2020.1), make, bash, node, npm, and awk to generate the bitstream file. You also need a ttf font for the overlay number display. Futhermore, you need Xilinx Vitis (2020.1), make, bash to generate the bootable image.

Step 1: Get the source code

You need to (fork and) clone the repo first: ```bash git clone --depth=1 https://github.com/b1f6c1c4/Deep-DarkFantasy.git git submodule update --init --recursive

Or, use git-get:

git gets b1f6c1c4/Deep-DarkFantasy

```

In the file config you can find the following parameters: ```verilog

Video parameters

HWIDTH=1920 HSTART=2008 HTOTAL=2200 VHEIGHT=1080 FREQ=148.50

Dark-Fantasy parameters

KH=24 # Block width (px) KV=24 # Block height (px) SMOOTH_T=1200 # Smoothing time (ms)

Overlay parameters

FONT_SZ=768 # (px) ```

Step 2: Configure the video parameters

Since most OS and video cards will adapt to whatever device connected to it, you usually don't need to modify these parameters. However, if it is NOT the case, you must either force your video card to cater to the FPGA, or force your FPGA to cater to the video card. The first way is usually easier, but here are are explaining the second way.

• If you are using Linux with X11, use the following command:

  bash xrandr --verbose And you will see tons of modelines. Find the one with *current, which looks like: 1920x1080 (0x1c8) 148.500MHz +HSync +VSync *current +preferred h: width 1920 start 2008 end 2052 total 2200 skew 0 clock 67.50KHz v: height 1080 start 1084 end 1089 total 1125 clock 60.00Hz Now you should know where does those magic numbers came from. Edit the parameters in config to match the numbers from xrandr.

  Note: If you have multiple displays, pick the one you want to use Deep: Dark-Fantasy. You need one FPGA develop board per display if you want all your displays to be Dark-Fantasy.

• If you are using macOS or Windows, you are having some trouble. If you do encounter problems like this, please feel free to submit an issue.

Step 3: Configure the block size

You can modify the two parameter KH and KV. It is used to specify the size of blocks - the smaller blocks are, the finer granularity Dark-Fantasy effect is achieved. However, if the blocks are too small, texts will become illegible for read. Furthermore, Deep: Dark-Fantasy may not work as desired with very small (<5) KH and/or KV.

Step 4: Configure the other parameters

• SMOOTH_T specifies the overall time of smooth transition (in milliseconds).
• FONT_SZ specifies the size of overlay mode font (in pixels). If set too large, you will run out of BRAM, so be discreet.

Step 5: Build the project

The project takes a while to build - usually several minutes to half an hour. Multicore won't help. ```bash

Specify the font

export FONT=/usr/share/fonts/truetype/noto/NotoMono-Regular.ttf

Specify your Xilinx Vivado installation

Specify your Xilinx SDK installation

export VIVODO=/opt/Xilinx/Vivado/2020.1 export VITIS=/opt/Xilinx/Vitis/2020.1

Perform synthsizing, implementation, bitstream creation, boot image creation.

This may take a while (15~25min), so be patient

make -j8 ```

You should be able to find BOOT.bin in the build folder. Put it into a FAT32-formatted SD card and put it on your FPGA board. Don't forget to configure the boot mode.

Limitation

• 4K is not supported. 1080p 120Hz is not supported.
• Only one resolution and refresh rate is supported once synthesized.