HX711

A platform agnostic driver to interface with the HX711 (load cell amplifier and 24 bit ADC)

What works

• Resetting the chip
• Setting the mode (gain and channel)
• Reading conversion results (blocking and non blocking)
• Entering low-power mode and wake up

Tested with STM32F103. Pull requests for other hardware welcome!

Because the interface works by toggling of GPIO pins, some care has to be taken. See below.

Examples

See here: https://github.com/jonas-hagen/hx711-examples

Bit-banging and delays

The protocol is implemented using GPIO interface because the HX711 needs a specific number of clock cycles to set the operation mode (25, 26 or 27 cycles). So, beware of interrupts during readout! The delays between state changes for clocking only need to be 0.1 µs (per HX711 specs), allowing to clock through all 24 cycles in approximately 5 µs. But the current embedded HAL does not support delays smaller than 1 µs (see embedded-hal #63 for the discussion). With a delay of 1 µs, the readout takes at least 48 µs. Depending on clock speed of the device, this increases to 300 µs (STM32F103 at 8 MHz) or more. This is much larger than the conversion time of the HX711 ADC (100 µs).

To tweak the performance, an alternative implementation of the delay trait can be used. For example:

```rust use embedded_hal::blocking::delay::DelayUs;

pub struct BusyDelay { nopsperus: u32, }

impl BusyDelay { pub fn new(loopsperus: u32) -> Self { BusyDelay{loopsperus: loopsperus as u32} } }

impl DelayUs for BusyDelay { fn delayus(&mut self, us: u32) { for _ in 0..us { cortexm::asm::delay(self.nopsperus) } } } ```

Or even:

```rust pub struct NoDelay();

impl NoDelay { pub fn new() -> Self { NoDelay() } }

impl DelayUs for NoDelay { fn delay_us(&mut self, _us: u32) { } } ```

Some random notes on this topic: * Maybe add a nodelay feature? * It would be interesting to try to use SPI with MOSI as clock and MISO as data line, not using the actual SPI clock. * How to make this work on linux? Any ideas?

Changelog

v0.4

• Add delays.
• Add enable() and disable() functions to enter and leave low-power mode.

v0.3

• Add custom error type. Some HALs implement the digital interface in a way that it cannot fail. In this case, the Error type of Input and Output pins are Infallible. With a custom Error type we can allow the use of .into_ok() when using such HAL implementations.

v0.2

• Update to embedded-hal digital pin v2 API. Thanks to mmou!

v0.1

• First version.

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.