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

sudo apt install hdmi2usb-mode-switch/stretch-backports

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

# Stretch: 
wget https://launchpad.net/~timvideos/+archive/ubuntu/fpga-support/+files/vizzini-dkms_1.0.0-5~ppa3~ubuntu14.04_all.deb
sudo dpkg -i vizzini-dkms_1.0.0-5~ppa3~ubuntu14.04_all.deb

## Trusty:
sudo apt install vizzini-dkms

blacklist xr_usb_serial_common

All platforms and OSs:

Get and flash 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

Atlys

needs fx2 blob (after power cycling, I think?)

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

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.

# Opsis
sudo hdmi2usb-mode-switch -v --mode serial 

# Atlys (you may need to guess about 006)
fxload -t fx2lp -D /dev/bus/usb/001/006 -I /lib/firmware/hdmi2usb.hex 

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

common-errors

notes about version versions