add instructions for running gate level sim
diff --git a/README.md b/README.md
index 5bfd9fb..e11fac5 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,27 @@
 control applications. It is a peripheral that sits between firmwares and motors to free up
 processing on the microcontroller and greatly simplify the motor driver.
 
+## Gate Level Testing
+
+Instructions for running gate-level validation:
+
+Make sure submodules are correct:
+```
+git submodule init
+git submodule update
+```
+
+Gate-level testing directory:
+
+```
+cd verilog/dv/caravel/rapcore/io_ports
+```
+
+```
+make clean
+make
+```
+
 ## Features
 
 - Onboard stepper motor commutator with microstepping