DIATwinQUICK START
第一次使用
依序完成安裝、產品標註，再進行模擬與生成配方。
QUICK START · 01
安裝與啟動
操作影片
完成目標：安裝後能啟動 MachinePilot，並且開始運行操作
1. 系統需求與安裝
1.1 系統需求
安裝前，請確認電腦規格、使用者權限及網路環境符合下列需求。
| 項目 | 需求 |
|---|---|
| 處理器（CPU） | Intel Core i7 或以上。 |
| 記憶體 | 建議 32 GB；標準配置為 64 GB。 |
| 顯示卡 | 待補充適用型號與規格。 |
| 安裝磁碟空間 | 保留至少 2 GB 可用空間。 |
| 安裝權限 | 具備安裝軟體所需的管理員權限。 |
| 網路連線 | 可連線至所使用授權類型需要的授權服務；詳細方式請參閱 2.2 授權與首次啟動。 |
1.2 安裝 MachinePilot
準備 DIATwin_Machine_Pilot_Enterprise_1.6.0.msi，並依下列步驟安裝。
- 雙擊安裝程式；若系統顯示權限確認視窗，允許安裝程式執行。
- 等待安裝精靈開啟，閱讀並接受軟體授權條款。
- 確認安裝選項。可使用預設設定；如需調整安裝範圍或自訂路徑，選擇
Advanced並完成設定。 - 確認設定後，開始安裝。
- 等待安裝完成，確認未顯示錯誤訊息，再關閉安裝精靈。
2. 授權與首次啟動
啟動 MachinePilot，依取得的授權選擇下列其中一種方式。完成授權後，接續安裝官方設備資料。
| 類型 | 使用資料 | 首次使用 |
|---|---|---|
| Offline | License Text | 依提供的授權完成首次啟用；需要線上綁定時，先連線完成啟用。 |
| Floating | License Key | 保持可連線至所使用的授權服務。 |
2.1 啟動 MachinePilot
- 完成安裝後，勾選 Launch 並按 Finish，或開啟 MachinePilot 桌面捷徑。
- 進入授權類型選擇畫面，依提供的授權選擇 Offline 或 Floating。
2.2 Offline：選擇授權類型
選擇 I have an offline license，按 Next >。
2.3 Offline：輸入 License Text
- 將提供的完整授權文字貼入 License text。
- 若交付環境要求 Proxy，依提供的資訊填入 Proxy Host 與 Port。
- 按 Validate，完成首次啟用後接續下方 dtpkg 安裝。
2.4 Floating：選擇授權類型
選擇 I have a floating license，按 Next >。
2.5 Floating：輸入 License Key
- 填入提供的 License key。
- 依交付的授權服務與網路設定填寫必要連線資訊。
- 按 Validate，完成驗證後接續 dtpkg 安裝。
本節依授權資料正確且可順利啟用的流程操作。授權問題請查閱疑難排解。
3. 模型與範例資料（dtpkg）安裝
本流程以首次安裝、指定位置尚無舊版設備資料為起點。完成授權後，系統會依既有設定檢查設備資料，依下列畫面安裝提供的官方 .dtpkg。
3.1 設定資料儲存位置
- 在 Set Up Equipment Data 確認設備資料與 Workspace 的儲存位置。
- 需要更改時按 Browse… 選擇資料夾。
- 按 Continue。系統會在該位置下建立
AssetLibrary/PackageStore與AssetLibrary/Workspace。
3.2 選取並安裝 dtpkg
- 在 Equipment Data Required 按 Select Equipment Data File…。
- 選取隨本版軟體提供的相符
.dtpkg檔案。 - 依接續畫面完成安裝，等待資料檢查及安裝結束，再開始開啟資產。
3.3 開啟並核對
- 進入 Electronic Component → Open Project。
- 選擇對應的 Group，確認模型清單已顯示。
- 選取提供的資產，按 OK 開啟。再切換 Product，準備建立 APEX 單板。
完成檢查：MachinePilot 可啟動、設備資料已安裝，且能開啟所需資產。
QUICK START · 02
產品標註快速上手
操作影片
使用 APEX 範例，從新單板、BOM 與零件連結，完成 Gerber／PNP 標註、3D 板體、結合點及產品儲存。
開始前：已完成 MachinePilot 授權及官方設備資料安裝，並可在 Internal Library 查找提供的電子零件。
解壓縮後保留 QuickStart_Materials 資料夾。同一份 CSV 會分別用於 BOM 與 PNP 匯入。
1. 建立單板與匯入 BOM
BOM CSV 欄位與空值處理
使用 CSV、UTF-8 without BOM、CRLF 換行、逗號分隔。Designator 與 Part Number 是必要的欄位映射，Description 選填；不代表每列缺值都會讓整份檔案被拒絕。
匯入後分別核對來源列數、略過列、實際新增列與未連結列。已匹配呈藍色，未匹配呈黑色；同時確認料號及實際資產，不能只看顏色。準備完整 Library 可減少未匹配，但不是保留 BOM 列的必要條件。
其他編碼、XLS／XLSX 直接匯入、大小寫／空白匹配、含逗號文字的解析，以及重複匯入既有 BOM 的規則尚未完整確認。
1.1 建立新單板
- 進入 Product，按 New Board。
- 在 Create Root 輸入產品名稱，例如
APEX_QuickStart，按 OK。 - 確認左側出現 Workpart、BOM 與 Mountpoint。
1.2 建立使用者電子零件資料庫
- 選取單板下的 BOM（BOM Behavior）。
- 在右側 Electronic Component List 按 ＋CREATE。
- 輸入
HelloLibrary，按 CREATE，確認 Library 切換至新資料庫。
1.3 匯入 APEX BOM
按右側下方 IMPORT BOM，選擇 QuickStart_Materials/APEX OI Data.csv，依下表選擇來源欄位後完成匯入。
| 匯入目標 | CSV 來源欄位 |
|---|---|
| Designator | RefDes |
| Part Number／PartNo. | PartNo |
| Description | Description |
此時列表呈黑色，表示尚未 Linked 至剛建立的 HelloLibrary；接著完成零件對應。
2. 對應提供的電子零件
2.1 依 Description 尋找外型並建立料號對應
- 選取尚未連結的 BOM 項目，開啟 Component Library Search。
- 切到 Internal Library，依 CSV 的 Description 核對外型、尺寸及接腳，選用提供的對應電子零件。
- 在資產卡片按 ADD TO HelloLibrary，於 Part No. 填入該列 CSV 的 PartNo，完成加入。
- 返回 HelloLibrary，以料號找到該資產，按 LINK，回到 BOM 確認連結。
- 依序完成其餘料號；同料號共用對應時，仍核對各 Designator 的連結結果。
完成檢查：每列 BOM 的料號、Description 與選用資產相符，Linked／Unlinked 狀態符合預期。
3. 匯入 Gerber 與數位標註
PNP 匯入與位置檢查
APEX 練習資料限制：APEX OI Data.csv 的 RY1、RY2、C170、C174 共四列 Rz 空白，尚不符合 PNP 匯入要求。先依實際方向補齊工作副本並驗證；不得直接假定為 0。此檔可供欄位對照，但不能當作已驗證可直接匯入的 PNP 範本。
PNP 座標一律視為 mm，不轉換 inch；Designator、X、Y、RotationZ 須有值。
3.1 建立兩個 Link
- 在單板根節點按右鍵，選 Create Link…。
- 建立 Top Layer (Gerber)，確認出現
Link_GerberTop。 - 再建立 3D Shape，確認出現
Link_Shape。
3.2 匯入頂層 Gerber
在 Link_GerberTop 按右鍵 → Import Gerber Shape…。進入 QuickStart_Materials/Gerber_APEX2024，按住 Ctrl 選取本例頂層的四個檔案並開啟：
- APEX2024 Layer 1 stencil_ 2mil.gbr
- APEX2024 Layer 1.gbr
- APEX2024 Layer1 mask.gbr
- APEX2024 Layer1 silk.gbr
核對 Link Feature Data 的四個圖層，以 Focus Viewport 查看板件輪廓。
3.3 使用 Import PNP 批次建立標註
- 選取 Link_GerberTop，使用 Import PNP。
- 選擇同一份
QuickStart_Materials/APEX OI Data.csv。 - 依下表指定欄位，核對匯入預覽後完成批次匯入。
- 確認 Designator 與 BOM 相符，並在 Gerber 上檢查位置與旋轉方向。
| 匯入目標 | CSV 來源欄位 |
|---|---|
| Designator | RefDes |
| X | X |
| Y | Y |
| RotationZ | Rz |
本例採數位資料匯入完成標註。手動標註可另參考使用手冊的產品標註說明。
4. 產生板體與調整圖層高度
4.1 量測板件外型
按 Measure，依序選取板件外框的兩個對角端點。核對 X 方向長度 304.8 mm、Y 方向寬度 165 mm。量測顯示負值時，尺寸取其長度大小。
4.2 產生 3D 板體
選取 Link_Shape → ParametricShape，確認 Shape Type 為 Box，輸入下列尺寸，再按 GENERATE。
| 軸向 | 參數 | 輸入值（mm） |
|---|---|---|
| X／長邊 | Length | 304.8 |
| Y／短邊 | Width | 165 |
| Z／板厚 | Height | 3.0 |
確認板體已產生，長寬與 Gerber 外框相符。
4.3 將 Gerber 移至板體上表面
- 在 Link_GerberTop 按右鍵，開啟 Move Link…。
- 本例從初始 Z＝0 開始，確認 Coord Mode＝Offset。
- 依板厚輸入 X＝0、Y＝0、Z＝3.0 mm，旋轉維持 0，按 OK。
- 確認 Gerber 圖層位於板體上表面。
PS：避免圖層與板子重疊時呈現閃爍，可以輸入 3.001 mm 避免此現象。此值替代本步驟的 3.0 mm；若已移動 3.0 mm，Offset 僅再增加 0.001 mm，不要重複增加 3.001 mm。
5. 結合點與產品尺寸
5.1 自動建立產品結合點
在單板的 Mountpoint 按右鍵 → Create Mount Point，核對自動產生的八個角點及對應位置。
5.2 設定 Workpart 尺寸
選取單板的 Workpart，依剛才建立的板體輸入：
| 欄位 | 方向 | 數值（mm） |
|---|---|---|
| Width | X | 304.8 |
| Length | Y | 165 |
| Thickness | Z | 3.0 |
這裡設定的是 Workpart，不是 Workspace 設定。Gerber 的 0.001 mm 顯示間距不改變本例板體的建模厚度。
6. 儲存並重新確認
6.1 Save to Library
- 在 Product → Save to Library 開啟儲存視窗。
- 核對目前產品、Name（例如 APEX_QuickStart）、版本與保存位置。
- 在 Group membership 選擇 ProductCatalog，按 ＋Add，確認群組列入表格。
- 使用 Capture from 3D view 更新預覽，按 OK 儲存。
- 確認儲存成功後，以 Product → Open Project 在對應 Group 找到並重新開啟本次產品。
6.2 完成檢查
- BOM 的 Designator、PartNo 及資產連結正確。
- Gerber、匯入標註的位置與旋轉方向相符。
- 板體尺寸為 304.8 × 165 × 3.0 mm，Workpart 已輸入對應尺寸。
- 八個結合點已建立，重新開啟後資料仍保留。
完成後接續機台配置、模擬與配方流程。
QUICK START · 03
模擬時間與生成配方
操作影片
沿用 Demo_Single_Board，完成機台自動配置與模擬，查看 Cycle Time 並匯出配方檔。熟悉範例後，再以自己建立的單板重做一次。
1. 載入範例單板與機台
- 確認已完成官方 dtpkg 安裝，使用資料中提供的 Demo_Single_Board 與對應機台、工具及供料器。
- 進入 Recipe → Create Project，選擇已安裝的適用機台與 Demo_Single_Board。
- 核對產品名稱後按 Next，進入產品組裝。
2. 完成產品組裝
- 依 Product Assembly 的順序設定 Select Position 與 Adjust Orientation。
- 設定 Select Attachment Point，再以 Adjust Conveyor Width 配合板件寬度。
- 從 3D 視圖確認板件位置、朝向及輸送帶寬度，再進入配置。
3. 自動配置工具與供料器
- 核對供料器與工具槽位的可用、啟用及鎖定狀態。
- 按 Auto Configure，等待運算完成。
- 在 Auto Configure Result 檢查 Feeder 與 Tool 建議，按 Import，依提示繼續並等待配件安裝完成。
- 確認配置位置顯示安裝狀態、必要配件齊全且 Next 可用，再進入流程與模擬。
4. 執行模擬並查看 Cycle Time
- 進入 Run Simulation，等待初始化完成後按 Start。
- 觀察工具取料、移動與插件動作，搭配 Check Collision 與狀態欄核對結果。
- 讀取並記錄本次 Cycle Time（C.T.）。同時保留產品與配置條件，作為下一步比較基準。
畫面中的時間是該次模擬結果，不預設所有產品都會得到相同數值。
5. 調整順序後再模擬
- 回到 Flow Editor，核對 Designator、Feeder Slot、Tool Slot。
- 依練習需求調整 Pick Seq. 與 Insert Seq.。
- 重新執行 Path Planning／Run Simulation，使用更新後的流程重新計算。
- 按 Start，觀察動作並記錄新的 C.T.。保持產品與配置條件一致，對照調整前後結果。
6. 生成並匯出配方
- 在 Run Simulation 按 Export DB。
- 核對匯出視窗中的座標基準、加工模式與產品形狀資訊。
- 按 Browse 選擇輸出資料夾，輸入 .db 檔名並保存。
- 返回匯出視窗完成 Export，到目的資料夾確認本次輸出的配方檔。
7. 換成自己建立的單板練習
完成範例後，以 Step 2 保存的產品重新建立 Recipe Project，依本頁流程完成組裝、自動配置、模擬、C.T. 查看及匯出。核對新的產品名稱與配置，重新產生配方檔。