# 物联设备数据接入 - 快速上手指南

## 🚀 5分钟快速开始

### 访问入口
```
登录系统
  ↓
顶部导航 → "AI作物模型精准决策系统"
  ↓
侧边栏 → "全域数据感知中心"
  ↓
Tab页 → "物联设备数据接入"
```

---

## 📱 添加第一个设备

### 步骤1: 点击添加设备
1. 找到页面上的绿色"添加设备"按钮
2. 点击打开设备配置对话框

### 步骤2: 填写基本信息
```yaml
设备编号: WS-001 (可自动生成)
设备名称: 1号气象站
设备类型: 气象站 (下拉选择)
设备型号: SM-WX100
生产厂家: XX科技公司
安装位置: A区1号地块
```

### 步骤3: 配置通信参数
```yaml
通信协议: MQTT (下拉选择)
上报频率: 每5分钟 (下拉选择)
MQTT主题: farm/sensors/weather/ws-001
```

### 步骤4: 测试连接
1. 点击"测试连接"按钮
2. 等待测试结果
3. 看到"连接测试成功"提示

### 步骤5: 保存配置
1. 确保"启用设备"开关已打开
2. 点击"保存配置"按钮
3. 看到"设备配置保存成功"提示

**✅ 恭喜！第一个设备添加成功！**

---

## 📊 查看设备状态

### 设备状态概览卡片
```
┌─────────┬─────────┬─────────┬──────────────┐
│ 在线设备 │ 离线设备 │ 故障设备 │ 数据采集率   │
│   3     │   1     │   0     │   98.5%      │
│  🟢     │  ⚪     │  🔴     │   📊         │
└─────────┴─────────┴─────────┴──────────────┘
```

**说明**:
- 🟢 绿色 = 在线正常
- ⚪ 灰色 = 离线
- 🔴 红色 = 故障

### 设备列表
找到你刚添加的设备，可以看到：
- ✅ 设备编号和名称
- ✅ 设备类型（徽章）
- ✅ 安装位置
- ✅ 通信协议
- ✅ 传感器实时数据
- ✅ 信号强度/电池电量
- ✅ 最后上报时间
- ✅ 设备状态

---

## 🔍 查看实时数据

### 方法1: 快速查看
在设备列表中，传感器状态列直接显示前2个传感器的实时读数：
```
温度: 25.3°C
湿度: 65.2%
```

### 方法2: 详细监控
1. 点击设备操作栏的第一个按钮（Activity图标）📊
2. 打开"实时数据监控"对话框
3. 看到所有传感器的实时数据和趋势图

**实时数据监控对话框内容**:
- 🟢 数据流状态（正常/异常）
- 📊 数据速率（如：2条/分钟）
- 🕐 最后更新时间
- ⭐ 数据质量评分

**每个传感器显示**:
- 📈 当前读数（大号显示）
- 📏 正常范围
- 📊 状态徽章（正常/异常）
- 📉 迷你趋势图（最近5次）

---

## 💡 查看设备详情

### 打开设备详情
1. 点击设备操作栏的第二个按钮（Eye图标）👁️
2. 打开"设备详情"对话框

### 详情内容包括

#### 1. 基本信息
- 设备编号、名称、类型
- 设备型号、生产厂家
- 安装位置、通信协议
- 上报频率、设备状态

#### 2. 通信状态
- 信号强度（进度条）
- 电池电量（进度条）
- 最后上报时间
- 在线时长
- 协议配置详情

#### 3. 传感器配置
显示所有传感器的：
- 传感器名称
- 当前读数
- 正常范围
- 运行状态

#### 4. 数据采集统计（最近24小时）
- 总采集次数: 2,880次
- 有效数据: 2,856条 (99.2%)
- 异常数据: 18条 (0.6%)
- 丢失数据: 6条 (0.2%)
- 采集趋势图

