综合 SDK

更新时间：2022-11-24 09:20:02下载pdf

本文详细介绍了综合 SDK 相关的信息。

名词解释

名词	说明
网关	由于蓝牙 Mesh/Zigbee 设备没有直接上网的能力，所以需要通过另一种同时具有通信能力和联网能力的设备来联网，这个设备就是网关。网关是网络关口，就像大门一样，蓝牙 Mesh/Zigbee 设备的所有联网数据都要通过网关上传、下发。网关是一种特殊的设备，拥有蓝牙 Mesh/Zigbee 网关的本地网络将可以与云端进行通信。网关也可以同时具有灯、插座、报警器的功能。
SDK	为 Software Development Kit 的缩写，即软件开发工具包，是辅助开发软件的相关文档、示例、工具的集合。涂鸦根据多种系统或者语言提供了免费的 SDK。
PID	为 Product ID 的缩写。开发者在涂鸦 IoT 开发平台创建的每一个产品都会产生一个唯一的产品编号，即 PID。PID 关联了产品具体的功能、App 控制面板、出货信息等所有跟这个产品相关的信息。如果把产品比喻为人，那么 PID 则是产品的身份证。
UUID	为 Universally Unique Identifier 的缩写。在涂鸦智能开发智能化产品时，UUID是设备唯一的识别 ID。
Authkey	Authkey 是设备在云端注册时需要的密钥，和 UUID 是一一匹配的关系。
OTA	为 Over-the-Air 的缩写，涂鸦支持通过 OTA 升级设备固件。
DP	DP 为 Data Point 的缩写，即数据点，偶尔被称为 DP 点或功能点，表示智能设备所具备的功能。涂鸦智能将每个功能抽象成数据点，数据点定义成不同的类型，例如布尔、枚举、数值等。数据点具备读写属性。例如，一个两路的开关，可以抽象成两个数据点，每个数据点类型为布尔型，可取值为 `True` 或 `False`。数据点可读写，读表示获取开关目前的值，写表示改变开关目前的值。
DPID	指定通信协议下 DP 事件的 ID。
QR配网	指二维码配网。
本地联动	由云端下发，条件和动作的设备符合同一网关下的条件下发到网关，由网关判断执行。
局域网联动	一种能跨网关局域网内的本地自动化，在路由器外网断开的情况下，处于同一局域网系统的设备的联动仍然能执行。
Pegasus	是涂鸦闪电配网或无感配网的别称。
Zigbee	Zigbee技术是一种近距离、低复杂度、低功耗、低速率、低成本的双向无线通讯技术。
Zigbee 协调器	Zigbee 协调器是启动和配置网络的一种设备。协调器负责网络正常工作以及保持同网络其他设备的通信。一个 Zigbee 网络只允许有一个 Zigbee 协调器。
Zigbee NCP	NCP 指网关的 Zigbee 模组硬件，即为 Zigbee 协调器。
Zigbee Host	运行在 Zigbee 网关主控中的代码，通过串口与 NCP 进行通信，Host + NCP 组成了一套完整的网关 Zigbee 协议处理程序。
蓝牙 mesh	蓝牙 mesh 是一种通信方式，是在传统蓝牙的基础上用的 mesh 协议通信。
蓝牙 mesh 协议	蓝牙 Mesh 协议是一种支持 M2M（Many to Many，多对多）拓扑的网络协议。蓝牙 Mesh 的基础是蓝牙。支持蓝牙 Mesh 的设备，可以对单点蓝牙 4.0、5.0 协议进行了支持。

产品概述

Tuya IoTOS 综合 SDK 采用分层、插拔式组件的方式设计，各个业务被划分成独立的组件库，开发者按需链接对应的组件库，以实现快速构建具有差异性的网关产品。

SDK 提供基本的连接涂鸦云的能力，支持工程施工、故障替换、本地自动化以及跨网关局域网联动等功能。

SDK 还提供设备管理的能力，搭配涂鸦网关 Zigbee 模组和蓝牙模组，可以低代码实现涂鸦生态子设备接入，也可以使用自定义模组，如 Zigbee、433、485、Z-Wave、Lora 等，把子设备接入到涂鸦生态，与涂鸦生态其他智能设备互联互通。

SDK 还提供安防、红外、中控、路由器和中继器等能力，支持开发复合型网关。

基于 SDK 能够开发的产品有：

搭配涂鸦网关 Zigbee 模组，低代码实现接入涂鸦生态 Zigbee 子设备的网关产品。同时，支持接入第三方 Zigbee 子设备，与涂鸦生态的智能设备互联互通。
搭配涂鸦网关蓝牙模组，低代码实现接入涂鸦生态蓝牙子设备的网关产品，支持蓝牙配网。
特定协议模组，实现特定协议的网关产品，把子设备接入到涂鸦生态，与涂鸦生态的智能设备互联互通。
低代码实现路由器和中继器产品。
低代码实现安抚网关产品。
低代码实现中控产品。
更多产品敬请期待…

技术架构

综合 SDK

目录结构

.
├── apps                # 应用示例代码目录，开发者可以根据需求修改
├── build_app.sh        # 编译脚本
├── CHANGELOG.md        # 版本信息
├── doc                 # API 文档
├── gen_demo.py         # （可选）demo 示例代码生成脚本
├── platforms           # 工具链，编译时会自动把工具链下载到该目录下
├── README.md           
├── sdk
│   ├── include         # SDK 头文件
│   └── lib             # SDK 库文件，开发者可以按需链接
└── template            # （可选）demo 模板文件，gen_demo.py 使用

综合 SDK

名词解释

产品概述

技术架构

目录结构

相关文档