2 Commits

Author SHA1 Message Date
d6a1e28975 远程开发环境升级:GitHub SSH 推送落地 + SMB 方案验证 + ESP32 串口优化
源代码管理 / 远程仓库(本次核心):
- 新增 GitHub 私有仓库 Leo-z8/OrangePi_CM5_Project(镜像 Android 13 SDK 关键路径)
- 本地 Git 仓库首次推送成功,远端 commit: c79995a30
- 白名单 .gitignore 追加通配符:device/rockchip/*/*/preinstall/*.apk
- 2 个 120MB camera360.apk 从 Git 历史排除(超 GitHub 100MB 限制,需另存备份)
- 认证方式切换为 SSH ed25519(ssh.github.com:443),永久免密,不依赖 Clash
- PAT 一次性推送后已撤销,凭证文件已清理

文档更新(Tailscale + SSH 远程开发操作指南 → v3.1):
- 4.5 新增 macOS SMB 挂载方案,并完整对比 Remote-SSH 在驱动开发场景下的差异
- 8.7 改写 GitHub 推送章节,SSH 为主推荐方案,HTTPS+PAT 降为应急备选
- 8.10 新增首次推送踩坑实录:100MB 单文件限制、git rev-list 去重陷阱、rwnd 瓶颈
- 8.11 新增实测数据:.git 774MB / 96,600 文件 / SSH 4-6 MiB/s 稳定无抖动
- 8.9 备份策略明确列出需另存的大文件清单

ESP32 HOLOMAIN 代码(02_HOLOMAIN_香橙派CM5开发板代码.ino):
- processCommand 响应统一走 Serial(USB CDC),不再回写 SerialLinux(UART0)
- 修复 Android 高频灯光命令占满 UART0 TX 导致 SORC_xxx/SO_BTx 刷卡数据延迟/丢失的问题

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-22 18:14:10 +08:00
87926e48a4 适配 OrangePi CM5 Android 开发板 + 修复 ESP32 冷启动与稳定性问题
一、架构改造
1、双串口架构:Serial (USB-Serial-JTAG, USB2) 用于 Windows 调试日志,
   SerialLinux (UART0/CH343, USB1) 用于 Android 业务数据收发
2、用 #define SerialLinux Serial0 别名引用 Arduino core 自带对象,
   避免自建 HardwareSerial(0) 导致 RX ring buffer 冲突、命令无响应

二、RFID 冷启动稳定性(核心修复)
1、新增 rc522HardResetRuntime():显式拉低拉高 RST 做标准硬件复位时序
2、setup 中 3 次重试初始化 + 读 VersionReg 校验(0x91/0x92 为合法)
3、TaskRFID 运行时每 5 秒健康检查,异常自动恢复
   背景:冷启动 GPIO14 浮空 50% 读到 HIGH,库仅软复位失败 → 刷卡永远无效
   参考 miguelbalboa/rfid Issue #229、#269、#125

三、数据完整性
1、serialPrintlnSafe:互斥锁 + flush 保护业务数据输出
2、卡号格式校验 (HA + 阿拉伯数字),非法数据不发送
3、命令末尾 trim 兼容 \r\n (CRLF) 和 \n (LF) 两种行尾符

四、命令接收(双向打通)
1、processCommand(cmd, Stream& resp):响应回到发送方串口
2、handleCommandFromStream:双串口独立缓冲,Windows 和 Android 都能下发命令
3、新增 RESET 软复位命令(设备封装后无法物理按 RST 时使用)

五、启动稳定性(防硬件冲击与虚假事件)
1、LED 开机全黑启动,避免 186 颗 WS2812 同时点亮产生 4.5A 瞬时电流
   冲击电源导致刚初始化的 RC522 进入异常状态
2、按键任务 lastState 从硬编码改为读取实际 GPIO 电平作为初始值
   避免 GPIO16/17/18 无上下拉浮空触发虚假 SO_WAKEUP/SO_BT 事件

六、性能优化
1、TaskRFID 从 Core 1 迁至 Core 0,与 WS2812 关中断窗口物理隔离
2、LED 刷新频率 30FPS 降至 20FPS,关中断时间减少 33%
3、RFID 认证失败后 delay 从 100ms 降至 30ms,提升刷卡响应速度
4、USB CDC TX 缓冲区扩容至 4KB,降低突发输出时的截断概率

七、新增文件
1、ESP32踩坑经验文档.md:记录 11 个踩坑点 + 修复方案(含 GitHub Issue 佐证)
2、01_HOLOMAIN_旧开发板代码.ino:旧开发板稳定版本代码存档
3、02_HOLOMAIN_香橙派CM5开发板代码.ino:香橙派 CM5 适配版本代码存档
4、docs/ESP32-S3-SCH-V1.4.pdf:ESP32-S3 核心板硬件原理图

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-21 16:52:08 +08:00