hx711
v0.3.0
Published
C Driver and Node Binding for HX711 Load Cell Amp
Downloads
13
Readme
C Driver and Node Binding for HX711 Load Cell Amp
Prerequisities
g++-4.8
node-gyp needs to compile with g++ v4.8 due to the version of v8 node uses since some versions. However raspian comes with v4.6 preinstalled. Install it viasudo apt-get install g++-4.8
WiringPi
for the native GPIO handling this libary uses WiringPi. Install it using the instructions on the Website.
API
This library exposes a class with Name HX711
that gives you access to all functions you need to interface.
Constructor(Number clockPin, Number dataPin)
const sensor = new HX711(clockPin, dataPin);
create a new Sensor instance. The pin Numbers should represent the WiringPi Pins the Sensor is connected to. You can have as many HX711 Chips connected as long as they all are connected to a different set of pins.
read()
sensor.read();
Read the raw value as returned from the Sensor. You normally don't call this Method directly, but you may find it useful so I exported it.
getUnits([Number times = 10])
let units = sensor.getUnits();
Read the sensor times
times and calculate the average. This returns a scaled value with the offset removed.
tare([Number times = 10])
sensor.tare();
Read the sensor times
times and save the average Offset via setOffset()
.
setOffset([Number offset = 0])
sensor.setOffset(-1000);
set or reset the offset for the sensor
getOffset()
let offset = sensor.getOffset();
get the current offset of the sensor
setScale([Number scale = 1.0])
sensor.setScale(3543.26);
set or reset the scale for the sensor
getScale()
let scale = sensor.getScale();
get the current scale of the sensor
Troubleshooting
It sometimes can happen that the HX711 chip gets in a state where it does not recover itself. This can result in an endless loop while the library waits for the chip to notify a new data set.
If you ever run in a problem where the library does not give you new values, just power cycle the sensor.