跳至主要内容

執行第一個 Flow

TUT02 · Terminux · 繁體中文影片

影片​

在 YouTube 開啟影片

指南​

Tutorial 02(S01–S07):使用 Terminux AI 執行第一個 IC 設計流程

熟悉的 Terminal,不變的操作習慣。· 每一個 Terminal Action,AI 都能感知。

本課會做什麼

  1. 啟動 Terminux,像一般 Terminal 一樣使用。
  2. 問 AI GCD 設計檔在哪裡,再自己核對。
  3. 執行 GCD Flow,找到它的 receipt 與 Run ID。
  4. 綁定這次 Run,問 AI 哪些品質檢查需要注意,再到 DQE Viewer 與 Report 核對。
  5. 問 AI 下一步要檢查什麼。

本課影片: 繁體中文(07:14.0)/English(07:15.4)。下方時間碼以繁體中文影片為準,English 影片寫在括號內。

開始前:先看懂這些 EDA 工具各做什麼

本課使用一套開源的 RTL-to-GDS Flow 當實例。你不需要先學會 Yosys/OpenROAD 的指令才能跟著做,但要先知道它們位於 IC Design Flow 的哪個階段,才看得懂後面的結果。下方的商用工具是工作階段/用途對照,不表示工具可直接互換,也不表示分析精度或 Signoff 能力相同。

整體流程: GCD RTL → Yosys(Synthesis)→ OpenROAD(Physical Implementation)→ KLayout(GDS 完成/合併)→ GDS。ORFS 串接上述 Flow;Terminux 則是用來操作、保存 Run Evidence、查看 DQE 與詢問 AI 的工作環境,不是 GDS 之後的另一個 EDA 階段。

工具/名詞 在這堂課做什麼 對應 Cadence/Synopsys 的哪一部分
ORFS — OpenROAD Flow Scripts 是串起各階段的自動化 Flow Scripts,不是單獨的 Synthesis 或 Place-and-Route Engine。用一個流程命令跑 GCD 範例。 類似企業內部串接 RTL-to-GDS 的 Design Flow/Scripts,不直接等同某一套 EDA 軟體。
Yosys 開源的 Logic Synthesis 工具,把 RTL 轉成對應標準元件 Library 的 Gate-level Netlist。 Cadence Genus;Synopsys Design Compiler。
OpenROAD 開源 Physical Implementation 工具,進行 Floorplan、Placement、CTS(Clock Tree Synthesis)、Timing Optimization、Routing 等。 Cadence Innovus、Synopsys IC Compiler II 的 Physical Implementation 工作階段。
OpenSTA OpenROAD 生態系使用的 Static Timing Analysis(STA) Engine,用於計算 Setup/Hold、Slack、WNS 等;這堂課不需自行啟動它。 Cadence Tempus、Synopsys PrimeTime 的 STA 工作內容;不是商用 Signoff 能力等同聲明。
KLayout 在本次錄製的 ORFS Run 中,使用 KLayout 0.28.16 合併 GDS 資料,產生 6_final.gds。KLayout 也能檢視/分析 Layout,但本影片沒有展示 Layout Viewer。 對照商用 Flow 中的 GDS 輸出、版圖檢視/部分驗證工作;沒有精確的一對一商用產品對應。
Terminux + DQE Viewer 本片真正要教的使用介面:在 Terminal 執行 Flow、保存 Run/Evidence、檢查 Design Quality,再向 AI 詢問下一步。 位於 EDA 工具外層的工程操作與分析工作流程,並非要取代 Genus、Innovus 或 Signoff Tools。

跨階段整合平台: Cadence Innovus+ 與 Synopsys Fusion Compiler 都涵蓋 Synthesis 與 Physical Implementation,因此不把它們歸類成 Yosys 或 OpenROAD 的單一階段對應工具。以上是工作階段類比,不代表功能、精度或 Signoff 能力相同。

這次使用的 GCD 是範例 RTL Design,Nangate45 是本 Run 所選的參考 Technology/Platform;兩者都不是 EDA Tool。**Flow 會使用 SDC Timing Constraint;這堂課只核對 SDC_FILE 指向的路徑,不在該步驗證 Timing Constraint 的正確性。**之後執行 Flow,再查看 DQE 的 FAIL/WARNING。Flow 執行完成(exit 0)不代表 Timing 或 Signoff 已經通過。

到了步驟 12 請注意: --yosys-exe 是指定 Synthesis Tool;--openroad-exe 是指定 Physical Design Tool;terminux-orfs-run 用這些工具執行 ORFS Flow,並留下可供 DQE Viewer 與 AI 分析的 Run 證據。

官方參考:OpenROAD Flow User Guide、Yosys、OpenROAD、Cadence Genus、Synopsys Design Compiler、Cadence Innovus+、Cadence Innovus Training、Synopsys Fusion Compiler、Synopsys IC Compiler II、OpenSTA、KLayout。

  • 影片: 工具鏈導入段 00:49.4–01:32.9[00:48.9–01:35.9]:ORFS 00:49.8[00:49.3]、Yosys 00:59.3[00:59.3]、OpenROAD 01:09.3[01:11.3]、KLayout 01:19.3[01:22.8]、Terminux 01:23.9[01:27.9]。

