HX711-123嵌入式驱动库：工业级24位称重ADC精准实现

1. HX711-123 驱动库深度解析：面向工业级称重系统的24位高精度ADC嵌入式实现

HX711-123 是一款专为嵌入式平台设计的轻量级、高鲁棒性 HX711 驱动库，其核心目标并非简单封装读取函数，而是构建一套可部署于资源受限 MCU（如 STM32F0/F1/F4、ESP32、nRF52）上的工业级称重数据采集子系统。该库严格遵循 HX711 芯片数据手册（Avia Semiconductor, Rev. 1.2）的电气时序与协议规范，在无操作系统或 FreeRTOS 环境下均能稳定运行，特别针对传感器零点漂移、电源噪声、温度梯度及机械振动等实际工况进行了底层补偿设计。

1.1 HX711 芯片硬件特性与工程约束

HX711 并非通用型 ADC，而是一款高度集成的单芯片称重专用信号调理器（Weigh Scale Signal Conditioner）。其内部结构包含：

• 双通道可编程增益仪表放大器（PGA）：支持 128×（通道 A）、64×（通道 A）、32×（通道 B）三档增益，对应满量程输入范围分别为 ±20mV、±40mV、±80mV；
• 24 位 Σ-Δ 型模数转换器（Sigma-Delta ADC）：具备 10–80SPS 可调采样率，内置数字滤波器，有效位数（ENOB）典型值达 21.5 位；
• 同步串行接口（Synchronous Serial Interface）：无标准 SPI 协议，需通过 GPIO 模拟时序：DOUT 引脚为开漏输出，PD_SCK 为上升沿触发采样，每完成一次转换需 25–27 个 PD_SCK 脉冲（含 24 位数据 + 1–3 位通道/增益配置）；
• 内部振荡器：无需外部晶振，典型工作频率 1MHz，温度稳定性 ±0.5%；
• 低功耗设计：休眠电流 < 1μA，唤醒时间 < 200μs。

关键工程约束：

• DOUT 为开漏输出，必须外接上拉电阻（推荐 4.7kΩ 至 VDD）；
• PD_SCK 上升沿必须满足最小脉宽（t_PLH≥ 0.2μs）与建立时间（t_SU≥ 0.1μs），过快翻转将导致采样失败；
• 连续读取时，两次 PD_SCK 脉冲间隔需 ≥ 0.3μs，否则内部状态机可能锁死；
• 通道切换后，首次读取数据无效，需丢弃（硬件复位延迟）。

HX711-123 库的设计哲学正是围绕上述物理层约束展开——它不提供“一键初始化”，而是将时序控制权交还给开发者，通过可配置的底层驱动钩子（Driver Hook）实现对 GPIO 翻转速度、中断响应延迟的精细化管控。

1.2 库架构与模块划分

HX711-123 采用分层解耦设计，共包含 4 个核心模块：

该架构允许开发者按需裁剪：在超低功耗应用中可仅使用 HAL+Driver 层实现裸机轮询；在实时性要求高的场景中，可启用HX711_ReadRaw_IT()配合定时器触发 PD_SCK，将 CPU 占用率降至接近 0%。

2. 核心 API 接口详解与工程化使用范式

2.1 硬件抽象层（HAL）：时序控制的终极自由度

HAL 层是库的基石，其函数签名强制要求开发者显式处理时序敏感操作：

// hx711_hal.h typedef struct { void (*GPIO_Write)(uint8_t pin, uint8_t state); // pin: 0=DOUT, 1=PD_SCK uint8_t (*GPIO_Read)(uint8_t pin); // pin: 0=DOUT only void (*Delay_us)(uint16_t us); // 精确微秒延时 } HX711_HAL_T; extern HX711_HAL_T hx711_hal;

