|
|
713cbd1835
|
修复律动期间 UART0 TX 拥堵 + 补充踩坑文档 + 硬件文档归类 + Mac 开发工程入库
一、代码修复（HOLOMAIN.ino）
1、processCommand 响应改为只发 Serial (USB CDC / Windows 调试)，不再回发 SerialLinux (Android)
背景：Android 随音乐律动高频发送 LED 命令时，ESP32 每条命令的响应挤占 UART0 TX，
导致刷卡产生的 SORC_xxx 业务数据延迟到达 Android，表现为律动期间刷卡经常无效
效果：UART0 TX 释放给业务数据使用，Windows 调试仍能通过 USB CDC 看到响应
二、踩坑经验文档补充（ESP32踩坑经验文档.md）
1、新增坑 12：音乐律动时高频 LED 命令导致 RFID 高概率失败【物理层面干扰】
2、内容涵盖：
- 现象描述与触发条件（律动期间 vs 静态场景）
- 根本原因推演：高频亮度跳变 → WS2812 电流瞬变 → 电源噪声耦合 → RC522 SPI 异常
- 与坑 7（WS2812 关中断）的区别：坑 12 是物理电源噪声，即使用 RMT 也无法避免
- 四层解决方案按优先级排列：
方案1 Android 端降频+去重+节拍化（已验证，60FPS→5次/秒，失败率显著降低）
方案2 ESP32 响应只发调试口（已实施，本次提交）
方案3 ESP32 亮度平滑过渡（预备方案，含完整代码和 step_max 调校参考）
方案4 RC522 供电去耦电容（硬件方案，终极根治）
3、经验教训：主机端源头减量 > 固件端平滑过渡 > 硬件去耦电容
三、硬件文档目录归类（docs/）
1、新建 docs/ESP32/ 分类目录
2、新建 docs/OrangePi_CM5/ 分类目录
3、移动原散落在 docs/ 根目录的文档到对应分类
4、新增资料：
- docs/OrangePi_CM5/OPI CM5 BASE-TABLET_V1_1_SCH.pdf（底板原理图）
- docs/OrangePi_CM5/开发工具用户手册_v1.0.pdf
四、Mac 开发工程入库（Luotianyi_Mac/）
1、新增 Luotianyi_Mac/Luotianyi_Mac.ino
2、用途：Windows 切换到 Mac 开发环境后，后续 ESP32 业务在此工程继续开发
3、HOLOMAIN.ino 保留作为 Windows Arduino IDE 下的基线版本
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-04-22 14:35:42 +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 |
|
|
|
c21c4d2547
|
新增 OrangePi CM5 Android 13 编译环境配置指南
1、新增 3.7 节 OrangePi CM5 编译环境（与 Radxa CM5 平级）：基于 Ubuntu 22.04 Docker 镜像，对齐 OrangePi 官方推荐环境
2、新增 OrangePi 分卷压缩包合并解压踩坑记录：官方文档的管道流式解压会出错，改用先合并再解压的方式
3、新增 OrangePi Dockerfile 模板和构建步骤（android-builder-orangepi:13.x）
4、新增 Radxa / OrangePi 双环境关键差异对比表
5、更新环境信息表：标注 Radxa 和 OrangePi 双环境状态
6、3.6 节重命名为 Radxa CM5 Android 12 编译环境（明确区分）
7、docs/ 新增 OrangePi CM5 Base 两本官方用户手册（v1.3 + Tablet v1.0）
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-04-17 18:25:44 +08:00 |
|
|
|
3373e88e5c
|
新增远程开发操作指南和官方参考文档
1、新增 Tailscale + SSH 远程开发操作指南：Mac 跨网络连接 Windows 虚拟机的完整配置（网络架构、ClashX Pro 增强模式与 Tailscale 共存、Docker Android 编译环境、换新电脑迁移方案、故障排除）
2、新增 Radxa 官方 Android 底层开发文档（Dockerfile 环境参考）
3、新增 .gitignore，排除 macOS 自动生成的 .DS_Store
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-04-17 17:03:46 +08:00 |
|
