入门

欢迎查看此入门教程。在入门之前，请先准备好所需的硬件设备，比如OPCDA服务器，或者PLC设备。
登陆后进入欢迎界面后出现一些菜单：转发设置，操作，通道和设备列表。单击某个选项，即可进行相应的功能设置。

菜单	说明
概况	查看本软件所运行系统目前的状态，包括内存，CPU等信息；查看当前的点位配置和数据分发的情况。
数据分发	定义数据转发到算盘/虎符平台的地址，包括Websocket和MQTT两种方式。
系统	查看日志，设置时区
数据接入	可以在此新建通道和设备，在每一个设备中还可以添加点位
文档	查看此文档

用户通过浏览器中可视化的配置界面，结合工程现场的实际需求对功能进行配置。如定义对底层设备的通讯参数、采集数据点定义、云端发送地址等。

数据接入

数据接入服务是算盘Link基础的、重要的功能，通过数据采集服务可以获取连接的设备的数据。算盘Lin支持通过多种接口（RS232/RS485串口，以太网，CAN等）多种通讯协议与设备通讯。用电脑登陆网关配置页面成功后，就可以进行数据采集设置。具体步骤如下：
( 1 ) 建通道（定义连接到设备的一个通道，比如串口名称/代理地址) ( 2 ) 连设备（定义设备的参数，比如设备的IP地址和设备号）；
( 3 ) 配置要采集的数据项。
在进行本项配置前，请确保算盘Link与被监控设备的通讯线已经连接好。

建通道

点击下图中新建通道的按钮，即可新建通道。点击后，请在弹出的对话框中输入通道的名称，选择设备的类型，驱动，并选择对应的通讯参数，这里以虚拟PLC为例，如下图所示：通道建好后，左侧就会显示对应的通道：通道建立好之后，可以点击右边的X来删除此通道。如果通道下面有附属设备，需要删除通道的附属设备之后才能删除此通道。

连设备

通道建好之后，就可以选中通道，然后点击新建设备在这个通道上建立一个新的设备。这里先选中“虚拟PLC测试通道”，然后点击新建设备按钮。新建设备有一些选择和输入项目。目前页面上的是默认值，可以选择输入参数，然后点击确认即可新建好设备。
设备定义好之后，就可以点击右边的X来删除这个设备。

设置数据项

单击设备名称，在右边的点位列表里面即可进入定义数据的界面：

按钮	功能
新增	添加一个新的数据项
删除选中	选择列表中的点位，点击此按钮即可删除
刷新	刷新列表中的点位
导入点位表	导入一个Excel表格，包含点位信息
导出点位表	将当前的点位信息批量导出
转发字段定义	对于对转发的字段进行一些过滤操作

新增点位

点击新增按钮，即可弹出新增点位的窗口，进行点位的增加操作。新增的点位包括名称，别名，值运算，采集频率这些通用的参数。对于驱动的参数，请在对应驱动（opcda，modbus…)的文档中查看。
数据项属性说明（通用属性）：

数据项属性	说明
名称（必填）(唯一)	数据项的名称，如 “sensor1”、“temperature 1”等英文名称
描述(可选)	如 “阀门打开1”、“油温 1”等汉字
值运算(可选)	表示对当前数据项的值进行的线性操作，如 Y=aX+b
值运算参数(可选)	表示对当前数据项的值进行的线性操作的参数
采集频率（必填）	该数据项的采集频率
是否允许写入	表示此数据项是否是只读的，如果是只读的，那么
上报	表示此数据项是否会以HTTP/MQTT等方式发送到云平台
数据变化上报	表示此数据项是否发生变化才上报，可以用来节省流量

写入点位

点击写入点位，即提供一个值，让用户写入新的数据到这个点位中。

编辑点位

点击编辑按钮即可编辑这一行的点位。参数定义和新增点位相同。

删除选中

当用户添加了一些点位之后，可以选中这些点位，然后点击删除，删除之后立刻生效。在第一列还有一个全选的复选框，点击这个之后就可以全部选中或者全部不选，适用于批量操作的情况。

刷新

点击刷新按钮即可得到最新的点位情况。因为网页上的点位数据不会自动更新。

导出点位表

点击导出点位表按钮即可将目前的点位信息导出为excel格式。关于每一种驱动的excel表格式可以查看驱动相关的说明。

导入点位表

