HDL 助理示範 · HDL assistant demo
以下是羲和 HDL 助理(地端單卡版:開放模型 gpt-oss-120b,Apache-2.0,加上模擬器回饋自動修正)的實際輸出,沒有經過人工修改。 每一題都用開源模擬器和我們自己寫的 testbench 驗證;編譯或模擬出錯時,系統會把錯誤訊息回饋給模型重寫,最多 2 次。 測試機器:一張 NVIDIA RTX PRO 6000(96 GB),時間是單人使用時的實測。
Unedited outputs of the HeliosLM HDL assistant (single-GPU on-prem build: open model gpt-oss-120b + simulator-feedback repair, up to 2 retries), each checked with open-source simulators against our own testbenches. Prompts, answers, testbenches and logs: Hugging Face.
UVM testbench 自動產生仍在開發中,尚未放上示範。UVM testbench generation is still in development and not shown here.
Verilog:同步 FIFO · Verilog: synchronous FIFO
問題
請用 Verilog-2001 寫一個同步 FIFO,模組名稱 sync_fifo,參數 WIDTH=8、DEPTH=16。 埠:clk、rst_n(非同步、低態有效重置)、wr_en、din[WIDTH-1:0]、rd_en、dout[WIDTH-1:0](暫存器輸出)、full、empty。 規格: - wr_en=1 且 FIFO 未滿時,在 clk 上升緣寫入 din;FIFO 滿時寫入被忽略(即使同一拍也在讀)。 - rd_en=1 且 FIFO 非空時,在 clk 上升緣把最舊的一筆放到 dout;FIFO 空時讀取被忽略(即使同一拍也在寫);沒有讀取時 dout 保持不變。 - 同一拍可以同時讀寫。 - full、empty 依目前資料筆數直接輸出(組合邏輯)。
過程
- 模型作答(34 秒)→ 模擬通過
驗證:Icarus Verilog 12 模擬,我們自己寫的 testbench:4,000 個時脈隨機讀寫(含寫滿、讀空、同時讀寫),逐拍比對 dout、full、empty。 結果 RESULT errors=0 cycles=4000。總時間約 34 秒。
模型的說明(節錄)
以下簡述此同步 FIFO 的設計要點,並給出完整的 Verilog‑2001 模組程式碼。 - 使用雙指標寫入/讀出與計數器 `count` 來追蹤 FIFO 內的資料筆數。 - `full` 與 `empty` 直接由 `count` 產生,為純組合邏輯。 - 在同一個上升緣可同時讀寫;若 FIFO 已滿則寫入被忽略,若 FIFO 已空則讀取被忽略。 - 非同步低電平有效復位 `rst_n` 會同步清除所有暫存與指標。
最終程式碼(64 行)
//====================================================================
// sync_fifo
// 同步 FIFO (WIDTH=8, DEPTH=16) - Verilog-2001
//====================================================================
module sync_fifo #(
parameter WIDTH = 8,
parameter DEPTH = 16
)(
input wire clk,
input wire rst_n, // 非同步、低電平有效復位
input wire wr_en,
input wire [WIDTH-1:0] din,
input wire rd_en,
output reg [WIDTH-1:0] dout, // 註冊輸出
output wire full,
output wire empty
);
// 計算指標與計數寬度
localparam ADDR_W = $clog2(DEPTH); // 地址位元寬度
localparam CNT_W = $clog2(DEPTH+1); // 計數位元寬度,可容納 0~DEPTH
// 記憶體、指標與計數
reg [WIDTH-1:0] mem [0:DEPTH-1];
reg [ADDR_W-1:0] wr_ptr;
reg [ADDR_W-1:0] rd_ptr;
reg [CNT_W-1:0] count;
// full / empty 為組合邏輯輸出
assign full = (count == DEPTH);
assign empty = (count == 0);
// 同步寫入、讀出與計數更新
always @(posedge clk or negedge rst_n) begin
if (!rst_n) begin
wr_ptr <= {ADDR_W{1'b0}};
rd_ptr <= {ADDR_W{1'b0}};
count <= {CNT_W{1'b0}};
dout <= {WIDTH{1'b0}};
end else begin
// ---------- 寫入 ----------
if (wr_en && !full) begin
mem[wr_ptr] <= din;
wr_ptr <= wr_ptr + 1'b1; // 自動環繞
end
// ---------- 讀出 ----------
if (rd_en && !empty) begin
dout <= mem[rd_ptr];
rd_ptr <= rd_ptr + 1'b1; // 自動環繞
end
// ---------- 計數更新 ----------
// w_valid = 實際執行的寫入,r_valid = 實際執行的讀取
case ({wr_en && !full, rd_en && !empty})
2'b10: count <= count + 1'b1; // 只寫入
2'b01: count <= count - 1'b1; // 只讀取
default: count <= count; // 同時寫讀或均未執行,計數不變
endcase
end
end
endmodule
//====================================================================SystemVerilog:round-robin 仲裁器+SVA 斷言 · SystemVerilog: round-robin arbiter with SVA
問題
請用 SystemVerilog 寫一個 4 路 round-robin 仲裁器,模組名稱 rr_arbiter。 埠:clk、rst_n(非同步、低態有效重置)、req[3:0]、gnt[3:0]。 規格: - gnt 是組合邏輯:從「上次獲得授權的編號 + 1」開始往上找(3 之後回到 0),第一個 req 為 1 的取得授權,gnt 為 one-hot;沒有任何 req 時 gnt=0。 - 只要這一拍有授權,就在 clk 上升緣記住這次授權的編號。 - 重置後視為上次授權給 3(所以 req[0] 優先)。 - 請用 always_ff/always_comb,並加上 SVA 斷言:gnt 最多只有一個 1,而且只會授權給 req 為 1 的位元。
過程
- 模型作答(68 秒)→ 編譯失敗
%Error: dut.sv:19:21: syntax error, unexpected IDENTIFIER, expecting "'{" 19 | logic [3:0] grant_tmp; | ^~~~~~~~~ ... See the manual at https://verilator.org/verilator_doc.html?v=5.052 for more assistance. - 模型作答(79 秒)→ 模擬通過
驗證:Verilator 5.052(--assert,模型寫的 SVA 也一起檢查),我們自己寫的 testbench:3,000 個時脈隨機 req,逐拍比對 gnt。 結果 RESULT errors=0 cycles=3000。總時間約 146 秒。
模型的說明(節錄)
**說明** * 先將「從上一次授權的編號+1」開始搜尋的組合邏輯抽成 `calc_gnt` 函式,避免在 `always_comb` 內直接宣告變數(Verilator 5.052 在此情況會產生語法錯誤)。 * `last_grant_idx` 於每一次有授權產生時於上升緣更新。 * 非同步低電位有效的 `rst_n` 於復位時把 `last_grant_idx` 設為 **3**,因此復位後 `req[0]` 具有最高優先權。 * 加入兩條 SystemVerilog Assertion (SVA): 1. `gnt` 只能是 at‑most‑one‑hot (`$onehot0`). 2. 若 `gnt[i]` 為 1,對應的 `req[i]` 必須為 1。
最終程式碼(85 行)
module rr_arbiter (
input logic clk,
input logic rst_n, // 非同步、低電位有效
input logic [3:0] req,
output logic [3:0] gnt
);
// -----------------------------------------------------------------
// 上一次授權的編號 (2 位元, 0~3)
// -----------------------------------------------------------------
logic [1:0] last_grant_idx;
// -----------------------------------------------------------------
// 組合邏輯:根據 last_grant_idx 計算 one‑hot gnt
// -----------------------------------------------------------------
// 功能:從 start (last_grant_idx+1) 開始循環搜尋第一個 req=1 的位元
function automatic logic [3:0] calc_gnt (
input logic [1:0] start,
input logic [3:0] req_vec
);
logic [3:0] gnt_local;
logic found;
gnt_local = 4'b0;
found = 1'b0;
for (int i = 0; i < 4; i++) begin
int idx = (start + i) & 2'b11; // 等同於 modulo 4
if (!found && req_vec[idx]) begin
gnt_local[idx] = 1'b1;
found = 1'b1;
end
end
return gnt_local;
endfunction
// 組合路徑
always_comb begin
// 起始搜尋位置 = (last_grant_idx + 1) mod 4
logic [1:0] start_ptr;
start_ptr = (last_grant_idx + 2'b01) & 2'b11;
gnt = calc_gnt(start_ptr, req);
end
// -----------------------------------------------------------------
// 時序邏輯:在有授權的拍次更新 last_grant_idx
// -----------------------------------------------------------------
always_ff @(posedge clk or negedge rst_n) begin
if (!rst_n) begin
// 復位後視為上一次授權給 3,故下一拍優先考慮 0
last_grant_idx <= 2'd3;
end else begin
if (|gnt) begin // 只在有授權時更新
case (gnt)
4'b0001: last_grant_idx <= 2'd0;
4'b0010: last_grant_idx <= 2'd1;
4'b0100: last_grant_idx <= 2'd2;
4'b1000: last_grant_idx <= 2'd3;
default: ; // 只要 gnt 為 one‑hot,此 case 已覆蓋全部情形
endcase
end
end
end
// -----------------------------------------------------------------
// SVA 斷言
// -----------------------------------------------------------------
// 1. gnt 必須是 at‑most‑one‑hot(0 or 1 個 1)
property p_gnt_onehot;
@(posedge clk) disable iff (!rst_n) $onehot0(gnt);
endproperty
assert property (p_gnt_onehot)
else $error("Assertion failed: gnt 必須是 at‑most‑one‑hot (0 或 1 個 1)");
// 2. 若某位元被授權,對應的 req 必須為 1
generate
for (genvar i = 0; i < 4; i++) begin : gen_req_match
assert property (
@(posedge clk) disable iff (!rst_n) (gnt[i] |-> req[i])
)
else $error("Assertion failed: gnt[%0d] asserted while req[%0d]=0", i, i);
end
endgenerate
endmodule讀真實 RTL 找 bug:OpenTitan UART 傳送模組 · Bug hunt in real RTL: OpenTitan UART transmitter
問題
這是開源 OpenTitan 專案(lowRISC,Apache-2.0)的 UART 傳送模組 uart_tx。我們改過其中一行之後,開啟 parity 時接收端常收到 framing error。請用繁體中文說明這個模組怎麼運作,找出 bug,並給出修正後的完整模組。
```systemverilog
// Copyright lowRISC contributors (OpenTitan project).
// Licensed under the Apache License, Version 2.0, see LICENSE for details.
// SPDX-License-Identifier: Apache-2.0
//
// Description: UART Transmit Module
//
module uart_tx (
input clk_i,
input rst_ni,
input tx_enable,
input tick_baud_x16,
input logic parity_enable,
input wr,
input logic wr_parity,
input [7:0] wr_data,
output idle,
output logic tx
);
logic [3:0] baud_div_q;
logic tick_baud_q;
logic [3:0] bit_cnt_q, bit_cnt_d;
logic [10:0] sreg_q, sreg_d;
logic tx_q, tx_d;
assign tx = tx_q;
always_ff @(posedge clk_i or negedge rst_ni) begin
if (!rst_ni) begin
baud_div_q <= 4'h0;
tick_baud_q <= 1'b0;
end else if (tick_baud_x16) begin
{tick_baud_q, baud_div_q} <= {1'b0,baud_div_q} + 5'h1;
end else begin
tick_baud_q <= 1'b0;
end
end
always_ff @(posedge clk_i or negedge rst_ni) begin
if (!rst_ni) begin
bit_cnt_q <= 4'h0;
sreg_q <= 11'h7ff;
tx_q <= 1'b1;
end else begin
bit_cnt_q <= bit_cnt_d;
sreg_q <= sreg_d;
tx_q <= tx_d;
end
end
always_comb begin
if (!tx_enable) begin
bit_cnt_d = 4'h0;
sreg_d = 11'h7ff;
tx_d = 1'b1;
end else begin
bit_cnt_d = bit_cnt_q;
sreg_d = sreg_q;
tx_d = tx_q;
if (wr) begin
sreg_d = {1'b1, (parity_enable ? wr_parity : 1'b1), wr_data, 1'b0};
bit_cnt_d = (parity_enable ? 4'd10 : 4'd11);
end else if (tick_baud_q && (bit_cnt_q != 4'h0)) begin
sreg_d = {1'b1, sreg_q[10:1]};
tx_d = sreg_q[0];
bit_cnt_d = bit_cnt_q - 4'h1;
end
end
end
assign idle = (tx_enable) ? (bit_cnt_q == 4'h0) : 1'b1;
endmodule
```
過程
- 模型作答(87 秒)→ 模擬通過
驗證:Verilator 5.052,我們自己寫的 testbench:300 個隨機 UART 框架(有/無 parity),逐位元解碼 tx 線並檢查起始位、資料、parity、停止位與 idle 時間。原始 OpenTitan 模組通過、植入 bug 的版本失敗(377 個錯誤),模型修正後通過。 結果 RESULT errors=0 frames=300。總時間約 87 秒。
模型的說明(節錄)
**模組說明** `uart_tx` 以 16 倍過採樣的時脈 `tick_baud_x16` 產生每個波特的「一次」脈衝 `tick_baud_q`,作為移位的時機。 * `sreg_q` (11 bit) 保存完整的 UART 框架:**停止位 1**, **奇偶位 (若啟用)**, **資料位 8** (LSB 先送), **起始位 0**。 * `bit_cnt_q` 記錄尚未送出的位元數,當 `bit_cnt_q==0` 時表示傳送完畢,`idle` 會被拉高。 * `wr` 將新資料與奇偶位裝入 `sreg_q`,同時根據是否使用奇偶位設定 `bit_cnt_d`。 * 每一次 `tick_baud_q` 且 `bit_cnt_q!=0` 時,將 `sreg_q[0]` 輸出到 `tx`,然後右移 `sreg_q`,同時 `bit_cnt_q` 扣 1。 **發現的 bug** 在載入新傳送框架時,`bit_cnt_d` 的設定與奇偶位的有無相反: ```systemverilog bit_cnt_d = (parity_enable ? 4'd10 : 4'd11); ``` - 當 **奇偶位啟用** 時,實際需要傳送 **11 個位元**(起始 + 8 資料 + 奇偶 + 停止),但程式只給 10 個計數,導致最後的停止位未被送出,接收端會偵測到 *framing error*。 - 反向的情況(不使用奇偶位)則多送出一個額外的高位,雖不會造成錯誤,但仍不符合規格。 **修正方式** 把條件反過來,使奇偶位啟用時計數 11,未啟用時計數 10: ```systemverilog bit_cnt_d = (parity_enable ? 4'd11 : 4'd10); ``` **重點** - 只改了 `bit_cnt_d` 的條件判斷,其他邏輯保持不變。 - 這樣在啟用奇偶位時會正確送出完整的 **起始‑資料‑奇偶‑停止** 11 個位元,接收端的 framing error 也隨之消失。
最終程式碼(97 行)
// Copyright lowRISC contributors (OpenTitan project).
// Licensed under the Apache License, Version 2.0, see LICENSE for details.
// SPDX-License-Identifier: Apache-2.0
//
// Description: UART Transmit Module (fixed parity‑bit count)
//
module uart_tx (
input clk_i,
input rst_ni,
input tx_enable,
input tick_baud_x16,
input logic parity_enable,
input wr,
input logic wr_parity,
input logic [7:0] wr_data,
output logic idle,
output logic tx
);
// -----------------------------------------------------------------
// 16×baud tick generator : one‑cycle pulse every 16 clocks
// -----------------------------------------------------------------
logic [3:0] baud_div_q;
logic tick_baud_q;
always_ff @(posedge clk_i or negedge rst_ni) begin
if (!rst_ni) begin
baud_div_q <= 4'h0;
tick_baud_q <= 1'b0;
end else if (tick_baud_x16) begin
// 5‑bit counter, MSB = carry → one‑pulse every 16 cycles
{tick_baud_q, baud_div_q} <= {1'b0, baud_div_q} + 5'h1;
end else begin
tick_baud_q <= 1'b0;
end
end
// -----------------------------------------------------------------
// Shift register & bit counter
// -----------------------------------------------------------------
logic [3:0] bit_cnt_q, bit_cnt_d;
logic [10:0] sreg_q, sreg_d;
logic tx_q, tx_d;
assign tx = tx_q;
always_ff @(posedge clk_i or negedge rst_ni) begin
if (!rst_ni) begin
bit_cnt_q <= 4'h0;
sreg_q <= 11'h7ff; // idle = all ‘1’
tx_q <= 1'b1;
end else begin
bit_cnt_q <= bit_cnt_d;
sreg_q <= sreg_d;
tx_q <= tx_d;
end
end
// -----------------------------------------------------------------
// Combinational control logic
// -----------------------------------------------------------------
always_comb begin
// Default: keep current state
bit_cnt_d = bit_cnt_q;
sreg_d = sreg_q;
tx_d = tx_q;
if (!tx_enable) begin
// TX disabled → force idle line
bit_cnt_d = 4'h0;
sreg_d = 11'h7ff;
tx_d = 1'b1;
end
else if (wr) begin
// Load new frame: {stop, parity?, data[7:0], start}
sreg_d = {1'b1, (parity_enable ? wr_parity : 1'b1), wr_data, 1'b0};
// Fixed bug: correct bit‑count for parity case
bit_cnt_d = (parity_enable ? 4'd11 : 4'd10);
end
else if (tick_baud_q && (bit_cnt_q != 4'h0)) begin
// Transmit next bit
sreg_d = {1'b1, sreg_q[10:1]}; // shift right, inject stop=1 at MSB
tx_d = sreg_q[0]; // current LSB goes to tx line
bit_cnt_d = bit_cnt_q - 4'h1;
end
end
// -----------------------------------------------------------------
// Idle indicator
// -----------------------------------------------------------------
assign idle = tx_enable ? (bit_cnt_q == 4'h0) : 1'b1;
endmodule說明 · Notes
- OpenTitan 的 uart_tx.sv 版權屬 lowRISC contributors,Apache-2.0 授權;示範裡的 bug 是我們故意改的一行,不是 OpenTitan 原本的問題。
- 這三題各跑了 3 次,羲和 HDL 助理 3 次都通過;第 2 題有時第一次會用到 Verilator 不支援的寫法,靠錯誤訊息回饋在 1–2 次內修好。
- 模擬器:Icarus Verilog 12、Verilator 5.052(都是開源工具)。實際效果依題目與規格清楚程度而不同。