TSET_IMG2COL_PADDING

指令示意图

TSET_IMG2COL_PADDING tile operation

简介

从 IMG2COL 配置 Tile 设置 IMG2COL 填充元数据。

数学语义

No direct tensor arithmetic is produced by this instruction. It updates IMG2COL padding control state consumed by subsequent data-movement operations.

汇编语法

PTO-AS 形式：参见 PTO-AS Specification.

Schematic form:

tset_img2col_padding %cfg

AS Level 1 (SSA)

pto.tset_img2col_padding %cfg : !pto.fmatrix_config -> ()

AS Level 2 (DPS)

pto.tset_img2col_padding ins(%cfg : !pto.fmatrix_config) outs()

AS Level 1（SSA）

pto.tset_img2col_padding %cfg

AS Level 2（DPS）

pto.tset_img2col_padding ins(%cfg) outs()

C++ 内建接口

声明于 include/pto/common/pto_instr.hpp:

template <typename ConvTileData, typename... WaitEvents>
PTO_INST RecordEvent TSET_IMG2COL_PADDING(ConvTileData &src, WaitEvents &... events);

template <typename ConvTileData, SetFmatrixMode FmatrixMode = SetFmatrixMode::FMATRIX_A_MANUAL, typename... WaitEvents>
PTO_INST RecordEvent TSET_IMG2COL_PADDING(ConvTileData &src, WaitEvents &... events);

For MEMORY_BASE targets, an overload without SetFmatrixMode is also provided.

约束

  • This instruction is backend-specific and available only for backends that expose IMG2COL configuration state.
  • src must be a valid IMG2COL configuration tile type accepted by the backend implementation.
  • The exact padding fields updated by this instruction are implementation-defined.
  • Use this instruction before dependent TIMG2COL operations in the same execution stream.

示例

#include <pto/pto-inst.hpp>

using namespace pto;

void example_set_img2col_padding(Img2colTileConfig<uint64_t>& cfg) {
  TSET_IMG2COL_PADDING(cfg);
}