ZHCUAU3J January   2018  – March 2024

 

  1.   1
  2.   请先阅读
    1.     关于本手册
    2.     标记规则
    3.     相关文档
    4.     德州仪器 (TI) 提供的相关文档
    5.     商标
  3. 1 软件开发工具简介
    1. 1.1 软件开发工具概述
    2. 1.2 编译器接口
    3. 1.3 ANSI/ISO 标准
    4. 1.4 输出文件
  4. 2 开始使用代码生成工具
    1. 2.1 Code Composer Studio 项目如何使用编译器
    2. 2.2 从命令行编译
  5. 3 使用 C/C++ 编译器
    1. 3.1  关于编译器
    2. 3.2  调用 C/C++ 编译器
    3. 3.3  使用选项更改编译器的行为
      1. 3.3.1  链接器选项
      2. 3.3.2  常用选项
      3. 3.3.3  其他有用的选项
      4. 3.3.4  运行时模型选项
      5. 3.3.5  选择目标 CPU 版本（--silicon_version 选项）
      6. 3.3.6  符号调试和分析选项
      7. 3.3.7  指定文件名
      8. 3.3.8  更改编译器解释文件名的方式
      9. 3.3.9  更改编译器处理 C 文件的方式
      10. 3.3.10 更改编译器解释和命名扩展名的方式
      11. 3.3.11 指定目录
    4. 3.4  通过环境变量控制编译器
      1. 3.4.1 设置默认编译器选项 (C7X_C_OPTION)
      2. 3.4.2 命名一个或多个备用目录 (C7X_C_DIR)
    5. 3.5  控制预处理器
      1. 3.5.1  预先定义的宏名称
      2. 3.5.2  #include 文件的搜索路径
        1. 3.5.2.1 在 #include 文件搜索路径（--include_path 选项）中新增目录
      3. 3.5.3  支持#warning 和 #warn 指令
      4. 3.5.4  生成预处理列表文件（--preproc_only 选项）
      5. 3.5.5  预处理后继续编译（--preproc_with_compile 选项）
      6. 3.5.6  生成带有注释的预处理列表文件（--preproc_with_comment 选项）
      7. 3.5.7  生成带有行控制详细信息的预处理列表（--preproc_with_line 选项）
      8. 3.5.8  为 Make 实用程序生成预处理输出（--preproc_dependency 选项）
      9. 3.5.9  生成包含#include在内的文件列表（--preproc_includes 选项）
      10. 3.5.10 在文件中生成宏列表（--preproc_macros 选项）
    6. 3.6  将参数传递给 main()
    7. 3.7  了解诊断消息
      1. 3.7.1 控制诊断消息
      2. 3.7.2 如何使用诊断抑制选项
    8. 3.8  其他消息
    9. 3.9  生成原始列表文件（--gen_preprocessor_listing 选项）
    10. 3.10 使用内联函数扩展
      1. 3.10.1 内联内在函数运算符
      2. 3.10.2 内联限制
      3. 3.10.3 不受保护定义控制的内联
        1. 3.10.3.1 使用内联关键字
      4. 3.10.4 保护内联和 _INLINE 预处理器符号
        1. 3.10.4.1 头文件 string.h
        2. 3.10.4.2 库定义文件
    11. 3.11 使用交叉列出功能
    12. 3.12 关于应用程序二进制接口
    13. 3.13 启用入口挂钩和出口挂钩函数
  6. 4 优化您的代码
    1. 4.1  调用优化
    2. 4.2  控制代码大小与速度
    3. 4.3  执行文件级优化（--opt_level=3 选项）
      1. 4.3.1 创建优化信息文件（--gen_opt_info 选项）
    4. 4.4  程序级优化（--program_level_compile 和 --opt_level=3 选项）
      1. 4.4.1 控制程序级优化（--call_assumptions 选项）
    5. 4.5  自动内联扩展（--auto_inline 选项）
    6. 4.6  链接时优化（--opt_level=4 选项）
      1. 4.6.1 选项处理
      2. 4.6.2 不兼容的类型
    7. 4.7  优化软件流水线
      1. 4.7.1 关闭软件流水线（--disable_software_pipeline 选项）
      2. 4.7.2 软件流水线信息
        1. 4.7.2.1 软件流水线信息
        2. 4.7.2.2 软件流水线信息术语
        3. 4.7.2.3 不符合软件流水线的循环的消息循环
        4. 4.7.2.4 流水线故障消息
        5. 4.7.2.5 由 --debug_software_pipeline 选项生成寄存器使用表
      3. 4.7.3 折叠逻辑程序和收尾程序以改善性能和代码大小
        1. 4.7.3.1 推测执行
    8. 4.8  冗余循环
    9. 4.9  指示是否使用了某些别名技术
      1. 4.9.1 采用某些别名时使用 --aliased_variables 选项
    10. 4.10 防止重新排列关联浮点运算
    11. 4.11 使用性能建议优化代码
      1. 4.11.1 建议 #35000：使用 restrict 提高循环性能
    12. 4.12 通过优化使用交叉列出特性
    13. 4.13 调试和分析优化代码
      1. 4.13.1 分析优化的代码
    14. 4.14 正在执行什么类型的优化？
      1. 4.14.1  基于成本的寄存器分配
      2. 4.14.2  别名消歧
      3. 4.14.3  分支优化和控制流简化
      4. 4.14.4  数据流优化
      5. 4.14.5  表达式简化
      6. 4.14.6  函数的内联扩展
      7. 4.14.7  函数符号别名
      8. 4.14.8  归纳变量和强度降低
      9. 4.14.9  循环不变量代码运动
      10. 4.14.10 循环旋转
      11. 4.14.11 循环折叠和循环合并
      12. 4.14.12 展开和阻塞
      13. 4.14.13 向量化 (SIMD)
      14. 4.14.14 指令排程
      15. 4.14.15 寄存器变量
      16. 4.14.16 寄存器跟踪/定位
      17. 4.14.17 软件流水线
    15. 4.15 流引擎和流地址生成器
      1. 4.15.1 流引擎概述
      2. 4.15.2 流引擎和流地址生成器的工作原理
      3. 4.15.3 流地址生成器概述
      4. 4.15.4 使用流引擎和流地址生成器的优点
      5. 4.15.5 用于流引擎和流地址生成器的接口
      6. 4.15.6 参数模板配置
      7. 4.15.7 使用流引擎
        1. 4.15.7.1 使用流引擎时进行硬编码的内在函数操作数
      8. 4.15.8 使用流地址生成器
        1. 4.15.8.1 流地址生成器的矢量谓词
        2. 4.15.8.2 断言与非断言的流地址存储和加载
      9. 4.15.9 自动使用流引擎和流地址生成器（--auto_stream 选项）
        1. 4.15.9.1 自动使用 SE 和 SA 的正确性
        2. 4.15.9.2 对 SE 和 SA 的自动使用进行调优
    16. 4.16 嵌套循环控制器 (NLC)
      1. 4.16.1 可能限制使用 NLC 的障碍
  7. 5 C/C++ 语言实现
    1. 5.1  C7000 C 的特征
      1. 5.1.1 实现定义的行为
    2. 5.2  C7000 C++ 的特性
    3. 5.3  数据类型
      1. 5.3.1 枚举类型大小
      2. 5.3.2 矢量数据类型
    4. 5.4  文件编码和字符集
    5. 5.5  关键字
      1. 5.5.1 complex 关键字
      2. 5.5.2 const 关键字
      3. 5.5.3 __cregister 关键字
        1. 5.5.3.1 定义和使用控制寄存器
        2. 5.5.3.2 在进行浮点运算后评估标志状态寄存器 (FSR) 中的标志
      4. 5.5.4 restrict 关键字
      5. 5.5.5 volatile 关键字
    6. 5.6  C++ 异常处理
    7. 5.7  寄存器变量和参数
    8. 5.8  pragma 指令
      1. 5.8.1  CALLS Pragma
      2. 5.8.2  CLINK Pragma
      3. 5.8.3  COALESCE_LOOP Pragma
      4. 5.8.4  CODE_ALIGN Pragma
      5. 5.8.5  CODE_SECTION Pragma
      6. 5.8.6  DATA_ALIGN Pragma
      7. 5.8.7  DATA_MEM_BANK Pragma
        1. 5.8.7.1 使用 DATA_MEM_BANK Pragma
      8. 5.8.8  DATA_SECTION Pragma
        1. 5.8.8.1 使用 DATA_SECTION Pragma C 源文件
        2. 5.8.8.2 使用 DATA_SECTION Pragma C++ 源文件
      9. 5.8.9  诊断消息 Pragma
      10. 5.8.10 FORCEINLINE Pragma
      11. 5.8.11 FORCEINLINE_RECURSIVE Pragma
      12. 5.8.12 FUNC_ALWAYS_INLINE Pragma
      13. 5.8.13 FUNC_CANNOT_INLINE Pragma
      14. 5.8.14 FUNC_EXT_CALLED Pragma
      15. 5.8.15 FUNC_IS_PURE Pragma
      16. 5.8.16 FUNC_IS_SYSTEM Pragma
      17. 5.8.17 FUNC_NEVER_RETURNS Pragma
      18. 5.8.18 FUNC_NO_GLOBAL_ASG Pragma
      19. 5.8.19 FUNC_NO_IND_ASG Pragma
      20. 5.8.20 FUNCTION_OPTIONS Pragma
      21. 5.8.21 INTERRUPT Pragma
      22. 5.8.22 LOCATION Pragma
      23. 5.8.23 MUST_ITERATE Pragma
        1. 5.8.23.1 MUST_ITERATE Pragma 语法
        2. 5.8.23.2 使用 MUST_ITERATE 扩展编译器对循环的了解
      24. 5.8.24 NOINIT 和 PERSISTENT Pragma
      25. 5.8.25 NOINLINE Pragma
      26. 5.8.26 NO_COALESCE_LOOP Pragma
      27. 5.8.27 NO_HOOKS Pragma
      28. 5.8.28 once Pragma
      29. 5.8.29 pack Pragma
      30. 5.8.30 PROB_ITERATE Pragma
      31. 5.8.31 RETAIN Pragma
      32. 5.8.32 SET_CODE_SECTION 和 SET_DATA_SECTION Pragma
      33. 5.8.33 STRUCT_ALIGN Pragma
      34. 5.8.34 UNROLL Pragma
      35. 5.8.35 WEAK Pragma
    9. 5.9  _Pragma 运算符
    10. 5.10 应用程序二进制接口
    11. 5.11 目标文件符号命名规则（链接名）
    12. 5.12 更改 ANSI/ISO C/C++ 语言模式
      1. 5.12.1 C99 支持 (--c99)
      2. 5.12.2 C11 支持 (--c11)
      3. 5.12.3 严格 ANSI 模式和宽松 ANSI 模式（--strict_ansi 和 --relaxed_ansi）
    13. 5.13 GNU 和 Clang 语言扩展
      1. 5.13.1 扩展
      2. 5.13.2 函数属性
      3. 5.13.3 For 循环属性
      4. 5.13.4 变量属性
      5. 5.13.5 类型属性
      6. 5.13.6 内置函数
    14. 5.14 向量数据类型的运算和函数
      1. 5.14.1 向量字面量和串联
      2. 5.14.2 向量的一元和二进制运算符
      3. 5.14.3 向量的三态运算符 (?:)
      4. 5.14.4 矢量的混合运算符
      5. 5.14.5 不受支持的矢量比较运算符
      6. 5.14.6 向量的转换函数
      7. 5.14.7 矢量的重新解释函数
      8. 5.14.8 矢量谓词类型
        1. 5.14.8.1 构造向量谓词类型
        2. 5.14.8.2 使用向量谓词类型
        3. 5.14.8.3 布尔向量类型
    15. 5.15 C7000 内在函数
      1. 5.15.1 高级别过载内在函数
      2. 5.15.2 为特殊加载和存储指令定义的内在函数
      3. 5.15.3 直接映射的内在函数
      4. 5.15.4 查找表和直方图内在函数
      5. 5.15.5 矩阵乘法加速器 (MMA) 内在函数
      6. 5.15.6 传统内在函数
    16. 5.16 C7000 可扩展矢量编程
  8. 6 运行时环境
    1. 6.1 存储器
      1. 6.1.1 段
      2. 6.1.2 C/C++ 系统堆栈
      3. 6.1.3 动态存储器分配
    2. 6.2 对象表示
      1. 6.2.1 数据类型存储
        1. 6.2.1.1 char 和 short 数据类型（有符号和无符号）
        2. 6.2.1.2 enum、int 和 long 数据类型（有符号和无符号）
        3. 6.2.1.3 长数据类型（有符号和无符号）
        4. 6.2.1.4 浮点数据类型
        5. 6.2.1.5 double 和 long double 数据类型
        6. 6.2.1.6 指向数据成员类型的指针
        7. 6.2.1.7 指向成员函数类型的指针
        8. 6.2.1.8 结构和数组
      2. 6.2.2 位字段
      3. 6.2.3 字符串常量
    3. 6.3 寄存器惯例
    4. 6.4 函数结构和调用惯例
      1. 6.4.1 函数如何进行调用
      2. 6.4.2 被调用函数如何响应
      3. 6.4.3 访问参数和局部变量
    5. 6.5 访问 C 和 C++ 中的链接器符号
    6. 6.6 运行时支持算术例程
    7. 6.7 系统初始化
      1. 6.7.1 用于系统预初始化的引导挂钩函数
      2. 6.7.2 变量的自动初始化
        1. 6.7.2.1 零初始化变量
        2. 6.7.2.2 的直接初始化
        3. 6.7.2.3 运行时变量自动初始化
        4. 6.7.2.4 的自动初始化表
          1. 6.7.2.4.1 数据格式遵循的长度
          2. 6.7.2.4.2 零初始化格式
          3. 6.7.2.4.3 行程编码 (RLE) 格式
          4. 6.7.2.4.4 Lempel-Ziv-Storer-Szymanski 压缩 (LZSS) 格式
        5. 6.7.2.5 在加载时初始化变量
        6. 6.7.2.6 全局构造函数
  9. 7 使用运行时支持函数并构建库
    1. 7.1 C 和 C++ 运行时支持库
      1. 7.1.1 将代码与对象库链接
      2. 7.1.2 头文件
      3. 7.1.3 修改库函数
      4. 7.1.4 支持字符串处理
      5. 7.1.5 极少支持国际化
      6. 7.1.6 时间和时钟函数支持
      7. 7.1.7 允许打开的文件数量
      8. 7.1.8 库命名规则
    2. 7.2 C I/O 函数
      1. 7.2.1 高级别 I/O 函数
        1. 7.2.1.1 格式化和格式转换缓冲区
      2. 7.2.2 低级 I/O 实现概述
        1.       open
        2.       close
        3.       read
        4.       write
        5.       lseek
        6.       unlink
        7.       rename
      3. 7.2.3 器件驱动程序级别 I/O 函数
        1.       DEV_open
        2.       DEV_close
        3.       DEV_read
        4.       DEV_write
        5.       DEV_lseek
        6.       DEV_unlink
        7.       DEV_rename
      4. 7.2.4 为 C I/O 添加用户定义的器件驱动程序
        1. 7.2.4.1 将默认流映射到器件
      5. 7.2.5 器件前缀
        1.       add_device
        2.       291
        3. 7.2.5.1 为 C I/O 器件编程
    3. 7.3 处理可重入性（_register_lock() 和 _register_unlock() 函数）
    4. 7.4 库构建流程
      1. 7.4.1 所需的非德州仪器 (TI) 软件
      2. 7.4.2 使用库构建流程
        1. 7.4.2.1 通过链接器自动重建标准库
        2. 7.4.2.2 手动调用 mklib
          1. 7.4.2.2.1 构建标准库
          2. 7.4.2.2.2 共享或只读库目录
          3. 7.4.2.2.3 使用自定义选项构建库
          4. 7.4.2.2.4 mklib 程序选项摘要
      3. 7.4.3 扩展 mklib
        1. 7.4.3.1 底层机制
        2. 7.4.3.2 来自其他供应商的库
  10. 8 目标模块简介
    1. 8.1 目标文件格式规范
    2. 8.2 可执行目标文件
    3. 8.3 段简介
      1. 8.3.1 特殊段名
    4. 8.4 链接器如何处理段
      1. 8.4.1 合并输入段
      2. 8.4.2 放置段
    5. 8.5 符号
      1. 8.5.1 局部符号
      2. 8.5.2 弱符号
    6. 8.6 加载程序
  11. 9 程序加载和运行
    1. 9.1 负载
    2. 9.2 入口点
    3. 9.3 运行时初始化
      1. 9.3.1 _c_int00 函数
      2. 9.3.2 RAM 模型与 ROM 模型
        1. 9.3.2.1 在运行时自动初始化变量 (--rom_model)
        2. 9.3.2.2 在加载时初始化变量 (--ram_model)
        3. 9.3.2.3 --rom_model 和 --ram_model 链接器选项
      3. 9.3.3 关于链接器生成的复制表
        1. 9.3.3.1 BINIT
        2. 9.3.3.2 CINIT
    4. 9.4 main 的参数
    5. 9.5 运行时重定位
    6. 9.6 其他信息
  12. 10归档器说明
    1. 10.1 归档器概述
    2. 10.2 归档器在软件开发流程中的作用
    3. 10.3 调用归档器
    4. 10.4 归档器示例
    5. 10.5 库信息归档器说明
      1. 10.5.1 调用库信息归档器
      2. 10.5.2 库信息归档器示例
      3. 10.5.3 列出索引库的内容
      4. 10.5.4 要求
  13. 11链接 C/C++ 代码
    1. 11.1 通过编译器调用链接器（-z 选项）
      1. 11.1.1 单独调用链接器
      2. 11.1.2 调用链接器作为编译步骤的一部分
      3. 11.1.3 禁用链接器（--compile_only 编译器选项）
    2. 11.2 链接器代码优化
      1. 11.2.1 条件链接
      2. 11.2.2 生成函数子段（--gen_func_subsections 编译器选项）
      3. 11.2.3 生成聚合数据子段（--gen_data_subsections 编译器选项）
    3. 11.3 控制链接过程
      1. 11.3.1 包含运行时支持库
        1. 11.3.1.1 自动选择运行时支持库
          1. 11.3.1.1.1 使用 --issue_remarks 选项
        2. 11.3.1.2 手动选择运行时支持库
        3. 11.3.1.3 用于搜索符号的库顺序
      2. 11.3.2 运行时初始化
      3. 11.3.3 全局对象构造函数
      4. 11.3.4 指定全局变量初始化类型
      5. 11.3.5 指定在内存中分配段的位置
      6. 11.3.6 链接器命令文件示例
  14. 12链接器说明
    1. 12.1  链接器概述
    2. 12.2  链接器在软件开发流程中的作用
    3. 12.3  调用链接器
    4. 12.4  链接器选项
      1. 12.4.1  文件、段和符号模式中的通配符
      2. 12.4.2  通过链接器选项指定 C/C++ 符号
      3. 12.4.3  重定位功能（--absolute_exe 和 --relocatable 选项）
        1. 12.4.3.1 生成绝对输出模块（--absolute_exe 选项）
        2. 12.4.3.2 生成可重定位输出模块（--relocatable 选项）
      4. 12.4.4  分配存储器供加载器使用以传递参数（--arg_size 选项）
      5. 12.4.5  压缩（--cinit_compression 和 --copy_compression 选项）
      6. 12.4.6  压缩 DWARF 信息（--compress_dwarf 选项）
      7. 12.4.7  控制链接器诊断
      8. 12.4.8  自动选择库（--disable_auto_rts 选项）
      9. 12.4.9  不要删除未使用的段（--unused_section_elimination 选项）
      10. 12.4.10 链接器命令文件预处理（--disable_pp、--define 和 --undefine 选项）
      11. 12.4.11 定义入口点（--entry_point 选项）
      12. 12.4.12 设置默认填充值（--fill_value 选项）
      13. 12.4.13 定义堆大小（--heap_size 选项）
      14. 12.4.14 隐藏符号
      15. 12.4.15 改变库搜索算法（--library、--search_path 和 C7X_C_DIR）
        1. 12.4.15.1 指定备用库目录（--search_path 选项）
        2. 12.4.15.2 指定备用库目录（C7X_C_DIR 环境变量）
        3. 12.4.15.3 详尽读取和搜索库（--reread_libs 和 --priority 选项）
      16. 12.4.16 更改符号局部化
        1. 12.4.16.1 将所有全局符号设为静态（--make_static 选项）
      17. 12.4.17 创建映射文件（--map_file 选项）
      18. 12.4.18 管理映射文件内容（--mapfile_contents 选项）
      19. 12.4.19 禁用名称还原 (--no_demangle)
      20. 12.4.20 合并符号调试信息
      21. 12.4.21 去除符号信息（--no_symtable 选项）
      22. 12.4.22 指定输出模块（--output_file 选项）
      23. 12.4.23 确定函数放置优先级（--preferred_order 选项）
      24. 12.4.24 C 语言选项（--ram_model 和 --rom_model 选项）
      25. 12.4.25 保留丢弃的段（--retain 选项）
      26. 12.4.26 扫描所有库中的重复符号定义（--scan_libraries）
      27. 12.4.27 定义栈大小（--stack_size 选项）
      28. 12.4.28 符号映射（--symbol_map 选项）
      29. 12.4.29 生成 Far 调用 Trampoline（--trampolines 选项）
        1. 12.4.29.1 使用 Trampoline 的优缺点
        2. 12.4.29.2 尽量减少所需的 Trampoline 数量（--minimize_trampolines 选项）
        3. 12.4.29.3 将 Trampoline 从加载空间传送到运行空间
      30. 12.4.30 引入未解析的符号（--undef_sym 选项）
      31. 12.4.31 创建未定义的输出段时显示一条消息 (--warn_sections)
      32. 12.4.32 生成 XML 链接信息文件（--xml_link_info 选项）
      33. 12.4.33 零初始化（--zero_init 选项）
    5. 12.5  链接器命令文件
      1. 12.5.1  链接器命令文件中的保留名称
      2. 12.5.2  链接器命令文件中的常量
      3. 12.5.3  从链接器命令文件访问文件和库
      4. 12.5.4  MEMORY 指令
        1. 12.5.4.1 默认存储器型号
        2. 12.5.4.2 MEMORY 指令语法
        3. 12.5.4.3 表达式和地址运算符
      5. 12.5.5  SECTIONS 指令
        1. 12.5.5.1 SECTIONS 指令语法
        2. 12.5.5.2 段分配和放置
          1. 12.5.5.2.1 绑定
          2. 12.5.5.2.2 指定的存储器
          3. 12.5.5.2.3 使用 HIGH 位置说明符来控制放置
            1. 12.5.5.2.3.1 使用 HIGH 说明符进行链接器放置
            2.         425
            3. 12.5.5.2.3.2 在没有 HIGH 说明符的情况下进行链接器放置
          4. 12.5.5.2.4 对齐和分块
          5. 12.5.5.2.5 对齐和填充
        3. 12.5.5.3 指定输入段
          1. 12.5.5.3.1 指定段内容的最常用方法
          2.        431
        4. 12.5.5.4 使用多级子段
        5. 12.5.5.5 指定库或存档成员作为输出段的输入
          1. 12.5.5.5.1 将成员存档至输出段
          2.        435
        6. 12.5.5.6 使用多个存储器范围进行分配
        7. 12.5.5.7 在非连续存储器范围之间自动拆分输出段
      6. 12.5.6  在不同的加载和运行地址放置段
        1. 12.5.6.1 指定加载和运行地址
        2.       440
      7. 12.5.7  使用 GROUP 和 UNION 语句
        1. 12.5.7.1 将输出段一同进行分组
        2. 12.5.7.2 利用 UNION 语句叠加段
        3. 12.5.7.3 将存储器用于多种用途
        4. 12.5.7.4 嵌套 UNION 和 GROUP
        5. 12.5.7.5 检查分配器的一致性
        6. 12.5.7.6 为 UNION 和 GROUP 命名
      8. 12.5.8  特殊段类型（DSECT、COPY、NOLOAD 和 NOINIT）
      9. 12.5.9  在链接时分配符号
        1. 12.5.9.1 赋值语句的语法
        2. 12.5.9.2 向符号分配 SPC
        3. 12.5.9.3 赋值表达式
        4. 12.5.9.4 由链接器自动定义的符号
        5. 12.5.9.5 向符号分配一个段的确切开始值、结束值和大小值
        6. 12.5.9.6 为什么点运算符有时不起作用
        7. 12.5.9.7 地址和维度运算符
          1. 12.5.9.7.1 输入项
          2. 12.5.9.7.2 输出段
          3. 12.5.9.7.3 GROUP
          4. 12.5.9.7.4 UNION
        8. 12.5.9.8 LAST 运算符
      10. 12.5.10 创建和填充孔洞
        1. 12.5.10.1 已初始化和未初始化的段
        2. 12.5.10.2 创建空洞
        3. 12.5.10.3 填充孔洞
        4. 12.5.10.4 对未初始化的段进行显式初始化
    6. 12.6  链接器符号
      1. 12.6.1 链接器定义的函数和数组
      2. 12.6.2 链接器定义的整数值
      3. 12.6.3 链接器定义的地址
      4. 12.6.4 有关 _symval 运算符的更多信息
      5. 12.6.5 使用 _symval、PC 相对寻址和远数据
      6. 12.6.6 弱符号
        1. 12.6.6.1 弱符号引用
        2. 12.6.6.2 弱符号定义
      7. 12.6.7 利用对象库解析符号
    7. 12.7  默认放置算法
      1. 12.7.1 分配算法如何创建输出段
      2. 12.7.2 减少存储器碎片
    8. 12.8  使用由链接器生成的复制表
      1. 12.8.1 使用复制表进行引导加载
      2. 12.8.2 在复制表中使用内置链接运算符
      3. 12.8.3 重叠管理示例
      4. 12.8.4 使用 table() 运算符生成复制表
        1. 12.8.4.1 table() 操作符
        2. 12.8.4.2 启动时复制表
        3. 12.8.4.3 使用 table() 操作符管理目标组件
        4. 12.8.4.4 由链接器生成的复制表段和符号
        5. 12.8.4.5 拆分对象组件和重叠管理
      5. 12.8.5 压缩
        1. 12.8.5.1 压缩的复制表格式
        2. 12.8.5.2 目标文件中的压缩段表示
        3. 12.8.5.3 压缩的数据布局
        4. 12.8.5.4 运行时解压缩
        5. 12.8.5.5 压缩算法
        6.       496
      6. 12.8.6 复制表内容
      7. 12.8.7 通用复制例程
    9. 12.9  部分（增量）链接
    10. 12.10 链接 C/C++ 代码
      1. 12.10.1 运行时初始化
      2. 12.10.2 对象库和运行时支持
      3. 12.10.3 设置堆栈段的大小
      4. 12.10.4 在运行时初始化和自动初始化变量
      5. 12.10.5 CMMU 配置产生的约束
    11. 12.11 链接器示例
  15. 13目标文件实用程序
    1. 13.1 调用目标文件显示实用程序
    2. 13.2 调用反汇编器
    3. 13.3 调用名称实用程序
    4. 13.4 调用符号去除实用程序
  16. 14C++ 名称还原器
    1. 14.1 调用 C++ 名称还原器
    2. 14.2 C++ 名称还原器的示例用法
  17.   A XML 链接信息文件说明
    1.     A.1 XML 信息文件元素类型
    2.     A.2 文档元素
      1.      A.2.1 标头元素
      2.      A.2.2 输入文件列表
      3.      A.2.3 对象组件列表
      4.      A.2.4 逻辑组列表
      5.      A.2.5 放置映射
      6.      A.2.6 Far Call Trampoline 列表
      7.      A.2.7 符号表
  18.   B 不受支持的工具和功能
    1.     B.1 不受支持的工具和功能列表
  19.   C 术语表
    1.     528
  20.   D 修订历史记录

