Interior PM Controller

Interior PM Controller 是一个内置式永磁同步电机（IPMSM）的磁场定向控制器。它的核心作用是接收转矩指令，自动计算电机所需的 d 轴和 q 轴电流，以实现 最大转矩电流比（MTPA） 和 弱磁控制

控制类型（Control Type）

Control Type 设置为 Torque Control。这意味着控制器本身不包含速度环。

Torque Control：模块作为一个纯转矩控制器工作，你需要从外部提供一个转矩指令（T*）作为输入，控制器会输出相应的电压指令（Vd, Vq）去驱动电机。

Speed Control：如果选择此项，模块内部会包含一个速度控制器，你只需提供转速指令（ω*），模块会自动计算出所需的转矩指令。

模块参数详解

1.Motor Parameters

Stator resistance, Rs [Ohm]：定子相绕组的电阻（欧姆）。 0.02 Ω 属于低电阻设计，常见于高功率密度电机。

D-axis inductance, Ld [H]：d 轴电感（亨利）。填写的 1.7e-3 H（即 1.7 mH）是直轴电感。

Q-axis inductance, Lq [H]：q 轴电感（亨利）。填写的 3.2e-3 H（即 3.2 mH）是交轴电感。对于内置式永磁电机（IPMSM），Lq 通常大于 Ld，这是产生磁阻转矩、实现 MTPA 控制的基础。

Permanent magnet flux, lambda_pm [Wb]：永磁体磁链（韦伯）。你填写的 0.2205 Wb 是永磁体产生的磁链，这是决定电机转矩能力的关键参数。

Number of pole pairs, PolePairs [ ]：极对数。你填写的 4 表示电机有 4 对极（即 8 个磁极）

2.Id and Iq Calculation

这里主要用于根据电机的物理参数，计算并生成 d 轴和 q 轴电流的查找表（Lookup Table），以实现最优控制

Motor constraint（电机约束）：
选择Maximum Torque。这意味着控制器会按照 MTPA（最大转矩电流比） 策略来计算电流，即在产生相同转矩时，使得总电流最小，从而降低铜损。
选择Maximum Current：在实际的电机控制代码生成或硬件调试中，强烈建议使用此项。因为你需要直接对标你使用的功率模块（IPM/IGBT/MOSFET）的峰值电流耐受能力

MTPA table breakpoints, bp：10。这是查找表的数据点数量。10 个点对于平滑插值来说通常足够，如果电机非线性极强或需要极高精度，可以适当增加。

Derived Parameters（派生参数/计算出的数据）
点击 Calculate MTPA Table Data 按钮后自动生成的表格数据。控制器会根据上一个选项卡中填入的电机参数（Rs, Ld, Lq, lambda_pm, PolePairs）以及这里的 T_max，离线计算出这些点：

Torque Breakpoints, T_mtpa [Nm]：从 0 到 60 N·m 均匀分布的 10 个转矩点。

D-axis table data, id_mtpa [A]：对应每个转矩点所需的 d 轴电流。注意看数值，它们全部是负值（从 0 到 -11.22A）。这是因为内置式电机（IPMSM）存在凸极效应（Lq > Ld），利用负的 id 可以产生磁阻转矩，从而提高效率。

Q-axis table data, iq_mtpa [A]：对应每个转矩点所需的 q 轴电流（从 0 到 42.14A），这是产生主要电磁转矩的分量。

D, Q, and max current limits, idq_limits [A]：电流限制。数据 [-11.22, 42.14, 43.60] 分别代表 [id的最小值, iq的最大值, 最大定子电流幅值]。

3.Current Controller（电流控制器）

这里主要用于自动计算电流环 PI 控制器的增益。 内置的“自动计算”功能非常方便，它根据你前面填写的电机参数和控制需求，直接计算出最优的 PI 参数，避免了繁琐的手动试凑。

Bandwidth of the current regulator, BW_current [Hz]: 200
含义：电流环的闭环带宽，决定了电流跟踪指令的响应速度。数值越大，响应越快，但过大会导致噪音放大和系统不稳定。
经验值：通常设为开关频率（或采样频率）的 1/10 到 1/20。你设置的 200 Hz 是一个非常稳健、安全的初始值。高性能伺服驱动通常会在 500 Hz 到 1 kHz 甚至更高。

