Chisel Project Versioning

Chisel and related projects follow a versioning scheme similar to PVP. Project versions are of the form A.B.C where A.B specifies the Major version and C specifies the Minor version. Projects maintain binary compatibility between minor versions of the same major version. For example, a project compiled against Chisel3 version 3.4.0 can be used with Chisel3 version 3.4.2 or 3.4.15 without recompilation.

Compatible Versions

Historically, due to a mistake in versioning with chisel-iotesters as well as some projects originating later than others, the compatible versions of Chisel-related projects has not been obvious. We are taking steps to improve the situation by bringing the major versions more in line (the B part in A.B.C), but the inconsistencies remain in previously published versions. Beginning with Chisel 3.5, the major versions for all projects are aligned on A.5).

Please use the following table to determine which versions of the related projects are compatible. In particular, versions of projects in this table were compiled against the version of any dependencies listed in the same row. For example, chisel-iotesters version 1.4 was compiled against chisel3 version 3.3.

chisel3 chiseltest chisel-iotesters3 firrtl treadle diagrammer firrtl-interpreter2
3.5 0.54 2.55 1.5 1.54 1.54 -
3.4 0.3 1.5 1.4 1.3 1.3 1.4
3.3 0.2 1.4 1.3 1.2 1.2 1.3
3.2 0.11 1.3 1.2 1.1 1.1 1.2
3.1 - 1.2 1.1 1.0 1.0 1.1
3.0 - 1.1 1.0 - - 1.0

1 chiseltest 0.1 was published under artifact name chisel-testers2 (0.2 was published under both artifact names)
2 Replaced by Treadle, in maintenance mode only since version 1.1, final version is 1.4
3 Replaced by chiseltest, final version is 2.5
4 chiseltest, treadle, and diagrammer skipped X.4 to have a consistent major version with Chisel
5 chisel-iotesters skipped from 1.5 to 2.5 to have a consistent major version with Chisel