首页
智能设备
智能设备
GemeOpen 智能设备是支持二次开发的成品，有着严格的生产流程与测试要求，已在大量的项目实战中得到软件开发者验证，设备安全稳定可靠。
智能插座系列
SmartPlug
智能通断器系列
SmartBreaker
智能传感器系列
SmartSensor
智能音响系列
SmartAudio
AI智能设备系列
SmartAvian
AI工作辅助
Smart Avian Base
电控系统
开发文档
最佳实践
资料下载
关于我们
服务热线：130-0715-9689 控制台 v1.0 手机版
GemeOpen 智能红外控制器 S2 (型号：GSCU2B) - 开发者指令
# 智能红外控制器 S2 (型号：GSCU2B) - 开发者指令
## 产品基本描述
内置红外接收管、5-24V供电、外接红外发射器、外接温度传感器、红蓝双色灯
## 产品主要特点
一款小巧的方便隐藏安装的红外遥控器……
## 官网产品资料
### 产品详细信息
### 淘宝购买网址
### 京东购买网址
### 开发者文档
https://www.smart-bird.cn/doc/product/GSCU/device/GSCU2B/command
## 产品电气参数
---
| 参数名 | 参数值 |
|------|------|
|
品牌
|
GemeOpen
|
|
上市日期
|
2025年
|
|
产品类型
|
智能红外控制器-WiFi版
|
|
产品型号
|
GSCU2B
|
|
外观尺寸
|
41mm*41mm*20mm
|
|
输入电压
|
9-24V
|
|
工作电压
|
1A
|
|
遥控信号
|
38KHz 红外
|
|
待机功率
|
＜1W
|
|
通信方式
|
2.4GHz WIFI
|
|
通讯模块
|
乐鑫ESP32
|
|
电源插口
|
DC 9-24V 电源适配器（尾端去皮裸线）
|
|
载波频率
|
38KHz 红外
|
|
遥控距离
|
红外探头需紧贴红外接收端<10cm
|
|
红外学习
|
支持学习128种红外码
|
---
## 全部指令
###
*controller-infrared-emit*


**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
　　"action" : "emit",
　　"data" :
　　{
　　　　"no" : 110
　　},
　　"messageId" : "20260520",
　　"type" : "infrared"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
|
String
|
学习红外码指令默认填"emit"
|
emit
|
|
data
|
Object
|
数据
|
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
no
|
int
|
红外码编号，编号范围0~127
|
110
|
|
type
|
String
|
固定值"infrared"
|
infrared
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
　　"commandName" : "controller-infrared-emit",
　　"mac" : "2026bb16aa14",
　　"message" : "ok",
　　"messageId" : "20260520",
　　"no" : 110,
　　"source" : "command",
　　"success" : true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
controller-infrared-emit
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果，若红外码不存在，则信息为“Infrared data does not exist”
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
no
|
int
|
红外码编号，编号范围0~127
|
110
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
---
###
*controller-infrared-erase*


**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
　　"action" : "erase",
　　"messageId" : "20260520",
　　"type" : "infrared"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
|
String
|
擦除红外码指令默认填"erase"
|
erase
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
type
|
String
|
固定值"infrared"
|
infrared
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
　　"commandName" : "controller-infrared-erase",
　　"mac" : "2026bb16aa14",
　　"message" : "ok",
　　"messageId" : "20260520",
　　"source" : "command",
　　"success" : true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
controller-infrared-erase
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
---
###
*controller-infrared-learn*


**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
　　"action" : "learn",
　　"data" :
　　{
　　　　"no" : 110
　　},
　　"messageId" : "20260520",
　　"type" : "infrared"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
|
String
|
学习红外码指令默认填"learn"
|
learn
|
|
data
|
Object
|
数据
|
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
no
|
int
|
红外码编号，编号范围0~127
|
110
|
|
type
|
String
|
固定值"infrared"
|
infrared
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
　　"commandName" : "controller-infrared-learn",
　　"mac" : "2026bb16aa14",
　　"message" : "ok",
　　"messageId" : "20260520",
　　"no" : 110,
　　"source" : "command",
　　"success" : true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
controller-infrared-learn
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果，若超时失败（未学习到，20s超时）则信息为“time out of learning”
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
no
|
int
|
红外码编号，编号范围0~127
|
110
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
---
### 取消学习指令
*controller-infrared-learn-cancel*

