|
|
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 |
|
|
|
75662e102e
|
补充 OrangePi CM5 Android 13 实际编译踩坑记录与修复方法
1、Dockerfile 加入实测必需的兼容包：libncurses5（Clang 依赖）、python2（Rockchip U-Boot make.sh 硬依赖）、libssl-dev、imagemagick、protobuf-compiler 等预防性包
2、新增编译后的 U-Boot 手动修复步骤：-F 参数不自动生成 MiniLoaderAll 和 trust.img，需手动调用 u-boot/make.sh rk3588 + trust.img 副本伪装 + -Mu 重打包
3、新增完整镜像产物清单，说明 update.img 作为 Rockchip 固件打包格式已包含所有分区镜像，首次烧录只需 update.img
4、新增分区单独烧录对照表，指导开发调试时精确刷分区（boot/super/uboot 等）节省时间
5、新增 10 个踩坑速查表，覆盖 SDK 下载、合并、编译、打包全流程
6、新增新电脑复现完整命令流水线，换电脑后按序执行可避开所有已知坑
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
2026-04-21 10:01:29 +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 |
|
|
|
1402dc6dee
|
本次修改内容如下：
1、增加代码备注；
2、上传NFC卡片的数据刷写操作指南；
|
2026-04-15 11:55:27 +08:00 |
|
|
|
8693ee1d29
|
1、洛天依项目ESP32部分业务-项目初始化
|
2026-03-05 17:12:48 +08:00 |
|
