asc_copy_l12ub

产 品 支 持 情 况

产 品	是 否 支 持
Ascend 950PR/Ascend 950DT	√

功 能 说 明

将 数 据 从L1 Buffer搬 运 到Unified Buffer中。

函 数 原 型

• 高 维 切 分 搬 运

  C++

  __aicore__ inline void asc_copy_l12ub(__ubuf__ void * dst_addr, __cbuf__ void * src_addr, bool sub_blockid, uint16_t n_burst, uint16_t len_burst, uint16_t src_gap, uint16_t dst_gap)
  

• 同 步 搬 运

  C++

  __aicore__ inline void asc_copy_l12ub_sync(__ubuf__ void * dst_addr, __cbuf__ void * src_addr, bool sub_blockid, uint16_t n_burst, uint16_t len_burst, uint16_t src_gap, uint16_t dst_gap)
  

参 数 说 明

参 数 名	输 入/输 出	描 述
dst_addr	输 出	目 的 操 作 数 起 始 地 址。
src_addr	输 入	源 操 作 数 起 始 地 址。
sub_blockid	输 入	使 用 的 子 块ID。
n_burst	输 入	待 搬 运 的 连 续 传 输 数 据 块 个 数。
len_burst	输 入	待 搬 运 的 每 个 连 续 传 输 数 据 块 的 长 度，单 位 为DataBlock（32字 节）。
src_gap	输 入	源 操 作 数 相 邻 连 续 数 据 块 的 间 隔（前 面 一 个 数 据 块 的 尾 与 后 面 一 个 数 据 块 的 头 的 间 隔）。 单 位 为DataBlock（32字 节）。
dst_gap	输 入	目 的 操 作 数 相 邻 连 续 数 据 块 的 间 隔（前 面 一 个 数 据 块 的 尾 与 后 面 一 个 数 据 块 的 头 的 间 隔）。 单 位 为DataBlock（32字 节）。

返 回 值 说 明

无

流 水 类 型

PIPE_MTE1

约 束 说 明

• dst_addr、src_addr的 起 始 地 址 需 要32字 节 对 齐。
• 操 作 数 地 址 重 叠 约 束 请 参 考通 用 地 址 重 叠 约 束。
• 由 于 此 接 口 实 现 了Cube核 与Vector核 间 的 数 据 搬 运，所 以 如 果 核 函 数 调 用 了 该 接 口，则 不 能 使 用__cube__或__vector__的 执 行 空 间 修 饰 符，否 则 会 导 致 执 行 失 败。

调 用 示 例

C++

constexpr uint16_t n_burst = 1;
constexpr uint16_t len_burst = 1;
constexpr uint16_t src_gap = 0;
constexpr uint16_t dst_gap = 1;
__cbuf__ void src[256];
__ubuf__ void dst[256];
asc_copy_l12ub(dst, src, false, n_burst, len_burst, src_gap, dst_gap);