将 Logic Builder Shell 与 JetBrains PyCharm 一起使用

概述

利用 EcoStruxure Machine Expert 和 LogicBuilderShell.exe，您可以开发并调试 Python 脚本。如要开发 EcoStruxure Machine Expert Python 脚本，可以使用简介章节中所述的编辑器。

建议使用来自第三方供应商的 IDE，如 JetBrains PyCharm。PyCharm 是来自 JetBrains 的产品，包含免费的 Community Edition 和可购买的 Professional Edition。它不在 EcoStruxure Machine Expert 交货范围内，但是可以从 https://www.jetbrains.com/pycharm 下载。PyCharm 是交叉平台，支持 Windows、macOS 和 Linux。

在下图中，您可以看到 PyCharm 如何与 EcoStruxure Machine Expert LogicBuilderShell.exe 协同工作。

开发和调试程序

安装并配置了工具之后，请执行以下操作：

步骤

动作

启动 PyCharm。

创建或打开 PyCharm 项目或 Python 文件。

在 PyCharm 中开发脚本并执行。

结果：PyCharm 执行以下任务：

o启动 LogicBuilderShell.exe。

o在 PyCharm 与 LogicBuilderShell.exe 之间建立 TCP/IP 连接。

o将 Python 语句发送到 shell。

o获取结果反馈。

用 JetBrains PyCharm 开发脚本

PyCharm 让您能够开发自己的 EcoStruxure Machine Expert Python 脚本。

支持以下功能：

o在写入时验证 Python 语法。

o通过设置断点并使用调试器命令 Step Into、Step Over、Step Out 等来进行调试。

oPython 脚本的语法高亮显示

o支持自动完成。（注：无法解析内部模块的代码。）

执行了命令 Run > Debug... 或者在 PyCharm 中按下了 Alt+Shift+F9 并选择了要执行的 Python 脚本之后，会启动 LogicBuilderShell.exe 并开始执行脚本。如果在脚本中设置了断点并且抵达了断点，则 PyCharm 会标记当前语句，您可以使用调试器命令。脚本输出显示在 Console 中。

使用 PyCharm 调试 Python 脚本：

1 Python 脚本中的断点

2 LogicBuilderShell.exe 的由 PyCharm 启动的调试控制台

3 调试器命令

4 打开表达式求值对话，以便直接下发 Python 语句

有关如何使用 PyCharm 调试的更多信息，请参阅 https://www.jetbrains.com/help/pycharm/2017.1/debugging.html。

脚本调试的系统要求

如要调试 EcoStruxure Machine Expert Python 脚本，您的系统必须满足以下前提条件。

o安装有包含 Logic Builder Shell 功能的 EcoStruxure Machine Expert。

o已安装 PyCharm。

o已在 PyCharm 中配置了 Logic Builder Shell 环境（请参见在 PyCharm 中配置 Logic Builder Shell 章节）。

在 PyCharm 中配置 Logic Builder Shell

注意：如要使用 PyCharm，必须对相应的 EcoStruxure Machine Expert 系统应用一个操作。由于 PyCharm 需要且仅允许为 Python 解译器配置原始可执行名称，因此 LogicBuilderShell.exe 必须相应地命名。为此，应执行以下步骤中的步骤 1。

一旦搭载到某个系统上，便利用 Logic Builder Shell 功能，为每个已安装的 EcoStruxure Machine Expert 版本在 PyCharm 中配置 Logic Builder Shell 环境。

步骤	动作
1	重命名 LogicBuilderShell.exe： o导航至 Windows 资源管理器中的 LogicBuilderShell.exe（比如，C:\Program Files (x86)\Schneider Electric\SoMachine Software\V4.40 Motion）。 o通过复制粘贴到同一目录的方式来复制文件 LogicBuilderShell.exe 和 LogicBuilderShell.exe.config。 o将文件重命名为 ipy.exe 和 ipy.exe.config，因为 Logic Builder 将 IronPython 用作 Python 解译器。
2	启动 PyCharm，通过 Configure > Settings 打开 Settings 对话框。
3	打开 Project Interpreter 视图，然后通过 Project Interpreter: 框右侧的按钮执行命令 Add Local。结果：此过程完成（可能需要一定时间）之后，显示 Project Interpreter 并使其回到缺省设置。
4	通过 Project Interpreter: 框右侧的按钮执行命令 More...。
5	选择新创建的条目，然后单击右侧的铅笔图标，编辑属性。
6	将其重命名为 LogicBuilderShell_V4.x，其中 x 是 Logic Builder Shell 的具体版本。
7	单击确定，应用设置并关闭对话框。

有关如何配置 PyCharm Python 解译器的更多信息，请参阅 https://www.jetbrains.com/help/pycharm/2017.1/configuring-available-python-interpreters.html。

配置现有 PyCharm 项目或 Python 文件

如果在创建 PyCharm 项目时应用如在 PyCharm 中配置 Logic Builder Shell 中所述的步骤，则会预先配置新创建的 Logic Builder Shell Python 解译器。

如要配置现有 Python 项目或单个文件，请执行以下步骤：

步骤	动作
1	启动 PyCharm。
2	打开现有项目或 Python 文件。
3	在黄色突出显示的标题中，单击消息的 Configure Python Interpreter 链接。
4	在 Settings 对话框中，选择先前创建的 LogicBuilderShell_V4.x 作为 Project Interpreter，然后单击 OK 进行确认。

有关如何配置 PyCharm 项目解译器的更多信息，请参阅 https://www.jetbrains.com/help/pycharm/2017.1/configuring-python-interpreter-for-a-project.html。