手机连单片机只会找串口线SimpleBluetoothTerminal 用蓝牙 SPP 帮你 30 分钟搭一个无线调试台【免费下载链接】SimpleBluetoothTerminalAndroid terminal app for Bluetooth classic devices using SPP profile项目地址: https://gitcode.com/gh_mirrors/si/SimpleBluetoothTerminal每次调试 ESP32、Arduino 这类开发板很多人第一反应是翻箱倒柜找 USB 转 TTL 线、装驱动、盯端口号线缆一多桌面就乱成一团。如果你想要的是打开手机、点一下设备、直接收发数据的体验SimpleBluetoothTerminal 这个 Android 开源项目就是为这个场景准备的——它用经典蓝牙的 SPP 协议把手机变成一个纯正的串口终端随时对着开发板说话。先搞清楚它解决的是哪类麻烦做硬件调试的人都知道传统串口调试链路里有一堆隐形成本电脑上没有空闲的 USB 口、驱动版本和操作系统打架、台式机离测试台太远只能蹲着看数据。蓝牙串口模块HC-05、HC-06 之类很便宜但问题是——谁来当那个串口终端市面上能搜到的蓝牙调试 App 不少但要么广告铺满屏要么连数据都收不完整。SimpleBluetoothTerminal 的目标非常单纯做一个面向经典蓝牙2.x设备、基于 SPP 串口配置文件的行式终端。它不碰低功耗蓝牙BLE不搞花哨仪表盘就把连接→收发→显示这件事做到扎实。值得一提的是它的作者就是 Google Play 上知名应用 Serial Bluetooth Terminal 的开发者这个仓库是那款商业应用的简化开源版专门留给想学习蓝牙通信实现的人。换句话说你读到的不是玩具代码而是一套在真实产品里打磨过的逻辑。为什么说它是刚刚好的参考实现作为学习样本这个项目有两个很关键的优点。第一体量小到一天能读完。整个核心逻辑只有 9 个 Java 文件全部在app/src/main/java/de/kai_morich/simple_bluetooth_terminal/目录下入口MainActivity、设备列表DevicesFragment、终端界面TerminalFragment、连接管理SerialSocket、后台服务SerialService、回调接口SerialListener外加BluetoothUtil权限处理和TextUtil十六进制、控制字符转换两个工具类。没有第三方蓝牙库没有晦涩的框架Android 官方 API 就是全部依赖。第二生命周期处理是教科书级的。蓝牙连接最怕的就是界面旋转、切到后台、来电打断这些情况——很多简易实现会在这些时刻掉线或崩掉。这个项目用前台服务 事件队列的组合拳把连接和数据收发的稳定性兜住了。后面会细说它是怎么做到的。从克隆到和开发板对话走一遍最快路径环境上你需要 Android Studio、API 21 以上的 SDK、JDK 11以及一台支持蓝牙的 Android 真机模拟器一般不靠谱蓝牙栈差异太大。硬件端准备一块带 HC-05/HC-06 蓝牙模块的开发板波特率先设成 9600 或 115200跟模块默认一致即可。第一步克隆仓库git clone https://gitcode.com/gh_mirrors/si/SimpleBluetoothTerminal用 Android Studio 打开后Gradle 会自动拉取依赖主要是 AndroidX 和 Material 组件。等首次构建完成后把手机开成开发者模式、连上数据线直接点 Run。如果你只想快速看效果也可以装上之后用系统蓝牙先配对开发板再进入 App。实际使用流程只有三步打开 App会看到已配对设备的列表顶部有刷新和蓝牙设置两个入口点击目标设备界面切换到终端页状态栏会依次显示connecting...→connected底部输入框敲一条命令比如AT或LED_ON点发送上方的接收区马上会出现设备的回应。终端页右上角菜单还藏着几个实用开关Hex切换十六进制收发模式Newline选择换行符是\r\n还是\nClear清空屏幕还有一个后台通知开关用来控制在后台保持连接时是否显示常驻通知。九个 Java 文件里的三层门道看懂这个项目就等于看懂了 Android 蓝牙串口通信的标准答案。它的数据流是一条清晰的三级链SerialSocket → SerialService → 界面层。第一层SerialSocket把 RFCOMM 连接藏起来SerialSocket承担了最底层的工作。它的核心是这一行socket device.createRfcommSocketToServiceRecord(BLUETOOTH_SPP);其中BLUETOOTH_SPP是 SPP 的公认 UUID00001101-0000-1000-8000-00805F9B34FBAndroid 据此去和蓝牙模块建立 RFCOMM 通道。连接和读数据被塞进一个单线程池里执行避免阻塞 UI 线程run()方法里用一个 1024 字节的缓冲区循环读输入流读到的每一段数据都通过SerialListener回调抛给上层。断开时它会关闭 socket、注销广播接收器并忽略残留的数据——注释里写得很直白ignore remaining data and errors。第二层SerialService稳定性的灵魂这是整个项目最值得反复读的部分。SerialService是一个前台服务它解决了一个现实问题用户切到别的 App 甚至锁屏时蓝牙数据还在源源不断进来如果界面和连接绑死一切就中断了。它的设计是服务常驻界面来去自由attach / detach界面TerminalFragment可见时 attach 自己作为监听者不可见时 detach双队列缓冲界面不在时收到的数据不会丢而是进queue1/queue2暂存等界面重新挂载时一次性补发前台通知界面退到后台时创建一个常驻通知点通知能回主界面通知栏里还带一个 Disconnect 按钮可以直接断开。还有一个容易被忽略的细节接收数据用的是两个ArrayDeque双端队列做合并。注释里解释得很清楚——蓝牙数据可能以每秒上百个碎片到达但 UI 每秒钟只能刷新十几次。于是它只在队列为空时通知 UI 一次后续数据先堆进队列等 UI 消费时一次性取走把频繁的刷新请求压缩成了批量更新。TerminalFragment里也特意把接收文本的颜色设为默认色减少 Spannable 的 span 数量因为TextView 性能会随 span 数量下降。第三层界面层把字节翻译成人话TerminalFragment负责数据的人性化呈现。它做了三件小事但每一件都针对真实痛点十六进制收发TextUtil提供字节流和十六进制字符串的双向转换发送框还有HexWatcher实时格式化边输入边自动补空格控制字符转义串口设备经常回一些\r、\x01之类的不可见字符直接显示会花屏。项目用 Caret 记法把控制字符显示成^A、^M这种形式还专门处理了\r\n被拆成两段到达时的边界情况避免出现多余的^M发送换行选择不同设备对行结束符的脾气不一样有的认\r\n有的只认\n菜单里可以随时切换。顺带一提权限处理BluetoothUtil把 Android 12API 31之后的BLUETOOTH_CONNECT运行时权限请求、拒绝后的引导跳转设置页都封装好了新版系统上不至于踩点了没反应的坑。新手最容易在这四个地方翻车这个项目本身能跑通但你在自己项目里照搬或改造时有四个坑几乎人人都会踩一遍。坑一把 SPP 和 BLE 混为一谈。项目明确过滤掉了DEVICE_TYPE_LE类型的设备——它只服务经典蓝牙。如果你拿的是 BLE 模块很多新开发板默认 BLE列表里根本看不到它。需要 BLE 的话这套代码不适用得另找 GATT 方案。坑二Android 12 权限不弹窗。如果设备列表一直显示 permission missing, use REFRESH别怀疑手机坏了——新系统把蓝牙连接权限单独拆了出来BLUETOOTH_CONNECT而且首次拒绝后再次请求会走解释弹窗 → 设置页的流程。这也是BluetoothUtil存在的意义。坑三后台收不到数据。Android 8 以后对后台服务限制严格Android 13/14 又新增了通知权限POST_NOTIFICATIONS不授权的话切后台连接就可能静默死亡。Manifest 里的FOREGROUND_SERVICE系列权限和前台服务类型声明remoteMessaging|connectedDevice一个都不能少。坑四连接失败但报错信息太笼统。常见原因其实是物理层面的——模块没上电、波特率不匹配、或者设备已经被别的终端占着。连接失败时界面上会打印connection failed:加异常信息先看是不是这些老三样。这趟跑通了下一步你想把它变成什么跑通一个 demo 只是开始。这个项目的价值在于它是可生长的底座你有至少四个方向可以动手给数据加记忆把收发记录落盘做成一个带历史的调试日志工具接入协议解析在onSerialRead回调里挂上 Modbus、自定义帧协议的解码器终端立刻升级成协议分析仪改造 UI 布局现在的接收区是滚动 TextView你可以换成 RecyclerView支持复制、过滤、高亮关键词做多设备轮询在SerialService的队列机制上扩展轮流切换多个连接模拟工业现场的多机巡检。说到底一个串口终端真正让人上瘾的地方是它把看不见的字节变成了看得见的对话。你现在有了一个现成的对话窗口那么——你准备让你的开发板先开口说什么是回一句HELLO还是直接把传感器数据流倒进手机屏幕【免费下载链接】SimpleBluetoothTerminalAndroid terminal app for Bluetooth classic devices using SPP profile项目地址: https://gitcode.com/gh_mirrors/si/SimpleBluetoothTerminal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 手机连单片机只会找串口线？SimpleBluetoothTerminal 用蓝牙 SPP 帮你 30 分钟搭一个无线调试台
手机连单片机只会找串口线SimpleBluetoothTerminal 用蓝牙 SPP 帮你 30 分钟搭一个无线调试台【免费下载链接】SimpleBluetoothTerminalAndroid terminal app for Bluetooth classic devices using SPP profile项目地址: https://gitcode.com/gh_mirrors/si/SimpleBluetoothTerminal每次调试 ESP32、Arduino 这类开发板很多人第一反应是翻箱倒柜找 USB 转 TTL 线、装驱动、盯端口号线缆一多桌面就乱成一团。如果你想要的是打开手机、点一下设备、直接收发数据的体验SimpleBluetoothTerminal 这个 Android 开源项目就是为这个场景准备的——它用经典蓝牙的 SPP 协议把手机变成一个纯正的串口终端随时对着开发板说话。先搞清楚它解决的是哪类麻烦做硬件调试的人都知道传统串口调试链路里有一堆隐形成本电脑上没有空闲的 USB 口、驱动版本和操作系统打架、台式机离测试台太远只能蹲着看数据。蓝牙串口模块HC-05、HC-06 之类很便宜但问题是——谁来当那个串口终端市面上能搜到的蓝牙调试 App 不少但要么广告铺满屏要么连数据都收不完整。SimpleBluetoothTerminal 的目标非常单纯做一个面向经典蓝牙2.x设备、基于 SPP 串口配置文件的行式终端。它不碰低功耗蓝牙BLE不搞花哨仪表盘就把连接→收发→显示这件事做到扎实。值得一提的是它的作者就是 Google Play 上知名应用 Serial Bluetooth Terminal 的开发者这个仓库是那款商业应用的简化开源版专门留给想学习蓝牙通信实现的人。换句话说你读到的不是玩具代码而是一套在真实产品里打磨过的逻辑。为什么说它是刚刚好的参考实现作为学习样本这个项目有两个很关键的优点。第一体量小到一天能读完。整个核心逻辑只有 9 个 Java 文件全部在app/src/main/java/de/kai_morich/simple_bluetooth_terminal/目录下入口MainActivity、设备列表DevicesFragment、终端界面TerminalFragment、连接管理SerialSocket、后台服务SerialService、回调接口SerialListener外加BluetoothUtil权限处理和TextUtil十六进制、控制字符转换两个工具类。没有第三方蓝牙库没有晦涩的框架Android 官方 API 就是全部依赖。第二生命周期处理是教科书级的。蓝牙连接最怕的就是界面旋转、切到后台、来电打断这些情况——很多简易实现会在这些时刻掉线或崩掉。这个项目用前台服务 事件队列的组合拳把连接和数据收发的稳定性兜住了。后面会细说它是怎么做到的。从克隆到和开发板对话走一遍最快路径环境上你需要 Android Studio、API 21 以上的 SDK、JDK 11以及一台支持蓝牙的 Android 真机模拟器一般不靠谱蓝牙栈差异太大。硬件端准备一块带 HC-05/HC-06 蓝牙模块的开发板波特率先设成 9600 或 115200跟模块默认一致即可。第一步克隆仓库git clone https://gitcode.com/gh_mirrors/si/SimpleBluetoothTerminal用 Android Studio 打开后Gradle 会自动拉取依赖主要是 AndroidX 和 Material 组件。等首次构建完成后把手机开成开发者模式、连上数据线直接点 Run。如果你只想快速看效果也可以装上之后用系统蓝牙先配对开发板再进入 App。实际使用流程只有三步打开 App会看到已配对设备的列表顶部有刷新和蓝牙设置两个入口点击目标设备界面切换到终端页状态栏会依次显示connecting...→connected底部输入框敲一条命令比如AT或LED_ON点发送上方的接收区马上会出现设备的回应。终端页右上角菜单还藏着几个实用开关Hex切换十六进制收发模式Newline选择换行符是\r\n还是\nClear清空屏幕还有一个后台通知开关用来控制在后台保持连接时是否显示常驻通知。九个 Java 文件里的三层门道看懂这个项目就等于看懂了 Android 蓝牙串口通信的标准答案。它的数据流是一条清晰的三级链SerialSocket → SerialService → 界面层。第一层SerialSocket把 RFCOMM 连接藏起来SerialSocket承担了最底层的工作。它的核心是这一行socket device.createRfcommSocketToServiceRecord(BLUETOOTH_SPP);其中BLUETOOTH_SPP是 SPP 的公认 UUID00001101-0000-1000-8000-00805F9B34FBAndroid 据此去和蓝牙模块建立 RFCOMM 通道。连接和读数据被塞进一个单线程池里执行避免阻塞 UI 线程run()方法里用一个 1024 字节的缓冲区循环读输入流读到的每一段数据都通过SerialListener回调抛给上层。断开时它会关闭 socket、注销广播接收器并忽略残留的数据——注释里写得很直白ignore remaining data and errors。第二层SerialService稳定性的灵魂这是整个项目最值得反复读的部分。SerialService是一个前台服务它解决了一个现实问题用户切到别的 App 甚至锁屏时蓝牙数据还在源源不断进来如果界面和连接绑死一切就中断了。它的设计是服务常驻界面来去自由attach / detach界面TerminalFragment可见时 attach 自己作为监听者不可见时 detach双队列缓冲界面不在时收到的数据不会丢而是进queue1/queue2暂存等界面重新挂载时一次性补发前台通知界面退到后台时创建一个常驻通知点通知能回主界面通知栏里还带一个 Disconnect 按钮可以直接断开。还有一个容易被忽略的细节接收数据用的是两个ArrayDeque双端队列做合并。注释里解释得很清楚——蓝牙数据可能以每秒上百个碎片到达但 UI 每秒钟只能刷新十几次。于是它只在队列为空时通知 UI 一次后续数据先堆进队列等 UI 消费时一次性取走把频繁的刷新请求压缩成了批量更新。TerminalFragment里也特意把接收文本的颜色设为默认色减少 Spannable 的 span 数量因为TextView 性能会随 span 数量下降。第三层界面层把字节翻译成人话TerminalFragment负责数据的人性化呈现。它做了三件小事但每一件都针对真实痛点十六进制收发TextUtil提供字节流和十六进制字符串的双向转换发送框还有HexWatcher实时格式化边输入边自动补空格控制字符转义串口设备经常回一些\r、\x01之类的不可见字符直接显示会花屏。项目用 Caret 记法把控制字符显示成^A、^M这种形式还专门处理了\r\n被拆成两段到达时的边界情况避免出现多余的^M发送换行选择不同设备对行结束符的脾气不一样有的认\r\n有的只认\n菜单里可以随时切换。顺带一提权限处理BluetoothUtil把 Android 12API 31之后的BLUETOOTH_CONNECT运行时权限请求、拒绝后的引导跳转设置页都封装好了新版系统上不至于踩点了没反应的坑。新手最容易在这四个地方翻车这个项目本身能跑通但你在自己项目里照搬或改造时有四个坑几乎人人都会踩一遍。坑一把 SPP 和 BLE 混为一谈。项目明确过滤掉了DEVICE_TYPE_LE类型的设备——它只服务经典蓝牙。如果你拿的是 BLE 模块很多新开发板默认 BLE列表里根本看不到它。需要 BLE 的话这套代码不适用得另找 GATT 方案。坑二Android 12 权限不弹窗。如果设备列表一直显示 permission missing, use REFRESH别怀疑手机坏了——新系统把蓝牙连接权限单独拆了出来BLUETOOTH_CONNECT而且首次拒绝后再次请求会走解释弹窗 → 设置页的流程。这也是BluetoothUtil存在的意义。坑三后台收不到数据。Android 8 以后对后台服务限制严格Android 13/14 又新增了通知权限POST_NOTIFICATIONS不授权的话切后台连接就可能静默死亡。Manifest 里的FOREGROUND_SERVICE系列权限和前台服务类型声明remoteMessaging|connectedDevice一个都不能少。坑四连接失败但报错信息太笼统。常见原因其实是物理层面的——模块没上电、波特率不匹配、或者设备已经被别的终端占着。连接失败时界面上会打印connection failed:加异常信息先看是不是这些老三样。这趟跑通了下一步你想把它变成什么跑通一个 demo 只是开始。这个项目的价值在于它是可生长的底座你有至少四个方向可以动手给数据加记忆把收发记录落盘做成一个带历史的调试日志工具接入协议解析在onSerialRead回调里挂上 Modbus、自定义帧协议的解码器终端立刻升级成协议分析仪改造 UI 布局现在的接收区是滚动 TextView你可以换成 RecyclerView支持复制、过滤、高亮关键词做多设备轮询在SerialService的队列机制上扩展轮流切换多个连接模拟工业现场的多机巡检。说到底一个串口终端真正让人上瘾的地方是它把看不见的字节变成了看得见的对话。你现在有了一个现成的对话窗口那么——你准备让你的开发板先开口说什么是回一句HELLO还是直接把传感器数据流倒进手机屏幕【免费下载链接】SimpleBluetoothTerminalAndroid terminal app for Bluetooth classic devices using SPP profile项目地址: https://gitcode.com/gh_mirrors/si/SimpleBluetoothTerminal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考