Home/Instructions/VMERGE-VXM
VMERGE.VXM

RISC-V VMERGE.VXM Instruction Details

Instruction ManualOPIVX

Select element-wise between vs2 and integer scalar rs1 using v0 selection mask bits, writing vd.

Instruction Syntax

vmerge.vxm vd, vs2, rs1, v0
Operand Breakdown
v0[i]=0 selects vs2[i]; v0[i]=1 selects the second source. Fixed vm=0 uses v0 as selection data, and every body element is written.
32-bit OP-V: opcode=1010111, funct6=010111, funct3=100. x[rs1] uses low SEW bits if XLEN>SEW and sign-extension if XLEN<SEW; x0 is zero.
Same-EEW sources/destination may overlap; vd cannot cover v0, and v0 cannot supply both EEW=1 selection bits and SEW data.
Require valid vtype, enabled VS, and supported SEW. VMV instead uses vm=1 and vs2=v0; distinguish it from VMERGE.
Body is vstart≤i<vl; prestart is unchanged, tails follow vta. VL=0 or vstart≥vl updates no destination, including tails. The animation fixes LMUL=m1, VLEN=4096, vstart=0; steps are not processor cycles.
VVector Data MovementMerge/Select

Instruction Behavior

VMERGE.VXM is a RISC-V V vector integer merge instruction. v0.mask[i]=0 selects vs2[i], and v0.mask[i]=1 selects the SEW-width scalar value formed from x[rs1] by the .vx scalar rule.

VMERGE.VXM Decode And Execute Animation

Starts from OP-V encoding fields, then shows how VMERGE uses v0 as selection data: bit 0 selects vs2, bit 1 selects the second source, and every body element is written.

Instruction input
vmerge.vxm
v0
v0
selection-mask data, vm=0

Require valid vtype, enabled VS, and supported SEW. Only body elements are shown; VL=0 updates no destination elements, including tails. Same-EEW sources/destination may overlap. When v0 supplies EEW=1 mask/selection bits, it cannot also supply SEW data or be vd.

Execution Context

The teaching model fixes LMUL=m1 and vstart=0 and shows only body elements in the selected VL. It fixes VLEN=4096, VLMAX=4096/16=256, and assumes support for the selected SEW; equal vector sources require equal elements. VMERGE fixes vm=0; each v0 bit selects one of two sources, every body element executes, and only tails follow vtype.vta.

OP-V encodingvmerge.vxm
funct6
010111
vm
0
vs2
01000
rs1
01011
funct3
100
vd
00100
opcode
1010111
lane
0
1
2
3
4
5
6
7
v8
0x0020
0x0027
0x002e
0x0035
0x003c
0x0043
0x004a
0x0051
select
select
select
select
select
select
select
select
x11
0x0055
0x0055
0x0055
0x0055
0x0055
0x0055
0x0055
0x0055
v0
1
0
1
1
1
0
1
1
v4
...
...
...
...
...
...
...
...
Current step

Show OP-V 32-bit encoding fields

vmerge.vxm uses OP-V encoding. The animation places fixed fields, register fields, vm, and the rs1 field in one encoding strip.

This animation shows only ISA-visible relationships from the official V extension: OP-V field decode, active-element reads, SEW-width integer v0-selected merge, v0 selection data, and vd writeback. It does not model pipelines, caches, or timing.

Quick Understanding & Search Notes

VMERGE.VXM: v0 bit 0 selects vs2; bit 1 selects integer scalar rs1. Every body element receives its selected value.

Body: vstart≤i<vl. Prestart stays unchanged; tails follow vta. VL=0 or vstart≥vl leaves every destination unchanged.
v0[i]=1 selects x[rs1]: use low SEW bits if XLEN>SEW, sign-extend if XLEN<SEW; x0 is zero. v0[i]=0 selects vs2[i].
OP-V: opcode=1010111, funct6=010111, funct3=100, vm=0. VMV instead uses vm=1 and vs2=v0.
Require valid vtype, enabled VS and supported SEW. Same-EEW overlap is legal. vd cannot be v0; v0 cannot supply both SEW data and EEW=1 selection bits.

Vector Execution Context

v0[i]=0 selects vs2[i]; v0[i]=1 selects the second source. Fixed vm=0 uses v0 as selection data, and every body element is written.

32-bit OP-V: opcode=1010111, funct6=010111, funct3=100. x[rs1] uses low SEW bits if XLEN>SEW and sign-extension if XLEN<SEW; x0 is zero.

Same-EEW sources/destination may overlap; vd cannot cover v0, and v0 cannot supply both EEW=1 selection bits and SEW data.

Require valid vtype, enabled VS, and supported SEW. VMV instead uses vm=1 and vs2=v0; distinguish it from VMERGE.

Body is vstart≤i<vl; prestart is unchanged, tails follow vta. VL=0 or vstart≥vl updates no destination, including tails. The animation fixes LMUL=m1, VLEN=4096, vstart=0; steps are not processor cycles.

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

Common Usage Scenarios

Mask Widening

Assume enabled V/VS, supported e32,m1, VLEN≥128, vl=4, vstart=0, ta/ma, and initialized sources; Fixed vm=0 selects at every body element. v4=[10,20,30,40], x11=3, v0.mask=[1,0,1,1] → v8=[3,20,3,3]. Tails are not guaranteed zero; mask destinations are always tail-agnostic.

Conditional Assignment

Assume enabled V/VS, supported e32,m1, VLEN≥128, vl=4, vstart=0, ta/ma, and initialized sources; Fixed vm=0 selects at every body element. v4=[10,20,30,40], x11=3, v0.mask=[1,0,1,1] → v8=[3,20,3,3]. Tails are not guaranteed zero; mask destinations are always tail-agnostic.

Pre-Use Checklist

Syntax Check
  • v0[i]=0 selects vs2[i]; v0[i]=1 selects the second source. Fixed vm=0 uses v0 as selection data, and every body element is written.
  • 32-bit OP-V: opcode=1010111, funct6=010111, funct3=100. x[rs1] uses low SEW bits if XLEN>SEW and sign-extension if XLEN<SEW; x0 is zero.
Semantic Check
  • Same-EEW sources/destination may overlap; vd cannot cover v0, and v0 cannot supply both EEW=1 selection bits and SEW data.
  • Require valid vtype, enabled VS, and supported SEW. VMV instead uses vm=1 and vs2=v0; distinguish it from VMERGE.
  • Body is vstart≤i<vl; prestart is unchanged, tails follow vta. VL=0 or vstart≥vl updates no destination, including tails. The animation fixes LMUL=m1, VLEN=4096, vstart=0; steps are not processor cycles.

Pitfalls / Common Confusions

v0 is selection data, not the ordinary v0.t execution mask.
A v0 bit of 0 selects vs2, and a bit of 1 selects the second source.
VMERGE and VMV share related encoding space, but their semantics are selected merge versus unmasked move.

FAQ

Which source does v0 bit 1 select in VMERGE.VXM?

v0[i]=1 selects integer scalar rs1; v0[i]=0 selects vs2[i].

Is VMERGE an ordinary masked instruction?

No. v0 selects between two sources for every body element; it does not disable execution.