需要準備什麼

  • 你的帳號已安裝 Terminux(含 DQE Viewer)。
  • 管理者已為你的帳號啟用 Terminux AI(允許綁定 Run 的具名 Profile)。
  • 一份含 GCD 設計的 ORFS checkout,以及該 ORFS 環境可使用的 OpenROAD、Yosys、KLayout。KLayout 可能已由 ORFS 工具環境提供;若 Flow 能定位它,不一定要另外安裝,也不一定要在互動 Shell 的 PATH 中。
  • S06–S07 需要能將綁定 Run 提供給 AI 的版本與 Profile 設定;開始前請確認這項能力。

各項目前的狀態見附錄。

命令怎麼看

命令都照影片中實際輸入的內容列出。/data/tut02/… 是本片錄製時的示範環境路徑,請換成你自己的 ORFS 與工具安裝路徑。步驟中另外列出的「在你的機器上」命令是需要依環境調整的範本,影片中沒有以那個形式輸入。

@@ 後面的文字是交給 Terminux,不是交給 Shell,Shell 變數在這裡不會展開(已實測,見步驟 14)。@@ 命令中一律使用完整的絕對路徑。

下面引用的 AI 回答,是錄影中真實英文回答的逐字摘錄,附「重點翻譯」(翻譯不是 AI 原文)。你自己操作時,回答的用字可能會不同;各步驟會說明如何自己核對事實。


S01 · 開始工作:像平常一樣啟動 Terminal

步驟 1:在 flow 目錄啟動 Terminux
  • 目的: 從平常使用的 Terminal,在要工作的目錄中啟動 Terminux。
  • 在哪裡與前置條件: 作業系統一般的 Terminal;已安裝 Terminux。
  • 操作:
    cd /data/tut02/runtime/orfs/flow
    terminux-launch
    
    這是影片中的示範環境路徑;請換成你自己的 ORFS flow/ 目錄。
  • 可觀察結果: Terminux 視窗出現。錄影中視窗以預設大小開啟;之後放大視窗、調大字體的部分,影片已剪掉。
  • 如何核對: 視窗中出現 Shell 提示字元 $。
  • 沒看到時: 找不到 terminux-launch,表示你的帳號尚未安裝 Terminux,請停下來詢問管理者。不要用 sudo。
  • 請用步驟 2 確認目前的工作目錄。
  • 影片: 00:02.5;約 00:12.5 視窗出現。

Terminux 視窗出現

另見 guide_frames/G01_launch_command.png。

步驟 2:照平常的方式使用 Shell
  • 目的: Terminux 就是 Terminal。熟悉的命令,不變的習慣。
  • 在哪裡與前置條件: Terminux 視窗。
  • 操作:
    pwd
    ls
    
  • 可觀察結果: pwd 印出目前目錄,ls 列出 ORFS flow 的內容。錄影中的輸出: BUILD Makefile README.md designs docs platforms scripts settings.mk test tutorials util
  • 如何核對: 看得到 designs 與 platforms,表示目前位在 ORFS 的 flow/ 目錄。
  • 沒看到時: 先 cd 到你的 flow/ 目錄再繼續。
  • 影片: 00:14.8–00:30.8。品牌卡在 00:30.8–00:49.4[00:30.8–00:48.9]。
  • 截圖: guide_frames/G03_pwd_ls.png。

S02 · Q1:用 @@ 找出設計與設定

從這裡開始是另一個 session(轉場卡在 01:32.9[01:35.9])。

步驟 3:用 @@ 問 AI
  • 目的: 在提示字元直接問 AI,不必離開 Terminal。
  • 在哪裡與前置條件: Terminux Prompt;你的帳號已啟用 AI。
  • 操作: 輸入 @@,後面直接接問題,按 Enter。
    @@I'm going to run the GCD design in ORFS using Nangate45. Where are its RTL and flow configuration, and how can I check them?
    
  • 可觀察結果: Terminal 上方的 Notification Bar 先顯示 Q: I'm going to run the GCD design…,接著顯示回答。
  • 如何核對: 通知列中出現你的問題。
  • 沒看到時: 可能是你的帳號尚未啟用 AI,這是管理者的設定。
  • 影片: 場景 01:36.4[01:39.4];輸入 01:43.2[01:46.2];通知列 01:44.6[01:47.6]。
  • 截圖: guide_frames/G04_q1_typed.png、guide_frames/G05_q1_sent_panel.png。
步驟 4:閱讀回答
  • 目的: 知道要去哪裡找。

  • 可觀察結果: 回答在 Notification Bar 展開。開頭幾行(英文逐字):

    In a standard ORFS checkout, run from the flow/ directory:

    • GCD RTL: designs/src/gcd/gcd.v
    • GCD flow/design config: designs/nangate45/gcd/config.mk
    • GCD timing constraints: designs/nangate45/gcd/constraint.sdc

    重點翻譯:在標準的 ORFS checkout 中,從 flow/ 目錄看:GCD 的 RTL 是 designs/src/gcd/gcd.v;GCD 的 Flow/設計設定是 designs/nangate45/gcd/config.mk;GCD 的時序約束是 designs/nangate45/gcd/constraint.sdc。

  • 如何核對: 步驟 5 用你的檔案核對這些路徑。

  • 沒看到時: 回答出現約 5 秒後,通知列會收合成標題列,例如 4 notifications。要重看全文,請見步驟 10。

  • 影片: 01:47.1[01:50.1]。影片略過部分等待回答的時間。

  • 截圖: guide_frames/G06_q1_answer_expanded.png。

