# WO_40118 接觸感應器技術彙整手冊

## 1. 產品規格與硬體描述
WO_40118 是一款基於 ZigBee 協議的門磁/接觸感應器，用於偵測門窗、櫃體的開闔狀態。

### 硬體規格參數
- **產品尺寸**：
    - 感應主體：65 x 32 x 16 mm
    - 磁鐵部分：51 x 16 x 11 mm
- **電源供應**：CR2032 鋰電池 x 1
- **觸發距離**：< 20 mm
- **通訊協議**：ZigBee

### 接線說明 (Wiring Diagram Description)
裝置採無線化設計，無須實體配線：
- **內部供電**：內置 CR2032 電池倉，提供傳感模組電力。
- **無線連接**：完全透過 ZigBee 無線訊號與網關主機通訊。

---

## 2. 軟體架構與操作邏輯
### 軟體系統架構
1. **管理層**：Matter 控制器, Home Assistant (ZHA), HomeKit, Google Home。
2. **通訊層**：區域網路由器與本地 ZigBee Mesh 網絡。
3. **主機層**：環控主機核心（處理感測邏輯與聯動觸發）。
4. **設備層**：WO_40118 感應器（即時回報開闔狀態與電池電量）。

### 配對設定流程
- **重置模式**：長按配對鈕至指示燈閃爍。
- **配對步驟**：
    - **Matter**：透過渥屋智能 App 網關管理介面進行「快速添加」。
    - **ZHA**：於系統「裝置與服務」中新增 ZHA 整合並搜尋裝置。
- **狀態顯示**：App 內可即時顯示「開啟 (Opening)」或「關閉 (Closed)」狀態。

---

## 3. 工程應用與場景建議
- **安防聯動**：支援門窗入侵監測與手機 App 警報推送。
- **照明自動化**：可結合玄關或櫃體門，實現開門即開燈之場景。
- **紀錄追蹤**：系統自動儲存開闔歷史紀錄供日後查詢。