# 📋 负载类型参数模板示例

## 🎯 概述

负载类型现在提供了**5个完整的参数模板示例**，其中**5个都配置了参数**，展示了各种参数类型的使用方法。

## 📊 数据概览

| 序号 | 类型名称 | 品牌 | 型号 | 参数数量 | 必填参数 |
|------|----------|------|------|----------|----------|
| 1 | 北斗定位终端 | 华为 | BD-200 | 2个 | 1个 |
| 2 | 高清摄像头 | 海康威视 | DS-2CD2345 | 2个 | 0个 |
| 3 | 油耗传感器 | 博世 | FS-100 | 1个 | 1个 |
| 4 | 转速传感器 | 西门子 | RS-500 | 6个 | 2个 |
| 5 | 温度传感器 | 霍尼韦尔 | TS-300 | 7个 | 3个 |

**总计**: 5个类型，18个参数，7个必填参数

## 📝 详细参数示例

### 1️⃣ 北斗定位终端（2个参数）

**基本信息**:
- 品牌: 华为
- 型号: BD-200
- 描述: 高精度北斗定位终端，支持实时位置上报和轨迹记录

**参数配置**:

#### 参数1: 上报间隔 ⭐ 必填
```
参数编码: reportInterval
参数类型: number (数字)
单位: 秒
默认值: 10
范围: 1 ~ 60
说明: 位置数据上报时间间隔
```

#### 参数2: 精度模式
```
参数编码: accuracyMode
参数类型: select (选择)
选项:
  - 高精度 (high)
  - 普通 (normal)
默认值: high
说明: 定位精度模式
```

---

### 2️⃣ 高清摄像头（2个参数）

**基本信息**:
- 品牌: 海康威视
- 型号: DS-2CD2345
- 描述: 4K高清网络摄像头，支持夜视功能和远程监控

**参数配置**:

#### 参数1: 分辨率
```
参数编码: resolution
参数类型: select (选择)
选项:
  - 1080P (1080p)
  - 4K (4k)
默认值: 4k
说明: 视频分辨率设置
```

#### 参数2: 夜视功能
```
参数编码: nightVision
参数类型: boolean (布尔)
默认值: true (启用)
说明: 是否启用夜视功能
```

---

### 3️⃣ 油耗传感器（1个参数）

**基本信息**:
- 品牌: 博世
- 型号: FS-100
- 描述: 高精度油耗检测传感器，实时监测油耗数据

**参数配置**:

#### 参数1: 采集频率 ⭐ 必填
```
参数编码: sampleFrequency
参数类型: number (数字)
单位: Hz
默认值: 1
范围: 0.1 ~ 10
说明: 数据采集频率
```

---

### 4️⃣ 转速传感器（6个参数）⭐ 推荐示例

**基本信息**:
- 品牌: 西门子
- 型号: RS-500
- 描述: 发动机转速实时监测传感器，支持异常报警

**参数配置**:

#### 参数1: 采集频率 ⭐ 必填
```
参数编码: sampleFrequency
参数类型: number (数字)
单位: Hz
默认值: 10
范围: 1 ~ 100
说明: 转速数据采集频率
```

#### 参数2: 上传频率 ⭐ 必填
```
参数编码: uploadFrequency
参数类型: number (数字)
单位: 秒
默认值: 10
范围: 1 ~ 60
说明: 数据上传时间间隔
```

#### 参数3: 最大转速
```
参数编码: maxRpm
参数类型: number (数字)
单位: RPM
默认值: 3000
范围: 1000 ~ 5000
说明: 发动机最大转速限制
```

#### 参数4: 报警阈值
```
参数编码: alarmThreshold
参数类型: number (数字)
单位: RPM
默认值: 3500
范围: 2000 ~ 5000
说明: 转速超过此值时触发报警
```

#### 参数5: 启用报警
```
参数编码: alarmEnabled
参数类型: boolean (布尔)
默认值: true (启用)
说明: 是否启用超速报警功能
```

