快速开始

更新时间:2026-04-10 02:07:51LLM 副本以 Markdown 格式查看下载 PDF

本文介绍开发包中的重要文件,便于您更好地理解代码的组织结构。

目录结构

开发包整体目录结构如下:

├── hardware                  # 硬件手册,存放涂鸦自研硬件资料
├── pc
│    └── tools                # 工具类目录,存放各种开发相关工具
├── software
│    ├── packages             # SDK 压缩包
│    ├── SDKInformation.json  # SDK 信息文件
│    └── TuyaOS               # SDK 开发包目录
│        ├── apps             # 应用示例代码目录,您可以根据需求修改
│        ├── build
│        ├── build_app.sh     # 编译脚本
│        ├── CHANGELOG.md
│        ├── include          # SDK 头文件
│        ├── libs             # SDK 库文件,您可以按需链接
│        ├── LICENSE          # Tuya MIT License
│        ├── Makefile
│        ├── output           # 产物输出目录
│        ├── README.md
│        ├── scripts
│        └── vendor           # 工具链,编译时会自动把工具链下载到该目录下
└── tuya.json

TuyaOS > apps > 8711daf_gateway-tuyaos_rtos_zigbee_demo 目录结构:

|—— application_components        #开源组件
|—— application_drivers                  
|—— build                         #打包到固件的文件
|—— include                       #应用头文件
|—— libs                          #应用库文件
|—— src                           #应用源文件
|—— output                        #输出目录
|—— README.md
└── build.conf                    #编译配置

配置

RTOS 网关需要在初始化时生成一份 JSON 配置,如下所示:

{
    "pid": <xxx>,
    "uuid": <...>,
    "authkey_key": <...>,
    "ap_ssid": <... optional>,
    "ap_password": <... optional>,
    "log_level": <level>,
    "storage_path": <...>,
    "start_mode": <xxxx>,
    "tuya": {
        "zigbee": {
                "dev_name": <xxx, string>,
                "cts": <xxx, bool>,
                "thread_mode": <xxx, bool>,
                "dev_txt_sta": <xxx, bool>,
        },
    },
    "user": {
        [ { "tp": <DEV_ATTACH_MOD_X, number>, "sw_ver": <version, string> }, ... ]
    },
}

公共配置

字段 必须 说明
PID SDK 运行在非 OEM 模式,PID 字段指定此设备 PID
uuid 唯一识别码,优先从 Flash 读取,不存在时使用此处
authkey_key 授权识别码,优先从 Flash 读取,不存在时使用此处
ap_ssid 热点模式配网 SSID,未指定则使用默认 SmartLife-<WLAN MAC 后四位>
ap_password 热点模式配网密码,默认为空
log_level 日志等级,默认为 Debug 等级 4
start_mode Wi-Fi 配网模式,支持以下类型:
  • 0WF_START_AP_ONLY 仅支持热点模式配网
  • 1WF_START_SMART_ONLY 仅支持快连模式配网
  • 2WF_START_AP_FIRST 支持 热点模式 + 快连模式 配网,热点模式优先
  • 3WF_START_SMART_FIRST 支持 热点模式 + 快连模式 配网,快连模式优先
  • 4WF_START_SMART_AP_CONCURRENT 热点模式 和 快连模式 共存

Zigbee 配置

字段 说明
dev_name Zigbee 设备名
cts 是否支持硬件流控
thread_mode 使用用户态线程(pthread)或进程(fork)启动服务;TRUE:线程,FALSE:进程
dev_txt_sta TRUE:devices.txt 需要更新;FALSE:无需更新

编译

工具链解压依赖 unzip 工具,编译前输入以下命令:

sudo apt install unzip

按照如下步骤操作,在 Visual Studio Code 上编译 SDK-WR11-G 固件:

  1. 展开开发包的 TuyaOS > apps 目录,并单击右键,在菜单中选择 Build Project,然后输入版本号按下回车键,开始编译。

    快速开始

    快速开始

  2. 观察 Visual Studio Code 下方的 终端,会看到编译的输出打印。直到看到如下图所示的打印时,代表编译成功,生成的固件位于 output 目录下。

    快速开始

固件烧录

固件详情和烧录方法,请参考 固件烧录 章节。

运行

前置工作完成后,接下来可以运行示例程序查看效果。

固件烧录完成之后,断电重启设备。

WR11-G 支持蓝牙配网、热点模式配网,可以用 涂鸦 app 来激活网关。App 的详细使用教程,请参考 使用指南

上传固件

详细步骤,请参考 固件升级