This project is to make a installer to helping on setup a working msys2 environment for developping SpinalHDL design, in one step, offline. The installer in the (release)[https://github.com/Readon/msys2-installer/releases] directory of this repos contains separate versions of the SpinalHDL jar file, released with the same version number as the version of the SpinalHDL libraries contained therein.
Note: the installed sbt runtime version is 1.8.0. I add an option to SBT_OPTS to fixs this, it would override your project's sbt.version which is normally specified in project/build.properties file.
Installing the GUI installer via the CLI to C:\msys64:
.\msys2-x86_64-latest.exe in --confirm-command --accept-messages --root C:/msys64Uninstalling an existing installation in C:\msys64 via the CLI:
C:\msys64\uninstall.exe pr --confirm-commandInstalling the self extracting archive to C:\msys64:
.\msys2-base-x86_64-latest.sfx.exe -y -oC:\The interference could lead a mess up environment variable management.
Start a console from any of your favourite terminal by msys2_shell.cmd -defterm -no-start -mingw64 can start a standalone environment.
Note: Only MINGW64 environment is supported.
The installer provides some additional features such as installing shortcuts, registering an uninstaller, a GUI for selecting the installation path and automatically running a login shell at the end to initialize the MSYS2 environment.
If you unpack the archives and run a login shell once, you will get a functionally equivalent MSYS2 installation.
It contains the base package with others required packages by SpinalHDL runing and debugging, and all their dependencies. You can list the contained packages using: pactree base -lu | sort
The java environment is install through sdkman which helps to provide a standalone environment seperate from host Windows. So that portable using is possible. Java and sbt are all managed by sdkman in it's own directory /sdkman. On other way, jar cache file is installed in /cache so that we can use the installer offline.
Without starting the target IDE, open the MSYS2 built-in MINGW64 console and enter the path of the target IDE's startup executable file in the command line to start the target IDE which use this environment.
This installation package only includes the files required for compiling and testing the SpinalHDL project, and does not include the files needed for various IDEs and their plugins. Since different people use different development environments and IDE versions, it is recommended to install this package on an online machine, and after starting the compilation and testing of your project, copy the installation directory to the offline machine.
For using mirror downloads, you can refer to the Coursier official documentation.
create issue, or clone this repos and modify yourself.
This is the only stable version until now, use version 5 (until 5.016) would meet a bundle of problems.
By chances, compiling your project would report below, or other more. Then scala test in version 3.2.14 and scala in version 2.12.18 are prefered.
(update) found version conflict(s) in library dependencies; some are suspected to be binary incompatible:
[error]
[error] * org.scala-lang.modules:scala-xml_2.12:2.1.0 (early-semver) is selected over 1.0.6
[error] +- org.scalatest:scalatest-core_2.12:3.2.14 (depends on 2.1.0)
[error] +- org.scala-lang:scala-compiler:2.12.16 (depends on 1.0.6)Some releases before 0.9.5 would meet error while simulating with iverilog, which report this error. use the command below can solve it.
pacman -S mingw-w64-x86_64-boostVersion of SpinalHDL below 1.9.3 could not work with scala 2.12.13 as #1229 states. It will trigger version confilict. Until 1.9.4 the SpinalHDL upgrade scala compiler to 2.12.18, it will works. So we installed scala 2.12.18 in this case. Use scala version 2.12.18 in your project.