Flashing Firmware

How to update the HDMI2USB-litex-firmware from the HDMI2USB prebuilt repository onto your Numato Opsis or Digilent Atlys board.

Currently this is only supported under Linux.

Required: openocd 0.10.0 fxload hdmi2usb-mode-switch

Numato Opsis

To upgrade the firmware to a stable version:

Install hdmi2usb-mode-switch and its dependencies.

Debian Stretch

Ubuntu Xenial

sudo apt --assume-yes install software-properties-common
sudo add-apt-repository --yes --update ppa:timvideos/fpga-support
sudo apt install hdmi2usb-mode-switch  

Digilent Atlys

blacklist xr_usb_serial_common
sudo apt install vizzini-dkms
wget https://raw.githubusercontent.com/timvideos/HDMI2USB-firmware-prebuilt/master/archive/master/v0.0.2-81-gd0d3aea/atlys/hdmi2usb/hdmi2usb.hex
hdmi2usb-mode-switch -v --load-fx2-firmware hdmi2usb.hex

Get the stable version:

wget https://raw.githubusercontent.com/timvideos/HDMI2USB-mode-switch/master/bin/download-prebuilt-firmware.py
python3 download-prebuilt-firmware.py --platform opsis
hdmi2usb-mode-switch -v --flash-image image-gateware+bios+firmware*.bin

Solutions to common problems

If you see this (which seems to happen 100% of the time now, so it gets listed here)

DNA = 110000001100000011000000110000001100000011000000110000001 (0x181818181818181)

Do this, then retry the --flash-image.

sudo hdmi2usb-mode-switch -v --mode serial

Otherwise, here are some links to other known problems and solutions.

common-errors