Home

RA75X ASSEMBLER PACKAGE PC-9800 Series (MS

1. 327 A 6 List of Librarian Converter Options 327 APPENDIX MAXIMUM CAPABILITIES 329 APPENDIX C POINT FOR ATTENTION J J U J 331 APPENDIX D SAMPLE PROGRAMS J J 333 DI 1 15 0 334 D2 Execution Examples kukaa 337 SU Lu c 339 PPPENDIX E INDEX me 363 di o 363 16 x X X XX X X Figure No 1 1 1 2 1 3 1 4 1 5 1 6 1 7 1 8 1 9 1 10 1 11 1 12 1 13 1 14 1 15 1 16 3 1 3 2 4 1 8 1 8 2 9 1 10 1 10 2 10 3 10 4 10 5 10 6 10 7 10 8 10 9 LIST FIGURES RA75X Assembler Package Assembler Flow Development Process for Products Using Microcomputers Software Development
2. a 82 5 1 Linker Input Output Files 120 5 2 Segment Relocation Attributes and Location Adjustmenti 125 5 3 Kinds of Linker Options r 144 6 1 Object Converter Input Output Files 182 6 2 Object Converter Option Types 191 7 1 Librarian Input Output Files 202 8 1 List Converter Input Output Files a 236 8 2 List Converter Option TY PCS uuu uuu u 244 9 1 Library Converter Input Output Files r 254 9 2 Types of Library Converter Option nnne 257 10 1 Option Setting Dialog Box Functions Assembler 263 10 2 Source File Options Setting Dialog Box Functions 265 10 3 Options Setting Dialog Box Functions Linker
3. 267 10 4 Options Setting Dialog Box Functions Object Converter 269 18 CHAPTER 1 GENERAL DESCRIPTION Describes the role of the assembler package in 75X Series and 75XL Series development etc together with a general outline of its functions 19 CHAPTER 1 GENERAL DESCRIPTION 1 1 Outline of Assembler RA75X Assembler Package referred to in the following text simply as assembler package is the generic name for a series of programs for converting source programs written in 75X Series and 75XL Series assembly language into machine language The Assembler Package includes 7 programs Structured Assembler Assembler Linker Object Converter Librarian List converter and Library Converter Figure 1 1 RA75X Assembler Package Structured Assembler Program Assembler Program Linker Program RA75X AssemblerPackage Object Converter Program Librarian Program List Converter Program Library Converter Program 20 CHAPTER 1 GENERAL DESCRIPTION 1 1 1 The function of an assembler 1 Assembly language and machine language Assembler language is the most basic programming language for microprocessors To operate a microprocessor a program and data are necessary This is programmed by a human being and memorized in the memory of the microcomputer Programs and data which a microcomputer can handle are collecti
4. PHE nQ 272 278 281 282 339 I Say uuu 41 43 59 61 P F OptON ASS OMIBICN UU X 78 95 324 P option linker U UU as 144 147 325 PAGE SCONO i lu a EE OE to o E 125 uuu u nr eee 70 71 120 121 192 236 IG SV PMID OI Nr P X P 121 145 278 280 R E 144 161 325 s O IO TU u cS 144 161 325 R option object converter e 191 204 326 MOETO 42 murice m T 42 RAOK OM 42 Random inkage MOJE pA 128 Relocatable assembla Uus Em 26 Relocatable object code 122 133 x U 124 Rima tect m ec nee ele ogee cre dete ete 219 326 S O option uuu uuu u u uu ua n 78 103 32
5. 932 Execution start and end message 9 3 3 Library converter error processing 9 3 4 Library converter end status NEP RET Library Converter Options LLULLU LIL II Sasa saakiaqkaaunaaaauwawaqusq 9 4 1 Types of library converter option 9 4 2 Specifying the library converter option 9 4 3 Priority order of library converter options 9 4 4 Library converter option explanation 2 CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER 10 1 Setting Options from the Project Manager Jl u h KM 10 13 Object COnVerl r u uuu uu CHAPTER 11 PROGRAM OUTPUT LISTS Assembler Output Lists ILLL Asemblylisluu xr uuu HR 15 EE opo
6. a ara 78 193 324 NP option linker T 144 148 325 NR option object converter a r 191 194 326 NS option 78 113 324 NS option object converter NENNT E T EI 191 192 326 zb TAB ODON 1 2 uu uu E Ur 239 Normal termination 1 a n re esie ns 76 142 143 189 190 241 256 O O option 78 88 324 365 APPENDIX INDEX O option library a aa arrrssssssssssssssssssssssssssssssssssssa 191 197 326 uuu uuu uuu T Uu T 257 258 327 ODIO MINK Gl ER 144 175 325 OPTION GN leer CO D uuu UU UL TT 191 197 326 C gt ju uuu S P 239 CSC COC uuu uu u uu 42 59 63 181 ObDjectconvener OPUONS u ee ul uu m 183 191 326 Qh Sol mOd l amp u uuu uuu ull 124 Object module file l u u uu U u uu uuu uuu uu ere eee 70 71 120 123 236 ORG pseudo instruction R 72 330 OT qe
7. u 291 CHAPTER 13 ERROR MESSAGES ua III Ila sassa 293 19 1 Assembler s Error Messages 294 13 2 LINKERS Error Messages J 306 13 3 Object Converter Error Message 313 13 4 Librarian Error Messages 317 13 5 List Converter Error Messages 321 13 6 Library Converter Error Messages J 322 APPENDIX A LISI OF OPTIONS vade cua ausu 323 List of Assembler Options nium aviae uidi aie 324 A2 LiSLIGOILinkKer OBII6IIS uq 325 List of Object Converter Options 326 A 4 List of Librarian Subcommands J T T T 326 List of Converter Options
8. a 8 2 4 Points to note when using the list converter amp 3 LisrGoriverler Start Method sinp A iran pda cu rea 8 3 1 List starting the list CONVINCE ger ieii tears 8 3 2 Execution start and end messages 8 3 3 List converter error handling 8 3 4 List converter termination status ListConv rnter OBIIoRS uuu iS aaah 8 4 1 Types of list converter optlofiS u u LLL 8 4 2 List converter ODONIS uu bI E AT CHAPTER 9 LIBRARY CONVERTER 91 Library Converter Input Output Files J J J 9 2 Library Converter Functions 93 Starting the Library Converter 9 3 1 Starting the library converter
9. s 125 B F TJ C u u D m M 291 BR P cudo iN gee 38 Branch instruction optimization function BR uuu u u 38 T us u us S aires panos Gea n 135 Li ich i bie Tiri EE OR 121 145 278 281 Branch tables NUMDET OT u uuu u uu u uuu oom 38 330 C C Option assembl r u uuu m cnm 78 82 324 CA ODUON METTRE Tm 78 102 324 GD option Id u 144 159 325 Command file 41 43 59 61 COTS TAL u 80 RIN x OU 60 CREATE 211 326 Esca cidit c EET 272 276 346 D D Oplionn uuu uuu u uu T mn 78 104 324 DATE On S sS ns SS S SSS SS 207 208 oe sco tare gee S 216 326 E E option assembler a 76 97 324 E option object converter 1
10. Function e The DELETE subcommand specifies that one or more modules in an existing library file are to be deleted Use e The DELETE subcommand is specified when it is wished to delete one or more modules which are no longer needed from a library file Description The library file name specified is the name of the library file containing the module s to be deleted e The module name specified is the name of the module to be deleted from the library file Caution The specified module must exist in the library file Example Example 1 Modules M1 and MG are to be deleted from the library file 75XTEST LIB Before deletion 75XTEST LIB 216 CHAPTER 7 LIBRARIAN DELETE delete Description format DELETE 75XTEST LIB 1 lt After deletion gt 75XTEST LIB Only module M2 remains in the library file Example 2 Module AD SUB is to be deleted from existing library file 75 1 First the contents of the library file are checked LIST 75XTEST LIB 75X Series Librarian VX XX DATE LIB FILE NAME 75XTEST LIB 1 AD MAIN UPDATE O0 RA75X VX XX UPD75106 2 AD SUB UPDATE O0 RA75X VX XX UPD75106 NUMBER OF MODULES 2 c2 Module AD SUB is deleted DELETE 75XTEST LIB AD SUB 217 CHAPTER 7 LIBRARIAN DELETE delete lt 3 gt The contents of library file 75XTEST LIB are checked LIST 75XTEST LIB 75X Ser
11. en ee 275 11 1 3 Cross reference 15 276 i j OPO 277 EISi LL e S 278 11 21 Pmkeropipnillilu 278 1h22 input output module St uuu ULU uuu uuu u lll u DUE degna Roos e a aU A DRE 279 112 9 Segmemuilinkimapilstu UU Eeee aus e EEES EE EAEE EER ROSES 280 11 2 4 Branch table 281 11 2 5 Public symbol list symbol table list eo nune nay 282 TLS Libi imi 283 EC MEE S oca R MUS mmm 283 11 4 List Converter Output List J J 284 1141 Absolute assembly ISt uuu nica dade Ei bu usn Ui Ca bu 284 CHAPTER 12 EFFECTIVE USE OF THE ASSEMBLER 287 12 1 How to Utilize Parameter File 288 12 2 Use ofthe EIST CONV GION 289 1223 Finding Error ICS u U LLL 290 12 4 Example of Use of Batch File
12. Description of assembler options nennen nnne nnns Librarian Input Output Files J T T Librarian Functions 7 2 1 7 2 2 Mod le tttm Library file editing x 239 Printung OF library file u UU U ULU UU uu usss S Eis cu hnbcudilqn m 7 3 1 taring rre libra u u uuu E uuu t UR 792 2 Subcommand input in conversational 7 3 3 Subcommand file 7 3 4 Execution start and end messages 7 3 5 e Oia u 7 4 Description of Subcommandss CHAPTER B OST CONVERTER uuu u S ukasa DNI ODE MEN NN 8 1 List Converter Input Output Files J J 52 ec 8 2 1 Incorporation of location addresses nib ssmP tup 8 2 2 Incorporation of object code 8 2 3 List converter processing method
13. User s Manual RA75X ASSEMBLER PACKAGE PC 9800 Series MS DOS Based PC AT DOS Based Version 5 xx Operation Target Devices 75X Series 75XL Series Documen t U12622bEJ6VOUMJl1 6th edition Previous No EEU Date Published January 2001 N NEC Corporation 1990 Printed in Japan MEMO FIP is a trademark of NEC Corporation EEPROM and V30 are trademarks of NEC Corporation MS DOS and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and or other countries IBM DOS PC AT and PC DOS are trademarks of International Business Machine Corporation Pentium is a trademark of Intel Corporation The information in this document is current as of September 1997 The information is subject to change without notice For actual design in refer to the latest publications of NEC s data sheets or data books etc for the most up to date specifications of NEC semiconductor products Not all products and or types are available in every country Please check with an NEC sales representative for availability and additional information No part of this document may be copied or reproduced in any form or by any means without prior written consent of NEC NEC assumes no responsibility for any errors that may appear in this document NEC does not assume any liability for infringement of patents copyrights or other intellectual property rights of third
14. 18 F file name Parameter file specification Read all the options and file names from the command line CHAPTER 4 ASSEMBLER Table 4 2 Assembler Options 2 2 LH Description Format Function Category Default Interpretation Ypath name Specifies the device file search path It searches in the sequence of the DEV path with respect to the RA75X starting path the RA75X starting path the current directory and the path set in the environ ment variable PATH Remark Options can be written in either upper or lower case characters 79 CHAPTER 4 ASSEMBLER 4 4 2 Assembler options specification method Assembler options are specified in the command line when the assembler is started or in a parameter file In addition certain assembler options can be specified by a control instruction which corresponds to the module header of the source module until a comment mnemonic or pseudo instruction appears in the source module The assembler options shown below can be specified by using a control instruction in in the module header It is convenient to use these options to specify in the module header those items which must always be specified each time assembly is performed C PROCESSOR or PC CA or CA NCA or NOCA G DEBUG or DB NG NODEBUG or NODB GA DEBUGA or DA NGA NODEBUGA NODA J GENERATE or GEN NJ NOGENERATE or NOGEN
15. Modefy AUTOEXEC BAT Select the way to modify AUTOEXEC BAT Modify AUTOEXEC BAT The original AUTOEXEC BAT is saved as AUTOEXEC OLD Modify by yourself AUTOEXEC SMP is made on root directory as a sample b If Installer will modify automatically is selected the AUTOEXEC BAT file on the disk where the Windows directory is located will be rewritten and the original file will be saved with the name AUTOEXEC OLD 56 CHAPTER 3 ASSEMBLER PACKAGE EXECUTION c If Modify it manually later is selected AUTOEXEC SMP will be created in the root directory sample to help you modify the AUTOEXEC BAT file If AUTOEXEC SMP already exists the following contents will be added to it REM nec tools installer PATH a nectools bin PATH lt 10 gt Finish installation a The following message is displayed Select OK to terminate the installation Setup Successful Installation is complete You will need to restart computer so that the new settings can take effect b Restarting the Host Machine Remark If you cancelled the installation in the middle the following message will be displayed Press Continue C to return to the dialog box where you selected Exit E Setup stoped Setup is not completed Select Exit E to display the next message Select OK to close the installer Setup terminated accidenta
16. Code symbol DATA Data symbol NUMBER Constant symbol PBIT Port bit symbol MACRO Macro Symbol value shown as 4 hexadecimal digits A Absolute symbol H Relocatable symbol Symbol attributes Symbol relocation attributes EXT External reference symbol name Symbol reference format PUB External definition symbol name lt 8 gt A Local symbol name 9 Additional symbol information Label symbol Definition segment name Blank for absolute segment Name symbol Definition segment name Blank for constant symbol Segment name Link attribute and location attribute Others Blank 10 Definition reference statement number in decimal notation on the left of the number indicates a definition statement number 276 CHAPTER 11 PROGRAM OUTPUT LISTS 11 1 4 Error list Only error line and error messages resulting from assembly are output in the error list Output Format a asm 1 001 SYNTAX ERROR lt 1 gt lt 2 gt 3 4 Descriptions of Output Items Input file name Input file line number Error message number shown as 3 decimal digits See 13 1 for the Hau E of the message numbers Error Emormessage 277 CHAPTER 11 PROGRAM OUTPUT LISTS 11 2 Linker Output List The file name creates the following lists in the link list file Link List File Linker option list e Input output module list Segment li
17. Function The NTB option notifies the linker that automatic creation of branch tables is not to be performed Use If linkage is aborted with an FO12 BRANCH TABLE OVERFLOW error linkage should be performed again with the NTB option specified Description 172 In order to perform automatic branch table creation processing the linker records provisional branch table uniformly for all BRCB instructions other than those for which the object code was determined during assembly which branch from an absolute address to an absolute address Then only those branch tables which are really necessary are created when segment location addresses are determined Therefore it may happen thatthe number of branch tables recorded temporarily during linker processing exceeds the maximum number of approximately 1 000 even if branch tables are not actually created with the result that the linker aborts If the NTB option is specified the linker does not create branch tables automatically and therefore linkage will not be aborted with an 012 BRANCH TABLE OVERFLOW error Also as the number of branch tables approaches the maximum of approximately 1 000 the generated object efficiency becomes extremely low If linkage is performed with the NTB option specified an error will result if the branch destination of a BRCB instruction is not in the same block In this case the relevant BRCB instructions should be rewritten as 3 byte br
18. omm 78 86 324 MOPON INKE T umu 144 146 325 NI UNO Soc ies ec ates nein alee s Sm a S 79 2 eee 26 213 N NE option assembler a 78 97 324 NG option assembler NER T T c s 78 111 324 NGA option ass mDI r uuu U T Tm 78 94 324 N r option ass embia ew Rem 78 90 325 NJ OPUOM INKT L L l T E 144 175 325 NKA Option UU UU 98 112 324 NKL Option INKET m Tu 144 175 325 NKM option linker TOT 78 112 324 ANEP ODIOM INKET uuu u u u u m cuu 144 155 325 NKG OOO MOSS 21116 5 3 u uu uuu u u uuu 144 150 325 ooo uuu uuu tau aus sswsssaszsesussesiassassasanansaQhasaupayassasphyussqhasQasuusapas 144 154 325 SG SSsaembi6r uuu uuu Umm ms 78 88 324 NO option object convener 191 197 326 NGOPUR 11 512 eee 144 174 325 NP option assembler
19. 341 APPENDIX D SAMPLE PROGRAMS b 75XTEST2 ASM assembly list Output to 75XTEST2 PRN 75X SERIES ASSEMBLER VX XX A D CONVERT VX XXSUB XX XX XX PAGE X COMMAND 75 2 C106 KS KX STNO ADRS R OBJECT 1 2 3 4 5 6 7 8 9 10 11 12 13 0000 9907 14 0002 9922 15 0004 9911 16 0006 E A200 17 0008 E 00 18 0009 92E4 19 000 89EE 20 0000 92 0 21 000 9906 22 0011 23 24 25 26 27 0000 9907 28 0002 00 29 0003 8BD3 30 0005 89 31 0007 93CO 32 0009 9040 33 000 A3CO 34 0000 9206 35 OOOF 36 0010 CO 342 IC MAC SOURCE STATEMENT TITLEZ A D CONVERTER VX XX SUB ak lt lt lt K K K lt lt lt lt lt lt lt lt lt K K K K lt lt lt lt KK e e e lt K K K x lt K K K lt lt lt lt K K K K lt e e K K lt lt lt lt lt lt lt 3 ias A D CONVERT PROGRAM wes NAME AD SUB EXTRN CODE SEL15 EXTRN PUBLIC SIOSUB ADCONV STKLN 2 a SIO SUB ROUTINE SEG4 CSEG SENT SIOSUB PUSH BS SEL RB2 SEL MB1 MOV XA TDATA SEL15 SSEL MB15 MOV SIO XA MOV XA 11101110B MOV SIOM XA CLOCK 262KHZ MSB POP BS RET ANALOG INPUT RBE 0 SEG5 CSEG SENT ADCONV PUSH BS GETI SEL15 SEL MB15 MOV HL 0D3H MOV XA 0COH MOV BSBO A BSBO lt LOOP SET1 BSBO L MOV A BSBO MOV PTHM COMP START MOV A 0AH 18 MACHINE W
20. NUMBER OF PUBLIC SYMBOLS 5 CHAPTER 7 LIBRARIAN REPLACE Example 3 lt 1 gt The contents of the library file 75XTEST LIB are to be checked LIST 75XTEST LIB PUBLICS 75X Series Librarian VX XX DATE LIB FILE NAME 75XTEST LIB 1 AD MAIN UPDATE O0 RA75X VX XX UPD75106 SEGO SEG1 SEG2 SEGS SEG15 TDATA NUMBER OF PUBLIC SYMBOLS 6 AD_SUB UPDATE RA75X VX XX UPD75106 ADCONV SEG4 SEG5 SIOSUB NUMBER OF PUBLIC SYMBOLS 4 NUMBER OF MODULES 2 replace 225 lt 2 gt CHAPTER 7 LIBRARIAN 75XTEST1 ASM is assembled after rewriting as shown below TITLE A D CONVERTER VX XX skkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk J A D CONVERT PROGRAM NAME MAIN EXTRN CODE ADCONV CODE SIOSUB CODE HEIKIN PUBLIC TDATA SEL15 STKLN 10 VENTO MBE 1 RBE 1 MAIN VENT4 1 0 ADCONV SEGO DSEG 1 AT 10H TDATA DS 2 GETI TABLE x SEG1 CSEG IENT SEL15 SEL MB15 ROUTINE Bs SEG2 CSEG INBLOCK MAIN SEL RB1 GETI SEL15 STACK POINTER SET MOV XA STACK MOV A 0011B MOV 0011 d DATA RAM 0H 13FH ZERO CLEAR x SEL MB1 MOV HL 3FH MOV XA 00H LOOP1 MOV HL A 100H 13FH DECS HL BR LOOP SEL MBO LOOP2 MOV HL A OH FFH DECS HL BR LOOP2 226 replace CHAPTER 7 LIBRARIAN REPLACE TIMER SET SAMPLING TIME 30 MSEC FXX 4 19 MHZ MOV MOV MOV MOV
21. Name of symbol defined in module left justified Symbol type MODULE In case of module name left justified PUBLIC In case of symbol SYMBOL In case of intra module symbol 282 CHAPTER 11 PROGRAM OUTPUT LISTS 11 3 Librarian Output List The librarian outputs a list of library file information by means of the LIST subcommand See 7 4 5 LIST for the list output destination 11 3 1 Library file information list Output Format 75X Series Librarian Vx xx DATE lt 1 gt PAGE lt 2 gt LIB FILE NAME 3 lt 4 gt lt 5 gt M lt 8 gt lt 9 gt lt 6 gt lt gt UPDATE lt 10 gt lt 11 gt This is output for each SS 6 module NUMBER OF PUBLIC SYMBOLS lt 14 gt NUMBER OF MODULES lt 15 gt Note The area enclosed by a broken line is only printed when there is a PUBLICS specification Descriptions of Output Items System date Output list page number decimal notation Library file name Library file creation date Library file update date PUBLIC symbol name 283 CHAPTER 11 PROGRAM OUTPUT LISTS 11 4 List Converter Output List The list converter outputs the absolute assembly list 11 4 1 Absolute assembly list In this list the actual values determined by the linker are incorporated in the assembly list part excluding the symbol list and cross reference list in the assembly list file output by the assembler Out
22. caaiiseancianeutscummmbuclanrats 5 4 5 4 1 Discrete mo ORT 5 4 2 Linker option specification method 5 4 3 Linker Option priority Order u ur uu u uuu u u u u uu 5 4 4 Description of linker options CHAPTER 6 OBJECT CONVERTER 6 1 Object Converter Input Output Files eere rere nennen 6 2 Object Converter Functions T 6 2 1 HEX format object module file format 6 2 2 Symbol table file 6 3 Object Converter Initiation Method J J 6 3 1 Starting the object converter a a
23. 1 3 6 Caution on homonymous segments If there are two or more segments with the same name in a single source module list conversion may not be performed correctly Ensure that all segments in a source module have different names when using the list converter 1 4 Assembler Package Features 38 The assembler package features the following functions 1 2 3 4 Branch instruction optimization function BR An automatic branch instruction selection pseudo instruction BR pseudo instruction is provided To create a program which makes efficient use of memory it is necessary to use a 1 byte or 2 byte branch instruction according to the branch destination range However it is very tedious to take account of the branch destination range in writing each branch instruction When the BR pseudo instruction is used the assembler generates the appropriate branch instruction code for the branch range concerned This process is referred to as optimization VENTn pseudo instruction 75X series and 75XL series products have an interrupt vector table in the area from address OH to address OFH as a maximum depending on the device The start address of each interrupt service routine and the value of MBE memory bank enable flag and RBE register bank enable flag during interrupt servicing are set in this interrupt vector area The VENTn pseudo instruction is provided to facilitate the setting of values in this vector table TBR
24. 6 3 2 Execution start and end messages 2 4444 88 6 3 3 Object converter error 6 3 4 Object converter termination status 6 4 Object Converter Options 6 4 1 Types of object converter options r 6 4 2 Object converter option specification method 6 4 3 Object converter option priority order 6 4 4 Description of object converter options CHAPTER 7 LIBRARIAN 14 4 4 7 1 7 2 4 3 2 4 3 3 4 3 4 Assembler Options 4 4 1 4 4 2 4 4 3 4 4 4 Execution start and end messages Assembler error handling NU uPSMUMMdE EMIT SET EEUU Assembler termination Status Types of assembler options Assembler options specification method Assembler options priority order
25. CHAPTER 1 GENERAL DESCRIPTION 1 2 7 List converter The list converter has as input the assembly list file of relocatably assembled modules the object module file and the load module file output by the linker and incorporates actual address values and object code in a relocatable assembly list It then outputs the results as an absolute assembly list The list converter is designed to enable relocatable assembled programs to be debugged more efficiently Figure 1 15 List Converter Function Assembly list file relocatable Object module file Load module file List converter LCNV75X Absolute assembly list file 35 CHAPTER 1 GENERAL DESCRIPTION 1 2 8 Library converter The Library Converter outputs library files which can be input to Version 5 00 or subsequent versions of Linker and Librarian when object program module format library files output by the Librarian in a version of RA75X Assembler Package earlier than Version 5 00 are input Figure 1 16 Library Converter Functions Object module format library files from a version earlier than Version 5 00 Library converter LBCNV75X Library converter output library file 36 CHAPTER 1 GENERAL DESCRIPTION 1 3 Before Beginning Program Development The following restrictions should be noted before beginning actual program development 1 3 1 Assembly time source statements Source statements up to 220 characters in length including a
26. CHAPTER 1 GENERAL DESCRIPTION The software development process is described in somewhat more detail by Figure 1 4 Software Devel opment Process Figure 1 4 Software Development Process Software development Program specification creation gt Flowchart creation editing Assembly YES Eros Debugging System evaluation 2 7 m 62 Using 75X series and 75XL series assembly language Creates source module file using editor Creates HEX format object module file Operation check using hardware debugger IE 75000 R 91 IE 75001 R 75 Heote 2 Notes 1 Maintenance product not available for purchase 2 Discontinued not available for purchase 23 24 CHAPTER 1 GENERAL DESCRIPTION We shall now apply the assembler package to the assembly process Figure 1 5 Assembly Process of This Package From source module editing Assembly Assembly errors Object module file output To source module editing Load module file output To debugging ee HEX format object module file output Remarks As necessary use the structured assembler preprocessor librarian list converter or library converter 1 Structured assembler preprocessor Program for implementing structured programming in assembly language 2 Librarian It is convenient to librarize general purpose modules with a clear interface by means of the lib
27. CHAPTER 2 PRODUCT SUMMARY Gives the file names of the programs provided in the assembler package and describes the program operating environment etc CHAPTER 3 ASSEMBLER PACKAGE EXECUTION Describes the actual execution procedure for each of the programs in the assembler package using sample pro grams CHAPTER 4 ASSEMBLER CHAPTER 5 LINKER CHAPTER 6 OBJECT CONVERTER CHAPTER 7 LIBRARIAN CHAPTER 8 LIST CONVERTER CHAPTER 9 LIBRARY CONVERTER Explain in detail the functions of each program in the assembler package assembler linker object converter librar ian list converter library converter and how to run them CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER Explains setting of options from the Project Manager used when running the Assembler Package in Windows 11 PROGRAM OUTPUT LISTS Describes the format of the various lists output by the assembler package programs CHAPTER 12 EFFECTIVE USE OF THE ASSEMBLER PACKAGE Introduces way of using the assembler package effectively CHAPTER 13 ERROR MESSAGES Describes the error messages output by the assembler package programs APPENDIX The appendices include a list of program options sample program list maximum performance table and list of points for attention Reading the manual Readers wishing to actually use the assembler package should read Chapter 3 Assembler Package Execution Readers who have a general understanding of assemblers o
28. Language Document No U12385E referred to in the text simply as language should therefore be read this manual This manual applies to assembler package version 5 XX products Structured Assembler Program Assembler Program Linker Program RA75X Assembler Package Object Converter Program Librarian Program List Converter Program Library Converter Program Readers This manual is intended for users who are familiar with the functions of and method of writing source programs for the microcomputer 75X series and 75XL series subject to development Target devices The assembler package can be used for software development on the microcomputers shown below 75X Series lt 75X Series gt Ps Evaluation chip uPD75000 75000A General purpose series General purpose 75004 75006 75008 75P008 General purpose A D converter 75028 75036 75P036 75064 PD75066 75068 75P068 General purpose A D converter uPD75048 75P048 EEPROM Control series Control 75104 75106 75108 75112 75116 75104A 75108 75P108 75P108B 75P116 Low voltage high speed control BPD75108F 75112F 75116F F product low voltage capability LuPD75116H 75117H 75P117H FIP drive series FIPTM grive 1 PD75206 75208 75212A 75216A 75217 75218 75 216 75P218 75268 75CG208 75CG216A FIP drive A D converter 75236 75237 75238 75P238 LCD drive series LCD drive 1 75304 75306 75308 75304B 75306B 7
29. Message Checks correct file name then re execute Confirm program start method then re execute Check correct file name then re execute Program processing Checks start line syntax then halts processing and returns control to OS Error No File specification conflicted file name Error No Illegal file specification file name A008 Input or output file specification overlaps A009 Specified output file cannot be created Program processing Checks start line syntax then halts processing and returns control to OS Check correct file name then re execute Check remaining disk capacity etc Error No Input file specification overlapped file name A007 Overlapping input file specification Program processing Checks start line syntax then halts processing and returns control to OS Error No Directory not found file name A010 Nonexistent drive or directory is included in output file name Program processing Checks start line syntax then halts processing and returns control to OS Error No Illegal path option Program processing Checks start line syntax then halts processing and returns control to OS Program processing Checks start line syntax then halts processing and returns control to OS Check correct file name then re execute Error No Unable to make file file name Check correct file name then re execute A011 Cause Item other than path name is specified in option in which path name should be speci
30. See 4 5 3 STKLN for details Description e The reserved word STACK has a value which indicates the address maximum address of stack segment 1 e When the stack segment is located automatically in the linkage processing the reserved word STACK is assigned the address value maximum address of stack segment 1 by the linker f the value of STACK is specified by the SK option when linkage is performed the stack segment is located in the low address direction starting at the address address specified by SK option 1 See 5 2 2 3 Determination of stack segment location address for details of stack segment location Data memory bank 0 OH Stack segment d Value of reserved word STACK FFH 168 CHAPTER 5 LINKER SK stack The specified address must be an even address in the range to 100H and can be specified in binary octal decimal or hexadecimal notation e The SK option can only be specified once e The stack segment can only be located in bank 0 Examples Example 1 When the SK option is omitted A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK The stack segment is located automatically MAP OF ROM AREA LENGTH MODULE SEGMENT AD_MAIN AD_MAIN 169 CHAPTER 5 LINKER SK stack Example 2 When the SK option is specified A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK SKOAOH The sta
31. d Error No Illegal path option 011 Cause Item other than path name is specified in option in which path name should be speci fied as parameter Program processing Checks start line syntax then halts processing and returns control to OS Check correct file name and option name then re execute 099 C option M option has not been specified Program execution is halted Specify C option or M option 295 N CHAPTER 13 ERROR MESSAGES Assembler s Error Message cont d Error No A100 Message NO OVERLAY FILE overlay file name Overlay file has not been found Cause Program processing Program execution is halted User action Check that overlay file is in executable format and is in same directory and same drive ILLEGAL OVERLAY FILE VERSION overlay file name Overlay file version is incorrect Error No A101 Message Cause Program processing Program execution is halted User action Check that overlay file version is correct MACRO MEMORY OVERFLOW CANNOT DEFINE MACRO Insufficient memory to record macro Error No A102 Message Cause Program processing Program execution is halted User action Partition the program and re execute PARAMETER REPLACEMENT OVERFLOW More than 128 formal parameter substitutions Error No A103 Message Cause Program processing Program execution is halted User action Check that the
32. fied as parameter Program processing Checks start line syntax then halts processing and returns control to OS Check correct file name and option name then re execute 313 CHAPTER 13 ERROR MESSAGES Object Converter Error Messages cont d Error No Missing parameter option A012 Necessary parameter has not been specified Program processing Checks start line syntax then halts processing and returns control to OS Error No Out of range option A014 i Check correct option syntax then re execute Parameter syntax is incorrect Program processing Checks start line syntax then halts processing and returns control to OS Check correct option syntax then re execute Number of parameters exceeds limit A019 F option is included in parameter file gt Error No Illegal parameter option A016 Error No Memory allocation failed 021 Check correct option syntax then re execute Memory block acquisition has failed Error No Option is not recognized option A018 Program processing Checks start line syntax then halts processing and returns control to OS Error No Too many parameters option A017 Program processing Checks start line syntax then halts processing and returns control to OS Check mounted memory capacity and whether there are resident programs etc Error No File name Illegal processor type A100 The target assembly or compilation product is not
33. 113 324 js gg eg u u 222 125 INBLOCK SegImant L UU U uuu ussasssssbsssstasasskantusassanqtalassqieusoustususkkaqpukussskusausssahascuastashaskuspupassasquacunssahusa 125 INBLOCKA Segment 125 E s 2 erento m s 60 113 114 uuu nen uuu Emm 60 TCI TMS 121 output module enc E R E E 145 278 279 J aJ Ophion G Sc uuu u u T rt 68 110 324 J option linker 144 175 325 K KA Opiom u L ua sunsu mmm 78 112 324 OOM ii T T eem 144 155 325 KM optior u u ULU U LL u 144 149 325 FP SOO uu x E a az 144 153 325 KS option 78 99 324 KX option assembler m 78 102 324 L s option HSE CONVENE u LLULLU 244 245 327 L pO TO Ue Mate u uuu Lu NT m UU Em 78 105 324 LT option assembler u 78 111 324 364
34. KS SYMBOLS or SB NKS NOSYMBOLS NOSB KX XIREF or XR NKX NOXREF or NOXR LL PAGELENGTH or PL LW PAGEWIDTH or PW LT TAB or TB M MODE or S SYMLEN or SL NS NOSYMLEN or NOSL The control instructions is specified in the module header of the source module as shown below control instruction m One option can be specified on one line Multiple control instructions cannot be specified on one line is specified in the first column Example To specify a control instruction in the module header of a source module SYMBOLS XREF TITLEZ A D CONVERTER ak cc e ck e e lt lt lt lt lt lt e K K K K lt lt lt lt lt lt lt lt K K K K e lt lt lt lt lt e e k e e k lt lt lt lt lt lt aa A D CONVERT PROGRAM lt e e lt lt e lt lt lt lt lt lt lt lt K K K lt lt lt lt lt lt lt lt K K K lt lt lt lt lt lt lt lt lt k K lt lt lt lt lt 80 CHAPTER 4 ASSEMBLER 4 4 3 Assembler options priority order 1 If multiple identical options or options of the same kind are specified in the command line the option specified last is valid 2 the same or same kind of option is specified in the parameter file and in the command line the command line option is valid 3 If another special assembler option is specified among assembler options
35. OO NUMBER m Pr _ 185 CHAPTER 6 OBJECT CONVERTER Example 04 AD_MAIN 0201105 0 010020SEG1 010050SEG2 010046SEG3 010020SEL15 020110TDATA lt 010046HEIKIN O83EF1IETO 010060LOOP1 010066 2 010079LOOP3 01007DLOOP4 010048LOOP5 010050MAIN 083EC1MBE 2 O83ECORBE 020 805 O20FAOTMO O20FA6TMODO AD_SUB 010022ADCONV 01000ASEG4 010022SEG5 01000ASIOSUB 020FCOBSBO 01002BLOOP O20FD4PTHO O20FD6PTHM 083ECORBE O20FE4SI0 O20FEOSIOM 010032WAIT 186 CHAPTER 6 OBJECT CONVERTER 6 3 Object Converter Initiation Method 6 3 1 Starting the object converter The object converter is started by inputting the following command in the format shown in the OS command line X gt OC75X option input file name option e X indicates the current drive input file name is the name of the load module file to be converted The drive name directory name etc can be added to the input file name Example OC75X B 75XTEST LNK OC75X C USER NEC 75XTEST LNK option is a string of 1 to 2 letters beginning with the symbol and may be followed by parameters Options can be written before and after the input file and if there are multiple options they can be written in any order However if multiple identical options or options of the same kind are written in some cases an error is generated and in some cases the last output specified is valid See 6
36. PL Function e The LIST subcommand specifies that information on modules in the library file are to be output to the list file Use The LIST subcommand is specified when it is wished to obtain information on modules recorded in a library file Description e The name of the library file for which information is to be printed is specified as the library file name f only information for a specific module is to be printed the relevant module name is specified in parentheses f a module name is not specified information all the modules in the library file is printed out e The name of the file to which the print information is to be output is specified as the list file name The following can be specified as the list file name PRN Output to printer CON Output to console If information on PUBLIC symbols defined in the module is to be output PUBLICS is specified PUBLIC symbols are symbols declared by the assembler PUBLIC pseudo instruction 230 CHAPTER 7 LIBRARIAN LIST list e Output information is as shown below Library information Creation date update date e Number of recorded modules Module information Module name e Creation program name e Recording date update date e Number of updates e PUBLIC symbols defined in module Number of PUBLIC symbols Caution If the list file name is omitted the information is output to the console Example Exa
37. Primary name of assembly list file and object module file output by assembler ete Name of load module file output by linker Nete Notes 1 The file type LNK should also be specified 2 filetype of the assembly list file and the object module file must be PRN and REL respectively 3 The name of the file to which the absolute assembly list created by the list converter is to be output should be specified If omitted a specified by file is output with the primary name file type P 4 L and O can be specified in any order Caution Spaces may not be inserted between options and file names 241 CHAPTER 8 LIST CONVERTER 8 3 2 Execution start and end messages 1 Execution start message When the list converter is started a start message is displayed on the console List Conversion Program for RA75X VX XX KX Xxx XX Copyright C NEC Corporation 1986 1997 After that when the list converter then asks for input file names in conversational mode specify the appropriate file 2 Execution end message f processing terminates normally the list converter outputs the following message to the console and returns control to the OS Conversion complete e Ifa fatal error is detected during processing which prevents the conversion processing from continuing the list converter outputs a message to the console stops execution and returns control to the OS Example If there is an error in the
38. an error will result Individual options and input file names should be separated by spaces TABs or Line Feed characters A parameter file description cannot be split over a number of lines The 5 and symbols are treated as comment marks in the parameter file Characters from these characters to the end of the line are regarded as a comment 251 CHAPTER 8 LIST CONVERTER F parameter file name Examples Consider a parameter file 75XTEST PLV with the following contents PARAMETER FILE 75XTEST1 L75XTEST LNK E75XTEST ELV Example The assembler is started with parameter file 75XTEST PLV specified AANECTOOLS SMP75X RA75X gt LCNV75X F75XTEST PLV 252 CHAPTER 9 LIBRARY CONVERTER The library converter LBCNV75X outputs library files which can be input to version 5 00 or subsequent versions of Linker LK75X and Librarian LB75X when object program module format library files output by a version of Librarian LB75X in a RA75X Assembler Package which is earlier than version 5 00 are input 253 CHAPTER 9 LIBRARY CONVERTER 9 1 Library Converter Input Output Files Library converter LBCNV75X input output files are the files shown in Table 9 1 Library Converter Input Output Files Table 9 1 Library Converter Input Output Files Type of File Default File Type Input File Object program module format library files LIB Library files output by the Librarian LB75X RA75X Assembler Package ve
39. and the output destination and filename The NE option specifies that no error list file is to be output Use When the assembly list is very long it is difficult to find error lines in the list In this case the E option can be specified to extract only assembly error information Description If the output file name is omitted when the E option is specified source module file name ERA is taken as being specified as the output file name the drive name is omitted from the file name specification the current path name is taken as being specified If the same output file name as the specified by the P option is specified an error list is not output The following can be specified as the device type file output destination EPRN Error list is output to line printer ECON Error list is output to console EAUX Error list is output to RS 232 C ENUL Error list is not output If the same device as the absolute assembly list file is specified in the file name it will result in an abort error Example If 75XTEST1 ASM is assembled with the E option specified the file name is 75XTEST ELV A NECTOOLS SMP75X RA75X gt LONV75X 75XTEST1 L75XTEST LNK E75XTEST ELV If there was an error the error list file 75XTEXT ELV is output 250 CHAPTER 8 LIST CONVERTER parameter file name 5 Description Format F parameter file name Default Interpre
40. are in the subdirectory BIN 75X and the current path is other than BIN 75X there are two possible start methods as shown below 1 Specify the drive and directory in which the program files are located in full as follows A gt C BIN 75X RA75X 75XTEST1 ASM C106 2 Include the name of the path in which the program files are located in a list of command search paths supported by the OS For example A gt SET PATH A BIN C BIN C BINY75X If AUTOEXEC BAT etc is used for this setting the assembler can subsequently be started simply by specifying RA75X in the command line A gt RA75X 75XTEST1 ASM C106 In either case the command file and overlay files must be in the same path 61 CHAPTER ASSEMBLER PACKAGE EXECUTION 3 1 2 Sample programs Of the files stored on disk 75XTESTI ASM and 75XTEST2 ASM are sample program for confirming operation These files will be the input to the assembler as source program files in subsequent assembler operations A brief description of the contents of this sample program is given below This sample program is an A D conversion program which samples an analog source PTHOOH pin input signal 8 times using 75106 on chip hardware programmable threshold port and serial interface and outputs the average value from the serial output pin The sample program is divided into two modules one is stored in the source module file 75XTEST1 ASM under t
41. in the relevant module have been processed so that fewer dots may be output in this pass than in pass 1 pass 1 start pass 2 start 8 2 4 Points to note when using the list converter When using the list converter the following points should be noted when writing the source program The VENTn and ORG pseudo instructions should be written in upper case characters starting in column 9 of the source program The NOLIST control instruction should not be used Segments with the same name should not be used in the same module A segment definition pseudo instruction or ORG pseudo instruction must be written before writing an instruction which generates object code Also the list converter does not correct the symbol values of a cross reference list or symbol list included in the assembly list All files input to the list converter must be free of errors 240 CHAPTER 8 LIST CONVERTER 8 3 List Converter Start Method 8 3 1 List starting the list converter The list converter is started as shown below X gt LCNV75X List converter option file specification Specifies list converter options Nete List converter command file name Current drive name Note If multiple options are specified they are separated by spaces See 8 4 2 List converter options for details 1 Command line specification X gt LCNV75XL_ L file name A file specification O output file name Output file name 3
42. nu na mE R file name Specifies the input object module file name the input object module file name tee assembly list file primary name REL E file name Specifies the error list file name NE F file name Specifies the parameter file Read all options and file names from the command line 8 4 2 List converter options Each of the list converter options is described in detail in the following pages 244 CHAPTER 8 LIST CONVERTER L link file name Description Format L file name Default Input assembly list file primary name LNK Function The L option specifies the name of the load module file to be input Use e The L option is specified when the input files are specified in the command line Description f there is a L option is not specified the file input assembly list file primary name file the only the primary name of the input file is specified input a file with the same name but with the file type LNK added Examples Example 1 When the L option is specified A NECTOOLS SMP75X RA75X gt LONV75X L75XTEST LNK 75XTEST1 List Conversion Program for RA75X VX XX XX Xxx XX Copyright C NEC Corporation 1986 1987 Pass 1 start Pass 2 start Conversion complete 245 CHAPTER 8 LIST CONVERTER L link file name Example 2 When the L option is not specified A NECTOOLS SMP75X RA75X gt LONV75X 75XTEST1 List Conversion Pr
43. select Continue Directory Option Root Cnectools Need 4768 Space 350656 Executable files CAnectools bin Ra75x Sample CAnectoolsismp 75xira 5x Ideal Sample CAnectoolsismp75xiideal Addendum Text CAnectoolsidoc Device files CAnectoolsidev 6 return to the installation item selection dialog box select Back c To specify the default directory select Initialize Q The default installation destination directory thus becomes nectools on the drive where Windows is installed If the tools have already been installed using the installer that root directory is used To edit the root directory the directories which are related to the root directory and linked to it are changed d To terminate the installation select End E Items which cannot be installed are displayed in gray O n If there are no supplementary explanations the supplementary explanation directory is displayed in gray If there are supplementary explanations icons are registered after installation is completed so read their contents CHAPTER 3 ASSEMBLER PACKAGE EXECUTION g If the specified directory is incorrect it will result in an error and the following message will be displayed Bad Path Install directory drive path provided is not valid AAnectools h If the capacity is insufficient it will result in an error and the following message will be displayed Insufficient Disk Sp
44. 4 Object Converter Options for details One or more blanks spaces or TAB should be used to separate options and the input file name As the default output destination a file with the same name as the input file but with the file type changed to HEX is created in the current path This be changed by means of the O option RA75X OM1 is necessary to start the object converter 187 CHAPTER 6 OBJECT CONVERTER 6 3 2 Execution start and end messages 1 Execution start message When the object converter is started an execution start message is displayed on the console 75X Series Object Converter VX XX XX Xxx XX Copyright NEC Corporation 1985 2 Execution end message the object converter does not find a fatal error it outputs the following message to the console and returns control to the OS Object Conversion Complete 0 error s and 0 warning s found When the object converter outputs an error message and aborts linkage the cause of the error message should be found in 13 3 Object Converter Error Messages and appropriate action taken CHAPTER 6 OBJECT CONVERTER 6 3 3 Object converter error handling the object converter detects an error during execution it performs one of the following four kinds of processing according to the severity of the error 1 2 3 4 Abort error If an error is generated which prevents program executi
45. 44 Table 2 2 List of Host Machine Applicable Models PC 9800 Series was changed p 46 Applicable OS were added and versions have been changed 2 2 1 2 PC 9800 series OS 2 2 2 2 IBM PC AT OS 46 Assembler Package 5 inch FD was eliminated 2 2 1 3 and 2 2 2 3 Assembler package supply media p 48 3 1 1 Assembler package installation procedure was changed p 94 102 Assembler option types were added 197 117 4 4 4 6 GA NGA 11 12 S NS 13 D ND 19 Y p 180 A linker option type was added 5 4 4 15 Y p 194 197 Object Converter option types was added 200 6 4 4 2 R NR 4 O NO 5 E NE 6 F 7 Y p 249 251 List Converter option types was added 8 4 2 3 R 4 E NE 5 F p 253 CHAPTER 9 LIBRARY CONVERTER was added p 259 CHAPTER 10 OPTION SETTINGS FROM PROJECT MANAGER was added p 273 11 1 1 Assembly list was changed p 322 13 6 Library Converter Error Messages was added p 327 A 6 List of Library Converter Options was added Note Under development The mark shows major revised points MEMO PREFACE The purpose of this manual is to give users a clear understanding of the function and operation method of each of the programs comprising the RA75X Assembler Package referred to in the text simply as assembler package This manual does not cover source program writing the RA75X Assembler Package User s Manual
46. A900 Error No A901 User action Error No A902 Check the disk condition where the file exists available space media condition etc Check if the file where there was an error is the correct file Message Can t access file file name Cause The file could not be read correctly or it could not be written correctly Program Processing Program execution is halted User action Check the disk condition where the file exists available space media condition etc Check if the file where there was an error is the correct file Error No A903 Error No Message Can t write file file name A904 Cause Data could not be written correctly to the output file Program Processing Program execution is halted User action Check the disk condition where the file exists available space media condition etc 315 CHAPTER 13 ERROR MESSAGES Object Converter Error Messages cont d F200 Cause Program Processing User action F201 W300 316 Cause Program Processing Cause Program Processing User action Undefined symbol symbol name There is a symbol with an unresolved address Set the value at 0 then output the symbol table and continue program execution Please define the value of this symbol This symbol is referred to as an external reference symbol but when no external definition is provided please define it externally in the module defined by the symbol value
47. ADD 75XTEST2 75XTEST LIB LIST 75XTEST LIB The update date is recorded in the library file 75X Series Librarian VX XX DATE XX XX XX PAGE LIB FILE NAME 75XTEST LIB XX XX XX XX XX XX 1 AD MAIN XX XX XX UPDATE O0 RA75X VX XX UPD75106 2 AD SUB XX XX XX UPDATE 0 RA75X VX XX UPD75106 NUMBER OF MODULES 2 In 1 the date on which library file 75XTEST LIB was edited last remains In 2 the update date is recorded 209 CHAPTER 7 LIBRARIAN 7 4 Description of Subcommands Details of each subcommand are given in the following pages The description format is as follows Subcommand Operand information Prompt output by librarian 210 CHAPTER 7 LIBRARIAN CREATE create 1 CREATE Description Format CREATE Library file name Abbreviated Format C Library file name Default Interpretation None Function e The CREATE subcommand creates a new library file Use e The assembler and linker create one output module in one file If there are a large number of modules therefore the number of files also increases Consequently a function is required for collecting together a number of modules in a single file This function is called module librarization and the librarized file is called a library file If there are a large number of modules a library file can be created by specifying the CREATE subcommand Description The name of the library file to be created s
48. APPENDIX INDEX LW option assembler sans ales sliaaamcceaiutsiaasbeatacwidensSadiscencdeawaieeraaseatdsstiectesenaciae 78 105 324 E oe a n E 42 59 Bierzo 42 59 67 201 ON 155 UN TUN o EE a 120 123 202 203 207 208 211 213 216 219 Library TUNG infomation sss uuu ul estes oat momo 283 353 Wie scu nus tetas H 120 121 278 MURS Mm T S 42 59 63 119 Liner COLON E uU uuu u uuu cs 121 145 278 144 145 325 8122 oe Q H 230 326 Hic NONE OUTRE 38 41 59 68 235 BE COMMENTED ODOM ca E Om NOE 241 244 327 nlii m o 212 Load module file RT TRTREE E 120 121 182 234 Local symbols number of S 122 adil uuu 236 Weeje iKer ICC 174 207 236 M SI ODOM Soe mbi
49. CHARACTERS STRING IS NOT ALLOWED String exceeding 80 characters in length has been written Program processing Excess part of string is ignored First 80 characters are valid User action 32 Message Cause Divide string into sections of up to 80 characters ALREADY DEFINED SYMBOL IGNORE Symbol this statement attempts to define has already been defined Program processing Processing is continued with this symbol undefined User action 34 Message Cause Change symbol name and re assemble ARITHMETIC OVERFLOW Expression description is too complex Program processing Processing is continued with 0 as expression value User action 35 Message Cause Rewrite expression in simpler form SUBSTITUTE OVERFLOW Operand value exceeds permissible object code substitution value range Program processing Processing is continued with O as object code substitution value User action 36 Message Cause Ensure that operand value is in this range OPERAND MUST BE CODE SEGMENT ADDRESS Items other than code or constant symbol is used as operand symbol attribute Program processing Processing is continued with constant symbol as operand symbol attribute User action 37 Message Cause Ensure that operand symbol attribute is code or constant symbol OPERAND MUST BE DATA DATA SEGMENT ADDRESS Items other than data or constant symbol is used as operand symbol attribute Program processing Processing is continued with cons
50. Example Example 1 Module M2 in the library file 75XTEST LIB is to be replaced Before replacement 75XTEST LIB F2 REL Description format HEPLACE F2 M2 FROM 75XTEST LIB After replacement 75XTEST LIB M2 in library file 75XTEST LIB has been replaced 220 CHAPTER 7 LIBRARIAN REPLACE replace Example 2 lt 1 gt The contents of public symbols in the library file 75XTEST LIB are to be checked LIST 75XTEST LIB PUBLICS 75X Series Librarian VX XX DATE LIB FILE NAME 75XTEST LIB 1 AD MAIN UPDATE 0 RA75X VX XX UPD75106 SEGO SEG1 SEG2 SEGS SEG15 TDATA NUMBER OF PUBLIC SYMBOLS 6 AD_SUB UPDATE RA75X VX XX UPD75106 ADCONV SEG4 SEG5 SIOSUB NUMBER OF PUBLIC SYMBOLS 4 NUMBER OF MODULES 2 221 lt 2 gt CHAPTER 7 LIBRARIAN 75XTEST1 ASM is assembled after rewriting as shown below TITLE A D CONVERTER VX XX k lt ce lt lt lt lt lt lt e ec e e lt lt K K K x K K K lt lt lt K lt e K K K K K K lt lt lt lt lt lt k k lt lt J A D CONVERT PROGRAM NAME MAIN EXTRN CODE ADCONV CODE SIOSUB CODE HEIKIN PUBLIC TDATA SEL15 STKLN 10 VENTO MBE 1 RBE 1 MAIN VENT4 1 0 ADCONV SEGO DSEG 1 AT 10H TDATA DS 2 GETI TABLE x SEG1 CSEG IENT SEL15 SEL MB15 ROUTINE Bs SEG2 CSEG INBLOCK MAIN SEL RB1 GETI SEL15 STACK POINTER SET
51. Input file name REL is create in current IF __ ss 4 J Object module file forced output NJ NJ output specification 5 G Specification of output to object module of G S ML GA Specifies output of source debugging GA ir PCM P file Assembly list file specification Input file name PRN is create in current WE sm eee RN Symbol table list output specification NKS hie KX Cross reference list output specification NKX Specifies distinguishing between upper NCA lower case letters NCA CA Do not distinguish between upper lower case letters NCA Distinguish between upper lower case letters Sets the symbol name length S S Sets a maximum of 31 characters NS Sets a maximum of 8 characters Dsymbol name Symbol Name None numerical value Symbol Name numerical value NDsymbol Name LL number of lines Number of lines and columns per page of LL66 LW number of characters assembly list file LW132 LT number of characters Specification of number of TAB expansion LT8 columns in assembly list table KA Assembly list output specification KA NKA path name path name Include file search path specification Search the path specified by the IN CLUDE pseudo command the source Cannot be omitted when a 75XL Series device is used module file path and the path set in environmental variable INC75X in that order
52. LEVEL 1 ECHO Error generated during assembly IF LEVEL 1 GOTO END SET LEVEL 0 CLS LK75X TEST1 TEST2 5 0 5 IF ERRORLEVEL 1 ECHO Error generated during linkage IF LEVEL 1 GOTO END CLS OC75X TEST IF ERRORLEVEL 1 ECHO Error generated during object conversion IF LEVEL 1 GOTO END SET LEVEL 0 LCNV75X LTEST LNK 5 1 IF ERRORLEVEL 1 SET LEVEL 1 LCNV75X LTEST LNK ATEST2 IF ERRORLEVEL 1 SET EEVEL 1 LCNV75X LTEST LNK IF ERRORLEVEL 1 SET LEVEL 1 CLS IF LEVEL 1 ECHO Error generated during list conversion IF LEVEL 1 GOTO END ECHO No errors END 3 Example of executed result a Normal termination No error b When there is an assembly error Error in assembly The error should be corrected with reference to the assembly print file and assembly performed again 292 CHAPTER 13 ERROR MESSAGES This chapter describes the error messages output by each program in the assembler package the cause of each error action to be taken by the user and so forth 293 CHAPTER 13 ERROR MESSAGES 13 1 Assembler s Error Messages Format ERROR error number error message PROGRAM ABORTED This error cause program execution to be aborted Note This part is not output in error messages 001 to 021 User action Check correct file name then re execute User action Check correct file name then re execute 294 CHAPTER 13 ERROR MESSAGES Assembler s Error Message cont
53. M 4 TARGET CHIP UPD75000 DEVICE FILE VX XX Nete2 STACK SIZE 0000H ASSEMBLY COMPLETE NO ERROR FOUND Notes 1 The source input to the structured assembler preprocessor is output 2 When a device file is used file s version is output 273 CHAPTER 11 PROGRAM OUTPUT LISTS Descriptions of Output Items System date Output list page number in decimal notation 3 Title value specified by TITLE control instruction Blank if there is no TITLE control instruction specification lt 4 gt Parameter file command image Blank if there is no parameter file input specification Displays the line number of a source described by the user in 4 digit decimal notation Displays the location counter value in 4 digit hexadecimal R Reference to a relocatable symbol A Absolute value gt Operand Attributes E Reference to external reference symbol lt 8 lt 9 lt 1 Object code is displayed in hexadecimal lt 11 gt Source statement which includes the Assembler generation line The source 32 column input to the structured assembler preprocessor is output lt 12 gt User described source statement If exceeds the heading of the line it is output after carriage return 274 CHAPTER 11 PROGRAM OUTPUT LISTS 11 1 2 Symbol table list This name attributes and symbol values of symbols defined in the source program are output in this list Output Format 75X SERIES ASSEMBLER
54. Number of segments that can be written Number of branch tables that can be created 329 APPENDIX MAXIMUM CAPABILITIES 1 Source statement length 220 characters including Cr and Lr 2 Number of symbols that can be written Linker Local symbols No limit e External definition PUBLIC approx 3 000 all modules e External reference EXTRN symbols Approx 500 module 3 Number of segments that can be written Assembler Total of approximately 120 for a to c below per module a Number of segment definition pseudo instructions b Number of ORG pseudo instructions 2 x Number of VENT pseudo instructions Linker Total of approximately 250 for a to d below for all modules 2 x Number of input modules b Number of segments Number of ORG pseudo instructions 2 x Number of VENT pseudo instructions 4 Number nch table that can be treated 5 Other Assembler Number of local symbols 1 macro 100 including temporary parameters Nest level Approx 64Kbytes Macro body area size 32 Levels e macro instructions IF instruction SWITCH instructions INCLUDE instruction e Number of repetitions of a repeating macro 1023 times 330 APPENDIX POINT FOR ATTENTION Points requiring attention when using the assembler package are shown here Point for Attention Remedy Action Caution on memory bit operations mem bit object code is generated even if immediate dat
55. XX Xxx XX Copyright C NEC Corporation 1985 2 Execution end message f linkage terminates normally the linker outputs the following message to the console and returns control to the OS LINK COMPLETE NO ERROR FOUND e errors are detected during linkage the linker displays an error message on the console and returns control to the OS B gt LK75X FLINK PLK 75X Series Linker VX XX XX Xxx XX Copyright C NEC Corporation 1985 W300 CHIP TYPE MISMATCH MODULE AD SUB LINK COMPLETE 1 ERROR FOUND e Ifafatal error is detected during linkage which prevents linkage from continuing the linker outputs a message to the console stops execution and returns control to the OS An example of an error message is shown on the next page 141 CHAPTER 5 LINKER Example When a source module file is specified as an input file B gt LK75X 75XTEST1 REL 75XTEST2 ASM 75X Series Linker VX XX XX Xxx XX Copyright C NEC Corporation 1985 ERROR F304 INVALID FILE SYNTAX FILE 75XTEST2 ASM Program aborted In this example an error is generated since a source module file is specified as an input file and linkage is aborted When the linker outputs an error message and aborts linkage the cause of the error message should be found in 13 2 Linker s Error Messages and appropriate action taken 5 3 3 Linker error handling If the linker detects an error during execution it performs one of the followin
56. and TCALL pseudo instructions If it is wished to execute a 2 byte or 3 byte branch instruction or call instruction as a 1 byte instruction by means of the GETI instruction special data must be set in the GETI instruction reference table 20H to 7FH The TBR and TCALL pseudo instructions are provided to facilitate the setting of this data Macros A macro is a symbolic name which is assigned to a string of commands and is used in the source program in place of that string of commands so that those commands are executed each time that name is called When the same string of commands is used repeatedly if it is made into a macro the volume of the source program can be made smaller Also when a single function includes a number of commands if a name indicating the function of that string of commands is assigned to it the source program becomes easy to write and easy to read CHAPTER 1 GENERAL DESCRIPTION 5 Structured assembler preprocessor ST75X The structured assembler preprocessor is a program for implementing structured programming in assembly language A source program written in assembly language is input and an assembler source program is output Use of structured assembly language enables a program with good coding characteristics to be written 6 Librarian LB75X A librarian function is provided This enables a number of object modules to be collected together in a single library file Collecting generally applicable modules as
57. covered by this program Program Processing Program execution is halted User Action Check if the load module file is correct Confirm the target product to be assembled or compiled Check if the overlay file is the correct version 314 x O x x CHAPTER 13 ERROR MESSAGES Object Converter Error Messages cont d Message File Invalid input file or made by different host machine Error No A101 Cause A file other than a load module file was input or a load module file created on an incompatible host machine was input Program Processing Program execution is halted User action Check if someone didn t attempt to input a file other than a load module file When input of a load module file created on an incompatible host machine is attempted use a hot machine which is compatlible Message Symbol symbol name Illegal attribute Error No A103 Program Processing Program execution is halted User action When it is possible to add more memory to the host machine add more memory Add Error No A105 to the amount of memory which can be used by other application programs When it is not possible to add more memory linking cannot be done with this host machine User action Specify the correct file name Check the disk condition available space media condition etc Prepare a correct file particularly in the case of an overlay file Error No A106 Error No
58. current path J NJ Parameter file specification 1 Y path name Specifies the device file search path Searching is executed on the NDEV path the LK75X run the current directory and the environmental variable PATH in that order for the LK75X run path 4 325 APPENDIX A LIST OF OPTIONS A 3 List of Object Converter Options Description Format Function Category Default Interpretation 1 S file name Symbol table file specification input file name SYM is created in p 192 NS current path 2 R Specifies the HEX format object NR p 194 NR output sequence 3 U fill value Mask ROM ordering object output None p 195 specification name HEX format object module file Input file name HEX is created in p 197 name Specifies the error list file 5 198 F name Specifies the parameter file Reads all the options and file names p 199 from the command line 7 Y path name Specifies the device file search path It searches in the sequence of the path with respect to the RA75X starting path the OC75X starting path the current directory and the path set in the environment variable PATH A 4 List of Librarian Subcommands Abbreviated Format CREATE library file name Library file creation 211 ADD object module file name Module recording p 213 library file name object module TO update library file nam
59. editor execution format command file prjtedit htp Standard editor help file prjtlog exe File used by the Project Manager prjtmsg dll File used by the Program Manager prjtspin dll File used by the Project Manager prjtedit dll File used by the standard Editor prjtman txt Project Manager supplementary explanations ddummy 75x 75X Dummy Device File Note This file is also necessary when starting the Linker and Object Converter 42 CHAPTER 2 PRODUCT SUMMARY Table 2 1 Provided Files 2 2 386 File used by the Project Manager 75xtest1 asm 75xtest2 asm Sample program file for the Assembler stest1 src stest2 src Sample program file for the Structured Assembler sra75x bat Batch file for the Structured Assembler cd chg lib exam0000 idm Sample program for the Project Manager s standard editor exam0001 idm example1 idl example2 idl example3 asm pick up fnc sub pu fnc Remarks 1 A command file is the first file read into memory when a program is started 2 An overlay file is read into memory if required during program execution 3 A sample program file is used to check the operation of the assembler package 43 CHAPTER 2 PRODUCT SUMMARY 2 2 Host Machine Models and Operating Systems Host machines and OSs that can run RA75X are described below 2 2 1 PC 9800 series 1 PC 9800 series models Table 2 2 Host Machine Models PC 9800 Series 1 2 8086 V30 80286 80386 80486 Supported Model PC 98
60. file name Parameter file specification All operation and file names are p 115 read from command line Y path name Specifies the device file search path It searches in the sequence of the p 117 path with respect to the RA75X starting path the RA75X En starting path the current directory and the path set in the environment variable PATH 324 APPENDIX LIST OF OPTIONS A 2 List of Linker Options Description Format Function Category Default Interpretation M module name Output module name specification Object module name of first file input p 146 2 P file name Link list file specification First input input file MAP is output p 148 NP to current path 3 KM Map list output specification KM NKM 4 Local symbol list output specification NKP KL Specification of the local symbol list CD segment name Code segment relocation address address location order specification multiple specifications possible RS start address end Code segment allocation prohibited ROM area not incorporated in address area specification multiple target device specifications possible SQ Segment location order specification RN KI eee SK address Sets stack address in assembler Set automatically by linker reserved word STACK branch table creation 2 The initially input Input file LNK is NO output to the
61. has output 75XTEST1 P absolute assembly list 67 CHAPTER 3 ASSEMBLER PACKAGE EXECUTION 3 3 Summary of Assembler Package Execution Procedure The assembler package execution procedure for the sample program is summarized in the figure below Figure 3 2 Assembler Package Execution Procedure 75XTEST1 ASM Source module file Assembler RA75X 75XTEST1 PRN Assembly list file file 75XTEST1 MAP List converter LCNV75X Absolute assembly o i list file 75XTEST1 P Symbol C table file 75XTEST SYM 68 75XTEST1 REL 75XTEST2 REL Object module Librarian LB75X 75XTEST LIB Link list Object converter OC75X 75XTEST2 ASM Source e module file Assembler RA75X Object module file 75XTEST2 PRN o Assembly list file e Load module file 75XTEST LNK List converter LCN75X Absolute assembly list file 75XTEST2 P HEX format object module file 75XTEST HEX CHAPTER 4 ASSEMBLER The assembler RA75X has as input a source module file written in 75X Series and 75XL Series assembly language converts this into machine language and outputs the result as an object module file In addition the assembler outputs assembly list files such as an assembly list symbol table list cross reference list etc there are assembly errors the assembler outputs error messages in the assembly list error list etc indicating the cause of the error
62. information a load module file to a HEX format object module which can be input by a HEX loader PG 1500 IE 75000 RNete 1 75001 EVAKIT 75XNete 2 f an error is found during object conversion an error message is displayed on the console e The object converter performs processing in accordance with the object converter options specified when it is started See 6 4 Object Converter Options for object converter options When this processing terminates normally the object converter outputs a termination message and returns control to the OS e Ifthe NG option is specified when assembly is performed module symbol information is not output to the symbol table file Notes 1 Maintenance product not available for purchase 2 Discontinued not available for purchase 6 2 1 HEX format object module file format The HEX format object module file is output in HEX format 10 0708 00 3SCAFCD3AOT7 FF 8 lt gt lt L gt Checksum 2 digits e Value obtained by subtracting data up to code from number of codes in order from 0 is entered Code Max 16 bytes Indicates object code with each byte divided into high order 4 bits and low order 4 bits This item is not included in the last record Record Type 2 digits OOH indicates data record indicates last record Location Address 4 digits e Indicates start address of code indicated by this record OOOOH in last record Number of Codes 2 d
63. is regarded as if the Cancel button was pressed Help button This opens the help file for this dialog box Option character string display area This displays option character strings which are currently set It also displays option C1 character strings which cannot be reduced to one line Option character strings input in the option input combo box are displayed here in real time Option input combo box 2 Input option character strings here The number of characters Fete can be up to 127 characters Device file specification is done in the project manager settings so it is not necessary here A history of past inputs drops down Up to 10 past inputs are stored lf there is no source there are 10 options and also 10 options for special sources If there is a character string in the history which is the same as the option character string the previously input history is cleared and the newly input character string is added Note Includes the name of the source file set automatically by the project manager and the number of option characters Caution When setting options no check is made for errors in the option description Errors in the option description become errors during build 263 CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER 3 Source File Option Setting Dialog Box If Options Source List menu is selected from the menu items this dialog box opens see Figure 10 4 Figure 10 4 Source Lis
64. items select Options Set Linker Options menu to open the set linker options dialog box Figure 10 7 Options Setting Dialog Box Linker Linker option setup Delete source option Cancel Help linker Option cs 266 CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER Table 10 3 Options Setting Dialog Box Functions Linker OK button Sets the options and closes the dialog box If the return key is pressed when the focus is on the options input combo box it is regarded as if the OK button was pressed Cancel button This cancels the settings in this dialog box and closes it If the ESC key is pressed it is regarded as if the Cancel button was pressed Option character string display area Displays the character strings for the currently set options Option character strings 1 which cannot be fit one line also displayed Option character strings input in the options input combo box are displayed here in real time Option input combo box 2 Input option character strings here The number of characters Note can be up to 127 characters Device file specification is done in the project manager settings so it is not necessary here A history of past inputs drops down Up to 10 past inputs are stored If there is a character string in the history which is the same as the option character string the previously input history is cleared and the newly input character string is added
65. list is output to console PAUX Link list is output to RS 232 C e Ifthe drive name is omitted from the output name specification the current path is used If the extension is omitted MAP is used Examples Example 1 When the P option is specified The file name is A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK PSAMPLE MAP link list file SAMPLE MAP and load module file 75XTEXT LNK are output Example 2 To output the link list 75XTEST LNK to the printer A NECTOOLS SMP75X RA75X gt LX75X 75XTESTI REL 75XTEST2 REL 075 PPRN Example 3 The NP option is specified A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK NP The link list file is not output The Load Module File 75XTEST LNK only is output CHAPTER 5 LINKER KM NKM map no map 3 KM NKM Description Format KM NKM Default Interpretation KM Function The KM option specifies that map lists Segment list and branch table map list are to be output to the link list file The NKM option specifies that map lists are not to be output to the link list file Use e The NKM option is specified when linkage is to be performed only in order to output a load module file etc the linkage time is reduced Description e The link list file output destination is specified by the P option e f the NP is s
66. list is to be output directly to the printer or the disk or file name is to be changed from the default specification Description e f the absolute assembly list is to be output directly to the printer PRN should be specified as the file name e f the O option is not specified a file with the same primary name as the input assembly list file and file type P is output to the disk containing the input assembly list file Example Example 1 When the O option is specified A NECTOOLS SMP75X RA75X gt LONV75X L75XTEST LNK 75XTEST1 OSAMPL List Conversion Program for RA75X VX XX XX Xxx XX Copyright C NEC Corporation 1986 1997 Pass 1 start Pass 2 start Conversion complete The absolute assembly list SAMPL P is output 247 CHAPTER 8 LIST CONVERTER O output file name Example 2 When the file name SAMPLE LST is specified by the O option A NECTOOLS SMP75X RA75X gt LONV75X L75XTEST LNK 75XTEST1 OSAMPL LST List Conversion Program for RA75X VX XX XX Xxx XX Copyright C NEC Corporation 1986 Pass 1 start Pass 2 start Conversion complete The absolute assembly list SAMPL LST is output Example 3 When the O option is not specified A NECTOOLS SMP75X RA75X gt LCNV75X L75XTEST LNK 75XTEST1 List Conversion Program for RA75X VX XX XX Xxx XX Copyright C NEC Corporation 1986 Pass 1 start Pass 2 start Conversion complete In this example the input and output fil
67. number of segments r 124 Olther limitations a 1 3 5 Number of linker branch tables uuu uu mmm 1 3 6 Caution on homonymous segments 1 4 Assembler Package Features 1 5 Cautions 75XL Series Development CHAPTER 2 PRODUCT SUMMARY 21 Product Gontenls ll 2 2 Host Machine Models and Operating System s 2 2 1 Seres L LLULLU EIC RO PW PE CHAPTER 3 ASSEMBLER PACKAGE EXECUTION T T 31 Before Running Assembler Package s 3 1 1 Assembler package installation procedure aka uuu u uuu PE 3 2 Assembler Package Execution Procedure 3 2 1 Ass
68. option Located in low address direction FFH CHAPTER 5 LINKER 5 2 3 Resolution of relocatable object code During assembly temporary values are incorporated in the object code of instructions which reference relocatable symbols or external reference symbols The linker amends this object code to the correct values Also if a source module is written using the reserved word STACK the following values are assigned to STACK by the linker 1 When linker SK option specified The address value specified by the SK option is assigned to the reserved word STACK 2 When linker SK option is not specified The address value maximum address of stack segment 1 is assigned to the reserved word STACK OH Stack segment Address value assigned to STACK maximum address of stack segment 1 FFH The correct value is also assigned to STACK at the time of linkage in the object code of a MOV XA STACK instruction which sets a value in the stack pointer by using the reserved word STACK Example 1 When a relocatable item is referenced in the segment C1 ABC MOV BRCB Resolution of address corresponding to END 133 CHAPTER 5 LINKER Example 2 Symbol reference in another segment Resolution of address corresponding to DM Example 3 When an external reference name is referenced 134 EXTRN CODE SUB PUBLIC COMD CSEG CALL SUB Refer
69. ro ce _ 088 751 75 10800 05 59 5552 9 OHto1FFFH to 1FFFH OH toO1FFH to Note Addresses 0400H to 07FFH are allocated by EEPROM 82 CHAPTER 4 ASSEMBLER chip Notes 1 Display memory means an area comprising a total of 196 bits consisting of RAM addresses 1COH to 1FFH with the exception of 1C3H 1C7H 1CBH 1CFH 1D3H 1D7H 1DBH 1DFH 1E7H 1EBH 1EFH 1F3H 1F7H and 1FBH 2 8 bit data transfer instructions MOV XA mem MOV mem XA XCH XA mem cannot be use on addresses in the range to 01FFH 3 8 bit data transfer instructions MOV XA mem MOV mem XA XCH XA mem cannot be used on addresses in the range 01E8H to 4 8 bit data transfer instructions MOV XA mem MOV mem XA XCH XA mem cannot be used on addresses in the range 0100H to 0126H 83 CHAPTER 4 ASSEMBLER eC chip 2 75XL Series uPD753304 Note 1 3304 to OFFFH to 1EOH to 1F7H Notes uPD754144 4144 to 07FFH to 07FH 0400H to 041FH Nete 7 uPD754244 4244 to OFFFH to 07FH 0400H to 041 7 uPD754264 4264 OH to OFFFH to 07FH 0400H to 041FH 7 UPD75F4264 Note 1 F4264 OH to OFFFH to 07FH 0400H to 041FH 7 754302 sis 43800 OHto07FFH to 07FFH OH to OFFH uPD754304 4304 OH to OFFFH OH to OFFH uPD75P4308 P4308 to O1FFFH 0H to OFFH 84 C
70. syntax then halts processing and returns control to OS A005 File name format is incorrect Check correct file name then re execute File not found file name Error No Message Program processing Checks start line syntax then halts processing and returns control to OS Confirm program start method then re execute Check correct file name then re execute Program processing Checks start line syntax then halts processing and returns control to OS Error No File specification conflicted file name Error No Illegal file specification file name A008 Input or output file specification overlaps A009 Specified output file cannot be created Program processing Checks start line syntax then halts processing and returns control to OS Program processing Checks start line syntax then halts processing and returns control to OS Check correct file name then re execute Check remaining disk capacity etc Error No Unable to make file file name Error No Directory not found file name A010 Nonexistent drive or directory is included in output file name Error No Input file specification overlapped file name Program processing Checks start line syntax then halts processing and returns control to OS Error No Illegal path option A006 Specified file does not exist Check correct file name then re execute A007 Overlapping input file specification User action Check correct file name then re execute Prog
71. the list to the printer A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM C106 PPRN gt assembly list file is output to the printer CHAPTER 4 ASSEMBLER E NE error print no error print 8 E NE Description Format E output file name NE Default Interpretation NE Function E option specifies error list output and the output destination and filename The NE option specifies that no error list file is to be output Use When the assembly list is very long it is difficult to find error lines in the list In this case the E option can be specified to extract only assembly error information Description e f the output file name is omitted when the E option is specified source module file is taken as being specified as the output file name f the drive name is omitted from the file name specification the current path name is taken as being specified e f the same output file name as the specified by P option is specified an error list is not output The following can be specified as the device type file output destination EPRN Error list is output tp line printer ECON Error list is output to console EAUX Error list is output to RS 232 C ENUL Error list is not output Example If 75XTEST1 ASM is assembled with the E option specified the file name is 75XTEST ERA A NECTOOLS SMP75X RA75X g
72. when the S option is specified Description Example Assemble 75XTEST1 ASM specifying the NS option A NECTOOLS SMP75X RA75X BA75X 75XTEST1 ASM C106 NS The object module file 75XTEST1 REL is output with the symbol names a maximum of 8 characters in length Caution IE 75000 R and IE 75001 R can recognize only symbol names with a length of 8 characters so specify the NS option 103 x CHAPTER 4 ASSEMBLER D ND define no define 13 D ND Description Format D Symbol Name Numerical Value Symbol Name Numerical value ND Symbol Name Symbol Name Default Interpretation symbol is not defined Function The D option instructs that the specified symbol be defined with the value of the specified numerical value e The ND option invalidates the specified symbol definition Use If you are defining a specified symbol with the value of the specified numerical value specify the D option If you are invalidating the definition of the specified symbol specify the ND option Explanation If specification of a numerical value is omitted the symbol value becomes 1 Description Example f defining 1 in the symbol TRUE A NECTOOL SMP75X RA75X RA75X gt RA75X 75XTEST1 ASM DTRUE 1 104 CHAPTER 4 ASSEMBLER LL LW page length page width 14 LL LW Description Format LL number of lines printed on one page LW number of columns pri
73. 000H R SEG SEG3 60 68 IETO PBIT OFBCH 1 53 1 CODE 0010H R SEG SEG2 37 39 LOOP2 CODE 0016H R SEG SEG2 41 43 LOOPS CODE 0029H R SEG SEG2 56 63 LOOP4 CODE 002DH R SEG SEG2 58 59 5 CODE 0002H R SEG SEG3 69 75 MAIN CODE 0000H R SEG SEG2 9 23 MBE PBIT OFBOH 1 9 10 PCC DATA 30 RBE PBIT OFBOH O 9 10 SEGO DATA 0002H PUB ABS 12 SEG1 CODE 0002H PUB REL IENT 17 SEG2 CODE 0039H PUB REL INBLOCK 22 SEGS CODE OOOAH PUB REL SENT 67 SEL15 CODE 0000H R PUB SEG SEG1 7 18 25 47 SIOSUB CODE EXT 6 62 SP DATA OF80H 27 STACK STACK EXT 26 TDATA DATA 0110H PUB ABS 7 13 61 TMO DATA 51 TMODO DATA OFA6H 49 TARGET CHIP UPD75106 STACK SIZE 000AH ASSEMBLY COMPLETE NO ERROR FOUND 358 APPENDIX D SAMPLE PROGRAMS b 75XTEST2 PRN absolute assembly list Output to 75XTEST2 P 75X SERIES ASSEMBLER VX XX A D CONVERT VX XX SUB COMMAND STNO ADRS R OBJECT 1 2 3 4 5 6 7 8 9 10 11 12 13 000 9907 14 000 9922 15 000 9911 16 0010 E A210 17 0012 E 10 18 0013 92E4 19 0015 89 20 0017 92E0 21 0019 9906 22 001 EE 23 24 25 26 27 0022 9907 28 0024 10 29 0025 8BD3 30 0027 89C0 31 0029 93C0 32 002B 9D40 33 0020 34 002 9206 35 0031 36 0032 CO of 0033 FE IC MAC XX XX XX PAGE X 75 2 C106 KS KX SOURCE STATEMENT
74. 0042101092 489 92 09906 0000000032 10002000991F9907108BD389C093C09D40A3C0929C 10003000D67ACOFEBDO049BA40CAF 19A09A3COAAC1EA 100040009D809906C7EF9A2ED9E698D998CEF9EEF9 10005000992110890092807393B399118B3F890085 10006000E8AA6AFC9910E8AAGAFC 10897992A68924 100070004C92A09DB29D9C991189009A0F9A87FD80 10008000AB40469210AB400AF000000000000000B8 100090000000000000000000000000000000000060 1000A0000000000000000000000000000000000050 1000B0000000000000000000000000000000000040 1000C0000000000000000000000000000000000030 1000D0000000000000000000000000000000000020 1000E0000000000000000000000000000000000010 1000F0000000000000000000000000000000000000 1001000000000000000000000000000000000000EF 1001100000000000000000000000000000000000DF 1001200000000000000000000000000000000000CF 1001300000000000000000000000000000000000BF 1001400000000000000000000000000000000000AF 10015000000000000000000000000000000000009F 10016000000000000000000000000000000000008F 10017000000000000000000000000000000000007F 10018000000000000000000000000000000000006F All addresses not used for program description have been filled with the specified decimal code 00 196 CHAPTER 6 OBJECT CONVERTER output file name 4 O NO Description Format O HEX format object module file name NO Default Interpretation Input file name HEX is created in current path Function e The O option specifies the name of the HEX format object modul
75. 01 XAmodel 1 2 3 11 21 31 F A2 5 7 U2 U5 U7 E XL model 1 2 4 HL2 5 21 51 BXu ue ve 1 2 3 V 4 01 21 41 RA2 5 21 51 BAuz ue m2 2 UXa1 41 ES BS2us uzv2 RX24 21 51 RS21 51 BX2uz2 u7 m2 2 4 21 11 EX2 4 T model W2 W5 W7 S5 F5 F51 F71 202 07 2 U2 DX2 4 u2 u5 0525 02 05 BA3u2 UV 221 11 2 4 5 5 DA2 5 7 U2 U5 U7 BX3u2 CVa1 CSa2 5 5w 120 40 120 U NS R40 120 UF F Sa siziU2 U5 U7 120 XL model 1 2 4 X2 5 U2 5 VX0 2 4 01 21 41 525 120 340 UXa1 41 NS zo NL R PC 9801 RX24 21 51 NS E 20 40 NL A120 260A EX NS T 20 40 XL NS L 40 RL2 5 21 51 NC 4o RA2 5 21 51 52 5 RS21 51 T model W2 W5 W7 S5 F5 F51 F7 21 22 LX2 4 5 5C 52 5 NV NL Remark Models in the table that have a high resolution mode can also be used in high resolution mode Caution At least 640K bytes of internal memory is required 44 CHAPTER 2 PRODUCT SUMMARY Table 2 2 Host Machine Models PC 9800 Series 2 2 8086 V30 80286 80386 80486 aaa Model model70 002 100 Smodel8 002 040 100 model60 002 040 100 SmodelU8 002 040 100 modelU60 002 040 100 model80 002 040 100 modelU80 002 040 100 model90 002 040 100 PC H98 modelU90 ooz 040 100 model100 1100 05 100 300 modelU105 100 300 Tmodeliz 2c 80486 Pentium Supported Model A u2 u7 U7W M2 M7 M7W Afusw mow ASu2 u7 u7w us usw M2 M7 M
76. 39 Message macro is not allowed in macro definition macro_name lodm is not allowed in macro definition macro Cause Macro definition statement in macro definition Program processing Processing is continued with that macro name macro definition invalidated Describe correctly 498 Undefine symbol Undefined symbol in SET expression outside macro definition Program processing Processing is continued without performing SET symbol registration Check whether symbol is assembler pseudo instruction SET symbol Unsuitable expression format Cause Set expression outside macro definition is incompatible with this macro processor s SET expression format Program processing Processing is continued without performing SET symbol registration User action Check whether symbol is assembler pseudo instruction SET symbol 305 CHAPTER 13 ERROR MESSAGES 13 2 Linker s Error Messages Error No Message Missing input file 001 Input file has not been specified in start line Program processing Checks start line syntax then halts processing and returns control to OS Confirm program start method then re execute A003 Specified string cannot be interpreted Program processing Checks start line syntax then halts processing and returns control to OS Error No Illegal file file name A004 Type or length of characters in file name is illegal Program processing Checks start line
77. 4 S option object converter 191 192 326 s oK Oj MT ERE ua u mmn 144 168 325 O Dl On 144 165 325 OZ Op i li eee EN eee ee ne S IK 144 171 325 SAMPEE E cote S 96 192 Segment definition pseudo instructions 72 330 Segment link map 1 121 145 278 280 Segment relocation attribute a a r 124 125 Segments JUL LIL eei a 328 SENT segment 125 334 ee ee 70 71 Source iabqee
78. 41 CHAPTER 2 PRODUCT SUMMARY 2 1 Product Contents The RA75X assembler package consists of the files shown in Table 2 1 Table 2 1 Provided Files 1 2 File Contents Structured Assembler st75x exe Structured assembler preprocessor execution format command file st75x hlp Execution format help file st75xp dll Tools DLL for Project Manager st75xp hlp Tools DLL help file st75x om1 Overlay File Assembler ra75x exe Assembler execution format command file ra75x hlp Execution format help file ra75xp dll Tools DLL for Project Manager ra75xp hlp Tools DLL help file ra75x om1 Note Assembler Information File ra 5x om 75X Device File Linker Ik75x exe Linker Execution Format Command File IK75xp dll Tools DLL for Project Manager IK75xp hlp Tools DLL help file Object Converter 75 Object converter execution format command file oc75x hlp Execution format help file oc75x dll Tools DLL for Project Manager 0c75xp hlp Tools DLL help file Librarian Ib75x exe Librarian execution format command file Ib75x hlp Execution format help file List Converter Icnv75x exe List converter execution format command file Icnv75x hlp Execution format help file Library Converter Ibcnv75x exe Library Converter execution format command file Project Manager prjtman exe Project Manager execution format command file prjtman hlp Project Manager help file prjtmake exe Project Manager make execution format command file prjtedit exe Standard
79. 5 0 to Ver 6 0 5 0 VNote 2 IBM DOS Note 1 J5 02 VNote 2 Notes 1 A task swapping function is provided from Ver 5 0 onward but the task swapping function cannot be used with the RA75X assembler package 2 Only the English language mode is supported 3 Ifthe Assembler is used in Windows Project Manager is necessary If Project Manager is not used run the Assembler under MS DOS PC DOS or IBM DOS 3 Assembler package supply media 3 5 inch FD 2HC 46 CHAPTER 3 ASSEMBLER PACKAGE EXECUTION This chapter describes the assembler package installation procedure and execution procedures Executing each program in accordance with the execution procedures described here will enable the user to become familiar with the operation of the assembler package 47 CHAPTER 3 ASSEMBLER PACKAGE EXECUTION 3 1 Before Running Assembler Package 3 1 1 Assembler package installation procedure Install the Assembler Package and the Project Manager The Project Manager is necessary if the Assembler is to be used in Windows This software is supplied on four 3 5 inch floppy disks Installation can be done by one of the following three methods Table 3 1 Installation Methods Installation Method Programs which can be installed Execute setupj exe in Windows 3 1 Assembler Package Project Manager Japanese Edition Execute setupe exe in Windows 3 1 Assembler Package Project Manager English Edition Execute dosin
80. 5 3 Kinds of Linker Options Description Format Function Category Default Interpretation M module name Output module name specification Object module name of first file input First input input file MAP is output to NP current path NKM NKP KL Local symbol list output specification NKL CD segment name Code segment relocation address location Automatically located by linker address order specification multiple specifications possible RS start address Code segment allocation prohibited area ROM area not incorporated in target device end address specification multiple specifications possible SQ Segment location order specification RN RN SK address Sets stack address in assembler reserved Set automatically by linker word STACK SZ size Stack size change specification NTB Specifies suppression of automatic branch Created automatically table creation O file name Load module file specification First input input file LNK is output to NO current path J Load module file forced output specification NJ NJ F file name Parameter file specification All options and file names are read from command line Y path name Specifies the device file search path For the LK75X run path the path specified in DEV path LK75X run path current directory and environmental variable PATH are searched in that order Remark Options can be written in either
81. 5308B 075312 75316 PD75312B 75316B 75P308 uPD75P316 75P316A 75P316B LCD drive A D converter 75238 75P328 LCD drive A D converter uPD753936 75P336 high level functions Control on chip A D Control on chip A D converter HPD75512 75516 75 516 on chi One Control on chip A D converter uPD75517 75518 75P518 high speed Telephone series LCD drive D A converter uPD75352A LCD drive DTMF D A converter uPD75617A A D converter lt 75XL Series gt General purpose series General purpose 1 750004 750006 750008 75P0016 General purpose RC oscillator uPD750104 750106 750108 75P0116 circuit General purpose A D converter 750064 750066 750068 75P0076 LCD drive series LCD drive UPD753012 753012 753106 753016A 753017 753017A 75P3018 75P3018A LCD drive A D converter UPD753036 75P3036 For driving a LCD small 753104 753106 753108 75P3116 PD753204 753206 753208 75 216 753206 753208 PD753204 753206 753208 75P3216 LCD drive RC oscillator circuit uPD753304Nete small Keyless entry 0722 754144 754244 754264 uPD75F4264Nete General purpose small 74302 754304 75P4308 Organization The configuration of this manual is shown below CHAPTER 1 GENERAL DESCRIPTION Describes the role of the assembler package in microcomputer development etc together with a general outline of its functions
82. 5XL p 86 Cannot be omitted when a 75XL Series devices is used Series devices is used 3 O file name Object module file specification Input file name REL is created on p 88 NO the current path 4 J Object module file forced output NJ p 100 5 G Specification of output to the object G p 101 NG module of symbol information for debugging GA Specifies output of source debugging GA p 94 KR IIWGTST TCKc OCo 7 P file name Assembly list file specification Input file name PRN is created p 95 Perm G m PI NE 7 eem r 5 specification CA Specifies distinguishing between NCA p 102 NCA upper lower case letters CA Do not distinguish between upper lower case letters NCA Distinguish between upper lower case letters 12 S Sets the symbol name length S p 103 NS S Sets a maximum of 31 characters NS Sets a maximum of 8 characters D symbol Name Sets the symbol definition None p 104 numerical value symbol Name numerical value ND symbol Name LW number of columns page of assembly list file LW132 pansion columns in assembly list file KA Assembly list output specification p 112 NKA path name Include file search path specification Searching is executed on the path p 113 path name specified by the INCLUDE control command the path of the source module file and the path specified by environmental variable INC75X 8 F
83. 7w BfuswiMsw ADu2 U7 U7w U9 U9W M2 M7 M7W Anuaew cer U2 M2 Beuzw Xtc1ow Bsuzw XAU8W C9W C10W U1 Bpuzw uew Xnusw cow AS2u U7WIUSW M2 Xfuswicow ut Ap2u2 usw c 9w c T M2 Xa7caice Xpusw csw 9 XSuzw csw Xa10ca o12 Xeu7w CX25815B S17B S15T S17T Ap3caw c w u2 M2 Cfmodel 53 AsScsw u2 m2 Nfsaow s10w Xe104ca PC 9821 PC 9821 model 51 52 Cemodel 51 52 Ce2model 1 S2 S2D T2 T2D Cs2model 2 S3 Cb model 2F 2D 2 CXmodel 52 53 Cb2B r wA TS 120 w Ne 120 w 340 w Np340W 540W 810W INS340w 540W 810W Ne2 a4ow Nd s4ow Ld260 3504 350A2 Lt260 350A 540A Nmv34o Ne3vs Nd2 s Remark Models in the table that have a high resolution mode can also be used in high resolution mode Caution At least 640K bytes of internal memory is required 45 x x CHAPTER 2 PRODUCT SUMMARY 2 9800 series OS MS DOS Ver 3 30 5 00 1 1 5 00 1 Notes 1 A task swapping function is provided in Ver 5 00 5 00A but the task swapping function cannot be used with the RA75X assembler package 2 Ifthe Assembler is used in Windows Project Manager is necessary If Project Manager is not used run the Assembler under MS DOS 3 Assembly package supply medium 3 5 inch FD 2HD 2 2 2 PC AT 1 Models IBM PC AT Caution At least 384K bytes of internal memory is required not including the system area 2 IBM PC AT OS DOS7MNete Ver 5 0 to 6 0 MS DOSNete 1 Ver
84. 8 FO 64 65 66 67 68 0046 2 69 0048 09 70 0049 E6 71 004A 98 72 004B 09 73 004 98 74 0040 75 004E F9 76 004F EE 77 78 356 XX XX XX XX XX XX PAGE X SOURCE STATEMENT 4 5 HEIKIN LOOP5 EI EI SEL MOV MOV SKE BR CALL MOV CALL BR HEIKIN CSEG MOV XCH CLR1 RORC XCH RORC DECS BR RET END 1 00H B 08H LOOP4 IHEIKIN TDATA XA ISIOSUB SAMPLE NUMBERS 8 SENT C 2H A X CY A A X A LOOPS LSE 75X SERIES ASSEMBLER VX XX CONVERTER VX XX SYMBOL TABLE LIST OFFSET TYPE SYMBOL AD_MAIN 1 LOOPS OFBOH O RBE CODE PUB SEG3 STACK EXT STACK OFFSET TYPE PAGE SYMBOL ADCONV LOOP2 MAIN SEGO SEL15 TDATA OFFSET 0000H 0029H 1 0002H TYPE CODE CODE PBIT X SYMBOL HEIKIN LOOP3 MBE CODE PUB SEG1 CODE EXT SIOSUB DATA TMO OFFSET TYPE SYMBOL OFBCH 1 PBIT IETO 002DH 0039H OF80H OFA6H CODE LOOP4 DATA PCC CODE PUB SEG2 DATA SP DATA TMODO AIdNVS XIGNAddV APPENDIX D SAMPLE PROGRAMS 75X SERIES ASSEMBLER VX XX XX XX XX XX XX XX PAGE X A D CONVERTER VX XX CROSS REFERENCE LIST SYMBOL TYPE VALUE ATTRIBUTES XREF LIST AD MAIN 1 ADCONV CODE 6 10 CODE 0
85. 8E 00 4 Regional Information Some information contained in this document may vary from country to country Before using any NEC product in your application please contact the NEC office in your country to obtain a list of authorized representatives and distributors They will verify e Device availability e Ordering information e Product release schedule e Availability of related technical literature e Development environment specifications for example specifications for third party tools and components host computers power plugs AC supply voltages and so forth e Network requirements In addition trademarks registered trademarks export restrictions and other legal issues may also vary from country to country NEC Electronics Inc U S Santa Clara California Tel 408 588 6000 800 366 9782 Fax 408 588 6130 800 729 9288 NEC Electronics Germany GmbH Duesseldorf Germany Tel 0211 65 03 02 Fax 0211 65 03 490 NEC Electronics UK Ltd Milton Keynes UK Tel 01908 691 133 Fax 01908 670 290 NEC Electronics Italiana s r l Milano Italy Tel 02 66 75 41 Fax 02 66 75 42 99 NEC Electronics Germany GmbH Benelux Office Eindhoven The Netherlands Tel 040 2445845 Fax 040 2444580 NEC Electronics France S A Velizy Villacoublay France Tel 01 30 67 58 00 Fax 01 30 67 58 99 NEC Electronics France S A Madrid Office Madrid Spain Tel 91 504 2787 Fax 91 504 2860 NEC El
86. 91 198 326 363 APPENDIX INDEX E option list converter eec TK c 244 250 327 egre crm 272 282 Er Orl r Em 70 71 182 236 272 ioe sis ast u 76 143 243 256 F T cs atic ew E SU U 233 326 External definition PUBLIC symbols number of 122 External reference EXTRN symbols number 122 F F option assembler a arar rassssssssssssssssssssssssssssssssssssssass 78 115 324 F option object converter a rr 191 199 328 linker xu m 144 178 325 F IST CORY TNR 244 253 327 76 142 143 189 190 243 G G option assembler M 78 91 324 EGA ODUN ASS SIMIC PEOR a r e eE EEEE 78 94 324 H POO TIG NN ERN E E Z s 41 59 HEX format object module file sere ene ee Oo T 182 183 351 I option 78
87. 9AOF MOV B 00H 9A87 LOOP4 SKE B 08H FD BR LOOP4 AB4000 CALL HEIKIN 9210 MOV TDATA XA AB4000 CALL SIOSUB Temporary values are incorporated in the object code An absolute assembly list is output in which the object code of the CALL instructions which reference the relocatable symbol HEIKIN and the external reference symbol SIOSUB is replaced with the correct values determined during linkage Absolute assembly list 007B 9AOF MOV B 00H 007D 9A87 LOOP4 SKE B 08H 007F FD BR LOOP4 0080 R AB4046 CALL HEIKIN 0083 9210 MOV TDATA XA 0085 E AB400A CALL SIOSUB Correct object code is incorporated Caution The code of the VENTn pseudo instruction is not converted by the list converter 239 CHAPTER 8 LIST CONVERTER 8 2 3 List converter processing method List converter processing consists of two stages called passes In pass 1 the list converter checks the contents of the input object module file and load module file and searches the load module file for modules corresponding to the object module file In pass 2 the list converter incorporates absolute values in the assembly list based on the module information found and outputs an absolute assembly file As a guide to the processing stage the list converter outputs the following images to the console during processing Each dot output represents one segment In pass 2 the remaining segments are skipped when all the segments
88. 9D40A3C0929C 10003000D67ACOFEBDO049B40CAF 19A09A3COAAC1EA 100040009D809906C7EF9A2ED9E698D998CEF9EEF9 10005000992110890092807393B3991 18B3F890085 10006000E8AAGAFC9910E8AAGAFC10897992A68924 100070004C92A09DB29D9C991189009A0F9A87FFD80 09008000AB40469210AB400AFOBF 00000001FF 351 APPENDIX D SAMPLE PROGRAMS 6 Symbol table file Output to 75 5 5 04 AD_MAIN 0201105 0 010020SEG1 010050SEG2 010046SEG3 010020SEL15 030100STACK 020110TDATA lt 010046HEIKIN O83EF1IETO 010060LOOP1 010066 2 0100791 01007DLOOP4 010048LOOP5 010050MAIN 083EC1MBE 20 083CORBE 020 805 O20FA6TMODO AD SUB 010022ADCONV 01000ASEG4 010022SEG5 01000ASIOSUB lt 020FCOBSBO 0100SBLOOP O20FD4PTHO O20FD6PTHM O20FE4SIO O20FEOSIOM 010032WAIT 352 APPENDIX D SAMPLE PROGRAMS 7 Library file information list Output to 75XTEST LST 75X Series Librarian LIB FILE NAME 75XTEST LIB AD_MAIN UPDATA 0 RA75X VX XX UPD75106 SEGO SEG1 SEG2 SEG3 SEL15 TDATA NUMBER OF PUBLIC SYMBOLS AD_SUB UPDATE RA75X VX XX UPD75106 ADCONV SEG4 SEG5 SIOSUB NUMBER OF PUBLIC SYMBOLS NUMBER OF MODULES 353 APPENDIX D SAMPLE PROGRAMS 8 Absolute assembly list a 75XTEST1 PRN absolute assembly list Output to 75XTEST1 P 75X SERIES ASSEMBLER VX XX CONVERTER VX XX XX XX XX XX XX XX PAGE
89. AIT INCS A CIRCLE WAIT APPENDIX D SAMPLE PROGRAMS WAIT CY BSBO L CY L LOOP X A BSBO XA XXA ADD DATA RBE BS SAMPLE COUNT INC 343 bre 75X SERIES ASSEMBLER VX XX A D CONVERTER VX XX SYMBOL TABLE LIST OFFSET TYPE OFBOH O SYMBOL AD MAIN LOOP 1 LOOP5 HBE CODE PUB SEG3 SIACK EXT STACK TARGET CHIP UPD75106 STACK SIZE 000AH OFFSET TYPE SYMBOL CODE EXT ADCONV CODE LOOP2 CODE MAIN DATA PUB SEGO CODE PUB SEL15 DATA PUB DATA ASSEMBLY COMPLETE NO ERROR FOUND OFFSET TYPE 0000H 0029H OFBOH 1 CODE CODE PBIT SYMBOL HEIKIN CODE PUB SEG1 CODE EXT SIOSUB DATA TMO PAGE X OFFSET TYPE SYMBOL OFBCH 1 PBIT IETO 002DH 0039H OF80H OFA6H CODE LOOP4 DATA PCC CODE PUB SEG2 DATA SP DATA TMOD0 NHd LLSSLXSZ 0 1ndino 1s Ioqui s 15 ejqe1 Ioqu S 2 AIdNVS XIGNAddV 75X SERIES ASSEMBLER VX XX CONVERTER VX XX SUB SYMBOL TABLE LIST OFFSET TYPE SYMBOL OFFSET 0000H PUB SEG5 PUB SIOSUB XX XX XX XX XX XX PAGE X SYMBOL PUB ADCONV PTHM EXT SEL15 EXT TDATA OFFSET TYPE OFCOH DATA OFBOH O OFE4H DATA 0010H CODE SYMBOL OFFSETTYPE BSBO 0009 CODE RBE 0012H CODE SIO OFEOH DATA WAIT SYMBOL LOOP PUB SEG4 SIOM NYd
90. Assembly is performed in accordance with the CPU mode specified by M An error will be flagged if this option is not specified when 75XL Series device is used e In the 75XL Series the Mark1 Mode cannot be specified for products with more than 16 Kbytes of ROM This option cannot be specified when 75X Series device is used Description The modes that can be selected with this option are shown in the table below Can be specified 2 Cannot be specified In the Mark1 mode The BRA and CALLA instructions result in an error n the common mode an instruction in which there is a change in the stack results in an error 86 CHAPTER 4 ASSEMBLER M MODE Examples Example 1 If 75XTEST1 ASM is assembled with the M2 option specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM 0004 M2 Example 2 If 75XTEST1 ASM is assembled without the M option being specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM 0004 75X Series Assembler VXX XX XX Xxx xx Copyright C NEC Corporation 1985 XXXX ERROR A099 MODE IS NOT SELECTED Program aborted An assembly error is flagged 87 CHAPTER 4 ASSEMBLER object no object 3 O NO Description Format O output file name NO Default Interpretation Input file name REL is created in current path Function The O option specifies the output destination and file name of the object module fi
91. BLER PACKAGE 12 1 How to Utilize Parameter File It is convenient to use a parameter file when starting the assembler linker or object converter A parameter file is one in which specifications of input files options etc needed when starting a program are recorded beforehand using an editor Use of a parameter file is particularly recommended when starting the linker which uses a large number of input files The contents of options specified in a parameter file can be added to or changed in the command line when starting the program Example 1 A parameter file LINK PLK is created with the editor e Contents of LINK PLK 75XTEST1 REL 75XTEST2 REL 075X LNK PSAMP MAP KM The linker is started with parameter file LINK PLK specified A NECTOOLS SMP75X RA75X gt LK75X FLINK PLK 75X Series Linker VX XX XX Xxx XX Copyright C NEC Corporation 1985 LINK COMPLETE NO ERROR FOUND Example 2 The options specified in the parameter file are changed and added to in the command line A NECTOOLS SMP75X RA75X gt LK75X FLINK PLK PTEST LNK SQ CHAPTER 12 EFFECTIVE USE OF THE ASSEMBLER PACKAGE 12 2 Use of the List Converter In the assembly list output by the relocatable assembler temporary values are used for addresses and object code which were not determined during assembly In order to perform debugging with the in circuit emulator etc using this assembly list the actual values of addresses and object c
92. CROSS REFERENCE LIST SYMBOL TYPE VALUE ATTRIBUTES LIST 1 ADCONV OOOOH R PUB SEG SEG5 8 27 BSBO OFCOH 31 32 33 39 43 LOOP 0009H R SEG SEG5 32 41 PTHO OFD4H 38 PTHM OFD6H 34 RBE OFBOH O 45 SEGA 0012H PUB REL SENT SEGS 0024H PUB REL SENT SEL15 SIO SIOM SIOSUB OOOOH R PUB SEG SEG4 TDATA EXT WAIT CODE 0010H R SEG SEG5 TARGET CHIP UPD75106 STACK SIZE 0002H ASSEMBLY COMPLETE NO ERROR FOUND 362 APPENDIX INDEX E 1 Index A ADON Oi Or x E S 76 142 189 190 243 256 Absolute assempDiler U u 25 Nee u gt Uo 284 354 Absolute assembDIy ug eT US 236 PROS OES SS hi m uuu l 124 125 AOD 5 213 ABD MAIN 62 218 AD gt 62 217 41 59 63 69 Assembler 72 73 77 324 hires eee ee en eee ee 47 68 AssembDly language Z 21 PASS SMO dll c Y 70 265 272 F ri IS cC 236 AT
93. E SEGMENT NAME BRANCH TABLE MAP FOR BR LNK LOCATED REFERENCE EXPRESSION REFERENCE REFERENCE ADDRESS ADDRESS SEGMENT 0030H IEXT1 Three branch tables have been created Caution In order to perform automatic branch table creation processing the linker records provisional branch tables uniformly for all BRCB instructions other than those for which the object code was determined during assembly which branch from an absolute address to an absolute address Then only those branch tables which are really necessary are created when segment location addresses are determined Therefore it may happen that the number of branch tables recorded temporarily during linker processing exceeds the maximum number of approximately 1 000 even if branch tables are not actually created with the result that the linker aborts If this happens linkage should be performed again with the NTB linker option specified see 5 4 4 Description of linker options for the NTB option However if linkage is performed with the NTB option specified no branch tables will be created and thus a BRCB instruction which branches to another block will cause an error 139 5 3 CHAPTER 5 LINKER Linker Start Method 5 3 1 Starting the linker The linker is started by inputting the following command in the format shown in the OS command line 140 X gt LK75X option input file name _input file name __option X indicates the current driv
94. EG INBLOCK 23 0000 9921 MAIN SEL RB1 24 25 0002 R 00 GETI SEL15 STACK POINTER SET 26 0003 E 8900 MOV XA STACK 27 0005 9280 MOV SP XA 28 29 0007 73 MOV A 0011B 30 0008 93B3 MOV PCC A 0011B 31 339 APPENDIX D SAMPLE PROGRAMS DATA RAM OH 13FH ZERO CLEAR SEL MB1 MOV HL 3FH MOV XA 00H MOV HL A 100H 13FH DECS HL BR LOOP 1 SEL MBO MOV HL A OH FFH DECS HL BR LOOP2 TIMER SET SAMPLING TIME 30MSEC 4 19 2 001A R 00 SEL15 SEL MB15 001B 8979 MOV XA 79H 0010 92A6 MOV TMODO XA 001F 894 MOV XA 01001100B 0021 92A0 MOV TMO XA 340 APPENDIX D SAMPLE PROGRAMS 75X SERIES ASSEMBLER VX XX A D CONVERTER VX XX STNO ADRS OBJECT MAC 52 0023 9082 53 0025 9D9C 54 55 0027 9911 56 0029 8900 57 0028 9AOF 58 0020 9 87 59 0026 FD 60 0030 R 4000 61 0033 9210 62 0035 4000 63 0038 FO 64 65 66 67 68 0000 9A2E 69 0002 D9 70 0003 E6 71 0004 98 72 0005 D9 73 0006 98 74 0007 75 0008 F9 76 0009 EE 77 78 XX XX XX PAGE X SOURCE STATEMENT LOOP3 4 5 HEIKIN LOOP5 EI E SEL MOV MOV SKE BR CALL MOV CALL BR HEIKIN CSEG MOV XCH CLR1 RORC XCH RORC DECS BR RET END MB1 XA 00H B 0H B 08H LOOP4 IHEIKIN TDATA XA ISIOSUB LOOPS SAMPLE NUMBERS 8 SENT C 2H A X CY A A X A 5
95. EL RB1 GETI SEL15 STACK POINTER SET MOV XA STACK MOV SP XA MOV A 0011B MOV PCC A 0011 DATA RAM OH 13FH ZERO CLEAR SEL MB1 MOV HL MOV XA 00 LOOP1 MOV HL A 100H 13FH DECS HL BR 1 SEL MBO LOOP2 MOV HL A OH FFH DECS HL BR LOOP2 334 kk LOOP3 LOOP4 o 3 SEG3 HEIKIN LOOP5 APPENDIX D SAMPLE PROGRAMS SET SAMPLING TIME 30MSEC FXX 4 19MHz GETI MOV MOV MOV MOV EI EI oEL MOV MOV SKE BR CALL MOV CALL BR HEIKIN CSEG MOV XCH RORC XCH RORC DECS BR RET END SEL15 15 79H TMODO 01001100B IETO MB1 XA 0H B 00H B 08H LOOP4 IHEIKIN TDATA XA ISIOSUB SAMPLE NUMBERS 8 SENT C 2H A X CY A A X A 5 335 APPENDIX D SAMPLE PROGRAMS 2 75XTEST2 ASM TITLE A D CONVERT k lt lt lt lt lt lt x lt lt e lt lt ck e e e lt K K K K K K K K lt lt lt K lt K K k e e kA x lt kx J CONVERT PROGRAM idi ac ce lt e e ck e lt lt e ck e e e lt e ce K K e K K K lt e k k k e k e x x x J SEG4 SIOSUB SEGS ADCONV LOOP WAIT 336 NAME AD_SUB EXTRN DATA TDATA CODE SEL15 PUBLIC SIOSUB ADCONV STKLN 2 SIO SUB ROUTINE CSEG SENT PUSH BS SEL RB2 SEL MB1 MOV XA TDATA SEL15 SSEL MB15 MOV SIO XA MOV
96. ES LIST 1 ADCONV OOOOH R PUB SEG SEG5 8 27 BSBO OFCOH 31 32 33 39 43 LOOP 0009H R SEG SEG6 32 41 PTHO OFD4H 38 PTHM OFD6H 34 RBE OFBOH O 45 SEG4 0012H PUB REL SENT SEG5 0024H PUB REL SENT SEL15 SIO SIOM SIOSUB OOOOH R PUB SEG SEG4 TDATA EXT WAIT 0010H R SEG SEG5 TARGET CHIP UPD75106 STACK SIZE 0002H ASSEMBLY COMPLETE NO ERROR FOUND 347 APPENDIX D SAMPLE PROGRAMS 4 Link list linker control list input output module list segment list and symbol table list Output to 75bXTEST1 MAP 75X SERIES LINKER VX XX XX XX XX COMMAND 75XTEST1 REL 75XTEST2 REL 075XTEST LNK INPUT MODULE LIST TOXTEST 1 REL AD_MAIN 75XTEST2 REL AD_ SUB LOAD MODULE LIST 75XTEST LNK AD_MAIN SEGMENT LINK MAP FOR 75XTEST LNK AD_MAIN MAP OF ROM AREA BASE LENGTH MODULE NAME SEGMENT 0000H 0002H AD MAIN ABSOLUTE 0002H 0006H GAP 0008H 0002H AD_MAIN ABSOLUTE 0012H AD_SUB SEG4 SENT 001CH 0004H 0020H 0002H AD_MAIN SEG1 IENT 0022H 0024H AD_SUB SEG5 SENT 0046H 000AH AD MAIN SEG3 SENT 0050H 0039H AD MAIN SEG2 INBLOCK 0089H 16F7H GAP MAP OF RAM AREA TYPE BASE LENGTH MODULE SEGMENT OOOOH OOF4H GAP STACK OOF4H 000 AD_MAIN SSEG 0100H 0010H GAP DATA 0110H 0002H AD_MAIN SEGO 0112H 002 GAP 348 APPENDIX D SAMPLE PROGRAMS PUBLIC S
97. El El SEL15 SSEL 15 XA 79H TMODO XA XA 01001100B IETO MB1 XA 00H B 0H B 08H LOOP4 IHEIKIN TDATA XA ISIOSUB 227 CHAPTER 7 LIBRARIAN REPLACE replace lt 3 gt A new file CLIB LIB is created by LB75X and its contents are checked LIST CLIB LIB PUBLICS 75X Series Librarian VX XX DATE LIB FILE NAME 75XTEST LIB 1 AD MAIN UPDATE RA75X VX XX UPD75106 SEGO SEG1 SEG2 SEL15 TDATA NUMBER OF PUBLIC SYMBOLS 5 AD SUB UPDATE 0 RA75X VX XX UPD75106 ADCONV SEG4 SEG5 SIOSUB NUMBER OF PUBLIC SYMBOLS 4 NUMBER OF MODULES 2 4 CLIB LIB is replaced with 75XTEST LIB HEPLACE CLIB LIB FROM 75XTEST LIB 228 CHAPTER 7 LIBRARIAN REPLACE replace public symbol information in 75XTEST LIB after replacement is as follows LIST 75XTEST LIB PUBLICS 75X Series Librarian VX XX DATE LIB FILE NAME 75XTEST LIB 1 AD MAIN UPDATE RA75X VX XX UPD75106 SEGO SEG1 SEG2 SEL15 TDATA NUMBER OF PUBLIC SYMBOLS 5 AD SUB UPDATE RA75X VX XX UPD75106 ADCONV SEG4 SEG5 SIOSUB NUMBER OF PUBLIC SYMBOLS 4 NUMBER OF MODULES 2 229 CHAPTER 7 LIBRARIAN LIST list 5 LIST Description Format PUBLICS LIST Library file Object module List file name PUB PL PUBLICS L Library file name Object module IO List file name PUB
98. File used by the Project Manager Standard editor execution format command file File used by the Program Manager File used by the Project Manager File used by the standard editor Project Manager help file Standard editor help file Assembler Information file 75X device file Overlay file Project Manager supplementary explanations 75X dummy device file use Project Manager Setup log file idea L light sample program for training idea L light sample program for saving Assembler sample file Structured Assembler sample file Structured Assembler sample batch file Tools information file Project Manager prjtlog exe PIF file File used by the Project Manager Please copy the 75XL device file sold separately to this directory 59 CHAPTER 3 ASSEMBLER PACKAGE EXECUTION 60 4 Adjustment of CONFIG SYS file contents 5 Create a file CONFIG SYS in the root directory of the disk used to start up the host machine and include the following in it FILES n isa number indicating the maximum number of files that can be opened by one program 20 or more should be written in order to use the assembler package However a larger number than this may be necessary depending on what other programs editor etc are to be used concurrently with the assembler package Please check the manual etc for each program The following should also be specified in order to increase the program exec
99. GAL TYPE Amend to correct description 52 NO END STATEMENT IN SOURCE TEXT There is no END statement in source module Program processing Processing is continued with END statement assumed to be present at end of source module Program processing This statement is ignored as illegal statement LOCATION COUNTER OVERFLOW Location counter value exceeds ROM size maximum value of target device Program processing Processing is continued with counter overflow Ensure that maximum value is not exceeded Write END statement at end of source module OPERAND MUST BE ABSOLUTE OR IN THIS SEGMENT Cause Expression other than absolute expression has been written in operand or symbol not defined in same segment has been referenced Program processing With ORG CSEG DSEG DS pseudo instructions this statement is ignored as illegal statement Impermissible mnemonic has been written Program processing NOP codes are generated equivalent to longest code of target device as illegal statement Use permitted mnemonic a Impermissible symbol name is written in operand field of PUBLIC pseudo instruction 300 CHAPTER 13 ERROR MESSAGES Assembler s Error Message 5 SEGMENT SIZE OVERFLOW TO RELOCATION TYPE INBLOCK Segment with INBLOCK or INBLOCKA attribute exceeds one block range Program processing Processing is continued without further action Ensure that segment size is in one block range SEGMENT SIZE O
100. GAP STACK OOF4H 000CH SSEG PUBLIC SYMBOL LIST POR 75XTEST LNX TYPE VALUE MODULE SYMBOL NAME CODE 0022H AD SUB ADCONV DATA 0110H MAIN SEGO CODE 0020H AD MAIN SEGI1 SYMBOL LIST FOR 75XTEST LNK TYPE VALUE ATTRIBUTE NAME MODULE MAIN CODE 0046H SYMBOL HEIKIN PBIT OFBCH 1 SYMBOL IETO CODE 0060H SYMBOL LOOP CODE 0066H SYMBOL LOOP2 CODE 0079H SYMBOL LOOP3 CODE 007DH SYMBOL LOOP4 CODE 0048H SYMBOL LOOP5 CODE 0050H SYMBOL MAIN PBIT OFBOH 1 SYMBOL MBE DATA OFBS3H SYMBOL PCC 157 CHAPTER 5 LINKER KL NKL local symbols no local symbols Example 2 When the NKL option is specified The local symbol list is output 75X SERIES LINKER VX XX XX XX XX XX XX XX PAGE X COMMAND 75XTEST1 REL 75XTEST2 REL 075XTEST LNK KL SEGMENT LINK MAP FOR 75XTEST LNK AD_MAIN MAP OF ROM AREA LENGTH MODULE NAME SEGMENT NAME TYPE AD_MAIN MAP OF RAM AREA BASE LENGTH OOOOH OOF4H OOF4H 000CH PUBLIC SYMBOL LIST FOR 75XTEST LNK VALUE MODULE SYMBOL NAME 0022H SUB ADCONV 0110H MAIN SEGO 0020H AD MAIN SEG LINK COMPLETE NO ERROR FOUND 158 CHAPTER 5 LINKER CD code Description Format CD segment name address Default Interpretation Relocatable code segment is located automatically by linker Function The CD option specifies the location address of a relocatable code segment or specifies the location order for multiple code se
101. HAPTER 4 ASSEMBLER C chip Notes 1 Under development The addresses 1FOH 1FFH are allocated by the display memory The addresses 1ECH 1FFH are allocated by the display memory The addresses 1EOH 1F7H are allocated by the display memory The addresses 1ECH 1F7H are allocated by the display memory The addresses 1EOH 1F7H are allocated by the display memory Addresses 0400H 041FH are allocated by EEPROM qe Examples Example 1 When the C option is omitted A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM 75X Series Assembler VXX XX XX Xxx xx Copyright C NEC Corporation 1985 XXXX ERROR A099 CHIP IS NOT SELECTED C000A 000 004 006 008 028 036 048 064 066 068 104 106 108 108 112 116 116 117 206 208 CG208 212A 216A CG216A 21 7 21 8 236 237 238 268 304 306 308 31 2 312B 316 316A 316B 328 336 352A 402 512 516 517 518 617A 0004 0006 0008 0016 3012 3016 3017 P3018 3104 3106 3108 P3116 Program aborted Note The installed 75XL Series device files are displayed In this example an error is generated since the C option is omitted and program execution is aborted Example 2 When a 75104 75104 source program is assembled A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM C104 85 CHAPTER 4 ASSEMBLER M MODE Description Format M mode Default Interpretation Omission Impossible 75XL Series Function The M option specifies the 75XL Series CPU mode Use e
102. INBLOCK 160 CHAPTER 5 LINKER CD code Example 2 When the CD option is specified for segments SEG2 and SEG3 The segments are located at the addresses specified by the CD option SEGMENT LINK MAP FOR 75XTEST LNK AD MAIN MAP OF ROM AREA LENGTH MODULE NAME SEGMENT NAME TYPE AD_MAIN ABSOLUTE AD_MAIN ABSOLUTE AD_SUB SENT AD_MAIN IENT AD_SUB SENT AD_MAIN INBLOCK AD_MAIN SENT 161 CHAPTER 5 LINKER RS reserve 7 RS Description Format RS start address end address Default Interpretation RS ROM area not incorporated in target device Function he RS option specifies the area of program memory ROM in which code segment location is prohibited using the start and end addresses Use e The RS option is specified when there is an area in the ROM area in segments are not to be located Description The linker does not locate code segments in the area specified by the RS option The start address and end address can be specified in binary octal decimal or hexadecimal notation The following condition must apply start address lt end address Caution When numeric specification is omitted by RS option It is assumed that OH has been specified for the omitted part Therefore a numeric specification should not be omitted during RS option specification Example A gt LK75X TEST RS 100H 200H When described as above address OH t
103. MAIN 16F7H BASE LENGTH OOOOH OOF4H OOF4H 000CH 0100H 0010H 0110H 0002H 0112H 002bEH PUBLIC SYMBOL LIST POR 75XTEST LNK SEG4 GAP SEG1 SEG5 SEGS3 SEG2 GAP MODULE NAME AD MAIN AD MAIN ABSOLUTE ABSOLUTE SENT IENT SENT SENT INBLOCK lt lt o SEGMENT NAME Segment Map List Input Output Module List 151 CHAPTER 5 LINKER KM NKM map no map Caution In this example no branch table is created and therefore a branch table map list is not output even though the KM option is specified 152 CHAPTER 5 LINKER KP NKP publics no publics 4 KP NKP Description Format KP NKP Default Interpretation KP Function e The KP option specifies that a public symbol list is to be output to the link list file e The NKP option specifies that a public symbol list is not to be output Use The KP option is specified when it is wished to ascertain information such as the symbol names and values of symbols defined by a PUBLIC pseudo instruction in an input segment the names of defined modules etc If the NKP option is specified the linkage processing time is shortened somewhat Description e The public symbol list output destination is specified by the P option e f the NP is specified the KP option is invalid and a public symbol list is not output Examples Example 1 When the KP option is specified A NEC
104. MOV XA 79H MOV TMODO XA MOV 01001100 MOV 109 CHAPTER 4 ASSEMBLER LL LW 75X SERIES ASSEMBLER VX XX CONVERTER VX XX STNO ADRS R OBJECT IC MAC 52 0023 9DB2 o3 0025 9D9C 54 55 0027 9911 56 0029 8900 57 002 9AOF 58 0020 9A87 59 002F FD 60 0030 R AB4000 61 0033 9210 62 0035 E AB4000 63 0038 FO 64 65 n 66 67 68 0000 9A2E 69 0002 D9 70 0003 E6 71 0004 98 72 0005 D9 73 0006 98 74 0007 CE 75 0008 F9 76 0009 EE 77 78 TARGET CHIP UPD75106 STACK SIZE 000AH ASSEMBLY COMPLETE NO ERROR FOUND 110 LOOP3 LOOP4 SEG3 HEIKIN LOOP5 El El SEL MOV MOV SKE BR CALL MOV CALL BR HEIKIN CSEG MOV XCH RORC XCH RORC DECS BR RET END page length page width XX XX XX PAGE X SOURCE STATEMENT IETO 1 XA 00H B 0H B 08H LOOP4 IHEIKIN TDATA XA ISIOSUB SAMPLE NUMBERS 8 a SENT C 2H A X CY A A X A LOOPS CHAPTER 4 ASSEMBLER LT TAB 15 LT Description Format LT number of characters Default Interpretation LT8 Function This option informs the assembler of the number of space characters 20H to which TAB codes 09H in the source module are to be expanded when the assembly list is generated Use TAB codes in the source module are expanded to a number of space characters when output to the assembly list This option is used to set the maximu
105. MOV XA STACK MOV A 0011B MOV 0011 d DATA RAM 0H 13FH ZERO CLEAR x SEL MB1 MOV HL 3FH MOV XA 00H LOOP1 MOV HL A 100H 13FH DECS HL BR LOOP SEL MBO LOOP2 MOV HL A OH FFH DECS HL BR LOOP2 222 replace CHAPTER 7 LIBRARIAN REPLACE replace TIMER SET SAMPLING TIME 30 MSEC FXX 4 19 MHZ 5 15 SSEL 15 MOV XA 79H MOV TMODO XA MOV XA 01001100B MOV El IETO MB1 XA 00H B 0H B 08H LOOP4 IHEIKIN TDATA XA ISIOSUB lt 3 gt Modules in library file 75XTEST LIB are replaced REPLACE 75XTEST1 FROM 75XTEST LIB 223 CHAPTER 7 LIBRARIAN REPLACE replace lt 4 gt Check the contents of the public symbols in the library file 75XTEST LIB after replacement LIST 75XTEST LIB PUBLICS 75X Series Librarian VX XX DATE LIB FILE NAME 75XTEST LIB 1 AD MAIN UPDATE 0 SEGO SEG1 SEG2 SEG15 TDATA NUMBER OF PUBLIC SYMBOLS 5 AD SUB UPDATE 0 ADCONV SEG4 SEG5 SIOSUB NUMBER OF PUBLIC SYMBOLS 4 NUMBER OF MODULES 2 RA75X VX XX UPD75106 RA75X VX XX UPD75106 The AD MAIN public symbols in the library 75XTEST LIB before replacement are changed in 75XTEST1 224 after replacement as follows Before replacement SEGO SEG1 SEG2 SEG3 SEL15 TDATA NUMBER OF PUBLIC SYMBOLS 6 After replacement SEG0 SEG1 SEG2 SEL15 TDATA
106. NCE NO ADDRESS ADDRESS ADDRESS BB Descriptions of Output Items Output file name load module file Branch table location bank value 2 hexadecimal digits Address in block 4 hexadecimal digits Target device ROM size Up to 16K BR Over 16K BRA Reference symbol name left justified Definition segment name when an intra module local symbol is referenced Reference address value in case of absolute address reference Reference symbol modification value 4 hexadecimal digits Blank in case of absolute address reference Reference start address 4 hexadecimal digits lt Reference start segment name left justified in case of absolute address reference 3 lt 4 gt lt 5 gt lt 6 gt 8 gt 281 CHAPTER 11 PROGRAM OUTPUT LISTS 11 2 5 Public symbol list symbol table list Information on public symbols and local symbols is output in these lists Output Format PUBLIC SYMBOL LIST FOR lt 1 gt TYPE VALUE MODULE SYMBOL NAME lt 2 gt lt 3 gt EN SYMBOL LIST FOR TYPE VALUE ATTRIBUTE NAME 2 3 Descriptions of Output Items Output file name load module file BIT Bit symbol Code symbol Symbol attribute names DATA Data symbol left justified NUMBER Constant symbol PBIT Port bit symbol STACK Stack symbol Symbol value 4 hexadecimal digits Name of defined symbol left justified
107. Note Includes the name of the source file set automatically by the project manager and the number of option characters Cautions 1 The Source Options Delete button is displayed in reverse video and cannot be selected 2 When setting options no check is made for errors in the option description Errors in the option description become errors during build 10 1 3 Object converter 1 Options Menu Items Options menu items set from the project manager are shown below 267 CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER Figure 10 8 Options Setting Menu Object Converter Project Manager TEST PRJ j Option sas cae 1 Structured assembler options Assembler options Linker options Object converter options Tools Debug Status Bar Tool Box Source List 2 Options Setting Dialog Box 268 Following is an explanation of the set object converter options dialog box From the Menu items select Options gt Set Object Converter Options menu to open the set object converter options dialog box Figure 10 9 Options Setting Dialog Box Object Converter Object converter option setup Delete source option Cancel Help object converter Option CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER Table 10 4 Options Setting Dialog Box Functions Object Converter OK button Sets the options and closes the dialog box If the
108. O XX XX XX XX XX XX PAGE X OFFSET TYPE SYMBOL OFBCH 1 PBIT IETO 002DH 0039H OF80H OFA6H CODE LOOP4 DATA PCC CODE PUB SEG2 DATA SP DATA TMOD0 1SI y ur 1ndino SI s 4 eu S N S ou sjoqw s 5 v HdldVHO CHAPTER 4 ASSEMBLER KX NKX cross reference no cross reference 10 KX NKX Description Format Default Interpretation Function The KX option specifies that a cross reference list is to be output to the assembly list file The NKX option specifies that a cross reference list is not to be output Use e The KX option is specified when it is wished to ascertain such information as how often a symbol defined in the source module file list is referenced in the source module in which lines of coding in the assembly list that symbol has been referenced and so forth For example if the location at which a symbol which defines a subroutine entry address is known it is possible to find immediately where that subroutine was called Description e f the NP option is specified the KX option is invalid e The cross reference list is output at the end of the assembly list file a file containing only the cross reference list is not output Example f 75XTEST1 ASM is assembled with the KX option specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM C106 K
109. OOP4 5 MAIN MBE PCC RBE SEGO SEG1 SEG2 SEG3 SEL15 SP TDATA TMO TMODO LINK COMPLETE NO ERROR FOUND CHAPTER 4 ASSEMBLER GA NGA debuga no debuga 6 GA NGA Description format GA NGA Default Interpretation GA Function e The GA option instructs to output object module files output by the Assembler with source debugging information added The NGA option instructs to output object module files output by the Assembler without source debugging information added Use Specify the NGA option when desiring to generate object module files without source debugging information added Description When NO option is specified the GA option becomes invalid Example Assemble 75XTEST1 ASM with the NGA option specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM C106 NGA 94 The object module file 75XTEST1 REL is output without source debugging information added Caution 1 75000 and IE 75001 R do not support source debugging so specify the NGA option CHAPTER 4 ASSEMBLER P NP print no print 7 P NP Description Format P output file name NP Default Interpretation input file name PRN is created in current path Function The P option specifies the output destination and file name of the assembly list file output by the assembler The NP option specifies that no assembly list file is to be created Us
110. Out of address range The load module file s object address exceeds the limit Execution of the program continues as is Specify the output object area correctly yyyyH overlapped The object is overlapping with respect to the addresses between xxxx and yyyy Output the object as is and continue processing Using expansion space etc link and correct so that no object is output that is overlap ping with respect to the same address in the same address space CHAPTER 13 ERROR MESSAGES 13 4 Librarian Error Messages 1 Error message for fatal file I O errors Format FATAL I O ERROR DEVICE device name FILE NAME file name ERROR error message PROGRAM ABORTED There is insufficient directory area for writing files on disk Increase disk area Specify correct device name Program processing Control is returned to OS 317 CHAPTER 13 ERROR MESSAGES 2 Error message for start command Format ERROR error number error message PROGRAM ABORTED Librarian s Error Messages F007 Cause Parameter has not been specified for control which requires parameter or illegal m Cause FOO9 Cause Syntax error in start command Program processing Control is returned to OS Specify command file name and control correctly then re execute Error No Message FILE NOT FOUND file name 318 CHAPTER 13 ERROR MESSAGES 3 Error messages in librarian processing For
111. Process Assembly Process of this Package Heassembly Process Program Creation Using Previously Written Modules Program Development Procedure Using Assembler Source Module File Creation Structured Assembler Preprocessor Functions EIDE Or FUNCION uuu US Object Converter FUNGUOM M E Librarian Function TOUT List Converter Library Converter Sample Program Construction MEO Assembler Package Execution Procedure Assembler Input Output Linker input Output Files RTT Object Converter Input Output Files ccdecrcseccscncasccenassndncencacceesnesdenaseenetachaccecasaad Librarian Input Output List Converter Input Output Files Example of List Converter Input Output Files Library Converter Input Output Files 2 Options Setting Menu Assembler Options Se
112. RA75X Structured Assembler Preprocessor User s Manual U12598E RA75X Structured Assembler Preprocessor EEA 1203 12 CONTENTS CHAPTER 1 GENERAL DESCRIPTION U 1 1 Outline of Assembler 1 1 1 The function of an assembler RI 1 1 2 Function of a relocatable assembler 1 2 Outline of Assembler Package Functions 1 1 1 2 1 Source module file creation using editor 1 2 2 Structured assembler preprocessor a D Ass0Olfiberuu 1 2 4 Fill EEE E A E A SD E u S E EE E E A 1 2 5 Object converter m 1 2 6 Wels u Mmm 1 2 7 L PEON I puyu u uuu TE 1 2 8 OMS u 1 3 Before Beginning Program 1 3 1 Assembly time source statements 1 3 2 Limitation on number of symbols 1 3 3 Limitations on
113. RIBUTE NAME MODULE AD_MAIN 0046H SYMBOL HEIKIN OFBCH 1 SYMBOL 0060H SYMBOL LOOP 0066 SYMBOL LOOP2 155 CHAPTER 5 LINKER KL NKL local symbols no local symbols 5 KL NKL Description Format KL NKL Default Interpretation KL Function The KL option specifies that local symbol list is to be output to the link list file e The NKL option specifies that a local symbol list is not to be output Use The KL option is specified when it is wished to ascertain information such as the symbol attribute value and type of all the symbols defined in an input segment e f the NKL option is specified the linkage time is shortened somewhat Description e The symbol list output destination is specified by the P option f the NP is specified the KL option is invalid and therefore a symbol list is not output Examples Example 1 When the KL option is specified A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK KL 156 CHAPTER 5 LINKER KL NKL local symbols no local symbols The local symbol list is output 75X SERIES LINKER VX XX XX XX XX XX XX XX PAGE X COMMAND 7Z5XTEST1 REL 75XTEST2 REL 075XTEST LNK KL SEGMENT LINK MAP FOR 75XTEST LNK AD MAIN MAP OF ROM AREA BASE LENGTH MODULE SEGMENT NAME TYPE OOOOH 0002H AD_MAIN ABSOLUTE 0002H 0006H GAP MAP OF RAM AREA TYPE BASE LENGTH MODULE NAME SEGMENT NAME OOOOH OOF4H
114. RTER 8 2 1 Incorporation of location addresses Offset addresses with OOOOH as the start of the segment are incorporated as relocatable segment addresses in the assembly list output by the assembler The list converter incorporates absolute location addresses determined during linkage in place of these relocatable location addresses Example Following assembly list is input to the list converter lt Assembly list gt INBLOCK RB1 SEL15 STACK POINTER SET STACK SP XA A 0011B PCC A lt 0011 Temporary values incorporated the location addresses Absolute addresses are incorporated during linkage in the location addresses and output as an absolute assembly list lt Absolute assembly list gt SEG2 CSEG INBLOCK MAIN SEL RB1 GETI SEL15 STACK POINTER SET MOV XA STACK MOV SP XA MOV A 0011B PCC A lt 0011B Absolute addresses incorporated 238 CHAPTER 8 LIST CONVERTER 8 2 2 Incorporation of object code Temporary values with OOH used as the data value indicated by relocatable symbols are incorporated in the object code of instructions which reference relocatable symbols including external reference symbols in the assembly list output by the assembler The list converter replaces this temporary object code with the correct object code determined during linkage Example Following assembly list is input to the list converter lt Assembly list gt
115. STS This chapter shows the format etc of the various lists output by each program in the assembler package 271 CHAPTER 11 PROGRAM OUTPUT LISTS 11 1 Assembler Output Lists The assembler outputs the following lists Assembly list Symbol table list Cross reference list e Error list The assembly list symbol table list and cross reference list are output to the assembly list file The error list is output to the error list file Assembly List File Error List File Assembly list Error list Symbol table list e Cross reference list 272 CHAPTER 11 PROGRAM OUTPUT LISTS 11 1 1 Assembly list The assembly results are output in this list together with any error messages only if there are errors Output Format 75X SERIES ASSEMBLER Vx xx lt 1 gt PAGE lt 2 gt kk COMMAND COMMAND FILE 42 IC LINE ADDR R OBJECT ASSEMBLER SOURCE ORIGINAL SOURCE 1 0001 0000 R 12345678 lebel mnem operand slebel mnem operand 0001 0000 R 12345678 lebel mnem operand 0002 0000 12345678 lebel mnem operand operand lebel mnem operand operand 0003 SINCLUDE A1 INC 1 0001 SINCLUDE A2 INC 2 0001 SINCLUDE A3 INC 3 0001 a asm 1 001 SYNTAX ERROR 4 0001 4 0001 hhhh a XXXXXXXX SSSSSSSSSSSS 8888888888SS UUUU UUUU lt 6 gt lt 7 gt 8 9 10 lt 11 gt lt 12 gt SOURCE FILE A ASM INCLUDE FILE A1 INC 1 A2 INC 2 A3 INC 3 MACRO FILE EXMAC
116. TATE LAE A 66 69 193 351 POATE TLIE E 67 69 209 211 214 215 217 218 219 221 223 224 225 66 69 149 150 194 249 TATE VES e 67 353 TPM VIA 66 69 194 348 66 69 213 352 7551ESTI ASNI Lu aus 63 64 69 87 89 90 92 94 96 98 98 100 102 106 168 224 228 TE ae usnu E 68 69 249 I ID M ee Pee ee u 64 69 249 ns S S SSS Mm 64 65 69 92 94 96 63 65 69 92 93 168 P6 Acl 69 359 ECT TPC P 65 69 249 ri iz H 65 69 92 367 MEMO 368 Although NEC has taken all possible steps 5 to ensure that the documentation supplied to our customers is complete bug free and up to date we readily accept that From errors may occur Despite all the care and precautions we ve taken you may Name encounter problems in the
117. TITLE A D CONVERTER VX XX SUB A D CONVERT PROGRAM NAME AD SUB EXTRN CODE SEL15 EXTRN DATA TDATA PUBLIC SIOSUB ADCONV STKLN 2 SEG4 SIOSUB SEGS ADCONV LOOP WAIT SIO SUB ROUTINE mee CSEG PUSH SEL SEL MOV MOV MOV MOV POP RET ANALOG INPUT CSEG PUSH MOV MOV MOV SET1 MOV MOV MOV INCS BR SENT BS RB2 MB1 XA TDATA SEL15 SIO XA XA 11101110B SIOM XA CLOCK 262KHZ MSB BS SSEL MB15 0 SENT BS SEL15 HL 0D3H 0 BSBO BSBO L A BSBO COMP START A 0AH 18 MACHINE A CIRCLE WAIT WAIT 15 lt 359 APPENDIX D SAMPLE PROGRAMS CY H PTHO 0 BSBO L CY L LOOP X A BSBO XA XXA ADD DATA RBE BS SAMPLE COUNT INC 360 196 75X SERIES ASSEMBLER VX XX CONVERTER VX XX SUB SYMBOL TABLE LIST OFFSET TYPE SYMBOL OFFSET AD_MAIN 0000H PTHO PUB SEG5 PUB SIOSUB TYPE CODE DATA CODE DATA SYMBOL PUB ADCONV PTHM EXT SEL15 EXT TDATA XX XX XX XX XX XX PAGE X OFFSET TYPE SYMBOL OFCOH DATA BSB0 OFBOH O RBE OFE4H DATA SIO 0010H CODE WAIT OFFSET TYPE SYMBOL 0009 CODE LOOP 0012H CODE PUB SEG4 OFEOH DATA SIOM AIdNVS XIGNAddV APPENDIX D SAMPLE PROGRAMS 75X SERIES ASSEMBLER VX XX XX XX XX XX XX XX PAGE X A D CONVERTER VX XX SUB
118. TOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK KP 153 CHAPTER 5 LINKER KP NKP publics no publics The public symbol list is output 75X SERIES LINKER VX XX XX XX XX XX XX XX PAGE X COMMAND 7Z5XTEST1 REL 75XTEST2 REL 075XTEST LNK KP SEGMENT LINK MAP FOR 75XTEST LNK AD MAIN MAP OF ROM AREA BASE LENGTH MODULE NAME SEGMENT NAME TYPE OOOOH 0002H AD_MAIN ABSOLUTE 0002H 0006H GAP MAP OF RAM AREA TYPE BASE LENGTH MODULE NAME SEGMENT NAME OOOOH OOF4H GAP STACK OOF4H 000CH SSEG PUBLIC SYMBOL LIST POR 75XTEST LNK TYPE VALUE MODULE SYMBOL NAME CODE 0022H AD_SUB ADCONV DATA 0110H AD_MAIN SEGO CODE 0020H AD MAIN SEGI1 CODE 0050H AD MAIN SEG2 CODE 0046H AD_MAIN SBG3 CODE 000AH AD SUB SEGA CODE 0022H SUB SEG5 CODE 0020H AD MAIN SEL15 CODE 000AH AD SUB SIOSUB DATA 0100H SIACK DATA 0110H MAIN TDATA SYMBOL LIST FOR 75XTEST LNK TYPE VALUE ATTRIBUTE NAME MODULE AD MAIN CODE 0046H SYMBOL HEIKIN 154 CHAPTER 5 LINKER KP NKP publics no publics Example 2 When the NKP output is specified The public symbol list is output 75X SERIES LINKER VX XX XX XX XX XX XX XX PAGE X COMMAND 75XTESTI REL 75XTEST2 REL 075XTEST LNK NKP SEGMENT LINK MAP FOR 75XTEST LNK AD_MAIN MAP OF ROM AREA BASE LENGTH MODULE NAME SEGMENT NAME TYPE OOOOH 0002H AD_MAIN 0002H 0006H MAP OF RAM AREA LENGTH AD_MAIN SYMBOL LIST FOR 75XTEST LNK TYPE VALUE ATT
119. Table 3 11 Combination used of items and operators external reference items according to relocation attributes Cautions concerning library converter Chapter 9 Library options Converter Object modules included in library files converted by the Library Converter cannot be debugged Cautions concerning the assembler Set options as shown below 4 options NGA CA NS GA NGA IE 75000 R and IE 75001 R CA NCA respond to source debugging Also S NS there is no distinguishing between upper case and lower case letters in symbol names Only symbol names with lengths of 8 characters will be recog nized 332 APPENDIX SAMPLE PROGRAMS This chapter describes some of sample lists of programs etc that are used in assembler package 333 APPENDIX D SAMPLE PROGRAMS D 1 Source Lists 1 75XTEST1 ASM TITLEZ A D CONVERT acce lt lt lt lt lt lt e lt lt lt lt e ck e e e e lt K K K K K K K lt lt lt K lt e k K e kA lt lt lt lt 1 CONVERT PROGRAM k lt lt lt e lt lt lt K lt lt lt lt e e ERK lt e K K K K K K K lt lt e ke K k lt k lt lt lt x 3 NAME AD MAIN EXTRN CODE SIOSUB ADVONC PUBLIC TDATA SEL15 STKLN 10 VENT MBE 1 RBE 1 MAIN VENT 4 MBE 1 RBE 0 ADCONV SEGO DESG 1 AT 10H TDATA DS 2 GET1 TABLE SEG CSEG IENT SEL15 SEL MB15 MAIN ROUTINE SEG2 CSEG INBLOCK MAIN S
120. The error line back number in the assembly list is indicated as shown below ERROR xxx STNO 1111 0000 ERROR MESSAGE ERROR STNO mmmm 1111 ERROR MESSAGE ERROR STNO nnnn mmmm ERROR MESSAGE ASSEMBLY COMPLETE tt ttt ERROR S FOUND nnnn 1 First error line 2 Next error line 3 Next error line 4 Last error line Using the error line back number indication enables lines in which errors are generated to be added in the order nnnn gt mmmm 1111 from the end of the list file 290 CHAPTER 12 EFFECTIVE USE OF THE ASSEMBLER PACKAGE 12 4 Example of Use of Batch File In the assembly package an error status code is returned according to the error level If an error status code is used assembly can be performed efficiently using a batch file An example is given here of performance of the following processing 1 Batch file BAT BAT processing flow Dmm assembler assembler assembler Linker TEST LNK TEST HEX Object converter Y Y TEST2 P TEST3 P List converter TEST1 P 291 CHAPTER 12 EFFECTIVE USE OF THE ASSEMBLER PACKAGE 2 Sample program BAT BAT ECHO OFF SET LEVEL 0 ST75X TEST1 SRC RA75X TEST1 ASM C106 IF ERRORLEVEL 1 SET LEVEL 1 ST75X TEST2 SRC RA75X TEST2 ASM C106 IF ERRORLEVEL 1 SET LEVEL 1 ST75X TEST3 SRC RA75X TEST3 ASM C106 IF ERRORLEVEL 1 SET LEVEL 1 CLS IF
121. VERFLOW TO RELOCATION TYPE XBLOCK Segment with XBLOCK or XBLOCKA attribute exceeds ROM range permitted for target device Odd address has been written as operand Processing is continued with operand value taken as 0 Change operand value to appropriate even address O O O 6 N 6 6 6 6 N 6 7 O 7 N 301 CHAPTER 13 ERROR MESSAGES Assembler s Error Message cont d THIS INSTRUCTION IS NOT ALLOWED AT ODD ADDRESS TBR and TCALL pseudo instructions have been allocated to odd address 73 Cause Program processing Processing is continued with this statement regarded as illegal statement User action Allocate TBR TCALL pseudo instructions to appropriate even address TOO MANY ERRORS TO REPORT Cause There are too many errors in this statement 9 or more errors 74 Message Program processing Processing is continued without outputting 9 or more error messages User action No action required 100 Message PHASE ERROR The symbol value has changed during assembly e When a BR pseudo instruction is located on a block boundary correct location addresses cannot be obtained in the subsequent assembly and therefore an error is output Cause e When there is an error in a statement which contains a symbol reference the values of symbols defined in lines afte
122. Vx xx lt 1 gt PAGE lt 2 gt kk SYMBOL TABLE LIST OFFSET TYPE SYMBOL OFFSET TYPE SYMBOL XXxxH rrr xxxxH tttttt rrr 4 lt 5 gt 4 Descriptions of Output Items System date Output list page number in decimal notation Title value specified by TITLE control instruction Blank if there is not TITLE control instruction specification Symbol value shown as 4 hexadecimal digits In case of segment name segment size shown as 4 hexadecimal digits Symbol attribute NUMBER Constant symbol PBIT Port bit symbol MACRO Macro name EXT External reference symbol name Symbol reference format PUB External definition symbol name A Local symbol name BIT Bit symbol CODE Code symbol DATA Data symbol 3 lt 4 gt lt 5 gt 6 gt lt 7 gt Symbol name 275 CHAPTER 11 PROGRAM OUTPUT LISTS 11 1 3 Cross reference list The locations line numbers at which symbols are referenced in the source program are output in this list Output Format 75X SERIES ASSEMBLER Vx xx lt 1 gt PAGE lt 2 gt kk CROSS REFERENCE LIST SYMBOL TYPE VALUE ATTRIBUTES XREF LIST XXXX A RRRAA nn nn 265 29 zs 20s lt 10 gt Descriptions of Output Items System date Output list page number in decimal notation 3 Title value specified by TITLE control instruction Blank if there is no TITLE control instruction 5 BIT Bit symbol CODE
123. X COMMAND 75XTEST1 ASM C106 KS KX STNO ADRS R OBJECT IC SOURCE STATEMENT 1 TITLE A D CONVERTER VX XX 3 i A D CONVERT PROGRAM 4 aed 5 NAME 6 EXTRN CODE ADCONV CODE SIOSUB 7 PUBLIC SEL15 8 STKLN 10 9 0000 000 VENTO 1 RBE 1 MAIN 10 0008 E 8000 VENT4 MBE 1 RBE 0 ADCONV 11 12 SEGO DSEG 1AT 10H 13 0110 TDATA DS 2 14 15 p GETI TABLE a 16 17 SEG1 CSEG IENT 18 0020 991F SEL15 SEL MB15 19 20 p MAIN ROUTINE add 21 22 SEG2 CSEG JNBLOCK 23 0050 9921 MAIN SEL RB1 24 25 0052 10 GETI SEL15 STACK POINTER SET 26 0053 E 8900 MOV XA STACK 27 0055 9280 SP 28 29 0057 73 MOV A 0011B 30 0058 93B3 MOV PCC A 0011 31 32 d DATA RAM 0H 13FH ZERO CLEAR i 33 34 005A 9911 SEL MB1 354 APPENDIX D SAMPLE PROGRAMS HL 3FH XA 00H HL A 100H 13FH HL LOOP 1 MBO HL A HL BR LOOP2 TIMER SET SAMPLING TIME 30MSEC FXX 4 19MHZ 006A R 00 SEL15 SEL MB15 006B 8979 MOV XA 79H 0060 92A6 MOV TMODO XA OO6F 894C MOV XA 01001100B 0071 92A0 MOV TMO XA 355 APPENDIX D SAMPLE PROGRAMS 75X SERIES ASSEMBLER VX XX A D CONVERTER VX XX STNO ADRS R OBJECT IC MAC 52 0073 9082 53 0075 9D9C 54 55 0077 9911 56 0079 8900 57 007 9AOF 58 0070 9A87 59 007F FD 60 0080 R AB4046 61 0083 9210 62 0085 E AB400A 63 008
124. X ERROR A099 CHIP IS NOT SELECTED C000A 000 004 006 008 028 036 048 064 066 068 104 106 108 108 112 116 116 117 206 208 CG208 212A 216A CG2164A 217 218 236 237 238 268 304 306 308 312 312B 316 3164 316B 328 336 352A 402 512 516 517 518 617A 0004 0006 0008 P001 6 3012 3016 3017 3018 3104 3106 3108 3116 Program aborted Note The 75XL Series device file in the same directory as the assembler main program is displayed In this example an error is generated since the C option for specification of the target product has not been specified and assembly is aborted When the assembler outputs an error message and aborts assembly the cause of the error message should be found in 13 1 Assembler s Error Messages and appropriate action taken 75 CHAPTER 4 ASSEMBLER 4 3 3 Assembler error handling If the assembler detects an error during execution it performs one of the following three kinds of processing according to the severity of the error 1 Abort error If the assembler is generated which prevents program execution from continuing the program displays a Program aborted message and the program is aborted immediately 2 Fatal error If an error is generated which would result in generation of object code different from that intended by the user the program nevertheless continues processing to the end then outputs the message ASSEMBLY COM PLETE X ERRORS FOUND where X is the num
125. X 100 CHAPTER 4 ASSEMBLER KX NKX cross reference no cross reference The following type of cross reference list is output in the Assemble List File 75X SERIES ASSEMBLER VX XX XX XX XX XX XX XX PAGE X A D CONVERTER VX XX CROSS REFERENCE LIST SYMBOL TYPE VALUE ATTRIBUTES XREF LIST AD MAIN 1 ADCONV CODE EXT 6 10 HEIKIN CODE OOOOH R SEG SEG3 60 68 PBIT OFBCH 1 53 1 0010H R SEG SEG2 37 39 LOOP2 CODE 0016H R SEG SEG2 41 43 LOOP3 CODE 0029H R SEG SEG2 56 63 LOOP4 CODE 002DH R SEG SEC2 58 59 LOOP5 CODE 0002H R SEG SEG3 69 75 MAIN CODE 0000H R SEG SEG2 9 23 MBE PBIT OFBOH 1 9 10 30 RBE PBIT OFBOH O 9 10 SEGO DATA 0002H PUB ABS 12 SEG1 CODE 0002H PUB REL IENT 17 SEG2 CODE 0039H REL 22 SEG3 CODE 000AH PUB REL SENT 67 SEL15 CODE 0000H PUB SEG SEG1 7 18 25 47 SIOSUB CODE EXT 6 62 SP DATA OF80H 27 STACK STACK EXT 26 TDATA DATA 0110H PUB ABS 7 13 61 TMO DATA 91 TMODO DATA OFA6H 49 TARGET CHIP UPD75106 STACK SIZE 000AH ASSEMBLY COMPLETE NO ERROR FOUND 101 CHAPTER 4 ASSEMBLER CA NCA cap no cap x 11 Description Format CA NCA Default Interpretation NCA Function e The CA option specifies not to distinguish the upper and lower case letters of symbol name The NCA option specifies to
126. X XX PAGE X CONVERTER VX XX COMMAND 75XTEST1 ASM C106 LL40 LW80 STNO ADRS R OBJECT IC SOURCE STATEMENT TITLEZ A D CONVERTER VX XX k lt lt lt lt lt lt lt lt lt lt lt lt c ck e e e lt lt K K K K lt K K KKK lt lt K K lt K lt K K K lt lt lt lt lt e K k k K k k lt kx A A D CONVERT PROGRAM ii NAME AD MAIN EXTRN CODE ADCONV CODE SIOSUB PUBLIC TDATA SEL15 STKLN 10 VENTO MBE 1 RBE 1 MAIN VENT4 MBE 1 RBE 0 ADCONV CON DO DSEG 1AT 10H DS 2 TABLE id CSEG IENT SEL MB15 MAIN ROUTINE CSEG INBLOCK SEL HB1 SEL15 STACK POINTER SET 106 CHAPTER 4 ASSEMBLER LL LW page length page width 75X SERIES ASSEMBLER VX XX XX XX XX XX XX XX PAGE X A D CONVERTER VX XX STNO ADRS R OBJECT IC SOURCE STATEXENT 26 0003 E 8900 MOV XA STACK 27 0005 9280 MOV lt 28 29 0007 73 MOV A 0011B 30 0008 MOV PCC A 0011B 31 32 DATA 0H 13FH ZERO CLEAR 33 34 SEL 1 35 HL 3FH 36 MOV XA 00H 37 MOV 100H 13FH 38 DECS HL 39 BR 1 40 SEL MBO 41 MOV 42 DECS HL 43 BR LOOP2 44 45 TIMER SET SAMPLING TIME 30MSEC 4 Example 2 The LL and LW options are omitted A NECTOOLS SMP75X RA75X gt RA75X 75XTESTILASM C106 The assembly list is output as follows 107 LL LW CHAPTER 4 ASSEMBLER page length page
127. XA 11101110B MOV SIOM XA CLOCK 262kHz MSB POP BS RET ANALOG INPUT RBE 0 CSEG PUSH MOV SET1 MOV MOV MOV INCS BR 1 1 DECS BR MOV MOV ADDS SET1 POP INCS SENT BS SEL15 15 HL 0D3H 0 BSBO BSBO lt BSBO L A BSBO PTHM XA COMP START A 0AH 18 MACHINE A CIRCLE WAIT WAIT CY BSBO L CY L LOOP X A BSBO XA XA ADD DATA RBE BS B SAMPLE COUNT INC APPENDIX D SAMPLE PROGRAMS D 2 Execution Examples A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM C106 KS KX 75X Series Assembler VX XX XX Xxx XX Copyright NEC Corporatton 1985 ASSEMBLY START TARGET CHIP UPD75106 STACK SIZE 000AH ASSEMBLY COMPLETE NO ERROR FOUND A NECTOOLS SMP75X RA75X gt RA75X 75XTEST2 ASM C106 KS KX 75X Series Assembler VX XX XX Xxx XX Copyright C NEC Corporation 1985 XXXX ASSEMBLY START TARGET CHIP UPD75106 STACK SIZE 000AH ASSEMBLY COMPLETE NO ERROR FOUND A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK 75X Series Linker VX XX XX Xxx XX Copyright C NEC Corporation 1985 LINK COMPLETE NO ERROR FOUND A NECTOOLS SMP75X RA75X gt 0C75X 75XTEST LNK 75X Series Object Converter VX XX XX Xxx XX Copyright C NEC Corporation 1985 XXXX Object Conversion Complete 0 error s and 0 warning s fou
128. YMBOL LIST FOR 75XTEST LNK VALUE MODULE AD_MAIN AD_MAIN AD_MAIN AD_MAIN AD_SUB AD_SUB AD_MAIN AD_SUB SYMBOL NAME ADCONV SEGO SEG SEG2 SEG3 SEG4 SEG5 SEL15 SIOSUB 349 APPENDIX D SAMPLE PROGRAMS 75X SERIES LINKER VX XX XX XX XX XX XX XX PAGE SYMBOL LIST FOR 75XTEST LNK TYPE VALUE ATTRIBUTE NAME MODULE AD_MAIN CODE 0046H SYMBOL HEIKIN PBIT OFBCH 1 SYMBOL IETO CODE 0060H SYMBOL LOOP 1 CODE 0066H SYMBOL LOOP2 CODE 0079H SYMBOL CODE 007DH SYMBOL LOOP4 CODE 0048H SYMBOL 5 0050H SYMBOL MAIN PBIT OFBOH 1 SYMBOL MBE DATA SYMBOL PCC PBIT OFBOH O SYMBOL RBE DATA 0110H PUBLIC SEGO CODE 0020H PUBLIC SEG1 CODE 0050H PUBLIC SEG2 CODE 0046H PUBLIC SEG3 CODE 0020H PUBLIC SEL15 DATA OF80H SYMBOL SP DATA 0110H PUBLIC TDATA DATA SYMBOL TMO DATA OFA6H SYMBOL TMODO MODULE AD_SUB CODE 0022H PUBLIC ADCONV DATA OFCOH SYMBOL BSBO CODE 002BH SYMBOL LOOP DATA OFDAH SYMBOL PTHO DATA OFD6H SYMBOL PTHM PBIT OFBOH O SYMBOL HBE CODE 000AH PUBLIC SEGA CODE 0022H PUBLIC SEG5 DATA OFE4H SYMBOL SIO DATA SYMBOL SIOM CODE PUBLIC SIOSUB CODE 0032H SYMBOL WAIT LINK COMPLETE NO ERROR FOUND 350 APPENDIX D SAMPLE PROGRAMS 5 HEX format object module file Output to 75XTEST1 HEX 02000000C050EE 100008008022990799229911 2101092 489 9200 04001800 09906 77 10002000991F9907108BD389C093C0
129. ZLSSLXSZ 0 1ndino 1s joqui s WWSV ZLSALXSZ 9 AIdNVS XIGNAddV APPENDIX D SAMPLE PROGRAMS 3 Cross reference lists a 75XTEST1 ASM cross reference list Output to 75XTEST1 PRN 75X SERIES ASSEMBLER VX XX XX XX XX XX XX XX PAGE X A D CONVERTER VX XX di CROSS REFERENCE LIST SYMBOL TYPE VALUE ATTRIBUTES LIST AD MAIN 1 ADCONV CODE EXT 6 10 HEIKIN CODE 0000H R SEG SEG3 60 68 IE TO PBIT OFBCH 1 53 1 CODE 0010H R SEG SEG2 37 39 LOOP2 CODE 0016H R SEG SEQ2 41 43 LOOP3 CODE 0029H R SEG SEG2 56 63 LOOP4 CODE 002DH R SEG SEG2 58 59 5 CODE 0002H R SEG SEG3 69 75 MAIN CODE 0000H R SEG SEG2 9 23 MBE PBIT OFBOH 1 9 10 PCC DATA 30 RBE PBIT OFBOH O 9 10 SEGO DATA 0002H PUB ABS 12 SEG1 CODE 0002H PUB REL IENT 17 SEG2 CODE 0039H PUB REL INBLOCK 22 SEG3 CODE 000 PUB REL SENT 67 SEL15 CODE 0000H R PUB SEG SEG1 7 18 25 47 SIOSUB CODE EXT 6 62 DATA OF80H 27 STACK STACK EXT 26 TDATA DATA 0110H PUB ABS 7 13 61 TMO DATA 51 TMODO DATA OFA6H 49 TARGET CHIP UPD75106 STACK SIZE 000AH 346 APPENDIX D SAMPLE PROGRAMS ASSEMBLY COMPLETE NO ERROR FOUND b 75XTEST2 ASM cross reference list Output to 75XTEST2 PRN 75X SERIES ASSEMBLER VX XX XX XX XX XX XX XX PAGE X A D CONVERT VX XX SUB CROSS REFERENCE LIST SYMBOL TYPE VALUE ATTRIBUT
130. a in the range 0 to OFBFH 3 or OFFOH O to OFFFH 3 is specified Caution on segments with same name If segment with the same name are written in one source module the list converter may not function correctly Caution on source program description If the assembly list of a source program which does not follow the rules shown on the right is input the list converter may abort due to an error with the result that list is not converted correctly Restriction on input files All files input to the list converter must be free of errors If mem bit object code is to be generated a reserved word must be specified in the ranges shown on the left Language Volume 3 5 Operand Characteristics Do not write modules with the same name in one source module when using the list converter Language Volume 4 2 Segment Definition Pseudo Instructions The following rules should be followed lt 1 gt Write VENTn and ORG pseudo instructions in upper case characters starting at column 9 in the source program lt 2 gt Do not use a NOLIST control instruc tion lt 3 gt Do not use segments with the same name in the same module lt 4 gt Be sure to write a segment definition pseudo instruction before writing an instruction which generates object code Language Volume Chapter 4 Pseudo Instructions Check that the following files are error free Assembly list file PRN Object module file REL Load module
131. a library file enable modules to be used more effectively and also offers improved efficiency in terms of file management and operability 7 List converter LONV75X The list converter is designed to improve debugging efficiency using IE 75000 R ete 1 E 75001 R 75XNote 2 of programs assembled by the assembler In an ordinary assembly list addresses in relocatable segments and object code in which relocatable symbols are referenced are different from the final values For this reason when debugging is performed with absolute addresses specified it is not possible to find the absolute addresses simply by referring to the assembly list and the link map list must also be consulted The list converter is a program which generates an absolute assembly list in which the final absolute addresses are incorporated in the relocatable addresses and object code in the assembly list output by the assembler Notes 1 Maintenance product not available for purchase 2 Discontinued not available for purchase 1 5 Cautions on 75XL Series Development The following points must be noted when using a 75XL Series device as a development device 1 For 75XL Series development a 75XL Series device file sold separately is needed as well as the RA75X assembler package 39 MEMO 40 CHAPTER 2 PRODUCT SUMMARY This chapter outlines the file names and operating environment for each of the programs provided in the assembler package
132. ace You do not have enough disk In the destination to install all of the required files Delete unnecessary files change install crie 53 54 CHAPTER 3 ASSEMBLER PACKAGE EXECUTION lt 4 gt Specify the group to be registered in Program Manager a The dialog box for specifying the registered group name is next displayed After inputting the group name to be registered as shown below select Continue C If the specified group does not exist that group is newly created Also if the specified group has already been registered using the Installer that group is used Group Name specify the Program manager Group name to register icons If the Group is not exist it willbe made automatically Group NEC tools 6 return to the dialog box for specifying the installation destination select Back To terminate installation select Exit d If you are not installing Project Manager the dialog box for specifying the registered group name is not displayed lt 5 gt Start copying files a The dialog box for starting copying of files is displayed If you select Continue C copying of files will start 6 To return to the dialog box for specifying the registered group name select Back To terminate installation select Exit File copy Start If you press Continue button installer will start the file copy If you pr
133. ad module file output by the linker and output the results as a HEX format object module file An object module file output by the assembler cannot be used as input to the object converter A HEX format object module file is necessary for ROM ordering and debugging input In addition symbol information required for symbolic debugging by the debugger is output as a symbol table file Figure 1 13 Object Converter Function Load module file Input Object converter OC75X Symbol table HEX format file object module file The basic processing of the assembler package ends when processing has been completed normally as far as the object converter In addition program development can be made more efficient by using the librarian and list converter 33 CHAPTER 1 GENERAL DESCRIPTION 1 2 6 Librarian The librarian is used to create or update library files It is convenient to librarize general purpose modules with a clear interface as this enables a large number of object modules to be handled easily as a single file The linker includes a function for extracting only the needed modules from the library file Therefore if a number of modules are recorded in a single library file it is not necessary to specify the file name of each module required for linkage Figure 1 14 Librarian Function Object module files n Library file Librarian LB75X Library file Library file information list file 34
134. added to the library file is specified as the input file e f the file type is omitted from the input file name it is taken to be fthe input file is a library file the name of the module in the library file to be recorded is specified in parentheses e f the module name is omitted all the modules in the library file are recorded e The update library file name is the name of the library file to which the addition is made Caution The update library file must not contain a module with the same name as that of the module to be added 213 CHAPTER 7 LIBRARIAN ADD add Example Example 1 Modules M3 and M4 are to be added to the library file 75XTEST LIB Before addition Library file 75XTEST LIB F3 REL Description format ADD F3 F4 M4 TO 75XTEST LIB lt After recording gt Library file 5XTEST LIB 214 CHAPTER 7 LIBRARIAN ADD add Example 2 Module 75XTEST1 is to be added to the existing library file 75XTEST LIB ADD 75XTEST1 75XTEST LIB The contents of the library file 75XTEST LIB are checked LIST 75XTEST LIB 75X Series Librarian VX XX DATE LIB FILE NAME 75XTEST LIB 1 AD MAIN UPDATE O0 RA75X VX XX UPD75106 NUMBER OF MODULES 1 215 CHAPTER 7 LIBRARIAN DELETE delete 3 DELETE Description Format DELETE Library file name Object module name Abbreviated Format D Library file name Object module name
135. al termination If the program terminates normally it outputs the message NO ERROR FOUND In cases 1 and 2 above the error message is output in the following format error number error message The error number consists of a letter followed by a 3 digit number The initial letter is one of the following W Warning error F Fatal error A Abort error 8 3 4 List converter termination status When the list converter terminates the execution and returns control to the OS one of the following error status codes is returned to the OS Termination Condition Termination Status Normal termination When the list converter is started from a batch file under MS DOS PC DOS IBM DOS it is possible to determine whether there are any errors automatically using these values 243 CHAPTER 8 LIST CONVERTER 8 4 List Converter Options 8 4 1 Types of list converter options List converter options are used to specify the input output files to be used by the list converter There are five options as shown in Table 8 2 below Options can be written in either upper or lower case characters Table 8 2 List Converter Option Types Description Format Function Classification Interpretation when Omitted L file name Specifies the input load module file name Input assembly list file primary name LNK 2 O file name Specifies the output absolute assembly list file Input assembly list file primary name P
136. an be input to HEX loader Nete 2 The object converter also outputs the symbol table file required for symbolic debugging using a debugger control program Notes 1 All reference address information must have been resolved 2 PG 1500 IE 75000 R maintenance product IE 75001 R EVAKIT 75X discontinued 181 CHAPTER 6 OBJECT CONVERTER 6 1 Object Converter Input Output Files The object converter OC75X input output files are shown in Table 6 1 Table 6 1 Object Converter Input Output Files Type of File Input file Load module file Load module file output by the linker Parameter file This is a file created by the editor when desiring to specify a large number of files which cannot be defined on the command line as object converter input files Output file HEX format object module file HEX format file which can be input to HEX loader Symbol table file File containing information on symbols included in each module of the input file Error list file This is a file which contains error information when running the object converter Figure 6 1 Object Converter Input Output Files Load module file Object converter OC75X Parameter file Symbol table HEX format Error list file file object module file Caution object module file REL output the assembler cannot be input 182 Default File Type CHAPTER 6 OBJECT CONVERTER 6 2 Object Converter Functions e The object converter converts the
137. anch instructions in the source module CHAPTER 5 LINKER no table Example Example Assume that the following error was output when linkage was performed A NECTOOLS SMP75X RA75X gt LX75X BR1 REL BR2 REL OBR LNK 75X Series Linker VX XX XX Xxx XX Copyright C NEC Corporation 1985 ERROR F012 BRANCH TABLE OVERFLOW Program aborted Linkage is performed with the NTB option specified A NECTOOLS SMP75X RA75X gt LK75X BR1 REL BR2 REL OBR LNK NTB 75X Series Linker VX XX XX Xxx XX Copyright C NBC Corporation 1985 W502 EVALUATED VALUE EXCEEDS THE RANGE AT XXXXH IN XXXX LINK COMPLETE 1 ERROR FOUND Link processing terminates but the W502 error is output for commands branching to other blocks in the BRCB command 173 CHAPTER 5 LINKER output file 12 O NO Description Format O load module file name NO Default Interpretation First specified object file name LNK is created in current path Function The O option specifies the name of the load module file to be created by the linker The NO option informs the linker that a load module file is not to be created Use e The O option is specified when it is wished to change the load module file name from the default name e The NO option is specified when the linker is to be started only in order to output a link list file etc Description e f neither the O option nor the NO option i
138. any input module EXTRN symbols approx 500 EXTRN symbols can be used in one input module Reduce number of PUBLIC symbols SEGMENT TABLE OVERFLOW MODULE module name 015 Cause Too many segments total of approx 120 segments can be handled including number of ORG pseudo instructions Program processing Program execution is halted Reduce number of segments Program processing Program execution is halted User action Reduce number of segments and PUBLIC amp EXTRN symbols or reduce number of unresolved branch instructions A909 Capacity of disk specified for output is insufficient Program execution is halted Delete unnecessary files or use a new disk 308 CHAPTER 13 ERROR MESSAGES Linker s Error Messages cont d Message PROGRAM ERROR Cause Memory contents have been overwritten by another program Program processing Program execution is halted Cause Error No A999 Error No F100 Error No F102 Error No F106 Location has been attempted a reasonable number of times changing the relocatable segment order but without success the linker cannot find a location method as there are a large number of segments Program processing Program execution is halted User action Input segments in the order in which they are to be located and specify the SQ option To find the size of each segment specify the SQ option without considering the segment order Linkage wi
139. at objects Explanation e f the R option and NR option are specified at the same time the last option specified becomes valid e When the NO option is specified the R option and NR option are invalidated Example of Use Example Specify the R option A NECTOOLS SMP75X RA75X gt OC75X 75XTEST LNK R Arranges HEX format objects in address order and outputs them 194 CHAPTER 6 OBJECT CONVERTER fill up Description Format U filler value start size Default Interpretation None Function The U option indicates that the specified decimal code is to be placed in all addresses other than those used in the program description and the object code of all the addresses of the target device are to be output Use The U option is specified when object code for mask ROM ordering is to be output with free ROM area filled with decimal codes Explanation For filler values specify a value from 0 to 255 in binary octal decimal or hexadecimal notation If a numerical value outside this range is specified or something other than a numerical value is specified or if a filler value is not specified it will result in an error At the start use a header address in the address range where you intend to carry out filling specifying a number between OH and OFEFFH in binary octal decimal or hexadecimal notation If a numerical value outside this range is specified or if something other than a numerical value is s
140. ate execution of the batch file please refer to the contents of nectools ra75x add and modify autoexec bat lt Contents of ra75x add gt REM PLEASE ADD TO THE BOTTOM OF YOUR AUTOEXEC BAT PATH a nectools BIN PATH CHAPTER ASSEMBLER PACKAGE EXECUTION 3 File Configuration after Installation The Assembler Package file configuration after installation is as follows nectools windows Note This is an empty directory bin doc dev Note setup smp75x system ra 5x exe st 5x exe Ik75x exe 5 75 Ibcnv75x exe Icnv75x exe hip p hlp prjtman exe prjtmake exe prjtlog exe prjtedit exe prjtmsg dll prjtspin dll prjtedit dll prjtman hlp prjtedit htp ra75x om1 ra75x om st75x om1 prjtman txt ddummy 75X ra75x log ideal example L org ra75x asm S sra75x bat necdevi ini prjlog pif prjpipe 386 Assembler execution format command file Structured Assembler preprocessor execution format command file Linker execution format command file Object converter execution format command file Librarian execution format command file Library converter execution format command file List converter execution format command file Execution format help file Project Manager tools DLL Tools DLL help file Project Manager execution format command file Project Manager make execution format command file
141. ber of errors 3 Normal termination If the program terminates normally it outputs the message ASSEMBLY COMPLETE NO ERROR FOUND e Error related to start line only output to standard output Error unrelated to start line Output format for assembly list and standard output number STNO mmmm error message nnnn Error line number mmmm Previous error line number 4 3 4 Assembler termination status When the assembler terminates and returns control to the OS one of the following error status codes is returned to the OS Termination Condition Termination Status Normal termination 0 When the assembler is started from a batch file under MS DOS PC DOS IBM DOS it is possible to determine whether there are any assembly errors automatically using these values 76 CHAPTER 4 ASSEMBLER 4 4 Assembler Options 4 4 1 Types of assembler options Assembler options are used to give the assembler detailed directions concerning its operation There are 19 different options as shown below 77 x N O x x CHAPTER 4 ASSEMBLER Table 4 2 Assembler Options 1 2 Description Format Function Category Default Interpretation C product Specification of assembler target product Cannot be omitted 2 M mode 75XL Series CPU mode switching Cannot be specified when a 75X Series device is used 9 O file name Object module file specification
142. ble the sample program 75XTEST2 ASM The following is input in the command line A NECTOOLS SMP75X RA75X gt RA75X 75XTEST2 ASM C106 e The following message is output at the console 75X Series Assembler VX XX XX Xxx XX Copyright C NEC Corporation 1985 XXXX ASSEMBLY START TARGET CHIP UPD75106 STACK SIZE 0002H ASSEMBLY COMPLETE NO ERROR FOUND 5 Check the contents of drive The assembler has output 75XTEST2 REL object module file and 75XTEST2 PRN assembly list file 6 Link object module files 75XTEST1 REL and 75XTEST2 REL output by the assembly The following is input in the command line A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK 64 e The following message is output at the console 75X Series Linker VX XX XX Xxx XX Copyright C NEC Corporation 1985 LINK COMPLETE NO ERROR FOUND CHAPTER 3 ASSEMBLER PACKAGE EXECUTION 7 Check the contents of drive B The linker has output 75XTEST LNK load module file and 75XTEST1 MAP link list file 8 Input the load module file 75XTEST LNK output as the result of linkage to the object converter A NECTOOLS SMP75X RA75X gt OC75X 75XTEST LNK The following message is output at the console 75X Series Object Converter VX XX XX Xxx XX Copyright NEC Corporation 1985 Object Conversion Complete 0 error s and 0 warning s found 9 Check
143. cdannebasddindiaebeidubtonducdestendthetaeiee 330 366 APPENDIX INDEX A ga 43 59 JE 4i X8 9 re 42 59 18 NND OD 131 132 169 172 E T C 43 STE T2 ORO 43 COU EE I M MI MU MM M E M SEND DEUS 202 205 SUDCOM AA uu ene ene ae 204 205 210 RMON S 145 MN table ES NER E oo o Em 192 195 352 wydulesBc ie 282 285 292 344 348 Symbolic debugging PRECEPIT QE 195 OOS 01216 ONERE ONT 37 330 y SPOT uuu u u u E TOTO Tr 44 TBR 8 TCALL U PIO MET m n E E sassa 191 195 326 V VENT SURO ST SEO uu u u u u uuu 72 330 VENTO se COTO l uu uuu m m T Tem 39 Y sA ODUNA ASS EMDE u u u uuu 78 117 324 Y option object converter NER 191 200 326 zeli LE T mE 144 179 325 Numbers
144. chase Description e When the NO option was specified the G option is invalid e When the NG option is specified symbol information is not output at the object module file output by the assembler Therefore when the object module files output at this time is linked symbol information is not output to the link list file output by the linker or the symbol table list output by the object converter either 91 CHAPTER 4 ASSEMBLER G NG debug no debug Examples Assembly of 75XTEST1 ASM with the G option specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM C106 G Assembly of 75XTEST2 ASM with the NG option specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST2 ASM C106 NG To link 75XTEST1 REL and 75XTEST2 REL A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL CHAPTER 4 ASSEMBLER G NG debug no debug Symbols not displayed in the symbol list in the link list file for 75XTEST2 ASM for which the NG option was specified SYMBOL LIST FOR 75XTEST1 LNK TYPE VALUE ATTRIBUTE NAME OFBCH 1 0060H 0066H 0079H 007DH 0048H 0050H OFBOH 1 0 0110H 0020H 0050 0046H 0020H OF80H 0110H OFAOH OFA6H MODULE SYMBOL SYMBOL SYMBOL SYMBOL SYMBOL SYMBOL SYMBOL SYMBOL SYMBOL SYMBOL SYMBOL PUBLIC PUBLIC PUBLIC PUBLIC PUBLIC SYMBOL PUBLIC SYMBOL SYMBOL AD MAIN HEIKIN IETO 1 2 L
145. cified an error will result Individual options and input file names should be separated by spaces TABs or Line Feed characters A parameter file description cannot be split over a number of lines The 5 and symbols are treated as comment marks in the parameter file Characters from these characters to the end of the line are regarded as a comment 199 CHAPTER 6 OBJECT CONVERTER Y device file search path Description Format Y Path name Default Interpretation Executes a search in accordance with the specified search sequence 2 5 of the Explanation Function The Y option specifies the device file search path Use Specify the Y option when searching from the specified path first Explanation device file is searched for by the following sequence 1 Path specified by the Y option 2 DEV path with respect to the OC75X starting path 3 OC75X starting path 4 Current Path 5 Environment Variable PATH e f a name other than a path name is specified or if the path name is omitted it will result in an error m lt 200 CHAPTER 7 LIBRARIAN The librarian is a tool for collecting together modules which are of general applicability and have a clear interface in a single file librarization Once multiple modules have been collected together in a single file the library file can be specified as an input file when linkage is performed in addition to the object
146. ck segment is located starting as address address specified by SK option 1 MAP OF ROM AREA BASE LENGTH MODULE NAME SEGMENT NAME AD_MAIN AD_MAIN 170 CHAPTER 5 LINKER SZ stack size 10 SZ Description Format SZ size Default Interpretation change of stack area is assumed Function e The SZ option specifies the size of the stack segment to be changed to in nibbles Use The SZ option is specified when it is wished to change the size of the stack segment linked when linkage is performed it is only meaningful when the stack pointer value has been set using the reserved word STACK in the source program and the stack size has been reserved with the STKLN pseudo instruction Description The stack segment size is increased or decreased by the amount specified by the SZ option e The size can be specified in binary octal decimal or hexadecimal notation f multiple SZ options are specified the last one specified is valid Example Example The SZ option is specified as shown below A NECTOOLS SMP75X RA75X gt 75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK SZ 1CH Since the size of the original stack segment is OCH the stack segment size is OCH 1CH 28H MAP OF ROM AREA LENGTH MODULE NAME SEGMENT NAME AD_MAIN AD_MAIN 171 CHAPTER 5 LINKER NTB no table 11 NTB Description Format NTB Default Interpretation Linker creates a branch tables automatically
147. console The librarian performs processing in accordance with the subcommands specified after the librarian is started See 7 4 Description of Subcommands for the subcommands When the EXIT subcommand is input the librarian returns control to the OS 7 2 1 Module librarization The assembler creates one object module in one file If there are a large number of object modules therefore the number of files also increases Consequently a function is provided for collecting together a number of modules in a single file This is called module librarization and the librarized file is called a library file A library file can also be input to the linker Therefore if a library file is created from generally applicable modules when modular programming is used efficiency can be improved in terms of both file management and operability 7 2 2 Library file editing The librarian has the following functions for editing a library file e Addition of modules to library file Deletion of modules from library file Replacement of modules in library file See 7 4 Description of Subcommands for details of these functions 7 2 3 Printing of library file information The librarian has functions for editing and printing the following information held in a library file Module name Creating program Recording date e Update date e PUBLIC symbol information See 7 4 Description of Subcommands for details of these funct
148. ction The J option specifies that a load module file is to be created even if there is a linkage error e The NJ option specifies that a load module file is not to be created if there is a linkage error Use e When desiring to generate a load module file even if there are errors during linking specify the J option Explanation e When the NO option is specified the J option is invalid 176 CHAPTER 5 LINKER J NJ JUNK NO JUNK Examples When the J option is specified A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL J 75X Series Linker VXX XX XX Xxx xx Copyright C NEC Corporation 1985 ERROR W310 UNRESOLVED SYMBOL MODULE AD_MAIN SYMBOL ADCONV ERROR W310 UNRESOLVED SYMBOL MODULE AD MAIN SYMBOL SIOSUB ERROR W503 REFERENCE SYMBOL 15 UNRESOLVED 0008H IN ERROR W503 REFERENCE SYMBOL 15 UNRESOLVED 0035H IN SEG2 LINK COMPLETE 4 ERRORS FOUND An load module file 75XTEST1 LNK has been output even though there is an assembly error 177 CHAPTER 5 LINKER parameter file name 14 F Description Format F parameter file name Default Interpretation Parameter file is not used Function The F option specifies that linker options and input output file names are to be read from the file specified by the option parameter This file is called the parameter file Use Writing options and input output file names to be specified for the linker in a parameter f
149. d after segment SA if segment SB is larger than the free area between segment SA and ASEG segment SB is located after ASEG In this case the area between segment SA and ASEG is left as a free area 127 128 CHAPTER 5 LINKER lt 2 gt Random linkage mode Location is performed so as to avoid the creation of free areas in memory as far as possible without regard to the segment input order Starting with the largest of the input segments location is performed in the lowest address in which location is possible in the free area left after absolute segment location Example Assume that the following segments are input Absolute segment Segment Segment ASEG1 BOH ASEG2 50H Relocatable segments Segment Segment Segment SA 200H SB 140H 100H SD 50H al m 20H Numbers segment sizes In this case the input segments are located as shown on the next page lt 1 gt lt 2 gt lt 3 gt lt 4 gt lt 5 gt lt 6 gt lt gt CHAPTER 5 LINKER Segment Program memory ASEG1 lt 1 gt SA lt 3 gt ASEG2 2 200H SC 5b a ASEG1 lt 1 gt 3008 Fi 3BOH SB lt 4 gt lt 4 gt SB 5 2 lt 2 gt 500 SD lt 6 gt 550H 62 o o J O A VN A Jk N V SE lt 7 gt First the absolute segments are located at the specified addresses ASEG1 address 300H ASEG2 address 500H The largest of
150. distinguish the upper and lower case letters of symbol name Use Use the CA option in cases where upper and lower case letters are not distinguished and specify the NCA option when distinguishing upper and lower case letters Explanation e f neither the CA option or the NCA option is specified processing is the same as when the NCA option is specified Description Example e Assemble 75XTEST1 ASM with the CA option specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM C106 CA The object module file 75XTEST1 REL is output without upper and lower case letters in symbol names distinguished Caution Upper and lower case letters in symbol names cannot be judged by the IE 75000 R and IE 75001 R so specify the CA option 102 CHAPTER 4 ASSEMBLER S NS symlen no symlen x 12 S NS Description Format 5 5 Default Interpretation S Function The S option instructs to expand the length of recognizable symbol names to a maximum of 31 characters The NS option instructs to invalidate the S option and allow the length of recognizable symbol names to be a maximum of 8 characters Use Specify the S option when making the length of recognizable symbol names a maximum of 31 characters and specify the NS option when making the length of recognizable symbol names a maximum of 8 characters Explanation e f neither the S or NS option is specified processing is the same as
151. documentation Please complete this form whenever Company YOU like to report errors or suggest Improvements to us Tel FAX Address Thank you for your kind support North America Hong Kong Philippines Oceania Asian Nations except Philippines NEC Electronics Inc NEC Electronics Hong Kong Ltd NEC Electronics Singapore Pte Ltd Corporate Communications Dept Fax 852 2886 9022 9044 Fax 65 250 3583 Fax 1 800 729 9288 1 408 588 6130 s tronics Hong Kong Ltd EOS iconductor Technical ectronics Hong Kong Ltd emiconductor Technical Hotline Re S B pA Fax 044 435 9608 Technical Documentation Dept Eax 02 528 4411 Fax 49 211 6503 274 South America Taiwan NEC do Brasil S A NEC Electronics Taiwan Ltd Fax 55 11 6462 6829 Fax 02 2719 5951 would like to report the following error make the following suggestion Document title Document number Page number If possible please fax the referenced page or drawing Document Rating Excellent Clarity Technical Accuracy Organization
152. e input file is the name of the object module file to be linked The drive name directory name etc can be added to the input file name Examples LK75X B 75XTEST1 REL 75XTEST2 REL LK75X C USER NEC 75XTEST1 REL C USER NEC 75XTEST2 REL option is a string of 1 to 3 characters beginning with the symbol and may be followed by parameters Options can be written before and after the input file and if there are multiple options they can be written in any order However if multiple identical options or options of the same kind are written in some cases an error is generated and in some cases the last output specified is valid See 5 4 Linker Options for details One or more blanks spaces or TAB should be used to separate options and the input file name The input file name and options can be written in a parameter file For the use of the parameter file see the item on the 14 F option in 5 4 4 Description of linker options As the default output destination a file with the same name a the first file specified but with the file type changed to is created in the current path This be changed by means of the O option RA75X OM1 is necessary to start the linker CHAPTER 5 LINKER 5 3 2 Execution start and end messages 1 Execution start message When the linker is started an execution start message is displayed on the console 75X Series Linker VX XX
153. e DELETE library file name Module deletion p 216 object module name HEPLACE object module file name Module replacement p 219 library file name object module namel FROM update library file name LIST library file nane Library information output p 230 object module name TO list file name PUBLICS eni EXIT Librarian termination E p 233 326 APPENDIX A LIST OF OPTIONS A 5 List of Converter Options Description Format Function Category Default Interpretation 1 L file name Input load module file name Input assembly list file name LNK p 245 specification 2 file name Output absolute assembly list file Input assembly list file primary p 247 einen 3 R file name Input object module file name Input assembly list file primary p 249 specification name REL file name Error list file specification ME p 250 NE F file name Parameter file specification All option and filename are read p 251 from command line A 6 List of Librarian Converter Options Description Format Function Category Default Interpretation 1 O file name Librarian converter output librarian input file name CNV is created in p 258 file specification current path 327 MEMO 328 APPENDIX MAXIMUM CAPABILITIES The maximum capabilities of the assembler package are shown for the next after Source statement length Number of symbols that can be written
154. e e The P option is specified when it is wished to change the assembly list file output destination or file name The NP option is specified when assembly is to be performed only in order to output an object module file etc the assembly time is reduced Description f the drive name is omitted from the file name specification the current path name is taken as being specified The following can be specified as the device type output destination e PPRN Assembly list is output to line printer PCON Assembly list is output to console PAUX Assembly list is output to RS 232 C PNUL Assembly list is not output e An error list file can be output separately by means of the E option e f the NP option is specified the following options are invalid KS KX LL LW LT 95 CHAPTER 4 ASSEMBLER P NP print no print Examples Example 1 If 75XTEST1 ASM is assembled with the NP option specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM C106 NP Assemble List file is not output Only the object module file 75XTEST1 REL is output Example 2 If 75XTEST1 ASM is assembled with the P option specified the file name is SAMPLE PRN A NECTOOLS SMP75X RA75X gt RA75X 75 5 1 5 C106 PSAMPLE PRN Assemble List File SAMPLE PRN and the object module file 75XTEST1 REL are output Example 3 To output
155. e are stack segments in the input module the linker links all the stack modules Thus the stack segment size after linkage is the sum of the sizes of all the stack segments However the stack segment size after linkage can be changed by the linker SZ option see 10 SZ under 5 4 4 Description of linker options 4 2 Stack segment location The stack segment is located starting in the highest addresses in the area comprising addresses OH to OFFH bank 0 of the data memory If data segments are located in bank 0 the stack segment is located in the highest free area at which location is possible 131 132 CHAPTER 5 LINKER Example Stack segment When data segments When data segments are located in the bank are located in the bank Data memory bank 0 Data memory bank 0 oH OH 1 Free area SSEG FFH FFH The stack segment is Since the stack located in the highest segment is too large addresses to be located in the highest free area it is located in the highest addresses of the next free area The stack segment location address can also be specified when linkage is performed by means of the SK option Example The following option is specified at linkage time SK80H In this case the stack segment is located starting at address address specified by SK option 1 in the low address direction Data memory bank 0 Address specified SSEG i 80H by SK
156. e file to be created by the object converter e The NO option instructs the object converter not to generate a HEX format object module file Use The O option is specified when it is wished to change the HEX format object module file name from the default name e In cases where the object converter is run solely for the purpose of outputting a symbol table file etc specify the NO option Description e f the O operation or the NO option is not specified the object converter creates a HEX format object module file with the initially specified load module file name but with the file type changed to HEX on the current path This gives the same result as when the O option is specified with the file name omitted A logical device name cannot be specified as a file name If a logical device name is specified it will result in an error e t is possible to specify the path in which the HEX format object module file is to be created by including the path name in the file name In this case a file with the same name as the load module file but with the file type changed to is created in the specified path e f O and NO are specified at the same time the option specified last is valid Example Example 1 When the converter is started with TEST HEX specified as the output file name A NECTOOLS SMP75X RA75X gt OC75X OTEST HEX 75XTEST LNK 197 CHAPTER 6 OBJECT CONVERTER E NE error print n
157. e regarded as a comment CHAPTER 5 LINKER F parameter file name Examples Consider a parameter file 75XTEST PLK with the following contents 75XTEST1 REL Input file name 75XTEST2 REL Input file name 075XTEST LNK Output file name P75XTEST MAP Link list file name KM Obtain map list on link list file Example 1 The linker is started with parameter file 75XTEST PLK specified A NECTOOLS SMP75X RA75X gt LK75X F75XTEST PLK Example 2 The contents specified by the parameter file 75XTEST PLK are changed and added to in the command line A NECTOOLS SMP75X RA75X gt LK75X F75XTEST PLK PPRN SQ 179 CHAPTER 5 LINKER Y device file search path 15 Y Description Format Y Path name Default Interpretation Executes a search in accordance with the specified search sequence 2 5 of the Explanation Function The Y option specifies the device file search path Use Specify the Y option when searching from the specified path first Explanation A device file is searched for by the following sequence 1 Path specified by the Y option 2 path with respect the LK75X starting path 3 LK75X starting path 4 Current Path 5 Environment Variable PATH 180 CHAPTER 6 OBJECT CONVERTER The object converter OC75X has as its input the load module file Note1 output by the linker and outputs a HEX format object module file which c
158. ecified A logical device name such as COM or AUX cannot be specified as a file name Describing a file name with a logical device name will result in an error A path name can be described and the path where a symbol table file is created can be specified in file name In this case with the load module file name but with the file type changed to SYM is created on the specified path e f S and NS are specified at the same time the option specified last is valid 192 CHAPTER 6 OBJECT CONVERTER S NS symbols no symbols Example Example 1 When the NS option is specified A NECTOOLS SMP75 RA75X gt OC75X 75XTEST LNK NS A symbol table file is not output The HEX format object module file 75XTEST HEX only is output Example 2 When the S option is specified A NECTOOLS SMP75 RA75X gt O0C75X 75XTEST LNK S75XTEST SYM The symbol table file 75XTEXT SYM and HEX format object module file 75XTEXT HEX are output 193 CHAPTER 6 OBJECT CONVERTER R NR sort no sort 2 R NR Description format R NR Default Interpretation NR Function The R option instructs the arrangement of HEX format objects in address order and outputting them NR option instructs the outputting of HEX format objects in the order in which they are stored in load module files Use e Use these options when desiring to specify concerning the output order of HEX form
159. ectronics Germany GmbH Scandinavia Office Taeby Sweden Tel 08 63 80 820 Fax 08 63 80 388 NEC Electronics Hong Kong Ltd Hong Kong Tel 2886 9318 Fax 2886 9022 9044 NEC Electronics Hong Kong Ltd Seoul Branch Seoul Korea Tel 02 528 0303 Fax 02 528 4411 NEC Electronics Singapore Pte Ltd United Square Singapore Tel 65 253 8311 Fax 65 250 3583 NEC Electronics Taiwan Ltd Taipei Taiwan Tel 02 2719 2377 Fax 02 2719 5951 NEC do Brasil S A Electron Devices Division Guarulhos SP Brasil Tel 55 11 6462 6810 Fax 55 11 6462 6829 J00 7 Major Revisions in This Edition General RA75X Assembler Package Version 4 5X changed to Version 5 XX General Programs included in the RA75X Assembler Package were changed A macro function added to the assembler program Accordingly the macro processor was eliminated library converter program was added Target devices were added 750064 750066 750068 75P0076 750104 750106 750108 75P0116 7530124 7530164 7530174 75P3018A 753036 75P3036 753204 753206 753208 75P3216 753304 754202 754144 754244 754264 75 4264 754302 754304 75 4308 General General Development of target devices which were under development was completed LP D750004 750006 750008 75P0016 753012 753016 753017 75P3018 753104 753106 753108 75P3116 p 36 1 2 8 Library converter was added p 38 1 3 4 Other limitation items was added p
160. ed by the option parameter This file is called the parameter file Use Writing options and input file names to be specified for the assembler in a parameter file in advance also reduces the amount of typing required Options and input file names can still be specified in the command line even if a parameter file is used It is thus possible to write only frequently used options in the parameter file Description The parameter file is a text file and can be created with an editor etc There are no particular restriction on the length of the parameter file The parameter file name cannot be omitted However if the file type is omitted PRA is taken as being specified A logical device name CON AUX etc cannot be specified as the parameter file name Use of such names will result in an error The contents of the parameter file are expanded at the position at which the F option is written in the assembler start line It is therefore possible to change the parameter file contents or add other option specifications with options written after the F option Parameter files cannot be nested If an F option is written in the parameter file an error will result It is not possible to use more than one parameter at one time If multiple F options are specified an error will result Individual options and input file names should be separated by spaces TABs or Line Feed characters A parameter file description cannot be s
161. embler Linker Object Converter 3 2 2 Se UNT TOL 3 2 3 RO NT UU TET 3 3 Summary of Assembler Package Execution Procedure CHAPTER 4 ASSEMBLER 4 1 4 2 4 3 Assembler Input Output 2 2 2 2 00 Assembler Functions Assembler Start Method 4 3 1 Starting the assembler 19 20 21 25 27 29 30 31 32 33 34 35 36 37 37 37 37 38 38 38 38 39 40 41 44 44 46 47 48 48 62 63 63 66 67 68 69 70 72 73 73 13 CHAPTER 5 LINKER 5 1 Linker Input Output Files dua d aura d 52 8 u ut u ut uuu 5 2 1 Linkage of object modules in input 5 2 2 Determination of segment location address 5 2 3 Resolution of relocatable object code 524 Automatic branch table creation 59 Me IB0q oe 5 3 1 ili Big mE 5 3 2 Execution start and end messages 5 33 Linker error handling L Eoo SET 5 3 4 Linker termination status
162. ence 1 AT 10H Definition EXTRN DATA COMD PUBLIC SUB CSEG us AE d Definition Reference CHAPTER 5 LINKER 5 2 4 Automatic branch table creation When a symbol which has an address value in another block bytes from x000H to xFFFH is referenced by a 2 byte branch instruction BRCB instruction the linker automatically creates a 3 byte Fete branch instruction called a branch table in the original blockNete 1 enabling the other block to be referenced by the 2 byte branch instruction Notes 1 To be exact the branch table is created in the block to which the address two addresses ahead of the address specified by the BRCB instruction belongs Therefore if the BRCB instruction is written on a block boundary XFFEH XFFFH the corresponding branch table will be created in the next block Writing a BRCB instruction at the end of a block should therefore be avoided 2 The kind of 3 byte branch instruction created depends on the size of on chip ROM in the device concerned as shown below ROM size up to 16 Kbytes BH addr instruction ROM size exceeding to 16 Kbytes BRA addr1 instruction 135 CHAPTER 5 LINKER Example 1 branch table is created in the case shown below In this case it is possible that a branch table will be created In this case a branch table will not be created 3 I I I I T I I I I l I I I I I I I I When the segments shown above are l
163. ence list is full 105 Message Cause Program processing Cross reference table creation is discontinued User action Assemble without creating cross reference list or divide source program and perform split assembly SEGMENT MUST BE ABSOLUTE Cause ORG pseudo instruction is written in relocatable segment ORG pseudo instruction can only be used in absolute segment 311 Message Program processing This ORG pseudo instruction is ignored User action Do not use the ORG pseudo instruction in a relocatable segment When object code allocated to an absolute address is generated write that part as an absolute segment 02 CHAPTER 13 ERROR MESSAGES Assembler s Error Message cont d 401 macro not found Macro definition is illegal That macro definition is invalidated and processing is continued Describe correctly There is no ends description That case block is invalidated and processing is continued Describe the correct endcase 303 CHAPTER 13 ERROR MESSAGES Assembler s Error Message cont d 417 if not found There is no 5 if description That line is invalidated and processing is continued Amend to the correct description There is a 5 case label after 5 default Processing is continued with this definition invalidated Describe the case label correctly 304 CHAPTER 13 ERROR MESSAGES Assembler s Error Message cont d 4
164. erenced Program processing Processing is continued with 0 as undefined symbol value User action 19 Message Cause Program processing With SET pseudo instruction symbol is not defined In other cases processing is User action 20 Message Cause Program processing With symbol definition pseudo instruction symbol is not defined In other cases User action 21 Message Cause Amend to correct symbol or define symbol ABSOLUTE EXPRESSION EXPECTED Relocatable expression cannot be written as operand of this statement performed with expression regarded as absolute expression Use absolute expression as operand NUMERIC EXPRESSION IS REQUIRED Inappropriate item has been written as operator term processing is continued with 0 as operand value Use appropriate item as operator term EXPRESSION STACK OVERFLOW Expression description is too complex Program processing Processing is continued with 0 as expression value User action 22 Message Cause Program processing With symbol definition pseudo instruction symbol is not defined In other cases User action 23 Message Cause Program processing With symbol definition pseudo instruction symbol is not defined In other cases User action 98 Rewrite expression in simpler form ATTRIBUTE OF EXPRESSION MISMATCHED Impermissible symbol attribute is used in expression symbol attribute combination processing is continued with 0 as expression va
165. es are as shown below Input load module file 75XTEST LNK Input assembly list file 75XTEST1 PRN Input object module file 75XTEST1 REL Output absolute assemble list file 75XTEST1 P Caution A space cannot be inserted between O and the file name If a space is inserted an error will be output 248 CHAPTER 8 LIST CONVERTER R relocatable file name Description Format R file name Default Input assembly list file primary name REL Function The R option specifies the name of the object module file to be input Use If the primary name of the object module file differs from the primary name of the assembly list file or if the file type is not REL specify the R option Description e f there is fatal error the absolute assembly list is not output f the only the primary name of the input file is specified input a file with the same name but with the file type added Example e If the O option is specified load module file 75XTEST LNK assembly list file 75XTEST1 PRN object module file SAMPLE REL A NECTOOLS SMP75X RA75X gt LONV75X L75XTEST LNK 75XTEST1 RSAMPLE REL The absolute assembly list file 75XTEST1 P is output 249 CHAPTER 8 LIST CONVERTER E NE error print no error print x 4 E NE Description Format E output file name NE Default Interpretation NE Function The E option specifies error list file output
166. ess Cancel button while copying files you can quit the installation But the directories files which have already been copied are leftin the disk CHAPTER 3 ASSEMBLER PACKAGE EXECUTION lt 6 gt Copying Files SETUP DISK 1 Source File AM L CNV75X EXE Destination File CANECTOOLSIBINILCNY 5X EXE a When Cancel C is selected the following message is displayed Setup Message setup is not yet complete If you quit now this product will not be correctly installed Quit the setup of this product 6 To terminate installation select Yes Y To resume copying of files select No lt 7 gt Replace the Output Media a When the following message is displayed insert RA75X SETUP DISK 2 in the floppy disk drive Setup Message Please insert the disk labeled RA75X SETUP DISK into drive Cancel b When the same message is repeated insert RA75X SETUP DISK 3 then next RA75X SETUP DISK 4 the floppy disk drive 55 CHAPTER ASSEMBLER PACKAGE EXECUTION lt 8 gt The registered group and icons are created The Assembler cannot be operated in Windows so no icon is created for it Fra Readme for Manager miata lt 9 gt AUTOEXEC BAT is changed a Using the radio button select whether to modify the AUTOEXEC BAT file by selecting Installer will modify automatically or Modify it manually later
167. eudo instruction is not written in upper case characters starting at column 9 in the source module There is not ORG pseudo instruction or CSEG pseudo instruction in first segment of source module Program processing Execution is halted and control is returned to OS User action Check the input file name Write the ORG pseudo instruction in upper case characters starting at column 9 in the source module Write an ORG pseudo instruction or CSEG pseudo instruction at the start of the first segment of the source module 321 CHAPTER 13 ERROR MESSAGES 13 6 Library Converter Error Messages Error No Illegal input file 001 The input file contents are incorrect Program execution is halted Specify the correct input file Error No Memory allocation failed A002 Allocation of memory blocks failed Program Processing Program execution is halted Check the installed memory capacity or check if there are any resident programs running 322 APPENDIX LIST OF OPTIONS Options for each of the programs in the assembler package are shown here in tabular form Please refer to these when carrying out program development 323 x APPENDIX A LIST OF OPTIONS A 1 List of Assembler Options Description Format Function Category Default Interpretation 1 C product Specification of assembler Cannot be omitted p 82 m mem Pe 2 mode 75XL Series CPU mode switching Cannot be specified when a 7
168. f who have already read the RA75X Assembler Pack age User s Manual Language Volume can skip Chapter 1 Appendix A List of Options can be used once the reader is familiar with the operation of each program Legend The meanings of symbols and abbreviations used throughout this manual are shown below Continuation of same format Item in square brackets may be omitted EX EL 7 Actual characters enclosed in Actual characters enclosed in Characters in heavy type The characters themselves 10 Important item Underlining in examples indicates input characters One or more spaces Abbreviated form of program description Actual characters enclosed in Delimiter symbol CR Carriage Return LF Line Feed Line feed key input A From to File Name Rules 1 Disk type file specification Drive name V directory name primary name file type Max 3 characters Max 8 characters Specifies name of directory containing file If omitted the current directory is assumed to be specified Specifies name of drive containing file If omitted the current drive is assumed to be specified Remarks 1 Spaces cannot be specified before or after 7 and V 2 No distinction is made between upper and lower case characters 3 If the file type is omitted the following default values are used for each type of file File Default File Type So
169. file LNK 331 APPENDIX POINT FOR ATTENTION Point for Attention Remedy Action Cautions on input file name to be used lt gt The first letter of the file name should with debugger be written in letters other than numeric For input file to be used with debugger in lt 2 gt Change existing file name with name circuit emulator a file name is created as pseudo instruction a module name in the process of assem bly Therefore if the first letter of the file name is written in number an error results on debugger side upon loading Bug concerning BRCB instruction lt 1 gt When jump destination address of instruction is BLOCK external reference as number of label constant output is not performed in branch table map address ascending order lt 2 gt When jump destination address of instruction is BLOCK external reference in the form of label constant and there is a BRCB instruction of different description format at the same jump destination address in the same block an extra branch table is created Caution when using byte separation Language Volume operators HIGH LOW Table 3 10 Combination If the item is a relocatable item or an of items and operators external reference item nesting cannot except external refer be done However if used in combina ence items according to tion with the BRCB EQU and SET relocation attributes commands absolute items only can be
170. from the project manager is explained Please refer to the Project Manager User s Manual concerning the project manager The programs in which the options can be set from the project manager are as follows Assembler Linker Object converter Structured assembler preprocessor 259 CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER 10 1 Setting Options from the Project Manager The programs in which the options can be set from the project manager are as follows e Assembler e Linker Object converter e Structured assembler preprocessor see RA75X Structured Assembler Preprocessor User s Manual con cerning setting of options from this program s project manager Cautions 1 260 In the check for the existence of an include file when creating the assembler s make file clearing of commands and character strings only is performed and if _if and similar conditions are disregarded Description Examples if SYM include func1 inc else include func2 inc Sendif In the description examples the if else and endif lines disregarded so both files are interpreted as include files For that reason regardless of whether or not there is an actual reference if these files do not exist it will result in an error during the build When setting options from the project manager the C and Y options are added in the assembler At this time the user cannot add the C option When setting options fr
171. g segment location addresses 124 lt 1 gt Determination of absolute segment location addresses data segments are all absolute segments lt 2 gt Determination of relocatable segment location addresses a Determination of the location addresses of segments for which address specification is performed by the linker CD option see 6 CD 5 4 4 Description of linker options for the CD options b Determination of the location addresses of other relocatable segments The order of priority for determining the location addresses of other relocatable segments specified at assembly time as shown below 1 Location 2 Location 3 Location 4 Location 5 Location 6 Location 7 Location 8 Location 9 Location 10 Location 11 Location address determination for segments with IENT attribute address determination for segments with SENT PAGE attribute address determination for segments with SENT attribute address determination for segment with INBLOCK PAGE attribute address determination for segments with XBLOCK PAGE attribute address determination for segments with INBLOCK attribute address determination for segments with XBLOCK attribute address determination for segments with INBLOCKA PAGE aittribute address determination for segments with XBLOCKA PAGE attribute address determination for segments with INBLOCKA attribute address determination for segments with XBLOCKA attribute Location addresses are determined
172. g three kinds of processing according to the severity of the error 1 Abort error If an error is generated which prevents program execution from continuing the program displays a Program aborted message and the program is aborted immediately 2 Fatal error If an error is generated which would result in generation of object code different from that intended by the user the program nevertheless continues processing to the end then outputs the message LINK COMPLETE X ERRORS FOUND where X is the number of errors 3 Normal termination If the program terminates normally it outputs the message LINK COMPLETE NO ERROR FOUND In the 1 and 2 cases the error message is output in the following format the destinations are standard output and the map file error number error message 142 CHAPTER 5 LINKER 5 3 4 Linker termination status When the linker terminates and returns control to the OS one of the following error status codes is returned to the OS Termination Condition Termination Status When the linker is started from a batch file under MS DOS PC DOS IBM DOS it is possible to determine whether there are any linkage errors automatically using these values 143 CHAPTER 5 LINKER 5 4 Linker Options 5 4 1 Types of linker options Linker options are used to five the linker detailed directions concerning its operation There are 15 different options as shown below Table
173. gment is not compatible with specified address Error No W411 Message Cause Program processing Segment is located with relocation attribute taken as valid Ensure that specification does not involve incompatibility between address specification User action and relocation attribute CAN NOT CREATE BRANCH TABLE SEGMENT segment name Branch tables required for absolute or address specified segment cannot be created in same block Error No F412 Message Cause Program processing Processing is continued with branch instruction unresolved User action Move segment specification address to another block or reduce number of unresolved branch instructions LOCATION OVERFLOW AT CODE MEMORY SEGMENT segment name Attempt has been made to locate code segment exceeding maximum target chip ROM value Error No F415 Message Cause Program processing Segment is located with maximum target chip ROM value exceeded User action Amend so that code segment fits in ROM range of target device LOCATION OVERFLOW AT DATA MEMORY SEGMENT segment name Attempt has been made to locate data segment exceeding maximum target chip RAM value Error No F416 Message Cause Program processing Segment is located with maximum target chip RAM value exceeded User action Amend so that data segment fits in RAM range of target device SEGMENT SIZE OVER ALIGN relocation attribute SEGMENT segment name Maximum segment size s
174. gments Use The CD option is specified when it is wished to specify a location address when linkage is performed on segments defined as relocatable segments in the assembly stage 15 specified when it is wished to determine in relative terms the location order of multiple relocatable segments Description e The segment name specified is a segment name defined by a CSEG pseudo instruction in a source module The segment location address can be specified in binary octal decimal or hexadecimal notation The address range is within the ROM area of the target device e An error will result if multiple specifications are made for the same segment Caution Address specification and order specifications can be made simultaneously with the CD option Example CD C1 C4 C3 300H C6 C5 When this kind of specification is made order specifications are interpreted individually before segments for which an address specification is made In other words this case is equivalent to the following specifications CD C1 C4 CD C3 300H C6 C5 159 CHAPTER 5 LINKER CD code Examples Example 1 When the CD option is omitted A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK SEGMENT LINK MAP FOR 75XTEST LNK AD_MAIN MAP OF ROM AREA LENGTH MODULE NAME SEGMENT NAME TYPE AD_MAIN ABSOLUTE AD_MAIN ABSOLUTE AD_SUB SENT AD_MAIN AD_SUB SENT AD_MAIN SENT AD_MAIN
175. gt lt 4 gt lt 5 gt MAP OF RAM AREA BASE LENGTH MODULE NAME SEGMENT NAME XXX TTTT BBBB lt 3 gt lt 9 gt lt 3 gt lt 4 gt lt 5 gt Descriptions of Output Items lt 1 gt Output file name load module file lt 2 gt Output module name value specified by M option If there is no M option primary name of output file name 3 Segment overlap indication Shown as OVERLAP Blank if there is no segment overlap Segment start address shown as 4 hexadecimal digits in ascending address order Segment size 4 hexadecimal digits End address Start address 1 Module name Segment definition module name lt gt Segment name left justified GAP is shown for a free area Blank in case of default absolute segment or VENT area SENT BLOCK PAGE XBLOCKA PAGE CODE Code segment DATA Data segment STACK Stack segment Segment attributes left justified lt 8 gt ABSOLUTE absolute segment TENT SENT INBLOCK INBLOCKA Segment relocation attributes KBLOCK XBLOCKA INBLOCK PAGE INBLOCKA PAGE 280 CHAPTER 11 PROGRAM OUTPUT LISTS 11 2 4 Branch table map list Information on branch tables generated in order to branch to another block is output in this list Output Format BRANCH TABLE MAP FOR 1 BLOCK LOCATED REFERENCE EXPRESSION REFERENCE REFERE
176. he O option 73 CHAPTER 4 ASSEMBLER 4 3 2 Execution start and end messages 1 Execution start message When the assembler is started an execution start message is displayed on the console 75X Series Assembler VX XX XX Xxx XX Copyright C NEC Corporation 1985 XXXX ASSEMBLY START 2 Execution end message e f no assembly errors are detected during assembly the assembler outputs the following message and returns control to the OS ASSEMBLY COMPLETE NO ERROR FOUND f assembly errors are detected during assembly the assembler displays the number of errors on the console and returns control to the OS ASSEMBLY COMPLETE 5 ERRORS FOUND 10 e Ifa fatal error is detected during assembly which prevents assembly from continuing the assembler outputs a message to the console stops execution and returns control to the OS CHAPTER 4 ASSEMBLER Example 1 When a source file which does not exist in drive B is specified A NECTOOLS SMP75X RA75X gt RA75X SAMPLE ASM C106 75X Series Assembler VX XX XX Xxx XX Copyright NEC Corporation 1985 A006 File not found SAMPLE ASM Program aborted In this example an error is generated since a source file which does not exist in drive is specified and assembly is aborted Example 2 When the C option is not specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM 75X Series Assembler VXX XX XX Xxx xx Copyright C NEC Corporation 1985 XX
177. he module name AD_MAIN and the other is stored in the source module file 75XTEST2 ASM under the module name AD_SUB Figure 3 1 Sample Program Construction AD_MAIN SIOSUB routine output routine ws HEIKIN Interrupt Average routine value output routine Caution This sample program has been provided as reference software to help the user learn the functions and operating procedures of the assembler package and cannot be used directly as an application program 62 CHAPTER 3 ASSEMBLER PACKAGE EXECUTION 3 2 Assembler Package Execution Procedure 3 2 1 Assembler Linker Object Converter 1 Changes to RA75X under SMP75X which is under NECTOOLS in the current directory in Drive A A A gt CD NECTOOLS SMP75X RA75X A NECTOOLS SMP75X RA75X gt 2 Assemble the sample program 75XTEST1 ASM The following is input in the command line A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM C106 The following message is output at the console 75X Series Assembler VX XX XX Xxx XX Copyright NEC Corporation 1985 ASSEMBLY START TARGET CHIP UPD75106 STACK SIZE 000AH ASSEMBLY COMPLETE NO ERROR FOUND 3 Check the contents of drive B The assembler has output 75XTEST1 REL object module file and 75XTEST1 PRN assembly list file 63 CHAPTER ASSEMBLER PACKAGE EXECUTION 4 Assem
178. hould be specified as the operand e There are no modules in the initially created library file Examples Example 1 Consider an initially created library file named 75XTEST LIB CREATE 75XTEST LIB The library file 75XTEST LIB is created 211 CHAPTER 7 LIBRARIAN CREATE create Example 2 The library file name is omitted ERROR W212 ILLEGAL FILE SPECIFICATION Omission of the library file name results in an error Example 3 Multiple library files are specified for initialization CREATE CLIB LIB DLIB LIB ERROR W209 PARAMETER OVER If multiple library files are specified for initialization as shown here an error results However the first library file specified is created 212 CHAPTER 7 LIBRARIAN ADD add 2 ADD Description Format Object module file name ADD Library file name whe Update library file name Object module name Abbreviated Format Object module file name Library file name Update library file name Object module name Function The ADD subcommand specifies that one or more modules in a different file are to be added to an existing library file Use The ADD subcommand is specified when itis wished to newly record one or more modules in a library file initially created with the CREATE subcommand Description The object module file or library file containing the modules to be
179. ies Librarian VX XX DATE LIB FILE NAME 75XTEST LIB 1 AD MAIN UPDATE O0 RA75X VX XX UPD75106 NUMBER OF MODULES 1 The module AD SUB is deleted and AD MAIN only remains 218 CHAPTER 7 LIBRARIAN REPLACE replace 4 REPLACE Description Format Object file name Library file FROM Update library file name Object module name Object file name Library file name FROM Update library file name Dbject module name Function e The REPLACE subcommand specifies that one or more modules in an existing library file are to be replaced with modules from another object module file or library file Use e The REPLACE subcommand is specified when it is wished to update the recorded module contents Description e The object module file or library file containing the module s is specified as the input file fthe input file is a library file the name of the module in the library file to be replaced is specified in parentheses f a module name is not specified all the modules in the library file are replaced The update library file name is the name of the library file from which the replacement is made Caution The update library file must contain a module with the same name as that of the module to be replaced The input library file name and the update library file name must be different 219 CHAPTER 7 LIBRARIAN REPLACE replace
180. igits Number of code bytes contained one record Maximum 16 bytes OOH in last record Record Mark Indicates start of record 183 CHAPTER 6 OBJECT CONVERTER Remark last record indicating the end of the object code is as shown below 00 0000 01 FF Lr Checksum Record Address 0000H Code Count Example 02000000C050EE 100008008022990799229911 2101092 489 9200 04001800E09906EE77 10002000991F9907108BD389C093C09D40A3C0929C 10003000D67ACOFEBDOA9BAOCAF 19A09A3COAAC 1 EA 100040009D809906C7EF9A2ED9E698D998CEF9EEF9 Data Records 10005000992110890092807393B3991 18B3F890085 10006000E8AAGAFC9910E8AAGAFC10897992A68924 100070004C92A09DB29D9C991 189009A0F9A87FD80 09008000AB40469210AB400AFOBF 00000001FF Last Record 184 CHAPTER 6 OBJECT CONVERTER 6 2 2 Symbol table file format The symbol table file is output in the following format Start of symbol table 04 Cr LF Start of ame mbol Symbol value Public symbol name public symbol Public symbols 1 object module Start of pan t po Symbol value Local symbol name Local symbols r Local symbol name ose Bk nae nana Notes 1 This column is fixed at 4 characters Repeated for each object module Symbol table end mark 2 Up to 8 characters are entered in this column 3 The symbol attributes are indicated by the following values
181. ile in advance also reduces the amount of typing required Options and input file names can still be specified in the command line even if a parameter file is used It is thus possible to write only frequently used options in the parameter file Description 178 The parameter file is a text file and can be created with an editor etc There are no particular restrictions on the length of the parameter file The parameter file name cannot be omitted However if the file type is omitted PLK is taken as being specified A logical device name CON AUX etc cannot be specified as the parameter file name Use of such names will result in an error The contents of the parameter file are expanded at the point at which the F option is written in the linker start line It is therefore possible to change the parameter file contents or add other option specifications with options written after the F option Parameter files cannot be nested If an F option is written in the parameter file an error will result It is not possible to use more than one parameter at one time If multiple F options are specified an error will result Individual options and input file names should be separated by spaces TABs or Line Feed characters A parameter file description cannot be split over a number of lines The 5 and symbols are treated as comment marks in the parameter file Characters from these characters to the end of the line ar
182. input output file specification method the list converter outputs the following message to the console and returns control to the OS List Conversion Program for RA75X VX XX XX Xxx XX Copyright C NEC Corporation 1986 1997 Usage LCNV75X option input file option Please enter LCNV75X if you want help messages f the list converter outputs an error message error number and aborts processing the cause of the error message should be found in 13 5 List Converter Error Messages and appropriate action taken Caution If there is an error in the contents of the input assembly list file the list converter will create an output file in which conversion is incomplete You should check for an error message on the console even if an output file is produced 242 CHAPTER 8 LIST CONVERTER 8 3 3 List converter error handling If the list converter detects an error during execution it performs one of the following three kinds of processing according to the severity of the error 1 Abort error If an error is generated which prevents program execution from continuing the program displays a Program aborted message and the program is aborted immediately 2 Fatal error If an error is generated which would result in generation of object code different from that intended by the user the program nevertheless continues processing to the end then outputs the message X ERRORS FOUND when X is the number of errors 3 Norm
183. ion or address specification is made do not overlap Error No REFERENCE TYPE ERROR AT address IN segment name W501 Impermissible item has been used in reference symbol segment type Program processing Processing is continued with no segment type as symbol type User action Correct so that external reference symbol with correct segment type is referenced and re assemble W503 Information on external reference symbol referenced in text has not been resolved Program processing Part of text corresponding to this external reference symbol is not corrected Link to module containing corresponding external reference symbol 312 CHAPTER 13 ERROR MESSAGES 13 3 Object Converter Error Message Error No Missing input file 001 Input file has not been specified in start line Checks start line syntax then halts processing and returns control to OS Confirm program start method then re execute Error No Message A003 Specified string cannot be interpreted Program processing Checks start line syntax then halts processing and returns control to OS Error No Illegal file name file name A004 Type or length of characters in file name is illegal Program processing Checks start line syntax then halts processing and returns control to OS A005 File name format is incorrect Check correct file name then re execute File not found file name Error No A006 Specified file does not exist
184. ions 203 CHAPTER 7 LIBRARIAN 7 3 Librarian Start Method 7 3 1 Starting the librarian The librarian is initiated as shown below X gt LB75X __ subcommand file name DATE option Option for recording library file edit date File holding commands to librarian subcommands Subcommand file specification symbol Librarian command file name Current drive name Cautions 1 The librarian command files LB75X COM and LB75X OMO must be stored in the current directory 2 If the librarian is started without specification of a subcommand file the librarian waits for subcommand input The librarian does not support directories 7 3 2 Subcommand input in conversational mode Ifasubcommand file is not specified when the librarian is started the librarian waits for subcommand input with prompt displayed after displaying the start message A NECTOOLS SMP75X RA75X gt LB75X 75X Series Librarian VX XX XX Xxx XX Copyright C NEC Corporation 1984 XXXX Asubcommand is used to give instructions to the librarian and uses the following format see 7 4 Description of Subcommands for details of sub commands Subcommand name Operand information Prompt output by librarian 204 CHAPTER 7 LIBRARIAN 7 3 3 Subcommand file f a series of subcommands to be given to the librarian is decided in advance these subcommands are compiled into a subcommand file using the editor f a subcom
185. iple object module files or one library file Parameter file Load module file Link list file Input output file list Linker option list Segment link map list Branch table map list Public symbol list 121 CHAPTER 5 LINKER 5 2 Linker Functions The main functions of the linker are as follows Linkage of object modules in the input file Determination of segment location addresses Resolution of relocatable object code gt IS Automatic branch table creation If an error is found during linkage symbol reference cannot be resolved segment location not possible an error message is output in the segment link map list and to the console e The linker performs linkage processing in accordance with the linker options specified when the linker is started See 5 4 Linker Options for linker options When this processing terminates normally the linker outputs a termination message and returns control to the OS Maximum linker capabilities are shown below Number of symbols that Number of local symbols can be handled by linker Number of external definition PUBLIC symbols Approx 3 000 for all input modules Number of external reference EXTRN symbols Approx 500 per module Number of segments that can be handled by linker Approx 250 For all input modules 1 2 x number of input 2 Number of segments 3 Number of ORG pseudo instructions in source program Total of 4 2 x number of VENT
186. it may be meaningless The priority order for these assembler options is shown in Table 4 3 A cross x in the table means that when the option under A is specified the option under B is invalid Table 4 3 Assembler Options Priority O gt hos NEN EX NEW KA EST peg z 2 1 The side B options are invalid Thereis norelationship between side A and side B 4 4 4 Description of assembler options Each off the assembler options is described in detail in the following pages 81 CHAPTER 4 ASSEMBLER Description Format C device Default Interpretation Cannot be omitted Function C option specifies the product subject to assembly Use C option must always be specified The assembler performs assembly appropriate to the product specified by C option Description e The ROM range RAM range instruction set reserved words specified address name symbols etc vary according to the 75X Series and 75XL Series product device Products which can be specified by the C option and the ROM and RAM ranges of each product are shown in Table 4 4 Table 4 4 Assemble Object Device List 1 75X Series worwo oesrrH 1207606 OHio17H O i r uPD75048 75P048 OH to 1F7FH to O1FFH 400H to 07FFH ote m 1 9 99 1 5 urs
187. itten on one line e the subcommand operand information specification does not fit on one line the specification can be continued by using amp e f amp is specified at the end of a line the operand input request symbol is printed on the next line and input of operand information can be continued from the beginning of the next line LIBRARY CREATION COMMAND CREATE 75XTEST LIB ADD 75XTEST1 REL 75XTEST2 REL 8 75XTEST LIB 75XTEST LIB TO SAMPL LST PUBLICS EXIT e An example of a subcommand file is shown below LIBRARY CREATION COMMAND CREATE 75XTEST LIB ADD 75XTEST1 REL 75XTEST2 REL amp TO 75XTEST LIB LIST 75XTEST LIB TO SAMPL LST PUBLICS EXIT 206 CHAPTER 7 LIBRARIAN 7 3 4 Execution start and end messages 1 Execution start message When the librarian is started an execution start message is displayed on the console 75X Series Librarian VX XX XX Xxx XX Copyright NEC Corporation 1984 2 Execution end message If no fatal error is detected the librarian returns control to the OS without outputting a message If the librarian outputs an error message and aborts processing the cause of the error message should be found in 13 4 Librarian Error Messages and appropriate action taken 7 3 5 Date option The librarian has only one option the DATE option The DATE option is used to record the date on which the library file was edited as information i
188. le name should be specified as a string of up to 8 characters The load module name is printed in the link list Example AAA is specified as the output load module name A NEC TOOLS SMP75X RA75XSLK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK MAAA 146 CHAPTER 5 LINKER M name The link list is printed out as follows 75X SERIES LINKER VX XX XX XX XX XX XX XX PAGE X COMMAND 7Z5XTEST1 REL 75XTEST2 RBL 075 MAAA INPUT MODULE LIST 75XTEST1 REL AD_MAIN 75XTEST2 REL AD_ SUB LOAD MODULE LIST 75XTEST LNK AAA SEGMENT LINK MAP FOR 75XTEST LNK AAA MAP OF ROM AREA 147 CHAPTER 5 LINKER P NP print no print 2 P NP Description Format P output file name NP Default Interpretation The object module file name MAP specified initially is output to the current path Function P option specifies the output destination and file name of the link list file output by the linker The NP option specifies that no link list file is to be created Use The P option is specified when it is wished to change the link list file output destination or file name The NP option is specified when linkage is to be performed only in order to output a link module file etc the linkage time is reduced Description e n addition to a file name the following can be specified as the file output destination PPRN Link list is output to line printer PCON Link
189. le name specified by INCLUDE control instruction includes relative path name beginning with or beginning with except the drive name or V 1 Path whose name comprises the name of the path in which the source module file exists followed by the path name specified by the INCLUDE control instruction 2 Path whose name comprises the path name specified by the I option followed by the path name specified by the INCLUDE control instruction 3 Path whose name comprises the path name specified by the environment variable INC75X followed by the path name specified by the INCLUDE control instruction 113 CHAPTER 4 ASSEMBLER include path Examples Next the following conditions Source module file name AASRCOWTILS ASM e INCLUDE control instruction specification INCLUDE PATH INCFILE H option specification IB WORK Environment variable INC75X specification BAINC The include file search order is as follows 1 A SRC PATH INCFILE H lt 2 gt B WORK PATH INCFILE H lt 3 gt B INC PATH INCFILE H That is the assembler searches these files in order and read the first one found as part of the source module file 114 CHAPTER 4 ASSEMBLER parameter file name Description Format F parameter file name Default Interpretation Parameter file not used Function The F option specifies that the assembler option and input file name are to be read from the file specifi
190. le output by the assembler The NO option specifies that no object module file is to be created Use The O option is specified when it is wished to change the object module file output destination or file name The NO option is specified when assembly is to be performed only in order to output an assembly list etc the assembly time is reduced Description When the O option is specified and the output file name is omitted the output file name source module file name REL is taken as being specified f the path name is omitted from the file name specification the current path is taken as being specified 88 CHAPTER 4 ASSEMBLER object no object Examples Example 1 If 75XTEST1 ASM is assembled with NO option specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM C106 NO An object module file is not output The Assemble List File 75XTEST1 PRN only is output Example 2 If 75XTEST1 ASM is assembled with the O option specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM 106 OSAMPLE REL The object module file SAMPLE REL and the Assemble List file 75XTEST1 PRN are output CHAPTER 4 ASSEMBLER J NJ junk no junk 4 J NJ Description Format J NJ Default Interpretation NJ Function The J option specifies that an object module file is to be created even if there is an assembly error The NJ option specifie
191. library file created by the librarian and outputs a load module file and link list file If a link error occurs an error message is output to the link list file and the console Main Linker Processing 1 Linkage of the object modules in the input file 2 Determination of segment location addresses 3 Resolution of relocatable object code 4 Automatic branch table creation 119 CHAPTER 5 LINKER 5 1 Linker Input Output Files Linker LK75X input output files are shown in Table 5 1 Table 5 1 Linker Input Output Files Type of File Default File Type Input file Object module file ete 1 Object module file output by assembler Library file Netes 1 2 File created by librarian in which multiple object modules are recorded Output file Load module file Note 1 File containing all information resulting from linkage The load module file is used as the input file for the object converter OC75X Link list file List file containing linkage information such as input output file list linker option list segment list etc Parameter file ete 3 PLK This file is created with an editor when it is wished to specify a large number of files which cannot be specified in the command line as linker input files Notes 1 Binary file 2 For details see CHAPTER 7 LIBRARIAN 3 For details see 14 F under 5 4 4 Description of linker options 120 CHAPTER 5 LINKER Figure 5 1 Linker Input Output Files Mult
192. ll generate an error in most cases but the size of each segment is shown in the map file Message MODULE NOT FOUND MODULE module name Error No F134 Cause Specified module is not in library file Program processing Program execution is halted User action Specify correct module name MODULE COUNT OVERFLOW FILE file name There are too many module name specifications for library file Error No F135 Message Cause Program processing Program execution is halted User action Reduce number of module name specifications ILLEGAL SEGMENT CLASS SEGMENT Segment name CLASS segment type Illegal segment type in input file Error No A505 Message Cause Program processing Program execution is halted User action Create input file again THIS MODULE IS DIFFERENT VER REV MODULE module name Input file version is not compatible with this linker version Error No F301 Message Cause Program processing Program execution is halted User action Input file output by same version of assembler THIS MODULE IS OBJECT DIFFERENT CHIP OR SERIES MODULE module name Modules output by non 75X assembler has been input Error No F302 Message Cause Program processing Program execution is halted User action Input modules output by 75X assembler THIS MODULE IS OBJECT NOT LINKABLE MODULE module name Modules output by non 75X assembler has been input Error No F303 Message Cause Program pr
193. lly The product has not been properly installed You should run the setup program from scratch again Please consult your nearest NEC technical support department if you need assistance to install this product 57 58 CHAPTER 3 ASSEMBLER PACKAGE EXECUTION 2 If you are installing by running dosinst bat under DOS The example is shown of installation in the case where a PC 9800 series host machine is used the Assembler Package is read from drive C the execution format is installed in A nectools bin and the sample program is installed in A nectools smp75x Execution Example lt 1 gt Execute the batch file dosinst bat The description format is as shown below x gt dosinst bat A Installation source drive A Installation destination drive A Installation destination directory A indicates 1 or more blank spaces lt Example of Description gt A gt mkdir nectools Creates an installation destination directory A gt C Changes from the current drive to the installation source drive C gt dosinst bat c a nectools Executes the batch file lt 2 gt To end the installation input the CTRL key C key or the ALT key C key when the message Press any key to continue is displayed The following message will be displayed End batch file execution Y N Input Y to terminate execution of the batch file Press N to continue execution of the batch file lt 3 gt Ifyou termin
194. lude path 17 I Description Format path name path name Default Interpretation Search is executed in stipulated search order ete Function The I option specifies the search path of an include file specified by INCLUDE control instruction Use e When an include file is in a different path from the source module file this option is used to specify that path Description e Multiple paths can be specified separated by commas In this case space cannot be inserted before or after the commas e The path name cannot be omitted Also an error will result if an item other than a path name is specified Up to eight I options can be specified at one time If multiple paths are specified by an option include files are searched for in the specified order The search path set by the environment variable INC75X as well as by the option Note Example A gt SET INC75X A SRC HDR 106 Note The include file search is conducted in the following order 1 When file name specified by INCLUDE control instruction does not include a path name 1 path in which source module file exists 2 path specified by option 3 path specified by environment variable INC75X 2 When the file name specified by INCLUDE control instruction includes an absolute path name beginning with the drive name or 4 1 Path specified by INCLUDE control instruction 3 When fi
195. lue Amend to correct description format SEGMENT TYPE MISMATCHED Impermissible item is written as operand symbol attribute processing is continued with 0 as expression value Amend to correct description format Assembler s Error Message 24 Message Cause Program processing User action 25 Message Cause Program processing With symbol definition pseudo instruction symbol is not defined In other cases User action 26 Message Cause CHAPTER 13 ERROR MESSAGES cont d OPERAND TYPE MISMATCHED Mismatch with operand description format permitted in mnemonic or pseudo instruction With mnemonic NOPs are generated equivalent to longest code of target device In Amend operand to correct description format BIT ADDRESS EXPRESSION ERROR Bit specification exceeds range 0 to 3 processing is continued with 0 as bit value Ensure that bit specification is in range 0 to 3 STRING LONGER THAN 2 CHARACTERS IS NOT ALLOWED String exceeding 2 characters cannot be used in expression Program processing Processing is continued using first 2 characters User action 28 Message Cause Program processing User action 30 Message Cause Ensure that string length is no more than 2 characters EXPRESSION NEST OVERFLOW Nesting of parentheses is too deep Processing is continued with 0 as operand value Ensure that parenthesis nesting is maximum of 8 levels MORE THAN 80
196. lute segments and segments whose location addresses are specified by the CD option are located unconditionally starting at the specified address The area specified by the RS option is reserved in advance as a segment location prohibited area There are three methods of determining the location addresses of other relocatable segments as follows e Sequential linkage mode specified by the SQ option e Random link mode RN option specification or mode specification omitted Order specification mode specified by CD option 125 CHAPTER 5 LINKER lt 1 gt Sequential linkage mode Location is performed from the low address of the free memory area in the segment input order The segment input order is the order of the object modules specified for input or in an object module the order in which the segments are written in the source Example 1 The linker is started as shown below A gt LK75X OM1 REL OM2 REL 00M LNK SQ In this case the input segments are located as shown below OM1 REL Program memory OM2 REL Free area 126 CHAPTER 5 LINKER Example 2 Ifthere is absolute segment performing linkage with the SQ option specified may result in the creation of a free area in memory as shown below Module Program memory Note ASEG is an absolute segment In the above case the location address of the absolute segment is determined first Therefore when location of segment SB is attempte
197. m number of space characters corresponding to one TAB code at this time Description e The number of characters can be specified as a decimal number between 0 and 8 An error will be generated if a number outside this range or a non numeric value is specified f the parameter is omitted 8 is taken as being specified f the NP is specified the LT option is ignored 111 CHAPTER 4 ASSEMBLER KA NKA assemble list no assemble list 16 KA NKA Description Format KA NKA Default Interpretation KA Function e KA option specifies assembly list to be output to print file e NKA option specifies assembly list not to be output to print file Use e When assembly list is not required specify NKA option When assembly list is required while parameter file including NKA option is being used specify KA option after F option Description e The KA NKA options correspond to the LIST control instruction NOLIST control instruction of assemblers However the KA and NKA options have an effect on whole source module e f the KA and NKA options are specified simultaneously the option specified later is effective e The NKA option takes priority over the LIST control instruction e NOLIST control instruction takes priority over the KA option e When the NP option is specified the KA option becomes invalid and no assembly list is output 112 CHAPTER 4 ASSEMBLER inc
198. mand file is specified when the librarian is started the librarian reads the subcommands from the subcommand file and performs processing accordingly and when all the subcommands in the subcommand file have been executed returns control to the OS e The subcommand is created in the following format Subcommand name information Subcommand name information EXIT e Up to 132 characters can be written on one line of the subcommand file f a subcommand does not fit on one line an ampersand 8 symbol is written at the end of the line to indicate that the subcommand is continued on the next line e Characters from a semicolon up to the end of a line are regarded as a comment and are not interpreted as part of a librarian subcommand Even if there is not EXIT subcommand at the end of the subcommand file the librarian infers the presence of an EXIT subcommand and terminates the processing e When subcommand input ends processing of each subcommand begins When processing of one subcommand is completed is displayed again and the librarian waits for input of the next subcommand This operation is repeated until the termination subcommand EXIT subcommand is input Subcommand specification Subcommand processing J Subcommand specification Termination subcommand specification Librarian termination 205 CHAPTER 7 LIBRARIAN e Up to 80 subcommand characters can be wr
199. mat ERROR error number error message Librarian s Error Messages Woo Error No MODULE NOT FOUND file name module name woo W210 Cause External definition symbol defined in module in file specified in ADD or REPLACE subcommand already exists in output library file Program processing Program ignores this subcommand and waits for input of next subcommand User action Re execute with correct subcommand 319 CHAPTER 13 ERROR MESSAGES Librarian s Error Messages MISSING FILE SPECIFICATION There is no file name specification subcommand parameter Error No W211 Message Cause Program processing Program ignores this subcommand and waits for input of next subcommand Re execute with correct subcommand ILLEGAL FILE SPECIFICATION file name Illegal file name has been specified in subcommand parameter User action Error No W212 Message Cause Program processing Program ignores this subcommand and waits for input of next subcommand Re execute with correct subcommand FILE SPECIFICATION CONFLICTED file name Input file name and output file name specified by subcommand parameter do not match User action Error No W213 Message Cause Program processing Program ignores this subcommand and waits for input of next subcommand Re execute with correct subcommand ILLEGAL FILE file name File specified by subcommand parameter is not
200. method Object converter options are specified in the command line when the object converter is started See 6 3 Object Converter Start Method for the method of specifying object converter options in the command line 6 4 3 Object converter option priority order 1 If multiple identical options or options of the same kind are specified in the command line the option specified last is valid 2 If the same or same kind of option is specified in the parameter file and in the command line the command line option is valid 6 4 4 Description of object converter options Each of the object converter options is described in detail in the following pages 191 CHAPTER 6 OBJECT CONVERTER S NS symbols no symbols 1 S NS Description Format S output file name NS Default Interpretation Input file name SYM is created in current path Function e The S option informs the object converter that a symbol table file is to be output The NS option informs the object converter that a symbol table is not to be output Use The NS option is specified when symbolic debugging is not to be performed in debugging Description f the S option or the NS option is not specified the object converter creates a symbol table file on the current path with the initially specified load module file name but with the file type changed to SYM It is the same when the file name has been omitted and the S option has been sp
201. module file Only the necessary modules in the library file are linked Creating a library file in this way facilitates object module management and administration 201 CHAPTER 7 LIBRARIAN 7 1 Librarian Input Output Files Librarian input output files are shown in Table 7 1 Table 7 1 Librarian Input Output Files Type of File Default File Type Input file Object module file ete 1 Object module file output by the assembler LI Subcommand file ete A series of subcommands for the librarian are created in advance using the editor in the form of a subcommand file Output file Library file File which has been updated by the librarian additions deletions replacements List file PRN List file to which information on each module in the library file is output Notes 1 Binary file 2 See 7 3 3 Subcommand file EL Library file LIB File created by the librarian Specific modules or the all modules in the file can be input B Figure 7 1 Librarian Input Output Files Object module files Librarian LB75X List file Library file Caution cannot be used as a file name in Librarian Use instead 202 CHAPTER 7 LIBRARIAN 7 2 Librarian Functions The main functions of the librarian are as follows 1 Librarization of modules 2 Library file editing 3 Printing of library file information e f an error is found during processing the librarian outputs an error message to the
202. mple 1 To output information on all modules in 75XTEST LIB LIST 75XTEST LIB 75X Series Librarian VX XX DATE LIB FILE NAME 75XTEST LIB 1 AD MAIN UPDATE O0 RA75X VX XX UPD75106 2 AD SUB UPDATE O0 RA75X VX XX UPD75106 NUMBER OF MODULES 2 231 CHAPTER 7 LIBRARIAN LIST list Example 2 To output information on the specific module AD MAIN in 75XTEST LIB LIST 75XTEST LIB AD_MAIN 75X Series Librarian VX XX DATE LIB FILE NAME 75XTEST LIB 1 AD MAIN UPDATE 0 RA75X VX XX UPD75106 NUMBER OF MODULES 1 Example 3 To output information on PUBLIC symbols in the specific module AD MAIN in 75XTEST LIB LIST 75XTEST LIB AD MAIN PUBLICS 75X Series Librarian VX XX DATE LIB FILE NAME 75XTEST LIB 1 AD MAIN UPDATE O0 RA75X VX XX UPD75106 SEGO SEG1 SEG2 SEGS SEG15 TDATA NUMBER OF PUBLIC SYMBOLS 6 NUMBER OF MODULES 1 232 CHAPTER 7 LIBRARIAN EXIT exit 6 EXIT Description Format EXIT Abbreviated Format E Function e The EXIT subcommand specifies that the librarian is to be terminated Use e The EXIT subcommand is specified to terminate the librarian Example e Terminates the librarian A NECTOOLS SMP75X RA75X gt 233 MEMO 234 CHAPTER 8 LIST CONVERTER The list converter LONV75X has as input an assembly list file and object module file output by the assembler and a load module file ou
203. n in TITLE option User action Specify the parameter 297 N Assembler s Error Message 11 Message Cause Program processing User action 14 Message Cause CHAPTER 13 ERROR MESSAGES cont d NO PARAMETER IS ALLOWED TO THIS CONTROL Parameter has been specified for option which does not require parameter Specified parameter is ignored Delete the parameter LABEL WITHOUT COLON IS REQUIRED There is no name or segment name in symbol field Program processing This statement is ignored as illegal statement User action 15 Message Cause Write name or segment name in symbol field LABEL WITH COLON IS NOT ALLOWED Delimiter between symbol field and mnemonic field is space not colon Program processing This statement is ignored as illegal statement User action 16 Message Cause Replace unnecessary colon delimiter with space LABEL WITHOUT COLON IS NOT ALLOWED Colon lt is required as delimiter between symbol field and mnemonic field Program processing Processing is continued with label undefined User action 17 Message Cause Write colon NAME IS NOT ALLOWED TO THIS STATEMENT Name cannot be written in symbol field in this statement Program processing Processing is continued with name undefined User action 18 Cause Define name in appropriate place other than this statement and re assemble UNDEFINED SYMBOL Undefined symbol has been ref
204. n the library file and to print this information as a header in the output list 207 CHAPTER 7 LIBRARIAN DATE date Description Format DATE character string Abbreviated Format DA character string Default Interpretation DATE system time Function e The DATE record the specified string date as the library file edit date in the library file e The specified string is also printed in the list file header Use The DATE option is specified in order to record when editing was performed on individual modules in the library file Description A string of up to 12 characters should be specified Examples Example 1 The librarian is started with the DATE option specified A subcommand file is not specified A NECTOOLS SMP75X RA75X gt LB75X DATE XX XX XX 75X Series Librarian VX XX XX Xxx XX Copyright C NEC Corporation 1984 X XXX CREATE 75XTEST LIB ADD 75XTEST1 TO 75XTEST LIB LIST 75XTEST LIB 75X Series Librarian VX XX DATE XX XX XX PAGE LIB FILE NAME 75XTEST LIB XX XX XX XX XX XX 1 AD MAIN XX XX XX UPDATE O0 RA75X VX XX UPD75106 NUMBER OF MODULES 1 The processing date is recorded in the library file 208 CHAPTER 7 LIBRARIAN DATE date Example 2 The library file 75XTEST LIB is updated with the DATE option specified A NECTOOLS SMP75X RA75X gt LB75X DATE XX XX XX 75X Series Librarian VX XX XX Xxx XX Copyright C NEC Corporation 1984 XXXX
205. nd 337 APPENDIX D SAMPLE PROGRAMS A NECTOOLS SMP75X RA75X gt LB75X 75X Series Librarian VX XX XX Xxx XX Copyright NEC Corporation 1984 CREATE 75XTEST LIB ADD 75XTEST1 REL 75XTEST2 HEL TO 75XTEST LIB LIST 75XTEST LIB TO 75XTEST LST PUBLICS EXIT A NECTOOLS SMP75X RA75X gt LONV75X L75XTEST LNK A75XTEST1 List Conversion Program for RA75X VX XX XX Xxx XX Copyright C NEC Corporation 1986 1997 pass 1 start pass 2 start Conversion complete A NECTOOLS SMP75X RA75X gt LONV75X L75XTEST LNK 75XTEST2 List Conversion Program for RA75X VX XX XX Xxx XX Copyright C NEC Corporation 1986 1997 pass 1 start pass 2 start Conversion complete 338 APPENDIX D SAMPLE PROGRAMS D 3 Output List 1 Assembly list a 75XTEST1 ASM assembly list Output to 75XTEST1 PRN 75X SERIES ASSEMBLER VX XX XX XX XX XX XX XX PAGE X A D CONVERTER VX XX d COMMAND Z5XTEST1 ASM C106 KS KX STNO ADRS R OBJECT IC SOURCE STATEMENT 1 TITLE A D CONVERTER VX XX 3 ae A D CONVERT PROGRAM 5 NAME AD MAIN 6 EXTRN CODE ADCONV CODE SIOSUB 7 PUBLIC TDATA SEL15 8 STKLN 10 9 0000 C000 VENTO MBE 1 RBE 1 MAIN 10 0008 E 8000 VENT4 1 RBE 0 ADCONV 11 io SEGO DSEG 1AT 10H 13 0110 TDATA DS 2 14 15 TABLE 16 SEG1 CSEG IENT 18 0000 991F SEL15 SEL MB15 19 20 MAIN ROUTINE is 21 25 sos SEG2 CS
206. nd Lr can be handled by the assembler 1 3 2 Limitation on number of symbols 1 2 During assembly Approx 3 000 During linkage Limits to the number of symbols differs as follows depending on the type of symbol Local symbols No limit e External definition PUBLIC symbols Approx 3 000 for all input modules e External reference EXTRN symbols Approx 500 per module 1 3 3 Limitations on number of segments 1 2 During assembly For one source program a total of approximately 120 for a to c below can be written a Number of segment definition pseudo instructions b Number of ORG pseudo instructions 2 x number of VENT pseudo instructions During Linkage For all input modules a total of approximately 250 a to d below can be input a Number of input modules x 2 b Number of segments c Number of ORG pseudo instructions in source program d 2 x number of VENT pseudo instructions 37 CHAPTER 1 GENERAL DESCRIPTION 1 3 4 Other limitations 1 During assembly Number of local symbols 1 macro 100 including temporary parameters Nest Levels Approx 64 Kbytes Macro Body Area Size 32 Levels Macro instructions instructions SWITCH instructions and INCLUDE instructions together Maximum number of times repeating macros can be repeated 1023 Times 1 3 5 Number of linker branch tables Approximately 1 000 branch tables can be created by the linker
207. nk map list Branch table map list Public symbol list Symbol table list 11 2 1 Linker option list The image of the options input from the console is output in this list Output Format 75X SERIES LINKER Vx xx lt 1 gt PAGE lt 2 gt COMMAND cccc COMMAND FILE lt 3 gt Descriptions of Output Items System date Output list page number in decimal notation Parameter file command image Blank if there is no lt _ _ file input specification Command Commandimage 000000 278 CHAPTER 11 PROGRAM OUTPUT LISTS 11 2 2 Input output module list The input output file names and module names are output in this list Output Format INPUT MODULE LIST FFF F MMM M lt 1 gt lt 2 gt LOAD MODULE LIST LLL L lt 3 gt Descriptions of Output Items Input file name object module file library file Input object module name Output file name load module file lt 4 gt Output module name value specified by M option If there is no M option primary name of first input file name 279 CHAPTER 11 PROGRAM OUTPUT LISTS 11 2 3 Segment link map list Information on located segments is output in this list in address order separately for the program memory and data memory Output Format SEGMENT LINK MAP FOR 1 2 MAP OF ROM AREA BASE LENGTH MODULE NAME SEGMENT NAME TYPE XXX BBBB LLLL lt 3
208. nted on one line Default Interpretation LL66 LW132 Function e The LL option specifies the number of lines per page in the assembly list e The LW option specifies the number of columns per line in the assembly list Use e The LL and LW option are specified when it is wished to change the number of lines to be printed on one page or the number of columns to be printed in one line of the assembly list Description e The number of lines and columns which can be specified by these options are as follows 20 lt number of print lines per page lt 65535 72 lt number of print columns per line lt 256 f the number of characters of per line for which output to the assembly list file is attempted exceeds the value specified by the LW option the assembler truncates the characters exceeding the specified number of columns before outputting the line to the list file e The number of lines actually printed on one page of the assembly list file is number of lines specified by LL option 6 as a 3 line margin is left at the top and bottom of each page of the assembly list 105 CHAPTER 4 ASSEMBLER LL LW page length page width Example Example 1 If 75XTEST1 ASM is assembled with printing of 40 lines per page and 80 characters per line specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM C106 LL40 LW80 The following type of assembly list is output 75X SERIES ASSEMBLER VX XX XX X
209. o 200H become location disabled area 162 CHAPTER 5 LINKER RS reserve Examples Example 1 When the RS option is omitted A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK SEGMENT LINK MAP FOR 75XTEST LNK AD_MAIN MAP OF ROM AREA LENGTH MODULE NAME SEGMENT NAME TYPE AD_MAIN ABSOLUTE AD_MAIN ABSOLUTE AD_SUB SENT AD_MAIN AD_SUB SENT AD_MAIN SENT AD_MAIN INBLOCK 163 CHAPTER 5 LINKER RS reserve Example 2 When the RS option is specified A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK RS 40H 60H SEGMENT LINK MAP FOR 75XTEST LNK AD_MAIN MAP OF ROM AREA LENGTH MODULE NAME SEGMENT NAME TYPE AD_MAIN ABSOLUTE AD_MAIN ABSOLUTE AD_SUB SENT AD_MAIN IENT AD_MAIN SENT Reserve area AD_SUB SENT AD_MAIN INBLOCK 164 CHAPTER 5 LINKER SQ RN sequential random 8 SQ RN Description Format SQ RN Default Interpretation RN Function The SQ option specifies that segments are to be located in the order in which they are written in the input modules or in each input module e The HN segment specifies that segments are to be located in memory in an efficient fashion without regard to the module input order Use The RN option is specified when it is wished to avoid creating free areas as far as possible without regard to the segment input order e When desiring to locate
210. o error print 5 E NE Description Format E output file name NE Default Interpretation NE Function The E option specifies error list output and the output destination and filename The NE option specifies that no error list file is to output Use e Specify the E option when desiring to change the error list file output destination or output file name Description When specifying the E option if the output file name is omitted it is regarded as if the output file name Load Module File Name EOC was specified e f the drive name is omitted from the file name specification the current path name is taken as being specified The path name can be described in the file name and the path for generating an error list file can be specified In this case a file with the load module file name but with the file type changed to EOC is generated in the specified path The following can be specified as the device type file output destination EPRN Error list is output tp line printer ECON Error list is output to console EAUX Error list is output to RS 232 C ENUL Error list is not output If the E option and the NE option are instructed at the same time the last option specified becomes valid 198 CHAPTER 6 OBJECT CONVERTER parameter file name Description Format F parameter file name Default Interpretation Parameter file is not used F
211. object module file load module file or User action Error No W214 Message Cause library file or write protected file has been specified as output file Program processing Program ignores this subcommand and waits for input of next subcommand He execute with correct subcommand CHECK SUM ERROR file name Check sum error in file User action Error No W215 Message Cause Program processing Program ignores this subcommand and waits for input of next subcommand Re create file in which checksum error occurred then re execute EXIT SUBCOMMAND NOT FOUND file name There is no EXIT subcommand in parameter file specified at start time User action Error No W216 Message Cause Program processing Processing is performed assuming presence of EXIT subcommand at end of parameter file control is returned to OS User action Insert EXIT subcommand in parameter file WORKING TABLE SPACE EXHAUSTED Work area memory is insufficient Error No A901 Message Cause Program processing Control is returned to OS User action Increase memory INVALID FILE SYNTAX file name File format is incorrect Error No A902 Message Cause Program processing Control is returned to OS He execute with correct subcommand PROGRAM ERROR error code Program bug has been detected User action Error No A999 Message Cause Program processing Control is returned to OS User action Inform NEC of pr
212. ocated as shown below a branch table is created Program memory BRCB BADD C1 segment BRCB BADD i C2 segment 002 OO BR BADD Branch table 136 CHAPTER 5 LINKER Example 2 there 2 byte branch instructions which reference differently named symbols which have the same value in the same block one common branch table is created in the same block These symbols have different names but a common address value When the segments shown above are located as shown below a branch table is created as shown below Program memor OH I 4 BRCB REL1 BRCB C2 C1 segment BRCB REL2 po eee BR BR REL2 Branch table J REL1 C2 REL2 The created branch table information is shown in the branch table map list in the link list file output C2 segment 1FFFH by the linker 137 CHAPTER 5 LINKER Example 3 Two modules are linked as shown below Module 1 Module 2 PUBLIC EXT1 EXT3 10H EQU 40H CSEG AT 10H 30H AT 10H END EXT1 EXT2 IABS1 IABS2 IABS3 IABS1 IREL1 IREL2 51 IEXT1 IEXT2 The following branch table list is output to the link list file output by the linker 138 CHAPTER 5 LINKER SEGMENT LINK MAP FOR BR LNK BR1 MAP OF ROM AREA LENGTH MODULE NAME SEGMENT NAME TYPE INBLOCK ABSOLUTE ABSOLUTE INBLOCK INBLOCK Branch table LENGTH MODULE NAM
213. ocessing Program execution is halted User action Input file output by 75X assembler 30 CHAPTER 13 ERROR MESSAGES Linker s Error Messages cont d Error No INVALID FILE SYNTAX FILE file name F304 Module output by the non 75X assembler has been input Program processing Program execution is halted Input files output by 75X assembler Error No SAME NAME SEGMENT IN DIFFERENT CLASS SEGMENT segment name F307 W300 w308 Error No Message SAME NAME SEGMENTS OF DIFFERENT ALIGNMENT TYPE MODULE module W309 SEGMENT segment name W310 Cause External reference symbol information has not been resolved There is no external reference symbol corresponding to the external definition symbol W311 External definition symbol and external reference symbol segment types do not match Program processing External definition symbol segment type is valid Ensure that external definition symbol and external reference symbol segment types match Program processing Processing is continued with 0 as stack size User action Use SZ option specification of 100H or less or amend so that accumulated value of stack size for each module is 100H or less Error No SPECIFIED SEGMENT NOT FOUND IN INPUT MODULES SEGMENT segment name F405 Code segment name specified by order or address option does not exist in input file Program processing Program execution is halted Specify correc
214. ode must be calculated by referring to the segment map list etc output by the linker This is not so necessary if symbolic debugging is performed effectively using the OC75X This problem is common to relocatable assemblers The list converter is provided to solve this problem This list converter creates an absolute assembly list which enables debugging to be performed more efficiently the absolute assembly list is to be output to the printer specifying the printer as the output destination in the list converter LCNV75X enables the list to be output directly to the printer Example To output the absolute assembly list to the printer A NECTOOLS SMP75X RA75X gt LONV75X 75XTEST1 L75XTEST LNX OPRN List Conversion Program for RA75X VX XX XX Xxx XX Copyright C NEC Corporation 1986 1997 Pass 1 start Pass 2 start Conversion complete 289 CHAPTER 12 EFFECTIVE USE OF THE ASSEMBLER PACKAGE 12 3 Finding Error Lines To find error lines in the assembly list in order to eliminate assembly errors the error line back no is used When errors are detected as a result of assembly the assembler outputs the following message Example ASSEMBLY COMPLETE 5 ERRORS FOUND 10 Number of errors Line number of last error line In this example the lOth line of the assembly list is the last error line In the lOth line of the assembly list the line number of the preceding error line is shown together with the error message
215. of the same source program Also since addresses in the assembly list file created by the assembler are virtual addresses the addresses in the absolute assembly list file created by the list converter should be referred to 2 Binary file Figure 8 1 List Converter Input Output Files Object module file Assembly list file Load module file Parameter file 9 9 e List converter LCNV75X 9 Absolute assembly list file Error list file 236 CHAPTER 8 LIST CONVERTER Figure 8 2 Example of List Converter Input Output Files Source module file C 75xXTEST1 ASM 75xTEST2 ASM Relocatable Relocatable assembler assembler Object Object Assembly module file module file list file 75XTEST1 REL 75XTEST2 REL 75XTEST2 PRN Load module file 75XTEST LNK List converter List converter Absolute assembly Absolute assembly list file list file 75XTEST1 P 75XTEST2 P 8 2 List Converter Functions The list converter searches among the modules in the input load module file LNK for modules in the object module file REL input at the same time The list converter reads from the relevant module information values determined during linkage for the relocatable addresses and temporary object code which were not determined during assembly It then inserts these values in the appropriate places in the input assembly list and outputs the result as an absolute assembly list file 237 CHAPTER 8 LIST CONVE
216. ogram for RA75X VX XX XX Xxx XX Copyright C NEC Corporation 1986 1997 pass 1 start pass 2 start conversion complete The list converter asks for the load module file name and this should therefore be input When the file name has been input the converter processing is started If the specified file does not exist or the file type is omitted the following message is output and control is returned to the OS A NECTOOLS SMP75X RA75X gt LONV75X 75XTEST1 List Conversion Program for RA75X VX XX XX Xxx XX Copyright C NEC Corporation 1986 1997 A006 File not found I75XTEST1 LNK Program aborted Example 3 Insert a space between L and the primary name A NECTOOLS SMP75X RA75X gt LONV75X L 75XTEST LNK List Conversion Program for RA75X V1 1 19 Mar 88 Copyright C NEC Corporation 1986 1997 A002 Too many input file Please enter 1 75 if you want help messages Program aborted Caution A space cannot be inserted between L and the file name If a space is inserted the list converter will abort as shown in Example 3 246 CHAPTER 8 LIST CONVERTER O output file name Description Format O file name Default The file is output with the file extension P added to the input assembly list file primary name Function The O option specifies the name of the file to which the absolute assembly list is to be output Use e The O option is specified when the absolute assembly
217. ogram name version and error code CHAPTER 13 ERROR MESSAGES 13 5 List Converter Error Messages Message lt L file gt a lt A file gt o lt O file gt L Linker output file A Assembler output file O Output file name Cause Start command option name is incorrect User action Message File name file open error Cause lt 1 gt Input file has not been found lt 2 gt There is a space between the option and file name Program processing Execution is halted and control is returned to OS User action lt 1 gt Check the input file name With the L output the file must also be specified With the option check that there is both REL and PRN lt 2 gt Start again with no space between option and file name Message Error n n 20 to 27 35 36 40 to 47 program aborted Cause Error in input load module file or input object module file Program processing Execution is halted and control is returned to OS User action Check the input file name If there is no error the file is damaged and must be created again with the linker or assembler Message Error 30 program aborted Cause Error in input assembly list file Program processing Execution is halted and control is returned to OS User action Check the input file name If there is no error the file is damaged and must be created again with the assembler Message Error 37 program aborted Cause Error in input assembly list ORG ps
218. om the project manager the Y and F options are added in the linker F project file primary name PLK At this time the user cannot add the F option When setting options from the project manager the Y option is added in the object converter The structured assembler preprocessor always starts together with the assembler When setting options from the project manager at this time the C and Y options are added in the assembler At this time the user cannot add the C option The project manager s Option Debug menus disregarded For debugging informa tion set the GS option in the Set Structured Assembler Options menu or the GA option in the Set Assembler Options menu CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER 10 1 1 Assembler 1 Options Menu Items Options Menu items set from the project manager are as follows Figure 10 1 Options Setting Menu Assembler Project Manager TEST PRJ Run Project Help ER Project Manager Options structured assembler options Assembler options Linker options Object converter options Tools Debug Status Bar Tool Box source List 261 262 CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER 2 Options Setting Dialog Box Following is an explanation of the dialog box for setting assembler options From the menu items select Option Set Assembler Options menu
219. on from continuing the program displays a Program aborted message and the program is aborted immediately However if this type of error is discovered on the object converter start line execution ends after the check continues for the remainder of the start line Fatal error An error in which a HEX format object module file or symbol file which has been generated differs from the user s design is treated as a fatal error Processing is continued to the extent that other errors can be detected but a HEX format object module file or a symbol file is not created If a file with the same name as the one you are trying to create already exists the existing file is deleted Warning Error If some error is discovered in a portion which is not related to the generation of a HEX format object module file or symbol file it is counted as a warning error This is a comparatively minor error and does not effect the file which is output Program execution can continue to the very end Normal termination If the program terminates normally it outputs the message Object Conversion Complete 0 error s and 0 warning s found In case 1 2 and 3 above the error message is output in the following format ERROR error number error message The error number is expressed as one alphabet character and 3 digits The header alphabet characters are one of the following letters e W Warning Error e F Fatal Error A Abort Err
220. ons of binary data this is known as machine language computer comprehensible language Programming in machine language that is in binary code is difficult for a human mind to learn and prone to errors hence the method of representing machine language in easily understood English symbols and writing programs using these symbols The language system for programming using these symbols is called assembly language A program is needed to translate a program written in assembly language into a collection of binary numbers intelligible to a microprocessor This program is called an assembler Figure 1 2 Assembler Flow Program Written Translation in Assembly Language Source Module File Assembler Program Comprising Binary Numbers Object Module File 21 CHAPTER 1 GENERAL DESCRIPTION 2 The role of this package in developing products using microcomputers Where assembly language programming fits into product development is outlined in Figure 1 3 Development Process for Products Using Microcomputers Figure 1 3 Development Process for Products Using Microcomputers Product planning System design Hardware development Software development Logic design Software design Programming in assembly language Production Position of Assembly assembler Testing package A i NO YES YES Debugging 5 System evaluation Commercial production 22
221. or 189 CHAPTER 6 OBJECT CONVERTER 6 3 4 Object converter termination status When the object converter terminates and returns control to the OS one of the following error status codes is returned to the OS Termination Conditions Termination Status When the object converter is started from a batch file under MS DOS PC DOS IBM DOS it is possible to determine whether there are any errors automatically using these values 190 CHAPTER 6 OBJECT CONVERTER 6 4 Object Converter Options 6 4 1 Types of object converter options Object converter options are used to give the object converter detailed directions concerning its operation There are seven different options as shown below Table 6 2 Object Converter Option Types Description Format Function Category Default Interpretation NS is created in current path NR sequence specification Input file is created in current NO path 5 E File name Specifies the error list file NE NE Ffile name Specifies the parameter file Reads all the options and file names from the command line 7 Ypath name Specifies the device file search path It searches in the sequence of the ADEV path with respect to the OC75X starting path the OC75X starting path the current directory and the path set in the environ ment variable PATH Remark Options can be written in either upper or lower case characters 6 4 2 Object converter option specification
222. or select Options Source List menu Select the Options button in the dialog box to open the assembler options setting dialog box Figure 10 2 Options Setting Dialog Box If the source file has not been selected Assembler Sets option for all source files Assembler option setup Delete source option assembler Option Figure 10 3 Options Setting Dialog Box the source has been selected Assembler Sets option for the selected source file Assembler option setup Xx ASM assembler Option G 1 CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER Table 10 1 Option Setting Dialog Box Functions Assembler OK button If a source file is not selected option setting of all source files Source files for which individual options are not set is done then the dialog box closes If a source file is selected option setting is done for the selected source file then the dialog box closes If the return key is pressed when the focus is on the option input combo box it is regarded as if the OK button was pressed Source option delete button This becomes valid when a source file is selected If this button is selected the individual options set in source file units are cleared Overall options become valid for a source file with individual options cleared Cancel button This button cancels the settings in this dialog box and closes the dialog box If the ESC key is pressed it
223. output file name 1 O Description Format O File name Format when Omitted Input file name CNV is generated on the current path Function The O option specifies the library file name output by the library converter Use e Specify the O option when desiring to change the library file name output by the library converter from the default file name Explanation e f the O option is not specified a library file which has the same name as the input file name first specified but with the file type changed to is generated and output by the library converter This is the same in the case when the file name is omitted and the O option is specified A logical device name such as COM or AUX cannot be specified as a file name If such a name is used to describe the file name it will result in an error e The path name can be included in the file name and the path where the library file output by the library converter is to be generated can be specified In this case a with the name of the input file but with the file type changed to CNV is generated in the specified path Example Start the converter with the output file name TEST CNV specified A NECTOOLS SMP75X RA75X gt LBCNV75X 75XTEST LIB OTEST CNV The library file is output by the library converter 258 CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER In this chapter setting of options
224. parties by or arising from the use of NEC semiconductor products listed in this document or any other liability arising from the use of such products No license express implied or otherwise is granted under any patents copyrights or other intellectual property rights of NEC or others Descriptions of circuits software and other related information in this document are provided for illustrative purposes in semiconductor product operation and application examples The incorporation of these circuits software and information in the design of customer s equipment shall be done under the full responsibility of customer NEC assumes no responsibility for any losses incurred by customers or third parties arising from the use of these circuits software and information While NEC endeavours to enhance the quality reliability and safety of NEC semiconductor products customers agree and acknowledge that the possibility of defects thereof cannot be eliminated entirely To minimize risks of damage to property or injury including death to persons arising from defects in NEC semiconductor products customers must incorporate sufficient safety measures in their design such as redundancy fire containment and anti failure features NEC semiconductor products are classified into the following three quality grades Standard Special and Specific The Specific quality grade applies only to semiconductor products developed based on a customer designated quali
225. pecified it will result in an error When the start specification is omitted it is regarded as if O was specified In the size specify a number from 1H to OFFOOH in binary octal decimal or hexadecimal notation to be the size of the address area where you intend to carry out filling If a numerical value outside this range is specified if something other than a numerical value is specified or if the size was omitted when specifying the start it will result in an error If specification of both the start and the size is omitted it is regarded as if the internal ROM area has been specified The description format and address range are as follows e U Filler Value Internal ROM Area e U Filler Value size From address 0 to the address specified by the size e U Filler Value start size From the address specified by start to the address specified by the size The final address of the address range where you intend to carry out filling is a value from 1H to OFEFFH Specify a size value which does not exceed this range If this range is exceeded it will result in an error When the U option is specified more than once the last option specified becomes valid More than one address range cannot be specified Example Example The U option is specified A NECTOOLS SMP75X RA75X gt OC75X 75XTEST LNK U00 195 CHAPTER 6 OBJECT CONVERTER U fill up When U output is specified 10000000 050000000000000802299079922991139 100010
226. pecified the KM option is invalid and map lists are not output Examples Example 1 When the NKM option is specified A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK NKM 149 CHAPTER 5 LINKER KM NKM map no map The link list is as shown below 75X SERIES LINKER VX XX XX XX XX XX XX XX PAGE X COMMAND 75XTEST1 REL 75XTEST2 REL 075XTEST LNK NKM Linker Option List INPUT MODULE LIST 75XTEST1 REL AD_MAIN 75XTEST2 REL AD_SUB Input Output Module List LOAD MODULE LIST 75XTEST LNK AD MAIN PUBLIC SYMBOL LIST FOR 75XTEST LNK TYPE VALUE MODULE SYMBOL NAME Public Symbol List CODE 0022H SUB ADCONV Example 2 When the KM option is specified the same result is produced if the option is omitted A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK KM 150 CHAPTER 5 LINKER map no map The link list is as shown below 75X SERIES LINKER VX XX COMMAND INPUT MODULE LIST 75XTEST1 REL 75XTEST2 REL LOAD MODULE LIST 75XTEST LNK AD MAIN AD SUB AD MAIN SEGMENT LINK MAP FOR 75XTEST LNK AD MAIN MAP OF ROM AREA MAP OF RAM AREA XX XX XX XX XX XX PAGE X 7Z5XTEST1 REL 75XTEST2 REL 075XTEST LNX KM Linker Option List LENGTH MODULE NAME SEGMENT NAME TYPE 0002H AD MAIN 0006H 0002H AD MAIN 0012H AD SUB 0004H 0002H AD MAIN 0024H AD SUB 000AH AD MAIN 0039H AD
227. ple 1 When the RN option is specified the result is the same if the RN option is omitted Segments are located as follows SEGMENT LINK MAP FOR 75XTEST LNK AD_MAIN MAP OF ROM AREA LENGTH MODULE NAME SEGMENT NAME TYPE AD_MAIN ABSOLUTE AD_MAIN ABSOLUTE AD_SUB SENT AD_MAIN IENT AD_SUB SENT AD_MAIN SENT AD_MAIN INBLOCK 166 CHAPTER 5 LINKER SQ RN sequential random Example 2 When the SQ option is specified A NECTOOLS SMP75X gt LX75X 75XTEST1 REL 75XTEST2 REL 075XTEST LNK SQ Segments in 75XTEST1 ASM and 75XTEST2 ASM are located in the order of segment description and when there are links in the input module order SEGMENT LINK MAP FOR 75XTEST LNK AD MAIN MAP OF ROM AREA LENGTH MODULE NAME SEGMENT NAME TYPE AD MAIN ABSOLUTE AD MAIN ABSOLUTE AD MAIN AD MAIN AD MAIN AD SUB AD SUB 167 CHAPTER 5 LINKER SK stack 9 SK Description Format SK address Default Interpretation Value is assigned to reserved word STACK by linker Function e The SK option sets a value in the reserved word STACK The linker locates the stack segment in the low address direction starting at the address address specified by SK option 1 Use e The SK option is specified when it is wished to specify the stack segment location address it is only meaningful when the stack pointer value has been specified using the reserved word STACK in the source program
228. plit over a number of lines The 5 and symbols are treated as comment marks in the parameter file Characters from these characters to the end of the line are regarded as a comment 115 CHAPTER 4 ASSEMBLER F parameter file name Examples Consider a parameter file ASM PRA with the following contents 75XTEST1 ASM Input file name C106 Chip is UPD75106 KS Keep symbol list Example 1 The assembler is started with parameter file ASM PRA specified A NECTOOLS SMP75X RA75X gt RA75X FASM PRA Example 2 The contents specified by the parameter file ASM PRA are changed and added to in the command line A NECTOOLS SMP75X RA75X gt RA75X FASM PRA C000 PPRN CHAPTER 4 ASSEMBLER Y device file search path 19 Description Format Y Path Name Default Interpretation Executes a search in accordance with the specified search sequence 2 to 5 of the Explanation Function e The Y option specifies the device file search path Use Specify the Y option when searching from the specified path first Explanation A device file is searched for by the following sequence 1 Path specified by the Y option 2 DEV path with respect to the RA75X starting path 3 RA75X starting path 4 Current Path 5 Environment Variable PATH 117 MEMO 118 CHAPTER 5 LINKER The linker LK75X has as its input object module files output by the assembler and a
229. pseudo instructions Number of branch tables that can be created Approx 1 000 Maximum number of input files 122 CHAPTER 5 LINKER 5 2 1 Linkage of object modules in input files The linker has multiple object module files as input In addition one library file can be input together with the object module files there are unresolvable symbol reference relations by EXTRN and PUBLIC pseudo instructions between input object module files the linker checks the object modules in the library file specified as an input file Then if there are object modules in which unresolvable symbols are externally defined in the library file those modules are extracted from the library file automatically an linked together with the modules in the object module files specified for input Example The linker is started as shown below A gt LK75X B TEST1 REL B TEST2 REL B 75X LIB OB TEST LNK i Object module file Library file Load module file In this case the object modules are linked as shown below TEST1 REL TEST2 REL Module 1 Module 2 EXTRN 1 PUBLIC A2 EXTRN A2 75X LIB Module 3 PUBLIC B1 Module 4 PUBLIC 1 Module 5 PUBLIC B2 TEST LNK Module 1 EXTRN 1 EXTRN A2 Module 2 PUBLIC A2 Module 4 PUBLIC 1 CHAPTER 5 LINKER 5 2 2 Determination of segment location address The linker determines the location addresses of segments in the input object modules 1 Order of priority for determinin
230. put Format 75X SERIES ASSEMBLER Vx xx lt 1 gt PAGE lt 2 gt kk COMMAND cccc COMMAND FILE 4 STNO ADRS R OBJECT IC MAC SOURCE STATEMENT nnnn hhhh XXXXXXXX i 4mm 555 TARGET CHIP 14 STACK SIZE2xxxx lt 13 gt ASSEMBLY COMPLETE ERROR FOUND 284 CHAPTER 11 PROGRAM OUTPUT LISTS Descriptions of Output Items System date Output list page number in decimal notation 3 Title value specified by TITLE control instruction Blank if there is no TITLE control instruction specification Blank if there is no parameter file input specification lt 5 gt lt 7 gt Location counter value shown as 4 hexadecimal digits lt 8 gt Operand attributes Reference of external reference symbol symbol declared by the EXTRN pseudo instruction R Reference of relocatable symbols in the same module A Absolute value Object code in hexadecimal notation In case of a symbol definition pseudo instruction the operand evaluation value is shown as 4 hexadecimal digits Blank if not nested 11 gt 12 gt 13 gt Stack area size shown as 4 hexadecimal digits A cO lt 14 gt Assembly target product Items lt 7 gt and lt 9 gt are subject to amendment 285 MEMO 286 CHAPTER 12 EFFECTIVE USE OF THE ASSEMBLER PACKAGE This chapter suggests some methods of making efficient use of the assembler package 287 CHAPTER 12 EFFECTIVE USE OF THE ASSEM
231. r that line are also different and therefore this error is output In addition this error may be generated due to the influence of an error in another statement Program processing Processing is continued without further action User action When a BR pseudo instruction is located a block boundary replace that BR pseudo instruction with an ordinary branch instruction Check other error statement ZERO DIVIDE ERROR Division by 0 has occurred during evaluation of expression 101 Message Cause Program processing Mnemonic processing is continued with value of expression taken to be 0 Processing is continued with this pseudo instruction line is invalidated User action Write expression correctly SYMBOL QUANTITY IS OVERFLOW Cause Number of symbols exceeds processable number permissible number of symbols per source module is approx 3 000 102 Message Program processing Statements following location of this error are not processed User action Reduce number of symbols and re assemble or divide source program and perform split assembly SEGMENT QUANTITY IS OVERFLOW Number of segments exceeds processable number 103 Message Cause Program processing Statements following location of this error are not processed User action Reduce number of segments to re assemble or divide source program and perform split assembly CROSS REFERENCE TABLE OVERFLOW The table for creation of cross refer
232. ram processing Checks start line syntax then halts processing and returns control to OS A01 1 Cause Check correct file name then re execute Item other than path name is specified in option in which path name should be speci fied as parameter Program processing Checks start line syntax then halts processing and returns control to OS Check correct file name and option name then re execute 306 CHAPTER 13 ERROR MESSAGES Linker s Error Messages cont d Error No Missing parameter option A012 Necessary parameter has not been specified Checks start line syntax then halts processing and returns control to OS 004 Cause No correspondence between first and last single quotation mark used in option specification Program processing Program execution is halted Specify option correctly 307 CHAPTER 13 ERROR MESSAGES Linker s Error Messages cont d Error No ILLEGAL FILE file name F006 Input file contents are illegal Program processing Program execution is halted Specify correct input file BRANCH TABLE OVERFLOW F012 Number of branch tables exceeds processable number approx 1 000 can be created Program processing Program execution is halted User action Reduce number of BRCB instruction note that branch tables may also be created by branch instruction optimization Error No EXTERNAL SYMBOL OVERFLOW MODULE module name F013 Cause Too m
233. rarian Librarization enables a large number of object modules to be handled easily as a single file 3 List converter The list converter is used to create an assembly list which incorporates absolute values for debugging purposes 4 Library Converter Library files which can be input to the Linker and Librarian in Assembler Package Version 5 00 or later can be created from library files in the object program module format output by versions of Librarian before Version 5 00 CHAPTER 1 GENERAL DESCRIPTION 1 1 2 Function of a relocatable assembler The machine language resulting from the assembler conversion process is written into the memory of the microcomputer before being used To do this it is first necessary to determine where in memory the machine language is to be written Therefore the machine language produced by the assembler s conversion has attached to it information indicating in which address in memory it should be located Assemblers can be broadly classified into two kinds absolute assemblers and relocatable assemblers according to the method used to place machine language in memory address Absolute assembler An absolute assembler locates machine language converted in a single assembly operation in absolute addresses Relocatable assembler With a relocatable assembler the addresses converted by the assembly process are only determined temporarily Absolute address determination is performed by the program kno
234. rce file 30 CHAPTER 1 GENERAL DESCRIPTION 1 2 8 Assembler The assembler has a source module file as input and converts the assembly language into machine language coding errors are found in the source module file assembly errors are output If there are no assembly errors object module file is output containing machine language information and relocation information relating to the relocatable machine language addresses In addition assembly time information is output as an assembly list file Figure 1 11 Assembler Function Source module file Conversion of assembly language to machine language Assembler RA75X Output Creation of object module file Object module file Creation of list file Assembler list file 31 CHAPTER 1 GENERAL DESCRIPTION 1 2 4 Linker The linker has as input a number of object module files output by the assembler or a library file output by the librarian links them and outputs a single load module file It also outputs link time information as a link list file If a library file is specified one only should be specified at the end of the input file names Figure 1 12 Linker Function Object module files Library file Output Load module file Link list file 32 CHAPTER 1 GENERAL DESCRIPTION 1 2 5 Object converter The object converter has an input the lo
235. re is no more than 128 formal parameter substitutions WORKING TABLE SPACE EXHAUSTED Working area in memory is insufficient Error No A901 Message Cause Program processing Program execution is halted User action Reduce number of segments and PUBLIC amp EXTRN symbols or reduce number of unresolved branch instructions BRANCH TABLE OVERFLOW BR pseudo instruction optimization work area is full Error No A902 Message Cause Program processing Program execution is halted User action Reduce number of BR pseudo instructions OPEN ERROR Input output file cannot be opened Error No A903 Message Cause Program processing Program execution is halted User action Check status of specified disk CLOSE ERROR Input output file cannot be closed Error No A904 Message Cause Program processing Program execution is halted User action Check status of specified disk DUPLICATE INCLUDE OR MACRO FILE file_name Error No A905 Message Cause Include file name specified in source program or external macro file name is same as file name specified in start line Program processing Program execution is halted Check file name DISK FULL Capacity of disk specified for output is insufficient User action Error No A909 Message Cause Program processing Program execution is halted User action Delete unnecessary files or use a new disk PROGRAM ERROR Memory contents have been overw
236. reliable and generally applicable modules previously created can be used in the development of other programs Accumulating a number of such generally applicable modules means that the proportion of new work needed on program development can be reduced Figure 1 7 Program Creation Using Previously Written Modules Module A Module B Module C Module D New module Module A New module Module D New program 1 2 Outline of Assembler Package Functions The general program development procedure using this package is shown in Figure 1 8 Program Development Procedure Using Assembler Package The basic procedure used in program development is assembler linker object converter Use the Structured Assembler Librarian List Converter or Library Converter as necessary 27 CHAPTER 1 GENERAL DESCRIPTION Figure 1 8 Program Development Procedure Using Assembler Package source file Structured assembler ST75X Source module file Assembler RA75X Structured assembler Structured assembler source file Structured assembler ST75X Source module file 2 Assembler RA75X Assembly Object Assembly list file 2 module list file file 2 Q Librarian LB75X Library 2 Object converter OC75X List converter LCNV75X List converter LCNV75X Absolute Symbol HEX format Absolute a
237. return key is pressed when the focus is on the options input combo box it is regarded as if the OK button was pressed Cancel button This cancels the settings in this dialog box and closes it If the ESC key is pressed it is regarded as if the Cancel button was pressed Option character string display area Displays the character strings for the currently set options Option character strings 1 which cannot be fit on one line are also displayed Option character strings input in the options input combo box are displayed here in real time Option input combo box 2 Input option character strings here The number of characters Note can be up to 127 characters Device file specification is done in the project manager settings so it is not necessary here A history of past inputs drops down Up to 10 past inputs are stored If there is a character string in the history which is the same as the option character string the previously input history is cleared and the newly input character string is added Note Includes the name of the source file set automatically by the project manager the number of option characters Cautions 1 The Source Options Delete button is displayed in reverse video and cannot be selected 2 When setting options no check is made for errors in the option description Errors in the option description become errors during build 269 MEMO 270 CHAPTER 11 PROGRAM OUTPUT LI
238. ritten by another program Error No A999 Message Cause Program processing Program execution is halted User action Check the multi user method of use 96 CHAPTER 13 ERROR MESSAGES Format ERROR error number STNO error message These errors are printed in the assembly list Assembler s Error Message SYNTAX ERROR Error in statement format Program processing Mnemonic operand value is regarded as 0 and processing is continued With pseudo pen instruction line is regarded as invalid and processing continues Amend to correct description format Program processing Mnemonic operand value is regarded as 0 and processing is continued With pseudo instruction line is regarded as invalid and processing continues ILLEGAL PARAMETER TO CONTROL Error in specified parameter option description Program processing The option is ignored In case of INCLUDE option however fatal error results and program execution is aborted 3 Correct this parameter description 4 CONTROL COMMAND IS NOT RECOGNIZED Program processing The option is ignored Amend to correct option name 5 MISPLACED PRIMARY CONTROL Program processing This option is ignored Amend to correct description location NO TITLE FOR TITLE CONTROL 10 Program processing This option is ignored Specified option can only be written in start command line or at start of source program No parameter specificatio
239. rsion earlier than Version 5 00 Output File Library converter output library files Library files which can be input to the Linker LK75X and Librarian LB75X in Version 5 00 or subsequent versions of the RA75X Assembly Package Figure 9 1 Library Converter Input Output Files Object module format library files earlier than Version 5 00 Library converter LBCNV75X Library converter output library files 254 CHAPTER 9 LIBRARY CONVERTER 9 2 Library Converter Functions The library converter converts object program module format library files output by a version of Librarian LB75X in an Assembler Package which is earlier than Version 5 00 to library files which can be input to the Linker and Librarian in Version 5 00 or subsequent versions e f an error is discovered while the library converter is running an error message is displayed on the console The library converter carries out processing in accordance with the library converter options which are specified at startup time See 9 4 Library Converter Options concerning the options in library converter When processing is completed normally the library converter outputs an end message and control returns to the OS Caution The object modules included in library files converted by the library converter cannot be debugged 9 3 Starting the Library Converter 9 3 1 Starting the library converter In order to start the library converter input a command on
240. s 69 CHAPTER 4 ASSEMBLER 4 1 Assembler Input Output Files Assembler RA75X input output files are shown in Table 4 1 Table 4 1 Assembler Input Output Files Type of File Default File Type Input file Source module files Source module files written in 75X Series and 75XL Series assembly language Parameter files Note 1 When it is not wished to specify option one by one in the command line when the assembler is started the options to be specified etc are generated as a parameter file using the editor etc Device file sold separately File containing 75XL Series product SFR information etc Binary file containing machine language information machine language location address related information and symbol formation Assemble list file Note File containing assembly information such as assembly list symbol table list cross reference list etc Error list file File containing the assembly time error information Notes 1 For detail see 4 4 4 Description of assembler options 18 F Output file Object module file 2 The address of the Assemble List File created by the Assembler is a virtual address so if you are referring to the actual address refer to the Absolute Assemble List File address created by the list converter 70 CHAPTER 4 ASSEMBLER Figure 4 1 Assembler Input Output Files Source module file Assembler RA75X Device fileNete Parameter file Object Assembly Error li
241. s specified the linker creates a load module file in the current path using the first object module file name specified but with the file type changed to LNK This fives the same result as when the O option is specified with the file name omitted NUL or AUX can be specified for the file name as a logical device name If NUL is specified the same result is obtained as when the NO option is specified It is possible to specify the path in which the load module file is to be created by including the path name in the file name In this case a file which has the name of the first object module file specified but with the file type changed to is created in the specified path e f O and NO are specified at the same time the latter specification is valid 174 CHAPTER 5 LINKER output file Examples Example 1 When the linker is started with 75XTEST LNK specified as the output file name A NECTOOLS SMP75X RA75X gt LK75X O75XTEST LNK 75XTEST1 REL 75XTEST2 HEL The link list file 75XTEST1 MAP and load module file 75XTEXT LNK are output Example 2 When the linker is started with the NO option specified A NECTOOLS SMP75X RA75X gt LK75X NO P75XTEST MAP 75XTEST1 REL 75XTEST2 REL In this case the link list file 75XTEXT MAP only is output 175 CHAPTER 5 LINKER J NJ JUNK NO JUNK 13 J NJ Description Format J NJ Default Interpretation NJ Fun
242. s that an object module file is not to be created if there is an assembly error Use When generating an object file even when there is an error in the source file specify the J option Explanation When the NO option is specified the J option is invalid Examples f 75XTEST1 ASM is assembled with the J option specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM J The object module file 75XTEST1 REL is output even when there is an assembly error 90 CHAPTER 4 ASSEMBLER G NG debug no debug 5 G NG Description Format G NG Default Interpretation G Function The G option specifies that symbol information is to be output to the object module file output by the assembler e The NG option specifies that symbol information is not to be output to the object module file Use When the NG option is specified the necessary symbol information is not output at the link list file output by the linker or the symbol table file which is input to the debugger IE 75000 R Mete 1 E 75001 R 75 Note2 Therefore when symbolic debugging is to be performed all modules to be linked should be assembled with the G option specified If symbol information is not required and it is wished to shorten the assembly time if only by a little the NG option should be specified Notes 1 Maintenance product not available for purchase 2 Discontinued not available for pur
243. segments in the description order in the source module and in the order specified in the input module specify the SQ option Description The SQ and RN options are used to indicate to the linker the method to be used for determining the location addresses of relocatable segments See 5 2 2 2 Determination of segment location addresses for details of the segment location method when each option is specified Caution However if there are a large number of segments and object code is generated to the point of filling the ROM capacity of the product on which assembly is being performed the processing time will be extremely long Since there is danger that the user will mistake it for running out of control if a correct location method is not discovered after a fixed number of relocation attempts 3000 times an error message is output and the operation is aborted There are three possible countermeasures in this case as follows 1 Link the object modules which could not be linked after specifying the SQ option anerror will of course be generated as a result decide the location method manually based on the size of the segments in the output map list then perform linkage again with the location order specified by the CD option 2 Reduce the number of segments 3 Amend the program so that INBLOCK INBLOCKA segments fit exactly within block boundaries 165 CHAPTER 5 LINKER SQ RN sequential random Examples Exam
244. specified by the CD option segment address specification can be performed at the same time Example CD C1 C4 C3 300H C6 C6 When this specification is made the order specification mode is interpreted individually before the segment for which address specification has been performed That is it is equivalent to the following specification CD C1 C4 CD C3 300H C6 C5 However if there are a large number of segments and object code is generated to the point of filling the ROM capacity of the product on which assembly is being performed the processing time will be extremely long If the correct location method is not found after trying relocation a certain number of times an error message is output and the operation is aborted The following 3 processing methods can be used at this time 1 Link the object modules which could not be linked after specifying the SQ option an error will of course be generated as a result decide the location method manually based on the size of the segments in the output map list then perform linkage again with the location order specified by the CD option 2 Reduce the number of segments 3 Amend program so that INBLOCK INBLOCKA segments fit exactly within block boundaries Stack segment location address determination A stack segment is a segment which is reserved as a stack area by the STKLN pseudo instruction in a source module 1 Stack segment linkage If ther
245. ssembly table object assembly list file file module file list file 28 CHAPTER 1 GENERAL DESCRIPTION 1 2 1 Source module file creation using editor A single program is functionally divided into a number of modules A module is the unit of coding and the unit of input to the assembler A module which is an assembler input unit is called a source module After coding of each source module is completed the source module is input using the editor and written to a file The file created in this way is called the source module file The source module file is the input file for the assembler 75 Figure 1 9 Source Module File Creation Program Source module Source module END Source module a Write to file editor Source module file 29 CHAPTER 1 GENERAL DESCRIPTION 1 2 2 Structured assembler preprocessor The structured assembler preprocessor is a program for implementing structured programming in assembly language A source program written in assembly language is input and an assembler source program is output Please refer to the separate volume RA75X Assembler Package Structured Assembler Preprocessor User s Manual Document No U12598E for details of the structured assembler preprocessor and structured assembly language Figure 1 10 Structured Assembler Preprocessor Functions Structured assembler source file Structured assembler preprocessor 5 75 Assembler sou
246. st file module file list file Assembly list Cross Reference list Symbol table list Note A 75XL Series device file sold separately is needed for 75XL Series development 71 CHAPTER 4 ASSEMBLER 4 2 Assembler Functions e The assembler reads source module files and converts the assembler language into machine language If a coding error is found in the source module an error message is output in the assembly list and error list The assembler performs assembly processing in accordance with the assembler options specified when the assembler is started or in the source module header See 4 4 Assembler Options for assembler options When this processing terminates normally the assembler output a termination message and returns control to the OS Maximum assembler capabilities are shown below Item Maximum Value Number of characters that can be written in one source line 220 characters including Cr and Lr Characters used in symbol The first 31 characters 8 characters when the NS option is specified are valid Number of symbols handled by assembler Approx 3000 Number of segments that can be handled by assembler Approx 120 Total of 1 Number of segment definition pseudo instructions 2 Number of ORG pseudo instructions 3 2 x number of VENT pseudo instructions 72 CHAPTER 4 ASSEMBLER 4 3 Assembler Start Method 4 3 1 Starting the assembler The assembler is started by inputting
247. starting with segments with the highest priority shown above this priority order does not show the order of location addresses The location adjustment shown in Table 5 2 Segment Relocation Attributes and Location Adjustment is performed for segments with the relocation attributes shown above when location address determination is performed CHAPTER 5 LINKER Table 5 2 Segment Relocation Attributes and Location Adjustment Also located so that the segment starts at an even address PAGE segment Located so that the start of the segment is at the start of a page INBLOCK segment Located so that the entire segment is within the range OH to 3FFFH and in the same block INBLOCKA segment Located so that the entire segment is in the same block as with INBLOCK However location is possible within the entire ROM area XBLOCK segment Located so that the entire segment is within the range to 3FFFH Segment boundary adjustment is not performed as in the case of INBLOCK XBLOCKA segment Located in the same way as for XBLOCK with location possible within the entire ROM area AT absolute expression The segment is located in the addresses specified by the absolute expression 2 This segment is only valid for program memory This segment is also called an absolute segment Segment location prohibited areas can be specified by means of the RS option Segment location address determination method Abso
248. t Dialog Box __ Edit Options If a source file is selected and the Options button pressed the assembler options setting dialog box opens see Figure 10 2 If options are input in the options input combo box 2 and the OK button pressed the source file options setting dialog box opens see Figure 10 5 Figure 10 5 Source File Options Setting Dialog Box Assembler option setup XXX ASM set options To TARR ASM set as option 264 CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER Table 10 2 Source File Options Setting Dialog Box Functions OK button Sets options for the selected source file and closes the dialog box Set overall options button Sets options for all source files Source files for which individual options are not set Cancel button This cancels the settings in this dialog box and closes it 10 1 2 Linker 1 Options Menu Items Options menu items set from the project manager are as follows Figure 10 6 Options Setting Menu Linker Project Manager TEST PRJ Help Jese Project Manager Options structured assembler options Assembler options Linker options Object converter options Debug 4 Status Bar Tool Box Source List 265 CHAPTER 10 SETTING OPTIONS FROM THE PROJECT MANAGER 2 Options Setting Dialog Box Following is an explanation of the set linker options dialog box From the menu
249. t RA75X 75 5 1 5 C106 E75XTEST ERA gt there was an error the Error List File 75XTEXT ERA is output 97 CHAPTER 4 ASSEMBLER KS NKS symbols no symbols 9 KS NKS Description Format KS NKS Default Interpretation NKS Function The KS option specifies that a symbol table list is to be output to the assembly list file The NKS option specifies that a symbol table list is not to be output Use The KS option is specified when it is wished to list the symbol name symbol attribute value etc of all symbols defined in the source module Description e When the KS option is specified a symbol table list is output after the assembly list in the assembly list file e f the NP option is specified the KS option is invalid and a symbol table list is not output Example f 75XTEST1 ASM is assembled with the KS option specified A NECTOOLS SMP75X RA75X gt RA75X 75XTEST1 ASM C106 KS 98 66 75X SERIES ASSEMBLER VX XX CONVERTER VX XX SYMBOL TABLE LIST OFFSET SYMBOL OFFSET TYPE AD_MAIN 1 5 OFBOH O RBE CODE PUB SEGS3 SIACK EXT STACK TARGET CHIP UPD75106 STACK SIZE 000AH ASSEMBLY COMPLETE NO ERROR FOUND SYMBOL ADCONV LOOP2 MAIN SEGO SEL15 TDATA OFFSET TYPE 0000H 0029H OFBOH 1 0002H OFAOH CODE CODE PBIT SYMBOL HEIKIN CODE PUB SEG1 CODE EXT SIOSUB DATA TM
250. t bat under DOS Assembler Package 48 Cautions 1 2 3 Close all currently running applications before installation Windows 3 1 may become unstable if installation is cancelled so restart the host machine The information file used by each tool necdev ini is changed only when setupj exe or setupe exe is executed and the software is installed Accordingly if you use Project Manager install it using setupj exe setupe exe If your OS is the Japanese Windows 3 1 execute setupj exe if English Windows 3 1 execute setupe exe and if DOS execute dosinst bat to install the Assembler Package and the Project Manager CHAPTER 3 ASSEMBLER PACKAGE EXECUTION 1 In installing by running setupj exe or setupe exe under Windows 3 1 The following installation example is for the case that the host machine is a PC 9800 series model the Assembler Package and Project Manager are being read from Drive C the execution format is being installed in A nectools bin and the sample program is being installed in A nectools smp75x It is assumed that Windows has already been started Execution Example lt 1 gt Running the Installer a Insert the RA75X SETUP DISK 1 in the floppy disk drive 6 Select Run from the File menu c Input the following in the command line input box Command Line AASETUPE EXE Cancel 1 Run Minimized Browse Help Input set
251. t segment name 310 CHAPTER 13 ERROR MESSAGES Linker s Error Messages cont d Error No F406 Message SPECIFIED SEGMENT NOT FOUND IN SPECIFIED CLASS CLASS segment type SEGMENT segment name Segment name specified by order or address option does not exist in specified code segment Cause Program processing Program execution is halted User action Specify correct segment name SPECIFIED SEGMENT IS ABSOLUTE SEGMENT segment name Allocation address has been specified in absolute segment by address option Error No F407 Message Cause Program processing Address option is ignored User action Re link without specifying allocation address in absolute segment Message ADDRESS FOR SEGMENT SPECIFIED MORE THAN ONCE SEGMENT segment name Cause Error No F408 Multiple address specifications have been made for same segment Program processing Program execution is halted User action Eliminate duplicate specifications STACK OVER THE DATA MEMORY Cause Stack size specified by STKLN pseudo instruction and SZ option exceeds range specifiable for stack Error No W409 Message Program processing Processing is continued with 0 as stack size User action Ensure that total stack size specified by STKLN pseudo instruction and SZ option does not exceed range specifiable for stack ALIGNMENT NOT COMPATIBLE WITH ASSIGNED ADDRESS SEGMENT segment name Relocation attribute of address specified se
252. tant symbol as operand symbol attribute User action 38 Message Cause Program processing User action Ensure that operand symbol attribute is data or constant symbol OPERAND MUST BE DATA BIT SEGMENT ADDRESS Items other than bit or constant symbol is used as operand symbol attribute Processing is continued with constant symbol as operand symbol attribute Ensure that operand symbol attribute is bit or constant symbol 29 CHAPTER 13 ERROR MESSAGES Assembler s Error Message cont d Message BALANCE ERROR not balanced in expression Processing is continued with supplementary Amend so that balance is obtained Different relocation attributes are used for same segment name Program processing Processing is continued with relocation attribute specified first as valid User action Make all relocation attributes the same or do not specify 2nd and subsequent reloca tion attributes 49 TEXT EXISTS BEHIND END STATEMENT IGNORE Source exists after END statement Program processing Source after END statement is ignored No action required object code in which this error occurs is not affected 50 FORWARD REFERENCE IS NOT ALLOWED Symbol forward reference is not allowed in this operand expression Program processing Processing is continued with O as value of forward reference symbol Amend source program description to avoid forward reference 51 PUBLIC SYMBOL IS OF ILLE
253. tation Parameter file not used Function The F option specifies that the list convert option and input file name are to be read from the file specified by the option parameter This file is called the parameter file Use Writing options and input file names to be specified for the list convert in a parameter file in advance also reduces the amount of typing required Options and input file names can still be specified in the command line even if a parameter file is used Therefore it is possible to write only frequently used options in the parameter file Description The parameter file is a text file and can be created with an editor etc There are no particular restriction on the length of the parameter file The parameter file name cannot be omitted However if the file type is omitted PLV is taken as being specified A logical device name CON AUX etc cannot be specified as the parameter file name Use of such names will result in an error The contents of the parameter file are expanded at the position at which the F option is written in the assembler start line It is therefore possible to change the parameter file contents or add other option specifications with options written after the F option Parameter files cannot be nested If an F option is written in the parameter file an error will result It is not possible to use more than one parameter at one time If multiple F options are specified
254. the OS command line with the following format X LBCNV75X Option Input file Option e X indicates the current drive The input file name is the name of the library file which you want to convert The drive name and directory name etc can be included with the input file name Please input 1 or more spaces between each option or input file space or TAB to demarcate between them The default output destination is the originally specified file name with the file type changed to created on the current path This can be changed using the O option 9 3 2 Execution start and end message 1 Execution Start Message The execution start message is displayed on the console when the library converter starts 75X Series Library Converter Vx xx XX xxx XX Copyright C NEC Corporation 1996 255 CHAPTER 9 LIBRARY CONVERTER 2 Execution End Message Ifthe library converter has not detected any fatal error it outputs the following message to the console then control is returned to the OS Library Conversion Complete 0 error s found f the library converter outputs an error message and aborts processing the cause of the error message should be found in 13 6 Library Converter Error Messages and appropriate action taken 9 3 3 Library converter error processing The library converter outputs an Abort Error and aborts processing immediately if an error occurs which makes it impossible to contin
255. the contents of drive B The object converter has output 75XTEST HEX HEX format object module file and 75XTEST SYM symbol table file 65 CHAPTER ASSEMBLER PACKAGE EXECUTION 3 2 2 Librarian 1 Execute the librarian e Execute the librarian A gt NECTOOLS SMP75X RA75X gt LB75X The following message is output to the console and the librarian prompt is displayed 75X Series Librarian VX XX XX Xxx XX Copyright NEC Corporation 1984 Input the librarian subcommand as shown below the EXIT command returns control to the OS CREATE 75XTEST LIB ADD 75XTEST1 REL 75XTEST2 REL TO 75XTEST LIB LIST 75XTEST LIB TO 75XTEST LST PUBLICS EXIT B 2 Check the contents of drive B The librarian has output 75XTEST LIB library file and 75XTEST LST list file 3 The library file created in this way can be input to the linker as follows A NECTOOLS SMP75X RA75X gt LK75X 75XTEST1 REL 75XTEST LIB 075XTEST LNK 66 CHAPTER 3 ASSEMBLER PACKAGE EXECUTION 3 2 3 List converter 1 Execute the list converter The following is input in the command line A NECTOOLS SMP75X RA75X gt LONV75X L75XTEST LNK 75XTEST1 The following message is output at the console List Conversion Program for RA75X VX XX XX Xxx XX Copyright C NEC Corporation 1986 1997 Pass 1 start Pass 2 start Conversion complete 2 Check the contents of drive B The list converter
256. the following command in the format shown in the OS command line X gt RA75X _option __input file name __option X indicates the current drive Input file is the name of the source module file to be assembled Only one input file name can be specified Therefore it is not possible to assemble multiple source module files in one run of the assembler The drive name directory name etc can be added to the input file name Example RA75X C106 B 75XTEST1 ASM RA75X 106 USER NEC 75XTEST1 ASM option is a string of 1 to characters beginning with the symbol and may be followed by parameters Options can be written before and after the input file and if there are multiple options they can be written in any order However if multiple identical options or options of the same kind are written in some cases an error is generated and in some cases the last output specified is valid for details See 4 4 Assembler Options for details One or more blanks spaces or TAB should be used to separate options and the input file name The input file name and options can be written in the parameter file For the use of the parameter file see the item on the F option in 4 4 4 Description of assembler options As a default operation a file with the same name as the input file but with the file type changed to is created in the current directory This be changed by means of t
257. the relocatable segments segment SA is located starting at the lowest address of the free area The next largest segment SB is located segment SB is 140H in size it cannot be located in the first free area with a size of 100H from address 200H to address 2FFH Segment SB is therefore located starting at address 3BOH of the next free area Next segment SC is located As segment SC is 100H in size it is located in the first free area addresses 200H to 2FFH Next segment SD is located As segment SB is 150H in size it cannot be located in the first free area 4FOH to 4FFH Segment SD is therefore located starting at address 550H of the next free area Next segment SE is located As segment SE is 20H in size it cannot be located in the first free area 4FOH to 4FFH and is therefore located starting at address 5AOH of the next free area Finally the shaded areas shown in the above diagram are left as free areas 129 130 CHAPTER 5 LINKER lt 3 gt Order specification mode Location is performed in the segment order specified by the CD option Example The following CD option is specified when linkage is started 51 CS3 CS2 Of the segments input at this time CS1 CS2 and CS3 are located in the specified order starting at the free area in memory however they are not necessarily located in consecutive areas Program memory 3 CHAPTER 5 LINKER Caution As the order specification mode is
258. tipulated by relocation attribute has been exceeded Error No F418 Message Cause Program processing Performs location ignoring maximum segment size stipulated by relocation attribute User action Divide segment so that it is within maximum segment size range stipulated by reloca tion attribute 31 CHAPTER 13 ERROR MESSAGES Linker s Error Messages cont d Error No Message CAN NOT ALLOCATE IN FIXED AREA ALIGN relocation attribute SEGMENT F419 segment name Cause This segment cannot be located in location area in ROM corresponding to specified attribute IENT 20H to 7FH SENT OH to 7FFH INBLOCK and INBLOCKA area not running over 4K byte block XBLOCK 0 to User action Perform absolute specification or correct address option so that segment can be a Waga Program processing Processing is continued without further action however linkage results are not assured User action Specify overlapping segments with address specification or absolute specification so ERN TUS VERREM Error No SEGMENT IN RESERVED SPACE SEGMENT segment name F423 An attempt has been made to locate segment in area in which location of segment for which absolute specification oraddress specification has been made is prohibited Program processing Segment is located in location prohibited area User action Ensure that area specified by RS option action and area for which absolute specifica t
259. tput by the linker and outputs an absolute assembly list in which actual values are incorporated in the relocatable addresses and object code in the assembly list file Debugging efficiency be improved by performing program debugging using an IE 75000 R Mete 1 E 75001 or EVAKIT 75X Note 2 while referring to the absolute assembly list Notes 1 Maintenance product not available for purchase 2 Discontinued not available for purchase 235 CHAPTER 8 LIST CONVERTER 8 1 List Converter Input Output Files List converter LCNV75X input output files are shown in Table 8 1 Table 8 1 List Converter Input Output Files Type of File Default File Type Input file Assembly list file ete 1 Assembly list file output by the assembler Object module file Netes 1 2 Object module file output by the assembler Load module file Nete 2 Load module file output by linker The list converter calculates the actual values from this file Parameter file File for creating execution program parameters User created file Output file Absolute assembly list file List file in which with the relocatable values in the assembly list output by the assembler are replaced with actual values determined by the linker Error list file This is file which contains error information when running the list converter Notes 1 The input assembly list file and object module file must have been output as the result of assembly
260. tting Dialog Box If the source file has not been selected Assembler Options Setting Dialog Box If the source file has been selected Assembler Source List Dialog source File Options Setting Dialog 2 Options Setting Menu Options Setting Dialog Box Options Setting Menu Object Converter Options Setting Dialog Box Object Converter 62 68 71 121 182 202 236 237 254 261 262 262 264 264 265 266 268 268 17 x x LIST OF TABLES Table No Title Page 2 1 Provided FIS 12 OO 41 2 1 Provided Files 2 2 43 2 2 Host Machine Models PC 9800 Series 1722 44 2 2 Host Machine Models PC 9800 Series 22 45 3 1 uuu uu E E T T Tm 48 4 1 Assembler Input Output 70 4 2 Assembler Options 1 2 78 4 2 Assembler Options 2 2 Me 79 4 3 Assembler Options Priority 81 4 4 Assemble Object Device List
261. ty assurance program for a specific application The recommended applications of a semiconductor product depend on its quality grade as indicated below Customers must check the quality grade of each semiconductor product before using it in a particular application Standard Computers office equipment communications equipment test and measurement equipment audio and visual equipment home electronic appliances machine tools personal electronic equipment and industrial robots Special Transportation equipment automobiles trains ships etc traffic control systems anti disaster systems anti crime systems safety equipment and medical equipment not specifically designed for life support Specific Aircraft aerospace equipment submersible repeaters nuclear reactor control systems life support systems and medical equipment for life support etc The quality grade of NEC semiconductor products is Standard unless otherwise expressly specified in NEC s data sheets or data books etc If customers wish to use NEC semiconductor products in applications not intended by NEC they must contact an NEC sales representative in advance to determine NEC s willingness to support a given application Note 1 NEC as used in this statement means NEC Corporation and also includes its majority owned subsidiaries 2 NEC semiconductor products means any semiconductor product developed or manufactured by or for NEC as defined above M
262. ue program execution Error messages are output with the following format Error No message 9 3 4 Library converter end status The library converter returns the following error status code to the OS when it ends execution and returns control to the OS End Conditions If the Library Converter is started from a batch file in MS DOS PC DOS IBM DOS it can be judged automatically using these values whether there were any link errors 256 CHAPTER 9 LIBRARY CONVERTER 9 4 Library Converter Options 9 4 1 Types of library converter option The following type of option is provided Table 9 2 Types of Library Converter Option Description Format Function Classification Interpretation when Omitted 1 O file name Specifies a library file output by the Library Generates Input file name cnv in the current Converter path 9 4 2 Specifying the library converter option The library converter option is specified on the command line when starting the library converter Please refer to 9 3 Starting the Library Converter concerning specification of the library converter option on the command line 9 4 3 Priority order of library converter options If the same option is specified more than once on the command line of the library converter the option specified last becomes valid 9 4 4 Library converter option explanation Details of the O option are explained below 257 CHAPTER 9 LIBRARY CONVERTER
263. unction The F option specifies that object converter options and input output file names are to be read from the file specified by the option parameter This file is called the parameter file Use Writing options and input output file names to be specified for the object converter in a parameter file in advance also reduces the amount of typing required Options and input file names can still be specified in the command line even if a parameter file is used It is thus possible to write only frequently used options in the parameter file Description The parameter file is a text file and can be created with an editor etc There are no particular restrictions on the length of the parameter file The parameter file name cannot be omitted However if the file type is omitted is taken being specified A logical device name CON AUX etc and a path name cannot be specified as the parameter file name Use of such names will result in an error The contents of the parameter file are expanded at the point at which the F option is written in the object converter start line It is therefore possible to change the parameter file contents or add other option specifications with options written after the F option Parameter files cannot be nested If an F option is written in the parameter file an error will result It is not possible to use more than one parameter at one time If multiple F options are spe
264. upj exe in the command line input box in Japanese Windows 3 1 and setupe exe in English Windows 3 1 d Select OK 49 CHAPTER 3 ASSEMBLER PACKAGE EXECUTION e After setup initialization the installer will start tools setup initializing setup RASA setup Setup te Welcome to Setup Program f To continue the installation select Continue To terminate installation select End 50 CHAPTER 3 ASSEMBLER PACKAGE EXECUTION lt 2 gt Select the item to be installed a Select the items to be installed by clicking the appropriate check boxes In the default installation the Assembler Package and Project Manager are selected for installation 6 After selecting the items to be installed select Continue If you are installing the Assembler it is necessary that Project Manager be installed already or that it be installed at the same time that the Assembler is installed ca Products to Install Select the products to install X Project Manager Vxxx X 75X Series Assembler Package c To end the installation select d Items which cannot be installed will be displayed in gray 51 CHAPTER 3 ASSEMBLER PACKAGE EXECUTION lt 3 gt Specify the installation directory a The dialog box for specifying the installation destination directories is then displayed After inputting the installation directories as shown below
265. upper or lower case characters 144 CHAPTER 5 LINKER Caution e Link list definition There are 6 kinds of link lists Link lists Linker option list Input output module list Segment link map list Branch table map list Public symbol list Symbol list 5 4 2 Linker option specification method Linker options are specified in the command line when the linker is started or in a parameter file See 5 3 Linker Start Method for the method of specifying linker options in the command line and in a parameter file 5 4 3 Linker option priority order 1 If multiple identical options or options of the same kind are specified in the command line the option specified last is valid 2 If the same or same kind of option is specified in the parameter file and in the command line the command line option is valid 3 With the CD and RS options all the specified options are valid However an error will be generated if multiple different specifications are made for the same segment with the CD option 5 4 4 Description of linker options Each of the linker options is described in detail in the following pages 145 CHAPTER 5 LINKER name 1 Description Format M load module name Default Interpretation M first input file object module name Function The M option specifies the output load module name Use The M option specifies the output load module name Description The load modu
266. urce program file Object module file Load module file HEX format object file Assemble list file Link map file Symbol table file Error list file Library file Library Converter Output Library File Library list file Absolute assembly list file Assembler parameters file Linker parameter file 4 When a file without a file type is specified file name Example B RA75X ABC In this time the file name is interpreted ABC ASM B gt RA75X In this time the file name is interpreted ABC 5 Not only an absolute path ete 1 put also a relative path 9 2 can be used in the directory name Notes 1 Using the root directory V as the starting point Example YBIN 75X etc Using the current directory or parent directory 7 as the starting point Example SRC HDR DOC 75X etc 6 Directories are not supported for libraries 11 2 Device type specification The following can be specified as logical devices CON Console output CRT input Keyboard PRN Line printer output only AUX RS 232 C NUL Null device However in some cases these cannot be specified or a meaningless result is obtained if specified This is explained in the text Remark A CLOCK device cannot be specified Related documents Documentation related to this manual is shown below RA75X Assembler Package User s Manual Version 4 5X Language Volume U12385E
267. ution speed BUFFERS n is the number of system input output buffers to L be used by the entire system To a certain degree the greater this value the faster is the disk input output speed However this value is directly related to memory consumption If there is adequate installed memory capacity it is as well to specify a larger value If 512 to 640 KB of memory is installed a value of around 20 should be specified Setting environment variable The following environment variable is supported by the assembler package INC75X Specifies the include file search path This environment variable is used when using an include file which defines constant values etc specific to the product subject to assembly See the section on the assembler I option for details CHAPTER ASSEMBLER PACKAGE EXECUTION Caution The assembler package assembler and linker are divided into an executable command file and overlay files When these program files are in the current path current directory of current drive the program files can be loaded simply by specified RA75X in the command line However in some cases source module files and the associated object files etc are located in the current path and other executable file etc are located in a different path The method for accomplishing this is as follows Example If the assembler program files RA75X EXE and RA75X 0M1 RA75X 0M2 RA75X OM3 amp RA75X 0M4
268. width 132 ii MM el 75X SERIES ASSEMBLER VX XX A D CONVERTER VX XX XX XX XX PAGE X COMMAND 75XTEST1 ASM C106 STNO ADRS R OBJECT CON O OQ N cO 0000 R C000 0008 E 8000 N 0110 c O 0000 991F O O o 0000 9921 N N nm N 0002 R 00 0003 E 8900 0005 9280 N MO NM IN IN O ON O 0007 73 0008 93B3 OO Ne o 000A 991 1 000C 8B3F OOOE 8900 0010 E8 N O1 108 IC MAC SOURCE STATEMENT TITLEZ A D CONVERTER VX XX k lt lt lt lt lt lt lt lt lt lt KEK e ck e e e lt K K K K K lt K K K lt lt lt K K lt kx 3 CONVERT PROGRAM ih NAME AD MAIN EXTRN CODE ADCONV CODE SIOSUB PUBLIC TDATA SEL15 STKLN 10 VENTO MBE 1 RBE 1 MAIN VENT4 MBE 1 RBE 0 ADCONV SEGO DSEG 1AT TDATA DS 2 panes TABLE SEG1 CSEG IENT SEL15 SEL MB15 MAIN ROUTINE SEG2 CSEG INBLOCK MAIN SEL RB1 GETI SEL15 STACK POINTER SET MOV XA STACK MOV SP XA MOV A 0011B PCC A lt 0011B ud DATA RAM OH 13FH ZERO CLEAR SEL 1 MOV HL 3FH MOV XA 00H LOOP1 HL A 100H 13FH CHAPTER 4 ASSEMBLER LL LW page length page width 132 HL 1 MBO HL 1 HL BR LOOPZ TIMER SET SAMPLLING TIME 30MSEC FXX 4 19MHZ GETI SEL15 SEL 15
269. wn as the linker When a program is created with an absolute assembler programming must in principle be performed as a one time operation However writing a large program at one time as a single entity results in a complex program and makes program analysis difficult when maintenance is required In view of this program development is carried out by dividing the program into a number of subprograms modules each with a specific function This is known as modular programming A relocatable assembler is one which is suited to modular programming The advantages of modular programming using a relocatable assembler are described below 25 CHAPTER 1 GENERAL DESCRIPTION 1 Development is made more efficient Writing a large program as a single unit is difficult Dividing a large program into modules allows a number of programs to be developed in parallel making the process more efficient Also when a bug is found it is not necessary to reassemble the whole program just to amend one party only the module requiring correction needs to be reassembled This enables the time required for debugging to be reduced Figure 1 6 Reassembly Process When program consists When program consists of single modules of several modules Module Module Module Whole program must be pe Only this modified UE Module needs to be modified Module x 26 CHAPTER 1 GENERAL DESCRIPTION 2 Resources can be fully used Highly

RA75X ASSEMBLER PACKAGE PC-9800 Series (MS

Contents

Download Pdf Manuals

Related Search

Related Contents