步驟 5:自己打開實際的檔案
  • 目的: 回答告訴你去哪裡找,你再用實際的檔案確認。
  • 在哪裡與前置條件: 你的 ORFS flow/ 目錄。
  • 操作:
    cd /data/tut02/runtime/orfs/flow
    
    影片中的示範環境路徑;請換成你自己的 flow/ 路徑。
    ls designs/src/gcd designs/nangate45/gcd
    head -n 20 designs/src/gcd/gcd.v
    
    (路徑相對於 flow/。)
  • 可觀察結果:
    • designs/nangate45/gcd 內有 config.mk 與 constraint.sdc。
    • designs/src/gcd 內有 gcd.v。
    • head 顯示 RTL 的開頭(module gcd)。
  • 如何核對: 步驟 4 回答中的三個路徑都存在。
  • 沒看到時: 表示你的 checkout 和標準的不同。以你的檔案為準,不以回答為準。
  • 影片: ls 約在 01:59.8[02:02.8];head 的輸出約在 02:00.1[02:03.1]可見(打字過程沒有拍進影片)。
  • 截圖: guide_frames/G07_ls_design_dirs.png、guide_frames/G07b_head_gcd_v.png。

S03 · Q2:選字 → Ask AI about this → 再用 @@ 追問

兩種不同的提問方式:

  • 選取文字,再按右鍵 → Ask AI about this。 選取的文字本身就是問題;這個選單不能另外輸入問句。
  • 輸入 @@ 問句。 這是另一個獨立、自己輸入的回合。
步驟 6:顯示設定檔並選取一行
  • 目的: 選一個真實的設定來問。
  • 操作:
    cat designs/nangate45/gcd/config.mk
    
    接著用滑鼠選取以 export SDC_FILE 開頭的整行:
    export SDC_FILE      = $(DESIGN_HOME)/$(PLATFORM)/$(DESIGN_NAME)/constraint.sdc
    
    cat 不會印出行號。這個檔案中它是第 5 行,前面依序是 export DESIGN_NAME、export PLATFORM、一個空行與 export VERILOG_FILES。
  • 可觀察結果: 這一行被反白;反白只畫到文字結尾。
  • 如何核對: 只有這一行被反白。
  • 以滑鼠拖曳過輸出以選取文字(步驟 14)。
  • 影片: 02:00.0[02:03.0];約 02:13.4[02:16.4]選取完成。

已選取 export SDC_FILE 這一行

步驟 7:按右鍵 → Ask AI about this
  • 目的: 選取的文字就是問題,不必重新輸入。

  • 操作: 在 Terminal 內按右鍵,選擇選單最後一項 Ask AI about this。

  • 可觀察結果: Notification Bar 先顯示選取的那一行,接著顯示回答。英文逐字摘錄:

    This looks like a line from an ORFS config.mk (or a platform/design config) that sets the SDC path.

    重點翻譯:這看起來是 ORFS config.mk(或平台/設計設定檔)中設定 SDC 路徑的一行。

  • 如何核對: 通知列顯示的問題就是你選取的那一行。

  • 沒看到時: 選單項目是灰色的,表示沒有選取文字,請重做步驟 6。

  • 影片: 選單約在 02:15.7[02:18.7];回答在 02:18.2[02:21.2]。

  • 截圖: guide_frames/G10_selection_answer.png。

右鍵選單中的 Ask AI about this

步驟 8:回到檔案核對回答
  • 目的: AI 解釋了這一行,接著由你核對能自己確認的部分。

  • 真實回答(英文逐字摘錄):

    With the usual GCD/Nangate45 settings (DESIGN_HOME = ./designs, PLATFORM = nangate45, DESIGN_NAME = gcd) it expands to ./designs/nangate45/gcd/constraint.sdc, i.e. the path I mentioned earlier.

    I can't verify your local checkout or branch from here

    重點翻譯:以常見的 GCD/Nangate45 設定(DESIGN_HOME = ./designs、PLATFORM = nangate45、DESIGN_NAME = gcd),它會展開成 ./designs/nangate45/gcd/constraint.sdc,也就是我先前提到的路徑。……我無法從這裡驗證你本機的 checkout 或分支。

  • 如何核對(對照步驟 6 的 cat 輸出;與影片核對卡的項目相同):

    • ✓ 檔案中有 export PLATFORM = nangate45 這一行(第 2 行)。
    • ✓ 檔案中有 export DESIGN_NAME = gcd 這一行(第 1 行)。
    • ⓘ DESIGN_HOME 本檔沒有設定,AI 假設為常見的 ./designs。
    • ✓ constraint.sdc 列在 designs/nangate45/gcd/ 中(步驟 5)。
  • 範圍: 這裡只核對 SDC_FILE 的路徑引用,不核對 clock period、WNS 或 Timing Signoff。

  • 影片: 核對卡在 02:37.1[02:40.1]。