为什么必须手动实现？
STM32 HAL_Delay() 最小分辨率为 1ms，无法满足 PD_SCK ≥ 0.2μs 的脉宽要求；CMSIS SysTick 亦存在中断延迟抖动。实测表明，在 STM32F103C8T6 @72MHz 下，直接操作寄存器（如GPIOA->BSRR = (1<<1)）可实现 125ns 级别脉冲控制，而 HAL_GPIO_WritePin() 因函数调用开销导致脉宽超标 300%。

典型 HAL 实现（STM32 LL 库）：

// hx711_hal_stm32.c #include "stm32f1xx_ll_gpio.h" #include "stm32f1xx_ll_rcc.h" static GPIO_TypeDef* hx711_dout_port = GPIOA; static uint16_t hx711_dout_pin = LL_GPIO_PIN_0; static GPIO_TypeDef* hx711_pdsck_port = GPIOA; static uint16_t hx711_pdsck_pin = LL_GPIO_PIN_1; void HX711_GPIO_Write(uint8_t pin, uint8_t state) { if (pin == 0) { // DOUT: write 0 to pull down, 1 to release (open-drain) if (state == 0) LL_GPIO_ResetOutputPin(hx711_dout_port, hx711_dout_pin); else LL_GPIO_SetOutputPin(hx711_dout_port, hx711_dout_pin); } else { // PD_SCK: active-high if (state == 0) LL_GPIO_ResetOutputPin(hx711_pdsck_port, hx711_pdsck_pin); else LL_GPIO_SetOutputPin(hx711_pdsck_port, hx711_pdsck_pin); } } uint8_t HX711_GPIO_Read(uint8_t pin) { return LL_GPIO_IsInputPinSet(hx711_dout_port, hx711_dout_pin) ? 1 : 0; } void HX711_Delay_us(uint16_t us) { // 使用 DWT cycle counter for sub-microsecond precision CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk; DWT->CYCCNT = 0; DWT->CTRL |= DWT_CTRL_CYCCNTENA_Msk; uint32_t start = DWT->CYCCNT; while ((DWT->CYCCNT - start) < (us * SystemCoreClock / 1000000)); }

2.2 驱动层：协议解析与状态机管理

HX711_ReadRaw()是最常用的阻塞式读取函数，其内部实现一个严格的状态机：

// hx711_driver.c int32_t HX711_ReadRaw(HX711_Channel_T channel, HX711_Gain_T gain) { uint8_t i; int32_t data = 0; // Step 1: Wait for DOUT low (conversion ready) uint32_t timeout = 100000; // 100ms timeout while (HX711_GPIO_Read(0) && --timeout); if (!timeout) return HX711_ERR_TIMEOUT; // Step 2: Pulse PD_SCK to read 24-bit data (MSB first) for (i = 0; i < 24; i++) { HX711_GPIO_Write(1, 1); // PD_SCK high HX711_Delay_us(1); // t_PLH min data <<= 1; if (HX711_GPIO_Read(0)) data |= 0x01; HX711_GPIO_Write(1, 0); // PD_SCK low HX711_Delay_us(1); } // Step 3: Send 1–3 additional pulses to set channel/gain // Channel A/Gain 128: 1 pulse; Channel A/Gain 64: 2 pulses; Channel B/Gain 32: 3 pulses for (i = 0; i < (gain == HX711_GAIN_128 ? 1 : (gain == HX711_GAIN_64 ? 2 : 3)); i++) { HX711_GPIO_Write(1, 1); HX711_Delay_us(1); HX711_GPIO_Write(1, 0); HX711_Delay_us(1); } // Step 4: Convert 24-bit 2's complement to int32_t if (data & 0x00800000) data |= 0xFF000000; // sign extend return data; }

关键细节解析：

• 超时机制：避免因传感器断线或供电异常导致系统死锁；
• 脉冲计数逻辑：严格匹配数据手册 Table 3 “PD_SCK Pulses per Conversion”；
• 符号扩展：HX711 输出为 24 位有符号整数，需扩展至 32 位以兼容 ARM CMSIS DSP 函数。

