L2L Connect for Ignition 快速入门指南

Last updated: June 19, 2026

L2L 连接用于 Ignition 是一个网关模块，提供 Ignition Python 脚本功能，支持许多标准的 CloudDISPATCH API。L2L 连接为您的所有 Ignition 项目标准化了 L2L 连接。它提供集中式凭据管理和增强的日志记录功能。这是实现企业标准化 L2L CloudDISPATCH 集成的最佳解决方案。

要下载 L2L 连接用于 Ignition，请点击这里。

L2L 连接用于 Ignition 详情：

  • 支持 Ignition 8.1+（虽然早期版本未经过测试，但可能可以工作。）
  • 以 .modl 文件形式提供，通过网关模块配置界面上传。
  • 通过 system.L2L 命名空间，提供易于使用的脚本功能，支持常见的 L2L / Ignition API 用例。
    • 获取 L2L 站点、区域、生产线、机器
    • 在 L2L 中设置/递增机器周期计数
    • 在 L2L 中记录生产实际值/废品
    • 在 L2L 中打开调度
  • 为用户提供更便捷的方式，在其 Ignition 服务器上部署和标准化 L2L 功能，集中管理凭据。

目录

与 Ignition 的集成

有关集成用例和最佳实践的更多信息，请参考以下支持文章：

支持版本详情

我们支持所有版本的 Ignition 8.1 及以上。当前版本为 8.1.11。以前的版本可能与以下描述的多种方法兼容，但我们建议升级到最新版本，以利用最新的功能、安全增强和性能优势。

安装

以下安装文档改编自官方 Ignition 文档。有关安装 Ignition 模块的最新信息，请参阅：

下载

要下载 L2L 连接用于 Ignition 模块，请点击 这里。

模块配置

模块配置在网关网页中的 配置 > 模块 部分完成。这里可以添加、删除和重启模块。模块将其设置集成到左侧的网关配置菜单中。

