MLX90393 三轴磁强计

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

# Example configuration entry
sensor:
  - platform: mlx90393
    id: mlx
    x_axis:
      name: "x"
    y_axis:
      name: "y"
    z_axis:
      name: "z"

配置变量

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

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

默认情况下，传感器配置为最低灵敏度。这允许读取高达 50,000 µT 的磁场。然而，灵敏度限制为 3 µT。通过使用增益和分辨率选项可以显著改善这一点，代价是降低可测量的最大磁场。

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

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

分辨率选项以及它们向 ESPHome 报告哪些位。DIV_8 发送最高有效 16 位，而 DIV_1 发送最低有效位。

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

接收到 16 位值后，ESPHome 将其转换为以 µT 为单位的浮点值。因此，增益和分辨率均不直接影响 ESPHome 中值的幅度。

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

增益	分辨率	灵敏度 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 三轴磁强计

配置变量

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

参见