Epson S1C88 Series Manual

Cmos 8-bit single chip microcomputer

page of 353

/ 353
Bookmarks

Quick Links

Download this manual

CMOS 8 - BIT SINGLE CHIP MICROCOMPUTER

S5U1C88000C Manual II

(Integrated Tool Package for S1C88 Family)

Workbench/Development Tools/Assembler Package Old Version

Summary of Contents for Epson S1C88 Series

Page 1 CMOS 8 - BIT SINGLE CHIP MICROCOMPUTER S5U1C88000C Manual II (Integrated Tool Package for S1C88 Family) Workbench/Development Tools/Assembler Package Old Version...
Page 2 No part of this material may be reproduced or duplicated in any form or by any means without the written permission of Seiko Epson. Seiko Epson reserves the right to make changes to this material without notice. Seiko Epson does not assume any...
Page 3 Configuration of product number Devices 88104 0A01 Packing specifications 00 : Besides tape & reel 0A : TCP BL 2 directions 0B : Tape & reel BACK 0C : TCP BR 2 directions 0D : TCP BT 2 directions 0E : TCP BD 2 directions 0F : Tape &...
Page 5 Describes the operation of the tools included in the Simulator Package. S5U1C88000H5 Manual Describes the operation of the ICE (S5U1C88000H5). S5U1C88xxxP Manual Describes the operation of the peripheral circuit board installed in the ICE. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 6 MANUAL ORGANIZATION EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 7 3.9.2 Assembler Options ....................27 3.9.3 Linker Options ..................... 29 3.9.4 Locator Options ....................30 3.9.5 Section Editor ...................... 32 3.10 Debugging ........................38 3.10.1 Simulator ......................38 3.10.2 In-circuit Emulator (S5U1C88000H5) and Debugger ........40 EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 8 9.3.5 Operation Procedure ................... 68 9.4 Error Messages ......................74 9.5 Example Output Files ....................75 10 M <winmdc> _____________________________ 76 CHAPTER HECKER 10.1 Outline of winmdc....................... 76 10.2 Input/output Files ....................... 76 EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 9 13.8.5 Break Functions ....................120 13.8.6 Trace Functions ....................127 13.8.7 Coverage ......................131 13.8.8 Writing Data to the FPGA on the Standard Peripheral Circuit Board ... 133 13.8.9 System Options ....................134 EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 10 13.9.11 Trace ....................... 180 td (trace data display) ................180 ts (trace search) ..................183 tf (trace file) ....................185 13.9.12 Coverage ......................186 cv (coverage) .................... 186 cvc (coverage clear) ................. 188 EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 11 A.2.4.7 Execution example of linking .............. 229 A.2.5 Creating Program Data HEX File ..............230 A.2.5.1 Program data HEX file ............... 230 A.2.5.2 Creating program data HEX file using hex88 ........230 A.2.5.3 Motorola S2 format ................231 EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 12 C.2 Cross Assembler <asm88> ..................276 C.3 Linker <link88> ......................281 C.4 Symbol Information Generator <rel88> ..............285 C.5 Symbolic Table File Generator <sym88> ..............288 C.6 Binary/HEX Converter <hex88> ................290 _________________________________________________ 293 UICK EFERENCE EPSON viii S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 13 Common to all S1C88 chips The tools included in this package are common to all S1C88 Family models. The chip dependent information is read from the parameter file and device information definition file for each chip. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 14 CHAPTER 1 GENERAL 1.2 S1C88 Family Integrated Development Environment EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 15 Converts the absolute object file generated by the linker into a HEX data file in the Motorola S format. This HEX file is used for debugging and creating mask data. Refer to Appendix for details of the tools in the Sub tool chain. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 16 This tool checks the data in development-completed program file and option document files to create the mask data file that will be presented to Seiko Epson. Refer to Chapters 6 through 12 for details of the tools in the Development tool chain.
Page 17 To use the optional ICE (S5U1C88000H5), Windows 2000 or Windows XP is necessary. Other To debug the target program using the in-circuit emulator system, the optional ICE (S5U1C88000H5) and a Peripheral Circuit Board (S5U1C88xxxP) are needed as the hardware tools. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 18 - The folder name must be 8 letters or less. - The folder name cannot contain any spaces. - When selecting a sub-directory, it must be located within two levels from the root directory. The installer will start installing the tools. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 19 To uninstall To uninstall the installed tools, use "Add/Remove Programs" on the Control Panel. 2.4 Directories and Files after Installation The installer copies the following files in the specified directory (default is "C:\EPSON\S1C88\"): [EPSON\S1C88] README_E.TXT ... ReadMe text file (English) README_J.TXT...
Page 20 The online manuals are provided in PDF format, so Adobe Acrobat Reader Ver. 4.0 or later is needed to read it. Files for future release models The files for future release models will be provided in the Microcomputer User's Site of Seiko Epson. Refer to the Readme file included in the package for installation. 2.5 Environment Settings The following environment variables must be configured for the tools in this package: SET PATH=C:\EPSON\S1C88\BIN;%PATH%...
Page 21 To start up the work bench Double-click on the wb88.exe icon. When the work bench starts up, the window shown below appears. To terminate the work bench Select [Exit] from the [File] menu. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 22 Each view area can be resized by dragging the boundary. A standard scroll bar appears if the display contents exceed the view area. Use it to scroll the display contents. The arrow keys can also be used. EPSON S5U1C88000C MANUAL II...
Page 23 Status bar Shows help messages when the mouse cursor is placed on a menu item or a button. The status bar can be shown or hidden by selecting [Status Bar] from the [View] menu. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 24 Invokes the auto evaluation system AutoEva. [ICE88UR] button Invokes the ice88ur debugger. [DB88] button Invokes the db88 debugger. [ROM Writer] button Invokes the on-board ROM writer control software. [About] button Displays the version of wb88. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 25 Saves the currently opened project. [Close Workspace] Closes the currently opened project. [Exit] Terminates wb88. 3.5.2 [View] Menu [Tool Bar] Shows or hides the tool bar. [Status Bar] Shows or hides the status bar. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 26 [Simulator Tools - Bitmap Utility] Invokes the bitmap utility BmpUtil. [Simulator Tools - LCD Panel Customize Utility] Invokes the LCD panel customize utility LCDUtil. [Simulator Tools - Port Setting Utility] Invokes the port setting utility PrtUtil. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 27 Displays a dialog box for setting the path to the simulator Sim88.exe. [Editor Configuration] Displays a dialog box for setting the editor path and the command line options. 3.5.7 [Help] Menu [About WB88] Displays a dialog box showing the version of the work bench. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 28 Folder in which temporary files created during building or tool execution are saved. For more information on the file types placed in each folder, refer to Section 3.12, "File List". EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 29 Notepad in Windows is set as the default editor. It can be changed by selecting [Editor Configuration] from the [Tool] menu. Note: Note that the list in the [project] window is not the actual directory structure. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 30 • Create a new project ([New | Project] on the [File] menu) • Compile or assemble ([Compile/Assemble] on the [Build] menu) • Build ([Build] on the [Build] menu) • Rebuild ([ReBuild All] on the [Build] menu) EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 31 "/j <line number>" option for tag jump in front of the file name, set the parameter as follows: /j%1 %f Note: In the default Notepad application, the tag jump function cannot be used. 2. Click the [OK] button. The editor used is changed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 32 This check box is displayed only when C source file is selected. Leave it checked to copy code from the C startup module stationery file into the C source file to be created. The stationery file is cstart.c in the \EPSON\S1C88\LIB\SRC folder. 2. Click the [OK] button.
Page 33 Note: Before using the tag jump function, you must ascertain that your editor supports command line- based tag jumps, and that the command line option is correctly set in [Tool | Editor Configuration]. (This function cannot be used with the default Notepad.) EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 34 The section editor of wb88 is used (so The section editor of wb88 is used or the there is no need to learn DELFEE). user creates files in DELFEE language. CARL instruction branching Available Not available optimization function EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 35 Project view, then select [Compile/Assemble] from the [Build] menu or click the [Compile/Assemble] button. [Compile/Assemble] button Depending on the file type selected, either the compiler or the assembler is launched to process the file. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 36 5. Select an assembly source file Local assemble options (which apply only to the selected assembly source) are displayed. The options for each tool selected in the Option view become effective the next time the tool is run. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 37 To enter multiple numbers, separate each entry with a comma (,). Other options To specify other options (including those listed above), enter the desired option in this text box in command line format. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 38 C source file. To change the compile options for each C source, uncheck the [Use Default] button and set each option individually again. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 39 File]. Click this button to display the dialog box shown below appears, where you can select the source type line to be removed from the list file. The default option setup content is "-LcDElMnPQsWXy". EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 40 To change the assembler options for each assembly source, uncheck the [Use Default] button and set each option individually again. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 41 If this option is selected, the linker suppresses diagnosis of undefined symbols. Print Name of Processing File (Verbose) "-v" option of lk88 If this option is selected, the linker displays the currently processed file name when linking. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 42 If this option is selected, the locator displays proposals for the software part of a locator description file. Print Name of Processing File (Verbose) "-v" option of lc88 If this option is selected, the locator displays the name of the file currently being processed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 43 This option always generates IEEE 695 standard (.abs) and Motorola S (.s) files. This option always generates a locate map file. -o file File names are set to the project name. This option is not used in wb88. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 44 When different types of sections generated by the compiler are to be located at contigu- ous addresses, however, the start address must be specified for each section (as detailed later). EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 45 Specify the size of a heap area for which memory is to be allocated by malloc( ), etc. Note that this setting only becomes effective when heap area is required and malloc( ), etc. actually used. EPSON S5U1C88000C MANUAL II...
Page 46 (i.e., contents of locator description files are not reflected). If you want to change for processing by alc88, therefore, be sure to correctly recreate an advanced locator definition file. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 47 1. Delete all contents of [Addr], [Mem] and [Size] on the line you want to delete (by using the [Backspace] or [Delete] key and selecting blank for [Mem]). 2. When three cells have been blanked, click the [Enter] key. The line will be deleted, with subsequent lines moved up. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 48 .text_xxxxxxxx table ..Address cannot be specified. data_short .nrdata data .frdata RAM area data_short .nbss .ndata .nbssnc data .fdata .fbss .fbssnc stack ..Address cannot be specified. xvwbuffer ..Address cannot be specified. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 49 The following four types of sections cannot be specified in the section editor. If any of these sections are specified, it will be deleted when you save or build a project. "heap", "stack", "table" and "xvwbuffer" EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 50 Once a path is set, there is no need to set it again the next time the simulator is run. Invoking the simulator To invoke the simulator 1. Select [Sim 88 Simulator] from the [Debug] menu or click the [Sim88] button. The dialog box shown below is displayed: [Sim88] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 51 The simulator is ready to start debugging as soon as it is started. The [Accept] button only generates the above files. It does not close the dialog box or launch the simulator. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 52 6. Click the [OK] button to close the dialog box and launch the debugger. The Work Bench generates a command file to load the necessary files from the input information and passes it to the debugger. The debugger is ready to start debugging as soon as it is started. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 53 For information on how to use each tool, refer to the simulator manual for tools 1 to 4, the corresponding chapters in this manual for tools 5 to 6, and the flash EEPROM-containing microcomputer technical manual for tool 7. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 54 <project>\obj\ Program data HEX file Project name .psa wb88/fil88xxx <project>\obj\ Development tool-related files Device information definition file Model name .ini Seiko Epson EPSON\S1C88\Dev\ Function option HEX file Option .fsa User/WinFOG Option Function option document file Option .fdc User/WinFOG Option...
Page 55 The command needs an active project. The command requires a project. This error message is displayed if, in the absence of a project, a function is executed for which a project must be present. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 56 Refer to the document titled "S5U1C88000C Manual I" for details about tools 1 to 4. Advanced locator alc88 in 5 is detailed in this manual. Note that because all of the above tools are executed by the functions of wb88, you need not operate any tool individually. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 57 When yyyy exists in the same bank as the CARL instruction, the immediately preceding "LD NB,xxxx" is deleted. When yyyy exists in a bank different than that of the CARL instruction, the immediately preceding "LD NB,xxxx" is not deleted. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 58 Symbolic table file (file.sy) This file contains symbol information extracted from the debugging information in the input files. This file is required for the symbolic debugging to be performed by the debugger or simulator. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 59 Specify the object file name to be supplied to alc88. <file.inf> Specify the advanced locator definition file to be supplied to alc88. Example: C:\epson\s1c88\app1 app1.out app1.inf When alc88 completes processing, it displays the following message (to stdout) regardless of whether it terminated normally.
Page 60 3. Mask data checker <winmdc.exe> This tool checks the data in development-completed built-in ROM file and option document files to create the mask data file that will be presented to Seiko Epson. 4. Device information definition file <s1c88xxx.ini> This file is used to set information, such as the configuration of options, on each type of microcom- puter for the three tools described above.
Page 61 Not available (Because OSC1 and OSC3 are respectively fixed to + old development tools Not considered a problem 32.768 kHz and 4.9152 MHz, clocks from external sources may be used for other oscillator frequencies as required.) Not considered a problem EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 62 00EFFFH) with FFH. The generated file is used to debug the program with the ICE (S5U1C88000H5). When debugging with the ICE, download this file from the computer. This file is also used as the program data to generate the mask data for submission to Seiko Epson by the mask data checker <winmdc>.
Page 63 (2) Start-up message When fil88xxx is started, the following message is displayed. FIL88xxx Unused Area Filling Utility Version X.XX Copyright (C) SEIKO EPSON CORP. xxxx (3) End message When a series of operation are complete, the fil88xxx displays the following message.
Page 64 Warning: No 00H Address There is no data in the physical address 000000H. Note: When there is no data in the physical address 000000H, it will output a warning message and filled the data FFH. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 65 System code (e.g. F1H, FFH) are set in the system reserved area (e.g. addresses 000024H and 000025H) for S1C88xxx. S224000000000123500050235023502350235023502350235023502350235023502350235040 S22400002023500150F1FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF21 S224000040FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFBB S224000060FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF9B S224000080FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7B S2240000A0FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5B S2240000C0FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF3B S2240000E0FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF1B S224000100CF6E00F6B4FFDD0030DD0100D94004C700F0C40000CFDCC30200D700F8E7F7F262 S2240001209300D94004B0FFB104C543F8C700F8CFEB7093CF3BE7FBC10001C20001CFEED725 S22400014000FEE7EEC500F8C600F8CFEE1255F5DAB000F23A04DD2003D94009DD22019C3F7C S224000160B001CED400F0D94004F27A00F29000F2A600F2BC00F2DD00F21703F23F03F2BD28 S22400018003F2F203CED084F1803204E703B000CED484F1CED003F1803214E703B000CED462 S2240001A003F1CEAECED006F332FFE7F7B000CED406F3F1B3D97560CED0007F7810CED00143 S2240001C07F7811D97801CED0027F7844CED0037F7845DD62FFDD6000DD63F5DD613FD9768C S2240001E010DD4008F8A2A0C60E7FB100CED084F1CF40464C02CEB0FC297802A8AAF8CED0CC S22400020084F13203E608F2E503B000F106F2D403B0FFCED407F4F8A2A0C6127FB100CED0CB S22400EFA0FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF6C S22400EFC0FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF4C S22400EFE0FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF2C S804000000FB EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 66 This file contains option lists for various types of microcomputers and other information. Always be sure to use the files presented by Seiko Epson. This file is effective for only the type of microcomputer indicated by the file name. Do not modify the contents of the file or use the file in other types of microcomputers.
Page 67 When winfog starts, it displays the [FOG] window. The following diagrams show a [FOG] window when the device information definition file has been loaded and when it has not. [FOG] Window (initial screen) [FOG] Window (after reading the device information definition file) EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 68 Message area When you create a file by selecting [Generate] from the [Tool] menu or clicking the [Generate] button, this area displays a message showing the result of the selected operation. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 69 [Device INI Select] button [Help] menu Version Displays the version of winfog. The [Help] button has the same function. [Help] button The dialog box shown below appears. Click [OK] to close this dialog box. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 70 When you create a function option HEX file, specify its file name here. The file name displayed by default can be modified. You can use the [Ref] button to look at other folders. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 71 HEX file (if specified) are created. When winfog has finished creating the files normally, it displays the message "Making file(s) is completed" in the message area. If an error occurs, an error message is displayed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 72 Use the [Setup] dialog box to change the file name. Note: The function option document file can be read only when the device information definition file has been loaded. (6) Quitting To terminate winfog, select [End] from the [File] menu. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 73 File (xxxx) cannot be written when executing Generate. Message Making file(s) is not completed Table 8.4.2 winfog warning messages Message Description Display Are you file update? Overwrite confirmation message Dialog xxxx is already exist (Specified file already exists.) EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 74 ← File name (specified by [Setup]) * FILE NAME zzzzzzzz.FDC ← User name (specified by [Setup]) * USER'S NAME SEIKO EPSON CORPORATION ← Date of creation (specified by [Setup]) * INPUT DATE yyyy/mm/dd ← Comment (specified by [Setup]) * COMMENT SAMPLE DATA ←...
Page 75 This file contains option lists for various types of microcomputers and other information. Always be sure to use the files presented by Seiko Epson. This file is effective for only the type of microcomputer indicated by the file name. Do not modify the contents of the file or use the file in other types of microcomputers.
Page 76 When the command is entered, a dialog box will appear to allow file selection. Enter the file name including the path in the text box or choose the file from the dialog box that appears by clicking on the [Ref] button. This specification can be omitted. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 77 When winsog starts, it displays the [SOG] window. The following diagrams show a [SOG] window when the device information definition file has been loaded and when it has not. [SOG] Window (initial screen) [SOG] Window (after reading the device information definition file) EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 78 Message area When you create a file by selecting [Generate] from the [Tool] menu or clicking the [Generate] button, this area displays a message showing the result of the selected operation. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 79 [Device INI Select] button [Help] menu Version Displays the version of winsog. The [Help] button has the same function. [Help] button The dialog box shown below appears. Click [OK] to close this dialog box. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 80 Click [OK], and the file is loaded. If the specified file exists and there is no problem with its contents, the set-up items in winsog are initialized with the loaded device information. To stop loading the file, click [Cancel]. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 81 When you create a segment option HEX file, specify its file name here. The file name displayed by default can be modified. You can use the [Ref] button to look at other folders. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 82 "Memory Address/Data bit" title is the base address of display memory, with only the lower byte of address being displayed in each row of the table. The vertical columns of the table correspond to data bits. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 83 When using the shared pins as COM pins, select segment/common shared output ([M] button) as the output specification and do not allocate memory. Note: This setting is required only for microcomputers that have SEG/COM shared pins. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 84 You can continue segment assignment from the previous set state. To stop loading the file, click [Cancel]. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 85 Therefore, the segment option document file in which the settings do not match the function option cannot be read. (10) Quitting To terminate winsog, select [End] from the [File] menu. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 86 One or more SPEC cells are left blank when executing Generate. Message Making file(s) is not completed Table 9.4.2 winsog warning messages Message Description Display Are you file update? Overwrite confirmation message Dialog xxxx is already exist (Specified file already exists.) EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 87 ← File name (specified by [Setup]) * FILE NAME zzzzzzzz.SDC ← User name (specified by [Setup]) * USER'S NAME SEIKO EPSON CORPORATION ← Date of creation (specified by [Setup]) * INPUT DATE yyyy/mm/dd ← Comment (specified by [Setup]) * COMMENT SAMPLE DATA ←...
Page 88 This file contains option lists for various types of microcomputers and other information. Always be sure to use the files presented by Seiko Epson. This file is effective for only the type of microcomputer indicated by the file name. Do not modify the contents of the file or use the file in other types of microcomputers.
Page 89 ∗ The microcomputer model name on the title bar is the file name (not including the path and extension) of the device information definition file that has been read. ∗ The [Pack] and [Unpack] buttons on the tool bar are enabled when the device information definition file is read. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 90 [Tool] menu Pack Packs the ROM data file and option document file to create a mask data file for presentation to Seiko Epson. The [Pack] button has the same function. [Pack] button Unpack Restores files in the original format from a packed file. The [Unpack] button has the same function.
Page 91 Once a device information definition file is selected, the same file is automatically loaded the next time you start winmdc. (2) Packing 1. Select [Pack] from the [Tool] menu or click the [Pack] button on the tool bar to bring up the [Pack] dialog box. [Pack] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 92 The file name displayed by default can be modified. You can use the [Ref] button to look at other folders. Make sure the extension of the output file name is ".pa0". If after presenting data to Seiko Epson, you present new data due to program bugs or any other reason, increase the number in the last digit of the extension in increments of one.
Page 93 5. Click the [Cancel] button to close the dialog box. Alternatively, you can click the [Cancel] button to quit winmdc before it executes unpacking. (4) Quitting To terminate winmdc, select [End] from the [File] menu. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 94 LCD segment data error : Data is not enough. Segment data is insufficient. Message LCD segment data error : Illegal start mark. Start mark is incorrect. Message LCD segment data error : Illegal end mark. End mark is incorrect. Message EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 95 ← Function option start mark \OPTION1 ← Model name/version * S1C88xxx FUNCTION OPTION DOCUMENT V x.x * FILE NAME zzzzzzzz.FDC * USER'S NAME SEIKO EPSON CORPORATION * INPUT DATE yyyy/mm/dd * COMMENT SAMPLE DATA "zzzzzzzz.fdc" * *** OPTION NO.1 *** * --- OSC1 SYSTEM CLOCK --- * Crystal(32.768KHz) ---- Selected...
Page 96 (2) Check the LEDs on the S5U1C88xxxP. If the LEDs light in the sequence described in readme.txt after a system reset, it is normal. The "cycle count" described in readme.txt indicates a 1 second interval and the LEDs change their light status every second. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 97 Map22=00FF42 00FF42 I Map23=00FF43 00FF43 I W Map24=00FF44 00FF45 I Map25=00FF48 00FF4A I Map26=00FF50 00FF53 I Map27=00FF54 00FF55 I W Map28=00FF61 00FF61 I Map29=00FF63 00FF63 I Map30=00FF70 00FF71 I Map31=00FF75 00FF75 I Map32=00FF78 00FF78 I EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 98 • The parameters (1) to (4) must be described in the part that begins with an [Options] line and the parameters following (5) must be described after the [MAP Config] line. Do not delete [Options] and [MAP Config]. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 99 ROM data HEX file is loaded. This file allows the debugger to display the symbols defined in the source. Function option HEX file (file_name.fsa) This is the mask option setup file in Motorola S2 format that is generated by the function option generator. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 100 ^ [<parameter file name>] ^ [<command file name>] ^ denotes a space. [ ] indicates the possibility to omit. Example: C:\epson\s1c88\\db88\db88 par88xxx.par startup.cmd Note: The parameter file and command file will be recognized by their extensions ".par" and ".com", so the extension must be included in the file name to be specified.
Page 101 CHAPTER 13 S1C88 FAMILY DEBUGGER When the debugger starts up, it outputs the following message in the [Command] window. DB88 Ver x.xx Copyright SEIKO EPSON CORP. 2001 Parameter file: xxxxxxxx.par Initialize......OK > When the tests and initialization of the ICE have been finished, the debugger displays "OK" and is ready to execute a debugger command.
Page 102 However, windows can only be resized and moved within the range of the application window. (3) Other The opened windows can be cascaded or tiled using the [Window] menu. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 103 The commands stored in memory can be recalled by entering the [Ctrl] + [H] keys when the [Command] window is active. Command history displayed by entering [Ctrl] + [H] EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 104 - If you follow by entering a 'y', command sy is highlighted. - Enter [Ctrl] + [H] after entering the character 'd' to paste the command dd into the prompt position. Note: The [Command] window cannot be closed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 105 In this case, the window in source display mode is left blank, and in mix display mode, the window shows only the disassembled contents. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 106 If the [Go to Cursor] button is clicked, the program will execute beginning with the current PC position, and program execution breaks at the line where the cursor is located. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 107 In this case, the source that includes the current PC address is displayed in the window. If the corresponding source cannot be found, the [Select Files] dialog box shown above appears, prompting for selection of the source to be displayed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 108 This search is case-insensitive, and instances that do not completely match the string will also be found. The [Find Previous] button functions in the same way as the [Find Next] button described above, except that string searches proceed up (toward the beginning of the program). EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 109 For [Source] window functions that can be used in mix display mode, refer to the description of disas- semble display mode. The source lines and the disassembled contents are displayed in black and gray, respectively. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 110 Hover the mouse cursor over data (need not to click) during [BYTE], [WORD], or [LONG] display, and the data is displayed in decimal notation (signed int or unsigned int). For [BYTE], the data is also displayed in bits. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 111 This condition can be changed so that the display is updated while the program is running using the dialog box that appears by selecting the [Run | Setting...] menu command (see Section 13.8.4, "Execut- ing Program"). EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 112 To update the display, select [Coverage] from the [Coverage] menu or execute the cv command. To clear the coverage information acquired in the ICE and display contents in the [Coverage] window, select [Coverage Clear] from the [Coverage] menu. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 113 This menu item forcibly breaks execution of the target program. The [Esc] key can also be used. [Reset CPU] This menu item resets the CPU. It performs the same function when the rst command is executed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 114 This menu item clears the coverage information acquired in the ICE and display contents in the [Coverage] window. It performs the same function as executing the cvc command. [Setting...] This menu item displays a dialog box for setting coverage options (coverage area and coverage mode). EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 115 It performs the same function as executing the rec command. [Setting...] This menu item displays a dialog box for setting system options (emulation clock, firmware clock, self-rewrite check function, and wait time for the cmw command). EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 116 This menu item tiles the opened windows. This menu shows the currently opened window names. Selecting one acti- vates the window. [Help] Menu [About DB88...] This menu item displays an About dialog box for the debugger. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 117 This button performs the same function when the se command is executed. [Reset CPU] button This button resets the CPU. It performs the same function when the rst command is executed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 118 ← Modifies address 00ff00H to 1. 00FF00 A:1↵ ← Returns to the immediately preceding address. 00FF01 A:^↵ ← Inputs address 00ff00H back again. 00FF00 1:0↵ 00FF01 A:↵ 00FF02 A:↵ ← Terminates the input session. 00FF01 A:q↵ > EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 119 Successive execution here means repeating the previous operation or continuous display of the previous contents. Execution commands: g, s, n, se, com Display commands: u, dd, td The successive execution function is terminated when some other command is executed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 120 [View | Watch] – Register symbols – Turn log output on or off [Option | Log...] – Record commands to a command file [Option | Record...] – ∗ Located in the [Source] window EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 121 Creating a command file Create a command file as a text file using an editor. Although there are no specific restrictions on the extension of a file name, Seiko Epson recommends using ".cmd". Command files can also be created using the rec command. The rec command creates a command file and saves the executed commands to the file.
Page 122 (2) When executing a command while each window is closed When the relevant display window is closed, the execution results are always displayed in the [Command] window regardless of whether operation is in log mode or normal mode. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 123 A FPGA data file is used to program the FPGA on the peripheral board (S5U1C88000P) for an S1C88 Family model. When this data is written to the FPGA once, rewriting is not necessary until the develop- ment for the model has been completed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 124 In this mode, the source that contains the code at the current PC address is displayed. This mode is available only when an IEEE-695 absolute object file that contains source debugging information has been loaded. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 125 The symbols used in the program and the defined addresses can be displayed in the [Command] window or the [Symbol] window. Table 13.8.2.2 Symbol list display command/menu item Function Command Menu Button Displaying symbol list [View | Symbol] – EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 126 256 found data. The [Dump] window shows found data within the current displayed area in green. See Section 13.4.4, "[Dump] Window", for display contents and operation on the [Dump] window. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 127 The contents of the above registers can be set to any desired value. The register values can be directly modified on the [Register] window. See Section 13.4.5, "[Register] Window", for display contents and operation on the [Register] window. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 128 [Run | Setting...] menu command. The [Symbol ] and [Coverage] windows do not change their display contents due to successive executions. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 129 If the [Register] window is closed, its contents are displayed in the [Command] window. The [Symbol ] and [Coverage] windows do not change their display contents due to single-stepping. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 130 The run time here can be measured in units of 1 µs (default) or 62.5 ns as selected with this option. Bus cycles can be counted up to 2,147,483,647 cycles (with ±0 error). EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 131 The respectively stipulated initializations are done for internal peripheral circuits. (2) Redisplaying the [Source] and [Register] windows Because the PC is reset, the [Source] window is redisplayed beginning with that address. The [Register] window is redisplayed with the settings above. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 132 Table 13.8.5.1 Commands/menu items/tool bar button to set breakpoints Function Command Menu Button Set software breakpoints [Break | Breakpoint Setting] Set software break area [Break | Breakpoint Setting] – Clear software breakpoints [Break | Breakpoint Setting] bc (bpc) EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 133 The addresses that are set as PC breakpoints are marked with a as they are displayed in the [Source] window. Example in source display mode Example in disassemble display mode EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 134 The same applies for lines whose execution can be halted by the [Go to Cursor] button. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 135 [CH3 Count] text box becomes active. There- fore, enter an execution count in this text box. The pro- gram does not break until it fetches the instruction (the number of times as specified here) at the BA3 address. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 136 To clear a breakpoint, select the address of that breakpoint from the list, then click the [Delete] button. The [Clear All] button allows you to clear all breakpoints that have been set. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 137 To clear break conditions on any channel, select that channel from the list, then click the [Delete] button. The [Clear All] button allows you to clear all break conditions that have been set. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 138 • Access to an undefined area • Executing an illegal instruction (that is not available in the model) These errors are detected using the memory and other information described in the parameter file. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 139 Values of the CPU registers (hexadecimal) SC, CC: Condition flag status Memory: Memory access status (other than code fetch status) MR: Memory read MW: Memory write [<address>] = <data>: Accessed memory address and read/write data (hexadecimal) EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 140 (All) or only data read/write accesses be traced (Data). After making the above selections, click the [OK] button. To stop setting trace mode, click the [Cancel] button. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 141 When [Trace Search...] is selected from the [Trace] menu, the dialog box shown below appears. Choose a search condition using the radio button, enter an address, and then click the [Search] button. To cancel searching trace data, click the [Cancel] button. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 142 Enter the file name to the [File Name] text box or choose a folder/file using the [Browse...] button. Then click the [OK] button to start saving. To cancel saving trace data, click the [Cancel] button. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 143 Note that the start and the end addresses of the 64 KB area selected are assumed if start and end addresses are not entered in these text boxes. To stop setting addresses, click the [Cancel] button. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 144 (∗), except in source display mode. Executing the cv command while the [Coverage] window is closed displays information in the [Com- mand] window as shown below. Example: >cv 0 00001e 000100 - 00010f EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 145 (2) Writing data to FPGA Data in the specified file is written to the FPGA. Also, the write command supports erasing the FPGA. Data for the supported models are provided as "c88xxx.mot" files in the "epson\s1c88\ice\fpga" directory (default). (3) FPGA data comparison The contents of the FPGA and specified file are compared.
Page 146 Specify an interval time at which to execute commands after loading a command file with the cmw command. The interval time can be set from 1 to 256 seconds in 1-second increments. The interval time initially is set to 1 second. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 147 Display map information FPGA operation xfer Erase FPGA xfwr Write FPGA data <file> ;{H|S} [;N] xfcp Compare FPGA data <file> ;{H|S} Dump FPGA data <addr1> [<addr2>] Quit Quit debugger Help Display command usage EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 148 • The input commands are case-insensitive, you can use either upper case or lower case letters or even mixed. • An error results if the number of parameters is not correct when you input a command using direct input mode. Error : Incorrect number of parameters EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 149 Since the [Dump] window can be scrolled to show the entire data memory, defining <address2> or @<size> does not have any specific effect. Only defining <address1> and both defining <address1> and <address2> or @<size> has same display result. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 150 AE 02 F0 F0 -5.942371e+029 000004 C9 02 F0 F0 -5.942382e+029 ... Double format >dd -d↵ 000000 AE 02 F0 F0 C9 02 F0 F0 -1.018151011077231e+236 000008 F0 F0 F0 F0 F0 F0 F0 F0 -1.077308742674321e+236 > EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 151 • An error results if the start address is larger than the end address. GUI utility [View | Dump] menu item When this menu item is selected, the [Dump] window opens or becomes active and displays the current data memory contents. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 152 … Return to previous address. "↵" … Input is skipped. (keep current value) If the maximum address of data memory is reached and gets a valid input other than "^↵", the command is terminated. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 153 (0–9, a–f). Data in the address will be modified with the entered number and the cursor will move to the next address. This allows successive modification of a series of addresses. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 154 • When the contents of the data memory is modified using the df command, the displayed contents of the [Dump] window are updated automatically. GUI utility None EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 155 • When the contents of the data memory is modified using the dm command, the displayed contents of the [Dump] window are updated automatically. GUI utility None EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 156 An error results if the limit is exceeded or the input one is not a hexadecimal number or a valid symbol. • Search is made within a 64 KB range. Specifying an address exceeding this range results in an error. GUI utility None EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 157 [Command] window even if the [Register] window is opened and are also output to the log file. GUI utility [View | Register] menu item When this menu item is selected, the [Register] window opens or becomes active and displays the current register contents. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 158 When a register is modified, the [Register] window is updated to show the contents you have input. If you input "q↵" to stop entering in the middle, the contents input up to that time are updated. EPSON S5U1C88000C MANUAL II...
Page 159 … Input is skipped. (keep current value) GUI utility [Register] window The [Register] window allows direct modification of data. Click the [Register] window, select the displayed data to be modified and enter a value then press [Enter]. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 160 SC:I1 I0 U D N V C Z CC:F3 F2 F1 F0 0 0 0 0 0 0 0 > When a break occurs, the same display appears as when data is displayed by the rd command. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 161 When this menu item or button is selected after placing the cursor to the temporary break address line in the [Source] window, the g command with a break address is executed. The program execution will be suspended before executing the address at the cursor position. [Go to Cursor] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 162 GUI utility [Run | Go after Reset] menu item, [Go after Reset] button When this menu item or button is selected, the gr command is executed. [Go after Reset] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 163 (4) During log mode If the program is single-stepped after turning on the log mode, the same contents as when executing the rd command are displayed in the [Command] window after the last step is completed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 164 • The program will not break even if the break condition set by a command is met while this command is processed. GUI utility [Run | Step] menu item, [Step] button When this menu item or button is selected, the s command without step count is executed. [Step] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 165 • The program will not break even if the break condition set by a command is met while this command is processed. GUI utility [Run | Next] menu item, [Next] button When this menu item or button is selected, the n command without step count is executed. [Next] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 166 • During a single-step operation, the program will not break even if the break condition set by a command is met. GUI utility [Run | Step Exit] menu item, [Step Exit] button When this menu item or button is selected, the se command is executed. [Step Exit] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 167 • The debug status, such as memory contents, breaks, and trace, is not reset. GUI utility [Run | Reset CPU] menu item, [Reset] button When this menu item or button is selected, the rst command is executed. [Reset] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 168 Any attempt to set a breakpoint at any address in that area will result in an error being assumed. • When a program or parameter file is loaded, the contents of all breaks set are cleared. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 169 If the address has been set as a breakpoint, this button clears the breakpoint. [Break] button The set breakpoints are marked with a at the beginning of the address lines in the [Source] window. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 170 If an intermediate address of that instruction is specified, no breaks can occur. • When a program or parameter file is loaded, the contents of all breaks set are cleared. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 171 To clear a breakpoint, select the address of that breakpoint from the list, then click the [Delete] button. The [Clear All] button allows you to clear all breakpoints that have been set, including those in a software break area. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 172 When this button is clicked after placing the cursor to a break address line in the [Source] window, the breakpoint is cleared. If the address has not been set as a breakpoint, this button sets a new breakpoint at the address. [Break] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 173 Select a sequential break mode using the [Sequential Break Mode] radio buttons. The [CH3 Count] text box is enabled to enter a BA3 execution count value when a radio button for the mode that uses the BA3 counter is selected. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 174 0x0300 once and fetches the instruction at 0x0300 again after executing the instruction at 0x0200 once or more, a break occurs before that instruction is executed. These breakpoints are effective even when set outside a 1 MB active break area. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 175 To clear a breakpoint, select the address of that breakpoint from the list, then click the [Delete] button. The [Clear All] button allows you to clear all breakpoints that have been set. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 176 An error results if no hardware breakpoint is set. GUI utility [Break | Breakpoint Setting] menu item When this menu item is selected, a dialog box appears for setting/clearing breakpoints. (See the ba command.) EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 177 In this example, data break is set on CH0. A break occurs when the program reads data whose MSB = 1 from address 0xf100. This address is effective even when set outside a 1 MB active break area. >bd0 _↵ > In this example, break conditions are disabled on CH0. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 178 To clear break conditions on any channel, select that channel from the list, then click the [Delete] button. The [Clear All] button allows you to clear all break conditions that have been set. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 179 An error results if no hardware data break condition is set. GUI utility [Break | Breakpoint Setting] menu item When this menu item is selected, a dialog box appears for setting/clearing breakpoints. (See the bd command.) EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 180 BA1 - BA3 Sequential Mode : Count(3) Data break: CH0 DATA: 1******* R/W: R R/W AREA: 00F010 ENABLE > GUI utility [Break | Break List] menu item When this menu item is selected, the bl command is executed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 181 (direct input mode) GUI utility [Break | Break All Clear] menu item, [Break All Clear] button When this menu item or button is selected, the bac command is executed. [Break All Clear] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 182 UNASSEMBLE 0002AE 00:02AE CF6E00F8 __START: LD SP,#F800h 0002B2 00:02B2 B4FF LD BR,#FFh 0002B4 00:02B4 DD0000 LD [BR:00h],#00h 0002B7 00:02B7 DD020C LD [BR:02h],#0Ch 0002CF 00:02CF B200 LD L,#00h 0002D1 00:02D1 C30000 ADD IY,#0000h > EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 183 [View | Source | Disassemble] menu item, [Disassemble] button When this menu item or button is selected, the [Source] window opens or activates and displays the program from the current PC address. [Disassemble] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 184 ============================ ;======================================================================== SP,#@DOFF(__lc_es) ; stack pointer initialize BR,#0FFh ; BR register initialize to I/O area ;--------------- bus mode setting ------------------------------------- ; MCU & MPU mode [BR:00h],#0 ; Single Chip mode ; /CE0,/CE2,/CE3,/CE1:disenabled > EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 185 [View | Source | Source] menu item, [Source] button When this menu item or button is selected, the [Source] window opens or activates and displays the program from the current PC address. [Source] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 186 _start_cpt( void ) 0002AE 00:02AE CF6E00F8 __START: LD SP,#F800h 0002B2 00:02B2 B4FF LD BR,#FFh 0002B4 00:02B4 DD0000 LD [BR:00h],#00h 0002B7 00:02B7 DD020C LD [BR:02h],#0Ch 0002BA 00:02BA DD0100 LD [BR:01h],#00h 0002BD 00:02BD B4F0 LD BR,#F0h EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 187 [View | Source | Mix] menu item, [Mix] button When this menu item or button is selected, the [Source] window opens or activates and displays the program from the current PC address. [Mix] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 188 The symbol list can only be displayed when the object file (.abs) in IEEE-695 format has been read or when the symbol file (.sy) is loaded simultaneously with the program HEX file (.psa). GUI utility None EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 189 [Watch] button. The selected symbol is then registered in the symbol list in the [Watch] window. Once registered this way, the symbol value can be confirmed in the [Watch] window. [Watch] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 190 [File | Load File…] menu item, [Load File] button When this menu item or button is selected, a dialog box appears allowing selection of an object file to be loaded. [Load File] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 191 [File | Load Parameter File] menu item, [Load Parameter] button When this menu item or button is selected, a dialog box appears allowing selection of a parameter file to be loaded. [Load Parameter] button EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 192 <cycle>, the trace data starting from <cycle> is displayed in the [Trace] window. The display contents of the [Trace] window is updated after an execution of the target program. All trace data can be displayed by scrolling the window. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 193 (Data on cycle Nos. 99 to 89 is displayed.) ... Continued display in BACKWARD. >↵ (Data on cycle Nos. 88 to 78 is displayed.) ... Changed back to FORWARD. >f↵ (Data on cycle Nos. 99 to 89 is displayed.) > EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 194 0. [Trace | Setting...] menu item When this menu item is selected, the [Trace Information Setting] dialog box appears to set trace conditions. See Section 13.8.6, "Trace Function", for details. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 195 The address specified for search must be within the range of the memory area available for each microcomputer model. An error results if the limit is exceeded or the input one is not a hexadecimal number or not a valid symbol. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 196 [Trace | Trace Search...] menu item When this menu item is selected, a dialog appears for setting a search condition. Select an option using the radio button and enter an address in the text box, then click [OK]. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 197 To save all the trace information, leave the [Start Point] and [End Point] boxes blank. The file name can be selected using a standard file selection dialog box that appears by clicking [Browse...]. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 198 ...Shows the executed addresses following 0x000100. 000100 - 00020e 000233 - 0002c4 0004e4 - 0004e9 00ff40 00ff54 - 00ff55 00ff61 00ff63 ...Shows the executed addresses from 0x000100 to 0x0001ff. >cv 100 1ff↵ 000100 - 0001ff > EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 199 [Coverage] window, you can leave [End to] blank. Note that the start and end addresses of the selected 64 KB area are assumed if start and end addresses are not entered in these text boxes. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 200 (coverage clear) Function This command clears the coverage information. Format >cvc↵ (direct input mode) GUI utility [Coverage | Coverage Clear] menu item When this menu item is selected, the cvc command is executed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 201 [Browse...]. To specify an interval, select [With Wait] and enter the number of seconds into the [Executing Wait Time] text box. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 202 • Use the hot key ([CTRL]+[Q]) to stop executing a command file. GUI utility None However, the same function as the cmw can be executed using [Command File...] in the [Run] menu (see the com command). EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 203 [Current Command File] or click the [New...] button and select from the list that appears. If the debugger has already started recording commands, use the [Record State] radio buttons to turn recording on or off. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 204 [Current Log File] or click the [New...] button and select from the list that appears. If the debugger has already started logging commands, use the [Log State] radio buttons to turn logging on or off. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 205 * * * * * * * * * FF80 FF90 FFA0 FFB0 FFC0 FFD0 FFE0 FFF0 ∗ When displaying the map information of the I/O area, the mapped addresses are marked by the letter "∗". GUI utility None EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 206 [Cancel] button on the dialog box or press the [ESC] key. In this case, the standard peripheral circuit board cannot be used until the FPGA is erased and reprogrammed. • Erase time is about TBD minutes TBD seconds (max.). GUI utility None EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 207 Notes • Use the file provided by Seiko Epson as the data to be written without modifying the contents. Also the file extension cannot be changed as it is .mot (Motorola S) or .mcs (Intel HEX). Specifying an illegal file results in an error and data cannot be written.
Page 208 • Use the file provided by Seiko Epson as the data to be compared without modifying the contents. Also the file extension cannot be changed as it is .mot (Motorola S) or .mcs (Intel HEX). Specifying an illegal file results in an error.
Page 209 00100: FF > Notes • An error results if the specified address is not a hexadecimal number. • An error results if the start address is larger than the end address. GUI utility None EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 210 CHAPTER 13 S1C88 FAMILY DEBUGGER 13.9.17 Quit (quit) Function This command quits the debugger. Format >q↵ (direct input mode) GUI utility [File | Exit] menu item Selecting this menu item terminates the debugger. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 211 ... dump from 0x0 in byte unit if without parameter dd [addr1] [@size] [unit] ... dump from 0x0 in byte unit if without parameter unit: display unit (-B (default) / -W / -L / -F / -D) GUI utility None EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 212 Failed to initialize DB88. Please restart DB88. Please quit and restart! Error : Input address does not exist The address specified here has no breakpoints set. Error : Invalid command The command entered here is invalid. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 213 Please clear the breakpoint set at (Address). Please clear the break point(Address) (If this breakpoint is not cleared, the program may stop at an unexpected location.) EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 214 Internal error : Illegal error code fetched. Nonexistent error code has been encountered. System crash possible (Please shut down the ICE88UR debugger immediately.) Processing terminated by hitting ESC-key Processing terminated because the ESC key was pressed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 215 Symbolic table file generator sym88 Mask Data Checker Symbolic winmdc table file file.SY file.par Mask file.PAn data file In-circuit Emulator (ICE) SEIKO EPSON Fig. A.1.2.1 Software development flow using structured assembler EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 216 • ra88.bat: Batch file for relocatable assembly • lk88.bat: Batch file for linking Details on the batch file and how to create customized files will be explained in Section A.2, respec- tively under their titles. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 217 The program memory (usable area) will be wasted if all modules are too large. Give consideration to each module size to prevent this. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 218 Batch processing for linking <lk88.bat> • System code setting and FF filling in unused program area by fil88XXX. • Program debugging using ICE. • Creating mask data of program. Fig. A.2.1.1 Relocatable assembly development flow EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 219 (For more information refer to Appendix B.) Macro statements are offered as pseudo-instructions of the sap88 and by putting it through the sap88 it is applied in the macro call-out portion in mnemonic form that can be assembled. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 220 "example" public main,work external src_address,dst_address,counter 0ffh data work: db code ;************************************************* * macro define * ;************************************************* ;************************************************* * example * ;************************************************* main: a,#abc b,[work] Macro statement expanded into mnemonics ix,#src_address iy,#dst_address hl,[counter] ;*** EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 221 Unlike CPU instructions, pseudo-instructions do not directly compose of application programs upon executing control instructions to the sap88 and asm88. The pseudo-instructions that can be used with this assembler are indicated above according to their functions. (Refer to Appendix B for more details.) EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 222 The relation of the symbol definition and reference within the file has been prepared to foster easy understanding depending on the cross reference list. File management has been enhanced since they are prepared as separate files. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 223 The DATA section of each module is further consolidated as a whole by the linker. The linker will link in sectional units in accordance with the page control within the data memory area. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 224 Refer to Appendix C for information on other flags. Example: C:\USER>c:\EPSON\sap88 -o sample.ms sample.s Inputs the assembly source file "sample.s" created in the sub-directory USER of drive C and then creates assembly source file "sample.ms" to be input in asm88 in the same directory as the input file.
Page 225 If the PATH to asm88 is set, then there is not need to specify the path before asm88. Example 2: Assembling with the relocatable assembler, including the verification of the ROM and RAM capacity. C:\USER>c:\EPSON\asm88 -ROM 32768 -RAM 65536 sample.ms Inputs assembly source file "sample.ms" created within the sub-directory USER of drive C and starts relocatable assembly.
Page 226 4. Cross reference list file: file_name.x This is the address list that contains the definition and references of symbols. 5. Error list file: file_name.e This is the list of error taking place during assembling. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 227 Do not input the extensions of file name. It is fixed on the ".s" extension. Example: C:\USER>c:\EPSON\ra88 sample Inputs structured assembly source file "sample.s" created within the sub-directory USER of drive C and starts relocatable assembly. Then creates the following files in the same directory as the input file.
Page 228 ************************************************************************** :start echo E0C88 Family Auto Relocatable Assemble Execution Utility Ver. X.XX echo Copyright (C) SEIKO EPSON CORP. 1993–1996 if "%1"=="" goto usage :error_chk if not exist %drv%nul goto exit04 if not exist %1.s goto exit05 if not exist %drv%sap88.exe goto exit06...
Page 229 APPENDIX A ASSEMBLER (Sub tool chain) Message list 1. Start-up message E0C88 Family Auto Relocatable Assemble Execution Utility Ver. X.XX Copyright (C) SEIKO EPSON CORP. 1993–1996 2. Message when terminated normally ra88.bat utility has been successfully executed. 3. Error message...
Page 230 Adds a involuntary page break. Refer to Appendix B for details of the pseudo-instructions. Start-up flag Refer to Appendix C for details of the flag. Flag Description Prevents creation of an assembly list file. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 231 The cross reference list file can prohibit output using the -x flag of the asm88. Example of cross reference list CROSS REFERENCE TABLE OF asm88 error.x 1993-06-07 17:28 PAGE delay 000100H delay_00 000103H delay_3times 000107H EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 232 Messages when ra88.bat (relocatable assembly) is executed C:\USER>c:\EPSON\ra88 sample C:\USER>echo off E0C88 Family Auto Relocatable Assemble Execution Utility Ver. X.XX Copyright (C) SEIKO EPSON CORP. 1993–1996 sap88 Structured Assembler Preprocessor Version X.XX Copyright (c) 1993 by Advanced Data Controls, Corp. Licenced to SEIKO EPSON CORP.
Page 233 The section is defined by using the linker's secondary flag (flag used to define section) +code and +data and the -p flag is used to allocate the address. Up to a maximum of 255 sections can be defined with one link. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 234 "prg.a" will be created. Multiple modules can be allocated in these sections defined as long as it is within the allowable capacity limit. What's more, multiple sections can be allocated within one bank as well. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 235 It will be necessary to give consid- eration to the combination of modules in each section upon allocation. Otherwise, there will be more unused memory area and thus, require unnecessary memory extension. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 236 Refer to Appendix B for details of the flags. Example: Performing linking through the link command parameter file (.lcm) C:\USER>c:\EPSON\link88 < sample.lcm Use the link command parameter file "sample.lcm" created in the USER of the sub-directory of drive C as the input redirect function to start-up link88 and perform linking. The name of the absolute object file specified in the link command parameter file will be created in the same directory as the input file.
Page 237 Example: C:\USER>c:\EPSON\lk88 Use the link command parameter file "sample.lcm" created in the USER of the sub-directory of drive C to start batch processing. Batch processing will create the absolute object file (.a), symbol information reference file (.ref), program data HEX file (.sa) and symbolic table file (.sy) in the same directory as the input file.
Page 238 Use the same name for the customized parameter outfn as the name described in the link command parameter (.lcm). The following indicates the lk88.bat program source list and the message list of the lk88.bat. Refer to it upon customizing the program. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 239 * option flag(s) at command line rem ************************************************************************** :start echo E0C88 Family Auto Link Execution Utility Ver. X.XX echo Copyright (C) SEIKO EPSON CORP. 1993–1996 :error_chk if not exist %drv%nul goto exit05 if not exist %parfn%.lcm goto exit06 :chk00 if not exist %drv%link88.exe goto exit07...
Page 240 Message list 1. Start-up message E0C88 Family Auto Link Execution Utility Ver. X.XX Copyright (C) SEIKO EPSON CORP. 1993–1996 2. Message when terminated normally lk88.bat utility has been successfully executed. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 241 The following shows examples of the lk88 execution. C:\USER>c:\EPSON\lk88 C:\USER>echo off E0C88 Family Auto Link Execution Utility Ver. X.XX Copyright (C) SEIKO EPSON CORP. 1993–1996 link88 Linker Version X.XX Copyright (c) 1993 by Advanced Data Controls, Corp. Licenced to SEIKO EPSON CORP.
Page 242 If this flag is omitted it will be processed as a standard output. Example: Converting sample.a to create program data HEX file C:\USER>c:\EPSON\hex88 -o sample.sa sample.a "sample.sa" will be created in the same directory as the input file by inputting the absolute object file "sample.a"...
Page 243 This is the complement of 1 of the total number of bytes allocated to that line (excluding S <CHECKSUM> field). Motorola S2 format S224000380788812CF7C8812CFC0CFC1CFC2CFC3CFC4CFC5CFC6CFC7CFD0CFD1CFD2CFD3CF7C S2240003A0D4CFD5CFD6CFD7CFD8CFD9CFDACFDBCFDCCFDDCFDECFDFCFE0CFE1CFE2CFE3CF90 S2240003C0E4CFE5CFE6CFE7CFE8CFE9CFEACFEBCFECCFEDCFEECFEFCFF0CFF1CFF2CFF3CE71 S2240003E0F4CEF5CEF8CEF9CFFACFFEDD8812C8C8C9C9CACACCCCCCCCCDCDA8A9AAABACAD28 S224000400AEAFCFB4CFB5CFB6CFB7CFBCCFBDA0A1A2A3A4A5A6A7CFB0CFB1CFB2CFB3CFB8AC S224000420CFB9F6F7CE94CE95CE9688CE97CE90CE91CE9288CE93CE9CCE9DCE9E88CE9FCE22 S22400044098CE99CE9A88CE9BCE80CE81CE8288CE83CE84CE85CE8688CE87CE88CE89CE8A9E S22400046000CE8BCE8CCE8DCE8E88CE8FE438E536E634E732CEE02FCEE12CCEE229CEE326CE <ADDR> <DATA BYTES> <CHECKSUM> <COUNT> 32-byte <S FIELD> EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 244 Example: C:\USER>c:\EPSON\rel88 -v +sec sample.a > sample.ref Inputs the absolute object file "sample.a" created in the USER of the sub-director of drive C and then creates the symbol list file "sample.ref" in the same directory as the input file.
Page 245 0x0000b8 D _ptecr 0x000082 C n_main *** +dec format *** acia.o 184 d acia.o n_getch 188 D _buffer 89 C n_recept 69 C n_outch 186 D _ptlec 184 D _ptecr 130 C n_main EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 246 Example: C:\USER>c:\EPSON\sym88 sample.ref Inputs the symbol information reference file "sample.ref" created in the USER of the sub-director of drive C and then creates the symbolic table file "sample.sy" in the same directory as the input file.
Page 247 In addition to the macro-definition and the macro-call, some pseudo-instructions related to the macro have been provided. For details, see Section B.3.8. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 248 In this field, describe an operand or constant of each instruction, a variable, a defined Operand field: symbol, a symbol that indicates memory address, or an operational expression. Put semicolon (;) at the beginning of this field, and describe a comment following it. Comment field: EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 249 B.2.4 Comment Comments are disregarded in the process of assembly. The comment begins with a ";" (semicolon) and ends at the termination of the line end (line feed code). EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 250 These descriptions by escape sequences are only permitted in character strings. The character string can be handled by ASCII instruction, and they can also be expressed by sets of characters enclosed by single quotation marks. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 251 2 execution, an error results. Also, if variables which were undefined when used for the expression in pass 1 are used in pass 2, it causes a phase error. Consequently, you should define the values for variables prior to using them in an expression. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 252 ↓ BOC, LOC, POD, LOD Every left parenthesis "(" must have a correspond- HIGH, LOW, ~, -, + High ing right parenthesis ")". The following table shows the priority for opera- tors. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 253 System condition flag SC Program counter PC New code bank register NB Code bank register CB Expand page register EP XP expand page register for IX YP expand page register for IY XP and YP register EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 254 Numeric expressions and symbols are to be enclosed by brackets ([ ]) Numeric expressions and symbols are to be enclosed by brackets ([ ]) Numeric expressions and symbols are to be written directly Numeric expressions and symbols are to be written directly None EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 255 $+10H ... Jumps to the address at a distance of 10H from current address jrs(l) Except for the above, notations described in the "S1C88 Core CPU Manual" can be used as is. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 256 Here instructions that function in a similar manner and instructions that assist in understanding are indicated. 6) Restriction Here restrictions for use are provided. Also, causes of errors that occur in the use of an instruction (forgetting the separator, for example) are explained. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 257 When it has not been specified, an error message is output. Example: Defines the program and constants in the code section. code trans: [iy],[ix] inc ix inc iy djr nz,trans 01h, 02h, 03h, 04h, 05h Related items: DATA, ORG EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 258 When it has not been specified, an error message is output. Example: Reserves an area for flag and buffer table in the data section. data flag: db [1] buffer: db [256*8] Related items: CODE, ORG EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 259 ;Reserves 16 bytes data as the constant ;Reserves 64 bytes and initializes at the character code for the space xhrbuf: db ' '(64) ;Reserves 64 bytes '*' as the constant db '*'(64) Related items: DW, DL EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 260 2 bytes will be made the evaluation value. Each format can be premixed for one instruction. Examples: ;Reserves 10 word size area array: dw [10] external func1,func2,func3,func4,func5 jmptbl: dw func1,func2,func3,func4,func5 ;Jump table of the functions Related items: DB, DL EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 261 Each format can be premixed for one instruction. Examples: ;Reserves 10 4 byte size areas lubarr: dl [10] ;Sets the constant lonum with a long word size integer lonum: dl 13768 Related items: DB, DW EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 262 It is set such that "1" within the 8 bits becomes odd PARITY EVEN It is set such that "1" within the 8 bits becomes even Related item: Table of ASCII character set EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 263 ;Initialization true ;Calculation of table length tablen TABFIN-TABSTA ;Defines a character string indicating ASCII characters Related items: SET, IFC, IFDEF, IFNDEF, REPT Limitation: The <name> description must begin from the 1st column. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 264 IFDEF/IFNDEF statements. [sap88 only] Examples: a,#abc a,#abc Related items: EQU, IFC, IFDEF, IFNDEF, REPT Limitation: The <name> description must begin from the 1st column. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 265 Length of the expression can be defined up to a 6 digit hexadecimal number, and an error occurs if 7 digits or more has been defined. Examples: sizstk 200h ;The stack size is 512 bytes ;Reserves space for the stack topstk: topstk+sizstk Related items: CODE, DATA EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 266 Example: ;SQRT permits reference from other modules public sqrt ;Routine that computes the square root of an integer sqrt: ..etc. Related item: EXTERNAL EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 267 ;General purpose subroutine group include utilsub Limitation: This instruction can only be used in the structured preprocessor sap88. In the cross assembler asm88, it cannot be used and will cause an error if used. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 268 Assembly termination pseudo-instruction terminates each source program. Name: ..Assembly stop Format: {<Label>} Functions: This instruction is used to stop the assembly. A list for the portion following this instruction is output, but not assembled. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 269 All symbols except a comma "," and brackets "(" , ")", "{" , "}", "[" , "]" can be used for parameters and arguments. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 270 "add a,y" in the third line will call itself. The macro call, therefore, will not occur. It will turn out to be a simple "add" instruction. If we take a look at a little more complicated example : maca macro macb macc endm EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 271 EQU, IFC, IFDEF, IFNDEF, IRP, IRPC, PURGE, SET Limitation: This pseudo-instruction can only be used in the structured preprocessor sap88. It cannot be accepted in the asm88 and will cause an error if used. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 272 ↓ a,#128 Related items: IDEF, IFNDEF, UNDEF Limitation: This pseudo-instruction can only be used in the structured preprocessor sap88. It cannot be accepted in the asm88 and will cause an error if used. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 273 L001: a,#3 c,L002 L002: Related item: MACRO Limitation: This pseudo-instruction can only be used in the structured preprocessor sap88. It cannot be accepted in the asm88 and will cause an error if used. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 274 XMAX ;delete the character string macro XMAX undef Related items: DEFINE, IFDEF, IFNDEF Limitation: This pseudo-instruction can only be used in the structured preprocessor sap88. It cannot be accepted in the asm88 and will cause an error if used. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 275 Related items: IRPC, MACRO, REPT Limitation: This pseudo-instruction can only be used in the structured preprocessor sap88. It cannot be accepted in the asm88 and will cause an error if used. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 276 ↓ Related items: IRPC, MACRO, REPT Limitation: This pseudo-instruction can only be used in the structured preprocessor sap88. It cannot be accepted in the asm88 and will cause an error if used. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 277 Related items: EQU, IRP, IRPC, SET Limitation: This pseudo-instruction can only be used in the structured preprocessor sap88. It cannot be accepted in the asm88 and will cause an error if used. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 278 "true" if the left side is larger than the right side > "true" if the left side is smaller than, or equal to the right side <= "true" if the left side is larger than, or equal to around the right side >= EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 279 Related items: EQU, IFDEF, IFNDEF, SET Limitation: This pseudo-instruction can only be used in the structured preprocessor sap88. It cannot be accepted in the asm88 and will cause an error if used. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 280 Related items: DEFINE, EQU, IF, IFNDEF, SET Limitation: This pseudo-instruction can only be used in the structured preprocessor sap88. It cannot be accepted in the asm88 and will cause an error if used. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 281 Related items: DEFINE, EQU, IF, IFNDEF, SET Limitation: This pseudo-instruction can only be used in the structured preprocessor sap88. It cannot be accepted in the asm88 and will cause an error if used. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 282 After the first page, SUBTITLE appearing within the current page is used as the subtitle of the following page and continue to be used until a new SUBTITLE appears. The character string should be enclosed by double quotation marks. Example: subtitle "asm88 Special function library" EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 283 Example: noskip 1,2,3,4,5,6,7,8,9,0 ;All the hexadecimal codes output to the assembly list file skip ascii "1234567890" ;ASCII codes output to list file as one line only Related item: SKIP EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 284 When this instruction appears, the form feed with the page header is inserted to the assembly list file same as an auto form feed. This instruction itself is shown in the first line of the page after form feeding. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 285 -[all c l o* q RAM# ROM# Here is an example using the software tool. sig# suf* x] [drive:]<files> We know that the asm88 receives the following 10 NOTE different sorts of flags. Here notes for use are described. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 286 Specify the file name to be input to the sap88. This file name can be input using either capital letters or small letters. When <file> has not been specified, the sap88 reads from the standard input. Note: The extension for the structured assembly source file should be made as ".s". EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 287 If there is no syntax error in a macro statement, the sap88 expands it normally even though it contains illegal operands such as wrong register names. This error will be detected by the assembler asm88. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 288 Cross reference Error Relocatable Assembly list file list file object file list file EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 289 An error will occur when <files> are not specified. Note: Up to eight characters are available for the source file name. Furthermore, the extension ".ms" must be input. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 290 By inputting the above, the three object files file1.o, file2.o and file3.o are automatically created. Be aware that the -o flag will not function, when multiple files have been specified for <files>. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 291 <token> invalid in expression Syntax error due to an illegal token system error < > <token> System error due to an illegal token unsupported instruction Unsupported instruction has appeared. unsupported operand Unsupported operand has appeared. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 292 When there is no syntax error within the input file nor pass 2 error, and all the processing is success- fully completed, the asm88 returns "success". EXAMPLE Performs relocatable assembly of the file "sample.ms" to simultaneously obtain the list file "sample.l". C>asm88 sample.ms EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 293 However, it outputs an error when the size exceeds 64K bytes in default, but does not output when the size exceeds 32K bytes. Consequently, a flag must be specified for judgment when the size exceeds 32K bytes. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 294 In case of the relocatable object files or the libraries are not in current drive, input the drive name in front of these file names. It can be omitted if these files are in current drive. Note: The extension for the relocatable object files should be made as ".o". EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 295 (CODE section) or 10000H (DATA section). An error will occur if the section size exceeds this setting value. Physical address setting Sets the physical address of the beginning of the section as ##. -p## EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 296 "success". If not, it returns "failure". EXAMPLE Links the sample.o by the link88 via standard input. A>link88 -o c88xxx.a +code -p0x100 +data -p0x8000 sample.o A> A>link88 < sample.lcm EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 297 Specify the file name to be input into the rel88. This file name can be input using either capital or small letters and specifying two or more files is possible. An error will occur when <files> is not specified. EPSON S5U1C88000C MANUAL II...
Page 298 Reading of the symbolic table in the object has failed. RETURN VALUE When a diagnostic message has not been created (in other words, when all the reads have succeeded and all the file formats are valid), rel88 returns "success". EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 299 However, the local symbols are registered in the symbolic table by setting the -all flag of the asm88 (all symbols output). If you wish to refer to all symbols, set the -all flag of the asm88. EPSON S5U1C88000C MANUAL II...
Page 300 This file name can be input using either capital letters or small letters. An error will occur when <file> is not specified. ERROR MESSAGE Error message Description No Input File Input file ".ref" has not been specified. EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 301 2. The sym88 does not check the format of the input file. Therefore, the symbol information file to be input to the sym88 must only be generated using the symbol information generating utility rel88 with the flags shown below. A:\>rel88 -v +sec sample.a>sample.ref EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 302 Specify the file name input to the hex88. This file name can be input using either capital or small letters. When an <ifile> is not assigned, or when an assigned file name is a "-" (hyphen), file xeq is read. Note: The extension for the absolute object file should be made as ".a". EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 303 "success". Otherwise, the hex88 returns "failure". EXAMPLE Converts the absolute object file sample.a into the program data HEX file in the Motorola S2 format. A>hex88 -o sample.sa sample.a EPSON S5U1C88000C MANUAL II WORKBENCH/DEV TOOLS/OLD ASSEMBLER...
Page 305 S1C88 Family Development Tools Quick Reference...
Page 352 12/F, Dawning Mansion, Keji South 12th Road 80992 GERMANY Hi-Tech Park, Shenzhen Phone: +49-89-14005-0 Fax: +49-89-14005-110 Phone: +86-755-2699-3828 Fax: +86-755-2699-3838 EPSON TAIWAN TECHNOLOGY & TRADING LTD. 14F, No. 7, Song Ren Road Taipei 110 Phone: +886-2-8786-6688 Fax: +886-2-8786-6660 EPSON SINGAPORE PTE., LTD. 1 HarbourFront Place...
Page 353 S5U1C88000C Manual II (Integrated Tool Package for S1C88 Family) Workbench/Development Tools/Assembler Package Old Version SEMICONDUCTOR OPERATIONS DIVISION EPSON Electronic Devices Website http://www.epson.jp/device/semicon_e Document code: 411391600 First issue October, 2001 Printed March, 2008 in Japan...

This manual is also suitable for:

S5u1c88000c

Epson S1C88 Series Manual

Quick Links

Related Manuals for Epson S1C88 Series

Summary of Contents for Epson S1C88 Series

This manual is also suitable for: