设备管理

一. 设备新增

1. topic

res/device/add

2. payload

[
    {
        "ext_button": [],
        "ext_light": [],
        "ext_sync": {},
        "has_new": 0,
        "id": "10E48D35-0ABD-47EB-BA4B-C150D68C4B23",
        "join_status": 1,
        "name": "Bar Lamp",
        "new_version": "",
        "online": 1,
        "product": {
            "cat1_id": 2,
            "cat1_name": "Light",
            "cat2_id": 205,
            "cat2_name": "RGB CW Light",
            "cat3_id": 20504,
            "cat3_name": "Bar Lamp",
            "hardware_version": "6",
            "manufacturer": "Bweetech",
            "model": "915005988001",
            "software_version": "",
            "zigbee_version": "4.11.11_50"
        },
        "services": [
            {
                "rid": "8BAD2C8A-38BE-41CB-A4D3-563B5C7E9C03",
                "rtype": "light"
            }
        ],
        "type": "device"
    }
]

3. 字段说明

序号	字段	类型	说明
1	id	string	设备的UUID
2	type	string	资源类型, 此处固定为 "device"
3	name	string	设备名称
4	join_status	int	入网状态, 此处必然为1
5	online	int	在线状态, 设备刚添加成功时必然为1
6	has_new	int	是否有新版本, 1有, 0没有
7	new_version	string	新版本的版本号
8	product	object	产品信息, 详见API文档
9	services	object array	服务列表
9.[].1	rid	string	资源UUID
9.[].2	rtype	string	资源类型
10	ext_light	object array	灯具状态, 详见API文档
11	ext_sync	object	同步器状态, 详见API文档
12	ext_button	object_array	按键状态, 详见API文档

4. 功能说明

• 此topic会在设备入网后, 并且将 join_status 设置为1时 触发

---

二. 设备删除

1. topic

res/device/remove

2. payload

[
    {
        "id": "10E48D35-0ABD-47EB-BA4B-C150D68C4B23",
        "type": "device"
    }
]

3. 字段说明

序号	字段	类型	说明
1	id	string	设备唯一ID
2	type	string	资源类型, 此处固定为 "device"

4. 功能说明

• 此topic会在设备删除, 或者设备 join_status 置为 0 时触发

---

三. 设备更新

1. topic

res/device/update

2. payload

[
    {
        "id": "10E48D35-0ABD-47EB-BA4B-C150D68C4B23",
        "value": {
            "name": "吧灯01"
        }
    }
]

3. 字段说明

序号	字段	类型	说明
1	id	string	设备的 ID
2	value	object	有更新的字段

value对象

序号	字段	类型	说明
1	name	string	设备名称
2	room_id	string	房间的UUID

4. 功能说明

• 在设备信息变更时, 会触发此 topic
• value对象中, key存在代表有更新, key不存在代表未更新