取消学习指令

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
　　"action" : "learnCancel",
　　"messageId" : "20260520",
　　"type" : "infrared"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
|
String
|
取消学习红外码指令默认填"learnCancel"
|
learnCancel
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
type
|
String
|
固定值"infrared"
|
infrared
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
　　"commandName" : "controller-infrared-learn-cancel",
　　"mac" : "2026bb16aa14",
　　"message" : "ok",
　　"messageId" : "20260520",
　　"source" : "command",
　　"success" : true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
controller-infrared-learn-cancel
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
---
###
*controller-reset*

恢复出厂设置后配网信息和自定义信息都会清空，请谨慎操作！

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
　　"messageId" : "20260520",
　　"system" : "reset",
　　"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
system
|
String
|
重置/恢复出厂设置默认填"reset"
|
reset
|
|
type
|
String
|
设备设置固定值"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
　　"commandName" : "controller-reset",
　　"mac" : "2026bb16aa14",
　　"message" : "ok",
　　"messageId" : "20260520",
　　"source" : "command",
　　"success" : true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
controller-reset
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
---
###
*controller-restart*

软重启后，通过指令设置的参数将生效，同时设备将重新连接Wifi/4G网络，注意设备IP地址可能发生变化

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
　　"messageId" : "20260520",
　　"system" : "restart",
　　"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
system
|
String
|
设备软重启默认填"restart"
|
restart
|
|
type
|
String
|
设备设置固定值"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
　　"commandName" : "controller-restart",
　　"mac" : "2026bb16aa14",
　　"message" : "ok",
　　"messageId" : "20260520",
　　"source" : "command",
　　"success" : true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
controller-restart
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
---
###
*device-timer-interval*

设置温度定时上报的频率。

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
　　"messageId" : "20260520",
　　"timerEnable" : 1,
　　"timerInterval" : 15,
　　"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
timerEnable
|
int
|
设备统计信息定时上报状态，0：关闭；1：开启
|
1
|
|
timerInterval
|
int
|
设备统计信息上报时间间隔（单位秒），取值范围5-86400
|
15
|
|
type
|
String
|
设备设置固定值"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
　　"commandName" : "device-timer-interval",
　　"mac" : "2026bb16aa14",
　　"message" : "ok",
　　"messageId" : "20260520",
　　"source" : "command",
　　"success" : true,
　　"timerEnable" : 1,
　　"timerInterval" : 15
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
device-timer-interval
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
|
timerEnable
|
int
|
设备统计信息定时上报状态，0：关闭；1：开启
|
1
|
|
timerInterval
|
int
|
设备统计信息上报时间间隔（单位秒），取值范围5-86400
|
15
|
---
### 自动上报任务（定时上报）
*device-timer-task*

主动上报信息，与设置定时上报任务（device-timer-interval）相关联。未接温度传感器时，上报内容为：{"commandName" : "device-timer-task","mac" : "2026bb16aa14","source" : "auto"}

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
　　"commandName" : "device-timer-task",
　　"mac" : "2026bb16aa14",
　　"source" : "auto",
　　"temperature" : 28
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
device-timer-task
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
source
|
String
|
指令回复“auto"
|
auto
|
|
temperature
|
float
|
温度 (单位:摄氏度)，未接温度传感器时则无该字段
|
28
|
---
###
*info-all*

获取设备信息一般会包含：设备通断电状态、MAC/IMEI、固件版本、设备内网IP地址、设备WIFI网络名称等信息，不同的产品返回的信息有所差异

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"messageId" : "20260520",
"type" : "info"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
type
|
String
|
固定值"info"
|
info
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"bssid" : "742ad779046",
"code" : "GSCU2B",
"commandName" : "info-all",
"ip" : "192.168.122.119",
"mac" : "2026bb16aa14",
"messageId" : "20260520",
"signal" : -75,
"source" : "command",
"ssid" : "gemeopen",
"tempOffset" : 0,
"timerEnable" : 1,
"timerInterval" : 15,
"version" : "1.0.0",
"wifiLock" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
bssid
|
String
|
路由器 MAC 地址
|
742ad779046
|
|
code
|
String
|
设备型号代码
|
GSCU2B
|
|
commandName
|
String
|
指令名称
|
info-all
|
|
ip
|
String
|
设备连接WIFI后获取的IP
|
192.168.122.119
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
signal
|
int
|
信号强度，显示规则为： signal<= 0 && signal>= -50 //信号最好 signal< -50 && signal>= -70 //信号较好 signal< -70 && signal>= -80 //信号一般 signal<-80 && signal>= -100 //信号较差 signal没有在0～（-100)之间，表示无信号
|
-75
|
|
source
|
String
|
指令回复“command"
|
command
|
|
ssid
|
String
|
设备当前连接的WIFI名称
|
gemeopen
|
|
tempOffset
|
float
|
温度补偿偏移值，单位：℃，取值范围：+20~-20； 计算公式：校准后数据=实际读取的数据+tempOffset
|
0
|
|
timerEnable
|
int
|
设备统计信息定时上报状态，0：关闭；1：开启
|
1
|
|
timerInterval
|
int
|
设备统计信息上报时间间隔（单位秒），取值范围5-86400
|
15
|
|
version
|
String
|
当前固件版本号
|
1.0.0
|
|
wifiLock
|
int
|
配网锁，0：关闭，1：开启
|
0
|
---
###
*info-protocol*