12.11 链接器示例

此示例链接了名为 demo.c.obj、filter.c.obj 和 tables.obj 的三个目标文件，并创建了名为 demo.out 的程序。

假定目标存储器具有以下程序存储器配置：

地址范围 内容
0x0080 至 0x7000 片上 RAM_PG
0xC000 至 0xFF80 片上 ROM
地址范围 内容
0x0080 至 0x0FFF RAM 块 ONCHIP
0x0060 至 0xFFFF 映射的外部地址 EXT
地址范围 内容
0x00000020 至 0x00210000 PMEM
0x00400000 至 0x01400000 EXT0
0x01400000 至 0x01800000 EXT1
0x02000000 至 0x03000000 EXT2
0x03000000 至 0x04000000 EXT3
0x40000000 至 0x82000000 BMEM

输出段的构造方式如下：

  • demo.c.obj、filters.c.obj 中 .text 段包含的可执行代码，以及来自 RTS 库的可执行代码链接到程序存储器 PMEM。
  • tables.c.obj 中定义了两个数据对象。每个对象置于其自有输出段中：.tableA 和 .tableB。加载程序时，.tableA 和 .tableB 输出段链接到 BMEM 区域中的单独位置。但是，对这些表的运行时访问引用由符号“filter_matrix”指示的运行时位置，其定义为包含 .tableA 和 .tableB 的 UNION 的起始位置。此位置链接到 EXT1 存储器区域。在运行时，在尝试从复制的表中访问数据之前，应用程序负责将 .tableA 或 .tableB 从其在 BMEM 中的加载位置复制到在 EXT1 中的运行位置。链接器支持节 12.8中所述的复制表机制，以为完成此操作提供便利。
  • 对于支持并使用 DP 相对寻址的架构，使用 DP 相对寻址访问的所有数据对象均收集到一个包括 .bss 输出段的组中。该组链接到 BMEM 存储器区域。
  • 由于 demo.out 程序使用在加载和运行 demo.out 时必须指定的命令行参数，应用程序必须预留空间，以便将命令行参数传递至 .args 段中的程序。为 .args 段分配的空间大小在靠近链接器命令文件顶部的‘--args 0x1000’选项中指示。然后将 .args 输出段链接到 BMEM 存储器区域。在 RTS 库中包含的引导例程中提供了对处理命令行参数的支持，该引导例程将链接到 demo.out 程序。
  • 软件栈的大小通过靠近链接器命令文件顶部的“--stack 0x6000”选项来指示。同样，堆的大小（通过它可以在运行时动态地分配存储器）通过靠近链接器命令文件顶部的“--heap 0x3000”选项来指示。.stack 和 .sysmem（包含堆）输出段链接到 BMEM 存储器区域。

