HC-05 蓝牙串口通信模块，是基于 Bluetooth Specification V2.0 带 EDR 蓝牙协议的数传模块。无线工作频段为 2.4GHz ISM，调制方式是 GFSK。模块最大发射功率为 4dBm，接收灵敏度-85dBm，板载 PCB 天线，可以实现 10 米距离通信。模块采用邮票孔封装方式，模块大小 27mm×13mm×2mm，方便客户嵌入应用系统之内，自带 LED 灯，可直观判断蓝牙的连接状态。模块采用 CSR 的 BC417 芯片，支持 AT 指令，用户可根据需要更改角色（主、从模式）以及串口波特率、设备名称等参数，使用灵活。

模块来源

采购链接：

HC-05主从一体无线蓝牙模块 串口透传通讯 带清除键

规格参数

工作电压：3.6-6V

供电电流：40mA

发射功率：4dBm(最大)

参考距离：10米

控制方式：串口

管脚数量：6 Pin（2.54mm间距排针）

以上信息见厂家资料文件

移植过程

我们的目标是将例程移植至开发板上【实现手机通过蓝牙传输数据的功能】。首先要获取资料，查看数据手册应如何实现读取数据，再移植至我们的工程。

查看资料

  使用HC05蓝牙模块之前，需要知道蓝牙模块的波特率，这样我们才能控制它。将蓝牙模块与USB转TTL串口调试模块进行连接，在插入电脑之前，按住模块上的按键再通电，插入电脑通电后此时模块上的灯是慢闪，HC-05进入AT命令模式，默认波特率是38400；此模式我们叫原始模式。原始模式下一直处于AT命令模式状态。

  进入AT命令模式之后，最主要的是设置模式为从机控制，即等待手机去连接我们蓝牙模块的蓝牙，主要由手机控制。发送指令时需要注意，每一条指令都要加上\r\n或者勾选发送新行，不然是识别不到命令的。

关键指令说明

连接手机成功之后，模块上的灯进入慢闪状态，说明已经连接成功。

在手机端打开蓝牙通信软件，测试能否与电脑互传数据。

引脚选择

这里选择的引脚见引脚接线表

代码移植

下载为大家准备的驱动代码文件夹，复制到自己工程中\luban-lite\application\rt-thread\helloworld\user-bsp文件夹下

驱动代码文件夹下载

📌 资料下载中心（点击跳转）

📌 在 资料下载中心->模块移植资料下载 里面的该章节压缩包中。

提示

如果未找到 user-bsp 这个文件夹，说明你未进行模块移植的前置操作。请转移到手册使用必要操作（点击跳转）中进行必要的配置操作！！！

接下来打开自己的工程，开始修改Kconfig文件。

1、在 VSCode 中打开 application\rt-thread\helloworld\Kconfig 文件

2、在该文件的 #endif 前面添加该模块的 Kconfig路径语句

# HC05蓝牙模块
source "application/rt-thread/helloworld/user-bsp/hc05-bluetooth-module/Kconfig"

menuconfig操作

1、我们 双击 luban-lite 文件夹下的 win_env.bat 脚本打开env工具：

2、输入以下命令列出所有可用的默认配置：

scons --list-def

3、选择 d13x_JLC_rt-thread_helloworld 这个配置！这个是我们衡山派开发板的默认配置！输入以下命令即可：

scons --apply-def=7

或者

scons --apply-def=d13x_JLC_rt-thread_helloworld_defconfig

这两个命令作用是一样的，一个是 文件名 ，一个是 编号 ！！！

4、输入以下命令进入menuconfig菜单

scons --menuconfig

进入以下界面：

5、选中 Porting code using the LCKFB module

按 Y 选中

按 N 取消选中

方向键 左右 调整 最下面菜单的选项

方向键 上下 调整 列表的选项

回车 执行最下面菜单的选项

6、回车进入 Porting code using the LCKFB module 菜单

7、按方向键 上下 选中 Using infrared decoding and encoding modules 后按 Y 键，看到前面括号中出现一个 * 号，就可以下一步了。

