跳到內容

使用啟動腳本

文件對應版本v0.2.0/main 穩定版

這篇接續第一個 RPC,把原本手動輸入的 rpcSubscriber、rpcPublisher 寫進一份啟動腳本,讓 Vinc 依序啟動兩個 Module。

沿用前篇已建置的 open-vinc-examples。以下 PowerShell 命令都在 repository 根目錄執行,也就是看得到 scripts/ 與 build/ 的位置。

範例已附上 scripts/rpc-startup.tcl,內容很簡單:

scripts/rpc-startup.tcl
# 先啟動接收端,再啟動發送端。
rpcSubscriber
rpcPublisher

scripts/rpc-startup.tcl · e165aed · 中文註解

# 開頭是註解。接下來兩行就是原本在 Vinc Shell 輸入的 ModuleType。

腳本使用 Tcl,由中央的 Vinc Shell 執行。C++ 與 Python 模組共用同一份腳本,範例建置也已帶入所需的 Tcl,不必另外安裝。

每行會依序執行:先等 rpcSubscriber 啟動完成、收到 Ready,再啟動 rpcPublisher。最後一行完成後,兩個 Module 會繼續運行。

若前一次的 Vinc Shell 還開著,先輸入 exit。回到 PowerShell,執行:

終端機視窗
.\build\debug\Vinc.exe -S scripts/rpc-startup.tcl

-S 指定啟動時執行的腳本。Python 的 --python 要放在 -S 前面。

腳本路徑是相對於目前的工作目錄,所以這裡要從 repository 根目錄執行。只修改 .tcl 內容時,不需要重新建置 Module。

會看到兩個 Module 的啟動輸出。請等到:

Script completed: scripts/rpc-startup.tcl

這表示腳本已正常完成,現在可以繼續在 Vinc Shell 輸入指令,不需要再次手動建立兩個 Module。

先詢問接收數量:

sender count

等待發送端印出:

RPC received=0

再送一筆訊息:

sender send

等到接收端印出:

received sequence=1 publisher=sender

再輸入 sender count,會得到 RPC received=1。這和前篇的操作相同,只是兩個 Module 改由腳本啟動。

4. 已經開啟 Shell 時,用 srun 執行

Section titled “4. 已經開啟 Shell 時,用 srun 執行”

也可以先開 Vinc,再執行同一份腳本。先用 exit 關閉剛才的中央,回到 PowerShell,不帶 -S 啟動:

終端機視窗
.\build\debug\Vinc.exe

看到 VINC ready 後,在 Vinc Shell 輸入:

srun scripts/rpc-startup.tcl

同樣等到 Script completed: scripts/rpc-startup.tcl,再輸入 sender count,這次新啟動的接收端會回覆 RPC received=0。

-S 適合啟動 Vinc 時直接執行;srun 則是在已開啟的 Shell 執行腳本。

這份範例使用固定的實例名稱 sender、receiver。兩個 Module 已在運行時,重複執行同一份啟動腳本會因同名實例而失敗。

exit

等到 stopped sender、stopped receiver 並回到 PowerShell。腳本完成會留下 Module 繼續運行,Shell 的 exit 才會要求它們正常停止。

沒有看到 Script completed?

先確認 PowerShell 的位置與腳本路徑。若腳本某行失敗,錯誤會顯示檔名與行號,該次腳本就會停止。

已啟動的 Module 仍會繼續運行,不會自動回復到執行腳本前的狀態。可以先用 exit 正常關閉,修正腳本後重新啟動。

接著閱讀讓模組輸出日誌,記錄模組運作,並選擇 Shell 要顯示的等級。