4. CANopenNode移植到STM32：移植步骤概览、硬件抽象层（HAL）适配、定时器与系统时钟配置、CAN接收发送回调函数实现

好，咱们进入实战环节。前面几章把NMT状态机的理论讲透了，但理论终归要落到代码上。这一章，我带你走一遍CANopenNode移植到STM32的全过程。

说实话，我第一次移植CANopenNode的时候，也踩了不少坑。文档写得不算差，但真正动手时，你会发现那些“显而易见”的细节，往往最要命。咱们今天就把这些细节掰开揉碎了讲。

4.1 移植步骤概览：先看全局，再动手

移植CANopenNode到STM32，我习惯分成5大步。你按这个顺序走，基本不会乱。

步骤	任务	关键文件/模块
1	获取源码并建立工程	CANopenNode源码、STM32CubeMX工程
2	适配硬件抽象层（HAL）	CO_driver.h、CO_driver_target.h
3	配置定时器与系统时钟	定时器中断、SysTick或TIM
4	实现CAN接收发送回调	CO_CANmodule.c、CAN中断服务函数
5	集成NMT状态机并测试	CO_NMT_Heartbeat.c、主循环调用

嗯，这里要特别提醒你：步骤2和步骤4是移植成败的关键。很多新手在HAL层随便改改，结果CAN收发死活不通，最后查出来是寄存器配置错了位。

4.2 硬件抽象层（HAL）适配：填好这些“坑”

CANopenNode的硬件抽象层，说白了就是一组宏定义和函数声明。你打开CO_driver_target.h，会看到一堆#define和typedef。你的任务就是把这些“占位符”换成STM32的真实值。

4.2.1 数据类型重定义

STM32是32位MCU，但CANopenNode为了跨平台，用了标准类型。你需要确保这些类型映射正确：

// CO_driver_target.h 中的典型配置
#define CO_UINT8    uint8_t
#define CO_UINT16   uint16_t
#define CO_UINT32   uint32_t
#define CO_INT8     int8_t
#define CO_INT16    int16_t
#define CO_INT32    int32_t

// 关键：定义CAN帧结构体
typedef struct {
    uint32_t id;           // CAN标识符
    uint8_t  dlc;          // 数据长度
    uint8_t  data[8];      // 数据
    uint8_t  rtr;          // 远程帧标志
    uint8_t  xtd;          // 扩展帧标志
} CO_CANtx_t;

typedef struct {
    uint32_t id;
    uint8_t  dlc;
    uint8_t  data[8];
    uint8_t  rtr;
    uint8_t  xtd;
} CO_CANrx_t;

我在项目中遇到过一个问题：有人把CO_CANtx_t里的data数组定义成uint16_t，结果CAN发送的数据全是乱的。这种低级错误，排查起来特别费时间。所以，类型定义一定要和CAN硬件寄存器对齐。

4.2.2 临界区保护

CANopenNode在访问共享资源（比如CAN发送缓冲区）时，需要关中断来保护临界区。STM32的临界区实现很简单：

// 进入临界区
#define CO_LOCK_CAN_SEND()      __disable_irq()
// 退出临界区
#define CO_UNLOCK_CAN_SEND()    __enable_irq()

但要注意：如果你的系统里还有其他中断（比如定时器），关中断时间不能太长。我一般控制在10微秒以内，否则会影响系统实时性。

4.3 定时器与系统时钟配置：心跳的节奏

CANopenNode需要一个1ms的定时器作为系统心跳。这个心跳用于NMT状态机的时间管理、心跳报文的发送、以及SYNC报文的同步。

我习惯用STM32的基本定时器TIM6或TIM7来做这件事。为什么？因为它们最简单，没有复杂的输入输出通道，纯粹就是一个定时中断。

4.3.1 定时器初始化

假设你的系统时钟是72MHz，定时器预分频设为72-1，自动重装载设为1000-1，这样中断频率就是1kHz：

void TIM6_Init(void) {
    RCC->APB1ENR |= RCC_APB1ENR_TIM6EN;   // 使能TIM6时钟
    TIM6->PSC = 72 - 1;                    // 预分频：72MHz / 72 = 1MHz
    TIM6->ARR = 1000 - 1;                  // 自动重装载：1MHz / 1000 = 1kHz
    TIM6->DIER |= TIM_DIER_UIE;            // 使能更新中断
    TIM6->CR1 |= TIM_CR1_CEN;              // 启动定时器
    NVIC_EnableIRQ(TIM6_DAC_IRQn);         // 使能NVIC中断
}

4.3.2 中断服务函数

在中断里，你需要调用CANopenNode的时间处理函数：

