README.TXT MetaLink(r) COP8(r) Emulator & Debug Module Host Software Debugger for Microsoft(r) Windows(r) Host Software Version: 4.5 Rev 10 / 3.207 CONTENTS: 1. INSTALLATION / UNINSTALLATION 2. GENERAL OVERVIEW 3. LIMITATIONS / PROBLEMS 4. USAGE TIPS 5. ONLINE USER'S MANUALS 6. EXAMPLE PROGRAMS 7. IAR C-SPY NOTE 8. SOFTWARE REVISION HISTORY ====================================================================== 1. INSTALLATION / UNINSTALLATION ====================================================================== 1.1. Installation: All files installed by the InstallShield(r) Setup program are put in the directory you select during setup (either the default directory or one of your choosing). No files (e.g., DLL's) are put in (added to) the Windows or Windows SYSTEM directory. No files in the Windows or Windows SYSTEM directory are overtly modified/replaced. The only exceptions to this are the Folder/Group/Program Items and Shortcuts created/modified by InstallShield. For the COP8 emulators and Debug Module, the following Program Items / Shortcuts are installed: a. Program COP8 iceMASTER Software b. Help COP8 iceMASTER Software Help c. README COP8 iceMASTER Software README d. Manual #1 COP8 iceMASTER-AD Emulator Manual e. Manual #2 COP8 iceMASTER-DM Debug Module Manual f. Manual #3 COP8 Programming Adapter Manual g. Manual #4 COP8 iceMASTER-WA COP8-EM/DM/IM-Flash Emulator Manual h. UnInstall COP8 iceMASTER Software UnInstall These are removed by the UnInstall program (which is installed during Setup). 1.2. UnInstallation: Only the files that were installed by the InstallShield Setup program (into the directory that you chose) will be deleted by the UnInstall program. Any files created after the installation (e.g., $HSTPRJ) will not be deleted. ====================================================================== 2. GENERAL OVERVIEW ====================================================================== 2.1. You can have any number of windows of any type, including multiple windows of the same type, open at the same time. All windows are updated after an emulation cycle or after something changes (e.g., after you explicitly change the value in a register or memory location during Break Condition). 2.2. To cycle through the existing windows: CTRL+F6: cycle forward CTRL+SHIFT_F6: cycle backward This is the Microsoft Windows convention for cycling through MDI (Multi-Document Interface) child windows. The host software implementation "model" most closely resembles an MDI application, with the following enhancements: a. The "child" windows (all host software windows except the Main Menu window) are not constrained to be within ("be clipped by") the Main Menu window. They can be anywhere on the screen. (For comparison, open several documents in a word processor and move the document windows around.) b. You can have as many "child" windows as you want, of a given type, open at the same time (e.g., 5 Code Memory windows, each viewing the same/different/overlapping memory addresses). c. If you turn off the 'Configure|Preferences|Move Windows with Main' option, the Main Menu window can be moved independently of any "child" windows. Currently, resizing the Main Menu window is always done independently of any "child" windows. Additionally, the Main Menu window will never be "on top of" any of the "child" windows. You can also pick a specific existing window by selecting it from the bottom of the "Windows" pull-down menu. 2.3. In general, double-click (left mouse button) on a symbol name, register name or memory-location to pop-up the "Display/Alter|Expression" dialog box, which will allow you to view/change/browse the value. In general, right-clicking on a line will pop-up a floating menu containing commands for everything you can do to the selected line/string. 2.4. Currently, the "Save Settings on Exit" function saves the preferences, the name of the previously loaded program file and the position, size and other information for each window. These settings can optionally be restored (re-established) whenever you restart the software based on the "Restore Settings at Startup" and "Reload Code File at Startup" settings. A detailed list of exactly what settings are saved is displayed in the on-line help for the "Save Settings on Exit" command. 2.5. "Host Break": There are several ways to stop emulation if no breakpoint is set or reached during emulation: a. Click on the 'Stop' toolbar button. b. Select the 'Stop(Esc)' command in the 'Emulating' window, if it is present. c. Select the 'Run|Stop' command from the Main Menu window. d. Press the 'Esc' key. ====================================================================== 3. LIMITATIONS / PROBLEMS ====================================================================== 3.1. (This step may or may not be necessary.) If communication with the emulator or Debug Module cannot be established initially, try doing the following. This step should not be necessary in subsequent versions of the software: After installation, make the following Windows change: Disable the FIFO for the COMn port that you will be using: a. Windows 95: My Computer Control Panel System Device Manager (System Properties) Ports (COM & LPT) Communications Port (COMn) n=1,2,3,4 Port Settings (Comm. Port (COMn) Properties) Advanced Either: 1. Uncheck the "Use FIFO Buffers" selection, or 2. Set Receive and Transmit buffers to "Low (1)". b. Windows 3.11: In the SYSTEM.INI file, in the [386Enh] section, add: COM1FIFO=0 if your are using COM1 for the emulator. Add COM2FIFO=0 if your are using COM2 for the emulator, etc. 3.2. "Changed-Value Highlighting" is implemented in the following window types: Core Registers Memory Registers (SFRs) SFR Bits Watch In the future, we will be adding "Changed-Value Highlighting" to the following window types: Symbols Browse 3.3. Currently, there is no 'Stack' window which automatically updates its position to reflect the current value in the Stack Pointer register. However, you can open a Memory window and "manually" position it to the internal data memory on the chip to view the stack at all times. 3.4. Currently, colors (highlighting) and tabstops are fixed from the user-interface viewpoint. Internally, they are based on values/tables which can be changed. These features will be made user-controllable in the near future. Note: The background color of all windows is currently fixed at "white". 3.5. (Temporary Workaround): If you ever see the message: "Initialization not complete. System may not function properly." you should exit the host software completely and restart it. ====================================================================== 4. USAGE TIPS ====================================================================== 4.1. When you first start the host software, it will display a dialog box allowing you to specify your hardware base type (emulator or Debug Module) and probe card (emulation processor) type. If you have more than one hardware base type and/or more than one probe card and later want to switch emulator and/or probe card types, you can select the 'Configure|Select Chip...' command and follow the directions there. ====================================================================== 5. ONLINE USER'S MANUALS ====================================================================== 5.1. In addition to the Windows Online Help within the host software, the InstallShield Setup program also installs four '.PDF' (Portable Document Format) User's Manual into the directory you chose for installation during Setup: a. IM80_AD.PDF: iceMASTER-AD Emulator User's Manual b. IM80_DM.PDF: iceMASTER-DM Debug Module User's Manual c. IM80_PGM.PDF: Programming Adapter Manual d. IM80_WA.PDF: iceMASTER-WA COP8-EM/DM/IM-Flash Emulator User's Manual You can view and/or print these manuals using the Adobe(r) Acrobat(r) Reader 3.0. If you do not already have the Adobe Acrobat Reader 3.0, you can download a free copy from: http://www.adobe.com/prodindex/acrobat/readstep.html ====================================================================== 6. EXAMPLE PROGRAMS ====================================================================== 6.1. We have included some example programs which can be loaded into the emulator or Debug Module system. The programs are based on a simple scheme of outputting a pulse train on PORTD, Pin 0. These programs are located in the 'Examples' subdirectory of the directory that you chose for installation -- the default is: \MetaLink\WHP2380\Examples (for 16-bit software) \Program Files\MetaLink\XHP2380\Examples (for 36-bit software) A detailed description of each file in this subdirectory follows: C8A1.COF: Assembly Language Demo Program (National COP8 Assembler/Linker) C8A1.COF Linker-generated absolute, loadable COFF file (with debug information) C8A1MAKE.BAT Batch file to create loadable C8A1.COF file from scratch C8A1MAKE.LNK Linker control file for creating C8A1.COF C8A1INC.INC COP8 demo program, Include File (COP8 assembly source) C8A1MAIN.ASM COP8 demo program, Module #1 (COP8 assembly source) C8A1SPIN.ASM COP8 demo program, Module #2 (COP8 assembly source) BC84.COD: Byte Craft COP8 C Demo Program BC84.COD Loadable, absolute object module format, (with debug information) BC84.HEX Loadable HEX file for BC84 BC84.H C #include file BC84INNR.C Function 'InnerLoop()' (C source) BC84MAIN.C Main program (function 'main()'; C source) BC84MAKE.BAT Batch file to generate BC84.COD from scratch BC84MAKE.LNK Linker control file (used by BC84MAKE.BAT) BC84WAST.C Function 'WasteTime()' (C source) TD.DBG: IAR COP8 C Demo Program TD.DBG Loadable, UBROF format, (with debug information) TD.BAT Batch file to generate TD.DBG from scratch TD.H C #include file TDF.C Function (C source) TDF.LST Generated code produced by compiler (for TDF.C) TDM.C Main program (function 'main()'; C source) TDM.LST Generated code produced by compiler (for TDM.C) TD.XCL Linker control file (used by TD.BAT) TD.LST Load map produced by linker ====================================================================== 7. IAR C-SPY NOTE ====================================================================== 7.1. IAR C-SPY release 1.3 (and earlier) is not compatible with version 4.4 Rev 23 / 3.194 (and newer) of the MetaLink software. Contact National Semiconductor support about upgrading to a compatible version of C-SPY. ====================================================================== 8. SOFTWARE REVISION HISTORY ====================================================================== The following is a list of changes, improvements and bug-fixes implemented in the host software debugger over time. Each entry shows the date the change was made and the software version number and revision level in which the change appears. Unless otherwise noted, any bug described here was fixed on the date and in the version/revision indicated. In some cases, you may note that version or revision levels appear to have been "skipped" (they do not appear in the list at all). In such cases, a change was made to the host software debugger which was specific to some product other than a COP8 product. The change was tracked (via a version/revision level change), but does not appear in the list below because it does not apply to the COP8 products. ---------------------------------------------------------------------- 05/07/99 4.3 Rev 2 Multi-Frequency support added for the DM5. ---------------------------------------------------------------------- 05/11/99 4.3 Rev 2 Fixed Programmer Dialog Box so that ECON value is handled properly (reflects value from load file, and not overwritten automatically). ---------------------------------------------------------------------- 05/12/99 4.3 Rev 2 Fixed a GPF in the Source Window when disassembling code memory in an area (large area) with no code labels or line numbers and when all the memory locations in that area contained the same byte value (e.g., 0x00). ---------------------------------------------------------------------- 05/14/99 4.3 Rev 2 (UBROF) Empty bit field member names were not handled properly. Bit fields can now have unnamed members. ---------------------------------------------------------------------- 05/21/99 4.3 Rev 4 Programmable device list now up to date. ---------------------------------------------------------------------- 06/01/99 4.3 Rev 4 (UBROF) Support for IAR UBROF format (version 7) for the COP8 now finished. ---------------------------------------------------------------------- 06/08/99 4.3 Rev 5 The COP8 Demo/Simulator now supports the COP8SGR Debug Module (DM5), by default. ---------------------------------------------------------------------- 06/10/99 4.3 Rev 5 Model files now available for FGE/FGG/FGH/FGK (for Debug Module), SER (for Debug Module and Model 400), and SGE/SGG/SGH/SGK (for Debug Module and Model 400). ---------------------------------------------------------------------- 06/04/99 HSW: 4.3 Rev 6 Updated write to file dialog box from source and memory windows to handle project directories better. There had been a problem when just a name was typed into the edit control. ---------------------------------------------------------------------- 06/23/99 HSW: 4.3 Rev 8 Fixed the situation where the "Cannot get dialog control handle." message was displayed when the "Select Chip" command was selected. ---------------------------------------------------------------------- 06/28/99 MF: 3.154 New $CL2 file received from Hardware Engineering. ---------------------------------------------------------------------- 07/02/99 HSW: 4.3 Rev 8 Previous Behavior: If the Main window was maximized when you exitted the software, and the settings were saved on exit and restored upon reentry, the software would display (except as noted below) the Main window at its maximized size, but Windows would not "recognize" this Main Window as being "maximized". The result was that you could not restore the Main window to its restored state (size/position), nor could you move or resize it. However, the behavior was not quite the same on all systems. Win16 (16-bit) Host Software: Windows 95: Worked (incorrectly) as described above. Windows 98: Worked (incorrectly) as described above. Windows NT: Worked (incorrectly) as described above. Win32 (32-bit) Host Software: Windows 95: Worked (incorrectly) as described above. Windows 98: Worked (incorrectly) as described above. Windows NT: Main Window "disappeared". Current Behavior: Now, additional information is saved in the $SETTING file on exit, so that a maximized Main Window will be restored to it maximized state, and the 'Restore' button in that window will allow the user to restore it to its restored state (size/position). However, the behavior is not quite the same on all systems. Win16 (16-bit) Host Software: Windows 95: Everything works fine (as described above). Windows 98: Everything works fine (as described above). Windows NT: Everything works fine (as described above). Win32 (32-bit) Host Software: Windows 95: Everything works fine (as described above). Windows 98: Everything works fine (as described above). Windows NT: Main Window still "disappears". There is still a bug on NT; we are looking into it. Workaround for NT (for now): In such a case, exit the software and delete the $SETTING file. Never exit the software with the Main Window "maximized" (from the Windows view point). You CAN make the Main Window go to its maximum size by manually resizing it; this should restore properly (that needs a quick test). ---------------------------------------------------------------------- 07/10/99 HSW: 4.3 Rev 9 Fixed a problem and enhanced the function of the FIND dialog box in the Symbols/program Structure windows. The fix was that previously, when a symbol was found the window would position properly but the found symbol would not always be high-lighted as the new selected symbol. The enhancement was to the buttons. The FIND FIRST button will now become the default button if any text is entered by the user into the edit control and the FIND NEXT button will now become the default button when there is a priming string in the edit control (when the FIND dialog box is opened). ----------------------------------------------------------------------------- 08/02/99 HSW:4.3 Rev 10 MF: 3.155 Previous Behavior: If the Main window was maximized when you exitted the software, and the settings were saved on exit and restored upon reentry, the software would display (except as noted below) the Main window at its maximized size, but Windows would not "recognize" this Main Window as being "maximized". The result was that you could not restore the Main window to its restored state (size/position), nor could you move or resize it. However, the behavior was not quite the same on all systems. Win16 (16-bit) Host Software: Windows 95: Worked (incorrectly) as described above. Windows 98: Worked (incorrectly) as described above. Windows NT: Worked (incorrectly) as described above. Win32 (32-bit) Host Software: Windows 95: Worked (incorrectly) as described above. Windows 98: Worked (incorrectly) as described above. Windows NT: Main Window "disappeared". Current Behavior: Now, additional information is saved in the $SETTING file on exit, so that a maximized Main Window will be restored to it maximized state, and the 'Restore' button in that window will allow the user to restore it to its restored state (size/position). ----------------------------------------------------------------------------- 08/03/99 HSW:4.3 Rev 10 MF: 3.155 The $CL3 file used by the SEC Debug Modules has been updated. ----------------------------------------------------------------------------- 08/09/99 HSW:4.3 Rev 10 MF: 3.155 Register variables are now local, not global. There had been some load warnings about symbol redefinitions for some of these variables. ----------------------------------------------------------------------------- 08/27/99 HSW:4.3 Rev 10 MF: 3.155 Fixed the problem when loading a break file and break names were sometimes mistakenly added for breaks that had no names. ----------------------------------------------------------------------------- 09/27/99 HSW:4.3 Rev 12 MF: 3.157 Added the GOTOF and WESTLF commands in the Command Window (for better processing efficiency). ----------------------------------------------------------------------------- 09/28/99 HSW:4.3 Rev 12 MF: 3.157 Fixed a GPF in View Trace. ----------------------------------------------------------------------------- 10/05/99 HSW:4.3 Rev 12 BETA #2 MF: 3.157 There were instances where the host software would: a) Repeatedly access the file system, 'stat'ing a file. b) "Hog" the system in such a way that other applications became very sluggish and non-responsive. ----------------------------------------------------------------------------- 10/06/99 HSW:4.3 Rev 13 MF: 3.157 There was a window-refresh problem when scrolling a Source Window horizontally. The problem is now fixed. Workaround for "old" software: If "garbage" appears in a Source Window after scrolling horizontally, resize the window slightly. ----------------------------------------------------------------------------- 10/27/99 HSW:4.3 Rev 15 MF: 3.159 Dialog windows (either debugger "custom" dialogs or MS Windows "Common Dialogs") can no longer be hidden by a debugger window or by another dialog. Previously, before this fix, if the dialog was completely hidden by another window (e.g., making the Source Window the current window while the 'File|Load' Common Dialog was present), the system would become "unresponsive" (i.e., you couldn't select Main Menu commands) and it wasn't obvious why this was happening, because the Dialog window was not visible. ----------------------------------------------------------------------------- 11/10/99 HSW:4.3 Rev 17 MF: 3.160 In 32 bit software, file open dialog box is now the explorer style. ----------------------------------------------------------------------------- 11/17/99 HSW:4.3 Rev 17 MF: 3.160 The trace status field in the Status Window is now updated properly. ----------------------------------------------------------------------------- 11/23/99 HSW:4.3 Rev 17 MF: 3.160 (COP8 Simulator) Fixed simulation of RET instruction. Previous simulation was sensitive to value in S register and should not have been. ----------------------------------------------------------------------------- 11/23/99 HSW:4.3 Rev 17 MF: 3.160 Changed references to "PROM Programmer" to "Device Programmer" and changed references to "EPROM" to "Memory". ----------------------------------------------------------------------------- 11/24/99 HSW:4.3 Rev 18 MF: 3.161 Default output format of "Write To File" dialog is now Intel Hex format. Memory range in "Write To File" dialog is now all of memory. ----------------------------------------------------------------------------- 11/30/99 HSW:4.3 Rev 18 MF: 3.161 Disabled display of PC, real-time clock and reset count in pop-up Emulation Window and disabled display of real-time clock and reset count in Status Window. These have never been valid but were mistakenly enabled. ----------------------------------------------------------------------------- 12/09/99 HSW:4.3 Rev 19 MF: 3.162 (ALL 32 Bit SW) Fixed another quirk in the keeping dialog boxes on top issue. It turns out that our fix on 11/10/99 to get the explorer style File Open dialog box for 32 bit software causes a weird problem with the Choose Font dialog box. The window calling the Choose Font dialog would become the on-top window for the rest of the emulator session. It now works properly for both the File Open and Choose Font dialog boxes. ----------------------------------------------------------------------------- 12/10/99 HSW:4.3 Rev 19 MF: 3.163 Added model file for COP8CBR for Debug Module. ----------------------------------------------------------------------------- 12/13/99 HSW:4.3 Rev 20 MF: 3.164 When you respond 'OK' to select a new font ('Options|Font...') in any window, you are now asked whether or not you want apply that font change to just the current window or to all host software windows. ----------------------------------------------------------------------------- 12/13/99 HSW:4.3 Rev 20 MF: 3.164 The software now pops up the standard 'Configure|Emulator|OK' dialog box after the initial attempt at establishing communication is successful (i.e., when the $CONFIGW file is NOT present initially and you can only choose the COMn port and baud rate settings). This is so that we force the user to see any other options/settings which might need to be adjusted to get the emulation environment "correct" (e.g., operating mode, clock frequency, etc.) once the software has communicated with the emulator and determined exactly what features and properties it has. ----------------------------------------------------------------------------- 12/28/99 HSW:4.3 Rev 21 MF: 3.164 Added 44 QFP version of SAC to programmable device lists for the Debug Module and EPU. ----------------------------------------------------------------------------- 12/29/99 HSW:4.3 Rev 21 MF: 3.164 Previous versions of the software had been inconsistent in when and where the constraints on breakpoints had been enforced. The constraints are now enforced properly everywhere. Note also that previous versions of the software would not allow overlapping break ranges but they are legal now. ----------------------------------------------------------------------------- 12/29/99 HSW:4.3 Rev 21 MF: 3.164 When a break file is loaded, if a variable/label has an address that is different from the address previously saved in the file, we will use the new value silently, without any error messages. ----------------------------------------------------------------------------- 01/13/00 HSW:4.3 Rev 22 MF: 3.166 Fixed the problem that caused a GPF crash when a file was loaded from the programmer menu in the COP8 EPU. ----------------------------------------------------------------------------- 01/26/00 HSW:4.3 Rev 22 MF: 3.166 The $P7 file has been updated. ----------------------------------------------------------------------------- 01/27/00 HSW:4.3 Rev 22 MF: 3.166 The $CL5 file has been updated. ----------------------------------------------------------------------------- 02/17/00 HSW:4.3 Rev 23 MF: 3.170 Support finished for the Beta Release of the new iceMASTER-WA COP8-EM/DM/IM-Flash emulator. The $CL5 file is downloaded into older iceMASTER-WA emulators; the $CL5A file is downloaded into newer emulators. ----------------------------------------------------------------------------- 04/03/00 HSW:4.4 MF: 3.172 (COP8 iceMASTER-WA) Changed all command name references etc. from "FlashCB" to "Flash". Added new commands in the Command Window to configure and control the COP8-EM/DM/IM-Flash emulator. Updated online Help topics for the iceMASTER-WA COP8-EM/DM/IM-Flash emulator. ----------------------------------------------------------------------------- 04/06/00 HSW:4.4 MF: 3.172 (COP8 iceMASTER-WA) If you ran the software using a Model 400 or Model 500 unit (with a Trace) and had a Trace Window open and "Saved Settings on Exit" and then brought the same software up using a Model 100 (no Trace), the software would GPF (crash). ----------------------------------------------------------------------------- 04/06/00 HSW:4.4 MF: 3.172 (COP8 iceMASTER-WA) When you press the Stop button to halt emulation and the COP8 processor is "inactive" (e.g., HALT or IDLE mode), the following message is no longer issued: "Emulation Processor Inactive. Do you want to RESET to break emulation?" because, in fact, emulation can be stopped "cleanly" and the COP8 part will not be RESET. ----------------------------------------------------------------------------- 04/07/00 HSW:4.4 MF: 3.172 (COP8 iceMASTER-WA) Four of the ISP registers were often being overwritten. These registers were ISPADLO, ISPADHI, ISPRD and ISPWR. ----------------------------------------------------------------------------- 04/21/00 HSW:4.4 Rev 1 MF: 3.173 (COP8 iceMASTER-WA) Added support for the COP8SBR/SCR/SDR9 chips. These are the same as the COP8CBR/CCR/CDR9, but without A/D hardware/registers. ----------------------------------------------------------------------------- 05/01/00 HSW:4.4 Rev 1 MF: 3.173 (COP8 iceMASTER-WA, IAR COP8 C) Local variables in functions were not displayed properly, to indicate whether the function was active ("alive") or not. Only the most-recently called function (the function at the top of the stack) was shown as active. All other functions below that on the stack were shown as not being active. ----------------------------------------------------------------------------- 05/02/00 HSW:4.4 Rev 1 MF: 3.173 (COP8 iceMASTER-WA) Modified the RS-232 communication routines to use flow control for transmission to the emulator. ----------------------------------------------------------------------------- 05/03/00 HSW:4.4 Rev 1 MF: 3.173 (COP8) Changed the hot key for the 'Window|Registers (SFRs)' command from 'R' to 'g' because 'R' is already used for the 'Window|RAM Memory' command. ----------------------------------------------------------------------------- 05/03/00 HSW:4.4 Rev 1 MF: 3.173 (COP8 iceMASTER-WA / ALL): Windows' Power Management Features may cause communication failures with any MetaLink emulator product (either during Emulation Condition or during Break Condition). The recommended solution is to turn off all Power Management features controlled by Windows. Note that different versions of Windows (e.g., Windows 95 vs. 98) have different power management features that are available, and some computers don't even have the 'My Computer|Control Panel|Power Management' icon. ----------------------------------------------------------------------------- 05/09/00 HSW:4.4 Rev 2 MF: 3.173 (32-bit Host Software) In a Trace Window, when: 1. Searching for a specific trace frame, or, 2. Writing a certain range of trace frames to a file the software did not work properly when the trace frame number was a negative number. ----------------------------------------------------------------------------- 05/09/00 HSW:4.4 Rev 2 MF: 3.173 (32-bit Host Software) In displaying signed integral scalar values, the software displayed negative numbers incorrectly. For example, a signed integer value of '-5' was being displayed by the software as an unsigned integer value ('65531'). This occurred in a Watch window or in any of the Symbols windows. ----------------------------------------------------------------------------- 05/09/00 HSW:4.4 Rev 2 MF: 3.173 (COP8 iceMASTER-WA) For the COP8 iceMASTER-WA (COP8 EM-/DM-/IM-Flash), the diagnostic message: "The probe (pod, emulation device) is not operating properly." has been augmented to include a "Reason" field, as follows: "The probe (pod, emulation device) is not operating properly. (Reason: )" where is one of the following: Meaning/Cause ---------------------------- -------------------------------- "(invalid/undefined code)" (should never happen) "FPGA Loading Error" Fatal Emulator Hardware Error. If this error occurs with the Null Target, the emulator needs to be repaired. "Hooks Mode Entry Failure" The COP8 chip is not responding properly. Please check the COP8 clock, power and emulator cable connection/orientation. "Break Transition Error" "Command Execution Error" "Monitor Rev. Error" "End-of-Command Error" Emulator - COP8 Communications Error. Please check that the COP8 clock and power are within specification. ----------------------------------------------------------------------------- 05/24/00 HSW:4.4 Rev 3 MF: 3.174 (IAR UBROF Loader) Fixed the problem with the IAR loader that caused a GPF. The GPF would occur when some enumerated type information was loaded. ----------------------------------------------------------------------------- 06/01/00 HSW:4.4 Rev 3 MF: 3.176 (COP8) Added model files for Lonepeak (COP8AJC, COP8AKC) ----------------------------------------------------------------------------- 06/01/00 HSW:4.4 Rev 3 MF: 3.176 (COP8) $P21, $CL5B and $CL5C files have been updated. ----------------------------------------------------------------------------- 06/02/00 HSW:4.4 Rev 4 MF: 3.176 (COP8 DM5) For those devices with a programmable clock there were startup paths which could lead to the programmable clock being set with an illegal value. In the case of the DM5, the FW had started the programmable clock on it's own for HW startup reasons, which is why the DM5 appeared to operate properly, however, the actual frequency of the device might not be what the user specified. ----------------------------------------------------------------------------- 06/12/00 HSW:4.4 Rev 4 MF: 3.176 (COP8) $CL5B and $CL5C files have been updated. ----------------------------------------------------------------------------- 06/12/00 HSW:4.4 Rev 4 MF: 3.176 (COP8 IM-WA) In the IM-WA emulator, the stack pointer is now initialized on startup and after the Reset Processor command, to accomodate the 2 byte breakpoint stack frame. ----------------------------------------------------------------------------- 06/13/00 HSW:4.4 Rev 4 MF: 3.176 (COP8 IM-WA) In the IM-WA emulator, in the 'File|Load' command when you respond 'No' to the "Merge into current application environment?" prompt, flash memory is now mass erased and the OPTION register is restored to its previous value before the file is loaded into flash memory. ----------------------------------------------------------------------------- 06/15/00 HSW:4.4 Rev 5 MF: 3.177 (COP8 IM-WA) In the IM-WA emulator, when you select the 'File|Unload' command, flash memory is now mass erased and the OPTION register is restored to its previous value. ----------------------------------------------------------------------------- 06/15/00 HSW:4.4 Rev 5 MF: 3.177 (COP8) $P21, $CL5B and $CL5C files have been updated. ----------------------------------------------------------------------------- 06/28/00 HSW:4.4 Rev 6 MF: 3.178 (COP8) SGR devices can now be run up to 15 MHz on DM5. ----------------------------------------------------------------------------- 06/28/00 HSW:4.4 Rev 6 MF: 3.178 (COP8) Support for Emulation Module added (including for Simulator). ----------------------------------------------------------------------------- 06/29/00 HSW:4.4 Rev 6 MF: 3.178 (COP8) $CL5B and $CL5C files have been updated. ----------------------------------------------------------------------------- 06/30/00 HSW:4.4 Rev 6 MF: 3.179 (COP8) $CL6 file has been updated. ----------------------------------------------------------------------------- 08/08/00 HSW:4.4 Rev 8 MF: 3.183 (COP8) Changed the listed order of the emulator bases in the Select Chip Dialog Box and removed the CBR/SBR chip listings from the Debug Module. ----------------------------------------------------------------------------- 08/08/00 HSW:4.4 Rev 8 MF: 3.183 (COP8) There is now a Function Call Stack Window for the Debug Module, the AD base and the WA-500 base. ----------------------------------------------------------------------------- 08/09/00 HSW:4.4 Rev 8 MF: 3.183 (COP8 IM-WA) When the "File|Unload" command is selected, a yes/no/cancel box is displayed to verify that the user does want to perform a "Mass erase of the Flash Memory". ----------------------------------------------------------------------------- 08/21/00 HSW:4.4 Rev 8 MF: 3.183 (All 32-Bit Products) The debugger now has column headers in each of the applicable window types. The columns in each window are resizeable and moveable. The column headers can also be turned off via the window's 'Options|Headers' command to maximize the useable space in each window. Any customized (changed) settings are saved in and restored from the $SETTING file. ----------------------------------------------------------------------------- 08/21/00 HSW:4.4 Rev 8 MF: 3.183 (Memory Windows) The operation of the memory windows (Code, Data) has been improved. The window now scrolls more naturally when there is a currently- selected location. The window's title now indicates the address of the currently-selected location. A right-mouse click menu is also implemented. ----------------------------------------------------------------------------- 08/21/00 HSW:4.4 Rev 8 MF: 3.183 The 'Configure|Default Windows' command closes all existing windows and re-establishes the default window configuration. ----------------------------------------------------------------------------- 08/24/00 HSW:4.4 Rev 8 MF: 3.183 (COP8 IM-WA) There is now a Flash Programmer dialog box. ----------------------------------------------------------------------------- 09/28/00 HSW:4.4 Rev 9 MF: 3.183 (COP8) The 'Save Settings on Exit', etc., functionality now saves and restores the current 'View' mode for a Function Call Stack Window. ----------------------------------------------------------------------------- 10/02/00 HSW:4.4 Rev 9 MF: 3.183 Fixed a scrolling/painting problem in the 'Watch' and 'Browse' windows. Workaround Without This Fix: Resize the window. ----------------------------------------------------------------------------- 10/03/00 HSW:4.4 Rev 9 MF: 3.184 Fixed a bug where the software would take a very long time setting up the emulator for some breaks when, for example, an address specification of '>= 0x100' was supplied, or a large simple break range was specified. ----------------------------------------------------------------------------- 10/03/00 HSW:4.4 Rev 9 MF: 3.184 (COP8) If a chip is selected for an emulator base other than the current emulator base, the user is notified and will be forced to exit the software, but not before having access to the Select Chip dialog box. ----------------------------------------------------------------------------- 10/05/00 HSW:4.4 Rev 10 MF: 3.185 (Command Window) A long expression in an 'IF ...' statement in a Command Window caused a GPF (General Protection Fault). ----------------------------------------------------------------------------- 10/19/00 HSW:4.4 Rev 10 MF: 3.186 (Command Window) Modified the behavior of displaying error messages resulting from commands issued in a Command Window. Previously, the diagnostic was displayed (in the Command Window only) immediately following the offending command, and the software continued processing commands in the Command Window (e.g., reading commands from a Command File). Now, if the offending command is being read from a Command File, the diagnostic is displayed in the Command Window, as before; additionally, the same diagnostic is displayed in a standard "interactive" error message box and processing in the Command Window is suspended until you press the 'OK' button in the error message box. If the offending command is being entered directly into the Command Window from the keyboard, the behavior is the same as it was before: The diagnostic will be displayed only in the Command Window and the Command Window will be "ready" to accept the next command typed into the window without any other user interaction. ----------------------------------------------------------------------------- 10/20/00 HSW:4.4 Rev 10 MF: 3.186 (COP8 WA) Added model files and support for COP8ALE/AME/ANE9 devices. ----------------------------------------------------------------------------- 10/24/00 HSW:4.4 Rev 11 MF: 3.186 (Command Window) New commands are now available in a Command Window to display selected subsets of the 'ID' (Identification) information: ID_HWMODS Displays only HW-level version/content information. ID_MODDRVRS Displays only FW-level ("Module Drivers") version/content information. ID_PC_INFO Displays only Probe Card HW version/content information. ----------------------------------------------------------------------------- 11/01/00 HSW:4.4 Rev 12 MF: 3.187 (COP8 WA) Added model files and support for COP8LGE devices. ----------------------------------------------------------------------------- 11/09/00 HSW:4.4 Rev 13 MF: 3.187 (Command Window) Modified the 'HALT' and 'HALT msg' commands so that an interactive 'OK' box is displayed explaining that the 'HALT' command was executed, and displaying the 'msg', if any. ----------------------------------------------------------------------------- 12/14/00 HSW:4.4 Rev 15 MF: 3.189 (COP8 WA) $CL5B and $CL5C files updated. The internal reset detection logic has been improved. ----------------------------------------------------------------------------- 01/24/01 HSW:4.4 Rev 16 MF: 3.190 (COP8 WA) Added model files and support for CBC/CCC/CDC, CBE/CCE/CDE, CBG/CCG/CDG, CFC and CFE. Removed pin-out variations of CxR and SxR devices. ----------------------------------------------------------------------------- 01/30/01 HSW:4.4 Rev 17 MF: 3.190 (COP8 EPU/PM/DM) In Device Programmer dialog box, when a new device is selected and the answer to the "Do you want to initialize Code Memory?" is Yes, older versions did not update the windows under the dialog box. All windows are now updated. ----------------------------------------------------------------------------- 02/19/01 HSW:4.4 Rev 18 MF: 3.190 (COP8 WA) Modified the 'Run|Reset|Processor' command to write/restore the first 5 locations in code memory with the 'BRK' instruction byte, rather than 'NOP's to fix a HW bug. ----------------------------------------------------------------------------- 02/28/01 HSW:4.4 Rev 18 MF: 3.190 (ALL SW) Fixed a problem with source path mapping file processing. There was a situation where a source file with a name such as "filename.c" could be mistakenly picked as the source file for a module named "name". Whatever the length of the module name, only that many letters at the end of the base file name were checked. It now checks the whole base file name regardless of the length of the module name. ----------------------------------------------------------------------------- 02/28/01 HSW:4.4 Rev 18 MF: 3.190 (ALL SW) Issues regarding long file names and file names with spaces in them are now fixed. Previously, there were several places where the long file name was truncated and file names with spaces was not supported. ----------------------------------------------------------------------------- 03/01/01 HSW:4.4 Rev 18 MF: 3.190 (ALL SW) Fixed long file name problems in Trace Window. ----------------------------------------------------------------------------- 03/02/01 HSW:4.4 Rev 19 MF: 3.191 (ALL SW) When the Select Chip dialog box causes an exit from the software, the windows settings are no longer saved. Generally this dialog box would be called at startup with no windows open under it (other than the main menu window) and the settings would be saved that way. This would mean that on the next entrance to the software there would be no windows (again other than the main menu window). ----------------------------------------------------------------------------- 03/15/01 HSW:4.4 Rev 20 MF: 3.191 (COP WA) New $CL5B and $CL5C files released. Changes should make the COP8 WA a little more robust at low voltages. ----------------------------------------------------------------------------- 03/16/01 HSW:4.4 Rev 20 MF: 3.191 (ALL SW) Fixed a problem that caused an emulator comm timeout when an emulation was started. This happened if a memory window was minimized when starting the emulation. ----------------------------------------------------------------------------- 04/09/01 HSW:4.4 Rev 22 MF: 3.193 (ALL SW) Due to continued confusion over the "merge" question when the "File|Load" command is selected, there will be no more "merge" question. Instead the "File|Load" command will now assume that the user wants to load a file into a clean emulator (the equivalent of saying NO to the "merge" question). For those users who do need to load multiple files there is a new command "File|Load Multiple", which will assume that the user wants to load the file without cleaning the emulator environment (the equivalent of saying YES to the "merge" question). ----------------------------------------------------------------------------- 04/09/01 HSW:4.4 Rev 22 MF: 3.193 (ALL SW) When the host software detects that the users program has changed, it asks the user if they want to reload it. If the user says YES, then the program is loaded immediately, once the emulator environment is cleaned up (like the old "merge" NO), with no further questioning. The old version would open up the File Open box where the user would have to press OK and would also then ask the "merge" question. ----------------------------------------------------------------------------- 04/17/01 HSW:4.4 Rev 23 MF: 3.194 (COP8 WA) Updated a few items: 1) Reference to ALE devices removed. 2) If program being loaded has code out of range of flash devices you can now cancel load. 3) Changed wording in "Restore OPTION Register Bits" dialog box after Mass Erase to avoid some confusion. ----------------------------------------------------------------------------- 04/19/01 HSW:4.4 Rev 23 MF: 3.194 (COP8 DM/EM) New $P7 file released. The changes are to update the DM and EM for the changed programming spec for the SA/SG/AxC devices. ----------------------------------------------------------------------------- 04/19/01 HSW:4.4 Rev 23 MF: 3.194 (Any device with on board programmable clock) Fixed a problem that may have caused some start up problems with any emulator/probe card with the programmable clock. ----------------------------------------------------------------------------- 05/04/01 HSW:4.4 Rev 25 MF: 3.195 (All Products) The emulator now establishes communication with the emulator base at 9600 baud the very first time only. From then on (e.g., during a 'Configure|Emulator|OK') it resets the base only once and then establishes communication once (not twice) with the base at the user-selected baud rate. ----------------------------------------------------------------------------- 05/04/01 HSW:4.4 Rev 25 MF: 3.195 (COP8 DM, EPU, PM) Added two COP8AxC devices to programmable device list. ----------------------------------------------------------------------------- 05/08/01 HSW:4.4 Rev 25 MF: 3.195 (COP8 DM, EPU, PM) As part of fixing the configuration options for the COP8AJC/AKC devices, updated Device Programmer Configuration Options dialog box for COP8780 (Monolithic) devices, COP8SAx/SGx/AJC/AKC devices and Flash devices so that the dialog box looks like the layout of the ECON or OPTION register in the data book. ----------------------------------------------------------------------------- 06/21/01 HSW:4.5 Rev 1 MF: 3.196 (COP8 WA) When the FLASH_CKI command is used in the command window the Flash dialog box was not being updated properly. It is now. Also in the command window, the initial values shown using the DFLASH_CKI, DFLASH_HALT, DFLASH_WDT and DFLASH_START commands were not always correct. ----------------------------------------------------------------------------- 08/30/01 HSW:4.5 Rev 3 MF: 3.200 (ALL) Changed the A11 directive so that the SFR's will always be alphabetized in the SFR window for every device. I'm not sure why it was any other way. ----------------------------------------------------------------------------- 09/18/01 HSW:4.5 Rev 4 MF: 3.201 (All) Command Window now supports tabs in input lines, whether typed in directly or from a command file. Also, Command Window now assumes the project directory by default for all files, rather than the working directory (which is generally the SW installation directory). ----------------------------------------------------------------------------- 09/18/01 HSW:4.5 Rev 4 MF: 3.201 (All) Trace Window now defaults to the project directory for file writes, rather than the working directory (which is generally the SW installation directory). ----------------------------------------------------------------------------- 11/23/01 HSW:4.5 Rev 6 MF: 3.203 (All) All emulators tested on Windows XP. No problems found. ----------------------------------------------------------------------------- 11/30/01 HSW:4.5 Rev 7 MF: 3.204 (All) Implicit registers can now be added to the Watch Window. ----------------------------------------------------------------------------- 12/03/01 HSW:4.5 Rev 7 MF: 3.204 (COP8 WA) Added support for the SBE/SCE/SDE devices. ----------------------------------------------------------------------------- 12/04/01 HSW:4.5 Rev 7 MF: 3.204 (All) The problem that appeared to lock source files has been fixed. ----------------------------------------------------------------------------- 12/05/01 HSW:4.5 Rev 7 MF: 3.204 (COP8 WA) Fixed the spurious error when programming the security bit in the CBE device. ----------------------------------------------------------------------------- 12/07/01 HSW:4.5 Rev 8 MF: 3.204 (All) For any emulator that has trace memory, if a trace window is opened at startup and before an emulation is done, and the Reset Processor command is executed an API error occurs. The HSW now ignores this situation and no error is generated. ----------------------------------------------------------------------------- 12/07/01 HSW:4.5 Rev 8 MF: 3.204 (All) In the Command Window, it is now possible to halt the command script when the WES command is stuck because emulation does not break. Simply press any key on the keyboard and both the emulation and the command script will be halted. This applies only to the WES command. -----------------------------------------------------------------------------