esphome/tests/components/mlx90393/test.esp32-c3-idf.yaml
functionpointer 6f16365b2f [mlx90393] Fix inverted gain and resolution, change default values
The old gain options were copied from the arduino-MLX90393 library. However, the library actually does the opposite thing from the sensor hardware. Low hardware gain settings are multiplied with large numbers, while high gains are multiplied with small numbers. This is done in order to get consistent readings in µT independent of gain setting.

This is confusing from the user's perspective. The user configures the sensor, not the library.
Therefore, this PR inverts (actually 5/x) all gain settings. This reflects the analog gain used inside the sensor.

Furthermore, the resolution options are named more appropriately. The resolution is always 16 bit, we just choose which 16 bits we get.

Additionally, the default values are changed. The old defaults offered high sensitivity, but caused integer overflows in strong magnetic fields. This easily happened when a neodymium magnet was held within a few cm of the sensor.
The new default configuration prevents all integer overflows and can deal with strong fields easily.
Higher sensitivity must now be explicitly configured by the user. The new documentation informs about integer overflows, mitigating the risk of false readings that existed previously.

Finally, this commit exposes the already existing `hallconf` and `temperature_compensation` options.
2024-10-19 18:21:09 +02:00

23 lines
392 B
YAML

i2c:
- id: i2c_mlx90393
scl: 5
sda: 4
sensor:
- platform: mlx90393
oversampling: 1
filter: 0
gain: 1X
temperature_compensation: true
x_axis:
name: mlxxaxis
resolution: DIV_2
y_axis:
name: mlxyaxis
resolution: DIV_1
z_axis:
name: mlxzaxis
resolution: DIV_2
temperature:
name: mlxtemp
oversampling: 2