summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorSchuyler Eldridge2019-09-25 15:58:39 -0400
committerGitHub2019-09-25 15:58:39 -0400
commitf6107b19fce0c4d0a16c795c711ffe825da62b94 (patch)
tree22433953fe6e3ef7718b771b6614232b5215ea4f /README.md
parentb03006e30904ed51fa94a47fbfd0f7b199498ca1 (diff)
parente0238a23176e416836e6647b91390695e1b366c4 (diff)
Merge pull request #1190 from freechipsproject/readme-fix
Readme Fixes
Diffstat (limited to 'README.md')
-rw-r--r--README.md20
1 files changed, 10 insertions, 10 deletions
diff --git a/README.md b/README.md
index 8493f929..f4c70ae3 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
![Chisel 3](https://raw.githubusercontent.com/freechipsproject/chisel3/master/doc/images/chisel_logo.svg?sanitize=true)
-#
+---
[![Join the chat at https://gitter.im/freechipsproject/chisel3](https://badges.gitter.im/freechipsproject/chisel3.svg)](https://gitter.im/freechipsproject/chisel3?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![CircleCI](https://circleci.com/gh/freechipsproject/chisel3/tree/master.svg?style=shield)](https://circleci.com/gh/freechipsproject/chisel3/tree/master)
@@ -12,13 +12,13 @@ This generator methodology enables the creation of re-usable components and libr
For more information on the benefits of Chisel see: ["What benefits does Chisel offer over classic Hardware Description Languages?"](https://stackoverflow.com/questions/53007782/what-benefits-does-chisel-offer-over-classic-hardware-description-languages)
-Chisel is powered by [FIRRTL (Flexible Intermediate Representation for RTL)](https://github.com/freechipsproject/firrtl), a hardware compiler framework that performs optimizations of Chisel-generated circuits and supports custom user-defined circuit transformations.
+Chisel is powered by [FIRRTL (Flexible Intermediate Representation for RTL)](https://github.com/freechipsproject/firrtl), a hardware compiler framework that performs optimizations of Chisel-generated circuits and supports custom user-defined circuit transformations.
## What does Chisel code look like?
Consider an FIR filter that implements a convolution operation, as depicted in this block diagram:
-<img src="doc/images/fir_filter.svg?sanitize=true" width="512" />
+<img src="https://github.com/freechipsproject/chisel3/blob/readme-fix/doc/images/fir_filter.svg?sanitize=true" width="512" />
While Chisel provides similar base primitives as synthesizable Verilog, and *could* be used as such:
@@ -51,15 +51,15 @@ class FirFilter(bitWidth: Int, coeffs: Seq[UInt]) extends Module {
for (i <- 1 until coeffs.length) {
zs(i) := zs(i-1)
}
-
+
// Do the multiplies
val products = VecInit.tabulate(coeffs.length)(i => zs(i) * coeffs(i))
-
+
// Sum up the products
io.out := products.reduce(_ + _)
}
```
-
+
and use and re-use them across designs:
```scala
val movingAverage3Filter = FirFilter(8.W, Seq(1.U, 1.U, 1.U)) // same 3-point moving average filter as before
@@ -72,7 +72,7 @@ val triangleFilter = FirFilter(8.W, Seq(1.U, 2.U, 3.U, 2.U, 1.U)) // 5-point FI
### Bootcamp Interactive Tutorial
The [**online Chisel Bootcamp**](https://mybinder.org/v2/gh/freechipsproject/chisel-bootcamp/master) is the recommended way to get started with and learn Chisel.
-**No setup is required** (it runs in the browser), nor does it assume any prior knowledge of Scala.
+**No setup is required** (it runs in the browser), nor does it assume any prior knowledge of Scala.
### Build Your Own Chisel Projects
@@ -88,7 +88,7 @@ resolvers ++= Seq(
)
libraryDependencies += "edu.berkeley.cs" %% "chisel3" % "3.2-SNAPSHOT"
libraryDependencies += "edu.berkeley.cs" %% "chisel-testers2" % "0.1-SNAPSHOT"
-```
+```
### Design Verification
@@ -110,9 +110,9 @@ These simulation-based verification tools are available for Chisel:
If you are migrating from Chisel2, see [the migration guide on the wiki](https://github.com/ucb-bar/chisel3/wiki/Chisel3-vs-Chisel2).
### Data Types Overview
-These are the base data types for defining circuit wires (abstract types which may not be instantiated are greyed out):
+These are the base data types for defining circuit components:
-![Image](doc/images/type_hierarchy.png?raw=true)
+![Image](https://raw.githubusercontent.com/freechipsproject/chisel3/master/doc/images/type_hierarchy.svg?sanitize=true)
## Developer Documentation
This section describes how to get started developing Chisel itself, including how to test your version locally against other projects that pull in Chisel using [sbt's managed dependencies](https://www.scala-sbt.org/1.x/docs/Library-Dependencies.html).