App Inventor 2 串口调试 App 全方案技术调研

App Inventor 2

App Inventor 2 串口调试 App 全方案技术调研

前言

串口调试器是硬件开发、嵌入式工程中最常用的工具。很多同学问：App Inventor 2 能不能做一个手机版的串口调试器？答案是：不仅能做，而且有多条技术路线可选。本文从源码层面深度剖析 App Inventor 2 的串口通信能力，给出完整的方案对比和实现建议。

---

一、先说结论：AI2 其实内置了 USB 串口组件

很多人不知道，App Inventor 2 内置了一个 Serial 组件，基于开源的 Physicaloid 库实现，支持 USB OTG 直连串口设备。

源码位置：com/google/appinventor/components/runtime/Serial.java
依赖库：physicaloid-library.jar

支持的 USB 转串口芯片：
- CH340 / CH341（Arduino Nano 兼容板最常用）
- CP2102 / CP2104（ESP8266 常用）
- FT232（FTDI 工业级）
- CDC/ACM（Arduino Uno/Mega 原生 USB）

Serial 组件 API：
- InitializeSerial() — 初始化串口
- OpenSerial() — 打开连接
- CloseSerial() — 关闭连接
- ReadSerial() — 读取数据（文本模式）
- WriteSerial(text) — 发送文本
- PrintSerial(text) — 发送文本+换行
- BaudRate 属性（默认9600）
- BufferSize 属性（默认256）
- IsOpen / IsInitialized 状态属性

局限性：
- 不支持端口选择（自动打开第一个 USB 设备）
- 不支持数据位/停止位/校验位设置
- 无事件回调（需 Clock 轮询读取）
- 仅文本模式，二进制支持较弱
- 不支持 PL2303 芯片

---

二、六大技术方案全面对比

方案1：内置 Serial 组件（USB OTG 直连）

手机 --OTG线-- USB转串口模块(CH340等) -- 目标设备

优点：开箱即用，无需安装扩展；有线连接稳定可靠；支持主流 USB 转串口芯片
缺点：功能有限，无端口选择；无事件回调；二进制数据处理不便；占用手机USB口
推荐度：★★★ 适合入门教学

方案2：蓝牙串口 SPP（BluetoothClient 内置组件）★最推荐

手机 --蓝牙-- HC-05/HC-06 --UART-- 目标设备

BluetoothClient 组件使用 SPP（Serial Port Profile）协议，通信能力比 Serial 组件还要完善。

源码中的 SPP UUID：00001101-0000-1000-8000-00805F9B34FB

BluetoothClient 串口数据传输能力：

发送方法：
- SendText(text) — 发送文本
- Send1ByteNumber / Send2ByteNumber / Send4ByteNumber — 发送指定宽度数字
- SendBytes(list) — 发送字节列表

接收方法：
- ReceiveText(numBytes) — 接收文本（-1表示读到分隔符）
- ReceiveSigned/Unsigned 1/2/4 ByteNumber — 按宽度接收
- ReceiveSignedBytes / ReceiveUnsignedBytes — 字节数组接收
- BytesAvailableToReceive — 可读字节数

配置属性：
- CharacterEncoding（默认UTF-8）
- DelimiterByte（分隔符，按行接收很实用）
- HighByteFirst（字节序/大小端切换）
- Secure（安全配对模式）

优点：内置组件零配置成本；二进制收发完善；支持分隔符/定长接收；HC-05/HC-06不到10元；无线距离10米；可与Chart组件绑定实现实时波形
缺点：需预先配对；经典蓝牙功耗较高；无原生数据接收事件（需Clock轮询）；iOS不支持SPP
推荐度：★★★★★ 最成熟可靠

方案3：自研 USB Serial 扩展

推荐基础库：UsbSerial（GitHub: felHR85/UsbSerial）
- 支持芯片最全：CDC, CP210x, FTDI, PL2303, CH34x
- 支持异步事件回调
- 支持完整串口参数配置（数据位/停止位/校验位/流控）

建议的扩展接口设计：
方法：ListDevices()、RequestPermission()、Connect()、Disconnect()、SendText/SendHex、SetParameters()
事件：DeviceAttached/Detached、DataReceived、ConnectionLost
属性：BaudRate/DataBits/StopBits/Parity、Connected

优点：功能最强，接近专业串口调试器；支持异步事件回调；支持所有主流芯片
缺点：需要Java+Android开发能力；开发周期2-3周
推荐度：★★★★ 适合进阶开发