void TIM6_DAC_IRQHandler(void) {
    if (TIM6->SR & TIM_SR_UIF) {
        TIM6->SR = ~TIM_SR_UIF;            // 清除中断标志
        CO_TMR_Task();                      // CANopenNode定时器任务
    }
}

这里有个细节：CO_TMR_Task()的执行时间不能超过1ms，否则下一次中断来了，上一次还没处理完。我实测过，在STM32F103上，这个函数执行时间大约在10-20微秒，完全没问题。但如果你用的是更复杂的MCU，或者开启了大量对象字典，最好用示波器量一下。

4.4 CAN接收发送回调函数实现：打通数据通道

CAN收发是CANopenNode的“手脚”。没有它们，协议栈就是个空壳。CANopenNode通过回调函数来驱动CAN硬件，你需要实现两个核心函数：CO_CANsend()和CO_CANinterrupt()。

4.4.1 CAN发送回调

当协议栈需要发送CAN帧时，它会调用CO_CANsend()。你的任务就是把帧数据写入STM32的CAN发送邮箱：

CO_ReturnError_t CO_CANsend(CO_CANmodule_t *CANmodule, CO_CANtx_t *buffer) {
    CAN_TxHeaderTypeDef txHeader;
    uint32_t txMailbox;

    // 填充CAN发送头
    txHeader.StdId = buffer->id;
    txHeader.ExtId = 0;
    txHeader.IDE = buffer->xtd ? CAN_ID_EXT : CAN_ID_STD;
    txHeader.RTR = buffer->rtr ? CAN_RTR_REMOTE : CAN_RTR_DATA;
    txHeader.DLC = buffer->dlc;
    txHeader.TransmitGlobalTime = DISABLE;

    // 发送到CAN硬件
    if (HAL_CAN_AddTxMessage(&hcan, &txHeader, buffer->data, &txMailbox) != HAL_OK) {
        return CO_ERROR_TX_BUSY;  // 发送失败，返回忙状态
    }

    return CO_ERROR_NO;
}

这里要注意：HAL_CAN_AddTxMessage()如果返回HAL_BUSY，说明三个发送邮箱都满了。CANopenNode会重试，但如果你发现频繁返回CO_ERROR_TX_BUSY，说明总线负载太高，需要优化报文发送频率。

4.4.2 CAN接收中断

接收更关键。CANopenNode在接收中断里处理所有入站报文，包括NMT命令、SDO请求、PDO数据等。实现如下：

void HAL_CAN_RxFifo0MsgPendingCallback(CAN_HandleTypeDef *hcan) {
    CAN_RxHeaderTypeDef rxHeader;
    uint8_t rxData[8];

    if (HAL_CAN_GetRxMessage(hcan, CAN_RX_FIFO0, &rxHeader, rxData) != HAL_OK) {
        return;  // 读取失败，直接返回
    }

    // 构造CANopenNode接收结构体
    CO_CANrx_t rxMsg;
    rxMsg.id = rxHeader.StdId;
    rxMsg.dlc = rxHeader.DLC;
    rxMsg.rtr = (rxHeader.RTR == CAN_RTR_REMOTE) ? 1 : 0;
    rxMsg.xtd = (rxHeader.IDE == CAN_ID_EXT) ? 1 : 0;
    memcpy(rxMsg.data, rxData, 8);

    // 交给协议栈处理
    CO_CANinterrupt(&CANmodule, &rxMsg);
}

嗯，这里有个容易忽略的点：中断优先级。CAN接收中断的优先级应该高于定时器中断，但低于系统错误中断（比如HardFault）。我一般把CAN接收中断设为优先级1，定时器设为优先级2，这样既能保证CAN报文不丢失，又不会影响系统心跳。

4.5 移植架构总览：一张图看懂

说了这么多，咱们用一张SVG图把整个移植架构串起来。你对照这张图，就能清楚每个模块的位置和关系。

4.6 移植后的验证清单

移植完成后，别急着往下走。我建议你按这个清单逐项验证：

1. CAN收发测试：用CAN分析仪发一个标准数据帧，看STM32能否正确接收并触发中断。
2. 定时器精度测试：用示波器测量一个GPIO引脚，在定时器中断里翻转，确认周期是否为1ms。
3. NMT状态切换测试：发送NMT启动命令（0x01 0x00），观察从站是否进入Operational状态。
4. 心跳报文测试：配置心跳生产者时间，用CAN分析仪捕获心跳报文，确认周期和内容正确。
5. 临界区测试：在高负载下（比如同时收发大量PDO），检查系统是否出现死锁或数据错乱。