Push Message Reference
This document defines all SSE push message payloads. Each message is identified by the combination of pushTag + pushType.
Message Index Table
| pushTag | pushType | Description | Subscription Property Key |
|---|---|---|---|
attribute | 1 | Device main status | DEV_ST |
attribute | 2 | Charge status | CHG_ST |
attribute | 3 | Self-check status | SELF_CHK |
attribute | 6 | Battery percentage | BAT_PCT |
attribute | 8 | Real-time coordinate position | COORD |
attribute | 9 | Network status | NET_ST |
attribute | 10 | Work progress | WK_PRG |
notify | 1 | Device nickname modification event | DEV_INF |
notify | 3 | New device binding event | ENR_BIND |
notify | 4 | Device unbinding event | ENR_UNBIND |
progress | 1 | OTA upgrade progress | OTA_PRG |
sc | 1 | Server kick-off system message | System internal |
pushTag = attribute / pushType = 1: Device main status
Example:
{
"pushTag": "attribute",
"pushType": 1,
"pushData": {
"deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000",
"deviceName": "Luba-VA925276",
"status": 1,
"mainStatus": "Standby",
"lastOnlineTimestamp": 1763013324930,
"createTimestamp": 1776058649790
}
}Field Description:
| Field | Type | Required | Description |
|---|---|---|---|
pushTag | string | Yes | Push tag. Fixed value: attribute |
pushType | int | Yes | Push type. Fixed value: 1 |
pushData | object | Yes | Business payload of push message |
pushData.deviceId | string | Yes | Unique device ID |
pushData.deviceName | string | Yes | Device name |
pushData.status | int | Yes | Device status code |
pushData.lastOnlineTimestamp | long | Yes | Device last online time |
pushData.createTimestamp | long | Yes | Message create time |
pushTag = attribute / pushType = 2: Charge status
Example:
{
"pushTag": "attribute",
"pushType": 2,
"pushData": {
"deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000",
"deviceName": "Luba-VA925276",
"chargeStatus": 0,
"createTimestamp": 1776059243121
}
}Field Description:
| Field | Type | Required | Description |
|---|---|---|---|
pushTag | string | Yes | Push tag. Fixed value: attribute |
pushType | int | Yes | Push type. Fixed value: 2 |
pushData | object | Yes | Business payload of push message |
pushData.deviceId | string | Yes | Unique device ID |
pushData.deviceName | string | Yes | Device name |
pushData.chargeStatus | int | Yes | Charge status |
pushData.createTimestamp | long | Yes | Message create time |
pushTag = attribute / pushType = 3: Self-check status
Example:
{
"pushTag": "attribute",
"pushType": 3,
"pushData": {
"deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000",
"deviceName": "Luba-VA987654",
"selfCheckStatus": 11,
"createTimestamp": 1776061196023
}
}Field Description:
| Field | Type | Required | Description |
|---|---|---|---|
pushTag | string | Yes | Push tag. Fixed value: attribute |
pushType | int | Yes | Push type. Fixed value: 3 |
pushData | object | Yes | Business payload of push message |
pushData.deviceId | string | Yes | Unique device ID |
pushData.deviceName | string | Yes | Device name |
pushData.selfCheckStatus | int | Yes | Self-check status code |
pushData.createTimestamp | long | Yes | Message create time |
pushTag = attribute / pushType = 6: Battery percentage
Example:
{
"pushTag": "attribute",
"pushType": 6,
"pushData": {
"deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000",
"deviceName": "Luba-VA987654",
"batteryPercentage": 75,
"createTimestamp": 1776061196023
}
}Field Description:
| Field | Type | Required | Description |
|---|---|---|---|
pushTag | string | Yes | Push tag. Fixed value: attribute |
pushType | int | Yes | Push type. Fixed value: 6 |
pushData | object | Yes | Business payload of push message |
pushData.deviceId | string | Yes | Unique device ID |
pushData.deviceName | string | Yes | Device name |
pushData.batteryPercentage | int | Yes | Battery percentage (0~100) |
pushData.createTimestamp | long | Yes | Message create time |
pushTag = attribute / pushType = 8: Real-time coordinate position
Example:
{
"pushTag": "attribute",
"pushType": 8,
"pushData": {
"deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000",
"deviceName": "Luba-VA987654",
"lon": 104.00894152,
"lat": 30.46972243,
"createTimestamp": 1776062984432
}
}Field Description:
| Field | Type | Required | Description |
|---|---|---|---|
pushTag | string | Yes | Push tag. Fixed value: attribute |
pushType | int | Yes | Push type. Fixed value: 8 |
pushData | object | Yes | Business payload of push message |
pushData.deviceId | string | Yes | Unique device ID |
pushData.deviceName | string | Yes | Device name |
pushData.lon | number | Yes | Longitude |
pushData.lat | number | Yes | Latitude |
pushData.createTimestamp | long | Yes | Message create time |
pushTag = attribute / pushType = 9: Network status
Example:
{
"pushTag": "attribute",
"pushType": 9,
"pushData": {
"deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000",
"deviceName": "Luba-VA987654",
"usedNet": "1",
"wifiEnable": true,
"wifiSignalGrid": 4,
"fourGEnable": true,
"fourGSignalGrid": 3,
"createTimestamp": 1776065512320
}
}Field Description:
| Field | Type | Required | Description |
|---|---|---|---|
pushTag | string | Yes | Push tag. Fixed value: attribute |
pushType | int | Yes | Push type. Fixed value: 9 |
pushData | object | Yes | Business payload of push message |
pushData.deviceId | string | Yes | Unique device ID |
pushData.deviceName | string | Yes | Device name |
pushData.usedNet | string | Yes | Current network in use |
pushData.wifiEnable | boolean | Yes | Wi-Fi enabled status |
pushData.wifiSignalGrid | int | Yes | Wi-Fi signal level |
pushData.fourGEnable | boolean | Yes | 4G enabled status |
pushData.fourGSignalGrid | int | Yes | 4G signal level |
pushData.createTimestamp | long | Yes | Message create time |
pushTag = attribute / pushType = 10: Work progress
Example:
{
"pushTag": "attribute",
"pushType": 10,
"pushData": {
"deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000",
"deviceName": "Luba-VA987654",
"workArea": 5074,
"workProgress": 0,
"elapsedTime": 2,
"leftTime": 1179,
"createTimestamp": 1776065937722
}
}Field Description:
| Field | Type | Required | Description |
|---|---|---|---|
pushTag | string | Yes | Push tag. Fixed value: attribute |
pushType | int | Yes | Push type. Fixed value: 10 |
pushData | object | Yes | Business payload of push message |
pushData.deviceId | string | Yes | Unique device ID |
pushData.deviceName | string | Yes | Device name |
pushData.workArea | int | Yes | Working area |
pushData.workProgress | int | Yes | Work progress |
pushData.elapsedTime | int | Yes | Elapsed working time |
pushData.leftTime | int | Yes | Remaining work time |
pushData.createTimestamp | long | Yes | Message create time |
pushTag = notify / pushType = 1: Device nickname modification event
Example:
{
"pushTag": "notify",
"pushType": 1,
"pushData": {
"deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000",
"deviceName": "",
"nickname": ""
}
}Field Description:
| Field | Type | Required | Description |
|---|---|---|---|
pushTag | string | Yes | Push tag. Fixed value: notify |
pushType | int | Yes | Push type. Fixed value: 1 |
pushData | object | Yes | Business payload of push message |
pushData.deviceId | string | Yes | Unique device ID |
pushData.deviceName | string | Yes | Device name |
pushData.nickname | string | Yes | New nickname |
pushTag = notify / pushType = 3: New device binding event
Example:
{
"pushTag": "notify",
"pushType": 3,
"pushData": {
"deviceId": "4DM***d2p",
"deviceName": "Luba-MB3PC6VL",
"status": 19,
"mainStatus": "TaskPaused",
"lastOnlineTimestamp": 1793945914182,
"usedNet": "1",
"wifiEnable": true,
"wifiSignalGrid": 3,
"fourGEnable": false,
"fourGSignalGrid": 3,
"batteryPercentage": 62,
"coordinate": {
"lon": 104.0088707,
"lat": 30.46998501
}
}
}Field Description:
| Field | Type | Required | Description |
|---|---|---|---|
pushTag | string | Yes | Push tag. Fixed value: notify |
pushType | int | Yes | Push type. Fixed value: 3 |
pushData | object | Yes | Business payload of push message |
pushData.deviceId | string | Yes | Unique device ID |
pushData.deviceName | string | Yes | Device name |
pushData.status | int | Yes | Status code |
pushData.mainStatus | string | Yes | Main status identifier |
pushData.lastOnlineTimestamp | long | Yes | Last online timestamp (milliseconds) |
pushData.usedNet | string | Yes | Current network in use |
pushData.wifiEnable | boolean | Yes | Wi-Fi enabled status |
pushData.wifiSignalGrid | int | Yes | Wi-Fi signal level |
pushData.fourGEnable | boolean | Yes | 4G enabled status |
pushData.fourGSignalGrid | int | Yes | 4G signal level |
pushData.batteryPercentage | int | Yes | Battery percentage (0~100) |
pushData.coordinate | object | Yes | Real-time device coordinate position |
pushData.coordinate.lon | number | Yes | Longitude |
pushData.coordinate.lat | number | Yes | Latitude |
pushTag = notify / pushType = 4: Device unbinding event
Example:
{
"pushTag": "notify",
"pushType": 4,
"pushData": {
"deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000",
"deviceName": "",
"status": 1,
"mainStatus": 1
}
}Field Description:
| Field | Type | Required | Description |
|---|---|---|---|
pushTag | string | Yes | Push tag. Fixed value: notify |
pushType | int | Yes | Push type. Fixed value: 4 |
pushData | object | Yes | Business payload of push message |
pushData.deviceId | string | Yes | Unique device ID |
pushData.deviceName | string | Yes | Device name |
pushData.status | int | Yes | Unbind status |
pushData.mainStatus | int | Yes | Device current status |
pushTag = progress / pushType = 1: OTA upgrade progress
Example:
{
"pushTag": "progress",
"pushType": 1,
"pushData": {
"deviceId": "OlHl7Hmm6DCsdZq8P5Ap000000",
"deviceName": "Luba-VA653699",
"oldVersion": "2.1.1.9004",
"newVersion": "2.1.1.9002",
"progress": 100,
"upgradeStatus": "complete",
"failReason": [],
"otaId": "843140742607011840",
"triggerWay": "2"
}
}Field Description:
| Field | Type | Required | Description |
|---|---|---|---|
pushTag | string | Yes | Push tag. Fixed value: progress |
pushType | int | Yes | Push type. Fixed value: 1 |
pushData | object | Yes | Business payload of push message |
pushData.deviceId | string | Yes | Unique device ID |
pushData.deviceName | string | Yes | Device name |
pushData.oldVersion | string | Yes | Original firmware version |
pushData.newVersion | string | Yes | Target firmware version |
pushData.progress | int | Yes | OTA upgrade progress percentage |
pushData.upgradeStatus | string | Yes | Upgrade status |
pushData.failReason | array | Yes | List of failure reasons |
pushData.otaId | string | Yes | Unique OTA task ID |
pushData.triggerWay | string | Yes | Upgrade trigger mode |
pushTag = sc / pushType = 1: Server kick-off system message
Example:
{
"pushTag": "sc",
"pushType": 1
}Field Description:
| Field | Type | Required | Description |
|---|---|---|---|
pushTag | string | Yes | Push tag. Fixed value: sc |
pushType | int | Yes | Push type. Fixed value: 1 |
Special system message: The client must close the connection gracefully, do NOT auto-reconnect.
Appendix
- All timestamps are Unix timestamps in milliseconds.
- All messages are delivered as SSE raw JSON payloads, without extra
data:wrapper parsing logic. - New pushTag / pushType values will be appended to this document.
Last updated on


