博途系统变量-GET_NAME：读取IO设备或DP从站的名称

GET_NAME”指令用于读取 IO 设备或 DP 从站的名称。该名称将显示在网络视图和 IO 设备或 DP 从站的属性中。在以下截图中，以 IO 设备为例。通过 PROFINET IO 系统或 DP 主站的硬件标识符（LADDR 参数中）以及 IO 设备的设备编号或 DP 从站的 PROFIBUS 地址（STATION_NR 参数），可选择该 IO 设备或 DP 从站。指令成功执行后，IO 设备或 DP 从站的名称将写入由 DATA 参数寻址的区域中。所读取的名称取决于 IO 设备的类型：

• 对于 DP 从站或 IO 设备，将输出前端模块的名称。
• 对于智能从站或智能设备，将输出接口模块的名称。
• 对于 HMI 面板，将输出接口名称。
• 对于 PC 站，将输出接口模块的名称。
• 对于 GSD 设备，将显示设备接入点 (DAP) 的名称（接口或前端模块的名称）。

并通过参数 LEN 输出该名称的长度。如果该名称的长度大于 DATA 参数指定的区域，则将只写入寻址区域的最大长度的部分名称。该名称的最大长度为 128 个字符。

LADDR	Input	PROFINET IO 或 DP 主站系统的硬件标识符该值来自系统常量或 PROFINET IO 系统/ DP 主站系统的属性。
STATION_NR	Input	PROFINET IO 设备的设备编号或 DP 从站的 PROFIBUS 地址。该编号将显示在网络视图和 IO 设备或 DP 从站的属性中。
DATA	InOut	指向该名称待写入的目标区域的指针。
DONE	Output	指令执行成功。IO 设备或 DP 从站的名称已传送到 DATA 参数处指定的区域内。
BUSY	Output	状态参数 0：指令执行完成。 1：指令的执行尚未完成。
ERROR	Output	状态参数 0：无错误。 1：指令执行过程中发生错误。 详细信息将在 STATUS 参数中输出。
LEN	Output	IO 设备或 DP 从站的名称长度（字符数）。
STATUS	Output	状态参数该参数设置仅维持一次调用所持续的时间。因此，要显示该状态，需将 STATUS 复制到一个空闲数据区内。

示例

以下举例说明了如何读取 HMI 面板的站名称。

HMI 面板的组态：

创建以下变量，在全局数据块中进行数据存储：为指令“GET_NAME”分配参数：执行指令：        

• 在网络视图中创建站名称为“HMI_IO-Device”的 HMI 面板，并分配给相同 CPU 的 PROFINET IO 系统。
• 在硬件配置的属性中激活该 HMI 面板的操作模式“IO 设备”，并将 CPU 指定为 IO 控制器。
• 在“以太网地址”(Ethernet addresses) 下的属性内，设置设备编号“20”
  
  • 在输入参数 LADDR 中，输入 IO 系统（262）的硬件标识符。
  • 在输入参数 STATION_NR 中，输入 HMI 面板（2）的设备编号。
  • 互连“GET_NAME”指令的其它数，如下所示：
  • 执行该指令之后，HMI 面板 (HMI_IO-Device) 的站名称将保存到参数 DATA（“moduleName”）中。
  • 并在参数 LEN 中输出该名称的字符个数 (13)。
  • 成功读取 IO 设备后，如果 GET_NAME 的执行未停止，则输出参数BUSY（“busy”）将显示值“TRUE”；输出参数 STATUS（“status”）将显示值“16#7002”。

---

审核编辑 ：李倩