ZHCADC3B February   2019  – October 2023

 

  1.   1
  2. 1 简介
    1. 1.1  ABI - C28x
    2. 1.2  范围
    3. 1.3  ABI 变体
    4. 1.4  工具链和互操作性
    5. 1.5  库
    6. 1.6  目标文件的类型
    7. 1.7  段
    8. 1.8  C28x 架构概述
    9. 1.9  C28x 存储器模型
    10. 1.10 参考文档
    11. 1.11 代码片段表示法
  3. 2 数据表示
    1. 2.1 基本类型
    2. 2.2 寄存器中的数据
    3. 2.3 存储器中的数据
    4. 2.4 指针类型
    5. 2.5 复数类型
    6. 2.6 结构体和联合体
    7. 2.7 数组
    8. 2.8 位字段
      1. 2.8.1 易失性位字段
    9. 2.9 枚举类型
  4. 3 调用约定
    1. 3.1 调用和返回
      1. 3.1.1 调用指令
        1. 3.1.1.1 间接调用
        2. 3.1.1.2 直接调用
      2. 3.1.2 返回指令
      3. 3.1.3 流水线约定
      4. 3.1.4 弱函数
    2. 3.2 寄存器惯例
      1. 3.2.1 实参寄存器
      2. 3.2.2 被调用者保存的寄存器
    3. 3.3 实参传递
      1. 3.3.1 传递 16 位实参的
      2. 3.3.2 传递更长实参的
      3. 3.3.3 C++ 实参传递
      4. 3.3.4 传递结构体和联合体
      5. 3.3.5 未在寄存器中传递的实参的栈布局
      6. 3.3.6 帧指针
    4. 3.4 返回值
    5. 3.5 通过引用传递并返回的结构体和联合体
    6. 3.6 编译器辅助函数的约定
    7. 3.7 逻辑程序和收尾程序辅助函数
    8. 3.8 已见函数的暂存寄存器
    9. 3.9 中断函数
  5. 4 数据分配和寻址
    1. 4.1 数据段和数据区段
    2. 4.2 数据分块
    3. 4.3 寻址模式
    4. 4.4 静态数据的分配和寻址
      1. 4.4.1 静态数据的寻址方法
      2. 4.4.2 静态数据的放置约定
        1. 4.4.2.1 寻址的抽象约定
      3. 4.4.3 静态数据的初始化
    5. 4.5 自动变量
    6. 4.6 帧布局
      1. 4.6.1 栈对齐
      2. 4.6.2 寄存器保存顺序
    7. 4.7 堆分配对象
  6. 5 代码分配和寻址
    1. 5.1 计算代码标签的地址
    2. 5.2 调用
      1. 5.2.1 直接 调用
      2. 5.2.2 Far Call Trampoline
      3. 5.2.3 间接调用
  7. 6 辅助函数 API
    1. 6.1 浮点行为
    2. 6.2 C 辅助函数 API
    3. 6.3 C99 的浮点辅助函数
  8. 7 标准 C 库 API
    1. 7.1  关于标准 C 库
    2. 7.2  保留符号
    3. 7.3  <assert.h> 实现
    4. 7.4  <complex.h> 实现
    5. 7.5  <ctype.h> 实现
    6. 7.6  <errno.h> 实现
    7. 7.7  <float.h> 实现
    8. 7.8  <inttypes.h> 实现
    9. 7.9  <iso646.h> 实现
    10. 7.10 <limits.h> 实现
    11. 7.11 <locale.h> 实现
    12. 7.12 <math.h> 实现
    13. 7.13 <setjmp.h> 实现
    14. 7.14 <signal.h> 实现
    15. 7.15 <stdarg.h> 实现
    16. 7.16 <stdbool.h> 实现
    17. 7.17 <stddef.h> 实现
    18. 7.18 <stdint.h> 实现
    19. 7.19 <stdio.h> 实现
    20. 7.20 <stdlib.h> 实现
    21. 7.21 <string.h> 实现
    22. 7.22 <tgmath.h> 实现
    23. 7.23 <time.h> 实现
    24. 7.24 <wchar.h> 实现
    25. 7.25 <wctype.h> 实现
  9. 8 C++ ABI
    1. 8.1  限制 (GC++ABI 1.2)
    2. 8.2  导出模板 (GC++ABI 1.4.2)
    3. 8.3  数据布局（GC++ABI 第 2 章）
    4. 8.4  初始化保护变量 (GC++ABI 2.8)
    5. 8.5  构造函数返回值 (GC++ABI 3.1.5)
    6. 8.6  一次性构建 API (GC++ABI 3.3.2)
    7. 8.7  控制对象构造顺序 (GC++ ABI 3.3.4)
    8. 8.8  还原器 API (GC++ABI 3.4)
    9. 8.9  静态数据 (GC++ ABI 5.2.2)
    10. 8.10 虚拟表和键函数 (GC++ABI 5.2.3)
    11. 8.11 回溯表位置 (GC++ABI 5.3)
  10. 9 异常处理
    1. 9.1  概述
    2. 9.2  PREL31 编码
    3. 9.3  异常索引表 (EXIDX)
      1. 9.3.1 指向行外 EXTAB 条目的指针
      2. 9.3.2 EXIDX_CANTUNWIND
      3. 9.3.3 内联 EXTAB 条目
    4. 9.4  异常处理指令表 (EXTAB)
      1. 9.4.1 EXTAB 通用模型
      2. 9.4.2 EXTAB 紧凑模型
      3. 9.4.3 个性化例程
    5. 9.5  回溯指令
      1. 9.5.1 通用序列
      2. 9.5.2 字节编码展开指令
    6. 9.6  描述符
      1. 9.6.1 类型标识符编码
      2. 9.6.2 作用域
      3. 9.6.3 Cleanup 描述符
      4. 9.6.4 catch 描述符
      5. 9.6.5 函数异常规范 (FESPEC) 描述符
    7. 9.7  特殊段
    8. 9.8  与非 C++ 代码交互
      1. 9.8.1 EXIDX 条目自动生成
      2. 9.8.2 手工编码的汇编函数
    9. 9.9  与系统功能交互
      1. 9.9.1 共享库
      2. 9.9.2 覆盖块
      3. 9.9.3 中断
    10. 9.10 TI 工具链中的汇编语言运算符
  11. 10DWARF
    1. 10.1 DWARF 寄存器名称
    2. 10.2 调用帧信息
    3. 10.3 供应商名称
    4. 10.4 供应商扩展
  12. 11ELF 目标文件（处理器补充）
    1. 11.1 注册供应商名称
    2. 11.2 ELF 标头
    3. 11.3 段
      1. 11.3.1 段索引
      2. 11.3.2 段类型
      3. 11.3.3 扩展段标头属性
      4. 11.3.4 子段
      5. 11.3.5 特殊段
      6. 11.3.6 段对齐
    4. 11.4 符号表
      1. 11.4.1 符号类型
      2. 11.4.2 通用块符号
      3. 11.4.3 符号名称
      4. 11.4.4 保留符号名称
      5. 11.4.5 映射符号
    5. 11.5 重定位
      1. 11.5.1 重定位类型
        1. 11.5.1.1 绝对重定位
        2. 11.5.1.2 PC 相对重定位
        3. 11.5.1.3 数据段中的重定位
        4. 11.5.1.4 C28x 指令的重定位
        5. 11.5.1.5 其他重定位类型
      2. 11.5.2 重定位操作
      3. 11.5.3 未解析的弱引用的重定位
  13. 12ELF 程序加载和链接（处理器补充）
    1. 12.1 程序标头
      1. 12.1.1 基址
      2. 12.1.2 段内容
      3. 12.1.3 线程局部存储
    2. 12.2 程序加载
  14. 13构建属性
    1. 13.1 关于构建属性
    2. 13.2 C28x ABI 构建属性子段
    3. 13.3 构建属性标签
  15. 14复制表和变量初始化
    1. 14.1 关于复制表
    2. 14.2 复制表格式
    3. 14.3 压缩的数据格式
      1. 14.3.1 RLE
      2. 14.3.2 LZSS 格式
    4. 14.4 变量初始化
  16. 15修订历史记录
    1.     188

