Files
JBao_Magic_Box_FW/docs/门夹弹力绳_需求文档.md
T
wuchuyuan 4ee0f86d13 1、Makefile 与 CodeBlocks 编译单元对齐,补 make pack / BURN_KEY,增加 build.bat 与固件打包脚本
2、下载脚本同时生成无 Key / 带 Key 镜像,USB 默认烧无 Key,build.bat key 烧带 Key
3、配对超时从 60s 改为 120s
4、增加需求文档
2026-08-26 17:06:28 +08:00

132 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 门夹弹力绳 需求文档(V1.1
| 项目 | 内容 |
| --- | --- |
| 产品名称 | 门夹弹力绳(智能逗宠玩具) |
| 型号 | PICBC2 / CBC2 |
| 主控 | 杰理 AC7016C |
| 日期 | 2026-08-25 |
---
## 1. 产品简介
门夹弹力绳是一款智能逗宠玩具。设备夹在门板上,内部电机带动弹力绳收放,让绳端玩具按不同"玩法"动起来逗宠物玩。支持手机 App 通过远程控制,也支持按键本地操作。
---
## 2. 核心功能
### 2.1 开关机
| 操作 | 行为 |
| --- | --- |
| 深睡状态下按 3 秒 | 开机 |
| 深睡状态下按 5 秒 | 开机并进入配对模式 |
| 开机状态下按 3 秒 | 关机(深睡省电) |
| 插着充电线时上电 | 自动开机,不用按键 |
| 刚上电没按按键 | 保持深睡,不误开机 |
- 深睡状态下,按按键(3 秒/5 秒)或插充电线均可唤醒开机。
### 2.2 开关(App 控制)
- App 可开/关设备功能;关闭后电机停转,蓝牙不断开,可随时再开。
- 拔掉充电线会自动进入低功耗状态(电机停转、LED 关闭、蓝牙保持连接)。
### 2.3 自动玩法(6 种,App 或按键选择)
| 玩法 | 效果 |
| --- | --- |
| 停止复位 | 停转 |
| 弹力伪装 | 绳子慢慢放出去再慢慢收回来,来回一次 |
| 飞鸟俯冲 | 快速冲出去,再慢慢收回,模拟小鸟飞扑 |
| 云阶小陀螺 | 小幅度来回抖动,力度逐渐加大,像陀螺转动 |
| 起伏攻防战 | 慢慢逗弄两秒,突然猛收一下 |
| 微风拂动 | 轻轻动一下,歇两秒,像被风吹动 |
| 闪电快闪 | 快速连续来回抽动,动作急促 |
- 玩法会循环播放,直到切换或停止。
- 运行中可随时切换到其他玩法或停止。
### 2.4 手动控制(App 控制)
- App 可手动点动:控制电机**收绳**或**放绳**,松手/点停止后电机停止。
- 手动控制进行中,自动玩法暂停。
### 2.5 按键控制
| 操作 | 行为 |
| --- | --- |
| 短按(<1 秒) | 切换玩法:停 → 玩法1 → 玩法2 → … → 玩法6 → 停,循环 |
| 长按 3 秒 | 关机 |
| 充电中 / 配对中 | 按键无效 |
### 2.6 电量与充电
- 电量按电压换算:满电 4.2V = 100%3.2V = 0%,电量自动上报 App 显示。
- **低电量**(电池电压低于 **3.7V**):App 上报警告,指示灯红灯慢闪;持续 1 分钟未充电则自动关机保护电池。
- **电量极低**(低于 3.2V):直接自动关机。
- **插入充电线**:电机立即停止、进入充电状态,只有红灯常亮,表示充电中,充满转绿灯常亮;充电期间不执行玩法,按键无效。
- **充电中拔掉充电线**:设备自动进入低功耗状态(电机停转、LED关闭、蓝牙保持连接),需按短按按键或 App 重新开启后才能使用。
- 电池:锂电池,USB 5V 充电,充满自动转灯。
### 2.7 指示灯
| 状态 | 灯效 |
| --- | --- |
| 正常待机 | 绿灯常亮 |
| 充电中 | 红灯常亮 |
| 充满 | 绿灯常亮 |
| 低电量 | 红灯慢闪 |
| 配对中 | 绿灯快闪 |
| 配对成功 | 绿灯常亮 3 秒 |
| 配对失败 | 红绿交替闪 3 秒 |
| 按键切玩法 | 绿灯闪两下 |
### 2.8 配对
- 首次使用:深睡状态长按 5 秒开机并进入配对,App 扫码连接即可。
- 配对窗口 120 秒:期间连接成功绿灯 3 秒;超时未连接保持开机,可重新配对。
- App 可解绑设备,解绑后设备清除配对信息,重新配对即可再次使用。
### 2.9 时间同步
- 设备带实时时钟,连接后自动与手机对时(时区跟随手机)。
### 2.10 固件升级(OTA
- 支持 App 远程升级固件,升级协议已打通。
- 当前版本:固件 V1.0.0、硬件 V1.0.0。
- 实际升级流程(写入芯片、校验、版本判断)待开发。
---
## 3. 性能要求(功耗)
| 状态 | 要求 |
| --- | --- |
| 关机(深睡) | ≤ 8 uA |
| 待机(空闲,未接充电) | ≤ 300 uA |
| 待机 + 指示灯常亮 | ≤ 600 uA |
---
## 4. 待完善功能(当前仅预留,未实现)
| 功能 | 说明 |
| --- | --- |
| 绳索校准 | App 下发校准命令,用于校准绳子位置 |
| 绳索圈数设置 | App 设置圈数,用于限制收绳行程 |
| 勿扰模式 | App 开关,控制设备在某些时段不动作 |
| 手动力度/百分比 | 手动控制时调节收放力度,预留 |
| OTA 实际升级 | 协议已就绪,芯片写入逻辑待开发 |
---
## 5. 使用注意
- 设备空闲时自动进入低功耗省电模式,有操作时自动唤醒。
- 电机换向、停止均做过安全处理,避免损坏电机和电池。
- 换硬件板子时,只需改引脚配置文件,业务逻辑不变。