TuyaOS(旧版)

TuyaOS 是一种基于 RTOS、Linux、Non-OS 等设计的应用于物联网（IoT）领域面向全连接、全场景的分布式跨平台操作系统。

概述

通过 TuyaOS 内核（Kernel）标准的制订及设计，让您能够从不同的芯片平台、系统及连接协议等糟糕的碎片化开发体验中得到解放，专注于自身业务的发展，并且一次开发、多端可用、安全稳定加快产品上市。

TuyaOS 整体架构采用分层、可插拔组件的方式设计，可根据芯片资源状况自由裁剪，生成符合资源需求的开发框架。通过涂鸦独有的 DP 协议及自研高效的 RPC 通信机制，使得所有采用 TuyaOS 开发的不同通信协议的产品之间，能够互联互通。

技术架构

开发框架

TuyaOS 支持按需裁减定制，本章节对涂鸦目前基于 TuyaOS 裁减后对外提供的几种类型的开发包进行简单介绍，开发者可以根据自己产品的实际情况，选择合适的开发包使用

开发包名称	接入方案	适用条件	说明
联网控制开发包	Wi-Fi设备接入	涂鸦标准模组接入	涂鸦提供标准模组和适配后的开发包，开发包封装了 HAL 硬件层、系统层、网络层、OTA 等接口函数，您只需调用相关接口函数进行应用代码开发，无需适配，也无需关心复杂的功能逻辑，即可快速完成产品智能化。
		第三方芯片接入	涂鸦基于您的开发环境和编译选项生成库文件，您将库文件集成到自身 SDK 内，对相关 API 接口进行适配，适配完成后，再进行应用代码的开发，即可完成产品智能化
	4G LTE Cat.1设备接入	涂鸦标准模组接入	涂鸦提供标准模组、适配后的开发包和底层固件，开发包封装了 HAL 硬件层、系统层、网络层、OTA 等接口函数，您只需调用相关接口函数进行应用代码开发，无需适配，也无需关心复杂的功能逻辑，即可快速完成产品智能化。
		第三方芯片接入	涂鸦提供 Link SDK，您将 SDK 代码集成到自身系统内，调用相关 API 接口进行应用代码的开发，即可完成设备接入
	屏幕类设备接入	第三方芯片接入	涂鸦基于您的芯片开发环境和编译链工具生成库文件 ，以动态链接库（.so）或者静态库（.a）提供给您集成到现有设备内，调用相关的接口完成应用代码开发，即可使用涂鸦 App 扫码配网将设备连接到涂鸦开发者平台，实现产品智能化。
	语音设备接入	涂鸦标准模组接入	涂鸦提供标准模组和适配后的开发包，开发包封装了 HAL 硬件层、系统层、网络层、OTA 等接口函数，您只需调用相关接口函数进行应用代码开发，无需适配，也无需关心复杂的功能逻辑，即可快速完成产品智能化。
		第三方芯片接入	涂鸦基于您的开发环境和编译选项生成库文件，您将库文件集成到自身 SDK 内，对相关 API 接口进行适配，适配完成后，再进行应用代码的开发，即可完成产品智能化
子设备开发包	蓝牙设备接入	涂鸦标准模组接入	涂鸦提供适配了蓝牙协议的 SDK ，SDK 封装了蓝牙协议栈、应用回调、应用功能等接口函数，您只需调用相关接口函数进行应用代码开发，无需关心复杂的功能逻辑，即可快速完成产品智能化。
		第三方芯片接入	涂鸦基于您的开发环境和编译选项生成库文件，您将库文件集成到自身 SDK 内，对相关 API 接口进行适配，适配完成后，再进行应用代码的开发，即可完成产品智能化
	蓝牙 Mesh设备接入	涂鸦标准模组接入	涂鸦提供适配了蓝牙 Mesh 协议的 SDK ，SDK 封装了蓝牙 Mesh 协议栈、应用回调、应用功能等接口函数，您只需调用相关接口函数进行应用代码开发，无需关心复杂的功能逻辑，即可快速完成产品智能化。
		第三方芯片接入	涂鸦提供标准蓝牙 Mesh 接入协议和接入方法，您参考相关接入标准，自行根据协议接入涂鸦云
	Zigbee设备接入	涂鸦标准模组接入	涂鸦提供适配了 Zigbee 协议的 SDK ，SDK 封装了 Zigbee 协议栈、应用回调、应用功能等接口函数，您只需调用相关接口函数进行应用代码开发，无需关心复杂的功能逻辑，即可快速完成产品智能化。
