diff --git a/hw/README.md b/hw/README.md
new file mode 100644
index 0000000..a287ba8
--- /dev/null
+++ b/hw/README.md
@@ -0,0 +1,15 @@
+# Foboot Firmware Component
+
+## Usage
+
+To build:
+
+`python3 .\foboot-bitstream.py`
+
+This will ensure you have the required dependencies, and check out all submodules.
+
+## Tests
+
+You can run tests by using the `unittest` command:
+
+`python .\lxbuildenv.py -r -m unittest -v valentyusb.usbcore.cpu.epfifo_test.TestPerEndpointFifoInterface`
\ No newline at end of file