指令參考

兩個版本共用同一張指令表。同名指令的語法與語意逐字相同，差異只會是「有沒有 這個指令」——標了「僅視窗版」的就是那種。

指令列在畫面最下方。Tab 補齊指令名與常見的第二個關鍵字（如 record sta + Tab），打完指令名後會在上方浮出該指令的用法與範例（Tab 候選開著時先顯示候選），Enter 執行。

• 歷史：上下鍵翻歷史。已經打了幾個字再按 ↑，只會翻到開頭相同的指令（例如打 rd 再按 ↑ 只找 rd …）；一路按 ↓ 回到最後，會還原你原本打的字。
• 淺色預測：打了幾個字後，游標後面會以淡色顯示這個 Tab 最近一次以相同開頭打過的整行。游標在行尾時按 → 整段帶入、Ctrl+→ 只帶入下一個詞；不按就不會送出（Enter 只送你打的字）。
• Esc 清空指令列，清掉的那一行會先存進歷史，按 ↑ 就找得回來。
• 編輯：指令列有字時，Home／End 跳到行首／行尾（沒字時照舊捲動面板）；Ctrl+←／Ctrl+→ 以空白為界一次跳一個詞，Ctrl+Backspace 刪掉游標前一個詞，Ctrl+Delete 刪掉游標後一個詞。
• 選取、復原與剪貼簿：Shift＋方向鍵（或 Home／End）延伸選取，Ctrl+A 全選（焦點在 Log 面板時 Ctrl+A 仍是全選 Log）；打字或貼上會取代選取。Ctrl+Z 復原上一步（再按一次重做）。視窗版 Ctrl+C／Ctrl+X／Ctrl+V 複製／剪下／貼上；終端機版的 Ctrl+C 是關閉程式，複製用 Ctrl+Shift+C 或 Ctrl+Insert（兩者相同：指令列有選取就複製它，否則複製 Log 或暫存器表的選取；視窗版的 Ctrl+Insert 也是 Ctrl+C 的別名），剪下用 Ctrl+X 或 Shift+Delete，貼上用 Ctrl+V 或 Shift+Insert。

讀這張表之前

• 數值一律是十六進位。 rd 16 讀的是位移 0x16，不是 0x10。0x 前綴可以 加，只是顯式標示。
• [...] 是可省略的參數，<...> 是要你填的值。
• @p<N> 指定面板：終端機版是 @p0（左上）到 @p3，視窗版依面板數最多到 @p63（編號是十進位，@p10 就是第 10 號），面板標題左邊的 p0、p1… 就是它的編號。不指定時作用在目前有焦點的面板。
• 每個指令下面先列出每一種用法，再給可以直接照抄的範例（# 後面是說明， 不用打）。最底下的「完整語法」是程式內建 help 印出的原文，給需要精確語法的人參考。
• 位址沒特別指定時用的是這個分頁的 slave 位址，也就是 addr 設的那個。
• 想把手動下的指令錄成 Lua 腳本，用 record，教學見錄製 I2C 操作。

# 讀取位移 0x16 的 1 個位元組（沒給數量，預設 1 個）。
rd 16

# 從位移 0x10 連續讀 0x20（十進位 32）個位元組。
rd 10 20

# 讀位移 0x05 的 1 個位元組，位址是 0x56——只給位移＋一個數字時那是數量，要指定位址必須連數量一起打。
rd 05 1 56

# 把 0xA5 寫進位移 0x10（目前的位址）。
wr 10 A5

# 把 0xA5 寫進位移 0x10，位址是 0x58——只有 1 個資料值時，後面那個數字是位址。
wr 10 A5 58

# 從位移 0x10 開始連續寫入 0xA5、0x5A、0x3C 三個位元組（目前的位址）。
wr 10 A5 5A 3C

# 讀取 16-bit 位移 0x0100 的 1 個位元組。
rd16 0100

# 讀取位址 0x50、16-bit 位移 0x0100 起的 0x10（16）個位元組。
rd16 0100 10 50

# 把 0xA5 寫進 16-bit 位移 0x0100。
wr16 0100 A5

# 把 0xA5 寫進 16-bit 位移 0x0100，位址是 0x3C。
wr16 0100 A5 3C

# 把位移 0x10 的低 4 位元（遮罩 0x0F）設成 0x05，高 4 位元不變。
set 10 0F 05

# 同上，但目標是位址 0x58。
set 10 0F 05 58

# 把位移 0x10 的低 4 位元（遮罩 0x0F）清為 0。
clr 10 0F

