HX711 Load Cell Amplifier

The hx711 sensor platform allows you to use your HX711 load cell amplifier (datasheet, SparkFun_) with ESPHome

Image
HX711 Load Cell Amplifier. Image by SparkFun_ licensed and re-distributed under CC BY 2.0.

Connect GND to GND , VCC to 3.3V and the other two DOUT (or DT for short) and CLK (or SCK ) to free GPIO pins.

# Example configuration entry
sensor:
  - platform: hx711
    name: "HX711 Value"
    dout_pin: D0
    clk_pin: D1
    gain: 128
    update_interval: 60s

Configuration variables:

  • dout_pin (Required, Pin Schema): The DOUT (or DAT) pin.

  • clk_pin (Required, Pin Schema): The CLK pin.

  • gain (Optional, enum): The gain. Implicitly selects the channel. Defaults to 128 .

    • 32 (Channel B, gain 32)
    • 64 (Channel A, gain 64)
    • 128 (Channel A, gain 128)
  • update_interval (Optional, Time): The interval to check the sensor. Defaults to 60s .

  • All other options from Sensor.

Converting Units

As the HX711 does not have any calibration data, you have to convert the measurement to units yourself. To calibrate the sensor:

  1. Place a zero load or a known mass on the sensor, for example 0kg
  2. Wait for the data to arrive in the logs and write down the value. For example 120 .
  3. Place another (different) known mass on the sensor, for example 1kg
  4. Again wait for the data to arrive and note the value, for example 810 .

Once you’ve done those steps, you can use the calibrate_linear filter to map the incoming value to the calibrated one:

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

Replace the masses and values 120.0 , 810.0 , etc with your values.

See Also