ZDS II for Z8 Encore! MC Emulator 4.9.5 (Build 05101702) ============================================================================== Thank you for purchasing ZiLOG's Z8 Encore! MC Emulator kit. The following features are provided in this release: - ZDS II Integrated Development Environment (ZDS IDE) - Z8 Encore! MC language tools including C compiler, assembler, linker/locator, and librarian - Z8 Encore! MC Series stand alone and In-Circuit Emulator with trace and event system - Z8 Encore! MC Cycle Accurate Simulator and disassembler - ZiLOG Standard Library (ZSL) - Technical Documentation provided on the CD-ROM To maintain forward and backward compatibility between Silicon revision please recompile your code with the latest version of ZDS II. The technical documentation supplied on this CD-ROM is available in PDF format. This format requires that Acrobat Reader or equivalent be installed on the host machine. Acrobat Reader is available on this CD-ROM and is available free on the Adobe website at www.adobe.com. In the event of a component problem, please complete the Problem Report Form and submit it with your request. The form is located on the CD and in the installation directory of your hard drive. Our staff will use the information to diagnose or log the problem. Contact Information -------------------------------------------------------------------------- ZiLOG Inc. Web Site: http://www.zilog.com Technical Support Channel: http://support.zilog.com Table of Contents -------------------------------------------------------------------------- - Introduction - Changes from Previous Release - Compatibility - System Requirements - Application and Other OS issues - Migration Pointers - Precautions and Limitations - Closed Change Requests - Open Change Requests CHANGES FROM PREVIOUS RELEASE ============================================================================== Not Applicable COMPATIBILITY ============================================================================== Devices -------------------------------------------------------------------------- Z8 Encore! MC Series: Z8FMC16100 Please refer to the Project>Settings>CPU selection for the latest supported devices. Emulator -------------------------------------------------------------------------- Z8FMC161000ZEM: Z8 Encore! MC Emulator Please refer to the Project>Settings>Debugger tab for the latest supported targets. SYSTEM REQUIREMENTS ============================================================================== Supported Operating Systems -------------------------------------------------------------------------- Windows XP Professional, Windows 2000 SP4, Windows 98 SE, Windows NT 4.0 SP6 Suggested Host Configuration -------------------------------------------------------------------------- Windows XP Professional Pentium III 500MHz processor or higher 128 MB RAM or more 100 MB hard disk space (includes Application and Documentation) Super VGA Video Adapter CD-ROM for installation Ethernet 10Base-T compatible connection RS-232 communication port Internet browser (Internet Explorer or Netscape) Minimum Host System Configuration -------------------------------------------------------------------------- Windows 98 SE or Windows NT 4.0 SP6 Pentium II 233MHz processor 96 MB RAM 25 MB hard disk space (only includes Application) Super VGA Video Adapter CD-ROM for installation RS-232 communication ports Ethernet 10Base-T compatible connection Internet browser (Internet Explorer or Netscape) Z8 Encore! MC Emulator -------------------------------------------------------------------------- Ethernet 10Base-T compatible connection APPLICATION AND OTHER OS ISSUES ============================================================================== 1. Apply the latest Windows updates to the host system when appropriate. 2. ZDS II will terminate an active target connection when the host goes into Stand by or Hibernate. PRECAUTIONS AND LIMITATIONS ============================================================================== Debugger -------------------------------------------------------------------------- 1. The Debugger's memory window for RData shows internal Data Memory range 0-Edata limit of selected device. 2. Editing and building code while in Debug mode requires that the current debug session end. Restart the debugger, after completing the build, to debug the new code. 3. The simulator is an instruction set simulator without special function register support for performing input/output operations. Therefore the SFR and their related debug windows may not contain accurate register information. 4. In the SFR window, a special pull-down group named SPECIAL_CASE was created to control the reading of a few select registers. These few SFR's change state or alter the state of an associated SFR when read. See FAQ for further discussion. 5. The Symbol Window must not be open when running a command script. 6. The Watch Dog Timer (WDT) must be disabled while debugging the target. The WDT will cause the processor to perform a reset and the debug mode will not be enabled upon reset. Therefore the debugger will loose control of the processor. 7. The target frequency should be set in the Configure Emulator dialog for each new project. 8. The debugger does not support arrays with more then 6 dimensions. 9. The user may not break a target in STOP mode. STOP mode is exited by the specified STOP mode recovery methods or by invoking a debugger reset or reconnect. 10. The user may break a target in HALT mode. A single step will force the target to escape from HALT mode otherwise the target will remain in HALT mode. 11. If a target enters HALT mode, the trace information before the target exits HALT mode is not available. 12. When debugging a motor control application: break/resume code execution and use breakpoints with care; otherwise the target and/or it's components may be damaged. 13. At least one NOP must be inserted between Analog-to-Digital Converter (ADC) register access instructions when executing a program on the emulator. This is a limitation of the emulator and is not required for code running on the actual device. Refer to main.c in the Z8FMC16_MotorDemo sample (look for ADC_DELAY) for an example. 14. This emulator supports the external clock source only. Compiler, Assembler, Linker/Locator, & Librarian -------------------------------------------------------------------------- 1. The Small memory model uses General purpose registers from 0-FFH. The Large memory model uses the entire internal register memory with limit of 3FFH for devices with 1K. Run-Time Library -------------------------------------------------------------------------- 1. The ZiLOG default startup files startups.asm and startupl.asm have been modified to allow user code to begin at an arbitrary origin (because it can now be located independently of the interrupt vectors). In general, users can continue to use these startup files without any impact from the modifications, because the linker places the start of user code at a safe location. Any user who wishes to ensure that his user code begins at a specific address should use the LOCATE linker directive to do so. For example, to locate the startup at 38H, add the following in Project->Settings->Linker->Input->Add Directives: locate startup at $38 IDE -------------------------------------------------------------------------- 1. It is recommended to disable anti-virus software while using ZDS II. The scan all files feature may make ZDS II operate slowly and/or cause target communication errors. 2. In the Settings > Linker > Input page, if 'Standard' is not selected as the Startup Module, the necessary linker directives are not included in the generated link command file. If you use the 'Included in project' or 'Custom' Startup Module settings AND use the startup source or object provided with the tools (startups.asm, startupl.asm, startups.obj, startupl.obj), the build results in linker errors/warnings resembling the following example: Linking... WARNING (724) --> Symbol _far_stack (.\startupl.obj) is not defined. WARNING (724) --> Symbol _len_neardata (.\startupl.obj) is not defined. WARNING (724) --> Symbol _len_farbss (.\startupl.obj) is not defined. WARNING (724) --> Symbol _len_nearbss (.\startupl.obj) is not defined. WARNING (724) --> Symbol _len_fardata (.\startupl.obj) is not defined. WARNING (724) --> Symbol _low_neardata (.\startupl.obj) is not defined. WARNING (724) --> Symbol _low_nearbss (.\startupl.obj) is not defined. WARNING (724) --> Symbol _low_near_romdata (.\startupl.obj) is not defined. WARNING (724) --> Symbol _low_far_romdata (.\startupl.obj) is not defined. WARNING (724) --> Symbol _low_farbss (.\startupl.obj) is not defined. WARNING (724) --> Symbol _low_fardata (.\startupl.obj) is not defined. To work around this issue, you must add the standard linker directives to the generated link command file via 'Add Directives' on the same settings page. To get the correct directives, set up the project to use the standard startup module and then perform a build. Open the generated link command file (.linkcmd) and copy everything from 'CHANGE TEXT=EDATA' or CHANGE TEXT=RDATA to the ‘define _near_heapbot = top of RDATA’ line into the Add Directives dialog. The link command file is generated whether or not the build is successful. Reset your project settings and your build should work. 3. Ensure the Generate object option is selected in the Project > Settings > Assembler dialog after converting a project from a previous version of ZDS. Otherwise, the following linker warning will be generated when building the converted project: WARNING (731) --> File ".\zsldevinit.obj" is not found. 4. The Motorola S-record format is not supported. Utilities exist to convert files to the S-Record format from one or more of the formats supported by ZDS II. These may be acquired via the Internet using an Internet search site such as Yahoo or Google. OPEN CHANGE REQUESTS ============================================================================== None applicable