树莓派3B+迁移时RF24库与C代码编译问题排查

错误本质 #

链接器报错的gpioSetISRFunc、gpioInitialise是pigpio库的核心函数，说明你的编译/链接流程中缺少对pigpio库的引用，或者RF24库编译时依赖的GPIO驱动配置不匹配。

排查&解决步骤 #

• 1. 先修改Makefile，补充pigpio库链接
  把你的链接命令补充-lpigpio参数，修改后如下：

  g++ -Wall -o pimain Server_HomeAutomation.o -I. -I/usr/local/include/RF24 -L/usr/local/lib -lrf24 -lpigpio
  

  这是最直接的临时修复，先验证是否能解决链接错误。

• 2. 确认RF24库编译时的驱动配置正确
  新版RF24库需要明确指定GPIO驱动，重新编译安装RF24时，根据需求选择对应的cmake参数：

  • 若用pigpio驱动（推荐，对树莓派3B+兼容性更好）：

    cd RF24
    rm -rf build && mkdir build && cd build
    cmake -D RF24_DRIVER=pigpio ..
    make && sudo make install
    

  • 若用bcm2835驱动：
    先确保已安装bcm2835库，再执行：

    cmake -D RF24_DRIVER=bcm2835 ..
    make && sudo make install
    

  注意：SPIDEV模式仅负责SPI通信，GPIO中断仍依赖pigpio或bcm2835库，不能单独用SPIDEV解决GPIO符号问题。

• 3. 检查系统是否正确安装pigpio库
  执行以下命令安装或确认：

  sudo apt update && sudo apt install pigpio
  # 验证库文件存在
  ls /usr/lib/arm-linux-gnueabihf/libpigpio.so
  

• 4. 适配新版RF24的初始化代码
  新版RF24已废弃旧的引脚宏和SPI速度宏，建议改用更简洁的初始化方式，避免手动定义宏：

  #include <RF24/RF24.h>
  
  // 物理引脚22对应BCM编号25，CS0对应SPI片选0
  RF24 radio(25, 0);
  
  int main() {
      if (!radio.begin()) {
          // 初始化失败处理
          return 1;
      }
      // 设置8Mbps数据速率（对应原8MHz SPI速度的需求）
      radio.setDataRate(RF24_8MBPS);
      // 其他初始化逻辑...
  }
  

• 5. 清理旧安装残留
  如果之前安装过不同版本的RF24，先清理残留：

  cd RF24/build
  sudo make uninstall
  rm -rf build
  

  再重新执行编译安装流程，确保cmake输出中显示"Found pigpio"或"Found bcm2835"的检测信息。

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