KC868-S/KC868-G无线智能主机软件二次开发通信协议

注:如果将网络工作模式设置成“TCP Server”,则智能网关在局域网中充当服务器的角色,客户端软件可以直接进行TCP Socket连接进行通信与控制,无需internet和云服务器。
如果将网络工作模式设置成“TCP Client”,则智能网关充当客户端的角色,网关上电后,会自动连接到你自己指定IP和端口的服务器上,这台服务器可以是在局域网中,也可以在internet云端,根据IP地址连接即可。
 
1、主机网络号、信道设置:
智能家居二次开发 
设置键(同时发送了设置网络号和信道号的命令):
 
配置网络号:
发送:ZIGBEE_CONFIG-WRITE-02,OI,8192
返回:ZIGBEE_CONFIG-WRITE-OK
 
设置网络号:
发送:ZIGBEE_CONFIG-SEND-02
返回:ZIGBEE_CONFIG-SEND-OI,8192,OK
 
配置信道号:
发送:ZIGBEE_CONFIG-WRITE-04,CH,25
 
设置信道号:
发送:ZIGBEE_CONFIG-SEND-04
 
扫描ZigBee网络键:
发送:ZIGBEE_SCAN-DEVEICE-NOW
返回:ZIGBEE_SCAN-DEVEICE-1,16816,2;4,38831,0 (这是ZigBee网络中所有扫描到的设备会一一列出)
 
2、修改ZigBee终端设备的网络号,信道号(如:修改开关,电机,红外转发器的参数)
智能家居软件开发 
 
A.点击“1:进入配置”按键:
发送:
ZIGBEE_CONFIG-WRITE-02,OI,4096
ZIGBEE_CONFIG-SEND-02
ZIGBEE_CONFIG-WRITE-04,CH,25
ZIGBEE_CONFIG-SEND-04
 
返回:
ZIGBEE_CONFIG-WRITE-OK
ZIGBEE_CONFIG-SEND-OI,4096,OK
 
B.点击“2:发送”按键:
发送:
ZIGBEE_CONFIG-WRITE-01,CF,8192
ZIGBEE_CONFIG-SEND-01
ZIGBEE_CONFIG-WRITE-03,CN,25
ZIGBEE_CONFIG-SEND-03
ZIGBEE_CONFIG-WRITE-01,CF,8192
ZIGBEE_CONFIG-SEND-01
ZIGBEE_CONFIG-WRITE-03,CN,25
ZIGBEE_CONFIG-SEND-03
ZIGBEE_CONFIG-WRITE-01,CF,8192
ZIGBEE_CONFIG-SEND-01
ZIGBEE_CONFIG-WRITE-03,CN,25
ZIGBEE_CONFIG-SEND-03
 
返回:
ZIGBEE_CONFIG-WRITE-OK
ZIGBEE_CONFIG-SEND-CF,8192,OK
 
C.点击“3:设置完成”按键:
发送:
ZIGBEE_CONFIG-WRITE-02,OI,8192
ZIGBEE_CONFIG-SEND-02
ZIGBEE_CONFIG-WRITE-04,CH,25
ZIGBEE_CONFIG-SEND-04
 
返回:
ZIGBEE_CONFIG-WRITE-OK
ZIGBEE_CONFIG-SEND-OI,8192,OK
 
 
3.ZigBee灯光控制(ZigBee灯光面板):
zigbee灯光二次开发 
 
比如:这是一个3键的ZigBee灯光开关,从上到下分别是三个按键:
 
第一键“开灯”
发送:ZIGBEE_LIGHT-SEND-1,16816,1,1         
成功返回:ZIGBEE_LIGHT-SEND-1,16816,1,1,OK
失败返回:ZIGBEE_LIGHT-SEND-1,16816,1,1,ZIGBEE_ERR
 
SEND-1,16816,1,1参数说明:
1:这是一个包序号,从1-255自增,每次发送的序同不同即可,如自增到255,可以再从1开始。
16816:这是灯光面板上的地址码,请查看产品电路板上有标记。
1:该面板的第几个按键,比如使用的是三键面板,可以用1-3代表第几个按键。
1:用1表示开灯;用0表示关灯。
 
第一键“关灯”
发送:ZIGBEE_LIGHT-SEND-2,16816,1,0
成功返回:ZIGBEE_LIGHT-SEND-2,16816,1,0,OK
失败返回:ZIGBEE_LIGHT-SEND-2,16816,1,0,ZIGBEE_ERR
 
