Arduino控制HC-05蓝牙模块：AT指令与透传模式切换全攻略

1. 项目概述：蓝牙模块的双面人生

玩过Arduino的朋友，对那个蓝色的小板子HC-05蓝牙模块肯定不陌生。它便宜、好用，是让单片机项目“无线化”的入门神器。但很多人对它的认知，可能就停留在“配对-连接-收发数据”这个固定流程上，把它当成一个简单的无线串口。如果你也是这么想的，那可能只发挥了它一半的功力。

这个项目的核心，就是彻底解锁HC-05的两种工作模式：AT指令模式和透传模式。你可以把它想象成一个人的两种状态：AT模式是“配置状态”，就像你拿着手机进入设置菜单，调整Wi-Fi名称、密码、音量大小；而透传模式是“工作状态”，就是你正常用手机聊天、看视频。HC-05在出厂时，默认处于透传模式，直接就能用。但如果你想改变它的名字、配对密码、通信速率，甚至主从角色，就必须先让它进入AT模式进行配置。

所以，“HC-05 AT Mode & Normal Mode Controller using Arduino”这个项目，本质上是一个基于Arduino的HC-05蓝牙模块模式切换与控制器。它要解决的核心问题是：如何用一块Arduino板子，既作为上位机（比如电脑或手机）的代理，又作为下位机（HC-05模块）的指挥官，灵活地在两种模式间切换，并完成复杂的参数配置。这不仅仅是接上线、发个指令那么简单，里面涉及到电压匹配、状态机控制、串口监听与转发等一系列实操细节。无论是想批量配置一批模块，还是想做一个集成蓝牙配置功能的智能设备，这个项目都能给你一套完整的、可复现的解决方案。

2. 核心思路与硬件连接解析

2.1 为什么需要Arduino作为“中间人”？

你可能会问，HC-05不是有AT指令吗？我直接用USB转TTL模块连接电脑串口工具（如Arduino IDE的串口监视器或Putty）发送AT指令不就行了？理论上可以，但实操中会遇到几个麻烦：

1. 模式切换的物理操作：让HC-05进入AT模式，通常需要在模块上电的同时，按住板载的按键（或拉高KEY引脚）。用USB转TTL模块操作时，你需要手动控制电源和按键的时序，非常不便，且容易失败。
2. 配置与应用的分离：如果你的项目最终需要Arduino通过蓝牙与手机通信，那么配置好的HC-05最终还是要接到Arduino上。如果配置过程独立于Arduino，你就需要反复插拔接线，增加了硬件损坏的风险和复杂度。
3. 自动化与集成化需求：如果你想做一个产品，设备上电后能自动检查并配置蓝牙模块参数，或者允许用户通过一个按钮就能重置蓝牙设置，那么将配置逻辑集成在Arduino程序中就是必须的。

因此，用Arduino作为“中间人”是最优雅的方案。Arduino一方面通过硬件串口（Serial）与电脑通信，接收来自电脑的配置命令；另一方面通过软件串口（SoftwareSerial）与HC-05通信，既能向HC-05发送AT指令，也能监听HC-05返回的数据。同时，Arduino的一个数字引脚可以控制HC-05的KEY引脚，实现程序化的模式切换。这样，所有操作都可以通过电脑向Arduino发送指令来完成，实现了配置流程的软硬件一体化。

2.2 硬件连接图与关键细节

正确的连接是成功的一半，这里有几个极易出错的点需要特别注意。

Arduino Uno/Nano HC-05 Bluetooth Module —————————————————————————————————————————————— 5V/VCC ——————> VCC GND ——————> GND Pin 10 ——————> TXD Pin 11 ——————> RXD Pin 9 ——————> KEY/EN

连接详解与避坑指南：

