
# OT数采配置
#### 配置数据源
数据源提供OT数据的设备和系统，如DCS、SCADA、PLC、数据库等。
#### 创建数采连接
1. 访问[IoT边缘](https://www.huaweicloud.com/product/iotedge.html)，单击"管理控制台"进入IoT边缘控制台。
2. 在左侧导航栏选择"边缘节点 \> 节点管理"，节点名称选择"test_IoT10"进入页面。
3. 在左侧导航栏选择"数采配置 \> 创建数采连接"。 
   图1创建数采连接   
   ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001531634069.png "点击放大")
   
   
4. 填写"数采连接参数"后单击"确认"保存，此时配置仅在云平台存在，未下发到边侧，数采连接的"同步状态"为"待同步"。 
   表1连接参数信息 
   | 参数名称  | 参数说明                                                                                                                                                |
   |:---|:---|
   | 通道标识  | opcua                                                                                                                                               |
   | 通道名称  | opcua通道（自定义）                                                                                                                                        |
   | 驱动模块  | sys_ot_dc_opcua                                                                                                                                     |
   | 服务端点： | opc.tcp://121.36.62.255:53530/OPCUA/SimulationServer                                                                                                |
   | 用 户 名 | 与准备数据源[步骤4](https://support.huaweicloud.com/bestpractice-iotedge/iotedge_bestpractice_0119.html#ZH-CN_TOPIC_0000001188330604__li19728452181111)保持一致 |
   | 密 码   | 与准备数据源[步骤4](https://support.huaweicloud.com/bestpractice-iotedge/iotedge_bestpractice_0119.html#ZH-CN_TOPIC_0000001188330604__li19728452181111)保持一致 |
   | 采集周期  | 1000毫秒                                                                                                                                              |
      
   ![](https://support.huaweicloud.com/bestpractice-iotedge/public_sys-resources/note_3.0-zh-cn.png)
   服务端点：填写OPC-UA服务端提供的连接地址，常见的OPC-UA Server有SCADA系统，Kepware等软件。在本实验[准备数据源](https://support.huaweicloud.com/bestpractice-iotedge/iotedge_bestpractice_0119.html)中使用Prosys OPC UA Simulation Server来模拟一个OPC-UA服务端，服务端点填写该模拟器的url。
   
   
 
#### 添加点位映射
将点位上报转换为设备属性上报，将设备属性读写转换为点位读写操作，将设备命令转化为点位写操作。
1. 访问[IoT边缘](https://www.huaweicloud.com/product/iotedge.html)，单击"管理控制台"进入IoT边缘控制台。
2. 在左侧导航栏选择"边缘节点 \> 节点管理"，节点名称选择"test_IoT10"进入页面。
3. 在左侧导航栏选择"数采配置 \> 选择对应的数采连接"。
4. 单击"添加点位"在"添加点位映射"弹窗中填写配置信息，如[表2]所示，然后单击"确认"。
   
   ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000002656363887.png "点击放大")
    表2添加点位映射 
   | 基本信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |||
   |:---|---|---|
   | 点位标识     | 点位的唯一标识。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          ||
   | 点位名称     | 按照规范填写。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           ||
   | 设备ID     | 边缘设备页签里添加设备的ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   ||
   | 点位数据类型   | 当前支持如下数据类型： int(整型) uint(无符号整型) int64(64 位整型) short(短整型) ushort(无符号短整型) long(长整型) ulong(无符号长整型) bool(布尔类型) float(单精度浮点型) double(双精度浮点型) decimal(小数) string(字符串) object(对象类型)  | 取值范围: -2147483648\~2147483647 0\~4294967295 -2147483648\~2147483647 -32768\~32767 0\~65535 -2147483648\~2147483647 0\~4294967295 0/1 -3.4\*10\^38\~+3.4\*10\^38 -1.7\*10\^-308\~1.7\*10\^308 -1.7\*10\^-308\~1.7\*10\^308 |
   | 设备属性     | 设备属性由物模型中service_id/property_name格式构成。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            ||
   | 启用状态     | 启用点位开关，默认开启。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      ||
   | **采集配置**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |||
   | 点位地址     | 填写OT设备及系统的实际点位地址"ns=3;i=1001和ns=3;i=1002"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        ||
   | 点位值的数据类型 | 当前支持如下数据类型： int(整型) uint(无符号整型) int64(64 位整型) short(短整型) ushort(无符号短整型) long(长整型) ulong(无符号长整型) bool(布尔类型) float(单精度浮点型) double(双精度浮点型) decimal(小数) string(字符串) object(对象类型) | 取值范围: -2147483648\~2147483647 0\~4294967295 -2147483648\~2147483647 -32768\~32767 0\~65535 -2147483648\~2147483647 0\~4294967295 0/1 -3.4\*10\^38\~+3.4\*10\^38 -1.7\*10\^-308\~1.7\*10\^308 -1.7\*10\^-308\~1.7\*10\^308     |
   | 点位采集周期   | 1000毫秒。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           ||
      
   ![](https://support.huaweicloud.com/bestpractice-iotedge/public_sys-resources/caution_3.0-zh-cn.png)
   1. 不同点位请勿配置同一设备的相同属性。
   2. 同一个设备请勿配置在多个数采连接下。
   
   
5. 单击"下发配置"，把点位配置下发至边缘侧，此时数采连接的"同步状态"为"已同步"。 
   ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001333777261.png "点击放大")
   
   
![](https://support.huaweicloud.com/bestpractice-iotedge/public_sys-resources/note_3.0-zh-cn.png)
1. 修改点位信息后需重新单击下发配置，配置才会生效。
2. 模块的运行状态由启用状态决定，当启用了数采连接后，模块会显示为运行中。
 
#### 添加数采模板
描述数采配置项的元数据，数采配置包括数据源配置元数据、点位采集配置元数据。
#### 系统数据源模板导入
数据源模板描述了数据源配置项的元数据，用户在配置数据源之前，需要先导入数据源模板。IoT边缘服务当前已经预置通用数据源模板，可以直接使用，系统也支持用户自定义导入模板。
1. 访问[IoT边缘](https://www.huaweicloud.com/product/iotedge.html)，单击"管理控制台"进入IoT边缘控制台。
2. 在左侧导航栏选择"边缘节点 \> 应用管理"进入页面，
3. 选择"驱动应用 \> 数采模板管理 \> 添加数采模板"。 
   ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001332762937.png "点击放大")
   
   
4. 添加文件，单击"确认"。 
   - 本地准备一份OT数采模板文件，文件内容合规。
   
   - IoT边缘云平台当前已经预置2个业界主流通用数采模板，可以通过导入通用模板后使用。
   
   - 支持用户自定义导入模板，导入模板后缀.json，满足json格式规范，样例及字段解释如下： 示例
     ```
     {
     "tpl_id": "sys_general_opcua",
     "name": "opcua通用数采模板",
     "description": "opcua通用数采模板",
     "datasource_meta": {
     "config_tabs": [{
     "key": "connection_info",
     "name": "连接信息",
     "description": "连接信息",
     "config_items": [{
     "key": "endpoint",
     "name": "服务端点",
     "description": "服务完整URL",
     "data_type": "string",
     "required": true,
     "crypted": false,
     "max_length": 128,
     "example": "opc.tcp://127.0.0.1:53530/OPCUA"
     }, {
     "key": "username",
     "name": "用户名",
     "description": "OPCUA服务器认证用户名",
     "data_type": "string",
     "required": false,
     "crypted": false,
     "max_length": 128,
     "example": "admin"
     }, {
     "key": "password",
     "name": "密码",
     "description": "OPCUA服务器认证密码",
     "data_type": "string",
     "required": false,
     "crypted": true,
     "max_length": 512,
     "example": "******"
     }]
     }, {
     "key": "collection_paras",
     "name": "连接附加参数",
     "description": "连接附加参数",
     "config_items": [{
     "key": "default_cycle",
     "name": "采集周期",
     "description": "采集周期",
     "data_type": "int",
     "required": true,
     "crypted": false,
     "max_length": 65535,
     "example": 10000
     }]
     }],
     "default_values": {
     "drivername": "OPCUA"
     }
     },
     "point_meta": {
     "config_items": [{
     "key": "address",
     "name": "点位地址",
     "description": "采集点位的地址",
     "data_type": "string",
     "required": true,
     "crypted": false,
     "max_length": 256,
     "example": "ns=2;s=Root/Motor/Voltage"
     }, {
     "key": "data_type",
     "name": "点位值的数据类型",
     "description": "点位地址存储值的数据类型",
     "data_type": "string",
     "required": true,
     "crypted": false,
     "max_length": 128,
     "example": "int，decimal"
     }, {
     "key": "cycle",
     "name": "点位采集周期",
     "description": "点位采集周期",
     "data_type": "int",
     "required": true,
     "crypted": false,
     "max_length": 65535,
     "example": 10000
     }]
     }
     }
     ```
     表3OT数采模板 
     | **key**                                                                  | **类型**                                                       | **描述**                                                                                                                                            |
     |:---|:---|:---|
     | tpl_id                                                                   | String                                                       | 数采模板标识，租户下唯一 pattern: '\^\[a-zA-Z0-9_-\]\*$' 1-64 |
     | name                                                                     | String                                                       | 数据源模板名称，支持中英文 1-64                                                                                |
     | description                                                              | String                                                       | 数据源模板描述，支持中英文，0-128                                                                                                                               |
     | datasource_meta point_meta | Object Object | 数据源配置元数据 点位采集配置元数据                                                                                  |
        
     表4datasource_meta 
     | **key**        | **类型** | **描述**                |
     |:---|:---|:---|
     | config_tabs    | Array  | 数据源配置表格列表             |
     | default_values | Object | 数据源默认的值，通常用于描述默认的驱动协议 |
        
     表5config_tabs 
     | **key**      | **类型** | **描述**                                                  |
     |:---|:---|:---|
     | key          | String | 数据源配置表格键值，pattern: ' connection_info\|collection_paras' |
     | name         | String | 数据源配置表格名称，1-64                                          |
     | description  | String | 描述，0-255                                                |
     | config_items | Array  | 配置项列表                                                   |
        
     表6config_items 
     | **key**     | **类型**  | **描述**                                                                                              |
     |:---|:---|:---|
     | key         | String  | 配置项key，1-32                                                                                         |
     | name        | String  | 默认项名称,1-64                                                                                          |
     | description | String  | 配置项描述，0-128                                                                                         |
     | data_type   | String  | 配置项类型，支持short\|ushort\|int\|int64\|uint\|long\|ulong\|float\|double\|bool\|string\|object\|decimal。 |
     | required    | Boolean | 配置项是否必传项                                                                                            |
     | crypted     | Boolean | 配置项是否加密                                                                                             |
     | max_length  | Integer | 当data_type= string时配置有效，校验输入的字符串最大长度                                                                |
     | example     | String  | 配置项举例，值在界面输入框作为示例灰色显示，0-256                                                                         |
        
     表7default_values 
     | **key**    | **类型** | **描述**              |
     |:---|:---|:---|
     | drivername | String | 用于描述默认的驱动协议，如OPCUA。 |
        
     
   
   
   ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001188282576.png "点击放大")
   
   
 
#### 附录：批量导入/导出点位映射
**批量导入点位映射**
1. 在左侧导航栏选择"边缘节点 \> 节点管理"，节点名称选择"test_IoT10"进入页面。
2. 在左侧导航栏选择"数采配置"-\>对应的连接通道。
3. 单击"导入点位"单击"下载模板文件"，打开"模板文件"内容填写。
   
   ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001281240708.png "点击放大")
   
   
4. 选择"添加文件"导入[步骤3]下载的文件后，单击"确认"完成批量导入点位映射。
   
   ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001281120856.png "点击放大")
   
   
**批量导出点位映射**
1. 在左侧导航栏选择"边缘节点 \> 节点管理"，节点名称选择"test_IoT10"进入页面。
2. 在左侧导航栏选择"应用模块 \> 数采配置 \> 对应的连接通道"。
3. 单击"导出点位"完成批量导出点位。 
   ![](https://support.huaweicloud.com/bestpractice-iotedge/figure/zh-cn_image_0000001244609359.png "点击放大")
   
   
 
