保姆级教程：在Codesys V3.5 SP18中用CANBusAPI实现与第三方设备的CAN协议对接
Codesys V3.5 SP18实战：CANBusAPI与第三方设备协议对接全流程解析
当工业控制器需要与第三方设备进行数据交互时，CAN总线因其高可靠性和实时性成为首选方案。本文将带您从零开始，在Codesys V3.5 SP18环境中使用CANBusAPI实现与第三方设备的CAN协议对接，涵盖硬件选型、软件配置到功能块封装的全流程。
1. 硬件准备与基础环境搭建
在开始编码前，正确的硬件连接和软件环境是成功的基础。对于倍福CX系列控制器，通常需要确认以下几点：
- CAN接口选择：大多数工业控制器提供内置CAN接口（如倍福CX9020的CAN1/CAN2），若使用PCIe或USB转CAN适配器，需确保驱动兼容性
- 终端电阻配置：CAN总线两端需安装120Ω终端电阻，使用万用表测量CAN_H与CAN_L间电阻应为60Ω左右
- 线缆规格：推荐使用双绞屏蔽线，最大长度与波特率相关（1Mbps时不超过40米）
软件环境要求：
Codesys V3.5 SP18 Patch 4 CANBusAPI库版本 ≥ 2.3.0 第三方设备协议文档（含CAN ID定义）安装CANBusAPI库的详细步骤：
- 在Codesys开发环境中导航至"工具"→"库存储库"
- 点击"安装"按钮并选择下载的CANBusAPI.library文件
- 重启开发环境使库生效
注意：不同控制器型号可能需要特定的CAN驱动支持包，建议在厂商官网下载最新驱动
2. CAN通信基础配置
建立CAN通信需要正确配置总线参数和消息处理机制。以下是一个典型的配置结构：
VAR_GLOBAL // CAN驱动配置 g_busConfig : CAN.DRIVER_CONFIG := ( usiNetwork := 1, // CAN接口编号（0=CAN1, 1=CAN2） uiBaudrate := 500, // 波特率(kbps)，需与设备一致 ctMessages := 32 // 发送消息队列长度 ); // 接收超时设置 g_tTimeLimit : TIME := T#50MS; END_VAR关键参数说明：
| 参数 | 取值范围 | 说明 |
|---|---|---|
| uiBaudrate | 10,20,50,100,125,250,500,800,1000 | 必须与第三方设备严格匹配 |
| usiNetwork | 0-255 | 物理CAN接口索引 |
| ctMessages | 1-255 | 影响连续发送时的稳定性 |
消息过滤器配置示例：
maskConfig : CAN.RECEIVER_MASK := ( dwIdValue := 16#100, // 基础ID dwIdMask := 16#700, // 掩码（二进制11100000000） xRTRValue := FALSE, x29BitIdValue := FALSE, xAlwaysNewest := TRUE // 只处理最新消息 );3. 协议解析与功能块封装
面对第三方设备的自定义协议，合理的功能块设计能显著提升代码复用性。我们以某品牌伺服驱动器的协议为例：
3.1 数据帧解析
典型通信流程：
- 控制器发送指令帧（ID:0x201）
- 驱动器返回状态帧（ID:0x181）
- 数据长度通常为8字节
状态帧数据结构解析：
| 字节 | 内容 | 说明 |
|---|---|---|
| 0 | 0xA5 | 帧头标识 |
| 1 | 状态字 | bit0:就绪, bit1:报警 |
| 2-3 | 实际位置 | 单位：0.01mm |
| 4-5 | 实际速度 | 单位：1RPM |
| 6 | 温度 | 单位：℃ |
| 7 | 0x5A | 帧尾标识 |
3.2 可复用功能块设计
创建FB_ServoDrive_Comm功能块实现标准化操作：
FUNCTION_BLOCK FB_ServoDrive_Comm VAR_INPUT bEnable : BOOL; // 使能信号 fTargetPos : REAL; // 目标位置(mm) END_VAR VAR_OUTPUT bReady : BOOL; // 驱动器就绪 fActualPos : REAL; // 实际位置 iErrorCode : INT; // 错误代码 END_VAR VAR hReceiver : CAN.CAA.HANDLE; tPollTimer : TON; stMsg : CAN.RxMessage; END_VAR关键方法实现：
METHOD SendPositionCommand : BOOL VAR txMsg : CAN.TxMessage; BEGIN txMsg.udiCanID := 16#201; txMsg.usiDataLength := 8; // 位置数据转换为4字节整数 MEMCPY(DEST_ADR:=txMsg.abyData[0], SRC_ADR:=fTargetPos*100, LEN:=4); RETURN driver.SendMessage(txMsg); END_METHOD4. 联调测试与故障排查
实际调试中常见问题及解决方案：
问题1：无法接收到任何数据
- 检查步骤：
- 用CAN分析仪确认设备是否正常发送
- 确认波特率设置完全一致
- 检查终端电阻配置
- 验证过滤器掩码设置
问题2：数据偶尔丢失
- 优化方案：
// 增加接收缓冲区 g_busConfig.ctMessages := 64; // 缩短轮询周期 g_tTimeLimit := T#20MS;
问题3：数据解析错误
- 调试技巧：
- 在ProcessMessage方法中添加原始数据日志
- 使用联合体(UNION)处理字节转换：
TYPE UN_POSITION : UNION rValue : REAL; abyData : ARRAY[0..3] OF BYTE; END_UNION END_TYPE
实际项目中，我曾遇到因字节序问题导致的位置解析错误。后来通过添加以下校验代码解决了问题：
IF stMsg.abyData[0] = 0xA5 AND stMsg.abyData[7] = 0x5A THEN // 有效数据帧处理 ELSE iErrorCode := 16#8001; // 帧格式错误 END_IF