Skip to content

A c++ driver and a node binding for the HX711 Load Cell Amp

License

Notifications You must be signed in to change notification settings

aqmattil/opencushion

 
 

Repository files navigation

C Driver and Node Binding for HX711 Load Cell Amp

This is a small fork of @dangrie/hx711 to use newer g++ version. The original code didn't compile with newer compilers causing some issues with other packages. This is very much untested.

Prerequisities

  • g++-4.9 node-gyp needs to compile with g++ v4.9 due to the version of v8 node uses since some versions. However raspian comes with v4.6 preinstalled. Install it via sudo apt-get install g++-4.9
  • 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.

About

A c++ driver and a node binding for the HX711 Load Cell Amp

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 96.7%
  • Python 2.5%
  • JavaScript 0.8%