1. 项目缘起：为什么是CODESYS Control RTE 3.5.17.0？

如果你正在接触工业自动化，尤其是基于PC的软PLC（Soft PLC）或运动控制项目，那么“CODESYS Control RTE”这个名字你一定不陌生。它不是一个简单的编程软件，而是将CODESYS开发环境（IDE）中编写的控制逻辑，在Windows或Linux等通用操作系统上，以实时（Real-Time）方式运行的核心运行时系统。简单来说，IDE是“画图纸”的地方，而Control RTE就是那个严格按照图纸、分秒不差执行动作的“超级工人”。

我之所以选择3.5.17.0这个特定版本作为切入点，是因为在近期的几个项目中，客户现场既有老旧的遗留系统，也有新采购的工控机，对运行时的兼容性和稳定性提出了双重挑战。3.5.17.0作为一个经过长期市场验证的成熟版本，在稳定性、功能完整性和对新旧硬件的兼容性之间取得了很好的平衡。它不像最新版本那样可能引入未知的兼容性问题，也不像太老的版本缺少某些必要的功能或安全更新。因此，掌握这个版本的纯净、标准安装流程，是搭建一个可靠软PLC控制系统的第一步，也是避免后续无数“玄学”问题的基石。

很多人觉得安装软件就是一路“下一步”，但在工业控制领域，尤其是涉及实时内核的软件安装，任何一个不经意的选项勾选或路径设置，都可能为日后埋下深坑。比如，实时补丁安装失败导致控制周期抖动、防火墙设置不当造成网络通信中断、用户权限配置错误引发运行时无法启动等。这篇内容，就是基于我多次在全新工控机、虚拟机和已有复杂软件环境的PC上部署该运行时的实战经验，为你梳理出一条清晰、可复现且避坑的安装路径。

2. 安装前的核心准备：环境与依赖检查

安装前的准备工作，其重要性不亚于安装过程本身。跳过这一步，就像在未知地基上盖楼，隐患无穷。

2.1 操作系统兼容性与版本确认

CODESYS Control RTE 3.5.17.0对Windows系统的支持是其主流应用场景。官方明确支持Windows 10 IoT Enterprise LTSC 2019/2021以及Windows 11 IoT Enterprise（特定版本）。对于桌面版的Windows 10/11专业版或企业版，虽然在许多情况下也能运行，但并非官方推荐的生产环境选择，因为其后台服务和非实时进程的干扰可能影响控制周期的确定性。

关键动作：

1. 确认系统版本：右键点击“此电脑” -> “属性”，查看Windows规格。确保是64位系统。对于生产环境，强烈建议使用官方支持的IoT Enterprise LTSC版本。
2. 关闭Windows更新：在控制面板中，将Windows更新设置为“暂停更新”或通过组策略彻底禁用自动更新。一次意外的系统重启或驱动更新，可能导致实时内核失效，造成生产线停机。
3. 检查系统语言：建议将系统区域和语言设置为“英语（美国）”。虽然CODESYS支持多语言，但将系统区域设置为英语可以避免因路径中包含非英文字符而可能引发的某些底层库加载失败问题，这是一个非常隐蔽的坑。

2.2 硬件与BIOS/UEFI关键设置

实时性对硬件有基础要求，BIOS设置是确保硬件能够配合软件实现实时性能的关键。

硬件要求：

• CPU：支持Intel VT-x或AMD-V虚拟化技术的多核处理器。实时内核需要独占一个或多个物理核心。
• 内存：至少4GB，建议8GB或以上。对于大型项目或需要运行视觉等附加任务的系统，需要更多。
• 存储：固态硬盘（SSD）能显著提升启动和项目加载速度。
• 网卡：使用Intel I210/I350等系列或Realtek的千兆网卡通常有较好的驱动支持。务必从主板或工控机制造商官网下载最新版网卡驱动安装。

BIOS/UEFI必须调整的设置（以常见服务器/工控机为例）：

1. 虚拟化技术（Intel VT-x / AMD-V）：必须启用（Enabled）。这是实时内核工作的基础。
2. CPU电源管理：
   • Intel SpeedStep / AMD Cool‘n’Quiet：禁用（Disabled）。防止CPU频率动态变化引入时序抖动。
   • C-States：禁用（Disabled）或设置为C0/C1 only。深度睡眠状态（如C6、C7）会导致CPU唤醒延迟，破坏实时性。
   • P-States：禁用（Disabled）。
3. 操作系统类型：如果有选项，设置为“Windows 10”或“Other OS”，避免某些针对消费级Windows的优化干扰。
4. 安全启动（Secure Boot）：禁用（Disabled）。实时内核驱动通常未经微软签名，安全启动会阻止其加载。
5. 快速启动（Fast Boot）：禁用（Disabled）。确保所有硬件在启动时被正确初始化。