第一键“获得灯光状态”
发送:ZIGBEE_LIGHT-READ-3,16816
成功返回:ZIGBEE_LIGHT-READ-3,16816,3,0,1,0,OK
失败返回:ZIGBEE_LIGHT-READ-3,16816,ZIGBEE_ERR
 
其中16816,3,0,1,0,OK参数说明:
16816:这是灯光面板上的地址码。
3:代表该开关面板为3键开关。
0,1,0表示第1个按键当前状态是“关闭”状态的;第2个按键当前状态是“打开”状态的;第3个按键当前状态是“关闭”状态的;其中用1表示开灯;用0表示关灯。
 
以下不同开关键,原理一样。
 
-----------------------------------------------------------------------------------------
第二键“开灯”
发送:ZIGBEE_LIGHT-SEND-1,16816,2,1
成功返回:ZIGBEE_LIGHT-SEND-1,16816,2,1,OK
失败返回:ZIGBEE_LIGHT-SEND-1,16816,2,1,ZIGBEE_ERR
 
第二键“关灯”
发送:ZIGBEE_LIGHT-SEND-2,16816,2,0
成功返回:ZIGBEE_LIGHT-SEND-2,16816,2,0,OK
失败返回:ZIGBEE_LIGHT-SEND-2,16816,2,0,ZIGBEE_ERR
 
第二键“获得灯光状态”
发送:ZIGBEE_LIGHT-READ-3,16816
成功返回:ZIGBEE_LIGHT-READ-3,16816,3,0,1,0,OK
失败返回:ZIGBEE_LIGHT-READ-3,16816,ZIGBEE_ERR
 
-------------------------------------------------------------------------------------------
第三键“开灯”
发送:ZIGBEE_LIGHT-SEND-1,16816,3,1
成功返回:ZIGBEE_LIGHT-SEND-1,16816,3,1,OK
失败返回:ZIGBEE_LIGHT-SEND-1,16816,3,1,ZIGBEE_ERR
 
第三键“关灯”
发送:ZIGBEE_LIGHT-SEND-2,16816,3,0
成功返回:ZIGBEE_LIGHT-SEND-2,16816,3,0,OK
失败返回:ZIGBEE_LIGHT-SEND-2,16816,3,0,ZIGBEE_ERR
 
第三键“获得灯光状态”
发送:ZIGBEE_LIGHT-READ-3,16816
成功返回:ZIGBEE_LIGHT-READ-3,16816,3,0,1,0,OK
失败返回:ZIGBEE_LIGHT-READ-3,16816,ZIGBEE_ERR
 
4.ZigBee调光面板:
zigbee调光二次开发 
“执行”按键:
 
发送:ZIGBEE_DIMMER-SEND-54,38831,17
接收:ZIGBEE_DIMMER-SEND-54,38831,17,OK
 
38831:这是调光灯面板上的地址码。
17为亮度级别,范围从0-100,0为最暗状态(关灯状态),100为最亮状态。
 
“获得当前亮度”按键:
发送:ZIGBEE_DIMMER-READ-55,38831
接收:ZIGBEE_DIMMER-READ-55,38831,17,OK
 
17为当前灯光亮度。
 
5. ZigBee电动窗帘
 
zigbee电动窗帘二次开发 
 
“执行”按键:
 
发送:ZIGBEE_CURTAIN-SEND-57,16688,20,33
接收:ZIGBEE_DIMMER-SEND-54,38831,17,OK (成功)
      ZIGBEE_CURTAIN-SEND-57,16688,20,33,ZIGBEE_ERR (失败)
 
16688:电机地址码
20:电机类型,固定不变
33:窗帘控制定位。0-100来表示完整的行程。
 
“获得当前位置”按键:
发送:ZIGBEE_CURTAIN-READ-1058,16688
接收:ZIGBEE_DIMMER-READ-55,16688,33,OK
 
33:返回当前窗帘位置值。
 
6. ZigBee红外线转发器
zigbee红外控制二次开发 
“学习按键”:
 
发送:ZIGBEE_INFRARED-STUDY-60,64100,1,1784060321
接收:ZIGBEE_INFRARED-STUDY-60,64100,1,1784060321,OK  (成功)
      ZIGBEE_INFRARED-STUDY-60,64100,1,1784060321,ZIGBEE_ERR (失败)
 
