Merge pull request #433 from hxy7yx/main-2

plugin(hostlink-cmode): update tag address format
emqx · Jan 31, 2024 · 0ae210d · 0ae210d
2 parents 4387501 + 82c407f
commit 0ae210d
Show file tree

Hide file tree

Showing 2 changed files with 45 additions and 43 deletions.
diff --git a/en_US/configuration/south-devices/hostlink/hostlink-cmode.md b/en_US/configuration/south-devices/hostlink/hostlink-cmode.md
@@ -52,7 +52,11 @@ For information on general configuration items, see [Connect to Southbound Devic
 
 ### Address format
 
-> AREA ADDRESS.ID\[.BIT]\[.LEN\[H]\[L]]
+> ID!AREA ADDRESS\[.BIT]\[.LEN\[H]\[L]]
+
+#### ID
+
+Required, unit ID. For example, unit id is 10, area is CIO, address is 0, then fill in 10!CIO0000
 
 #### AREA ADDRESS
 
@@ -66,10 +70,6 @@ For information on general configuration items, see [Connect to Southbound Devic
 | TD   | uint16/int16/uint32/int32/uint64/int64/FLOAT/DOUBLE/STRING  | read/write    | TC value       |
 | TS   | BOOL                                                        | read/write    | TC status      |
 
-#### .ID
-
-Required, unit ID. For example, unit id is 10, area is CIO, address is 0, then fill in CIO0000.10
-
 #### .LEN\[H]\[L]\[D]\[E]
 
 When the data type is STRING, .LEN is a required field, indicating the number of bytes the string occupies. Each register contains four storage methods: H, L, D, and E, as shown in the table below.
@@ -84,22 +84,22 @@ When the data type is STRING, .LEN is a required field, indicating the number of
 
 | Address         | Data Type | Description |
 | ----------- | ------- | --------- |
-| CIO0001.10        | int16   | CIO Area, address is 1, unit id is 10      |
-| CIO0002.10        | uint16  | CIO Area, address is 2, unit id is 10      |
-| LR0020.10         | double  | LR Area, address is 20, unit id is 10      |
-| LR0030.10         | uint32  | LR Area, address is 30, unit id is 10      |
-| HR0010.10         | int32   | HR Area, address is 10, unit id is 10      |
-| HR0020.10         | float   | HR Area, address is 20, unit id is 10      |
-| D0010.10          | int32   | DM Area, address is 10, unit id is 10      |
-| D0020.10          | float   | DM Area, address is 20, unit id is 10      |
-| A0002.10          | int32   | AR Area, address is 2, unit id is 10       |
-| A0004.10          | uint32  | AR Area, address is 4, unit id is 10       |
-| TD0002.10         | uint16  | TC value, address is 2, unit id is 10      |
-| TD0004.10         | uint32  | TC value, address is 4, unit id is 10      |
-| TS0002.10         | BOOL    | TC status, address is 2, unit id is 10     |
-| TS0004.10         | BOOL    | TC status, address is 4, unit id is 10     |
-| CIO0000.20.20      | string   | CIO Area, address is 0, unit id is 10, the string length is 20 bytes, and the endianness is L      |
-| CIO0001.20H        | string   | CIO Area, address is 1, unit id is 10, the string length is 20 bytes, and the endianness is H      |
+| 10!CIO0001        | int16   | CIO Area, address is 1, unit id is 10      |
+| 10!CIO0002        | uint16  | CIO Area, address is 2, unit id is 10      |
+| 10!LR0020         | double  | LR Area, address is 20, unit id is 10      |
+| 10!LR0030         | uint32  | LR Area, address is 30, unit id is 10      |
+| 10!HR0010         | int32   | HR Area, address is 10, unit id is 10      |
+| 10!HR0020         | float   | HR Area, address is 20, unit id is 10      |
+| 10!D0010          | int32   | DM Area, address is 10, unit id is 10      |
+| 10!D0020          | float   | DM Area, address is 20, unit id is 10      |
+| 10!A0002          | int32   | AR Area, address is 2, unit id is 10       |
+| 10!A0004          | uint32  | AR Area, address is 4, unit id is 10       |
+| 10!TD0002         | uint16  | TC value, address is 2, unit id is 10      |
+| 10!TD0004         | uint32  | TC value, address is 4, unit id is 10      |
+| 10!TS0002         | BOOL    | TC status, address is 2, unit id is 10     |
+| 10!TS0004         | BOOL    | TC status, address is 4, unit id is 10     |
+| 10!CIO0000.20L    | string  | CIO Area, address is 0, unit id is 10, the string length is 20 bytes, and the endianness is L      |
+| 10!CIO0001.20H    | string  | CIO Area, address is 1, unit id is 10, the string length is 20 bytes, and the endianness is H      |
 
 ## Data Monitoring
 

diff --git a/zh_CN/configuration/south-devices/hostlink/hostlink-cmode.md b/zh_CN/configuration/south-devices/hostlink/hostlink-cmode.md
@@ -47,7 +47,11 @@ Neuron HostLink Cmode 插件用于通过串口网络与欧姆龙 PLC 进行通
 
 ### 地址格式
 
-> AREA ADDRESS.ID\[.BIT]\[.LEN\[H]\[L]]
+> ID!AREA ADDRESS\[.BIT]\[.LEN\[H]\[L]]
+
+#### ID
+
+必填，单元号。例如单元号为 10，区域为 CIO，地址为 0 则填 10!CIO0000
 
 #### AREA ADDRESS
 
@@ -61,34 +65,32 @@ Neuron HostLink Cmode 插件用于通过串口网络与欧姆龙 PLC 进行通
 | TD   | uint16/int16/uint32/int32/uint64/int64/FLOAT/DOUBLE/STRING  | 读/写    | TC 值        |
 | TS   | BOOL                                                        | 读/写    | TC 状态      |
 
-#### .ID
-
-必填，单元号。例如单元号为 10，区域为 CIO，地址为 0 则填 CIO0000.10
-
 #### .LEN\[H]\[L]
 
-当数据类型是 string 类型时，是必填项，**.LEN** 表示字符串长度，包含 **H** 和 **L** 两种字节顺序，不填默认是 **H** 字节顺序。
+当数据类型是 string 类型时，是必填项。
+**.LEN** 表示存储区域大小，其最大值为 29，该区域的单位为 PLC 中的双字节存储单元。
+string 类型包含 **H** 和 **L** 两种字节顺序，不填默认是 **H** 字节顺序。
 
 ### 地址示例
 
 | 地址       | 数据类型  | 说明 |
 | --------- | -------- | -------- |
-| CIO0001.10        | int16   | CIO 区域，地址为 1，单元号为 10      |
-| CIO0002.10        | uint16  | CIO 区域，地址为 2，单元号为 10      |
-| LR0020.10         | double  | LR 区域，地址为 20，单元号为 10      |
-| LR0030.10         | uint32  | LR 区域，地址为 30，单元号为 10      |
-| HR0010.10         | int32   | HR 区域，地址为 10，单元号为 10      |
-| HR0020.10         | float   | HR 区域，地址为 20，单元号为 10      |
-| D0010.10          | int32   | DM 区域，地址为 10，单元号为 10      |
-| D0020.10          | float   | DM 区域，地址为 20，单元号为 10      |
-| A0002.10          | int32   | AR 区域，地址为 2，单元号为 10       |
-| A0004.10          | uint32  | AR 区域，地址为 4，单元号为 10       |
-| TD0002.10         | uint16  | TC 值，地址为 2，单元号为 10         |
-| TD0004.10         | uint32  | TC 值，地址为 4，单元号为 10         |
-| TS0002.10         | BOOL    | TC 状态，地址为 2，单元号为 10       |
-| TS0004.10         | BOOL    | TC 状态，地址为 4，单元号为 10       |
-| CIO0000.20.20      | string   | CIO 区域，地址为 0，单元号为 10，字符串长度 20 个字节，字节顺序为 L      |
-| CIO0001.20H        | string   | CIO 区域，地址为 1，单元号为 10，字符串长度 20 个字节，字节顺序为 H      |
+| 10!CIO0001        | int16   | CIO 区域，地址为 1，单元号为 10      |
+| 10!CIO0002        | uint16  | CIO 区域，地址为 2，单元号为 10      |
+| 10!LR0020         | double  | LR 区域，地址为 20，单元号为 10      |
+| 10!LR0030         | uint32  | LR 区域，地址为 30，单元号为 10      |
+| 10!HR0010         | int32   | HR 区域，地址为 10，单元号为 10      |
+| 10!HR0020         | float   | HR 区域，地址为 20，单元号为 10      |
+| 10!D0010          | int32   | DM 区域，地址为 10，单元号为 10      |
+| 10!D0020          | float   | DM 区域，地址为 20，单元号为 10      |
+| 10!A0002          | int32   | AR 区域，地址为 2，单元号为 10       |
+| 10!A0004          | uint32  | AR 区域，地址为 4，单元号为 10       |
+| 10!TD0002         | uint16  | TC 值，地址为 2，单元号为 10         |
+| 10!TD0004         | uint32  | TC 值，地址为 4，单元号为 10         |
+| 10!TS0002         | BOOL    | TC 状态，地址为 2，单元号为 10       |
+| 10!TS0004         | BOOL    | TC 状态，地址为 4，单元号为 10       |
+| 10!CIO0000.20L    | string  | CIO 区域，地址为 0，单元号为 10，字符串长度 20 个字节，字节顺序为 L      |
+| 10!CIO0001.20H    | string  | CIO 区域，地址为 1，单元号为 10，字符串长度 20 个字节，字节顺序为 H      |
 
 ## 数据监控