Sample time for the torque control, Tst [s]: 5e-5
含义：转矩控制（也就是电流环）的采样时间。5e-5 s 即 50 微秒，对应的控制频率是 20 kHz。
关系：200 Hz 的带宽相对于 20 kHz 的采样频率来说非常保守（采样频率是带宽的 100 倍），这意味着离散化带来的相位滞后极小，系统会非常稳定。
派生参数（自动计算出的 PI 增益）
点击 Calculate Current Regulator Gains 按钮后，模块根据 Rs, Ld, Lq 和带宽计算出了以下参数：

D-axis proportional gain, Kp_d [V/A]: 2.1363

Q-axis proportional gain, Kp_q [V/A]: 4.0212

D and Q axis integral gain, Ki [V/(A*s)]: 25.1327

这是内置式永磁电机（IPMSM）的典型特征。你会发现Kp_q（4.02）差不多是 Kp_d（2.13）的两倍，这正好对应了你前面设置的 Lq (3.2e-3) 与 Ld (1.7e-3) 的比值。

4.Electrical Losses（电气损耗）

这里用于定义逆变器的损耗模型，以便控制器在进行功率计算或效率优化时，能够更准确地估算系统能耗。

Parameterize losses by（损耗参数化方式）:

1.Single efficiency measurement（单点效率测量）:使用一个恒定的平均效率值来代表整个逆变器的损耗特性。
Overall inverter efficiency, eff [%]（逆变器整体效率）：当逆变器输出功率时，由于开关损耗和导通损耗，会有 ？% 的功率损失。

2.Tabulated loss data（查表法）
Vector of speeds (w) for tabulated loss, w_loss_bp [rad/s]：速度断点向量。单位是 rad/s（这里通常指机械角速度，对应约 0 到 9550 rpm）。
Vector of torques (T) for tabulated loss, T_loss_bp [Nm]：转矩断点向量。单位是 N·m。
Corresponding losses, losses_table [W]：二维损耗矩阵。根据前两个向量，这个矩阵必须是 6 行 5 列。矩阵中的每个点，代表在对应转速和转矩交点处的逆变器总损耗功率（单位：W）。

注意：这组数据是随意编写的。实际工程中，你需要根据逆变器的效率Map图或半导体器件损耗仿真（如PLECS）来填入真实数据。

3.Tabulated efficiency data（查表效率）
Vector of speeds (w) for tabulated efficiency, w_eff_bp [rad/s]: 查表效率的速度向量 (w)，w_eff_bp [弧度/秒]
Vector of torques (T) for tabulated efficiency, T_eff_bp [Nm]: -> 查表效率的转矩向量 (T)，T_eff_bp [牛·米]
Corresponding efficiency, efficiency_table [%]: -> 对应的效率，efficiency_table [百分比]

Speed Controller (速度控制器)

意味着该模块不仅执行电流/转矩控制，还带有一个外部的速度控制环。

Bandwidth of the motion controller, BV_motion [Hz]: [20, 4, 0.8]。这是一个数组，通常代表速度环的期望闭环带宽以及用于自动整定控制器的极点和阻尼配置。第一个值 20 Hz 是主带宽，决定了速度环的动态响应速度；后面的 4 和 0.8 可能是用于设计状态反馈/前馈的高级参数（具体含义需参考该模块的 MATLAB 帮助文档，通常与极点配置或滤波器阻尼有关）。

Bandwidth of the state filter, BV_sf [Hz]: 200。状态滤波器带宽，通常用于滤除速度/位置信号中的高频噪声。200 Hz 远高于速度环带宽 20 Hz，这样设计是合理的，能在不影响速度环动态特性的前提下有效抑制噪声。

派生参数（Derived Parameters）分析

比例增益 (ba): 0.41909 Nm/(rad/s)。速度环的比例项，用来快速响应速度偏差。
角度增益 (Ksa): 10.5317 Nm/rad。通常用于前馈控制（如加速度前馈或负载转矩前馈相关）。
旋转增益 (Kisa): 42.6965 Nm/(rads)。对应速度环的积分项，用于消除稳态误差。
速度调节时间常数 (Ksf): 1217.9727 1/s。反映速度控制回路的快速响应能力。
惯量补偿 (Jcomp): 0.0027 kgm^2。这个值非常关键。它反映了系统转动惯量。控制器会利用这个值计算前馈加速度转矩，从而让速度响应更快、超调更小。
粘滞阻尼补偿 (Fv): 0.0004924 Nm/(rad/s)。用于补偿系统中的摩擦或风阻。
静摩擦 (Fs): 0。目前未启用静摩擦补偿。