**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"messageId" : "20260520",
"type" : "protocol"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
type
|
String
|
固定值"protocol"
|
protocol
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"clientId" : "admin",
"commandName" : "info-protocol",
"mac" : "2026bb16aa14",
"messageId" : "20260520",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "/topic/qos0",
"server" : "192.168.0.66
",
"source" : "command",
"subcribe" : "/topic/qos1
",
"username" : "username"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
clientId
|
String
|
自定义MQTT客户端ID注意：不可重复
|
admin
|
|
commandName
|
String
|
指令名称
|
info-protocol
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
port
|
String
|
端口号
|
1883
|
|
protocol
|
String
|
协议类型
|
mqtt
|
|
publish
|
String
|
自定义发布主题 注意:不可重复
|
/topic/qos0
|
|
server
|
String
|
自定义服务器地址
|
192.168.0.66
|
|
source
|
String
|
指令回复“command"
|
command
|
|
subcribe
|
String
|
自定义订阅主题，注意：不可重复
|
/topic/qos1
|
|
username
|
String
|
自定义服务器用户名
|
username
|
---
###
*info-statistic*

获取设备采集的温度信息

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"messageId" : "20260520",
"type" : "statistic"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
type
|
String
|
固定值"statistic"
|
statistic
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"commandName" : "info-statistic",
"mac" : "2026bb16aa14",
"message" : "ok",
"messageId" : "20260520",
"source" : "command",
"success" : true,
"temperature" : 28
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
info-statistic
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
|
temperature
|
float
|
温度 (单位:摄氏度)
|
28
|
---
###
*ir_read*


**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"action" : "ir_read",
"data" :
{
"no" : 110
},
"messageId" : "20260520",
"type" : "infrared"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
|
String
|
读取红外码指令默认填"ir_read"
|
ir_read
|
|
data
|
Object
|
数据
|
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
no
|
int
|
红外码编号，编号范围0~127
|
110
|
|
type
|
String
|
固定值"infrared"
|
infrared
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"commandName" : "controller-infrared-read",
"ir_data" : "e80200004e1a138d530340834e03cd89520341834e0341834f0340834e0342834e0342834d0342834d0342834e0342834d0341834e0341834d0342834f03cd895103418340834e03cd89520341834e0341834f0340834e0342834e0342834d0342834d0342834e0342834d0341834e0341834d0342834f03cd895103418340834e03cd89520341834e0341834f0340834e0342834e0342834d0342834d0342834e0342834d0341834e0341834d0342834f03cd8951034183",
"mac" : "2026bb16aa14",
"message" : "ok",
"messageId" : "20260520",
"no" : 110,
"source" : "command",
"success" : true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
controller-infrared-read
|
|
ir_data
|
String
|
红外码数据
|
e80200004e1a138d530340834e03cd89520341834e0341834f0340834e0342834e0342834d0342834d0342834e0342834d0341834e0341834d0342834f03cd895103418340834e03cd89520341834e0341834f0340834e0342834e0342834d0342834d0342834e0342834d0341834e0341834d0342834f03cd895103418340834e03cd89520341834e0341834f0340834e0342834e0342834d0342834d0342834e0342834d0341834e0341834d0342834f03cd8951034183
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果，若该地址上还没有学习，读取失败，则返回"Infrared data does not exist"
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
no
|
int
|
红外码编号，编号范围0~127
|
110
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
---
###
*ir_write*


