README.TXT ----------------------------------------------------- In-Target System Analyzer for Improv COOL-Jazz Copyright (C) 1998-2004 First Silicon Solutions, Inc. $Id: readme.txt,v 1.15 2004/07/29 20:41:56 ernie Exp $ ----------------------------------------------------- Changes in 1.8.0.1 ------------------ Removed limit of 240 registers. Changes in 1.8.0.0 ------------------ [2835] Set pqueue_ctl.edm prior to stepping in order to reset pqueue's qss bits. [2891] Added trst parameter to AbiResetJazz. This allows resetting the board (nSRST) without affecting nTRST. [2145] Added support for imem and irom modules. Any width memory up to 1024 bits is supported. The "size" variable or parameter must be set to the width in bytes of the memory being accessed. [2145] Corrected bug that erroneously reported "Named field jice_dstat. irom_dbdh not found in JazzConfig file." [3131] Corrected JTAG sequence to eliminate extra writes when writing to memory. ISA-Jazz now uses the parport2k driver rather than parllio. This affects third-party installation procedures. Changes in 1.7.3.1 ------------------ Adjusted acceptable voltage range in selftest to avoid false negatives. Changes in 1.7.2.1 ------------------ Added support for Jazz-16. The "size" variable in the Console or the "size" parameter to memory read/write functions must match the width of the memory interface (either 16-bit or 32-bit). Configuration parameters are now stored in the [jazz] section of fs2.ini instead of the [fs2] section. When installing as an update, the user should typically rename the [fs2] section to [jazz] to retain config settings. Changes in 1.7.1.1 ------------------ Changed response to reset assertions from target. Now the debugger will hold nSRST and issue a callback. In the Console this callback appears as an informational message. To clear nSRST, the "srst 0" command is used. Changed fg command to check for breakpoints in old processor just before switching processors. This guarantees that the old processor's information is current prior to the switch. Changes in 1.7.0.1 ------------------ Update for new Jazz hardware. Fixed bug in reset logic that was writing incorrect data to jice_dctl. Updated multithreading support. It should now be safe to call AbiBkptPoll() from a different thread. Changes in 1.6.2.1 ------------------ Change Abi functions that can change registers as side-effects to write back registers, do operation, then reread registers. The list: AbiPqueueFireTask, AbiPqueueSetQbus, AbiPqueueReadFifo, and AbiSetFgProcessor. Changes in 1.6.1.1 ------------------ Corrected problem with register save/restore. Not all registers were being reported correctly or restored if changed. Changes in 1.6.0.1 ------------------ Regsiter access through jstate now supported. The register list is read at runtime and constructed dynamically. The pc, ic, and pid registers are not accessible through jstate and are read-only. Changes in 1.5.9.1 ------------------ Updates for new CPU hardware. - Data breakpoints now distinct for each memory space. - Breakpoint scan logic has changed. - exdh bits moved from jice to pqueue. - Memory spaces are no longer hardcoded but instead are read in from the config file and made available to the user in the spacedef command (ABI function AbiGetAddrSpaceDef). Changes in 1.5.8.2 ------------------ - Corrected a problem in support for parallel ports that don't support EPP mode. These ports would lose communication sporadically. Changes in 1.5.8.1 ------------------ - Changed ABI semaphore handling so that the callbacks ABI_EVENT_EMU_STATE, ABI_EVENT_REG_CHANGE, and ABI_EVENT_MEM_CHANGE never occur while the semaphore is locked. This allows callback handlers for these events to call other ABI functions. Note that other callbacks--ABI_CONFIG_ITEM, ABI_CONFIG_CHANGED, and ABI_EVENT_PROGRESS may occur while the ABI semaphore is locked, so these handlers may not call ABI functions. Changes in 1.4.5.1 ------------------ - Initial release. User Notes ---------- - This release supports only parallel (EPP) communication between the host PC and the ISA-Jazz debugger probe. - The XE2 target does not implement software debug mode. Therefore, ISA-Jazz does not support software breakpoints. - TCK_RET is not available on the current XE2 target or ISA-Jazz. The TCK speed must be set manually using "config TckRate xxxx" where xxxx is the frequency in Hertz. - SYSHALTI and SYSHALTO are not present on the current XE2 target. Multi- platform run-control synchronization is not supported. - The XE2 target cannot be successfully reset from the JTAG debugger because the board keeps the CPU's in reset, preventing the debugger from communicating with them. To initialize the system: 1. Power on the XE2 system. 2. Start the XE2-6k diagnostics. 3. Bring board out of reset (5, 1, 99). 4. Change directory if necessary to where the xilinx and code images are. 5. Load driver: 3, 2, COOL_JAZZ 6. Program the XE2 FPGAs: 3, jazz_2021_xilinx_p1.exo, jazz_2021_xilinx_p2.exo 7. Now invoke the ISA-Jazz software. After a reset timeout, it initializes. 8. Load and run the application on the XE2, e.g. the dual processor loop test 6,3,enter,enter. 9. In ISA-Jazz, type "halt". Now everything is synchronized. - The gsce bit in the jQueue control register does not work. jQueue Q-points are processed whether or not gsce is on. The jqueue snoop enable and jqueue snoop disable commands cannot be used to globally enable/disable jQueue breakpoints. Disable individually using jqueue event disable.