8、按方向键 左右 选中 <Save> 然后一路回车，然后 退出 即可

编译

我们 保存并退出menuconfig菜单 之后，输入以下命令进行编译：

scons

或

scons -j16

-j 用来选择参与编译的核心数: 我这里是选择16

大家可以根据自己的电脑来选择

核心越多编译越快

如果写的数量高于电脑本身，那么就自动按照最高可用的来运行！

镜像烧录

编译完成之后会在 \luban-lite\output\d13x_JLC_rt-thread_helloworld\images 文件夹下生成一个 d13x_JLC_v1.0.0.img 镜像文件！

然后我们烧录镜像，具体的教程请查看：镜像烧录（点击跳转🚀）

到这里完成了，请移步到 最后一节 进行移植验证。

工程代码解析

bsp_bluetooth.c

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 文档网站：wiki.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 嘉立创社区问答：https://www.jlc-bbs.com/lckfb
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 */

#include <getopt.h>
#include <string.h>
#include <rtthread.h>
#include <aic_core.h>
#include <stdlib.h>
#include <sys/time.h>
#include "hal_adcim.h"
#include "rtdevice.h"
#include "aic_log.h"
#include "hal_gpai.h"
#include <stdio.h>
#include "aic_hal_gpio.h"
#include "bsp_bluetooth.h"

#define SAMPLE_UART_NAME    "uart3"                 // 串口设备名称
#define RCV_BUFF_SIZE_MAX   1024                    // 接收最大字节长度

static struct rt_semaphore rx_sem;                  // 用于接收消息的信号量
static rt_device_t serial;                          // 串口设备句柄
static rt_thread_t serial_recv_thread;              // 串口接收线程句柄

static char serial_recv_buff[RCV_BUFF_SIZE_MAX];    // 串口接收缓存区
static char serial_recv_flag;                       // 串口接收标志
static int  serial_recv_length;                     // 接收字节长度


/* ================STATE引脚=========================== */

#define HC05_DISCONNECT     0    // 蓝牙连接断开
#define HC05_CONNECT        1    // 蓝牙连接成功

#define HC05_STATE_PIN      rt_pin_get("PE.14")

#define HC05_STATE_GET()    rt_pin_read(HC05_STATE_PIN)

/*
 * 蓝牙连接状态:
 *          0 = 没有手机连接
 *          1 = 有手机连接
 */
static uint8_t HC05_Connect_Flag = 0;        // 当前状态
static uint8_t HC05_Connect_BeforeFlag = 0;  // 上一次状态

/* ================================================== */

static void delay_ms(uint64_t ms){ rt_thread_mdelay(ms); }
static void delay_us(uint64_t us){ aicos_udelay(us); }

// 中断接收回调函数
static rt_err_t uart_input(rt_device_t dev, rt_size_t size)
{
    /* 串口有数据传入后产生中断，调用此回调函数，释放信号量 */
    if (size > 0)
        rt_sem_release(&rx_sem);

    return RT_EOK;
}

// 串口接收线程入口函数
static void serial_recv_thread_entry(void *param)
{
    rt_kprintf("\nserial_recv_thread_entry run ......\n");

    while(1)
    {
        char temp_recv_buff = 0; // 接收临时缓存区

        int ret = rt_device_read(serial, 0, &temp_recv_buff, 1);

        if(ret < 0) // 出现了错误
        {
            pr_debug("read() return [%ld] %s\n", rt_get_errno(), rt_strerror(rt_get_errno()));
        }

        if(ret == 0) // 未接到数据
        {
            // 重置信号量
            rt_sem_control(&rx_sem, RT_IPC_CMD_RESET, RT_NULL);

            // 获取信号量，如果没有获取得到则阻塞在这里永远等待。
            rt_sem_take(&rx_sem, RT_WAITING_FOREVER);
        }

        if(ret == 1) // 接收到1字节的数据
        {
            // 防止数据超出缓存区的大小
            if(serial_recv_length < RCV_BUFF_SIZE_MAX - 1)
            {
                // 存入接收缓存区并递增长度
                serial_recv_buff[serial_recv_length++] = temp_recv_buff;
                // rt_kprintf("%x\n", temp_recv_buff); // 打印接收到的字节，用于调试
            }
            else
            {
                // 如果缓冲区已满，则从0开始覆盖旧数据
                serial_recv_length = 0;
                serial_recv_buff[serial_recv_length++] = temp_recv_buff;
            }

            // 为接收缓存区最后添加 '\0'
            serial_recv_buff[serial_recv_length] = '\0';

            // 设置串口接收完成标志
            serial_recv_flag = 1;
        }
    }
}


