# qcloud-iot-explorer-BLE-ADV-sdk-embedded

**Repository Path**: mirrors_tencentyun/qcloud-iot-explorer-BLE-ADV-sdk-embedded

## Basic Information

- **Project Name**: qcloud-iot-explorer-BLE-ADV-sdk-embedded
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-10-22
- **Last Updated**: 2025-07-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 概述

LLSync ADV SDK 提供了一种LLSync ADV 协议接入腾讯云物联网开发平台的方案，SDK内实现了LLSync ADV 协议和腾讯连连进行通信，打通了 `BLE设备-APP(网关设备)-物联网开发平台` 的数据链路，支持开发者快速接入 BLE 设备到物联网开发平台。开发者接入 LLSync ADV SDK 需要做的工作有：

1. 添加蓝牙设备广播、扫描、定时器的启停接口，以及flash的读写操作
2. 通过脚本将数据模板转换为C代码，添加相应的数据处理

LLSync ADV SDK 封装了协议实现细节和数据传输过程，让开发者可以聚焦在数据处理上，以达到快速开发的目的。


## 软件架构

LLSync ADV SDK 结构框图:

![LLSync ADV 结构框图](https://main.qcloudimg.com/raw/e869f212105bf305ea28b71490523f05.png)

SDK 分三层设计，从上至下分别为应用层、LLSync ADV 核心层、HAL 移植层。

* 应用层：LLSync ADV SDK 生成了数据模板的模板文件，用户需要根据需求做具体实现。
* LLSync ADV 核心组件：实现了 BLE ADV 设备和App (网关设备)之间的通信协议，身份认证，数据解析等功能，用户一般无需改动即可使用。
* HAL 移植层：主要是适配 BLE 广播、扫描、定时器的启停接口，以及flash的读写操作。

## 目录结构

| 名称               | 说明                                                         |
| ------------------ | ------------------------------------------------------------|
| docs               | 文档目录，SDK使用说明文档                                     |
| samples            | 应用示例                                                     |
| include            | 提供给用户使用的外部头文件                                    |
| sdk_src            | SDK核心通信协议及服务代码                                    |
| config             | 用户需配置的宏定义，例如定时器周期等                           |
| hal                | 用户适配的接口，例如广播启停等                                |
| scripts            | 生成数据模板的脚本文件                                       |
| data_template      | 数据模板代码放置目录                                         |

## 移植指引

请参见 [移植指引](./docs/LLSync%20ADV%20SDK接入指引.md)