米6体育平台手机版

ZHCU875Z August 2001 – October 2023 SM320F28335-EP

1
请先阅读
1. 关于本手册
2. 如何使用本手册
3. 命名规则
4. 米6体育平台手机版_好二三四 (TI) 提供的相关文档
5. 商标
1 软件开发工具简介
1. 1.1 软件开发工具概述
2. 1.2 工具说明
2 目标模块简介
1. 2.1 目标文件格式规范
2. 2.2 可执行目标文件
3. 2.3 段简介
  1. 2.3.1 特殊段名
4. 2.4 汇编器如何处理段
5. 2.5 链接器如何处理段
  1. 2.5.1 合并输入段
  2. 2.5.2 放置段
6. 2.6 符号
7. 2.7 符号重定位
  1. 2.7.1 具有多个可重定位符号的表达式（仅限 COFF）
8. 2.8 加载程序
3 程序加载和运行
1. 3.1 负载
  1. 3.1.1 加载和运行地址
  2. 3.1.2 引导加载
2. 3.2 入口点
3. 3.3 运行时初始化
4. 3.4 main 的参数
5. 3.5 运行时重定位
6. 3.6 其他信息
4 汇编器说明
1. 4.1 汇编器概述
2. 4.2 汇编器在软件开发流程中的作用
3. 4.3 调用汇编器
4. 4.4 控制应用二进制接口
5. 4.5 指定用于汇编器输入的备用目录
  1. 4.5.1 使用 --include_path 汇编器选项
  2. 4.5.2 使用 C2000_A_DIR 环境变量
6. 4.6 源语句格式
7. 4.7 字面常量
8. 4.8 汇编器符号
9. 4.9 表达式
10. 4.10 内置函数和运算符
  1. 4.10.1 内置数学和三角函数
11. 4.11 TMS320C28x 汇编器扩展
12. 4.12 源程序列表
13. 4.13 调试汇编源文件
14. 4.14 交叉引用列表
15. 4.15 智能编码
16. 4.16 流水线冲突检测
5 汇编器指令
1. 5.1 指令摘要
2. 5.2 用于定义段的指令
3. 5.3 用于初始化值的指令
4. 5.4 执行对齐和保留空间的指令
5. 5.5 用于设置输出列表格式的指令
6. 5.6 用于引用其他文件的指令
7. 5.7 用于启用条件汇编的指令
8. 5.8 用于定义联合体或结构体类型的指令
9. 5.9 用于定义枚举类型的指令
10. 5.10 在汇编时用于定义符号的指令
11. 5.11 其他命令
12. 5.12 指令参考
  1. .align
  2. .asg/.define/.eval
  3. .asmfunc/.endasmfunc
  4. .bits
  5. .bss
  6. .byte/.ubyte/.char/.uchar
  7. .cdecls
  8. .clink
  9. .common
  10. .copy/.include
  11. .cstruct/.cunion/.endstruct/.endunion/.tag
  12. .data
  13. .drlist/.drnolist
  14. .elfsym
  15. .emsg/.mmsg/.wmsg
  16. .end
  17. .fclist/.fcnolist
  18. .field
  19. .float/.xfloat/.xldouble
  20. .global/.def/.ref
  21. .group/.gmember/.endgroup
  22. .if/.elseif/.else/.endif
  23. .int/.unint/.word/.uword
  24. .label
  25. .length/.width
  26. .list/.nolist
  27. .long/.ulong/.xlong
  28. .loop/.endloop/.break
  29. .macro/.endm
  30. .mlib
  31. .mlist/.mnolist
  32. .newblock
  33. .option
  34. .page
  35. .retain/.retainrefs
  36. .sblock
  37. .sect
  38. .set
  39. .space/.bes
  40. .sslist/.ssnolist
  41. .string/.cstring/.pstring
  42. .struct/.endstruct/.tag
  43. .symdepend
  44. .tab
  45. .text
  46. .title
  47. .unasg/.undefine
  48. .union/.endunion/.tag
  49. .usect
  50. .var
  51. .weak
6 宏语言说明
1. 6.1 使用宏
2. 6.2 定义宏
3. 6.3 宏参数/替代符号
4. 6.4 宏库
5. 6.5 在宏中使用条件汇编
6. 6.6 在宏中使用标签
7. 6.7 在宏中生成消息
8. 6.8 使用指令设置输出列表的格式
9. 6.9 使用递归和嵌套宏
10. 6.10 宏指令摘要
7 归档器说明
1. 7.1 归档器概述
2. 7.2 归档器在软件开发流程中的作用
3. 7.3 调用归档器
4. 7.4 归档器示例
5. 7.5 库信息归档器说明
8 链接器说明
1. 8.1 链接器概述
2. 8.2 链接器在软件开发流程中的作用
3. 8.3 调用链接器
4. 8.4 链接器选项
5. 8.5 链接器命令文件
6. 8.6 链接器符号
7. 8.7 默认放置算法
  1. 8.7.1 分配算法如何创建输出段
  2. 8.7.2 减少存储器碎片