/************************************************
函数名称 ： Clear_recv_buff
功    能 ： 清空串口接收缓存区
参    数 ： 无
返 回 值 ：
作    者 ： LC
*************************************************/
static void Clear_recv_buff(void)
{
    // 清空接收缓存区
    rt_memset(serial_recv_buff, 0, sizeof(serial_recv_buff));

    // 清空标志位
    serial_recv_flag = 0;

    // 清空缓存区长度计量
    serial_recv_length = 0;
}


/************************************************
函数名称 ： serial_send_byte
功    能 ： 串口发送一个字节
参    数 ： 发送的数据
返 回 值 ： RT_EOK成功   -RT_ERROR失败
作    者 ： LC
*************************************************/
static int serial_send_byte(uint8_t dat)
{
    int ret = rt_device_write(serial, 0, &dat, 1);
    if(ret != 1)
    {
        LOG_E("Failed to [serial_send_byte] code[%d] !!!", ret);
        return -RT_ERROR;
    }

    return RT_EOK;
}

/******************************************************************
 * 函 数 名 称：HC05_Mode_Get
 * 函 数 说 明：判断蓝牙模块的连接状态
 * 函 数 形 参：无
 * 函 数 返 回：HC05_DISCONNECT 未连接
 *             HC05_CONNECT 已连接
 * 作       者：LC
 * 备       注：未连接时STATE低电平   连接成功时STATE高电平
******************************************************************/
static int HC05_Mode_Get(void)
{
    // 如果没有手机连接
    if( HC05_DISCONNECT == HC05_STATE_GET() )
    {
        //连接状态为未连接
        HC05_Connect_Flag = HC05_DISCONNECT;

        //如果之前是连接状态
        if( HC05_Connect_BeforeFlag == HC05_CONNECT )
        {
            HC05_Connect_BeforeFlag = HC05_DISCONNECT; // 修改状态

            rt_kprintf("\nSystem : HC-05 Bluetooth is disconnected !!\n");
        }

        return HC05_DISCONNECT;
    }

    // 如果手机已经连接
    if( HC05_CONNECT == HC05_STATE_GET() )
    {
        //连接状态为连接
        HC05_Connect_Flag = HC05_CONNECT;

        //如果之前是断开状态
        if( HC05_Connect_BeforeFlag == HC05_DISCONNECT )
        {
            HC05_Connect_BeforeFlag = HC05_CONNECT; // 修改状态

            rt_kprintf("\nSystem : HC-05 Bluetooth connected !!\n");
        }

        return HC05_CONNECT;
    }
}


/************************************************
函数名称 ： HC05_Send_DATA
功    能 ： HC05发送字符串
参    数 ： data_buff缓存区地址
返 回 值 ： RT_EOK成功   -RT_ERROR失败
作    者 ： LCKFB
*************************************************/
int HC05_Send_DATA(uint8_t *data_buff)
{
    int err_count = 0;

    /* 如果蓝牙未连接 */
    if(HC05_DISCONNECT == HC05_Mode_Get())
    {
        return -RT_ERROR;
    }

    /* 地址为空 或者 值为空 跳出 */
    while(data_buff && *data_buff)
    {
        if(RT_EOK != serial_send_byte(*data_buff++))
        {
            err_count++;
            continue;
        }
    }

    /* 如果err_count不为0，则说明发送的时候有错误！！！ */
    if(err_count)
    {
        LOG_E("serial_send_string failed !!!");
        return -RT_ERROR;
    }

    return RT_EOK;
}


