3.2.4. `hx711` — HX711 ADC for weigh scales¶

The HX711 chipset performs ADC convertions on weigh scales. It can be used to measure weight in various ranges.

This driver provides methods to read ADC samples from given channel with given gain.

3.2.4.1. Example usage¶

This is a small example illustrating how to read one sample from each channel and gain combination.

struct hx711_driver_t hx711;
float weight_a_128;
float weight_a_64;
float weight_b_32;

/* Initialize and start the deivce. */
hx711_init(&hx711, &pin_d2_dev, &pin_d3_dev, 1.0, 0.0);
hx711_start(&hx711);

/* Read a few samples from the device. */
hx711_read(&hx711, &weight_a_128, hx711_channel_gain_a_128_t);
hx711_read(&hx711, &weight_a_64, hx711_channel_gain_a_64_t);
hx711_read(&hx711, &weight_b_32, hx711_channel_gain_b_32_t);

/* Print the samples. */
std_printf(OSTR("weight_a_128: %f, weight_a_64: %f, weight_b_32: %f\r\n"),
           weight_a_128,
           weight_a_64,
           weight_b_32);

/* Stop the deivce. */
hx711_stop(&hx711);

Source code: src/drivers/sensors/hx711.h, src/drivers/sensors/hx711.c

Test code: tst/drivers/software/sensors/hx711/main.c

Test coverage: src/drivers/sensors/hx711.c

Example code: examples/hx711/main.c

Enums

enum hx711_channel_gain_t¶

Values:

hx711_channel_gain_a_128_t = 1¶

hx711_channel_gain_b_32_t¶

hx711_channel_gain_a_64_t¶

Functions

int hx711_module_init(void)¶

Initialize the hx711 module. This function must be called before calling any other function in this module.

The module will only be initialized once even if this function is called multiple times.

Return: zero(0) or negative error code.

int hx711_init(struct hx711_driver_t *self_p, struct pin_device_t *pd_sck_p, struct pin_device_t *dout_p, float scale, float offset)¶

Initialize given driver object from given configuration.

Return