链接器命令文件 mylnk.cmd 展示了此示例的链接器命令文件。输出映射文件，demo.map 展示了映射文件。

链接器命令文件 mylnk.cmd

/****************************************************************************/  
/*** 指定链接器选项                                               ***/  
/****************************************************************************/  
-cr                                /* --ram_model: 加载时初始化 */  
--heap 0x3000
--stack 0x6000
--args 0x1000
--output_file=demo.out                        /* 命名输出文件     */   
--map_file=demo.map                           /* 创建输出映射文件 */   
--undefined_sym=filter_table_A            /* 引入未定义符号 */   
--undefined_sym=filter_table_B            /* 引入未定义符号 */   
/****************************************************************************/  
/*** 指定输入文件                                              ***/  
/****************************************************************************/  
demo.c.obj
tables.obj
filter.c.obj
/****************************************************************************/  
/*** 指定要链接的运行时支持库                      ***/  
/****************************************************************************/  
-l libc.a
/****************************************************************************/  
/*** 指定存储器配置                                     ***/  
/****************************************************************************/  
MEMORY
{
  PMEM: o = 00000020h l = 0020ffe0h
  EXT0: o = 00400000h l = 01000000h
  EXT1: o = 01400000h l = 00400000h
  EXT2: o = 02000000h l = 01000000h
  EXT3: o = 03000000h l = 01000000h
  BMEM: o = 40000000h l = 02000000h
}
/****************************************************************************/  
/*** 指定输出段                                          ***/  
/****************************************************************************/  
SECTIONS
{
  .text : > PMEM
  UNION
  {
    .tableA: { tables.obj(tableA) } load > BMEM, table(tableA_cpy)
    .tableB: { tables.obj(tableB) } load > BMEM, table(tableB_cpy)
  } RUN = EXT1, RUN_START(filter_matrix)
  GROUP
  {
    .rodata: 
    .bss: 
  } > EXT2
  .stack:  > BMEM
  .args :  > BMEM
  .cinit:  > BMEM
  .cio:    > BMEM
  .const:  > BMEM
  .data:   > BMEM
  .sysmem: > BMEM
}
/****************************************************************************/  
/*** 命令文件结束                                                  ***/  
/****************************************************************************/

