bt_mx01软件包

1.简介

bt_mx01 软件包是低功耗蓝牙模块MX-01的驱动包。MX-01蓝牙模组是一款支持低功耗蓝牙协议的串口透传模组，其仅支持工作在从机模式；模组具有小体积、高性能、高性价比、低功耗、平台兼容性强等优点；可以帮助用户快速掌握蓝牙技术，加速产品开发；模组已兼容的软件平台包括：IOS 应用程序、 Android 应用程序、微信小程序等。MCU 通过串口连接模组，可与手机、平板等设备进行数据通讯，轻松实现智能无线控制和数据采集；模组广泛应用在智能家居、共享售货机等领域。

1.1目录结构

bt_mx01 软件包目录结构如下所示：

bt_mx01
├───inc                             // 头文件目录
│   └───bt_mx01.h                   // API接口头文件
├───src                             // 源码目录
│   |   bt_mx01.c                   // 源文件
│   └───bt_mx01_sample.c            // 从机示例源文件
│   license                         // 软件包许可证
│   readme.md                       // 软件包使用说明
└───SConscript                      // RT-Thread 默认的构建脚本

1.2许可证

bt_mx01 package 遵循 LGPLv2.1 许可，详见 LICENSE 文件。

1.3依赖

• RT_Thread 4.0
• uAT

2.使用

2.1接口函数说明

配置参数项定义如下：

typedef struct{
    const char *serial;     //串口设备名
    int sleep;              //休眠控制引脚
    int fifo_size;          //FIFO尺寸
    bt_power_t power;       //蓝牙功率
}bt_cfg_t;

bt_dev_t bt_create(const char *name, const bt_cfg_t *cfg);

• 功能 ：创建蓝牙设备
• 参数 ：name--蓝牙设备的名称
• 参数 ：cfg--蓝牙工作参数配置指针
• 返回 ：成功返回蓝牙设备指针，失败返回NULL

void bt_destory(bt_dev_t dev);

• 功能 ：销毁蓝牙设备
• 参数 ：dev--蓝牙设备指针
• 返回 ：无

int bt_open(bt_dev_t dev);

• 功能 ：打开蓝牙设备
• 参数 ：dev--蓝牙设备指针
• 返回 ：0-成功，<0-错误

int bt_close(bt_dev_t dev);

• 功能 ：关闭蓝牙设备
• 参数 ：dev--蓝牙设备指针
• 返回 ：0-成功，<0-错误

int bt_read(bt_dev_t dev, int pos, void *buf, int bufsize);

• 功能 ：从蓝牙设备读取接收数据
• 参数 ：dev--蓝牙设备指针
• 参数 ：pos--位置偏移，本参数未使用
• 参数 ：buf--数据缓冲区指针
• 参数 ：bufsize--缓冲区尺寸
• 返回 ：>=0-读取数据长度，<0-错误

int bt_write(bt_dev_t dev, int pos, void *buf, int size);

• 功能 ：向蓝牙设备写入发送数据
• 参数 ：dev--蓝牙设备指针
• 参数 ：pos--位置偏移，本参数未使用
• 参数 ：buf--数据缓冲区指针
• 参数 ：size--数据尺寸
• 返回 ：>=0-写入数据长度，<0-错误

int bt_control(bt_dev_t dev, int cmd, void *args);

• 功能 ：控制蓝牙设备
• 参数 ：dev--蓝牙设备指针
• 参数 ：cmd--命令码
• 参数 ：args--命令参数表
• 返回 ：0-成功，<0-错误

2.3获取组件

• 方式1： 通过 Env配置工具 或 RT-Thread studio 开启软件包，根据需要配置各项参数；配置路径为 RT-Thread online packages -> peripherals packages -> bt_mx01

2.4配置参数说明

参数宏	说明
BT_MX01_USING_SAMPLE	使用示例

3. 联系方式

• 维护：qiyongzhong
• 主页：https://github.com/qiyongzhong0/rt-thread-bt_mx01
• 主页：https://gitee.com/qiyongzhong0/rt-thread-bt_mx01
• 邮箱：[email protected]