企业官网建设流程全解析

简介：围绕正点原子 ATK-HC05 蓝牙模块整理的一套技术资料，目标读者是使用 STM32 微控制器开发无线通信功能的电子工程师与嵌入式爱好者。ATK-HC05 基于 Bluetooth V2.0+EDR 标准，可通过 UART、SPI、I2C 等串行接口与主控连接，适用于物联网节点、智能家居控制、工业数据采集等场景。资源以 zip 压缩包形式交付，约 33.2MB，内容以硬件设计原理图、PCB 布局与天线优化技巧、AT 命令集详解（包括工作模式、配对连接、数据速率等参数配置）、STM32 的 C/C++ 接口编程示例，以及设备发现、配对验证、连接建立等完整流程说明，并附带常见连接问题的故障排查指南。已有 2058 人学习/下载，对希望快速掌握蓝牙模块选型、电路接入与驱动调试的开发者来说，是一份能直接参考的实操性资料。

1. 一块蓝牙模块卡住整个调试进度的日子，从 ATK-HC05 开始

调试STM32串口的时候，最容易被忽略的反而是通信链路里最“黑盒”的那一段。很多人在PC上明明把串口助手调通了，程序一下到板子就收不到数据；还有人把HC-05和STM32的USART对接之后，AT指令发过去全是乱码，最后发现是电平不匹配或者波特率没对上。正点原子的ATK-HC05模块就是为解决这类问题常被选用的方案之一——它把HC-05的底板、按键、指示灯和电平转换电路都集成好了，接上4根线就能用，比裸模块省掉一堆硬件功夫。这篇文章顺着ATK-HC05的选型、AT指令集、STM32移植和排错顺序展开，目标是让新手照着接就能通，让老手在看参数和踩坑部分也有收获。核心解决的是“蓝牙模块怎么使用”和“连接不上时从哪里查起”这两件事。

2. ATK-HC05 的硬件底子与选型判断：为什么这块板子适合直接上手

2.1 从 HC-05 到 ATK-HC05，模块本身改了什么

市面上大量蓝牙模块都以HC-05为原型，但正点原子的ATK-HC05不是单纯把HC-05引脚引出来，而是做成了一块带底板的最小系统板。底板上集成了稳压芯片、电平转换电路、按键（KEY）、状态指示灯（LED）和板载天线。这意味着你不必自己搭分压电阻去匹配3.3V和5V电平，也不需要外接按键来切换AT模式——底板上已经把这些硬件逻辑接好了。对于STM32用户来说，这直接省掉了电路设计里最容易出问题的一环：蓝牙模块的TXD/RXD电平与MCU的GPIO电平不一致导致的通信失败。

模块核心是CSR主流蓝牙芯片方案，支持蓝牙2.0+EDR，协议栈里带SPP（串口透传协议）。SPP协议的价值在于：它把蓝牙无线链路抽象成一个虚拟串口，对上层应用来说，你往串口写什么，对端就收到什么，不需要自己处理蓝牙协议栈。这一点正是HC-05能成为嵌入式调试利器的根本原因。ATK-HC05在底板上把状态指示也做清楚了：LED快闪表示可配对、慢闪表示已连接。通过这两个LED状态你就能初步判断模块当前处于什么工作阶段，不必每次都接串口看返回。

2.2 主从模式与 AT 指令集：模块的行为由指令决定

ATK-HC05支持主模式、从模式和回环模式三种工作方式。回环模式主要用于自测，数据从串口发进去会原路返回；主模式由模块主动发起连接，从模式等待被连接。模块上电默认是AT模式还是透传模式，取决于KEY引脚的电平状态——KEY拉高时进入AT命令模式，此时串口收到的是AT指令而非透传数据；KEY拉低或悬空时才进入数据透传模式。这个设计在底板上通过一个按键实现，按下按键再上电，就能进入AT模式。

AT指令集的操作逻辑跟普通串口设备一致：发一条指令，模块回一条结果。常用的有AT（测试通信）、AT+NAME（设置名称）、AT+PSWD（设置配对密码）、AT+UART（设置串口波特率）、AT+ROLE（设置主从角色）、AT+CMODE（设置连接模式）。这些指令的返回值通常是OK或ERROR，通过串口助手或MCU的串口中断都能观察。需要特别注意的是，HC-05在AT模式下默认波特率是38400，而数据透传模式的默认波特率是9600，两者不一致是新手最容易踩的坑。

2.3 参数速查：一页纸看完主要配置项

选型判断上，如果你的项目只需要向上位机传数据、不需要双机通信，从模式加手机蓝牙串口助手就够了；如果要做两个MCU之间的无线数据交换，就把一个设为主、一个设为从。这块模块最大的优势是资料齐全——正点原子在探索者和精英板等系列开发板的教程里都给了配套例程，电路图、寄存器配置可以直接拷到自己的工程里用。对于赶项目进度的场景，能省去四处找手册的麻烦。

