3. 嵌入式部署基础
在桌面环境中开发 CODESYS 工程时，编译、下载、运行往往发生在同一台 PC 上；而一旦进入嵌入式部署，开发机与目标设备就分成了两个世界。开发机通常是 x86_64 的 Windows 或 Linux，目标设备却可能是 ARM Cortex-A、ARM Cortex-M、RISC-V 或 PowerPC 架构的控制器。两者指令集不同、操作系统不同、库依赖不同，因此必须借助交叉编译在开发机上生成目标平台可执行的 Runtime 与应用程序。理解交叉编译、目标平台、工具链、启动流程和部署方式，是 CODESYS Runtime 嵌入式落地的第一道门槛。
一、核心原理：为什么必须交叉编译
CODESYS Runtime 本质上是一个运行在目标设备上的软件系统，它包含运行时内核、组件库、通信栈、驱动以及可选的 Web 服务器、OPC UA、运动控制等模块。这些代码最终要变成目标 CPU 能识别的机器码。交叉编译的核心，就是使用一套运行在开发机上的工具链，把源码编译成目标架构的二进制文件。
这里有两个关键概念：宿主机（Host）和目标机（Target）。宿主机是执行编译的电脑，目标机是最终运行 Runtime 的设备。工具链中的编译器、链接器、汇编器都带有目标平台前缀，例如 arm-linux-gnueabihf-gcc 表示面向 ARM 架构、Linux 系统、使用硬浮点 ABI 的 GCC 编译器。前缀不同，生成的二进制就无法通用。
交叉编译三要素：目标 CPU 架构、目标操作系统、目标 ABI/浮点模式。三者必须与目标设备完全匹配，否则会出现“编译成功但无法运行”或“运行即崩溃”的问题。
二、目标平台与工具链的对应关系
CODESYS 支持多种目标平台，常见的有 Linux ARM、Linux x86、Windows、VxWorks、QNX、RTOS 以及裸机环境。不同平台需要不同的工具链和 Runtime 包。下表列出典型组合：
| 目标平台 | 典型 CPU | 工具链前缀 | Runtime 包类型 |
|---|---|---|---|
| Linux ARM 32 位 | Cortex-A7/A9 | arm-linux-gnueabihf- | Linux ARM Runtime |
| Linux ARM 64 位 | Cortex-A53/A72 | aarch64-linux-gnu- | Linux ARM64 Runtime |
| Linux x86 64 位 | Intel/AMD | x86_64-linux-gnu- | Linux x64 Runtime |
| Windows x86 64 位 | Intel/AMD | MSVC / MinGW | Windows Runtime |
| RTOS / 裸机 | Cortex-M、RISC-V | arm-none-eabi- 等 | 专用 Runtime 移植包 |
工具链通常由芯片厂商或系统集成商提供，例如 Xilinx、NXP、TI 的 SDK 中会附带交叉编译器。CODESYS 的 Runtime 包则需要在 CODESYS Store 或授权渠道获取，并确保版本与目标平台一致。
三、启动流程：从设备上电到 Runtime 就绪
嵌入式设备上电后，Runtime 并不是第一个运行的程序。典型的启动链路如下：
- BootROM：CPU 复位后执行固化在芯片内部的引导代码，加载一级引导程序。
- Bootloader：如 U-Boot，负责初始化内存、时钟、外设，并加载操作系统内核。
- 内核启动：Linux 内核解压、初始化驱动、挂载根文件系统。
- init 进程：执行
/etc/init.d/或 systemd 服务，启动系统服务。 - Runtime 启动：由启动脚本或服务拉起 CODESYSControl，加载授权、配置和应用程序。
- 通信就绪：Runtime 打开以太网、串口等接口，等待 CODESYS 开发环境连接。
在 Linux 目标上，Runtime 通常以守护进程方式运行，启动脚本可能位于 /etc/init.d/codesyscontrol。一个典型的启动命令如下：
# 手动启动 CODESYS Runtime
/etc/init.d/codesyscontrol start
# 查看运行状态
ps aux | grep CODESYSControl
netstat -tlnp | grep 1217其中 1217 是 CODESYS 网关默认端口，用于开发环境与 Runtime 之间的通信。如果该端口未监听，说明 Runtime 未正常启动或防火墙拦截。
四、部署方式与典型场景
CODESYS Runtime 的部署方式主要有三种：本地部署、网络部署和镜像预置。本地部署通过 U 盘或 SD 卡把 Runtime 包拷贝到目标设备，适合无网络或首次调试的场景；网络部署通过 scp、FTP 或 CODESYS 自带的部署工具远程传输，适合批量设备；镜像预置则是在制作根文件系统时就把 Runtime 集成进去，适合量产设备。
以一个 ARM Linux 控制器为例，典型操作流程如下：
# 1. 在开发机上编译 Runtime 包
tar -xzf CODESYSControl_ARM_Linux.tar.gz
cd CODESYSControl_ARM_Linux
./install.sh --target /opt/codesys
# 2. 传输到目标设备
scp -r /opt/codesys root@192.168.1.100:/opt/
# 3. 在目标设备上设置权限并启动
chmod +x /opt/codesys/CODESYSControl
/opt/codesys/CODESYSControl --daemon
# 4. 在 CODESYS 开发环境中扫描网关
# 设备 IP：192.168.1.100，端口：1217提示：首次部署建议先手动启动 Runtime，观察终端输出中的授权、库加载和端口绑定信息，确认无误后再配置为开机自启动服务。
五、常见误区与复盘
在实际项目中，交叉编译和部署最容易踩的坑集中在以下几个方面：
- 工具链与目标 ABI 不匹配：例如目标使用软浮点，却用硬浮点工具链编译，程序启动即报非法指令。
- 动态库缺失：Runtime 依赖 libc、libpthread、libdl 等，目标根文件系统中版本不一致会导致加载失败。
- 授权文件未正确放置：CODESYS Runtime 需要有效的授权文件，路径错误或授权过期会导致 Runtime 拒绝启动。
- 端口被占用或防火墙拦截：网关端口 1217 若被其他进程占用，开发环境无法扫描到设备。
- 启动脚本权限不足：以非 root 用户运行 Runtime 时，可能无法绑定特权端口或访问硬件外设。
排障建议：遇到 Runtime 无法启动时，先查看 /var/log/codesyscontrol.log 或终端输出，确认是授权问题、库依赖问题还是端口问题，再针对性处理，不要盲目重装。
总结来看，嵌入式部署的核心在于“匹配”二字：工具链与目标平台匹配、Runtime 包与操作系统匹配、启动配置与硬件资源匹配。掌握交叉编译的基本原理、目标平台的工具链对应关系、从 BootROM 到 Runtime 的启动链路，以及本地、网络、镜像三种部署方式，才能让 CODESYS Runtime 在嵌入式设备上稳定运行。