GRBL移植实战（一）：从AVR到ARM的引脚映射与平台适配
1. GRBL移植前的准备工作
第一次接触GRBL移植的朋友可能会觉得无从下手，毕竟要把一个成熟的运动控制系统从AVR平台搬到ARM架构上，听起来就像是要把一辆老爷车的发动机装进新能源车里。但别担心，我去年刚完成了一个从Atmega328p到STM32F407的移植项目，这里分享下我的实战经验。
首先得搞清楚GRBL到底依赖哪些硬件资源。打开cpu_map.h文件，你会发现它主要定义了三大类引脚：运动控制引脚（步进电机驱动）、限位开关引脚和主轴控制引脚。AVR架构下这些引脚都是直接映射到具体端口位的，比如X轴步进信号对应PD2引脚。但在ARM平台上，我们需要重新理解这些定义的本质。
举个例子，在AVR的cpu_map.h里你会看到这样的定义：
#define X_STEP_BIT 2 // Uno Digital Pin 2 #define STEP_PORT PORTD这表示X轴步进信号使用PORTD的第2位。移植到STM32时，我们得先确定用哪个GPIO端口。我建议在开发板上找一个完整的端口（比如GPIOA）来统一管理步进信号，这样后续操作会更方便。
2. ARM平台引脚映射实战
2.1 理解ARM的GPIO架构
STM32的GPIO配置可比AVR复杂多了。AVR的DDRx和PORTx寄存器在STM32里变成了GPIOx_MODER、GPIOx_ODR等一系列寄存器。不过别被吓到，实际操作起来反而更灵活。
以步进电机控制为例，在STM32F4上我们可以这样定义：
// 使用GPIOE端口统一管理步进信号 #define STEP_GPIO_PORT GPIOE #define X_STEP_PIN GPIO_PIN_2 #define Y_STEP_PIN GPIO_PIN_3 #define Z_STEP_PIN GPIO_PIN_4记得在初始化代码中配置GPIO模式：
GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = X_STEP_PIN | Y_STEP_PIN | Z_STEP_PIN; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(STEP_GPIO_PORT, &GPIO_InitStruct);2.2 中断系统的适配
GRBL对实时性要求极高，特别是限位开关检测需要快速响应。AVR用的是Pin Change中断，而STM32则使用EXTI中断系统。这里有个坑我踩过：STM32的EXTI中断线是共享的，比如PE2和PA2都使用EXTI2中断线。
配置限位开关中断时要注意：
// 配置X轴限位开关(PE5) GPIO_InitStruct.Pin = GPIO_PIN_5; GPIO_InitStruct.Mode = GPIO_MODE_IT_RISING; // 上升沿触发 HAL_GPIO_Init(GPIOE, &GPIO_InitStruct); // 设置中断优先级 HAL_NVIC_SetPriority(EXTI9_5_IRQn, 0, 0); HAL_NVIC_EnableIRQ(EXTI9_5_IRQn);中断服务函数里记得清除标志位：
void EXTI9_5_IRQHandler(void) { if(__HAL_GPIO_EXTI_GET_IT(GPIO_PIN_5) != RESET) { // 处理限位触发 __HAL_GPIO_EXTI_CLEAR_IT(GPIO_PIN_5); } }3. 定时器系统的重构
3.1 步进脉冲生成原理
GRBL使用AVR的定时器比较匹配中断来生成精确的步进脉冲。在STM32上，我们可以利用高级定时器（如TIM1）来实现同样的功能。关键是要理解GRBL的步进脉冲时序：
- 脉冲宽度通常为1-10μs
- 脉冲间隔决定运动速度
- 需要严格同步多个轴的脉冲
在STM32F4上配置TIM1：
TIM_HandleTypeDef htim1; htim1.Instance = TIM1; htim1.Init.Prescaler = 84-1; // 1MHz计数频率 htim1.Init.CounterMode = TIM_COUNTERMODE_UP; htim1.Init.Period = 1000-1; // 初始1kHz频率 htim1.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; HAL_TIM_Base_Init(&htim1); // 配置PWM模式 TIM_OC_InitTypeDef sConfigOC; sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 5; // 5μs脉冲宽度 sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(&htim1, &sConfigOC, TIM_CHANNEL_1);3.2 系统时钟的调整
AVR版的GRBL依赖16MHz系统时钟，而STM32通常运行在更高的频率（如168MHz）。这会影响以下几个关键部分：
- 串口波特率计算
- 定时器预分频设置
- 延时函数的实现
建议在system.h中定义系统时钟频率：
#define F_CPU 168000000UL然后修改delay.c中的延时函数：
void delay_us(uint32_t us) { uint32_t start = DWT->CYCCNT; uint32_t cycles = us * (SystemCoreClock / 1000000); while((DWT->CYCCNT - start) < cycles); }4. 工程框架搭建技巧
4.1 目录结构规划
不要直接把AVR的代码复制到ARM工程里，我建议这样组织目录：
/grbl_arm /Core /Inc cpu_map.h grbl_config.h /Src main.c /Drivers /STM32F4xx_HAL_Driver /Middlewares /grbl /avr // 保留原始AVR代码 /arm // ARM平台适配代码4.2 关键文件修改清单
- cpu_map.h：完全重写引脚定义
- nuts_bolts.h：修改数据类型定义（ARM是32位架构）
- serial.h：重写串口驱动接口
- system.h：调整系统时钟相关定义
特别注意数据类型的变化：
// 原AVR定义 typedef uint8_t uint8_t; typedef int8_t int8_t; // ARM平台建议修改为 #include <stdint.h>移植过程中最耗时的部分其实是调试步进电机驱动。我建议先用逻辑分析仪抓取AVR板的输出波形，然后在ARM板上尽量复现相同的时序。第一次成功让电机转动时的成就感，绝对值得这些折腾。