/******************************************************************
 * 函 数 名 称：HC05_Recv_DATA
 * 函 数 说 明：接HC05模块的数据
 * 函 数 形 参：data_buff数据缓存区
 * 函 数 返 回： 0：  未接收到数据
 *             其他： 接收到的数据长度
 * 作       者：LCKFB
 * 备       注：无
******************************************************************/
int HC05_Recv_DATA(uint8_t *data_buff)
{
    int i;

    /* 如果蓝牙未连接 */
    if(HC05_DISCONNECT == HC05_Mode_Get())
    {
        return 0;
    }

    /* 判断是否接到了数据 */
    if((serial_recv_flag != 1) || (serial_recv_length == 0))
    {
        /* 未接到 */
        return 0;
    }

    /* 将数据转存到指针指向的地址中 */
    for(i = 0; i < serial_recv_length; i++)
    {
        data_buff[i] = serial_recv_buff[i];
    }

    /* 加入字符串结尾 */
    data_buff[i] = '\0';

    /* 清除接收的数据、标志位和数据长度。 */
    Clear_recv_buff();

    return i; // 返回接收到的数据长度
}

/************************************************
函数名称 ： HC05_Init
功    能 ： 模块初始化
参    数 ： 无
返 回 值 ： RT_EOK成功   -RT_ERROR失败
作    者 ： LCKFB
*************************************************/
int HC05_Init(void)
{
    int ret = 0;

    // 清空接收缓存区
    rt_memset(serial_recv_buff,0,sizeof(serial_recv_buff));

    // 清空标志位
    serial_recv_flag = 0;

    // 清空缓存区长度计量
    serial_recv_length = 0;

    rt_kprintf("Try to open(%s)\n", SAMPLE_UART_NAME);

    // 获取串口句柄
    serial = rt_device_find(SAMPLE_UART_NAME);
    if (!serial)
    {
        LOG_E("find %s failed!\n", SAMPLE_UART_NAME);

        return -RT_ERROR;
    }

    // 初始化信号量
    ret = rt_sem_init(&rx_sem, "rx_sem", 0, RT_IPC_FLAG_FIFO);
    if (ret != RT_EOK)
    {
        LOG_E("failed to rt_sem_init !\n");
        return -RT_ERROR;
    }

    // 打开串口设备
    ret = rt_device_open(serial, RT_DEVICE_FLAG_INT_RX);
    if (ret != RT_EOK)
    {
        LOG_E("open %s failed : %d !\n", SAMPLE_UART_NAME, ret);
        return -RT_ERROR;
    }

    // 设置接收回调函数
    rt_device_set_rx_indicate(serial, uart_input);

    // 创建串口数据接收线程
    serial_recv_thread = rt_thread_create("serial", serial_recv_thread_entry, RT_NULL, 1024*2, 15, 20);
    if (serial_recv_thread != RT_NULL)
    {
        // 启动线程
        rt_thread_startup(serial_recv_thread);
    }
    else
    {
        rt_device_close(serial);
        LOG_E("Failed to [rt_thread_create] !!!");
        return -RT_ERROR;
    }

    /* state引脚输入模式设置 */
    rt_pin_mode(HC05_STATE_PIN, PIN_MODE_INPUT);

    /* 标志位重置 */
    HC05_Connect_Flag = HC05_DISCONNECT;
    HC05_Connect_BeforeFlag = HC05_DISCONNECT;

    return RT_EOK;
}

/************************************************
函数名称 ： HC05_DeInit
功    能 ： 清空模块初始化
参    数 ： 无
返 回 值 ： RT_EOK成功   -RT_ERROR失败
作    者 ： LCKFB
*************************************************/
int HC05_DeInit(void)
{
    int ret = RT_EOK;

    rt_kprintf("\nHC05_DeInit Run........\n");

    ret = rt_thread_delete(serial_recv_thread);
    if(ret != RT_EOK)
    {
        LOG_E("rt_thread_delete failed!!!");
        return ret;
    }

    ret = rt_device_close(serial);
    if(ret != RT_EOK)
    {
        LOG_E("rt_device_close failed!!!");
        return ret;
    }

    ret = rt_sem_detach(&rx_sem);
    if(ret != RT_EOK)
    {
        LOG_E("rt_sem_detach failed!!!");
        return ret;
    }

    rt_kprintf("\nHC05 DeInit successful!!\n");

    return RT_EOK;
}