步驟 9:用 @@ 追問
  • 目的: 用自己輸入的問題,接續同一段對話。

  • 操作:

    @@How could this timing setting affect the results we inspect after the GCD flow?
    
  • 可觀察結果: Notification Bar 顯示新的回答,開頭是(英文逐字):

    No orchestration run ID came with this question, so there's no recorded evidence bundle for me to query — the following is how SDC_FILE behaves in ORFS generally, and what to re-check in the reports afterwards.

    重點翻譯:這個問題沒有附上 orchestration run ID,所以沒有已記錄的證據包可以查詢;以下說明 SDC_FILE 在 ORFS 中一般的作用,以及之後在報告中要再檢查什麼。

  • 如何核對:

    • 追問只寫 this timing setting,沒有再次提到 SDC_FILE;但回答接著解釋 SDC_FILE 在 ORFS 中的作用。這就是你在畫面上能核對的對話延續。
    • 回答也指出這個問題沒有附上 Run ID。這是正確的:這時還沒綁定任何 Run,綁定在步驟 14。
  • 沒看到時: 回答完全沒有提到 SDC_FILE,表示追問沒有接上步驟 7。請確認你是在同一個 Terminux 視窗中提問。

  • 影片: 輸入 02:55.1[02:58.1];回答約在 03:03.9[03:06.9]。

  • 截圖: guide_frames/G11_followup_typed.png、guide_frames/G12_followup_answer.png。

步驟 10:重看已收合的回答(Notification Bar)
  • 目的: 回答不會一直展開。長回答(例如 Q3、Q4)需要用到這個方法。
  • 可觀察結果: 回答出現約 5 秒後,如果滑鼠不在通知列上,通知列會收合成標題列,例如 4 notifications。
  • 操作:
    1. 打開: 點標題列上的文字(例如 4 notifications),或在 Terminal 內按右鍵,選 Notification Bar ▸ Show。
    2. 保持展開: 把滑鼠游標停在通知列上,它就不會收合;游標離開約 5 秒後收合。
    3. 捲動: 在通知列上轉動滑鼠滾輪,在各則訊息之間移動。標題那一行永遠顯示最新的一則;下面的清單打開時,可能停在最新一則,也可能停在較早的訊息。
    4. 拉高(可選): 拖曳通知列的下緣往下拉。拉高後通知列會保持展開,也會蓋住 Terminal 最上面幾行。
    5. 收合: 點標題列。剛拉高後的第一下點擊可能沒有反應,再點一次即可。
    6. 恢復預設高度: 雙擊通知列的下緣。
  • 如何核對: 你能讀到回答的開頭,而不只是最後幾行。
  • 已測: 只用本地通知實測過。
    • 上面每個操作都在離線走查中實測過一次(Frozen build,沒有任何 AI 請求),使用的是簡短的本地通知(RUN_BOUND、DQE Viewer 啟動確認)。
    • 單一一則很長的 AI 回答(例如 Q3、Q4)沒有用這種方式實測。
  • 影片: 收合的標題列在 02:57.4[03:00.4]。

Notification Bar 子選單:Show

拉高後看得到全部訊息

另見 guide_frames/G13_collapsed_bar_header.png 與 derived_frames/DW02_collapsed_header_crop.png。


S04 · 從終端機執行 GCD

新的 session(開場卡在 03:28.0[03:31.0])。影片中的 S04–S07 取自同一次 Run 的幾段不同錄影。你跟著做時,S04–S07 都在同一個 Terminux 視窗中進行,而且不要關閉它。 步驟 11–12 設定的變數只存在於這個視窗的 Shell 中。

步驟 11:準備一個空的輸出目錄(影片中沒有拍)
  • 目的: 每次 Run 會把 receipt 與輸出寫進你指定的目錄;後面每一步都靠 receipt 認出這次 Run。
  • 在哪裡與前置條件: 你要用來進行 S04–S07 的那個 Terminux 視窗;你可以寫入上層目錄。
  • 操作:
    export TAKE_DIR=/absolute/path/to/a/new/empty/directory
    mkdir -p "$TAKE_DIR"
    test -d "$TAKE_DIR" && test -w "$TAKE_DIR" && [ -z "$(ls -A "$TAKE_DIR")" ] && echo TAKE_READY
    
    你的機器上用的範本。
  • 可觀察結果: TAKE_READY。
  • 如何核對: 只有在目錄存在、可寫入而且是空的時候,才會印出 TAKE_READY。
  • 沒看到時: 改用新的目錄。Run 會直接取代已存在的 receipt.json 與 stdout.txt,不會警告,所以絕對不要重複使用目錄。
  • 如果關掉了視窗: TAKE_DIR 就不見了。開一個新的 Terminux 視窗,用同一個路徑再執行一次 export TAKE_DIR=… 那一行。不要再執行 mkdir 與檢查,因為目錄已經不是空的。
  • 錄影: /data/tut02/t01 是管理者在鏡頭外準備好的。