输入以下命令来调用链接器：

cl7x --run_linker mylnk.cmd

这会创建一个如输出映射文件，demo.map 中所示的映射文件，以及一个名为 demo.out 的输出文件，可以在 C7000 上运行。

输出映射文件，demo.map

OUTPUT FILE NAME:   <demo.out>
ENTRY POINT SYMBOL: "_c_int00"  address: 000000007ec0
MEMORY CONFIGURATION
         name            origin         length     used     unused   attr    fill
----------------------  ------------   --------  --------  --------  ----  --------
  PMEM                  000000000020   0020ffe0  00008170  00207e70  RWIX
  EXT0                  000000400000   01000000  00000000  01000000  RWIX
  EXT1                  000001400000   00400000  00000080  003fff80  RWIX
  EXT2                  000002000000   01000000  000000b0  00ffff50  RWIX
  EXT3                  000003000000   01000000  00000000  01000000  RWIX
  BMEM                  000040000000   02000000  0000a6e4  01ff591c  RWIX
SEGMENT ALLOCATION MAP
  run origin     load origin      length   init length attrs members
--------------  --------------  ---------- ----------- ----- -------
000000000040    000000000040    00008170   00008170    r-x
  000000000040    000000000040    00008140   00008140    r-x .text
  000000008180    000000008180    00000030   00000030    r-- .ovly
