Z8 Encore!® Microcontroller Zilog Developer Studio II Product Brief PB009708-1010 Zilog Developer Studio II ZDS II Products Integrated for the Z8 Encore! Assembler ez8asm Introduction Compiler ez8cc Zilog Developer Studio II (ZDS II) Integrated Linker ez8link Development Environment is a complete stand- Librarian ez8lib alone system that provides a state-of-the-art devel- opment environment. Based on standard Windows Simulator Yes user interfaces, ZDS II integrates a language-sensi- Flash Loader Yes tive editor, project manager, C-Compiler, assem- Host Communication RS-232, USB, Ethernet bler, linker, librarian, and source-level symbolic debugger to provide a development solution specif- Figure 1 illustrates a typical display interface ically tailored to the Z8 Encore! line of microcon- showing many of the features of ZDS II. trollers. Figure 1. ZDS II’s Easy-To-Use Interface ZiLOG Worldwide Headquarters • 1590 Buckeye Drive • Milpitas, CA 95035 Telephone: 408.513.1500 • Fax: 408.365.8535 • www.zilog.com Zilog Developer Studio II for the Z8 Encore!® Microcontroller Product Brief 2 Easy-To-Use Interface • Download, Execute, Debug, and Analyze ZDS II provides a standard user interface with • Language-sensitive editor intuitive, easy-to-use controls commonly found in • Print the disassembly, call stack, symbol, ® Windows -based environments. The system con- memory and register window outputs for tains an integrated set of windows, document future reference views, menus, and toolbars to create, test and refine applications without having to alternate • Symbolic source-level debugging for C and between different systems. assembly languages • Online Help Flexible and Adaptable Design • Full-featured assembler and linker Capabilities • Interleaved source and disassembly Designed to use the multithreading capability of the host operating system, multiple operations can • Makefile generation be performed efficiently and easily with ZDS II. • Scripting language Working in this type of multitasking environment allows file editing while simultaneously compiling Specifications code. • Zilog Developer Studio (ZDS II) Save Valuable Time • Configurable settings for: The basic components of ZDS II are an assembler, CPU Target eZ8 C-Compiler, linker, debugger, and editor. Each Compiler Debugger of these modules plays an important role in helping a developer compile a product in record time. Assembler Debug Tool Incorporating auto-completion and auto-insert for Linker Workspace braces and quotes, the Intelligent Editor allows Editor options (syntax coloring, users to read and write code faster, navigate intelli- tabs, foldings, etc.) gently and identify and correct mistakes. • Debugger: Combining a simple interface and flexible design – elements results in full command of design appli- Source level, symbolic assembly debug- cations and quick time-to-market. ging – eZ8 C-Compiler Features • Supported Zilog processor family: Zilog's Z8 Encore!® Microcontrollers • Integrated Project Management—create, add, or remove project files • Host operating systems: Windows 2000, Windows XP Pro (32-bit), Windows Vista, • Intelligent Editor Support that allows you to Windows 7 read and write code faster, navigate intelli- ® gently and identify and correct mistakes • Supported hardware: Zilog Z8 Encore! Microcontroller On-Chip Debugger devices • Color configuration per syntax style • Find, Find in Files and Replace capabilities • Optimizing ANSI eZ8 C-Compiler • Compile, Build, and Rebuild All capabilities PB009708-1010 Zilog Developer Studio II – Z8 Encore!® Microcontroller Zilog Developer Studio II for the Z8 Encore!® Microcontroller Product Brief 3 IDE Window Details user. The Command Output window displays all text messages and output generated by the ZDS II Zilog ZDS II features several windows that allow IDE as it executes commands. viewing various aspects of ZDS II tools while The following windows output can be printed: Dis- working with a project. assembly, call stack, symbol, memory and register. Project Workspace Window Just click on the window and press CTRL + P (or right-click on the window and select “print”). The Project Workspace window displays project files. It uses a graphical hierarchy to display a proj- Status Bar ect’s source, dependency, and object files. This The Status Bar displays the current status of pro- graphic tree displays separate folders for source, gram execution. Status messages include STOP, web, and dependency files. These files display in STEP, and RUN. STOP mode halts the program. the Project Workspace window when the project is STEP mode allows Step Into, Step Over, and Step first opened. Out commands. Editor Window Debug Windows The Editor window allows viewing and editing of ZDS II features several specialized windows that the files in a project. It includes a chroma-code lan- allow viewing information that helps to debug guage-sensitive editor that displays instructions, applications. These windows are only available comments, and assembler directives in different when running in Debug mode. Select the Debug colors. It also includes built-in search capabilities. Windows submenu and the name of the Debug Double-click on an error message in the output window or click on the appropriate Debug win- window to find the line containing the error. dow’s icon in the toolbar. Figure 2 illustrates the Output Windows Debug Window. Developers can use the following commands and Use the Output windows to view comments and tools: errors when building or compiling a project. Out- put windows contain tabs for Build, Debug and • Go, Break, Reset, Step Into, Step Over, Step Find, Message, and Command Output functions. Out, and Set Next Instruction commands The Build tab displays the results of the assembler/ • Run or Jump to Cursor commands linker process. The Debug tab displays error mes- sages during the Debug and Build processes. The • Downloading code to Zilog emulators two Find files hold the results of the Find in Files • Inserting or removing breakpoints Command, depending on which Find in Files tab the user chooses. The Messages Output window • Enable/Disable (All) breakpoints displays informational messages intended for the PB009708-1010 Zilog Developer Studio II – Z8 Encore!® Microcontroller Zilog Developer Studio II for the Z8 Encore!® Microcontroller Product Brief 4 Disassembly Editor Window Project Memory Window Window Locals Window Symbols Call Stack Window Window Output Window Registers Window Figure 2. Debug Windows—Example Table 1 lists the Debug windows and functions. Table 1. Functions of the Debug Window Debug Window Function Registers Displays the contents of all registers. Clock Displays the number of states executed since the last reset. Memory Displays data located in program memory. Watch Displays all the variables and their values defined using the WATCH command. If the variable is not in scope, the variable is not displayed. Locals Displays all local variables that are currently in scope. Call Stack Displays the functions whose frames have been pushed onto the stack. Symbols Displays the address for each symbol in the program. Disassembly Displays the assembly code associated with the code displayed in the Code win- dow. For each line in this window, the address location, the machine code, the assembly instruction and its operands display. Special Function Displays the contents of the special function registers for the selected target. Registers PB009708-1010 Zilog Developer Studio II – Z8 Encore!® Microcontroller Zilog Developer Studio II for the Z8 Encore!® Microcontroller Product Brief 5 eZ8 C-Compiler <limits.h> and <stddef.h>. This release sup- ports more of the standard library than is required Introduction of a freestanding implementation. The compiler runs on the Windows 2000, The eZ8 C-Compiler is an optimizing ANSI C- Windows XP Pro (32-bit), Windows Vista or Compiler. The eZ8 C-Compiler meets ANSI’s defi- Windows 7 operating systems and can be invoked nition of a freestanding implementation (code can either through the command line or within the be developed for another machine; also, it is not Zilog Developer Studio Integrated Development assumed that operating system services will be Environment. There are several language exten- available at run time), with the exception that dou- sions supported in this version of the compiler, bles (object types) are 32 bits. In accordance with including interrupt functions and memory space the definition of a freestanding implementation, the accesses. compiler accepts programs which confine the use of the features of the ANSI standard library to the Figure 3 illustrates an example of the eZ8 C-Com- contents of the standard headers: <float.h>, piler development flow. C Source Files Assembler C- Source Compiler Assembler Assembler Source IEEE695 Linker Archiver Object Command Files Files Linker Libraries of IEEE695 Object Files IEEE695 File Target Board Figure 3. C-Compiler Development Flow PB009708-1010 Zilog Developer Studio II – Z8 Encore!® Microcontroller Zilog Developer Studio II for the Z8 Encore!® Microcontroller Product Brief 6 Software Features • 512MB RAM or more • Highly optimized ANSI C-Compiler • 50MB hard disk space or more • ANSI C run time library • Super VGA Video adapter – String manipulation • CD-RM – Character classification and conversion • One or more RS-232 ports – Buffer manipulation • USB Port – Data conversion • Ethernet Port – Floating point and trigonometric functions • Single precision IEEE floating point support Supported Zilog