aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAdam Izraelevitz2017-03-15 15:54:53 -0700
committerColin Schmidt2017-03-15 15:54:53 -0700
commit308fc62bf8bfbb66afc06eb28310781fe9a7d2b8 (patch)
tree08f2001f9704d66341c59a74eab398767eaf0815
parentcaa32f8c04887c9930d101082f764ed36a5b63fb (diff)
Update readme with links to wiki (#493)
-rw-r--r--README.md37
1 files changed, 25 insertions, 12 deletions
diff --git a/README.md b/README.md
index 8b7c1f3f..dbfbda2c 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,31 @@
This repository is in ALPHA VERSION, so many things may change in the coming months.
+#### Wiki's and Tutorials
+
+Useful information is on our wiki, located here:
+* https://github.com/ucb-bar/firrtl/wiki
+
+Some important pages to read, before writing your own transform:
+* [Submitting Pull Requests](https://github.com/ucb-bar/firrtl/wiki/submitting-a-pull-request)
+* [Understanding Firrtl's IR](https://github.com/ucb-bar/firrtl/wiki/Understanding-Firrtl-Intermediate-Representation)
+* [Traversing a Circuit](https://github.com/ucb-bar/firrtl/wiki/traversing-a-circuit)
+* [Common Pass Idioms](https://github.com/ucb-bar/firrtl/wiki/Common-Pass-Idioms)
+
+To write a Firrtl transform, please start with the tutorial here: [src/main/scala/tutorial](https://github.com/ucb-bar/firrtl/blob/master/src/main/scala/tutorial).
+To run these examples:
+```
+sbt assembly
+./utils/bin/firrtl -td regress -tn rocket --custom-transforms tutorial.lesson1.AnalyzeCircuit
+./utils/bin/firrtl -td regress -tn rocket --custom-transforms tutorial.lesson2.AnalyzeCircuit
+```
+
+#### Other Tools
+* Firrtl syntax highlighting for Vim users: https://github.com/azidar/firrtl-syntax
+* Chisel3, an embedded hardware DSL that generates Firrtl: https://github.com/ucb-bar/chisel3
+* Firrtl Interpreter: https://github.com/ucb-bar/firrtl-interpreter
+* Yosys Verilog-to-Firrtl Front-end: https://github.com/cliffordwolf/yosys
+
#### Installation Instructions
*Disclaimer*: This project is in alpha, so there is no guarantee anything works. The installation instructions should work for OSX/Linux machines.
@@ -30,16 +55,6 @@
sbt publish-local
```
-##### Transform Writing Tutorial
-
-To write a Firrtl transform, please start with the tutorial here: [src/main/scala/tutorial](https://github.com/ucb-bar/firrtl/blob/master/src/main/scala/tutorial).
-To run this example:
-```
-sbt assembly
-./utils/bin/firrtl -td regress -tn rocket --custom-transforms tutorial.lesson1.AnalyzeCircuit
-./utils/bin/firrtl -td regress -tn rocket --custom-transforms tutorial.lesson2.AnalyzeCircuit
-```
-
##### Useful sbt Tips
1. Run a single test suite:
`sbt "testOnly firrtlTests.UnitTests"`
@@ -58,5 +73,3 @@ utils/bin/firrtl -i regress/rocket.fir -o regress/rocket.v -X verilog // Compile
utils/bin/firrtl --help // Returns usage string
```
-##### Other Tools
-Firrtl syntax highlighting for Vim users: https://github.com/azidar/firrtl-syntax