bsp_bluetooth.h

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 文档网站：wiki.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 嘉立创社区问答：https://www.jlc-bbs.com/lckfb
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 */

#ifndef __BSP_BLUETOOTH_H__
#define __BSP_BLUETOOTH_H__

#include <getopt.h>
#include <string.h>
#include <rtthread.h>
#include <aic_core.h>

int HC05_Init(void);     // 模块初始化
int HC05_DeInit(void);   // 清除模块的初始化

int HC05_Send_DATA(uint8_t *data_buff);   // 发送数据
int HC05_Recv_DATA(uint8_t *data_buff);   // 收到数据

#endif

Kconfig

这个是一个menuconfig中的选项，如果在菜单中选中该选项，就会在rtconfig.h中定义一个语句，用来if判断条件编译之类的。

config LCKFB_HC05_BLUETOOTH_MODULE
    bool "Using HC-05 Bluetooth module"
    select AIC_USING_UART3
    default n
    help
        More information is available at: https://wiki.lckfb.com/

SConscript

自动化构建文件，如果定义了 LCKFB_HC05_BLUETOOTH_MODULE 和 USING_LCKFB_TRANSPLANT_CODE 就自动编译当前目录下的文件！！

Import('RTT_ROOT')
Import('rtconfig')
import rtconfig
from building import *

cwd = GetCurrentDir()
CPPPATH = [cwd]
src = []


if GetDepend('LCKFB_HC05_BLUETOOTH_MODULE') and GetDepend('USING_LCKFB_TRANSPLANT_CODE'):
    src = Glob(os.path.join(cwd, '*.c'))

group = DefineGroup('lckfb-hc05-bluetooth-module', src, depend = [''], CPPPATH = CPPPATH)

Return('group')

test_hc05_bluetooth_module.c

这个文件定义了一个处理HC05蓝牙模块的线程，初始化了蓝牙模块的板级支持包（BSP），并设置了线程的优先级、栈大小和时间片。

线程的主要任务是循环接收HC05蓝牙模块的数据，并将接收到的数据打印到控制台。同时，线程还会周期性地发送一条固定的消息到HC05蓝牙模块。

线程入口函数逻辑

• 打印一条消息表示线程开始运行。
• 在一个无限循环中，首先尝试从HC05蓝牙模块接收数据。
• 定义一个整型变量count用于记录接收到的数据长度，并定义一个recv_buff缓冲区用于存储接收到的数据。
• 调用HC05_Recv_DATA函数获取接收到的数据长度，并存储到recv_buff中。
• 检查接收到的数据长度是否超过缓冲区大小，如果超过则打印错误信息并限制数据长度。
• 如果接收到数据，则将其打印到控制台。
• 调用HC05_Send_DATA函数发送一条固定的消息到HC05蓝牙模块。
• 在每次循环结束时，线程会挂起一段时间，这里是1000毫秒。

此外，该文件还定义了两个命令，test_hc05_bluetooth_module和test_exit_hc05_bluetooth_module，它们分别用于启动和退出HC05蓝牙模块线程。

• test_hc05_bluetooth_module命令首先调用HC05_Init函数来初始化HC05蓝牙模块。如果初始化成功，则创建并启动一个名为hc05_thread的线程，该线程将执行hc05_thread_entry函数。
• test_exit_hc05_bluetooth_module命令用于删除hc05_thread线程，从而退出蓝牙模块的数据处理循环，并打印退出成功的消息。在退出之前，它会调用HC05_DeInit函数来反初始化蓝牙模块。如果删除线程或反初始化蓝牙模块失败，将打印错误信息。