网关开发包	基础联网网关接入	不管理涂鸦设备	涂鸦提供基于标准 Linux 系统的联网开发包，您将其集成到设备的软件中，可完成网关开发。开发包封装了涂鸦标准网关的通用接口，具体业务实现需要您自主开发，该方案开发的网关下行协议类型完全由您自主定义开发，故此方案开发的网关只能接入您自研的子设备，不支持接入涂鸦生态子设备。
	扩展网关接入	管理涂鸦设备	涂鸦提供基于标准 Linux 系统的扩展开发包和标准 Zigbee 模组，您将其集成到设备中，可完成网关开发。相比网关基础联网接入方案，此方案涂鸦提供烧录涂鸦网关固件的 Zigbee 模组，模组作为 Zigbee 网络协调器的角色，可直接接入涂鸦生态的 Zigbee 子设备，同时也支持您自行开发接入自研的 Zigbee设备和其他协议设备，此方案功能更强、更灵活。
	综合网关接入	多功能网关设备	综合网关开发包提供除了基本的连接涂鸦云的能力，还可以具备网关能力。同时也可以融合红外，中控，涂鸦生态 Zigbee 网关，涂鸦生态 Bluetooth LE 网关，路由器以及中继器，无感配网等业务。
中控开发包	中控设备接入	管理涂鸦设备	涂鸦提供中控开发包，您将其集成到设备中，可完成中控设备开发，支持全屋管理，可以将家庭下子设备纳入管理中，已实现了读取设备/读取场景/配置设备/设备状态上报等功能、封装了灯具、开关、插座、空调窗帘等品类，同时局域网环境下支持控制子设备和 Wi-Fi 单品，并支持上下线感知
IPC 开发包	IP 摄像机接入	第三方芯片接入	涂鸦将复杂的 IPC 音视频、P2P、设备控制、OTA 等功能进行接口封装，根据您的芯片平台打包成库 ，您可以将库集成到现有设备内，无需关心设备功能复杂的实现方式，只需调用相关接口进行应用代码开发，即可快速完成 IPC 产品智能化。
NVR 开发包	NVR设备接入	第三方芯片接入	涂鸦将复杂的 IPC 接入、存储、管理、控制等 NVR 常用功能进行接口封装，根据您的芯片平台打包成库 ，您可以将库集成到现有设备内，无需关心设备功能复杂的实现方式，只需调用相关接口进行应用代码开发，即可快速完成 NVR 产品智能化。
MCU 基础开发包	Wi-Fi设备接入	涂鸦标准模组接入	涂鸦提供支持 Wi-Fi 协议的开发包和标准模组，开发包对上下行通信、OTA、数据解析等功能进行函数接口封装，您可以将开发包移植到 MCU 内进行接口适配，并调用相关接口完成应用代码开发，即可实现产品智能化。
	Wi-Fi Homekit设备接入	涂鸦标准模组接入	涂鸦提供支持 Wi-Fi Homekit 协议的开发包和标准模组，开发包对上下行通信、OTA、数据解析等功能进行函数接口封装，您可以将开发包移植到 MCU 内进行接口适配，并调用相关接口完成应用代码开发，即可实现产品智能化。
	蓝牙设备接入	涂鸦标准模组接入	涂鸦提供支持蓝牙协议的开发包和标准模组，开发包对上下行通信、OTA、数据解析等功能进行函数接口封装，您可以将开发包移植到 MCU 内进行接口适配，并调用相关接口完成应用代码开发，即可实现产品智能化。
	蓝牙 Mesh设备接入	涂鸦标准模组接入	涂鸦提供支持蓝牙 Mesh 协议的开发包和标准模组，开发包对上下行通信、OTA、数据解析等功能进行函数接口封装，您可以将开发包移植到 MCU 内进行接口适配，并调用相关接口完成应用代码开发，即可实现产品智能化。
	Zigbee设备接入	涂鸦标准模组接入	涂鸦提供支持 Zigbee 协议的开发包和标准模组，开发包对上下行通信、OTA、数据解析等功能进行函数接口封装，您可以将开发包移植到 MCU 内进行接口适配，并调用相关接口完成应用代码开发，即可实现产品智能化。
	NB-智能设备接入	涂鸦标准模组接入	涂鸦提供支持 NB-IoT 协议的开发包和标准模组，开发包对上下行通信、OTA、数据解析等功能进行函数接口封装，您可以将开发包移植到 MCU 内进行接口适配，并调用相关接口完成应用代码开发，即可实现产品智能化。
	LTE Cat.1设备接入	涂鸦标准模组接入	涂鸦提供支持 LTE Cat.1 协议的开发包和标准模组，开发包对上下行通信、OTA、数据解析等功能进行函数接口封装，您可以将开发包移植到 MCU 内进行接口适配，并调用相关接口完成应用代码开发，即可实现产品智能化。
	调试助手	涂鸦标准模组接入	涂鸦提供调试助手，既可以模拟标准模组验证 MCU 代码逻辑，也可以模拟 MCU 调试配网功能，功能多样，使用方便。

