summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCoprDistGit <infra@openeuler.org>2023-06-20 08:16:24 +0000
committerCoprDistGit <infra@openeuler.org>2023-06-20 08:16:24 +0000
commit4c0114b932d814bd9aa9b072a440399e0e715624 (patch)
treef19594c0d5c3621f7f23d58727a88ab06f66db69
parent1215fb9b4f02c59aee73f2b4bc26c5811e29d81f (diff)
automatic import of python-hx711-multiopeneuler20.03
-rw-r--r--.gitignore1
-rw-r--r--python-hx711-multi.spec477
-rw-r--r--sources1
3 files changed, 479 insertions, 0 deletions
diff --git a/.gitignore b/.gitignore
index e69de29..8d5d05b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/hx711_multi-1.4.1.tar.gz
diff --git a/python-hx711-multi.spec b/python-hx711-multi.spec
new file mode 100644
index 0000000..212de01
--- /dev/null
+++ b/python-hx711-multi.spec
@@ -0,0 +1,477 @@
+%global _empty_manifest_terminate_build 0
+Name: python-hx711-multi
+Version: 1.4.1
+Release: 1
+Summary: HX711 class to sample 24-bit ADCs with Python 3 on a Raspberry Pi Rasperry Pi Zero, 2 or 3
+License: MIT License
+URL: https://github.com/Morrious/hx711-multi
+Source0: https://mirrors.aliyun.com/pypi/web/packages/58/9e/ad23a6eecd71d2e50c47d875dea52d4ab22f29f10aa9b31569f4d892955e/hx711_multi-1.4.1.tar.gz
+BuildArch: noarch
+
+
+%description
+# hx711-multi
+
+[![Publish to PyPI](https://github.com/morrious/hx711-multi/actions/workflows/python-publish.yml/badge.svg)](https://pypi.org/project/hx711-multi/) [![Downloads](https://pepy.tech/badge/hx711-multi)](https://pepy.tech/project/hx711-multi)
+
+HX711 class to sample a 24-bit ADC (or multiple) with Python 3 on a Rasperry Pi Zero, 3 or 4
+
+## Description
+
+This library allows the user to configure and read from one or multiple HX711 ADCs 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 ADC
+- Power up ADC
+- Zero ADC at start
+- Configure individual weight multiples for calibration of each scale to real-world weight
+- Read raw measurements from ADCs
+- Read weight measurements from ADCs
+
+**This package requires RPi.GPIO to be installed in Python 3.**
+
+## Hardware
+
+General HX711 documentation is included in Docs folder.
+
+The default sample rate of the HX711 is 10Hz, unless you wire the power to the RATE pin (15), at which point you can sample at 80Hz. I've included a picture of this wiring if desired. The SparkFun board includes a jumper option for this.
+
+[SparkFun Hookup Guide](https://learn.sparkfun.com/tutorials/load-cell-amplifier-hx711-breakout-hookup-guide) - great resource for understanding the wiring to your HX711
+
+[SparkFun Load Cells Guide](https://learn.sparkfun.com/tutorials/getting-started-with-load-cells) - great resource for understanding load cells
+
+## Getting started
+
+Install with `pip3 install hx711_multi`
+
+**Basic usage example:**
+
+_(also found at /tests/simple_read_test.py)_
+
+```python
+#!/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
+
+readings_to_average = 10
+sck_pin = 1
+dout_pins = [2, 3, 4, 14, 15]
+weight_multiples = [-5176, -5500, -5690, -5484, -5455]
+
+# create hx711 instance
+hx711 = HX711(dout_pins=dout_pins,
+ sck_pin=sck_pin,
+ channel_A_gain=128,
+ channel_select='A',
+ all_or_nothing=False,
+ log_level='CRITICAL')
+# reset ADC, zero it
+hx711.reset()
+try:
+ hx711.zero(readings_to_average=readings_to_average*3)
+except Exception as e:
+ print(e)
+# uncomment below loop to see raw 2's complement and read integers
+# for adc in hx711._adcs:
+# print(adc.raw_reads) # these are the 2's complemented values read bitwise from the hx711
+# print(adc.reads) # these are the raw values after being converted to signed integers
+hx711.set_weight_multiples(weight_multiples=weight_multiples)
+
+# read until keyboard interrupt
+try:
+ while True:
+ start = perf_counter()
+
+ # perform read operation, returns signed integer values as delta from zero()
+ # readings aare filtered for bad data and then averaged
+ raw_vals = hx711.read_raw(readings_to_average=readings_to_average)
+
+ # request weights using multiples set previously with set_weight_multiples()
+ # This function call will not perform a new measurement, it will just use what was acquired during read_raw()
+ weights = hx711.get_weight()
+
+ read_duration = perf_counter() - start
+ sample_rate = readings_to_average/read_duration
+ print('\nread duration: {:.3f} seconds, rate: {:.1f} Hz'.format(read_duration, sample_rate))
+ 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])
+ # uncomment below loop to see raw 2's complement and read integers
+ # for adc in hx711._adcs:
+ # print(adc.raw_reads) # these are the 2's complemented values read bitwise from the hx711
+ # print(adc.reads) # these are the raw values after being converted to signed integers
+except KeyboardInterrupt:
+ print('Keyboard interrupt..')
+except Exception as e:
+ print(e)
+
+# cleanup GPIO
+GPIO.cleanup()
+```
+
+**Calibration sequence**
+
+Each HX711 ADC needs to be calibrated separately in order to account for variance in raw measurements compared to real world weight. For example, the ADC may return a value of 5000 which corresponds to 1 gram. In this case, the weight multiple for this ADC should be set to 5000.
+
+Run the calibration sequence with known weights after initializing your HX711 object with the below command. Optional input for known weights included so that you can run through the process faster without needing to type in the weights throughout the sequence. If no known weights are input, it will prompt user before each measurement. This should only need to be performed once during hardware setup, or if the measurement environment changes (temperature, humidity, etc).
+
+_(full example can be found at /tests/calibrate.py)_
+
+```python
+weight_multiple = hx711.run_calibration(known_weights=[5, 10, 50, 100])
+print(f'Weight multiple = {weight_multiple}')
+```
+
+## Author
+
+- James Morris (https://james.pizza)
+
+## License
+
+- Free software: MIT license
+
+## Credits
+
+- Starting point: https://github.com/gandalf15/HX711/
+
+
+%package -n python3-hx711-multi
+Summary: HX711 class to sample 24-bit ADCs with Python 3 on a Raspberry Pi Rasperry Pi Zero, 2 or 3
+Provides: python-hx711-multi
+BuildRequires: python3-devel
+BuildRequires: python3-setuptools
+BuildRequires: python3-pip
+%description -n python3-hx711-multi
+# hx711-multi
+
+[![Publish to PyPI](https://github.com/morrious/hx711-multi/actions/workflows/python-publish.yml/badge.svg)](https://pypi.org/project/hx711-multi/) [![Downloads](https://pepy.tech/badge/hx711-multi)](https://pepy.tech/project/hx711-multi)
+
+HX711 class to sample a 24-bit ADC (or multiple) with Python 3 on a Rasperry Pi Zero, 3 or 4
+
+## Description
+
+This library allows the user to configure and read from one or multiple HX711 ADCs 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 ADC
+- Power up ADC
+- Zero ADC at start
+- Configure individual weight multiples for calibration of each scale to real-world weight
+- Read raw measurements from ADCs
+- Read weight measurements from ADCs
+
+**This package requires RPi.GPIO to be installed in Python 3.**
+
+## Hardware
+
+General HX711 documentation is included in Docs folder.
+
+The default sample rate of the HX711 is 10Hz, unless you wire the power to the RATE pin (15), at which point you can sample at 80Hz. I've included a picture of this wiring if desired. The SparkFun board includes a jumper option for this.
+
+[SparkFun Hookup Guide](https://learn.sparkfun.com/tutorials/load-cell-amplifier-hx711-breakout-hookup-guide) - great resource for understanding the wiring to your HX711
+
+[SparkFun Load Cells Guide](https://learn.sparkfun.com/tutorials/getting-started-with-load-cells) - great resource for understanding load cells
+
+## Getting started
+
+Install with `pip3 install hx711_multi`
+
+**Basic usage example:**
+
+_(also found at /tests/simple_read_test.py)_
+
+```python
+#!/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
+
+readings_to_average = 10
+sck_pin = 1
+dout_pins = [2, 3, 4, 14, 15]
+weight_multiples = [-5176, -5500, -5690, -5484, -5455]
+
+# create hx711 instance
+hx711 = HX711(dout_pins=dout_pins,
+ sck_pin=sck_pin,
+ channel_A_gain=128,
+ channel_select='A',
+ all_or_nothing=False,
+ log_level='CRITICAL')
+# reset ADC, zero it
+hx711.reset()
+try:
+ hx711.zero(readings_to_average=readings_to_average*3)
+except Exception as e:
+ print(e)
+# uncomment below loop to see raw 2's complement and read integers
+# for adc in hx711._adcs:
+# print(adc.raw_reads) # these are the 2's complemented values read bitwise from the hx711
+# print(adc.reads) # these are the raw values after being converted to signed integers
+hx711.set_weight_multiples(weight_multiples=weight_multiples)
+
+# read until keyboard interrupt
+try:
+ while True:
+ start = perf_counter()
+
+ # perform read operation, returns signed integer values as delta from zero()
+ # readings aare filtered for bad data and then averaged
+ raw_vals = hx711.read_raw(readings_to_average=readings_to_average)
+
+ # request weights using multiples set previously with set_weight_multiples()
+ # This function call will not perform a new measurement, it will just use what was acquired during read_raw()
+ weights = hx711.get_weight()
+
+ read_duration = perf_counter() - start
+ sample_rate = readings_to_average/read_duration
+ print('\nread duration: {:.3f} seconds, rate: {:.1f} Hz'.format(read_duration, sample_rate))
+ 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])
+ # uncomment below loop to see raw 2's complement and read integers
+ # for adc in hx711._adcs:
+ # print(adc.raw_reads) # these are the 2's complemented values read bitwise from the hx711
+ # print(adc.reads) # these are the raw values after being converted to signed integers
+except KeyboardInterrupt:
+ print('Keyboard interrupt..')
+except Exception as e:
+ print(e)
+
+# cleanup GPIO
+GPIO.cleanup()
+```
+
+**Calibration sequence**
+
+Each HX711 ADC needs to be calibrated separately in order to account for variance in raw measurements compared to real world weight. For example, the ADC may return a value of 5000 which corresponds to 1 gram. In this case, the weight multiple for this ADC should be set to 5000.
+
+Run the calibration sequence with known weights after initializing your HX711 object with the below command. Optional input for known weights included so that you can run through the process faster without needing to type in the weights throughout the sequence. If no known weights are input, it will prompt user before each measurement. This should only need to be performed once during hardware setup, or if the measurement environment changes (temperature, humidity, etc).
+
+_(full example can be found at /tests/calibrate.py)_
+
+```python
+weight_multiple = hx711.run_calibration(known_weights=[5, 10, 50, 100])
+print(f'Weight multiple = {weight_multiple}')
+```
+
+## Author
+
+- James Morris (https://james.pizza)
+
+## License
+
+- Free software: MIT license
+
+## Credits
+
+- Starting point: https://github.com/gandalf15/HX711/
+
+
+%package help
+Summary: Development documents and examples for hx711-multi
+Provides: python3-hx711-multi-doc
+%description help
+# hx711-multi
+
+[![Publish to PyPI](https://github.com/morrious/hx711-multi/actions/workflows/python-publish.yml/badge.svg)](https://pypi.org/project/hx711-multi/) [![Downloads](https://pepy.tech/badge/hx711-multi)](https://pepy.tech/project/hx711-multi)
+
+HX711 class to sample a 24-bit ADC (or multiple) with Python 3 on a Rasperry Pi Zero, 3 or 4
+
+## Description
+
+This library allows the user to configure and read from one or multiple HX711 ADCs 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 ADC
+- Power up ADC
+- Zero ADC at start
+- Configure individual weight multiples for calibration of each scale to real-world weight
+- Read raw measurements from ADCs
+- Read weight measurements from ADCs
+
+**This package requires RPi.GPIO to be installed in Python 3.**
+
+## Hardware
+
+General HX711 documentation is included in Docs folder.
+
+The default sample rate of the HX711 is 10Hz, unless you wire the power to the RATE pin (15), at which point you can sample at 80Hz. I've included a picture of this wiring if desired. The SparkFun board includes a jumper option for this.
+
+[SparkFun Hookup Guide](https://learn.sparkfun.com/tutorials/load-cell-amplifier-hx711-breakout-hookup-guide) - great resource for understanding the wiring to your HX711
+
+[SparkFun Load Cells Guide](https://learn.sparkfun.com/tutorials/getting-started-with-load-cells) - great resource for understanding load cells
+
+## Getting started
+
+Install with `pip3 install hx711_multi`
+
+**Basic usage example:**
+
+_(also found at /tests/simple_read_test.py)_
+
+```python
+#!/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
+
+readings_to_average = 10
+sck_pin = 1
+dout_pins = [2, 3, 4, 14, 15]
+weight_multiples = [-5176, -5500, -5690, -5484, -5455]
+
+# create hx711 instance
+hx711 = HX711(dout_pins=dout_pins,
+ sck_pin=sck_pin,
+ channel_A_gain=128,
+ channel_select='A',
+ all_or_nothing=False,
+ log_level='CRITICAL')
+# reset ADC, zero it
+hx711.reset()
+try:
+ hx711.zero(readings_to_average=readings_to_average*3)
+except Exception as e:
+ print(e)
+# uncomment below loop to see raw 2's complement and read integers
+# for adc in hx711._adcs:
+# print(adc.raw_reads) # these are the 2's complemented values read bitwise from the hx711
+# print(adc.reads) # these are the raw values after being converted to signed integers
+hx711.set_weight_multiples(weight_multiples=weight_multiples)
+
+# read until keyboard interrupt
+try:
+ while True:
+ start = perf_counter()
+
+ # perform read operation, returns signed integer values as delta from zero()
+ # readings aare filtered for bad data and then averaged
+ raw_vals = hx711.read_raw(readings_to_average=readings_to_average)
+
+ # request weights using multiples set previously with set_weight_multiples()
+ # This function call will not perform a new measurement, it will just use what was acquired during read_raw()
+ weights = hx711.get_weight()
+
+ read_duration = perf_counter() - start
+ sample_rate = readings_to_average/read_duration
+ print('\nread duration: {:.3f} seconds, rate: {:.1f} Hz'.format(read_duration, sample_rate))
+ 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])
+ # uncomment below loop to see raw 2's complement and read integers
+ # for adc in hx711._adcs:
+ # print(adc.raw_reads) # these are the 2's complemented values read bitwise from the hx711
+ # print(adc.reads) # these are the raw values after being converted to signed integers
+except KeyboardInterrupt:
+ print('Keyboard interrupt..')
+except Exception as e:
+ print(e)
+
+# cleanup GPIO
+GPIO.cleanup()
+```
+
+**Calibration sequence**
+
+Each HX711 ADC needs to be calibrated separately in order to account for variance in raw measurements compared to real world weight. For example, the ADC may return a value of 5000 which corresponds to 1 gram. In this case, the weight multiple for this ADC should be set to 5000.
+
+Run the calibration sequence with known weights after initializing your HX711 object with the below command. Optional input for known weights included so that you can run through the process faster without needing to type in the weights throughout the sequence. If no known weights are input, it will prompt user before each measurement. This should only need to be performed once during hardware setup, or if the measurement environment changes (temperature, humidity, etc).
+
+_(full example can be found at /tests/calibrate.py)_
+
+```python
+weight_multiple = hx711.run_calibration(known_weights=[5, 10, 50, 100])
+print(f'Weight multiple = {weight_multiple}')
+```
+
+## Author
+
+- James Morris (https://james.pizza)
+
+## License
+
+- Free software: MIT license
+
+## Credits
+
+- Starting point: https://github.com/gandalf15/HX711/
+
+
+%prep
+%autosetup -n hx711_multi-1.4.1
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+ find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+ find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+ find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+ find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+ find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-hx711-multi -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Tue Jun 20 2023 Python_Bot <Python_Bot@openeuler.org> - 1.4.1-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..55fe9c0
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+7f7d22dd7eb43fb178ccc061edd70d2d hx711_multi-1.4.1.tar.gz