通过在命令行中输入test_hc05_bluetooth_module，用户可以启动HC05蓝牙模块的数据处理线程，并且每当数据被接收或发送时，都会在控制台上看到相应的输出信息。输入test_exit_hc05_bluetooth_module命令可以退出数据处理线程。

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 文档网站：wiki.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 嘉立创社区问答：https://www.jlc-bbs.com/lckfb
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 */

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <getopt.h>
#include <sys/time.h>
#include <rtthread.h>
#include "rtdevice.h"
#include "aic_core.h"
#include "aic_hal_gpio.h"
#include "bsp_bluetooth.h"

#define THREAD_PRIORITY         25      // 线程优先级
#define THREAD_STACK_SIZE       4096    // 线程大小
#define THREAD_TIMESLICE        20      // 时间片

static rt_thread_t hc05_thread = RT_NULL;   // 线程控制块

// 线程入口函数
static void hc05_thread_entry(void *param)
{
    rt_kprintf("Start hc05_thread_entry...\n");

    while(1)
    {
        /*============================Recv==============================*/

        int count = 0;

        /* 接收缓存区 */
        uint8_t recv_buff[128] = {0};

        /* 获取接收到的数据长度 */
        count = HC05_Recv_DATA(recv_buff);

        /* 确保 count 不超过 recv_buff 大小，避免越界访问 */
        if (count > sizeof(recv_buff))
        {
            LOG_E("Error: Received data exceeds buffer size! count = %d",count);
            count = sizeof(recv_buff);  // 限制数据长度避免溢出
        }

        if (count > 0)
        {
            rt_kprintf("\nRead Data = %s\n", recv_buff);
        }

        /*============================Send==============================*/

        /* 发送数据 */
        HC05_Send_DATA((uint8_t *)"立创·衡山派D133EBS开发板");

        /*=============================END==============================*/

        /* 延迟 1000 毫秒 */
        rt_thread_mdelay(1000);
    }
}



static void test_hc05_bluetooth_module(int argc, char **argv)
{
    int ret = HC05_Init();          // 模块初始化
    if(ret != RT_EOK)
    {
        LOG_E("Failed to [HC05_Init] !!!");
        LOG_E("file: %s line: %d", __FILE__, __LINE__);
        return;
    }
    rt_kprintf("HC05_Init run END!!\n");

    /* 创建线程，名称是 hc05_thread，入口是 hc05_thread_entry */
    hc05_thread = rt_thread_create("hc05_thread",
                            hc05_thread_entry, RT_NULL,
                            THREAD_STACK_SIZE,
                            THREAD_PRIORITY, THREAD_TIMESLICE);

    /* 如果获得线程控制块，启动这个线程 */
    if (hc05_thread != RT_NULL)
        rt_thread_startup(hc05_thread);

    rt_kprintf("test_hc05_bluetooth_module run END!!\n");
}
// 导出函数为命令
MSH_CMD_EXPORT(test_hc05_bluetooth_module, test hc05 bluetooth);


// 退出测试线程
static void test_exit_hc05_bluetooth_module(void)
{
    int ret = rt_thread_delete(hc05_thread);
    if(ret != RT_EOK)
    {
        LOG_E("failed to rt_thread_delete !!");
        return;
    }
    else
    {
        rt_kprintf("\n========hc05 bluetooth exit successful !!========\n");
    }

    ret = HC05_DeInit();
    if(ret != RT_EOK)
    {
        LOG_E("failed to HC05_DeInit !!");
        return;
    }

    rt_kprintf("thread EXIT successful !!\n");
}
// 导出函数为命令
MSH_CMD_EXPORT(test_exit_hc05_bluetooth_module, exit Infrared encoding and decoding);

移植验证

我们使用串口调试，将 USB转TTL模块 连接到衡山派开发板上面！！

具体的教程查看：串口调试（点击跳转🚀）

串口波特率默认为115200

我们在输入下面的命令运行该模块的线程：

输入的时候按下TAB键会进行命令补全！！

test_hc05_bluetooth_module

模块上电效果：

模块代码下载

链接：下载中心->模块移植代码下载（点击跳转🚀）