Adafruit BNO08x库与Pico RP2040（PlatformIO）适配故障求助

一、先做硬件排查 #

• 确认供电：BNO08x是3.3V器件，必须接RP2040的3.3V引脚，严禁接5V，否则会烧毁模块。
• 检查接线：GND必须共地，SDA/SCL对应连接到RP2040的I2C引脚，确保连线无虚焊、松动。
• 确认I2C地址：BNO08x默认地址为0x4A，若模块的ADDR引脚接3.3V，地址会变为0x4B，后续代码要对应修改。

二、修改I2C引脚定义（Arduino/Earphilhower框架通用） #

RP2040有两个I2C硬件端口（I2C0、I2C1），默认引脚如下：

• I2C0：SDA=GP0，SCL=GP1
• I2C1：SDA=GP2，SCL=GP3

如果你的接线不是默认引脚，需要手动指定SDA/SCL引脚，代码示例如下：

#include <Adafruit_BNO08x.h>
#include <Wire.h>

#define BNO08X_RESET -1 // 若未接RESET引脚则设为-1

Adafruit_BNO08x  bno08x(BNO08X_RESET);
sh2_SensorValue_t sensorValue;

void setup(void) {
  Serial.begin(115200);
  while (!Serial) delay(10); // 等待串口打开

  Serial.println("Adafruit BNO08x test!");

  // 示例：使用I2C1端口，指定SDA=GP6，SCL=GP7
  Wire1.setSDA(6); // 设置SDA引脚
  Wire1.setSCL(7); // 设置SCL引脚
  Wire1.begin();   // 初始化I2C端口

  // 初始化BNO08x，传入I2C地址和Wire对象
  // 地址根据模块ADDR引脚状态选0x4A或0x4B
  if (!bno08x.begin_I2C(0x4A, &Wire1)) {
    Serial.println("Failed to find BNO08x chip");
    while (1) { delay(10); }
  }
  Serial.println("BNO08x Found!"); 
}

void loop() {
  // 后续传感器读取代码
}

如果使用I2C0端口，把Wire1换成Wire即可：

Wire.setSDA(0);
Wire.setSCL(1);
Wire.begin();
if (!bno08x.begin_I2C(0x4A, &Wire)) { ... }

三、用I2C扫描工具确认设备地址 #

如果还是连接失败，先运行I2C扫描程序，确认RP2040能检测到BNO08x：

#include <Wire.h>

void setup() {
  Serial.begin(115200);
  while (!Serial); // 等待串口打开

  // 对应你使用的I2C端口和引脚
  Wire1.setSDA(6);
  Wire1.setSCL(7);
  Wire1.begin();

  Serial.println("\nI2C Scanner");
}

void loop() {
  byte error, address;
  int nDevices;
  Serial.println("Scanning...");
  nDevices = 0;

  for(address = 1; address < 127; address++ ) {
    Wire1.beginTransmission(address);
    error = Wire1.endTransmission();

    if (error == 0) {
      Serial.print("I2C device found at address 0x");
      if (address < 16) Serial.print("0");
      Serial.print(address, HEX);
      Serial.println(" !");
      nDevices++;
    } else if (error == 4) {
      Serial.print("Unknown error at address 0x");
      if (address < 16) Serial.print("0");
      Serial.println(address, HEX);
    }    
  }

  if (nDevices == 0) {
    Serial.println("No I2C devices found\n");
  } else {
    Serial.println("done\n");
  }
  delay(5000);
}

• 如果扫描不到设备，回到硬件排查步骤，重点检查供电、接线、模块是否损坏。
• 如果扫描到地址，把代码中的地址改成扫描到的数值。

四、额外排查步骤 #

• 复位模块：若BNO08x未正常启动，可给RESET引脚一个低电平脉冲（比如接GP5，代码中拉低10ms再拉高），修改BNO08X_RESET为对应引脚号即可。
• 更新库：确保Adafruit BNO08x库和Adafruit Unified Sensor库是最新版本，避免兼容性问题。

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