乐鑫ESP32-C3 BLE教程

简介
目录大纲
最新文档

# 前言
该文集仅发布ESP32-C3相关的内容，包括软件、硬件以及教程（包含**公开**和**VIP**两部分），如遇到无权限访问的文章，请联系我们管理员微信号：**17625815328**

# 开发板简介
[HX-DK-商](https://item.taobao.com/item.htm?spm=a1z10.1-c-s.w4004-22286946226.12.7f292c2cfSNrZb&id=654877303965)，是红旭无线第二代无线通讯开发板，采用乐鑫ESP32-C系列的第一代产品ESP32-C3，其是一款安全稳定、低功耗、低成本的物联网芯片，搭载 RISC-V 32 位单核处理器 **（高达 160 MHz）**，同时 **支持`2.4 GHz Wi-Fi`，`全功能Bluetooth 5.0 (LE)`，`Bluetooth Mesh`，`WiFi Mesh`** 等协议，更多关于ESP32-C3的详情请参阅[乐鑫官网](https://www.espressif.com/zh-hans/products/socs/esp32-c3)。

![](https://docdisk.wireless-tech.cn/img/2021/10/15/hx_dk_shang_20211015110649848518.png)

[HX-DK-商](https://item.taobao.com/item.htm?spm=a1z10.1-c-s.w4004-22286946226.12.7f292c2cfSNrZb&id=654877303965)的概貌如上图所示，关于更多HX-DK-商的内容，请参阅红旭无线公众号的推文[【新品上市】HX-DK-商，支持WiFi+BLE5.0](https://mp.weixin.qq.com/s/7ETvlsvo3OYlM7oS1uCpLA)

# 资料
鉴于红旭无线上一代[HX-DK-夏](https://item.taobao.com/item.htm?spm=a230r.1.14.20.b5f04a28o0GC0A&id=608555326842&ns=1&abbucket=20#detail)的市场反馈，此次HX-DK-商开发板将采用全实战教程的方式，来阐述ESP32-C3的无线通讯的性能，并顺带讲解无线通讯过程中所使用到的ESP32-C3外设，如`UART`，`SPI`，`I2C`等等。同时，也鉴于目前市场上充斥着大量ESP32系列的WiFi教程，所以基于HX-DK-商的实战教程的优先级如下：
1. 低功耗蓝牙 **（高）**
1. SIG MESH **（中）**
1. WiFi **（低）**

## 硬件
### 原理图
[HX-DK-商开发板原理图](https://docdisk.wireless-tech.cn/file/2021/10/18/HX-DK-商_V1.1.pdf)

### PCB图
[HX-DK-商开发板PCB图](https://docdisk.wireless-tech.cn/file/2021/10/18/HX-DK-商_Layout_V1.1.pdf)

### ESP32-C3关键资料
1. [ESP32-C3规格书](https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf)
1. [ESP32-C3技术参考手册](https://www.espressif.com/sites/default/files/documentation/esp32-c3_technical_reference_manual_en.pdf)
1. [ESP32-C3编程指南](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html#introduction)
	环境搭建以及调试下载，参考下述的[【新手必读】基于VSCODE的ESP32-C3开发环境的搭建](https://docs.wireless-tech.cn/doc/6/)和[【新手必读】基于JTAG对ESP32-C3的调试及下载](https://docs.wireless-tech.cn/doc/7/)即可；

## 教程
由上面的[资料](#资料)章节可知，[HX-DK-商](https://item.taobao.com/item.htm?spm=a1z10.1-c-s.w4004-22286946226.12.7f292c2cfSNrZb&id=654877303965)的教程分成三大块即`BLE`，`SIG MESH`，`WiFi`，教程的编写优先级也是从高->中->低这样依次排列。
### 公共基础篇（理论）
1. [【新手必读】红旭相关源码的约定俗称](https://docs.wireless-tech.cn/doc/5/)

讲解红旭无线教程后续所涉及到的代码约定俗称
1. [【新手必读】基于VSCODE的ESP32-C3开发环境的搭建](https://docs.wireless-tech.cn/doc/6/)

详述了如何利用`VSCODE` + `Espressif IDF`插件，一步一步地搭建ESP32-C3的开发环境
1. [【新手必读】基于JTAG对ESP32-C3的调试及下载](https://docs.wireless-tech.cn/doc/7/)

讲述了基于`VSCODE` + `Espressif IDF`插件的基础上，如何利用JTAG接口对ESP32-C3进行调试或下载

1. [【新手必读】初识ESP32-C3](https://docs.wireless-tech.cn/project-2/doc-8/)

介绍ESP32-C3的软硬件特性，常用的文档以及获取技术支持的方式，让新手可以更快地了解并使用ESP32-C3，避免网上过多的资料让新人无从下手
1. [【新手选读】ESP32-C3启动流程详解](https://docs.wireless-tech.cn/doc/9/)

细述了ESP32-C3从上电到app_main()函数的整个过程
1. [【新手必读】第一课：Hello World（实战）](https://docs.wireless-tech.cn/doc/10/)

利用[HX-DK-商](https://item.taobao.com/item.htm?spm=a1z10.1-c-s.w4004-22286946226.12.7f292c2cfSNrZb&id=654877303965)开发板，搭建第一个Hello World工程
    
### BLE

#### 基础篇（理论）

1. [【新手必读】BLE基础知识](https://docs.wireless-tech.cn/project-2/doc-11)

介绍一些日常高频使用到的BLE知识点

1. [【新手必读】BLE的不同地址类型](https://docs.wireless-tech.cn/project-2/doc-12/)

讲解不同BLE地址之间的区别
1. [【新手必读】不同类型的BLE广播事件浅析
](https://docs.wireless-tech.cn/doc/13/)

阐述不同类型的BLE广播事件，为接下来的实战教程打下基础
	
1. [【新手必读】BLE扫描的基本概念
](https://docs.wireless-tech.cn/doc/48/)

阐述了扫描在BLE中的作用及概念，为接下来的实战教程打下基础

------------

**以下实战所对应的源码均已在[HX-DK-商](https://item.taobao.com/item.htm?spm=a1z10.1-c-s.w4004-22286946226.12.7f292c2cfSNrZb&id=654877303965)开发板验证通过，可以直接运行**。

#### 广播篇（实战）
1. [可连接可扫描的非定向广播](https://docs.wireless-tech.cn/doc/67/)

实现发出间隔为100ms，广播名为**“我是谁?”**的可连接可扫描非定向广播，且接受扫描者的扫描请求并回复广播名为**“HX-DK-商”**的扫描响应数据

1. [基于隐私的可连接可扫描的非定向广播](https://docs.wireless-tech.cn/doc/70/)

实现使用可解析私有地址发出间隔为100ms，广播名为**“我是谁?”**的可连接可扫描非定向广播，且接受扫描者的扫描请求并回复广播名为**“HX-DK-商”**的扫描响应数据
	
1. [不可连接不可扫描的非定向广播](https://docs.wireless-tech.cn/doc/14/)

实现发出间隔为100ms，广播名为**“红旭无线”**的不可连接不可扫描非定向广播
1. [不可连接不可扫描的定向广播（扩展广播）](https://docs.wireless-tech.cn/doc/20/)

实现发出间隔为100ms，广播名为**“红旭无线”**的不可连接不可扫描定向广播，该广播是基于**BLE 5.0**新特性的扩展广播

1. [不可连接可扫描的非定向广播](https://docs.wireless-tech.cn/doc/21/)

实现发出间隔为100ms，广播名为**“我是谁?”**的不可连接可扫描非定向广播，且接受扫描者的扫描请求并回复广播名为**“HX-DK-商”**的扫描响应数据
	
1. [不可连接可扫描的定向广播（扩展广播）](https://docs.wireless-tech.cn/doc/23/)

实现发出间隔为100ms的不可连接可扫描定向广播，且仅接受指定扫描者的扫描请求并回复广播名为**“我是红旭无线的第二代开发板HX-DK-商”**的扫描响应数据。其中，有效的广播数据`AdvData`也仅存在于扫描响应数据包中

1. [可连接不可扫描的非定向广播（扩展广播）](https://docs.wireless-tech.cn/doc/25/)

实现发出间隔为100ms，广播名为**“红旭无线”**的可连接不可扫描非定向广播，且在数据通道上通过`AUX_CONNECT_REQ`建立连接

1. [不可连接不可扫描的非定向广播（链式广播）](https://docs.wireless-tech.cn/doc/26/)

实现发出间隔为100ms，广播名为**“红旭无线”**的不可连接不可扫描的非定向**扩展广播（链式广播）**，广播数据的总长度为`1650`字节
	
1. [低占空比的可连接不可扫描定向广播](https://docs.wireless-tech.cn/doc/44/)

实现发出间隔为20ms的可连接不可扫描的定向广播，不携带任何广播数据，仅包含对端设备和自身设备的Mac地址，该类型的广播常用于需要与特定设备重新连接，但时间不重要或不知道中央设备是否在范围内的情况
	
1. [高占空比的可连接不可扫描定向广播](https://docs.wireless-tech.cn/doc/45/)

实现发出以小于等于3.75ms的广播间隔，向外广播高占空比的可连接不可扫描的定向广播，并持续1.28s 之后就停止广播，常用于快速重连

1. [BLE 5.0新特性---广播集（Advertising Set）](https://docs.wireless-tech.cn/doc/46/)
	
	实现了以100ms的时间间隔，同时向外广播4组不同类型的广播数据，简而言之就是4组不同类型的广播并行工作
	
1. [BLE 5.0新特性---周期广播（Periodic Advertising）](https://docs.wireless-tech.cn/doc/47/)

实现了以100ms的扩展广播间隔以及25ms的周期广播间隔，向外广播周期广播

1. [不可连接不可扫描的非向定匿名扩展广播](https://docs.wireless-tech.cn/doc/76/)

实现了以100ms的时间间隔，向外广播设备名为 “红旭无线” 的不可连接不可扫描的非定向匿名广播

1. [不可连接不可扫描的非向定匿名链式广播](https://docs.wireless-tech.cn/doc/76/)

以100ms的时间间隔，向外广播设备名为 “红旭无线” 的不可连接不可扫描的非定向匿名扩展广播`（链式广播）`
	
1. [不可连接不可扫描的链式周期广播](https://docs.wireless-tech.cn/doc/79/)

实现了以100ms的扩展广播间隔以及100ms的周期广播间隔，向外广播周期链式广播
	
#### 扫描篇
1. [扫描非定向广播](https://docs.wireless-tech.cn/doc/66/)

主动扫描周边的非定向广播设备，并将广播数据和扫描响应数据打印出来
1. [扫描非定向广播(基于白名单)](https://docs.wireless-tech.cn/doc/68/)

主动扫描周边的非定向广播设备，但只会将在白名单中的设备的广播数据和扫描响应数据打印出来

1. [扫描非定向广播(基于隐私)](https://docs.wireless-tech.cn/doc/69/)

主动扫描周边的非定向广播设备，但使用可解析私有地址，并将广播数据和扫描响应数据打印出来

1. [扫描非定向的扩展广播](https://docs.wireless-tech.cn/doc/71/)

被动扫描周边的非定向扩展广播设备，并将扩展广播数据打印出来
	
1. [扫描定向的扩展广播](https://docs.wireless-tech.cn/doc/72/)

被动扫描周边的定向扩展广播设备，并将指向自己的扩展广播数据打印出来
	
1. [扫描可连接定向扩展广播](https://docs.wireless-tech.cn/doc/73/)

主动扫描可连接定向扩展广播的设备并将扫描响应的扩展广播数据通过串口打印出来
	
1. [扫描不可连接不可扫描的链式广播（1650字节）](https://docs.wireless-tech.cn/doc/74/)

被动扫描不可连接不可扫描的链式广播的设备并将原始的链式广播数据通过串口打印出来
	
1. [扫描不可连接不可扫描的匿名扩展广播](https://docs.wireless-tech.cn/doc/75/)

被动扫描不可连接不可扫描的匿名扩展/链式广播并将原始的扩展/链式广播数据通过串口打印出来

1. [扫描周期广播](https://docs.wireless-tech.cn/doc/78/)

被动扫描指定的周期广播设备并将原始的扩展广播数据和周期广播数据，通过串口打印出来
	
	
#### 连接篇
#### 混合篇
#### 安全篇

### SIG MESH
占位，待补充

### WiFi
占位，待补充
# 关于我们
1. 技术交流论坛
    
    [![](https://img.shields.io/badge/BBS-bbs.wireless--tech.cn-red)](http://bbs.wireless-tech.cn/)

强烈建议在这个论坛上寻求帮助，我们可以免费为您解答相关的技术问题，**论坛里有大佬(24小时内回复!!!)** 。

1. CSDN-博客

[![](https://img.shields.io/badge/CSDN--%E5%8D%9A%E5%AE%A2-https%3A%2F%2Fwireless--tech.blog.csdn.net%2F-red)](https://wireless-tech.blog.csdn.net/)

相关的文字教程将映射至CSDN博客上，方便大家快速查阅。

1. 淘宝店铺

[![](https://img.shields.io/badge/%E6%B7%98%E5%AE%9D%E5%BA%97%E9%93%BA-%E7%BA%A2%E6%97%AD%E6%97%A0%E7%BA%BF-red)](https://shop166249478.taobao.com/index.htm?spm=2013.1.w5002-22232069179.2.8354125781JKC9)

对我们的硬件感兴趣的朋友，可以到上述的淘宝地址购买。
1. QQ群

![](https://img.shields.io/badge/QQ%E7%BE%A4-808014164-red)

QQ群主要用于自主的技术以及行业信息交流，无广告纯技术探讨 **（仅限技术开发者加入，非技术人员请勿加入免得发现被踢）**。
1. 微信公众号

不定期发布相关的技术动态消息或文章，也方便大家手机查看。

乐鑫ESP32-C3 BLE教程

不同类型的BLE广播事件浅析

基于VSCODE的ESP32C3开发环境的搭建

基于JTAG对ESP32-C3的调试及下载

基于Docker+WSL+VSCODE的ESP32-C3开发环境搭建

不可连接不可扫描的链式周期广播