Skip to main content
Version: 嵌入版本

安装 AstraraPlant

安装前准备​

IDE 软件安装程序

  • AstraraPlant_Setup_xx.exe, Window 版本的 IDE 开发机软件。将 AstraraPlant_Setup_xxx.exe 拷贝到开发机上
  • AstraraPlant_linux_xx.zip, ubuntu 版本的 IDE 开发机软件。将 AstraraPlant_linux_xx.zip 拷贝到开发机上并解压， 解压后的安装文件在当前目录的./rel 子目录中

开发机系统要求​

以下机器任意选一种

  • Ubuntu20.04及以上版本的操作系统，空闲磁盘空间在5G以上， 内存1G以上。
  • Window 11及以上版本的操作系统，空闲磁盘空间在5G以上， 内存4G以上。

Windows 平台安装 IDE​

  • 安装： 双击 AstraraPlant_Setup.exe，系统会提示需要 Administrator 权限运行该程序，点击确认， 然后按提示一步一步往下安装
  • 启动： 在桌面上或者 window 的程序开始菜单中，找到 AstraraPlant 如下图标入口并点击。在文件浏览器中任意文件夹上，鼠标右键菜单将会看到菜单项“AstraraPLC”, 点击即可对该文件下的项目打开 IDE 进行开发。

点击“AstraraPlant”的图标启动 IDE

安装 Windows 模拟器 (Wsl)​

AstraraPLC 在 Windows 平台上缺省提供基于 Wsl (Windows Sub-Linux)的模拟器。

运行安装程序后，首先会检测本机上 WSL 模拟器依赖的 Windows 配置环境，包含“虚拟机平台”和“WSL2”设置，如果没有，点击下一步将试图启用 Windows 系统的这些配置。某些用户的 Windows WSL 版本比较老，需要更新 WSL 的 Linux 内核版本，选中将试图自动更新。

当启用了“虚拟机平台”设置后，需要立即重新启动 Windows 系统才能继续安装。在重启 Windows 后，重新点击 Wsl 模拟器安装程序继续安装。

tip

如果不确定是否需要选中“更新 WSL 的 Linux 内核”，在第一次安装模拟器时可以总是选中此选项，并保持联网状态。更新 WSL 的 Linux 内核可能需要在联网的情况下持续一段时间，用户也可以先不选中进行下一步，如果后面导入模拟器步骤提示 WSL 需要更新时，再重新选中此选项重新安装一次。

然后在安装程序到本机后，执行导入模拟器过程。根据所使用的 Windows 系统，这个过程可能需要几十秒到数分钟。

如果过程中提示需要更新 WSL，请关闭安装程序，然后重启安装并在上面所属步骤选中“更新 WSL 的 Linux 内核”。如果导入成功，提示如下消息：

安装成功后，打开 AstraraPlant，在窗口中将显示 Wsl Simulator 的模拟器。

安装 Windows 模拟器 (VirtualBox)​

如果因为一些原因没有办法使用 Wsl 模拟器，可以使用基于 VirtualBox 的模拟器安装程序。目前 VirtualBox 版本模拟器没有在缺省的发型版本中提供，如需要请关注公众号 WasomCodeX 并留言:VirtualBox 版本模拟器。

运行安装程序 AstraraSimulator_Setup.exe, 首先会检测开发机是否安装有 VirtualBox 系统，如果没有将自动下载和安装。
注：用户也可以从浏览器搜索 VirtualBox 手工下载和安装。 安装 VirtualBox 完毕后，将检查本机是否已经安装过模拟器，如果是则提示用户是否覆盖，建议选址“是”。

安装模拟完成后，再打开 AstraraPlant 在目标设备连接视图(如下)中, 将会出现模拟器目标设备, 鼠标选择后, 可以选择按钮”启动模拟器”。

启动模拟器后，将会运行模拟器对应的虚拟机，如下图所示。此情况下在 IDE 中点击图标“停止模拟器”可以用来关闭模拟器。

VirtualBox 模拟器的 Windows 虚拟化设置​

模拟器上如果发生使用编译模式运行用户开发的 PLC 应用程序不能正常启动，可能是因为 Windows 的 HyperV 设置导致虚拟机没有启用 AVX 向量化加速指令，这正是 AstraraPLC 编译器的一项深度性能优化。

请执行以下操作，确保虚拟机中的 AVX 加速指令被启用。 第一步， 进入 windows 的系统配置，在查询窗口中输入hyper, 选中下拉菜单启动或关闭Windows功能

在以下弹出的窗口中确保hyperV和虚拟化平台两项都没有被选中。如果做出了修改，点击确定后需要重新启动 Windows 系统生效。

tip

当 Wsl 模拟器与 VirtualBox 模拟器同时安装，请确保 VirtualBox 的版本是 7.0 以上。否则可能会因为 VirtualBox 不支持启用虚拟机平台配置出现冲突。

Linux 平台安装 IDE​

warning
  • 强烈建议使用非root 的普通用户登录安装 AstraraPlant！
  • 如果当前 docker 是用 snap 安装的话，应该先执行命令sudo apt remove docker删除 docker 安装，AstraraPlant 安装过程会使用 apt 安装合适的 docker 版本。

  • 安装

    在安装文件的./AstraraPlant 目录下，执行以下命令：

    $ ./install.sh

    如果机器上没有安装 docker 和 vscode，安装过程比较漫长，需要耐心等待。 安装完成后会提示重启机器。

  • 启动

    执行以下命令：

    $ code <workspace_path>

    IDE 启动后， 点击左边一列中提示为 AstraraPlant”的图标, 点击"项目" ---> "变更"当前工作区 , 选择并设置工作区的路径

tip

目前不提供 Ubuntu 环境下的模拟器自动安装程序，用户可以手工下载 VirtualBox 和导入模拟器镜像文件。

用户也可以直接在本机（Ubuntu）安装 PLC 设备软件系统，使用本机作为测试目标环境。

IDE 日志收集​

出现使用问题，请收集 log 发送给我们。

log收集方法： “终端” ---> "新建终端" ---> "输出" ---> 下拉列表中"Astrara WebIDE", 过滤出来是WebIDE的log信息

Contents