======================================================================== ChipScope(tm) Pro 8.1.03i 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_8_1i_ug029.pdf. ------------------------------------------------------------------------ Section 2: Release Notes ------------------------------------------------------------------------ ---------------------------------- 8.1.03i Service Pack Release Notes ---------------------------------- o General: - Enhancement: Set the default device type to Virtex-4 in the core generator and core inserter tools. - Bug fix: Fixed several bugs in the ATC2 core IO standards table: - Removed LVDSEXT_25, LVDS_25_DCI, and LVDSEXT_25_DCI - Removed DIFF_HSTL and DIFF_SSTL - Fixed bugs in several LVTTL entries - Added Virtex-4 and Spartan-3E IO standards o Core Generator: - Enhancement: Set the default device type to Virtex-4 for all cores. - Enhancement: Made the wizard panel title bars more consistent across all cores. o Core Inserter: - Enhancement: Set the default device type to Virtex-4 for all cores. o Analyzer: - Enhancement: Made the file chooser components more consistent across the application. - Enhancement: Added version number to client log file. - Bug fix: Fixed an overflow problem in the configuration progress status meter. - Bug fix: Fixed a Java exception in the waveform viewer that occurs in specific zoom operation sequences. - Bug fix: Fixed waveform printing on Solaris and Linux systems. - Bug fix: Fixed IBA waveform printing problem. - Bug fix: Fixed font size in signed decimal bus radix dialog so it can be seen properly on Linux systems. - Bug fix: Fixed Java exception when using trigger sequencer under certain conditions. ---------------------------------- 8.1.02i Service Pack Release Notes ---------------------------------- o General: - Bug fix: Changed references to the ChipScope Pro web site to http://www.xilinx.com/chipscopepro - 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 8.1i installation directory and that the ISE 8.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 Core Inserter: - Bug fix: Removed the "Clock Edge" option from the ATC2 core setup panel in the Core Inserter tool. o Core Generator: - Enhancement: On the ILA core trigger panel, set the 'Enable Trigger Sequencer" to disabled by default. Also, set the default number of trigger sequencer levels to 16 by default. - Bug fix: Removed the "Clock Edge" option from the ATC2 core setup panel in the Core Generator tool. o Analyzer: - Enhancement: Renamed the VIO console from "Console" to "VIO Console". - Enhancement: Added "JTAG Scan Rate" options to VIO menu and toolbar. - Bug fix: Fixed a bug where invoking cs_server.bat from a different directory caused an error. - Bug fix: Fixed a bug where white space characters in the 'Host' text field on the 'Server Settings' dialog caused an error. - Bug fix: Fixed a problem where reading certain .CDC files caused a null pointer exception. - 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. ---------------------------------- 8.1.01i Service Pack Release Notes ---------------------------------- o General: - 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 8.1i installation directory and that the ISE 8.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 Core Inserter: - Bug fix: Fixed a problem when whitespaces are used in the pathnames to ISE Project Navigator projects. o Core Generator: - Bug fix: Fixed ILA and IBA trigger port panel size to display correctly on some UNIX operating systems. o Analyzer: - Bug fix: Fixed a problem when importing .CDC files that have extra whitespace in the port names. - 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. --------------------- 8.1i CD Release Notes --------------------- o General: - Enhancement: Added a license manager tool to make entering, viewing, and upgrading your ChipScope licenses easier. - Bug fix: Fixed problem in program launchers that caused a problem when trying to run the ChipScope Pro tools with the IBM Rational ClearCase tools. - Bug fix: Changed file permissions for certain files on UNIX systems to allow non-root users to run 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 8.1i installation directory and that the ISE 8.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 Core Generator: - Enhancement: Added core LUT, flip-flop, and block RAM resource utilization estimators for the ICON, ILA and VIO cores. - Discontinued: Support for the ILA/ATC core has been discontinued in this release. - Bug fix: The ILA storage qualification feature was inadvertently enabled in pre-Virtex-II devices and is now properly supported only in device family architectures of Virtex-II, Spartan-3, and beyond. - Bug fix: Fixed a problem where generating an ATC2 core caused a Java Run-Time Environment error. o Core Inserter: - Enhancement: Added core LUT, flip-flop, and block RAM resource utilization estimators for the ICON and ILA. - Discontinued: Support for the ILA/ATC core has been discontinued in this release. - Bug fix: The ILA storage qualification feature was inadvertently enabled in pre-Virtex-II devices and is now properly supported only in device family architectures of Virtex-II, Spartan-3, and beyond. - Bug fix: Fixed a problem where generating an ATC2 core caused a Java Run-Time Environment error. o Analyzer: - Enhancement: Improved the layout of the VIO console by moving global options to the toolbar and eliminating unused space in the VIO console table. - Discontinued: Support for the Agilent E5904B FPGA trace port analyzer cable and the corresponding ILA/ATC core have both been discontinued in this release. - Discontinued: Support for the legacy MultiLINX download cable has been discontinued in this release. - Bug fix: Fixed a bug where the Platform Cable USB command buffer was not being flushed properly in between command sequences. - Bug fix: Fixed a problem where clearing the VIO console activity detectors was not working properly. - Bug fix: Fixed a problem with odd-width Extended, Extended w/Edges, Range and Range w/Edges match units where they would incorrectly detect events. - Bug fix: Fixed bug in trigger setup where tooltips were not being displayed for all bits in the value field. - 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. ------------------------------------------------------------------------ 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_8_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 8.1i product ID ready. ------------------------------------- Running the ChipScope Pro 8.1i Tools: ------------------------------------- 1.) To run the Core Generator tool, select the "ChipScope Pro Core Generator" option from the ChipScope Pro 8.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 8.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 8.1i folder in the Windows "Start > All Programs" menu. 4.) To run the License Manager tool, select the "ChipScope Pro License Manager" option from the ChipScope Pro 8.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 8.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_8_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 8.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/xilinx/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/xilinx/bin/lin directory: cd $CHIPSCOPE/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 8.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 4.) To run the License Manager tool, run the script: $CHIPSCOPE/bin/lin/cs_register.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 8.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_8_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 8.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 8.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 4.) To run the License Manager tool, run the script: $CHIPSCOPE/bin/sol/cs_register.sh