L166 User's Guide

Combining Sections

Each section must have one of the following combination type attributes:

Combination TypeDescription
PRIVATESections of this type are not combined with sections from other modules. They may be combined with PRIVATE sections from the same module.
ABSOLUTESections of this type are located at an absolute address and are not combined with other sections.
PUBLICSections of this type are combined with other PUBLIC sections having the same name. PUBLIC sections are visible within a single TGROUP.
GLOBALSections of this type are combined with other GLOBAL sections having the same name. GLOBAL sections are visible to all TGROUPs.
COMMONSections of this type are overlapped with other COMMON sections having the same name into a single combined section. The length of the resulting section is the length of the largest section in the combination.
SYSSTACKSections of this type are combined with other SYSSTACK sections having the same name and located in on-chip RAM. The length of the resulting section is obtained by adding the lengths of the combined sections.
USRSTACKSections of this type are combined with other USRSTACK sections having the same name, located in memory, and accessed using DPPn:Offset. USRSTACK sections are visible within a single TGROUP. The length of the resulting section is obtained by adding the lengths of the combined sections.
GLOBUSRSTACKSections of this type are combined with other GLOBUSRSTACK sections having the same name, located in memory, and accessed using DPPn:Offset. GLOBUSRSTACK sections are visible to all TGROUPs. The length of the resulting section is obtained by adding the lengths of the combined sections.

Sections with the combination types PUBLIC and GLOBAL are combined end-to-end. A gap may exist between the sections if the alignment requires it. The relative addresses in the sections are adjusted for the increased section length.

Sections with the combination types SYSSTACK, USRSTACK, and GLOBUSRSTACK are overlaid but the section lengths are added together. The new section has the length of all the combined partial sections.

Sections with the combination type COMMON are overlaid with the low addresses starting at a common address. The length of the combined memory section is the length of the largest partial section that was combined.

Note

  • Use the same section and class name in each module to be sure that sections are combined correctly.