Skip to content

Commit ae525e9

Browse files
QQDQQQDQ
authored
Merge pull request #529 from ZhouBox/master
support array type
2 parents 7f0d4c5 + c7ce720 commit ae525e9

File tree

6 files changed

+161
-101
lines changed

6 files changed

+161
-101
lines changed

‎en_US/configuration/south-devices/fanuc-focas/fanuc-focas.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -111,6 +111,7 @@ The address can support up to 3 parameters, with the `@` symbol specifying the c
111111
The number of axes starts from 1 and increases according to the actual number of axes.
112112
To use the tool life management function, the corresponding parameters on the device must be enabled.
113113
If the parameter address does not set `@p`, it defaults to path 1.
114+
:::
114115

115116

116117
*CNC address example*

‎en_US/configuration/south-devices/opc-ua/overview.md‎

Lines changed: 56 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,13 @@ Go to **Configuration -> South Devices**, then click **Add Device** to add the d
1515

1616
After clicking **Create**, you will be redirected to the **Device Configuration** page, where we will set up the parameters required for Neuron to establish a connection with the device. You can also click the device configuration icon on the southbound device card to enter the **Device Configuration** interface.
1717

18-
| Parameter | Description |
19-
| ----------------- | --------------------------- |
20-
| **Endpoint URL** | Target OPC UA Server URL, the default value is `opc.tcp://127.0.0.1:4840/` |
21-
| **Username** | User name used to connect to the target OPC UA Server |
22-
| **Password** | Password for connecting to the target OPC UA Server |
23-
| **Cert** | Client certificate in DER format |
24-
| **Key** | The client key in DER format |
18+
| Parameter | Description |
19+
| ---------------- | -------------------------------------------------------------------------- |
20+
| **Endpoint URL** | Target OPC UA Server URL, the default value is `opc.tcp://127.0.0.1:4840/` |
21+
| **Username** | User name used to connect to the target OPC UA Server |
22+
| **Password** | Password for connecting to the target OPC UA Server |
23+
| **Cert** | Client certificate in DER format |
24+
| **Key** | The client key in DER format |
2525

2626
## Configure Data Groups and Tags
2727

@@ -56,25 +56,50 @@ You can use UaExpert to view the **Namespace Index** ( `NamespaceIndex`) and is
5656
* DOUBLE
5757
* BOOL
5858
* STRING
59+
* ARRAY_CHAR
60+
* ARRAY_INT8
61+
* ARRAY_UINT8
62+
* ARRAY_INT16
63+
* ARRAY_UINT16
64+
* ARRAY_INT32
65+
* ARRAY_UINT32
66+
* ARRAY_INT64
67+
* ARRAY_UINT64
68+
* ARRAY_FLOAT
69+
* ARRAY_DOUBLE
70+
* ARRAY_BOOL
5971

6072
### Data Type Conversion
6173

62-
| OPC UA Data Type | Neuron Data Type |
63-
| --------------- | --------------- |
64-
| SByte | INT8 |
65-
| Int16 | INT16 |
66-
| Int32 | INT32 |
67-
| Int64 | INT64 |
68-
| Byte | UINT8 |
69-
| UInt16 | UINT16 |
70-
| UInt32 | UINT32 |
71-
| UInt64 | UINT64 |
72-
| Float | FLOAT |
73-
| Double | DOUBLE |
74-
| Boolean | BOOL |
75-
| String | STRING |
76-
| Datetime | UINT32 |
77-
| LocalizedText(Read Only) | STRING |
74+
| OPC UA Data Type | Neuron Data Type |
75+
| ------------------------ | ----------------------- |
76+
| SByte | INT8 |
77+
| Int16 | INT16 |
78+
| Int32 | INT32 |
79+
| Int64 | INT64 |
80+
| Byte | UINT8 |
81+
| UInt16 | UINT16 |
82+
| UInt32 | UINT32 |
83+
| UInt64 | UINT64 |
84+
| Float | FLOAT |
85+
| Double | DOUBLE |
86+
| Boolean | BOOL |
87+
| String | STRING |
88+
| Datetime | UINT32 |
89+
| LocalizedText(Read Only) | STRING |
90+
| SByte Array | ARRAY_INT8 |
91+
| Int16 Array | ARRAY_INT16 |
92+
| Int32 Array | ARRAY_INT32 |
93+
| Int64 Array | ARRAY_INT64 |
94+
| Byte Array | ARRAY_UINT8, ARRAY_CHAR |
95+
| UInt16 Array | ARRAY_UINT16 |
96+
| UInt32 Array | ARRAY_UINT32 |
97+
| UInt64 Array | ARRAY_UINT64 |
98+
| Float Array | ARRAY_FLOAT |
99+
| Double Array | ARRAY_DOUBLE |
100+
| Boolean Array | ARRAY_BOOL |
101+
102+
ARRAY_CHAR displays and writes in the form of a string.
78103