000001400000    00004000a5e4    00000080   00000080    rw-
  000001400000    00004000a5e4    00000080   00000080    rw- .tableA
000001400000    00004000a664    00000080   00000080    rw-
  000001400000    00004000a664    00000080   00000080    rw- .tableB
000002000000    000002000000    000000b0   00000000    rw-
  000002000000    000002000000    000000b0   00000000    rw- .bss
000040000000    000040000000    00009000   00000000    rw-
  000040000000    000040000000    00006000   00000000    rw- .stack
  000040006000    000040006000    00003000   00000000    rw- .sysmem
000040009000    000040009000    00001384   00001384    rw-
  000040009000    000040009000    00001000   00001000    rw- .args
  00004000a000    00004000a000    00000384   00000384    rw- .data
00004000a384    00004000a384    00000140   00000140    r--
  00004000a384    00004000a384    00000140   00000140    r-- .const
00004000a4c4    00004000a4c4    00000120   00000000    rw-
  00004000a4c4    00004000a4c4    00000120   00000000    rw- .cio
SECTION ALLOCATION MAP
 output                                      attributes/
section   page      origin        length       input sections
--------  ----  --------------  ----------   ----------------
.text      0    000000000040    00008140
                  000000000040    00002400     rts7100_le.lib : _printfi.c.obj (.text:__TI_printfi)
                  000000002440    00000900                    : _printfi.c.obj (.text:_pconv_a)
                  000000002d40    00000800                    : _printfi.c.obj (.text:_pconv_g)
                  000000003540    00000680                    : _printfi.c.obj (.text:_pconv_e)
                  000000003bc0    000003c0                    : memory.c.obj (.text:aligned_alloc)
                  000000003f80    00000380                    : frcdivd.c.obj (.text:__TI_frcdivd)
                  000000004300    00000340                    : _printfi.c.obj (.text:_pconv_f)
                  000000004640    00000300                    : _printfi.c.obj (.text:fcvt)
                  000000004940    00000300                    : fputs.c.obj (.text:fputs)
