配置寄存器与隐式状态¶

Ascend 910B 指令既使用显式操作数，也使用当前 AI Core 执行上下文中的隐式状态。开发时最容易混淆的是：指令末尾的 Xs 配置字、命名 SPR、MASK/CMPMASK 并不是同一种寄存器接口。

本页只描述 dav-c220-vec 与 dav-c220-cube 工具链可见的开发接口。没有公开字段定义的寄存器只说明用途类别和访问边界，不给出猜测性的位域。

三类配置载体¶

例如：

MOV X3, #0
MOVEMASK MASK[0], X3
MOVEMASK MASK[1], X3
VADD.s16 [X0], [X1], [X2], X3, MASK

这里 X3 同时被用来提供掩码半部和 VADD 配置值，但它本身不是“VADD 配置寄存器”。不同指令对 Xs 的解释不同，不应把某条指令的配置字无条件复用于另一条指令。

命名 SPR 的读写形式¶

通用形式只有寄存器到寄存器的传送：

MOV Xd, NAME       // 读取 NAME
MOV NAME, Xn       // 写入 NAME

配置 SPR 不接受 MOV NAME, #imm。需要常量时先装入 X 寄存器：

MOV X0, #1
MOV CTRL, X0

每个符号分别定义可读方向、可写方向和目标 feature。以下是 910B 两个目标下可直接使用的代表性接口：

“只写”表示当前 c220 汇编语法/代码生成只提供写方向，不表示硬件内部没有可观察状态。反向写成 MOV Xd, FMATRIX 时，名称会进入立即数/标签解析路径，而不是完成 SPR 读取。

可复现的编码样例¶

以下字节按目标文件中的小端顺序书写。X 寄存器编号是编码的一部分，替换寄存器后字节也会变化。

可读取的环境与身份状态¶

下列 getter 在 dav-c220-vec 上会生成单条 MOV Xd, NAME。返回值按 64 位无符号标量承载；具体字段含义应由运行时 ABI 解释。

这些寄存器的写方向会被 c220 汇编器拒绝。它们用于查询当前执行环境，不是内核自行建立线程、地址空间或版本状态的接口。

MOV Xd, BLOCKDIM 可以由 c220 汇编器编码，但当前工具链的 __builtin_cce_get_blockdim() 没有对 dav-c220-vec/dav-c220-cube 开放。需要该值时，应先确认调用约定和部署环境，不要把“汇编器可编码”视为 C builtin 可用的保证。

功能分组¶

同一家族中的寄存器也不保证具有相同访问权限。例如 ST_ATOMIC_CFG 可读写，而 MOV_PAD_VAL 在 c220 Vector 语法中只提供写方向；ACC_VAL 与 CUBE_CTRL_* 也不能仅凭名称套用 MOV NAME, Xn。

bisheng builtin 与生成汇编¶

builtin 能把目标 feature 和寄存器方向纳入前端检查。下面的代码在 dav-c220-vec 上生成对应的单条 MOV：

unsigned long read_ctrl(void) {
    return __builtin_cce_get_ctrl();
}

void write_ctrl(unsigned long value) {
    __builtin_cce_set_ctrl(value);
}

unsigned long read_atomic_config(void) {
    return __builtin_cce_get_st_atomic_cfg();
}

void write_atomic_config(unsigned long value) {
    __builtin_cce_set_st_atomic_cfg(value);
}

MOV X0, CTRL
MOV CTRL, X0
MOV X0, ST_ATOMIC_CFG
MOV ST_ATOMIC_CFG, X0

常用的 c220 写接口包括：

后端还包含面向其他处理器版本的 builtin 名称。调用存在但目标 feature 不匹配时，前端会报告“不支持给定目标特性”；这不是通过声明函数原型可以绕过的普通外部函数错误。

内联汇编访问¶

需要与手写指令放在同一局部序列时，可使用 GNU extended asm 的 "l" 约束：

unsigned long read_ctrl_inline(void) {
    unsigned long value;
    __asm__ volatile("MOV %0, CTRL" : "=l"(value));
    return value;
}

void write_ctrl_inline(unsigned long value) {
    __asm__ volatile(
        "MOV CTRL, %0"
        :
        : "l"(value)
        : "memory");
}

"memory" 只阻止编译器把内存访问跨过该 asm 重排，不会替你生成流水线事件或屏障。若一个配置影响紧随其后的搬运、Vector 或 Cube 指令，最稳妥的做法是把“写配置 + 消费指令”放在同一 asm 块，或者使用 builtin 和 C 可见数据依赖保持顺序。

保存、恢复与作用域¶

命名配置寄存器应视为当前执行上下文的易变状态：

1. 在首次消费前完成写入，不依赖内核入口的偶然初值。
2. 不假设普通函数调用会替你保存 CTRL、FPC、掩码或量化状态。
3. 临时修改可读写寄存器时，先读取旧值，完成操作后恢复；只写寄存器无法采用通用的保存/恢复模式。
4. 不把某个 core/thread 读到的环境状态当作跨 core 共享配置。
5. 修改影响内存或异步流水线的状态时，仍按消费指令要求建立事件或屏障；SPR 写入本身不替代数据依赖同步。

推荐工作流是：先用 builtin 生成一份 -S 汇编，确认目标 CPU、寄存器方向和完整配置序列；再用 -cc1as -show-encoding 固化必须手写的语法。完整名称及编码见 SPR 编码。