======================================================================== ChipScope(tm) Pro 7.1i README ======================================================================== ------------------------------------------------------------------------ Table of Contents ------------------------------------------------------------------------ o Section 1: Resources for Product Information o Section 2: Release Notes o Section 3: Installation Instructions for Windows 2000 and XP o Section 4: Installation Instructions for Red Hat Enterprise Linux WS 3.0 o Section 5: Installation Instructions for Solaris 2.8/2.9 (32-bit) ------------------------------------------------------------------------ Section 1: Resources for Product Information ------------------------------------------------------------------------ o Software License Agreement The Xilinx time-based license agreement is located in the ChipScope Pro installation directory in a file called license.txt. o User Manual The ChipScope Pro User Manual is now included in the installation as a file called chipscope_pro_sw_cores_7_1i_ug029.pdf. ------------------------------------------------------------------------ Section 2: Release Notes ------------------------------------------------------------------------ ------------------------------------- 7.1.04i Service Pack #4 Release Notes ------------------------------------- o General: - Bug fix: Modified tool launchers so that the execution environment is compatible with the IBM Rational ClearCase tools. - Known issue: Linux versions of the core generator and core inserter tools (inserter.sh, generator.sh, gengui.sh) require the $XILINX environment variable to be set to the ISE 7.1i installation directory and that the ISE 7.1i tools be in path. - Known issue: When starting the Analyzer or Core Inserter tools, a warning message may appear: Warning: Cannot convert string "-monotype-arial- regular-r-normal--*-140-*-*-p-*-iso8859-1" to type FontStruct This warning message can be safely ignored as it does not affect the appearance or functionality of the tools. o Analyzer: - Enhancement: Added support for 3s1600e device. - Bug fix: The Analyzer project file browser now enforces the .cpj file extension. - Known issue: You can only print to the default system printer. Changing the printer in the Analyzer's "Page Setup" dialog has no effect. To change printers, close the Analyzer, change the default system printer, and restart the Analyzer. ------------------------------------- 7.1.03i Service Pack #3 Release Notes ------------------------------------- o General: - Bug fix: Fixed a bug where the storage qualification condition was inadvertent enabled for Virtex, Virtex-E, Spartan-II, and Spartan-IIE device families. The storage qualification feature is only available in Virtex-2 and Spartan-3 device families (and beyond). - Known issue: Linux versions of the core generator and core inserter tools (inserter.sh, generator.sh, gengui.sh) require the $XILINX environment variable to be set to the ISE 7.1i installation directory and that the ISE 7.1i tools be in path. - Known issue: When starting the Analyzer or Core Inserter tools, a warning message may appear: Warning: Cannot convert string "-monotype-arial- regular-r-normal--*-140-*-*-p-*-iso8859-1" to type FontStruct This warning message can be safely ignored as it does not affect the appearance or functionality of the tools. o Analyzer: - Enhancement: Added support for the XC3S4000 and XC3S5000 devices. - Bug fix: Fixed a problem where using a match unit with an enabled match counter in a storage qualification condition equation resulted in unexpected capture behavior. All match unit counters are now "disabled" when the match unit is used in the storage qualification condition. - Known issue: You can only print to the default system printer. Changing the printer in the Analyzer's "Page Setup" dialog has no effect. To change printers, close the Analyzer, change the default system printer, and restart the Analyzer. o Core Generator: - Bug fix: Fixed minor bugs in the ICON and ATC2 HDL example templates. ------------------------------------- 7.1.02i Service Pack #2 Release Notes ------------------------------------- o General: - Bug fix: Changed group+other permissions on UNIX launcher executable files to be read+execute. - Bug fix: Fixed minor bug in ILA core where match unit carry chain was improperly constructed for trigger ports that are 4 bits wide or less. - Bug fix: Fixed minor bug in ILA core where single-bit wide trigger and/or data port internal net names caused FPGA Editor tool to not properly recognize the port names in the ILA tool. - Known issue: Linux versions of the core generator and core inserter tools (inserter.sh, generator.sh, gengui.sh) require the $XILINX environment variable to be set to the ISE 7.1i installation directory and that the ISE 7.1i tools be in path. - Known issue: When starting the Analyzer or Core Inserter tools, a warning message may appear: Warning: Cannot convert string "-monotype-arial- regular-r-normal--*-140-*-*-p-*-iso8859-1" to type FontStruct This warning message can be safely ignored as it does not affect the appearance or functionality of the tools. o Analyzer: - Enhancement: This release includes a firmware update for the Xilinx Platform Cable USB download cable. Once you install this service pack, run the Analyzer tool, and connect to the Xilinx Platform Cable USB, the firmware update will automatically be applied to the download cable. - Enhancement: Added CoolRunner-IIA devices to list of recognized devices. - Bug fix: Fixed a problem where importing .cdc files didn't process bus indices correctly. - Known issue: You can only print to the default system printer. Changing the printer in the Analyzer's "Page Setup" dialog has no effect. To change printers, close the Analyzer, change the default system printer, and restart the Analyzer. o Core Inserter: - Bug fix: Previously, when using the Core Inserter from the ISE Project Navigator EDIF flow, the Core Inserter may have failed to find the EDIF netlist if it resides in a different directory from the ISE Project Navigator project files. This problem has been fixed in Xilinx ISE 7.1.02i (service pack #2). Please download and install this service pack. ------------------------------------- 7.1.01i Service Pack #1 Release Notes ------------------------------------- o General: - Enhancement: Made several enhancements to the Agilent ATC2 core. - Bug fix: Fixed the Windows installer so that includes necessary files that are not present on some systems running Windows 2000/XP. The symptom of this bug was that the installer did not recognize valid registration IDs. - Bug fix: Fixed the Windows installer so that the license.dat file is correctly copied to non-standard installation directories. The symptom of this bug was that the Analyzer would claim that the ChipScope Pro license was not valid or had expired. - Known issue: Linux versions of the core generator and core inserter tools (inserter.sh, generator.sh, gengui.sh) require the $XILINX environment variable to be set to the ISE 7.1i installation directory and that the ISE 7.1i tools be in path. - Known issue: When starting the Analyzer or Core Inserter tools, a warning message may appear: Warning: Cannot convert string "-monotype-arial- regular-r-normal--*-140-*-*-p-*-iso8859-1" to type FontStruct This warning message can be safely ignored as it does not affect the appearance or functionality of the tools. o Analyzer: - Enhancement: The Agilent E5904B TPA download cable is now supported in the ChipScope Pro 7.1.01i Analyzer tool on Windows 2000/XP operating systems. This cable will not be supported on Linux systems. - Enhancement: Linux support has been added for the Xilinx Platform Cable USB download cable in the ChipScope Pro 7.1.01i Analyzer tool. - Bug fix: Fixed a problem where client/server communication would hang. The symptom of this bug was the status bar at the bottom of the Analyzer window would constantly display the scanning status bar after you tried to open a connection to the cable. - Bug fix: Fixed a problem where the command queue between the client and server would not get cleared properly upon the closing of the cable. This caused subsequent open cable commands to fail until both the client and server were closed and reopened. - Bug fix: Fixed a problem where opening a cable would sometimes fail. - Bug fix: Fixed the right-click menus in the Listing viewer. - Bug fix: Fixed a problem where the contextual right-click menus in the chain navigation panel did not work properly. - Known issue: You can only print to the default system printer. Changing the printer in the Analyzer's "Page Setup" dialog has no effect. To change printers, close the Analyzer, change the default system printer, and restart the Analyzer. o Core Inserter: - Bug fix: Fixed the problem where if trigger port count in an existing project is changed to a larger number the "include trigger port as data" setting is not saved. - Bug fix: Fixed a problem where the ngcbuild tool would occasionally produce an "unresolved symbol: dlsym" error message when invoked by the Core Inserter. - Known issue: When using the Core Inserter from the ISE Project Navigator EDIF flow, the Core Inserter may fail to find the EDIF netlist if it resides in a different directory form the ISE Project Navigator project files. The work around for this problem is to copy the EDIF netlist to the same directory that contains the ISE Project Navigator files. --------------------- 7.1i CD Release Notes --------------------- o General: - Enhancement: Added two new features to the Agilent ATC2 core: auto setup and "always on" modes. Please refer to the ChipScope Pro Software and Cores User Guide for more information about these features. - Enhancement: Added support for Spartan-3E devices. - Known issue: Linux versions of the core generator and core inserter tools (inserter.sh, generator.sh, gengui.sh) require the $XILINX environment variable to be set to the ISE 7.1i installation directory and that the ISE 7.1i tools be in path. - Known issue: When starting the Analyzer or Core Inserter tools, a warning message may appear: Warning: Cannot convert string "-monotype-arial- regular-r-normal--*-140-*-*-p-*-iso8859-1" to type FontStruct This warning message can be safely ignored as it does not affect the appearance or functionality of the tools. o Analyzer: - Enhancement: Linux and Solaris support is now available for the Analyzer tool. For more information about the Linux and Solaris versions of the Analyzer tool, please refer to the ChipScope Pro Software and Cores User Guide for more details. - Enhancement: Client/Server support is now available for the Analyzer tool. Please refer to the ChipScope Pro Software and Cores User Guide for more details. - Known issue: You can only print to the default system printer. Changing the printer in the Analyzer's "Page Setup" dialog has no effect. To change printers, close the Analyzer, change the default system printer, and restart the Analyzer. - Known issue: The Agilent E5904B TPA download cable is not supported in the CD version of the ChipScope Pro 7.1i Analyzer tool. Windows 2000/XP support for the Agilent TPA cable will be added in the 7.1.01i version of the ChipScope Pro Analyzer. This cable will not be supported on Linux systems. - Known issue: Linux support for the Xilinx Platform Cable USB download cable is not available in the CD version of the ChipScope Pro 7.1i Analyzer tool. Linux support for the Platform Cable USB will be added in the 7.1.01i version of the ChipScope Pro Analyzer. o Core Inserter: - Enhancement: You can now insert cores into the entire design, regardless of how many individual netlists or levels of hierarchy there are in the design. Please refer to the ChipScope Pro Software and Cores User Guide for more details on this feature. - Known issue: If trigger port count in an existing project is changed to a larger number the "include trigger port as data" setting is not saved. The work around is to toggle the included trigger ports as data checkboxes prior to saving the project file. ------------------------------------------------------------------------ Section 3: Installation Instructions for Windows 2000 SP2 and XP ------------------------------------------------------------------------ ------------- Requirements: ------------- 1.) You must have "Windows 2000 SP2" or "Windows XP" installed on your system. 2.) If you plan to install download cable drivers on your system, you must have administrator access on the system. --------------------- Installing the files: --------------------- 1.) Run the ChipScope_Pro_7_1i_pc.exe installation program and follow the instructions in the installation wizard. You will need your 16-digit registration ID which can be obtained from the URL: http://www.xilinx.com/xlnx/xil_entry2.jsp?sMode=login&group=chipscope_pro Be sure to have your ChipScope Pro 7.1i product ID ready. ------------------------------------- Running the ChipScope Pro 7.1i Tools: ------------------------------------- 1.) To run the Core Generator tool, select the "ChipScope Pro Core Generator" option from the ChipScope Pro 7.1i folder in the Windows "Start > All Programs" menu. 2.) To run the Core Inserter tool, select the "ChipScope Pro Core Inserter" option from the ChipScope Pro 7.1i folder in the Windows "Start > All Programs" menu. 3.) To run the Analyzer tool, select the "ChipScope Pro Analyzer" option from the ChipScope Pro 7.1i folder in the Windows "Start > All Programs" menu. ------------------------------------------------------------------------ Section 4: Installation Instructions for Red Hat Enterprise Linux WS 3.0 ------------------------------------------------------------------------ ------------- Requirements: ------------- 1.) You must have "Red Hat Enterprise Linux WS 3.0" installed on your system. 2.) If you plan to install download cable drivers on your system, you must have root access on the system. 3.) The Xilinx ISE 7.1i implementation tools must be installed on the system to be able to run the Core Inserter or Core Generator tools. - The $XILINX environment variable must point to the Xilinx tool installation path - The $LD_LIBRARY_PATH environment variable include the path to the Xilinx shared libraries in the $XILINX/bin/lin directory - The $PATH environment variable must include $XILINX/bin/lin directory --------------------- Extracting the Files: --------------------- The Linux installation package is distributed in gzipped tar format. To extract the ChipScope Pro tools, follow these instructions: 1.) Make sure "gzip" and "tar" are in your $PATH environment variable 2.) Change directory to the directory that will hold the chipscope files 3.) Un-zip and un-tar the files: gzip -cd ChipScope_Pro_7_1i_lin.tar.gz | tar xvf - This will create a chipscope directory under the current working directory. ------------------------------------- Setting up the ChipScope Environment: ------------------------------------- 1.) Set the CHIPSCOPE environment variable to point to the "chipscope" installation. For the "csh" shell: setenv CHIPSCOPE /path_to_chipscope_parent/chipscope For the "sh" shell: set CHIPSCOPE=/path_to_chipscope_parent/chipscope export CHIPSCOPE ---------------------- Registering the tools: ---------------------- 1.) Obtain your 16-digit registration ID which can be obtained from the URL: http://www.xilinx.com/xlnx/xil_entry2.jsp?sMode=login&group=chipscope_pro Be sure to have your ChipScope Pro 7.1i product ID ready. 2.) Register your registration ID (for example, xxxx-xxxx-xxxx-xxxx) by running the following script on the command line: $CHIPSCOPE/bin/lin/cs_register.sh register xxxx-xxxx-xxxx-xxxx ------------------------------------------------------- Installing Xilinx Parallel Cable III/IV Device Drivers: ------------------------------------------------------- 1.) Make sure you have root privileges on the system. 2.) Change directory to the $CHIPSCOPE/bin/lin directory: cd $CHIPSCOPE/bin/lin 3.) Copy the appropriate windrvr6.o and xpc4drvr.o files to the /lib/modules/misc directory by running the update utility: source ./update_drv The update utility checks the number of CPUs and gcc kernel version to make sure that the correct files are copied. 4.) Run the wdreg script to load the windrvr6.o driver and create the required device file in the file system tree: source ./wdreg windrvr6 The device file created is /dev/windrvr6. 5.) Run the install_drv script to loads the xpc4drvr.o driver and creates the required device files in the file system tree. source ./install_drv The device files created are /dev/xpc4_0, /dev/xpc4_1, /dev/xpc4_2, /dev/xpc4_3. Note: Rebooting is not required after the installation of the drivers. 6.) The install scripts only load the drivers for the current Linux login session. When you restart the computer, the drivers will not be loaded automatically unless you add the following lines to the /etc/rc.local file: /lib/modules/misc/install_windrvr6 windrvr6 /lib/modules/misc/install_xpc4drvr Note: The executable files shown above are symbolic links of wdreg and install_drv files, respectively, that were created when you ran update_drv script in step 3.) above. For more information about Parallel Cable III/IV driver installation, please refer to Xilinx Answer Database Solution Record #18612 by opening the following URL in your web browser: http://support.xilinx.com/xlnx/xil_ans_display.jsp?getPagePath=18612 ---------------------------------------------------- Installing Xilinx Platform Cable USB Device Drivers: ---------------------------------------------------- 1.) Make sure you have root privileges on the system. 2.) Change directory to the $CHIPSCOPE/bin/lin/xilinx/bin/lin directory: cd $CHIPSCOPE/bin/lin/xilinx/bin/lin 3.) Run the setup script for the Xilinx Platform USB cable: source setup_pcusb The setup script creates a directory for the firmware file and copies the firmware file to this directory. It then copies the download script and adds the contents of xsubdfwu.usermap to the OS's /etc/hotplug/usb.usermap file. Rebooting is NOT required after running the script. 4.) Verify that the following files were copied and/or modified correctly: - The 'xusbdfwu' script was copied to the /etc/hotplug/usb directory. - The 'xusbdfwu.hex' file was copied to the /etc/hotplug/usb/xusbdfwu.fw directory. - The /etc/hotplug/usb.usermap file contains the 'xusbdfwu' entry. ------------------------------------- Running the ChipScope Pro 7.1i Tools: ------------------------------------- 1.) To run the Core Generator tool, run the script: $CHIPSCOPE/bin/lin/gengui.sh 2.) To run the Core Generator tool, run the script: $CHIPSCOPE/bin/lin/inserter.sh 3.) To run the Core Generator tool, run the script: $CHIPSCOPE/bin/lin/analyzer.sh ------------------------------------------------------------------------ Section 5: Installation Instructions for Solaris 2.8/2.9 (32-bit) ------------------------------------------------------------------------ ------------- Requirements: ------------- 1.) You must have the "Solaris 2.8" or "Solaris 2.9" installed on your system. 2.) The Xilinx ISE 7.1i implementation tools must be installed on the system to be able to run the Core Inserter tool: - The $XILINX environment variable must point to the Xilinx tool installation path - The $LD_LIBRARY_PATH environment variable include the path to the Xilinx shared libraries in the $XILINX/bin/sol directory - The $PATH environment variable must include $XILINX/bin/sol directory --------------------- Extracting the Files: --------------------- The Solaris installation package is distributed in gzipped tar format. To extract the ChipScope Pro tools, follow these instructions: 1.) Make sure "gzip" and "tar" are in your $PATH environment variable 2.) Change directory to the directory that will hold the chipscope files 3.) Un-zip and un-tar the files: gzip -cd ChipScope_Pro_7_1i_sol.tar.gz | tar xvf - This will create a chipscope directory under the current working directory. ------------------------------------- Setting up the ChipScope Environment: ------------------------------------- 1.) Set the CHIPSCOPE environment variable to point to the "chipscope" installation. For the "csh" shell: setenv CHIPSCOPE /path_to_chipscope_parent/chipscope For the "sh" shell: set CHIPSCOPE=/path_to_chipscope_parent/chipscope export CHIPSCOPE ---------------------- Registering the tools: ---------------------- 1.) Obtain your 16-digit registration ID which can be obtained from the URL: http://www.xilinx.com/xlnx/xil_entry2.jsp?sMode=login&group=chipscope_pro Be sure to have your ChipScope Pro 7.1i product ID ready. 2.) Register your registration ID (for example, xxxx-xxxx-xxxx-xxxx) by running the following script on the command line: $CHIPSCOPE/bin/sol/cs_register.sh register xxxx-xxxx-xxxx-xxxx ------------------------------------- Running the ChipScope Pro 7.1i Tools: ------------------------------------- 1.) To run the Core Generator tool, run the script: $CHIPSCOPE/bin/sol/gengui.sh 2.) To run the Core Generator tool, run the script: $CHIPSCOPE/bin/sol/inserter.sh 3.) To run the Core Generator tool, run the script: $CHIPSCOPE/bin/sol/analyzer.sh