快速开始

更新时间:2024-12-13 07:18:59下载pdf

获取开发包

在开发之前,先了解 网关 TuyaOS 的开发模式,根据实际需求选择合适的开发模式,然后申请开通对应的开发包白名单权限。审核通过后,则可以通过 Tuya Wind IDE 下载开发包。

目录结构

.
├── hardware
├── pc
├── software
│   ├── SDKInformation.json
│   ├── TuyaOS                 # TuyaOS 工程
│   │   ├── CHANGELOG.md
│   │   ├── LICENSE
│   │   ├── README.md
│   │   ├── RELEASE.md
│   │   ├── adapter
│   │   ├── apps               # 各种示例工程
│   │   ├── build
│   │   ├── build_app.sh       # 编译脚本
│   │   ├── docs               # 开发文档&接口文档
│   │   ├── include            # SDK 头文件
│   │   └── libs               # SDK 库文件
│   └── packages               # 附属产物包目录
└── tuya.json

附属产物包

网关产物包有多种形态,按配网方式划分,有 4 种形态:

  1. 仅支持有线配网。
  2. 仅支持无线配网。
  3. 支持有线 + 无线配网。
  4. 支持有线 + 无线 + 蓝牙配网。

它们都是以独立的产物包形式存在,放置在附属产物包目录下,其命名规则如下:

产物包名称 说明
*_eth-gw-com_* 仅支持有线配网
*_wifi-gw-com_* 仅支持无线配网
*_eth-wifi-gw-com_* 支持有线 + 无线配网
*_eth-wifi-ble-gw-com_* 支持有线 + 无线 + 蓝牙配网

默认指定其中一个附属产物包作为主产物包,IDE 下载开发包后,会自动解压主产物包到 TuyaOS 目录。

如果想要把当前主产物包替换成其他附属产物包,如附属产物包名称为 tuyaos-gw-integrated_3.5.6_ubuntu-x64_eth-gw-com_0.0.1.tar.gz,打开命令行终端并切换到已下载的开发包所在目录,执行以下命令:

$ cd software && rm -fr TuyaOS/include/ TuyaOS/libs/
$ tar xvf packages/tuyaos-gw-integrated_3.5.6_ubuntu-x64_eth-gw-com_0.0.1.tar.gz

快速体验

Tuya Wind IDE 集成了编译功能。编译时,编译脚本会自动下载交叉编译工具链,无需手动指定交叉编译工具链。

  1. 选择要编译的示例工程,单击右键,在弹出的菜单中选择 Build Project

    快速开始

  2. 选择 Build Project 后,在弹出的文本框中输入固件版本号(格式为 x.x.x),按回车健开始编译。

    快速开始

  3. 编译成功后,会在 output/<示例工程名称>_<版本号> 目录生成一个可执行文件,把它拷贝到目标板子上运行即可。

  4. 在使用示例工程之前,需要先阅读示例工程的使用文档。选择 docs 目录,右键单击,在弹出的菜单中选择 Quick Start,则会打开文档向导,单击对应的链接就可以阅读示例工程的使用文档了。

    快速开始

下一步

经过上面的操作步骤,我们已经掌握了如何获取开发包,以及如何编译和使用它,并跑通了网关设备的激活流程。

接下来,根据产品的实际需求,结合开发文档(docs 目录下)在示例工程基础上新增相应的功能。当然,也可以新建一个工程从零开始开发。