# BlueNRG-x-documentation

**Repository Path**: lucienkuang/BlueNRG-x-documentation

## Basic Information

- **Project Name**: BlueNRG-x-documentation
- **Description**: BlueNRG系列文档介绍
- **Primary Language**: C
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/lucienkuang/BlueNRG-x-documentation
- **GVP Project**: No

## Statistics

- **Stars**: 13
- **Forks**: 6
- **Created**: 2021-04-15
- **Last Updated**: 2025-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BlueNRG-x-documentation

## 前言 
- 本仓库是由个人维护的一个ST BlueNRG系列（BLE芯片）非正式文档的主页。
  主要包含： 
    - 1.平时培训文档; 
    - 2.快速上手资料；
    - 3.客户常见问题分析与总结；
    - 4.BLE和Mesh协议教程；
    - 5.一些典型应用的参考设计。
- 建议尽可能使用最新版本的SDK。
- 文档主要是用markdown格式编写的，可以使用VScode或者Typora等支持markdown格式的编辑器打开。
- 下载与更新：
  - 下载: git clone https://gitee.com/lucienkuang/BlueNRG-x-documentation.git
  - 更新:  git pull
- 如果文档查看相关文档仍然无法解决您的问题，或者想进一步交流，也可以直接发邮件到： lucien.kuang@foxmail.com  或者在Gitee的此仓库上提issues





## 目录
部分浏览器可能无法显示折叠功能中的三角型 ▼ ，以下目录带“折叠”二字的可以点击该行目录，进行目录的折叠与展开。


[快速开始与开发环境搭建](Quickstart/README.md)
  <details>
    <summary>快速开始与开发环境搭建折叠与展开</summary>
  
  - [资料下载与软件安装](Quickstart/资料下载与软件安装.md)
  - [主要的官方资料查找](Quickstart/主要的官方资料查找.md)
  - [认识BlueNRG-LP的评估板](Quickstart/认识BlueNRG-LP的评估板.md)
  - [拷贝制作用户自己的工程](./Quickstart/拷贝制作用户自己的工程.md)
  - [安装芯片的pack包](./Quickstart/安装芯片的pack包.md)
  - [免费的开发编译工具](./Quickstart/免费的开发编译工具.md)
    
    </details>

[硬件设计和测试](硬件设计和测试/README.md)

[BLE与Mesh协议](BLE/README.md)
  <details>
    <summary> BLE与Mesh协议折叠与展开</summary>

  - [BLE协议基础](BLE/BLE协议栈基础.md)
  - [BlueNRG-x如何更新BLE连接参数](BLE/update_connection_parameter/BlueNRG-x如何更新BLE连接参数.md)
  - [如何准确计算和配置BlueNRG-1/2的GATT属性表大小](BLE/如何准确计算和配置GATT属性表大小.md)
  - [BLE协议栈进阶](BLE/BLE协议栈基础.md)
      - 数据扩展包
      - BLE安全
      - 蓝牙5.0之扩展广播

    - Mesh协议
    </details>



[常见应用](Application/README.md)

  <details>
      <summary>常见应用折叠与展开</summary>

  - [如何优化BlueNRG-x的功耗](Application/功耗优化/如何优化BlueNRG-x的功耗.md)
  - [基于BLE多连接的星型网络应用](Application/Multiple_connection/基于BLE多连接的星型网络应用.md) 

  - [BlueNRG系列存储分析(Flash_and_RAM)](Application/BlueNRG系列如何使用静态协议栈/BlueNRG系列存储分析(Flash_and_RAM).MD) 
  - [BlueNRG系列如何使用静态协议栈](Application/BlueNRG系列如何使用静态协议栈/BlueNRG系列如何使用静态协议栈.MD)
  - [BlueNRG系列的OTA](Application/OTA/BlueNRG-x系列官方OTA操作简介.md)
  - [BlueNRG-1/2串口下载协议](Application/uart_bootloarder_protocol/串口下载协议应用笔记.md)

  - [BlueNRG系列协处理器介绍](./Application/BlueNRG系列协处理器介绍.md)
    
  - [BlueNRG系列如何设置划分分配内存给动态内存区](./Application/BlueNRG系列如何设置划分分配内存给动态内存区.md) 
  
  - [大规模低功耗节点组网方案参考设计](./Application/大规模低功耗节点组网方案参考设计.md)
  
  - [超市货架标签ESL组网方案参考设计](./Application/超市货架标签ESL组网方案参考设计.md)
    
  - [BlueNRG系列中使用FreeRTOS](./Application/BlueNRG系列中使用FreeRTOS.md)
      </details>



[工具使用](工具使用/README.md)
  - [开源改进的版本的Flasher_utility下载工具](https://github.com/wallekuang/MP-Tool)


[FAQ](FAQ/README.md)
  <details>
    <summary>FAQ折叠与展开</summary>


  - [如何区分不同的DTM工程与配置](FAQ/AboutDTM/关于BlueNRG-LP的DTM.md)
  - [如何查找QDID](FAQ/如何查找QDID.md)
  - [BlueNRG-x系列如何简单延时](FAQ/BlueNRG系列如何简单的延时.md)
  - [如何安装GNU工具链](FAQ/安装GNU工具链/如何安装GNU工具链.md)
  - [BlueNRG-1-2睡眠模式下使用RTC](FAQ/BlueNRG-1-2睡眠模式下使用RTC.md)
  - [如何在SDK中适配使用BlueNRG-345](FAQ/使用BlueNRG-345注意事项.md)
  - [如何设定BlueNRG系列广播数据](FAQ/如何设定广播数据.md)
  - [如何读取BlueNRG系列芯片的版本号](FAQ/如何读取BlueNRG系列芯片的版本号.md)


    <details>
    <summary>调试技巧折叠与展开</summary>
    
    - [如何监视BlueNRG-LP Radio的活跃状态](FAQ/RadioTXRX_map_to_gpio/如何在Radio_TX或者RX时将某个GPIO置位高电平.md)

    - [使用Ozone或者IAR定位死机问题和看门狗异常问题](FAQ/使用Ozone或者IAR定位死机问题和看门狗异常问题.md)

    </details>
    </details>

[培训资料](培训资料/README.md)

  - [2021_04_08_level1_BlueNRG系列培训资料](培训资料/2021_04_08_level1)
  - [2021_ST_BLE多连接技术的原理分析与应用](培训资料/2021_ST_BLE_MultipleConnection)
  - [BlueNRG-LP 2.4G 私有协议相关介绍](培训资料/2.4G_Radio)
  - [2022_ST_BLE_Mesh的基本介绍](培训资料/2022_ST_BLE_Mesh)  
  - [BLE系列课程]（https://www.bilibili.com/video/BV1Hh4y1t76g/?spm_id_from=333.788&vd_source=d27f9290993179409104a4782f344f22）