diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d41aff8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,61 @@
+# Fomu Workshop
+
+This repository contains files and projects that will be useful during the Fomu workshop.
+
+Fomu aims to be accessible from multiple levels, from interactive REPL-style scripting all the way down to low-level hardware description languages.
+
+## Micropython
+
+Micropython is a work-in-progress port to Fomu.  Currently the following features exist:
+
+* Manipulate RGB LED
+* Read SPI flash ID
+
+### Required Software
+
+* dfu-util
+* terminal emulator (screen, Tera Term, picocom, etc.)
+
+### Usage
+
+To load Micropython, use `dfu-util`:
+
+```sh
+# If this is the first time loading Micropython
+$ dfu-util -D micropython-fomu.dfu
+
+# If Micropython has already been loaded
+$ dfu-util -e
+```
+
+Then access the USB serial port using your serial program of choice.
+
+## RISC-V
+
+You can directly program the RISC-V softcore on Fomu.  The VexRiscv implements an RV32I core with no multiply unit.
+
+### Required Software
+
+* [Risc-V Toolchain](https://www.sifive.com/boards/)
+* make
+
+### Usage
+
+The `riscv-blink/` directory contains a simple "blink" program.  This utilizes the LEDD hardware PWM block to produce a pleasing "fade" pattern.  The `riscv-blink/` example project is entirely self-contained.  All you have to do is go into the directory and run `make`.
+
+For a more advanced example, the `riscv-usb-cdcacm/` directory contains a program that enumerates as a USB serial port.  This simply echoes back any characters that are typed, adding 1 to the value.  For example, if you send "a", it will respond with "b".
+
+As with micropython, you can load these binaries with `dfu-util -D output.bin`.
+
+## HDL
+
+HDL interfaces directly with the hardware.  With Verilog, you have complete control over the chip.  For easier debugging, LiteX lets you write in Python, which provides you with a USB debug bridge.
+
+### Required Software
+
+* [Yosys](https://github.com/FPGAwars/toolchain-yosys/releases/latest)
+* [Icestorm](https://github.com/FPGAwars/toolchain-ice40/releases/latest)
+* [Nextpnr](https://github.com/FPGAwars/toolchain-ice40/releases/latest)
+* [Python](https://www.python.org/downloads/) (for LiteX)
+
+The first is a simple Verilog blink, and is located in the `verilog-blink/` directory.  Go into this directory and run `make FOMU_REV=???`.  You will need to specify the version of Fomu you're using.  Once it is built, you can load the bitstream with `dfu-util -D blink.bin`.
\ No newline at end of file
diff --git a/litex/deps/litex b/litex/deps/litex
index 408d3f1..7656f54 160000
--- a/litex/deps/litex
+++ b/litex/deps/litex
@@ -1 +1 @@
-Subproject commit 408d3f1f7c5a4657dd9e964da4ed76f35cfd9e8f
+Subproject commit 7656f54d0a1e44fb53a366b0b5030b4c8b7ad4df
diff --git a/micropython-fomu.dfu b/micropython-fomu.dfu
new file mode 100644
index 0000000..f416808
Binary files /dev/null and b/micropython-fomu.dfu differ
diff --git a/reference/FPGA-SBTICETechnologyLibrary201504.pdf b/reference/FPGA-SBTICETechnologyLibrary201504.pdf
new file mode 100644
index 0000000..a0d6318
Binary files /dev/null and b/reference/FPGA-SBTICETechnologyLibrary201504.pdf differ
diff --git a/reference/FPGA-TN--2008-iCE40OscillatorUsageGuide.pdf b/reference/FPGA-TN--2008-iCE40OscillatorUsageGuide.pdf
new file mode 100644
index 0000000..f08fdcc
Binary files /dev/null and b/reference/FPGA-TN--2008-iCE40OscillatorUsageGuide.pdf differ
diff --git a/reference/FPGA-TN-1288-ICE40LEDDriverUsageGuide.pdf b/reference/FPGA-TN-1288-ICE40LEDDriverUsageGuide.pdf
new file mode 100644
index 0000000..60261ae
Binary files /dev/null and b/reference/FPGA-TN-1288-ICE40LEDDriverUsageGuide.pdf differ
diff --git a/reference/tomu-fpga-evt1.pdf b/reference/tomu-fpga-evt1.pdf
new file mode 100644
index 0000000..e977b41
Binary files /dev/null and b/reference/tomu-fpga-evt1.pdf differ