# BlueDevDocs

**Repository Path**: Xavier_09/blue-dev-docs

## Basic Information

- **Project Name**: BlueDevDocs
- **Description**: 蓝牙协议文档与芯片手册资源仓库，提供通用蓝牙开发所需的参考文档和技术资料，支持多平台蓝牙开发。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-12
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# bluetooth-reference

蓝牙协议文档与芯片手册资源仓库，提供通用蓝牙开发所需的参考文档和技术资料，支持多平台蓝牙开发。

## 项目简介

本仓库旨在为蓝牙开发者提供一站式文档资源，涵盖蓝牙协议规范、芯片技术手册、开发注意事项等内容。文档主要面向 ESP32-S3 平台，但蓝牙协议部分具有通用性，可广泛应用于其他蓝牙开发平台。

## 目录结构

```
BlueDevDocs/
├── 芯片手册/                    # 芯片技术文档
│   └── esp32-s3/               # ESP32-S3 芯片文档
│       ├── esp32-s3-wroom-1_wroom-1u_datasheet_cn.pdf  # 模块规格书
│       ├── esp32-s3_datasheet_cn.pdf                    # 芯片数据手册
│       └── esp32-s3_technical_reference_manual_cn.pdf   # 技术参考手册
├── 蓝牙协议/                    # 蓝牙协议规范文档
│   ├── CPS/                    # 循环功率服务协议
│   │   ├── CPP_v1.1.pdf        # 循环功率配置文件
│   │   └── CPS_v1.1.pdf        # 循环功率服务规范
│   ├── DIS/                    # 设备信息服务协议
│   │   └── DIS_v1.2.pdf        # 设备信息服务规范
│   ├── FTMS/                   # 健身机器服务协议
│   │   ├── FTMP_v1.0.1.pdf     # 健身机器管理协议
│   │   └── FTMS_v1.0.1.pdf     # 健身机器服务规范
│   ├── HRS/                    # 心率服务协议
│   │   ├── HRP_V10.pdf         # 心率配置文件
│   │   └── HRS_SPEC_V10.pdf    # 心率服务规范
│   ├── Appearance Values.pdf    # 蓝牙外观值定义
│   └── Assigned_Numbers.pdf     # 蓝牙分配编号规范
└── README.md                   # 仓库说明文档
```

## 文档说明

### 📖 芯片手册

ESP32-S3 系列芯片技术文档，位于 `芯片手册/esp32-s3/` 目录下：

| 文档名称 | 说明 | 适用平台 |
|---------|------|---------|
| `esp32-s3_datasheet_cn.pdf` | ESP32-S3 芯片数据手册，包含电气特性、引脚定义、封装信息等 | ESP32-S3 |
| `esp32-s3_technical_reference_manual_cn.pdf` | ESP32-S3 技术参考手册，详细描述芯片内部结构和外设功能 | ESP32-S3 |
| `esp32-s3-wroom-1_wroom-1u_datasheet_cn.pdf` | WROOM-1/WROOM-1U 模块规格书 | ESP32-S3 |

### 📋 蓝牙协议

蓝牙协议规范文档，按服务类型分类存放：

#### 🏃 健身机器服务 (FTMS)
| 文档名称 | 协议全称 | 用途 |
|---------|---------|------|
| `FTMS_v1.0.1.pdf` | Fitness Machine Service | 健身设备蓝牙服务规范 |
| `FTMP_v1.0.1.pdf` | Fitness Machine Management Profile | 健身设备管理协议 |

#### ❤️ 心率服务 (HRS)
| 文档名称 | 协议全称 | 用途 |
|---------|---------|------|
| `HRS_SPEC_V10.pdf` | Heart Rate Service | 心率服务规范 |
| `HRP_V10.pdf` | Heart Rate Profile | 心率配置文件 |

#### 🚴 循环功率服务 (CPS)
| 文档名称 | 协议全称 | 用途 |
|---------|---------|------|
| `CPS_v1.1.pdf` | Cycling Power Service | 循环功率服务规范 |
| `CPP_v1.1.pdf` | Cycling Power Profile | 循环功率配置文件 |

#### 📱 设备信息服务 (DIS)
| 文档名称 | 协议全称 | 用途 |
|---------|---------|------|
| `DIS_v1.2.pdf` | Device Information Service | 设备信息服务规范 |

#### 🔖 通用规范
| 文档名称 | 协议全称 | 用途 |
|---------|---------|------|
| `Appearance Values.pdf` | Bluetooth Appearance Values | 蓝牙设备外观值定义 |
| `Assigned_Numbers.pdf` | Bluetooth Assigned Numbers | 蓝牙分配编号规范 |

## 使用方式

### 克隆仓库
```bash
# 使用 HTTPS
git clone https://gitee.com/Xavier_09/blue-dev-docs.git

```

### 查阅文档
```bash
# 进入仓库目录
cd blue-dev-docs

# 查看目录结构
ls -la

# 直接打开 PDF 文档（根据系统选择合适的阅读器）
# Windows: start "芯片手册/esp32-s3/esp32-s3_datasheet_cn.pdf"
# macOS: open "芯片手册/esp32-s3/esp32-s3_datasheet_cn.pdf"
# Linux: xdg-open "芯片手册/esp32-s3/esp32-s3_datasheet_cn.pdf"
```

### 更新文档
```bash
# 拉取最新更新
git pull origin main
```

## 适用平台

- **主要支持**：ESP32-S3 蓝牙开发
- **通用兼容**：其他蓝牙开发平台（蓝牙协议文档具有通用性）

## 许可证

本仓库文档资源遵循以下许可证：

- **芯片手册**：版权归 Espressif Systems 所有，仅供参考使用
- **蓝牙协议文档**：版权归 Bluetooth SIG 所有，遵循 Bluetooth SIG 许可协议
- **自定义文档**：MIT License

> **注意**：使用本仓库文档时，请遵守各文档原始版权方的许可协议。

## 贡献指南

欢迎提交 Issue 或 Pull Request 来补充更多蓝牙协议文档和技术资料：

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/your-feature`)
3. 提交更改 (`git commit -am 'Add some feature'`)
4. 推送到分支 (`git push origin feature/your-feature`)
5. 创建 Pull Request

## 维护者

- **维护团队**：蓝牙开发团队

## 致谢

感谢 Espressif Systems 和 Bluetooth SIG 提供的官方文档资源。

## 版本历史

| 版本 | 日期 | 说明 |
|-----|------|------|
| v1.0.0 | 2026-06-12 | 初始版本，包含基础文档 |

---

*本仓库持续更新中，欢迎关注最新动态。*