#### 参数6: 显示模式
```
参数编码: displayMode
参数类型: select (选择)
选项:
  - 实时曲线 (realtime)
  - 数字显示 (digital)
  - 仪表盘 (gauge)
默认值: gauge
说明: 转速数据显示模式
```

---

### 5️⃣ 温度传感器（7个参数）⭐ 推荐示例

**基本信息**:
- 品牌: 霍尼韦尔
- 型号: TS-300
- 描述: 发动机温度监测传感器，支持高低温报警

**参数配置**:

#### 参数1: 采集频率 ⭐ 必填
```
参数编码: sampleFrequency
参数类型: number (数字)
单位: Hz
默认值: 0.5
范围: 0.1 ~ 10
说明: 温度数据采集频率
```

#### 参数2: 上传频率 ⭐ 必填
```
参数编码: uploadFrequency
参数类型: number (数字)
单位: 秒
默认值: 60
范围: 10 ~ 300
说明: 数据上传时间间隔
```

#### 参数3: 高温报警阈值 ⭐ 必填
```
参数编码: highAlarmThreshold
参数类型: number (数字)
单位: °C
默认值: 90
范围: 60 ~ 120
说明: 温度高于此值时报警
```

#### 参数4: 低温报警阈值
```
参数编码: lowAlarmThreshold
参数类型: number (数字)
单位: °C
默认值: -10
范围: -30 ~ 0
说明: 温度低于此值时报警
```

#### 参数5: 温度单位
```
参数编码: temperatureUnit
参数类型: select (选择)
选项:
  - 摄氏度 (°C) (celsius)
  - 华氏度 (°F) (fahrenheit)
默认值: celsius
说明: 温度显示单位
```

#### 参数6: 声音报警
```
参数编码: alarmSound
参数类型: boolean (布尔)
默认值: true (启用)
说明: 是否启用声音报警
```

#### 参数7: 校准偏移
```
参数编码: calibrationOffset
参数类型: number (数字)
单位: °C
默认值: 0
范围: -10 ~ 10
说明: 传感器校准偏移量
```

---

## 🎨 参数类型说明

### 1. number (数字类型)

**特点**:
- ✅ 支持整数和小数
- ✅ 可设置最小值和最大值
- ✅ 可指定单位
- ✅ 可标记为必填

**示例**:
```typescript
{
  key: 'sampleFrequency',
  label: '采集频率',
  type: 'number',
  unit: 'Hz',           // 单位
  required: true,       // 必填
  defaultValue: 10,     // 默认值
  min: 1,              // 最小值
  max: 100,            // 最大值
  description: '数据采集频率'
}
```

**应用场景**:
- 频率设置
- 阈值配置
- 时间间隔
- 测量值范围

### 2. select (选择类型)

**特点**:
- ✅ 预定义选项列表
- ✅ 单选
- ✅ 支持中英文选项
- ✅ 可设置默认值

**示例**:
```typescript
{
  key: 'displayMode',
  label: '显示模式',
  type: 'select',
  options: [
    { label: '实时曲线', value: 'realtime' },
    { label: '数字显示', value: 'digital' },
    { label: '仪表盘', value: 'gauge' }
  ],
  defaultValue: 'gauge',
  description: '数据显示模式'
}
```

**应用场景**:
- 模式选择
- 等级设置
- 单位选择
- 状态配置

### 3. boolean (布尔类型)

**特点**:
- ✅ 真/假 二选一
- ✅ 适合开关配置
- ✅ 界面显示为开关或复选框

**示例**:
```typescript
{
  key: 'alarmEnabled',
  label: '启用报警',
  type: 'boolean',
  defaultValue: true,
  description: '是否启用报警功能'
}
```

**应用场景**:
- 功能开关
- 是否启用
- 开/关状态

### 4. string (文本类型)

**特点**:
- ✅ 自由文本输入
- ✅ 适合灵活配置
- ✅ 可设置默认值

