IoT 物联网平台使用手册
IoT 物联网平台是一款一站式物联网解决方案，支持智慧商业、智慧酒店、智慧家居、智慧楼宇等多种应用场景，帮助企业实现设备互联、数据采集、远程控制和智能化管理。
平台概述
核心能力
- 设备接入：支持多种协议（MQTT、CoAP、HTTP、Modbus）
- 数据采集：实时采集设备数据，支持边缘计算
- 远程控制：随时随地控制设备状态
- 场景联动：基于条件触发的自动化场景
- 数据可视化：直观的数据大屏和报表分析
平台架构
┌─────────────────────────────────────────────────────────────┐
│ 应用层 │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │智慧商业 │ │智慧酒店 │ │智慧家居 │ │智慧楼宇 │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
├─────────────────────────────────────────────────────────────┤
│ 平台层 │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │设备管理 │ │规则引擎 │ │数据分析 │ │消息推送 │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
├─────────────────────────────────────────────────────────────┤
│ 接入层 │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ MQTT │ │ CoAP │ │ HTTP │ │ Modbus │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
├─────────────────────────────────────────────────────────────┤
│ 设备层 │
│ 传感器 | 控制器 | 网关 | 摄像头 | 智能终端 │
└─────────────────────────────────────────────────────────────┘设备管理
添加设备
- 进入 设备管理 > 设备列表
- 点击 添加设备
- 选择设备类型和接入协议
- 填写设备信息：
- 设备名称
- 设备编号（唯一标识）
- 所属分组
- 安装位置
设备分组
支持多级分组管理：
企业总部
├── 一楼大厅
│ ├── 照明设备
│ ├── 空调设备
│ └── 安防设备
├── 二楼办公区
│ ├── 照明设备
│ └── 环境传感器
└── 地下停车场
├── 照明设备
└── 车位检测器设备状态
| 状态 | 说明 |
|---|---|
| 🟢 在线 | 设备正常连接 |
| 🔴 离线 | 设备断开连接 |
| 🟡 告警 | 设备有异常告警 |
| ⚪ 未激活 | 设备未完成激活 |
数据采集
数据点配置
为每个设备配置需要采集的数据点：
{
"dataPoints": [
{
"name": "temperature",
"label": "温度",
"type": "float",
"unit": "℃",
"range": [-20, 60]
},
{
"name": "humidity",
"label": "湿度",
"type": "float",
"unit": "%",
"range": [0, 100]
},
{
"name": "power",
"label": "开关状态",
"type": "boolean"
}
]
}数据上报
设备通过 MQTT 协议上报数据：
// 设备端代码示例
const mqtt = require('mqtt');
const client = mqtt.connect('mqtt://iot.example.com', {
clientId: 'device_001',
username: 'device_001',
password: 'your_device_secret'
});
// 上报数据
client.publish('device/device_001/data', JSON.stringify({
temperature: 25.6,
humidity: 65.2,
power: true,
timestamp: Date.now()
}));数据存储
- 实时数据：Redis 缓存，支持毫秒级查询
- 历史数据：时序数据库，支持长期存储
- 聚合数据：按分钟/小时/天自动聚合
远程控制
下发指令
通过平台向设备下发控制指令：
// API 调用示例
POST /api/v1/devices/{deviceId}/commands
{
"command": "setPower",
"params": {
"power": true
}
}批量控制
支持对设备分组进行批量控制：
- 选择目标分组
- 选择控制指令
- 设置执行时间（立即/定时）
- 确认执行
场景联动
创建场景
场景联动支持基于条件触发的自动化控制：
示例：办公室节能场景
场景名称: 下班自动关灯
触发条件:
- 时间: 每天 19:00
- 条件: 人体传感器无人超过30分钟
执行动作:
- 关闭所有照明设备
- 空调设置为节能模式
- 发送通知给管理员条件类型
| 类型 | 说明 | 示例 |
|---|---|---|
| 定时触发 | 按时间执行 | 每天 8:00 |
| 设备触发 | 设备状态变化 | 温度 > 28℃ |
| 手动触发 | 一键执行 | 点击按钮 |
| API 触发 | 外部系统调用 | 接收 Webhook |
动作类型
- 控制设备（开/关/调节）
- 发送通知（App 推送/短信/邮件）
- 调用 API（触发外部系统）
- 延时执行（等待指定时间）
应用场景
智慧商业
适用于商场、超市、连锁门店：
- 能耗管理：照明、空调智能控制，降低能耗 20%+
- 客流分析：实时统计客流，优化运营策略
- 环境监测：温湿度、空气质量实时监控
- 设备巡检：冷柜、电梯等设备状态监控
智慧酒店
适用于酒店、民宿、公寓：
- 客房控制：灯光、空调、窗帘一键控制
- 入住体验：刷脸/刷卡开门，自动调节房间环境
- 能源管理：退房自动断电，节约能源
- 设备维护：设备故障自动报修
智慧家居
适用于住宅、别墅、社区：
- 全屋智能：照明、家电、安防统一控制
- 场景模式：回家、离家、睡眠等一键切换
- 语音控制：支持主流语音助手
- 远程监控：随时查看家中状态
智慧楼宇
适用于写字楼、园区、工厂：
- BA 系统集成：空调、照明、电梯统一管理
- 能耗分析：分区域、分时段能耗统计
- 安防联动：门禁、监控、报警联动
- 停车管理：车位引导、无感支付
数据可视化
数据大屏
平台提供可视化数据大屏：
- 设备总览（在线率、告警数）
- 实时数据展示
- 能耗趋势图
- 地图分布
报表分析
支持多维度数据分析：
- 设备报表：运行时长、故障率
- 能耗报表：用电量、节能效果
- 告警报表：告警类型、处理时效
API 接口
认证方式
使用 API Key 进行认证：
curl -X GET "https://api.example.com/v1/devices" \
-H "Authorization: Bearer YOUR_API_KEY"常用接口
| 接口 | 方法 | 说明 |
|---|---|---|
| /devices | GET | 获取设备列表 |
| /devices/{id} | GET | 获取设备详情 |
| /devices/{id}/data | GET | 获取设备数据 |
| /devices/{id}/commands | POST | 下发控制指令 |
| /scenes | GET | 获取场景列表 |
| /scenes/{id}/execute | POST | 执行场景 |