1. 电源（VCC & GND）：务必确保HC-05的VCC连接到Arduino的5V引脚。虽然有些HC-05模块标称支持3.3V逻辑，但其核心芯片和射频部分工作在3.3V，板载的LDO（低压差线性稳压器）会将输入的5V降至3.3V。如果接3.3V，可能导致供电不足，模块工作不稳定或无法启动。
2. 串口交叉连接（TX/RX）：这是串口通信的基本原则：TX（发送端）接RX（接收端）。所以Arduino的Pin 11（软件串口的RX）接HC-05的TXD；Arduino的Pin 10（软件串口的TX）接HC-05的RXD。接反了自然无法通信。
3. 关键引脚KEY：这个引脚用于控制模块的工作模式。当KEY引脚悬空或为低电平时，模块处于透传模式。当KEY引脚被拉高（接VCC，即高电平）时，模块进入AT指令模式。我们通过Arduino的Pin 9来控制它，这样就可以用程序digitalWrite(9, HIGH/LOW)来切换模式。
4. 状态引脚STATE：这个引脚通常可以忽略不接。它用于指示模块的连接状态（高电平表示已连接），对于本项目不是必需的。

重要提示：在连接和拔插任何杜邦线时，务必确保Arduino和HC-05处于断电状态。带电操作极易因瞬间短路或电压冲击损坏模块或单片机引脚。

3. 软件设计与核心代码实现

3.1 软件架构与状态机设计

整个程序的逻辑可以看作一个简单的状态机，它需要处理两个串口的数据流，并根据用户指令切换HC-05的模式。核心状态有两个：

• 命令模式：HC-05处于AT模式（KEY=HIGH）。此时，Arduino将从电脑（硬件串口）接收到的所有字符，原封不动地转发给HC-05（软件串口），同时将HC-05的回复转发回电脑。相当于一个透明的串口桥，让你可以直接和HC-05“对话”。
• 透传模式：HC-05处于正常工作模式（KEY=LOW）。此时，Arduino可以选择性地桥接两个串口，或者执行其他应用程序逻辑。

我们需要一个命令来触发模式切换。这里设计一个简单的协议：当从电脑串口接收到特定字符串（如“AT+MODE”），Arduino就执行切换KEY引脚电平、延时、重新初始化软件串口等一系列操作。

3.2 核心代码分步解析

下面是一个功能完整、注释详细的Arduino Sketch示例。我们将使用SoftwareSerial库来创建与HC-05通信的软串口。