完成这些设置后，保存并重启进入Windows。

2.3 软件环境清理与必备组件

一个干净的软件环境是稳定运行的保障。

1. 卸载冲突软件：检查并卸载系统中可能存在的旧版CODESYS运行时、其他品牌的软PLC运行时（如Beckhoff TwinCAT Runtime，如果不同时使用）或测试版的运行时。使用控制面板的“程序和功能”彻底卸载。
2. 安装/更新.NET Framework：CODESYS IDE和部分组件依赖.NET。确保已安装.NET Framework 4.7.2或更高版本。Windows 10/11通常已内置，但可通过“设置”->“应用”->“可选功能”中添加确认。
3. 关闭防火墙与杀毒软件（临时）：在安装过程中，暂时关闭Windows Defender防火墙和任何第三方杀毒软件的实时保护功能。它们可能会拦截运行时服务的安装、驱动程序的加载或网络端口的监听。（重要提示：安装完成后，需要根据通讯需求重新配置防火墙规则，而不是长期关闭。）
4. 获取安装包：从CODESYS官网或您的设备供应商处，获取CODESYS Control RTE 3.5.17.0的完整安装包。确保其适用于你的操作系统位数（64位）。

3. 分步安装详解与每个选项的深层含义

准备好安装包后，我们以管理员身份运行安装程序。安装界面可能因具体安装包略有差异，但核心步骤一致。

3.1 安装模式选择：完整、定制与仅运行时

安装程序启动后，通常会首先让你选择安装类型。

• 完整安装（Full）：推荐大多数用户选择。它会安装CODESYS Control RTE运行时、Windows实时内核补丁、CODESYS开发系统（IDE）的远程连接组件、在线帮助文档等所有必要内容。这是一站式解决方案。
• 定制安装（Custom）：适合高级用户或系统集成商。你可以选择只安装“Runtime”和“Real-Time Kernel”，而不安装IDE组件，以节省空间。但请注意，即使不在这台机器上编程，安装“Gateway”和“SysDrv”组件也通常是必要的，它们分别用于网络扫描/路由和设备驱动支持。
• 仅运行时（Runtime only）：一个更精简的选项，通常只包含最核心的运行时文件，可能不包含实时内核。除非你非常清楚自己在做什么，并且通过其他方式已经配置好了实时环境，否则不建议生产环境选择此选项。

我的选择与理由：对于一台专门用于控制的工控机，我通常选择“完整安装”。虽然会多占用几百MB磁盘空间，但它确保了所有依赖项被正确安装和注册，避免了后续因缺少某个dll或服务而导致的诡异问题。磁盘空间在今天已经不是瓶颈，系统的完整性和可维护性更重要。

3.2 安装路径与许可协议

接下来是选择安装路径和阅读许可协议。

• 安装路径：默认路径通常是C:\Program Files\CODESYS 3.5.17.0\。强烈建议使用默认路径。不要安装到包含中文、空格或特殊字符的路径中。工业软件对路径的解析有时很“脆弱”，非标准路径可能导致服务启动失败或文件访问错误。
• 许可协议：需要勾选接受。建议花时间阅读一下，特别是关于运行时许可证的部分。CODESYS Control RTE需要一个有效的运行时许可证（RTE License）才能运行超过2小时的完整功能。这个许可证通常是一个授权文件（.lic）或一个硬件狗（USB Dongle）。在安装阶段，你可以选择暂不导入许可证，系统会以7天全功能试用模式运行。

3.3 实时内核安装：最关键的步骤

这是整个安装过程的核心，也是问题高发区。安装程序会检测你的系统，并提示安装“CODESYS Real-Time (Win64)”内核。

1. 驱动签名警告：在安装实时内核驱动时，Windows会弹出“Windows安全”对话框，提示“Windows无法验证此驱动程序软件的发布者”。你必须点击“始终安装此驱动程序软件”。如果错过了这个窗口，或者点击了“不安装”，那么实时内核将安装失败，运行时将无法以硬实时模式工作。
2. 重启提示：实时内核驱动安装后，安装程序会要求重启计算机。这个重启是强制性的，不能跳过。重启是为了让新的驱动生效，并完成内核级别的配置。

常见坑点与处理：

• 没有弹出驱动安装提示：这可能是因为Windows的驱动程序强制签名策略。你需要临时禁用驱动签名强制。方法是：在“设置”->“更新与安全”->“恢复”->“高级启动”中点击“立即重新启动”，进入高级启动选项后，选择“疑难解答”->“高级选项”->“启动设置”->“重启”，然后按数字键“7”选择“禁用驱动程序强制签名”。重启后再运行安装程序。
• 重启后安装程序没有自动继续：有时重启后需要手动再次以管理员身份运行安装程序，它会检测到未完成的安装并继续。

