项目名称:智能挂锁系统 SmartPadlock V1.0
编写人:XXX
版本:V1.0
日期:2025-08-02
1.引言
1.1 编写目的
本说明书旨在明确”智能挂锁系统”的功能、性能、安全、接口及相关开发约束。为研发、测试、产品运营提供一致的需求依据。
1.2 项目背景
智能挂锁是一种融合蓝牙通信、指纹识别、远程控制技术的便携式安防设备,广泛应用于仓储门禁、快递柜、自行车锁、民用门锁等多种场景。本项目将实现:
1.3 术语与缩略词
| 缩略词 |
含义 |
|
|
Bluetooth Low Energy(低功耗蓝牙)
|
|
|
|
|
|
|
|
|
|
|
|
应用程序接口(Application Programming Interface)
|
1.4 参考资料
2.总体描述
2.1 产品概述
智能挂锁系统架构包括三部分:
| 模块 |
主要功能 |
|
|
指纹识别、电机控制、BLE通信、离线解锁、日志记录
|
|
|
|
|
|
用户与设备管理、开锁日志同步、OTP生成与下发、后台控制
|
2.2 系统环境
开发/部署环境,如:
-
移动App平台:iOS 14+ / Android 8.0+
-
-
云平台:部署于阿里云或AWS,支持 HTTPS 和 MQTT 协议
2.3 用户角色
2.4 约束条件
2.5 假设与依赖
3.功能需求
3.1 注册与绑定
3.2 解锁操作
3.3 密码授权(OTP)
| 编号 |
FR-03 |
|
|
|
|
|
|
|
|
OTP生成规则为时间戳 + 锁ID + SM4加密
|
|
|
|
|
|
|
3.4 历史记录查询
3.5 OTA 升级
-
支持从App发起升级请求,挂锁设备通过BLE下载并升级固件
-
4.非功能需求
| 类型 |
描述 |
|
|
解锁响应时间 < 1.5 秒;BLE配对不超过 5 秒
|
|
|
|
|
|
|
|
|
|
|
|
支持 Android 8.0+ / iOS 13+;兼容ESP32系列硬件
|
|
|
|
|
|
|
|
|
|
5.外部接口需求
5.1 App与锁设备间接口(BLE)
| 项目 |
内容 |
|
|
|
|
|
unlockCommand、deviceStatus、firmwareInfo、logUpload
|
|
|
AES-128/SM4 加密(绑定配对成功后启用)
|
|
|
TLV结构(Type-Length-Value)编码
|
5.2 App与云平台间接口(HTTPS)
| 接口 |
POST /api/v1/lock/unlock |
|
|
token、lockId、unlockMethod、timestamp
|
|
|
200 OK / 401 Unauthorized / 403 Forbidden
|
|
|
使用HTTPS,携带JWT鉴权Token,支持时间戳校验防重放攻击
|
6.其他需求
-
-
-
-
支持”定时自动锁定”功能,例如:10分钟内无操作则自动上锁
-
OTA更新日志应完整记录版本号、更新内容、发布时间等
7.版本控制