📚 课程目录第2章寄存器映射与位操作封装

2. 寄存器映射与位操作封装

任务目标

在嵌入式开发中，直接通过地址操作寄存器会导致代码可读性差、可移植性低。本案例以STM32F103的GPIOA外设为例，定义寄存器映射结构体，封装位操作宏，实现对外设寄存器的安全访问。

寄存器映射结构体定义

将外设寄存器按地址连续排列的特点，定义为C结构体，基地址通过宏定义，访问时通过结构体指针操作，编译器自动计算偏移量。

/* gpio_reg.h */
#ifndef GPIO_REG_H
#define GPIO_REG_H

#include <stdint.h>

/* STM32F103 GPIOA 基地址 */
#define GPIOA_BASE_ADDR   0x40010800UL

/* GPIO寄存器映射结构体 */
typedef struct {
    volatile uint32_t CRL;    /* 0x00 端口配置低寄存器 */
    volatile uint32_t CRH;    /* 0x04 端口配置高寄存器 */
    volatile uint32_t IDR;    /* 0x08 输入数据寄存器 */
    volatile uint32_t ODR;    /* 0x0C 输出数据寄存器 */
    volatile uint32_t BSRR;   /* 0x10 置位/复位寄存器 */
    volatile uint32_t BRR;    /* 0x14 复位寄存器 */
    volatile uint32_t LCKR;   /* 0x18 配置锁定寄存器 */
} GPIO_RegDef_t;

/* 将基地址转换为结构体指针 */
#define GPIOA              ((GPIO_RegDef_t *)GPIOA_BASE_ADDR)

#endif /* GPIO_REG_H */

位操作封装

使用宏封装常用的位操作，避免直接书写位运算表达式。每个宏都包含参数类型检查，防止误用。

/* gpio_bit.h */
#ifndef GPIO_BIT_H
#define GPIO_BIT_H

#include "gpio_reg.h"

/* 置位指定引脚（使用BSRR寄存器，原子操作） */
#define GPIO_SET_PIN(gpio, pin)    ((gpio)->BSRR = (1UL << (pin)))

/* 复位指定引脚（使用BRR寄存器，原子操作） */
#define GPIO_RESET_PIN(gpio, pin)  ((gpio)->BRR = (1UL << (pin)))

/* 读取指定引脚电平 */
#define GPIO_READ_PIN(gpio, pin)   (((gpio)->IDR >> (pin)) & 0x01UL)

/* 读取整个端口输入值 */
#define GPIO_READ_PORT(gpio)       ((gpio)->IDR)

/* 写整个端口输出值 */
#define GPIO_WRITE_PORT(gpio, val) ((gpio)->ODR = (val))

/* 配置引脚模式：mode=0x0输入，0x1输出10MHz，0x2输出2MHz，0x3输出50MHz */
/* cn=0x0推挽，0x1开漏，0x2复用推挽，0x3复用开漏 */
#define GPIO_CONFIG_PIN(gpio, pin, mode, cn) \
    do { \
        uint32_t pos = (pin) << 2; \
        uint32_t mask = 0xFUL << pos; \
        uint32_t val = (((cn) << 2) | (mode)) << pos; \
        if ((pin) < 8) { \
            (gpio)->CRL = ((gpio)->CRL & ~mask) | val; \
        } else { \
            (gpio)->CRH = ((gpio)->CRH & ~mask) | (val << 0); \
        } \
    } while(0)

#endif /* GPIO_BIT_H */

应用示例

以下代码演示如何使用上述封装操作GPIOA的Pin0和Pin1：

/* main.c */
#include "gpio_bit.h"

void GPIOA_Init(void) {
    /* 配置PA0为推挽输出50MHz，PA1为浮空输入 */
    GPIO_CONFIG_PIN(GPIOA, 0, 0x3, 0x0);   /* PA0 推挽输出 */
    GPIO_CONFIG_PIN(GPIOA, 1, 0x0, 0x0);   /* PA1 输入模式 */
}

void GPIOA_Demo(void) {
    GPIOA_Init();
    
    /* 置位PA0，输出高电平 */
    GPIO_SET_PIN(GPIOA, 0);
    
    /* 读取PA1输入电平 */
    uint8_t pa1_level = GPIO_READ_PIN(GPIOA, 1);
    
    /* 复位PA0，输出低电平 */
    GPIO_RESET_PIN(GPIOA, 0);
    
    /* 读取整个端口输入值 */
    uint32_t port_val = GPIO_READ_PORT(GPIOA);
    
    /* 写整个端口输出值 */
    GPIO_WRITE_PORT(GPIOA, 0x0001);
}

编译与验证

环境依赖：需要ARM交叉编译工具链（如arm-none-eabi-gcc）或Keil MDK。若在主机上验证语法正确性，可使用gcc加-fsyntax-only参数。

# 主机语法检查（不生成目标文件）
gcc -fsyntax-only -mcpu=cortex-m3 -mthumb gpio_reg.h gpio_bit.h main.c

# ARM交叉编译（生成目标文件）
arm-none-eabi-gcc -c -mcpu=cortex-m3 -mthumb main.c -o main.o

验证方法：

编译无错误无警告，说明结构体定义和宏展开语法正确。
在调试器中查看编译后生成的汇编代码，确认GPIO_SET_PIN(GPIOA, 0)被展开为对地址0x40010810（BSRR寄存器）的写操作。
检查GPIO_CONFIG_PIN宏展开后，CRL/CRH寄存器操作地址正确（PA0对应CRL的bit0~3，PA8对应CRH的bit0~3）。

通过条件：编译通过且生成的汇编指令中，寄存器操作地址与STM32F103参考手册中GPIOA各寄存器偏移地址一致（CRL=0x00，CRH=0x04，IDR=0x08，ODR=0x0C，BSRR=0x10，BRR=0x14）。

可移植性说明

更换MCU平台时，只需修改GPIOA_BASE_ADDR宏和寄存器结构体定义，应用层代码（使用GPIO_SET_PIN等宏的代码）无需改动。若新平台寄存器布局不同，仅需调整结构体成员顺序和位宽。