Skip to content

移动OneNET功能规划

概述

本文档介绍移动OneNET设备接入的功能规划和技术架构设计。此功能目前处于开发阶段,本文档将详细说明计划实现的功能和开发路线图。

功能架构

核心功能模块

1. 设备管理模块

  • 设备注册:支持设备在OneNET平台的注册和管理
  • 设备认证:实现设备身份验证和安全认证
  • 设备状态监控:实时监控设备在线状态

2. 数据通信模块

  • 数据上报:支持设备数据向OneNET平台上报
  • 指令下发:支持从OneNET平台向设备下发指令
  • 数据格式转换:实现平台数据格式与OneNET格式的转换

3. 协议适配模块

  • HTTP协议适配:支持OneNET HTTP协议
  • MQTT协议适配:支持OneNET MQTT协议
  • 协议版本管理:支持不同版本的OneNET协议

技术架构

系统架构图

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   设备端        │    │   Universal IoT │    │   OneNET平台    │
│                 │    │   平台          │    │                 │
│ ┌─────────────┐ │    │ ┌─────────────┐ │    │ ┌─────────────┐ │
│ │ 设备固件    │ │◄──►│ │ 协议适配层  │ │◄──►│ │ OneNET API  │ │
│ └─────────────┘ │    │ └─────────────┘ │    │ └─────────────┘ │
│ ┌─────────────┐ │    │ ┌─────────────┐ │    │ ┌─────────────┐ │
│ │ 通信模块    │ │    │ │ 数据转换层  │ │    │ │ 设备管理    │ │
│ └─────────────┘ │    │ └─────────────┘ │    │ └─────────────┘ │
└─────────────────┘    └─────────────────┘    └─────────────────┘

数据流设计

上行数据流

  1. 设备采集数据
  2. 数据格式转换
  3. 通过OneNET协议上报
  4. OneNET平台接收并存储

下行数据流

  1. OneNET平台下发指令
  2. 协议解析和格式转换
  3. 转发给目标设备
  4. 设备执行指令

开发计划

第一阶段:基础框架(预计2周)

  • [ ] 项目架构搭建
  • [ ] OneNET API接口封装
  • [ ] 基础协议解析
  • [ ] 设备注册功能

第二阶段:核心功能(预计3周)

  • [ ] 数据上报功能
  • [ ] 指令下发功能
  • [ ] 设备状态管理
  • [ ] 错误处理机制

第三阶段:高级功能(预计2周)

  • [ ] 批量操作支持
  • [ ] 数据同步功能
  • [ ] 性能优化
  • [ ] 安全加固

第四阶段:测试完善(预计1周)

  • [ ] 功能测试
  • [ ] 性能测试
  • [ ] 安全测试
  • [ ] 文档完善

技术选型

开发语言

  • 后端:Java 21 + Spring Boot 3.5 + Redis 无其他依赖
  • 协议处理:Netty框架

存储方案

  • 缓存:Redis
  • 数据库:MySQL

安全方案

  • 传输加密:TLS 1.2/1.3
  • 身份认证:OAuth 2.0 + API Key
  • 数据加密:AES-256

风险评估

技术风险

  • OneNET API变更风险
  • 协议兼容性风险
  • 性能瓶颈风险

缓解措施

  • 建立API版本管理机制
  • 实现协议适配层
  • 进行充分的性能测试

成功标准

功能标准

  • 支持设备注册和管理
  • 实现数据双向通信
  • 提供完整的错误处理

性能标准

  • 支持1000+设备并发
  • 数据延迟 < 100ms
  • 系统可用性 > 99.9%

安全标准

  • 通过安全审计
  • 支持数据加密传输
  • 实现访问控制机制