#include <SoftwareSerial.h> // 定义引脚 #define BT_KEY_PIN 9 // 连接HC-05的KEY引脚 #define BT_RX_PIN 10 // 连接HC-05的TXD #define BT_TX_PIN 11 // 连接HC-05的RXD // 创建软件串口对象，参数为(RX, TX) SoftwareSerial BTSerial(BT_RX_PIN, BT_TX_PIN); // 全局变量，记录当前模式 bool atMode = false; // false为透传模式，true为AT指令模式 void setup() { // 初始化硬件串口（与电脑通信） Serial.begin(9600); while (!Serial) { ; // 等待串口连接（对于Leonardo等板子很重要） } Serial.println("HC-05 Controller Ready."); Serial.println("Commands: "); Serial.println(" AT+MODE : Switch to AT Command Mode"); Serial.println(" NORMAL : Switch to Normal (Pass-through) Mode"); Serial.println(" In AT Mode, type AT commands directly."); // 初始化KEY引脚为输出模式，并默认设置为低电平（透传模式） pinMode(BT_KEY_PIN, OUTPUT); setBTPassThroughMode(); // 初始化软件串口，HC-05默认透传模式波特率为9600 BTSerial.begin(9600); } void loop() { // 1. 检查电脑（硬件串口）是否有数据传来 if (Serial.available()) { String command = Serial.readStringUntil('\n'); // 读取一行命令 command.trim(); // 去除首尾空格和换行符 // 处理模式切换命令 if (command.equalsIgnoreCase("AT+MODE")) { switchToATMode(); } else if (command.equalsIgnoreCase("NORMAL")) { switchToPassThroughMode(); } else { // 如果不是切换命令，则视为要发送给HC-05的数据 // 如果在AT模式，直接转发 if (atMode) { BTSerial.println(command); // 注意：这里发送了换行符，因为大多数AT指令需要以\r\n结尾 // SoftwareSerial的println()默认发送\r\n，符合AT指令要求。 } else { // 如果在透传模式，也可以选择转发，或者做其他处理 // 这里我们选择也转发，实现双向透传 BTSerial.print(command); // 透传模式下，通常按字节原样转发，不额外加换行 } } } // 2. 检查HC-05（软件串口）是否有数据返回 if (BTSerial.available()) { // 将HC-05返回的数据，转发给电脑串口监视器 Serial.write(BTSerial.read()); } } // 函数：切换到AT指令模式 void switchToATMode() { if (atMode) { Serial.println("Already in AT Mode."); return; } Serial.println("Switching to AT Command Mode..."); // 关键步骤1：拉高KEY引脚 digitalWrite(BT_KEY_PIN, HIGH); // 关键步骤2：给HC-05一个反应时间，同时确保模块处于稳定状态 // 先关闭软串口，避免干扰 BTSerial.end(); delay(100); // 关键步骤3：重新上电（通过断开再连接VCC来模拟）？不，我们通过重新初始化串口并发送AT指令来测试。 // 更稳妥的做法：在拉高KEY后，断开再连接VCC。但硬件上不便操作。 // 替代方案：拉高KEY后，重新以AT模式波特率（通常是38400）初始化软串口。 // 注意：有些HC-05在KEY拉高后，波特率会自动切换到38400，无论之前是什么。 BTSerial.begin(38400); // 尝试以38400的波特率通信 delay(100); // 等待稳定 // 关键步骤4：发送测试指令"AT"，期待返回"OK" BTSerial.println("AT"); delay(200); // 等待HC-05响应 bool success = false; unsigned long startTime = millis(); while (millis() - startTime < 1000) { // 等待1秒 if (BTSerial.available()) { String response = BTSerial.readString(); Serial.print("HC-05 Response: "); Serial.print(response); if (response.indexOf("OK") >= 0) { success = true; break; } } } if (success) { atMode = true; Serial.println("\nSwitched to AT Mode successfully. You can now send AT commands."); Serial.println("Note: Baudrate is now 38400 for AT commands."); } else { Serial.println("\nFailed to switch to AT Mode. Please check wiring and power."); // 失败则尝试恢复 digitalWrite(BT_KEY_PIN, LOW); delay(100); BTSerial.end(); BTSerial.begin(9600); // 恢复默认波特率 } } // 函数：切换到透传模式 void switchToPassThroughMode() { if (!atMode) { Serial.println("Already in Normal (Pass-through) Mode."); return; } Serial.println("Switching to Normal Mode..."); // 关键步骤1：拉低KEY引脚 digitalWrite(BT_KEY_PIN, LOW); // 关键步骤2：结束当前软串口（可能是38400波特率） BTSerial.end(); delay(200); // 等待HC-05模式切换稳定 // 关键步骤3：以透传模式默认波特率（通常是9600）重新初始化软串口 BTSerial.begin(9600); delay(100); atMode = false; Serial.println("Switched to Normal Mode. Ready for data pass-through."); }

代码关键点解读：

1. 双串口监听：loop()函数的核心是同时监听Serial和BTSerial，任何一端收到数据，就立刻转发到另一端。这构成了双向通信的基础。
2. 模式切换的时序：这是最容易出错的地方。从透传模式切换到AT模式，必须确保KEY引脚在模块上电前或复位前就被拉高。我们的代码通过BTSerial.end()和BTSerial.begin()配合延时，模拟了一个“复位”过程。digitalWrite(BT_KEY_PIN, HIGH)后必须要有足够的延时（delay(100)），让模块内部状态稳定。
3. 波特率切换：很多HC-05模块在AT模式下，其通信波特率是固定的38400，与透传模式下的可配置波特率（默认9600）不同。因此，在switchToATMode()函数中，我们用BTSerial.begin(38400)重新初始化软串口。如果切换失败，很可能是波特率不对，可以尝试其他常见波特率如9600、19200、57600等。
4. 确认机制：切换模式后，发送一个简单的AT指令并等待OK回应，这是一个很好的确认操作，能让你在串口监视器里直观看到切换是否成功。

4. 实操流程与AT指令应用

4.1 完整操作步骤

