HMC5883L 磁力计

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

# 示例配置条目
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 (Optional, int): 手动指定传感器的 I²C 地址。默认为 0x1E。
field_strength_x (Optional): X 轴方向的磁场强度，单位为微特斯拉。所有选项来自 Sensor。
field_strength_y (Optional): Y 轴方向的磁场强度，单位为微特斯拉。所有选项来自 Sensor。
field_strength_z (Optional): Z 轴方向的磁场强度，单位为微特斯拉。所有选项来自 Sensor。
heading (Optional): 传感器的航向，单位为度。所有选项来自 Sensor。
update_interval (Optional, Time): 检查传感器的间隔。默认为 60s。
oversampling (Optional): 每次采样平均的读数次数。可选值为 1x、2x、 4x、8x。默认为 1x。
range (Optional): 选择量程/增益预设。这不会影响发布值的比例，但允许以读取分辨率为代价避免溢出。支持的值为 88µT、130µT、190µT、 250µT、400µT、470µT、560µT、810µT。默认量程为 ±130µT。
id (Optional, ID): 手动指定用于代码生成的 ID。

过采样选项

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

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

量程选项

默认情况下，HMC5883L 传感器的测量范围为 130uT。但是，您可以配置此值。可能的值：

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

HMC5883L 磁力计

配置变量

过采样选项

量程选项

另见