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

4.7 KiB
Raw Blame History

门夹弹力绳 需求文档(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. 使用注意

  • 设备空闲时自动进入低功耗省电模式,有操作时自动唤醒。
  • 电机换向、停止均做过安全处理,避免损坏电机和电池。
  • 换硬件板子时,只需改引脚配置文件,业务逻辑不变。