assert功能

功能介绍

使用工具进行算子调测时，支持断言功能。当核函数代码中条件判断为False时，则立即中断运行流程并打印相关信息，方便快速定位错误。

固定为每个核分配的打印数据的最大可使用空间为1M，目前该大小不支持修改，若打印超过1M，打印内容不再显示，请开发者控制待打印的数据量。

使用方法（命令行）

1. 在核函数代码中按需在目标位置调用assert接口，接口说明参见表1，样例如下：

   int32_t x = 31; 
   assert(x < 0, "Invalid input_num: %d\n", x);

2. NPU调测场景执行如下命令，使能Dump开关。

   ascendebug kernel --backend npu --dump-mode normal ... {其他NPU调测参数}

   --dump-mode取normal，开启通用打印Scalar模式，其他参数参考NPU调测参数按需配置。

3. 查看断言结果。

   若调用时传入的判断条件为false，会中断程序并打屏显示断言内容（带文件名、行号），结果示例如下。

   [ASSERT] /home/.../add_custom.cpp:94: Assertion `x < 0' Invalid input_num: 31

使用方法（API）

1. 在核函数代码中按需在目标位置调用assert接口，接口说明参见表1，样例如下：

   int32_t x = 31; 
   assert(x < 0, "Invalid input_num: %d\n", x);

2. 调用算子编译及运行接口，对应options配置为设置dump_mode='normal'。以标准自定义场景下NPU上板打印断言为例：

   compile_npu_options = ascendebug.CompileNpuOptions(dump_mode='normal')
   name, kernel_file, extern = op_executor.compile_custom_npu(customize_path, tiling_info.tiling_key, compile_npu_options)
   npu_compile_info = ascendebug.NpuCompileInfo(syncall=extern['cross_core_sync'], task_ration=extern['task_ration'], dump_mode='normal')
   run_npu_options = ascendebug.RunNpuOptions()
   op_executor.run_npu(kernel_file, run_npu_options, npu_compile_info=npu_compile_info, tiling_info=tiling_info)

3. 查看断言结果。

   若调用时传入的判断条件为false，会中断程序并打屏显示断言内容（带文件名、行号），结果示例如下。

   [ASSERT] /home/.../add_custom.cpp:94: Assertion `x < 0' Invalid input_num: 31

接口说明

assert(input_num > 0, "Invalid input_num: %d ", input_num);