← HeliosLM HDL · HeliosLM 首頁

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 依目前資料筆數直接輸出(組合邏輯)。

過程

  1. 模型作答(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 的位元。

過程

  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.
  2. 模型作答(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
```

過程

  1. 模型作答(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