# 讀出目前位址、目前 bank 的 256 個位元組。
dump

# 讀出位址 0x58 那顆裝置目前 bank 的 256 個位元組。
dump 58

# 用這個 Tab 目前追蹤的 bank 狀態，把全部 bank 匯出成一個檔案。
dump all

# bank 選頁暫存器在位移 0x7F、用遮罩 0x03 選頁，切 4（十進位）頁全部匯出。
dump all 7F 03 4

# 把目前焦點面板的快取快照存成檔案。
dump snap

# 把面板 0 的暫存器表快取快照存成檔案。
dump snap @p0

# 拿產線基準檔比對目前掛載的晶片。
dump diff logs/dump_20260930_100000_addr51_allbanks.txt

# 把 golden.txt 拿去比對面板 1 上位址 0x58 的晶片。
dump diff golden.txt 58 @p1

# 互動介面：跳出確認視窗，列出要寫幾個位元組、略過幾個。
dump load golden.txt

# 已確認，直接寫入（Batch 與腳本必須這樣寫）。
dump load golden.txt force

# 沒有 regdef 時，把 golden.txt 所有非 -- 的位元組寫進面板 1 上位址 0x58 的晶片。
dump load golden.txt raw force 58 @p1

# 查詢目前的 bank。
bank

# 切換到 bank 0x02。
bank 02

# 查詢目前的 bank 選頁暫存器設定。
bank reg

# 把選頁暫存器設在位移 0x7F，遮罩用預設的 0xFF（全部位元參與選頁）。
bank reg 7F

# 把選頁暫存器設在位移 0x7F，只用其中的位元 0–1（遮罩 0x03）選頁。
bank reg 7F 03

# 列出目前監看的項目。
watch

# 監看位移 0x10（目前的位址）。
watch 10

# 監看面板 1、位址 0x58、位移 0x10。
watch 10 58 @p1

# 移除位移 0x10 的監看。
unwatch 10

# 移除位址 0x58、位移 0x10 的監看。
unwatch 10 58

# 移除掛載槽 0 上、位移 0x10 的監看。
unwatch 10 @s0

# 清空整份監看清單。
unwatch all

# 位址 0x58、位移 0x10：遮罩 0x0F 選中的位元出現上升緣時記一筆 Log。
trigger 10 58 0F rise

# 位移 0x10（需先 watch 10）第一次出現變化時，自動送出 wr 10 00；只觸發一次，要每次都觸發請加 cont。
trigger 10 FF any do wr 10 00

# 持續監看位移 0x10 的下降緣，每次都觸發，不是只觸發一次。
trigger 10 FF fall cont

# 清除位移 0x10 的觸發條件。
trigger 10 FF off

# 改設定之前先把目前快取的暫存器值留下來。
snap take before

# 改完之後看看哪幾格和 before 不一樣。
snap diff before

# 把面板 1 的掛載目前的快取也存起來。
snap take after @p1

# 比對兩份快照（必須同一個掛載）。
snap diff before after

# 看目前留了哪些快照。
snap list

# 打開標記，之後讀回變過值的格子會用警告色顯示。
mark on

# 改完設定、想看「接下來」還有哪些格子在變時，先重設基準。
mark reset

# 剛才寫錯了，把它寫回原值。
undo

# 看堆疊裡還有哪些寫入可以還原。
undo list

# 查詢目前載入的定義檔。
regdef

# 載入 ds3231.regdef.json 這份定義檔（檔名僅為範例）。
regdef load ds3231.regdef.json

# 卸下目前的定義檔。
regdef off

# 查詢目前的位址。
addr

# 把主要 IC 的位址改成 0x50。
addr 50

# 在面板 1 掛上位址 0x68 的 IC。
mount 68 @p1

# 在面板 1 掛上位址 0x58 的 IC，並用 16 位元暫存器位址。
mount 0x58 16bit @p1

# 列出目前的掛載清單。
mount list

# 卸下面板 1 的掛載。
unmount @p1

# 切換整個程式的背景輪詢開關。
poll

# 關閉背景輪詢。
poll off

# 只打開面板 0（暫存器表）的自動更新，不影響全域輪詢；@p<N> 必須指向暫存器表面板。
poll on @p0

# 列出目前掃描到的所有後端。
dongle

# 切換到名為 ui2c 的後端（後端名稱依實際安裝的 dongle 而定，這裡只是舉例）。
dongle ui2c