3. STM32 与 ATK-HC05 的接线与 AT 指令配置实战

3.1 硬件连接：四根线解决电平与串口映射

ATK-HC05底板上的接口分别是VCC、GND、TXD、RXD和KEY。VCC接5V、GND接GND，TXD接STM32的USART RX引脚，RXD接STM32的USART TX引脚。因为底板上已经有电平转换，STM32的3.3V GPIO可以直接和模块的5V逻辑互连，不需要外接分压电阻。KEY引脚在底板上连接了按键，按键按下时KEY拉高，松开后恢复低电平。

在接线时要注意串口引脚映射。以STM32F103系列为例，如果使用USART1，PA9是TX、PA10是RX；如果使用USART2，PA2是TX、PA3是RX。用哪组串口就能在CubeMX或标准库初始化里配置对应的GPIO。常见做法是默认用USART1，因为它和ST-Link的虚拟串口不冲突，而且很多开发板例程都默认走这个口。模块的TXD接MCU的RX、RXD接MCU的TX，这是交叉连接，不要接成同向。接反的结果是AT指令发出去没有任何返回，或者返回乱码。

3.2 用串口助手先把模块调明白，再写单片机代码

很多人一上来就直接在STM32里写蓝牙驱动，调不通时很难判断是模块问题还是代码问题。更稳妥的顺序是：先用USB转TTL模块把ATK-HC05接到电脑上，在串口助手里把所有参数配好，确认模块工作正常，再写STM32的代码。这个步骤能帮你把问题隔离在“模块”和“单片机”两个域里，排错范围缩小一半。

USB转TTL和模块的连接方式和STM32一样：转换器的TXD接模块的RXD、RXD接模块的TXD、VCC接5V、GND共地。注意USB转TTL模块的输出电平一般也是3.3V或5V，ATK-HC05底板兼容这两种。打开串口助手后，先按下底板按键再给模块上电，确保模块进入AT模式。然后按如下顺序执行指令：

AT OK AT+NAME=MyDevice OK AT+PSWD=8888 OK AT+UART=115200,0,0 OK AT+ROLE=0 OK

参数说明：AT+UART=115200,0,0中第二个参数表示停止位，0为1位停止位；第三个参数表示校验位，0为无校验。如果你的STM32串口初始化用的不是8N1（8数据位无校验1停止位），这里的参数要对应修改。配置完AT+UART后模块的AT模式波特率会立刻切换成115200，串口助手这边也要同步修改，否则后续指令会失效。

3.3 在 STM32 里实现 AT 指令的下发与返回解析

#include "stm32f1xx_hal.h" #include <string.h> #include <stdio.h> UART_HandleTypeDef huart1; char rx_buffer[128]; uint8_t rx_index = 0; void Bluetooth_SendCommand(char *cmd) { HAL_UART_Transmit(&huart1, (uint8_t *)cmd, strlen(cmd), 1000); HAL_Delay(200); } void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart->Instance == USART1) { // 把收到的字符存入缓冲区，并在收到换行符时截断 if (rx_index < sizeof(rx_buffer) - 1) { rx_buffer[rx_index++] = rx_char; if (rx_char == '\n') { rx_buffer[rx_index] = '\0'; rx_index = 0; // 在这里比对 OK 或 ERROR } } } }

代码逻辑说明：Bluetooth_SendCommand负责把AT指令通过串口发出，HAL_Delay(200)给模块留出处理时间，避免指令发出后紧接着读返回数据读到空缓冲。中断回调HAL_UART_RxCpltCallback在每次收到一个字节时触发，把数据累积到rx_buffer中，遇到换行符\n时把缓冲区结束并清零索引，方便后续用strstr(rx_buffer, "OK")判断模块是否返回成功。这里的rx_char需要在初始化时用HAL_UART_Receive_IT注册：

HAL_UART_Receive_IT(&huart1, &rx_char, 1);

每处理完一个字节后，需要重新调用一次HAL_UART_Receive_IT来准备接收下一个字节，否则中断只会触发一次。这是HAL库常见的遗漏点，很多人发现只收到一个字符后就再也收不到数据了，原因就在这里。参数方面，huart1的波特率在MX初始化中配置为115200（如果前面AT指令设置了115200），数据位8、停止位1、无校验，与AT指令配置保持一致。

3.4 用状态机思想处理蓝牙模块的返回数据