64100,1,1784060321 参数说明:
64100:红外转发器设备地址码,可从产品底部标签看到。
1:代表第一个红外存储按键,可以从1-800创建800个红外学习按键,该键码学习后会保存在红外转发器硬件芯片内。
1784060321:红外转发器设备验证码,可从产品底部标签看到。
 
“发射按键”:
发送:ZIGBEE_INFRARED-SEND-61,64100,1,1784060321
接收:ZIGBEE_INFRARED-STUDY-60,64100,1,1784060321,OK  (成功)
      ZIGBEE_INFRARED-SEND-61,64100,1,1784060321,ZIGBEE_ERR (失败)
发射按键:用于之前已学习好的红外线信号,进行手动发射,从而实现红外线控制的设备,如:空调,电视机,投影仪。
 
7. 射频信号的发射
射频控制二次开发 
“发射1527编码”:
发送:PT2262_315M-SEND-62,33,149739111
接收:PT2262_315M-SEND-62,33,149739111,OK
 
发送:PT2262_433M-SEND-62,33,149739111
接收:PT2262_433M-SEND-62,33,149739111,OK
 
33:表示振荡电阻为3.3M
149739111:为数据码和地址码计算后的一个综合值。可以改变这个值,发射不同的编码信号。
315M和433M为发射信号的频率值
 
 
“无线信号学习”:
发送:RFSTUY_315M-STUDY-1
接收:RFSTUY_315M-STUDY-START  准备进入学习状态
此时手按遥控器某个按键
接收:RFSTUY_315M-STUDY-1,OK   学习成功
 
RFSTUY_315M-STUDY-1 和 RFSTUY_315M-STUDY-1,OK  中的参数说明:
1:代表学习无线信号的通道数。
 
“学到的无线信号发射”:
发送:RFSTUY_315M-SEND-1
接收:RFSTUY_315M-SEND-OK
 
将学习到的第1路无线信号发射出去。
 
以上学习模式,还支持433M无线信号的学习与转发,只需要将协议中的315M替换为433M即可,如:
“无线信号学习”:
发送:RFSTUY_433M-STUDY-1
“学到的无线信号发射”:
发送:RFSTUY_433M-SEND-1
 
8. 杜亚电机遥控发射信号:
 
发送:
PTDYDJ_433M-SEND-6,33,841778201    开
PTDYDJ_433M-SEND-7,33,841778202    关
PTDYDJ_433M-SEND-8,33,841778203    停
PTDYDJ_433M-SEND-9,33,841778204    学习
 
 
33:振荡电阻值,固定不变
841778201:发射的无线信号编码值
 
9. 智能门锁开关门发射信号:
 
发送:
PTZNMS_315M-SEND-6,33,483946481    开
PTZNMS_315M-SEND-7,33,483946482    关
 
33:振荡电阻值,固定不变
483946481:发射的无线信号编码值,门锁对无线信号进行学习配对
483946482:发射的无线信号编码值,门锁对无线信号进行学习配对
 
10. KC868-G内置红外转发器的使用:
(和外置zigbee红外转发器使用方法一样,地址码永远固定成65535,验证码为0000000000)
红外线二次开发 
“学习按键”:
 
发送:ZIGBEE_INFRARED-STUDY-60,65535,1,0000000000
接收:ZIGBEE_INFRARED-STUDY-60,65535,1,0000000000,OK  (成功)
      ZIGBEE_INFRARED-STUDY-60,65535,1,0000000000,ZIGBEE_ERR (失败)
 
65535,1,0000000000 参数说明:
65535:红外转发器设备地址码,可从产品底部标签看到。
1:代表第一个红外存储按键,可以从1-800创建800个红外学习按键,该键码学习后会保存在红外转发器硬件芯片内。
0000000000:红外转发器设备验证码,可从产品底部标签看到。
 
“发射按键”:
发送:ZIGBEE_INFRARED-SEND-61,65535,1,0000000000
接收:ZIGBEE_INFRARED-STUDY-60,65535,1,0000000000,OK  (成功)
      ZIGBEE_INFRARED-SEND-61,65535,1,0000000000,ZIGBEE_ERR (失败)
发射按键:用于之前已学习好的红外线信号,进行手动发射,从而实现红外线控制的设备,如:空调,电视机,投影仪。