1. 硬件连接：按照第2部分的图示，用杜邦线连接Arduino和HC-05。再三检查TX/RX是否交叉，VCC是否接5V。
2. 上传代码：将上面的代码复制到Arduino IDE中，选择正确的板卡（如Arduino Uno）和端口，点击上传。
3. 打开串口监视器：上传成功后，打开IDE的串口监视器。将右下角的波特率设置为9600（与代码中Serial.begin(9600)一致），行结束符选择“Both NL & CR”（即同时发送换行和回车，这是AT指令的标准要求）。
4. 初始状态：上电后，串口监视器会打印欢迎信息和命令提示。此时HC-05应处于透传模式（KEY=低电平）。
5. 切换到AT模式：在串口监视器顶部的输入框中，输入AT+MODE（不区分大小写），然后点击发送。你会看到“Switching to AT Command Mode...”的提示，以及HC-05返回的“OK”响应。这表明切换成功。
6. 发送AT指令：现在，你可以直接在输入框里输入任何HC-05支持的AT指令了。例如：
   • AT：测试连接，应返回OK。
   • AT+NAME?：查询当前蓝牙名称，返回+NAME:<name>。
   • AT+NAME=MyHC05：设置蓝牙名称为“MyHC05”，成功返回OK。
   • AT+PSWD?和AT+PSWD=1234：查询和设置配对密码（默认为1234）。
   • AT+UART?和AT+UART=9600,0,0：查询和设置波特率、停止位、校验位（9600,0,0表示9600波特率，1位停止位，无校验）。
   • AT+ROLE?和AT+ROLE=0：查询和设置角色（0=从机，1=主机，2=回环）。
   • AT+ADDR?：查询模块的蓝牙MAC地址。
   • AT+VERSION?：查询固件版本。
7. 切换回透传模式：输入命令NORMAL，模块将切换回透传模式，波特率也变回9600。此时，再发送AT指令将不会得到“OK”回应，因为模块不再处于指令监听状态。
8. 测试透传：在透传模式下，你可以用手机蓝牙搜索并配对“MyHC05”（或你设置的名字），输入密码“1234”。然后使用一个串口调试APP（如“蓝牙串口”或“Serial Bluetooth Terminal”），连接该模块。在手机APP和Arduino IDE的串口监视器之间互相发送消息，应该能实现双向实时通信。

4.2 常用AT指令集与参数详解

为了让你配置时心里有数，这里整理一份最常用的AT指令速查表。注意：每条指令后必须跟上回车换行（\r\n），Arduino的println()函数会自动添加。

设置参数后的保存：大部分HC-05模块在收到设置指令（如AT+NAME=...）后，参数会立即生效并保存到Flash中，无需额外保存命令。但执行AT+RESET或重新上电后，新参数才会在透传模式下完全生效。

5. 深度排查：常见问题与解决方案实录

即使按照步骤操作，你也可能会遇到各种“玄学”问题。下面是我在多次项目中踩过的坑和解决方案，这些在官方文档里可找不到。

5.1 问题一：发送“AT+MODE”后无响应或返回乱码

• 现象：发送切换命令后，Arduino串口监视器没有显示“OK”，或者显示一堆乱码字符。
• 排查思路：
  1. 检查硬件连接（再次强调）：这是90%问题的根源。用万用表测量KEY引脚在发送命令后的电压，确认是否为高电平（接近5V）。检查TX/RX线是否接反。
  2. 检查波特率：在switchToATMode()函数中，我们假设AT模式波特率是38400。但有些批次或版本的HC-05，其AT模式波特率可能是9600或19200。尝试修改代码BTSerial.begin(38400)中的波特率值，逐个尝试。
  3. 检查行结束符：确保Arduino IDE串口监视器的行结束符设置为“Both NL & CR”（\r\n）。如果只设置了“Newline”（\n），HC-05可能无法正确识别命令。
  4. 电源干扰：HC-05在发射信号时瞬时电流较大，可能引起Arduino板载电压不稳。尝试在HC-05的VCC和GND之间并联一个100μF的电解电容，进行电源滤波。
  5. 初始化延时不足：在digitalWrite(BT_KEY_PIN, HIGH)后和BTSerial.begin()前，增加delay(500)甚至更长的时间，给模块足够的状态稳定时间。

