TMS320C5x DSP STARTER KIT USER'S GUIDE

Directives Reference.copy/.includeSyntax .copy ”filename”.include”filename”DescriptionExampleThe .copy and .include directives tell the assembler to read source statementsfrom a different file. The assembler:1) Stops assembling statements in the current source file2) Assembles the statements in the copied/included file3) Resumes assembling statements in the main source file, starting with thestatement that follows the .copy or .include directivefilename is a required parameter that names a source file; the filename must beenclosed in double quotes and must follow operating system conventions. You canspecify a full pathname (for example, c:\dsktools\file1.asm). If you do not specifya full pathname, the assembler searches for the file in the current directory.The statements that are assembled from an included file are printed in theassembly listing, depending on the .liston/.listoff directives and –l option.The .copy and .include directives can be nested within a file being copied orincluded. The assembler limits this type of nesting to eight levels; the hostoperating system may set additional restrictions.This example shows how the .include directive is used to tell the assembler to readand assemble source statements from other files, and then resume assemblinginto the current file.Source file: (source.asm);filename: source.asm.space 10h ;filename: source.asm.include ”byte.asm” ;filename: source.asm;filename: source.asm.space 20h ;filename: source.asmFirst copy file: (byte.asm);filename: byte.asm.byte ’a’, 0ah, 32 ;filename: byte.asm.include ”word.asm” ;filename: byte.asm.byte 11,12,13 ;filename: byte.asm;filename: byte.asmSecond copy file: (word.asm);filename: word.asm.word 0abcdh, 56 ;filename: word.asm;filename: word.asmAssembler Directives5-13