Documentation

// HX711 Load Cell Amplifier - Arduino Example
// Library: "HX711" by Bogdan Necula (Arduino Library Manager)
// DT  -> Arduino Digital Pin 3
// SCK -> Arduino Digital Pin 2

#include "HX711.h"

const int DT_PIN  = 3;
const int SCK_PIN = 2;

HX711 scale;

void setup() {
  Serial.begin(9600);
  Serial.println("HX711 Load Cell Demo");

  scale.begin(DT_PIN, SCK_PIN);

  // Replace this with your own calibration factor
  // (see the "calibrate" section in the README of the HX711 library)
  scale.set_scale(420.0983);

  // Tare the scale so the current weight reads as zero
  scale.tare();
  Serial.println("Tare complete. Place an item on the scale.");
}

void loop() {
  if (scale.is_ready()) {
    float weight = scale.get_units(10);  // average of 10 readings
    Serial.print("Weight: ");
    Serial.print(weight, 2);
    Serial.println(" g");
  } else {
    Serial.println("HX711 not ready. Check wiring.");
  }
  delay(500);
}

#!/usr/bin/env python3
# HX711 Load Cell Amplifier - Raspberry Pi Example
# Install: pip3 install hx711
# DT  -> GPIO 5  (physical pin 29)
# SCK -> GPIO 6  (physical pin 31)

import RPi.GPIO as GPIO
import time
from hx711 import HX711

GPIO.setmode(GPIO.BCM)

DT_PIN  = 5
SCK_PIN = 6

hx = HX711(dout_pin=DT_PIN, pd_sck_pin=SCK_PIN)

# Reset and tare
hx.reset()
hx.zero(readings=30)

# Replace with your calibrated scale factor (raw_value / known_weight_in_grams)
SCALE_FACTOR = 102.372
hx.set_scale_ratio(SCALE_FACTOR)

print("HX711 Load Cell Demo")
print("Place an item on the scale. Press Ctrl+C to quit.")

try:
    while True:
        weight = hx.get_weight_mean(readings=10)
        print("Weight: {:.2f} g".format(weight))
        time.sleep(0.5)
except (KeyboardInterrupt, SystemExit):
    print("\nStopped by user")
finally:
    GPIO.cleanup()

# HX711 Load Cell Amplifier - Pico MicroPython Example
# Library: hx711.py by endail (copy to your Pico as hx711.py)
# DT  -> GP14 (physical pin 19)
# SCK -> GP15 (physical pin 20)

from machine import Pin
from hx711 import hx711
import time

DT_PIN  = Pin(14, Pin.IN, pull=Pin.PULL_DOWN)
SCK_PIN = Pin(15, Pin.OUT)

scale = hx711(SCK_PIN, DT_PIN)
scale.set_gain(128)

# Tare: read current zero point
print("Taring...")
tare = 0
for _ in range(20):
    tare += scale.read()
    time.sleep_ms(50)
tare //= 20
print("Tare value:", tare)

# Replace with your calibrated scale factor
SCALE_FACTOR = 420.0

print("HX711 Load Cell Demo")
print("Place an item on the scale.")

while True:
    raw = scale.read()
    weight_g = (raw - tare) / SCALE_FACTOR
    print("Weight: {:.2f} g".format(weight_g))
    time.sleep_ms(500)

# HX711 Load Cell Amplifier - ESP32 MicroPython Example
# Library: hx711.py by SergeyPiskunov (copy to your ESP32 as hx711.py)
# DT  -> GPIO 4
# SCK -> GPIO 5

from machine import Pin
from hx711 import HX711
import time

DT_PIN  = Pin(4, Pin.IN, pull=Pin.PULL_DOWN)
SCK_PIN = Pin(5, Pin.OUT)

hx = HX711(d_out=4, pd_sck=5)
hx.set_gain(128)

# Tare
print("Taring...")
tare = 0
for _ in range(20):
    tare += hx.read()
    time.sleep_ms(50)
tare //= 20
print("Tare value:", tare)

SCALE_FACTOR = 420.0

print("HX711 Load Cell Demo")
print("Place an item on the scale.")

while True:
    raw = hx.read()
    weight_g = (raw - tare) / SCALE_FACTOR
    print("Weight: {:.2f} g".format(weight_g))
    time.sleep_ms(500)