在实际项目中，AT指令的返回往往不是一个完整的“OK\n”一次性到达，而是分多个字节陆续进入串口中断。如果每个字节都触发一次回调，那在回调里直接做字符串匹配很容易失败。常见做法是维护一个简单状态机：空闲状态下等待指令发出，收到字符后进入累积状态，直到收到\n再进入判断状态。判断完OK或ERROR后回到空闲状态。

typedef enum { BLUETOOTH_IDLE, BLUETOOTH_WAIT_RESPONSE, BLUETOOTH_RESPONSE_OK } BluetoothState; BluetoothState bluetooth_state = BLUETOOTH_IDLE; void Bluetooth_ProcessByte(char c) { if (bluetooth_state == BLUETOOTH_WAIT_RESPONSE) { if (c == '\n') { if (strstr(rx_buffer, "OK") != NULL) { bluetooth_state = BLUETOOTH_RESPONSE_OK; } else { bluetooth_state = BLUETOOTH_IDLE; } rx_index = 0; } else { rx_buffer[rx_index++] = c; } } }

这种状态机的好处是代码可读性好、扩展方便——以后要支持AT+NAME的返回名称解析，只需要在状态判断里增加对特定返回前缀的匹配分支。相比在中断回调里直接处理业务逻辑，状态机方式也让调试时可以单步跟踪模块的响应过程。

4. 数据透传调试与 HC-05 连接不上的经典排查路径

4.1 模块连不上手机或电脑时，按顺序查这几个点

HC-05蓝牙模块连接不上是搜索热词里出现频率最高的问题，但大多数情况下并非模块损坏，而是配置或操作顺序有误。按照下面的顺序排查，通常能在十分钟内定位问题。先看LED状态：快闪（大约每秒2次）说明模块处于可搜索状态，慢闪（大约每2秒1次）说明已有设备连接。如果LED完全不亮，先查电源；如果常亮不闪，检查是否意外进入了AT模式。

接下来检查引脚连接。TXD和RXD是否交叉连接是第一个怀疑对象，其次是共地问题。很多人把模块和USB转TTL或STM32开发板连接时忘记共地，结果串口完全没有反应。再查波特率——这是最隐蔽的问题。默认透传波特率是9600，但AT模式下是38400（如果之前被改过，则以上次设置的值为准）。如果在AT模式下用9600发AT指令，返回的必然是乱码。

4.2 手机搜不到模块时，改动这两个参数

手机搜不到ATK-HC05或者搜到了连不上，绝大多数情况出在AT+CMODE和AT+PSWD这两个参数上。AT+CMODE默认是1，即允许任意蓝牙地址连接，这个值适合手机配对场景。如果你之前为了双机通信把它改成了0（指定地址连接），手机自然无法连接。改回1即可：

AT+CMODE=1 OK

配对密码的问题更常见。默认密码是1234，但如果你之前执行过AT+PSWD修改密码，手机端需要输入新密码。还有个细节是：部分安卓手机的蓝牙协议栈对2.0设备的PIN码输入弹窗有时不显示，需要在手机蓝牙设置里先取消配对再重新搜索。iPhone对HC-05这类经典蓝牙模块的兼容性整体不如安卓——iOS的BLE和经典蓝牙是分开的，HC-05走的是SPP经典蓝牙，iPhone需要MFi认证设备才能直连，所以调试时优先用安卓手机加蓝牙串口助手的组合。

4.3 串口有数据但全是乱码，问题通常不在模块

AT指令返回乱码时，很多人第一反应是模块坏了，但实际原因多半在串口参数不匹配。排查时先把串口助手接收区的显示格式调成HEX，看一下收到的数据是什么。如果收到的是4F 4B 0D 0A，这就是OK\r\n的ASCII码——说明模块正常，只是显示格式或编码设置问题。如果字节完全无规律，优先怀疑波特率错误。HC-05对波特率误差比较敏感，USB转TTL使用的晶振精度不够时，115200下也可能出现偶发乱码。遇到这种情况，把波特率降到9600或38400，通常就能稳定通信。

另一个乱码来源是串口助手的DTR/RTS信号干扰。部分USB转TTL模块默认开启了DTR/RTS自动复位功能，连接ESP8266等模块时这会造成复位，连接HC-05时则可能干扰模块的KEY引脚状态。在串口助手里关闭DTR和RTS选项，再重新打开串口，可以解决相当一部分“上电后乱码”问题。调试HC-05时，同时也把串口关闭重开一次，让模块重新上电进入稳定状态。

4.4 STM32 端发送 AT 指令无响应的三处代码级检查

代码层面导致AT指令无响应，最常见的三个原因分别是：串口时钟未使能、GPIO复用配置错误、串口中断优先级设置导致数据丢失。第一点在CubeMX生成的代码里通常不会出错，但标准库手动初始化时容易遗漏：

