Device
更新时间：2019-06-14
| 字段 | 类型 | 说明 |
|---|---|---|
| uuid | String | 全局唯一ID |
| code | String | 设备名称。同一个gateway下唯一 |
| description | String | 设备描述 |
| gatewayUuid | String | 网关id |
| gatewayCode | String | 冗余字段。与gatewayUuid对应的gateway的code字段保持一致 |
| slaveId | Int | 用于modbus。只能从1-247（包括1和237）中取值且同一个gateway下唯一 |
| address | String | 用于子设备的ip:port, 或者串口地址(eg: /dev/pts/6) |
| mode | ENUM | [ TCP/RTU ]。默认值TCP |
| baud | Int | 波特率，仅用于RTU模式 |
| databits | Int | 数据位长，[7-8], 默认值8, 仅用于RTU模式 |
| stopbits | Int | 停止位长，[1,2], 默认值1, 仅用于RTU模式 |
| parity | ENUM | 校验方式， [NONE/EVEN/ODD],默认值NONE，仅用于RTU模式 |
| state | ENUM | [ENABLED, DISABLED] |
| status | ENUM | [ERROR, ACTIVE, DELETED] |
| createTime | DateTime | 创建记录的时间 |
| updateTime | DateTime | 最后修改记录的时间 |
筛选
接口描述
| 相对URI | HTTP 方式 |
|---|---|
| /v1/devicece | GET |
输入
| 名称 | 类型 | 是否必选 | 默认值 | 含义 |
|---|---|---|---|---|
| gatewayUuid | String | N | null | 网关id |
| state | ENUM | N | null | [ENABLED, DISABLED] |
输出
200: 成功
输出一个Device的List
其他: 失败
请求示例
Plain Text
1GET /v1/devicece输出示例
Plain Text
1{
2 "totalCount": 1,
3 "result": [
4 {
5 "databits": 8,
6 "baud": 300,
7 "address": "127.0.0.1:502",
8 "gatewayUuid": "08d95c37-bc72-44cd-8e93-8d94ff52a934",
9 "state": "ENABLED",
10 "description": "",
11 "code": "subdevice",
12 "mode": "TCP",
13 "createTime": "2017-02-04T08:16:11Z",
14 "parity": "NONE",
15 "status": "ACTIVE",
16 "slaveId": 1,
17 "stopbits": 1,
18 "updateTime": "2017-02-04T08:16:11Z",
19 "gatewayCode": "jwangateway",
20 "uuid": "8603dbc2-3fdc-4683-bfc5-dc18ed50adcf"
21 }
22 ],
23 "order": "desc",
24 "orderBy": "createTime",
25 "pageSize": 5,
26 "pageNo": 1
27}获取
接口描述
| 相对URI | HTTP 方式 |
|---|---|
| /v1/device/:deviceUuid | GET |
输入
| 名称 | 类型 | 是否必选 | 默认值 | 含义 |
|---|---|---|---|---|
| deviceUuid | String | Y | 子设备id |
输出
200: 成功
输出一个这个uuid对应的device
其他: 失败
请求示例
Plain Text
1GET /v1/devicece/8603dbc2-3fdc-4683-bfc5-dc18ed50adcf输出示例
Plain Text
1{
2 "databits": 8,
3 "baud": 300,
4 "address": "127.0.0.1:502",
5 "gatewayUuid": "08d95c37-bc72-44cd-8e93-8d94ff52a934",
6 "state": "ENABLED",
7 "description": "",
8 "code": "subdevice",
9 "mode": "TCP",
10 "createTime": "2017-02-04T08:16:11Z",
11 "parity": "NONE",
12 "status": "ACTIVE",
13 "slaveId": 1,
14 "stopbits": 1,
15 "updateTime": "2017-02-04T08:16:11Z",
16 "gatewayCode": "jwangateway",
17 "uuid": "8603dbc2-3fdc-4683-bfc5-dc18ed50adcf"
18}创建
接口描述
| 相对URI | HTTP 方式 |
|---|---|
| /v1/device | POST |
输入
| 名称 | 类型 | 是否必选 | 默认值 | 参数位置 | 说明 |
|---|---|---|---|---|---|
| code | String | Y | body json | 子设备名称（同一网关下唯一) | |
| description | String | N | "" | body json | 子设备描述 |
| gatewayUuid | String | Y | body json | 所属网关id | |
| slaveId | Int | Y | body json | MODBUS从站号[1-247] | |
| address | String | Y | body json | 地址， 对于TCP模式：ip:port, 如192.168.0.2:502 对于RTU模式：是串口号，如/dev/USBtty1 | |
| mode | ENUM | N | TCP | body json | TCP, RTU |
| baud | Int | N | 9600 | body json | 波特率，仅对RTU有意义 |
| databits | Int | N | 8 | body json | 数据位，仅对RTU有意义 |
| stopbits | Int | N | 1 | body json | 停止位，仅对RTU有意义 |
| parity | ENUM | N | NONE | body json | 校验，NONE/EVEN/ODD, 仅对RTU有意义 |
输出
201: 成功
输出创建成功的device
其他: 失败
请求示例
Plain Text
1{
2 "databits": 8,
3 "baud": 300,
4 "address": "127.0.0.1:502",
5 "gatewayUuid": "08d95c37-bc72-44cd-8e93-8d94ff52a934",
6 "description": "",
7 "code": "subdevice",
8 "mode": "TCP",
9 "parity": "NONE",
10 "slaveId": 1,
11 "stopbits": 1,
12}输出示例
Plain Text
1{
2 "databits": 8,
3 "baud": 300,
4 "address": "127.0.0.1:502",
5 "gatewayUuid": "08d95c37-bc72-44cd-8e93-8d94ff52a934",
6 "state": "ENABLED",
7 "description": "",
8 "code": "subdevice",
9 "mode": "TCP",
10 "createTime": "2017-02-04T08:16:11Z",
11 "parity": "NONE",
12 "status": "ACTIVE",
13 "slaveId": 1,
14 "stopbits": 1,
15 "updateTime": "2017-02-04T08:16:11Z",
16 "gatewayCode": "jwangateway",
17 "uuid": "8603dbc2-3fdc-4683-bfc5-dc18ed50adcf"
18}更新
接口描述
| 相对URI | HTTP 方式 |
|---|---|
| /v1/device/:deviceUuid | PUT |
输入
不能所有字段都为空
| 名称 | 类型 | 是否必选 | 默认值 | 参数位置 | 说明 |
|---|---|---|---|---|---|
| description | String | N | body json | 描述 | |
| slaveId | Int | N | body json | modbus 从站号 | |
| address | String | N | body json | 地址 | |
| state | ENUM | N | body json | 状态，[ENABLED, DISABLED] | |
| mode | ENUM | N | body json | TCP,RTU | |
| baud | Int | N | body json | 波特率 | |
| databits | Int | N | body json | 数据位 | |
| stopbits | Int | N | body json | 停止位 | |
| parity | ENUM | N | body json | 奇偶校验 |
输出
201: 成功
输出更新成功后的device
其他: 失败
请求示例
Plain Text
1{
2 "description":"",
3 "gatewayUuid":"08d95c37-bc72-44cd-8e93-8d94ff52a934",
4 "slaveId":1,
5 "address":"127.0.0.1:502",
6 "mode":"TCP",
7 "baud":300,
8 "databits":8,
9 "stopbits":1,
10 "parity":"NONE"
11}输出示例
Plain Text
1{
2 "databits":8,
3 "baud":300,
4 "address":"127.0.0.1:502",
5 "gatewayUuid":"08d95c37-bc72-44cd-8e93-8d94ff52a934",
6 "state":"ENABLED",
7 "description":"",
8 "code":"subdevice",
9 "mode":"TCP",
10 "createTime":"2017-02-04T08:16:11Z",
11 "parity":"NONE",
12 "status":"ACTIVE",
13 "slaveId":1,
14 "stopbits":1,
15 "updateTime":"2017-02-04T08:16:11Z",
16 "gatewayCode":"jwangateway",
17 "uuid":"8603dbc2-3fdc-4683-bfc5-dc18ed50adcf"
18}删除
接口描述
| 相对URI | HTTP 方式 |
|---|---|
| /v1/device/:deviceUuid | DELETE |
输入
| 名称 | 类型 | 是否必选 | 默认值 | 含义 |
|---|---|---|---|---|
| deviceUuid | String | Y | 子设备id |
输出
204: 成功
其他: 失败
请求示例
Plain Text
1DELETE /v1/device/8603dbc2-3fdc-4683-bfc5-dc18ed50adcf