涂鸦IoT平台RGBCW五路彩灯免开发方案产品创建指引

前言

目前Tuya平台上免开发LED照明产品有Wi-Fi、BLEMESH(SIG)、ZigBee、BLEMEHS(TUYA)四大类通信方式，每类又都有单色可调白光灯（C）、双色冷暖灯CW(CCT)、彩灯（RGB）、彩灯（RGBC）、彩灯（RGBCW（RGBCCT））五种控制方式选择。
本文以免开发方案的Wi-Fi五路灯为例，为您讲解平台上产品创建的步骤及注意点。

一、注册并登陆 iot.tuya.com

1、注册并登陆涂鸦 IOT 平台（iot.tuya.com）
2、建议同时完成企业认证，认证通过后自动升级企业版可获取更多功能权限。

二、创建SOC免开发方案智能RGBCW五路灯

1、 点击创建产品。
2、 建议优先选择免开发方案，十分钟完成RGBCW五路彩灯免开发产品开发。
3、 如免开发方案产品功能无法满足需求，可选择 MCU 对接自定义方案。
4、 添加产品名称，此名称显示于app控制界面。
5、 产品型号不会在app上显示，建议填写内部型号名称或客户产品型号，便于您在平台上进行产品维护以及订单管理。
6、 以上信息可以在“编辑产品信息”中修改。

三、功能定义

免开发方案的功能点不支持修改，只支持查看功能详情。

四、配置 APP 控制面板

1、 选择 APP 控制面板，升级企业账号可选用更多模板和配置面板 UI 功能。
2、 确认控制面板后，可通过涂鸦智能或智能生活 APP 扫码功能在 APP 中体验控制面板操作。
3、 选择自定义面板可进入面板编辑界面，修改面板配色、背景等。

五、硬件调试

这一步您可以定义模块的具体电性参数，涉及一些专业参数，建议由工程师来定义。

1、选择模块并查看参考电路图。（更换模块将刷新参考电路图）

根据整机产品的封装要求、摆放空间、温度高低、天线是否外置等具体要求来选择不同封装的模块，目前线上支持10种Wi-Fi模块选择。另外每种模块都会给出说明书及IO口的接线参考图。特别注意：E3S和E3L两个模块的EN脚要接高电平；特别注意模块的射频信号的参考设计。

2、模块固件IO信息配置

2.1 IIC方案硬件参数配置

a、IIC数据IO-iicsda：指IIC通信时数据通信IO口，有5个IO口选择，如果不需要IIC通信就选择“无”，其中可选性的第一个IO口为参考默认IO；
b、IIC时钟信号IO-iicscl：指IIC通信时时钟信号通信IO口，有5个IO口选择，如果不需要IIC通信就选择“无”其中可选性的第一个IO口为参考默认IO；
c、IIC-2135彩光电流：指当选择IIC方案SM2135来设计时，RGB三路彩光的电流大小，范围是从10-45MA；
d、IIC-2135白光电流：指当选择IIC方案SM2135来设计时，CW两路白光的电流大小，范围是从10-60MA；
e、“IIC-R”、“IIC-G”、“IIC-B”、”IIC-2135-W”、” IIC-2135-C”：指当选择IIC方案SM2135来设计时，R、G、B、C、W五路具体由SM2135上out_1- 5个pin脚来控制；

2.2 产品功能相关

