Compare commits
No commits in common. "8f14f93d7e4230db405b62f79f2c23da040d3021" and "f348990a79af5159710cce41f9843c52203ba077" have entirely different histories.
8f14f93d7e
...
f348990a79
|
@ -1,8 +1,3 @@
|
||||||
# ic_com
|
# ic_com
|
||||||
|
|
||||||
数字芯片设计公共库
|
数字芯片设计公共库
|
||||||
|
|
||||||
## 目录结构
|
|
||||||
- `lib/`:核心功能模块(如编码器、FIFO等)
|
|
||||||
- `tb/`:各模块的仿真测试平台
|
|
||||||
- `doc/`:文档与使用说明
|
|
|
@ -1,57 +0,0 @@
|
||||||
# ic_com 库功能简介
|
|
||||||
|
|
||||||
## 目录结构
|
|
||||||
- `lib/`:核心功能模块(如编码器、FIFO等)
|
|
||||||
- `tb/`:各模块的仿真测试平台
|
|
||||||
- `doc/`:文档与使用说明
|
|
||||||
|
|
||||||
## 主要功能模块
|
|
||||||
### 1. 编码/解码
|
|
||||||
- `enc_dec/oh_bin/oh2bin.sv`:参数化 one-hot 到二进制编码器,支持面积/频率优化,适用于高性能和低功耗场景。
|
|
||||||
|
|
||||||
### 2. FIFO
|
|
||||||
- `fifo/sync/fifo_sync.sv`:同步FIFO,支持参数化数据宽度和深度,适合多场景缓存。
|
|
||||||
|
|
||||||
## 仿真与验证
|
|
||||||
- `tb/enc_dec/oh_bin/oh2bin_tb.sv`:oh2bin编码器的时序仿真测试,支持自动化验证。
|
|
||||||
- `tb/fifo/sync/fifo_sync_tb.sv`:同步FIFO的功能仿真测试。
|
|
||||||
|
|
||||||
## 波形与调试
|
|
||||||
- 推荐使用VCS仿真,支持FSDB波形输出,便于使用Verdi/KDB调试。
|
|
||||||
|
|
||||||
## 快速仿真命令
|
|
||||||
见下方示例。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
# VCS仿真命令示例
|
|
||||||
|
|
||||||
## 1. 生成.f文件(文件列表)
|
|
||||||
|
|
||||||
- 默认各模块`.f`文件需要配置环境变量`IC_COM_DIR`为仓库根目录。
|
|
||||||
|
|
||||||
- `lib.f`:包含所有lib目录下的源文件
|
|
||||||
- `tb.f`:包含所有tb目录下的测试平台文件
|
|
||||||
|
|
||||||
## 2. 推荐VCS命令(含FSDB波形与KDB调试)
|
|
||||||
```sh
|
|
||||||
vcs -full64 -sverilog -debug_access+all +v2k +vcs+lic+wait \
|
|
||||||
-f lib.f -f tb.f \
|
|
||||||
-l vcs.log \
|
|
||||||
-kdb \
|
|
||||||
+fsdbfile+${USER}_sim.fsdb \
|
|
||||||
+fsdb+autoflush \
|
|
||||||
+vcsd \
|
|
||||||
+vcs+dumpvars+all \
|
|
||||||
+vcs+fsdbon \
|
|
||||||
+notimingcheck \
|
|
||||||
+define+FSDB \
|
|
||||||
+define+KDB
|
|
||||||
```
|
|
||||||
- 默认fsdb文件名为`${USER}_sim.fsdb`,可自动区分不同用户仿真结果。
|
|
||||||
- 支持KDB调试,推荐配合Verdi使用。
|
|
||||||
|
|
||||||
## 3. 运行仿真
|
|
||||||
```sh
|
|
||||||
./simv
|
|
||||||
```
|
|
|
@ -1,4 +0,0 @@
|
||||||
|
|
||||||
// doc/lib.f: ic_com库所有核心源文件,引用各子库f文件
|
|
||||||
lib/enc_dec/oh_bin/oh_bin.f
|
|
||||||
lib/fifo/sync/sync.f
|
|
|
@ -1,2 +0,0 @@
|
||||||
$IC_COM_DIR/lib/enc_dec/oh_bin/oh2bin.sv
|
|
||||||
$IC_COM_DIR/tb/enc_dec/oh_bin/oh2bin_tb.sv
|
|
|
@ -1,2 +0,0 @@
|
||||||
$IC_COM_DIR/lib/fifo/sync/fifo_sync.sv
|
|
||||||
$IC_COM_DIR/tb/fifo/sync/fifo_sync_tb.sv
|
|
4
doc/tb.f
4
doc/tb.f
|
@ -1,4 +0,0 @@
|
||||||
|
|
||||||
// doc/tb.f: ic_com库所有测试平台文件,引用各子库f文件
|
|
||||||
lib/enc_dec/oh_bin/oh_bin.f
|
|
||||||
lib/fifo/sync/sync.f
|
|
|
@ -1 +0,0 @@
|
||||||
// 已合并到 ../../../../lib/enc_dec/oh_bin/oh_bin.f
|
|
|
@ -1 +0,0 @@
|
||||||
// 已合并到 ../../../../lib/fifo/sync/sync.f
|
|
3
lib.f
3
lib.f
|
@ -1,3 +0,0 @@
|
||||||
// lib.f: ic_com库所有核心源文件
|
|
||||||
lib/enc_dec/oh_bin/oh2bin.sv
|
|
||||||
lib/fifo/sync/fifo_sync.sv
|
|
|
@ -1,44 +0,0 @@
|
||||||
|
|
||||||
// =============================================================
|
|
||||||
// 模块名称:oh2bin
|
|
||||||
// 功能描述:参数化 one-hot 到二进制编码器
|
|
||||||
// 参数:
|
|
||||||
// WIDTH - one-hot 输入宽度
|
|
||||||
// AREA_OPT- 1: 面积优化,0: 频率优化
|
|
||||||
// =============================================================
|
|
||||||
module oh2bin #(
|
|
||||||
parameter WIDTH = 8, // one-hot 输入宽度
|
|
||||||
parameter AREA_OPT = 1 // 1: 面积优化,0: 频率优化
|
|
||||||
)(
|
|
||||||
input logic [WIDTH-1:0] oh, // one-hot 输入
|
|
||||||
output logic [$clog2(WIDTH)-1:0] bin // 二进制输出
|
|
||||||
);
|
|
||||||
|
|
||||||
// =========================================================
|
|
||||||
// 面积优化方案:使用for循环,优先节省面积
|
|
||||||
// =========================================================
|
|
||||||
generate
|
|
||||||
if (AREA_OPT) begin : gen_area_opt
|
|
||||||
always_comb begin
|
|
||||||
bin = '0;
|
|
||||||
for (int i = 0; i < WIDTH; i++) begin
|
|
||||||
if (oh[i]) bin = i[$clog2(WIDTH)-1:0];
|
|
||||||
end
|
|
||||||
end
|
|
||||||
end else begin : gen_speed_opt
|
|
||||||
// =========================================================
|
|
||||||
// 频率优化方案:并行掩码法,参考pulp-platform/common_cells实现
|
|
||||||
// =========================================================
|
|
||||||
for (genvar j = 0; j < $clog2(WIDTH); j++) begin : gen_jl
|
|
||||||
logic [WIDTH-1:0] tmp_mask; //xinb:bin每1bit的掩码,实际上取巧了。相当于是逆向思维。还可以正向编码,待补充.
|
|
||||||
for (genvar i = 0; i < WIDTH; i++) begin : gen_il
|
|
||||||
logic [$clog2(WIDTH)-1:0] tmp_i;
|
|
||||||
assign tmp_i = i[$clog2(WIDTH)-1:0];
|
|
||||||
assign tmp_mask[i] = tmp_i[j];
|
|
||||||
end
|
|
||||||
assign bin[j] = |(tmp_mask & oh);
|
|
||||||
end
|
|
||||||
end
|
|
||||||
endgenerate
|
|
||||||
|
|
||||||
endmodule
|
|
3
tb.f
3
tb.f
|
@ -1,3 +0,0 @@
|
||||||
// tb.f: ic_com库所有测试平台文件
|
|
||||||
tb/enc_dec/oh_bin/oh2bin_tb.sv
|
|
||||||
tb/fifo/sync/fifo_sync_tb.sv
|
|
|
@ -1,78 +0,0 @@
|
||||||
// =============================================================
|
|
||||||
// 测试模块:oh2bin_tb
|
|
||||||
// 功能描述:onehot到bin编码器仿真测试,默认频率优化方案
|
|
||||||
// 仿真时钟频率:1GHz,周期1ns
|
|
||||||
// =============================================================
|
|
||||||
`timescale 1ns/1ps
|
|
||||||
|
|
||||||
module oh2bin_tb;
|
|
||||||
parameter WIDTH = 8;
|
|
||||||
parameter BINW = $clog2(WIDTH);
|
|
||||||
|
|
||||||
logic clk;
|
|
||||||
logic rst_n;
|
|
||||||
logic [WIDTH-1:0] oh;
|
|
||||||
logic [BINW-1:0] bin;
|
|
||||||
logic [BINW-1:0] bin_q;
|
|
||||||
|
|
||||||
// 实例化被测模块,AREA_OPT=0为频率优化方案
|
|
||||||
oh2bin #(
|
|
||||||
.WIDTH(WIDTH),
|
|
||||||
.AREA_OPT(0)
|
|
||||||
) dut (
|
|
||||||
.oh(oh),
|
|
||||||
.bin(bin)
|
|
||||||
);
|
|
||||||
|
|
||||||
// 时钟生成
|
|
||||||
// 仿真时钟频率:1GHz,周期1ns
|
|
||||||
initial clk = 0;
|
|
||||||
always #0.5 clk = ~clk; // 1ns周期,1GHz
|
|
||||||
|
|
||||||
// 采样输出
|
|
||||||
always_ff @(posedge clk or negedge rst_n) begin
|
|
||||||
if (!rst_n)
|
|
||||||
bin_q <= '0;
|
|
||||||
else
|
|
||||||
bin_q <= bin;
|
|
||||||
end
|
|
||||||
|
|
||||||
// 参考模型
|
|
||||||
function [BINW-1:0] ref_oh2bin(input [WIDTH-1:0] oh_in);
|
|
||||||
integer i;
|
|
||||||
ref_oh2bin = '0;
|
|
||||||
for (i = 0; i < WIDTH; i = i + 1) begin
|
|
||||||
if (oh_in[i]) ref_oh2bin = i[BINW-1:0];
|
|
||||||
end
|
|
||||||
endfunction
|
|
||||||
|
|
||||||
initial begin
|
|
||||||
rst_n = 0;
|
|
||||||
oh = '0;
|
|
||||||
#20;
|
|
||||||
rst_n = 1;
|
|
||||||
$display("==== oh2bin 频率优化方案时序仿真 ====");
|
|
||||||
for (int i = 0; i < WIDTH; i++) begin
|
|
||||||
@(negedge clk);
|
|
||||||
oh = '0;
|
|
||||||
oh[i] = 1'b1;
|
|
||||||
@(negedge clk);
|
|
||||||
if (bin_q !== ref_oh2bin(oh)) begin
|
|
||||||
$display("[ERROR] oh=%b, bin=%0d, ref=%0d", oh, bin_q, ref_oh2bin(oh));
|
|
||||||
end else begin
|
|
||||||
$display("[PASS] oh=%b, bin=%0d", oh, bin_q);
|
|
||||||
end
|
|
||||||
end
|
|
||||||
// 非法输入测试
|
|
||||||
@(negedge clk);
|
|
||||||
oh = '0;
|
|
||||||
@(negedge clk);
|
|
||||||
$display("[INFO] all zero input, bin=%0d", bin_q);
|
|
||||||
@(negedge clk);
|
|
||||||
oh = '1;
|
|
||||||
@(negedge clk);
|
|
||||||
$display("[INFO] all one input, bin=%0d", bin_q);
|
|
||||||
$display("==== 测试结束 ====");
|
|
||||||
$finish;
|
|
||||||
end
|
|
||||||
endmodule
|
|
|
@ -1,9 +1,4 @@
|
||||||
|
|
||||||
// =============================================================
|
|
||||||
// 测试模块:fifo_sync_tb
|
|
||||||
// 功能描述:同步FIFO仿真测试
|
|
||||||
// 仿真时钟频率:1GHz,周期0.5ns
|
|
||||||
// =============================================================
|
|
||||||
`timescale 1ns/1ps
|
`timescale 1ns/1ps
|
||||||
|
|
||||||
module fifo_sync_tb;
|
module fifo_sync_tb;
|
||||||
|
@ -42,10 +37,9 @@ module fifo_sync_tb;
|
||||||
.err(err)
|
.err(err)
|
||||||
);
|
);
|
||||||
|
|
||||||
// 仿真时钟频率:1GHz,周期0.5ns
|
|
||||||
// 时钟生成
|
// 时钟生成
|
||||||
initial clk = 0;
|
initial clk = 0;
|
||||||
always #0.25 clk = ~clk; // 0.5ns周期,1GHz
|
always #5 clk = ~clk;
|
||||||
|
|
||||||
// 复位
|
// 复位
|
||||||
initial begin
|
initial begin
|
||||||
|
|
Loading…
Reference in New Issue