Metadata-Version: 2.1
Name: JoyIT-hx711py
Version: 0.1.1
Summary: Updated Python library for the HX711 load cell amplifier and Raspberry Pi 5
Home-page: https://github.com/joy-it/JoyIT_hx711py
Author: j-dohnalek
Author-email: service@joy-it.net
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# HX711PY
Updated Python library for the HX711 load cell amplifier and Raspberry Pi 5

## Installation
You can install this library from PyPI.
To install it for the current user on your Raspberry Pi, use the following command:
```
pip install JoyIT-hx711py
```

## Initial Calibration

1. Place nothing on the scale, run the calibration.py and record the output. That is the **offset**.
2. Place a known weight like 1kg(1000g) on the scale, record the output as **weight**.
3. Calculate the ratio
```
ratio = (w - offset) / 1000
```
*1000 being the 1000 grams or the weight previously placed on scale*

Edit the example.py file with the offset and ratio
```Python
def setup():
    """
    code run once
    """
    hx.set_offset(`Place offset here`)
    hx.set_scale(`Place ratio here`)
    hx.tare()
    pass
```

## Resources

Source code adapted from:<br>
https://gist.github.com/underdoeg/98a38b54f889fce2b237

Documentation adapted from:<br>
https://github.com/aguegu/ardulibs/tree/master/hx711

HX711 Datasheet (EN):<br>
http://image.dfrobot.com/image/data/SEN0160/hx711_english.pdf


