# CSI-H238M 高精度摩擦係數測試儀上位機系統

## 項目簡介

CSI-H238M 是一款基於 **C# WPF** 技術開發的專業摩擦係數測試儀上位機系統，符合 **ASTM D1894**、**ISO 8295** 和 **GB 10006** 國際標準。系統採用 **MVVM** 設計模式，提供高精度、高響應性的測試界面。

## 主要特性

### ✨ 核心功能
- 🎯 **實時數據採集**：支持最高 1000 Hz 採樣率
- 📊 **動態曲線繪製**：基於 LiveCharts 的流暢圖表
- 🧮 **自動計算**：靜摩擦係數（μs）和動摩擦係數（μk）
- 💾 **數據存儲**：JSON 格式保存，支持 CSV 導出
- 🔧 **多種通信**：支持模擬、Modbus TCP、串口通信

### 🎨 用戶界面
- 🖥️ **12 吋觸控屏優化**：大按鈕、清晰顯示
- 🇨🇳 **中文界面**：繁體中文本地化
- 🎨 **工業風格**：專業、簡潔的設計
- ⚡ **實時監控**：力值、位移、狀態實時更新

### 🔬 數據處理
- 📈 **滑動平均濾波**：減少傳感器噪聲
- 📉 **中值濾波**：抑制脈衝干擾
- 🔍 **異常值檢測**：3-sigma 原則
- 📐 **標準符合**：ASTM D1894、ISO 8295、GB 10006

## 快速開始

### 環境要求
- Windows 10/11
- .NET 8.0 SDK
- Visual Studio 2022（可選）

### 安裝步驟

1. **克隆項目**
```bash
git clone https://github.com/your-repo/CSI-H238M.git
cd CSI-H238M
```

2. **還原依賴**
```bash
dotnet restore
```

3. **編譯項目**
```bash
dotnet build
```

4. **運行程序**
```bash
dotnet run --project CSI-H238M/CSI-H238M.csproj
```

## 使用指南

詳細使用說明請參閱：[使用說明.md](CSI-H238M/使用說明.md)

## 項目結構

```
CSI-H238M/
├── Models/                    # 數據模型
│   ├── Model.cs              # 核心數據結構
│   └── AppConfig.cs          # 配置管理
├── Services/                  # 業務服務
│   ├── Services.cs           # 數據處理和模擬
│   ├── ModbusService.cs      # Modbus 通信
│   └── DataStorageService.cs # 數據存儲
├── ViewModels/               # 視圖模型
│   └── ViewModel.cs          # 主視圖模型
├── Views/                    # 用戶界面
│   ├── MainWindow.xaml       # 主窗口 XAML
│   └── MainWindow.xaml.cs    # 主窗口代碼
└── App.xaml.cs               # 應用程序入口
```

## 技術棧

- **框架**：.NET 8.0 + WPF
- **設計模式**：MVVM
- **圖表庫**：LiveCharts.Wpf 0.9.7
- **數據格式**：JSON (System.Text.Json)
- **通信協議**：Modbus TCP（可擴展）

## 更新日誌

### v1.0.0 (2026-01-13)
- ✅ 初始版本發布
- ✅ 支持模擬和 Modbus TCP 通信
- ✅ 實現 ASTM D1894 和 ISO 8295 標準
- ✅ 數據存儲和 CSV 導出
- ✅ 中文界面

## 許可證

版權所有 © 2026 CSI Instruments. 保留所有權利。

## 聯繫方式

- 📧 技術支持：support@csi-instruments.com
- 📚 文檔：https://docs.csi-instruments.com
- 🌐 官網：https://www.csi-instruments.com