CODESYS单机版授权激活和恢复

1 概述

介绍在ED-IPC、ED-HMI和ED-PLC产品上使用CODESYS单机授权的背景和适用范围。

1.1 背景

部分客户在选购我司ED-IPC、ED-HMI及PLC产品时，为其设备配置了单机版CODESYS License（CODESYS Control for Raspberry Pi SL），但在部署过程中可能对授权激活、备份和恢复存在疑问。为方便用户，我司针对此场景开发指导文档，帮助指导用户激活、备份和恢复CODESYS单机版授权。

1.2 适用范围

本应用适用于随ED-IPC、ED-HMI和ED-PLC设备一起发货的单机版CODESYS License。

2 应用指导

介绍在ED-IPC、ED-HMI和ED-PLC产品上使用CODESYS单机授权的具体步骤，下文仅以在ED-PLC设备上操作为例。

2.1 激活授权

前提条件：

  • 已下载CODESYS IDE软件（V3.5 SP20 PAtch1版本）并安装至Windows PC。
  • 已将待授权的ED-PLC设备正常启动并接入以太网。
  • 确保Windows PC已接入网络，且需要与待授权ED-PLC设备在同一个网段。
  • ED-PLC设备已使能SSH。
  • 已获取待授权ED-PLC设备的IP地址和登录的用户名/密码。
  • 已获取授权的License。

操作步骤：

  1. 登录CODESYS官方网站下载针对 Raspberry Pi（PLC 扩展）的定制CODESYS Control for Raspberry PI SL运行时系统，下载链接:

CODESYS Control for Raspberry Pi SL | CODESYS Store Internationalopen in new window

dfg2857
  1. 在Windows PC上打开CODESYS IDE软件，在菜单栏中选择 “工具”→“CODESYS 安装程序…”，打开CODESYS Installer界面。
image-20240614102128667
  1. 在CODESYS Installer界面中选择“Browse”，在搜素框中输入“Raspberry”进行搜索；根据搜索的结果选择对应版本的运行时，再单击“Install”进行安装。
6-new

  1. 根据提示完成安装。

  2. 安装完成后，在菜单栏中选择 “工具”→“部署 Codesys Control SL”，打开“部署 Codesys Control SL”界面。

34567845627
  1. 在“部署 Codesys Control SL”界面中的“通讯”页签中输入设备的IP地址、用户名和密码，再单击“连接”。

提示

连接成功后下方的信息栏会提示连接成功。

66666666
  1. 目标设备连接成功后，选择“部署 Codesys Control SL”界面中的“部署”页签，在“产品”和“版本”中分别选择“CODESYS Control for Raspberry Pi SL”和“4.14.0.0”，最后单击“安装”。
77777774
  1. CODESYS Control for Raspberry Pi SL安装完成后，选择“部署 Codesys Control SL”界面中的“部署”页签，在“产品”和“版本”中分别选择“CODESYS Edge Gateway for Linux”和“4.14.0.0”，最后单击“安装”。
8888853420

9.CODESYS Control for Raspberry Pi SL安装完成后，选择“部署 Codesys Control SL”界面中的“操作”页签，查看已安装的运行时是否在运行中；如果显示未运行，单击“启动全部”。

99999954223
  1. 执行如下命令重启设备。
sudo reboot
  1. 设备启动完成后，在终端窗格执行如下命令。
sudo systemctl status codesyscontrol.service
  • 返回信息如下图所示，表示CODESYS运行时已经在设备上启动。 111155112
  1. 参照下图新建一个标准工程。
  • 类别：选择“Projects”
  • 模版：选择“Standard project”
  • 名称：自定义
  • 位置：自定义
  • 设备：选择“CODESYS Control for Raspberry Pi 64 SL”
1-new
  1. 左键双击界面左侧的“Device”，在右侧选择“扫描网络”页签，在弹出的“选择设备”选项卡中选择待授权的ED-PLC设备，再单击“确定”。
image-20240614115457202

提示