用户导出点位表之后就可以在点位表上做一些修改，增加或者删除自己的点位，并且导入。导入之后可以看到立马生效。如果某一行表格里面有于目前的数据项重复的数据项ID，则这一行的数据不会被导入。在导入之前需要子仔细检查，避免导入错误的点位表。

转发字段定义

点击转发字段定义，可以自定义发送到云平台的字段数量和字段的名称，打勾的即为需要转发的，另外在右边输入框填入的就是需要修改的转发名称。

数据分发

可以设置将数据转发到云平台或者本地的网络服务器，这里支持Websocket/MQTT/HTTP协议。数据分发时，每一个项目可以设置缓存数量，当网络和云平台断开的时候，可以将数据缓存到本地，当网络重连连上之后，再将数据上传。

Websocket

需要用户填入IP地址/端口和子URL，一般子URL是“/”。

MQTT

需要填入MQTT的一些参数。

HTTP

数据加密

云平台和本地共享一个AES密码，用来保护数据。

Bad点位

此项用于当某个点位读取失败时，结果是（Bad），这个点位是否需要进行分发。

系统设置

时区

设置当前的时区。如果查看点位表显示的时钟不正确，则需要修改一下时区。

日志

点击查看当前的运行日志，日志包括操作记录和设备重连等信息。

组件之间交互

组件输出

点位上报

主要格式是device_name,timestamp为主要值
values是上报的点位数组，数组内部的点位数量和点位名称可变，在网页上设置。对于组件输出格式，每一种驱动可能不一样。
{
"type" : "report",
"device_name":"device_lqILlz3TMi",
"channel" : "channel_abcdd",
"timestamp":"2020-11-05 07:36:17",
"driver":"s7",
"values":[
    {
      "id":"1",
      "name":"",
      "alias":"",
      "freq":"1000",
      "compute":"no;",
      "value":"0",
      "quality":"Good",
      "address":"D1560",
      "type":"SHORT",
      "length":""
    },{
      "id":"4",
      "name":"",
      "alias":"",
      "freq":"1000",
      "compute":"no;",
      "value":"0",
      "quality":"Good",
      "address":"D1560",
      "type":"SHORT",
      "length":""
    },
    {
      "id":"5",
      "name":"",
      "alias":"",
      "freq":"1000",
      "compute":"no;",
      "value":"0",
      "quality":"Good",
      "address":"D1560",
      "type":"SHORT",
      "length":""
    }
]
}

状态输出

对于写入成功或者失败，输出状态。
{
"type" : "status",
    "cmd": "/write/add",
    "status": "success",   //成功是success，失败是fail
    "appid": "3",
    "device_name": "device_lqILlz3TMi"
}
{
"type" : "status",
    "cmd": "unknown",
    "status": "failed",   //成功是success，失败是fail
    "message": "device_name not exists"
}

组件输入

组件输入可以用数组的方式来写入多个命令，比如
[{
    "cmd": "/write/add",
    "appid": "1",
    "value": "8",
    "device_name": "mc"
},{
    "cmd": "/write/add",
    "appid": "2",
    "value": "9",
    "device_name": "mc"
}]

写入值

写入的时候，cmd需要写“write”，并且需要给出device_name和数据项的id
{
    "cmd": "/write/add",
    "appid": "3",
    "value": "1",
    "device_name": "device_lqILlz3TMi"
}

添加点位

分为基本参数和驱动相关参数，基本参数时不变的，驱动参数需要和驱动的属性对应。
{
    "cmd": "/watch/add",
    "basic": {
        "name": "name1",
        "alias": "别名1",
        "freq": "1000",
        "compute": "no;"
    },
    "driver": {
        "address": "D1560",
        "length": "",
        "type": "SHORT"
    },
    "device_name": "device_lqILlz3TMi"
}

删除点位

删除的时候需要传一个appid数组。这个id就是设备数据上报时的id。可以批量删除一些点位。
{
    "cmd": "/watch/delete",
    "appid": ["1", "2"],
    "device_name": "device_lqILlz3TMi"
}

入门​

数据接入​

建通道​

连设备​

设置数据项​

新增点位​

写入点位​

编辑点位​

删除选中​

刷新​

导出点位表​

导入点位表​

转发字段定义​

数据分发​

Websocket​

MQTT​

HTTP​

数据加密​

Bad点位​

系统设置​

时区​

日志​

组件之间交互​

组件输出​

点位上报​

状态输出​

组件输入​

写入值​

添加点位​

删除点位​

入门