MQTT的使用配置 （数据转发-固件1400以上使用）
1.引言
1.1使用范围
适用于使用FlexManager软件的所有用户。
适用于固件版本号1415及以上的设备。
1.2 版权声明
本文档可能包含本公司技术机密以及其他需要保密的信息，文档所包含的所有信息均为繁易信息科技股份有限公司版权所有。未经本公司书面许可，不得向授权许可方以外的任何第三方泄露本文档内容，不得以任何形式擅自复制或传播本文档。若使用者违反本版权保护的约定，本公司有权追究使用者由此产生的法律责任。
1.3 概要
1) 新版本MQTT链路连接更加稳定，交互数据格式更加规范，更加灵活；
2） 新版本交互格式改为可配置Json格式的方式，主题、变量名可灵活命名；
3） 提供数据发布权限（Public），数据订阅权限（Subscribe）和订阅发布权限（Sub & Pub），客户可以根据不同场景灵活配置；
4） 支持数据变化上报；支持数据周期上报；
5） 支持监控点、报警数据上报；
6） 支持摄像头图片上传功能（需配合本地串口/网口摄像设备）；
2.使用说明
在FlexManager软件中使用MQTT协议进行数据转发，主要分为3个步骤：
1.连接配置（对接的MQTT服务器参数和MQTT协议参数等）
2.数据配置
Topic主题及功能配置（主题配置并选择MQTT中的sub、pub的功能项）
变量关联（从监控点中选择需要的点进行关联）
3.同步配置（发布执行）
2.1新建MQTT连接配置
在配置连接列表区域中点击图标 “+”，新建MQTT连接配置。
如下图 2- 1所示：
图 2- 1
将弹出连接配置主界面，如下图 2- 2所示：
图 2- 2
主要参数界面中的基本信息说明如下表2- 1：
| 界面字段 | 描述 | 必填 |
|---|---|---|
| 名称 | MQTT连接配置名称，支持32个字符，包括0~9，a~z,汉字等字符。 | √ |
| 代理平台 | 使用提供MQTT服务平台 | √ |
| 服务地址 | MQTT推送的服务器地址，支持128个字符 | √ |
| 服务端口 | MQTT推送的服务器地址的端口号 | √ |
| 设备ID | 设备ID是FBox登录MQTT服务器时的客户端标识符 | √ |
表2- 1
注：在MQTT功能配置连接列表中最多可新建10个MQTT连接配置，同时只支持一个MQTT连接配置执行，后续版本将支持多个MQTT连接配置执行。
常规配置：配置MQTT连接的常规参数，如下图 2- 3所示：
图 2- 3
界面中的基本信息说明如下表2- 2：
| 界面字段 | 描述 | 必填 |
|---|---|---|
| MQTT版本 | 目前FlexManager支持，3.1.1和3.1的MQTT标准协议 | √ |
| KeepAlive | 保活时间（Keep Alive）是一个以秒为单位的时间间隔，为一个16位的字，它是指在客户端传输完成一个控制报文的时刻到发送下一个报文的时刻，两者之间允许空闲的最大时间间隔 | √ |
| 上传方式 | 设置数据上传推送方式，支持周期推送、变化推送、变量变化推送 | √ |
| 周期 | 设置数据周期推送时间 | √ |
| 设置的变量当出现变化进行推送 | ||
| 变量变化 | 设置的变量变化做为条件进行配置变量数据推送(理解为条件推送) |
表2- 2
用户验证：配置MQTT登录服务器的验证信息，如下图 2- 4所示：
图 2- 4
用户验证界面中的基本信息说明如下表2- 3：
| 界面字段 | 描述 | 必填 |
|---|---|---|
| 用户验证 | 是FBox登录MQTT服务器所需要的用户信息验证 | √ |
| 用户名 | 登录MQTT服务器用户名 | √ |
| 密码 | 登录MQTT服务器密码 | √ |
连接模式：配置MQTT登录服务器的验证信息，如下图 2- 5所示：
图 2- 5
连接模式界面中的基本信息说明如下表2- 4：
| 界面字段 | 描述 | 必填 |
|---|---|---|
| 连接方式 | TCP的MQTT连接，并提供了两种连接方式：TCP连接、TCP加密连接(与MQTT服务器使用TLS（SSL）进行通讯) | √ |
| 客户端证书 | 客户端证书文件 | |
| CA证书 | 根证书，单击ca.crt链接下载文件。 | |
| 客户端密钥 | 客户端密钥文件 |
表2- 4
其他配置：配置MQTT登录服务器的验证信息，如下图 2- 6所示：
图 2- 6
其他配置界面中的基本信息说明如下表2- 5：
| 界面字 段 | 必填 | 描述 |
|---|---|---|
| 离线缓存 | √ | 允许在MQTT离线的状态下，将推送的消息缓存到SD卡U盘或本地，当FBox重新上线后会将缓存数据重新上传。 |
| 存储方式 | 存储到本地最大存储条数为1000条，SD卡和U盘根据容量大小不同来判断数据存储量。说明：本地保存数据最大1000条，超过1000条时会自动覆盖前面数据。 | |
| 上报间隔 | 上报间隔是离线数据的上报间隔时间。 | |
| 采样间隔 | 采样间隔是离线数据采集间隔时间。 | |
| 压缩 | 省流量、增加传输速度等需求时可以启用压缩功能。具体可参考brotli压缩说明文档。 |
表2- 5
2.2 数据配置
2.2.1 数据自定义组合方式 & 时间自定义组合方式
数据自定义组合方式 ：
数据自定义组合方式：MQTT 数据推送中，可以自定义组合数据的方式来接收自己自定义的数据格式。如下图：
自定义组合方式里的 %quality%参数变量是消息质量,可以用判断监控点离线或者不正常的情况下使用,可以区分监控点是否在线还是超时的一个参数变量。"quality":0表示正常的监控点。目前支持周期推送 ，变化推送的两种方式可以看到监控点状态，在关联变量的时候选择自定义的数据格式。如下图：
接收到的数据的类型就是自己自定义的数据类型了，如下图：
2.2.2 时间自定义组合方式:
MQTT 数据推送中，可以自定义组合的方式来接收自己自定义推送时间。
我们MQTT 中默认系统的秒级别的long型的utc 时间戳，自定义时间格式，默认推送的是系统时间格式，如需要自己自定义的格式，需要启用配置信息。
2.2.3 主题及功能配置
在 数据配置列表 区域中点击“添加”按钮，添加MQTT数据配置。如下图 2- 7：
图 2-7
将弹出MQTT数据配置的界面，我们用Pub操作权限下的发布监控点数据来做一个示范，如下图 2- 8所示：
图 2- 8
界面中的基本信息说明如下表2- 6：
| 界面字段 | 描述 | 必填 |
|---|---|---|
| 主题 | 主题(Topic)是UTF-8字符串，是发布/订阅（Pub/Sub）消息的传输中介，MQTT是通过主题对消息进行分类。注：主题名称可自定义配置(与MQTT服务器中的主题相匹配)，但在同一配置协议中不支持配置相同的主题信息，一个主题只能对应一个功能 | √ |
| 描述 | 当前数据配置的描述信息 | |
| 操作权限 | sub表示需要订阅的主题，pub表示需要发布的主题，pub_sub表示该主题既可以订阅也可以发布 | √ |
| 功能 | 为当前FlexManager软件通过MQTT所支持的功能，功能详情接收请查看功能描述 | √ |
| 推送策略 | mqtt-pub实现多周期推送配置，及多服务器间的pub及sub。目前推送策略支持 周期推送，变化推送，变量变化推送方式。 |
表2- 6
2.2.3.1 MQTT数据关联
1. 如需自定义JSON数据层级，选择“添加“。
点击“添加”按钮，表格中新增一条MQTT变量数据。
当属性类型选择int,long,uint,float,double,string,boolean时，需要点击
关联变量按钮，选择关联某一个内部变量或者监控点。
当属性类型中选择array或者object时，可以选择
添加子项或者
批量导入监控点。如下图 2- 8所示：
图 2- 8
界面中的基本信息说明如下表2- 6：
| 界面字段 | 描述 | 必填 |
|---|---|---|
| MQTT变量名称 | 可自定义MQTT变量名称，与服务器名称保持一致 | √ |
| 属性类型 | 变量数据支持多种类型。注意：选择“array”、“obiect”时，可执行添加子项、批量导入功能，不能执行关联 | √ |
| 变量名称 | 关联数据的变量名称。注意：同一层级中，变量名称不允许相同 | |
| 可以对这个变量赋予一个固定值 | ||
| 删除 | 删除选择的数据条目 | |
| 关联 | 关联变量。注意：只有选择非“array”、“obiect”时，才能关联 | |
| 添加子项 | 在当前数据条目下级，添加子项MQTT变量 | |
| 批量导入 | 在当前数据条目下级，批量关联变量 |
表2- 6
2. 如需快速导入监控点，选择“批量导入”。
选择批量导入后，会弹窗出现关联变量界面。如下图 2- 9所示：
图 2- 9
界面中的基本信息说明如下表2- 7：
| 界面字段 | 描述 | 必填 |
|---|---|---|
| 内部变量 | FBox当前支持MQTT执行的内部功能变量。详情可查看内部变量参数规范 | |
| 监控点 | 监控点变量数据 | |
| 分组名 | 监控点所在的分组 | |
| 名称 | 内部变量名称 | |
| 数据类型 | 内部变量数据类型 | |
| 读写 | 监控点是否是可读，可写，及读写类型 | |
| 描述 | 当前变量数据的描述信息 | |
| 组合方式根据需要自定义格式，在选择点位的时候选择配置好的组合方式 | ||
| 配置当前选择点位是否按照配置的自定义数据格式来推送 | ||
| 默认生成MQTT变量名称 | 勾选此功能点击“确认”按钮，可将关联变量名称的自动生成到MQTT变量名称中，替换原来的MQTT变量名称 |
表2- 7
点击“内部变量”按钮，会切换到内部变量页中，如下图 2- 10所示：
图 2- 10
界面中的基本信息说明如下表2- 8：
| 界面字段 | 描述 | 必填 |
|---|---|---|
| 名称 | 监控点名称。注：监控点名称只能在“监控点”管理页面修改 | |
| 数据类型 | 监控点数据类型。注：监控点数据类型只能在“监控点”管理页面修改 | |
| 描述 | 当前监控点数据的描述信息 | |
| 默认生成MQTT变量名称 | 勾选此功能点击“确认”按钮，可将关联变量名称的自动生成到MQTT变量名称中，替换原来的MQTT变量名称 |
表2- 8
2.2 配置同步
配置完成保存之后在“数据配置列表”页点击“配置同步”按钮，将已配置的数据下发到FBox中进行执行，如下所示：
注意：每做一次修改操作，都需要进行一次配置同步。
图 2- 11
界面中的基本信息说明如下表2- 9：
| 界面字段 | 描述 | 必填 |
|---|---|---|
| 添加 | 添加多条MQTT主题功能数据。说明：同一主题(Topic)只能配置一个功能 | |
| 配置同步 | 将当前MQTT连接配置文件（包含主题功能数据）打包下发到FBox中进行执行 | |
| 导入配置（点开配置同步旁边的小三角） | 可以将其他FBox中的MQTT连接配置文件，导入至当前连接配置列表中。说明：导入文件和当前FBox中的监控点不一致时，会自动去掉不一致的MQTT变量数据 | |
| 导出配置 | 当前MQTT连接配置文件（包含主题功能数据）打包生成.cfg格式导出，方便查看连接配置数据格式 | |
| 批量删除 | 多选批量删除数据配置列表数据 | |
| 搜索 | 可搜索“主题”“描述”字段 |
表2- 9
2.3 配置连接列表
在“配置连接列表”区域中页点击
按钮，可对当前MQTT连接配置文件进行操作，如下图 2- 12所示：
图 2- 12
界面中的基本信息说明如下表2- 10：
| 界面字段 | 描述 | 必填 |
|---|---|---|
| 配置连接列表 | 可以创建多个连接列表，支持多通达连接，但是最多只能启用三个连接，且对固件版本也有要求在1598固件以上支持。 | |
| 图标 | 当前配置连接的状态。说明：灰色表示未执行，绿色表示已下发执行 | |
| 名称 | 当前配置连接名称。说明：在当前配置连接列表中，不允许存在相同的名称 | |
| 编辑 | 对当前配置连接进行修改 | |
| 复制 | 可将当前MQTT配置连接数据（包含主题功能数据）复制给当前FBox和客户拥有的其他FBox。说明：复制给其他FBox时，一次最多只能复制给10个FBox | |
| 删除 | 删除当前MQTT配置连接数据（包含主题功能数据） |
表2- 10
3.功能描述
该功能为：MQTT1.1支持的所有功能信息
3.1写监控点数据
该功能为写监控点功能，用于修改监控点的数值；发送的格式根据配置格式自定义定义发送，写入的监控点信息可以少于等于配置格式定义的监控点数量；
如有需要，可在Pub权限功能中添加一条写监控点数据回复。
3.1.1 Sub服务器请求Topic
| 服务器请求Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 可勾选或全选）读写设置为“可写/读写”的监控点 |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/String | 时间戳 | 否 |
| flexem_message_id | Long/String | 客户自定义数值字段，返回时会原样返回改数值。 | 否 |
3.1.2 Pub客户端响应Topic
| 客户端响应Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 对应的Sub服务器请求Topic中关联的所有监控点 |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/String | 时间戳 | 否 |
| flexem_message_id | Long/String | 客户自定义数值字段，返回时会原样返回改数值。可用于识别数据包。 | 否 |
| flexem_error_code | Integer/string | 操作后返回的状态码 | 否 |
| flexem_message | String | 操作后返回状态的文字描述 | 否 |
示例：
3.2发布监控点数据
该功能为发布监控点数据功能，根据绑定的监控点的个数配置json交互格式自定义发送数据格式；本功能没有请求Topic。
3.2.1 Pub 客户端Topic
| 客户端Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| （可勾选或全选）读写设置为“可读/读写”的监控点 |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/String | 时间戳 | 否 |
示例：
3.3 发布报警点数据
该功能为发布绑定的报警点信息，更具触发条件当报警信息被触发时则根据配置格式发送报警数据，当触发条件恢复时则根据配置条件发送恢复状态；本功能没有请求Topic。
3.3.1 Pub 客户端Topic
| 客户端Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| （可勾选或全选）所有报警点 |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/String | 时间戳 | 否 |
| flexem_alarm | String | 报警触发类型（“alarm”-触发报警，“restore”-报警恢复） | 是 |
示例：
3.4 暂停或开启监控点推送
该功能为暂停或开启监控点推送功能，当用户需要暂时关闭或开启FBOX推送MQTT数据功能时启用该功能；如有需要，可在Pub权限功能中添加一条暂停或开启监控点推送回复。
3.4.1 Sub 服务器请求Topic
| 服务器请求Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 无 |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/String | 时间戳 | 否 |
| flexem_message_id | Long/String | 客户自定义数值字段，返回时会原样返回改数值。可用于识别数据包。 | 否 |
| flexem_error_code | Integer/string | 操作后返回的状态码 | 否 |
| flexem_message | String | 操作后返回状态的文字描述 | 否 |
| flexem_pause | Boolean | 暂停MQTT数据推送，值为1表示暂停推送，值为0表示恢复推送 | 是 |
示例：
3.5 重启FBOX
该功能为通过MQTT消息重启FBOX，重启是需要发送指定点位数据；
本功能没有响应Topic。
3.5.1 sub服务器请求Topic
| 服务器请求Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 无 |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/String | 时间戳 | 否 |
| flexem_reboot | boolean | 该数据段表示是否重启FBOX | 是 |
示例：
3.6设置监控点上报行为
该功能为设置监控点的上报行为，包括：“数据变化上报”、“数据周期上报”和“是否开启报警点数据上报”；而数据数据周期上报又可以设置上报时间；通过MQTT协议格式下发的时间固定为毫秒（ms）单位；如有需要，可在发布权限功能中添加一条设置监控点上报行为回复。
3.6.1 Sub 服务器请求Topic
| 服务器请求Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 无 |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/String | 时间戳 | 否 |
| flexem_message_id | Long/String | 客户自定义数值字段，返回时会原样返回改数值。可用于识别数据包。 | 否 |
| flexem_push_interval | unsigned integer | 该数据段表示需要设置监控点数据的发布周期（单位：ms） | 否 |
| flexem_push_mode | string | 数据推送方式（“interval”:周期推送，”change”:变化推送） | 否 |
| flexem_push_alarm | boolean | 该数据段表示是否启用报警点信息上报功能 | 否 |
3.6.2 Pub客户端响应Topic
| 客户端响应Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 无 |
关联属性点:
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/String | 时间戳 | 否 |
| flexem_message_id | Long/String | 客户自定义数值字段，返回时会原样返回改数值。可用于识别数据包。 | 否 |
| flexem_error_code | Integer/string | 操作后返回的状态码 | 否 |
| flexem_message | String | 操作后返回状态的文字描述 | 否 |
3.7 立即获取监控点数据
该功能为通过下发指定的监控点来立即获取想要的点位信息，下发的点位信息可以少于定于的监控点；需要Pub权限功能中添加一条立即获取监控点数据回复。
3.7.1 Sub服务器请求Topic
| 服务器请求Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| （可勾选或全选）读写设置为“可读/读写”的监控点，只有选中的监控点可以返回点位信息。注：立即获取监控点功能需要下发获取的点位名称，此时点位名称不需要填写变量值，"temprature": null,"pressure":null} |
关联属性点:
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/String | 时间戳 | 否 |
| flexem_timestamp | Long/String | 客户自定义数值字段，返回时会原样返回改数值。可用于识别数据包。 | 否 |
3.7.2 pub客户端响应Topic
| 客户端响应Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 对应的Sub服务器请求Topic中关联的所有监控点 |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/String | 时间戳 | 否 |
| flexem_message_id | Long/String | 客户自定义数值字段，返回时会原样返回改数值。可用于识别数据包。 | 否 |
示例：
一次性获取全部监控点位：
获取部分点位数据：
3.8 获取FBOX信息
该功能为获取FBOX中相应的信息，主要包括位置信息和状态信息；位置信息有：经度、纬度；状态信息有：固件版本信息、数据发布周期、数据发布模式、当前监控点是否暂停推送；需要Pub权限功能中添加一条立即获取监控点数据回复。
3.8.1 Sub 服务器请求Topic
| 服务器请求Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 无 |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/String | 时间戳 | 否 |
| flexem_message_id | Long/String | 客户自定义数值字段，返回时会原样返回改数值。可用于识别数据包。 | 否 |
| flexem_get_info | string | 该数据段表示需要获取盒子的一些状态信息（“location” 获取位置信息，“status” 获取状态信息） | 是 |
3.8.2 pub 客户端响应Topic
| 客户端响应Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 无 |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/string | 时间戳 | 否 |
| flexem_message_id | Long/string | 客户自定义数值字段，返回时会原样返回改数值。可用于识别数据包。 | 否 |
| flexem_error_code | Integer/string | 操作后返回的状态码 | 否 |
| flexem_info_type | string | 该数据段表示需要发布盒子的一些信息的类型（“location” 发布位置信息，“status” 发布状态信息） | 是 |
| flexem_sim_lac | uint/string | 基站-位置区域码（也叫，小区号） | 否 |
| flexem_sim_ccid | uint/string | 基站-基站编号 | 否 |
| flexem_sim_mcc | uint/string | 基站-移动国家代码 | 否 |
| flexem_sim_mnc | uint/string | 基站-移动网络号码 | 否 |
| flexem_longitude | float/string | GPS信息-经度信息 | 否 |
| flexem_latitude | float/string | GPS信息-纬度信息 | 否 |
| flexem_push_interval | unsigned integer | 该数据段表示需要设置监控点数据的发布周期 | 否 |
| flexem_push_mode | string | 表示数据发送类型（支持，周期推送和变化推送） | 否 |
| flexem_pause | boolean | 该数据段表示是否暂停当前FBOX想MQTT服务器的数据推送 | 否 |
| flexem_fcs_ver | unsigned integer | 该数据段表示FBox内Fcs的代码版本 | 否 |
| flexem_floader_ver | unsigned integer | 该数据段表示FBox内Floader的代码版本 | 否 |
| flexem_fds_ver | Unit/string | Unit/string | 否 |
| flexem_mac | string | MAC地址 | 否 |
| flexem_sn | string | 盒子/屏的序列号 | 否 |
| flexem_password | string | 盒子/屏的密码 | 否 |
| flexem_online_sta | integer | 盒子在线状态 | 否 |
| flexem_net_type | integer | 盒子联网类型 | 否 |
| flexem_wireless | integer | 盒子无线信号强度 | 否 |
| flexem_vnc_op_password | string | VNC操控密码 | 否 |
| flexem_vnc_mo_password | string | VNC监控密码 | 否 |
| flexem_connect_sta | boolean | 网络连接状态 | 否 |
| flexem_sd_card_sta | boolean | SD卡插入状态 | 否 |
| flexem_usb_sta | boolean | U盘插入状态 | 否 |
| flexem_usb_down_line_sta | boolean | USB下载线连接状态 | 否 |
示例：
3.9 抓拍图片
功能为获取图片信息功能，该类权限的功能以同一个主题进行收发数据，所以需要定义接收数据格式和发送数据格式；本功能需要在manager添加对应驱动使用。
3.9.1 Sub 服务器请求Topic
| 服务器请求Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 绑定的图片抓怕驱动监控点，注：抓拍图片功能需要下发绑定驱动的点位名称，此时点位名称不需要填写变量值，直接填写null类型数据即可；例如：{“picture”:null} |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_message_id | Long/String | 客户自定义数值字段，返回时会原样返回改数值。可用于识别数据包。 | 否 |
| flexem_get_picture | boolean | 否 |
3. 9.2 Pub 客户端响应Topic
| 客户端响应Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 无 |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_message_id | Long/String | 客户自定义数值字段，返回时会原样返回改数值。可用于识别数据包。 | 否 |
| flexem_message_id | Long/String | 客户自定义数值字段，返回时会原样返回改数值。可用于识别数据包。 | 否 |
| flexem_error_code | Integer/string | 操作后返回的状态码 | 否 |
| flexem_message | string | 操作后返回状态的文字描述 | 否 |
| flexem_picture_base64 | string | 图片的信息，以base64格式发送 | 是 |
3.10 发布设备注册信息
该功能是盒子刚上线后会主动发送配置好的注册数据包，每10秒推送一次，知道服务器返回注册成功，则停止注册(有一个条件满足即可表示注册成功)，设备就开始运行之后配置的逻辑。
注：该功能是在1579固件版本及以上固件支持。
3.10.1 Sub 服务器请求Topic
Sub服务器请求Topic
| 服务器请求Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 无 |
关联属性点
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_uuid | Long/String | flexem_uuid 注册上报时的唯一ID，服务器需要原样返回，则代表注册成功。 | 是 |
| flexem_register_status | Long/String | 注册返回状态，如果服务器返回1代表注册成功，返回0代表注册失败。 | 是 |
Pub客户端响应Topic
| 客户端响应Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| 无 |
关联属性点：
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_uuid | Long/String | 上报唯一ID | 是 |
| flexem_message_id | Long/String | 客户自定义数值字段，返回时会原样返回改数值。可用于识别数据包。 | 否 |
| flexem_timestamp | Long | 时间戳 | 否 |
注：返回状态码和返回状态的文字描述，详细说明请见参数规范
示例：
3.11 发布报警监听数据
该功能为获取FBOX中报警时监听的数据信息；设置关联的报警点和监控数据的时间设置(最大前20秒~后20秒)。配置这个功能的前提 要把 \发布FBOX报警功能\** 配置好，两个功能是联合使用。
注意：1586 固件版本及以上版本支持该功能。
3.11.1 Pub客户端Topic
| 客户端Topic |
|---|
| 自定义 |
| 关联监控点 |
|---|
| （可勾选或全选）读写设置为“可读/读写”的监控点 |
关联属性点
| 内部参数 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| flexem_timestamp | Long/String | 时间戳 | 否 |
| flexem_message_id | Long/String | 消息ID，客户可自定义，原样返回 | 否 |
示例：
当关联的报警点触发报警时，就会推送配置好的点位时间前10秒后5秒的数据。
