Epson S1C62 Family 3.7 HELP Command

ICE CONTROL SOFTWARE ICS62XX

3.7 HELP Command

S1C62 FAMILY	EPSON	VIII-85
DEVELOPMENT TOOL REFERENCE MANUAL

Contents

S1C62 Family Development Tool Reference Manual © SEIKO EPSON CORPORATION 2001 All rights reserved S1C62 Family Development Tool Reference Manual Preface I.INTRODUCTION II.DEVELOPMENT TOOL MANAGEMENT SYSTEM DMS6200 III.CROSS ASSEMBLER ASM62XX IV. MELODY ASSEMBLER MLA628X Page Devices Development tools S1C60 Family processors S1C62 Family processors Development tools for the S1C60/62 Family Page S1C62 FAMILY DEVELOPMENT TOOL INTRODUCTION Page INTRODUCTION Contents Composition of the Software Development Tools S5U1C62xxxD Composition of the Hardware Tools Page 1.1 Composition of the Software Development Tools S5U1C62xxxD 1.2 Composition of the Hardware Tools S1C62xxx Development Tool S5U1C62xxxD Concerning file names Note The melody and segment option flow are only valid in models possessing those functions Fig. 3.1 S5U1C62xxxD development flow Page Page Page Page Page DEVELOPMENT TOOL MANAGEMENT SYSTEM DMS6200 Page DEVELOPMENT TOOL MANAGEMENT SYSTEM Page Page Page Page Page CROSS ASSEMBLER ASM62XX Page CROSS ASSEMBLER ASM62XX Outline ASM62XX Input/Output Files Starting ASM62XX Selecting Auto-Page-SetFunction Page ■ROM area Valid specification range ■RAM area ■Undefined code 2.1 Outline 2.2 ASM62XX Input/Output Files ■Source file (C2XXYYY.DAT) ■Object file (C2XXYYYH.HEX, C2XXYYYL.HEX) ■Assembly listing file (C2XXYYY.PRN) 3.1 Starting ASM62XX ASM62XX _ [drive-name:] source-file-name[.shp] _ [-N] ■Drive name ■Source file name ■.shp A>ASM62XX C2XXYYY A>ASM62XX B:C2XXYYY A>ASM62XX C2XXYYY.BBZ A>ASM62XX C2XXYYY -N 3.2 Selecting Auto-Page-SetFunction DO YOU NEED AUTO PAGE SET?(Y/N) ■Auto-page-setfunction 3.3 Generating a Cross-ReferenceTable DO YOU NEED CROSS REFERENCE TABLE?(Y/N) Basic format: 4.2.2Mnemonic field 4.2.3Operand field 4.2.4Comment field 4.3 Index 4.3.1Label 4.3.2Symbol OFF A,ON ; = LD A,1 A,OFF 4.4.3Operator ■Arithmetic operators Example: 00000011B SHL 2 → 00001100B Example: 11000011B SHR 2 → 4.4.4Location counter ■Location counter JP $+3 4.5 Pseudo-Instructions 4.5.1Data definition pseudo-instructions ■EQU (Equate) <Symbol>_EQU_<Expression To define a symbol 4.5.2Memory setting pseudo-instructions ■ORG (Origin) ORG_<Expression To set the location counter ORG 0100H ; BNK=0, PCP=1, PCS=00H ■BANK BANK_<Expression To set the bank (BNK) ■PAGE PAGE_<Expression Section 4.5.3Assembler control pseudo-instructions ■END END To terminate assembly 4.6 Macro-Functions 4.6.2Macro-definitions ■MACRO ~ ENDM <Macro-name>_MACRO_ [<Dummy-argument>, ...]Statement ENDM LDM MACRO REG,ADDR 4.6.3Macro-calls [<Label>]_<Macro-name>_ [<Actual-argument>, ...] 0200H CTAS CTAE Page FILE NAME ERROR FILE NOT PRESENT DIRECTORY FULL FATAL DISK WRITE ERROR LABEL TABLE OVERFLOW APPENDIX ASM62XX EXECUTION EXAMPLE 1) Source file (C2XX0A0.DAT) 2) Running the assembler (display on the console) 3) Assembly listing file (C2XX0A0.PRN) 4) Object files (C2XX0A0H.HEX, C2XX0A0L.HEX) A>TYPE C2XX0A0L.HEX (When ROM capacity is in 1,024 steps) Page MELODY ASSEMBLER MLA628X Page MELODY ASSEMBLER MLA628X Page 1 DIFFERENCES DEPENDING ON THE MODEL 2.1 Outline and Execution Flow 2.2 MLA628X Input/Output Files ■Source file (C28XYYY.MDT) ■Melody HEX file (C28XYYYA.HEX) MLA628X_[drive name:]source filename[.shp]_[-H] ■Source filename ■-Hoption A>MLA628X C28XYYY A>MLA628X B:C28XYYY A>MLA628X C28XYYY.BBZ When MLA628X is activated, the activation messages appear as shown below When assembling C28X0A0.MDT (Basic assembly) 4.2 Statement (line) <Attack <Note <Scale <End bit (3)Scale field (4)End bit field (5)Comment field (6)Fields and corresponding melody data *Melody data 5.1 Address-Setting Pseudo-Instruction ■ORG (ORIGIN) Sets location counter 5.2 Option-Setting Pseudo-Instructions ■Tempo selection ■.TEMPC1 .TEMPC1 = n Sets TEMPC1 (n = 0–15) ■.OCTAVE .OCTAVE = m APPENDIX ■Example of Source File ■Example of Assembly List Example of scale ROM table -Hyphens "--"indicate unused code -When unused, the code is FFH ■Example of Melody Hex File Data Format Main ROM high-order(D8, D9) ■Example of Assembly List When Error Occurs ■Example of Melody Document File Format Main ROM (high side) Intel hexadecimal format Main ROM (low side) Scale ROM Page FUNCTION OPTION GENERATOR FOG62XX Page FUNCTION OPTION GENERATOR FOG62XX Outline of Function Option Generator FOG62XX Input/Output Files Option List Recording Procedure Option List Example Page FOG62XX.EXE 3.1 Option List Recording Procedure 3.2 Option List Example DEVICE TYPE MULTIPLE KEY ENTRY RESET INTERRUPT NOISE REJECTOR 4.1 Starting FOG62XX A>FOG62XX When FOG62XX is started, the following message is displayed When not modifying the date, press the RETURN key "" to continue 4.2 Setting New Function Options (1)PLEASE SELECT NO (2)PLEASE INPUT FILE NAME (3)PLEASE INPUT USER'S NAME (4)PLEASE INPUT ANY COMMENT 4.3 Modifying Function Option Settings (2)*** SOURCE FILE(S) (3)PLEASE INPUT FILE NAME (4)PLEASE INPUT USER'S NAME (5)PLEASE INPUT ANY COMMENT 4.4 Selecting Function Options 4.5 HEX File Generation and EPROM Selection (1)DO YOU MAKE HEX FILE (Y/N) (2)PLEASE SELECT NO 4.6 End Procedure Page SEGMENT OPTION GENERATOR SOG62XX Page SEGMENT OPTION GENERATOR SOG62XX Page Page 2.2 SOG62XX Input/Output Files ■Segment option source file (C2XXYYY.SEG) ■Segment option document file (C2XXYYYS.DOC) ■Segment option HEX file (C2XXYYYS.HEX) 3.1 Example of Option List 3.2 Segment Ports Output Specifications ■When segment output is selected ■When DC output is selected 4.1 Creating Segment Option Source File C2XXYYY.SEG ; C2XXYYY.SEG ; LCD SEGMENT DECODE TABLE A20 ■Output specification selection data 4.2 Starting SOG62XX A>SOG62XX_[-H] A parameter enclosed by [ ] can be omitted The current drive must contain the segment option source file (C2XXYYY.SEG) -H: 4.3 Input File Selection (1)*** SOURCE FILE(S) • H option use •H option not use (2)PLEASE INPUT SEGMENT SOURCE FILE NAME 4.4 HEX File Generation and EPROM Selection 4.5 End Procedure S : Syntax error N: Segment number selection error R: RAM address selection error D: Duplication error Each type of error is explained here D:Duplication error Out Port Set Error EVALUATION BOARD S5U1C62xxxE Page EVALUATION BOARD S5U1C62xxxE Page Page 3.1 Precautions for Operation 3.2 Differences from Actual IC ■I/O differences ■LCD differences ■Power-onsequence differences 4.1 Basic Functions ■Program execution (Run function) ■Single-stepprogram operation (Single-stepfunction) ■Program execution suspension at a given address (Break function) ■Displaying program addresses and instruction codes during a break ■LEDs ■ROM sockets ■Connectors LCD #0, #1 4.5 Rear Panel 4.6 Under Bottom Cover 5.1 Connection to ICE (S5U1C62000H) 5.2 Power Cable Connection 5.3 Connection to Target System 6.1 Preparation 6.1.1Creation of target system 6.1.2Creation and installation of ROMs 6.2 Independent Use of S5U1C62xxxE 6.2.1Power on/off 6.2.2Debugging 6.3 Operation When ICE (S5U1C62000H) is Connected 6.3.1Power on/off 6.3.2Debugging ICE CONTROL SOFTWARE ICS62XX Page ICE CONTROL SOFTWARE ICS62XX 2.1 Features 2.2 Connecting and Starting the System 2.3 S5U1C62000H Operation and Functions Display Command Group 3.3 Break and Go Command Group File Command Group ROM Command Group Control Command Group HELP Command ■OPTLD command 2.1 Features 2.1.1Description 2.1.2 Software configuration 2.1.3Function table Table 2.1.3.1 shows the functions supported by the ICE (S5U1C62000H) Table 2.1.3.1 ICE (S5U1C62000H) functions 2.1.4Function-differentiatedcommand list Page 2.1.5Alphabetical listing of commands Page (1)Verify Power OFF Status (2)Cable Connections (3)Power ON PC-DOSversion 2.10 or higher (1)Break enable mode: (2)Break disable mode: (3)Break trace mode: (4)Break stop mode: (1)Reset switch: (2)Break switch: (3)ESC key: (4)Break set command: (1)SYNC Pin Output (2)HALT Pin Output (1)Set break by PC: (2)Set break by RAM data: (3)Set break by register value: (4)Set compound break: 2.3.6Target interrupt and break *PC=0000 A=.... F=.DZC X=000 Y=010 2.3.7History function #H, 1980 LOC 2.3.8Break delay function 2.3.9Coverage function (1) Time counting mode (2)Step counting mode (1)When execution of the trace instruction (T,U) is prolonged (2)When the run is halted and restarted DISPLAY: SET: BREAK and GO: FILE: ROM: DISASSEMBLE LIST DUMP PROGRAM DUMP DATA RAM DISPLAY CPU REGISTER HISTORY DATA DISPLAY DISASSEMBLE LIST Format #L,<address 1>,<address 2 #L,<address 1 Examples #L,<address 1>,<address 2>#L,<address 1 2FF JP C,FF 01FF FFF DUMP PROGRAM #DP,<address 1>,<address 2 #DP,<address 1 #DP #DP,104,121 ADDR ASCII ..0B .....1BD DUMP DATA RAM #DD,<address 1>,<address 2 #DD,<address 1 #DD #DD,80,BE Examples #DD #DD,50,40 #DD,0,7E ADDR 0 1 2 A B C D DISPLAY CPU REGISTER Example #DR #DR *PC=0100 IR=FFF NOP7 A=0 B=0 X=06F Y=03A F=IDZCSP=10 HISTORY DATA DISPLAY #H,<pointer 1>,<pointer 2 #H,<pointer 1 ... Set range displayed 21 lines displayed * Instruction terminates after exceeding last history memory INT1 or INT2 displayed when interrupt only occurs (limited to "LD X,x" and "LD Y,y") HB, HG HISTORY DATA DISPLAY BACKWARD/FORWARD #HB #HG HB, HG #HB#HG HS, HSR, HSW HISTORY SEARCH PC/MEMORY READ/MEMORY WRITE HS, HSR, HSW #HS,<address #HSR,<address #HSW,<address HISTORY POINTER DISPLAY/SET HP, HPS Format #HP #HPS,<history pointer Examples #HP * LOC=2058 CHK CHECK ICE HARDWARE #CHK Examples #CHK * ROM CHECK ERROR 5F=>FF DXY #DXY Examples #DXY X=070 MX CVD, CVR #CVD,<address 1>,<address 2 #CVD #CVR #CVD,100,110 ASSEMBLE PROGRAM FILL PROGRAM FILL DATA RAM MOVE PROGRAM MOVE DATA RAM ASSEMBLE PROGRAM #A,<address (With guidance) A,B B,0A Examples #A,100 LD A,0F #A,200 PUSH XP * ERROR FILL PROGRAM #FP,<address 1>,<address 2>,<program data Examples #FP,0,3FF,FFB #FP,100,200,FF9 #FP,200,100,FFF FILL DATA RAM #FD,<address 1>,<address 2>,<data Examples #FD,60,7E,A #FD,10,2F,0101B #FD,50,1FF,0 MOVE PROGRAM #MP,<address 1>,<address 2>,<address 3 Examples #MP,0,FF,100 #MP,100,2FF,300 #MP,200,100,300 MOVE DATA RAM #MD,<address 1>,<address 2>,<address 3 Examples #MD,10,1F,30 #MD,00,3F,70 #MD,30,20,50 SET PROGRAM #SP,<address Examples #SP,100 FFF: FFF:FFB SET DATA RAM #SD,<address Examples #SD,20 #SD,FFF #SD,70 SET REGISTER #SR #SR,<register name>,<data Evaluation board CPU registers are displayed and modified (1)<data> is set in specified registers SXY #SXY X=040 MX=5: Y=030 MY=A: X=040 MX=5:0 SET HISTORY CONDITION Format #HC,S/C/E Function # Sets up the area for history extraction by means of the break point Examples "[ ]" is added to the break point HA, HAD, HAR #HA,<address 1>,<address 2>/ALL #HAD #HAR,<address 1>,<address 2>/ALL #HAR,ALL Page SET BREAK ADDRESS CONDITION RESET BREAK ADDRESS CONDITION SET BREAK DATA CONDITION RESET BREAK DATA CONDITION SET BREAK REGISTER CONDITION BA, BAR #BA,<address 1>,<address 2>,<address 3>,<address 4 #BAR,<address 1>,<address 2>,<address 3>,<address 4 #BA,100,200,101,1FF #BA,300..3FF BD, BDR #BD #BDR Examples #BD ADDR ---:074 BR, BRR Examples #BR -:C -:1 -:0 SET/RESET BREAK REGISTER CONDITION BR, BRR #BRR A-:0 B-:0 FI -: BM, BMR Examples #BM ----:100 ---:70 -:A SET/RESET BREAK MULTIPLE CONDITION BM, BMR 100: 70:71 A:^ 71:72 BREAK CONDITION DISPLAY Format #BC Examples #BC * BA NONE * BD NONE BRES #BRES #BRES *BA NONE *BD NONE GO TARGET PROGRAM #G,<address #G,R ■Setting the Starting Address ■Break Mode and Break Condition ■Display During Execution of GO Instruction *PC=xxxx ■ Break Display *EMULATION END STATUS = BREAK HIT ... (A) * ON THE FLY ON * BREAK ENABLE MODE * BREAK STOP MODE #G,R *PC=01FF A=5 B=0 X=70 Y=05 F=..ZC SP=20 #T,<address >,<step number>#T,<address #T,,<step number #T,100,3 *PC=0100 IR=FFF A=0 B=0 *PC=01AD IR=xxx HALT *NO HIS TORY DATA SINGLE STEP TRACE & LAST INFORMATION DISPLAY #U,<address >,<step number #U,,<step number Examples #U,100,5 *PC=01AA IR=ADI OR A,B BE, BSYN Format #BE #BSYN Examples #BE #BSYN BREAK TRACE MODE SET #BT (Toggle) Examples #BT * BREAK TRACE MODE BRKSEL #BRKSEL,REM #BRKSEL,CLR #BA,0100 #BRKSEL,REM READ PROGRAM FILE READ DATA FILE VERIFY PROGRAM FILE VERIFY DATA FILE WRITE PROGRAM FILE RF, RFD #RF,<file name #RFD,<file name Examples #RF,C6200A0 #RFD,WORK VF, VFD #VF,<file name #VFD,<file name Examples #VF,C6200A0 FD:ICE WF, WFD #WF,<file name #WFD,<file name Examples #WF,C6200A0 #WFD,WORK CL, CS #CL,<file name #CS,<file name #CS,TEST #CL,TEST OPTLD READ HEXA DATA FILE #OPTLD,0,<file name #OPTLD,0,C2XXYYY LOAD ROM PROGRAM VERIFY ROM PROGRAM ROM TYPE SELECT LOAD ROM PROGRAM Format #RP Examples #RP * NO ROM H/L * NO ROM H VERIFY ROM PROGRAM Format #VP Examples #VP ROM:ICE 0FF:0FC ROM ROM TYPE SELECT #ROM Examples #ROM *ROM 64: INITIALIZE TARGET CPU TIME OR STEP MODE SELECTION ON THE FLY MODE SET QUIT INITIALIZE TARGET CPU Format #I Example #I TIME OR STEP MODE SELECTION TIM #TIM Examples #TIM STEP COUNT MODE OTF ON THE FLY MODE SET #OTF Examples #OTF ON THE FLY OFF QUITQ Terminates the ICS62XX program and returns control to the operating system A waits control by host computer operating system Reloads the ICE ... Epson logo is displayed for about one second Page 3.7 HELP Command #HELP,n (n=1 to 8) Examples #HELP KEY IN 1.8 ENTER OR ENTER ONLY : #HELP,F HELP 1.DISPLAY COMMAND #DP #DD #DR Page Page Error message: * COMMUNICATION ERROR OR ICE NOT READY Meaning: Recovery procedure: * TARGET DOWN(1) ■Description of HEX file format Page MASK DATA CHECKER MDC62XX Page MASK DATA CHECKER MDC62XX Page 2.2 Execution Flow and Input/Output Files (1)Preparation of program data files (C2XXYYYH.HEX and C2XXYYYL.HEX) (2)Preparation of option data files (C2XXYYYF.DOC and C2XXYYYS.DOC) (3)Preparation of melody data file (C28XYYYA.DOC) (4)Packing of data 3.1 Copying the Data File 3.2Execution of MDC62XX 3.2.1Starting MDC62XX A>MDC62XX 3.2.2Packing of data 3.2.3Unpacking of data 4.1 Data Error If there are format problems, the following error messages are displayed 4.1.1Program data error 4.1.2Function option data error * \ sometimes appears as ¥, depending on the personal computer being used The pack file is configured according to the following format: *\ sometimes appears as ¥, depending on the personal computer being used 5.1 Program Data, Melody ROM Data and Scale ROM Data ■ Data line ■End mark :00000001FF 5.2 Segment Data EPSON ELECTRONICS AMERICA, INC - HEADQUARTERS - SALES OFFICES West Central In pursuit of “Saving” Technology, Epson electronic devices Our lineup of semiconductors, liquid crystal displays and quartz devices assists in creating the products of our customers’ dreams Development Tool Reference Manual