当前位置：首页 > news >正文

ESP32蓝牙开发笔记（十四）

news 来源：原创 2025/8/15 22:47:15

在 ESP32 的 BLE 开发中，esp_ble_gatts_add_char 是用于向 GATT 服务中添加特征（Characteristic）的核心函数。以下是该函数的详细说明、参数解析及示例代码：

函数原型

esp_err_t esp_ble_gatts_add_char(uint16_t service_handle,                  // 服务句柄（由添加服务时返回）esp_bt_uuid_t *char_uuid,                  // 特征的 UUIDesp_gatt_perm_t perm,                      // 特征的访问权限esp_gatt_char_prop_t property,             // 特征的属性（可读、可写等）esp_attr_value_t *char_val,                // 特征的初始值（可选）esp_attr_control_t *control                // 特征的属性控制（安全模式等）
);

参数详解

1. `service_handle`（服务句柄）

来源：由 esp_ble_gatts_create_service 或 esp_ble_gatts_add_service 创建服务后返回的句柄。
作用：指定特征所属的服务。

2. `char_uuid`（特征 UUID）

类型：esp_bt_uuid_t，可以是 16-bit、32-bit 或 128-bit UUID。

示例：

// 16-bit UUID（例如心率测量特征）
esp_bt_uuid_t char_uuid = {.len = ESP_UUID_LEN_16,.uuid = {.uuid16 = 0x2A37}
};

3. `perm`（权限）

类型：esp_gatt_perm_t，定义客户端对特征的访问权限。
常用值：
- ESP_GATT_PERM_READ：允许读
- ESP_GATT_PERM_WRITE：允许写
- ESP_GATT_PERM_READ_ENCRYPTED：需要加密读
- ESP_GATT_PERM_WRITE_ENCRYPTED：需要加密写

4. `property`（属性）

类型：esp_gatt_char_prop_t，定义特征支持的操作类型。
常用值（按位或组合）：
- ESP_GATT_CHAR_PROP_BIT_READ：可读
- ESP_GATT_CHAR_PROP_BIT_WRITE：可写（无响应）
- ESP_GATT_CHAR_PROP_BIT_WRITE_NR：可写（有响应）
- ESP_GATT_CHAR_PROP_BIT_NOTIFY：支持通知
- ESP_GATT_CHAR_PROP_BIT_INDICATE：支持指示

5. `char_val`（特征初始值）

类型：esp_attr_value_t，可选参数。如果设为 NULL，特征值初始为空。

示例：

esp_attr_value_t char_val = {.attr_max_len = 10,  // 最大长度.attr_len = 4,       // 初始值长度.attr_value = {0x01, 0x02, 0x03, 0x04} // 初始值
};

6. `control`（属性控制）

类型：esp_attr_control_t，通常用于配置安全模式。如果不需要特殊配置，可设为 NULL。

示例：

esp_attr_control_t control = {.auto_rsp = ESP_GATT_AUTO_RSP  // 自动响应读/写请求
};

返回值

ESP_OK：特征添加成功。
其他错误码：失败（如无效句柄、内存不足等）。

示例代码

步骤 1：创建服务

esp_bt_uuid_t service_uuid = {.len = ESP_UUID_LEN_16,.uuid = {.uuid16 = 0x180D} // 心率服务
};
uint16_t service_handle;
esp_ble_gatts_create_service(&service_uuid, 0, 5, &service_handle);

步骤 2：添加特征

// 定义特征 UUID（心率测量）
esp_bt_uuid_t char_uuid = {.len = ESP_UUID_LEN_16,.uuid = {.uuid16 = 0x2A37}
};// 特征权限和属性
esp_gatt_perm_t perm = ESP_GATT_PERM_READ | ESP_GATT_PERM_WRITE;
esp_gatt_char_prop_t property = ESP_GATT_CHAR_PROP_BIT_READ | ESP_GATT_CHAR_PROP_BIT_NOTIFY;// 添加特征
esp_err_t ret = esp_ble_gatts_add_char(service_handle,&char_uuid,perm,property,NULL,  // 初始值为空NULL   // 使用默认控制
);if (ret != ESP_OK) {ESP_LOGE("GATTS", "添加特征失败: %s", esp_err_to_name(ret));
}

步骤 3：启动服务

esp_ble_gatts_start_service(service_handle);

关键注意事项