#### 5. 设备控制
- ▶️ 启动数据采集
- ⏸️ 暂停数据采集
- 🔄 重启设备
- 🔗 测试连接

---

## ⚙️ 编辑设备配置

### 打开编辑对话框
**方法1**: 点击设备操作栏的第三个按钮（Settings图标）⚙️
**方法2**: 在设备详情对话框中点击"编辑配置"按钮

### 可以修改
- 设备基本信息
- 通信参数
- 上报频率
- 设备启用/禁用

**提示**: 修改后记得点击"保存配置"

---

## 🎛️ 设备控制操作

### 启动数据采集
1. 在设备详情对话框中
2. 点击"启动数据采集"按钮
3. 看到"数据采集已启动"提示
4. 设备开始按设定频率采集数据

### 暂停数据采集
1. 在设备详情对话框中
2. 点击"暂停数据采集"按钮
3. 看到"数据采集已停止"提示
4. 设备停止采集，但保持连接

### 重启设备
1. 在设备详情对话框中
2. 点击"重启设备"按钮
3. 看到"设备重启指令已发送"提示
4. 设备会重新启动

### 测试连接
1. 在设备详情对话框或编辑对话框中
2. 点击"测试连接"按钮
3. 等待测试结果
4. 看到"连接测试成功"或失败提示

---

## 📈 查看数据采集趋势

### 位置
在页面底部找到"设备数据采集趋势"图表

### 内容
- 📊 折线图展示
- 📅 X轴: 时间（如：10:00 ~ 14:00）
- 📊 Y轴: 数据点数量
- 🟢 绿色线条表示数据采集量

### 交互
- 鼠标悬停可以看到具体数值
- 可以看到数据采集的波动趋势

---

## 🚨 设备状态说明

### 在线 🟢
- 设备正常连接
- 数据正常上报
- 显示绿色"在线"徽章
- 对勾图标

### 离线 ⚪
- 设备断开连接
- 超过2倍上报间隔未收到数据
- 显示灰色"离线"徽章
- WiFi关闭图标

### 故障 🔴
- 设备连接但传感器异常
- 数据质量持续不达标
- 显示红色"故障"徽章
- X圆形图标

### 维护中 🟡
- 人工设置为维护状态
- 暂时不采集数据
- 显示黄色"维护中"徽章

---

## 📱 常见设备类型配置

### 气象站
```yaml
推荐协议: MQTT
上报频率: 每5分钟
典型传感器:
  - 温度 (-30~50°C)
  - 湿度 (0~100%)
  - 光照 (0~200,000 Lux)
  - 风速 (0~50 m/s)
  - 气压 (950~1050 hPa)
  - 降水量 (0~500 mm)
```

### 土壤传感器
```yaml
推荐协议: HTTP/MQTT
上报频率: 每10分钟
典型传感器:
  - 土壤温度 (-10~60°C)
  - 土壤湿度 (0~100%)
  - 土壤EC (0~10 mS/cm)
  - 土壤pH (3.5~9.5)
```

### 监控摄像头
```yaml
推荐协议: HTTP
上报频率: 每30分钟
典型传感器:
  - 图像质量
  - 存储空间
```

### 水质传感器
```yaml
推荐协议: MQTT
上报频率: 每10分钟
典型传感器:
  - 水温 (0~40°C)
  - pH值 (4.0~10.0)
  - 溶解氧 (0~20 mg/L)
  - 浊度 (0~1000 NTU)
```

---

## 🔧 通信协议配置

### MQTT协议
```yaml
适用场景: 传感器网络、低功耗设备
配置项:
  - MQTT主题: farm/sensors/device-id
  - Broker地址: mqtt.farm.com:1883
  - QoS等级: 0/1/2
  - 用户名/密码（可选）

示例主题格式:
  - farm/sensors/weather/ws-001
  - farm/sensors/soil/ss-001
  - farm/sensors/camera/cam-001
```

