Skip to Content
選單File

☰ → File

暫存器定義檔

選單項目終端機版
Load REG DEF file…regdef load <路徑>
Unload REG DEF fileregdef off

沒有載入定義檔時 Unload REG DEF file 是灰字,右邊寫 none loaded。 載入之後見暫存器定義面板。

工作區設定檔

Profile 子選單把整個工作區(掛載、監看與觸發、面板版面、暫存器定義檔、Dongle)存成具名設定檔,換板子或換專案時一鍵切換。

選單項目終端機版
Save profile…profile save [<名稱>]
Load profile…profile load [<名稱>]
Browse…profile load <路徑>
  • Save profile... 開輸入表單(名稱,或 .ini 的絕對路徑);同名已存在會再問一次是否覆寫。
  • Load profile... 開清單,列出設定檔資料夾(config.ini 旁的 profiles\)裡的檔案,右側顯示每個分頁的掛載位址、Plugin、定義檔檔名與存檔時間;按鈕 Load/Delete/Cancel,Delete 會再確認一次。載入前自動留下的備份 _previous 置頂。
  • Browse... 用檔案對話框挑任意位置的 .ini 載入。
  • 終端機版沒有選單,直接打 profile 指令;profile load 不帶名稱會開同樣的清單。

載入是整個取代:目前的掛載、監看與觸發會先卸載,再依設定檔重建;視窗版與終端機版的面板版面都會更新。 載入前自動存成 _previous,載到不對的設定檔時 profile load _previous 即可退回。 Lua 腳本、錄製或連續觸發執行中不能載入。檔案本身有問題(不存在、讀不到、版本過新)整個拒絕; Dongle 沒插、Plugin 沒裝、定義檔找不到這類問題只列出警告,該項設定照樣保留。 暫存器定義檔找不到原路徑時,會改找設定檔所在資料夾裡的同名檔,所以要分享就把 .ini 與定義檔放同一個資料夾。

設定檔不含歷史指令、主題、字型、視窗位置與 Plugin 自己的設定;載入後的狀態照常寫進 config.ini,設定檔本身不會被自動更新。 啟動時也可以用 --profile <名稱或路徑> 指定(批次模式只套用到記憶體,不改 config.ini)。 完整用法(分享、批次、常見問題)見工作區設定檔,語法見指令參考的 profile。

執行 Lua 指令稿

Run Lua script... 開原生檔案對話框挑一個 *.lua 檔,組出 run <路徑> 執行; 與 Load REG DEF file... 共用同一顆挑檔對話框。視窗版執行中沒有中止鍵; 終端機版直接打 run <路徑>。完整的 Lua 自動化教學見 Lua 自動化。

錄製 I2C 操作

Record I2C... 把你手動下的 I2C 指令錄成一支可以重播的 Lua 指令稿。選它會開原生存檔對話框 (預設在 logs/,檔名 record_日期_時間.lua),確定後開始錄製,等同輸入 record start <路徑>; 選到已存在的檔案會被拒絕,不會覆寫。

錄製中,狀態列右側會出現紅色的 ● REC 檔名(終端機版沒有圓點,是 REC 檔名),同一個選項變成 Stop recording,選它就停止(等同 record stop)。 直接關閉程式時,錄製也會先自動收尾。錄出來的檔案可以用 run 重播。 錄什麼、怎麼翻成 Lua、怎麼改成有判定的腳本,見教學錄製 I2C 操作。

匯出 Log

把目前的 Log 面板內容寫成 logs/ 底下的檔案。快捷鍵 F8。

⚠ logs/ 是你的量測資料,不會被任何清理動作刪掉,也不隨版本更新覆蓋。

匯出 CSV

把目前焦點面板看得到的 Log 匯成 logs/log_日期_時間.csv,等同輸入 log export csv (想指定面板就加 @p<N>,例如 log export csv @p2)。面板上設的等級過濾與 log bus 綁定都會一併套用,所以檔案內容就是你畫面上看到的那些紀錄。終端機版沒有選單項,直接打指令。

檔案是 UTF-8(含 BOM,Excel 直接開中文不會亂碼)、CRLF 換行,第一列是欄位名稱:

time,level,tab,bus,op,slave,offset,len,value,rc,msg

每一次 rd/wr/set/clr/dump 是一列,op(rd/wr/rmw)、slave、offset、len、value (前 4 個位元組)與 rc(0 為成功,負數是錯誤碼)都填好,可以直接拿去排序、篩選、畫圖。 其他 Log(系統訊息、警告等)也照時間順序列在裡面,只是 op 到 rc 這幾欄是空的。 一次操作附帶的表格多行內容會合併進同一列的 msg。背景輪詢與監看讀到的值不會逐筆記錄。

批次模式(--batch --cmd "log export csv")沒有面板,一律匯出全部等級與全部分頁,也不接受 @p<N>。

開啟 config.ini

用系統預設的編輯器打開設定檔。設定檔在 %USERPROFILE%\.config\nexus_tui\, 兩個版本共用同一份,各自只重寫自己負責的區段。

開啟 logs 資料夾

用檔案總管打開 logs\(匯出的 Log、錄製的檔案都放在這裡)。資料夾還不存在時會先建立。

拖放檔案

也可以直接把檔案拖進視窗,等同於從選單挑檔案:.json 載入暫存器定義檔、.lua 執行腳本、 .ini 載入設定檔。一次拖多個檔只處理第一個;其他副檔名會在狀態列提示 Drop: unsupported file type,不會執行任何東西。對話框開著的時候拖放會被忽略。 路徑含空白又沒有 8.3 短檔名時,和從選單挑檔案一樣會被拒絕(指令列不支援引號)。

結束

結束程式,會先把設定寫回 config.ini。終端機版:quit。

終端機版按 Ctrl+C 也是優雅關閉(不是強制中斷);視窗版的 Ctrl+C 是複製。