...
.rodata    0    000002000000    00000000     UNINITIALIZED
.bss       0    000002000000    000000b0     UNINITIALIZED
                  000002000000    000000a0     (.common:__TI_tmpnams)
                  0000020000a0    00000008     rts7100_le.lib : memory.c.obj (.bss)
                  0000020000a8    00000008     (.common:parmbuf)
.stack     0    000040000000    00006000     UNINITIALIZED
                  000040000000    00000010     rts7100_le.lib : boot.c.obj (.stack)
                  000040000010    00005ff0     --HOLE--
.sysmem    0    000040006000    00003000     UNINITIALIZED
                  000040006000    00000010     rts7100_le.lib : memory.c.obj (.sysmem)
                  000040006010    00002ff0     --HOLE--
.args      0    000040009000    00001000
                  000040009000    00001000     --HOLE-- [fill = 0]
.data      0    00004000a000    00000384
                  00004000a000    000001e0     rts7100_le.lib : defs.c.obj (.data:_ftable)
                  00004000a1e0    000000d8                    : host_device.c.obj (.data:_device)
                  00004000a2b8    000000a0                    : host_device.c.obj (.data:_stream)
                  00004000a358    00000010                    : exit.c.obj (.data)
                  00004000a368    00000008                    : _lock.c.obj (.data:_lock)
                  00004000a370    00000008                    : _lock.c.obj (.data:_unlock)
                  00004000a378    00000004                    : defs.c.obj (.data)
                  00004000a37c    00000004                    : errno.c.obj (.data)
                  00004000a380    00000004                    : memory.c.obj (.data)