安装或更新模块

  • 在网关网页上，选择配置 > 模块以打开模块配置页面。

    • 滚动到列表底部，找到蓝色箭头，然后点击安装或升级模块链接。

    点击选择文件，选择你之前下载的.modl文件。
      还没有下载L2L连接Ignition模块？ 在这里下载。

  • 在测试版期间，此模块可能是自签名的。只需点击你理解风险并想要安装此模块的复选框。然后点击“添加证书并安装模块”按钮（或者如果有的话，点击安装按钮）。
    当页面重新加载后，你现在可以在模块列表中看到你安装的模块。
    • mceclip0.png

    卸载模块

    1. 在网关网页上，选择配置 > 模块以打开模块配置页面。
    2. 滚动到你想卸载的模块。
    3. 在模块名称的右侧，点击更多 按钮并选择卸载。会出现确认消息。
    4. 点击确认。模块不再安装，并从列表中移除。

    模块是热插拔的，这意味着可以在系统运行时执行这些操作。模块的隔离性质确保执行这些操作只影响特定模块以及依赖它的任何模块。例如，卸载Ignition的L2L连接模块不会影响任何正在运行的Vision模块客户端。

    重启模块

    由于模块的隔离性质，其他模块不会受到重启的影响（除非它们依赖于该模块）。

  • 在网关网页上，选择配置 > 模块以打开模块配置页面。
  • 滚动到你想重启的模块。
    • 在模块名称的右侧，点击重启按钮。
  • 点击确认在确认消息中。

    • 点火将在模块重启后给你一个确认消息。

    模块状态

    已安装的模块列表在模块配置页面上也提供了一些关于状态的基本信息。版本、许可证和状态列都在列表中显示。模块授权在系统 > 许可证中集中进行，因此这里的值仅供参考。

    模块的状态可以是正在运行或已加载：

    • 正在运行表示模块程序正在积极执行任务，例如，报警通知模块显示为正在运行，因为它不断检查需要设置报警的条件变化。
    • 已加载表示模块程序或资源可用，但没有任何内容在运行，例如，符号工厂模块使所有符号图像可供使用。

    设置

    一旦你安装了 Ignition 的 L2L 连接模块，你需要通过添加你的凭据来配置它。在网关网页界面中，转到 配置，然后 L2L 连接设置。

    mceclip1.png

    你需要添加你的 服务器名称、站点编号、API 认证密钥，并提供与该 API 认证密钥相关联的用户名。然后点击 保存更改。

    授权和激活

    L2L 连接 for Ignition 授权工作原理

    L2L 连接 for Ignition 是一种基于订阅的服务，按站点计费。若要获取报价，请联系您的销售或支持账户代表。我们可以提供试用此服务的能力，请联系您的支持代表以启用此服务。

    Ignition 试用期

    新用户使用 Ignition？Ignition 按服务器授权，而非客户端。你只需要一份许可证用于你的服务器；任何客户端都自动包含在内。 如果你想测试 L2L 连接 for Ignition 模块，由于内置的试用模式，你无需额外操作。所有未授权的模块可以在 2 小时试用模式下重置。如果你没有从其网页下载、安装并开始使用的已授权 Ignition 服务器，也可以在 2 小时内使用。 试用结束后，模块将停止运行，但不要担心，你可以重置计时器以再次运行 2 小时。你可以多次重置计时器，所以尽情尝试！ 网关网页和设计器不受此试用影响，因此你可以无限期开发而不中断。 如果你拥有许可证，任何未授权的模块将在此试用模式下运行，但已授权的模块永不超时。

    你可以通过登录网关并点击 重置试用 来重新启动试用期，以启用另外 2 小时的运行时间。试用计时器可以多次重启。

    在网关中，试用时间横幅显示在屏幕顶部附近。要重置试用计时器，点击重置试用按钮：


    有关许可您的 Ignition 安装的更多信息，请参见；

    故障排除 / 调试

    未授权 API 错误

    如果您使用的 Ignition 试用版已过期，您可能会从 L2L 连接 Ignition 模块收到成功设置为 false 的响应以及错误信息 "L2L 连接 Ignition 未授权"。请通过 Ignition 网关网页界面重置您的试用版。

    站点禁用错误

    您可能会从 L2L 连接 Ignition 模块收到成功设置为 false 的响应以及错误信息 "L2L 连接 Ignition 被禁用"。每个站点必须启用 L2L 连接 Ignition 功能。请联系支持代表了解如何将其作为试用版启用，或联系您的销售代表获取添加此功能到您的订阅的报价。

    连接失败错误

    您可能会从 L2L 连接 Ignition 模块收到成功设置为 false 的响应以及错误信息 "L2L 连接 Ignition 连接失败"。在这种情况下，进入网关网页界面，选择配置，然后 L2L 连接设置以验证您的凭据。

    诊断 - 网关日志

    最重要的故障排除工具之一是 网关网页 的日志页面。此控制台显示由 网关 事件引起的错误，包括数据库或设备连接、身份验证配置文件、报警日志和管道，以及任何其他属于 网关 范围的内容。您可以在状态标签的日志中找到相关信息，位于 网关网页 下的诊断 > 日志。

    • 您可以过滤日志，仅显示 L2L 消息，以帮助您缩小搜索范围。
    • 您也可以将最低级别字段更改为调试，以显示更多信息。

    通过点击“添加映射诊断上下文过滤器”添加 L2L 连接的日志过滤器：

    配置过滤器，键名为 "module-name"，值为 "L2L Connect for Ignition"。它将出现在值输入框的下拉列表中。点击 "添加过滤器"。

    有关更多信息，请参阅 Ignition 文档：

    通过设计器脚本和输出控制台进行调试

    脚本控制台是一个实时的 Python 终端，只在设计器中可访问。它是快速测试脚本的绝佳方式，因为它不依赖于脚本事件或特定组件。可以通过菜单 工具 > 脚本控制台 打开脚本控制台。它由两个部分组成：一个 多行缓冲区 和一个 交互式解释器。可以在两边输入代码。

    脚本控制台可以调用 L2L 连接用于 Ignition、项目和共享脚本。如果最近添加了项目或共享脚本，则需要重置控制台才能调用。可以通过点击重置来完成
     图标 位于右上角。

    交互式解释器

    交互式解释器位于脚本控制台的右侧，允许您一次运行一行代码。按下Enter键即可从交互式解释器执行代码。来自脚本控制台两侧的打印语句将显示在交互式解释器中。

    在交互式解释器中可用的自动完成功能窗口，可以访问当前工作环境，因此项目和共享脚本等内容会自动显示。它们也可以手动输入。快捷键Ctrl + 空格将显示自动完成功能窗口，如果可以推断出任何函数。

    有关更多信息，请参阅 Ignition 文档：

    输出控制台

     输出控制台 是脚本编写者的最佳朋友。它是一个可停靠的面板，可以通过 工具 > 控制台 菜单或 Ctrl-Shift-C 快捷键打开。

     控制台 是一个可停靠的面板，您可以通过 工具 菜单或 Ctrl-Shift-C 快捷键打开。控制台会打印来自设计器的系统消息。这些消息可以是简单的加载信息，也可以是在出现错误时的错误信息。控制台也常用于测试和调试 Python 脚本，因为在设计器中运行的组件上的打印语句也会在这里显示。

    例如，通过在脚本中使用 print 函数，您可以观察脚本在执行时的内部工作。如果您执行以下脚本：

    # 一个演示print语句的Python脚本
      
    print "先打印我"
    x=10
    z=2
    print x, y, x / y
      
    # 结果如下：
    # 先打印我
    #10 2 5

    网关范围内的信息将不会出现在 输出控制台 或 脚本控制台。相反，输出将被发送到 wrapper.log 文件。或者， system.util.getLogger() 将消息发送到网关控制台，并且是故障排除网关范围脚本的首选方法。

    输出控制台最常用于在 Ignition 中测试和调试组件上的 Python 脚本。通过在脚本中使用print关键字，你可以观察脚本在执行时的内部工作。例如，如果你执行了以下脚本：

    Python - 使用输出控制台测试和调试 Python 脚本
    # 一个拦截标签写入的函数，先打印出之前的值
    def writeToTag(path, value):
       prevValue = system.tag.getTagValue(path)
       print "写入值 '%s' 到 %s，之前的值是 '%s'" % (value, path, prevValue)
       system.tag.writeToTag(path, value)
    writeToTag("压缩机/ HOA", 2)

    它会在控制台打印以下内容：

    写入值 '2' 到 压缩机/ HOA，之前的值是 '0'

    输出控制台在 Vision 客户端中也可以使用，路径为帮助 > 诊断，并选择控制台标签。

    欲了解更多信息，请参阅 Ignition 文档：