高级综合工具StratusHLS学习笔记(4)

HLS中使用浮点数

学习目标：

• 使用浮点数
• 换用自己的库进行高级综合

HLS中的浮点数

stratus HLS提供内置的浮点数，可以实现常规的加减乘操作，类型为：

cynw_cm_float

该类型共有5个模板参数，分别如下所示：

• e：指数位宽，为浮点数的指数位数
• f：尾数位宽，为浮点数的尾数位数
• accuracy：精确度，这一参数可以设置是否需要实现完整的IEEE标准浮点数。若需要实现则可以提高计算精度，若不实现则可以缩小面积提升性能。
• rounding mode：取整模式，推测为浮点数尾数处理中如何取整，具有多种模式
• NaN handle：用于选择如何处理NaN

对于指数位宽和尾数位宽，为每一个浮点数都具有的参数，不用过多解释；对于精确度，具有多种选项，每种选项具有不同的精度-代价折中，如下表所示：

标号	说明
CYNW_REDUCED_ACCURACY	默认情况，使用低精度低代价实现方法
CYNW_BEST_ACCURACY	使用IEEE标准的浮点数
CYNW_NATIVE_ACCURACY	使用C++中的浮点数，不可综合
CYNW_EXCEPTION_ACCURACY	使用IEEE标准带异常的浮点数精度

对于取整模式rounding，可选择的如下表所示：

标号	说明
CYNW_NEAREST	默认情况，向最接近的偶数取整
CYNW_POSINF	向上取整
CYNW_NEGINF	向下取整
CYNW_RNDZERO	向零取整
CYNW_NEAREST_AWAY	四舍五入

对于NaN处理，有下表所示：

标号	说明
0	返回恒定的NaN
1	默认情况，标准IEEE的NaN处理方法，左操作数优先
2	标准IEEE的NaN处理方法，右操作数优先

使用方法

在设计中，需要添加头文件cynw_cm_float.h即可使用以上浮点数类型，使用时如同常规数据类型直接使用，可实现加减乘等操作，如下所示：

#include "cynw_cm_float.h"
typedef cynw_cm_float<5,10> DT;
// DT a,b,c;c = a+b 可实现

在project.tcl中，需要在添加库的同时添加使用浮点库，如下所示：

use_hls_lib "cynw_cm_float"

随后进行常规的仿真流程即可，下图为CYNW_REDUCED_ACCURACY的float16加法器的仿真和综合结果，使用的库是自带的55nm库：

时序相关

时序设置

对于时序而言，在HLS有多个参数可以设置，包括：

• 时钟频率（必须）
• 时钟非理想因素
• 输入与输出延迟

这些因素在常规流程中使用SDC进行设置，在HLS流程中在代码或project.tcl中设置。首先考虑时钟非理想因素。即uncertainty，在HLS中使用cycle_slack在project.tcl中设置，如下所示：

set_attr clock_period 10.0
set_attr cycle_slack 1.5

上述设置时钟周期为10ns，非理想因素为1.5ns，等效时钟周期为8.5ns。输入与输出延迟在代码中直接设置，使用HLS_SET_INPUT_DELAY或HLS_SET_DEFAULT_INPUT_DELAY设置输入延迟，其中：

• HLS_SET_INPUT_DELAY( port, float delay, "char* name" )：用于设置特定端口
• HLS_SET_DEFAULT_INPUT_DELAY( float delay, "char* name" );：用于设置所有未被特定设置的端口

对于输出而言，同理有：

• HLS_SET_OUTPUT_DELAY(signal_id, delay );：用于设置特定端口
• HLS_SET_DEFAULT_OUTPUT_DELAY( delay);：用于设置所有未被特定设置的端口

stratus HLS一般使用寄存器输出，因此除非输出端口，输出延迟可以不进行设置。设置端口延迟如下所示，以下例子中，设置了w_in端口的输入延迟为0.5ns，其他端口（x_in和data_valid）均为0.3ns。

void dut_template::t() {
    HLS_SET_INPUT_DELAY(w_in,0.5,"data0_delay");
    HLS_SET_DEFAULT_INPUT_DELAY(0.3,"data1_delay");
    {
        HLS_DEFINE_PROTOCOL("reset");
        w_in.reset();
        x_in.reset();
        y_out.reset();
        data_valid.write(0);
        wait();
    }
    while(1) {
        HLS_PIPELINE_LOOP(SOFT_STALL, 1, "main_loop");
        DT x_val = x_in.get();
        DT w_val = w_in.get();
        DT out_val = x_val + w_val;
        y_out.put(out_val);
    }
}

时序违例

HLS一般不会出现时序违例，因为可以自动进行流水线的插入操作，经过试验，即使float计算ip也可以在时序不满足时自动进行流水线插入以避免时序违例，同时stratus HLS将时序违例看做“错误”，当出现时序违例时，软件会抛出错误Error并打印时序违例的信息，一般时序违例来源于人工指定过多时序等，例如强制要求某段代码在指定的时钟周期内完成。

使用自己的库

stratus HLS中内置一个55nm的库，在具体工艺中，需要使用自己的库进行评估，在project.tcl中，使用如下命令：

use_tech_lib "path.lib"

注意需要使用的是.lib库而不是.db库。随后重新生成makefile，即可使用自己的库进行评估。