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 修订历史记录

3.3 使用选项更改编译器的行为

选项控制编译器的运行。本部分说明选项约定和选项摘要表。此外，还提供常用选项（包括用于类型检查的选项）的详细说明。

如需查看选项的帮助屏幕摘要，请在命令行上输入不带参数的 cl7x。

下述原则适用于编译器选项：

  • 通常有两种方法来指定给定的选项。“长格式”使用两个连字符前缀，通常是更具描述性的名称。“短格式”使用单个连字符前缀以及并不总是直观的字母与数字的组合。
  • 选项通常区分大小写。
  • 单个选项不能组合。
  • 带参数的选项应在参数前用等号指定，以清楚地将参数与选项关联起来。例如，用于取消定义常量的选项可以表示为 --undefine=name。同样，用于指定最大优化量的选项可以表示为 -O=3。还可以在某些选项后直接指定参数，例如 -O3 与 -O=3 相同。选项与可选参数之间不允许有空格，因此不接受 -O 3。
  • 文件和除 --run_linker 选项外的选项可以按任何顺序出现。--run_linker 选项必须跟在所有编译器选项之后且在任何链接器选项之前。

可以使用 C7X_C_OPTION 环境变量为编译器定义默认选项。有关环境变量的详细说明，请参阅节 3.4.1。

表 3-1 到表 3-27 汇总了所有选项（包括链接选项）。使用表中的参考资料以获取更完整的选项说明。

