跳转到内容
ESPHome - 让智能家居更简单2026.7.0

NAU7802 24 位 ADC

nau7802 传感器平台允许您在 ESPHome 中使用 NAU7802 ADC （数据手册、Adafruit）。此 ADC 通常与应变计配合使用，充当重量传感器。

NAU7802 扩展板。图片由 Adafruit 提供

连接电源引脚（VCC/GND）和 I2C（SDA/SCL）。如果使用外部参考电压，请连接（AV/AVDD）。不支持中断（INT/DRDY）。

# Example configuration entry
sensor:
  - platform: nau7802
    name: "NAU7802 Value"
    gain: 128
    ldo_voltage: "3.0V"
    update_interval: 60s

配置变量

Section titled “配置变量”

  • gain (可选，enum): ADC 增益。

    • 1
    • 2
    • 4
    • 8
    • 16
    • 32
    • 64
    • 128 （默认）

  • ldo_voltage (可选，enum): 用于参考的电压，应小于 VCC

    • 2.4V
    • 2.7V
    • 3.0V （默认）
    • 3.3V
    • 3.6V
    • 3.9V
    • 4.2V
    • 4.5V
    • External、Ext 如果您使用 AV/AVDD 引脚，请使用此选项

  • samples_per_second (可选，enum): 设置芯片内部采样率

    • 10 （默认）
    • 20
    • 40
    • 80
    • 320

  • offset_calibration (可选，int): 预先校准的偏移值，范围 -8388608 到 8388607

  • gain_calibration (可选，float): 预先校准的增益值，范围 0 到 511.9999998807907

  • update_interval (可选，Time): 检查传感器的间隔。默认为 60s。

  • 来自 Sensor 的其他所有选项。

校准

Section titled “校准”

NAU7802 包含 3 种类型的校准：内部偏移、外部偏移和外部增益。使用 内部校准应产生一致的偏移，因为它只使用参考电压进行校准。 外部校准使用传感器在当前状态下的读数。这意味着如果负载不一致 在校准操作执行时，您将得到不同校准之间的变化结果，并可能 在 ADC 上失去范围。

对于高精度应用，建议执行校准并存储 结果，在您的配置中使用 offset_calibration 和 gain_calibration 字段进行最终使用。 您可以在组件转储其配置时，或执行 校准操作时获取校准值。

转换单位

Section titled “转换单位”

NAU7802 不会直接将 ADC 值转换为重量，并且可以与不同类型的应变计配合使用， 因此您需要自己将测量值转换为单位。 要校准传感器：

.. 本节其余内容复制自 HX711 文档，因为流程基本相同

  1. 在传感器上放置零负载或已知质量，例如 0kg
  2. 等待数据到达日志并记下数值。例如 120。
  3. 在传感器上放置另一个（不同的）已知质量，例如 1kg
  4. 再次等待数据到达并记录数值，例如 810。

完成这些步骤后，您可以使用 calibrate_linear 过滤器将输入值 映射到校准值：

# Example configuration entry
sensor:
  - platform: nau7802
    # ... Other NAU7802 options
    filters:
      - calibrate_linear:
          - 120 -> 0
          - 810 -> 1
    unit_of_measurement: kg

用您的数值替换 120.0、810.0 等质量和数值。

参见

Section titled “参见”