Skip to main content

hx711-multi

HX711 class to sample 24-bit ADCs with Python 3 on a Raspberry Pi Rasperry Pi Zero, 2 or 3

Description

This library allows to configure and read from one or multiple HX711 load cells with a Raspberry Pi. It was developed and tested in Python 3.8 on Raspberry Pi 4B with Raspberry Pi OS Lite v5.10.

Capabilities:

  • Configure Raspberry Pi digital pins for reading measurements
  • Configure Raspberry Pi SCK pin, or clock pin, used for configuring channel and triggering measurements
  • Configure Channel (A | B)
  • Configure Channel A Gain (128 | 64)
  • Power down load cell
  • Power up load cell
  • Zero load cell at start
  • Configure individual weight multiples for calibration of each scale to real-world weight
  • Read raw measurements from load cells
  • Read weight measurements from load cells

This package requires RPi.GPIO to be installed in Python 3.

Hardware

Documentation is included in Docs folder. Default rate of HX711 is 10Hz, unless you wire the digital power (DVDD) to the RATE pin (15), at which point you can sample at 80Hz. I've included a picture of this wiring if desired.

Getting started

Install with pip3 install hx711_multi

Basic usage example:

#!/usr/bin/env python3

from hx711_multi import HX711
from time import perf_counter
import RPi.GPIO as GPIO  # import GPIO

#init GPIO (should be done outside HX711 module in case you are using other GPIO functionality)
GPIO.setmode(GPIO.BCM)  # set GPIO pin mode to BCM numbering

dout_pins = [13,21,16,26,19]
sck_pin = 20
weight_multiples = [4489.80, 4458.90, 4392.80, 1, -5177.15]

hx711 = HX711(dout_pins=dout_pins, sck_pin=sck_pin, all_or_nothing=False, log_level='CRITICAL')  # create an object
hx711.reset()
hx711.zero()
hx711.set_weight_multiples(weight_multiples=weight_multiples)

# read until keyboard interrupt
try:
    while True:
        start = perf_counter()
        raw_vals = hx711.read_raw(readings_to_average=10)
        weights = hx711.read_weight(use_prev_read=True)
        read_duration = perf_counter() - start
        print('\nread duration: {:.3f} seconds'.format(read_duration))
        print('raw', ['{:.3f}'.format(x) if x is not None else None for x in raw_vals])
        print(' wt', ['{:.3f}'.format(x) if x is not None else None for x in weights])
except KeyboardInterrupt:
    print('Keyboard interrupt..')
except Exception as e:
    print(e)

# cleanup GPIO
GPIO.cleanup()

Author

License

  • Free software: MIT license

Credits

Metadata

Release files for hx711-multi 1.0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hx711-multi 1.0.5
File Size Uploaded Provenance
hx711_multi-1.0.5.tar.gz 10.8 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for hx711-multi 1.0.5
File Interpreter ABI Platform
hx711_multi-1.0.5-py3-none-any.whl Python 3 none any Details

Total release size: 20.8 kB

Release files / hx711_multi-1.0.5.tar.gz

Download URL hx711_multi-1.0.5.tar.gz
Size 10.8 kB
Tags Source
SHA-256 checksum
How to use checksums
a3eae774a3fabb5c9263be3675abef8cde019a40793cf8540ac6175cdcee8d06
BLAKE2b-256 checksum
How to use checksums
d0b5cb9a9bbc1f1a848e63674ec5db6c4f99a7bb7f8263fcd749c05daebe5151
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.8.10

Release files / hx711_multi-1.0.5-py3-none-any.whl

Download URL hx711_multi-1.0.5-py3-none-any.whl
Size 10.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c93ee854956c78c9b16940ea350dadd34b38a787689b748312026ba7a2698045
BLAKE2b-256 checksum
How to use checksums
e66b908cdc2066a520419bfb3ae69786f8eb2de71dc38026cba66cdf56539cf4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.8.10

Security for hx711-multi 1.0.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page