基于上海钜泉科技HT7017单相计量芯片的参考例程实现

news/2026/1/24 12:29:01/文章来源:https://www.cnblogs.com/45234ynn/p/19525901

一、HT7017芯片简介

HT7017是上海钜泉科技推出的单相电能计量专用芯片，集成高精度Sigma-Delta ADC、数字信号处理（DSP）单元及UART通信接口，支持电压、电流、有功功率、无功功率、电能等参数的实时测量，适用于智能电表、充电桩等电力计量场景。其核心特性包括：

工作电压：3.0V~5.5V（宽电压域）；
采样速率：31.2kHz（高分辨率）；
动态范围：5000:1（覆盖宽量程）；
通信接口：UART（支持9600~115200bps）；
封装形式：SSOP16（小型化）。

二、参考例程框架

HT7017的参考例程基于STM32F103C8T6单片机实现，涵盖芯片初始化、UART通信、数据读取三大核心模块，采用HAL库开发，代码可移植性强。例程框架如下：

graph TDA[系统初始化] --> B[HT7017初始化]B --> C[UART通信配置]C --> D[数据读取与解析]D --> E[结果输出]

三、核心代码实现

1. 系统初始化（时钟、GPIO）

#include "stm32f1xx_hal.h"UART_HandleTypeDef huart1; // UART1句柄（连接HT7017）void SystemClock_Config(void) {RCC_OscInitTypeDef RCC_OscInitStruct = {0};RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};// 配置HSE（外部高速时钟）RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;RCC_OscInitStruct.HSEState = RCC_HSE_ON;RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9; // 72MHz系统时钟HAL_RCC_OscConfig(&RCC_OscInitStruct);// 配置系统时钟RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2;RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2);
}void GPIO_Init(void) {__HAL_RCC_GPIOA_CLK_ENABLE(); // 使能GPIOA时钟（UART1_TX/RX引脚）
}

2. HT7017初始化（UART配置）

HT7017通过UART接口与单片机通信，需配置UART参数（波特率、数据位、停止位）与芯片寄存器（如采样率、通信格式）。

void HT7017_Init(void) {// 配置UART1（波特率9600，8数据位，1停止位，无校验）huart1.Instance = USART1;huart1.Init.BaudRate = 9600;huart1.Init.WordLength = UART_WORDLENGTH_8B;huart1.Init.StopBits = UART_STOPBITS_1;huart1.Init.Parity = UART_PARITY_NONE;huart1.Init.Mode = UART_MODE_TX_RX;huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE;HAL_UART_Init(&huart1);// 发送初始化命令（示例：设置采样率为31.2kHz）uint8_t init_cmd[] = {0x01, 0x03, 0x00, 0x01, 0x00, 0x01, 0xD5, 0xCA}; // 写寄存器命令（地址0x0001，值0x0001）HAL_UART_Transmit(&huart1, init_cmd, sizeof(init_cmd), HAL_MAX_DELAY);
}

3. 数据读取与解析

HT7017的测量数据（如电压、电流、电能）存储在内部寄存器中，需通过UART读取并解析。以下是读取电压有效值的示例：

float HT7017_ReadVoltage(void) {uint8_t read_cmd[] = {0x01, 0x03, 0x00, 0x02, 0x00, 0x01, 0x25, 0xCA}; // 读寄存器命令（地址0x0002，长度0x0001）uint8_t recv_buf[7] = {0}; // 接收缓冲区（7字节：地址+功能码+数据长度+数据+CRC）// 发送读命令HAL_UART_Transmit(&huart1, read_cmd, sizeof(read_cmd), HAL_MAX_DELAY);// 接收响应（超时100ms）HAL_UART_Receive(&huart1, recv_buf, sizeof(recv_buf), 100);// 解析数据（假设数据格式为16位无符号整数，单位：mV）uint16_t voltage_raw = (recv_buf[3] << 8) | recv_buf[4];float voltage = voltage_raw / 1000.0f; // 转换为伏特（V）return voltage;
}

4. 主函数（循环读取数据）

int main(void) {HAL_Init(); // 初始化HAL库SystemClock_Config(); // 配置系统时钟GPIO_Init(); // 初始化GPIOHT7017_Init(); // 初始化HT7017while (1) {float voltage = HT7017_ReadVoltage(); // 读取电压float current = HT7017_ReadCurrent(); // 读取电流（类似电压读取函数）float power = HT7017_ReadPower();     // 读取有功功率（类似电压读取函数）// 输出结果（通过串口助手或LCD显示）printf("电压：%.2f V\r\n", voltage);printf("电流：%.2f A\r\n", current);printf("功率：%.2f W\r\n", power);HAL_Delay(1000); // 1秒更新一次}
}

参考代码基于上海钜泉科技的单相计量芯片HT7017的参考例程 www.youwenfan.com/contentcnq/56489.html