# 查裝置目前被哪個程式佔用。
dongle who

# 關閉目前的預設後端。
dongle close

# 關閉名為 ui2c 的後端。
dongle close ui2c

# 重新掃描一次可用的後端。
dongle rescan

# 列出後端支援的 vendor op。
dongle op

# 查看 wave 這個 op 的參數與結果。
dongle op help wave

# 用具名參數執行 wave（STM32 dongle：在 SCL／SDA 輸出方波）。
dongle op wave scl_hz=100000 sda_hz=50000

# 解開卡住的匯流排。
dongle recover

# 把 3 號腳拉低 100 毫秒。
dongle pulse 3 0 100ms

# 把 1 號腳拉高 2000 微秒。
dongle pulse 1 1 2000us

# 偵測下降緣，內部上拉。
dongle int config falling up

# 把每個邊緣寫進 Log。
dongle int log on

# 查看中斷腳的狀態。
dongle int status

# 把匯流排設為 400 kHz。
dongle speed 400

# 掃描匯流排上有回應的位址。
scan

# 掃描並辨識有回應位址上的晶片，Log 會建議該載入哪份定義檔。
scan id

# 查詢橋接狀態。
bridge

# 打開橋接，共用名為 ui2c 的後端。
bridge on ui2c

# 關閉橋接。
bridge off

# 列出全部可用的解鎖序列。
password list

# 對名為 ds3231 的裝置送出解鎖序列（IC 名稱僅為範例）。
password ds3231

# 重新載入解鎖序列設定檔。
password reload

# 檢查並更新解鎖序列定義。
password update

# 切換到名為 ds3231 的 Plugin（名稱僅為範例）。
plugin switch ds3231

# 在面板 1 掛上 ds3231；就算偵測不到這顆 IC 也強制掛上（沒接硬體時除錯用）。
plugin switch ds3231 @p1 force

# 列出掃描到的全部 Plugin。
plugin list

# 從線上目錄安裝 ds3231 的 1.2.0 版。
plugin install ds3231 1.2.0

# 查詢目前的面板配置。
layout

# 把面板 1 換成暫存器定義面板。
layout @p1 regdef

# （終端機版）左欄寬度佔 60%、上半部高度佔 40%。
layout 60 40

# 鎖定版面，狀態列出現 LOCK。
layout lock

# 解除鎖定，狀態列的 LOCK 消失。
layout unlock

# 把面板 1 浮起。
layout float @p1

# 把面板 1 停靠回去。
layout dock @p1

# 放大焦點面板；再打一次還原。
layout max

# 把目前版面存成 bench。
layout save bench

# 套用先前存的 bench 版面。
layout load bench

# 刪除 bench 版面。
layout delete bench

# 顯示所有已存版面。
layout list

# 把面板 3 併入面板 1 的分頁組。
layout stack @p3 @p1

# 把面板 3 移出分頁組。
layout unstack @p3

# 在焦點面板所在的組新增一個 I2C Log 分頁。
layout tab add i2c_log

# 關閉焦點組的作用中分頁。
layout tab close

# 切到焦點組的下一個分頁。
layout tab next

# 切到焦點組的上一個分頁。
layout tab prev

# 把面板 3 釘到左邊。
layout pin @p3 left

# 把面板 3 放回原位。
layout unpin @p3

# 把面板 3 搬進新的獨立視窗。
layout window @p3

# 關閉這個獨立視窗並把面板併回主視窗。
layout window close

# 查詢面板 2 的自動捲動狀態。
autoscroll @p2

# 關閉面板 2 的自動捲動。
autoscroll @p2 off

# 查詢目前的主題。
theme

# 切換到 dracula 主題。
theme dracula

# 查詢目前的 Log 字型設定。
logfont

# 把 Log 面板字型換成 Consolas、11 點。
logfont Consolas 11

# 還原成預設字型。
logfont default

# 顯示目前的等級過濾設定。
log show

# 加入 debug 等級的訊息。
log +debug

# 還原成預設的等級組合。
log default

# 把目前焦點面板綁到名為 ui2c 的匯流排。
log bus ui2c

# 開啟寫入 Log 的欄位解碼。
log decode on

# 把目前焦點面板看得到的 Log 匯出成 CSV 檔。
log export csv

# 清空 I2C 記錄緩衝區。
clear

# 查詢目前的 UART 狀態。
uart

# 以 115200 baud 開啟 COM3，其餘用預設值（8 資料位元、無同位、1 停止位元、無流控）。
uart COM3 115200

