📚 课程目录第4章开发环境搭建

4. 开发环境搭建

GPIO，说白了就是芯片最基础的“手脚”。你要让LED亮，得靠它；你要读按键状态，也得靠它。但R-Car这种级别的SoC，GPIO可不是简单写个0或1就完事了——它背后挂着一堆寄存器、中断控制器、电气特性配置。

我个人习惯，做HAL封装的第一步，永远是先把寄存器映射搞清楚。寄存器映射错了，后面全是白搭。

4.1 寄存器映射：先找到“门牌号”

R-Car的GPIO模块，每个端口（Port）都有一组固定的寄存器偏移。以R-Car H3为例，GPIO基地址通常在0xE605_0000附近（具体要看芯片手册）。

我一般会在头文件里这样定义：

/* GPIO寄存器偏移量 */
#define GPIO_INDT      0x00    /* 输入数据寄存器 */
#define GPIO_OUTDT     0x04    /* 输出数据寄存器 */
#define GPIO_OUTDT_CLR 0x08    /* 输出清零寄存器 */
#define GPIO_OUTDT_SET 0x0C    /* 输出置位寄存器 */
#define GPIO_INTDT     0x10    /* 中断状态寄存器 */
#define GPIO_INTCLR    0x14    /* 中断清除寄存器 */
#define GPIO_INTMSK    0x18    /* 中断屏蔽寄存器 */
#define GPIO_INTMSK_CLR 0x1C   /* 中断屏蔽清除 */
#define GPIO_INTMSK_SET 0x20   /* 中断屏蔽置位 */
#define GPIO_INTCFG    0x24    /* 中断触发配置 */
#define GPIO_IOSEL     0x28    /* 输入/输出选择 */
#define GPIO_PUD       0x2C    /* 上下拉控制 */

嗯，这里要注意：R-Car的GPIO寄存器设计很“体贴”，专门提供了SET和CLR寄存器。你写OUTDT_SET寄存器，只把对应位置1，其他位不受影响。这在多任务环境下特别有用——不用先读再改写了。

核心原则：HAL层只暴露逻辑端口号（如GPIO_PORT_07），内部通过查表映射到物理基地址和偏移。上层代码永远不要直接碰寄存器地址。

4.2 输出控制：让引脚听话

输出控制其实就两件事：设置方向、写电平。但R-Car的方向控制是通过IOSEL寄存器实现的，不是简单的“1输出0输入”。

我封装出来的API长这样：

/* 设置GPIO为输出模式 */
void HAL_GPIO_SetOutput(uint32_t port, uint32_t pin)
{
    uint32_t reg_val;
    reg_val = REG_READ32(GPIO_BASE(port) + GPIO_IOSEL);
    reg_val |= (1 << pin);   /* 1 = 输出 */
    REG_WRITE32(GPIO_BASE(port) + GPIO_IOSEL, reg_val);
}

/* 写高电平 */
void HAL_GPIO_WriteHigh(uint32_t port, uint32_t pin)
{
    REG_WRITE32(GPIO_BASE(port) + GPIO_OUTDT_SET, (1 << pin));
}

/* 写低电平 */
void HAL_GPIO_WriteLow(uint32_t port, uint32_t pin)
{
    REG_WRITE32(GPIO_BASE(port) + GPIO_OUTDT_CLR, (1 << pin));
}

你看，写高用SET寄存器，写低用CLR寄存器。这样写的好处是：如果两个任务同时操作同一个端口的不同引脚，不会互相干扰。

小技巧：我在项目中遇到过一种情况——用OUTDT寄存器直接写值，结果一个任务把另一个任务刚设好的引脚电平给冲掉了。改用SET/CLR后，问题再没出现过。

4.3 输入读取：别被毛刺骗了

读输入看起来简单——读INDT寄存器就行。但实际项目中，机械按键、外部信号都可能带毛刺。

我建议HAL层至少提供两种读法：

读取方式	实现	适用场景
直接读取	读INDT寄存器，返回当前电平	快速状态判断、电平触发
去抖读取	连续采样N次，取稳定值	按键、开关等机械触点

/* 直接读取 */
uint8_t HAL_GPIO_ReadPin(uint32_t port, uint32_t pin)
{
    uint32_t reg_val = REG_READ32(GPIO_BASE(port) + GPIO_INDT);
    return (reg_val >> pin) & 0x01;
}

/* 去抖读取：连续采样5次，3次以上相同才返回 */
uint8_t HAL_GPIO_ReadDebounced(uint32_t port, uint32_t pin)
{
    uint8_t cnt_high = 0;
    for (int i = 0; i < 5; i++) {
        if (HAL_GPIO_ReadPin(port, pin)) cnt_high++;
        HAL_DelayUs(200);  /* 每次间隔200微秒 */
    }
    return (cnt_high >= 3) ? 1 : 0;
}

