PMSM 磁链观测器快速入门

概述

本入门带你 5-10 分钟跑通 PMSM（永磁同步电机）磁链观测器算法的核心数据分析闭环：加载离线数据 → 应用磁链观测器算法 → 查看 6 个派生通道波形 → 对比 actual/estimated 误差。

读完后你将掌握 PMSM 算法精度评估的基本工作流，可以独立完成一次"算法跑完→看波形→评估准不准"的完整流程。

一、准备工作

1.1 启动 EmeyeStudio

运行 EmeyeStudio 可执行文件（默认路径 EmeyeStudio\debug-qt5\EmeyeStudio.exe）。

1.2 打开工作区

1. 菜单 文件 → 打开工作区
2. 选择示例工作区文件（如 work\hard-demo\hard-demo.workspace）
3. 确认左侧资源管理器显示对应的工程节点（如 debug-1）

1.3 加载离线数据

1. 在左侧资源管理器中展开工程节点 → 数据 子节点
2. 双击一个 .xcpdata 文件（推荐选择数据量较大的文件，便于后续观察派生通道）
3. 确认波形图区域显示了数据曲线

二、应用 PMSM 磁链观测器算法

2.1 打开算法应用对话框

点击工具栏上的 算法 按钮（带齿轮图案的图标），弹出"算法应用"对话框。

2.2 选择算法

在对话框左侧的算法树中展开 电机控制 分组，点击 PMSM磁链观测器 节点，右侧将显示算法配置面板。

2.3 配置算法参数

算法参数表格如下，hard-demo 示例数据可保持默认值；真实电机调试时请按电机铭牌修改对应参数。

2.4 映射输入变量

对每个算法输入，从"数据变量"下拉框选择一个已加载的数据通道。下拉框的变量来源是当前已加载到波形图的数据通道；如果下拉框为空，请先回到"一、准备工作"完成数据加载。

2.5 选择输出通道

勾选需要的输出项（建议 6 项全部勾选以获得完整的算法输出）：

2.6 应用算法

1. 输出前缀保持默认值 flux_obs_（用于派生通道命名隔离，避免与原始通道重名）
2. 点击 应用 按钮
3. 对话框关闭，算法开始执行

三、查看派生通道波形

算法应用后，你将看到波形图区域新增 6 个 flux_obs_* 派生通道，与原始数据通道并列显示。每个派生通道与原始数据共享同一时间轴，可以同步观察估算值与实测值的关系。

常用交互操作：

• 显示/隐藏通道：点击通道名切换可见性
• 缩放：鼠标滚轮上下滚动
• 平移：鼠标左键拖动
• 查看数值：十字光标 + 悬浮窗显示某点实际值

故障排查：如果未看到派生通道，可在 视图 → 输出窗口 中切换到 程序日志 标签页，检查是否有"派生变量已更新"日志以确认算法是否执行成功。若日志显示错误信息，请检查输入变量映射是否正确。

四、下一步：误差分析

磁链观测器输出的 theta_e、omega_e 等估算值，可与编码器实测值对比以评估算法精度。EmeyeStudio 提供"误差分析"算法来自动完成这一对比：

1. 再次点击工具栏 算法 按钮打开算法应用对话框
2. 在算法树中选择 误差分析 算法（与 电机控制 并列的分组）
3. 映射 actual → 实测通道（如编码器角度）、estimated → 估算通道（如 flux_obs_theta_e）
4. 选择输出字段（如 theta_error，角度误差会自动 wrap 到 ±180°）
5. 点击 应用，查看 err_* 派生通道

误差通道注入后，可配合"误差统计面板"查看 RMS/峰值/标准差等指标，或用"误差阈值线"标红超限段。详见 算法库功能指南。

五、提示

• hard-demo 工程的变量并非标准 PMSM 变量名，估算值可能无物理意义，这属于正常现象 — 本入门仅用于验证"数据加载 → 算法执行 → 派生通道注入"的链路通断
• 真实电机调试时，请按电机铭牌修改 Rs/Ld/Lq/psi_f/pole_pairs 等参数，否则估算结果无参考价值
• 派生通道与原始数据共享同一时间轴，可同步观察两者关系
• 算法应用对话框关闭后仍可再次打开调整参数，重新应用会更新派生通道

六、探索更多

PMSM 场景下常用的其他特性：

七、相关文档

• 示例工程指南 — 创建示例工程
• 工作流程 — 标准工作流程
• 算法库功能指南 — PMSM 磁链观测器功能参考
• 波形分析 — 波形图核心功能
• 快捷键大全 — 完整快捷键列表

本文档最后更新时间：2026-07-04