diff options
| author | Jack Koenig | 2021-10-10 14:03:31 -0700 |
|---|---|---|
| committer | GitHub | 2021-10-10 21:03:31 +0000 |
| commit | 3643b7baa9f70ea8d6455928034ae4157bc59cee (patch) | |
| tree | 57bde5a089f717fe0f93bebe0f4bc9f65a5caa87 /README.md | |
| parent | 7930544e9c8047f27285420204d25f78c753ea57 (diff) | |
Update developer documentation in README (#2160)
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 20 |
1 files changed, 6 insertions, 14 deletions
@@ -111,14 +111,14 @@ If you like a textbook to learn Chisel and also a bit of digital design in gener ### Build Your Own Chisel Projects -See [the setup instructions](https://github.com/chipsalliance/chisel3/blob/master/SETUP.md) for how to set up your environment to run Chisel locally. +See [the setup instructions](SETUP.md) for how to set up your environment to build Chisel locally. When you're ready to build your own circuits in Chisel, **we recommend starting from the [Chisel Template](https://github.com/freechipsproject/chisel-template) repository**, which provides a pre-configured project, example design, and testbench. Follow the [chisel-template readme](https://github.com/freechipsproject/chisel-template) to get started. If you insist on setting up your own project, the magic SBT lines are: ```scala -libraryDependencies += "edu.berkeley.cs" %% "chisel3" % "3.4.0" -libraryDependencies += "edu.berkeley.cs" %% "chiseltest" % "0.3.0" % "test" +libraryDependencies += "edu.berkeley.cs" %% "chisel3" % "3.4.4" +libraryDependencies += "edu.berkeley.cs" %% "chiseltest" % "0.3.4" % "test" ``` ### Design Verification @@ -155,18 +155,11 @@ The [Useful Resources](#useful-resources) for users are also helpful for contrib ### Compiling and Testing Chisel -First, clone and build the master branch of [FIRRTL](https://github.com/chipsalliance/firrtl) and [Treadle](https://github.com/chipsalliance/treadle), as the master branch of Chisel may depend on unreleased changes in those projects: - -``` -git clone https://github.com/chipsalliance/firrtl.git -git clone https://github.com/chipsalliance/treadle.git -pushd firrtl; sbt publishLocal; popd -pushd treadle; sbt publishLocal; popd -``` +You must first install required dependencies to build Chisel locally, please see [the setup instructions](SETUP.md). Clone and build the Chisel library: -``` +```bash git clone https://github.com/chipsalliance/chisel3.git cd chisel3 sbt compile @@ -185,14 +178,13 @@ If the compilation succeeded and the dependencies noted above are installed, you sbt test ``` - - If you would like to run the tests without the compiler plugin (less common), you can do so by first launching `sbt`, then running `noPluginTests / test`: ``` sbt > noPluginTests / test ``` + ### Running Projects Against Local Chisel To use the development version of Chisel (`master` branch), you will need to build from source and `publishLocal`. |