3.4 组件配置与端口设置

安装后期，可能会对一些组件进行初始配置。

• CODESYS Gateway配置：Gateway是网络访问的枢纽。安装程序可能会询问Gateway服务的端口号（默认为1217）和是否将其添加到Windows防火墙例外。务必选择“是”，添加例外。否则，你将无法从网络上的其他电脑通过CODESYS IDE连接到这台运行时的控制器。
• 用户权限：确保安装运行时服务的Windows用户具有管理员权限，或者是“实时”用户组的成员（如果安装程序创建了该组）。CODESYS运行时服务（CodesysControlService）需要较高的权限来访问硬件和实时资源。

4. 安装后必须进行的验证与基础配置

安装完成并重启后，工作只完成了一半。以下验证步骤至关重要，确保运行时已就绪。

4.1 服务状态检查

1. 打开“任务管理器”，切换到“服务”选项卡，或直接运行services.msc打开服务管理器。
2. 找到名为“CODESYS Control RTE”或“CodesysControlService”的服务。检查其状态应为“正在运行”，启动类型应为“自动”。
3. 同时检查“CODESYS Gateway”服务，状态也应为“正在运行”。

如果服务没有运行，右键点击选择“启动”。如果启动失败，查看Windows事件查看器（eventvwr.msc）中“Windows日志”->“应用程序”里，来自“CODESYS”源的错误事件，这是排查问题的第一手资料。

4.2 实时性测试与系统评估

CODESYS安装后自带一个强大的诊断工具——CODESYS System Diagnostics。你可以在开始菜单中找到它。

1. 运行System Diagnostics。
2. 在“Runtime”选项卡下，你可以看到当前连接的运行时（本地或远程）的信息，包括版本号、运行状态等。
3. 关键步骤：进行实时性测试。切换到“Performance”或“实时性”相关选项卡。运行一个周期性的高优先级任务（工具内通常提供测试功能），并观察“最大周期超时”、“周期抖动”等指标。在一个配置良好的系统上，抖动（Jitter）应稳定在微秒（µs）级别。如果抖动达到毫秒（ms）级别或频繁出现超时，说明实时内核可能未正确工作，需要返回检查BIOS设置和驱动安装。

4.3 网络与防火墙规则确认

即使安装时添加了防火墙例外，手动确认一下更稳妥。

1. 打开“Windows Defender 防火墙”->“允许应用或功能通过Windows Defender防火墙”。
2. 在列表中找到“CODESYS Gateway”和“CODESYS Development System”，确保其在“专用”和“公用”网络上都被勾选允许。如果没有，点击“允许其他应用...”手动添加C:\Program Files\CODESYS 3.5.17.0\CODESYS\CodesysGateway.exe和你的CODESYS IDE可执行文件。
3. 对于需要与其他设备（如可视化触摸屏、第三方MES系统）进行TCP/IP或UDP通讯的，可能需要在防火墙中额外开放特定的端口（如502端口用于Modbus TCP）。

4.4 许可证激活

如果你有正式的运行时许可证文件（.lic）：

1. 将许可证文件复制到运行时系统的特定目录，通常是C:\ProgramData\CODESYS\CML或C:\Program Files\CODESYS 3.5.17.0\CODESYS\下的License文件夹（具体路径参考许可证说明）。
2. 重启CODESYS Control RTE服务。
3. 在CODESYS System Diagnostics的“License”选项卡中，确认许可证已成功加载，并检查其有效期和功能限制。

使用硬件狗（USB Dongle）的话，只需在系统启动前将狗插入工控机的USB口，运行时服务会自动识别。

5. 高级配置与性能调优要点

基础安装验证通过后，为了追求极致的稳定性和性能，可以进行一些高级配置。

5.1 实时内核与CPU亲和性设置

这是提升实时性能最有效的手段之一。原理是让CODESYS的实时任务线程只运行在指定的物理CPU核心上，避免被Windows操作系统和其他应用程序的线程抢占或干扰。

1. 在CODESYS IDE中连接到目标运行时。
2. 打开“设备”树，找到你的控制器设备（如“CODESYS Control Win V3”）。
3. 右键选择“设备命令”->“设置实时（Set Real-Time）”。或者，在设备编辑器中，找到“实时设置”相关的选项卡。
4. CPU亲和性（CPU Affinity）：在这里，你可以为实时任务分配专用的CPU核心。例如，在一个4核8线程的CPU上，你可以将核心0和1（物理核心）分配给Windows和非实时任务，将核心2和3（物理核心）独占给CODESYS实时任务。注意：需要避免使用CPU的超线程逻辑核心（通常编号较大的那些），绑定到物理核心效果更好。
5. 实时优先级：确保实时任务的优先级设置为“实时（Real-Time）”或最高级别。

