简介基于STM32的宠物陪伴机器人完整工程专为嵌入式、物联网、人工智能及相关专业的在校学生、教师和企业开发者设计既可作为课程设计、毕业设计也适合项目演示和课堂大作业帮助快速理解机器人控制与物联网通信的整体实现流程。压缩包共375个文件、12.32MB内容以C语言源码为主75个c文件、62个h文件并包含Keil工程配置文件、编译生成的axf/hex/map固件、14张PNG示意图、4个TXT说明文档以及批处理辅助脚本目录划分清晰可直接用Keil打开编译查看。目前已有309人学习下载在同类课设资源中具有一定参考价值。项目代码经过功能验证稳定可靠内部集成STM32主控逻辑、ESP8266通信模块、FatFs文件系统、LCD显示、定时器驱动等关键代码并提供编译脚本与固件输出既适合入门到进阶的嵌入式实验也方便在此基础上二次开发最终扩展为功能完整的宠物陪伴机器人。1. 为什么说课程设计项目的好与坏不在源码而在工程思路打开一个名为“基于STM32的宠物陪伴机器人源码及完整资料课程设计.zip”的包第一眼看到的通常不是清晰的工程逻辑而是散落在各处的 SystemInit、main.c、stm32f1xx_hal_uart.c以及一大堆注释风格各异的代码。真正拉开成绩差距的往往不是那几行 PWM 输出而是硬件引脚表、电源分区、状态机设计和联调顺序。这里顺着 STM32 宠物陪伴机器人的完整落地路径展开先从硬件选型确定系统架构再把舵机、超声波、语音模块的驱动源码逐个写透然后剖析源码工程结构并给出联调排错方法最后落到验收和答辩的加分细节。适合正在复现课程设计、做嵌入式毕业设计或第一次接触 STM32 工程源码的读者。2. 先射箭再画靶宠物陪伴机器人的硬件选型与 STM32 系统架构选型决定后续代码量和调试难度。不少课程设计把时间浪费在“板子能点亮但项目做不完”上根源就是一开始没把运动方案、引脚占用和电源拓扑想清楚。2.1 用舵机还是直流电机先把运动方案定下来宠物陪伴机器人的核心动作是头部转动、尾巴摆动、爪子抬升和投喂不需要跑得快反而要求每个动作可解释、可复现。课程设计里最常见的运动方案是用 2 到 3 个舵机搭出关节而不是做一套轮式底盘。SG90 便宜、轻、响应快适合头部和尾巴这类轻负载MG996R 扭矩达到 11kg·cm适合承担爪子落料的力矩。真正要留意的是两者峰值电流差异MG996R 启动瞬时电流能到 2.5A这在后续电源分区里会再次提到。舵机型号堵转扭矩工作电压典型脉宽范围峰值电流SG901.8kg·cm4.8V~6.0V500~2400us约 250mAMG996R11kg·cm4.8V~6.6V500~2500us约 2.5A如果题目没有强制要求“移动”我的建议是不要上直流电机。一旦引入驱动芯片和编码器调试面就从“一个 GPIO 输出 PWM”扩展到电机 PID、死区补偿、PWM 频率选择对课程设计的时间非常不友好。L298N 在 1A 以上负载时导通压降接近 2V很多标称 6V 的电机实际只有不到 4.5V表现就是板子正常但轮子无力排查比舵机麻烦得多。如果你想对比工业伺服方案那属于 stm32 控制伺服电机 485 的领域通信协议和 PWM 驱动完全不同这里只提一句不展开。市面上不少鱼缸喂食器用的就是这套“舵机加落料斗”的硬件逻辑说明这个方案在小型自动化设备里确实有成熟复用价值。2.2 STM32F103C8T6 的资源分配与引脚防冲突主控方面F103C8T6 是课程设计里的默认选项Cortex-M3 内核、72MHz 主频、64KB Flash、20KB RAM。三个 PWM 通道、一路串口、一路超声波加上若干 GPIO总占用不超过一半资源。选更大容量芯片不会带来评审加分反而会让时钟树、启动文件这些环节引入更多变量。APM32F103C8T6 经常被当作替代品引脚和寄存器兼容程序可以直接烧录但 Flash 容量必须一致遇到诡异现象先跑一个 GPIO 点灯程序验证时钟是否正常。引脚分配的关键是外设复用冲突。舵机 PWM 放在 TIM2_CH1/CH2/CH3对应 PA0/PA1/PA2这三个引脚不占用 USART1是最顺手的组合。语音模块和调试日志共用 USART1位置在 PA9/PA10。超声 Trig 放 PB0、Echo 放 PB1蜂鸣器放 PB5板上 LED 用 PC13。外设对象引脚复用功能电气方向头部舵机PA0TIM2_CH1PWM 输出尾巴舵机PA1TIM2_CH2PWM 输出爪子舵机PA2TIM2_CH3PWM 输出超声 TrigPB0普通 GPIO高速推挽输出超声 EchoPB1普通 GPIO浮空输入USART1 TXPA9复用推挽到语音模块 RXUSART1 RXPA10复用输入到语音模块 TX无源蜂鸣器PB5普通 GPIO推挽输出板载 LEDPC13普通 GPIO开漏输出void MX_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStruct {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); __HAL_RCC_GPIOB_CLK_ENABLE(); __HAL_RCC_GPIOC_CLK_ENABLE(); GPIO_InitStruct.Pin GPIO_PIN_0; // Trig GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull GPIO_NOPULL; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, GPIO_InitStruct); GPIO_InitStruct.Pin GPIO_PIN_1; // Echo GPIO_InitStruct.Mode GPIO_MODE_INPUT; GPIO_InitStruct.Pull GPIO_NOPULL; // 不要上拉 HAL_GPIO_Init(GPIOB, GPIO_InitStruct); GPIO_InitStruct.Pin GPIO_PIN_13; // 板载LED GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_OD; GPIO_InitStruct.Pull GPIO_PULLUP; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOC, GPIO_InitStruct); }PC13 开漏输出是因为板载 LED 通常接在 3.3V 与 PC13 之间拉低点亮。Echo 引脚不开上拉HC-SR04 空闲时内部把 Echo 拉低回波到达时由模块驱动拉高外部上拉电阻会让高低电平判断点偏移近距离测距值系统性偏大。这是排查超声误差时最容易忽略的点。2.3 复位、电源和时钟系统跑不稳先别怀疑代码硬件问题排在优先级第一位。最常见“舵机一转芯片复位”的原因是舵机瞬时大电流把主板 3.3V 拉低不是程序 Bug。常见做法是电池组 6V 或 7.4V 先供舵机再从同一电池组引出经过 AMS1117-3.3 给 MCU 供电两路共地。在舵机供电端并联 470uF 电解电容吸收启动尖峰这个问题基本消失。时钟配置从 8MHz 外部晶振 PLL 倍频到 72MHzHAL 库标准写法如下。RCC_OscInitTypeDef RCC_OscInitStruct {0}; 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; // 8MHz * 9 72MHz if (HAL_RCC_OscConfig(RCC_OscInitStruct) ! HAL_OK) { Error_Handler(); }如果你把 8MHz 晶振换成 16MHzPLLMUL 要改成 MUL4并同步检查 APB1 分频系数否则串口波特率和 HAL_Delay 都会跑偏。用 STM32CubeMX 修改单片机型号时外设和引脚会自动重建但启动文件和链接脚本里的 Flash 大小不会自动匹配F103C8 是 64KBROM Size 写 0x10000填成 0x20000 后程序能烧进去运行时却可能出现奇怪的数据覆盖。注意如果出现“舵机一转就复位”优先检查电源分区与共地而不是去改程序里的 PLL 配置。3. 把动作和感知落地STM32 外设驱动的源码与参数标定这章处理三个核心模块舵机 PWM、超声波测距和语音交互。每个模块都给出可直接抄进工程的代码以及调整参数时容易踩的坑。3.1 定时器 PWM 驱动舵机从频率、脉宽到角度映射舵机内部是直流电机、减速齿轮组和反馈电位器控制电路比较输入脉宽对应的目标角度与当前电位器反馈驱动电机转到目标位置。只要周期在 20ms 左右、高电平时间在 0.5ms 到 2.5ms 之间舵机就会输出期望角度。高电平时间的精度决定角度精度因此必须由硬件定时器输出 PWM而不是用延时函数模拟。参数值说明TIM2 计数频率1MHz72MHz / 72 预分频每 us 计 1 次ARR19999计 20000 次周期 20ms 对应 50HzCCR 起始值15001.5ms 脉宽舵机处于约 90 度角度映射pulse 500 angle/180*2000线性近似需实测微调void Servo_Init(TIM_HandleTypeDef *htim, uint32_t Channel) { TIM_OC_InitTypeDef sConfigOC {0}; sConfigOC.OCMode TIM_OCMODE_PWM1; sConfigOC.Pulse 1500; // 上电先回中间位置防抖动 sConfigOC.OCPolarity TIM_OCPOLARITY_HIGH; sConfigOC.OCFastMode TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(htim, sConfigOC, Channel); HAL_TIM_PWM_Start(htim, Channel); } void Servo_SetAngle(TIM_HandleTypeDef *htim, uint32_t Channel, float angle) { uint16_t pulse (uint16_t)(500.0f angle / 180.0f * 2000.0f); if (pulse 2450) pulse 2450; // 极限位留余量避免堵转 if (pulse 550) pulse 550; __HAL_TIM_SET_COMPARE(htim, Channel, pulse); }代码里把脉宽限制在 550 到 2450us而不是激进地使用 500 到 2500。多数舵机的实际机械行程比标称角度略小直接顶到极端会让齿轮组堵转发热课程设计连续演示十分钟就可能损坏舵机。正确做法是上电后先发 1500观察舵机是否在几何中位然后以 50us 步进递增记录机械限位点的脉宽值把映射公式里的上下限改成实测值。串口接入角度命令后这个标定过程可以被记录成日志答辩时能直接展示。如果舵机默认 50Hz 周期下的左右速度太慢不要通过改 ARR 提高频率标准舵机的内部控制电路是按 50Hz 周期设计的频率提高到 100Hz 以上会发热并缩短寿命。想要更快动作就把角度变化速率写死在状态机里每次任务只推进一小步。3.2 超声波避障Echo 高电平时长到距离的换算细节HC-SR04 的工作过程是Trig 拉高 10us 以上模块发送 8 个 40kHz 脉冲然后 Echo 输出高电平高电平持续时长等于声波往返时间。距离 cm 等于微秒数除以 58或者说乘以 0.017。测距的关键在于时间戳分辨率HAL_GetTick 只有毫秒级1ms 误差对应 17cm完全不可用所以要借用内核 DWT 周期计数器。void DWT_Init(void) { CoreDebug-DEMCR | CoreDebug_DEMCR_TRCENA_Msk; DWT-CYCCNT 0; DWT-CTRL | DWT_CTRL_CYCCNTENA_Msk; } float HC_SR04_GetDistance(void) { uint32_t start, end; uint32_t timeout 30000; HAL_GPIO_WritePin(TRIG_PORT, TRIG_PIN, GPIO_PIN_SET); DWT_Delay_Us(12); HAL_GPIO_WritePin(TRIG_PORT, TRIG_PIN, GPIO_PIN_RESET); while (HAL_GPIO_ReadPin(ECHO_PORT, ECHO_PIN) GPIO_PIN_RESET) { if (--timeout 0) return -1.0f; // 无回波返回无效值 } start DWT-CYCCNT; timeout 30000; while (HAL_GPIO_ReadPin(ECHO_PORT, ECHO_PIN) GPIO_PIN_SET) { if (--timeout 0) return -1.0f; } end DWT-CYCCNT; return (float)(end - start) / 72.0f * 0.017f; // 核心频率72MHz }DWT-CYCCNT 是 Cortex-M3 内核自带的周期计数器每个 CPU 周期加一不占用定时器外设对单路超声测距最轻量。SM72MHz 下把周期差除以 72 就得到微秒。返回 -1 表示测距失败主逻辑必须先判断这个异常值否则 -1 会被当成“非常近的障碍”触发误避障。尾迹时间戳的读取放在 while 循环里连续测三次取中间值做中值滤波能滤掉多径反射造成的零散尖峰。超声波探头正对软质物体时回波衰减明显容易测出跳变距离。演示时尽量让障碍物是纸箱或墙面减少软材料的干扰。3.3 交互反馈语音模块串口指令、蜂鸣器与状态灯宠物陪伴机器人需要给人反馈最简单方案是串口接语音模块。常见模块如 JQ8900 通过 UART 指令触发预存储的 mp3 文件波特率一般是 9600但不同批次可能默认 38400集成前先单独测试模块返回值再写入工程。void Voice_Play(uint8_t index) { uint8_t frame[4] {0xAA, 0x02, index, 0xA1}; HAL_UART_Transmit(huart1, frame, 4, 100); } void Buzzer_Beep(void) { for (uint8_t i 0; i 10; i) { HAL_GPIO_WritePin(BUZZ_PORT, BUZZ_PIN, GPIO_PIN_SET); DWT_Delay_Us(250); HAL_GPIO_WritePin(BUZZ_PORT, BUZZ_PIN, GPIO_PIN_RESET); DWT_Delay_Us(250); } }语音指令帧的校验字节计算方式因模块型号而异有的直接发 0xAA 0x02 index 0xA1 就能识别有的把校验算成其它值。买模块时向卖家要指令表并把命令封装统一放在 voice.c以后换模块只改这一个文件。脉冲蜂鸣器这里用 IO 翻转产生 2kHz 方波只适合播“嘀嘀”提示音如果要播旋律换用定时器 PWM 输出频率可变的信号占空比固定 50% 即可。PC13 板载 LED 用来做状态指示比串口日志更直观开机闪两下表示自检通过常亮表示进入避障等待快速闪烁表示超声故障。这样演示现场不用开串口也能看出程序走到了哪个状态。4. 源码工程结构与联调让课程设计代码按你预期跑起来从 zip 解压到全部外设动起来中间隔着源码阅读和排错两个环节。这章按“看懂目录—理顺调度—串口联调”的顺序展开。4.1 从 zip 到可烧录工程目录识别、芯片包与工程修复解压后先不要急着双击 uvprojx先看目录结构判断工程用的是标准库还是 HAL 库。HAL 库工程里 Drivers 文件夹内部有清晰的 STM32F1xx_HAL_Driver 子目录标准库工程则是一堆 stm32f10x_xxx.c 直接摊在用户目录下。路径作用课程设计主要改动点Core/Src系统时钟、main、中断回调main.c 写主逻辑Core/Inc头文件目录新增模块头文件Drivers/STM32F1xx_HAL_DriverHAL 库实现不修改Hardware 或 App板级驱动servo.c、ultrasonic.c重点阅读MDK-ARMKeil 工程文件双击打开打开工程后如果报找不到 stm32f1xx.h多半是 STM32 芯片包没装。在 Keil 的 Pack Installer 里搜索 STM32F1xx_DFP 并安装头文件和启动文件会自动补全。keil5 兼容 c51 和 stm32 安装时很多人把两个套件装到同一目录结果 ARM 编译器无法切换建议分目录安装用 License Management 分别选择 C51 和 ARM 授权。用 STM32 ST-LINK Utility 连接下载时Flash Download 页面会列出算法中容量 F103C8 不要勾成高容量 512KB 算法地址错位会产生难以排查的 HardFault。4.2 主循环还是 FreeRTOS用状态机把多个任务串起来宠物陪伴机器人不需要完整 RTOS裸机状态机完全够用但要把所有动作组织成有限状态而不是堆一长串 if 在 while 里。typedef enum { STATE_INIT, STATE_IDLE, STATE_SEARCH, STATE_AVOID, STATE_FEED, STATE_BACK } RobotState; void Robot_Task_Handler(void) { static RobotState state STATE_INIT; uint32_t now HAL_GetTick(); switch (state) { case STATE_INIT: if (now g_start_tick 200) { state STATE_IDLE; } break; case STATE_IDLE: if (g_ultrasonic_cm 30.0f) { state STATE_SEARCH; } break; case STATE_SEARCH: Servo_SetAngle(htim2, TIM_CHANNEL_1, g_scan_angle); if (g_ultrasonic_cm 10.0f) { state STATE_FEED; Voice_Play(1); } break; case STATE_FEED: state STATE_BACK; break; case STATE_BACK: state STATE_IDLE; break; default: state STATE_INIT; break; } }状态机的好处是每个状态只做一件事调试时可以强制把 state 赋成 STATE_FEED 单独验证投喂动作。主循环里禁止直接调 HAL_Delay 做长时间等待那样会让超声测距和舵机扫描全部停摆需要延时的动作改成“记录目标时间非阻塞查询”或者直接利用 HAL_GetTick 的差值判断时间片。FreeRTOS 需要项目里的变量和中断协同不上 RTOS 时状态机方案对课程设计而言更稳。如果你想把课程设计做出嵌入式内核的深度不用动 Linux 级的内核源码对照 FreeRTOS 源码看消息队列的阻塞唤醒机制就够了。把超声模块放进一个任务把投喂动作放进另一个任务两个任务用队列传距离值代码表达会比状态机更接近现代嵌入式开发方式。4.3 串口调试与常见错误排查从 printf 到 no target foundprintf 重定向是联调第一件事没有日志排错几乎靠猜。在 usart.c 里补上 fputc并把微库勾选上。int fputc(int ch, FILE *f) { HAL_UART_Transmit(huart1, (uint8_t *)ch, 1, 0xFFFF); return ch; }接下来可以做一个最简单的串口命令解析用角度和距离命令代替反复改代码烧录。void Debug_Command_Parse(char *cmd) { if (strncmp(cmd, servo, 5) 0) { int angle atoi(cmd 6); Servo_SetAngle(htim2, TIM_CHANNEL_1, (float)angle); printf(servo set to %d\r\n, angle); } else if (strncmp(cmd, dist, 4) 0) { float cm HC_SR04_GetDistance(); printf(dist: %.1f cm\r\n, cm); } }这条命令解析规则是收到以 servo 开头的字符串提取后面的数字作为目标角度收到 dist 则打印当前距离。串口接收中断把字节攒成整帧遇到换行符交给 Debug_Command_Parse日志和指令在同一通道完成。这样一个模块一个模块验证避免“全部接好一次调不通”的窘境。联调过程中最常碰到的几类问题按出现频率列一下报 error: no stm32 target found优先检查 SWD 的 SWDIO、SWCLK、GND 三根线按住板子复位键再点下载多数焊接不良的板子用这个办法能缓解。设备管理器里 stm32 virtual com port 带叹号通常是 USB 转串口驱动版本与系统不匹配换一个 USB 口或重装驱动一般能消失。printf 输出卡死检查中断优先级里 SysTick 是否被更高优先级中断长时间抢占或者 HAL_UART_Transmit 的超时时间从 0xFFFF 改小。串口收到大量乱码先确认 HSE 晶振实际频率和代码里的数值一致8MHz 晶振配成 MUL9 是 72MHz配成 MUL16 会直接超出 72MHz 上限。舵机抖动大概率不是代码问题而是舵机电源与 MCU 电源没分或者电容容量不足。烧录顺序建议固定为先电源指示灯亮再烧一个 GPIO 闪烁工程然后分别验证串口、舵机、超声最后才把状态机整机带起来。每验证一个模块就多一条日志整体联调时只看状态切换不看底层寄存器。5. 验收细节与答辩加分技巧把课程设计做成作品演示和答辩环节的准备工作往往比写代码更能拉开差距。下面这些细节是课程设计验收现场最常见的扣分点也是快速提分的部分。5.1 展示前检查这 5 个细节电池电压。演示通常持续 5 到 10 分钟MG996R 连续动作时电压掉得快演示前用万用表测舵机满行程下的电压低于 4.8V 就换电池或并联电容。舵机线束固定。三根线在关节活动处容易折断用热缩管包住焊点扎带固定在支架上。这不是外观分而是可靠性分。复位按钮并 10nF 电容。反复烧录后 NRST 引脚容易被调试器干扰并联小电容能让复位信号更干净减少偶发复位。删除调试残留。联调用的 printf 注释掉测试用的固定延时删掉保持代码干净。答辩时老师翻代码看到一堆测试垃圾比看到 Bug 更扣分。整机重新上电测试。从关机状态开机完整跑三遍观察状态灯和串口日志确保上电瞬间舵机不会猛甩到极限角度。5.2 答辩讲代码的两条路线状态机和中断优先级第一条路线是讲状态机为什么初始化后 200ms 才进入待机为什么超声波距离小于 30cm 进入扫描、小于 10cm 才投喂这些阈值从哪里来回答时要能说出“30cm 是舵机摆动一个周期内能发现宠物的安全距离10cm 是爪子落料能覆盖的范围”而不是“我随便设的”。展示状态切换日志配合硬件动作比背 PPT 有力得多。第二条路线是讲中断优先级为什么 Echo 用轮询而非外部中断在 F103C8T6 上单个回波测量期间 CPU 本来就空闲轮询读取 DWT 周期计数器反而比外部中断加输入捕获更简单如果有多个超声模块才需要把 Echo 接到 EXTI 上。这个取舍讲清楚老师就知道你理解中断而不是只会用 HAL 库。扩展方向不用贪多挑一个点做出效果。想加视觉识别可以研究 k210 与 stm32 通讯串口帧按长度、命令、校验字设计避免粘包想加远程控制参考 stm32 8266 宿舍控制灯开发实战的思路用 ESP8266 做远程投喂开关想提升语音质量stm32 数播 iis 设置里的 MCLK 与采样率配置值得研究换成 I2S 音频解码后能播放更自然的声音。把舵机角度标定过程沉淀成串口日志每一组 pulse 值都对应一组实测角度这组数据比“心得体会”更能说明你会调试嵌入式系统。本文还有配套的精品资源点击获取