**示例**:
```typescript
{
  key: 'deviceId',
  label: '设备ID',
  type: 'string',
  required: true,
  defaultValue: '',
  description: '设备唯一标识符'
}
```

**应用场景**:
- 设备ID
- IP地址
- 连接字符串
- 备注说明

---

## 📊 统计信息

### 参数类型分布

| 类型 | 数量 | 占比 | 示例数量 |
|------|------|------|----------|
| number | 13个 | 72% | 所有类型 |
| select | 3个 | 17% | 北斗、转速、温度 |
| boolean | 2个 | 11% | 摄像头、转速、温度 |
| string | 0个 | 0% | - |

### 参数配置复杂度

| 类型 | 参数数 | 复杂度 | 建议用途 |
|------|--------|--------|----------|
| 油耗传感器 | 1个 | ⭐ 简单 | 新手学习 |
| 北斗定位终端 | 2个 | ⭐⭐ 简单 | 快速上手 |
| 高清摄像头 | 2个 | ⭐⭐ 简单 | 类型组合 |
| 转速传感器 | 6个 | ⭐⭐⭐⭐ 复杂 | 参考示例 |
| 温度传感器 | 7个 | ⭐⭐⭐⭐⭐ 复杂 | 完整示例 |

---

## 🎯 使用场景

### 场景1: 简单设备配置

**适用**: 参数较少的设备（1-2个参数）

**示例**: 油耗传感器
```
只需配置采集频率即可使用
```

**优点**:
- ✅ 配置简单
- ✅ 快速上手
- ✅ 易于维护

### 场景2: 标准设备配置

**适用**: 一般设备（2-4个参数）

**示例**: 北斗定位终端、高清摄像头
```
配置核心参数：上报间隔、精度模式
配置显示参数：分辨率、夜视功能
```

**优点**:
- ✅ 功能完整
- ✅ 配置灵活
- ✅ 覆盖常用场景

### 场景3: 复杂设备配置

**适用**: 高级设备（5+个参数）

**示例**: 转速传感器、温度传感器
```
完整配置：
  - 数据采集参数（频率、间隔）
  - 报警阈值参数（高温、低温、超速）
  - 功能开关（报警启用、声音报警）
  - 显示设置（单位、模式、校准）
```

**优点**:
- ✅ 功能强大
- ✅ 精确控制
- ✅ 专业级配置

---

## 💡 最佳实践

### 1️⃣ 参数命名规范

**编码命名** (key):
- ✅ 使用驼峰命名：`sampleFrequency`
- ✅ 语义清晰：`alarmThreshold`
- ✅ 避免缩写：使用 `uploadFrequency` 而非 `upFreq`

**标签命名** (label):
- ✅ 使用中文：`采集频率`
- ✅ 简洁明了：`报警阈值`
- ✅ 加上单位：`上传频率 (秒)`

### 2️⃣ 必填参数设置

**原则**:
- ✅ 核心功能参数必填
- ✅ 可选功能参数不必填
- ✅ 提供合理默认值

**示例**:
```typescript
// 必填：采集频率（核心功能）
{ key: 'sampleFrequency', required: true }

// 可选：报警功能（附加功能）
{ key: 'alarmEnabled', required: false, defaultValue: true }
```

### 3️⃣ 默认值设置

**原则**:
- ✅ 提供安全的默认值
- ✅ 符合常用场景
- ✅ 避免极端值

**示例**:
```typescript
// ✅ 好的默认值
{ defaultValue: 10, min: 1, max: 60 }  // 中间值

// ❌ 不好的默认值
{ defaultValue: 1, min: 1, max: 60 }   // 最小值
```

### 4️⃣ 范围设置

**原则**:
- ✅ 设置合理的最小最大值
- ✅ 防止无效输入
- ✅ 符合物理意义

