📚 课程目录第4章开发环境搭建与第一个CAN节点

4. 开发环境搭建与第一个CAN节点

要让 PIC32 真正跑起 CAN 通信，第一步不是写业务代码，而是把“工具链—工程—硬件—调试通道”这条链路打通。本节以 PIC32MX795F512L（常见于 PIC32 以太网启动工具包，带双 CAN 模块）为例，走完从安装到回环测试的完整过程。所有参数均为教学示例，实际以所用器件数据手册和开发板原理图为准。

一、工具链的组成与安装顺序

PIC32 的开发环境由三部分构成：MPLAB X IDE 负责工程管理、编辑、下载与调试；XC32 编译器负责把 C 代码编译成 PIC32 的 MIPS 机器码；MPLAB Harmony（v3 及以后为 MCC 插件形式）负责外设驱动与中间件的图形化配置。安装顺序建议为：先装 MPLAB X IDE，再装 XC32，最后在 IDE 内通过 Tools → Plugins 安装 Harmony/MCC 插件。这样 IDE 能自动识别编译器路径，避免“找不到 xc32-gcc”的报错。

安装完成后需要验证：在 IDE 中新建一个 32 位工程，选择器件 PIC32MX795F512L，工具选择 Simulator，编译一个空 main 函数。若编译输出窗口出现 “BUILD SUCCESSFUL”，说明 XC32 已正确挂接。这一步看似多余，但能提前排除 90% 的环境问题。

二、用 Harmony 生成 CAN 外设初始化代码

Harmony 的核心价值是把寄存器级的初始化变成图形化配置。新建 Harmony 工程后，在 Project Graph 中依次添加 Harmony Core、CMSIS、Device Support，再添加 CAN 驱动模块。关键配置项如下（示例值）：

CAN 模块：CAN1，工作模式 Normal
波特率：500 kbps，系统时钟 80 MHz，CAN 时钟分频后为 40 MHz
位时间：Sync=1TQ，PropSeg=2TQ，PhaseSeg1=3TQ，PhaseSeg2=2TQ，SJW=1TQ，总计 8TQ
采样点：位于 6/8 = 75% 处，符合 CAN 推荐的 75%~87.5%
接收滤波器：Filter0 接收标准帧 ID 0x123，掩码 0x7FF
中断：接收中断使能，优先级 2

配置完成后点击 Generate Code，Harmony 会生成 system_config、drv_can 等目录。此时不要急着改生成文件，业务代码应写在 app.c 或自定义文件中，通过 DRV_CAN_Initialize() 等 API 调用驱动。

三、硬件连接：CAN 收发器与终端电阻

PIC32 的 C1TX/C1RX 是逻辑电平引脚，不能直接接 CAN_H/CAN_L，必须经过 CAN 收发器（如 MCP2551、ATA6561）。典型连接为：C1TX → 收发器 TXD，C1RX ← 收发器 RXD，收发器 VDD 接 5V 或 3.3V（视型号），CAN_H/CAN_L 接双绞线。总线两端各需一个 120 Ω 终端电阻，节点数少时可在开发板上直接焊接。

回环测试有两种方式：一是把 CAN 模块设为 Loopback 模式，TX 内部直接回连 RX，不需要外部收发器和总线；二是 Normal 模式下用一根双绞线把 CAN_H 与 CAN_L 短接到另一节点或自身收发器。前者用于验证驱动和中断，后者用于验证物理层。建议先做 Loopback，再做 Normal。

四、第一个 CAN 节点代码与回环验证

在 Harmony 生成的工程中，业务代码的核心是初始化、发送、接收三步。下面是一段基于 Harmony CAN 驱动的示例（仅示意 API 调用顺序，具体函数名以所用 Harmony 版本为准）：

#include "system_config.h"
#include "drv_can.h"

static DRV_CAN_HANDLE canHandle;

void APP_CAN_Init(void)
{
    DRV_CAN_Initialize(DRV_CAN_INDEX_1, &canHandle);
    DRV_CAN_SetOperationMode(canHandle, DRV_CAN_OPERATION_MODE_LOOPBACK);
}

void APP_CAN_SendTest(void)
{
    uint8_t txData[8] = {0x11,0x22,0x33,0x44,0x55,0x66,0x77,0x88};
    DRV_CAN_TxMessage txMsg;
    txMsg.id = 0x123;
    txMsg.idType = DRV_CAN_ID_TYPE_STANDARD;
    txMsg.dlc = 8;
    txMsg.data = txData;
    DRV_CAN_Transmit(canHandle, &txMsg);
}

void APP_CAN_RxCallback(DRV_CAN_RX_BUFFER *rxBuf)
{
    printf("RX ID=0x%03X DLC=%d Data=", rxBuf->id, rxBuf->dlc);
    for (int i = 0; i < rxBuf->dlc; i++)
        printf("%02X ", rxBuf->data[i]);
    printf("\r\n");
}

回环模式下，调用 APP_CAN_SendTest() 后，接收中断应被触发，串口打印出 RX ID=0x123 DLC=8 Data=11 22 33 44 55 66 77 88。若没有打印，按以下顺序排查：先确认 CAN 模块是否真正进入 Loopback 模式（读 CAN1CON 的 REQOP 位）；再确认接收滤波器是否放行 0x123；最后检查中断是否使能、向量是否注册。这三步能覆盖绝大多数“发得出去、收不回来”的问题。

五、串口打印调试的配置要点

串口是 CAN 调试的“眼睛”。在 Harmony 中添加 UART 模块，配置为 115200、8 数据位、无校验、1 停止位，并把 printf 重定向到 UART。XC32 下通常需要实现 _mon_putc() 或 write() 桩函数。注意：在中断回调里直接 printf 可能因阻塞影响实时性，建议只把数据存入环形缓冲区，在主循环中打印。

调试建议：先用 Loopback 验证驱动和中断，再切 Normal 模式接真实总线。切换模式时必须先让 CAN 模块进入 Configuration 模式，修改后再请求 Normal 模式，否则配置不生效。

常见坑：CAN 波特率与总线其他节点不一致会导致错误帧累积，最终进入 Bus-Off。用示波器观察 C1TX 引脚波形，测量位时间是否为 2 μs（500 kbps），可快速判断时钟配置是否正确。

完成以上步骤后，你手上就有了一个能自发自收、能打印报文的 CAN 节点。它虽然简单，但已经包含了后续所有 CAN 工程的最小闭环：工具链、驱动、物理层、调试通道。接下来无论是做多节点通信、CANopen 还是自定义协议，都可以在这个骨架上叠加。