开发流程

第一步：开发包获取

本小节仅简单介绍创建获取开发包的必要步骤，详情请参考 Tuya Wind IDE 使用说明。

1. 使用 涂鸦开发者平台 账号登录 IDE 并进入快速入口页面后，单击 创建新框架。

   
   

2. 根据自己的需求，选择合适的开发框架。

   

3. （可选）如果自定义下载位置，需要去除勾选 使用默认位置，再到以下界面中选择自定义的目录进行下载。

   注意：您对所选择的下载目录必须具有写入权限，否则会导致下载失败。

   

4. 单击 完成 进入到开发框架创建步骤。创建开发框架需要一定的时间，耐心等待进度完成即可。

   

5. 开发框架生成后，IDE 会自动在项目的左侧添加开发框架的全部内容。

   

6. 展开左侧 TuyaOS > apps 目录，选择其中一个 Demo 的目录并右键单击，再选择菜单中的 Compile Project。

   

7. 输入版本号(格式为 x.x.x)后，按下回车键。

   

8. 等待编译完成，即可将 Demo 固件烧录到设备内运行，验证 Demo 功能。

   

第二步：创建产品

本小节仅简单介绍创建智能产品的必要步骤，详情请参考 选品类创建产品。

1. 登录 涂鸦开发者平台。

2. 选择对应的开发方案和联网方式。此处以 Wi-Fi+蓝牙 设备开发方式为例演示。

   • 开发方案：零代码方案选择 零代码实现，其他 TuyaOS 开发方案选择 自定义方案。
   • 联网方式：该选择决定着通信协议和平台模组推荐。

   

3. 参考 标准功能说明 和 自定义功能 为创建的产品添加功能。

   涂鸦将产品功能的抽象叫做 DP（功能点），涂鸦为所有产品提供了标准的功能点。您可以根据产品实际需求，选择对应的产品功能点。

   

4. 参考 配置 App 界面 为 App 配置设备面板。

   App 中，设备的控制界面，通常称为面板。涂鸦提供近百种品类的公版面板供您免费选择，公版面板支持个性化修改。若您有自定义需求，涂鸦也可提供定制面板开发服务。

第三步：应用开发

创建产品后，在平台可购买模组样品和开发板，进入开发调试环节。

第一步下载的开发包内有多个 Demo 可以用于参考，您可以可以结合 开发方案 对应的 SDK 开发说明文档 以及 Demo 中心 中的教程进行应用代码开发。

第四步：烧录授权

应用代码开发完成后，需要将固件和对应的授权码烧录到设备内，才可以连接涂鸦开发者平台。

不同的 开发方案，不同的通信协议的设备烧录方式各不相同，根据是否需要您自行烧录，可以分为以下两种烧录类型：

• 涂鸦烧录授权码

  针对零代码开发方案和 MCU SDK 开发方案，涂鸦提供的模组已经烧录了固件和授权码，您无需再进行烧录授权，直接使用即可。

• 自行烧录授权码

  针对其他 SDK 开发方案，您开发完应用代码后，需要自行烧录固件和授权码验证应用代码功能。不同芯片平台的烧录方式各不相同，详情请参考 烧录授权 目录下各芯片的详细说明文档。

第五步：功能调试

功能调试时，经常需要查看云端的 设备日志数据 判断问题。详情请参考 运营中心 的设备日志查询章节。

第六步(可选)：OTA 升级

涂鸦开发者平台支持多种升级方式，您只需将升级固件上传至涂鸦开发者平台，对升级方式和升级文案进行相关配置，即可实现升级推送，完成设备 OTA 升级，关于 OTA 升级的详细说明，请参考 固件升级。