You've done the Chisel Bootcamp, and now you are ready to start your own Chisel project. The following procedure should get you started with a clean running Chisel3 project.
We recommend LTS releases Java 8 and Java 11. You can install the JDK as recommended by your operating system, or use the prebuilt binaries from AdoptOpenJDK.
SBT is the most common built tool in the Scala community. You can download it here.
This repository is a Github template. You can create your own repository from it by clicking the green Use this template in the top right.
Please leave Include all branches unchecked; checking it will pollute the history of your new repository.
For more information, see "Creating a repository from a template".
After using the template to create your own blank project, please wait a minute or two for the Template cleanup workflow to run which will removes some template-specific stuff from the repository (like the LICENSE).
Refresh the repository page in your browser until you see a 2nd commit by actions-user titled Template cleanup.
Once you have created a repository from this template and the Template cleanup workflow has completed, you can click the green button to get a link for cloning your repository.
Note that it is easiest to push to a repository if you set up SSH with Github, please see the related documentation. SSH is required for pushing to a Github repository when using two-factor authentication.
git clone [email protected]:dhxsy1994/chisel-dfc-module.git
cd chisel-dfc-moduleThe cleanup workflow will have attempted to provide sensible defaults for ThisBuild / organization and name in the build.sbt.
Feel free to use your text editor of choice to change them as you see fit.
Again, use you editor of choice to make the README specific to your project.
It is important to have a LICENSE for open source (or closed source) code. This template repository has the Unlicense in order to allow users to add any license they want to derivative code. The Unlicense is stripped when creating a repository from this template so that users do not accidentally unlicense their own work.
For more information about a license, check out the Github Docs.
git commit -m 'Starting chisel-dfc-module'
git push origin mainYou should now have a working Chisel3 project.
You can run the included test with:
sbt testYou should see a whole bunch of output that ends with something like the following lines
[info] [0.001] SEED 1540570744913
test GCD Success: 168 tests passed in 1107 cycles in 0.067751 seconds 16339.24 Hz
[info] [0.050] RAN 1102 CYCLES PASSED
[info] GCDTester:
[info] GCD
[info] Basic test using Driver.execute
[info] - should be used as an alternative way to run specification
[info] using --backend-name verilator
[info] running with --is-verbose
[info] running with --generate-vcd-output on
[info] running with --generate-vcd-output off
[info] ScalaTest
[info] Run completed in 3 seconds, 184 milliseconds.
[info] Total number of tests run: 1
[info] Suites: completed 1, aborted 0
[info] Tests: succeeded 1, failed 0, canceled 0, ignored 0, pending 0
[info] All tests passed.
[success] Total time: 5 s, completed Dec 16, 2020 12:18:44 PM
If you see the above then...
You are ready to go. We have a few recommended practices and things to do.
- Use packages and following conventions for structure and naming
- Package names should be clearly reflected in the testing hierarchy
- Build tests for all your work
- Read more about testing in SBT in the SBT docs
- This template includes a test dependency on chiseltest, this is a reasonable starting point for most tests
- You can remove this dependency in the build.sbt file if you want to
- Change the name of your project in the build.sbt file
- Change your README.md
Check out the Chisel Users Community page for links to get in contact!