5.2 问题二：AT模式切换成功，但发送AT指令不返回“OK”

• 现象：切换模式时收到了“OK”，但随后发送AT或其他指令却无反应。
• 排查思路：
  1. 模式维持：确保在发送AT指令的整个过程中，KEY引脚始终保持高电平。检查代码逻辑，是否有其他地方意外改变了KEY引脚的状态。
  2. 软件串口冲突：SoftwareSerial库在某些Arduino板子上（特别是使用AVR芯片的）对高波特率支持不稳定。38400对于16MHz的Arduino Uno来说压力不大，但如果遇到问题，可以尝试换用AltSoftSerial库（更稳定，但占用固定引脚）或NeoSWSerial库。
  3. 指令格式：确认发送的指令是“AT”而不是“at”或“At”？虽然大部分HC-05不区分大小写，但最好用大写。确保指令后面跟了换行。
  4. 监听回复：我们的示例代码在switchToATMode()函数中只监听了一次回复。在后续的loop()中，确保atMode标志已设置为true，并且BTSerial的数据被正确转发到了Serial。可以在loop()里加一句调试代码：if (atMode) { Serial.print("["); Serial.print(millis()); Serial.println("] AT Mode Active"); }来确认状态。

5.3 问题三：透传模式下手机无法连接或连接后无法通信

• 现象：手机能搜索到蓝牙名称，但配对失败，或配对成功但APP连接后无法收发数据。
• 排查思路：
  1. 密码错误：最可能的原因。用AT指令AT+PSWD?确认当前密码。手机配对时输入的密码必须完全一致。默认是1234。
  2. 角色冲突：如果你的HC-05被设置为AT+ROLE=1（主机模式），它将尝试主动连接其他设备，而不是被连接。确保在作为从机使用时，角色是0。用AT+ROLE=0设置并复位。
  3. 波特率不匹配：手机APP和HC-05在透传模式下的通信波特率必须一致。HC-05默认是9600。如果你的APP不支持更改波特率，或者HC-05的波特率被改成了别的值（比如115200），就会导致连接后乱码或无法通信。用AT+UART?查询，并用AT+UART=9600,0,0改回9600，然后务必执行AT+RESET或重新上电。
  4. 多设备连接干扰：HC-05一次只能维持一个蓝牙连接。确保没有其他设备（比如你的电脑或其他手机）已经连接了它。
  5. APP权限问题：在手机上，确保已授予蓝牙串口APP“位置”权限（在Android上，蓝牙扫描需要此权限），并且蓝牙和GPS（定位服务）已打开。

5.4 问题四：模块异常发热或频繁断开连接

• 现象：模块摸起来烫手，或者工作时好时坏。
• 原因与解决：
  1. 电源问题：这是首要怀疑对象。使用独立的5V/1A电源适配器给Arduino供电，而不是不稳定的电脑USB口。确保电源线能提供足够电流。
  2. 接线虚焊或接触不良：特别是VCC和GND，接触电阻会导致压降和发热。检查杜邦线接头和面包板（如果使用）的接触情况。
  3. 模块损坏：如果上述都排除了，模块仍异常发热，可能是内部短路或芯片损坏。只能更换模块。

我个人在实际操作中的体会是，HC-05虽然简单，但细节决定成败。最重要的三点经验：第一，电源一定要干净、足量，一个廉价的USB线可能就是所有灵异事件的罪魁祸首；第二，模式切换的时序和波特率是两大拦路虎，耐心地通过打印调试信息，一步步确认每个阶段的状态；第三，善用AT指令查询当前状态，在遇到问题时，不要猜，用AT+NAME?、AT+UART?等指令把模块的“底细”摸清楚，很多问题就迎刃而解了。

最后再分享一个小技巧：如果你需要频繁配置多个HC-05模块，可以把这套Arduino控制器代码固化下来，做一个专用的“HC-05配置器”。甚至可以用一个旋钮开关来选择不同的预设配置（如不同的名称、密码），实现一键刷机，这会比用电脑串口工具手动操作高效得多。