首页/指令库/VCOMPRESS-VM

VCOMPRESS.VM

RISC-V VCOMPRESS.VM 指令详解

指令手册R-type

按 vs1 选择掩码保序压缩 vs2 元素到 vd 起始位置。

指令语法

vcompress.vm vd, vs2, vs1

操作数说明

vd：目标向量寄存器组。

vs2/vs1 或标量源：按指令后缀 .vv/.vx/.vi/.vf 决定来源。

vm：若语法包含 vm，vm=0 使用 v0 作为执行掩码，vm=1 为未掩码。

V向量重排/索引置换

指令行为说明

VCOMPRESS.VM 使用显式 vs1 掩码选择 vs2 中的元素，并按原顺序从 vd[0] 开始连续写入；它编码为未掩码指令，压缩结果之后的目标元素属于尾部元素。

VCOMPRESS.VM 指令解析与执行动画

从 OP-V 编码字段开始，展示 VCOMPRESS 如何按显式 vs1 选择掩码保序压缩 vs2 元素，并从 vd[0] 开始连续写入。

输入的指令

vcompress.vm

vd使用 v0-v31vs2使用 v0-v31vs1选择掩码寄存器 v0-v31

固定未掩码编码，不是语法操作数

VLVLMAXSEWvs2 elements需要 VLMAX=16 个源元素；只显示 vl=8 个目标 body lane

立即数值

0 -> 0x0000

5-bit signed imm 符号扩展到 SEW

vs1 selection bitsvs1 显式选择掩码 bit 串

OP-V encodingvcompress.vm

funct6

010111

vs2

01000

vs1

00000

funct3

010

00100

opcode

1010111

lane

0x0002

0x0007

0x000c

0x0011

0x0016

0x001b

0x0020

0x0025

pack

vs1

...

tail

当前步骤

显示 OP-V 32 位编码字段

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

动画只展示官方 V 扩展定义的 ISA 可见关系：OP-V 字段解析、活动元素读取、元素索引/压缩/选择/移动重排整数掩码压缩、边界/选择规则和 vd 写回；不模拟流水线、缓存或执行时延。

快速理解与检索要点

vcompress.vm 对 vl 范围内 vs1=1 的源 lane 做稳定压缩：第 1 个选中元素写 vd[0]，第 2 个写 vd[1]，依此类推。

OP-V 编码中 funct6=010111、funct3=010，vm 字段为 1。

vs1 是选择掩码操作数；本指令没有单独执行掩码。

压缩写回之后的目标元素属于 tail，由 vtype.vta 策略处理。

vd 与 vs2 或 vs1 重叠的编码保留。

官方规范要求 vcompress.vm 在 vstart 非零时触发非法指令异常。

RISC-V Unprivileged ISA Manual：V Standard Extension for Vector Operations

向量执行上下文

阅读 VCOMPRESS.VM 时，不要只看助记符。官方 V 扩展语义还依赖当前 vl、vtype 和掩码状态。后缀和操作数形式决定源操作数来自向量、标量还是立即数。

先看 vl

当前 vl 决定 body 元素数量。典型代码会先执行 vsetvli、vsetivli 或 vsetvl，再执行本页指令。

再看 vtype

当前 vtype 提供 SEW、LMUL、tail policy 和 mask policy；这些规则影响元素宽度、寄存器组大小以及非活动/尾部目标元素。

最后看 vm/v0

带 vm 的普通向量指令在 vm=0 时用 v0 作为执行掩码，vm=1 表示未掩码。VMERGE 等少数形式会把 v0 当作数据选择输入。

官方来源：RISC-V V Standard Extension for Vector Operations

常见使用场景

稀疏数据压缩

结合 «vsetvli t0, a0, e32, m1, ta, ma vmsgt.vi v0, v8, 10 vcompress.vm v12, v8, v0» 等实际代码理解该场景。

流式压缩

结合 «vsetvli t0, a0, e32, m1, ta, ma vmsgt.vi v0, v8, 10 vcompress.vm v12, v8, v0» 等实际代码理解该场景。

使用前检查清单

语法检查

确认当前指令格式为 R-type。
确认操作数排列顺序与示例一致。

语义检查

确认目标寄存器用途和调用约定兼容。
确认该指令不是伪指令展开后的底层形式。

容易混淆 / 常见误区

vs1 是显式选择掩码，不是额外的 v0.t 执行掩码。

写入数量等于 vl 范围内 vs1 置 1 位的个数。

压缩结果之后的目标元素是尾部元素，不能假定保留旧值。

vd 目标寄存器组不能与 vs2 源向量寄存器组或 vs1 源 mask 寄存器重叠。

若 vstart 非零，vcompress.vm 会触发 illegal-instruction exception，并报告 vstart=0。

常见问题

vcompress.vm 会把未选中的元素写成 0 吗？

不会这样定义。未选中源元素不进入连续压缩结果；压缩结果之后的目标元素属于尾部元素，受 vtype.vta 策略影响。