特征描述符（如 CCCD）：
- 若特征支持通知或指示，需手动添加客户端特征配置描述符（CCCD），使用 esp_ble_gatts_add_char_descr。
回调处理：
- 特征的操作（读/写）会触发 ESP_GATTS_READ_EVT 或 ESP_GATTS_WRITE_EVT，需在 esp_ble_gatts_register_callback 中处理。
动态值更新：
- 使用 esp_ble_gatts_set_attr_value 可动态更新特征值。

错误排查

无效句柄：确保 service_handle 来自已成功创建的服务。
权限冲突：property 和 perm 需匹配（例如，若 property 包含 ESP_GATT_CHAR_PROP_BIT_READ，则 perm 必须包含 ESP_GATT_PERM_READ）。
内存不足：检查 ESP32 的堆内存（heap_caps_get_free_size()）。

完整流程示意图

创建服务 (esp_ble_gatts_create_service)|v
添加特征 (esp_ble_gatts_add_char)|v
（可选）添加描述符 (esp_ble_gatts_add_char_descr)|v
启动服务 (esp_ble_gatts_start_service)|v
处理读写事件 (ESP_GATTS_READ_EVT / WRITE_EVT)

通过合理使用 esp_ble_gatts_add_char，可以构建符合 BLE 标准的 GATT 服务，实现数据交互。

ESP32蓝牙开发笔记（十四）

