[TileOP] asm operand label DType collides with consumer -DDType macro

[wangyuascend-spec]

Environment

• TileOP API: a795b973020de012fa2a8e2c29b26adfc83d5d29
• llvm-project: 611105f2be11fab9a8ef20bd02b740f2c5d786b3
• Reproducer consumer: SuperNPUBench ops-20260823 (244d088fdc56dc0b41cc77b60e03dc974b67ea93)

Problem

Compiling any normalization testcase with its documented datatype define:

clang++ ... -DDType=__half ...

fails while parsing the TQUANT inline-assembly templates in include/jcore/template_asm.hpp:

error: unknown symbolic operand name in inline assembly string
"B.DATR %c[DType], RNONE, SAT\n"
         ^

The same error is emitted for the four B.DATR variants around lines 6539, 6557, 6575, and 6594.

Root cause

The inline asm uses DType as a symbolic operand label:

"B.DATR %c[DType], RNONE, SAT\n"
...
[DType] "i"(type_traits<typename tile_shape_out::DType>::TypeCode)

The consumer's public DType preprocessor macro rewrites the constraint label token [DType] to [__half]. Macro expansion does not occur inside the asm string, which still references %c[DType], so Clang correctly reports that the symbolic operand is missing.

This happens even when the consumer does not instantiate TQUANT because the template definition is parsed after preprocessing.

Verified minimal fix

Rename the asm operand label without changing the encoded value:

- "B.DATR %c[DType], RNONE, SAT\n"
- [DType] "i"(...)
+ "B.DATR %c[DstType], RNONE, SAT\n"
+ [DstType] "i"(...)

Applying this rename to all four variants makes all 10 default normalization ELFs compile successfully. No instruction encoding or runtime behavior changes.

Expected behavior

TileOP public headers should avoid generic symbolic asm labels that can collide with common consumer macros.

Suggested acceptance test

Compile a small TU that includes common/pto_tileop.hpp with -DDType=__half. The header should parse successfully, including when TQUANT is not instantiated.

[VV0003]

已确认并补充修复。

根因是编译器可能通过 -DDType=... 定义宏，而 TQUANT/TDEQUANT 的 inline asm 也使用了 [DType] 作为 symbolic operand label；预处理后会发生宏替换，导致 asm operand 名称被破坏，属于真实的前端/inline-asm 宏命名冲突。

修复如下：

• commit 4b8013d 将 TQUANT 四个 B.DATR 分支以及 PTO_RMODE_DATR_ASM 的动态 RMode 分支统一改用不易冲突的 [__pto_DstType]；
• 增加 test/tileop_api/src/DTypeMacro.cpp 和 test/tileop_api/verify_dtypemacro.sh，覆盖 -DDType=__half 的回归场景；
• 同步修正过时的 v0.58 engine contract 断言，commit d9a2e80，将旧的 [DType] 检查更新为 [__pto_DstType]。

验证结果：make check 全部通过，32 项契约测试、文档生成检查、C++ syntax-only 检查和脚本语法检查均通过。未涉及 SuperScalarModel。