已合并
asc_abs_sync废弃接口及目录 #5058
maohp_hw创建于 8 天前
asc_abs_sync废弃接口及目录 #5058
已合并
共 8 个文件变更+103-15
| @@ -1330,7 +1330,6 @@ | |||
| 1330 | - [asc_set_atomic_min](SIMD-API/c_api/simd_atomic/asc_set_atomic_min.md) | 1330 | - [asc_set_atomic_min](SIMD-API/c_api/simd_atomic/asc_set_atomic_min.md) |
| 1331 | - [asc_set_atomic_none](SIMD-API/c_api/simd_atomic/asc_set_atomic_none.md) | 1331 | - [asc_set_atomic_none](SIMD-API/c_api/simd_atomic/asc_set_atomic_none.md) |
| 1332 | - [asc_set_store_atomic_config_v1](SIMD-API/c_api/simd_atomic/asc_set_store_atomic_config_v1.md) | 1332 | - [asc_set_store_atomic_config_v1](SIMD-API/c_api/simd_atomic/asc_set_store_atomic_config_v1.md) |
| 1333 | - - [asc_set_atomic_add_int（废弃）](SIMD-API/c_api/simd_atomic/asc_set_atomic_add_int_deprecated.md) | ||
| 1334 | - [asc_set_atomic_max_int（废弃）](SIMD-API/c_api/simd_atomic/asc_set_atomic_max_int_deprecated.md) | 1333 | - [asc_set_atomic_max_int（废弃）](SIMD-API/c_api/simd_atomic/asc_set_atomic_max_int_deprecated.md) |
| 1335 | - [asc_set_atomic_min_int（废弃）](SIMD-API/c_api/simd_atomic/asc_set_atomic_min_int_deprecated.md) | 1334 | - [asc_set_atomic_min_int（废弃）](SIMD-API/c_api/simd_atomic/asc_set_atomic_min_int_deprecated.md) |
| 1336 | - [asc_set_store_atomic_config_v2（废弃）](SIMD-API/c_api/simd_atomic/asc_set_store_atomic_config_v2_deprecated.md) | 1335 | - [asc_set_store_atomic_config_v2（废弃）](SIMD-API/c_api/simd_atomic/asc_set_store_atomic_config_v2_deprecated.md) |
| @@ -1340,6 +1339,9 @@ | |||
| 1340 | - [asc_hf32_round_mode](SIMD-API/c_api/enum/asc_hf32_round_mode.md) | 1339 | - [asc_hf32_round_mode](SIMD-API/c_api/enum/asc_hf32_round_mode.md) |
| 1341 | - [asc_load_l2_cache_mode](SIMD-API/c_api/enum/asc_load_l2_cache_mode.md) | 1340 | - [asc_load_l2_cache_mode](SIMD-API/c_api/enum/asc_load_l2_cache_mode.md) |
| 1342 | - [asc_store_l2_cache_mode](SIMD-API/c_api/enum/asc_store_l2_cache_mode.md) | 1341 | - [asc_store_l2_cache_mode](SIMD-API/c_api/enum/asc_store_l2_cache_mode.md) |
| 1342 | + - [废弃接口](SIMD-API/c_api/deprecated_interface/deprecated_interface.md) | ||
| 1343 | + - [asc_set_atomic_add_int（废弃）](SIMD-API/c_api/deprecated_interface/asc_set_atomic_add_int_deprecated.md) | ||
| 1344 | + - [asc_abs_sync（废弃）](SIMD-API/c_api/deprecated_interface/asc_abs_sync_deprecated.md) | ||
| 1343 | 1345 | ||
| 1344 | - [高阶API](SIMD-API/adv_api/adv_api.md) | 1346 | - [高阶API](SIMD-API/adv_api/adv_api.md) |
| 1345 | - [高阶API列表](SIMD-API/adv_api/adv_api_list.md) | 1347 | - [高阶API列表](SIMD-API/adv_api/adv_api_list.md) |
| @@ -0,0 +1,76 @@ | |||
| 1 | +# asc_abs_sync（废弃） | ||
| 2 | + | ||
| 3 | +## 产品支持情况 | ||
| 4 | + | ||
| 5 | +<!-- npu="950" id1 --> | ||
| 6 | +- Ascend 950PR/Ascend 950DT：不支持 | ||
| 7 | +<!-- end id1 --> | ||
| 8 | +<!-- npu="A3" id2 --> | ||
| 9 | +- Atlas A3 训练系列产品/Atlas A3 推理系列产品：支持 | ||
| 10 | +<!-- end id2 --> | ||
| 11 | +<!-- npu="910b" id3 --> | ||
| 12 | +- Atlas A2 训练系列产品/Atlas A2 推理系列产品：支持 | ||
| 13 | +<!-- end id3 --> | ||
| 14 | +<!-- npu="310b" id4 --> | ||
| 15 | +- Atlas 200I/500 A2 推理产品：不支持 | ||
| 16 | +<!-- end id4 --> | ||
| 17 | +<!-- npu="310p" id5 --> | ||
| 18 | +- Atlas 推理系列产品AI Core：不支持 | ||
| 19 | +<!-- end id5 --> | ||
| 20 | +<!-- npu="310p" id6 --> | ||
| 21 | +- Atlas 推理系列产品Vector Core：不支持 | ||
| 22 | +<!-- end id6 --> | ||
| 23 | +<!-- npu="910" id7 --> | ||
| 24 | +- Atlas 训练系列产品：不支持 | ||
| 25 | +<!-- end id7 --> | ||
| 26 | + | ||
| 27 | +## 功能说明 | ||
| 28 | + | ||
| 29 | +该接口废弃，请通过[asc_abs](../vector_compute/asc_abs.md)和同步接口[asc_sync](../sync/asc_sync.md)实现精细化调优，达成最优性能。 | ||
| 30 | + | ||
| 31 | +按元素取绝对值，计算公式如下： | ||
| 32 | +$$ | ||
| 33 | +dst_i = |src_i| | ||
| 34 | +$$ | ||
| 35 | + | ||
| 36 | +## 函数原型 | ||
| 37 | + | ||
| 38 | +- 同步计算 | ||
| 39 | + | ||
| 40 | + ```cpp | ||
| 41 | + __aicore__ inline void asc_abs_sync(__ubuf__ half* dst, __ubuf__ half* src, uint32_t count) | ||
| 42 | + __aicore__ inline void asc_abs_sync(__ubuf__ float* dst, __ubuf__ float* src, uint32_t count) | ||
| 43 | + ``` | ||
| 44 | + | ||
| 45 | +## 参数说明 | ||
| 46 | + | ||
| 47 | +**表1** 参数说明 | ||
| 48 | + | ||
| 49 | +| 参数名 | 输入/输出 | 描述 | | ||
| 50 | +| :----- | :------- | :------- | | ||
| 51 | +| dst | 输出 | 目的操作数（矢量）的起始地址。 | | ||
| 52 | +| src | 输入 | 源操作数（矢量）的起始地址。 | | ||
| 53 | +| count | 输入 | 参与计算的元素个数。 | | ||
| 54 | + | ||
| 55 | +## 返回值说明 | ||
| 56 | + | ||
| 57 | +无 | ||
| 58 | + | ||
| 59 | +## 流水类型 | ||
| 60 | + | ||
| 61 | +PIPE_V | ||
| 62 | + | ||
| 63 | +## 约束说明 | ||
| 64 | + | ||
| 65 | +- dst、src的起始地址需要32字节对齐。 | ||
| 66 | +- 操作数地址重叠约束请参考[通用地址重叠约束](../general_description_and_constraints.md#通用地址重叠约束)。 | ||
| 67 | + | ||
| 68 | +## 调用示例 | ||
| 69 | + | ||
| 70 | +```cpp | ||
| 71 | +//total_length指参与计算的数据长度 | ||
| 72 | +constexpr uint32_t total_length = 128; | ||
| 73 | +__ubuf__ half src[total_length]; | ||
| 74 | +__ubuf__ half dst[total_length]; | ||
| 75 | +asc_abs(dst, src, total_length); | ||
| 76 | +``` | ||
Rdocs/zh/api/SIMD-API/c_api/simd_atomic/asc_set_atomic_add_int_deprecated.md→docs/zh/api/SIMD-API/c_api/deprecated_interface/asc_set_atomic_add_int_deprecated.md+3-3
| @@ -26,7 +26,7 @@ | |||
| 26 | 26 | ||
| 27 | ## 功能说明 | 27 | ## 功能说明 |
| 28 | 28 | ||
| 29 | -**该接口已废弃，请使用[asc_set_atomic_add_int32](asc_set_atomic_add.md)替代。** | 29 | +**该接口已废弃，请使用[asc_set_atomic_add_int32](../simd_atomic/asc_set_atomic_add.md)替代。** |
| 30 | 30 | ||
| 31 | 头文件路径：`"c_api/atomic/atomic.h"`。 | 31 | 头文件路径：`"c_api/atomic/atomic.h"`。 |
| 32 | 32 | ||
| @@ -53,9 +53,9 @@ PIPE_S | |||
| 53 | 53 | ||
| 54 | ## 约束说明 | 54 | ## 约束说明 |
| 55 | 55 | ||
| 56 | -- 使用完成后，建议清空原子操作的状态（详见[asc_set_atomic_none](./asc_set_atomic_none.md)），以免影响后续相关指令功能。 | 56 | +- 使用完成后，建议清空原子操作的状态（详见[asc_set_atomic_none](../simd_atomic/asc_set_atomic_none.md)），以免影响后续相关指令功能。 |
| 57 | - 该指令执行前不会对GM的数据做清零操作，开发者需在需要时手动添加清零操作。 | 57 | - 该指令执行前不会对GM的数据做清零操作，开发者需在需要时手动添加清零操作。 |
| 58 | 58 | ||
| 59 | ## 调用示例 | 59 | ## 调用示例 |
| 60 | 60 | ||
| 61 | -请参考[asc_set_atomic_add](asc_set_atomic_add.md)的调用示例。 | 61 | +请参考[asc_set_atomic_add](../simd_atomic/asc_set_atomic_add.md)的调用示例。 |
| @@ -0,0 +1,7 @@ | |||
| 1 | +# 废弃接口 | ||
| 2 | + | ||
| 3 | +## 矢量计算 | ||
| 4 | +- **[asc_abs_sync（废弃）](asc_abs_sync_deprecated.md)** | ||
| 5 | + | ||
| 6 | +## 原子操作 | ||
| 7 | +- **[asc_set_atomic_add_int（废弃）](asc_set_atomic_add_int_deprecated.md)** | ||
| @@ -12,8 +12,6 @@ | |||
| 12 | 12 | ||
| 13 | - **[asc_set_store_atomic_config_v1](asc_set_store_atomic_config_v1.md)** | 13 | - **[asc_set_store_atomic_config_v1](asc_set_store_atomic_config_v1.md)** |
| 14 | 14 | ||
| 15 | -- **[asc_set_atomic_add_int（废弃）](asc_set_atomic_add_int_deprecated.md)** | ||
| 16 | - | ||
| 17 | - **[asc_set_atomic_max_int（废弃）](asc_set_atomic_max_int_deprecated.md)** | 15 | - **[asc_set_atomic_max_int（废弃）](asc_set_atomic_max_int_deprecated.md)** |
| 18 | 16 | ||
| 19 | - **[asc_set_atomic_min_int（废弃）](asc_set_atomic_min_int_deprecated.md)** | 17 | - **[asc_set_atomic_min_int（废弃）](asc_set_atomic_min_int_deprecated.md)** |
| @@ -48,13 +48,6 @@ $$ | |||
| 48 | __aicore__ inline void asc_abs(__ubuf__ float* dst, __ubuf__ float* src, uint8_t repeat, uint16_t dst_block_stride, uint16_t src_block_stride, uint16_t dst_repeat_stride, uint16_t src_repeat_stride) | 48 | __aicore__ inline void asc_abs(__ubuf__ float* dst, __ubuf__ float* src, uint8_t repeat, uint16_t dst_block_stride, uint16_t src_block_stride, uint16_t dst_repeat_stride, uint16_t src_repeat_stride) |
| 49 | ``` | 49 | ``` |
| 50 | 50 | ||
| 51 | -- 同步计算 | ||
| 52 | - | ||
| 53 | - ```cpp | ||
| 54 | - __aicore__ inline void asc_abs_sync(__ubuf__ half* dst, __ubuf__ half* src, uint32_t count) | ||
| 55 | - __aicore__ inline void asc_abs_sync(__ubuf__ float* dst, __ubuf__ float* src, uint32_t count) | ||
| 56 | - ``` | ||
| 57 | - | ||
| 58 | ## 参数说明 | 51 | ## 参数说明 |
| 59 | 52 | ||
| 60 | **表1** 参数说明 | 53 | **表1** 参数说明 |