把安卓手机当成STM32的调试上位机这事儿听起来挺折腾但实际做下来会发现它比想象中简单而且非常实用。尤其当你做便携式设备、野外调试或者不想抱着笔记本跑来跑去的时候手机通过USB串口直接跟单片机通讯能省掉一大半麻烦。这个项目解决的核心问题就一个让安卓设备识别并操作USB转串口芯片打通数据链路实现双向通讯。这篇文章我会把硬件连接、安卓端USB Host模式原理、串口库选型、STM32固件配置、联调排错整个流程拆开讲清楚。内容偏向实际落地适合正在做安卓工控APP、嵌入式调试工具、或者搞物联网网关的朋友参考新手也能按步骤跟着做不会一上来就劝退。1. 项目整体架构与硬件准备1.1 通讯链路的基本构成整条链路从数据流向上看其实很清晰STM32单片机通过USART串口引脚输出TTL电平信号接到USB转串口模块比如CH340、CP2102、FT232模块再把TTL电平转换成USB协议信号通过OTG线进入安卓设备的USB口。安卓端在USB Host模式下枚举到这个设备由应用层库完成数据的读取和写入。听起来环节不少但每一步都是成熟方案。真正需要花心思的地方有两个一是安卓端如何拿到USB设备的读写权限二是STM32端如何稳定地收发数据不丢字节。这两个问题后面会重点展开。1.2 硬件清单与选型心得我实际用的是这几样东西你可以直接照抄配置器件型号/规格说明安卓设备任意支持OTG的手机或平板系统建议Android 5.0以上USB Host API更稳定OTG线标准Micro USB/Type-C转USB-A母口注意手机是Micro还是Type-C别买错USB转TTL模块CH340G或CP2102模块CH340便宜CP2102兼容性略好STM32开发板STM32F103C8T6最小系统板经典中的经典资料多便宜耐造杜邦线母对母若干连接模块与开发板有个选型细节值得说USB转TTL模块的供电跳线。很多模块上有3.3V和5V的跳线帽选择如果STM32开发板是3.3V逻辑模块跳线就选3.3V避免IO口电平不匹配。虽然STM32F103大部分IO是容忍5V的但稳妥起见电平一致能少很多玄学问题。1.3 为什么选择USB串口而不是蓝牙或WiFi你可能会有疑问现在蓝牙模块那么便宜WiFi也普及为什么还要用USB串口我的回答是稳定性和实时性。USB串口是纯硬件链路没有无线协议栈的延迟和干扰问题。如果你要调试的是工业设备、传感器数据采集或者要跑Modbus这类时序敏感协议USB串口比蓝牙靠谱得多。另外USB串口还有一个隐藏优势同时给安卓设备供电不用额外给手机准备充电宝。OTG线加上USB HUB甚至能实现边充电边通讯对长时间运行的测试场景非常友好。2. 安卓端从零跑通USB串口通讯2.1 USB Host模式原理解析安卓设备作为USB主机是在Android 3.1API 12以后才正式支持的。Android通过UsbManager类管理USB设备系统会负责枚举连接到OTG口的USB设备并把设备信息以UsbDevice对象的形式暴露给应用层。但这里有个关键问题安卓系统本身并不认识CH340、CP2102这类USB转串口芯片。它只知道插入了一个USB设备却不知道这个设备是干什么的、该怎么读写。真正的串口数据转换需要应用层通过USB的bulk端点批量传输端点来读写。幸运的是开源社区已经把这些脏活累活封装好了不需要你直接操作端点。2.2 串口库选型为什么不自己写我最早尝试过直接用UsbDeviceConnection的bulkTransfer方法做数据收发写了一半就放弃了。因为你要自己处理USB控制传输、端点地址解析、串口线路参数设置还要应对不同芯片的差异工作量非常大而且极易出错。后来换成了GitHub上的mik3y/usb-serial-for-android库简称UsbSerial项目瞬间清爽了。这个库封装了CH340、CP2102、FT232、PL2303等常见USB转串口芯片的驱动统一的UsbSerialPort接口操作起来和普通Java的InputStream/OutputStream一样简单。依赖添加也很简单在build.gradle里加入implementation com.github.mik3y:usb-serial-for-android:3.7.02.3 权限申请与设备插拔监听安卓的USB设备访问是受权限保护的即使你的App有所有运行时权限也不能直接打开USB设备。必须在用户点击“允许”之后才能建立连接。这段流程每次插拔设备后都要走一遍。// 获取UsbManager实例 UsbManager usbManager (UsbManager) getSystemService(Context.USB_SERVICE); // 查找目标设备根据vendorId和productId过滤 HashMapString, UsbDevice deviceList usbManager.getDeviceList(); UsbDevice device null; for (UsbDevice usbDevice : deviceList.values()) { if (usbDevice.getVendorId() 0x1A86) { // CH340的VendorID device usbDevice; break; } } // 申请权限 if (device ! null) { if (usbManager.hasPermission(device)) { openSerialPort(device); } else { PendingIntent permissionIntent PendingIntent.getBroadcast( this, 0, new Intent(ACTION_USB_PERMISSION), PendingIntent.FLAG_MUTABLE); usbManager.requestPermission(device, permissionIntent); } }权限申请的结果通过广播回调。这里有一个非常容易踩的坑PendingIntent的FLAG_MUTABLE标志。Android 12API 31以后强制要求显式指定可变性如果代码里不写应用会直接崩溃。我在项目里就是在这里吃过亏系统日志报的是SecurityException排查半天才发现是PendingIntent的标志位问题。2.4 串口参数配置与数据收发拿到权限后要先把UsbDeviceConnection和UsbSerialPort建立起来再配置波特率等参数UsbSerialPort port null; try { UsbDeviceConnection connection usbManager.openDevice(device); port new CH340SerialDriver(device).getPorts().get(0); port.open(connection); port.setParameters(115200, 8, UsbSerialPort.STOPBITS_1, UsbSerialPort.PARITY_NONE); } catch (IOException e) { e.printStackTrace(); }这里有几个参数需要你重点理解不只是设个值就完了波特率必须和STM32端的USART配置一致否则收到的就是乱码。我习惯用115200因为这是大部分调试工具比如串口助手的默认值联调时省心。数据位串口协议里数据位通常是8对应一个字节也是STM32 HAL库的默认配置。停止位1个停止位是最常见的选择。校验位常用无校验如果做工业通讯需要校验可以选偶校验这也需要在两端保持一致。读写数据用port.read()和port.write()但这两个方法在UsbSerial库里是同步阻塞的。如果你在UI线程里调用会把界面卡死。建议单独开一个工作线程做数据读写或者用ExecutorService管理。// 写入数据 byte[] data {0x01, 0x03, 0x00, 0x00, 0x00, 0x0A, 0xC5, 0xCD}; port.write(data, 1000); // 1秒超时 // 读取数据在子线程中 byte[] buffer new byte[1024]; int len port.read(buffer, 1000); // 阻塞最多1秒 if (len 0) { // 处理收到的数据 }需要注意的是read()返回的len可能小于buffer长度这是正常现象。串口是流式数据没有固定的包边界你需要自己的协议来判定一帧数据的开始和结束。3. STM32端串口配置与固件编写3.1 硬件连接与电平匹配STM32端接线很简单但也很容易接反。USB转TTL模块的TXD要接STM32的RX模块的RXD要接STM32的TX。注意是交叉连接不是直连。我见过好几个朋友第一次接的时候TXD接TXD结果数据怎么都跑不通。以STM32F103C8T6最小系统板为例我使用USART2引脚是PA2USART2_TX→ 模块RXDPA3USART2_RX→ 模块TXDGND → 模块GNDGND必须共地这是很多人忽略的细节。如果不共地信号电平没有参考基准通讯大概率失败表现是数据全乱或者完全收不到。另外如果模块是从USB取电给STM32供电那共地是自动的如果STM32是独立供电一定要单独接一根GND线。3.2 使用STM32CubeMX配置串口STM32CubeMX是ST官方的图形化配置工具用它能省去大量手写初始化代码的时间。我习惯先CubeMX生成工程再在生成的代码基础上加业务逻辑。关键配置项如下选择芯片型号STM32F103C8T6时钟树将系统主频配置为72MHz外部8MHz晶振9倍频USART2模式选择Asynchronous异步通讯参数配置波特率115200数据位8无校验停止位1使能USART2全局中断在NVIC设置中勾选USART2 global interrupt生成代码后CubeMX会自动创建huart2实例。接下来要做的就是在main函数里启动串口接收中断。3.3 中断接收与数据回传串口接收最基础的做法是中断方式也就是每收到一个字节就触发一次中断在中断回调函数里处理数据。这样做的好处是CPU不用轮询等待节省资源。在main.c的main函数中加入HAL_UART_Receive_IT(huart2, rx_data, 1);这行代码的意思是开启USART2的接收中断每次收到1个字节就触发回调。rx_data是一个全局变量用来暂存收到的字节。然后在stm32f1xx_it.c或main.c中实现回调函数uint8_t rx_data 0; uint8_t rx_buffer[256]; uint16_t rx_index 0; void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart-Instance USART2) { rx_buffer[rx_index] rx_data; // 简单回显测试用 HAL_UART_Transmit(huart2, rx_data, 1, 100); // 重新开启接收中断 HAL_UART_Receive_IT(huart2, rx_data, 1); } }这里的逻辑是收到一个字节存进缓冲区同时原样回显给安卓端然后重新开启中断等待下一个字节。rx_data必须定义成全局变量因为中断回调是在中断上下文执行的不能使用局部变量。3.4 防止数据丢失的缓冲区设计上面这种一字节一回调的做法在低波特率下没问题但如果数据量大、速率快频繁中断会拖累系统。更优的做法是使用环形缓冲区Ring Buffer在中断回调中只做“放入缓冲区”这件事主循环里再做数据解析和处理。环形缓冲区的核心思想一个固定大小的数组通过头尾指针实现循环读写头指针是写入位置尾指针是读取位置。当缓冲区满时可以选择覆盖旧数据或丢弃新数据根据业务需求来定。#define RX_BUFFER_SIZE 512 typedef struct { uint8_t buffer[RX_BUFFER_SIZE]; volatile uint16_t head; volatile uint16_t tail; } RingBuffer; RingBuffer rx_ring; void ring_buffer_write(RingBuffer *rb, uint8_t data) { uint16_t next_head (rb-head 1) % RX_BUFFER_SIZE; if (next_head ! rb-tail) { // 缓冲未满 rb-buffer[rb-head] data; rb-head next_head; } // 如果满了丢弃该字节 } void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart-Instance USART2) { ring_buffer_write(rx_ring, rx_data); HAL_UART_Receive_IT(huart2, rx_data, 1); } }主循环里通过检查head ! tail来判断是否有新数据到达然后按自己的协议解析。这种设计把“接收”和“处理”解耦即使主循环在处理其他任务比如驱动LED串口数据也不会丢除非缓冲区真的满了。3.5 一个完整的Modbus命令响应示例做工业通讯的话Modbus RTU协议用的非常多。下面给出一个简单的协议解析例子安卓端发送01 03 00 00 00 0ASTM32返回对应地址的数据。void parse_rx_data(uint8_t *data, uint16_t len) { if (len 8) return; if (data[0] 0x01 data[1] 0x03) { // 读保持寄存器命令返回20字节数据10个寄存器 uint8_t response[23]; response[0] 0x01; // 从机地址 response[1] 0x03; // 功能码 response[2] 20; // 数据字节数 for (int i 0; i 10; i) { response[3 i*2] (uint8_t)(regs[i] 8); response[4 i*2] (uint8_t)(regs[i] 0xFF); } // 计算CRC16Modbus这里省略具体实现 uint16_t crc modbus_crc16(response, 23); response[21] crc 0xFF; response[22] crc 8; HAL_UART_Transmit(huart2, response, 23, 100); } }Modbus CRC16的计算网上有很多现成实现但要注意高低字节的顺序发送时先低字节后高字节。这也是一个容易犯错的点如果不注意顺序从机端会一直报CRC错误。4. 联调过程与常见问题排查4.1 联调步骤实录准备工作做完就到了最激动人心的联调环节。我的建议是先分开测试再连起来测。不要一上来就把安卓和STM32直接连起来不然出问题你都不知道是哪一端的锅。第一步先用USB转TTL模块接电脑用串口助手我用的XCOM测试STM32的串口回显功能。如果电脑上能正常看到STM32发回来的数据说明STM32端没问题。第二步把USB转TTL模块从电脑拔下来插到安卓手机上。注意看手机上会不会弹出“允许访问USB设备”的提示。如果弹出来了点允许如果没弹说明你的App没有正确注册USB权限广播需要回头检查代码。第三步在安卓App里发一条测试指令比如一个简单的握手协议看STM32那边是否收到。如果收到正确数据并且STM32返回的数据也能在App里读到恭喜链路打通了。4.2 常见问题速查表说实话这个项目90%的问题都出在几个固定的地方我把它们整理成一张表你照着排查就行现象可能原因解决方法手机不弹USB权限框USB枚举失败或App未注册检查OTG线是否支持数据检查App的USB权限广播注册代码权限允许后打不开设备设备被其他App占用关闭其他串口App或先拔插USB线释放设备收到全是乱码波特率不一致确认两端波特率都是115200能发不能收TX/RX接反交叉连接模块TXD接STM32的RX模块RXD接STM32的TX能收不能发STM32未开启发送中断检查HAL_UART_Transmit的使用是否正确检查发送缓冲区是否被占满数据丢字节缓冲区太小或处理太慢加大环形缓冲区把数据处理移到主循环打开串口报Device not found驱动不匹配确认UsbSerial库里包含对应芯片的Driver类App崩溃闪退Android 12 PendingIntent标志位使用PendingIntent.FLAG_MUTABLE或FLAG_IMMUTABLE这里特别说一下“能发不能收”的情况我遇到过很多次。STM32端以为自己在发送数据但安卓端就是收不到。排查思路是这样的先用手机上的串口调试App比如“串口调试助手”测试如果调试App能收到说明硬件和驱动没问题问题在你的App代码里如果调试App也收不到检查模块的TXD引脚是否真的有信号——用万用表量一下空闲电平应该接近3.3V。4.3 几个必须避开的坑第一个坑USB转串口模块的供电不足。有些劣质OTG线或者旧手机的USB口输出电流只有100mA左右带不动CH340模块和STM32同时工作。表现是模块可以枚举成功但是一通讯就卡死或丢数据。解决方案是用带外部供电的USB HUB或者单独给STM32供电。第二个坑CH340和CP2102的驱动差异。CH340的VendorID是0x1A86ProductID是0x7523CP2102的VendorID是0x10C4ProductID是0xEA60。UsbSerial库虽然都支持但Driver类注册的顺序有讲究。如果两个设备同时插入有些版本可能识别到错误的设备。第三个坑也是容易被忽略的USB线缆的质量。很多安卓设备的充电线内部只有电源线没有数据线插上去根本不会有反应。这就是为什么联调前要先拿数据线连电脑测试确认线的数据功能正常再上手机。第四个坑串口接收缓冲区的溢出。如果你在STM32中断里做太多事情比如打印日志、浮点运算会导致接收中断响应不及时数据被USART硬件FIFO覆盖。我的建议是中断回调里只做入队操作其余逻辑一律放主循环。4.4 性能优化与后续扩展方向如果通讯频率高、数据量大有几个优化方向值得尝试使用DMA接收代替中断接收。STM32的USART支持DMA传输可以把串口数据直接搬到内存缓冲区几乎不占CPU。配置方法是在CubeMX里把USART2的模式改成Asynchronous DMA然后使能RX的DMA通道。DMA接收需要配合空闲中断IDLE Line来判定一帧数据的结束具体实现我在另一个项目里有整理过这里先提一嘴有需要的朋友可以深挖。安卓端也可以考虑使用UsbSerialProber来自动探测设备这样不用硬编码设备IDListUsbSerialDriver drivers UsbSerialProber.getDefaultProber() .findAllDrivers(usbManager); if (!drivers.isEmpty()) { UsbSerialDriver driver drivers.get(0); UsbSerialPort port driver.getPorts().get(0); }这种方式对用户更友好尤其是你打算把App给别人用的时候不同硬件厂商的产品都能自动识别。最后再分享一点个人体会做这个项目的过程中我最大的感触是嵌入式调试工具永远是“能用”和“好用”之间差着十万八千里。安卓USB串口通讯这个方案论速度比不过仿真器论方便比不过无线但在“现场调试、快速部署、便携操作”这些场景下它是无可替代的。我后来做的几个设备维护工具类App基本都沿用这套架构一个手机、一根OTG线、一个USB转TTL模块走遍现场都不怕。如果你按照上面的步骤做通了你手头就相当于有了一套非常灵活的软硬件调试平台。后续可以在此基础上继续扩展——比如加入数据图表显示、协议解析框架、甚至远程日志上传。关键是先把第一步打通链路通了后面的想象力就大了。
