nanoFramework.Iot.Device.Hx711
1.1.595
Prefix Reserved
See the version list below for details.
dotnet add package nanoFramework.Iot.Device.Hx711 --version 1.1.595
NuGet\Install-Package nanoFramework.Iot.Device.Hx711 -Version 1.1.595
<PackageReference Include="nanoFramework.Iot.Device.Hx711" Version="1.1.595" />
paket add nanoFramework.Iot.Device.Hx711 --version 1.1.595
#r "nuget: nanoFramework.Iot.Device.Hx711, 1.1.595"
// Install nanoFramework.Iot.Device.Hx711 as a Cake Addin #addin nuget:?package=nanoFramework.Iot.Device.Hx711&version=1.1.595 // Install nanoFramework.Iot.Device.Hx711 as a Cake Tool #tool nuget:?package=nanoFramework.Iot.Device.Hx711&version=1.1.595
Hx711 (M5Stack WEIGHT)
This is a library to interact with the Hx711 ADC. This is conveniently assembled and package in the M5Stack WEIGHT module.
Documentation
Usage
Signals and connections
Check the connections for the WEIGTH module at the product page. From the schematic one can see these signals:
- DOUT: Grove connector pin 1
- PDSCK: Grove connector pin 2
Our code is using SPI to generate the clock signals and read back data from the HX711, so the connections need to match the SPI signals like this:
- MOSI → PDSCK
- MISO → DOUT
SPI clock is not used so feel free to route to an unused GPIO. There is also no need for the CS signal so no need to define a pin for it.
Important: make sure you setup the SPI pins for ESP32 before creating the Scale
. For this, make sure you install the nanoFramework.Hardware.ESP32
NuGet.
///////////////////////////////////////////////////////////////////////
// When connecting to an ESP32 device, need to configure the SPI GPIOs
// The following mapping is used in order to connect the WEIGTH module
// to a M5Core device using the Grove port A
// MOSI: connects to WEIGHT Grove pin 2
// MISO: connects to WEIGHT Grove pin 1
// CLOCK: connect to any free port as it's not used at all
Configuration.SetPinFunction(21, DeviceFunction.SPI1_MOSI);
Configuration.SetPinFunction(22, DeviceFunction.SPI1_MISO);
Configuration.SetPinFunction(23, DeviceFunction.SPI1_CLOCK);
Warning Make sure to follow the instructions above. At first glance they can look contrary to the naming of the signals and schematics in M5Stack documentation. That's because the GROVE connectors are meant to use I2C and their implementation of the driver is different from ours.
For other devices, like STM32, please make sure you're using the pins for the UART you want to use.
Configuring SPI
// setup SPI connection settings
// the clock value was adjusted in order to get the typical duration expected by the PD_SCK ~1us
var spisettings = new SpiConnectionSettings(1)
{
ClockFrequency = Scale.DefaultClockFrequency
};
// create SPI device
var spidev = SpiDevice.Create(spisettings);
// create scale
var scale = new Scale(spidev);
The scale class is very simple to use and offers some configurations. Let's explore the most common usage scenarios.
Taring a scale
Taring is used to exclude a measurement from the total weight given by the scale. Most commonly, this function is used to negate the weight of the container or other elements attached to the scale.
// set scale tare to get accurate readings
scale.Tare();
Reading the weight
To take a reading of the weight on the load cell just need to call Read
. The following code snippet will read the weight continuously and output the value to the output pane.
// loop forever outputting the current reading
while (true)
{
var reading = scale.Read();
Console.WriteLine($"Weight: {reading}");
Thread.Sleep(2_000);
}
Settings and configurations
The library exposes several configurations. Please explore the documentation here.
Acknowledgments
The development of this library was kindly sponsored by greenYng!
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET Framework | net is compatible. |
-
- nanoFramework.CoreLibrary (>= 1.15.5)
- nanoFramework.System.Device.Spi (>= 1.3.52)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.1.631 | 48 | 8/28/2024 |
1.1.595 | 71 | 7/24/2024 |
1.1.570 | 99 | 6/14/2024 |
1.1.560 | 83 | 5/29/2024 |
1.1.548 | 76 | 5/15/2024 |
1.1.436 | 234 | 11/10/2023 |
1.1.384 | 175 | 9/6/2023 |
1.1.329 | 131 | 5/26/2023 |
1.1.313 | 123 | 5/12/2023 |
1.1.297 | 132 | 5/3/2023 |
1.1.253 | 266 | 2/22/2023 |
1.1.203 | 308 | 12/28/2022 |
1.1.141 | 387 | 10/25/2022 |
1.1.128 | 362 | 10/22/2022 |
1.1.122 | 423 | 10/12/2022 |
1.1.114 | 407 | 10/8/2022 |
1.1.95 | 418 | 9/22/2022 |
1.1.87 | 465 | 9/15/2022 |
1.1.73 | 383 | 9/8/2022 |
1.1.35 | 408 | 8/4/2022 |
1.1.5 | 418 | 7/13/2022 |
1.0.86.41205 | 411 | 7/6/2022 |
1.0.58.2032 | 411 | 6/23/2022 |
1.0.54.32999 | 426 | 6/16/2022 |
1.0.50.47843 | 396 | 6/15/2022 |
1.0.4.7661 | 409 | 5/24/2022 |
1.0.3.10097 | 392 | 5/23/2022 |
1.0.1.10218 | 402 | 5/23/2022 |