0.6.4 HX711

RobTillaart · RobTillaart · commit ed3027410d0f · 2026-06-30T14:45:46.000+02:00
diff --git a/libraries/HX711/.github/workflows/arduino-lint.yml b/libraries/HX711/.github/workflows/arduino-lint.yml
@@ -6,7 +6,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 5
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - uses: arduino/arduino-lint-action@v2
         with:
           library-manager: update
diff --git a/libraries/HX711/.github/workflows/arduino_test_runner.yml b/libraries/HX711/.github/workflows/arduino_test_runner.yml
@@ -6,9 +6,8 @@ jobs:
   runTest:
     runs-on: ubuntu-latest
     timeout-minutes: 20
-
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: 2.6
diff --git a/libraries/HX711/.github/workflows/jsoncheck.yml b/libraries/HX711/.github/workflows/jsoncheck.yml
@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 5
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: json-syntax-check
         uses: limitusus/json-syntax-check@v2
         with:
diff --git a/libraries/HX711/CHANGELOG..md b/libraries/HX711/CHANGELOG..md
@@ -5,6 +5,11 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 
+## [0.6.4] - 2026-06-28
+- rename examples
+- update GitHub actions
+- minor edits
+
 ## [0.6.3] - 2025-09-16
 - fix #70, HX711 rate pin code
 - fix #70, add a doReset parameter to begin() to improve start up time.
diff --git a/libraries/HX711/HX711.cpp b/libraries/HX711/HX711.cpp
@@ -1,7 +1,8 @@
 //
 //    FILE: HX711.cpp
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.6.3
+// VERSION: 0.6.4
+//    DATE: 2019-09-04
 // PURPOSE: Library for load cells for UNO
 //     URL: https://github.com/RobTillaart/HX711_MP
 //     URL: https://github.com/RobTillaart/HX711
@@ -54,6 +55,7 @@ void HX711::reset()
   _lastTimeRead = 0;
   _mode     = HX711_AVERAGE_MODE;
   _price    = 0;
+  read();  //  force settings.
 }
 
 
diff --git a/libraries/HX711/HX711.h b/libraries/HX711/HX711.h
@@ -2,7 +2,8 @@
 //
 //    FILE: HX711.h
 //  AUTHOR: Rob Tillaart
-// VERSION: 0.6.3
+// VERSION: 0.6.4
+//    DATE: 2019-09-04
 // PURPOSE: Library for load cells for Arduino
 //     URL: https://github.com/RobTillaart/HX711_MP
 //     URL: https://github.com/RobTillaart/HX711
@@ -15,7 +16,7 @@
 
 #include "Arduino.h"
 
-#define HX711_LIB_VERSION               (F("0.6.3"))
+#define HX711_LIB_VERSION               (F("0.6.4"))
 
 
 const uint8_t HX711_AVERAGE_MODE = 0x00;
@@ -54,7 +55,7 @@ class HX711
   bool     is_ready();
 
   //  wait until ready,
-  //  check every ms
+  //  check every ms milliseconds.
   void     wait_ready(uint32_t ms = 0);
   //  max # retries
   bool     wait_ready_retry(uint8_t retries = 3, uint32_t ms = 0);
diff --git a/libraries/HX711/LICENSE b/libraries/HX711/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2019-2025 Rob Tillaart
+Copyright (c) 2019-2026 Rob Tillaart
 Copyright (c) 2018 Bogdan Necula
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
diff --git a/libraries/HX711/README.md b/libraries/HX711/README.md
@@ -36,6 +36,8 @@ load etc. only 16 to 20 of the bits are expected significant in practice.
 This translates roughly to 4 or max 5 significant digits in a single measurement
 That's why it is advised to average (median) multiple measurements to reduce the noise.
 
+Feedback as always is welcome.
+
 
 ### Breaking change 0.4.0
 
@@ -106,11 +108,13 @@ This is a close "relative" of the HX711 that allows to set the SPS to
 
 ### Related
 
-- https://github.com/bogde/HX711
+- https://github.com/bogde/HX711 
+- https://github.com/bogde/HX711/issues/172 - hx711 module design fault fix
 - https://github.com/RobTillaart/weight  (conversions kg <> stone etc.)
 - https://github.com/RobTillaart/HX710AB
