You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Xiretza 5fb8d3a176 gitignore: ignore __pycache__ 5 months ago
vhdl fix: workaround nextpnr-xilinx#42 5 months ago
.gitignore gitignore: ignore __pycache__ 5 months ago
.gitmodules Add ws2812 submodule 6 months ago
LICENSE fix: add license 6 months ago
Makefile chore: clean up makefile, remove unused targets 6 months ago
Makefile.nextpnr fix: suppress ghdl binding warnings during synthesis 6 months ago
Makefile.symbiflow fix(Makefile.symbiflow): fix read_verilog yosys command 6 months ago doc: add packet structure to README 6 months ago
arty_a7_35.xdc vhdl: rename clk_sys to sys_clk 6 months ago Pixel UDP port demo 6 months ago

WS2812 driver gateware for blinkenwall v3

At 100 FPS, a single strand of WS2812 can only be just over 300 LEDs long:

318 = (1 / 100 - 50e-6) / 1.3e-6 / 24

Because blinkenwall v3 has 64 * 96 = 6144 pixels, driving it at 100 FPS requires at least 6144 / 318 = 20 parallel drivers. For simplicity, the wall is devided into 24 strands of 256 LEDs. Unfortunately, most microcontrollers have at most a couple WS2812-capable interfaces (typically SPI), so this would require coordinating several microcontrollers in parallel. A much more integrated solution is to instantiate as many WS2812 drivers as desired in an FPGA, then point the entire video firehose at the FPGA.

Ethernet communication

The controller accepts UDP packets containing image data on port 61437 ("PIXEL"). Each packet contains color data for one strand of LEDs.

The packet structure is as follows:

00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f
00 magic (0x5049_584c) strand number frame number 0 px1 R px1 G px1 B
10 0 px2 R px2 G px2 B 0 px3 R px3 G px3 B 0 px4 R px4 G px4 B ...

Every packet begins with a magic number 0x5049584c (ASCII for "PIXL"), followed by the strand number and the frame number. All numbers are big endian. After the header follows the pixel data, separated into one 4-byte word per LED.

Once all strands for a given frame number have been received and the video page has been flipped, the controller answers with a confirmation packet:

00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f
00 frame number