a、亮度最大/最小值（%）：指单色时，冷暖两路IO口输出PWM波形的最大/最小占空比值，支持从1-100之间更改。
特别注意：最小亮度值设定要根据所选调光IC的调光深度来设定，如果不匹配可能在低亮度时灯会直接关闭，所以默认最小亮度为10%；
b、PWM频率 ：指每路PWM控制信号的频率，支持从100HZ-20K更改。特别注意：频率选择主要根据调光IC所能接受的PWM频率来选择，市面大部分PWM调光IC都是500HZ-5K之间。另外，将频率调到8K以上，手机拍摄时水纹波现象基本看不出来；
c、色温调节驱动方式：有“CW-闪光/暖光”和“CCT-亮度/色温”两种方式，两种方式在APP上功能及界面都是一样的，都可以控制冷暖色温，都可以调节整灯亮度，两者主要区别是外围电路接法不一样。CCT的两路PWM信号，一路控制总电流大小，另一路分配冷光与暖光电流比例，两路PWM信号是相互独立的，无论是调光还是调色时都只有对应的一路PWM信号在变化；而CW的两路PWM信号，一路是接冷光控制电路，另一路接暖光控制电路，无论是调光还是调色时，两路PWM信号都是同时在变化的（CW和CCT两种说法只是Tuya内部的叫法，业界只要有调色温功能的灯都叫CCT，与Tuya内部的CCT方式不是一个意思）。
此选项非常重要，选择错了整灯控制逻辑就会错误，如果您不能确定，一定要发原理图给Tuya工程师确定；
d、彩光驱动引脚方式：有“正常PWM”、“CW-PWM+RGB-IIC(16726)”、“CWIIC(sm2135)+RGB-IIC(sm2135)”三种方式。“正常PWM”指R、G、B三路由三个IO口分别输出PWM信号来控制。而“CW-PWM+RGB-IIC(16726)”指由模块与SM726EB线性IC之间，通过IIC通信方式来控制RGB三路。“CW- IIC(sm2135)+RGB-IIC(sm2135)”指模块与SM2135线性IC之间，通过IIC通信方式来控制RGB三路。特别注意：三种方式一定要分清楚，否则选择错误整灯不会受控制；
e、首次配网触发方式：指模块进入配网状态的方式。有两种方式，“手动切换后闪烁”指模块上电后，通过开关几次进入配网状态，或者通过按键长按几秒进入配网状态。“上电即闪烁“指末配网的模块，上电后马上自动进入配网状态；
f、是否断电记忆：“有“断电记忆”和“开关后恢复到默认状态”两个选项。“断电记忆”指每次开机时恢复到上次断电前的状态，但是在关机前此状态一定要保持5秒以上才会记忆。而“默认状态”指亮白光，白光亮度和色温是模块配网后默认亮度值和色温值，后面需要设定此值；
g、开关渐变配置：指整机开关机时，模块PWM信号会从当前占空比逐渐降低到0。有“开关过程有渐变”和 “开关过程无渐变”两个选项；

2.3 产品配网选项

a、配网时灯光亮度：指配网时灯光闪烁的亮度，此值表示PWM信号的占空比，支持从10-100调整。特别注意：有些调光IC的调光深度最小值是10%，而此配网灯光亮度设定在10时，那么整灯配网时灯就会关闭，不会有闪烁现象，所以建议此值大于20；
b、配网时灯颜色：指配网状态下是哪路灯来闪烁，有RGBCW五种选择。
c、“默认配网后亮度”和“默认配网后色温“：指整灯刚配网成功后白光的亮度值与色温值，此值表示白光亮度和色温PWM信号的占空比。特别注意：此亮度值一定要大于调光IC调光深度的最小值，否则配网成功后灯会直接关闭，消费者会认为灯异常；

2.4 模块IO设置

根据自身情况对五路控制信号R、G、B、C（Bright）、W(CCT)的IO口选择，及高/低有效电平选择；

2.5 模块IO设置

a、产品按键：指是否增加按键方式让整灯进入配网状态。有“空”和IO口多个选项，选择“空”就是不增加按键方式。选择IO口就是通过此IO口做按键方式来进入配网状态。特别注意：如果产品不需要按键配网功能 ，一定要选择“无“，否则打开了此功能而悬空不用，很容易因为干扰导致模块异常开关机；
b、通过长按复位：如果上面选择了IO口，那么此数值为按键按下多少秒进入配网状态，支持从3秒-10秒之间选择。如果上面产品按键选择“空“，那么此项不用管；
c、通过产品通断电进行复位所需次数：指模块固件复位几次会进入配网状态，支持从3-10次调节。特别注意：模块复位一般是通过开关整灯，让模块Vcc掉电再上电实现的，所以开关配网时关机后一定要保证模块Vcc已经掉到接近0V再开机；
d、低功耗控制引脚ctrl：指IIC控制时低功耗功能脚 ，目前只支持SM16726B驱动下配置，也就是只有“彩光驱动引脚方式”下选择了“CW-PWM+RGB-IIC(16726)”时才需要来定义此功能；
特别注意：以上所有参数修改完后，一定要返回到此页面的最上面点击保存，否则上面修改的参数都无效。

3、购买模块

配置完成后，可在本页面购买少量模块样品用于调试。
注意：所有模块将按照此区域信息配置烧录，模块寄出后不能更改。如果配置信息修改，需要重新下单购买模块。若您在模块寄送后更改，会造成前后产品不一致，且老产品无法在线升级。

六、拓展功能

拓展功能的设置请查看：https://docs.tuya.com/cn/soc/soc-dev.html

七、批量投产

1、 收到样品模块并完成调试后，请提供不少于二个样品给我司测试确认开发产品状态。
2、 调试样品测试通过后“点击确认开发完成”，进入试产模式。
3、 试产完成后点击“测试通过开始量产”，配置参数将进入不可修改状态，避免误操作对使用该 产品的消费者造成不必要的影响。
4、请不要随意删除开发中或开发完成的产品，避免造成数据丢失，消费者无法正常使用。

RGBCW五路彩灯免开发方案配置说明