-- https://github.com/RobTillaart/HX711
-- https://github.com/RobTillaart/HX711_MP  multipoint calibration version.
+- https://github.com/RobTillaart/HX711 
+- https://github.com/RobTillaart/HX711_MP MP = multipoint calibration version.
+- https://github.com/RobTillaart/printHelpers engineering and scientific notation.
 
 Discussion about resolution of the ADC
 - https://forum.arduino.cc/t/scale-from-50-kg-to-5000kg-what-adc/1139710
@@ -125,6 +129,12 @@ Never seen one and cannot tell if it will work with this library.
 Breakout with RATE exposed by ADAfruit
 - https://www.adafruit.com/product/5974
 
+Reading multiple HX711's simultaneously
+- https://github.com/compugician/HX711-multi
+
+TM7711 - compatible (seems to, needs investigation)
+- https://electropeak.com/learn/interfacing-tm7711-electronic-weighing-sensor-with-arduino/
+
 
 ### Faulty boards
 
@@ -373,6 +383,9 @@ Note: Having the RATE set to 10 or 80 SPS changes the time to start up.
 At 10 SPS it takes 400 milliseconds, at 80 SPS it takes 50 milliseconds.
 (See datasheet, Output settling time on page 3)
 
+Note: add a pull up resistor on the CLK pin prevents waking up when the
+processor goes to sleep and cannot keep the CLK pin HIGH.
+
 
 ### Rate
 
@@ -440,7 +453,7 @@ Use calibrate to find your favourite values.
 - A+/A-  uses gain of 128 or 64
 - B+/B-  uses gain of 32
 
-Colour scheme wires of two devices.
+Colour scheme wires of two devices. Check the datasheet of your device!
 
 |  HX711 Pin  |  Colour dev 1   |  Colour dev 2   |
 |:-----------:|:---------------:|:---------------:|
@@ -537,6 +550,8 @@ See https://github.com/RobTillaart/HX711/issues/40
   - example for using rate functions.
 - investigate temperature compensation.
 - decide pricing keep/not => move to .cpp
+- implement HX711_RAW class, that only supports raw mode.
+
 
 #### Wont
 
diff --git a/libraries/HX711/examples/HX711_calibration/HX711_calibration.ino b/libraries/HX711/examples/HX711_calibration/HX711_calibration.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_calibration.ino
+//    FILE: HX711_calibration.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 calibration finder for offset and scale
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_delta_scale/HX711_delta_scale.ino b/libraries/HX711/examples/HX711_delta_scale/HX711_delta_scale.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_kitchen_scale.ino
+//    FILE: HX711_kitchen_scale.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 demo
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_get_noise_statistics/.arduino-ci.yml b/libraries/HX711/examples/HX711_get_noise_statistics/.arduino-ci.yml
diff --git a/libraries/HX711/examples/HX711_get_noise_statistics/HX711_get_noise_statistics.ino b/libraries/HX711/examples/HX711_get_noise_statistics/HX711_get_noise_statistics.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_get_noise_statistics.ino
+//    FILE: HX711_get_noise_statistics.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 noise meansurement
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_grocery_scale/HX711_grocery_scale.ino b/libraries/HX711/examples/HX711_grocery_scale/HX711_grocery_scale.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_grocery_scale.ino
+//    FILE: HX711_grocery_scale.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 demo
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_is_ready/HX711_is_ready.ino b/libraries/HX711/examples/HX711_is_ready/HX711_is_ready.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_is_ready.ino
+//    FILE: HX711_is_ready.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 demo
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_kitchen_scale/HX711_kitchen_scale.ino b/libraries/HX711/examples/HX711_kitchen_scale/HX711_kitchen_scale.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_kitchen_scale.ino
+//    FILE: HX711_kitchen_scale.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 demo
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_loadcell_array/HX711_loadcell_array.ino b/libraries/HX711/examples/HX711_loadcell_array/HX711_loadcell_array.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_loadcell_array.ino
+//    FILE: HX711_loadcell_array.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 demo
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_morse_experimental/HX711_morse_experimental.ino b/libraries/HX711/examples/HX711_morse_experimental/HX711_morse_experimental.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_morse_experimental.ino
+//    FILE: HX711_morse_experimental.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 demo
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_performance/HX711_performance.ino b/libraries/HX711/examples/HX711_performance/HX711_performance.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_performance.ino
+//    FILE: HX711_performance.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 performance measurements
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_performance/performance_0.3.1.txt b/libraries/HX711/examples/HX711_performance/performance_0.3.1.txt
diff --git a/libraries/HX711/examples/HX711_performance/performance_0.3.2.txt b/libraries/HX711/examples/HX711_performance/performance_0.3.2.txt
diff --git a/libraries/HX711/examples/HX711_performance/performance_0.3.4.txt b/libraries/HX711/examples/HX711_performance/performance_0.3.4.txt
diff --git a/libraries/HX711/examples/HX711_performance2/HX711_performance2.ino b/libraries/HX711/examples/HX711_performance2/HX711_performance2.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_performance2.ino
+//    FILE: HX711_performance2.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 performance measurements
 //     URL: https://github.com/RobTillaart/HX711