你想想看，如果不做去抖，一个按键按下去，CPU可能读到3~5次跳变。我曾经在一个车载项目中，就是因为没做去抖，导致一次按键触发了三次功能切换——用户投诉说“按一下跳三下”。

4.4 中断配置：别让CPU空转

GPIO中断是嵌入式系统的“灵魂”。R-Car的GPIO中断支持多种触发方式：

上升沿触发：电平从低变高时触发
下降沿触发：电平从高变低时触发
双边沿触发：任何变化都触发
高电平触发：持续高电平时触发
低电平触发：持续低电平时触发

配置中断的步骤，我总结为“四步走”：

设置触发方式：写INTCFG寄存器
清除挂起状态：写INTCLR寄存器，确保初始状态干净
使能中断：写INTMSK_CLR寄存器，取消屏蔽
注册中断服务函数：挂接到GIC（通用中断控制器）

void HAL_GPIO_EnableInterrupt(uint32_t port, uint32_t pin, 
                               uint8_t trigger_mode)
{
    uint32_t reg_val;
    
    /* 第一步：配置触发方式 */
    reg_val = REG_READ32(GPIO_BASE(port) + GPIO_INTCFG);
    reg_val &= ~(0x03 << (pin * 2));  /* 清除该引脚配置 */
    reg_val |= (trigger_mode & 0x03) << (pin * 2);
    REG_WRITE32(GPIO_BASE(port) + GPIO_INTCFG, reg_val);
    
    /* 第二步：清除可能的挂起状态 */
    REG_WRITE32(GPIO_BASE(port) + GPIO_INTCLR, (1 << pin));
    
    /* 第三步：取消屏蔽 */
    REG_WRITE32(GPIO_BASE(port) + GPIO_INTMSK_CLR, (1 << pin));
    
    /* 第四步：注册中断（由芯片级HAL完成） */
    HAL_GIC_RegisterIRQ(GPIO_IRQ_BASE + port, GPIO_IRQ_Handler);
}

注意：中断服务函数里一定要先清除中断标志（写INTCLR），再处理业务逻辑。否则可能陷入“刚处理完又触发”的死循环。我见过有同事把顺序搞反了，结果中断里一直清不掉标志，CPU直接卡死。

4.5 上下拉控制：别让引脚“悬空”

引脚悬空（floating）是嵌入式开发的“隐形杀手”。输入引脚如果不接上下拉，电平会随机跳变，导致误触发、功耗异常。

R-Car的PUD寄存器控制上下拉：

PUD[2:0]值	功能	说明
000	无上下拉	高阻态，用于输出引脚
001	上拉（Pull-Up）	默认高电平，用于按键、开漏总线
010	下拉（Pull-Down）	默认低电平，用于特定传感器
011~111	保留	不要使用

void HAL_GPIO_SetPull(uint32_t port, uint32_t pin, uint8_t pull_mode)
{
    uint32_t reg_val;
    uint32_t shift = pin * 3;  /* 每个引脚占3位 */
    
    reg_val = REG_READ32(GPIO_BASE(port) + GPIO_PUD);
    reg_val &= ~(0x07 << shift);  /* 清除该引脚配置 */
    reg_val |= (pull_mode & 0x07) << shift;
    REG_WRITE32(GPIO_BASE(port) + GPIO_PUD, pull_mode);
}

经验之谈：做输出引脚时，记得把上下拉设成“无”（000）。我曾经接手过一个项目，输出引脚设了上拉，结果输出低电平时，引脚实际电压是0.8V——外部设备死活不认。查了两天才发现是上下拉没关。

4.6 整体架构：一张图看懂

下面这张图，是我做GPIO HAL封装时的核心思路。你一看就明白：

你看，从应用层到底层硬件，一共四层。每一层只跟相邻层打交道——这就是HAL的核心思想：隔离变化。

4.7 避坑指南：我踩过的那些坑

做GPIO驱动这么多年，有些坑我印象特别深：

寄存器位宽搞错：R-Car有些GPIO寄存器是32位，有些是16位。我刚开始用16位读32位寄存器，高位数据全丢了。
中断优先级没配：GPIO中断默认优先级可能很低。如果你在中断里调用了等待高优先级任务的服务，直接死锁。
上下拉与输出模式冲突：输出模式下设了上拉，输出低电平时会有额外功耗。我见过一个产品因此待机电流超标。
忘记清中断标志：这个前面说过，但值得再说一遍——不清标志，中断反复触发，CPU根本跑不了其他任务。

终极建议：写GPIO HAL时，每个API函数开头都做参数合法性检查。端口号超范围？引脚号超范围？直接返回错误码。别等到运行时崩了再查——那会儿你连崩在哪都不知道。

好了，GPIO的HAL封装就聊到这儿。你把这些东西吃透了，后面做I2C、SPI、UART的HAL，思路都是一样的——寄存器映射、操作封装、中断处理、电气配置，万变不离其宗。