ZHCADC3B February   2019  – October 2023

 

  1.   1
  2. 简介
    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. 数据表示
    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. 调用约定
    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. 数据分配和寻址
    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. 代码分配和寻址
    1. 5.1 计算代码标签的地址
    2. 5.2 调用
      1. 5.2.1 直接 调用
      2. 5.2.2 Far Call Trampoline
      3. 5.2.3 间接调用
  7. 辅助函数 API
    1. 6.1 浮点行为
    2. 6.2 C 辅助函数 API
    3. 6.3 C99 的浮点辅助函数
  8. 标准 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. 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. 异常处理
    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

位字段

C28x EABI 采用来自 IA64 C++ ABI 的位字段布局。除非明确指出,否则以下说明与该标准一致。

位字段的声明类型是出现在源代码中的类型。为了保存位字段的值,C 和 C++ 标准允许实现分配任何大得足以容纳位字段的可寻址存储单元,这不需要与声明类型相关。可寻址存储单元通常称为容器类型,我们在本文档中也这样称呼它。容器类型是位字段压缩和对齐方式的主要决定因素。

为了提高效率,编译器可以访问类型与声明类型或容器类型不匹配的位字段。声明类型和容器类型被严格用于确定位字段压缩和对齐。用于实际加载位字段的类型是访问类型。它可以是较窄的类型,根据位字段的大小和偏移量计算得出。例如,在下面的示例中,容器类型为 32 位,但位字段将使用 16 位访问加载:

struct S 
    { 
        long :16; 
        long bf:16; 
    };

C89、C99 和 C++语言标准对于声明类型有不同的要求:

C89 int、unsigned int、signed int
C99 int、unsigned int、signed int、_Bool 或“其他一些实现定义类型”
C++ 任何整型或枚举类型,包括 bool

严格 C++ 中没有 long long 类型,但由于 C99 包含该类型,C++ 编译器通常支持该类型作为扩展。C99 标准不要求实现支持位字段的 long 或 long long 声明类型,但由于 C++ 允许这种实现,因此 C 编译器也支持这种类型的情况并不少见。

位字段的值完全包含在其容器中,不包含任何填充位。容器根据其类型正确对齐。包含字段的结构对齐方式受到容器对齐方式的影响,影响方式与该类型的成员对象相同。这也适用于未命名字段,这与 IA64 C++ ABI 不同。容器可以包含其他字段或对象,并且可以与其他容器重叠,但为任何一个字段保留的位,包括用于超大字段的填充位,绝不会与另一个字段的位重叠。

C28x EABI 中,位字段的容器类型是其声明类型,但有一个例外。C++ 允许所谓的超大位字段,这些字段的声明大小大于声明类型。在这种情况下,容器是不大于字段的声明大小的最大的整型。

布局算法保持下一个可用位,这是分配位字段的起点。布局算法中的步骤如下:

  1. 如前面所述,确定容器类型 T。
  2. 假设 C 是包含下一个可用位的 T 类型正确对齐的容器。C 可能与以前分配的容器重叠。
  3. 如果可以在 C 中分配该字段,则从下一个可用位开始执行分配。
  4. 否则,在下一个正确对齐的地址分配新的容器,并将该字段分配到该容器。
  5. 增加位字段的大小,包括超大字段的填充位在内,以确定下一个可用位。

在小端字节序模式下,容器从 LSB 向 MSB 填充。C28x 仅使用小端字节序模式。

零长度位字段强制结构的以下成员对齐到与声明类型对应的下一个对齐边界,并影响结构对齐。

C28x EABI 将 plain int 的声明类型视为 signed int