步骤说明 | 飞思物联IOT平台

# 步骤说明

步骤说明

1.平台下发获取文件命令。
2.设备回复文件列表。
3.平台在数据库创建文件信息并回复设备准备好接收文件。
4.设备通过http接口上传文件。
5.平台根据http接口内的唯一码查找数据库是否存在，存在则处理文件上送，不存在则回复无上传权限。

注意事项

1.设备若想主动上送文件可直接从步骤2开始，不需要等待平台下发获取文件命令。
2.若设备收到平台获取文件命令，但没有需要上传的文件，则可不回复平台或回复fileNameList=空数组([])，平台不会进入步骤3。
3.平台下发招取文件命令时会从步骤3开始，直接下发招取文件报文，设备收到后根据接口上传文件。
4.平台下发配置文件时会直接下发文件信息报文给设备，设备收到后可根据文件url下载文件。

# 主题和内容说明

# 平台请求获取文件列表

topic iot/tx/${AppKey}/${ID}/fileList
{
"fileStep":"getFileList"
}
1
2
3

参数说明

getFileList=获取文件列表

# 设备回复平台文件列表

topic iot/rx/${AppKey}/${ID}/fileList

{
"fileStep":"resultFileList",
"fileList": [
  {"name":"xxx","docType":"xxx","crc":"xxx"},
  ...
]
}

1
2
3
4
5
6
7

参数说明

resultFileList：返回文件列表
fileList：文件列表
name：文件名称
docType：文件类型，目前暂定类型有：log / data / config /
crc：文件CRC校验码，预留，平台暂未做处理

# 平台回复设备准备好接收文件或招取文件

topic iot/tx/${AppKey}/${ID}/fileList

{
"fileStep":"readyToReceive",
"fileList": [{"name":"xxx","uniqueCode":"xxx"}...],
"url": "xxxx"
}

1
2
3
4
5

参数说明

readyToReceive：准备好接收文件
name：文件名称
uniqueCode：文件唯一码，平台生成，用于区分文件唯一性，设备需保存文件和唯一码关联关系用以平台招取文件或设备下载文件
url：上传文件接口
设备收到该内容后可通过url调用平台接口上传文件到服务器

# 设备下载文件

topic iot/rx/${AppKey}/${ID}/fileList
{
"fileStep":"downloadFile",
"fileList": [{"uniqueCode":"xxx"}...]
}
1
2
3
4

参数介绍

downloadFile：下载文件
fileList：需要下载的文件列表
uniqueCode：文件唯一码

# 平台回复文件下载地址或下发文件

topic iot/tx/${AppKey}/${ID}/fileList

{
"fileStep":"resultDownloadFile",
"fileList": [{"uniqueCode":"xx","name":"xx","code":200,"msg":"xx","url":"xxx"}...]
}

1
2
3
4

参数介绍

resultDownloadFile：平台回复下载文件
fileList：下载的文件列表
uniqueCode：文件唯一码
name：文件名称
code：等于200为文件正常可下载，其他为不可下载，具体可查看msg信息
msg：文件下载信息，code等于200时为空，否则为
url：文件http下载地址