1. 从零开始为什么选择STM32F103C8T6驱动SG90舵机如果你刚开始接触嵌入式开发或者想从Arduino过渡到更专业的微控制器平台那么用STM32F103C8T6俗称“蓝桥杯最小系统板”或“核心板”来控制一个SG90舵机绝对是一个绝佳的入门项目。这个组合看似简单却涵盖了从硬件连接到软件配置再到核心控制原理的完整知识链。很多新手可能会觉得用Arduino的Servo库一行代码就能搞定的事情为什么还要用STM32这么“复杂”的芯片这里面的门道恰恰是区分“玩具级”玩法和“工程级”开发的开始。SG90舵机是一种位置角度伺服驱动器它内部集成了电机、减速齿轮组、控制电路和电位器。你给它一个周期性的PWM脉冲宽度调制信号它就能根据信号中高电平的持续时间即脉冲宽度精确地转动到对应的角度。而STM32F103C8T6作为一款经典的ARM Cortex-M3内核MCU其强大之处在于能提供精准、稳定且可灵活配置的PWM输出这是Arduino的模拟PWM引脚难以比拟的。更重要的是通过这个项目你将系统地学习如何使用ST官方的HAL库和CubeMX工具链这是现代STM32开发的“标准姿势”无论是做智能小车、机械臂还是机器人这都是绕不开的基础技能。我最初接触这个项目时也踩过不少坑比如以为随便一个引脚就能输出PWM结果舵机纹丝不动或者配置好了但舵机抖动得厉害又或者角度控制完全不线性。这些问题的根源都在于对PWM信号规格和STM32定时器工作模式的理解不够透彻。接下来我将带你一步步拆解从硬件原理到软件配置再到代码调试手把手让你不仅能让舵机动起来更能理解它为什么这么动以及如何让它动得更好。2. 硬件连接与信号原理SG90舵机到底需要什么样的PWM在写代码之前我们必须先搞清楚硬件上要做什么。很多教程一上来就讲CubeMX配置但如果硬件连接错了或者理解有偏差软件配置得再漂亮也是白搭。2.1 SG90舵机的PWM信号规格SG90是一种最常见的9克微型舵机它有三根线棕色GND、红色VCC和橙色信号线。它的控制逻辑非常标准电源VCC接5VGND接MCU的GND。注意虽然有些SG90标称工作电压为4.8V-6.0V但直接接STM32的3.3V可能无法正常工作扭矩不足或无法转动所以通常需要外部5V供电。MCU的3.3V IO口输出信号控制5V的舵机这在电平上是兼容的3.3V高电平 舵机逻辑高电平阈值。控制信号需要的是一个周期为20ms即频率为50Hz的PWM方波。脉冲宽度与角度关系0.5ms的高电平脉冲对应舵机转动到0度最左位置。1.5ms的高电平脉冲对应舵机转动到90度中间位置。2.5ms的高电平脉冲对应舵机转动到180度最右位置。这是一个线性关系。理论上脉冲宽度在0.5ms到2.5ms之间变化舵机角度就在0到180度之间变化。但实际应用中边界值可能会有些许偏差需要微调。注意市面上有些SG90的行程可能是0-180度有些可能是0-270度对应脉冲宽度0.5ms-2.5ms购买时需留意规格书。我们以最常见的180度版本为例。2.2 STM32F103C8T6的PWM输出能力与引脚选择STM32的PWM输出功能是由其高级定时器TIM1, TIM8和通用定时器TIM2, TIM3, TIM4的“输出比较”通道产生的。F103C8T6有3个通用定时器TIM2, TIM3, TIM4每个定时器有4个独立的通道CH1-CH4每个通道可以映射到特定的GPIO引脚上。这里第一个关键点来了不是所有GPIO都能输出PWM你必须使用具有“定时器通道输出”复用功能的引脚。对于F103C8T6常见的PWM引脚有TIM2_CH1: PA0TIM2_CH2: PA1TIM2_CH3: PA2TIM2_CH4: PA3TIM3_CH1: PA6TIM3_CH2: PA7TIM3_CH3: PB0TIM3_CH4: PB1TIM4_CH1: PB6TIM4_CH2: PB7TIM4_CH3: PB8TIM4_CH4: PB9为了方便我们选择PA6作为PWM输出引脚它对应TIM3_CH1。你的硬件连接应该是SG90 红线 - 5V电源正极。SG90 棕线 - 5V电源负极同时与STM32的GND相连共地这是必须的。SG90 橙线 - STM32的PA6引脚。2.3 计算定时器参数让STM32产生50Hz的PWM这是整个项目的核心原理部分。STM32的定时器通过一个计数器配合预分频器PSC和自动重装载寄存器ARR来产生特定频率的波形。我们的目标是产生一个频率为50Hz周期T20ms的PWM并且能够通过改变一个值捕获比较寄存器CCR来精确控制高电平的宽度0.5ms-2.5ms。步骤分解确定计时基准STM32F103C8T6默认使用内部高速时钟HSI8MHz或者通过外部晶振通常8MHz倍频到72MHz系统时钟SYSCLK。我们假设使用最常见的72MHz主频。定时器TIM3的时钟APB1总线通常是系统时钟的二分频即36MHz。但CubeMX配置时会自动处理我们只需关注定时器时钟。设定计数周期ARRARR决定了计数器从0数到多少后归零这个周期就是PWM的周期。为了计算方便我们让一个计数周期对应1微秒1us。这样20ms的周期就需要20000个计数周期。所以我们可以先设定ARR 19999因为计数器从0开始计数0到19999是20000个数。计算预分频值PSC如何让计数器每1us计一个数呢定时器的计数频率 定时器时钟 / (PSC 1)。我们需要这个频率是1MHz因为1/1MHz 1us。假设定时器时钟是72MHzCubeMX中配置TIM3的时钟源为内部时钟且APB1预分频器不为1时定时器时钟可能会是72MHz或36MHz这里以72MHz为例。那么PSC (定时器时钟 / 目标计数频率) - 1 (72MHz / 1MHz) - 1 71。计算对应角度的CCR值CCR捕获/比较寄存器的值决定了PWM输出中高电平的宽度。计数器从0开始向上计数当计数值小于CCR时输出高电平或低电平取决于极性配置大于等于CCR时翻转输出。0度0.5ms高电平CCR 500因为0.5ms 500us1us计一个数。90度1.5ms高电平CCR 1500。180度2.5ms高电平CCR 2500。参数总结基于72MHz定时器时钟假设PSC (Prescaler): 71ARR (AutoReload Register): 19999PWM频率: 72MHz / ((711)(199991)) 72,000,000 / (7220000) 50 HzCCR范围: 500 ~ 2500对应0~180度。实操心得这些计算是理解PWM配置的基石。在实际使用CubeMX时你只需要输入想要的PWM频率50Hz和计数器分辨率比如20000它会自动帮你计算PSC值。但自己会算才能在被问到“为什么我的舵机转不到180度”时快速定位是ARR设小了还是CCR最大值超限了。3. 使用STM32CubeMX进行图形化配置理论打通后我们进入实战环节。STM32CubeMX是ST官方推出的图形化配置工具能极大简化初始化代码的生成。下面我们一步步配置一个让PA6输出PWM的工程。3.1 新建工程与时钟树配置新建工程打开CubeMX点击“New Project”。在Part Number搜索框输入“STM32F103C8”选择“STM32F103C8Tx”。双击进入项目。系统核心SYS配置在左侧“System Core”-“SYS”中将“Debug”改为“Serial Wire”。这非常重要它释放了PA13和PA14引脚用于SWD下载调试否则这两个引脚可能被默认的JTAG功能占用导致你无法下载程序。配置时钟树RCC在“System Core”-“RCC”中将“High Speed Clock (HSE)”设置为“Crystal/Ceramic Resonator”。这意味着我们将使用外部8MHz晶振。点击上方“Clock Configuration”标签页。你会看到一个复杂的时钟树图。找到输入源选择“HSE”。将“PLL Source Mux”选择为“HSE”。将“PLLMUL”设置为“x9”倍频。将“System Clock Mux”选择为“PLLCLK”。此时你应该看到“HCLK”显示为72MHz。APB1总线时钟定时器时钟源之一会自动显示为36MHz。但请注意当APB1预分频系数不为1时挂载在其上的定时器时钟会是APB1时钟的2倍即72MHz。CubeMX会处理好这个细节。简单做法你也可以直接点击“HCLK”输入框手动输入72然后按回车CubeMX会自动帮你计算并填充其他参数。这是最稳妥的方法。3.2 定时器与PWM通道配置启用定时器在左侧“Timers”中找到“TIM3”。选择时钟源在TIM3的配置页面“Clock Source”选择“Internal Clock”。配置PWM通道下方“Channel1”选择“PWM Generation CH1”。这时右侧芯片图的PA6引脚会自动被标记为绿色TIM3_CH1。参数设置切换到“Parameter Settings”标签页。Prescaler (PSC): 输入71。Counter Mode: “Up”向上计数模式。Counter Period (ARR): 输入19999。Internal Clock Division (CKD): “No Division”。auto-reload preload: “Enable”。这个建议启用可以防止在修改ARR时产生毛刺。PWM模式设置向下滚动找到“PWM Generation Channel 1”部分。Mode: “PWM mode 1”。在这个模式下当计数器小于CCR时输出有效电平我们后面定义大于等于CCR时输出无效电平。Pulse (CCR): 先设置为1500对应90度中间位置。这个值后续在代码中可以动态修改。Output Compare Preload: “Enable”。启用预装载这样你修改CCR值后会在下一个更新事件时才生效保证波形稳定。CH Polarity: “High”。这意味着“有效电平”是高电平。所以我们的PWM波形将是前1500个计数周期为高电平后18500个计数周期为低电平。这正好符合我们的要求。3.3 GPIO与工程生成设置GPIO检查在“Pinout Configuration”视图的芯片图上确认PA6已被配置为TIM3_CH1。你也可以在“System Core”-“GPIO”中查看PA6的详细配置默认模式应为“Alternate Function Push Pull”无需改动。项目管理点击上方“Project Manager”标签页。“Project”-“Project Name”给你的工程起个名字如“SG90_Control”。“Project”-“Project Location”选择一个路径。“Toolchain / IDE”选择你使用的IDE如“MDK-ARM (V5)”对应Keil uVision5或“STM32CubeIDE”。代码生成设置“Code Generator”-“Generated files”: 勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”这会让代码结构更清晰。同样在“Code Generator”下建议勾选“Copy all used libraries into the project folder”这样工程可以独立移植。生成代码点击右上角的“GENERATE CODE”。CubeMX会生成完整的初始化代码工程并打开你选择的IDE。4. 编写控制代码从固定角度到平滑转动生成了工程我们来到了最关键的编程环节。HAL库的API已经为我们封装好了底层操作我们的任务就是调用它们。4.1 基础启动与固定角度控制打开工程后进入主函数所在的main.c文件。我们需要在/* USER CODE BEGIN 2 */和/* USER CODE END 2 */之间添加用户代码。首先启动PWM输出/* USER CODE BEGIN 2 */ // 启动TIM3的通道1输出PWM HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1); /* USER CODE END 2 */然后在主循环中我们可以尝试让舵机转到几个固定角度。但注意直接修改CCR寄存器可能不太直观。HAL库提供了__HAL_TIM_SET_COMPARE宏来方便地设置CCR值。/* Infinite loop */ /* USER CODE BEGIN WHILE */ while (1) { // 转到0度 __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, 500); HAL_Delay(1000); // 等待1秒 // 转到90度 __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, 1500); HAL_Delay(1000); // 转到180度 __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, 2500); HAL_Delay(1000); /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */编译下载程序到开发板连接好舵机你应该能看到舵机在0度、90度、180度三个位置来回转动。4.2 实现角度控制函数与线性扫掠上面的代码虽然能工作但很不灵活。我们最好封装一个角度控制函数。// 在main.c文件开头USER CODE BEGIN Includes之后添加函数声明 /* USER CODE BEGIN PFP */ void Servo_SetAngle(TIM_HandleTypeDef *htim, uint32_t Channel, float angle); /* USER CODE END PFP */ // 在USER CODE BEGIN 4和USER CODE END 4之间添加函数定义 /* USER CODE BEGIN 4 */ /** * brief 设置舵机角度 * param htim: 定时器句柄指针如htim3 * param Channel: 定时器通道如TIM_CHANNEL_1 * param angle: 目标角度范围0.0 ~ 180.0 * retval None */ void Servo_SetAngle(TIM_HandleTypeDef *htim, uint32_t Channel, float angle) { // 将角度限制在0-180范围内 if(angle 0.0f) angle 0.0f; if(angle 180.0f) angle 180.0f; // 线性映射角度(0~180) - 脉冲宽度(500~2500) // CCR 500 (angle / 180.0) * (2500 - 500) uint16_t ccr_val 500 (angle / 180.0f) * 2000; // 设置捕获比较寄存器值 __HAL_TIM_SET_COMPARE(htim, Channel, ccr_val); } /* USER CODE END 4 */现在主循环可以写得非常清晰并且可以实现平滑扫掠/* USER CODE BEGIN 2 */ HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1); /* USER CODE END 2 */ /* Infinite loop */ /* USER CODE BEGIN WHILE */ while (1) { // 从0度平滑扫掠到180度 for(float angle 0.0f; angle 180.0f; angle 1.0f) { Servo_SetAngle(htim3, TIM_CHANNEL_1, angle); HAL_Delay(20); // 每20ms移动1度扫完一圈大约3.6秒 } HAL_Delay(500); // 从180度平滑扫掠回0度 for(float angle 180.0f; angle 0.0f; angle - 1.0f) { Servo_SetAngle(htim3, TIM_CHANNEL_1, angle); HAL_Delay(20); } HAL_Delay(500); /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */4.3 使用HAL库函数动态调整PWM参数除了直接操作CCRHAL库也提供了更规范的函数来启动、停止和修改PWM。例如我们可以使用HAL_TIM_PWM_Start和HAL_TIM_PWM_Stop来控制输出开关用__HAL_TIM_SET_COMPARE或__HAL_TIM_GET_COMPARE来读写CCR值。一个更工程化的写法是将舵机控制相关的操作封装到一个独立的servo.c/.h文件中这样主程序逻辑会更清晰也便于代码复用。5. 调试、优化与常见问题排查让舵机动起来只是第一步让它稳定、精确、不抖动地工作才是真正的挑战。下面分享几个我踩过的坑和解决方案。5.1 舵机抖动问题分析与解决现象舵机到达指定位置后不停地震动或发出“滋滋”声无法稳定。原因与排查电源功率不足这是最常见的原因。SG90在空载时电流约100-200mA但在堵转或启动瞬间可能超过500mA。USB供电500mA或LDO线性稳压器可能无法提供足够电流。解决使用独立的5V/1A以上的电源模块如LM2596降压模块为舵机供电并与MCU共地。确保电源线足够粗。PWM信号不稳定如果PWM信号的周期或占空比有微小波动舵机内部的反馈电路会不断尝试修正导致抖动。解决检查代码中是否有其他中断或任务频繁打断PWM定时器。确保修改CCR值的操作是原子的使用__HAL_TIM_SET_COMPARE宏是安全的。在CubeMX中启用定时器的“auto-reload preload”和通道的“Output Compare Preload”功能。机械负载过重或卡死如果舵机轴被外力阻挡它会持续输出最大扭矩试图到达位置导致发热和抖动。解决检查机械结构是否顺畅避免超过舵机扭矩的负载。5.2 角度不准或行程范围不对现象设置90度实际可能转到80度或100度或者无法转到0度或180度的极限位置。原因与排查PWM参数计算错误回顾第2.3节的计算。确认你的定时器时钟频率、PSC和ARR值设置正确。一个快速验证的方法是用示波器或逻辑分析仪测量PA6引脚的波形看周期是否是20ms高电平时间是否随CCR值线性变化。舵机个体差异与死区不同厂家、甚至同批次的SG90其中位脉宽1.5ms对应的实际角度可能有±10度的偏差。而且脉宽在接近极限值如0.5ms和2.5ms时舵机内部的机械限位或电路可能已经饱和无法继续转动。解决进行校准。写一个测试程序让CCR值从400逐步增加到2600观察舵机的实际行程。记录下刚好开始转动对应0度和刚好转到极限对应180度时的CCR值用这两个值替换公式中的500和2500。代码示例校准后#define SERVO_MIN_CCR 420 // 实测0度对应的CCR #define SERVO_MAX_CCR 2480 // 实测180度对应的CCR #define SERVO_CCR_RANGE (SERVO_MAX_CCR - SERVO_MIN_CCR) void Servo_SetAngle_Calibrated(TIM_HandleTypeDef *htim, uint32_t Channel, float angle) { if(angle 0.0f) angle 0.0f; if(angle 180.0f) angle 180.0f; // 使用校准后的参数进行映射 uint16_t ccr_val SERVO_MIN_CCR (angle / 180.0f) * SERVO_CCR_RANGE; __HAL_TIM_SET_COMPARE(htim, Channel, ccr_val); }5.3 多路舵机控制与定时器资源规划一个定时器如TIM3的四个通道CH1-CH4可以独立产生不同占空比的PWM但它们共享同一个ARR和PSC即频率必须相同。这对于控制多个同型号舵机来说是完美的因为它们的控制频率都是50Hz。如何连接TIM3_CH1 (PA6) - 舵机1信号线TIM3_CH2 (PA7) - 舵机2信号线TIM3_CH3 (PB0) - 舵机3信号线TIM3_CH4 (PB1) - 舵机4信号线代码控制在CubeMX中启用这四个通道的PWM Generation然后在代码中分别启动它们并独立设置各自的CCR值。// 启动所有通道 HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1); HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_2); HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_3); HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_4); // 独立控制每个舵机 Servo_SetAngle(htim3, TIM_CHANNEL_1, 45.0f); // 舵机1转到45度 Servo_SetAngle(htim3, TIM_CHANNEL_2, 90.0f); // 舵机2转到90度 // ...如果你需要控制超过4个舵机或者需要不同频率的PWM就需要使用多个定时器如TIM2, TIM4。F103C8T6的定时器资源有限需要合理规划。5.4 进阶使用DMA实现多路舵机同步更新在复杂的应用如机械臂中可能需要同时更新多个舵机的角度以避免逐个更新带来的不同步和延迟。这时可以使用DMA直接存储器访问。思路将一个包含所有舵机目标CCR值的数组作为数据源通过DMA一次性搬运到各个定时器通道的CCR寄存器中。这样所有更新会在同一个定时器更新事件中同时生效。配置步骤以TIM3的4个通道为例CubeMX配置DMA在TIM3配置页的“DMA Settings”中为TIM3_CH1、CH2、CH3、CH4分别添加DMA请求。方向为“Memory To Peripheral”数据宽度为“Word”32位因为CCR寄存器是16位但DMA通常以字为单位传输更高效。代码实现定义一个数组uint32_t servo_ccr[4];存放四个通道的CCR值。使用HAL_TIM_PWM_Start_DMA函数启动PWM和DMA传输。当需要更新所有舵机角度时只需更新servo_ccr数组然后DMA会在下一个PWM周期自动完成搬运。这种方法实现了“同步更新”对于要求动作连贯性的应用至关重要。不过DMA配置相对复杂初次接触可以先用简单的__HAL_TIM_SET_COMPARE方式待基础扎实后再研究。6. 项目扩展与工程化思考掌握了基础的单舵机控制后我们可以将这个项目作为基石向更实际的应用扩展。扩展一加入电位器或传感器进行反馈控制思路利用STM32的ADC功能读取一个电位器的电压值对应旋转角度然后映射为舵机的目标角度。这样就实现了一个简单的“手动操纵杆”或位置随动系统。关键点ADC采样值需要滤波如滑动平均滤波以消除抖动映射函数可能需要校准。扩展二构建简单的二自由度云台硬件两个SG90舵机一个用于水平Pan转动一个用于垂直Tilt转动通过支架连接。软件为两个舵机分配不同的定时器通道如TIM3_CH1和TIM3_CH2。可以编写函数Set_PanTilt(float pan_angle, float tilt_angle)来同时控制两个轴。扩展三与上位机通信思路通过STM32的串口UART接收来自电脑如串口助手或蓝牙模块的指令解析指令中的角度值再控制舵机转动。协议可以定义简单的文本协议如”A90T45\n”表示水平轴转到90度垂直轴转到45度。这涉及到串口中断接收、数据解析和命令处理是迈向复杂系统的重要一步。工程化建议模块化编程将舵机驱动、ADC采集、串口解析等功能分别写成独立的.c/.h文件。主程序只负责调用高层接口和调度逻辑。使用RTOS如果项目复杂度增加如需要同时控制舵机、读取多个传感器、处理通信可以考虑引入FreeRTOS等实时操作系统将不同任务分配到不同线程中提高系统的响应性和可靠性。CubeMX可以很方便地集成FreeRTOS。电源管理多舵机系统对电源要求很高务必做好电源去耦在舵机电源入口处并联大电容如1000uF电解电容和0.1uF陶瓷电容并考虑使用单独的电源模块。从点亮一个LED到控制一个舵机再到构建一个多自由度系统STM32的学习路径就是这样一环扣一环。SG90舵机项目虽然小但它像一把钥匙帮你打开了定时器、PWM、HAL库和硬件控制的大门。理解了这里的每一个参数和步骤再去学习控制直流电机、步进电机、无刷电机你会发现底层逻辑都是相通的——无非是更复杂的定时器模式、更精密的信号控制和更强的驱动电路。下次当你看到那些炫酷的机器人舞蹈视频时你就能清晰地知道每一个流畅动作的背后都是无数个精准的PWM脉冲在有序地跳动。