HMC5883L 磁强计

hmc5883l 允许您在 ESPHome 中使用 HMC5883L 三轴磁强计（数据手册， Adafruit）。此传感器需要在您的配置中设置 I²C 总线才能工作。

# Example configuration entry
sensor:
  - platform: hmc5883l
    address: 0x1E
    field_strength_x:
      name: "HMC5883L Field Strength X"
    field_strength_y:
      name: "HMC5883L Field Strength Y"
    field_strength_z:
      name: "HMC5883L Field Strength Z"
    heading:
      name: "HMC5883L Heading"
    oversampling: 1x
    range: 130uT
    update_interval: 60s

配置变量

address (可选，int): 手动指定传感器的 I²C 地址。默认为 0x1E。
field_strength_x (可选): X 轴方向的磁场强度，单位为微特斯拉。来自 Sensor 的所有选项。
field_strength_y (可选): Y 轴方向的磁场强度，单位为微特斯拉。来自 Sensor 的所有选项。
field_strength_z (可选): Z 轴方向的磁场强度，单位为微特斯拉。来自 Sensor 的所有选项。
heading (可选): 传感器的航向，单位为度。来自 Sensor 的所有选项。
update_interval (可选，Time): 检查传感器的间隔。默认为 60s。
oversampling (可选): 每次采样平均的读数次数。可选值为 1x、2x、 4x、8x。默认为 1x。
range (可选): 选择量程/增益预设。这不改变发布值的量纲，但可在牺牲读数分辨率的代价下避免溢出。支持的值为 88µT、130µT、190µT、 250µT、400µT、470µT、560µT、810µT。默认量程为 ±130µT。
id (可选，ID): 手动指定用于代码生成的 ID。

过采样选项

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

1x（默认）
2x
4x
8x

量程选项

默认情况下，HMC5883L 传感器的测量量程为 130uT。但您可以配置该值。可选值：

88uT
130uT（默认）
190uT
250uT
400uT
470uT
560uT
810uT

HMC5883L 磁强计

配置变量

过采样选项

量程选项

参见