Simulator仿真参数
参数(区分大小写) |
说明 |
是否必选 |
默认值 |
备注 |
---|---|---|---|---|
kernel |
开启仿真功能的固定参数。 |
是 |
无 |
无 |
-b,--backend |
算子调试类型。 |
否 |
npu |
性能仿真场景设为simulator。
|
--chip-version |
昇腾AI处理器的版本。 |
否 |
工具自动获取对应版本。 |
支持手动设置。在安装昇腾AI处理器的服务器执行npu-smi info命令进行查询,在查询到的“Name”前增加Ascend信息,例如“Name”对应取值为xxxyy,实际配置的值为Ascendxxxyy。
若用户在没有Device的环境下调试算子,该参数必须指定。 |
-i,--install-path |
CANN软件安装后文件存储路径。 |
否 |
工具自动获取CANN包安装路径,缺省值为/usr/local/Ascend/ascend-toolkit。 |
例如,若安装的Ascend-cann-toolkit软件包,则安装后文件存储路径为:$HOME/Ascend/ascend-toolkit/latest。 |
-w,--work-dir |
调测结果的存放路径。 |
否 |
缺省为当前执行路径下/debug_workspace/${op_type}文件夹(若无则会自动新建)。 |
调测工作目录,可用于存放调测中各种临时文件、结果文件。例如/home/debug_workspace/AddCustom/simulator。 |
-j,--json-file |
算子信息json配置文件,配置算子输入/输出/属性信息。 |
是 |
无 |
json配置文件必须是绝对路径,其配置项说明详见数据准备与配置说明。 |
--log-level |
日志级别。 |
否 |
info |
支持debug 、info、warning、error级别。 |
--log-file |
日志文件路径。 |
否 |
缺省值为当前目录下的debug_op.log文件(若无则会新建)。 |
根据设置的--log-level存放程序执行过程中的日志信息。 |
--repo-type |
算子开发场景类型。 |
否 |
customize |
根据实际情况设置。
|
--customize-path |
自定义算子包的安装目录。 |
否 |
无 |
例如${INSTALL_DIR}/opp/vendors/${vendor_name},其中${INSTALL_DIR}为CANN安装包路径,${vendor_name}为部署自定义算子包时设置的vendor名。
说明:
仅当--repo-type为customize,该参数生效。 |
--dump-mode |
printf/PRINTF/DumpTensor/DumpAccChkPoint/assert打印功能的模式。 |
否 |
无 |
若不设置表示关闭打印功能,若开启支持如下取值:
更多打印功能说明参见更多功能。 |
--core-type |
算子类型。 |
否 |
AiCore |
根据实际算子情况填写,可选值为AiCore、MixCore、CubeCore、VectorCore、MixVectorCore,MixVectorCore为预留参数,开发者无需关注。 |
-t,--timeout |
设置运行超时时间,单位秒。 |
否 |
600 |
CAModel运行时间比较长,一般设为1200s, 用户可根据实际情况修改。 |
--block-num |
设置运行的核个数。 |
否 |
无 |
CAModel场景一般单核运行,设置为1。 |
--kernel-bin |
指定已编译好的kernel bin文件。 |
否 |
无 |
当该参数生效时,会跳过编译流程,直接用指定的kernel bin文件执行。 |
--simulator-mode |
仿真器模式设置。 |
否 |
camodel |
支持camodel、esl、biprof模式,目前仅支持camodel模式。 |
--simu-pkg-path |
设置仿真器安装包路径。 |
否 |
无 |
当--simulator-mode为camodel时,不需要设置该参数。 |
--tiling-bin |
使用用户传入的tiling.bin进行编译。 |
否 |
无 |
传入的Tiling bin是带绝对路径的文件名,文件命名规则为tiling_data_tiling_key_${tiling_key}_block_dim_${block_num}_workspace_${workspace}.bin,确保tiling_key、block_num、workspace与Tiling bin文件匹配。
说明:
该参数与--tiling-so、--tiling-json、--recompile-tiling冲突,不支持同时设置。 |
--tiling-so |
使用用户传入的liboptiling.so进行编译。 |
否 |
无 |
该参数与--tiling-bin、--tiling-json、--recompile-tiling冲突,不支持同时设置。 |
--tiling-json |
Tiling json文件路径(绝对路径),用于生成自定义Tiling data。 |
否 |
无 |
仅当--repo-type为ops_adv、cann_dev,该参数生效。
说明:
该参数与--tiling-so、--tiling-bin、--recompile-tiling冲突,不支持同时设置。 |
--repo-path |
算子源码仓所在路径(绝对路径)。 |
否 |
无 |
仅当--repo-type为ops_adv、cann_dev、op_contrib,该参数生效。 |
--recompile-tiling |
是否重新编译算子Tiling so,无需配置值。 |
否 |
无 |
说明:
|
--npu-compile-type |
设置调测场景下Kernel.o文件编译方式。 |
否 |
opc |
当--repo-type为cann_dev、ops_adv时支持ccec和opc两种编译方式,minimalist默认使用ccec,customize、op_contrib默认使用opc。 |
--syncall |
硬同步功能的使能开关,无需配置值。 |
否 |
无 |
当--repo-type为ops_adv、cann_dev且--npu-compile-type为ccec时,该参数在Atlas A2训练系列产品/Atlas 800I A2推理产品上才生效。 |
--task-ration |
设置核函数运行时的block数分配方式比例,例如“--task-ration 1:1”。 |
否 |
无 |
当--repo-type为ops_adv、cann_dev且--npu-compile-type为ccec时,该参数才生效。 |