Raspberry Pi Pico SDK中RP2350B芯片的PIO GPIO等待指令问题解析

背景介绍

在Raspberry Pi Pico SDK项目中，开发者发现了一个与RP2350B芯片PIO(可编程IO)模块相关的重要问题。这个问题涉及到PIO汇编器(pioasm)对GPIO等待指令(wait gpio)的处理方式，特别是在使用高IO组(GPIO 32及以上)时的行为异常。

问题本质

RP2350B芯片的PIO模块有一个特性：当使用高IO组(GPIO 32及以上)时，需要通过设置gpio_offset寄存器来正确访问这些引脚。然而，现有的pioasm工具在处理wait gpio指令时存在以下问题：

1. 对于GPIO编号大于31的引脚，pioasm生成的指令编码不正确
2. 指令编码会溢出到源(source)字段，导致错误的指令类型
3. 运行时需要根据gpio_offset调整指令，但现有实现未正确处理

技术细节分析

根据RP2350B的数据手册，PIO的WAIT指令格式中，GPIO索引(Index)字段只有5位，最大只能表示31。这意味着：

• 对于GPIO 0-31，可以直接使用原始编号
• 对于GPIO 32及以上，需要减去32后再编码

现有的pioasm实现存在以下不足：

1. 虽然能解析高GPIO编号的指令(如wait gpio 34)
2. 但在生成机器码时，只是简单地对GPIO编号取低5位，导致错误编码
3. 没有考虑运行时gpio_offset的影响

解决方案

开发团队经过讨论后确定了以下解决方案：

1. 在pioasm工具中改进GPIO编号处理逻辑

   • 跟踪程序中使用的GPIO范围
   • 根据实际使用的GPIO范围决定是否需要进行偏移调整
   • 在输出阶段正确处理高GPIO编号的编码

2. 在运行时处理方面：

   • 通过pio_claim_free_sm_and_add_program_for_gpio_range函数确保程序加载到正确的PIO实例
   • 根据gpio_offset设置调整WAIT GPIO指令的编码

实际影响

这个问题对开发者有以下影响：

1. 使用高GPIO组的PIO程序可能无法按预期工作
2. 需要更新到修复后的SDK版本才能获得正确的行为
3. 在CircuitPython等基于Pico SDK的项目中也需要相应调整

开发者建议

对于使用RP2350B芯片的开发者，建议：

1. 更新到包含此修复的Pico SDK版本(2.1.1及以上)
2. 检查所有使用高GPIO编号的PIO程序
3. 如果遇到GPIO等待指令问题，可考虑暂时使用WAIT PIN指令替代

这个问题展示了嵌入式开发中硬件特性与软件工具链紧密配合的重要性，也提醒我们在使用新硬件特性时需要仔细验证工具链的支持情况。