步驟 12:啟動 Flow
  • 目的: 在 Terminux 裡執行 ORFS,和在一般終端機裡一樣;Terminux 會記錄這次 Run 與品質證據。
  • 在哪裡與前置條件: 與步驟 11 同一個 Terminux 視窗;ORFS、OpenROAD、Yosys 與 KLayout 可用。
  • 這時正在做的階段: --yosys-exe 指向 Synthesis(Genus/Design Compiler 類比);--openroad-exe 指向 Physical Implementation(Innovus/IC Compiler II 類比)。這個命令執行的是整套 ORFS Flow,不需要學員另外手動操作兩套工具。
  • 錄影中實際輸入的操作(共 9 行):
    terminux-orfs-run \
      --orfs-repo-root /data/tut02/runtime/orfs \
      --openroad-exe /data/tut02/runtime/tools/openroad/bin/openroad \
      --yosys-exe /data/tut02/runtime/tools/yosys/install/bin/yosys \
      --design gcd --platform nangate45 --variant tut02 \
      --design-config designs/nangate45/gcd/config.mk \
      --work-home /data/tut02/t01/work \
      --ledger-db /data/tut02/t01/ledger.sqlite \
      --receipt-out /data/tut02/t01/receipt.json > /data/tut02/t01/stdout.txt
    
    影片中實際輸入的命令。/data/tut02/… 是本片的示範環境路徑,請換成你自己的 ORFS/工具安裝路徑。
  • 在你的機器上(同一個視窗,步驟 11 之後):
    export ORFS_ROOT=/absolute/path/to/your/OpenROAD-flow-scripts
    export OPENROAD_EXE=/absolute/path/to/openroad
    export YOSYS_EXE=/absolute/path/to/yosys
    terminux-orfs-run \
      --orfs-repo-root "$ORFS_ROOT" \
      --openroad-exe "$OPENROAD_EXE" \
      --yosys-exe "$YOSYS_EXE" \
      --design gcd --platform nangate45 --variant tut02 \
      --design-config designs/nangate45/gcd/config.mk \
      --work-home "$TAKE_DIR/work" \
      --ledger-db "$TAKE_DIR/ledger.sqlite" \
      --receipt-out "$TAKE_DIR/receipt.json" > "$TAKE_DIR/stdout.txt"
    
    你的機器上用的範本(影片中沒有這樣輸入)。
    • --design-config 是相對於 flow/ 的路徑(CLI 的 help 文字)。
    • 只有標準輸出寫到 stdout.txt;錯誤訊息仍會顯示在畫面上。
  • 可觀察結果: 執行期間畫面沒有輸出,結束後回到 Prompt。錄影中大約花 48 秒;影片略過其中約 45 秒的等待時間。
  • 如何核對: Flow 回到 Prompt 後,先不要執行其他 Shell 命令;立即進入步驟 13,用 echo $? 檢查本次 Flow 的 Exit Code,之後再確認 receipt.json 與 stdout.txt。
  • 沒看到時: 畫面上出現錯誤訊息,表示 Run 沒有啟動或沒有完成。保留訊息,檢查路徑與執行檔。要重試時,不要重複使用同一個目錄(步驟 11)。
  • 影片: S04 在 03:32.0[03:35.0];約 04:04.4[04:07.4]命令輸入完成;04:04.6[04:07.6]回到 Prompt。
  • 截圖: guide_frames/G14_s04_command_typed.png、guide_frames/G15_s04_prompt_returned.png。

S05 · 自己確認結果

兩件要分開看的事

你看到的 代表的意思
echo $? → 0 Flow 程序已執行完成。
[Terminux][error] ORFS DQE: fail **設計品質檢查(DQE)**需要處理;DQE 整體結果是 FAIL。
Viewer:失敗 2、警告 2 就是 AI 所說的 2 個 ERROR 與 2 個 WARNING 那 4 列。Viewer 與終端機摘要寫 fail,AI 引用的是 DQE 等級 ERROR。
-0.18 ns(Viewer、終端機摘要、AI) orfs_setup_wns 的 DQE 數值,四捨五入到小數 2 位。
-0.1806(Report) Report 印出的 finish critical path slack 精確數值。

AI 不會讀 Report。它是透過唯讀的 Evidence Tool 讀這次 Run 的證據摘要(步驟 15),所以 timing 數值要由你在 Viewer 與 Report 上自己核對。

步驟 13:Exit code、DQE 摘要、Run ID
  • 目的: 問 AI 之前,先自己確認 Flow 是否完成、品質檢查的結果,以及這是哪一次 Run。

  • 在哪裡與前置條件: 同一個 Terminux 視窗,緊接在步驟 12 之後。echo $? 必須是 Run 結束後輸入的第一個命令。

  • 錄影中實際輸入的操作:

    echo $?
    grep -A1 '^\[Terminux\]' /data/tut02/t01/stdout.txt
    grep '^  "run_id": ' /data/tut02/t01/receipt.json
    

    影片中實際輸入的命令。/data/tut02/… 是本片的示範環境路徑,請換成你自己的 ORFS/工具安裝路徑。

  • 在你的機器上:

    echo $?
    grep -A1 '^\[Terminux\]' "$TAKE_DIR/stdout.txt"
    grep '^  "run_id": ' "$TAKE_DIR/receipt.json"
    grep '^  "attempt": ' "$TAKE_DIR/receipt.json"
    

    你的機器上用的範本。最後一行是額外加的,影片中沒有輸入。

  • 可觀察結果(錄影):

    0
    [Terminux][error] ORFS DQE: fail
      run run_aff12e8fa4c64018ae30923cabc7f6fb / step orfs-gcd-tut02 — 2 fail, 2 warn, 0 unknown. orfs_setup_wns=fail (observed -0.18 ns violates >= 0.0); orfs_setup_violation_count=fail (observed 52 paths violates == 0) [manifest am_2b609fcc649848aeb744355d5a62efa4]
      "run_id": "run_aff12e8fa4c64018ae30923cabc7f6fb",
    
  • 如何核對:

    • exit 0 與 DQE: fail 是兩件不同的事(見上方方框)。
    • 把 Run ID、attempt,以及摘要行結尾的 am_… manifest ID 記下來,步驟 14、16、18 會用到。
    • 這次錄影中沒有出現: 全部檢查都通過時,標題會是 [Terminux][warning] ORFS DQE: pass。這次 Run 是 FAIL,錄影中只看得到 error … fail。
  • 這些識別資料的來源:

    項目 來源
    Receipt 你用 --receipt-out 指定的檔案。CLI 不會印出這個路徑。
    Run ID receipt 最上層的 "run_id";DQE 摘要那一行也有。
    Attempt receipt 最上層的 "attempt"(這裡是 1)。步驟 14 的 RUN_BOUND 也會顯示。錄影中由管理者在鏡頭外核對。
  • 沒看到時:

    • grep -A1 沒有印出任何內容,表示這次 Run 沒有產生 DQE 通知,請照實記錄。
    • 沒有 receipt,表示 Run 沒有完成,請回到步驟 12。
  • 影片: S05 在 04:04.6[04:07.6];約 04:28.6[04:31.6]三個輸出都已出現。Tutorial Note 在 04:23.3[04:26.3]:exit 0=Flow 已執行完成 · DQE: fail=品質檢查需要處理。