**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"action" : "ir_write",
"ir_data" : "e80200004e1a138d530340834e03cd89520341834e0341834f0340834e0342834e0342834d0342834d0342834e0342834d0341834e0341834d0342834f03cd895103418340834e03cd89520341834e0341834f0340834e0342834e0342834d0342834d0342834e0342834d0341834e0341834d0342834f03cd895103418340834e03cd89520341834e0341834f0340834e0342834e0342834d0342834d0342834e0342834d0341834e0341834d0342834f03cd8951034183",
"messageId" : "20260520",
"no" : 110,
"type" : "infrared"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
|
String
|
写入红外码指令默认填"learn"
|
ir_write
|
|
ir_data
|
String
|
红外码数据
|
e80200004e1a138d530340834e03cd89520341834e0341834f0340834e0342834e0342834d0342834d0342834e0342834d0341834e0341834d0342834f03cd895103418340834e03cd89520341834e0341834f0340834e0342834e0342834d0342834d0342834e0342834d0341834e0341834d0342834f03cd895103418340834e03cd89520341834e0341834f0340834e0342834e0342834d0342834d0342834e0342834d0341834e0341834d0342834f03cd8951034183
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
no
|
int
|
红外码编号，编号范围0~127
|
110
|
|
type
|
String
|
设备设置固定值"infrared"
|
infrared
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"commandName" : "controller-infrared-write",
"mac" : "2026bb16aa14",
"message" : "ok",
"messageId" : "20260520",
"no" : 110,
"source" : "command",
"success" : true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
controller-infrared-write
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
no
|
int
|
红外码编号，编号范围0~127
|
110
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果，若不成功，返回：false
|
true
|
---
###
*setting-mqtt*

设备支持自定义MQTT，注意：在通过MQTT自定义MQTT信息后，需要将设备断电重启或者向设备发送重启命令才可生效。

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"clientId" : "admin",
"messageId" : "20260520",
"password" : "123456",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "/topic/qos0",
"server" : "192.168.0.66",
"subcribe" : "/topic/qos1",
"type" : "setting",
"username" : "username
"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
clientId
|
String
|
自定义MQTT客户端ID注意：不可重复
|
admin
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
password
|
String
|
密码
|
123456
|
|
port
|
String
|
端口号
|
1883
|
|
protocol
|
String
|
协议类型
|
mqtt
|
|
publish
|
String
|
自定义发布主题 注意:不可重复
|
/topic/qos0
|
|
server
|
String
|
自定义服务器地址
|
192.168.0.66
|
|
subcribe
|
String
|
自定义订阅主题，注意：不可重复
|
/topic/qos1
|
|
type
|
String
|
设备设置固定值"setting"
|
setting
|
|
username
|
String
|
自定义服务器用户名
|
username
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"clientId" : "admin",
"commandName" : "setting-mqtt",
"mac" : "2026bb16aa14",
"messageId" : "20260520",
"port" : "1883",
"protocol" : "mqtt",
"publish" : "/topic/qos0
",
"server" : "192.168.0.66
",
"source" : "command",
"subcribe" : "/topic/qos1",
"username" : "username"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
clientId
|
String
|
自定义MQTT客户端ID注意：不可重复
|
admin
|
|
commandName
|
String
|
指令名称
|
setting-mqtt
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
port
|
String
|
端口号
|
1883
|
|
protocol
|
String
|
协议类型
|
mqtt
|
|
publish
|
String
|
自定义发布主题 注意:不可重复
|
/topic/qos0
|
|
server
|
String
|
自定义服务器地址
|
192.168.0.66
|
|
source
|
String
|
指令回复“command"
|
command
|
|
subcribe
|
String
|
自定义订阅主题，注意：不可重复
|
/topic/qos1
|
|
username
|
String
|
自定义服务器用户名
|
username
|
---
###
*setting-tcp*

设备支持通过MQTT方式自定义TCP信息，注意：通过MQTT自定义TCP信息后，需要将设备断电重启或者向设备发送重启命令才可生效。

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"messageId" : "20260520",
"port" : "1883",
"protocol" : "tcp",
"server" : "192.168.0.66",
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
port
|
String
|
端口号
|
1883
|
|
protocol
|
String
|
协议类型
|
tcp
|
|
server
|
String
|
自定义服务器地址
|
192.168.0.66
|
|
type
|
String
|
设备设置固定值"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"commandName" : "setting-tcp",
"mac" : "2026bb16aa14",
"messageId" : "20260520",
"port" : "8080",
"protocol" : "tcp",
"server" : "192.168.0.66",
"source" : "command"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-tcp
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
port
|
String
|
端口号
|
8080
|
|
protocol
|
String
|
协议类型
|
tcp
|
|
server
|
String
|
自定义服务器地址
|
192.168.0.66
|
|
source
|
String
|
指令回复“command"
|
command
|
---
###
*setting-temperature-compensate*

