Syntax

              .copy "filename"

              .include "filename"

Description

The .copy and .include directives tell the assembler to read source statements from a different file. The statements that are assembled from a copy file are printed in the assembly listing. The statements that are assembled from an included file are not printed in the assembly listing, regardless of the number of .list/.nolist directives assembled.

When a .copy or .include directive is assembled, the assembler:

1. Stops assembling statements in the current source file
2. Assembles the statements in the copied/included file
3. Resumes assembling statements in the main source file, starting with the statement that follows the .copy or .include directive

The filename is a required parameter that names a source file. It is enclosed in double quotes and must follow operating system conventions.

You can specify a full pathname (for example, /320tools/file1.asm). If you do not specify a full pathname, the assembler searches for the file in:

1. The directory that contains the current source file
2. Any directories named with the --include_path assembler option
3. Any directories specified by the C2000_A_DIR environment variable
4. Any directories specified by the C2000_C_DIR environment variable

For more information about the --include_path option and C2000_A_DIR, see Section 5.6. For more information about C2000_C_DIR, see the TMS320C28x Optimizing C/C++ Compiler User's Guide.

The .copy and .include directives can be nested within a file being copied or included. The assembler limits nesting to 32 levels; the host operating system may set additional restrictions. The assembler precedes the line numbers of copied files with a letter code to identify the level of copying. A indicates the first copied file, B indicates a second copied file, etc.

Example 1

In this example, the .copy directive is used to read and assemble source statements from other files; then, the assembler resumes assembling into the current file.

The original file, copy.asm, contains a .copy statement copying the file byte.asm. When copy.asm assembles, the assembler copies byte.asm into its place in the listing (note listing below). The copy file byte.asm contains a .copy statement for a second file, word.asm.

When it encounters the .copy statement for word.asm, the assembler switches to word.asm to continue copying and assembling. Then the assembler returns to its place in byte.asm to continue copying and assembling. After completing assembly of byte.asm, the assembler returns to copy.asm to assemble its remaining statement.

     .space 29
     .copy "byte.asm"
 ** Back in original file
     .string "done" 

 ** In byte.asm
     .byte 32,1+ 'A'
     .copy "word.asm"
 ** Back in byte.asm
     .byte 67h + 3q

 ** In word.asm
     .word 0ABCDh, 56q

Listing file:

       1 000000           .space 29
       2                  .copy "byte.asm"
       1              ** In byte.asm
       2 000002 0005     byte 5
       3                  .copy "word.asm"
       1              ** In word.asm
       2 000003 ABCD      .word 0ABCDh
       4              * Back in byte.asm
       5 000004 0006      .byte 6
       3              
       4              **Back in original file
       5 000005 646F      .string "done"
         000006 6E65 

Example 2

In this example, the .include directive is used to read and assemble source statements from other files; then, the assembler resumes assembling into the current file. The mechanism is similar to the .copy directive, except that statements are not printed in the listing file.

     .space 29
     .include "byte2.asm"
 ** Back in original file
     .string "done" 

 ** In byte2.asm
     .byte 32,1+ 'A'
     .include "word2.asm"
 ** Back in byte2.asm
     .byte 67h + 3q 

 ** In word2.asm
     .word 0ABCDh, 56q

Listing file:

       1 000000           .space 29
       2                  .include "byte2.asm"
       3              
       4              ** Back in original file
       5 000007 0064      .string "done"
         000008 006F 
         000009 006E 
         00000a 0065