.const     0    00004000a384    00000140
                  00004000a384    00000101     rts7100_le.lib : ctype.c.obj (.const:.string:_ctypes_)
                  00004000a485    00000003     --HOLE-- [fill = 0]
                  00004000a488    00000024                    : _printfi.c.obj (.const:.string)
                  00004000a4ac    00000018     demo.c.obj (.const:.string)
.tableA    0    00004000a5e4    00000080     RUN ADDR = 000001400000
                  00004000a5e4    00000080     tables.obj (tableA)
.tableB    0    00004000a664    00000080     RUN ADDR = 000001400000
                  00004000a664    00000080     tables.obj (tableB)
.cinit     0    000040000000    00000000     UNINITIALIZED
.cio       0    00004000a4c4    00000120     UNINITIALIZED
                  00004000a4c4    00000120     rts7100_le.lib : trgmsg.c.obj (.cio)
.ovly      0    000000008180    00000030
                  000000008180    00000018     (.ovly:tableA_cpy)
                  000000008198    00000018     (.ovly:tableB_cpy)
...
LINKER GENERATED COPY TABLES
tableA_cpy @ 00008180 records: 1, size/record: 20, table size: 24
        .tableA: load addr=00004000a5e4, load size=00000080, run addr=000001400000, 
         run size=00000080, compression=none
tableB_cpy @ 00008198 records: 1, size/record: 20, table size: 24
        .tableB: load addr=00004000a664, load size=00000080, run addr=000001400000, 
         run size=00000080, compression=none
GLOBAL SYMBOLS: SORTED ALPHABETICALLY BY Name
address       name
------------  ----
000000008040  C$$EXIT
000000006eb0  C$$IO$$
0000000069c0  HOSTclose
000000006100  HOSTlseek
000000005f80  HOSTopen
...
000000008180  tableA_cpy
000000008198  tableB_cpy
000000007cc0  unlink
000000007d40  wcslen
000000007dc0  write
...
[96 symbols]