Help: ICE_CORES_INSTALLATION

Installing the ICE tree for Core development

To run the builds for an ICE card, the ICE environment needs an FPGA compiler,
a JVM, and the ICE tree with the extra -soc extra zip file installed on 
a machine running Linux. All of the unix scripts depend on the following
environment variables:

  $XILINX   the root of the Xilinx ISE installation (ie /user/opt/Xilinx)
  $VIVADO   the root of the VIVADO installation (ie /user/opt/Xilinx/Vivado/2019.2)
  $ICEROOT  the root of the ICE option tree (ie /user/opt/icexxx)
  $JAVAHOME the root of the JDK installation (ie /opt/jdk1.8.0_301)

The Xilinx, Vivado, and JDK installations should be documented elsewhere.

The ICE tree installation is as follows.

The standard ICE tree sofware is distributed as iceXXX-YY.zip.
The System-On-Chip code for FPGA development is iceXXX-YY-soc.zip.
These can be found on the ice website under Downloads/Software/

Modify your .bashrc or .cshrc to add the following and rerun them:

for bash
  export ICEROOT=/user/opt/icexxx	! for example
  alias ice=$ICEROOT/jre/ice		! as is
  alias xi=$ICEROOT/code/soc/xilinx	! as is
or for csh
  setenv ICEROOT /user/opt/icexxx	! for example
  alias ice $ICEROOT/jre/ice		! as is
  alias xi $ICEROOT/code/soc/xilinx	! as is

On unix, it is handy to use a link to the current software tree.
  cd $ICEROOT/..
  ln -sfn iceXXX-YY icexxx

Next cd to $ICEROOT/.. and unzip the standard ICE tree.
  cd $ICEROOT/..
  unzip iceXXX-YY.zip

Next create the code directory and unzip the -soc ICE tree.
  mkdir $ICEROOT/code
  cd $ICEROOT/code
  unzip iceXXX-YY-soc.zip

If all of the dependencies have been installed properly, you should be able to build
the tree from the linux prompt with:
  ice reinstall

If you have ICE hardware on the system and need to install the drivers, use:
  ice install

To check your installation, try running
  ice sh
This should put you at a Nextmidas prompt, nM>
To make sure you can display X-windows graphics on your machine, run
  nM> spice
You should see a window pop up with this guide in the center window.

The build script for Xilinx and Altera FPGAs is $ICEROOT/code/soc/xilinx.
It can be run directly to compile user FPGA code. For example:
  xi make/v k8m rru
Run xi without arguments to see syntax details.