S05 結果:exit 0、DQE fail 摘要、run_id

S06 · 綁定 Run、問 AI,再到 Viewer 與 Report 核對

同一次 Run · 新的 Session(轉場卡在 04:30.6[04:33.6])。影片中的步驟 14、15、19 來自一個新的 Terminux session,重新綁定同一次 Run。你跟著做時,請留在同一個視窗。

步驟 14:綁定 Run
  • 目的: 告訴 Terminux 你接下來問的是哪一次 Run。
  • 在哪裡與前置條件: 同一個 Terminux 視窗。你需要 receipt 的完整絕對路徑。
  • 錄影中實際輸入的操作:
    @@/bind-run /data/tut02/t01/receipt.json
    
    影片中實際輸入的命令(示範環境路徑)。你自己的 Run,先在 Shell 印出路徑:
    echo "$TAKE_DIR/receipt.json"
    
    你的機器上用的範本。接著:
    1. 用滑鼠拖曳選取印出的路徑。
    2. 按 Ctrl+Shift+C 複製。
    3. 輸入 @@/bind-run (結尾有一個空格)。
    4. 按 Ctrl+Shift+V 貼上。
    5. 按 Enter。
  • 可觀察結果: Notification Bar 顯示 RUN_BOUND: run_aff12e8fa4c64018ae30923cabc7f6fb attempt 1 is now bound to this session (host_native nangate45/gcd). 如果這個視窗已經綁定過這次 Run,會顯示 … is already bound to this session.
  • 如何核對: Run ID 與 attempt 和步驟 13 一致。
  • 沒看到時:
    • 出現錯誤,通常是路徑不是絕對路徑,或不是步驟 12 產生的 receipt。
    • 不要輸入 @@/bind-run $TAKE_DIR/receipt.json。Terminux 會把 $TAKE_DIR 原封不動送出,通知列會顯示 Q: /bind-run $TAKE_DIR/receipt.json。
  • 走查: 上面五步的複製貼上已在離線走查中實測:Terminux 收到的貼上命令與手打的逐字相同;$TAKE_DIR 的寫法則原樣送出、沒有展開。
  • 綁定需要已啟用 AI,且 Profile 允許綁定 Run。
  • 影片: 04:34.1[04:37.1]綁定;約 04:39.3[04:42.3]看得到 RUN_BOUND。

Notification Bar 中的 RUN_BOUND

印出的路徑已選取,並貼在 @@/bind-run 後面

步驟 15:提出 Q3:哪些 DQE 檢查是 WARN 或 FAIL?
  • 目的: 請 AI 查詢這次 Run 的證據,列出需要注意的檢查。

  • 在哪裡與前置條件: 同一個視窗,步驟 14 之後。你的版本必須會把綁定的 Run 交給 AI(見「需要準備什麼」)。

  • 操作:

    @@For the Run I just bound, which DQE checks are WARN or FAIL? Show the run evidence and where I can verify it.
    
  • 可觀察結果: 回答出現在 Notification Bar。通知列一開始只顯示開頭幾行,請用步驟 10 的方法讀完整個回答;影片以摘錄卡呈現。英文逐字摘錄:

    DQE checks not OK — 4 of 14 rows. Two are WARNING-level and two are ERROR-level. Note: this package reports ERROR rather than a literal FAIL status, so nothing was tagged "FAIL" verbatim.

    重點翻譯:未通過的 DQE 檢查:14 列中有 4 列。其中兩項是 WARNING、兩項是 ERROR。這個 package 標示的是 ERROR,不是字面上的 FAIL。

    DQE check Value Status
    orfs_log_warning_markers 2 markers WARNING
    orfs_setup_tns −7.94 ns WARNING
    orfs_setup_violation_count 52 paths ERROR
    orfs_setup_wns −0.18 ns ERROR

    So the flow completed but setup timing is not clean — negative WNS (−0.18 ns) and TNS (−7.94 ns) across 52 violating paths.

    重點翻譯:Flow 已完成,但 setup timing 不乾淨:WNS −0.18 ns、TNS −7.94 ns,共 52 條違規路徑。

    No report items were returned, so I cannot show you the underlying timing-report artifacts — only the DQE summary rows above.

    重點翻譯:工具沒有回傳報告項目,所以只能提供上面的 DQE 摘要,無法顯示底層的 timing 報告。

  • 如何核對: AI 是用唯讀的 Evidence Tool 讀這次 Run 的 DQE 摘要,沒有看到 Report。步驟 16–18 在 Viewer 與 Report 上核對同樣的數字。

  • 沒看到時: 如果 AI 說它沒有綁定 Run 的 Run ID,表示你的版本不會把綁定的 Run 交給 AI。較早的 build 就是這樣,這也是影片中 S06–S07 改在新的 session、使用更新後 build 的原因。

  • 影片: 約 04:48.8[04:51.8]Q3 輸入完成;04:58.0[05:01.0]回答出現;摘錄卡 05:02.6[05:05.6]。卡片的 Tutorial Note:接下來,我們先用 DQE Viewer 查看,再到 Report 核對結果。

  • 截圖: guide_frames/G18_s06_q3_typed.png、guide_frames/G19_s06_q3_answer_bar.png。

