Appearance
因子管理
因子是设备采集的具体数据项，是云平台数据管理的核心。本文介绍如何配置和管理因子。
什么是因子
简单来说，因子就是您关心的那个"数值"。例如：
- 大棚里的温度是多少度？
- 土壤的湿度是多少？
- 水泵的开关状态是开还是关？
每一个这样的数据项，在云平台中都叫做一个"因子"。
因子类型
云平台预置了丰富的因子类型，覆盖常见的监测场景：
环境监测类
| 类型 | 说明 | 单位 |
|---|---|---|
| 温度传感器 | 空气温度 | ℃ |
| 湿度传感器 | 空气湿度 | %RH |
| 光照度传感器 | 环境光照强度 | Lux |
| 二氧化碳传感器 | CO₂ 浓度 | ppm |
| 大气压传感器 | 大气压力 | hPa |
土壤监测类
| 类型 | 说明 | 单位 |
|---|---|---|
| 土壤温度传感器 | 土壤温度 | ℃ |
| 土壤湿度传感器 | 土壤含水率 | %RH |
| 土壤电导率传感器 | 土壤 EC 值 | μS/cm |
| 土壤 pH 传感器 | 土壤酸碱度 | - |
水质监测类
| 类型 | 说明 | 单位 |
|---|---|---|
| 水温度传感器 | 水体温度 | ℃ |
| 水溶解氧传感器 | 溶解氧含量 | mg/L |
| 水 pH 传感器 | 水体酸碱度 | - |
| 水浊度传感器 | 水体浊度 | NTU |
控制类
| 类型 | 说明 |
|---|---|
| 远程开关 | 可远程控制的开关设备 |
| 智能插座 | 可远程控制的插座 |
| 电机 | 支持正反转控制 |
电力监测类
| 类型 | 说明 | 单位 |
|---|---|---|
| 电压 | 电压值 | V |
| 电流 | 电流值 | A |
| 电功率 | 功率值 | W |
自定义因子类型
如果预置类型不能满足需求，您可以在组织设置中创建自定义因子类型。
添加因子
方式一：手动添加
- 进入设备详情页，选择「因子配置」标签
- 点击「添加因子」按钮
- 填写因子信息：
- 因子名称：自定义名称，如「1号探头温度」
- 因子类型：选择对应的传感器类型
- Agri ID：因子的唯一标识，用于数据上报
- Modbus 地址：传感器的寄存器地址（参考传感器说明书）
- 点击保存
方式二：添加模块
如果您使用的是研几配套的传感器模块，可以使用「添加模块」功能快速配置：
- 点击「添加模块」按钮
- 选择对应的传感器模块型号
- 系统会自动添加该模块包含的所有因子
- 根据实际接线情况调整 Modbus 地址
方式三：导入配置
如果您有多台相同配置的设备，可以使用导入导出功能：
- 在已配置好的设备上，点击「导出因子配置」
- 下载 JSON 配置文件
- 在新设备上，点击「导入因子配置」
- 上传配置文件，系统会自动创建所有因子
因子设置
每个因子可以配置以下参数：
基本信息
- 名称：因子的显示名称
- 类型：因子类型，决定数据的单位和展示方式
- Agri ID：因子的唯一标识
数据采集
- Modbus 地址：传感器寄存器地址
- 数据类型：整数、浮点数等
- 系数：原始值的换算系数
- 偏移量：原始值的偏移修正
启用/禁用
您可以临时禁用某个因子，禁用后：
- 设备不再采集该因子的数据
- 历史数据保留，不受影响
- 随时可以重新启用
查看因子数据
实时数据
在设备概览页面，可以看到所有因子的实时数值和更新时间。
历史数据
- 点击因子卡片，进入因子详情
- 选择时间范围查看历史曲线
- 可切换折线图、柱状图等展示方式
数据导出
- 进入项目的「数据导出」页面
- 选择设备和因子
- 设置时间范围
- 点击导出，下载 Excel 或 CSV 文件
常见问题
因子数据显示异常？
- 检查 Modbus 地址是否正确
- 确认数据类型和系数设置
- 查看传感器是否正常工作
如何批量修改因子？
目前支持通过导入导出功能批量操作：
- 导出当前配置
- 修改 JSON 文件
- 删除原有因子后重新导入
删除因子会丢失数据吗？
删除因子后，该因子的历史数据将被清除。如需保留数据，建议先导出后再删除。