# gpt5-learning-bluetooth

**Repository Path**: luzhihaoTestingLab/gpt5-learning-bluetooth

## Basic Information

- **Project Name**: gpt5-learning-bluetooth
- **Description**: 使用gpt5创建学习蓝牙系统的底层原理
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-25
- **Last Updated**: 2025-10-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 蓝牙从零到双向通信：实战课程

本课程带你从零理解蓝牙（BLE）发送与接收的核心原理，并用手机作为发送端（外围设备，Peripheral），用网页或Python作为接收端（中心设备，Central）完成双向通信。内容分章节编写在多个 Markdown 文件中，配有可运行的示例代码。

## 你将收获
- 搭建一个可用的 BLE 发送/接收系统（手机 ↔ 网页/电脑）
- 掌握 GATT（服务/特征值）模型与 UUID 的使用
- 会用 Web Bluetooth 与 Python Bleak 进行读写和通知
- 能独立排查常见连接、权限和特征值问题

## 环境与准备
- 操作系统：Windows 10/11（建议）
- 浏览器：Chrome 89+（支持 Web Bluetooth），使用 `https` 或 `http://localhost`
- 手机：Android（安装 nRF Connect 或 LightBlue），开启蓝牙
- Python（可选，用于第二种接收端）：Python 3.10+，`pip install bleak`

## 本课程使用的关键 UUID
- 服务 UUID：`0000ffff-0000-1000-8000-00805f9b34fb`
- 写入特征（中心→外围）：`0000ff01-0000-1000-8000-00805f9b34fb`（Write/Write Without Response）
- 通知特征（外围→中心）：`0000ff02-0000-1000-8000-00805f9b34fb`（Notify/Read）

> 说明：你可以替换为自己的 128-bit UUID，但需保证手机端与接收端代码一致。

## 课程索引
- [01-蓝牙基础](./01-蓝牙基础.md)
- [02-GATT模型与UUID](./02-GATT模型与UUID.md)
- [03-搭建发送端-手机GATT服务器](./03-搭建发送端-手机GATT服务器.md)
- [04-搭建接收端-网页WebBluetooth](./04-搭建接收端-网页WebBluetooth.md)
- [05-接收端-PythonBleak](./05-接收端-PythonBleak.md)
- [06-双向通信与演示](./06-双向通信与演示.md)
- [07-故障排除](./07-故障排除.md)

## 快速上手（你将搭建最小可用系统）
1) 在手机上用 nRF Connect 创建 GATT 服务器，添加上面的服务与两个特征，并启动广播（详见第 03 章）。
2) 用第 04 章的网页示例连接手机设备：写入 FF01，订阅 FF02 通知。
3) 在手机端将 FF02 的值设置为文本并发送通知，网页端实时接收显示。
4) 选择进阶：在第 05 章用 Python Bleak 完成同样操作。

## 目录结构建议
- 纯课程文档：按上述索引阅读和实践即可。
- 如需本地运行网页示例：在 `web` 目录下启动本地服务器（`http://localhost`），详见第 04 章。

## 版权与许可
- 本课程仅用于学习交流，不包含第三方库的许可证文件；使用 nRF Connect、Bleak 等工具请遵循其许可证。