在 ESP32 的 BLE 开发中，esp_ble_gatts_add_char 是用于向 GATT 服务中添加特征（Characteristic）的核心函数。以下是该函数的详细说明、参数解析及示例代码： 函数原型 esp_err_t esp_ble_gatts_add_char(uint16_t service_handle…...

编程日记 2025/8/15 22:47:15

idea连接mongodb配置schemas

1. idea连接mongodb配置显示的schemas 默认展示 Default databse, 可以在此设置...

编程日记 2025/8/15 5:16:26

MySQL的函数

函数其实就是方法，就是别人封装好的东西熟能生巧，加油！！！完整代码在最后。一、聚合函数 - group_concat() 就是对数据进行分组然后合并二、数学函数函数很多，大家至少看一遍，有一个大概印…...

编程日记 2025/8/14 13:16:26

苍穹外卖（订单状态定时处理、来单提醒和客户催单）

订单状态定时处理、来单提醒和客户催单 Spring Task cron表达式入门案例 ①导入maven坐标 spring-context（已存在） ②启动类添加注解 EnableScheduling 开启任务调度 ③自定义定时任务类订单状态定时处理需求分析代码开发自定义定…...

编程日记 2025/8/15 6:44:33

SpringBoot应急物资供应管理系统开发设计

概述基于SpringBoot的应急物资供应管理系统功能完善，采用了现代化的开发框架，非常适合学习或直接应用于实际项目。主要内容 5.1 管理员功能模块管理员可通过登录界面进入系统，使用用户名、密码和角色信息进行身份验证。登录后&#xf…...

编程日记 2025/8/15 6:44:32

spring cloud gateway 断言(Predicates)与过滤器(filters)

断言在 Spring Cloud Gateway 中，内置的断言（Predicates）用于对请求进行条件匹配。Spring Cloud Gateway 提供了多种内置断言，可以根据请求的路径、头部、方法等条件来决定是否将请求路由到特定的处理器。内置断言基于路径 …...

编程日记 2025/8/15 6:44:30

MySQL-数据查询（多表连接JOIN）-04-（11-2）

学生表学号姓名班级课程编号课程名称是否结课 create table xs( xs_id int auto_increment primary key, xs_xm varchar(30), xs_bj varchar(30), xs_kcbh varchar(30), xs_kcmc varchar(30), xs_sfjk varchar(30) );insert xs values(1,张三,24大数据技术,1001,MYS…...

编程日记 2025/8/15 6:44:28

解决leetcode第3537题填充特殊网格

3537.填充特殊网格难度：中等问题描述： 给你一个非负整数N，表示一个x的网格。你需要用从0到-1的整数填充网格，使其成为一个特殊网格。一个网格当且仅当满足以下所有条件时，才能称之为特殊网格： 右上角…...

编程日记 2025/8/15 0:45:17

C++_MD5算法

文章目录概要代码应用概要 MD5算法在数据加密、一致性哈希、安全性验证等技术中有广泛的应用。 MD5算法的原理可简要的叙述为：MD5码以512位分组来处理输入的信息，且每一分组又被划分为16个32位子分组，经过了一系列的处理后，算法…...

编程日记 2025/8/15 6:44:26

深入理解C++ Lambda表达式：从基础到高级应用

在现代C编程中，Lambda表达式已经成为不可或缺的特性之一。自C11引入以来，Lambda极大地改变了我们编写函数对象和回调的方式，使代码更加简洁、表达力更强。本文将全面探讨C Lambda表达式的各个方面，从基础语法到高级应用场景&#…...

编程日记 2025/8/15 6:44:24

蓝桥杯 20. 倍数问题

倍数问题原题目链接题目描述众所周知，小葱同学擅长计算，尤其擅长判断一个数是否是另一个数的倍数。但当面对多个数时，他就比较苦恼了。现在小葱给了你 n 个数，希望你从中找出三个数，使得这三个数的和是 K 的倍…...

编程日记 2025/8/15 6:44:22

2025最新出版 Microsoft Project由入门到精通（二）

目录项目五部曲第一步：先设置项目的信息和日历项目的开始结束日期项目的日历默认日历改为全年无休（除法定节假日） 六天工作制/七天工作制设置方法七天工作制的设置方法全年无休工作制的设置方法大小周交替日历设置方法&…...

编程日记 2025/8/15 6:44:20

从人体姿态到机械臂轨迹：基于深度学习的Kinova远程操控系统架构解析

在工业自动化、医疗辅助、灾难救援与太空探索等前沿领域，Kinova轻型机械臂凭借7自由度关节设计和出色负载能力脱颖而出。它能精准完成物体抓取、复杂装配和精细操作等任务。然而，实现人类操作者对Kinova机械臂的直观高效远程控制一直是技术难题。传统远程…...

编程日记 2025/8/15 6:44:19

【ABAP】定时任务DEBUG方法

事物码SM37 执行后，选中作业名，在输入框输入“JDBG”，进入调试模式（提前在需要的调试的程序设置断点）...

编程日记 2025/8/15 9:02:10

DDPM（Denoising Diffusion Probabilistic Models，去噪扩散概率模型）

简介 DDPM即去噪扩散概率模型（Denoising Diffusion Probabilistic Models），是一种生成式模型，在图像生成、视频生成等领域有广泛应用。以下是其详细介绍： 原理 DDPM的核心思想是通过在数据上逐步添加噪声来破坏数据…...

编程日记 2025/8/15 9:02:08

C26-冒泡排序法

一算法步骤外层循环:控制遍历轮数(共n-1轮,n为数组长度)内层循环:每轮比较相邻的元素,若顺序错误则交换,将当前一轮最大(最小)的元素移至末尾二实例代码 #include <stdio.h> int main() {//数组及相关数据定义int arr[4]{12,4,78,23};int i;int j;int temp;int …...

编程日记 2025/8/15 9:02:06

CentOS 7.9 安装详解：手动分区完全指南

CentOS 7.9 安装详解：手动分区完全指南为什么需要手动分区？CentOS 7.9 基本分区说明1. /boot/efi 分区2. /boot 分区3. swap 交换分区4. / (根) 分区可选分区（进阶设置）5. /home 分区6. /var 分区7. /tmp 分区分区方案建议标准…...

编程日记 2025/8/15 9:02:04

大模型系列（五）--- GPT3: Language Models are Few-Shot Learners

论文链接： Language Models are Few-Shot Learners 点评： GPT3把参数规模扩大到1750亿，且在少样本场景下性能优异。对于所有任务，GPT-3均未进行任何梯度更新或微调，仅通过纯文本交互形式接收任务描述和少量示例。然而&…...

编程日记 2025/8/15 9:02:02

BK精密电源操作软件 9130BA系列和手侧user manual

BK精密电源操作软件 9130BA系列和手侧user manual...

编程日记 2025/8/15 9:01:59

MATLAB的cvpartition函数用法

1. 函数作用 cvpartition 将数据集划分为训练集和测试集，支持多种交叉验证方法，包括： Hold-Out验证：单次划分（如70%训练，30%测试）K折交叉验证：数据分为K个子集，依次用其…...

编程日记 2025/8/15 9:01:57

含铜废水回收的好处体现

一、环境保护：减少污染，守护生态安全降低重金属污染含铜废水若直接排放，铜离子会通过食物链富集，对水生生物和人体造成毒性影响（如肝肾损伤）。回收处理可去除废水中90%以上的铜离子，显著降低…...

编程日记 2025/8/15 9:01:55

C++20新特新——02特性的补充

虽然上节我们介绍了不少关于协程的特点，但是大家可能对协程还是不是很了解，没关系，这里我们再对其进行补充，详细讲解一下； 一、协程函数与普通函数的区别这里我们再回归到问题：普通函数和协程在这方面的…...

编程日记 2025/8/15 9:01:53

【c++】我的世界

太久没更新小游戏了给个赞和收藏吧，求求了要游戏的请私聊我 #include <iostream> #include <vector>// 定义世界大小 const int WORLD_WIDTH 20; const int WORLD_HEIGHT 10;// 定义方块类型 enum BlockType {AIR,GRASS,DIRT,STONE };// 定义世界…...

编程日记 2025/8/15 9:01:51

Redis从入门到实战 - 高级篇（上）

一、分布式缓存 1. 单点Redis的问题数据丢失问题：Redis是内存存储，服务重启可能会丢失数据 -> 实现Redis数据持久化并发能力问题：单节点Redis并发能力虽然不错，但也无法满足如618这样的高并发场景 -> 搭建主从集群&…...

编程日记 2025/8/15 9:01:49

常见的卷积神经网络列举

经典的卷积神经网络（CNN）在深度学习发展史上具有重要地位，以下是一些里程碑式的模型及其核心贡献： 1. LeNet-5（1998） 提出者：Yann LeCun特点： 首个成功应用于手写数字识别&#xff…...

编程日记 2025/8/15 9:01:47

Linux如何安装AppImage程序

Linux如何安装AppImage程序文章目录 Linux如何安装AppImage程序在 Linux 中，.AppImage 是一种便携式的应用程序格式，无需安装即可运行。 1.赋予该文件可执行权限可以使用下列命令，赋予可执行权限 # 举个例子 chmod x /path/to/MyApp.App…...

编程日记 2025/8/15 9:01:45

人工智能如何进行课堂管理？

人工智能如何协助老师课堂管理？ 第一步：在腾讯元宝对话框中输入：如何协助老师进行课堂管理，通过提问，我们了解了老师高效备课可以从哪些方面入手，提高效率。第二步：编辑问题进行提问&#xf…...

编程日记 2025/8/15 9:01:43

如何理解参照权

在管理学和组织行为学中，“参照权力”（Referent Power）是一种非常重要的权力来源，它属于非强制性权力的一种，主要基于个人特质和人际关系。以下是对参照权力的详细解释： 一、定义参照权力是指一个人由于…...

编程日记 2025/8/15 9:01:41

从一次被抄袭经历谈起：iOS App 安全保护实战

如何保护 iOS App 的最后一道防线：那些你可能忽略的混淆技巧如果你曾认真反编译过别人的 .ipa 文件，很可能会有这种感受：“哇，这代码也太干净了吧。” 类名像 UserManager，方法名是 getUserToken，甚至资源…...

编程日记 2025/8/15 9:01:39

从交互说明文档，到页面流程图设计全过程

依据交互说明文档绘制页面流程图，能够将抽象的交互逻辑转化为可视化、结构化的表达，为开发、测试及团队协作提供清晰指引。接下来，我们以外卖 App 订单确认页为例，详细拆解从交互说明文档到完整页面流程图的设计全过程。一、交互…...

编程日记 2025/8/15 9:01:37

fedora系统详解详细版本

Fedora 系统详解：从起源到实践的深度解析一、Fedora 概述：开源社区的技术先锋 Fedora 是由 Fedora 项目社区开发、Red Hat 公司赞助的 Linux 发行版，以自由开源、技术前沿和稳定性平衡著称。它是 Red Hat Enterprise Linux&#xff…...

编程日记 2025/8/15 9:01:35

2025-05-07-FFmpeg视频裁剪（尺寸调整，画面比例不变）

原比例如图原比例如图裁剪后的比例代码： 方法一：极速 ffmpeg -i input.mp4 -vf "crop1080:750:0:345" -c:v libx264 -preset ultrafast -c:a copy output.mp4关键参数说明： vf “crop宽:高❌y”：定义裁剪区域。 …...

编程日记 2025/8/15 9:01:33

RISC-V JTAG：开启MCU 芯片调试之旅

在当今电子科技飞速发展的时代， MCU 芯片成为众多企业追求技术突破与创新的关键领域。而芯片的调试过程则是确保其性能与可靠性的重要环节。本文以国科安芯自研 AS32A601为例，旨在详细记录基于 RISC-V 架构的 MCU 芯片JTAG 调试过程及操作，为…...

编程日记 2025/8/15 9:01:30

51单片机快速成长路径

作为在嵌入式领域深耕18年的工程师，分享一条经过工业验证的51单片机快速成长路径，全程干货无注水： 一、突破认知误区（新手必看） 不要纠结于「汇编还是C」：现代开发90%场景用C，掌握指针和内存管…...

编程日记 2025/8/15 1:33:10

idea左侧项目资源管理器不见了处理

使用idea误触导致，侧边栏和功能栏没了，如何打开？ 1.打开文件（File） 2. 打开设置（Settings） 3.选择Appearance&Behavior--->Appearance划到最下面，开启显示工具栏和左侧并排布…...

编程日记 2025/8/14 23:33:49

给小白的AI Agent 基本技术点分析与讲解

引言：重塑交互与自动化边界的 AI Agent 在人工智能技术飞速发展的浪潮中，AI Agent（智能体）概念的兴起标志着自动化和人机交互正迈向一个全新的阶段。传统的软件系统通常被设计来执行精确预设的指令序列，它们强大且高效…...

编程日记 2025/8/15 9:01:24

[特殊字符] 深入解析：Go 与 Rust 中的数组与动态集合结构

在 Go 和 Rust 这两种现代语言中，数组和动态集合（如切片或 Vec）是处理数据的基础工具。虽然它们都提供了高效的内存访问能力，但设计理念却截然不同： Go 更注重灵活性和性能，允许开发者直接操作底层指针和容…...

编程日记 2025/8/15 9:01:22

C25-数组应用及练习

第一题题目: 代码 #include <stdio.h> int main() {//数组及相关数据定义int arr[10];int i;//基于循环的数组数据输入for(i0;i<10;i){arr[i]i;}//基于循环的数组数据输出for(i9;i>0;i--){printf("%d ",arr[i]);}return 0; }结果第二题题目代码 …...

编程日记 2025/8/15 9:01:20

Soft Mask（软遮罩）技术

一、概述 Soft Mask是一种技术或工具，主要用于实现平滑的边缘遮罩效果。它在不同的应用领域有不同的实现和定义 1.在Unity UI设计中 SoftMask是一款专为Unity设计的高级遮罩工具，它突破了传统Mask的限制，提供了更为灵活和细腻的UI遮罩解决方案…...

编程日记 2025/8/15 9:01:18

683SJBH基于J2EE的广州旅游管理系统

第1章　绪论课题背景自互联网internet成为一种革命性的大众媒体以来，其发展速度之快令人惊叹。而作为世界最大朝阳产业的旅游，当它与电子商务这一新兴模式相结合时，其潜藏的商业价值表露无遗。根据CNN（美国有线电视新闻网&…...

编程日记 2025/8/15 9:01:16

关于STM32 SPI收发数据异常

问题描述： STM32主板做SPI从机，另一块linux主板做主机，通信的时候发现从机可以正确接收到主机数据，但是主机接收从机数据时一直不对，是随机值。问题原因： 刚发现问题的时候，用逻辑分析仪抓包…...

编程日记 2025/8/15 9:01:14

雅努斯问题（Janus Problem）及解决方案

一、雅努斯简介雅努斯（Janus）是罗马神话中的门神，也是罗马人的保护神。他具有前后两个面孔或四方四个面孔，象征开始。雅努斯被认为是起源神，执掌着开始和入门，也执掌着出口和结束，因此他又被成…...

编程日记 2025/8/15 9:01:12

ACE-Step：扩散自编码文生音乐基座模型快速了解

ACE-Step 模型速读一、模型概述 ACE-Step 是一款由 ACE Studio 和 StepFun 开发的新型开源音乐生成基础模型。它通过整合基于扩散的生成方式、Sana 的深度压缩自编码器（DCAE）以及轻量级线性变换器，在音乐生成速度、音乐连贯性和可控性等方…...

编程日记 2025/8/15 9:01:10

【论文阅读】在调制分类中针对对抗性攻击的混合训练时和运行时防御

A Hybrid Training-Time and Run-Time Defense Against Adversarial Attacks in Modulation Classification 摘要在深度学习在包括计算机视觉和自然语言处理在内的许多应用中的卓越性能的推动下，最近的几项研究侧重于应用深度神经网络来设计未来几代无线网络。然而，最近的…...

编程日记 2025/8/14 14:22:08

HDMI布局布线

1 HDMI简介高清多媒体接口(High Definition Multimedia Interface),简称:HDMI,是一种全数字化视频和声音发送接口,可以发送未压缩的音频及视频信号。随着技术的不断提升,HDMI的传输速率也不断的提升,HDMI2.0最大传输速率可达14.4Gbit/s,HDMI2.1最大传输数据速率可达42.6Gbit/s…...

编程日记 2025/8/15 9:01:06