79104
### Address Format
80105

@@ -88,14 +113,14 @@ You can use UaExpert to view the **Namespace Index** ( `NamespaceIndex`) and is
88113

89114
### Example Addresses
90115

91-
| Address | Data type | Description |
92-
| ---------------------- | -------- | ------------------------------------------------------------ |
93-
| 0!2258 | UINT32 | Get the timestamp of the OPC UA server using the digital NODEID. The NS value is 0, and the NODEID is 2258 |
94-
| 2!Device1.Module1.Tag1 | INT8 | Use the string NODEID to get the data point of type SBYTE. If NS is 2, NODEID is Device1.Module1.Tag1 |
95-
| 0!c496578a-0dfe-4b8f-870a-745238c6ae00 | BOOL | Get a data point of type BOOL using a NODEID of type GUID; NS is 0 and NODEID is c496578a-0dfe-4b8f-870a-745238c6ae00 |
96-
| 1[2]!array1d[string] | STRING | Accesses the 3rd element of the STRING array; NS is 1, NODEID is array1d[string], one-dimensional index is 2 |
97-
| 1[2,3]!array2d[int] | INT32 | Access the elements of row 3 and column 4 of the INT32 array; NS is 1, NODEID is array2d[int], one-dimensional index is 2, and two-dimensional index is 3. |
98-
| 1[2,3,4]!array3d[float] | FLOAT | Accesses row 3, column 4, and element 5 of the FLOAT array; NS is 1, NODEID is array3d[float], one-dimensional index is 2, two-dimensional index is 3, three-dimensional index is 4 |
116+
| Address | Data type | Description |
117+
| -------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
118+
| 0!2258 | UINT32 | Get the timestamp of the OPC UA server using the digital NODEID. The NS value is 0, and the NODEID is 2258 |
119+
| 2!Device1.Module1.Tag1 | INT8 | Use the string NODEID to get the data point of type SBYTE. If NS is 2, NODEID is Device1.Module1.Tag1 |
120+
| 0!c496578a-0dfe-4b8f-870a-745238c6ae00 | BOOL | Get a data point of type BOOL using a NODEID of type GUID; NS is 0 and NODEID is c496578a-0dfe-4b8f-870a-745238c6ae00 |
121+
| 1[2]!array1d[string] | STRING | Accesses the 3rd element of the STRING array; NS is 1, NODEID is array1d[string], one-dimensional index is 2 |
122+
| 1[2,3]!array2d[int] | INT32 | Access the elements of row 3 and column 4 of the INT32 array; NS is 1, NODEID is array2d[int], one-dimensional index is 2, and two-dimensional index is 3. |
123+
| 1[2,3,4]!array3d[float] | FLOAT | Accesses row 3, column 4, and element 5 of the FLOAT array; NS is 1, NODEID is array3d[float], one-dimensional index is 2, two-dimensional index is 3, three-dimensional index is 4 |
99124

100125
## Use Case
101126

