使用手册与环境要求¶
本手册以当前仓库的活动模型、初始化入口和已记录验证为依据。 首次使用从快速开始进入，随后按电机类型阅读 PMSM 或 BLDC。
选择工作流¶
| 工作流 | 前提与范围 |
|---|---|
| 文档浏览／构建 | 浏览器；本地构建使用 Python 和锁定的文档依赖，不需要 MATLAB |
| 主机 Normal | MATLAB/Simulink、已启用的 autoMBD HSP 0.1.0；不需要连接目标板 |
| 主机 SIL | 上述环境及 MATLAB Coder、Simulink Coder、Embedded Coder 和可用的主机 C 编译器 |
| 独立对象参考 | BLDC 使用 Simscape/Simscape Electrical；PMSM 使用提供 autolibpmsminterior/Interior PMSM 的产品安装，执行前确认该参考块可用 |
| Python 验证编排 | 配置项目锁定的官方 MCP 环境，逐项检查所需产品及许可证 |
| S32K344 目标构建 | HSP 0.1.0、RTD 7.0.1、EB tresos 30、NXP GCC 10.2、FreeRTOS 11.1.0 |
| S32K144 目标构建 | HSP 0.1.0 的 S32K1 适配器、RTD 3.0.0 QLP06、EB tresos 29、NXP GCC 10.2、FreeRTOS 11.1.0 |
| 实际 PIL | 所选目标构建环境、对应控制板、PEmicro 探针及确认的 UART 配置 |
| 带电机实验 | 额外需要正确连接及标定的驱动板、电机、采样和保护；按板级说明逐项验证 |
报告中的参考环境为 Windows、MATLAB/Simulink R2026a。 Agent 环境的最低版本要求不等于电机模型已在该最低版本验收。 产品安装和技能可用性也不等于本次许可证可成功签出。
autoMBD HSP 由外部安装提供。活动模型的 ambd_mc("setup",...) 会核对已启用的
0.1.0 版本；缺少它时先完成 HSP 安装与初始化，不应绕过检查打开目标模型。
芯片工具、本机路径、串口与探针设置见 HSP 指南。
学习与使用路径¶
- 快速开始：初始化、场景执行、读取 MAT 验收。
- 场景示例：有感、Hall、无感和 SIL 调用。
- 框架架构：算法、对象和硬件边界。
- PMSM 类型、BLDC 类型：接口与生成源。
- 完整验证流程：参考对象、场景矩阵和重放。
- HSP 构建/PIL、板级集成：目标工作副本与实机边界。
参数与数据的维护¶
控制器与对象参数分别维护。普通初始化保留字典标定；显式同步会重建本框架
拥有的类型与默认参数。修改类型源前先阅读对应电机手册，避免将排版调整变成
工程输入变更。两类电机的 PositionMode 编码不同，不能互相套用。
验证方法和结果判读见验证指南；文档组织规则见 文档维护清单。
两套目标的配置、模型矩阵与时基见 HSP 目标选择。