方案4：Web Serial API（WebView 方案）— 不可行

关键问题：Android System WebView 不支持 Web Serial API。Google出于安全考虑在WebView中禁用了navigator.serial接口。只有Chrome浏览器本身支持，WebView不支持也没计划支持。
结论：不可行，不推荐在此方向投入时间。

方案5：中间代理方案（ESP32/WiFi 中转）

手机 --WiFi-- ESP32 --UART-- 目标设备

ESP32 运行 TCP Server，一端WiFi透传一端UART透传。
AI2 端使用 TCP Socket 扩展连接 ESP32。

优点：避开USB串口难题；WiFi通信距离远；可在代理层实现协议解析
缺点：需要额外硬件（ESP30-50元）；需要写固件代码；引入网络延迟（约5-20ms）
推荐度：★★★ 适合 IoT 项目

方案6：TCP/UDP 网络串口

手机 --WiFi-- 串口服务器 --RS232/RS485-- 工业设备

优点：适合工业场景（RS232/RS485）；通信距离不受限；多客户端可同时连接
缺点：串口服务器硬件成本50-500元；需要稳定网络环境
推荐度：★★★ 适合工业应用

---

三、关键技术难点与解决思路

难点1：异步数据接收
AI2事件驱动模型中，蓝牙和Serial组件都没有"数据到达"事件。
解决：用Clock组件定时轮询，Interval=50ms，Timer事件中检查BytesAvailableToReceive，有数据则读取追加到缓冲区，超过50ms无新数据则认为一帧结束。

难点2：Hex/ASCII 双模式显示
AI2没有内置Hex转换函数。思路：ASCII转Hex用查表法逐字符转换；Hex转ASCII每两字符一组转十进制取字符。建议做成自定义Procedure复用。

难点3：大数据量下的性能
高波特率下数据量很大可能卡顿。解决：限制UI刷新频率（每100ms刷新一次）；用ListView替代TextBox显示；实现环形缓冲区限制最大行数；提供数据过滤搜索。

难点4：数据帧分片处理
蓝牙/网络传输中数据可能分多次到达。解决：实现接收缓冲区机制；基于超时判断帧结束；Modbus等协议按固定帧长度组装。

---

四、推荐实现路径

第一阶段（1-2天）：蓝牙串口调试器
1. ListPicker 显示已配对蓝牙设备
2. BluetoothClient.Connect 连接
3. Clock 定时轮询接收数据
4. TextBox + 按钮实现发送
5. 添加 Hex/ASCII 切换
6. File 组件保存日志

第二阶段（3-7天）：增加 USB OTG 支持
使用内置 Serial 组件或导入社区扩展，USB设备枚举和权限管理，串口参数配置界面，与蓝牙模式统一UI。

第三阶段（2-3周，可选）：自研专业扩展
基于 UsbSerial 开发库，异步事件回调，完整串口参数支持，十六进制收发，数据帧解析，多设备同时连接。

---

五、开源资源参考

- usb-serial-for-android（mik3y）：https://github.com/mik3y/usb-serial-for-android
Android平台最流行的USB串口驱动库，支持CP2102/FT232/CH340/PL2303/CDC

- UsbSerial（felHR85）：https://github.com/felHR85/UsbSerial
功能更强的替代库，推荐作为自研扩展的基础

- MIT App Inventor 源码：https://github.com/mit-cml/appinventor-sources
包含Serial组件和BluetoothClient完整源码

- App Inventor Extension 开发文档：https://docs.appinventor.mit.edu/extension-dev/

- MIT App Inventor 社区：https://community.appinventor.mit.edu/
搜索 serial、USB OTG、Bluetooth serial 等关键词

---

总结

App Inventor 2 制作串口调试 App 完全可行，而且选择丰富：

- 要快速出成果 -> 用蓝牙 BluetoothClient + HC-05，1天搞定
- 要有线直连 -> 用内置 Serial 组件 + USB OTG，开箱即用
- 要专业功能 -> 自研 UsbSerial 扩展，功能最强
- 要连工业设备 -> TCP 网络串口方案

App Inventor 2 虽然不是专业的串口开发平台，但其可视化编程优势和丰富的通信组件生态，足以支撑一个功能完善的串口调试 App 的快速开发。

如果你在实现过程中遇到问题，欢迎在评论区交流！