BMM150｜Arduino UNO R3 I2C 测试

// Arduino UNO R3 / Arduino AVR Boards 1.8.8 / DFRobot_BMM150
// Verification: compiled for arduino:avr:uno; hardware validation confirmed by project owner.
#include <Wire.h>
#include "DFRobot_BMM150.h"

/*
 * BMM150 + Arduino UNO R3
 *
 * 接线：
 * BMM150 VCC -> UNO 3.3V
 * BMM150 GND -> UNO GND
 * BMM150 SDA -> UNO A4
 * BMM150 SCL -> UNO A5
 *
 * I2C 地址：
 * 0x13 = I2C_ADDRESS_4
 */

// BMM150 I2C 地址 0x13
DFRobot_BMM150_I2C bmm150(&Wire, I2C_ADDRESS_4);

// 最多初始化尝试次数
const uint8_t INIT_MAX_RETRIES = 5;

// 记录传感器是否初始化成功
bool sensorReady = false;

void setup()
{
  Serial.begin(115200);

  // Arduino UNO R3 的 I2C：
  // SDA = A4
  // SCL = A5
  Wire.begin();

  delay(100);

  Serial.println();
  Serial.println("BMM150 Test Start");
  Serial.println("I2C Address: 0x13");

  // 有限次数初始化，避免传感器断开时永久卡死
  for (uint8_t attempt = 1; attempt <= INIT_MAX_RETRIES; attempt++)
  {
    Serial.print("BMM150 init attempt ");
    Serial.print(attempt);
    Serial.print("/");
    Serial.println(INIT_MAX_RETRIES);

    // DFRobot_BMM150：begin() 返回 0 表示成功
    if (bmm150.begin() == 0)
    {
      sensorReady = true;
      break;
    }

    Serial.println("BMM150 init failed!");
    delay(1000);
  }

  // 初始化失败后，不继续配置，也不读取传感器
  if (!sensorReady)
  {
    Serial.println();
    Serial.println("ERROR: BMM150 initialization failed.");
    Serial.println("Check VCC, GND, SDA=A4, SCL=A5 and I2C address 0x13.");
    return;
  }

  Serial.println("BMM150 init OK");

  // 正常连续测量模式
  bmm150.setOperationMode(BMM150_POWERMODE_NORMAL);

  // 高精度预设
  bmm150.setPresetMode(BMM150_PRESETMODE_HIGHACCURACY);

  /*
   * Bosch BMM150 高精度预设推荐 ODR 为 20Hz。
   *
   * 高精度预设使用较高的 X/Y、Z 重复测量次数，
   * 完成一次测量所需时间决定了最大有效数据率约为 20Hz。
   *
   * 因此这里不使用 30Hz，以保持高精度预设的正确组合。
   */
  bmm150.setRate(BMM150_DATA_RATE_20HZ);

  // 开启 X、Y、Z 三轴测量
  bmm150.setMeasurementXYZ();

  Serial.print("Configured data rate: ");
  Serial.print(bmm150.getRate());
  Serial.println(" Hz");

  Serial.println("High-accuracy mode enabled");
  Serial.println("Start measuring...");
  Serial.println();
}

void loop()
{
  // 初始化失败时禁止访问未初始化的传感器
  if (!sensorReady)
  {
    delay(1000);
    return;
  }

  // 读取三轴磁场数据，库返回单位为 uT
  sBmm150MagData_t magData = bmm150.getGeomagneticData();

  Serial.print("X = ");
  Serial.print(magData.x);

  Serial.print(" uT   Y = ");
  Serial.print(magData.y);

  Serial.print(" uT   Z = ");
  Serial.print(magData.z);

  Serial.println(" uT");

  // 网页测试要求：每 500ms 输出一次
  delay(500);
}