Programming with Assembler, Required knowledge | Panasonic MN1030

Chapter 2 Program Development Flow

2.3Programming with Assembler

Before creating programs using the assembler, you must understand the following items.

Required knowledge

•Machine-language instructions

•Device operation

•Editor use

•C compiler use

•Assembler and linker use (in this manual)

•Debugger use

Program development is an iterative process of editing, assembling, linking, and debugging many times until finished. Therefore, you should as much as possible automate assembler and linker commands, debugger calls, and error correction.

MAKE

When a program is divided into multiple files for joint development efforts by several programmers, a control system must be created for assembly and linking without error.

If this is not done, an old undebugged program could be linked within the iterative development process.

The solution lies with the following program which runs on the workstation or personal computer.

•MAKE

With MAKE the programmer defines the dependency relationships of the files needed to generate the final executable file and list files. Afterwards MAKE will automatically assemble and link only those files that have been modified.

Program format

The Cross-Assembler utilizes a program format called section address format.

Section address format specifies the start addresses of programs for each section linked. Even when the program is divided between multiple files, or when a file is divided into multiple sections, identical sections are linked together with the same attributes. Therefore, the programmer must create programs such that addresses do not overlap.

[Reference: Chapter 6, "Using Linker", for details]

Programming with Assembler 17

Image 29

Panasonic MN1030 Programming with Assembler, Required knowledge, Program format, Reference , Using Linker, for details

Contents

