简体中文
简体中文
English
联系我们
注册
登录
layout空间导航

创建应用

更新时间:2022-12-05 10:17:41下载pdf

流程概述

首先,在 涂鸦 IoT 开发平台 上创建产品,配置功能,并获取后续开发所需的资料信息。然后,可以在 Tuya Wind IDE 下载所需的开发资料,进行产品功能的开发调试。待产品功能稳定后,可将测试报告上传至涂鸦 IoT 开发平台并发布产品,后续即可进入相应的产品量产流程,这就是产品开发的大体流程。

创建应用

创建产品

本章节以创建自定义开发光源产品为例,讲解在涂鸦 IoT 开发平台创建产品的整个流程。

选择品类

  1. 进入 涂鸦 IoT 开发平台,使用先前注册的账号登录。

  2. 在侧边栏单击 产品 > 产品开发 > 创建产品

    创建应用

  3. 在标准类目中,选择 照明 > 照明通用 > 光源

    创建应用

  4. 选择 光源 > 产品开发 > 自定义方案 > 光源

    • 如果选择 零代码实现,那么开发者可以在平台上在线配置功能并直接生成固件。
    • 如果选择 自定义方案,那么开发者可以使用 Tuya Wind IDE 开发自定义功能,相对于零代码实现会更加灵活, 这里需要选择 自定义方案

    创建应用

  5. 填写 产品名称,通讯协议根据模组对应选择即可,之后单击 创建产品

    创建应用

选择功能

创建产品后,需要为产品选择功能。左边列表栏是可以选择的功能,右边列表栏是已经选择的功能,开发者可以根据实际应用场景选择对应的功能。

  1. 这里只选择必选功能,单击 删除可选功能,并单击 确定

    创建应用

  2. 选择功能后,会跳转到 功能定义 界面。产品名称下方是产品的 PID 信息,中间是为产品选择的功能,可以看到功能的 ID 和数据类型等。如果想要添加功能,可以单击后面的 添加功能 进行调整。

    创建应用

  3. 在该界面下方,可以看到自定义功能栏和高级功能栏。

    • 在自定义功能栏,可以添加自定义功能。

    • 高级功能栏处是可选的功能,有照明情景库、色温值配置等高级功能。开发者可以根据实际应用进行调整。

      创建应用

选择控制面板

  1. 单击 设备交互,在 面板控制 栏中为产品选择控制面板,控制面板就是在智能生活 App 上控制设备的界面样式,不同的控制面板界面、控件风格会有所不同。平台提供了大量的公版面板供开发者选择,开发者也可以使用涂鸦提供的开发工具包,自定义开发面板或者定制面板。这里以公版面板为例。

    创建应用

  2. 选择控制面板后,还可以更换面板或者简单地编辑面板。开发者可以使用智能生活 App 扫描右侧的二维码体验面板。

    创建应用

选择硬件模组

  1. 单击 硬件开发,接入方式选择 TuyaOS

    创建应用

  2. 可以在该界面选择所使用的模组,单击 硬件详情 可以查看模组的主频,外设参数等等,开发者根据实际应用进行选择。这里选择 CBU Wi-Fi & Bluetooth 模组

    创建应用

到此,产品创建配置就完成了,通常只需要为产品 选择功能选择面板选择硬件 即可。

领取授权码

只有经过授权的模组才能接入涂鸦 IoT 开发平台。每个账号都可以领取免费授权码。

  1. 单击 硬件开发 后,单击 免费领取2个授权码

    创建应用

  2. 提示账号最多可领取 6 个免费授权码,单击 确定

    创建应用

  3. 交付方式选择 授权码清单,单击 确认领取

  4. 单击 提交订单

    创建应用

  5. 单击 去订单列表页看看

  6. 单击 下载授权码清单

    创建应用

  7. 获取并输入验证码,单击 确认生成并下载

    创建应用

  8. 之后,系统会自动下载保存授权码信息的表格。

    创建应用

    有关 UUID 和 key 的介绍,可以参考 什么是云端授权码

下载开发框架

下载开发框架

本教程中以 联网单品开发:Wi-Fi BLE 双模设备开发包 作为示例。

  1. 打开 Tuya Wind IDE,选择 新建开发框架

    创建应用

  2. 开发模式选择 TuyaOS OS 开发,类型开发包、开发平台和版本选择对应的即可,输入项目名称。

    创建应用

  3. 因为该框架是 Windows + 虚拟机开发,为了方便后续烧录固件,调整项目保存位置,将其保存到使用 smaba 工具创建的共享文件路径下。

    创建应用

  4. 设定好路径后,单击 完成,等待框架下载完成。

    创建应用

查看文档

在开发框架 software/TuyaOS/Apps 路径下的有个 tuyaos_demo_quickstart 工程,本章节是以此 Demo 工程为基础稍作修改完成的,开发者可以查看 Demo 文档熟悉其实现流程。

  1. 在 TuyaOS 目录上右键选择 Quick Start 打开 TuyaOS 文档向导

    创建应用

  2. 单击 quickstart Demo 文档。

    创建应用

  3. 文档中介绍了环境准备,开发流程,编译烧录等内容,开发者可自行查看。

    创建应用

修改 PID 和授权信息