8. 8.8 使用由链接器生成的复制表
9. 8.9 由链接器生成的 CRC 表和存储器范围的 CRC
10. 8.10 部分（增量）链接
11. 8.11 链接 C/C++ 代码
12. 8.12 链接器示例
9 绝对列表器说明
1. 9.1 生成绝对列表
2. 9.2 调用绝对列表器
3. 9.3 绝对列表器示例
10交叉参考列表器说明
1. 10.1 生成交叉参考列表
2. 10.2 调用交叉参考列表器
3. 10.3 交叉参考列表示例
11目标文件实用程序
1. 11.1 调用目标文件显示实用程序
2. 11.2 调用反汇编器
3. 11.3 调用名称实用程序
4. 11.4 调用符号去除实用程序
12十六进制转换实用程序说明
1. 12.1 软件开发流程中十六进制转换实用程序的作用
2. 12.2 调用十六进制转换实用程序
  1. 12.2.1 从命令行调用十六进制转换实用程序
  2. 12.2.2 使用命令文件调用十六进制转换实用程序
3. 12.3 理解存储器宽度
4. 12.4 ROMS 指令
  1. 12.4.1 何时使用 ROMS 指令
  2. 12.4.2 ROMS 指令的示例
5. 12.5 SECTIONS 指令
6. 12.6 加载映像格式（--load_image 选项）
  1. 12.6.1 加载映像段形成
  2. 12.6.2 加载映像特性
7. 12.7 排除指定段
8. 12.8 分配输出文件名
9. 12.9 映像模式和 --fill 选项
10. 12.10 数组输出格式
11. 12.11 为片上引导加载程序编译引导表
12. 12.12 在 TMS320F2838x 器件上使用安全闪存引导功能
13. 12.13 控制 ROM 器件地址
14. 12.14 控制十六进制转换实用程序诊断
15. 12.15 目标格式说明
16. 12.16 十六进制转换实用程序错误消息
13与汇编源代码共享 C/C++ 头文件
1. 13.1 .cdecls 指令概述
2. 13.2 C/C++ 转换注意事项
3. 13.3 C++ 专有转换注意事项
4. 13.4 汇编器特殊支持
A 符号调试指令
1. A.1 DWARF 调试格式
2. A.2 调试指令语法
B XML 链接信息文件说明
1. B.1 XML 信息文件元素类型
2. B.2 文档元素
  1. B.2.1 标头元素
  2. B.2.2 输入文件列表
  3. B.2.3 对象组件列表
  4. B.2.4 逻辑组列表
  5. B.2.5 放置映射
  6. B.2.6 符号表
C CRC 参考设计
1. C.1 编译指令
2. C.2 参考 CRC 计算例程
  1. C.2.1 CRC 计算函数的参考设计：ref_crc.c
3. C.3 由链接器生成的复制表和 CRC 表
  1. C.3.1 示例应用的 main 例程：main.c
  2. C.3.2 检查 CRC 值：check_crc.c
  3. C.3.3 任务 1 例程：task1.c
  4. C.3.4 任务 2 例程：task2.c
  5. C.3.5 任务 3 例程：task3.c
  6. C.3.6 示例 1 命令文件：ex1.cmd（用于 COFF）
D 术语表
1. D.1 术语
E 修订历史记录

8.4.17.2 指定备用库目录（C2000_C_DIR 环境变量）

环境变量是由您定义并为其分配字符串的系统符号。链接器使用名为 C2000_C_DIR 的环境变量来指定包含对象库的备用目录。分配环境变量的命令语法是：

操作系统	输入
UNIX (Bourne shell)	C2000_C_DIR="pathname₁; pathname₂; ..."; export C2000_C_DIR
Windows	set C2000_C_DIR= pathname₁ ; pathname₂ ; ...

pathnames 是包含输入文件的目录。在命令行或命令文件中使用 --library 链接器选项可告知链接器要搜索哪个库或链接器命令文件。路径名必须遵循以下约束条件：

路径名必须用分号分隔。
路径开头或结尾的空格或制表符将被忽略。例如，下面的分号前后的空格被忽略：
```
    set C2000_C_DIR= c:\path\one\to\tools ; c:\path\two\to\tools
```
路径中允许使用空格和制表符来适应包含空格的 Windows 目录。例如，下述路径名是有效的：
```
    set C2000_C_DIR=c:\first path\to\tools;d:\second path\to\tools
```

在以下示例中，假设两个名为 r.lib 和 lib2.lib 的存档库位于 ld 和 ld2 目录中。下表显示了如何设置环境变量，以及如何在链接期间使用这两个库。请根据操作系统选择相应的行：

操作系统调用命令

UNIX (Bourne shell)

操作系统	调用命令
UNIX (Bourne shell)	`C2000_C_DIR="/ld ;/ld2"; export C2000_C_DIR; cl2000 --run_linker f1.c.obj f2.c.obj --library=r.lib --library=lib2.lib`
Windows	`C2000_C_DIR=\ld;\ld2 cl2000 --run linker f1.c.obj f2.c.obj --library=r.lib --library=lib2.lib`

C2000_C_DIR="/ld ;/ld2"; export C2000_C_DIR; 
cl2000 --run_linker f1.c.obj f2.c.obj --library=r.lib --library=lib2.lib

Windows

C2000_C_DIR=\ld;\ld2
cl2000 --run linker f1.c.obj f2.c.obj --library=r.lib --library=lib2.lib

环境变量保持设置状态，直到您重新启动系统或通过输入以下命令来重置变量：

操作系统	输入
UNIX (Bourne shell)	`unset C2000_C_DIR`
Windows	`set C2000_C_DIR=`

汇编器使用名为 C2000_A_DIR 的环境变量来指定包含复制文件/头文件或宏库的备用目录。如果未设置 C2000_C_DIR，则链接器会在使用 C2000_A_DIR 指定的目录中搜索对象库。有关 C2000_A_DIR 的信息，请参阅节 4.5.2。有关对象库的更多信息，请参阅节 8.6.6。