**示例**:
```typescript
// ✅ 合理的范围
{
  label: '高温报警阈值',
  unit: '°C',
  defaultValue: 90,
  min: 60,    // 发动机正常工作温度
  max: 120    // 发动机危险温度
}
```

---

## 🔄 参数模板管理

### 查看参数模板

**方式1**: 列表中直接查看
```
在"负载类型"列表中，点击"参数模板"列的"👁 X个参数"按钮
```

**方式2**: 详情中查看
```
点击"查看"按钮 → 点击参数模板链接 → 查看完整参数
```

**方式3**: 编辑时查看
```
点击"编辑"按钮 → 点击"查看参数"按钮
```

### 修改参数模板

**注意**: 参数模板不在"负载类型"页面编辑

**步骤**:
1. 前往"负载参数"页面
2. 选择要编辑的类型
3. 添加/编辑/删除参数
4. 保存修改

### 应用参数模板

**在"负载设备"中使用**:
1. 创建新设备
2. 选择负载类型
3. 系统自动显示参数表单
4. 根据参数模板填写参数值

---

## 📋 参数清单

### 所有参数汇总（18个）

| 参数编码 | 参数名称 | 类型 | 必填 | 所属类型 |
|----------|----------|------|------|----------|
| reportInterval | 上报间隔 | number | ✅ | 北斗定位终端 |
| accuracyMode | 精度模式 | select | ⭕ | 北斗定位终端 |
| resolution | 分辨率 | select | ⭕ | 高清摄像头 |
| nightVision | 夜视功能 | boolean | ⭕ | 高清摄像头 |
| sampleFrequency | 采集频率 | number | ✅ | 油耗/转速/温度传感器 |
| uploadFrequency | 上传频率 | number | ✅ | 转速/温度传感器 |
| maxRpm | 最大转速 | number | ⭕ | 转速传感器 |
| alarmThreshold | 报警阈值 | number | ⭕ | 转速传感器 |
| alarmEnabled | 启用报警 | boolean | ⭕ | 转速传感器 |
| displayMode | 显示模式 | select | ⭕ | 转速传感器 |
| highAlarmThreshold | 高温报警阈值 | number | ✅ | 温度传感器 |
| lowAlarmThreshold | 低温报警阈值 | number | ⭕ | 温度传感器 |
| temperatureUnit | 温度单位 | select | ⭕ | 温度传感器 |
| alarmSound | 声音报警 | boolean | ⭕ | 温度传感器 |
| calibrationOffset | 校准偏移 | number | ⭕ | 温度传感器 |

---

## 🎓 学习路径

### 初级（了解基础）
1. 查看**油耗传感器**（1个参数）
2. 理解 number 类型参数
3. 学习必填参数的设置

### 中级（掌握组合）
1. 查看**北斗定位终端**（2个参数）
2. 学习 number + select 组合
3. 理解参数的默认值和范围

### 高级（完整示例）
1. 查看**转速传感器**（6个参数）
2. 学习 number + boolean + select 组合
3. 掌握复杂参数配置

### 专家级（最佳实践）
1. 查看**温度传感器**（7个参数）
2. 理解完整的参数体系
3. 学习参数之间的关联

---

## 🎉 总结

### 核心要点

1. **5个类型，18个参数** - 丰富的示例覆盖
2. **4种参数类型** - number, select, boolean, string
3. **7个必填参数** - 保证核心功能
4. **完整的配置示例** - 从简单到复杂

### 推荐使用

- 🥇 **温度传感器** - 最完整的参数示例（7个参数）
- 🥈 **转速传感器** - 丰富的参数组合（6个参数）
- 🥉 **北斗定位终端** - 快速上手示例（2个参数）

### 下一步

1. 刷新页面查看新数据
2. 点击参数模板查看详情
3. 前往"负载参数"页面管理参数
4. 在"负载设备"中应用参数模板

---

**创建时间**: 2025-10-17  
**数据版本**: v2.0  
**参数总数**: 18个  
**示例类型**: 5个