表 3-1 处理器选项
选项 别名 效果 段
--silicon_version=id -mv 选择目标版本。默认为 7100。 节 3.3.5
--silicon_errata_i2117 生成代码以处理 C7100 器件勘误表 i2117。 节 3.3.4
--silicon_errata_i2376={on|off} 生成代码以处理 C7504 器件勘误表 i2376。 节 3.3.4
--big_endian -me 以大端字节序格式生成目标代码。默认格式为小端字节序。 节 3.3.4
--mma_version={ 1 | 2 | 2_256 | disallow } 指定要在目标器件上使用的矩阵乘法加速器 (MMA) 的版本。 节 3.3.4
表 3-2 优化选项(1)
选项 别名 效果 段
--opt_level=off 禁用所有优化（如果未使用选项且 --vectypes=off，则为默认值）。 节 4.1
--opt_level=n -On 级别 0 (-O0) 仅优化寄存器使用情况（如果未使用选项且 --vectypes=on，则为默认值）。
级别 1 (-O1) 使用级别 0 优化并在本地进行优化。
级别 2 (-O2) 使用级别 1 优化并在本地进行优化（如果使用选项但无设置，则为默认值）。
级别 3 (-O3) 使用级别 2 优化并对文件进行优化。
级别 4 (-O4) 使用级别 3 优化并执行链接时间优化。		 节 4.1、节 4.3
--opt_for_speed[=n] -mf 控制大小和速度之间的权衡（0-5 范围）。如果未指定此选项，或此选项未指定 n，则默认值为 4。 节 4.2
(1) 注意：机器专用选项（参阅表 3-12）也会影响优化。
表 3-3 高级优化选项(1)
选项 别名 效果 段
--assume_addresses_ok_for_stream={off|on} 如果启用，使用 --auto_stream 选项控制的自动流式传输将假定寻址模式合法地映射到流。 节 4.15.9
启用此假设可能会导致更多地使用流引擎 (SE) 或流地址生成器 (SA)。可能需要此类假设的情况包括但不限于：应用于向量指针的 64 位索引、无符号索引和数组索引。
--auto_inline=[size] -oi 设置自动内联大小（仅限 --opt_level=3）。如果未指定 size，则默认值为 1。 节 4.5
--auto_stream={off|saving|no_saving} 控制编译器是否在可能且有利的情况下尝试自动使用流引擎 (SE) 和流地址生成器 (SA)。 节 4.15.9
在“off”模式下，将禁止自动使用 SE 和 SA。在“saving”模式下，SE 和/或 SA 状态将被保存，以防它们已在使用中。在“no_saving”模式下，无需保存上下文即可自动使用 SE 和 SA。C7100 和 C7120 器件仅支持“off”或“no_saving”模式，“off”是默认值。较新的器件（例如 C7504）支持所有三种模式，并且 --auto_stream=saving 是默认设置。
--call_assumptions=n -opn 级别 0 (-op0) 指定了模块包含从提供给编译器的源代码外部调用或修改的函数和变量。
级别 1 (-op1) 指定了模块包含从提供给编译器的源代码外部修改的变量，但不使用从源代码外部调用的函数。
级别 2 (-op2) 指定了模块不包含从提供给编译器的源代码外部调用或修改的函数或变量（默认值）。
级别 3 (-op3) 指定了模块包含从提供给编译器的源代码外部调用的函数，但不使用从源代码外部修改的变量。		 节 4.4.1
--disable_inlining 防止发生任何内联。 节 3.10
--fp_mode={relaxed|strict} 启用或禁用宽松浮点模式。 节 3.3.3
--fp_reassoc={on|off} 启用或禁用浮点算术的重新关联。 节 3.3.3
--fp_single_precision_constant 使所有未添加后缀的浮点常量都被视为单精度值（而非双精度常量）。 节 3.3.3
--gen_opt_info=n -onn 级别 0 (-on0) 会禁用优化信息文件。
级别 1 (-on2) 会生成优化信息文件。
级别 2 (-on2) 会生成详细的优化信息文件。		 节 4.3.1
--optimizer_interlist -os 交叉列出优化器注释与汇编语句。 节 4.12
--program_level_compile -pm 组合源文件以执行程序级优化。 节 4.4
--src_interlist -s 交叉列出优化器注释（如果可用）和汇编源语句；否则交叉列出 C 语言和汇编源语句。 节 3.3.2
--aliased_variables -ma 通知编译器传递给函数的地址可能会由被调用函数中的别名修改。 节 4.9.1
(1) 注意：机器专用运行时选项（参阅表 3-12）也会影响优化。
表 3-4 调试选项
选项 别名 效果 段
--symdebug:dwarf -g 默认行为。启用符号调试。调试信息的生成不会影响优化。因此，默认情况下会生成调试信息。 节 3.3.6
节 4.13
--symdebug:dwarf_version=3|4 指定 DWARF 格式版本。默认版本为 4。 节 3.3.6
--symdebug:none 禁用所有符号调试。 节 3.3.6
节 4.13
表 3-5 Include 选项
选项 别名 效果 段
--include_path=directory -I 将指定的目录添加到 #include 搜索路径。 节 3.5.2.1
--preinclude=filename 在编译开始时包含 filename。 节 3.3.3
表 3-6 控制选项
选项 别名 效果 段
--compile_only -c 禁用链接（否定 --run_linker）。 节 11.1.3
--help -h 打印（在标准输出设备上）编译器理解的选项的说明。 节 3.3.2
--run_linker -z 导致从编译器命令行调用链接器。 节 3.3.2
--skip_assembler -n 编译 C/C++ 源文件，从而生成汇编语言输出文件。汇编器不会运行，也不会生成目标文件。 节 3.3.2
--keep_asm -k 保留汇编语言 (.asm) 文件。
表 3-7 语言选项
选项 别名 效果 段
--c89 根据 ISO C89 标准处理 C 文件。 节 5.12
--c99 根据 ISO C99 标准处理 C 文件。 节 5.12
--c11 根据 ISO C11 标准处理 C 文件。 节 5.12
--c++14 根据 ISO C++14 标准处理 C++ 文件。 节 5.12
--cpp_default -fg 将所有带有 C 扩展名的源文件作为 C++ 源文件处理。 节 3.3.8
--exceptions 启用 C++ 异常处理。 节 5.6
--extern_c_can_throw 允许外部 C 函数传播异常。 --
--float_operations_allowed
={none|all|32|64}		 限制允许的浮点运算类型。 节 3.3.3
--pending_instantiations=# 指定在任何给定时间内可能正在进行的模板实例化的数量。使用 0 指定一个不受限制的数字。 节 3.3.4
--printf_support={nofloat|full|
minimal}		 支持更小、有限版本的 printf 函数系列（sprintf、fprintf 等）和 scanf 函数系列（sscanf、fscanf 等）运行时支持函数。 节 3.3.3
--relaxed_ansi -pr 启用宽松模式；忽略严格的 ISO 违规。默认设置为 on。要禁用此模式，请使用 --strict_ansi 选项。 节 5.12.3
--strict_ansi -ps 启用严格的 ANSI/ISO 模式（适用于 C/C++，不适用于 K&R C）。在此模式下，禁用与 ANSI/ISO C/C++ 冲突的语言扩展。在严格的 ANSI/ISO 模式下，大多数 ANSI/ISO 违规都会报告为错误。被视为酌情处理的违规行为可能会报告为警告。 节 5.12.3
--vectypes={on|off} 启用对 TI 矢量数据类型的支持。默认为 on。 节 5.3.2
表 3-8 解析器预处理选项
选项 别名 效果 段
--preproc_dependency[=filename] -ppd 仅执行预处理，但不写入预处理的输出，而是写入适合于输入到标准 make 实用程序的依赖行列表。 节 3.5.8
--preproc_includes[=filename] -ppi 仅执行预处理，但不写入预处理的输出，而是写入 #include 指令中包含的文件列表。 节 3.5.9
--preproc_macros[=filename] -ppm 仅执行预处理。将预定义和用户定义的宏列表写入与输入同名但扩展名为 .pp 的文件。 节 3.5.10
--preproc_only -ppo 仅执行预处理。将预处理的输出写入与输入同名但扩展名为 .pp 的文件。 节 3.5.4
--preproc_with_comment -ppc 仅执行预处理。将预处理的输出（保留注释）写入与输入同名但扩展名为 .pp 的文件。 节 3.5.6
--preproc_with_compile -ppa 使用任何通常会禁用编译的 -pp<x> 选项在预处理后继续编译。 节 3.5.5
--preproc_with_line -ppl 仅执行预处理。将带有行控制信息（#line 指令）的预处理的输出写入与输入同名但扩展名为 .pp 的文件。 节 3.5.7
表 3-9 预定义宏选项
选项 别名 效果 段
--define=name[=def] -D 预定义 name。 节 3.3.2
--undefine=name -U 未定义 name。 节 3.3.2
表 3-10 诊断消息选项
选项 别名 效果 段
--compiler_revision 打印出编译器发布版本并退出。 --
--diag_error=num -pdse 将由 num 标识的诊断分类为错误。 节 3.7.1
--diag_remark=num -pdsr 将由 num 标识的诊断分类为备注。 节 3.7.1
--diag_suppress=num -pds 抑制由 num 标识的诊断。 节 3.7.1
--diag_warning=num -pdsw 将由 num 标识的诊断分类为警告。 节 3.7.1
--diag_wrap={on|off} 使诊断消息换行（默认为 on）。请注意，此命令行选项不能在 Code Composer Studio IDE 中使用。
--display_error_number -pden 显示诊断的标识符及其文本。请注意，此命令行选项不能在 Code Composer Studio IDE 中使用。 节 3.7.1
--emit_warnings_as_errors -pdew 将警告视为错误。 节 3.7.1
--issue_remarks -pdr 发出备注（非严重警告）。 节 3.7.1
--no_warnings -pdw 抑制诊断警告（仍会发出错误）。 节 3.7.1
--quiet -q 抑制进度消息（静默）。 --
--set_error_limit=num -pdel 将错误限制设置为 num。在达到此错误数量后，编译器放弃编译。（默认为 100。） 节 3.7.1
--super_quiet -qq 超级静默模式。 --
--tool_version -version 示每个工具的版本号。 --
--verbose 显示横幅和函数进度信息。 --
--verbose_diagnostics -pdv 提供详细的诊断消息，以自动换行的方式显示原始源代码。请注意，此命令行选项不能在 Code Composer Studio IDE 中使用。 节 3.7.1
--write_diagnostics_file -pdf 生成诊断消息信息文件。编译器唯一选项。请注意，此命令行选项不能在 Code Composer Studio IDE 中使用。 节 3.7.1
表 3-11 补充信息选项
选项 别名 效果 段
--gen_preprocessor_listing -pl 生成原始列表文件 (.rl)。 节 3.9
--section_sizes={on|off} 生成段大小信息，包括含可执行代码和常量、常量或初始化数据（全局和静态变量）以及未初始化数据的段的大小。（如果此选项未包含在命令行中，则默认为 off。如果使用此选项但未指定值，则默认为 on。） 节 3.7.1
表 3-12 运行时模型选项
选项 别名 效果 段
--common={on|off} 设置为 on 时，未初始化的文件范围变量作为通用符号发出。设置为 off 时，不会创建通用符号。 节 3.3.4
--debug_software_pipeline -mw 生成详细的软件流水线报告。 节 4.7.2
--disable_software_pipeline -mu 关闭软件流水线。 节 4.7.1
--fp_not_associative -mc 阻止对关联浮点运算进行重新排序。 节 4.10
--gen_data_subsections={on|off} 将所有聚合数据（数组、结构和联合体）放入子段中。这使得链接器可以更好地控制在最终链接步骤期间删除未使用的数据。有关默认设置的详细信息，请参阅右侧的链接。 节 11.2.3
--gen_func_subsections={on|off} -mo 将每个函数放在目标文件的一个单独子段中。如果未使用此选项，则默认为 off。有关默认设置的详细信息，请参阅右侧的链接。 节 11.2.2
--ramfunc={on|off} 如果设置为 on，则表示每个函数都将从 RAM 运行。函数将被放置在 RAM 中，并针对 RAM 执行进行优化。等效于在转换单元的所有函数中指定 __attribute__((ram_func))。 节 3.3.4
表 3-13 入口/出口挂钩选项
选项 别名 效果 段
--entry_hook[=name] 启用入口挂钩。 节 3.13
--entry_parm={none|name|
address}		 将函数的参数指定给 --entry_hook 选项。 节 3.13
--exit_hook[=name] 启用出口挂钩。 节 3.13
--exit_parm={none|name|address} 将函数的参数指定给 --exit_hook 选项。 节 3.13
--remove_hooks_when_inlining 删除自动内联函数的入口/出口挂钩。 节 3.13
表 3-14 汇编选项
选项 别名 效果 段
--c_src_interlist -ss 交叉列出 C 源代码和汇编语句。 节 3.11
节 4.12
表 3-15 文件类型说明符选项
选项 别名 效果 段
--asm_file=filename -fa 不管其扩展名为何，都将 filename 标识为汇编源文件。默认情况下，编译器和汇编器将 .asm 文件视为汇编源文件。 节 3.3.8
--c_file=filename -fc 不管其扩展名为何，都将 filename 标识为 C 源文件。默认情况下，编译器将 .c 文件视为 C 源文件。 节 3.3.8
--cpp_file=filename -fp 不管其扩展名为何，都将 filename 标识为 C++ 文件。默认情况下，编译器将 .C、.cpp、.cc 和 .cxx 文件视为 C++ 文件。 节 3.3.8
--obj_file=filename -fo 不管其扩展名为何，都将 filename 标识为目标代码文件。默认情况下，编译器和链接器将 .obj 文件视为目标代码文件，包括 *.c.obj 和 *.cpp.obj 文件。 节 3.3.8
表 3-16 目录说明符选项
选项 别名 效果 段
--asm_directory=directory -fs 指定汇编文件目录。默认情况下，编译器使用当前目录。 节 3.3.11
--obj_directory=directory -fr 指定目标文件目录。默认情况下，编译器使用当前目录。 节 3.3.11
--output_file=filename -fe 指定编译输出文件名；可以覆盖 --obj_directory。 节 3.3.11
--pp_directory=dir 指定预处理器文件目录。默认情况下，编译器使用当前目录。 节 3.3.11
--temp_directory=directory -ft 指定临时文件目录。默认情况下，编译器使用当前目录。 节 3.3.11
表 3-17 默认文件扩展名选项
选项 别名 效果 段
--asm_extension=[.]extension -ea 设置汇编源文件的默认扩展名。 节 3.3.10
--c_extension=[.]extension -ec 设置 C 源文件的默认扩展名。 节 3.3.10
--cpp_extension=[.]extension -ep 设置 C++ 源文件的默认扩展名。 节 3.3.10
--listing_extension=[.]extension -es 设置列表文件的默认扩展名。 节 3.3.10
--obj_extension=[.]extension -eo 设置目标文件的默认扩展名。 节 3.3.10
表 3-18 命令文件选项
选项 别名 效果 段
--cmd_file=filename -@ 将文件内容解释为命令行的扩展。可以使用多个 -@ 实例。 节 3.3.2
表 3-19 性能顾问选项
选项 别名 效果 段
--advice:performance[={all|none}] 生成编译器优化建议。默认为 all。 节 4.11
--advice:performance_file={stdout|
    stderr|user_specified_filename}		 指定将建议写入 stdout、stderr 或文件。 节 4.11
--advice:performance_dir=
    {user_specified_directory_name}		 指定在命名目录中创建建议文件。 节 4.11