一款智能控制WIFI多色信号灯的使用说明
本文档是二开硬件“K2-L1”和“K2-L2”和“K2-L3”三个系列无线WIFI信号灯的说明文档。
信号灯支持TCP、串口双协议，可以通过USB有线控制，也可以通过WIFI无线控制，是一个工业软件用指示灯的好选择，价廉物美，应用广泛。
购买地址：https://duxiai.taobao.com
日期：2023年6月8日
变更记录
变更类型：新建/审核/修改/通过
|
版本号 |
版本日期 |
变更类型 |
版本描述 |
人员 |
|
V0.1 |
2022年6月8日 |
新建 |
完成主体目录、文档概述节 |
王生 |
|
V1.0 |
|
正式 |
|
|
目录
1 文档概述... 1
2 产品简介... 1
2.1 产品名称... 1
2.2 产品特点... 1
2.3 产品参数... 1
2.4 产品尺寸图... 2
2.5 接线方式... 2
2.6 双模式说明... 3
2.7 串口模式（232串口协议）... 3
2.8 无线WIFI模式（TCP协议）... 3
2.9 无线WIFI模式下亮灯说明... 3
3 产品说明... 4
3.1 测试工具... 4
3.1.1 可通过串口调试工具进行有线调试.. 4
3.1.2 可通过TCP调试工具进行无线调试... 4
3.2 配置工具（工具使用方式见视频文件）... 5
3.3 WIFI模式测试工具（工具使用方式见视频文件）.. 5
3.4 日志文件说明.. 5
3.5 二次开发... 5
3.6 常见问题... 7
3.6.1 有线串口命令执行慢... 7
3.6.2 配置工具命令执行慢... 7
3.6.3 智能灯上电后没有反应... 7
1 文档概述
本文档是二开硬件“K2-L1”和“K2-L2”和“K2-L3”三个系列无线WIFI信号灯的说明文档。
2 产品简介
2.1 产品名称
无线WIFI信号灯（可编程二次开发USB声光信号灯）
2.2 产品特点
- 产品使用一体金属一次压铸成型，抗震耐摔，高透抗击打奶白灯罩，LED高亮灯珠，经久耐用。
- 支持USB即插即用，232串口协议。
- 支持接入无线WIFI，TCP无线通讯。
- 红、橙、黄、绿、青、蓝、紫、白，一灯多色，程序控制。
- 高分贝蜂鸣，程序控制。
2.3 产品参数
- 直径：50MM
- 高度：80MM
- 安装开孔：30MM
- 安装方式：支架、开孔
- 光源寿命:5万小时
- 灯珠数：16
- 单颗灯珠功率：0.2W
- 灯珠颜色：RGB三合一
- 灯珠尺寸：5*5*1.6MM
- 灯体：铝合金一体
- 灯罩：奶白PP防撞防敲
- 重量：200克
- 蜂鸣类型：有源
- 蜂鸣大小：80分贝
- 蜂鸣方式：长鸣
- 电压：5V USB供电
- 供电：最小5V1A(建议使用5V2A电源)
- 芯片频率：80Mhz
- USB线长：默认2M，可定制
- USB线色：黑色
- USB线径：4.2MM加粗
- USB线材：屏蔽线/镀锡铜
- USB：串口模式下为供电+通讯，WIFI模式下仅供电
2.4 产品尺寸图
2.5 接线方式
- 串口有线通讯时，直接将智能灯USB口插入电脑USB口即可。
- WIFI无线控制时，需要给智能灯提供5V2A（最低5V1A）电源供电，控制电脑和智能灯必须在同一个WIFI网络中。
2.6 双模式说明
2.7 串口模式（232串口协议）
串口模式：
- 232串口协议/ USB有线控制
- 串口模式下，指示灯为命令执行模式。
- 指示灯不会主动向上位机发送任何数据。
- 上位机发送指令后，指示灯执行指令，并且返回指令执行结果。
- 如果是读取指令，指示灯返回对应的信息。
- 如果是控制指令，指示灯成功执行后，原样返回控制指令，便于上位机匹配执行结果。
2.8 无线WIFI模式（TCP协议）
WIFI模式：
- TCP协议/USB供电/无线控制
- TCP无线控制模式下，指示灯除串口模式相同的命令执行模式外，还会主动向上位机发送数据。
- 指示灯通电后，会上报自己的ID，便于上位机绑定IP与ID。
- 指示灯会间隔一段时间向上位机发送心跳包，心跳包为指示灯ID，便于设备保活，以及IP变更后上位机可以重新绑定IP与ID。
- 通过指定服务器IP为域名或外网IP，可以实现指示灯的云端控制。
2.9 无线WIFI模式下亮灯说明
- 智能灯上电后亮一颗红色灯珠：设备还未初始化，还没有写入任何配置
- 智能灯上电后蓝色灯一直渐变亮灯：设备正在连接WIFI网络
- 智能灯亮一颗黄色灯：设备WIFI已经连上，但是还未连上服务端
- 智能灯亮一颗绿色灯：设备WIFI已经连上，服务端也连上
3 产品说明
3.1 测试工具
产品文件包内含以下两个测试工具：
3.1.1 可通过串口调试工具进行有线调试
3.1.2 可通过TCP调试工具进行无线调试
3.2 配置工具（工具使用方式见视频文件）
3.3 WIFI模式测试工具（工具使用方式见视频文件）
3.4 日志文件说明
见附录1
3.5 二次开发
发送命令说明：
|
命令 |
名称 |
回复 |
说明 |
|
|
|
|
|
|
@GetStatus# |
获取当前状态 |
@GetStatus:1:0:1:0# |
四个数字，当前只是用了第1个和第3个。 第1位数字：0灯关闭/1红灯/2橙灯/3黄灯/4绿灯/5青色/6蓝色/7紫色/8品红 第2位数字：0蜂鸣关/1蜂鸣开 |
|
@Restart# |
重启设备 |
@Restart# |
|
|
@GetConfig#
|
获取配置 |
@GetConfig{"Device_Model":"K2-L1","Device_Id":"K2-L1-N0001","Device_IcId":"light-001","Wifi_Enable":"0","Wifi_Logs":"0","Wifi_Name":"TP-GYLKJ","Wifi_Pass":"wanghuaisheng2","Server_Ip":"192.168.0.111","Server_Port":"20666"}# |
{……}中为配置信息 |
|
@SetConfig:{……}# |
设置配置 |
@SetConfig:{"Device_Model":"K2-L1","Device_Id":"K2-L1-N0001","Device_IcId":"light-001","Wifi_Enable":"0","Wifi_Logs":"0","Wifi_Name":"TP-GYLKJ","Wifi_Pass":"wanghuaisheng2","Server_Ip":"192.168.0.111","Server_Port":"20666"}# |
{……}中为配置信息 |
|
@OpenRed# |
开红色灯 |
@OpenRed# |
|
|
@OpenOrange# |
开橙色灯 |
@OpenOrange# |
|
|
@OpenYellow# |
开黄色灯 |
@OpenYellow# |
|
|
@OpenGreen# |
开绿色灯 |
@OpenGreen# |
|
|
@OpenCyan# |
开青色灯 |
@OpenCyan# |
|
|
@OpenBlue# |
开蓝色灯 |
@OpenBlue# |
|
|
@OpenPurple# |
开紫色灯 |
@OpenPurple# |
|
|
@OpenMagenta# |
开品红灯 |
@OpenMagenta# |
|
|
@OpenWhite# |
开白色灯 |
@OpenWhite# |
|
|
@OpenBuzz# |
打开蜂鸣 |
@OpenBuzz# |
|
|
@ShutBuzz# |
关闭蜂鸣 |
@ShutBuzz# |
|
|
@ShutLight# |
关灯 |
@ShutLight# |
|
|
@ShutALL# |
关闭灯光+关闭蜂鸣 |
@ShutALL# |
|
3.6 常见问题
3.6.1 有线串口命令执行慢
信号灯为有线、无线双模式，支持两个模式同时使用，但是不建议同时使用两个模式，在无线模式没有连接上WIFI或没有连接上“服务端”时，如果通过有线方式发送串口命令，或通过配置工具进行有线配置时，会有命令执行响应时间较长的问题，这是由于WIFI连接时会占用较多的计算时长，此为正常现象。
3.6.2 配置工具命令执行慢
同上：信号灯为有线、无线双模式，支持两个模式同时使用，但是不建议同时使用两个模式，在无线模式没有连接上WIFI或没有连接上“服务端”时，如果通过有线方式发送串口命令，或通过配置工具进行有线配置时，会有命令执行响应时间较长的问题，这是由于WIFI连接时会占用较多的计算时长，此为正常现象。
3.6.3 智能灯上电后没有反应
一般为智能灯设置为有线模式，此模式下智能灯上电后没有反馈，但是电脑或有COM设备连接声音
附录1：日志说明
|
@Restart |
重启命令 |
|
ets Jan 8 2013,rst cause:2, boot mode:(3,7)
load 0x4010f000, len 3424, room 16 tail 0 chksum 0x2e load 0x3fff20b8, len 40, room 8 tail 0 chksum 0x2b csum 0x2b v0007aea0 ~ld
|
重启后的设备输出信息（不用管这个） |
|
接收[2023-06-29 21:34:32]: JSON.typeof(myObject) = object myObject["Wifi_Name"] = TP-GYLKJ myObject["Wifi_Pass"] = wanghuaisheng2 myObject["Server_Ip"] = 192.168.0.111 myObject["Server_Port"] = 20666 myObject["Device_Model"] = K2-L1 myObject["Device_Id"] = K2-L1-N0001 myObject["Device_IcId"] = light-001 myObject["Wifi_Enable"] = 1 myObject = {"Device_Model":"K2-L1","Device_Id":"K2-L1-N0001","Device_IcId":"light-001","Wifi_Enable":"1","Wifi_Logs":"1","Wifi_Name":"TP-GYLKJ","Wifi_Pass":"wanghuaisheng2","Server_Ip":"192.168.0.111","Server_Port":"20666"}
read config result:1 TP-GYLKJ wanghuaisheng2 192.168.0.111 20666 20666
|
重启后，调试信息输出，主要是设备的配置信息 |
|
light-001
|
设备Id标识 |
|
Open Wifi STA Mode. |
设备开启WIFI STA 模式 |
|
接收[2023-06-29 21:34:32]: Connecting to TP-GYLKJ... 接收[2023-06-29 21:34:32]: 0 接收[2023-06-29 21:34:33]: wifi connecting... 1 接收[2023-06-29 21:34:33]: wifi connecting... 2 接收[2023-06-29 21:34:33]: wifi connecting... 3 接收[2023-06-29 21:34:34]: wifi connecting... 4 接收[2023-06-29 21:34:34]: wifi connecting... 5 接收[2023-06-29 21:34:35]: wifi connecting... 6 接收[2023-06-29 21:34:36]: wifi connecting... 7 接收[2023-06-29 21:34:36]: wifi connecting...
|
设备连接无线WIFI网路 |
|
8 接收[2023-06-29 21:34:37]: wifi connect success! IP:192.168.0.102
|
无线网络接入成功 信号灯分配的IP地址 |
|
接收[2023-06-29 21:34:43]: server connect failed! 接收[2023-06-29 21:34:50]: server connect failed! 接收[2023-06-29 21:34:57]: server connect failed!
|
服务端连接失败 |
|
发送[2023-06-30 00:38:00]: @OpenRed# 接收[2023-06-30 00:38:03]: server connect failed! @OpenRed
|
打开红色灯 |
|
发送[2023-06-30 00:38:05]: @OpenOrange# 接收[2023-06-30 00:38:10]: server connect failed! @OpenOrange
|
打开橙色灯 |
|
发送[2023-06-30 00:38:11]: @OpenYellow# 接收[2023-06-30 00:38:11]: @OpenYellow
|
打开黄色灯 |
|
发送[2023-06-30 00:38:13]: @OpenGreen# 接收[2023-06-30 00:38:18]: server connect failed! @OpenGreen
|
打开绿色灯 |
|
发送[2023-06-30 00:38:18]: @OpenCyan# 接收[2023-06-30 00:38:19]: @OpenCyan
|
打开青色灯 |
|
发送[2023-06-30 00:38:20]: @OpenBlue# 接收[2023-06-30 00:38:25]: server connect failed! @OpenBlue
|
打开蓝色灯 |
|
发送[2023-06-30 00:38:25]: @OpenPurple# 接收[2023-06-30 00:38:25]: @OpenPurple
|
打开紫色灯 |
|
发送[2023-06-30 00:38:34]: @OpenMagenta# 接收[2023-06-30 00:38:39]: server connect failed! @OpenMagenta
|
打开品红灯 |
|
发送[2023-06-30 00:38:40]: @OpenWhite# 接收[2023-06-30 00:38:40]: @OpenWhite
|
打开白色灯 |
|
发送[2023-06-30 00:38:43]: @OpenBuzz# 接收[2023-06-30 00:38:46]: server connect failed! @OpenBuzz
|
打开蜂鸣 |
|
发送[2023-06-30 00:39:01]: @ShutBuzz# 接收[2023-06-30 00:39:01]: @ShutBuzz
|
关闭蜂鸣 |
|
发送[2023-06-30 00:39:04]: @ShutLight# 发送[2023-06-30 00:39:06]: @ShutALL# 接收[2023-06-30 00:39:07]: server connect failed! @ShutLight@ShutALL
|
关闭信号灯 |
|
发送[2023-06-30 00:39:16]: @GetStatus# 接收[2023-06-30 00:39:16]: @GetStatus:0:0:0:0#
|
获取信号灯状态 冒号分隔 第1节：红色0（0或1）代表灯是否开启 第2节：绿色0（0或1）代表灯是否闪烁（暂不支持） 第3节：蓝色0（0或1）代表蜂鸣是否开启 第4节：橙色0（0或1）代表蜂鸣是否闪烁（暂不支持） |
|
发送[2023-06-30 00:39:18]: @GetConfig# 接收[2023-06-30 00:39:21]: server connect failed! @GetConfig{"Device_Model":"K2-L1","Device_Id":"K2-L1-N0001","Device_IcId":"light-001","Wifi_Enable":"1","Wifi_Logs":"1","Wifi_Name":"TP-GYLKJ","Wifi_Pass":"wanghuaisheng2","Server_Ip":"192.168.0.111","Server_Port":"20666"}# |
获取配置 |
|
|
|
