diff --git a/README.md b/README.md
index d6dcb25..b02012c 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,33 @@ one round takes one cycle. The overhead latency cost when using the top
 level wrapper is three, which means that with eight rounds the total
 latency is 11 cycles. For ChaCha20 the latency is 23 cycles.
 
+## FuseSoC
+This core is supported by the
+[FuseSoC](https://github.com/olofk/fusesoc) core package manager and
+build system. Some quick  FuseSoC instructions:
+
+#install FuseSoC
+pip install fusesoc
+
+#Create and enter a new workspace
+mkdir workspace && cd workspace
+
+#Register aes as a library in the workspace
+fusesoc library add chacha /path/to/aes
+#...if repo is available locally or...
+#...to get the upstream repo
+fusesoc library add chacha https://github.com/secworks/chacha
+
+#Run tb_chacha testbench
+fusesoc run --target=tb_chacha secworks:crypto:chacha
+
+#Run with modelsim instead of default tool (icarus)
+fusesoc run --target=tb_chacha --tool=modelsim secworks:crypto:chacha
+
+#List all targets
+fusesoc core show secworks:crypto:aes
+
+
 
 ## Implementation results##