MLX90393 三轴磁力计

mlx90393 传感器平台允许您在 ESPHome 中使用 MLX90393 (数据手册, Adafruit) 三轴磁力计。使用此传感器需要在您的配置中设置 I²C。

# 示例配置条目
sensor:
  - platform: mlx90393
    id: mlx
    x_axis:
      name: "x"
    y_axis:
      name: "y"
    z_axis:
      name: "z"

配置变量

x_axis (可选): x 轴的信息。
- resolution (可选, 整数): 指定要读取完整 19 位值的哪一部分。默认为 DIV_4。必须是以下之一：
  - DIV_8
  - DIV_4
  - DIV_2
  - DIV_1
- 所有其他选项来自传感器。
y_axis (可选): y 轴的信息。
- resolution (可选, 整数): 指定要读取完整 19 位值的哪一部分。默认为 DIV_4。必须是以下之一：
  - DIV_8
  - DIV_4
  - DIV_2
  - DIV_1
- 所有其他选项来自传感器。
z_axis (可选): z 轴的信息。
- resolution (可选, 整数): 指定要读取完整 19 位值的哪一部分。默认为 DIV_4。必须是以下之一：
  - DIV_8
  - DIV_4
  - DIV_2
  - DIV_1
- 所有其他选项来自传感器。
temperature (可选): 内置温度传感器。
- oversampling (可选, 整数): 温度传感器的片上过采样。默认为 0。必须在 0 到 3 之间。
- 所有其他选项来自传感器。
drdy_pin (可选, 引脚方案): 数据就绪引脚。通常标记为 INT。使用此引脚可能会导致稍快的读取时间。
gain (可选, 整数): 设置模拟增益。默认为 1X。必须是以下之一
- 1X
- 1_25X
- 1_67X
- 2X
- 2_5X
- 3X
- 3_75X
- 5X
oversampling (可选, 整数): 片上过采样。默认为 2。必须在 0 到 3 之间。
filter (可选, 整数): 片上数字滤波器。默认为 6。必须在 0 到 7 之间。
temperature_compensation (可选, 布尔值): 片上温度补偿。默认为 false。启用时，不能使用分辨率选项 DIV_8 和 DIV_4。
hallconf (可选, 整数): 修改霍尔板旋转（2 相 vs 4 相）。默认为 0xC。必须是 0xC 或 0x0。
update_interval (可选, 时间): 检查传感器的时间间隔。默认为 60s。
address (可选, 整数): 手动指定传感器的 I²C 地址。默认为 0x0C。
i2c_id (可选, ID): 如果您想使用多个 I²C 总线，手动指定 I²C 组件的 ID。

增益、分辨率和满量程读数

默认情况下，传感器配置为最低灵敏度。这允许读取 50,000 µT 的磁场。然而，灵敏度限于 3 µT。使用 gain 和 resolution 选项可以显著改善这一点，代价是减少可测量的最大磁场。

传感器内部生成一个发送到放大器的模拟信号。 gain 选项控制此放大器。过多的放大将导致数值饱和，但不会整数溢出。

放大后，模拟信号使用 19 位 ADC 进行数字化。只有 16 位被发送到 ESPHome。resolution 选项选择发送哪些位。

分辨率选项及其向 ESPHome 报告的位。DIV_8 发送最高有效 16 位，而 DIV_1 发送最低有效位。

请注意，ADC 实际上不会填满其所有 19 位。这导致 DIV_4 与 DIV_8 具有相同的最大场强，同时提供更好的灵敏度。只有 DIV_2 和 DIV_1 实际使用所有值，赋予它们最佳的动态范围。然而，当超过最大场强时，两者都会导致整数溢出。

接收到 16 位值后，ESPHome 将其转换为 µT 为单位的浮点值。因此，gain 和 resolution 都不直接影响 ESPHome 中值的大小。

下表显示了每种组合的灵敏度和最大场强。请注意，由于硬件限制，Z 轴的灵敏度较差。

gain	resolution	灵敏度 XY (µT/LSB)	最大场强 XY (µT)	灵敏度 Z (µT/LSB)	最大场强 Z (µT)
1X	DIV_8	6.009	66,098	9.680	106,480
1X	DIV_4	3.004	66,098	4.840	106,480
1X	DIV_2	1.502	49,225	2.420	79,299
1X	DIV_1	0.751	24,612	1.210	39,649
1_25X	DIV_8	4.807	52,878	7.744	85,184
1_25X	DIV_4	2.404	52,878	3.872	85,184
1_25X	DIV_2	1.202	39,380	1.936	63,439
1_25X	DIV_1	0.601	19,690	0.968	31,719
1_67X	DIV_8	3.605	39,659	5.808	63,888
1_67X	DIV_4	1.803	39,659	2.904	63,888
1_67X	DIV_2	0.901	29,535	1.452	47,579
1_67X	DIV_1	0.451	14,767	0.726	23,790
2X	DIV_8	3.004	33,049	4.840	53,240
2X	DIV_4	1.502	33,049	2.420	53,240
2X	DIV_2	0.751	24,612	1.210	39,649
2X	DIV_1	0.376	12,306	0.605	19,825
2_5X	DIV_8	2.404	26,439	3.872	42,592
2_5X	DIV_4	1.202	26,439	1.936	42,592
2_5X	DIV_2	0.601	19,690	0.968	31,719
2_5X	DIV_1	0.300	9,845	0.484	15,860
3X	DIV_8	2.003	22,033	3.227	35,493
3X	DIV_4	1.001	22,033	1.613	35,493
3X	DIV_2	0.501	16,408	0.807	26,433
3X	DIV_1	0.250	8,204	0.403	13,216
3_75X	DIV_8	1.602	17,626	2.581	28,395
3_75X	DIV_4	0.801	17,626	1.291	28,395
3_75X	DIV_2	0.401	13,127	0.645	21,146
3_75X	DIV_1	0.200	6,563	0.323	10,573
5X	DIV_8	1.202	13,220	1.936	21,296
5X	DIV_4	0.601	13,220	0.968	21,296
5X	DIV_2	0.300	9,845	0.484	15,860
5X	DIV_1	0.150	4,922	0.242	7,930

对于 hallconf = 0x0，灵敏度按因子 98/75 缩放。例如，HALLCONF 0xC 下的 0.150μT/LSB 变为 HALLCONF 0x0 下的 0.196μT/LSB。最大场强也相应变化。

MLX90393 三轴磁力计

配置变量

增益、分辨率和满量程读数

另见