9.5.2 字节编码展开指令

个性化例程 PR0、PR1 和 PR2 使用字节编码的指令序列来说明如何展开帧。前几条指令被封装到 EXTAB 第一个字的剩余三个字节中；附加指令被封装到后续字中。最后一个字中未使用的字节由“RET ”指令填充。

尽管指令是字节编码的，但它们始终封装成从 MSB 开始的 32 位字。因此，在小端字节序模式下，第一个展开指令将不会位于最低地址字节。

个性化例程 PR0 最多允许三条展开指令，所有这些指令都存储在第一个 EXTAB 字中。如果有三个以上的展开指令，则必须使用其他个性化例程之一。

GUID-59BA2E98-7DFC-4DAA-A556-3B41DB5F1AFB-low.gif

对于 PR1 和 PR2，位 23-16 编码展开指令的额外 32 位字的数量，该数量可为 0。

GUID-96D09DE5-7B2B-4CAD-8571-4D28DE64F66B-low.gif

表 9-2 总结了展开指令集。表格后面对每条指令进行了更详细的介绍。

表 9-2 堆栈展开指令
编码指令说明
0000 0xxxPOP (XAR1-XAR3) + RET（或者如果 x=0，则只是 RET）
0000 1000 0xxx xxxxPOP (XAR1-XAR3, R4-R7) + RET（或者如果 x=0，则只是 RET）
0000 1yyy yxxx xxxx保留（其中 yyyy 不为 0）
0001 0000无法展开（函数可能捕获但不传播）
0001 0001 xxxx xxxxSP -= (ULEB128 << 1) + 512;范围是 [514, max]
0001 001x保留
0001 01xx保留
0001 1xxx保留
001x xxxx保留
01xx xxxx保留
1xxx xxxxSP -= (xxxxxxx << 1) + 2;范围是 [2, 256]

