C语言手动更新RP2400输出寄存器及Raspberry Pi Pico代码排障

问题描述 #

调试Raspberry Pi Pico时，尝试通过直接操作SIO模块的GPIO方向寄存器（GPIO_OE_SET、GPIO_OE_CLR）和输出寄存器（GPIO_OUT_SET、GPIO_OUT_CLR）编写自定义函数配置GPIO输出方向并控制电平，代码编译成功但GPIO无预期输出，询问是否遗漏关键步骤。

现有代码 #

寄存器定义与GPIO操作函数

#define SIO_BASE_P 0xd0000000
#define GPIO_IN_OFFSET 0x004
#define GPIO_OUT_OFFSET 0x010
#define GPIO_OUT_SET_OFFSET 0x014
#define GPIO_OUT_CLR_OFFSET 0x018
#define GPIO_OUT_XOR_OFFSET 0x01c
#define GPIO_OE_OFFSET 0x020
#define GPIO_OE_SET_OFFSET 0x024
#define GPIO_OE_CLR_OFFSET 0x028

void custom_set_gpio_dir(uint gpio, bool dir)
{
  uint32_t* gpio_oe_set_p = (uint32_t*)(SIO_BASE_P + GPIO_OE_SET_OFFSET);
  uint32_t* gpio_oe_clr_p = (uint32_t*)(SIO_BASE_P + GPIO_OE_CLR_OFFSET);
  if(dir)
   {
     (*gpio_oe_set_p) |= (1 << gpio);
   }
  else
  {
     (*gpio_oe_clr_p) |= (1 << gpio);
  }
}

void custom_set_gpio_output(uint gpio, bool out)
{
  uint32_t* gpio_out_set_p = (uint32_t*)(SIO_BASE_P + GPIO_OUT_SET_OFFSET);
  uint32_t* gpio_out_clr_p = (uint32_t*)(SIO_BASE_P + GPIO_OUT_CLR_OFFSET);
  if(out)
   {
     (*gpio_out_set_p) |= (1 << gpio);
   }
  else
   {
     (*gpio_out_clr_p) |= (1 << gpio);
   }
}

主函数

int main() 
{
  custom_set_gpio_dir(25, true);
  custom_set_gpio_output(25, true);
  while(true)
  {}
  return 0;
}

问题原因与解决方案 #

1. 遗漏GPIO功能配置为SIO模式 #

Raspberry Pi Pico的GPIO引脚默认并非SIO功能模式，必须先通过IO_BANK0模块的寄存器将目标GPIO配置为SIO功能，否则SIO模块的寄存器操作无法作用到物理引脚。

添加GPIO功能配置函数：

#define IO_BANK0_BASE 0x40014000
#define GPIO_CTRL_STEP 0x008  // 每个GPIO的CTRL寄存器间隔0x008，GPIO0对应0x000，GPIO1对应0x008，以此类推

void custom_set_gpio_function(uint gpio, uint func)
{
    uint32_t* gpio_ctrl_p = (uint32_t*)(IO_BANK0_BASE + GPIO_CTRL_STEP * gpio);
    // 清除原有FUNCSEL字段（bit0-4），设置为目标功能
    *gpio_ctrl_p = (*gpio_ctrl_p & ~0x1F) | func;
}

SIO功能对应的func值为5，需在main函数开头调用：

custom_set_gpio_function(25, 5);

2. 优化SET/CLR寄存器操作方式 #

SIO模块的SET/CLR寄存器特性是：写入1会触发对应位的置位/清零操作，写入0无影响。因此不需要使用|=，直接赋值(1 << gpio)即可，更符合寄存器设计逻辑：

void custom_set_gpio_dir(uint gpio, bool dir)
{
  uint32_t* gpio_oe_set_p = (uint32_t*)(SIO_BASE_P + GPIO_OE_SET_OFFSET);
  uint32_t* gpio_oe_clr_p = (uint32_t*)(SIO_BASE_P + GPIO_OE_CLR_OFFSET);
  if(dir)
   {
     *gpio_oe_set_p = (1 << gpio);  // 直接写入对应位，触发置位
   }
  else
  {
     *gpio_oe_clr_p = (1 << gpio);  // 直接写入对应位，触发清零
  }
}

void custom_set_gpio_output(uint gpio, bool out)
{
  uint32_t* gpio_out_set_p = (uint32_t*)(SIO_BASE_P + GPIO_OUT_SET_OFFSET);
  uint32_t* gpio_out_clr_p = (uint32_t*)(SIO_BASE_P + GPIO_OUT_CLR_OFFSET);
  if(out)
   {
     *gpio_out_set_p = (1 << gpio);
   }
  else
   {
     *gpio_out_clr_p = (1 << gpio);
   }
}

3. 可选：添加内存屏障确保指令执行顺序 #

嵌入式系统中，编译器可能会对寄存器操作进行重排序优化，添加内存屏障可以确保寄存器操作按预期顺序执行：
在寄存器操作后添加：

__asm__ volatile("" ::: "memory");

例如修改后的custom_set_gpio_dir：

void custom_set_gpio_dir(uint gpio, bool dir)
{
  uint32_t* gpio_oe_set_p = (uint32_t*)(SIO_BASE_P + GPIO_OE_SET_OFFSET);
  uint32_t* gpio_oe_clr_p = (uint32_t*)(SIO_BASE_P + GPIO_OE_CLR_OFFSET);
  if(dir)
   {
     *gpio_oe_set_p = (1 << gpio);
   }
  else
  {
     *gpio_oe_clr_p = (1 << gpio);
  }
  __asm__ volatile("" ::: "memory");
}

修改后的完整主函数 #

int main() 
{
  custom_set_gpio_function(25, 5);  // 先配置GPIO25为SIO功能
  custom_set_gpio_dir(25, true);
  custom_set_gpio_output(25, true);
  while(true)
  {}
  return 0;
}

内容的提问来源于stack exchange，提问作者Blam