flat_atomic_swap GPU Native ISA AMD Vector

Flat Memory

flat_atomic_swap

Swap an unsigned 32-bit integer value in the data register with a location in the flat aperture.

Also written as flat_atomic_swap_b32. AMD's machine-readable ISA specification lists this name for the same instruction.

Encoding

Verified bit-level encoding data is not yet available for this instruction. The instruction-format classification below (FLAT) is well-documented and stable; exact per-target opcode/field bit positions have not yet been imported from a verified source.
Format FLAT

Operands

  • VDST
    Written. N/A Data format: Value can be anything. (OPR_VGPR_OR_ACCVGPR, FMT_ANY)
  • ADDR
    Read. N/A Data format: Value can be anything. (OPR_VGPR, FMT_ANY)
  • DATA
    Read. N/A Data format: Value can be anything. (OPR_VGPR_OR_ACCVGPR, FMT_ANY)

In AMD's order, as its machine-readable ISA specification lists them for the ENC_FLAT encoding (AMD CDNA 4).

GFX Target Compatibility

TargetSupport
gfx1100✅ Supported

Related

More in Flat Memory

Reference

AMDGPU / GFX ISA

Description

Swap an unsigned 32-bit integer value in the data register with a location in the flat aperture. Store the original value from flat aperture into a vector register iff the SC0 bit is set.

Semantics

addr = CalcFlatAddr(ADDR.b32, OFFSET.b32); tmp = MEM[addr].b32; MEM[addr].b32 = DATA.b32; RETURN_DATA.b32 = tmp

Example

flat_atomic_swap v[1:2], v2

A real instruction accepted by the LLVM assembler, taken verbatim from LLVM's own AMDGPU MC test suite. Not from an AMD document, and not authored here.

Sources