Guidelines

The -La option translates specified parts of header files into an include file to import labels and defines into an assembler source. Because the -La compiler option is very powerful, use the following guidelines to avoid incorrect usage. This section describes using this option to combine C and assembler sources, both using common header files.

The following general implementation recommendations help to avoid problems when writing software using the common header file technique.

• Make all interface memory reservations or definitions in C source files. Memory areas only accessed from assembler files can still be defined in the common assembler manner.
• Compile only C header files (and not the C source files) with the -La option to avoid multiple defines and other problems. The project-related makefile must contain an inference-rules section that defines the C header file-dependent include files to be created.
• Use #pragma CREATE_ASM_LISTING ON/OFF only in C header files. This pragma selects the objects to translated to the assembler include file. The created file then holds the corresponding assembler directives.
• Do not use the -La option as part of the command line options used for all compilations. Use this option in combination with the -Cx (no Code Generation) option. Without this option, the compiler creates an object file which could accidently overwrite a C source object file.
• Remember to extend the list of dependencies for assembler sources in your make file.
• Ensure that the compiler-created assembler include file is included into your assembler source.
  Note: The Compiler translates zero-page declared objects (if this is supported by the target) into XREF.B directives for the base address of a variable or constant. The compiler translates structure fields in the zero page into an EQU.B directive to access them. Explicit zero-page addressing syntax may be necessary as some assemblers use extended addresses to EQU.B defined labels.