ShadowTac 組裝指南
以微型攝影機與柔軟薄膜打造、以視覺為基礎的觸覺感測器
授權條款
CC BY-NC-SA 4.0
組裝指南
1. 開始之前
原專案為這個感測器公開了什麼、遺漏了什麼,以及你手上可能是哪個版本的說明。
1.1 閱讀原專案公開與未公開的內容
唯一的組裝途徑是 ShadowTac 儲存庫的 README,附有 CAD 檔案、Python 程式碼與一個 Arduino sketch。
- 原專案只發布一種製作方式:ShadowTac 儲存庫中的 README。內容涵蓋在 SLA 列印的模具中澆鑄帶凹點的矽膠膜、為其上漆、將其黏合到 PMMA 板上、在列印的外殼中裝入三顆 RGB LED、安裝攝影機,以及在電腦上執行 Python 程式碼。
- 此感測器不使用紅外線 LED、觸覺單元、外加標記或力校正曲線。README 表示,凹點圖案直接由模塑製程形成,三顆 RGB LED 會產生彩色陰影,由攝影機記錄。
- 影像處理不需要燒錄任何程式到微控制器。唯一的韌體是 other/rgb_led.ino,用來點亮三顆 LED。影像處理在電腦上以 Python 執行。
- 原專案沒有提供物料清單、配線圖、LED 零件編號、草稿碼適用的板子名稱、sensor_base 與其他部分的接合方式,也沒有任何安全警告,包括 LED 電源方面的警告。因此本指南只提供 README、程式碼與 CAD 資料夾中說明的內容。
- 請確認你手上的是哪一版 README。在 2025 年 7 月 1 日(commit 0e56e2fe)之前,README 要求用一般的瞬間膠將 PMMA 與矽膠組件固定到外殼上。目前的 README 要求使用非氰基丙烯酸酯的柔性聚合物黏著劑,因為氰基丙烯酸酯的揮發氣體會讓光學元件起霧。請依照目前的說明。
- 在 2025 年 7 月 1 日(commit 495e9f5d)之前,塗料表的前兩列標示為 SilPoxy A 與 SilPoxy B。在目前的 README 中,它們是 PsychoPaint A 與 PsychoPaint B。
2. 觸覺薄膜
在 SLA 列印的模具中澆鑄帶凹點的矽膠薄膜,塗上反光混合塗料,再黏合到 PMMA 板上。
2.1 3D 列印矽膠模具
模具以 SLA 列印以確保凹點精度,其上半部可用 FDM 印表機列印。
- 用 SLA 印表機列印模具。README 表示,要達到高凹點精度必須使用 SLA。
- 模具的上半部可以用 FDM 印表機列印。README 寫的是「FDA」;本指南將其解讀為 FDM。
- 模具檔案在 CADs 資料夾中:sillicone_mold.stl(儲存庫中拼成兩個 l)與 silicone_mold_top.stl。STEP 版本 silicone_mold.step 與 silicone_mold_top.step 也在其中。
- README 在此處提到 sensor_casing.stl 與 sensor_casing_top.stl。這些是外殼的名稱,而儲存庫中並沒有 sensor_casing_top 檔案。請使用上方的兩個模具檔。
- README 的圖片(階段 1 與 2)顯示列印好的模具,其上半部以螺絲固定。沒有任何文字說明螺絲尺寸或數量。
2.2 準備矽膠
以最多 30% 的 Smooth-On Silicone Thinner 稀釋 Smooth-On Solaris 矽膠。
- 使用 Smooth-On Solaris 矽膠,並以最多 30% 的 Smooth-On Silicone Thinner 稀釋,以降低蕭氏硬度。
- 依照供應商網站上的說明調製矽膠。
- 公布的配方:Silicone Solaris A 5 g(36%)、Silicone Solaris B 5 g(36%)、Silicone Thinner 4 g(28%)。
- 原專案表示,這些配方可稍作調整,不會影響感測器的運作。
2.3 脫泡、澆鑄與固化
將混合物脫泡,在模具上塗抹脫模劑,倒入後固化 24 小時再脫模。
- 澆注前先對矽膠混合物進行脫泡,以去除氣泡。
- 在模具上塗抹脫模劑,讓固化後的矽膠容易取出。
- 將矽膠倒入模具中,靜置固化 24 小時。
- 24 小時後,小心地將矽膠觸覺薄膜脫模。
2.4 準備塗料混合物
混合 Smooth-On Psychopaint A/B、NOVOCS Matte 溶劑、鋁粉與 White Silc Pig。
- 調製由 Smooth-On Psychopaint A/B、NOVOCS Matte 溶劑、鋁粉與 White Silc Pig 組成的塗料混合物。
- 依照供應商網站上的說明調製塗料。
- 公布的配方:PsychoPaint A 1.2 g(18%)、PsychoPaint B 1.2 g(18%)、NOVOCS Matte 3.5 g(50%)、Aluminium Powder 0.8 g(12.5%)、SilPig White 0.08 g(1.5%)。
- 原專案表示,這些配方可稍作調整,不會影響感測器的運作。
2.5 為薄膜上色
將塗料混合物均勻倒在薄膜上,讓它填滿每個凹點。
- 將塗料混合物均勻地倒在矽膠薄膜上。
- 為達最佳效果,塗料應完全滲入每個凹坑。
- 為此,先用手在凹坑上塗抹少量塗料,再倒入剩餘的混合物。
2.6 將薄膜黏到 PMMA 板上
以 Smooth-On SilPoxy 將上色的矽膠黏到厚 3 mm、直徑 34 mm 的 PMMA 板上。
- 使用 Smooth-On SilPoxy 黏著劑,將塗好的矽膠黏合到一片 3 mm 厚、直徑 34 mm 的 PMMA 板上。
- 黏合前先清潔表面。
- 輕微地扭轉與按壓有助於排除氣泡。
3. 感測器外殼與照明
列印外殼,裝上三顆 RGB LED,並將 PMMA-矽膠組件固定到外殼上。
3.1 3D 列印感測器外殼
外殼以 CADs 資料夾中的 sensor_casing.stl 列印。
- 在 FDM 印表機上列印感測器外殼。README 寫的是「FDA」;本指南將其解讀為 FDM。
- 檔案是 CADs 資料夾中的 sensor_casing.stl。該資料夾中也有 sensor_casing.step。
3.2 裝上三顆 RGB LED
焊接三顆 RGB LED,並以熱熔膠將它們固定在外殼內,避開發光錐範圍。
- 感測器由三顆 RGB LED 照明。它們投射出的彩色陰影就是量測原理,因此不要以紅外線 LED 替代。
- 焊接 RGB LED,並用熱熔膠將它們固定在外殼內。
- 確保它們不會遮擋發光錐。
- 草稿碼 other/rgb_led.ino 使用 Adafruit NeoPixel 函式庫,在針腳 6 上驅動三顆 NeoPixel 類型的像素(NUMPIXELS 3、NEO_GRB + NEO_KHZ800)。它將像素 0 設為紅色、像素 1 設為綠色、像素 2 設為藍色。
- 原專案未指明草稿碼使用的開發板,也未提供 LED 的供電電壓或接線圖。通電前請先查閱 LED 供應商的規格書。
- ShadowTac.py 將 LED 數值設為 self.angle = 45 與 self.order = 'RBG'。原專案並未解釋這兩個數值,也未說明這個順序與接線的關係。
3.3 將薄膜組件黏到外殼上
使用有彈性、非氰基丙烯酸酯類的聚合物黏著劑,例如 Bison Max Repair。
- 使用非氰基丙烯酸酯的柔性聚合物黏著劑,將 PMMA-矽膠組件固定到感測器外殼上。
- 這能避免揮發氣體造成的起霧。原專案的範例是 Bison Max Repair 膠。
- 不要使用氰基丙烯酸酯(瞬間膠)。2025 年 7 月 1 日之前的舊版 README 曾說使用一般的瞬間膠。
4. 攝影機與最終組裝
裝上指定的攝影機與鏡頭,並將攝影機與外殼接合。
4.1 選擇攝影機與鏡頭
原專案指定使用 Basler daA1920-160uc(S-Mount)攝影機與 Evetar M13B02820W 鏡頭。
- 相機:Basler daA1920-160uc(S-Mount)。
- 鏡頭:Evetar M13B02820W。
4.2 將攝影機接到外殼
以四顆 M2 螺絲與螺帽將攝影機固定到外殼上。
- 用四組 M2 螺絲與螺帽將相機與外殼組裝在一起。
- README 沒有提供關於鏡頭對焦或相機位置的進一步細節。
- CADs 資料夾中還有 sensor_base.stl 與 sensor_base.step,標示為用來安裝感測器的底座。原專案並未說明底座如何與感測器結合。
5. 運行感測器
將攝影機連接到電腦,安裝 Python 相依套件,記錄首次執行時的凹點配置,並以鍵盤指令操作處理流程。
5.1 連接攝影機並安裝相依套件
感測器在電腦上以 Python 執行,透過 USB micro-B 3.0 纜線連到攝影機。
- 感測器完全組裝好後,用 USB micro-B 3.0 纜線將相機連接到電腦。
- 程式碼位於 code 資料夾。它匯入 os、time、keyboard、cv2、numpy、scipy(scipy.spatial KDTree;scipy.fft ifftshift、fft2、ifft2)與 pypylon.pylon。請安裝缺少的套件。
- 如果你使用 Ubuntu,keyboard 模組可能需要管理員權限。請在 launch.json 設定檔中加入 "sudo": true。
5.2 設定程式碼目錄並啟動程式
將 ShadowTac.py 中的 dir 設為存放程式碼資料夾的上層資料夾完整路徑,然後直接執行 ShadowTac.py。
- 開啟 ShadowTac.py。它定義了 ShadowTac 類別,並管理 DimpleTrackingClass.py(側向處理)與 PhotostereoClass.py(法向處理)。
- 執行前,將 dir = r'path/to/your/code/directory/' 這一行改成你系統上 code 資料夾所在目錄的完整路徑。
- 直接執行 ShadowTac.py;它的底部有 main 區段。
- ShadowTac.py 會關閉相機的自動曝光與自動增益,並將 ExposureTime 設為 2000.0、Gain 設為 0。
5.3 首次執行:儲存初始凹點配置
新組裝的感測器需要自己的 ImgInitSensor.npy,方法是按下 s,再將儲存的檔案重新命名。
- 組裝好新的感測器時,要儲存一個新的 .npy 檔,記錄凹坑的初始位置。側向位移處理流程會以這個配置為基準追蹤移動。
- 按下「s」鍵。這會在 save 資料夾中產生 ImgInitSensor_new.npy。
- 將該檔案重新命名為 ImgInitSensor.npy,並移到 code 資料夾。
- 之後感測器就能辨識凹坑的初始位置,法向與切向處理流程都需要這些資訊。儲存庫中提供的 ImgInitSensor.npy 屬於原專案自己的感測器,必須替換。
5.4 使用鍵盤指令
以單一按鍵開啟或關閉各個處理流程。
- 「h」啟動高度圖處理流程。
- 「r」重設背景高度。
- 「c」啟動接觸面積偵測。
- 「t」啟動凹坑追蹤流程。
- 每按一次「s」就儲存一張影像。第一次按下時也會開始錄影,並持續到程式結束。
- 「e」一次啟動所有處理流程。
- 「q」結束程式。