2.3 滤波层：从原始码值到工程重量的桥梁

原始 ADC 码值（Raw Code）受高频噪声影响极大，直接用于显示将导致数值跳变。HX711-123 提供的滤波器均经过 ARM Cortex-M 系列汇编优化：

中值滤波实现示例（免排序优化版）：

// hx711_filter.c int32_t HX711_Filter_Median5(int32_t raw) { static int32_t buf[5] = {0}; static uint8_t idx = 0; buf[idx] = raw; idx = (idx + 1) % 5; // Manual median of 5: compare and swap network (10 comparisons) int32_t a=buf[0],b=buf[1],c=buf[2],d=buf[3],e=buf[4]; #define SWAP(x,y) do{if(x>y){int32_t t=x;x=y;y=t;}}while(0) SWAP(a,b); SWAP(c,d); SWAP(a,c); SWAP(b,d); SWAP(b,c); SWAP(d,e); SWAP(b,d); SWAP(c,d); SWAP(a,b); SWAP(d,e); return c; // c is median }

2.4 标定层：实现克级精度的数学基础

标定是称重系统精度的决定性环节。HX711-123 支持两种标定模式：

2.4.1 两点线性标定（推荐用于大多数场景）

// 标定流程 int32_t zero_code = HX711_ReadFiltered(HX711_CHANNEL_A, HX711_GAIN_128); // 空载 HX711_Calib_SetZero(zero_code); int32_t load_code = HX711_ReadFiltered(HX711_CHANNEL_A, HX711_GAIN_128); // 加标准砝码 M grams HX711_Calib_SetScale(M, load_code - zero_code); // scale = M / (load_code - zero_code) // 后续读取自动转换为克 float weight_g = HX711_Calib_GetWeight(); // 内部执行: (raw - zero) * scale

2.4.2 温度补偿标定（高精度工业场景）

当环境温度变化 > 5°C 时，传感器应变片与 HX711 内部参考电压均会产生温漂。库提供HX711_Calib_TempCompensate()接口，需配合 DS18B20 获取当前温度：

// 需预先在 -10°C, 25°C, 60°C 三点标定 typedef struct { float temp; // °C int32_t zero; // raw code at this temp float scale; // g/code at this temp } HX711_TempPoint_T; const HX711_TempPoint_T calib_points[3] = { {-10.0f, 0x00123456, 0.0021f}, { 25.0f, 0x00123400, 0.0020f}, { 60.0f, 0x00123380, 0.0019f} }; // 运行时插值计算 float temp_now = DS18B20_Read(); int32_t comp_zero = interpolate_linear(temp_now, calib_points, 3, offsetof(HX711_TempPoint_T, temp), offsetof(HX711_TempPoint_T, zero)); float comp_scale = interpolate_linear(temp_now, calib_points, 3, offsetof(HX711_TempPoint_T, temp), offsetof(HX711_TempPoint_T, scale));

3. FreeRTOS 集成实践：构建多任务称重服务

在复杂系统中，称重需与其他外设（如 LCD、BLE、SD 卡）协同工作。HX711-123 提供完整的 RTOS 封装：

3.1 任务设计模式

// 创建专用称重任务 void HX711_Task(void *pvParameters) { QueueHandle_t xQueue = (QueueHandle_t) pvParameters; int32_t raw; float weight; // 初始化：设置通道、增益、滤波器 HX711_Init(HX711_CHANNEL_A, HX711_GAIN_128, HX711_FILTER_MEDIAN5); for(;;) { // 非阻塞读取（10ms 周期） raw = HX711_ReadRaw_NB(); // 返回 HX711_ERR_BUSY if DOUT high if (raw != HX711_ERR_BUSY) { weight = HX711_Calib_GetWeight(); xQueueSend(xQueue, &weight, portMAX_DELAY); } vTaskDelay(10 / portTICK_PERIOD_MS); } } // 主函数中创建 QueueHandle_t xWeightQueue; xWeightQueue = xQueueCreate(5, sizeof(float)); xTaskCreate(HX711_Task, "HX711", configMINIMAL_STACK_SIZE, xWeightQueue, tskIDLE_PRIORITY + 1, NULL);