__HAL_RCC_USART1_CLK_ENABLE(); __HAL_RCC_GPIOA_CLK_ENABLE();

第二点经常发生在引脚复用模式配置上。USART1_TX要配置为GPIO_MODE_AF_PP（复用推挽输出），RX要配置为GPIO_MODE_INPUT或GPIO_MODE_AF_IN并带上拉。如果初学者把TX配置成了普通推挽输出，会导致发送时电平不对，模块收不到完整数据。第三点比较隐蔽：如果串口中断优先级和SysTick或其他外设相同，在高频中断场景下可能丢失接收字节。把USART中断优先级设置得比定时器等外设高，能明显减少丢字节概率。

5. 进阶技巧：用按键进入 AT 模式，把模块参数固化到产品里

5.1 开发态和运行态的切换逻辑

ATK-HC05底板的KEY按键在开发调试时用来进入AT模式，但在量产或嵌入式集成场景里，你不会希望每次上电都要手动按键才能改参数。常见做法是：用MCU的一个GPIO控制KEY引脚的默认电平，上电后先让GPIO输出高电平，让模块进入AT模式，MCU完成参数配置后把GPIO拉低，模块自动进入透传模式。这样实现了“上电即配置，配置完即运行”的无人工干预流程。

void Bluetooth_InitWithAT(void) { HAL_GPIO_WritePin(KEY_GPIO_Port, KEY_Pin, GPIO_PIN_SET); // 拉高KEY进入AT模式 HAL_Delay(500); // 等待模块启动进入AT状态 Bluetooth_SendCommand("AT+ROLE=0\r\n"); Bluetooth_SendCommand("AT+CMODE=1\r\n"); Bluetooth_SendCommand("AT+UART=115200,0,0\r\n"); HAL_GPIO_WritePin(KEY_GPIO_Port, KEY_Pin, GPIO_PIN_RESET); // 拉低KEY进入透传 HAL_Delay(200); }

这段代码的关键在于时序：KEY拉高后模块上电，需要等待约500ms让模块完成初始化和AT模式切换；发送AT指令后每句之间也留了延时；全部配置完成后拉低KEY，模块会重新检测KEY状态并切换到透传模式。不同版本的HC-05模组对KEY的响应时间有微小差异，如果500ms不够稳定，可以适当加大到1秒。这个思路在需要批量配置模块参数的产线场景里也适用——用一个STM32的最小系统板做一个“蓝牙模块参数烧录器”，比手动按键和串口助手操作快得多。

5.2 验证模块参数是否配置成功的最快方法

配置完成后的验证方法，不应该靠“感觉好像连上了”，而是要做一次实际的数据回环测试。

1. 手机或另一个HC-05作为对端连接ATK-HC05。
2. 连接成功后，用串口助手或STM32向模块发送一段固定的测试字符串，如ATK-HC05-TEST。
3. 在手机串口助手或对端模块的串口端查看是否完整收到相同字符串。
4. 反向再发一次，确认双向通路都正常。
5. 如果只有单向通，检查发送端的串口TX是否正常初始化，接收端的RX中断是否开启。

这个测试完成后，再检查模块参数是否固化生效：断电重新上电，先用串口发送AT+NAME?查询模块名称，如果返回的还是你配置的名字，说明参数已经写入模块的Flash。这里有个技巧：ATK-HC05这类模块的AT指令中，在指令后加?可以查询当前值，比如AT+UART?返回当前波特率配置，AT+ROLE?返回主从角色。利用查询指令可以在不改动参数的前提下确认模块当前状态，比直接盲改参数安全得多。

5.3 掉坑提醒：恢复默认参数的正确姿势

HC-05的恢复默认参数操作，网上说法很多，最可靠的方式是：按住底板按键上电进入AT模式，发送AT+ORGL恢复出厂设置。这个指令会把波特率、名称、密码、主从角色全部重置为出厂值。执行后模块会恢复为从模式、名称HC-05、密码1234、波特率9600（透传）/38400（AT）。如果你的模块执行AT+ORGL后串口助手突然收不到返回了，大概率是波特率已经变回默认值，把你串口助手的波特率从115200改成38400再试一次，就能看到OK的返回了。

如果AT+ORGL也无法解决问题，比如模块完全不响应或进入异常状态，最后的恢复手段是利用底板上的复位引脚（如果有引出）或对整个模块断电等待10秒再上电。ATK-HC05底板设计得比较皮实，一般不会因为AT指令配置错误而永久损坏。真正损坏的原因通常是电源问题——USB转TTL模块的供电能力不足，连接手机或电脑时电压被拉低，导致模块反复重启。这种情况下换一个单独供电的5V电源，就能解决大部分“模块莫名其妙不工作”的问题。

本文还有配套的精品资源，点击获取