MN1030 Series Cross Assembler User’s Manual Page Page Reference Techniques Manual Features Heading How to readProgram example Usage note Related Manuals Chapter Writing Macro Control Statements Purpose of This Chapter Purpose of This Chapter Rules of Usage Usage Example Chapter Types of Source Statements Writing Assembler Control Statements Readinig List Files Error Correction Using Tag Jumps 306 Chapter Purpose of This Chapter Host machine Operating system Version of OS Operating EnvironmentSolaris Or later 98/Me/2000/XP As103 assembler File OrganizationLd103 linker Slib103 library manager Installation Start-up files SetupSetting command path Keywordparameter Start-up file format Message Keyword DescriptionNotation Option Ed-OPTION En-OPTIONStdlib Libdir File Conversion Utility General command formatOptions Excv103 options EX format file name Rules of output file name Default specification Example of specifying options Program Development Flow Program Development Flow Assembler and compiler Program Development FlowMain development flow Source code debugger Programming with Assembler Reference , Using Linker, for detailsRequired knowledge Program format Optimization Programming style Debugging Conditional assemblyMacros Program Development Flow Programming with Assembler Introduction to Operation Introduction to Operation Files Used Files Used by Assembler and Linker Introduction to Operation Create source files Basic Operation of Assembler and Linker Assemble Contents of program2.asm are as follows Generate final list files Link Contents of the final list file program1.lst are as follows Contents of the final list file program2.lst are as follows Assembling and Linking Multiple Sections Assemble and generate list files Contents of program4.asm are as follows DATA, PUBLIC,4 Contents of the list file program4.lst are as follows Parameter file during linking Following command was input to link CAE0 Data Contents of the final list file program4.lst are as follows Program Location Program locations after linking #ifdef Conditional Assembly and LinkingCreate source file Assemble and link the program that you have created Assemble and link Select false condition, assemble, and link Specify assembly conditions in the command As103 -D Debug program5.asm Introduction to Operation Conditional Assembly and Linking Chapter Optimization Has been optimized Rules of Usage Optimization is off by default Optimization Instructions Usage ExampleOptimized Conditional Branch Instructions Type Branch Range Instruction Type Branch Range Abs, Dn Abs, AnAn, abs Dn, abs Movhu abs, Dn Movhu Dn, abs Btst imm, Dn Logical Instructions Subject To OptimizationInstruction Optimization processing Assembler processing Optimization processing of conditional branch instructionsLinker processing BNE*+5 Optimization of function calls BRA label Optimization of branchesLabel JMP label Label JMP label Call label Calls label JSR label Optimization Optimization Opt Text CA7F Example subroutine call converted to a relative branch Using Assembler Using Asssembler Specifying options General format of commandsStarting Assembler Summary of options Command Options Functional description Output File OptionsRules of Use Operation Example No list file will be output Output a list fileAs103 -l sample.asm As103 -l -Li sampl.asm Do not output files included by include to the list fileAs103 -Li -l sample.asm As103 -l -Lm sampl.asm As103 -Lm -l sample.asm As103 -l -Lc sampl.asm As103 -Lc -l sample.asm Symbol table will be output Do not output a symbol table to the list fileAs103 -Ls -l sample.asm As103 -a sample.map -l sample.asm As103 -j sample.asm Error Message Options This option is not available on DOS/V or PC/AT machines As103 -Je sample.asm As103 -Js sample.asm As103 -Jj sample.asm As103 -e sample.asm Output error and warning messages in English As103 -W 2001 sample.asm Default is to display all warning messagesWall Do not output any warning messages As103 -Wall sample.asm As103 -I/user/defs main.asm Preprocessor OptionsPathname Specify the trace directory of the include file As103 -D Version sample.asm Output debug information to the relocatable object file Program Generation OptionsExecutable format file .EX As103 -g sample.asm As103 -O sample.asm Turn on optimizationTurn off optimization As103 -Od sample.asm As103 -h Other OptionsOn the screen Display the assemblers version number on the console Operation Examples Program assemblyAs103 -g -D Version -o test.rf /user/source/main.asm As103 -g -o test.rf -I /user/lib sample.asm As103 -l -a main.map sub.asm As103 -l -Lc -Lm -a main.map -D Mode prog1.asm Chapter Using Linker Link Model of Section Address Format Ld103 options relocatableobjectfilename Libraryfilename Starting LinkerJmg Main.ex -gm @CODE=80000000 or -T @CODE=80000000 Path specifications on the relocatable object filesM103.map, respectively Executable file Linker options Option Type Symbol Description Command Options Ld103 -o /usr/tmp/test.ex main.rf sub.rf Ld103 -m -TTEXT=80000000 -TCONST=80005000 prog1.rf prog2.rf Output a map fileLd103 -m main.rf sub.rf Ld103 -j sample.rf Ld103 -Je sample.rf Ld103 -Js sample.rf Ld103 -Jj sample.rf Ld103 -e sample.rf Ld103 -Wall main.rf sub.rf Function descriptionLd103 -W3001 progr1.rf prog2.rf Ld103 -g main.rf sub.rf Output debug information to the executable format file Section =addresses Specify starting address for a section Section layout rules Ld103 -T @CODE=80000000 -T@DATA=0 main.rf sub.rf Lowest section is referred to the section nameLd103 main.rf sub.rf Parameter file Letter Ld103 -r prog1.rf Output an executable format file even if errors are detected En option cannot be used in conjunction with the g option Ld103 -En main.rf sub.rfOutput the Data section to the executable file Ld103 -Ed main.rf sub.rf Libraryfilename Specify a library file Library File OptionsLd103 -l /usr/lib/sample.lib main.rf sub.rf Message will be appeared Library files specified by the l option will be read Pathname Specify a directory containing library files Ld103 @pfile Operational example@filename Specify a parameter file Ld103 Ld103 -h Instruction RAM Support Number field to Structure of Iram Support Executable FileStructural Elements of an Iram Support Executable Layout Image for Instruction RAM and External Memory These names for ordinary symbols Using Linker Same result Iram Support Options Starting address in instruction RAM is given in hexadecimal Address is in hexadecimal PUT symbol=address Specify address for extra symbolOverlaytable Irammanage Assignment to the same address in instruction RAM Operation ExamplesAssigning to different addresses in instruction RAM Overlaps with actual code Conflicts and suppresses executable file output Using Linker Instruction RAM Support Types of Source Statements Type of Source Statements Program Format Equ 0x32 #includeDataset Macro Movw Data, A0 0x12 D0, A0 Endm Directive statements Machine language instruction statements Mov 0x11, D0 Assembler Control Statements#else Mov 0x22, D0 Adrset Data1, reg1 Data2, reg2 Macro Control StatementsAdrset Macro data, reg Mov Reg, A0 Data, D0 D0, A0 Endm Program Start main Conditional assembly definitionComment Statements Blank Statements Type of Source Statements Blank Statements Writing Source Statements Writing Source Statements Digits Permitted Characters2 3 4 5 6 7 8 Letters Radices and allowed digits NumbersC D E F or Re hexadecimal digits that correspond to decimal Coding rules Extended C language formatIntel format ’101’ Matsushita format’567’ ’789’ Character constants Character Constants Specifies the string Abcdefg as Ascii code String constants+-&%$#@ Specifies the string +-&%$#@!,. as Ascii code Specified Example Address Constants Location Counter Assembler or linker ExpressionsSection CODE,PUBLIC,1 Sec Arithmetic operators OperatorsShift operators Operator Meaning Formats Example Operand1 Operand2 Logical operatorsLogical operators perform calculation in bit units Equ 0b01101110 Expression EvaluationPrecedence Operator Description Mov 10+5, d0 Expression SyntaxMov +10+5, d0 Mov 10+5+2, d0 Operation result attributes Expression AttributesFor ~, +, unary operators Attribute of Operand Attribute of Result For *, /, %, , , &, , operators For + addition operatorFor subtraction operator D0, d1, d2, d3, a0, a1,a2, a3, PSW, mdr, sp Reserved WordsDefine, if Ifb, ifdef, ifeq, ifge, ifgt, ifle Iflt, ifn, ifnb, ifndef, ifneq, include, undefPage Purpose of This Chapter Coding rules Instruction Statement Fields Label Longlabellonglabellonglabellonglab main Startcont Writing Label FieldCoding examples Start Mov Writing Operation FieldEqu One operand Writing Operand FieldOperands are register and expression Jsr Set count value Writing Comment FieldMov 0x10, D0 Writing Machine Language Instruction Statements List of directives Writing Directive StatementsDocument conventions Below is a list of directives Section Default settingsSyntax Section linking rules Directive coding rules Operand coding rulesUsage example Main Jsr Current location counter value will be inherited AlignLabel Operation Operand Align Expression 0x01 Below is an example use of the align directive00000000 Label 3 endName end Below is an example use of the end directive Label operation operand Name listoff Name liston Listoff, listonListoff and liston directives themselves are output These directives take no operands Label Operation Operand Notation NotationClang will be selected Operand Format Notation Below is an example use of the notation directive Secadr 6 orgSecfnc Org 0x20 Org 0x100 End Opt on Opt off 7 opt Below is an example use of the page directive Label Operation Operand Linesexpression ,columnsexpressionNumber of lines = Number of columns = Label Operation Operand Radix Expression RadixAnother radix Below is an example use of the radix directive 10 dc 11 ds When expression2 is omitted, expression3 cannot be specified PanaX Series MN1030 Cross Assembler Loc Object Line Source Below is an example use of the ds directiveDs0 1122 Section DATA, Public 12 dw3930 Dw0 dw 12345 34127856 Dw1 dw 0x1234 Label Operation Operand Name Expression, expression 13 dd78563412 Dd0 0x12345678 00000000 Dd0 Memory equ Motor equ Stop equ 0b00001000 Base equ 14 equLabel Operation Operand Name Equ Expression Equ 0b00001000 Equ 0x20Equ 0x1000 8020 Mov Label Operation Operand Name Global Name, name Global External declaration Below is an example use of the global directiveExternal reference Mov 0x11, D0 Rts End Label operation operand Titstring 16 titBelow is an example use of the tit directive Loc Object Line Source Tit Name Xlistoff Xliston Xlistoff, xlistonXlistoff and xliston directives themselves are not output These directives take no operand Usage Examples, Optimization of function calls Directive Specification RulesFuncinfo Call 0func Global 0func, func Global 0funcFunc Movm D2, SP Add 0func Funcinfo Func, 8, D2 Ret Stack Usage examples AssignAssign 0x01 00000000 8001 Mov Assign 0x02 00000002 8002 MovPage Writing Assembler Control Statements Common coding rules Symbols used in this chapter have the following meaningsContents of brackets may be omitted File Inclusion Path name is coded within filename 10.2.1 #include#include filename File to be assembled consists of the following statements Data equ#include Inc.h Main Mov Data, A0 0x34, D0 D0, A0 End Identifier Definement 10.3.1 #define #define Replacementstring comment#define Data Load Mov Data, D0 Main Mov Data, D0 Load End #undef identifier 10.3.2 #undefSource file that uses #undef is shown below #define Data1 0x11 Data2 0x22 #if Conditional AssemblyContents of brackets from #else on can be omitted These directives can be used only within macro definitions Table below lists the conditional assembly directives Syntax for #ifdef Syntax for #ifndef 10.4.1 #ifdef, #ifndef#ifdef Identifier #ifndef Block1 #else Block2 #endif #ifndef #else Mov 0x03, D1 0x04, D1 #endif #else Mov 0x01, D0 0x02, D0 #endif #ifndef8001 Mov 0x01, D0 #else 0x02, D0 #endif #ifndef 10X Mov 0x03, D1 #else Syntax for #if Syntax for #ifn 10.4.2 #if, #ifn#ifn #if #else Mov 0x03, D0 0x04, D0 #endif #else Mov 0x01, D0 0x02, D0 #endif #ifnMov 0x01, D0 #else 8002 Mov 0x02, D0 #endif #ifn #ifneq 10.4.3 #ifeq, #ifneq#ifeq Compare Abc, abc Abc, acb 8002 11+ Mov 0x02, D0 #endif M10 Compare Abc, abc 10+ #ifeq #ifle 10.4.4 #iflt, #ifle#iflt 12+ #iflt M12 Dsize12X Mov 0x01, D0 12+ #else 8002 12+ Mov 0x02, D0 #endif #ifgt 10.4.5 #ifgt, #ifge#ifge #else Mov 0x01, D0 0x02, D0 #endif #ifge 8002 Mov 0x02, D0 #endif #ifge #ifnb 10.4.6 #ifb, #ifnb#ifb Debugon 14+ #ifb Debugon 14X Jsr Check Proc #else 00000000 M14 Debug+14+ Jsr Proc 00000008 00F8FE04 #endif #undef M17 Debug Writing Macro Control Statements #include directive Macro definitions Macroname Macro Definitions macro, endmDummyparameter , dummyparameter Macrobody An example macro definition is shown below Up to10 dummy parameters can be specified Macro Calls and ExpansionMacroname Parameter , parameter Var1 Equ 0x10 Var2 Var1+2 Addadr Macro Adr Adr, A0 Endm Operator Description Macro Operators Text Section CODE,PUBLIC,1 Up to 30 symbols can be specified Local Symbol Declaration localMacroname macro parameter Local symbol , symbol Symbol An example using the local directive is shown below #endif Exitm Endm Forced Termination of Macro Expansion exitmParameter Test Purge macroname , macroname Purging Macro Definitions purge Reptexpression block Rept Assembled list file is shown below Irp 11.9 irpDummyparameter, parameter , parameter Block Irp Irpc IrpcDummyparameter, string Following example uses the irpc directive DATA, Public Writing Macro Control Statements Irpc List of Machine Language Instructions List of Machine Language Instructions Register indirect addressing Addressing Modes Register relative indirect addressing Absolute addressing Index addressing List of Machine Language Instructions Move source to destination 12.3.1 Data Move Instructions Mnemonic Description of operation Movhu Index Absolute Extend Sign Subtract with Borrow Arithmetic InstructionsADD with Carry Compare source with destination Source with destination Logical InstructionsOr source with destination EXCLUSIVE-OR source with destination ASR imm8, Dn Mnemonic Description of operation ASR Dm, DnASR Dn Mnemonic Description of operation LSR Dm, Dn Bit operations Bit Manipulation Instructions Bclr imm8,abs32 Call Subroutine Branching Instructions JMP label Unconditional BranchMnemonic Description of operation JMP An Mnemonic Meaning Description of operation Conditional Branch ZF=1 If ZF = 0, execute next instruction Conditional Branch for LoopZF=0 If ZF = 1, execute next instruction If ZF = 1 or NF != VF, execute next instruction User Defined Function User-Defined InstructionsUDFnn Dm, Dn UDFnn imm, Dn Do nothing Other Instructions Error Messages Error Messages Assembler Errors Define symbol multiple defined Operand errorDefine symbol not defined Illegal operand value Line of the source file exceed 65535 lines Not guaranteed operand by the instruction allocationSymbol name too long Error Messages Macro symbol is used recursively Debug operand errorIllegal section name Illegal operand expression Too many arguments Error in configure fileCan’t find Funcinfo directive No optimizing information Fatal Error Messages Linker Errors Filename Section not found. This file ignored Extra symbolname address aligned. addressFilename Illegal sectionname attribute or align value Address overlay with Iram manager Multiply defined symbol Bad option switch.stringUndefined symbol Filename Symbolname not defined with FUNCINFO. line lineno 3313 Extra symbolname used as normal symbol No memory space Filename Invalid symbol detail information type.typeFileneme Cannot open file Filename Cannot read file Internal Error.string Filename Referring to symbolname defined in a programID=idFilename Illegal relocation information.line lineno Filename Illegal optimize information.line lineno Error Messages Linker Errors Readinig List Files Reading List Files Reading List Files Location Loc Output Format of Machine Language CodeMachine language code Object Machine language code supplemental information Supplemental information Version Source statement Source Symbol Value Symbol TableSymbol Type Symbols value is shown as eight hexadecimal digits Symbol Name Using Library Manager Using Library Manager Starting Library Manager Slib103 test.lib -f -j test1.rf test2.rf test3.rf Slib103 test.lib -f -Je test1.rf test2.rf test3.rf Slib103 test.lib -f -Js test1.rf test2.rf test3.rf Slig103 test.lib -f -Jj test1.rf test2.rf test3.rf Rules os use Slib103 test.lib -f -e test1.rf test2.rf test3.rf Slib103 test.lib -Wall -c test1.rf test2.rf test3.rf Slib103 test.lib -W4001 -o test1.rf test2.rf test3.rf Slib103 test.lib -c test1.rf Create a new library fileSlib103 test.lib -c test1.rf test2.rf test3.rf test4.rf Name Slib103 test.lib -f test1.rf Force creation of a library fileSlib103 test.lib -f test1.rf test2.rf test3.rf test4.rf Files with the same name Slib103 test.lib -a test.1.rf Functional OptionsSlib103 test.lib -a test1.rf test2.rf test3.rf Path name will be added in the library file Slib103 test.lib -d test1.rf test2.rf test3.rf Slib103 test.lib -d test1.rf Slib103 test.lib -p test1.rf slib103 test.lib -p Slib103 test.lib -p File Slib103 test.lib -r test1.rfSlib103 Test.lib -r test1.rf test2.rf test3.rf Slib103 test.lib -t test1.rf slib103 test.lib -t Slib103 test.lib -t test1.rf Existing in the current directory Slib103 test.lib -x test1.rfSlib103 test.lib -x test1.rf slib103 test.lib Assume that the file pfile contains the following line There is no default specificationSlib103 @pfile Slib103 -h Default is not to display the version numberDisplay the library manager’s version number on the console Slib103 Cause Solutions Error MessagesErrornumber Displayedmessage 4003 Filename not found. In addition to library 4002 This file has no public symbol information.filename4001 Filename not found 4312 Symbol name length over. max 66. symbol 4310 This file has redefined public symbol. filename4301 Multiply specified object file name.filename 4302 Premature EOF. filename 4315 Not warning message number 4313 Parameter-file already specified. filename4314 Cannot read parameter-file. filename 4501 Illegal option. string 4504 Memory allocation error4502 Library file name not found 4503 Multiply specified library file name. filenamePage Purpose of This Chapter Personal Computer Versions PC/ATWindows98/2000/Me/XP DOS/VWindows98/2000/Me/XP Operating Environment AS103.EXE Assembler FilesLD103.EXE linker SLIB103.EXE library manager Installation SET PATH=A\usr\local\bin Environment Settings New setting will then automatically take effect Differences From Workstation Versions Command line differences Contents of the generated error file Error are as follows Error Correction Using Tag JumpsGenerate error file Contents of the file Error will be displayed on the screen Fix errorsFirst error message matches this display on the screen Tag jumps MAIN.ASM7 Error 2306 Multiple define symbol Return to error file Appendix Numeric Restrictions List of Command Options Output file options List of Assembler Command OptionsAssembler command general format Program generation options Error message optionsPreprocessor options Display the assembler’s version number on the console Others Linker command general format List of Linker Command Options Instruction RAM options Library file options Display the linker’s version number on the console Ld103 @ pfileDisplay help information on the console List of Assembler Directives Directives for symbolsDirectives for program control Syntax Function & Notes Directives for list control Directives for data area allocation Other directives Clang Extended C language format defaultIntel Intel format Pana Matsushita format This section provides a list of assembler control statements List of Assembler Control Statements Syntax Function & Notes Symbols Machine language code supplemental information Libraryfilename 103 Pathname 104 Label Field 148Macro 207 Macroname 207 Undefined 142 173 Number Wall 313 289 Xlistoff 176 Xliston Index MN1030 Series Cross Assembler User’s Manual Sales Offices