# bt24s

**Repository Path**: RT-Thread-Mirror/bt24s

## Basic Information

- **Project Name**: bt24s
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-16
- **Last Updated**: 2026-01-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BT24S 项目简介

这是一个基于蓝牙 BT24S 模块的嵌入式软件项目，主要实现了与蓝牙模块的通信、数据接收和 AT 指令处理功能。
该项目可以作为串口类外设驱动的编程模板。
注: 作者使用QT6.10开发了一个安卓app 真机测试OPPO手机可以和模组通信 并能文件传输做OTA升级 项目地址https://gitee.com/GKoSon/my-first-android-app-on-qt

## 功能概述

- **AT 指令处理**：支持发送 AT 指令并等待预期响应，用于控制蓝牙模块。
- **数据接收与解析**：处理蓝牙模块接收的数据，并支持回调机制。
- **URC（Unsolicited Result Code）处理**：注册特定前缀的未请求响应，并绑定处理函数。
- **数据模式切换**：进入和退出数据透传模式。
- **硬件初始化**：配置蓝牙模块相关的串口、引脚和中断。

## 文件结构

- `example/bt24s_app.c`：主程序入口和应用示例，包含测试标志和处理回调。
- `src/bt24s_client.c`：实现蓝牙模块核心功能，如 AT 指令发送、URC 注册、数据收发等。
- `src/bt24s_dev.c`：硬件相关实现，包括串口通信、引脚初始化和数据接收线程。
- `inc/bt24s_client.h` 和 `inc/bt24s_dev.h`：头文件，声明函数和结构体。

## 主要接口说明

### AT 指令操作
- `at_cmd_send_impl`：发送 AT 指令并等待期望的响应。
- `register_urc_impl`：注册 URC 响应及其处理函数。
- `client_task_start`：启动 AT 指令处理任务。

### 数据通信
- `enter_data_mode_impl`：进入数据透传模式。
- `exit_data_mode_impl`：退出数据透传模式。
- `send_data_impl`：发送二进制数据到蓝牙模块。

### 硬件控制
- `bt24s_pin_init`：初始化蓝牙模块的控制引脚。
- `bt24s_hw_init`：初始化蓝牙模块的硬件（串口、线程等）。

## 使用方法

1. **初始化硬件**：
   ```c
   bt24s_pin_init();
   bt24s_hw_init();
   ```
2. **创建客户端**：
   ```c
   client_t *client = client_create();
   ```
3. **启动任务**：
   ```c
   client_task_start(client);
   ```
4. **发送 AT 指令**：
   ```c
   char response[128];
   at_cmd_send_impl(client, "AT", "OK", 1000, response, sizeof(response));
   ```
5. **注册 URC 响应**：
   ```c
   register_urc_impl(client, "+SMS:", sms_10086_handler, NULL);
   ```
6. **处理数据接收**：
   ```c
   enter_data_mode_impl(client, data_receive_callback);
   ```

## 注意事项

- 本项目基于 RT-Thread 操作系统，需确保系统正常运行。
- 使用前请根据实际硬件配置修改 `BLE_PORT_NAME`、`BLE_ENPWR_PIN_NAME` 等定义。
- 所有 AT 指令和 URC 处理依赖于串口通信，确保串口配置正确。

## 开源协议

本项目采用 MIT 许可证，请在使用时遵守相关开源协议。

## 联系方式
维护：龚金华 单位: 上海威派格智慧水务股份有限公司 邮箱：782730309@qq.com