external-cannbot-ops-ascendc-runtime-debug

Ascend C Operator Runtime Error Debugging

Systematically debug Ascend C operator runtime errors, including error code handling and environment checks.

Quick Diagnosis

运行时错误
    │
    ├─ 返回码非0？
    │   ├─ 161xxx → 参数错误 → 见高频错误速查
    │   ├─ 361xxx → Runtime错误 → 见 debug_workflow.md
    │   ├─ 507035 → 向量核异常 → 见 debug_workflow.md#507035-向量核异常
    │   └─ 561xxx → 内部错误 → 见高频错误速查 / debug_workflow.md
    │
    └─ 复杂场景 → 开启日志调试

High-Frequency Error Quick Reference

Error Code	Type	Troubleshooting Direction	Detailed Solution
507035	Vector Core Exception	Check DataCopyPad 32B alignment / UB overflow	debug_workflow.md
161xxx	Parameter Error	Check dtype/shape/nullptr	debug_workflow.md
561002	Tiling Error	Check TilingKey/TilingFunc	debug_workflow.md
561003	Kernel Not Found	Check operator installation/environment configuration	debug_workflow.md

For more error codes, see error_codes.md

Handling Unknown Error Codes

When encountering an error code not listed in the quick reference table, see debug_workflow.md

Debugging Tools Quick Reference

Tool	Purpose	Usage
aclGetRecentErrMsg()	Get Error Details	Call when the return code is non-zero
Environment Check	ascendc-env-check skill	See skill:ascendc-env-check
parse_plog.py	Log Parsing	python3 scripts/parse_plog.py [plog_file]
ASCEND_SLOG_PRINT_TO_STDOUT=1	Log Printing to Screen	View logs in real time

For detailed debugging methods, see debug_workflow.md

Detailed Resources

• debug_workflow.md: Detailed debugging process (error code handling, environment check)
• kernel_binary_debug.md: Kernel binary build debugging (compilation cache, SEL matching, multi-version conflicts, opParaSize)
• error_codes.md: Complete error code table (basic status codes, internal exception status codes)
• ascendc-env-check skill: Environment variable configuration guide