基于STM32LXXX的数字电位器（MCP41010T-I/SN）驱动应用程序设计

一、简介MCP41010T-I/SN 是 Microchip 公司推出的一款单通道、8位数字电位器采用 SPI 串行接口进行通信。该器件将传统的机械电位器功能数字化通过简单的数字指令精确调节电阻值特别适用于需要软件控制电路参数的嵌入式系统。二、主要技术特性电阻值10kΩ 端到端电阻256个离散抽头位置8位分辨率接口SPI 串行接口支持 Mode 0,0 和 Mode 1,1工作电压2.7V 至 5.5V兼容 3.3V 和 5V 系统低功耗静态电流典型值 1μA工作电流典型值 340μA上电复位上电自动复位至中值50% 抽头位置0x80封装8引脚 SOIC150mil 宽度工作温度-40℃ 至 85℃三、引脚定义引脚编号引脚名称类型功能描述1CS数字输入片选信号低电平有效2SCK数字输入SPI 串行时钟3SI数字输入SPI 串行数据输入SDI4VSS电源地5PA0模拟电位器 A 端6PW0模拟电位器滑动端抽头7PB0模拟电位器 B 端8VDD电源正电源2.7V-5.5V四、内部原理框图五、头文件/*** file mcp41010.h* brief MCP41010 Digital Potentiometer Driver Header* version V1.0* date 2026-04-03*/#ifndef __MCP41010_H#define __MCP41010_H#include stm32l4xx_hal.h/* 引脚定义 - 可根据实际连接修改 */#define MCP41010_CS_PIN GPIO_PIN_5#define MCP41010_CS_PORT GPIOB#define MCP41010_CS_HIGH() HAL_GPIO_WritePin(MCP41010_CS_PORT, MCP41010_CS_PIN, GPIO_PIN_SET)#define MCP41010_CS_LOW() HAL_GPIO_WritePin(MCP41010_CS_PORT, MCP41010_CS_PIN, GPIO_PIN_RESET)/* 命令字节定义 */#define MCP41010_CMD_WRITE 0x11 /* 写数据命令 (00010001) *//* 抽头位置预定义值 */#define MCP41010_TAP_MIN 0x00 /* 最小阻值抽头移至PB0 */#define MCP41010_TAP_MID 0x80 /* 中值上电默认 */#define MCP41010_TAP_MAX 0xFF /* 最大阻值抽头移至PA0 *//* 电阻值计算公式R_pw0_pb0 (data / 256) * 10kΩ *//*** brief 初始化 MCP41010 相关 GPIO 和 SPI* param hspi: SPI 句柄指针* retval HAL 状态*/HAL_StatusTypeDef MCP41010_Init(SPI_HandleTypeDef *hspi);/*** brief 设置数字电位器抽头位置* param tap_value: 抽头值 (0x00 - 0xFF)* - 0x00: 最小阻值* - 0x80: 中值阻值* - 0xFF: 最大阻值* retval HAL 状态*/HAL_StatusTypeDef MCP41010_SetTapping(uint8_t tap_value);/*** brief 设置电阻百分比* param percent: 电阻百分比 (0-100)* retval HAL 状态*/HAL_StatusTypeDef MCP41010_SetPercent(uint8_t percent);/*** brief 获取当前抽头位置* retval 当前抽头值 (0x00 - 0xFF)*/uint8_t MCP41010_GetCurrentValue(void);#endif /* __MCP41010_H */六、驱动文件/*** file mcp41010.c* brief MCP41010 Digital Potentiometer Driver Source*/#include mcp41010.hstatic SPI_HandleTypeDef *mcp41010_spi NULL;static uint8_t current_tap_value MCP41010_TAP_MID; /* 记录当前抽头位置 *//*** brief MCP41010 初始化* param hspi: SPI 句柄指针* retval HAL 状态*/HAL_StatusTypeDef MCP41010_Init(SPI_HandleTypeDef *hspi){GPIO_InitTypeDef GPIO_InitStruct {0};if (hspi NULL)return HAL_ERROR;mcp41010_spi hspi;/* 使能 GPIO 时钟 */__HAL_RCC_GPIOB_CLK_ENABLE();/* 配置 CS 引脚为推挽输出 */GPIO_InitStruct.Pin MCP41010_CS_PIN;GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP;GPIO_InitStruct.Pull GPIO_PULLUP;GPIO_InitStruct.Speed GPIO_SPEED_FREQ_LOW;HAL_GPIO_Init(MCP41010_CS_PORT, GPIO_InitStruct);/* 初始 CS 为高电平未选中 */MCP41010_CS_HIGH();/* 可选将电位器初始化为中值 */return MCP41010_SetTapping(MCP41010_TAP_MID);}/*** brief 向 MCP41010 发送 16 位指令命令字节 数据字节* param command: 命令字节* param data: 数据字节* retval HAL 状态*/static HAL_StatusTypeDef MCP41010_Transmit(uint8_t command, uint8_t data){uint8_t tx_buffer[2];if (mcp41010_spi NULL)return HAL_ERROR;tx_buffer[0] command;tx_buffer[1] data;/* CS 低电平启动传输 */MCP41010_CS_LOW();/* 发送 2 字节数据 */HAL_StatusTypeDef status HAL_SPI_Transmit(mcp41010_spi, tx_buffer, 2, HAL_MAX_DELAY);/* CS 高电平结束传输数据在此上升沿锁存 */MCP41010_CS_HIGH();return status;}/*** brief 设置数字电位器抽头位置* param tap_value: 抽头值 (0x00 - 0xFF)* retval HAL 状态*/HAL_StatusTypeDef MCP41010_SetTapping(uint8_t tap_value){HAL_StatusTypeDef status;/* 发送写命令和数据 */status MCP41010_Transmit(MCP41010_CMD_WRITE, tap_value);if (status HAL_OK){current_tap_value tap_value;}return status;}/*** brief 设置电阻百分比* param percent: 电阻百分比 (0-100)* retval HAL 状态* note 百分比映射0% - 0x00最小阻值抽头在PB0端* 100% - 0xFF最大阻值抽头在PA0端* 电阻值 (percent / 100) * 10kΩ*/HAL_StatusTypeDef MCP41010_SetPercent(uint8_t percent){uint16_t tap_value;/* 限制百分比范围 */if (percent 100)percent 100;/* 百分比映射到 0-255 抽头值 */tap_value (uint16_t)percent * 255 / 100;return MCP41010_SetTapping((uint8_t)tap_value);}/*** brief 获取当前抽头位置* retval 当前抽头值 (0x00 - 0xFF)*/uint8_t MCP41010_GetCurrentValue(void){return current_tap_value;}七、应用示例1、LED 亮度调节示例#include mcp41010.hextern SPI_HandleTypeDef hspi3; /* 声明 SPI 句柄 */void LED_Brightness_Example(void){/* 初始化 MCP41010 */MCP41010_Init(hspi3);/* 渐变效果亮度从 0% 增加到 100% */for (uint8_t percent 0; percent 100; percent 5){MCP41010_SetPercent(percent);HAL_Delay(100); /* 每步延时 100ms */}/* 设置特定亮度值 */MCP41010_SetPercent(30); /* 设置 30% 亮度 */HAL_Delay(2000);MCP41010_SetPercent(70); /* 设置 70% 亮度 */HAL_Delay(2000);/* 直接设置抽头值 */MCP41010_SetTapping(0x40); /* 约 25% 阻值 */}2、可编程增益放大器配置/*** brief 可编程增益放大器配置* note 使用 MCP41010 作为运放反馈电阻* 增益计算公式Gain 1 (R_feedback / R_in)* R_feedback 由 MCP41010 控制*/typedef struct {uint8_t tap_value;float gain;} GainConfig_t;/* 预定义增益配置表 */static const GainConfig_t gain_table[] {{0x00, 1.0}, /* 最小增益 */{0x33, 2.0},{0x66, 3.0},{0x99, 4.0},{0xCC, 5.0},{0xFF, 6.0} /* 最大增益 */};void PGA_SetGain(uint8_t gain_index){if (gain_index sizeof(gain_table) / sizeof(GainConfig_t))return;MCP41010_SetTapping(gain_table[gain_index].tap_value);}void PGA_Example(void){MCP41010_Init(hspi3);/* 循环设置不同增益 */while (1){for (uint8_t i 0; i 6; i){PGA_SetGain(i);HAL_Delay(1000);}}}3、软件校准和温度补偿/*** brief 带温度补偿的电压调节* note 根据温度传感器读数补偿输出电压漂移*/#include stm32l4xx_hal.hextern ADC_HandleTypeDef hadc1; /* 温度传感器 ADC *//* 温度补偿系数表示例数据需根据实际测试校准 */static const int8_t temp_comp_table[] {-10, /* -40℃ ~ -30℃ */-8, /* -30℃ ~ -20℃ */-5, /* -20℃ ~ -10℃ */-2, /* -10℃ ~ 0℃ */0, /* 0℃ ~ 10℃ */1, /* 10℃ ~ 20℃ */2, /* 20℃ ~ 30℃ */3, /* 30℃ ~ 40℃ */4, /* 40℃ ~ 50℃ */5, /* 50℃ ~ 60℃ */6, /* 60℃ ~ 70℃ */7, /* 70℃ ~ 80℃ */8, /* 80℃ ~ 90℃ */9 /* 90℃ ~ 100℃ */};/*** brief 获取温度补偿后的抽头值* param base_tap: 基准抽头值* retval 补偿后的抽头值*/uint8_t MCP41010_GetTempCompensatedValue(uint8_t base_tap){uint32_t adc_value;float temperature;int16_t compensated;uint8_t temp_index;/* 读取温度传感器值 */HAL_ADC_Start(hadc1);if (HAL_ADC_PollForConversion(hadc1, 100) HAL_OK){adc_value HAL_ADC_GetValue(hadc1);/* 转换为摄氏度公式取决于具体传感器 */temperature (adc_value * 3.3 / 4096 - 0.76) / 0.0025 25;}HAL_ADC_Stop(hadc1);/* 查找补偿系数 */if (temperature -30)temp_index 0;else if (temperature 90)temp_index 13;elsetemp_index (uint8_t)((temperature 40) / 10);/* 应用补偿 */compensated (int16_t)base_tap temp_comp_table[temp_index];/* 限制范围 */if (compensated 0)compensated 0;if (compensated 255)compensated 255;return (uint8_t)compensated;}/*** brief 温度补偿应用示例*/void TempCompensation_Example(void){uint8_t target_tap 0x80; /* 目标中值 */uint8_t compensated_tap;MCP41010_Init(hspi3);while (1){/* 获取温度补偿后的抽头值 */compensated_tap MCP41010_GetTempCompensatedValue(target_tap);/* 设置补偿后的阻值 */MCP41010_SetTapping(compensated_tap);HAL_Delay(1000); /* 每秒更新一次 */}}