常见问题Q&A | 文档中心

解答：

物联云平台提供的是可独立运行的程序，使用独立的进程运行与网关系统中。保活包含两个：A、程序的自启动 B、程序的守护（程序异常退出时，网关需有措施让退出的程序自动恢复运行）；
由于不同厂家的网关架构不同，程序的安装路径也可能不一样，所以程序的自启动一般由厂家实现；
网关由xcg、xsep、ptp程序组成，其中ptp程序一般由厂家实现，所以ptp的守护也由厂家实现。Xcg自带了进程守护功能，可无须厂家处理，但在android等系统除外，具体需要视网关系统环境而定是否要单独做进程守护。Xsep本地情景程序是可选模块，也须厂家处理，增加守护功能（例如增加守护脚本）。

解答：

如果是PTP程序上报一个子设备加入信息（$xlink/ptp/{ptp_id}/device/new），xcg会根据上报子设备信息激活子设备并在云端上线该子设备。

解答：

PTP协议中的子设备离开协议（$xlink/ptp/{ptp_id}/device/left），是指子设备本地退网，xcg收到该协议时，会删除该子设备，并且子设备会在云端离线。

解答：

PTPO是PTP的辅助协议，根据项目需求可选择是否实现。例如若需要支持主从网关，则必须实现PTPO。区别于PTP，实现PTPO需另外起一路MQTT连接到XCG，同时需实现PTPO自己的心跳维护。PTPO的具体协议说明，请参照协议文档。

解答：

PTP ID是PTP程序与XCG之间的唯一的标志ID，约定以”ptp_16个随机字符”来定义。规定每一个PTP连接的PTP ID都必须是唯一的，不能重复。如果有特殊需求，“16个随机字符”可采用有意义且唯一的字符替代。

解答：组网后，PTP有两种方式上报设备给XCG：

主动方式，当新子设备首次入网后，可主动上报子设备信息给XCG，Topic是：$xlink/ptp/{ptp_id}/device/new ;
被动方式,当PTP收到XCG的devices_public（获取列表信息）请求时，上报设备列表， Topic是:$xlink/ptp/{ptp_id}/devices。

解答：分以下3种情况：

解答：

暂停搜索命令由云端或APP触发。

解答：

可以通过在PTP程序里实现PTPO，并实现PTPO的“运维事件通知”协议，当PTP程序检测到Reset键按下时，发送运维事件通知($xlink/ptpo/{ptp_id}/optevent)给XCG（eventcode设置为0），XCG收到通知后，会进行重置操作（具体可参看协议文档）。

解答：

可以在设备列表页面，点击查看上下线历史记录按钮查看。

解答：

关于OTA，物联云平台提供了云端支持，可针对网关或子设备配置各自的升级任务，并提供升级包上传、下载服务。厂家可利用云端API或PTP协议（查询最新的升级任务、查询最新的升级任务结果），实现升级任务查询，并由此获得升级包下载地址。而升级包的下载、程序的关停、替换、重启等升级操作，由于不同厂家的网关架构不同，sdk的安装路径也可能不一样，或者厂家网关有自己的升级流程，所以一般由厂家自行实现OTA升级（PTPO对升级提供了一些辅助功能，具体可参看API或PTP协议文档）；
关于如何将新版本号传递给云端，升级程序可利用云端API或PTP协议（上报升级结果）实现。

解答：

网关程序由XCG、XSEP、PTP程序组成，其中PTP程序一般由厂家实现，所以ptp程序如何替换及需要替换哪些文件，由厂家自行决定。XCG和XSEP都是单一执行文件，没有其他依赖库文件，升级时只需替换原文件即可。另外根据项目需求决定XCG和XSEP的配置文件是否也需要升级替换；
一般替换文件时需先关停程序，通过PTPO的协议的“运维事件通知”协议，可触发xcg关停（xsep不支持）。或者使用系统killall命令先停止xcg和xsep程序。之后就可以进行文件的升级替换操作；
一般来说，将XCG、XSEP、PTP组成一个升级包在云端上传并管理，升级包需要包含当前的版本信息，并且与云端创建的升级任务版本信息一致。网关下载完升级包后，需要校验升级包正确性以及版本号，才执行升级的操作。并且将新的版本号记录在网关本地中。然后上报升级结果。后续检查升级时，需要使用新的版本号进行查询；
程序升级后，上报升级结果给云端成功后，可以在云端设备详情界面查看设备版本号。

上次更新：2024-05-09