以下限制适用：

  • 在可能会传播 C++ 异常的 C/C++ 可调用函数中，栈必须始终与 32 位对齐。
  • 程序不能将代码或数据放置在高于 0x80000000 的地址。这样做将产生重定位错误。

所有其他位模式均保留。

以下各段详细说明了展开指令的解释。

POP + RET

POP+RET 指令指定一个位掩码，用于表示由此函数逻辑程序保存的寄存器。这些寄存器必须按顺序弹出，从 XAR1 开始到 XAR3。如果启用 FPU，则按顺序弹出 R4 到 R7。完成后，不再有展开指令。如果位掩码中的位均未设置，则这只是一条 RET 指令。

 

小增量

GUID-567C2F29-289B-4797-A4B2-E4A0F660144A-low.png

k 的值从编码的低 6 位中提取。此指令可以使 SP 递增一个介于 0x8 到 0x200 之间的值，包括边界值。0x208 到 0x400 范围内的增量应该用这些指令中的两个来完成。

 

大增量

GUID-7EECDDED-60B3-4F24-8D34-31300F88DB08-low.png

值 ULEB128 在 8 位操作码之后的字节中进行 ULEB128 编码。此指令可以将 SP 递增 0x408 或更大的值。增量小于 0x408 应使用 1 条或 2 条小增量指令实现。

 

CANTUNWIND

GUID-1F86C2BF-298C-47BD-9849-A06121E58853-low.gif

此指令指示函数不能展开，通常是因为它是中断函数。但是，中断函数仍然可以有 try/catch 代码，因此 EXIDX_CANTUNWIND 不适用。