# 以 9600 baud、8 資料位元、無同位、1 停止位元、無流控開啟 COM3。
uart COM3 9600 8 n 1 none

# 在面板 3（UART 記錄面板）開啟 COM3。
uart COM3 115200 @p3

# 列出可用的序列埠。
uart scan

# 關閉目前的序列埠。
uart close

# 關閉面板 3 的序列埠。
uart close @p3

# 把 1 號巨集內容設成 AT+RST。
uart macro 1 "AT+RST"

# 把面板 3（UART 記錄面板）的 2 號巨集設成 AT+GMR；@p<N> 必須指向 UART 記錄面板。
uart macro 2 "AT+GMR" @p3

# 清空 3 號巨集。
uart macro 3 ""

# 清空目前 UART 記錄面板的收發紀錄。
uart clear

# 送出 AT+RST 加上換行。
uart send "AT+RST"

# 從面板 3（UART 記錄面板）的序列埠送出 help。
uart send "help" @p3

# 匯出目前 UART 記錄面板的紀錄。
uart export

# 匯出面板 3 的 UART 紀錄。
uart export @p3

# 把面板 3 的 UART 設成 COM3、115200 baud，只存設定不開埠。
uart set COM3 115200 @p3

# 以 SSH 連線到 192.168.50.4（使用者 pgl）。
term open ssh pgl@192.168.50.4

# 連線到 ~/.ssh/config 裡名為 lab 的主機。
term open ssh lab

# 以 115200 連線到 COM7。
term open uart COM7 115200

# 以預設的 115200 連線到 COM3。
term open uart COM3

# 斷線。
term close

# 開始 session 記錄。
term log on

# 結束記錄並關檔。
term log off

# 執行 scripts/demo.lua 腳本。
run scripts/demo.lua

# 開始錄製，檔名依目前時間自動產生。
record start

# 開始錄製，存成 logs/my_setup.lua。
record start my_setup.lua

# 停止錄製。
record stop

# 把目前的工作區存成 board_a。
profile save board_a

# 切換到 board_a。
profile load board_a

# 退回載入前自動留下的那一份。
profile load _previous

# 不經確認直接刪除 board_a（Batch 與腳本的寫法）。
profile delete board_a force

# 把這次 NACK 問題的資料收成一包，交給 FAE。
report it6622_nack

# 新增一個 Tab 並切過去。
tab new

# 關閉目前這個 Tab。
tab close

# 關閉第 2 個 Tab。
tab close 2

# 查詢 MCP 伺服器的狀態與連線數。
mcp

# 暫時不讓 AI 助手操作。
mcp off

# 重新開放。
mcp on

# 顯示最近一次自動檢查的結果。
update

# 安裝已偵測到的新版本，本程式隨即關閉。
update apply

# 顯示版本資訊。
ver

# 列出全部指令的名稱。
help

# 查 dump 的各種用法與範例。
help dump

# 列出每個指令的完整說明。
help all

# 列出按鍵對照表。
help keys

# 解釋錯誤碼 -42（I2C 匯流排錯誤）。
help err -42

# 結束程式。
quit

批次模式

兩個執行檔都可以不開畫面直接跑指令：

nexus_tui.exe --batch --cmd "addr 58" --cmd "rd 0 10"
nexus_tui.exe --batch --run script.lua

批次模式的 Exit Code 是第一條失敗指令的錯誤碼絕對值，前面的指令都成功就是 0，失敗的那一條之後的指令不會再執行。Plugin 自訂指令也一樣：Plugin 的處理函式 回傳錯誤碼才算失敗；處理函式若只在輸出裡寫了一行錯誤、卻回傳成功，Exit Code 仍是 0，所以要確認結果時請一併看輸出。指令名稱不存在是 7。--run 跑的是 Lua 自動化腳本，Exit Code 的意義另見Lua 自動化（互動模式沒有 Exit Code 這件事；互動模式下要跑腳本也只能用 run 指令，--cmd "run ..." 在批次模式裡會 被拒絕）。

兩個執行檔也接受 --profile <名稱或路徑>：在 --cmd 與腳本之前先載入工作區設定檔（profile 指令的啟動版，用法見工作區設定檔）。批次模式只套用到記憶體、不寫 config.ini；設定檔本身讀不到、版本過新或執行中工作擋住時中止並回傳非 0，部分失敗只印警告。批次模式下，同時給 --dongle 或 --log-level 時，分別以 --dongle、--log-level 為準。