Skip to content

H
Hdlmake
Commit d82ab74a authored by Javier D. Garcia-Lasheras's avatar Javier D. Garcia-Lasheras
Browse files
Options

Remote Xilinx Synthesis is not supported on 3.0 release

parent 653e4c1b
Hide whitespace changes
Inline Side-by-side
Showing with 0 additions and 64 deletions
docs/index.rst
View file @ d82ab74a
......@@ -914,70 +914,6 @@ when ``hdlmake`` is executed:
Remote synthesis with Xilinx ISE
--------------------------------
When using ISE synthesis, ``hdlmake`` allows for the implementation of a centralized synthesis machine.
For this purpose, when running ``hdlmake`` an extra remote synthesis target is created in the Makefile so that
the actual resource intensive synthesis process is executed in a remote machine instead of in the local one.
In order to do that, when a remote synthesis is performed the local machine connects to the synthesis server through
a secure TCP/IP connection by using SSL. For this purpose, the following tools need to be installed:
+-----------+--------------------------------------------+
| Machine | Communication Software |
+===========+============================================+
| Client | ISE, ssh-server, rsync, screen (optional) |
+-----------+--------------------------------------------+
| Server | ssh-client, rsync, screen (optional) |
+-----------+--------------------------------------------+
.. note:: You'll need a local ISE deployment if you want to regenerate the synthesis Makefile or the ISE project (.xise),
files that are mandatory to perform both local and remote synthesis. But, if you have a valid Makefile and ISE project, you can
launch the remote synthesis from a local machine in which the ISE toolchain is not installed.
Before running the remote synthesis Makefile targets, there are different parameters that need to defined for proper operation.
These can be defined as shell environmental variables or, alternatively, inside the Makefile itself:
+--------------------------+--------------------+--------------------------------------------+
| Environmental Variable | Makefile Variable | Description |
+==========================+====================+============================================+
| HDLMAKE_RSYNTH_USER | USER | Remote synthesis user in the host machine |
+--------------------------+--------------------+--------------------------------------------+
| HDLMAKE_RSYNTH_SERVER | SERVER | IP/Address of the remote synthesis server |
+--------------------------+--------------------+--------------------------------------------+
| HDLMAKE_RSYNTH_ISE_PATH | ISE_PATH | Path of the ISE binaries in the server |
+--------------------------+--------------------+--------------------------------------------+
In addition, an optional ``HDLMAKE_RSYNTH_USE_SCREEN`` environmental variable can be set to 1 in order to use ``screen``
when the remote connection is stablished. If this variable is not defined or set to other value,
a standard shell connection is used (by using ``screen``, the remote synthesis feedback messages are smoothly printed).
As an example, in order to launch a remote synthesis by using the ``screen`` interface to connect with the user "javi",
available inside the 64 bit Linux machine placed at address 192.168.0.13 in the local network which features
a Xilinx ISE deployment in the default installation folder, we should issue:
.. code-block:: bash
export HDLMAKE_RSYNTH_USER=javi
export HDLMAKE_RSYNTH_SERVER=192.168.0.13
export HDLMAKE_RSYNTH_ISE_PATH=/opt/Xilinx/14.7/ISE_DS/ISE/bin/lin64/
export HDLMAKE_RSYNTH_USE_SCREEN=1
Once this parameters are defined, we can use any of the available remote synthesis Makefile targets,
that are enumerated in the following table:
+-------------------------+---------------------------------------------------------------------+
| Remote Makefile Target | Target Description |
+=========================+=====================================================================+
| remote | Transfer required files to the remote server and run the synthesis |
+-------------------------+---------------------------------------------------------------------+
| sync | Copy back the synthesis outcomes in the server to the local folder |
+-------------------------+---------------------------------------------------------------------+
| cleanremote | Delete the remote synthesis folder to free space in the server |
+-------------------------+---------------------------------------------------------------------+
Incremental synthesis in Xilinx ISE
-----------------------------------
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment