clattner-test / spt

This is a test repository, experimenting with an approach of building a modular set of tools for verilog and other SiFive related projects.

SPT is just a placeholder, "SiFive Platform Tools". It has been pointed out that this is far too close to the existing "SBT" tool and it also only has three letters. A better 4-letter suggestion is very welcome :-)

Setting this up

These are the commands Chris used to set this up on a Mac:

1. Install Dependences of LLVM/MLIR according to the instructions, including cmake and ninja.

2. Check out LLVM and SPT repo's:

$ cd ~/Projects
$ git clone git@github.com:llvm/llvm-project.git
$ git clone git@github.com:sifive/clattner-experimental.git spt

3. HACK: Add symlink because I can't figure out how to get LLVM_EXTERNAL_SPT_SOURCE_DIR to work with cmake:

$ cd ~/Projects/llvm-project
$ ln -s ../spt spt

4. Configure the build to build MLIR and SPT (MLIR is probably not necessary, but it builds reasonably fast and is good to provide a sanity check that things are working):

$ cd ~/Projects/llvm-project
$ mkdir build
$ cd build
$ cmake -G Ninja ../llvm  -DLLVM_EXTERNAL_PROJECTS="spt" -DLLVM_EXTERNAL_SPT_SOURCE_DIR=/Users/chrisl/Projects/spt   -DLLVM_ENABLE_PROJECTS="mlir;spt" -DLLVM_TARGETS_TO_BUILD="X86;RISCV"  -DLLVM_ENABLE_ASSERTIONS=ON -DCMAKE_BUILD_TYPE=DEBUG

The -DCMAKE_BUILD_TYPE=DEBUG flag enables debug information, which makes the whole tree compile slower, but allows you to step through code into the LLVM and MLIR frameworks.

To get something that runs fast, use -DCMAKE_BUILD_TYPE=Release or -DCMAKE_BUILD_TYPE=RelWithDebInfo if you want to go fast and optionally if you want debug info to go with it. RELEASE mode makes a very large difference in performance.

5. Build MLIR and run MLIR tests as a smoketest:

$ ninja check-mlir

6. Build SPT and run SPT tests:

$ ninja check-spt

Submitting changes to SPT

Submitting changes to LLVM / MLIR

This project depends on MLIR and LLVM, and it is occasionally useful to improve them. To get set up for this:

1. Follow the "How to Contribute" instructions, and install the right tools, e.g. 'arcanist' and clang-format.
2. Get an LLVM Phabricator account
3. ask for LLVM commit access.

Submitting a patch

The patch flow goes like this:

1. Check out the LLVM mono repo (as described above).
2. Make changes to your codebase.
3. Stage your changes with git add.
4. Run clang-format to tidy up the details of the patch with git clang-format origin/master
5. Create a patch in Phabricator with arc diff.
6. Iterate on review, changing your code and sending another patch with arc diff.

When your review converges and your patch is approved, do the following:

1. commit your changes with git commit
2. rebase your changes with git pull --rebase
3. retest your patch with ninja check-mlir (or whatever other target makes sense)
4. push your changes with git push