步驟 16:打開 DQE Viewer
  • 目的: 「Terminux 也附了一個小工具,叫做 DQE Viewer,可以用來查看 Design Quality,也就是設計品質。現在打開它,看看哪些檢查需要注意,再回到 Report 核對 timing 數值。」
  • 在哪裡與前置條件: 同一個視窗;DQE Viewer 隨 Terminux 一起安裝(見「需要準備什麼」)。
  • 操作:
    @@open DQE Viewer
    
  • 可觀察結果:
    • Notification Bar 短暫確認請求,錄影中顯示 已將 DQE Viewer 啟動請求交給 client。。
    • 接著 DQE Viewer 視窗開在「暫存」分頁,有一個 job 20261103_204848_001(orfs_finish,2 FAIL)。
    • 摘要卡:總計 14 · 通過 10 · 警告 2 · 失敗 2 · 未知 0。
  • 沒看到時:
    • 沒有出現視窗: 多半是 Viewer 沒有隨 Terminux 一起安裝,請詢問管理者。
    • @@ 請求被拒絕: 本教學以你的帳號已啟用 Terminux AI 為前提(見「需要準備什麼」)。
  • 說明: 這個命令不會送出 AI 請求;Viewer 只讀取已儲存的 DQE 結果。
  • Viewer 語言: 跟隨 Terminux 的語言(在終端機按右鍵 → Language;guide_frames/G25_language_menu_zh.png)。zh-TW 影片是切換語言、重新打開 Viewer 後的繁體中文介面;EN 影片是 English 介面。
  • 影片: 05:18.6[05:21.6]輸入;05:21.1[05:24.1]Viewer 出現。這段來自新的 session。
  • 截圖:
    • guide_frames/G20_viewer_open_typed_en.png
    • guide_frames/G26_viewer_overview_zh.png
    • EN:guide_frames/G21_viewer_overview_en.png

DQE Viewer 總覽:總計 14、通過 10、警告 2、失敗 2

步驟 17:篩選「失敗」,檢視兩項檢查
  • 目的: 找出失敗的檢查,並看每一項失敗的原因。
  • 在哪裡與前置條件: 步驟 16 打開的 DQE Viewer。
  • 操作:
    1. 點「失敗」摘要卡。
    2. 點 orfs_setup_wns 這一列。
    3. 點 orfs_setup_violation_count 這一列。
  • 可觀察結果:
    • 1 之後:表格只剩 orfs_setup_violation_count(52,paths)與 orfs_setup_wns(-0.18,ns),狀態都是 Fail。
    • 2 之後:右側「選取項目檢視」顯示數值 -0.18、單位 ns、狀態 Fail、說明 observed -0.18 ns violates >= 0.0。
    • 3 之後:顯示數值 52、單位 paths、說明 observed 52 paths violates == 0。
  • 如何核對:
    • 這就是步驟 15 中 AI 回報為 ERROR 的兩項;Viewer 以 Fail 標示。
    • 兩個警告列(篩選前看得到)是 orfs_setup_tns(-7.94 ns)與 orfs_log_warning_markers(2 markers)。
  • 沒看到時: 「失敗」卡是 0,表示這個 job 沒有失敗的檢查;請照實記錄,不要硬找這兩列。
  • 不要操作: 左側的「簽入」、「暫存保留政策」與「暫存清除」不屬於這個教學;它們會改變或刪除已儲存的 DQE 結果。
  • 影片: 05:28.8[05:31.8]「失敗」篩選;05:34.6[05:37.6]orfs_setup_wns;05:45.3[05:48.3]orfs_setup_violation_count。
  • 截圖:
    • guide_frames/G27_viewer_fail_filter_zh.png
    • guide_frames/G28_viewer_wns_inspector_zh.png
    • guide_frames/G29_viewer_violation_inspector_zh.png
    • EN:G22_viewer_fail_filter_en.png、G23_viewer_wns_inspector_en.png、G24_viewer_violation_inspector_en.png

「失敗」篩選:兩列 Fail

orfs_setup_wns 的檢視:observed -0.18 ns violates >= 0.0

orfs_setup_violation_count 的檢視:observed 52 paths violates == 0

