asc_unlock

产 品 支 持 情 况

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

功 能 说 明

用 于AI Core内 部 异 步 通 道 同 步 的 指 令，用 于 释 放 由asc_lock指 令 申 请 的 缓 存。

函 数 原 型

Text

```cpp
enum ascMutexExecuteMode {
    ASC_LOCK_BLOCK = 0,
    ASC_LOCK_NON_BLOCK = 1
};

__aicore__ inline void asc_unlock(pipe_t pipe, uint8_t mutex_id)
__aicore__ inline void asc_unlock(pipe_t pipe, uint8_t mutex_id, const ascMutexExecuteMode mode)
```

参 数 说 明

参 数 名	输 入/输 出	描 述
pipe	输 入	该 指 令 的 执 行 流 水 线。
mutex_id	输 入	buffer标 号。取 值 范 围[0, 31]。
mode	输 入	可 选 参 数，用 于 指 定 是 否 阻 塞 流 水 线，默 认 值 为ASC_LOCK_BLOCK。 • ASC_LOCK_BLOCK：该 指 令 等 待pipe所 对 应 的 流 水 线 中 所 有 前 置 指 令 完 成 后 执 行。 • ASC_LOCK_NON_BLOCK：该 指 令 等 待pipe所 对 应 的 流 水 线 中 所 有 前 置 指 令 完 成 且 相 同mutex_id的 所 有asc_unlock指 令 执 行 完 成 后 执 行。

返 回 值 说 明

无

流 水 类 型

PIPE_S

约 束 说 明

• 必 须 与asc_lock搭 配 使 用，且 需 要 使 用 相 同 的mutex_id与mode。此 外，asc_unlock必 须 始 终 插 在 对 应 的asc_lock指 令 之 后，否 则 会 出 现 未 定 义 的 硬 件 行 为。
• 具 有 相 同mutex_id的asc_lock与asc_unlock组 合，无 论pipe与mode是 否 相 同，均 不 得 在 编 程 顺 序 中 嵌 套，否 则 硬 件 行 为 将 不 可 预 测。
• 对 于 程 序 顺 序 中 连 续 出 现 的，具 有 相 同pipe与mutex_id的 指 令 对，后 一 个asc_lock将 不 再 阻 塞 流 水 线 运 行，若 需 实 现 同 一 流 水 线 的 依 赖 关 系，则 必 须 使 用 指 令asc_sync_pipe。

调 用 示 例

C++

//buffer标 号 为1
uint8_t mutex_id = 1;
//等 待PIPE_S中 所 有 前 置 指 令 完 成 后 释 放 标 号 为1的 缓 存
asc_lock(PIPE_S, mutex_id);
asc_unlock(PIPE_S, mutex_id);