QMC5883L 磁力计

qmc5883l 允许您在 ESPHome 中使用 QMC5883L 三轴磁力计（数据手册）。该传感器与 HMC5883L 传感器非常相似，经常作为其替代品出现。QMC5883L 传感器的性能与 HMC5883L 相当，但配置有所不同。要在您的配置中使该传感器正常工作，必须先设置好 I²C 总线。

# 示例配置条目
sensor:
  - platform: qmc5883l
    address: 0x0D
    field_strength_x:
      name: "QMC5883L Field Strength X"
    field_strength_y:
      name: "QMC5883L Field Strength Y"
    field_strength_z:
      name: "QMC5883L Field Strength Z"
    heading:
      name: "QMC5883L Heading"
    temperature:
      name: "QMC5883L Temperature"
      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 (可选, Time): 检查传感器的间隔。若要达到最高的数据率 200Hz，在配置 drdy_pin 时可以将其设为 0。默认为 60s。
id (可选, ID): 手动指定代码生成中使用的 ID。
drdy_pin (可选, Pin): 数据就绪引脚。使用较低的 update_interval 时，建议连接数据就绪引脚。
data_rate (可选, enum): 传感器的数据率参数。

数据率选项

默认情况下，QMC5883L 的数据率为 200Hz。您也可以对其进行配置。可选值如下：

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

NOTE

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

量程选项

默认情况下，QMC5883L 传感器的测量范围为 200µT。您也可以对其进行配置。可选值如下：

200µT（默认）
800µT

过采样选项

默认情况下，QMC5883L 传感器在请求新值时对每个值测量 512 次。您也可以对其进行配置。最终结果是传感器会取 x 次采样的平均值。可选的采样值如下：

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

QMC5883L 磁力计

配置变量

数据率选项

量程选项

过采样选项

参见