步驟 18:在 Report 上核對 timing
  • 目的: 從這次 Run 的 Report 讀出精確的 setup slack。
  • 在哪裡與前置條件: 同一個 Terminux 視窗;Run ID 與 attempt 來自步驟 13。
  • 錄影中實際輸入的操作:
    terminux-orfs-report --receipt /data/tut02/t01/receipt.json --run-id run_aff12e8fa4c64018ae30923cabc7f6fb --attempt 1
    
    影片中實際輸入的命令。/data/tut02/… 是本片的示範環境路徑,請換成你自己的 ORFS/工具安裝路徑。
  • 在你的機器上:
    RUN_ID="run_aff12e8fa4c64018ae30923cabc7f6fb"
    ATTEMPT="1"
    echo "Run ID: $RUN_ID  attempt: $ATTEMPT"
    terminux-orfs-report --receipt "$TAKE_DIR/receipt.json" --run-id "$RUN_ID" --attempt "$ATTEMPT"
    
    你的機器上用的範本。執行前,請把引號內的兩個值換成你的步驟 13 印出的 run_id 與 attempt。上面的值是錄影中的值。引號要保留。
  • 可觀察結果: echo 那一行印出你的值;接著 Report 印出 finish critical path delay、finish critical path slack 等段落。錄影中 slack 的數值是 -0.1806。
  • 如何核對:
    • -0.1806 與 DQE 的 WNS -0.18 ns(Viewer、AI、終端機摘要;已四捨五入)一致。
    • Report 的數值寫成 -0.1806,DQE 的數值寫成 -0.18 ns;兩者不是同一個數字。
  • 沒看到時: 如果 echo 印出的仍是錄影中的值,或與步驟 13 不同,先改正再執行 Report。
  • 執行前請核對變數指向你的檔案與工作目錄。
  • 影片: 05:50.1[05:53.1],以 Note 標出數值:Report 顯示最差 setup slack 為 −0.1806 ns(AI 回報約 −0.18 ns)。 截圖中的輸出約在 06:03.5[06:06.5]。

Report:finish critical path slack -0.1806

S07 · 問下一步要檢查什麼

步驟 19:提出 Q4
  • 目的: 根據這次 Run 的證據,問 AI 下一步要檢查什麼。

  • 在哪裡與前置條件: 已綁定 Run 的視窗(步驟 14)。影片使用這個問法,只問這次已綁定的 Run。

  • 操作:

    @@Based on the evidence from this run, what should I inspect next, and why?
    
  • 可觀察結果: Notification Bar 出現一則很長的回答,請用步驟 10 的方法讀完。英文逐字摘錄:

    1. The setup-timing report for step orfs-gcd-tut02 — highest value. This is the only place something is actually wrong with the design result rather than the process. WNS −0.18 ns, TNS −7.94 ns, 52 violating paths.

    重點翻譯:1. 優先檢查 orfs-gcd-tut02 這一步的 setup timing 報告。這是設計結果本身真正有問題的地方,而不是流程問題:WNS −0.18 ns、TNS −7.94 ns、52 條違規路徑。

    Hold = 0, route DRC = 0, max cap/fanout/slew = 0. Spending time on routing DRC or hold closure this run would be redundant — setup timing is the single open front.

    重點翻譯:Hold、route DRC、max cap/fanout/slew 都是 0;這次不必花時間在 DRC 或 hold,setup timing 是唯一待處理的問題。

    If this design is heading for sign-off, it's worth confirming whether DQE ERROR is advisory or gating at this step.

    重點翻譯:如果這個設計要走向 sign-off,值得先確認 DQE 的 ERROR 在這一步是提醒,還是會擋下流程。

  • 如何核對:

    • Hold、route DRC、max cap/fanout/slew 在 Viewer 中都是 Pass 列(步驟 16,篩選前)。
    • AI 的建議是下一步要檢查的方向,不代表 timing 已簽核。
  • 沒看到時: 見步驟 15。

  • 影片: 場景 06:04.7[06:07.7];約 06:19.9[06:22.9]Q4 輸入完成;06:35.9[06:38.9]回答出現;摘錄卡 06:40.2[06:43.2]。

  • 截圖: guide_frames/G31_s07_q4_typed.png、guide_frames/G32_s07_q4_answer_bar.png。

步驟 20:你完成了什麼
  • 影片: 結尾卡在 06:56.2[06:59.2]:
    • Flow 已完成 · 品質檢查需要處理
    • DQE:2 ERROR · 2 WARNING · WNS −0.18 ns · 52 條 setup 違規
    • 下一步:檢查 setup timing 報告
  • 回顧:
    • 找到輸入(S02–S03)。
    • 執行 Flow,並確認是哪一次 Run(S04–S05)。
    • 問 AI 這次的證據,再到 Viewer 與 Report 核對(S06)。
    • 知道下一步要看什麼(S07)。
  • Flow 完成是一個里程碑,品質檢查則告訴我們還有哪些地方要處理。

附錄 · 前置條件狀態

前置條件 狀態
已安裝 Terminux;terminux-launch、terminux-orfs-run、terminux-orfs-report 在 PATH 中 Confirm the required tools and Profile configuration before proceeding.
安裝內容含 DQE Viewer(dqe_viewer 在 terminux 旁)與 Qt Quick runtime 拍攝用的 QA 套件沒有附 Viewer;後來從同一份 build 補上。
ORFS checkout、OpenROAD、Yosys、可供 GDS finishing 使用的 KLayout ORFS Flow 必須能使用相容的 KLayout;示範使用 KLayout 0.28.16。
已啟用 Terminux AI(允許綁定 Run 的具名 Profile) 由管理者設定。
會把綁定 Run 交給 AI 的版本 S06–S07 需要能將綁定 Run 提供給 AI 的版本與 Profile 設定;開始前請確認這項能力。

S04–S07 的 session 並不接續 S02–S03 的對話;S06–S07 的 AI 沒有看到 S01–S05。

  • 影片與截圖中的 /data/tut02/… 與 Viewer 檢視區的「參考」欄位,是錄影的示範環境;你的環境會不同。

適用版本​

相關文件​