相關教學
機械手臂使用指南
各裝置名稱
名稱 | 型號 | 圖片 |
---|---|---|
關節式機器手臂(以下稱「手臂」) | RT605-710-GB | |
機器手臂控制器(以下稱「控制箱」) | RTC605-710-GB | |
教導器 | TP02 |
開機與關機
連線
常見問題:
- HRSS 版本與 HRSDK 版本有對應關係,如有更新任一方,應向上銀確定,否則可能會造成手臂無法連線。
- 除非有需求,不然保險起見,應將除了手臂連線用的網路介面卡外的所有網路介面卡都禁用。
- IP 位置
127.0.0.1
代表的是該電腦自己本身(localhost),是測試的時候才會用到的,實際使用上不應出現或使用此 IP。 - HRSDK 都應有隨附上銀所提供的 SampleCode 範例程式,可作爲手臂測試用。
編輯此章節時的 HRSS 版本
3.3.11.7492
,HRSDK 版本2.2.9_7492
。
以教導器控制
詳細待補。
工作流程 Workflow
工作流程大致上與 GitHub-Flow 一樣,請先去瞭解其運作,並善用 nfu-irs-lab/test 進行練習。
在此每個 repo 會有兩個 Branch:main
和 develop
。其中 develop
Branch 的功能就是 GitHub-Flow 中的 main
或 master
Branch,而我們真正的 main
Branch 只作為發行用,只由管理員負責管理,一般人不需要也不允許操作組織上的 main
Branch(除了 Pull 和 Fetch)。
▲ 實驗室 Git 工作流程
一般成員
首次使用
- 登入網頁版 GitHub。
- 進入目標的「組織 Remote repo」,點選「Fork」按鈕,將其
Fork
進自己的 GitHub 帳號,它會變成「個人 Remote repo」。- 例如將 nfu-irs-lab/test
Fork
進自己的 GitHub,會產生一個「YOUR_NAME/test」的 repo。
- 例如將 nfu-irs-lab/test
- 將「個人 Remote repo」
Clone
到個人電腦上。此時電腦上的就是「個人 Local repo」。 - 將「組織 Remote repo」添加到「個人 Local repo」作為新的 Remote repo。
- 確認此時的「個人 Local repo」應該有 2 個 Remote repo,分別為:「個人 Remote repo (origin)」和「組織 Remote repo」。
- 完成。
一般作業
Checkout
到「個人 Local repo」上的develop
Branch,並且Pull
「組織 Remote repo」的develop
Branch。- 此步驟的目的是確保「個人 Local repo」已經更新到最新的狀態。
- 在「個人 Local repo」上從
develop
Branch 中新增一個新 Branch,並命名為GOAL
,其中GOAL
是本次目標要做的事情,並確認已經Checkout
到GOAL
Branch 上。- Branch 的命名可以使用「iss + issue編號」,例如:命名爲「iss3」代表此 Branch 要處理 Issue #3 。
- 圖中以
feature_1
與feature_2
爲例。
- 在
GOAL
Branch 上進行作業、送Commit
。 - 當本次目標要做的事都已經完成、
Commit
都送完後,Checkout
到「個人 Local repo」上的develop
Branch。 - 將「個人 Local repo」上的
GOAL
BranchMerge
到「個人 Local repo」上的develop
Branch。Checkout
到develop
後,Merge
GOAL
intodevelop
。
- 將「組織 Remote repo」上的
develop
BranchPull
到「個人 Local repo」上的develop
Branch。 - 若發生衝突,與其它人討論後解決衝突。
- 如果你在
GOAL
Branch 上進行作業時,「組織 Remote repo」上有其它人的更新,也就是同一個檔案有多個人修改,就會發生衝突,請討論後決定要保留誰的修改版本。
- 如果你在
- 將「個人 Local repo」上的
develop
BranchPush
到「個人 Remote repo」上的develop
Branch。 - 發起
Pull Request (PR)
。方向為「base: 組織 Remote repo/develop 」←「compare: 個人 Remote repo/develop」。 - 等待發起的
PR
被管理員審查。 - 若
PR
被要求修改,請在「個人 Local repo」上的GOAL
Branch 繼續修改、送Commit
,如同步驟 3 ~ 8。完成步驟 8 後,步驟 9 發起的PR
會自動更新,不用再發起新的PR
。 - 若
PR
被接受、已經被Merge
或Rebase
並標記爲「Closed」,將「組織 Remote repo」上的develop
BranchPull
到「個人 Local repo」上的develop
Branch。- 此步驟的目的是確保「個人 Local repo」已經更新到最新的狀態。
- 為了保持整潔,可以刪除「個人 Local repo」上的
GOAL
Branch,因為它的工作已經結束了。 - 完成。
管理員
未完成。
手臂控制程式架構
▲ 手臂控制程式概略架構圖