物联网嵌入式驱动开发硬件开发【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址https://gitcode.com/GitHub_Trending/es/esp-iot-solution点击查看免费下载本指南以examples/bluetooth/ble_services/ble_ots示例为核心介绍如何在 ESP32 系列芯片上通过 esp-iot-solution 的 OTS 组件构建一个实现 BLE Object Transfer Service对象传输服务OTS的 GATT 服务端从硬件准备、工程配置、编译烧录到应用层事件处理与底层 OTS 服务 API 的完整剖析。读完本文你将掌握在 ESP-IDF NimBLE 环境下启用 OTS 服务、配置广播参数、处理 Object Name / Object Properties 写入事件并通过通用 BLE 扫描工具进行连接与基础验证的完整实战流程。1. 示例概述与功能边界BLE Object Transfer ServiceOTS服务 UUID0x1825是 Bluetooth SIG 定义的标准服务用于在设备之间传输二进制对象文件、固件、配置数据等。本示例在 ESP32 上创建一个实现了 OTS 的 GATT 服务器并启动广播等待 GATT 客户端连接用于演示BLE 连接管理与OTS 相关的 GATT 流程。需要注意的是该示例聚焦于验证 OTS 服务的基础通信能力属于基础 OTS GATT 流程演示并未实现完整的 OTS 功能例如对象操作创建、删除、读、写OACPObject Action Control Point对象动作控制点与 OLCPObject List Control Point对象列表控制点流程对象元数据处理。在功能评估与二次开发时这一点至关重要——它更适合作为 OTS 服务接入与底层 API 使用的起点而非开箱即用的对象传输应用。支持的芯片目标示例通过 CI 配置验证的支持范围如下源自 README.md支持的芯片ESP32ESP32-C3ESP32-C2ESP32-S3ESP32-H2示例工程位置示例工程examples/bluetooth/ble_services/ble_ots底层 OTS 服务组件components/bluetooth/ble_services/ots同目录下其他标准 BLE 服务示例可参考 components/bluetooth/ble_services/README.md2. 工程结构与依赖关系该示例是一个标准的 ESP-IDF 工程目录结构非常精简examples/bluetooth/ble_services/ble_ots/ ├── main/ │ ├── CMakeLists.txt # 声明源文件与依赖bt、nvs_flash │ ├── Kconfig.projbuild # Example Configuration 菜单广播名、副广播数据 │ ├── app_main.c # 应用主逻辑 │ └── idf_component.yml ├── CMakeLists.txt ├── README.md ├── sdkconfig.ci.nimble # CI 使用的 NimBLE 配置 └── sdkconfig.defaults # 默认配置开启 BT 栈与 OTS从 main/CMakeLists.txt 可以看到应用层直接依赖bt与nvs_flashidf_component_register(SRCS app_main.c REQUIRES bt nvs_flash)在代码层面app_main.c 引用了两个关键头文件esp_ble_conn_mgr.h来自连接管理组件 components/bluetooth/ble_conn_mgr负责 BLE 初始化、广播、连接与断开的事件管理esp_ots.h来自 OTS 服务组件 components/bluetooth/ble_services/ots/include/esp_ots.h提供 OTS 各特征值的读写 API 与事件定义。这种连接管理 标准服务的分层设计使应用代码只需聚焦业务逻辑无需直接操作 GATT 表与 NimBLE 底层接口。3. 硬件准备与快速上手硬件需求一块搭载 ESP32 / ESP32-C3 / ESP32-C2 / ESP32-S3 / ESP32-H2 SoC 的开发板一根 USB 数据线用于供电与程序烧录。设置芯片目标工程配置与编译前必须先设置正确的芯片目标idf.py set-target chip_name例如 ESP32-S3idf.py set-target esp32s3编译、烧录与监视构建工程并烧录到开发板随后打开串口监视器查看输出idf.py -p PORT flash monitor退出串口监视器使用快捷键Ctrl-]。4. 配置项详解广播参数与 OTS 服务开关4.1 通过 menuconfig 配置打开工程配置菜单idf.py menuconfigExample Configuration菜单定义于 main/Kconfig.projbuildExample Configuration -- Advertisement name设备广播名称默认BLE_OTS。Kconfig 帮助信息说明其最大长度为 29 个字符Example Configuration -- Subsequent advertisement data后续广播数据默认值为SUB_ADV用于填充广播包中的制造商/附加数据字段。BLE Standard Services菜单定义于 components/bluetooth/ble_services/ots/Kconfig.inBLE Standard Services -- GATT Object Transfer Service即CONFIG_BLE_OTS总开关默认通过 sdkconfig.defaults 启用。启用 OTS 后还可按需裁剪以下三个可选的 OTS 特征Kconfig 选项默认值作用BLE_OTS_FIRST_CREATED_CHARACTERISTIC_ENABLEy是否启用 Object First Created 特征0x2AC1BLE_OTS_LAST_MODIFIED_CHARACTERISTIC_ENABLEy是否启用 Object Last Modified 特征0x2AC2BLE_OTS_OBJECT_CHANGE_CHARACTERISTIC_ENABLEy是否启用 Object Change 特征0x2AC8从 Kconfig 定义可以看出Kconfig.in这三个特征均为布尔开关默认开启。在资源受限的芯片上可以关闭不需要的特征以减小 GATT 表体积。4.2 sdkconfig.defaults默认启用的关键配置sdkconfig.defaults 中预先开启了四组关键配置保证开箱即用# Override some defaults so BT stack is enabled # by default in this example CONFIG_BT_ENABLEDy # 启用蓝牙控制器与主机栈 CONFIG_BT_NIMBLE_ENABLEDy # 使用 NimBLE 作为蓝牙协议栈 CONFIG_BLE_CONN_MGR_ROLE_PERIPHERALy # 连接管理器以外围设备Peripheral角色运行 CONFIG_BLE_OTSy # 启用 GATT Object Transfer Service其中CONFIG_BT_ENABLED/CONFIG_BT_NIMBLE_ENABLED覆盖 ESP-IDF 默认配置启用蓝牙并选择体积更小、适合 SoC 场景的 NimBLE 协议栈CONFIG_BLE_CONN_MGR_ROLE_PERIPHERAL示例作为 GATT 服务器外围设备运行故连接管理器配置为 Peripheral 角色CONFIG_BLE_OTS将 OTS 标准服务纳入构建。另外sdkconfig.ci.nimble 仅保留CONFIG_BT_NIMBLE_ENABLEDy用于 CI 流水线中针对 NimBLE 配置的专项验证。5. 应用逻辑源码解析从启动到事件回调app_main.c 是示例的全部应用代码核心流程可拆解为四步。5.1 应用初始化流程app_mainapp_main()app_main.c按以下顺序完成启动初始化 NVS调用nvs_flash_init()若返回ESP_ERR_NVS_NO_FREE_PAGES或ESP_ERR_NVS_NEW_VERSION_FOUND则先擦除再重新初始化保证首次烧录或版本升级时 NVS 分区可用创建默认事件循环esp_event_loop_create_default()注册连接管理事件回调esp_event_handler_register(BLE_CONN_MGR_EVENTS, ESP_EVENT_ANY_ID, app_ble_conn_event_handler, NULL)初始化连接管理器构造esp_ble_conn_config_t配置设备名取CONFIG_EXAMPLE_BLE_ADV_NAME广播数据取CONFIG_EXAMPLE_BLE_SUB_ADV调用esp_ble_conn_init(config)初始化 OTS 服务调用app_ble_ots_init()启动广播esp_ble_conn_start()失败时依次执行esp_ble_conn_deinit()、esp_ble_ots_deinit()等清理动作并打印错误日志。5.2 OTS 服务初始化与事件注册app_ble_ots_init()app_main.cstatic void app_ble_ots_init(void) { ESP_ERROR_CHECK(esp_ble_ots_init()); ESP_ERROR_CHECK(esp_event_handler_register(BLE_OTS_EVENTS, ESP_EVENT_ANY_ID, app_ble_ots_event_handler, NULL)); }esp_ble_ots_init()负责在 GATT 表中注册 OTS 服务及其全部特征底层实现见 components/bluetooth/ble_services/ots/src/esp_ots.c。初始化完成后应用通过BLE_OTS_EVENTS事件基类订阅 OTS 相关事件。5.3 OTS 事件处理Object Name 与 Object Propertiesapp_ble_ots_event_handler()app_main.c处理两类写入事件switch (id) { case BLE_OTS_CHR_UUID16_OBJECT_NAME: ESP_LOGI(TAG, Object Name write event); break; case BLE_OTS_CHR_UUID16_OBJECT_PROP: recv_obj_prop (esp_ble_ots_prop_t *)event_data; ESP_LOGI(TAG, Object prop 0x%x, recv_obj_prop-delete_prop); break; default: break; }BLE_OTS_CHR_UUID16_OBJECT_NAME0x2ABE客户端写入对象名时触发示例仅打印日志BLE_OTS_CHR_UUID16_OBJECT_PROP0x2AC4客户端写入对象属性时触发event_data携带esp_ble_ots_prop_t结构体示例读取其中的delete_prop位段并打印。5.4 连接事件处理连接后设置 Object Sizeapp_ble_conn_event_handler()app_main.c监听BLE_CONN_MGR_EVENTSESP_BLE_CONN_EVENT_CONNECTED客户端连接成功后调用esp_ble_ots_set_size(obj_size)设置 Object Size 特征值失败则打印告警ESP_BLE_CONN_EVENT_DISCONNECTED断开连接时打印日志不做额外处理。示例声明的 Object Size 特征值app_main.c为已分配 256 字节、当前 0 字节的空对象static esp_ble_ots_size_t obj_size { .allocated_size 256, .current_size 0 };这一设计表明示例在连接建立后即向客户端暴露一个可容纳 256 字节内容的空对象——这正是基础 OTS 通信验证的典型行为。6. 深入 OTS 组件特征 UUID、操作码与 API 全貌OTS 组件的公共接口定义在 components/bluetooth/ble_services/ots/include/esp_ots.h它是理解整个服务的关键。6.1 服务与特征 UUID 一览OTS 服务 UUID 为0x1825BLE_OTS_UUID16其下包含 12 个特征esp_ots.h特征名称16 位 UUID宏定义OTS Feature0x2ABDBLE_OTS_CHR_UUID16_OTS_FEATUREObject Name0x2ABEBLE_OTS_CHR_UUID16_OBJECT_NAMEObject Type0x2ABFBLE_OTS_CHR_UUID16_OBJECT_TYPEObject Size0x2AC0BLE_OTS_CHR_UUID16_OBJECT_SIZEObject First Created0x2AC1BLE_OTS_CHR_UUID16_OBJECT_FIRST_CREATEDObject Last Modified0x2AC2BLE_OTS_CHR_UUID16_OBJECT_LAST_MODIFIEDObject ID0x2AC3BLE_OTS_CHR_UUID16_OBJECT_IDObject Properties0x2AC4BLE_OTS_CHR_UUID16_OBJECT_PROPObject Action Control Point (OACP)0x2AC5BLE_OTS_CHR_UUID16_OBJECT_ACTION_CONTROL_POINTObject List Control Point (OLCP)0x2AC6BLE_OTS_CHR_UUID16_OBJECT_LIST_CONTROL_POINTObject List Filter0x2AC7BLE_OTS_CHR_UUID16_OBJECT_LIST_FILTERObject Changed0x2AC8BLE_OTS_CHR_UUID16_OBJECT_CHANGED其中BLE_OTS_ATT_VAL_LEN值为 20esp_ots.h定义了特征值属性长度与经典 BLE ATT 单包最大载荷一致。6.2 OACP 与 OLCP 操作码定义虽然示例未实现完整的对象操作但头文件已完整定义协议层面的操作码为二次开发预留了接口esp_ots.h。OACP 操作码写入 0x2AC5| 操作码 | 含义 | 宏 | | ------ | ---- | -- | | 0x01 | 创建对象Create |BLE_OTS_OACP_CREATE| | 0x02 | 删除对象Delete |BLE_OTS_OACP_DELETE| | 0x03 | 计算校验和 |BLE_OTS_OACP_CALCULATE_CHECKSUM| | 0x04 | 执行Execute |BLE_OTS_OACP_EXECUTE| | 0x05 | 读Read |BLE_OTS_OACP_READ| | 0x06 | 写Write |BLE_OTS_OACP_WRITE| | 0x07 | 中止Abort |BLE_OTS_OACP_ABORT| | 0x60 | 响应Response |BLE_OTS_OACP_RESPONSE|配套的 OACP 响应码覆盖SUCCESS、NOT_SUPPORT、INVALID_PARAMETER、INSUFFICIENT_RESOURCES、INVALID_OBJECT、CHANNEL_UNAVAILABLE、UNSUPPORT_TYPE、NOT_PERMIT、OBJECT_LOCK、OPERATION_FAIL0x01~0x0A。OLCP 操作码写入 0x2AC6FIRST(0x01)、LAST(0x02)、PREVIOUS(0x03)、NEXT(0x04)、GO_TO(0x05)、ORDER(0x06)、REQ_NUM_OF_OBJ(0x07)、CLEAR_MARK(0x08)、RESPONSE(0x70)。排序参数支持按名称/类型/大小/创建时间/修改时间的升序与降序共 10 种0x01~0x15。Object Change 特征标志位esp_ots.h使用 5 个 bit 标识变更来源| 位 | 含义 | | -- | ---- | | bit0 | Source of Change变更来源 | | bit1 | Change occurred to the object contents对象内容变更 | | bit2 | Change occurred to the object metadata对象元数据变更 | | bit3 | Object Creation对象创建 | | bit4 | Object Deletion对象删除 |6.3 核心数据结构OTS 组件定义了一批紧凑packed结构体用于与特征值一一对应esp_ble_ots_feature_tesp_ots.hOTS Feature 特征值内含oacp10 个操作支持位与olcp4 个操作支持位两个位段子结构共 32 bitesp_ble_ots_size_tL148-L151Object Size 特征值含current_size与allocated_sizeesp_ble_ots_utc_tL156-L163UTC 时间年 1582~9999、月 1~12、日 1~31、时 0~23、分/秒 0~59用于 First Created / Last Modified 特征esp_ble_ots_id_tL168-L1706 字节 Object ID合法范围 0x000000000100 ~ 0xffffffffffffesp_ble_ots_prop_tL175-L184Object Properties 特征值8 个属性位delete/execute/read/write/append/truncate/patch/markesp_ble_ots_oacp_t/esp_ble_ots_olcp_tL189-L200OACP 与 OLCP 的控制点结构含操作码与参数区esp_ble_ots_change_tL222-L225Object Change 特征值含标志位与 6 字节对象 ID。6.4 公共 API 一览esp_ots.h为每个特征提供了成对的get/set接口应用层可在运行时读写这些特征值API说明esp_ble_ots_init()/esp_ble_ots_deinit()初始化 / 反初始化 OTS 服务esp_ble_ots_get_feature()/esp_ble_ots_set_feature()读写 OTS Featureesp_ble_ots_get_name()/esp_ble_ots_set_name()读写 Object Nameesp_ble_ots_get_type()/esp_ble_ots_set_type()读写 Object Typeesp_ble_ots_get_size()/esp_ble_ots_set_size()读写 Object Size示例在连接后调用 setesp_ble_ots_get_first_create_time()/esp_ble_ots_set_first_create_time()读写 Object First Createdesp_ble_ots_get_last_modify_time()/esp_ble_ots_set_last_modify_time()读写 Object Last Modifiedesp_ble_ots_get_id()/esp_ble_ots_set_id()读写 Object IDesp_ble_ots_get_prop()/esp_ble_ots_set_prop()读写 Object Propertiesesp_ble_ots_get_oacp()/esp_ble_ots_set_oacp(val, need_send)读写 OACPneed_sendtrue时主动推送至客户端esp_ble_ots_get_olcp()/esp_ble_ots_set_olcp(val, need_send)读写 OLCPneed_sendtrue时主动推送esp_ble_ots_get_filter()/esp_ble_ots_set_filter()读写 Object List Filteresp_ble_ots_get_change()/esp_ble_ots_set_change(val, need_send)读写 Object Changeneed_sendtrue时主动推送大多数接口返回ESP_OK表示成功参数错误返回ESP_ERR_INVALID_ARG初始化类接口还可能返回ESP_ERR_NO_MEM/ESP_FAIL。7. 运行结果与验证方式7.1 预期串口输出烧录并复位后示例启动广播典型串口输出如下节选自 README.mdI (330) BLE_INIT: BT controller compile version [9359a4d] I (340) system_api: Base MAC address is not set I (340) system_api: read default base MAC address from EFUSE I (350) BLE_INIT: Bluetooth MAC: 58:cf:79:1e:9e:de I (350) phy_init: phy_version 1150,7c3c08f,Jan 24 2024,17:32:21 I (420) blecm_nimble: BLE Host Task Started I (420) blecm_nimble: No characteristic(0x2a00) found I (420) blecm_nimble: No characteristic(0x2a01) found I (420) blecm_nimble: No characteristic(0x2a05) found I (430) NimBLE: GAP procedure initiated: stop advertising. I (440) NimBLE: GAP procedure initiated: advertise; I (440) NimBLE: disc_mode2 I (440) NimBLE: adv_channel_map0 own_addr_type0 adv_filter_policy0 adv_itvl_min256 adv_itvl_max256 I (450) NimBLE: I (460) main_task: Returned from app_main()输出要点解读BLE_INIT日志确认蓝牙控制器已初始化Bluetooth MAC打印本机地址blecm_nimble: No characteristic(0x2a00) found等提示表示连接管理器未在服务中发现 GAP/ATT 基础特征本示例未注册这些特征属正常现象GAP procedure initiated: advertise表示广播已启动adv_itvl_min256 / adv_itvl_max256单位 0.625 ms即 160 ms 广播间隔最后app_main()返回主任务结束应用转入事件驱动模式。7.2 使用通用 BLE 扫描工具验证由于示例只做基础 OTS 通信演示使用任何通用 BLE 扫描/调试 App如 nRF Connect即可完成验证扫描到广播名为BLE_OTS默认值的设备并连接在 GATT 服务列表中查找0x1825服务及其 12 个特征读取 Object Size0x2AC0应看到 allocated256、current0连接建立时由esp_ble_ots_set_size()写入向 Object Name0x2ABE写入数据观察串口输出Object Name write event向 Object Properties0x2AC4写入属性位观察串口输出Object prop 0x...。8. 从示例到完整 OTS 应用的延伸方向补全 OACP/OLCP 流程示例仅在头文件中定义了操作码与响应码未实现对象创建/删除/读写。可在esp_ble_ots_set_oacp()/esp_ble_ots_set_olcp()的调用链上扩展解析逻辑并配合 Object Change 特征esp_ble_ots_set_change(..., true)向客户端推送变更通知结合连接管理器做多端管理esp_ble_conn_mgr组件还提供多种连接策略可在 components/bluetooth/ble_conn_mgr 中查阅参考同目录其他标准服务示例examples/bluetooth/ble_services下还有 ANS、BAS、CTS、HRS 等服务示例可对照学习标准服务组件的接入模式。如果遇到技术问题可以在项目仓库的 Issues 中反馈并附上复现日志与芯片型号。本示例以最小可验证为原则是理解 esp-iot-solution 中 BLE 标准服务组件工作原理的绝佳切入点。赞分享物联网嵌入式驱动开发硬件开发【免费下载链接】esp-iot-solutionEspressif IoT Library. IoT Device Drivers, Documentations and Solutions.项目地址https://gitcode.com/GitHub_Trending/es/esp-iot-solution点击查看免费下载相关推荐esp-iot-solution BLE Object Transfer Service (OTS) 详解基于 L2CAP CoC 的批量数据传输esp iot solution BLE Object Transfer Service OTS 详解基于 L2CAP CoC 的批量数据传输 BLE Obj物联网嵌入式驱动开发硬件开发ESP IoT Solution BLE 对象传输服务OTS实战指南基于 L2CAP 的批量数据管理与传输ESP IoT Solution BLE 对象传输服务OTS实战指南基于 L2CAP 的批量数据管理与传输 对象传输服务Object Transfer物联网嵌入式驱动开发硬件开发ESP-IoT-Solution BLE Alert Notification ServiceANS开发指南基于 esp_ble_conn_mgr 的 GATT 告警服务实现与实战ESP IoT Solution BLE Alert Notification ServiceANS开发指南基于 esp_ble_conn_mgr 的 G物联网嵌入式驱动开发硬件开发创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考