升级接收卡
# 升级接收卡
Path:
/api/rcv_update
Method: POST
Content-type: application/json; charset=utf-8
接口描述:
升级接收卡程序
上传升级文件 body 需要使用form-data方式
不上传升级文件使用 raw 即可(播放盒内部应用使用,升级文件存放到/mnt/sdcard/Android/data/com.color.home/files/RCV_UPDATE)。
请求参数
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| limitType | byte | true | 默认为true,true:限制型号生成,false:不限制型号升级 |
升级描述文件字段说明:
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| name | string | "xx.hex" | 升级文件的名称 |
| portIndexes | List | - | 需要升级的网口信息 |
portIndexInfo
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| portIndex | byte | 0 | 接收卡所在网口序号 |
| rcvIndexes | List | [0,1,2] | 需要升级的接收卡序号数组(接收卡序号从0开始) |
升级描述文件示例(名称必须是update.json)
{
"name": "xxx.hex",
"portIndexes": [{
"portIndex": 1,
"rcvIndexes": [1, 2]
}, {
"portIndex": 2,
"rcvIndexes": [0, 2]
}]
}
请求示例
(1)form-data方式

(2)raw方式

返回数据
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| errorCode | int | 0 | 错误码 |
| apiErrorCode | int | 0 | sdk |
| portIndexes | List | - | 升级结果数组,假如errorCode或者apiErrorCode不为0,则这个为空 |
PortUpdateInfo
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| portIndex | int | 0 | 网口序号(网口序号从0开始) |
| rcvIndexes | List | - | 网口内接收卡升级结果数组 |
rcvUpdateInfo
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| rcvIndex | int | 0 | 接收卡序号 |
| errorCode | int | 0 | 错误码 |
响应示例
{
"errorCode": 0,
"apiErrorCode": 0,
"portIndexes": [{
"portIndex": 0,
"rcvIndexes": [{
"rcvIndex": 0,
"errorCode": 0
}, {
"rcvIndex": 1,
"errorCode": 0
}]
}, {
"portIndex": 1,
"rcvIndexes": [{
"rcvIndex": 0,
"errorCode": 0
}, {
"rcvIndex": 1,
"errorCode": 0
}]
}]
}
注意
●升级描述文件文件名必须为update.json
●描述文件中的参数名必须和上传文件的文件名对应上
●升级描述文件里面网口序号和网口内的接收卡序号不能重复