5.2 网络适配器电源管理禁用

工控机的网卡为了省电，默认可能启用了“节能以太网”、“环保节能”或“允许计算机关闭此设备以节约电源”等功能。这些功能会导致网卡在空闲时进入低功耗状态，唤醒时产生延迟，对于需要恒定、低延迟网络通讯的工业现场是致命的。

1. 打开“设备管理器”。
2. 找到“网络适配器”，右键点击你的工控网卡（如Intel I210），选择“属性”。
3. 切换到“电源管理”选项卡，取消勾选“允许计算机关闭此设备以节约电源”。
4. 切换到“高级”选项卡，寻找“节能以太网（Energy Efficient Ethernet）”、“环保节能（Green Ethernet）”等选项，将其设置为“关闭（Disabled）”。

5.3 系统电源计划与性能优化

将Windows的电源计划设置为“高性能”或“卓越性能”，确保CPU始终以最高性能状态运行，避免因电源管理导致的频率波动。

1. 在Windows搜索栏输入“电源计划”，选择“编辑电源计划”。
2. 选择“高性能”。如果没有，点击“显示附加计划”。
3. 进一步点击“更改高级电源设置”，在弹出窗口中，确保“处理器电源管理”->“最小处理器状态”设置为100%。

6. 典型故障排查与解决方案

即使按照上述步骤操作，在实际环境中仍可能遇到问题。这里列举几个我亲身踩过的坑及其解决办法。

6.1 服务无法启动，错误代码1067

这是最常见的问题之一。可能的原因和排查步骤：

1. 检查事件查看器：这是首要步骤。查看应用程序日志中CODESYS相关的错误事件，通常会有更具体的描述。
2. 许可证问题：无效或过期的许可证会导致服务启动后立即停止。检查许可证文件是否在正确路径，或USB狗是否被识别。试用期是否已过。
3. 实时内核驱动加载失败：运行CODESYS System Diagnostics，查看“Runtime”信息中是否有“Real-Time: Inactive”的提示。如果实时内核未激活，返回检查驱动签名和BIOS设置。
4. 端口冲突：Gateway默认的1217端口被其他程序占用。使用命令netstat -ano | findstr :1217查看端口占用情况。如果被占用，可以在Gateway配置工具（CodesysGatewayConfig.exe）中修改端口号。
5. 依赖服务问题：确保远程过程调用（RPC）等相关Windows服务正常运行。

6.2 从IDE无法扫描或连接到目标设备

1. 网络连通性：首先用ping命令测试物理连通性。关闭防火墙临时测试。
2. Gateway服务状态：确认目标设备上的CODESYS Gateway服务正在运行。
3. 扫描设置：在IDE的“设备”->“扫描网络”中，确保扫描的网段正确。有时需要手动添加路由（在Gateway配置中），如果控制器和编程电脑不在同一子网。
4. 用户控制权限（UAC）影响：在以管理员身份运行的IDE和普通身份运行的IDE中，网络扫描的结果有时会不同。尝试都以管理员身份运行。

6.3 实时任务周期超时或抖动过大

1. BIOS设置复查：这是最可能的原因。再次进入BIOS，逐项确认所有与电源管理（C-State, P-State, SpeedStep）、虚拟化（VT-x）相关的选项已按前述要求禁用或启用。
2. CPU亲和性未设置：实时任务可能被调度到繁忙的核心上。按照5.1节的方法正确设置CPU亲和性。
3. 系统中有高负载进程：使用任务管理器或资源监视器，查看是否有其他进程（如杀毒软件、Windows更新、日志服务）持续占用大量CPU。考虑卸载或禁用非必要的后台服务。
4. DPC/ISR延迟过高：使用LatencyMon（一个免费工具）监测系统。它可以告诉你哪个驱动程序或内核模块导致了高延迟。根据其报告，更新或回滚有问题的驱动程序（特别是显卡、声卡、某些USB控制器驱动）。

安装CODESYS Control RTE 3.5.17.0，远不止是点击“下一步”直到完成。它是一次对目标系统从硬件固件层到操作系统层，再到应用软件层的系统性配置和调优。每一个被忽略的细节，都可能在生产环境中被放大为一个棘手的故障。我的经验是，为安装和配置预留出充足的时间，严格按照清单操作，并在交付前进行完整的实时性测试和压力测试，是保证项目后期稳定运行最经济的投入。毕竟，在凌晨三点被叫去处理一个因电源管理设置导致的偶发性控制失灵，滋味可不好受。把功夫花在前面，让系统在安装之初就处于一个已知的、最优的基准状态，是工程师专业性的体现。