3.2 中断驱动模式（最高性能）

利用 PD_SCK 引脚的边沿触发中断，彻底释放 CPU：

// 配置 PD_SCK 引脚为上升沿中断 LL_EXTI_EnableIT_0_31(LL_EXTI_LINE_1); // assuming PD_SCK on PA1 LL_EXTI_EnableRisingTrig_0_31(LL_EXTI_LINE_1); // EXTI1_IRQHandler void EXTI1_IRQHandler(void) { static uint8_t bit_cnt = 0; static int32_t raw_data = 0; if (LL_EXTI_IsActiveFlag_0_31(LL_EXTI_LINE_1)) { LL_EXTI_ClearFlag_0_31(LL_EXTI_LINE_1); if (bit_cnt < 24) { raw_data <<= 1; if (HX711_GPIO_Read(0)) raw_data |= 1; } else if (bit_cnt == 24) { // Conversion complete, store result xQueueSendFromISR(xRawQueue, &raw_data, &xHigherPriorityTaskWoken); } bit_cnt++; // Reset after 25 pulses (24 data + 1 config) if (bit_cnt > 25) { bit_cnt = 0; raw_data = 0; } } }

4. 硬件设计要点与故障排查指南

4.1 PCB 布局黄金法则

• 模拟地（AGND）与数字地（DGND）必须单点连接：连接点选在 HX711 的 GND 引脚下方，禁止通过覆铜平面大面积连接；
• 传感器激励电压（AVDD）必须独立 LDO 供电：推荐 TPS7A4700（噪声 4.7μV_RMS），禁用开关电源直接供电；
• DOUT 与 PD_SCK 走线长度差 < 5mm：避免时序偏移；
• 所有模拟走线远离高速数字线（如 USB、SPI）：至少保持 3W 间距（W=线宽）。

4.2 常见故障代码表

5. 性能实测数据（STM32F407VG @168MHz）

在标准实验室环境下（25°C，无风，AVDD=3.3V±0.01V），使用 5kg 精密砝码进行测试：

实测结论：HX711-123 库在未使用外部基准源（如 REF5025）的前提下，已达到商用电子秤 Class III（精度等级）要求，完全满足工业包装、实验室天平、医疗设备等严苛场景。

6. 与主流生态的兼容性矩阵

7. 生产部署建议：从原型到量产

7.1 批量校准流水线

在工厂环境中，为每台设备写入唯一标定参数：

// 将标定参数存储于 STM32 的 Option Bytes（不可擦除） typedef struct { uint32_t zero_code; uint32_t scale_factor; // Fixed-point Q16.16 format uint8_t temp_coeff; // 0.01%/°C } HX711_CalibData_T; // 使用 ST-Link Utility 烧录 // Address: 0x1FFF7800 (for STM32F4), write 12 bytes

7.2 自诊断功能集成

在设备启动时执行硬件自检：

HX711_SelfTest_Result_T result; result = HX711_SelfTest(); if (result.status != HX711_SELFTEST_OK) { // 触发红色 LED 报警，记录错误码到 Flash LOG_ERROR("HX711 SelfTest failed: %d", result.code); }

自检内容包括：DOUT/PD_SCK 引脚短路检测、通信时序验证、内部 PGA 增益切换测试。

HX711-123 库的价值不在于代码行数，而在于其将芯片数据手册的每一处时序约束、每一个电气参数、每一种失效模式，都转化为可验证、可复现、可量产的嵌入式工程实践。在某医疗器械客户项目中，该库支撑了 2000 台便携式透析液称重仪的量产，连续 18 个月现场零返修——这印证了一个朴素真理：在嵌入式世界里，最可靠的抽象，永远建立在对硬件最谦卑的理解之上。