手把手教你用STM32F103ZET6和GUI Guider做个电机控制界面（Keil5工程分享）-平芜编程栈

基于STM32F103ZET6的电机控制UI开发实战：从GUI设计到硬件联动

在工业控制和智能设备领域，嵌入式图形用户界面(GUI)正变得越来越重要。对于电机控制这类需要实时交互的应用场景，一个直观、响应迅速的操作界面不仅能提升用户体验，还能显著提高调试效率。本文将带你使用STM32F103ZET6微控制器和GUI Guider工具，从零开始构建一个完整的电机控制界面，并实现与底层硬件的深度交互。

1. 开发环境搭建与工具链配置

1.1 硬件准备清单

要完成这个项目，你需要准备以下硬件组件：

STM32F103ZET6开发板（或兼容的最小系统板）
2.8寸TFT触摸屏（分辨率240×320）
电机驱动模块（如L298N或DRV8833）
直流电机（12V以下）
USB转TTL串口模块（用于调试）
必要的连接线和电源

硬件连接要点：

屏幕的SPI接口连接到STM32的对应引脚
电机驱动模块的PWM输入连接到TIM1或TIM2通道
确保所有地线(GND)共地

1.2 软件工具安装

开发所需的软件工具包括：

Keil MDK-ARM（建议使用Keil5最新版本）
STM32CubeMX（用于外设初始化）
GUI Guider（NXP提供的LVGL可视化设计工具）
ST-Link Utility（或其它烧录工具）

安装GUI Guider时需要注意：

# 在Linux下安装示例 wget https://github.com/lvgl/lv_gui_guider/releases/download/v1.0.0/GUI_Guider_1.0.0.AppImage chmod +x GUI_Guider_1.0.0.AppImage ./GUI_Guider_1.0.0.AppImage

提示：Windows用户可直接下载exe安装包，安装过程中建议选择"添加到系统PATH"选项

2. LVGL与GUI Guider基础配置

2.1 LVGL库的获取与裁剪

LVGL是一个轻量级的开源图形库，特别适合资源有限的嵌入式系统。获取最新LVGL库的方法：

访问LVGL官方GitHub仓库
下载v8.x稳定版本
根据项目需求裁剪不需要的组件

关键配置文件修改：

// lv_conf.h中的重要参数 #define LV_COLOR_DEPTH 16 // 匹配TFT屏幕色深 #define LV_HOR_RES_MAX 240 // 水平分辨率 #define LV_VER_RES_MAX 320 // 垂直分辨率 #define LV_USE_LOG 1 // 启用日志调试

2.2 GUI Guider界面设计入门

GUI Guider提供了所见即所得的界面设计体验。创建新项目时需注意：

选择正确的显示分辨率（240×320）
设置颜色格式为RGB565
选择"Light"主题作为起点

常用UI组件在电机控制中的应用：

按钮：启停控制、模式切换
滑块：速度调节、参数设置
图表：实时显示转速曲线
标签：显示当前状态和参数
开关：功能使能控制

3. 电机控制UI的深度开发

3.1 界面布局与交互设计

一个典型的电机控制界面应包含以下功能区域：

状态显示区：当前转速、温度、运行时间
控制区：启动/停止按钮、急停开关
参数调节区：速度滑块、加速度设置
日志区：运行状态和错误信息

UI设计技巧：

使用容器(Container)组织相关控件
为重要操作添加视觉反馈（如按钮按下效果）
合理使用颜色编码（红色表示警告/停止）
保持界面简洁，避免信息过载

3.2 关键代码实现

将UI事件与硬件操作绑定的核心代码：

// 电机控制回调函数示例 void motor_ctrl_event_cb(lv_event_t * e) { lv_obj_t * slider = lv_event_get_target(e); int32_t speed = lv_slider_get_value(slider); // 设置PWM占空比（假设使用TIM1通道1） TIM1->CCR1 = speed * MAX_PWM / 100; // 更新UI显示 lv_label_set_text_fmt(ui->speed_label, "%d%%", speed); }

注意：实际应用中需要添加参数范围检查和故障保护逻辑

PWM初始化代码片段：

// 使用CubeMX生成的PWM初始化代码 void MX_TIM1_Init(void) { TIM_HandleTypeDef htim1; htim1.Instance = TIM1; htim1.Init.Prescaler = 71; // 72MHz/72 = 1MHz htim1.Init.CounterMode = TIM_COUNTERMODE_UP; htim1.Init.Period = 999; // 1MHz/1000 = 1kHz PWM频率 htim1.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; HAL_TIM_PWM_Init(&htim1); TIM_OC_InitTypeDef sConfigOC; sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 0; // 初始占空比为0 sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(&htim1, &sConfigOC, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); }

