# 负载参数样例数据说明

## 更新内容

已为"农机负载管理-负载参数"模块添加了丰富的样例数据，包含10种不同类型的负载设备及其完整的参数定义模板。

## 设备类型清单

### 1. 北斗定位终端
- **厂商**: 华为
- **型号**: BD-200
- **通信协议**: MQTT
- **参数数量**: 3个
- **主要参数**:
  - 上报间隔 (number, 1-60秒)
  - 精度模式 (select: 高精度/普通/省电)
  - 轨迹跟踪 (boolean)

### 2. 高清摄像头
- **厂商**: 海康威视
- **型号**: DS-2CD2345
- **通信协议**: HTTP
- **参数数量**: 4个
- **主要参数**:
  - 分辨率 (select: 720P/1080P/4K)
  - 夜视功能 (boolean)
  - 帧率 (number, 15-60fps)
  - 存储模式 (select: 本地/云端/双重备份)

### 3. 油耗传感器
- **厂商**: 博世
- **型号**: FS-100
- **通信协议**: RS485
- **参数数量**: 3个
- **主要参数**:
  - 采集频率 (number, 0.1-10Hz)
  - 流量范围 (select: 低/中/高)
  - 报警阈值 (number, 10-100L/h)

### 4. 转速传感器
- **厂商**: 西门子
- **型号**: RS-500
- **通信协议**: CAN
- **参数数量**: 6个
- **主要参数**:
  - 采集频率 (number, 1-100Hz)
  - 上传频率 (number, 1-60秒)
  - 最大转速 (number, 1000-5000RPM)
  - 报警阈值 (number, 2000-5000RPM)
  - 启用报警 (boolean)
  - 显示模式 (select: 实时曲线/数字显示/仪表盘)

### 5. 温度传感器
- **厂商**: 霍尼韦尔
- **型号**: TS-300
- **通信协议**: MQTT
- **参数数量**: 7个
- **主要参数**:
  - 采集频率 (number, 0.1-10Hz)
  - 上传频率 (number, 10-300秒)
  - 高温报警阈值 (number, 60-120°C)
  - 低温报警阈值 (number, -30-0°C)
  - 温度单位 (select: 摄氏度/华氏度)
  - 声音报警 (boolean)
  - 校准偏移 (number, -10-10°C)

### 6. 湿度传感器
- **厂商**: 施耐德
- **型号**: HS-200
- **通信协议**: RS485
- **参数数量**: 5个
- **主要参数**:
  - 采集频率 (number, 1-60次/小时)
  - 监测深度 (number, 5-100cm)
  - 报警水位 (select: 严重干旱/轻度干旱/正常)
  - 自动灌溉 (boolean)
  - 土壤类型 (select: 沙土/壤土/黏土)

### 7. 深度传感器
- **厂商**: 约翰迪尔
- **型号**: DS-150
- **通信协议**: CAN
- **参数数量**: 5个
- **主要参数**:
  - 测量模式 (select: 实时监测/采样监测/连续记录)
  - 目标深度 (number, 5-50cm)
  - 允许误差 (number, 1-10cm)
  - 偏差报警 (boolean)
  - 记录间隔 (number, 1-100米)

### 8. 流量传感器
- **厂商**: 艾默生
- **型号**: FL-500
- **通信协议**: MQTT
- **参数数量**: 6个
- **主要参数**:
  - 流量范围 (select: 0-10/0-50/0-100 L/min)
  - 测量精度 (select: ±0.5%/±1%/±2%)
  - 累计流量 (boolean)
  - 脉冲输出 (boolean)
  - 最小流量报警 (number, 0-50L/min)
  - 最大流量报警 (number, 10-100L/min)

### 9. GPS定位终端
- **厂商**: Trimble
- **型号**: AG-372
- **通信协议**: MQTT
- **参数数量**: 6个
- **主要参数**:
  - 定位模式 (select: RTK固定解/RTK浮动解/DGPS/单点定位)
  - 更新频率 (number, 1-20Hz)
  - 卫星高度角 (number, 5-20度)
  - PDOP阈值 (number, 1-10)
  - 轨迹记录 (boolean)
  - 轨迹点间隔 (number, 1-50米)