@@ -64,6 +64,8 @@ void measure()
   Serial.println(count);
   Serial.print("calls per second: ");
   Serial.println(count / 60.0);
+  Serial.print(" micros per call: ");
+  Serial.println(60000000.0 / count, 1);
 }
 
 
diff --git a/libraries/HX711/examples/HX711_performance2/performance_0.2.3.txt b/libraries/HX711/examples/HX711_performance2/performance_0.2.3.txt
diff --git a/libraries/HX711/examples/HX711_performance2/performance_0.3.0.txt b/libraries/HX711/examples/HX711_performance2/performance_0.3.0.txt
diff --git a/libraries/HX711/examples/HX711_performance2/performance_0.3.6.txt b/libraries/HX711/examples/HX711_performance2/performance_0.3.6.txt
diff --git a/libraries/HX711/examples/HX711_plotter/HX711_plotter.ino b/libraries/HX711/examples/HX711_plotter/HX711_plotter.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_plotter.ino
+//    FILE: HX711_plotter.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 demo
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_plotter_multimap/.arduino-ci.yml b/libraries/HX711/examples/HX711_plotter_multimap/.arduino-ci.yml
diff --git a/libraries/HX711/examples/HX711_plotter_multimap/HX711_plotter_multimap.ino b/libraries/HX711/examples/HX711_plotter_multimap/HX711_plotter_multimap.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_plotter_multimap.ino
+//    FILE: HX711_plotter_multimap.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 demo
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_read_median/HX711_read_median.ino b/libraries/HX711/examples/HX711_read_median/HX711_read_median.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_read_median.ino
+//    FILE: HX711_read_median.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 demo
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_read_median_average/HX711_read_median_average.ino b/libraries/HX711/examples/HX711_read_median_average/HX711_read_median_average.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_read_median_average.ino
+//    FILE: HX711_read_median_average.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 demo
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_set_mode/HX711_set_mode.ino b/libraries/HX711/examples/HX711_set_mode/HX711_set_mode.ino
@@ -1,5 +1,5 @@
 //
-//    FILE: HX_set_mode.ino
+//    FILE: HX711_set_mode.ino
 //  AUTHOR: Rob Tillaart
 // PURPOSE: HX711 demo
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/examples/HX711_set_persistent/.arduino-ci.yml b/libraries/HX711/examples/HX711_set_persistent/.arduino-ci.yml
diff --git a/libraries/HX711/examples/HX711_set_persistent/HX711_set_persistent.ino b/libraries/HX711/examples/HX711_set_persistent/HX711_set_persistent.ino
@@ -1,6 +1,6 @@
 
 //
-//    FILE: HX_set_persistent.ino
+//    FILE: HX711_set_persistent.ino
 //  AUTHOR: Felix Moli Grao la base de Rob Tillaart
 // PURPOSE: HX711 demo
 //     URL: https://github.com/RobTillaart/HX711
diff --git a/libraries/HX711/library.json b/libraries/HX711/library.json
@@ -15,7 +15,7 @@
     "type": "git",
     "url": "https://github.com/RobTillaart/HX711"
   },
-  "version": "0.6.3",
+  "version": "0.6.4",
   "license": "MIT",
   "frameworks": "*",
   "platforms": "*",
diff --git a/libraries/HX711/library.properties b/libraries/HX711/library.properties
@@ -1,5 +1,5 @@
 name=HX711
-version=0.6.3
+version=0.6.4
 author=Rob Tillaart <rob.tillaart@gmail.com>
 maintainer=Rob Tillaart <rob.tillaart@gmail.com>
 sentence=Arduino library for HX711 load cell amplifier.
