86型零火智能开关-三开-WiFi版 (型号:GSCW3B) - 开发者指令
产品基本描述
产品主要特点
WiFi网络,三路控制
AC110v-250v宽电压输入
单路最大负载800W
开发者文档
https://www.smart-bird.cn/doc/product/GSCWB/device/GSCW3B/command
产品电气参数
| 参数名 | 参数值 |
|---|---|
| 品牌 | GemeOpen |
| 上市日期 | 2023年 |
| 产品类型 | 86型零火智能开关-三开-WiFi版 |
| 产品型号 | GSCW3B |
| 产品尺寸 | 86mm86mm40mm |
| 键数 | 三键 |
| 供电方式 | 零火 |
| 输入电压 | 85Vac-265Vac |
| 工作电流 | 10A |
| 最大负载 | 阻性负载 MAX 800W/路 |
| 待机功率 | <3W |
| 工作温度 | -5℃ ~ +40℃ |
| 通讯方式 | 2.4GHz WIFI |
| 通讯模块 | 乐鑫ESP8266 |
| 外壳材质 | PC阻燃 |
| CQC证书编号 | CQC25003474028 |
控制采集
远程控制设备通断电
controller-event
远程控制设备的通断电状态(通电/断电),指令执行后,设备立即切换继电器状态。
向设备发送指令(服务端向设备订阅topic发送消息)
{"key1":0,"key2":0,"key3":0,"type":"event"}字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| key1 | int | 控制设备一路通断 0:关灯,1:开灯 | 0 |
| key2 | int | 控制设备二路通断 0:关灯,1:开灯 | 0 |
| key3 | int | 控制设备三路通断 0:关灯,1:开灯 | 0 |
| type | String | 控制设备开关固定传"event" | event |
设备返回信息(设备向服务端订阅topic上报消息)
{"bssid":"742ad7790468","channel":"1","commandName":"controller-event","ip":"192.168.0.150","key1":0,"key2":0,"key3":0,"keyLock":0,"mac":"8c4f00e5d4c2","messageId":"","signal":-58,"source":"command","ssid":"gemeopen","type":"Zero-3","version":"2.1.9","wifiLock":0}字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| bssid | String | 路由器 MAC 地址 | 742ad7790468 |
| channel | String | 主从机或多子机时,使用channel | 1 |
| commandName | String | 指令名称 | controller-event |
| ip | String | 设备连接WIFI后获取的IP | 192.168.0.150 |
| key1 | int | 控制设备一路通断 0:关灯,1:开灯 | 0 |
| key2 | int | 控制设备二路通断 0:关灯,1:开灯 | 0 |
| key3 | int | 控制设备三路通断 0:关灯,1:开灯 | 0 |
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 8c4f00e5d4c2 |
| messageId | String | 业务流水号。由请求方生成的唯一标识,响应方原样回显,用于请求与响应的关联匹配。 | |
| signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -58 |
| source | String | 指令回复“command" | command |
| ssid | String | 设备当前连接的WIFI名称 | gemeopen |
| type | String | 设备型号 | Zero-3 |
| version | String | 当前固件版本号 | 2.1.9 |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
获取设备基础信息
info-all
查询当前设备的基础信息,如设备MAC地址、设备型号、固件版本号、当前连接的WiFi名称(ssid)、当前设备被分配的IP地址、WiFi信号强度及相关配置信息。
向设备发送指令(服务端向设备订阅topic发送消息)
{"type":"info"}字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| type | String | 获取设备基本信息固定传"info" | info |
设备返回信息(设备向服务端订阅topic上报消息)
{"bssid":"742ad7790468","channel":"1","commandName":"info-all","ip":"192.168.0.150","key1":0,"key2":0,"key3":0,"keyLock":0,"mac":"8c4f00e5d4c2","messageId":"","signal":-59,"source":"command","ssid":"gemeopen","type":"Zero-3","version":"2.1.9","wifiLock":0}字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| bssid | String | 路由器 MAC 地址 | 742ad7790468 |
| channel | String | 主从机或多子机时,使用channel | 1 |
| commandName | String | 指令名称 | info-all |
| ip | String | 设备连接WIFI后获取的IP | 192.168.0.150 |
| key1 | int | 控制设备一路通断 0:关灯,1:开灯 | 0 |
| key2 | int | 控制设备二路通断 0:关灯,1:开灯 | 0 |
| key3 | int | 控制设备三路通断 0:关灯,1:开灯 | 0 |
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 8c4f00e5d4c2 |
| messageId | String | 业务流水号。由请求方生成的唯一标识,响应方原样回显,用于请求与响应的关联匹配。 | |
| signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -59 |
| source | String | 指令回复“command" | command |
| ssid | String | 设备当前连接的WIFI名称 | gemeopen |
| type | String | 设备型号 | Zero-3 |
| version | String | 当前固件版本号 | 2.1.9 |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
设备维护
重置/恢复出厂设置
controller-reset
将设备恢复至出厂状态,清除全部用户数据与配置,并自动重启。
向设备发送指令(服务端向设备订阅topic发送消息)
{"system":"reset","type":"setting"}字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| system | String | 重置/恢复出厂设置默认填"reset" | reset |
| type | String | 设备设置固定传"setting" | setting |
设备返回信息(设备向服务端订阅topic上报消息)
{"commandName":"controller-reset","mac":"8c4f00e5d4c2","message":"ok","messageId":"","source":"command","success":true}字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| commandName | String | 指令名称 | controller-reset |
| mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 8c4f00e5d4c2 |
| message | String | 执行结果描述:对命令执行结果的文本说明。执行完成且无异常:ok ;如果出现异常,返回异常结果描述。 | ok |
| messageId | String | 业务流水号。由请求方生成的唯一标识,响应方原样回显,用于请求与响应的关联匹配。 | |
| source | String | 指令回复“command" | command |
| success | boolean | 执行结果,执行成功:true;执行失败:false | true |
设备软重启
controller-restart
将设备恢复至出厂状态,清除全部用户数据与配置,并自动重启。
向设备发送指令(服务端向设备订阅topic发送消息)
字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| system | String | 软重启设置默认填"restart" | restart |
| type | String | 设备设置固定传"setting" | setting |
设备返回信息(设备向服务端订阅topic上报消息)
字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|
设置按键控制锁
setting-key-lock
功能按键锁定后,设备仅能通过MQTT/TCP协议操作,例如控制开关的通断、插座的通断电,都只能通过指令操作。
向设备发送指令(服务端向设备订阅topic发送消息)
{"keyLock":0,"type":"setting"}字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| type | String | 设备设置固定传"setting" | setting |
设备返回信息(设备向服务端订阅topic上报消息)
{"bssid":"742ad7790468","channel":"1","commandName":"controller-event","ip":"192.168.0.150","key1":0,"key2":0,"key3":0,"keyLock":0,"mac":"8c4f00e5d4c2","messageId":"","signal":-58,"source":"command","ssid":"gemeopen","type":"Zero-3","version":"2.1.9","wifiLock":0}字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| bssid | String | 路由器 MAC 地址 | 742ad7790468 |
| channel | String | 主从机或多子机时,使用channel | 1 |
| commandName | String | 指令名称 | controller-event |
| ip | String | 设备连接WIFI后获取的IP | 192.168.0.150 |
| key1 | int | 控制设备一路通断 0:关灯,1:开灯 | 0 |
| key2 | int | 控制设备二路通断 0:关灯,1:开灯 | 0 |
| key3 | int | 控制设备三路通断 0:关灯,1:开灯 | 0 |
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 8c4f00e5d4c2 |
| messageId | String | 业务流水号。由请求方生成的唯一标识,响应方原样回显,用于请求与响应的关联匹配。 | |
| signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -58 |
| source | String | 指令回复“command" | command |
| ssid | String | 设备当前连接的WIFI名称 | gemeopen |
| type | String | 设备型号 | Zero-3 |
| version | String | 当前固件版本号 | 2.1.9 |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
自定义MQTT参数
setting-mqtt
修改设备的 MQTT 服务器连接参数,使设备接入客户指定的MQTT 服务器(自建服务器、第三方平台等)。
向设备发送指令(服务端向设备订阅topic发送消息)
字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| clientId | String | 自定义MQTT客户端ID注意:不可重复 | custum |
| password | String | 密码 | password |
| port | String | 端口号 | 1883 |
| protocol | String | 协议类型 | mqtt |
| publish | String | 自定义发布主题 注意:不可重复 | /topic/qos0 |
| server | String | 自定义服务器地址 | 192.168.0.66 |
| subcribe | String | 自定义订阅主题,注意:不可重复 | /topic/qos1 |
| type | String | 设备自定义固定传"custom" | custom |
| username | String | 自定义服务器用户名 | username |
设备返回信息(设备向服务端订阅topic上报消息)
字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| clientId | String | 自定义MQTT客户端ID注意:不可重复 | custum |
| password | String | 密码 | password |
| port | String | 端口号 | 1883 |
| protocol | String | 协议类型 | mqtt |
| publish | String | 自定义发布主题 注意:不可重复 | /topic/qos0 |
| server | String | 自定义服务器地址 | 192.168.0.66 |
| subcribe | String | 自定义订阅主题,注意:不可重复 | /topic/qos1 |
| username | String | 自定义服务器用户名 | username |
自定义TCP参数
setting-tcp
设置设备的 TCP 服务器连接参数。设备仅支持 TCP Client 模式,设备作为客户端主动连接客户指定的 TCP 服务器。
向设备发送指令(服务端向设备订阅topic发送消息)
字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| port | String | 端口号 | 8080 |
| protocol | String | 协议类型 | tcp |
| server | String | 自定义服务器地址 | 192.168.0.66 |
| type | String | 设备自定义固定传"custom" | custom |
设备返回信息(设备向服务端订阅topic上报消息)
字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| port | String | 端口号 | 8080 |
| protocol | String | 协议类型 | tcp |
| server | String | 自定义服务器地址 | 192.168.0.66 |
设置WiFi配网锁
setting-wifi-lock
WiFi配网锁定后,设备无法通过长按配网按钮进入配网操作,仅能通过MQTT/TCP协议解锁配网功能
向设备发送指令(服务端向设备订阅topic发送消息)
{"type":"setting","wifiLock":0}字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| type | String | 设备设置固定传"setting" | setting |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |
设备返回信息(设备向服务端订阅topic上报消息)
{"bssid":"742ad7790468","channel":"1","commandName":"controller-event","ip":"192.168.0.150","key1":0,"key2":0,"key3":0,"keyLock":0,"mac":"8c4f00e5d4c2","messageId":"","signal":-58,"source":"command","ssid":"gemeopen","type":"Zero-3","version":"2.1.9","wifiLock":0}字段属性
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|---|---|---|---|
| bssid | String | 路由器 MAC 地址 | 742ad7790468 |
| channel | String | 主从机或多子机时,使用channel | 1 |
| commandName | String | 指令名称 | controller-event |
| ip | String | 设备连接WIFI后获取的IP | 192.168.0.150 |
| key1 | int | 控制设备一路通断 0:关灯,1:开灯 | 0 |
| key2 | int | 控制设备二路通断 0:关灯,1:开灯 | 0 |
| key3 | int | 控制设备三路通断 0:关灯,1:开灯 | 0 |
| keyLock | int | 按键锁,0:关闭,1:开启 | 0 |
| mac | String | wifi设备MAC地址或4G设备的IMEI号,唯一标识 | 8c4f00e5d4c2 |
| messageId | String | 业务流水号。由请求方生成的唯一标识,响应方原样回显,用于请求与响应的关联匹配。 | |
| signal | int | 信号强度,显示规则为: signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0~(-100)之间,表示无信号 | -58 |
| source | String | 指令回复“command" | command |
| ssid | String | 设备当前连接的WIFI名称 | gemeopen |
| type | String | 设备型号 | Zero-3 |
| version | String | 当前固件版本号 | 2.1.9 |
| wifiLock | int | 配网锁,0:关闭,1:开启 | 0 |