首页/指令库/VRGATHER.VI
VRGATHER.VI

RISC-V VRGATHER.VI 指令详解

指令手册OPIVI (OP-V)

按 5 位立即数索引从 vs2 收集同一元素。

指令语法

vrgather.vi vd, vs2, uimm[, v0.t]
操作数说明
语法:vrgather.vi vd, vs2, uimm[, v0.t];省略掩码为 vm=1,给出 v0.t 为 vm=0。32 位 OP-V:opcode=1010111、funct3=011(OPIVI)、funct6=001100。
5 位零扩展 uimm(0..31)作为元素索引;可读取 vl 以外但小于 VLMAX 的源,索引≥VLMAX 返回0。不访问内存。
活动 body 满足 vstart≤i<vl 且掩码开启;inactive/tail 按 vma/vta 保留或取 agnostic,不依赖固定值。vl=0 不更新任何目标元素。
vd 不能与任何源向量寄存器组重叠,否则编码保留;masked vd 不可为 v0,v0 不能同时提供 EEW=1 掩码和 SEW 数据。组起点按 EMUL 对齐,EMUL≤8。
要求 V 1.0、启用向量状态及合法受支持 vtype/SEW。动画固定 m1、vstart=0;VLMAX×SEW 给出当前教学配置的 VLEN。步骤不表示处理器周期。
V向量重排/索引排列操作

指令行为说明

VRGATHER.VI 使用 5 位零扩展立即数作为元素索引,让活动目标元素从 vs2 的同一索引位置读取;索引大于或等于 VLMAX 时结果为 0。

VRGATHER.VI 指令解析与执行动画

从 OP-V 编码字段开始,展示 VRGATHER 如何把第二源作为元素索引,从 vs2[VLMAX] 范围内收集元素;越界索引写 0。

输入的指令
vrgather.vi

要求 V 1.0、启用向量状态及合法受支持 vtype/SEW;固定 LMUL=m1、vstart=0。本教学配置 VLEN=VLMAX×SEW=256;切换 SEW/VLMAX 表示切换配置。源可读取 vl 以外但小于 VLMAX 的元素,索引≥VLMAX 返回0;vd 不可与任何源重叠。索引按无符号解释。masked vd 不可为 v0,v0 不可同时提供掩码与 SEW 数据。输入元素为非负位模式;VL=0 不更新目标。只展示 body,不确定 inactive/tail 值;教学步骤不是处理器周期。

执行环境
立即数值
3 -> index 3
5-bit unsigned uimm 零扩展为元素索引,不按 SEW 截断
OP-V encodingvrgather.vi
funct6
001100
vm
0
vs2
01000
uimm
00011
funct3
011
vd
00100
opcode
1010111
lane
0
1
2
3
4
5
6
7
v8
0x0002
0x0007
0x000c
0x0011
0x0016
0x001b
0x0020
0x0025
idx
idx
idx
idx
idx
idx
idx
idx
imm
0x0003
0x0003
0x0003
0x0003
0x0003
0x0003
0x0003
0x0003
v0.t
1
0
1
1
1
0
1
1
v4
...
-
...
...
...
-
...
...
当前步骤

显示 OP-V 32 位编码字段

vrgather.vi 使用 OP-V 编码。动画把固定字段、寄存器字段、vm 和 uimm 字段放在同一条编码带中。

动画展示 OP-V 字段解析、活动元素读取、索引收集、mask 控制和 vd 写回。步骤是教学分解,不表示流水线、缓存或执行时延。

快速理解与检索要点

vrgather.vi 用 5 位零扩展 uimm 作为同一个元素索引,活动 lane 都读取 vs2[uimm];越界索引写 0。

32 位 OP-V:opcode=1010111、funct3=011(OPIVI)、funct6=001100。
uimm 是元素编号,不是字节偏移。
vm 控制 body 元素是否更新。
vd 与 vs2 源/目的寄存器组重叠的编码保留。
索引按无符号解释;可读取 vl 以外但小于 VLMAX 的源元素。inactive/tail 按 vma/vta 处理;vl=0 不更新目标。

向量执行上下文

语法:vrgather.vi vd, vs2, uimm[, v0.t];省略掩码为 vm=1,给出 v0.t 为 vm=0。32 位 OP-V:opcode=1010111、funct3=011(OPIVI)、funct6=001100。

5 位零扩展 uimm(0..31)作为元素索引;可读取 vl 以外但小于 VLMAX 的源,索引≥VLMAX 返回0。不访问内存。

活动 body 满足 vstart≤i<vl 且掩码开启;inactive/tail 按 vma/vta 保留或取 agnostic,不依赖固定值。vl=0 不更新任何目标元素。

vd 不能与任何源向量寄存器组重叠,否则编码保留;masked vd 不可为 v0,v0 不能同时提供 EEW=1 掩码和 SEW 数据。组起点按 EMUL 对齐,EMUL≤8。

要求 V 1.0、启用向量状态及合法受支持 vtype/SEW。动画固定 m1、vstart=0;VLMAX×SEW 给出当前教学配置的 VLEN。步骤不表示处理器周期。

The RISC-V Instruction Set Manual, Volume I: Unprivileged Architecture — Version 20260120, Chapter 31

常见使用场景

寄存器查表

假定 V/VS 已启用、合法 m1、支持 SEW、VLEN=128、vl=4、vstart=0、v0.mask[0..3]=1111,源已初始化。SEW=8, VLMAX=16, v12[3]=40, uimm=3 → v8=[40,40,40,40]。inactive/tail 按 vma/vta;vl=0 不更新目标。

向量元素重排

假定 V/VS 已启用、合法 m1、支持 SEW、VLEN=128、vl=4、vstart=0、v0.mask[0..3]=1111,源已初始化。SEW=8, VLMAX=16, v12[3]=40, uimm=3 → v8=[40,40,40,40]。inactive/tail 按 vma/vta;vl=0 不更新目标。

使用前检查清单

语法检查
  • 语法:vrgather.vi vd, vs2, uimm[, v0.t];省略掩码为 vm=1,给出 v0.t 为 vm=0。32 位 OP-V:opcode=1010111、funct3=011(OPIVI)、funct6=001100。
  • 5 位零扩展 uimm(0..31)作为元素索引;可读取 vl 以外但小于 VLMAX 的源,索引≥VLMAX 返回0。不访问内存。
语义检查
  • 活动 body 满足 vstart≤i<vl 且掩码开启;inactive/tail 按 vma/vta 保留或取 agnostic,不依赖固定值。vl=0 不更新任何目标元素。
  • vd 不能与任何源向量寄存器组重叠,否则编码保留;masked vd 不可为 v0,v0 不能同时提供 EEW=1 掩码和 SEW 数据。组起点按 EMUL 对齐,EMUL≤8。
  • 要求 V 1.0、启用向量状态及合法受支持 vtype/SEW。动画固定 m1、vstart=0;VLMAX×SEW 给出当前教学配置的 VLEN。步骤不表示处理器周期。

容易混淆 / 常见误区

立即数字段是 0..31 的元素索引,不是有符号立即数。
索引 >= VLMAX 时结果为 0。
所有活动 lane 使用同一个立即数索引。
vd 目标寄存器组不能与 vs2 源向量寄存器组重叠。

常见问题

vrgather.vi 的立即数范围是多少?

它使用 5 位零扩展立即数字段,因此动画校验 0..31;若该索引大于或等于当前 VLMAX,则结果元素为 0。