‎en_US/configuration/south-devices/siemens-s7/s7.md‎

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,7 @@ For information on general configuration items, see [Connect to Southbound Devic
6767
* DOUBLE
6868
* BIT
6969
* STRING
70+
* ARRAY_CHAR
7071

7172
### Address Format
7273

@@ -114,21 +115,24 @@ Optional, referring to a bit of an address, range 0 - 7.
114115

115116
#### .LEN
116117

117-
When the data type is a string type, it is required and indicates the length of the string.
118+
When the data type is a string or char array type, it is required and indicates the length of the string.
118119

119120
### Example Addresses
120121

121-
| Address | Data Type | Description |
122-
| ------------ | --------- | ----------------------------------------------------------------------- |
123-
| I0.0 | bit | I area, address 0, bit 0 |
124-
| I0.1 | bit | I area, address 0, bit 1 |
125-
| O1.0 | bit | O area, address 1, bit 0 |
126-
| O1.2 | bit | O area, address 1, bit 2 |
127-
| F2.1 | bit | F area, address 2, bit 1 |
128-
| F2.2 | bit | F area, address 2, bit 2 |
129-
| DB1.DBW10.0 | bit | In a data block of 1, the starting data word is 10, bit 0 |
130-
| DB2.DBW1.7 | bit | In a data block of 2, the starting data word is 1, bit 7 |
131-
| DB1.DBW12.20 | string | In a data block of 1, the starting data word is 12, string length is 20 |
122+
| Address | Data Type | Description |
123+
| ------------- | ---------- | ---------------------------------------------------------------------------- |
124+
| I0.0 | bit | I area, address 0, bit 0 |
125+
| I0.1 | bit | I area, address 0, bit 1 |
126+
| O1.0 | bit | O area, address 1, bit 0 |
127+
| O1.2 | bit | O area, address 1, bit 2 |
128+
| F2.1 | bit | F area, address 2, bit 1 |
129+
| F2.2 | bit | F area, address 2, bit 2 |
130+
| DB1.DBW10.0 | bit | In a data block of 1, the starting data word is 10, bit 0 |
131+
| DB2.DBW1.7 | bit | In a data block of 2, the starting data word is 1, bit 7 |
132+
| DB1.DBW12.20 | string | In a data block of 1, the starting data word is 12, string length is 20 |
133+
| DB1.DBW100.20 | ARRAY_CHAR | In a data block of 1, the starting data word is 100, char array length is 20 |
134+
135+
ARRAY_CHAR displays and writes in the form of a string.
132136

133137
## Use Case
134138

‎zh_CN/configuration/south-devices/fanuc-focas/fanuc-focas.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,7 @@ address 最多可以支持3个参数，@ 指定 address 所在通道。
113113
轴数从1开始，根据实际轴数递增。
114114
使用刀具寿命管理功能，需要开启设备相应的参数。
115115
参数地址不设置 @p，默认为通道1。
116+
:::
116117

117118
*CNC 地址示例*
118119

‎zh_CN/configuration/south-devices/opc-ua/overview.md‎

Lines changed: 56 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -18,13 +18,13 @@ OPC UA 服务端目前支持匿名方式、用户名/密码方式、证书/密
1818

1919
点击插件卡片或插件列，进入**设备配置**页。配置 Neuron 与设备建立连接所需的参数，下表为 OPC UA 相关配置项。
2020

21-
| 参数 | 说明 |
22-
| ----------------- | --------------------------- |
23-
| **端点 URL** | 目标 OPC UA Server 的 URL，默认值是 `opc.tcp://127.0.0.1:4840/` |
24-
| **用户名** | 连接目标 OPC UA Server 使用的用户名 |
25-
| **密码** | 连接目标 OPC UA Server 使用的密码 |
26-
| **证书** | DER 格式的客户端证书 |
27-
| **密钥** | DER 格式的客户端密钥 |
21+
| 参数 | 说明 |
22+
| ------------ | --------------------------------------------------------------- |
23+
| **端点 URL** | 目标 OPC UA Server 的 URL，默认值是 `opc.tcp://127.0.0.1:4840/` |
24+
| **用户名** | 连接目标 OPC UA Server 使用的用户名 |
25+
| **密码** | 连接目标 OPC UA Server 使用的密码 |
26+
| **证书** | DER 格式的客户端证书 |
27+
| **密钥** | DER 格式的客户端密钥 |
2828

2929
## 设置组和点位
3030

@@ -58,25 +58,50 @@ OPC UA 服务端目前支持匿名方式、用户名/密码方式、证书/密
5858
* DOUBLE
5959
* BOOL
6060
* STRING
61+
* ARRAY_CHAR
62+
* ARRAY_INT8
63+
* ARRAY_UINT8
64+
* ARRAY_INT16
65+
* ARRAY_UINT16
66+
* ARRAY_INT32
67+
* ARRAY_UINT32
68+
* ARRAY_INT64
69+
* ARRAY_UINT64
70+
* ARRAY_FLOAT
71+
* ARRAY_DOUBLE
72+
* ARRAY_BOOL
6173

6274
#### 数据类型转换
6375

64-
| OPC UA 数据类型 | Neuron 数据类型 |
65-
| --------------- | --------------- |
66-
| SByte | INT8 |
67-
| Int16 | INT16 |
68-
| Int32 | INT32 |
69-
| Int64 | INT64 |
70-
| Byte | UINT8 |
71-
| UInt16 | UINT16 |
72-
| UInt32 | UINT32 |
73-
| UInt64 | UINT64 |
74-
| Float | FLOAT |
75-
| Double | DOUBLE |
76-
| Boolean | BOOL |
77-
| String | STRING |
78-
| Datetime | UINT32 |
79-
| LocalizedText（只读） | STRING |
76+
| OPC UA 数据类型 | Neuron 数据类型 |
77+
| --------------------- | ----------------------- |
78+
| SByte | INT8 |
79+
| Int16 | INT16 |
80+
| Int32 | INT32 |
81+
| Int64 | INT64 |
82+
| Byte | UINT8 |
83+
| UInt16 | UINT16 |
84+
| UInt32 | UINT32 |
85+
| UInt64 | UINT64 |
86+
| Float | FLOAT |
87+
| Double | DOUBLE |
88+
| Boolean | BOOL |
89+
| String | STRING |
90+
| Datetime | UINT32 |
91+
| LocalizedText（只读） | STRING |
92+
| SByte Array | ARRAY_INT8 |
93+
| Int16 Array | ARRAY_INT16 |
94+
| Int32 Array | ARRAY_INT32 |
95+
| Int64 Array | ARRAY_INT64 |
96+
| Byte Array | ARRAY_UINT8, ARRAY_CHAR |
97+
| UInt16 Array | ARRAY_UINT16 |
98+
| UInt32 Array | ARRAY_UINT32 |
99+
| UInt64 Array | ARRAY_UINT64 |
100+
| Float Array | ARRAY_FLOAT |
101+
| Double Array | ARRAY_DOUBLE |
102+
| Boolean Array | ARRAY_BOOL |
103+
104+
ARRAY_CHAR 展示和写入形式为字符串。
80105

81106
### 地址格式
82107

@@ -90,14 +115,14 @@ OPC UA 服务端目前支持匿名方式、用户名/密码方式、证书/密
90115

91116
### 地址示例
92117

93-
| 地址 | 数据类型 | 说明 |
94-
| ---------------------- | -------- | ------------------------------------------------------------ |
95-
| 0!2258 | UINT32 | 使用数字类型的 NODEID，获取 OPC UA 服务器的时间戳；NS 为0，NODEID 为2258 |
96-
| 2!Device1.Module1.Tag1 | INT8 | 使用字符串类型的 NODEID，获取类型为 SBYTE 的数据点；NS 为2，NODEID 为 Device1.Module1.Tag1 |
97-
| 0!c496578a-0dfe-4b8f-870a-745238c6ae00 | BOOL | 使用 GUID 类型的 NODEID，获取类型为 BOOL 的数据点；NS 为0，NODEID 为c496578a-0dfe-4b8f-870a-745238c6ae00 |
98-
| 1[2]!array1d[string] | STRING | 访问 STRING 数组的第 3 个元素；NS 为1，NODEID 为 array1d[string], 一维索引为 2 |
99-
| 1[2,3]!array2d[int] | INT32 | 访问 INT32 数组的第 3 行，第 4 列的元素；NS 为1，NODEID 为 array2d[int], 一维索引为 2，二维索引为 3 |
100-
| 1[2,3,4]!array3d[float] | FLOAT | 访问 FLOAT 数组的第 3 行，第 4 列，第 5 个元素；NS 为1，NODEID 为 array3d[float], 一维索引为 2，二维索引为 3，三维索引为 4 |
118+
| 地址 | 数据类型 | 说明 |
119+
| -------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------- |
120+
| 0!2258 | UINT32 | 使用数字类型的 NODEID，获取 OPC UA 服务器的时间戳；NS 为0，NODEID 为2258 |
121+
| 2!Device1.Module1.Tag1 | INT8 | 使用字符串类型的 NODEID，获取类型为 SBYTE 的数据点；NS 为2，NODEID 为 Device1.Module1.Tag1 |
122+
| 0!c496578a-0dfe-4b8f-870a-745238c6ae00 | BOOL | 使用 GUID 类型的 NODEID，获取类型为 BOOL 的数据点；NS 为0，NODEID 为c496578a-0dfe-4b8f-870a-745238c6ae00 |
123+
| 1[2]!array1d[string] | STRING | 访问 STRING 数组的第 3 个元素；NS 为1，NODEID 为 array1d[string], 一维索引为 2 |
124+
| 1[2,3]!array2d[int] | INT32 | 访问 INT32 数组的第 3 行，第 4 列的元素；NS 为1，NODEID 为 array2d[int], 一维索引为 2，二维索引为 3 |
125+
| 1[2,3,4]!array3d[float] | FLOAT | 访问 FLOAT 数组的第 3 行，第 4 列，第 5 个元素；NS 为1，NODEID 为 array3d[float], 一维索引为 2，二维索引为 3，三维索引为 4 |
101126

102127
## 应用场景
103128
本节还提供以下应用场景示例，方便您快速上手：

0 commit comments

Comments
 (0)