asc_sync_wait

产 品 支 持 情 况

产 品	是 否 支 持
Ascend 950PR/Ascend 950DT	√
Atlas A3 训 练 系 列 产 品/Atlas A3 推 理 系 列 产 品	√
Atlas A2 训 练 系 列 产 品/Atlas A2 推 理 系 列 产 品	√

功 能 说 明

等 待 特 定 的 同 步 标 志，阻 塞 当 前 流 水 线 直 到 条 件 满 足。

函 数 原 型

C++

__aicore__ inline void asc_sync_wait(pipe_t pipe, pipe_t tpipe, event_t id)

参 数 说 明

参 数 名	输 入/输 出	描 述
pipe	输 入	等 待 的 源 流 水 线 类 型。需 传 入 编 译 期 常 量。
tpipe	输 入	当 前 流 水 线 类 型。需 传 入 编 译 期 常 量。
id	输 入	同 步ID。

返 回 值 说 明

无

流 水 类 型

PIPE_S

约 束 说 明

无

调 用 示 例

C++

// 本 例 中total_length指 参 与 计 算 的 数 据 总 长 度。src0_gm，src1_gm，dst_gm是 外 部 输 入 的float类 型 的 源 操 作 数、目 的 操 作 数，指 向GM内 存 空 间。
constexpr uint32_t total_length = 128;
__ubuf__ float src0[total_length];
__ubuf__ float src1[total_length];
__ubuf__ float dst[total_length];

asc_copy_gm2ub((__ubuf__ void*)src0, (__gm__ void*)src0_gm, total_length * sizeof(float));
asc_copy_gm2ub((__ubuf__ void*)src1, (__gm__ void*)src1_gm, total_length * sizeof(float));

// 同 步 操 作：数 据 搬 运 操 作（GM到UB，PIPE_MTE2流 水）完 成 后 才 能 启 动 计 算 操 作（PIPE_V流 水）。
asc_sync_notify(PIPE_MTE2, PIPE_V, EVENT_ID0);  // EVENT_ID0为 外 部 传 入 的 同 步ID。
asc_sync_wait(PIPE_MTE2, PIPE_V, EVENT_ID0);  // EVENT_ID0为 外 部 传 入 的 同 步ID。

asc_add(dst, src1, src0, total_length);

// 同 步 操 作：计 算 操 作（PIPE_V流 水）完 成 后 才 能 启 动 数 据 搬 运 操 作（UB到GM，PIPE_MTE3流 水）。
asc_sync_notify(PIPE_V, PIPE_MTE3, EVENT_ID0);  // EVENT_ID0为 外 部 传 入 的 同 步ID。
asc_sync_wait(PIPE_V, PIPE_MTE3, EVENT_ID0);  // EVENT_ID0为 外 部 传 入 的 同 步ID。

asc_copy_ub2gm((__gm__ void*)dst_gm, (__ubuf__ void*)dst, total_length * sizeof(float));