union_type using

一、vivado hls中union说明1.vivado hls中union联合体和标准的c/c联合体的union使用规则类似2.vivado hls中需要对内存和数据类型进行比较准确的推断从而来生成硬件3.联合体中所有的成员共享一块内存同一时刻只能使用其中的一个成员4.在 HLS 中使用联合体时需要注意数据类型的位宽和对齐因为这会直接影响生成的硬件5.在vivado hls中联合体的综合是有条件的需要避免使用指针和动态内存分配6.联合体中使用数组和结构体是被允许的7.联合体在vivado hls使用比较常见的用途是用于事项数据类型的转换二、内存共享机制// 案例1: 基本union使用union DataUnion {uint32_t word; // 32位uint8_t bytes[4]; // 4个8位字节struct {uint8_t b0, b1, b2, b3;} byte_struct;};void union_example1(ap_uint32 input, ap_uint8 byte0) {#pragma HLS INTERFACE ap_ctrl_none portreturn#pragma HLS INTERFACE ap_none portinput#pragma HLS INTERFACE ap_none portbyte0DataUnion data;data.word input; // 写入32位字// 四个字节共享同一内存位置byte0 data.bytes[0]; // 读取低8位// data.bytes[1], [2], [3] 对应高8位}三、数据位宽匹配设计// 案例2: 位宽精确匹配union FixedUnion {ap_uint12 data_12bit; // 12位ap_uint4 nibbles[3]; // 3×412位正确匹配// ap_uint8 bytes[2]; // 错误2×816位不匹配// 可以使用struct进行位域控制struct {ap_uint4 low : 4;ap_uint4 mid : 4;ap_uint4 high : 4;} bits;};void union_example2(ap_uint12 in_data,ap_uint4 out_nibble) {#pragma HLS PIPELINE II1FixedUnion fu;fu.data_12bit in_data;// 通过不同方式访问相同数据out_nibble fu.nibbles[1]; // 中间4位// 等效于out_nibble fu.bits.mid;}四、使用限制// 案例3: HLS可综合的union用法union HLS_Compatible {// 只包含POD普通旧数据类型float fval;int ival;ap_fixed16,8 fixed_val; // HLS定点数类型// 以下不可在union中使用// 1. 非POD类型如std::string// 2. 动态内存分配// 3. 虚函数};void type_conversion(float float_in, int int_out) {#pragma HLS INLINEunion {float f;int i;} converter;converter.f float_in;int_out converter.i; // 浮点位模式解释为整数}