Quickstart Demo 中实现了 TuyaOS 的初始化,无线配网,DP 通讯等功能,把编译生成的程序固件烧录到模组中后,对其进行配网,之后便可以在手机端使用涂鸦智能 APP 控制模组上的 LED 状态,同时也可以使用板载的按键来控制 LED 状态,并将 LED 状态发送到 APP 端,实现双向通讯,在 APP 端还能实现离线提醒、定时关闭等高级功能。接下来我们就基于这个 Demo 进行修改,填入刚才创建的产品 PID 和授权信息。

修改 PID

在产品的 功能定义 界面上方,找到产品的 PID。每个产品都有自己独有的 PID,PID 也关联着设备的功能点和控制面板。

创建应用

打开下载好的开发框架,找到 software/TuyaOS/Apps 路径下的 tuyaos_demo_quickstart 工程(下面简称 quickstart Demo),打开工程下的 tuya_device.c 文件,将 PID 信息修改成自己创建的产品的 PID 即可。

创建应用

修改授权信息

在产品开发过程中,难免需要反复烧录授权。如果每次都使用云模组烧录授权平台会比较繁琐,所以在产品开发阶段,可以使用在程序中设定授权信息的方式进行授权。

打开 tuya_device.c 文件,可以看到包含授权信息的宏定义 UUID 和 AUTHKEY,用自己申请的授权码进行替换,程序中会调用相关函数将授权信息写入模组完成授权。

当产品开发完成后需要批量烧录授权时,要注释掉有关授权的程序,避免多个设备使用同一个授权码。可以使用涂鸦的云模组烧录授权平台进行授权,也可以自行进行烧录授权。

创建应用

固件烧录

生成固件

修改 PID 和授权码后,编译项目生成烧录固件。

  1. 在 quickstart Demo 上右键选择 Build Project

    创建应用

  2. 输入版本号。

    创建应用

  3. 首次编译需要下载文件,下载完成后会自动编译。编译完成后会在项目下生成 output 文件,其中保存着编译生成的固件。

    创建应用

硬件开发板

硬件开发板使用涂鸦三明治开发板中的 CBU 主控板,板载的 CBU 模组使用 BK7231N 芯片。如需购买,请访问 Soc CBU 主控板

创建应用

使用 USB 数据线将 CBU 主控板连接至电脑。此时电脑端会多出两个端口,是因为板载的 CH343 是双通道 USB 转 TTL 芯片,一个通道用于程序下载,另一个通道用于输出系统日志,方便开发者进行开发调试。

烧录工具

不同的开发平台对应的原厂烧录方式不一样。开发者可以查看开发框架下 pc/tools 目录下的烧录工具和说明文档,使用支持 Markdown 语法的编辑器打开说明文档。

创建应用

文档里详细介绍了如何使用原厂烧录工具烧录固件。

创建应用

Demo 演示

设备配网

使用不同的模组,配网的流程也有所不同。目前主要有两种配网方式,分别是 Wi-Fi 配网和蓝牙配网,主推的是蓝牙配网。这里使用 CBU 模组,采用 7.1 Wi-Fi&Bluetooth LE 双模芯片,默认使用蓝牙配网。

需要使用 智能生活 App 给模组配网。

  1. 在手机应用商店搜索下载,并注册登录。

  2. 在首页单击 添加设备,这时需要给模组上电,同时打开手机的 Wi-Fi 和蓝牙

    创建应用
  3. 当模组处于配网状态时会被搜索到,单击 添加

    创建应用

    设备名称就是在涂鸦 IoT 开发平台创建的产品名称。这里是 一路白光灯,单击设备后面的添加按钮。

    创建应用
  4. 选择需要模组连接的 Wi-Fi 名称,输入 Wi-Fi 密码后,单击 下一步

    创建应用
  5. 配网成功后,会提示设备添加成功,单击 完成 即可。

    创建应用
  6. 添加完成后,可以在 App 首页看到添加成功的设备,单击设备会进入该设备的控制界面。

    创建应用

    设备的控制面板可以在涂鸦 IoT 开发平台进行配置。在涂鸦 IoT 开发平台修改设备面板后,再次打开 App 时,控制面板会自动更新。

App 控制 LED

按下控制面板底部的电源键,可以看到 CBU 主板上的 LED 开启变亮。同时控制面板切换到开启状态,再次按下电源键主板上的 LED 关闭变暗,面板切换成关闭状态。

创建应用 创建应用

按键控制 LED

按下 CBU 主板上左侧的按键,可以看到主板上的灯变亮。同时 App 端该设备的控制面板的状态切换到打开状态,再次按下灯变暗,控制面板切换到关闭状态。

重置配网状态

App 重置配网

App 重置配网时,设备必须处于在线状态。

  1. 打开智能生活 App,长按设备会自动跳转到设备移除界面,选择需要移除的设备。

    创建应用
  2. 单击 移除设备,会提示设备移除后相关场景会失效,单击 确定

    创建应用
  3. 单击 完成

    创建应用

手动移除设备后,设备会自动重置配网状态,并进入配网模式。此时看到板载的 LED 会闪烁,说明重置成功,可以重新给模组配网。

本地重置配网

本地重置配网通过 CBU 主控板上的按键来实现,长按按键 3 秒后会自动重置设备配网状态,并进入配网模式。此时看到板载的 LED 会闪烁,说明重置成功,可以重新给模组配网。