# 🔧 RapidHarness 詳細使用教學指南

> 作者：范紹捷/動力組/5~9代
> 適用對象：首次使用 RapidHarness 的學生
> 更新時間：2025/06/25

---

## 目錄
1. [安裝與登入](#安裝與登入)
2. [建立新專案](#建立新專案)
3. [建立與編輯元件](#建立與編輯元件)
4. [繪製線束圖](#繪製線束圖)
5. [設定線材參數](#設定線材參數)
6. [使用 Harness Node 匯流](#使用-harness-node-匯流)
7. [加入 Label 與文字說明](#加入-label-與文字說明)
8. [產出報表與圖檔](#產出報表與圖檔)
9. [進階技巧](#進階技巧)
10. [FAQ 常見問題](#faq-常見問題)

---

## 安裝與登入

### ✅ 步驟：
1. 前往 [https://www.rapidharness.com](https://www.rapidharness.com)
2. 點選右上角 `Download` → 選擇 Windows / Mac 版本
3. 安裝完成後打開，點選 `Sign up` 註冊帳號（或用 Google 登入）

---

## 建立新專案

### ✅ 步驟：
1. 開啟 RapidHarness → 左上角點選 `+ New Harness`
2. 命名專案（如：2025_Main_Power）→ 點選 `Create`
3. 畫布出現後，左側為元件區、右上為屬性區

---

## 建立與編輯元件

### ✅ 建立元件：
1. 點選左側 `Components` → `+ Add Component`
2. 命名（例如：ECU、Sensor、Battery）
3. 選擇元件類型（Connector / Inline / Module）

### ✅ 編輯元件 Pin：
1. 選取元件 → 點 `Edit`
2. 點選 `+ Add Pin`
3. 設定 Pin 名稱（如 CANH、12V、GND）
4. 指定方向：
   - Input / Output（邏輯訊號）
   - Power / Ground（電源）

### ✅ 小技巧：
- 可複製元件，快速建立相似接頭
- 可加入 Color 標籤幫助辨識用途

---

## 繪製線束圖

### ✅ 基本畫線步驟：
1. 拖拉元件進畫布中
2. 點一下 Pin → 拖曳出導線 → 連到另一元件的 Pin
3. 點導線 → 右上屬性區調整顏色與類型（Power、CAN、Analog）

### ✅ 導線顏色建議：
| 類型 | 顏色建議 | 線徑 |
|------|----------|------|
| 電源 (12V) | 紅色 | 14~16 AWG |
| 接地 (GND) | 黑色 | 14~16 AWG |
| CANH / CANL | 綠色 / 藍色 | 20~22 AWG |
| 感測訊號 | 灰色 | 22~24 AWG |

---

## 設定線材參數

### ✅ 設定步驟：
1. 點選導線 → 點右上角齒輪（Properties）
2. 設定：
   - **Wire Name**：自訂線號（如：W12_CAN_H）
   - **AWG**：線徑（選擇合適的粗細）
   - **Color**：指定顏色
   - **Type**：訊號類型（Power / Signal / CAN / GND）

### 🔍 設定會自動反映於報表與 BOM 中！

---

## 使用 Harness Node 匯流

### ✅ 使用情境：多個 GND 匯流或 VBAT 匯流

### 步驟：
1. 點選畫布空白處 → `Add Node`
2. 命名（如：GND_Node）
3. 將導線拉到 Node 上，系統會自動將多條線合併
4. 可標記 Node 以協助布線

---

## 加入 Label 與文字說明

### ✅ 步驟：
1. 上方工具列點選 `T` 圖示（Text Label）
2. 點畫布位置加入文字 → 輸入如「Main Battery」或「CAN Line」
3. 可改變字型與大小，標示區塊或元件用途

---

## 產出報表與圖檔

### ✅ 報表匯出：
1. 點選上方 `Reports`
2. 常用報表：
   - **Wire Table**：包含線號、線徑、長度
   - **Connector Pinout**：列出每個元件的 Pin 定義
   - **BOM**：自動列出所有材料與數量

### ✅ 圖檔匯出：
- 點選 `File → Export` → 選擇 PNG / PDF / SVG
- 適合製作安裝手冊或技術手冊

---

## 進階技巧

| 技巧 | 說明 |
|------|------|
| 自建 Connector | 可自訂腳位排布、加上背殼模型 |
| 多頁專案 | 分頁建立不同模組（如：儀表、主電源、後段車身） |
| 材料庫編輯 | 可輸入自家線材料號、端子品牌等 |
| 項目版本控制 | 每次修改皆可儲存為版本，便於追蹤更動 |

---

## FAQ 常見問題

### ❓ A. 無法拉線怎麼辦？
請檢查元件 Pin 是否設定為 Input/Output/Power。若皆為 "Not Assigned"，導線無法連接。

### ❓ B. 如何統一線號命名？
可在 `Reports → Wire Table` 批次編輯 Wire Name。

### ❓ C. 可以和 KiCad 交互使用嗎？
目前無直接匯入匯出，但可作為 KiCad 線束設計前的規劃輔助。

---

## 🔚 結語

RapidHarness 是適合 FSAE / 車輛控制系統開發的線束設計工具。  
它將繁瑣的配線邏輯簡化為圖形化操作，幫助團隊規劃配線、降低錯線率、提升裝配效率。

---