使用啟動腳本
這篇接續第一個 RPC,把原本手動輸入的 rpcSubscriber、rpcPublisher 寫進一份啟動腳本,讓 Vinc 依序啟動兩個 Module。
沿用前篇已建置的 open-vinc-examples。以下 PowerShell 命令都在 repository 根目錄執行,也就是看得到 scripts/ 與 build/ 的位置。
1. 準備啟動腳本
Section titled “1. 準備啟動腳本”範例已附上 scripts/rpc-startup.tcl,內容很簡單:
# 先啟動接收端,再啟動發送端。rpcSubscriberrpcPublisherscripts/rpc-startup.tcl · e165aed · 中文註解
# 開頭是註解。接下來兩行就是原本在 Vinc Shell 輸入的 ModuleType。
腳本使用 Tcl,由中央的 Vinc Shell 執行。C++ 與 Python 模組共用同一份腳本,範例建置也已帶入所需的 Tcl,不必另外安裝。
每行會依序執行:先等 rpcSubscriber 啟動完成、收到 Ready,再啟動 rpcPublisher。最後一行完成後,兩個 Module 會繼續運行。
2. 啟動 Vinc 時執行腳本
Section titled “2. 啟動 Vinc 時執行腳本”若前一次的 Vinc Shell 還開著,先輸入 exit。回到 PowerShell,執行:
.\build\debug\Vinc.exe -S scripts/rpc-startup.tcl.\build\python\Vinc.exe --python .\.venv\Scripts\python.exe -S scripts/rpc-startup.tcl-S 指定啟動時執行的腳本。Python 的 --python 要放在 -S 前面。
腳本路徑是相對於目前的工作目錄,所以這裡要從 repository 根目錄執行。只修改 .tcl 內容時,不需要重新建置 Module。
會看到兩個 Module 的啟動輸出。請等到:
Script completed: scripts/rpc-startup.tcl這表示腳本已正常完成,現在可以繼續在 Vinc Shell 輸入指令,不需要再次手動建立兩個 Module。
3. 確認模組可以操作
Section titled “3. 確認模組可以操作”先詢問接收數量:
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.\build\python\Vinc.exe --python .\.venv\Scripts\python.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 已在運行時,重複執行同一份啟動腳本會因同名實例而失敗。
5. 正常關閉
Section titled “5. 正常關閉”exit等到 stopped sender、stopped receiver 並回到 PowerShell。腳本完成會留下 Module 繼續運行,Shell 的 exit 才會要求它們正常停止。
沒有看到 Script completed?
先確認 PowerShell 的位置與腳本路徑。若腳本某行失敗,錯誤會顯示檔名與行號,該次腳本就會停止。
已啟動的 Module 仍會繼續運行,不會自動回復到執行腳本前的狀態。可以先用 exit 正常關閉,修正腳本後重新啟動。
接著閱讀讓模組輸出日誌,記錄模組運作,並選擇 Shell 要顯示的等級。