diff --git a/README.md b/README.md
index f6b1e25..e2c6b61 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 
 ## Example of using [eurorack-pmod](https://github.com/apfelaudio/eurorack-pmod) with LiteX.
 
-TODO: add nice block diagram here
+![block diagram of gateware / firmware](doc/block_diagram.png)
 
 The `example-ecpix-5.py` SoC in this repository has the following main parts:
 - A softcore (RISCV `vexriscv_smp`, here we use `rv32im` without compressed instructions).
diff --git a/doc/block_diagram.png b/doc/block_diagram.png
new file mode 100644
index 0000000..de7ee2b
Binary files /dev/null and b/doc/block_diagram.png differ