### 10. 作业监控摄像头
- **厂商**: 大华
- **型号**: DH-IPC6222
- **通信协议**: HTTP
- **参数数量**: 7个
- **主要参数**:
  - 视频分辨率 (select: 720P/1080P/4K)
  - 帧率 (select: 15/25/30 fps)
  - 夜视功能 (boolean)
  - 移动侦测 (boolean)
  - AI识别 (select: 关闭/作物识别/障碍物识别/全部启用)
  - 存储模式 (select: 本地/云端/双重备份)
  - 压缩率 (select: 高质量/平衡/高压缩)

## 参数类型说明

样例数据涵盖了所有支持的参数类型：

### 1. number (数字类型)
- 支持 `min` 和 `max` 范围限制
- 支持 `unit` 单位显示
- 可设置 `defaultValue` 默认值
- 示例: 采集频率、转速、温度等

### 2. string (文本类型)
- 自由文本输入
- 可设置 `defaultValue` 默认值
- 适用于备注、描述等字段

### 3. boolean (布尔类型)
- true/false 开关选项
- 通常用于功能启用/禁用
- 示例: 夜视功能、报警开关等

### 4. select (选择类型)
- 提供预定义选项列表
- 每个选项包含 `label` (显示名称) 和 `value` (实际值)
- 适用于固定选项的配置
- 示例: 分辨率、精度模式、显示模式等

## 数据特点

1. **完整性**: 每个设备类型都包含多个参数定义
2. **多样性**: 涵盖不同类别的传感器和设备
3. **实用性**: 参数定义贴近实际农业应用场景
4. **规范性**: 所有参数都包含详细的描述信息

## 使用方式

### 访问路径
农机装备管理 → 负载管理 → 负载参数

### 操作步骤
1. 在左侧"设备类型列表"中选择任意设备类型
2. 右侧会显示该类型的所有参数定义
3. 可以查看、编辑、删除现有参数
4. 可以添加新的参数定义

### 参数管理功能
- ✅ 查看参数详情（参数名、类型、单位、范围、默认值等）
- ✅ 编辑参数定义
- ✅ 删除参数
- ✅ 添加新参数
- ✅ 参数类型支持：数字、文本、布尔、选择

## 数据存储

- **localStorage key**: `smart_agriculture_device_types`
- **数据格式**: JSON数组
- **自动初始化**: 首次访问时自动创建样例数据

## 技术说明

### 参数定义接口
```typescript
interface ParameterDefinition {
  key: string;              // 参数编码（唯一标识）
  label: string;            // 参数名称
  type: 'string' | 'number' | 'boolean' | 'select';  // 参数类型
  required?: boolean;       // 是否必填
  defaultValue?: any;       // 默认值
  options?: { label: string; value: any }[];  // 选项列表（select类型）
  unit?: string;            // 单位
  min?: number;             // 最小值（number类型）
  max?: number;             // 最大值（number类型）
  description?: string;     // 参数描述
}
```

### 设备类型接口
```typescript
interface DeviceType {
  id: string;
  name: string;
  category: DeviceCategory;
  manufacturer?: string;
  model?: string;
  communicationProtocol?: string;
  dataFormat?: string;
  description?: string;
  parameterDefinitions: ParameterDefinition[];
  createdAt: string;
  updatedAt: string;
}
```

## 应用场景

这些参数定义模板将用于：

1. **设备库管理**: 在"负载设备"页面创建设备实例时，根据设备类型自动生成参数配置表单
2. **设备挂载**: 将设备挂载到农机时，可以配置这些参数
3. **数据监测**: 根据参数定义采集和显示设备运行数据
4. **报警管理**: 使用参数中定义的阈值进行报警判断

## 更新日志

- **2025-10-25**: 初始创建，添加10种设备类型共54个参数定义
  - 新增北斗定位终端、GPS定位终端
  - 新增高清摄像头、作业监控摄像头
  - 新增油耗传感器、流量传感器
  - 新增转速传感器、温度传感器、湿度传感器、深度传感器
  - 覆盖number、string、boolean、select四种参数类型
  - 包含完整的参数约束（最小值、最大值、单位、选项等）