4. 系统集成与性能优化

4.1 内存管理与性能调优

STM32F103ZET6仅有64KB RAM，需要精心管理内存：

优化策略：

使用LVGL的内存池功能
限制同时显示的界面数量
启用LVGL的异步刷新模式
合理设置LVGL的刷新周期

// 内存配置示例 #define LV_MEM_SIZE (32 * 1024) // 分配32KB给LVGL #define LV_DISP_DEF_REFR_PERIOD 30 // 刷新周期30ms

4.2 触摸屏校准与抗干扰

电阻式触摸屏需要校准才能获得最佳体验：

实现四点校准算法
添加软件滤波（如移动平均）
设置合理的采样频率
实现触摸事件去抖动

校准数据存储：

// 将校准参数保存到Flash void Save_Calibration_Data(int16_t calib[6]) { FLASH_Unlock(); FLASH_ErasePage(0x0801F000); for(int i=0; i<6; i++) { FLASH_ProgramHalfWord(0x0801F000 + i*2, calib[i]); } FLASH_Lock(); }

4.3 多任务协同设计

在FreeRTOS环境下实现UI与控制的协同：

// 典型任务划分 void vMotorControlTask(void *pvParameters) { while(1) { // 读取编码器反馈 // PID计算 // 更新PWM输出 vTaskDelay(10); // 100Hz控制频率 } } void vUITask(void *pvParameters) { lv_init(); // 显示初始化 while(1) { lv_task_handler(); vTaskDelay(30); // ~33Hz刷新率 } }

5. 高级功能实现

5.1 参数保存与加载

实现用户设置的持久化存储：

typedef struct { uint16_t max_speed; uint16_t acceleration; uint8_t direction; uint16_t saved_presets[3]; } MotorConfig; void Save_Config_to_EEPROM(MotorConfig *cfg) { uint8_t *p = (uint8_t*)cfg; for(int i=0; i<sizeof(MotorConfig); i++) { HAL_I2C_Mem_Write(&hi2c1, 0xA0, i, I2C_MEMADD_SIZE_8BIT, p+i, 1, 100); } }

5.2 安全保护机制

完善的电机控制系统需要多重保护：

软件保护：
- 过流检测
- 堵转保护
- 温度监控
- 紧急停止
硬件保护：
- 硬件看门狗
- 独立比较器
- 保险丝

保护逻辑实现：

void Safety_Check(void) { if(Current > MAX_CURRENT) { Motor_Stop(); lv_msgbox_create(NULL, "错误", "过流保护触发", NULL, true); } if(Temperature > MAX_TEMP) { Motor_Stop(); lv_msgbox_create(NULL, "警告", "温度过高", NULL, true); } }

5.3 远程监控与调试

通过串口实现简易的远程监控：

void USART1_IRQHandler(void) { if(USART1->SR & USART_SR_RXNE) { uint8_t cmd = USART1->DR; switch(cmd) { case 'S': // 获取状态 printf("Speed:%d,Current:%d,Temp:%d\n", current_speed, motor_current, temperature); break; case 'P': // 设置参数 // 参数解析逻辑 break; } } }

6. 项目实战：完整的电机控制面板

6.1 界面元素与硬件功能映射

构建一个包含以下功能的完整控制面板：

UI元素	硬件功能	相关外设
启动/停止按钮	电机使能控制	GPIO
速度滑块	PWM占空比调节	TIM1
方向开关	GPIO电平控制	GPIO
转速显示	编码器输入捕获	TIM3
温度显示	ADC采样	ADC1
电流表	电流传感器ADC采样	ADC2

6.2 状态机设计

实现电机控制的状态逻辑：

typedef enum { STATE_IDLE, STATE_STARTING, STATE_RUNNING, STATE_STOPPING, STATE_FAULT } MotorState; void Motor_State_Machine(MotorState *state) { static uint32_t start_time; switch(*state) { case STATE_IDLE: if(start_command) { *state = STATE_STARTING; start_time = HAL_GetTick(); } break; case STATE_STARTING: if(HAL_GetTick() - start_time > SOFT_START_TIME) { *state = STATE_RUNNING; } // 软启动逻辑 break; case STATE_RUNNING: if(stop_command || fault_condition) { *state = STATE_STOPPING; } break; case STATE_STOPPING: // 减速停止逻辑 *state = STATE_IDLE; break; case STATE_FAULT: // 故障处理 break; } }