设置温度的补偿值，用于校准传感器采集数据的偏差。

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"messageId" : "20260520",
"tempOffset" : 0,
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
tempOffset
|
float
|
温度补偿偏移值，单位：℃，取值范围：+20~-20； 计算公式：校准后数据=实际读取的数据+tempOffset
|
0
|
|
type
|
String
|
设备设置固定值"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"commandName" : "setting-temperature-compensate",
"mac" : "2026bb16aa14",
"message" : "ok",
"messageId" : "20260520",
"source" : "command",
"success" : true,
"tempOffset" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-temperature-compensate
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
|
tempOffset
|
float
|
温度补偿偏移值，单位：℃，取值范围：+20~-20； 计算公式：校准后数据=实际读取的数据+tempOffset
|
0
|
---
### 设置设备WiFi信息
*setting-wifi-config*

重启才会连接新设置的wifi信息，可支持空密码wifi，无密码wifi时需不填写password字段或password字段为空，示例："password":"",<br/>

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"bssid" : "742ad779046",
"messageId" : "20260520",
"password" : "123456",
"ssid" : "gemeopen",
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
bssid
|
String
|
路由器 MAC 地址，可选参数，有需求则填写
|
742ad779046
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
password
|
String
|
WIFI密码，无密码wifi时可不填写该字段
|
123456
|
|
ssid
|
String
|
设备当前连接的WIFI名称
|
gemeopen
|
|
type
|
String
|
设备设置固定值"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"bssid" : "742ad779046",
"commandName" : "setting-wifi-config",
"mac" : "2026bb16aa14",
"message" : "ok",
"messageId" : "20260520",
"source" : "command",
"success" : true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
bssid
|
String
|
路由器 MAC 地址
|
742ad779046
|
|
commandName
|
String
|
指令名称
|
setting-wifi-config
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
---
###
*setting-wifi-dhcpEnable*

设备默认为动态获取ip，通过该接口开启静态IP，需重启生效<br/>配置的静态IP需和路由器处于同一网段下<br/>

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"dhcpEnable" : 1,
"dns" : "192.168.0.1",
"gateway" : "192.168.0.1",
"local_ip" : "192.168.0.118",
"messageId" : "20260520",
"subnet" : "255.255.255.0",
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
dhcpEnable
|
int
|
自动寻址1：开启， 0：关闭，默认开启
|
1
|
|
dns
|
String
|
DNS服务器地址
|
192.168.0.1
|
|
gateway
|
String
|
默认网关
|
192.168.0.1
|
|
local_ip
|
String
|
IP地址
|
192.168.0.118
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
subnet
|
String
|
子网掩码
|
255.255.255.0
|
|
type
|
String
|
设备设置固定值"setting"
|
setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"commandName" : "setting-wifi-dhcpEnable",
"mac" : "2026bb16aa14",
"message" : "ok",
"messageId" : "20260520",
"source" : "command",
"success" : true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-wifi-dhcpEnable
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
---
###
*setting-wifi-lock*

wifi配网锁定后，设备无法通过长按配网按钮进入配网操作，仅能通过MQTT/TCP协议解锁配网功能<br/>

**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"messageId" : "20260520",
"type" : "setting",
"wifiLock" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
type
|
String
|
设备设置固定值"setting"
|
setting
|
|
wifiLock
|
int
|
配网锁，0：关闭，1：开启
|
0
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"commandName" : "setting-wifi-lock",
"mac" : "2026bb16aa14",
"message" : "ok",
"messageId" : "20260520",
"source" : "command",
"success" : true,
"wifiLock" : 0
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
|
String
|
指令名称
|
setting-wifi-lock
|
|
mac
|
String
|
wifi设备MAC地址或4G设备的IMEI号，唯一标识
|
2026bb16aa14
|
|
message
|
String
|
执行返回结果
|
ok
|
|
messageId
|
String
|
业务流水号。由请求方生成的唯一标识，响应方原样回显，用于请求与响应的关联匹配。
|
20260520
|
|
source
|
String
|
指令回复“command"
|
command
|
|
success
|
boolean
|
执行结果
|
true
|
|
wifiLock
|
int
|
配网锁，0：关闭，1：开启
|
0
|
---
开发文档 v3.0
企业运维系统
CSDN 社区
智能用电监控
淘宝官方店
京东旗舰店
VI视觉物料
公司地址：湖北省武汉市高新大道光谷崇文中心B1栋1401、1409     /     体验店地址：光谷崇文中心B1栋104     /     电话：027-87001787
Copyright © 2020-2026 Smart-bird. All Rights Reserved. 武汉智鸟科技有限责任公司   版权所有     /    鄂ICP备2020020019号-1
微信扫一扫
企业微信 · 产品咨询
微信扫一扫
智鸟科技 · 微信公众号
淘宝扫一扫
智鸟科技GemeOpen官方店
京东扫一扫
GEMEOPEM官方旗舰店
爱采购扫一扫
GEMEOPEM官方旗舰店