ERROR: [HLS 200-1916]

HLS 200-1916：ap_ctrl_chain blackbox 模块不能用于 pipeline 区域

HLS / Vitis 已闭环 Vitis HLS 22.1

现象

在 Vitis HLS 22.1 的 pipelined for 循环中使用 RTL blackbox 时出现 pipeline 报错

报错原文

ERROR: [HLS 200-1916] Ap_ctrl_chain blackbox module 'xxx' can not be used in pipeline region.

根因

帖中未明确；回答中给出的解决方式是通过返回值而非引用输出，并在 JSON 中配置 c_return、rtl_common_signal 及 II=1

可尝试的处理步骤

• 在 JSON 中添加 c_return 字段，c_port_direction 设为 out，rtl_ports 中 data_write_out 映射到 res
• 定义 rtl_common_signal，module_clock 为 ap_clk、module_reset 为 ap_rst、module_clock_enable 为 ap_ce，ap_ctrl_chain 各字段留空
• 将 rtl_performance 的 II 设为 1（设为 0 时 Vitis 认为未流水化，不会对外层循环流水）
• 将 C++ 函数定义为通过返回值输出，例如 ap_fixed<16,4> my_rtl_mo

结论

通过返回值输出并正确配置 JSON 的 c_return、rtl_common_signal 与 II=1 可解决

同一工具下的相关错误码