QMC5883L 磁力计

qmc5883l 允许您在 ESPHome 中使用 QMC5883L 三轴磁力计 (数据手册)。此传感器与 HMC5883L 传感器非常相似，常作为替代品出现。QMC5883L 传感器的性能与 HMC5883L 传感器相当，但配置有所不同。需要在配置中设置 I²C 总线才能使此传感器工作。

# 示例配置条目
sensor:
  - platform: qmc5883l
    address: 0x0D
    field_strength_x:
      name: "QMC5883L 磁场强度 X"
    field_strength_y:
      name: "QMC5883L 磁场强度 Y"
    field_strength_z:
      name: "QMC5883L 磁场强度 Z"
    heading:
      name: "QMC5883L 方位角"
    temperature:
      name: "QMC5883L 温度"
      filters:
        - offset: 34.0
    range: 200uT
    oversampling: 512x
    update_interval: 60s
    data_rate: 200Hz
    drdy_pin: GPIOXX

配置变量

address (可选, int): 手动指定传感器的 I²c 地址。默认为 0x0D。
field_strength_x (可选): X 轴方向的磁场强度（微特斯拉）。来自 Sensor 的所有选项。
field_strength_y (可选): Y 轴方向的磁场强度（微特斯拉）。来自 Sensor 的所有选项。
field_strength_z (可选): Z 轴方向的磁场强度（微特斯拉）。来自 Sensor 的所有选项。
heading (可选): 传感器的方位角（度）。来自 Sensor 的所有选项。
temperature (可选): 传感器的温度。根据数据手册： “温度传感器增益已在工厂校准，但其偏移未补偿，只有相对温度值是准确的”。上面的示例有一个您需要校准的偏移量。来自 Sensor 的所有选项。
range (可选, enum): 传感器的范围参数。
oversampling (可选, enum): 传感器的过采样参数。
update_interval (可选, 时间): 检查传感器的时间间隔。要达到 200Hz 的最高数据率，当配置了 drdy_pin 时可将其设置为零。默认为 60s。
id (可选, ID): 手动指定用于代码生成的 ID。
drdy_pin (可选, 引脚): 数据就绪引脚。当使用低 update_interval 时建议连接数据就绪引脚。
data_rate (可选, enum): 传感器的数据率参数。

数据率选项

默认情况下，QMC5883L 数据率为 200Hz。但是，您可以配置此数量。可能的值：

200Hz（默认）
100Hz
50Hz
10Hz

NOTE

要达到最大数据率，请配置 drdy_pin 并将 update_interval 设置为零。

范围选项

默认情况下，QMC5883L 传感器测量范围为 200µT。但是，您可以配置此数量。可能的值：

200µT（默认）
800µT

过采样选项

默认情况下，QMC5883L 传感器在请求新值时测量每个值 512 次。但是，您可以配置此数量。结果是传感器将取 x 个样本的平均值。可能的采样值：

512x（默认）
256x
128x
64x

QMC5883L 磁力计

配置变量

数据率选项

范围选项

过采样选项

另见