Moqbus物联网平台使用手册(V1.0)
admin
2023-09-08 05:41:54
0

一、用户注册

在浏览器中输入平台的地址,进入“用户登录”页面,在登录页面上点击“注册”链接:




登录页面中的“注册”入口

进入“用户注册”页面:




用户注册页面

用户名:请输入有效的email地址

密码:请设置登录密码

邮箱验证码:点击右侧“获取验证码”后,系统会发送验证码到上面输入的email地址。查看收件箱,在此填入验证码。

点击“注册”按钮,完成用户注册。

二、用户登录

完成用户注册后,在用户登录页面输入用户名和密码,登录进入系统:




登录后进入系统控制台页面

三、设备管理

3.1 添加设备

登录系统后,首先显示的是“设备管理”页面。

点击“设备管理”页面表头右侧的“+”号按钮,添加设备:




添加设备

输入设备名称后,点击“确定”按钮,保存新添加的设备。此时,在设备列表页面,可以看到刚刚添加的设备:




设备列表

设备列表中的“设备编号”是系统自动生成的,用于唯一标识系统中的设备。

3.2 修改设备

点击列表项目右侧的编辑图标,在弹出的下拉菜单中选择“修改设备“:




修改设备

在弹出的“修改设备”页面中,修改名称、备注等字段。设备编号一旦生成,是不能修改的。




修改设备

3.3 传感器管理

在上面的内容中,我们已经添加了一台设备。物联网云平台中的设备,指的是一个网络接入点,也可以称之为网关。在网关上需要连接各种传感器,来实现物联网的【物-物】连接的功能。

在设备列表中,点击“传感器”列的数字。这个数字表示当前该设备连接的传感器的数量。




添加传感器

编号:传感器的编号,整数。同一个网关设备下编号是唯一的

名称:传感器的名称。

备注:选填项目。

以上项目填写完成后,单击右边绿色的“”号,保存传感器。




传感器列表

传感器添加后,我们还可以给传感器添加预定义的下发指令。如“问询”指令,请求传感器上报温湿度值。

在传感器列表中,单击传感器名称,弹出指令列表页面:




指令列表

输入“编号”、“名称”和“指令脚本“。其中”编号“是整数值,在同一个传感器下是唯一的。”指令脚本“即下发给传感器的字节序列的16进制表示。

以上项目填写完成后,单击右边绿色的“”号,保存指令。

3.3 设置解码器

传感器上报的数据,通常是二进制的字节序列。我们必须按照事先定义好的协议规则,解析这些字节序列,生成可以被上层应用方便使用的格式,如json格式的数据。

点击列表项目右侧的编辑图标,在弹出的下拉菜单中选择“设置解码器“:




设置解码器菜单项

在解码器页面,可以设置解析函数、返回值模式和测试用例。




解码器函数

解码器函数的输入是从传感器上报的字节序列,输出是转换后的json字符串。




返回值模式

返回值模式用于定义解码器函数输出的json数据中各字段的定义。




测试用例

测试用例可以用来测试解析器是否符合预期结果。

上述解码器函数、返回值模式和测试用例都设置完成后,单击右侧工具栏中的保存图标按钮,保存解码器。

3.4 设置计划任务

有些传感器可以定时主动上报数据。也有一些传感器不会主动上报,而是在接收到相应的指令后才会上报数据。后者如果想要实现和前者一样的效果,就需要平台定时下发指令来触发传感器的数据上报。计划任务可以用来设置定时下发指令的时间间隔和指令内容。

点击列表项目右侧的编辑图标,在弹出的下拉菜单中选择“计划任务“:




计划任务菜单项

在弹出的计划任务页面中可以设置“指令Hex”、“任务名称”、“数据指纹“、”频率“和”延时“。




计划任务

指令Hex:定时下发的指令,16进制的字符串表示。

任务名称:设置一个名称,可以作为这个任务的说明。

数据指纹:用于识别此下发指令相关的上报数据。[[0,1]]表示二进制序列的第一个字节为0x01。

频率:定时的时间间隔,6表示60秒。

延时:如果有多个指令,可以通过延时设置来避免同一时刻同时发送多个指令而造成指令丢失。

四、实时控制

实时控制功能提供了与传感器交互的界面。点击左侧菜单中的“实时控制“,打开实时控制界面。




实时控制

“连接“按钮:首先点击连接按钮,与服务器建立一个连接。

选项“hex/json":如果直接在文本框中输入要下发的指令,则勾选此项。因为我们已经预定义了传感器的查询指令,所以可以不勾选此项。

“发送“按钮:将控制指令下发到传感器。




指令下发与数据上报

上图中可以看到,我们向传感器下发了指令:

01 03 00 00 00 02 C4 0B

并收到了传感器上报的数据:

01 03 04 01 DF 01 1C CA 6C

解码器将上报的数据转换成json格式

{"sno":1,"data":{"wd":28.4,"sd":47.9}}

五、历史数据

除了在实时控制页面中查看实时数据,我们还需要查看传感器的历史数据。

点击左侧主菜单的“历史数据“菜单项,打开历史数据页面:




历史数据列表

通过选择不同的“期间”或调整日期区间,可以查看传感器不同时间段的历史数据。

点击左上角工具栏的过程线图标,可以以图表形式展现历史数据:




过程线图标



历史数据折线图

六、状态监控

状态监控详细记录了网关设备的上下线事件和上下行通讯记录。

6.1 事件日志

点击左侧主菜单的“状态监控 > 事件日志“菜单项,打开事件日志页面:




事件日志列表-最新

如果要查看某台设备的详细日志,可以点击“设备编号”列,打开日志明细:




事件日志明细

6.2 通讯日志

设备与平台之间所有的通讯的原始数据都可以在这里查询到。

点击左侧主菜单的“状态监控 > 通讯日志“菜单项,打开通讯日志页面:




通讯日志

列表中的“direction”列,“UP”表示上行数据即“传感器->平台“的通讯,“DOWN“表示下行数据即”平台->传感器"的通讯。通过选择期间,这样我们就可以看到所有时间段的通讯记录,方便调试查看通讯问题。

七、调试工具(设备模拟器)

在物联网应用开发过程中,为了方便调试,可能需要使用软件来模拟一台设备与平台通讯。设备模拟器可以模拟设备发送上行数据,并接收平台发送的下行数据。

点击左侧主菜单的“调试工具 > 设备模拟器“菜单项,打开设备模拟器页面:




设备模拟器

设备编号:输入设备管理中设备的编号

通讯密码:输入设备的通讯密码

”连接“按钮:模拟设备连接到通讯服务器

连接后,在下发的列表中可以看到平台下发的指令,也可以通过上报数据文本框和发送按钮向平台模拟发送设备的上报数据。




设备模拟器发送和接收数据

八、开放接口

云平台提供了开放接口,以方便应用层与设备/传感器的交互。主要接口有:

接口名称接口标识功能方式下发指令realtime.device.sendcmd向传感器下发指令Post/Restful API获取最新数据uiconfig.device.data.get获取传感器的最新数据Post/Restful API获取历史数据history.data.query获取传感器的历史数据Post/Restful API

相关内容