创建照明产品

更新时间:2023-05-16 09:28:01下载pdf

本文以 Wi-Fi 五路彩灯(RGBCW)产品为例,介绍如何在涂鸦 IoT 平台上产品创建免开发方案照明产品。

背景信息

涂鸦 IoT 平台免开发 LED 照明产品包含四类通信方式,每类都包含五种控制方式。

通信方式 控制方式
Wi-Fi
  • 单色可调白光灯(C)
  • 双色冷暖灯(CW)、双色冷暖灯(CCT)
  • 彩灯(RGB)
  • 彩灯(RGBC)
  • 彩灯(RGBCW)、彩灯(RGBCCT)
Zigbee
BLEmesh(SIG)
BLEmesh (Tuya)

创建照明产品

操作步骤

  1. 登录 涂鸦 IoT 平台

  2. 单击 创建产品
    创建照明产品

  3. 标准类目 区域中,选择 照明 > 光源
    创建照明产品

  4. 选择产品方案 区域中,选择 零代码实现 > Wi-Fi > 彩灯五路(RGBCW_Wi-Fi)
    创建照明产品

    说明:如免开发方案产品功能无法满足需求,请参考 SoC 定制固件流程 进行自定义方案开发。

  5. 填写产品信息。

    • 产品名称(必选):填写品牌名和产品名。该名称用于显示在 App 控制界面。
    • 产品型号(可选):填写产品型号。可填入多个型号,使用半角逗号(,)分隔。

      说明:产品型号不会在 App 上显示,建议填写内部型号名称或客户产品型号,以便您在平台上进行产品维护以及订单管理。

    创建照明产品

  6. 单击 创建产品
    产品创建完成后,页面自动跳转至 功能定义 步骤的 添加标准功能 弹窗。

定义产品功能

操作步骤

  1. 添加标准功能 窗口中,选择需要的产品功能后单击 确定
    添加功能定义

    说明:必选功能无法从已选功能中删除。

  2. (可选)在 功能定义 页面,根据需要启用云功能。
    创建照明产品

  3. 在页面底部,单击 下一步:App 面板
    页面跳转至 App 面板 步骤。

配置 App 面板

本文以选择一款可视化面板并使用其默认配置为例进行介绍,如需定制或者编辑面板元素,请参考界面提示进行修改。

操作步骤

  1. App 面板 界面中,移动鼠标至目标面板后,单击 使用此模板
    创建照明产品

  2. (可选)更换、编辑面板,并使用涂鸦智能 App 扫码体验手机控制功能。
    创建照明产品

  3. 单击 下一步:硬件调试
    页面跳转至 硬件调试 步骤。

硬件调试

这一步您可以定义模组的具体电性参数,建议由工程师来定义其中的专业参数。

背景信息

根据整机产品的封装要求、摆放空间、温度高低、天线是否外置等具体要求来选择不同封装的模组,目前线上支持 10 种 Wi-Fi 模组选择。

产品类型 推荐模组
球泡灯 TYE3L 模组
灯丝灯 TYLC5 模组
蜡烛灯、GU10 TYLC4 模组
内置电源灯具、金属外盒电源灯具 支持外接天线的 TYE1S-IPEX 模组
塑胶外盒电源灯具 TYE1S 板载天线模组或 TYE3S 模组
空间紧凑产品,比如灯带控制器等 TYE2S 模组

说明

  • 每种模组都有说明书及 I/O 口的接线参考图。
  • E3S 和 E3L 两个模组的 EN 脚要接高电平。
  • 需要特别注意模组的射频信号的参考设计。

操作步骤

  1. 根据实际情况选择模组。
    创建照明产品
  2. 生成固件 区域,配置固件参数。详细参数信息请参考下表。
    创建照明产品
参数类型 参数 说明
IIC 方案硬件参数 控制管脚 使用 App 关机时输出与开机时的反向电平,用于控制关断白光和彩光线路降低待机功耗。
开机时输出高电平,使用 App 关机时输出低电平。
说明:当产品驱动方式参数设置为 IIC-SM726EB 时,只支持控制关断彩光。
IIC时钟信号-IICSCL 可根据下拉菜单进行选择,但不可与其它引脚重复。
IIC数据信号-IICSDA 可根据下拉菜单进行选择,但不可与其它引脚重复。
配网相关参数 通断电复位次数 触发重置配网的断电上电次数。例如参数配置为 3,则执行“开关开关开”操作之后重置配网。
I/O 引脚配置 红光输出引脚-R 可根据下拉菜单进行选择,但不可与其它引脚重复。
绿光输出引脚-G 可根据下拉菜单进行选择,但不可与其它引脚重复。
蓝光输出引脚-B 可根据下拉菜单进行选择,但不可与其它引脚重复。
白光输出引脚-C/Bright 可根据下拉菜单进行选择,但不可与其它引脚重复。
暖光输出引脚-W/CCT 可根据下拉菜单进行选择,但不可与其它引脚重复。
产品功能相关 白光亮度最大值 白光硬件 I/O 或者是专用 IC 输出口上输出的最高占空比。
取值范围:1~100。
白光亮度最小值 白光硬件 I/O 或者是专用 IC 输出口上输出的最低占空比。
取值范围:1~100。
注意:请根据硬件 IC 选择合适的亮度最小值,设定不合理可能会让灯闪烁。
PWM频率 频率过高或过低会造成 PWM 抖动频闪。
取值范围:100~20000。默认值为 1000,建议使用默认值。
色温调节驱动方式
  • CW:一路 PWM 控制冷光、另一路 PWM 控制暖光 。
  • CCT:一路 PWM 控制亮度、另一路 PWM 控制色温。
产品驱动方式 驱动 LED 灯珠的方式。
  • PWM-RGB:SoC 模组 I/O 口输出可调占空比驱动,包含白光 PWM + 彩光 PWM。
  • IIC-SM726EB:LED 灯光系统专用驱动芯片,包含白光 PWM + 彩光 IIC。
断电记忆模式 产品断电重启之后,是否存储记忆上一次用户设置的颜色、亮度色温、场景模式等设置。
说明:断电记忆需要维持当前状态 5 秒方可生效。
开关渐变 灯开关时灯光变化的模式。
  • 开关过程无渐变:开关灯时灯光亮度不会发生渐变。
  • 开关过程有渐变:开灯时,灯光亮度将从 0% 渐变到 100%;关灯时,灯光亮度将从 100% 渐变到 0%。最长渐变时间为 800 毫秒。
产品配网选项 配网提醒亮度 配网时指示灯闪烁的亮度。
取值范围:10~100。
常亮默认亮度 配网成功之后,或者配网模式为上电常亮状态下,灯常亮的初始亮度。
取值范围:1~100。
常亮默认色温 配网成功之后,或者配网模式为上电常亮状态下,灯初始白光常亮时,常亮初始色温。
取值范围:0~100。
  1. 配置完成后,单击 在线生成固件
  2. 单击 下一步:产品配置
    页面跳转至 产品配置 步骤。

产品配置

产品配置项请根据页面操作说明进行配置,配置完成后单击 下一步:测试服务
创建照明产品

测试服务

产品配置完成后,根据界面提示使用涂鸦云测 App 进行测试并生成测试报告,或者选择涂鸦测试服务。测试完成后单击 下一步:产品发布
创建照明产品

说明

  • 涂鸦云测 App 仅支持安卓版本。
  • 涂鸦云测流程请参考 涂鸦云测 App 概述
  • 不要随意删除开发中或开发完成的产品,避免造成数据丢失,消费者无法正常使用。