SET_IMG2COL_PADDING¶

指令示意图¶

SET_IMG2COL_PADDING tile operation

简介¶

从 IMG2COL 配置 Tile 设置 IMG2COL 填充元数据（实现定义）。

数学语义¶

该指令不直接产生张量算术结果。它会更新后续数据搬运类操作使用的 IMG2COL 填充控制状态。

C++ 内建接口¶

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

公共包含头为 <pto/pto-inst.hpp>，内部声明位于 pto/common/pto_instr.hpp。

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

该重载按目标后端分别提供：#if defined(PTO_NPU_ARCH_A2A3) || defined(PTO_NPU_ARCH_KIRINX90) 与 #if defined(PTO_NPU_ARCH_A5) || defined(PTO_NPU_ARCH_KIRIN9030) || defined(__CPU_SIM)。

约束¶

该指令属于后端相关能力，仅在支持 IMG2COL 配置状态的后端可用。
src 必须是目标后端接受的 IMG2COL 配置 Tile 类型。
该指令更新的填充相关字段属于实现定义行为。
在同一执行流中，应先设置该状态，再执行依赖的 TIMG2COL 指令。

示例¶

#include <pto/pto-inst.hpp>

using namespace pto;

void example_set_img2col_padding() {
  // IMG2COL 配置 Tile：使用 ConvTile（Mat，NC1HWC0 布局）
  using CfgTile = ConvTile<TileType::Mat, half, 1 * 1 * 16 * 16 * 16, Layout::NC1HWC0,
                           ConvTileShape<1, 1, 16, 16, 16>>;
  CfgTile cfg;
  TASSIGN(cfg, 0x0);
  // 设置 fmapH/fmapW、padList 等配置字段后，再设置填充元数据：
  SET_IMG2COL_PADDING(cfg);
}