如果未扫描到设备，可能包含如下原因：

  • PC与ED-PLC设备不在同一个网段，需要重新将PC和设备配置在同一个网段。

  • 未安装运行时或运行时已损坏，需要重新安装运行时。

  • CODESYS Gatway v3服务未启用，可在本地服务启用。

  1. 在弹出的“设备用户登录”选项卡中，输入用户名和密码，单击“确定”登录设备。
image-20240614120242296
  1. 设备正常登录后，在菜单栏中选择 “工具”→“授权管理器...”，打开授权管理器界面。
image-20240614105300082
  1. 在“Select Target”界面中选择“设备”，再单击“Next”。
image-20240614105611655
  1. 在“Select Container”界面中选择“软容器”，再单击“Next”。
image-20240614110005649
  1. 在“选择设备”界面中选择待授权的设备，再单击“确定”。
image-20240614110341674
  1. 在“授权管理器”界面中单击“安装授权”。
image-20240614111300138
  1. 在“安装授权”界面中选择“激活授权”，再单击“Next”。
image-20240614111557888
  1. 在“安装授权”界面的“票证ID”中填入License，选择容器，再单击“Next”。
image-20240614112253526
  1. 单击“Finish”，完成激活。

2.2 备份授权

在使用过程中，如果用户可以将授权文件进行备份，后续可通过该文件还原授权。

提示

CODESYS V3.5 SP13及以上的版本自动备份授权，在ED-PLC设备根目录生成后缀名为“.WibuCmRaU”的授权文件。

前提条件：

已在CODESYS IDE软件中连接ED-PLC设备并激活授权。

操作步骤：

  1. 左键双击界面左侧的“Device”，在右侧窗格选择“Files”页签，在Runtime区域单击image-20240614141610038，显示ED-PLC设备根目录的文件，其中后缀名为“.WibuCmRaU”的文件为授权备份文件。
image-20240614141610038
  1. 选中授权文件，单击image-20240614142806810，将授权文件保存至本地PC的自定义目录下。
image-20240614141610038

2.3 恢复授权

如果用户对ED-PLC设备重新安装了操作系统，则需要对设备恢复授权。恢复授权支持重新安装授权和通过备份的授权文件来恢复两种不同的操作方法，可参考下文进行操作。

提示

仅支持在同一台ED-PLC设备上执行恢复授权的操作。

前提条件：

已在CODESYS IDE软件中连接ED-PLC设备。

操作步骤：

- 重新安装授权

  1. 设备正常登录后，在菜单栏中选择 “工具”→“授权管理器...”，打开授权管理器界面。

    image-20240614105300082

  2. 在“Select Target”界面中选择“设备”，再单击“Next”。

    image-20240614105611655

  3. 在“Select Container”界面中选择“软容器”，再单击“Next”。

    image-20240614110005649

  4. 在“选择设备”界面中选择待授权的设备，再单击“确定”。

    image-20240614110341674

  5. 在“授权管理器”界面中单击“附加功能”，选择“恢复授权”。

    image-20240614150431551

  6. 在“恢复授权”界面的“票证ID”中填入License，再单击“恢复”。

    image-20240614150827205

- 通过备份的授权文件来恢复

  1. 设备正常登录后，在菜单栏中选择 “工具”→“授权管理器...”，打开授权管理器界面。

    image-20240614105300082

  2. 在“Select Target”界面中选择“设备”，再单击“Next”。

    image-20240614105611655

  3. 在“Select Container”界面中选择“软容器”，再单击“Next”。

    image-20240614110005649

  4. 在“选择设备”界面中选择待授权的设备，再单击“确定”。

    image-20240614110341674

  5. 在“授权管理器”界面中单击“安装授权”。

    image-20240614111300138

  6. 在“安装授权”界面中选择“安装授权”，再单击“Next”。

    image-20240614145556348

  7. 选择容器，导入备份的后缀名为“.WibuCmRaU”的授权文件，再单击“Finish”。

    image-20240614145837501