### HTTP协议
```yaml
适用场景: 标准设备接口、RESTful API
配置项:
  - API端点: http://192.168.1.100/api/data
  - 请求方式: GET/POST
  - 认证方式: Bearer Token/API Key
  - 请求头配置

示例端点:
  - http://device-ip/api/sensors/data
  - http://device-ip/api/status
```

---

## 📊 数据质量指标说明

### 完整性 (目标 ≥95%)
- 检测数据包是否完整
- 检测字段是否缺失
- 当前值: 99.8% ✅

### 准确性 (目标 ≥95%)
- 检测数值是否在正常范围
- 检测是否有异常值
- 当前值: 98.5% ✅

### 时效性 (目标 ≥90%)
- 检测数据延迟情况
- 检测是否有过期数据
- 当前值: 100% ✅

### 连接稳定性 (目标 ≥95%)
- 检测连接中断频率
- 检测丢包率
- 当前值: 99.2% ✅

---

## ⚠️ 常见问题

### Q1: 设备显示离线怎么办？
**A**: 
1. 检查设备电源是否正常
2. 检查网络连接是否正常
3. 检查设备IP地址或MQTT主题配置是否正确
4. 在设备详情中点击"测试连接"
5. 如果测试失败，检查防火墙设置

### Q2: 传感器数据显示异常怎么办？
**A**: 
1. 在实时数据监控中查看具体数值
2. 检查传感器是否正常工作
3. 检查正常范围配置是否合理
4. 查看数据采集日志，寻找异常记录

### Q3: 如何提高数据采集率？
**A**: 
1. 确保网络连接稳定
2. 适当降低采集频率
3. 启用数据缓存和断线续传
4. 定期维护设备

### Q4: 如何批量配置多个设备？
**A**: 
1. 点击"批量配置"按钮
2. 选择要配置的设备
3. 统一设置参数
4. 应用到所有选中的设备

### Q5: 数据采集频率如何选择？
**A**: 
- 实时监控: 每分钟或更高
- 环境监测: 每5-10分钟
- 土壤监测: 每10-30分钟
- 图像采集: 每30-60分钟
- 根据实际需求和网络带宽选择

---

## 💡 使用技巧

### 技巧1: 快速识别设备状态
看设备状态列的图标和颜色：
- 🟢 + ✓ = 在线正常
- ⚪ + WiFi关闭 = 离线
- 🔴 + ✗ = 故障

### 技巧2: 快速查看关键数据
不需要打开对话框，直接在列表中看：
- 传感器状态列显示前2个传感器数据
- 信号/电量列显示通信状态

### 技巧3: 设置合理的上报频率
- 数据变化快 → 高频采集（每分钟）
- 数据变化慢 → 低频采集（每30分钟）
- 异常情况 → 临时提高频率

### 技巧4: 定期查看数据统计
在设备详情中查看24小时统计：
- 总采集次数
- 有效数据率
- 异常数据率
- 及时发现问题

### 技巧5: 利用设备控制功能
- 维护前：暂停数据采集
- 维护后：重启设备
- 调试时：频繁测试连接
- 异常时：查看实时日志

---

## 📚 下一步

### 学习更多
- 阅读 `IOT_DEVICE_ACCESS_COMPLETE.md` 了解完整功能
- 阅读 `DATA_ACCESS_GUIDE.md` 了解数据接入体系
- 阅读 `README.md` 了解整体系统架构

### 开始使用
1. ✅ 添加所有需要的设备
2. ✅ 配置合适的采集频率
3. ✅ 定期查看设备状态
4. ✅ 监控数据质量指标
5. ✅ 及时处理异常告警

---

## 📞 需要帮助？

如有任何问题，请：
1. 查看本指南的常见问题部分
2. 查看完整功能文档
3. 联系系统管理员

---

**祝您使用愉快！🎉**

---

**更新时间**: 2024-10-23  
**版本**: v1.0  
**适用系统**: 智慧农业生产管理系统 - AI作物模型精准决策系统
