Execute qualquer Skill no Manus
com um clique

Execute qualquer Skill no Manus com um clique

motor-dtc-pmsm

Estrelas8

Forks0

Atualizado20 de maio de 2026 às 10:10

PMSM Direct Torque Control Builder. Build a Direct Torque Control (DTC) outer-loop torque/flux controller for a three-phase voltage-source-inverter-driven PMSM (SPMSM/IPMSM via parameterization) in Simulink using Sutikno 6-state switching table, αβ stationary frame, 2-level hysteresis on (T, ψ), with outer-loop Speed PI providing Te_ref. Use when constructing, reproducing, porting, or extending a DTC simulation in Simulink (keywords DTC, direct torque control, Takahashi DTC, Sutikno DTC, hysteresis-based torque control, switching table, 磁链滞环, 转矩滞环). Skip for FCS-MPC, FOC, sensorless, scalar V/Hz, BLDC trapezoidal, induction-motor DTC, DTC-SVM, MP-DTC, or pure theory questions. Layered on motor-pmsm-base.

Instalação

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Executar no Manus

Fonte

calebzu

calebzu/pmsm-control-claude-skills-for-matlab

Abrir repositório GitHub Ver repositórios do creator

Download

Executar no Manus

Ocupações relacionadasSOC

Baseado na classificação ocupacional SOC

Desenvolvedores de softwareInformática e Matemática·SOC 15-1252

Explorador de arquivos

9 arquivos

SKILL.md

readonly

Mais deste repositório

mesmo repositório

motor-mfpcc-eso

calebzu/pmsm-control-claude-skills-for-matlab

PMSM Model-Free Predictive Current Control + ESO Builder. Build an inner-loop model-free DEADBEAT predictive current controller in the stationary αβ frame — first-order ultralocal model (ẏ = F + α·u) with a linear Extended State Observer estimating the lumped disturbance F — modulated by SVPWM at fixed switching frequency, with an outer speed PI providing iq_ref, for a three-phase voltage-source-inverter-driven SPMSM in Simulink. The current control law uses NO machine parameters (no Rs/Ls/ψf) — only the input gain α and the ESO bandwidth ω0. Use when constructing, reproducing, porting, or extending an MFPCC / ultralocal-model / ESO-based deadbeat current-control simulation in Simulink (keywords MFPCC, model-free predictive current control, ultralocal model, extended state observer, ESO, deadbeat predictive current control, ADRC-style current loop, 无模型预测电流控制, 扩张状态观测器). Skip for FCS-MPC of any vector count (single/dual/three-vector — this method is continuous-set deadbeat + SVM, NOT FCS-MPC; use the motor-fcs-

2026-06-158

motor-fcs-mpc-dualvector

calebzu/pmsm-control-claude-skills-for-matlab

PMSM Dual-Vector Finite-Control-Set MPC Builder. Build an inner-loop two-vectors-per-period finite-control-set MPC current controller for a three-phase voltage-source-inverter-driven PMSM (SPMSM / mild-saliency IPMSM via parameterization) in Simulink, with an outer speed PI providing iq_ref. Two vectors per control period (V_opt1 + V_j) with q-axis-deadbeat time allocation cut switching-cycle current ripple ~3-5x below single-vector FCS-MPC. Use when constructing, reproducing, porting, or extending a dual-vector / two-vector FCS-MPC current-control simulation in Simulink (keywords dual-vector MPC, two-vector MPC, double-vector MPCC, deadbeat time allocation, duty-cycle MPC, 双矢量模型预测, 占空比 MPC). Skip for single-vector FCS-MPC (use motor-fcs-mpc), FOC, DTC, SMC, sensorless, scalar V/Hz, BLDC trapezoidal, induction-motor MPC, three-or-more-vector / multi-step-horizon MPC, strong-saliency IPMSM MTPA, weak-field, or pure theory questions. Layered on motor-pmsm-base.

2026-06-108

motor-pmsm-base

calebzu/pmsm-control-claude-skills-for-matlab

PMSM Simulation Modeling Base — entry-point skill for building three-phase voltage-source-inverter-driven PMSM (SPMSM/IPMSM) control simulations in Simulink. Provides plant build standard, dq frame conventions, building blocks library SOP, sanity-check templates, broken-FOC defense checklist, and visual review standards. Method-specific skills (motor-fcs-mpc / motor-dtc-pmsm / motor-smc-pmsm) layer their control law on this base. Use when starting a new PMSM control method study, designing a build script skeleton, or debugging broken-FOC symptoms (motor stalled, abc DC-locked). Skip for non-PMSM motors (induction / BLDC / SRM) or pure theory questions.

2026-06-108

motor-smc-pmsm

calebzu/pmsm-control-claude-skills-for-matlab

PMSM Sliding Mode Control Speed-Loop Builder. Build a Sliding Mode Control (SMC) speed-loop outer controller (PD-type sliding surface + Super-Twisting Algorithm reaching law) + dq current-loop PI inner controller with cross-decoupling feedforward + Anti_Park library block + SVPWM library block + Universal Bridge IGBT inverter + PMSM Discrete plant for a three-phase voltage-source-inverter-driven PMSM in Simulink. v1 baseline supports SPMSM and mild-saliency IPMSM (id_ref=0). Use when constructing, reproducing, porting, or extending an SMC-based PMSM speed-loop simulation in Simulink (keywords SMC, sliding mode control, super-twisting, STA, PD-type sliding, boundary layer SMC, 滑模控制, 滑模面). Skip for FCS-MPC, FOC, DTC, sensorless, scalar V/Hz, BLDC trapezoidal, induction-motor SMC, observer-based / adaptive / disturbance-observer / neural-network / fuzzy SMC variants, strong-saliency IPMSM MTPA, weak-field, or pure theory questions. Layered on motor-pmsm-base.

2026-06-108

motor-fcs-mpc-trivector

calebzu/pmsm-control-claude-skills-for-matlab

PMSM Three-Vector Finite-Control-Set MPC Builder. Build an inner-loop three-vectors-per-period finite-control-set MPC current controller for a three-phase voltage-source-inverter-driven PMSM (SPMSM / mild-saliency IPMSM via parameterization) in Simulink, with an outer speed PI providing iq_ref. Each control period synthesizes an expected voltage vector from two adjacent active vectors + one zero vector and splits the period into three sub-intervals (t_i, t_j, t_z) so that BOTH i_d and i_q hit their references in one period (dual-axis deadbeat) — cutting current ripple below single- and dual-vector FCS-MPC at the same Tsc. Use when constructing, reproducing, porting, or extending a three-vector / triple-vector FCS-MPC current-control simulation in Simulink (keywords three-vector MPC, triple-vector MPC, TV-MPCC, dual-axis deadbeat, expected voltage vector synthesis, sector-based MPCC, 三矢量模型预测, 期望电压矢量). Skip for single-vector FCS-MPC (use motor-fcs-mpc), dual-vector / two-vector FCS-MPC (use motor-fcs-mpc-dualve

2026-06-038

motor-foc-ltid-pmsm

calebzu/pmsm-control-claude-skills-for-matlab

PMSM FOC + Load-Torque Estimator + Feed-Forward Builder. Build a field-oriented speed controller for a three-phase voltage-source-inverter-driven PMSM (SPMSM / mild-saliency IPMSM via parameterization) in Simulink, augmented with a linear load-torque state estimator (Luenberger + Kalman-filter family, 7 selectable variants on one shared structure) whose estimate is fed forward into the q-axis current reference to reject load-step speed dips. dq current PI ×2 with back-EMF decoupling, Symmetric-Optimum speed PI with anti-windup, selectable equation-linear plant or Simscape switched plant. Use when constructing, reproducing, porting, or extending an FOC speed loop with disturbance/load-torque estimation and feed-forward compensation (keywords FOC, field-oriented control, load-torque observer, load torque estimator, Luenberger observer, Kalman filter load estimation, feed-forward disturbance compensation, LTID, 负载转矩观测器, 前馈补偿, 卡尔曼). Skip for FCS-MPC, DTC, SMC, sensorless/position estimation, scalar V/Hz, BLDC tra

2026-06-028

name	motor-dtc-pmsm
description	PMSM Direct Torque Control Builder. Build a Direct Torque Control (DTC) outer-loop torque/flux controller for a three-phase voltage-source-inverter-driven PMSM (SPMSM/IPMSM via parameterization) in Simulink using Sutikno 6-state switching table, αβ stationary frame, 2-level hysteresis on (T, ψ), with outer-loop Speed PI providing Te_ref. Use when constructing, reproducing, porting, or extending a DTC simulation in Simulink (keywords DTC, direct torque control, Takahashi DTC, Sutikno DTC, hysteresis-based torque control, switching table, 磁链滞环, 转矩滞环). Skip for FCS-MPC, FOC, sensorless, scalar V/Hz, BLDC trapezoidal, induction-motor DTC, DTC-SVM, MP-DTC, or pure theory questions. Layered on motor-pmsm-base.
metadata	{"version":"1.0"}

motor-dtc-pmsm — PMSM Direct Torque Control Builder

Three-phase 2-level voltage-source inverter + PMSM (SPMSM / IPMSM via parameterization). Outer-loop = Speed PI providing Te_ref. Inner-loop = Direct Torque Control in αβ stationary frame: stator flux integrator + magnitude/angle/sector + 2-level hysteresis on (T, ψ) + Sutikno 6-state switching table → V_k → gate.

Layered on motor-pmsm-base. All base discipline applies.

Must-Follow Rules

Plan first — Numbered plan with 21 input table, design-decision choices (design_decisions.md), build-script structure. Get user approval.
One-click reproducibility — All parameters injected via set_param(mdl, 'InitFcn', ...). Model must Run from .slx double-click in fresh MATLAB session. See crit_conditions.md §E-CRIT.
Default 6-state switching table for PMSM — switching_table_mode='6state' (Sutikno 2011 Table 2). Never default to 8-state Takahashi for PMSM — V0/V7 zero vectors cause flux to decay. See switching_table.md and crit_conditions.md §A-CRIT.
ψ_ref ≠ ψ_f by default — Take psi_ref from reference if supplied; else compute the id=0 load-point stator flux |ψ_s|_load = sqrt(ψ_f² + (Lq·iq_max)²) (not true MTPA, which needs id<0). Never default ψ_ref = ψ_f for IPMSM. See crit_conditions.md §B-CRIT.
T_eq_factor = 15 for DTC, NOT 5 — DTC's hysteresis inner loop has lower bandwidth than FCS-MPC's current PI. Compute Speed PI gains via pi_design('SO', J, 1, T_eq, a_so) with T_eq = 15·Tsc, a_so = 4. Pass Kt = 1 because DTC outer PI directly outputs Te_ref [N·m] (plant has no Kt). See crit_conditions.md §C-CRIT.
Chart config = INHERITED + dual ZOH — ch.SampleTime='-1', ch.ChartUpdate='INHERITED'. ZOH @ Tsc on every chart input (5 inputs: Te_ref, ia, ib, ua, ub) AND every chart output (9 outputs: gate, Te_meas, mag_psi, ψ_α, ψ_β, sector, V_k, C_ψ, C_T). See crit_conditions.md §D-CRIT.
Speed PI saturation is mandatory — Saturation block after PI with limits [-T_max, +T_max]. Anti-windup off for v1 baseline; production should add clamp or back-calc.
Add 4 Scopes for human inspection — Scope_wm_RPM / Scope_Te / Scope_psi_mag / Scope_psi_alphabeta (XY Graph). The αβ XY plot is the most diagnostic — circular trajectory means healthy 6-state; hexagonal-with-inner-circle means 8-state pollution. See crit_conditions.md §F-CRIT.
Non-overlapping wiring — Every add_block specifies Position per X/Y bands; arrangeSystem(mdl, 'FullLayout') as final fallback.
HB reverse-calculation from fs_max — Use plant + Tsc to back-calc HB_T_min and HB_psi_min. Percentages (HB_T = 7.5% T_max, HB_ψ = 2.5% ψ_ref) are fallback only when fs_max is unknown. See hb_sizing.md.

Build Flow

Phase	Action	Reference
0	Validate inputs + sanity grid	base/pre_build_grid.md
1	Plant layer (powergui Discrete @ step_size, DC, UB, PMSM, TL Step, current/voltage measurement)	(this skill)
2	Measurement + αβ transform layer (Clark for currents, Clark for voltages)	(this skill)
3	Outer Speed PI (RPM domain, mandatory saturation, SO method `T_eq=15·Tsc`)	crit_conditions.md §C-CRIT
4	Inner DTC chart (flux integrator + magnitude/sector + hysteresis + 6-state table)	chart_algorithm.md + switching_table.md
5	Logger (19 channels, including ψ_α and ψ_β)	crit_conditions.md §F-CRIT
6	4 Scopes (wm_RPM / Te / mag_psi / αβ XY)	crit_conditions.md §F-CRIT
7	Solver (Fixed-step ode3, FixedStep = step_size; powergui Discrete)	(this skill)
8	InitFcn injection	crit_conditions.md §E-CRIT
9	Layout cleanup (`arrangeSystem('FullLayout')`)	(this skill)
10	Self-tests + acceptance	acceptance_criteria.md

Required User Inputs (21)

Ask user before starting. Defaults in parameter_defaults.md.

Group	Parameters
Machine (6)	`Pn`, `Rs`, `Ld, Lq`, `psi_f`, `J`, `B` (B=0 forces SO method for Speed PI)
Power stage (1)	`Vdc`
Control (3)	`psi_ref` (reference value if supplied; else id=0 load-point stator flux — never `ψ_f` for IPMSM), `T_max` (reference value if supplied; else `1.5·Pn·ψf·iq_max`), `iq_max`
Sampling (3)	`Tsc` (default 50 μs), `step_size` (default 1 μs; `step_size ≤ Tsc/50`), `fs_max` (default 10 kHz)
PI design (2)	`T_eq_factor` (default 15 for DTC), `a_so` (default 4 for SO ζ_eq ≈ 0.71)
Mode (4)	`switching_table_mode` (default `'6state'`), `torque_hysteresis_levels` (default 2), `Te_feedback_mode` (default `'alphabeta'`), `flux_drift_compensation` (default `'none'`)
Solver (1)	`solver` (default `'ode3'`)
Scenario (4)	`omega_ref_rpm`, `sim_time`, `TL_step_t`, `TL_after`

Triggers / Skip

✅ Use	❌ Skip
Build / port / extend DTC simulation in Simulink	FCS-MPC, FOC, sensorless, scalar V/Hz, BLDC trapezoidal
Takahashi DTC, Sutikno DTC, hysteresis-based torque control	DTC-SVM (constant switching freq variant), MP-DTC (predictive DTC), 12-sector schemes, deadbeat flux/torque control
Switching table for PMSM DTC (6-state)	Online parameter adaptation, MTPA mid-loop, weak-field
Generalizing DTC to a new PMSM machine parameter set	Pure theory questions, paper writing, MATLAB perf, unit tests

Generalization Across Machine Sub-Types

Sub-type	Parameter constraint	Strategy
SPMSM	`Ld == Lq`	`psi_ref ≈ ψ_f` workable (verify load doesn't push `\|ψ_s\|_load` above `ψ_f`)
IPMSM mild saliency	`Lq > Ld`, `Lq/Ld ≤ 1.5`	`psi_ref` = id=0 load-point flux: `sqrt(ψ_f² + (Lq·iq_max)²)`
IPMSM strong saliency	`Lq/Ld ≥ 2`	Same id=0 flux formula; `T_max` may need higher headroom

Topology does not change — same blocks, same wiring, same chart, same CRIT conditions. Only psi_ref and iq_max budgets differ.

Out-of-scope sub-types: SynRM (ψ_f ≈ 0), IM, BLDC trapezoidal — different prediction equations and switching tables.

Known Limitation: Classical DTC Te Ripple

Hysteresis-driven switching produces an inherent torque ripple intrinsic to the bang-bang structure. Steady-state mean Te tracks reference within < 1%, but the instantaneous-Te ripple band may exceed simple ±5% bands. Acceptance Criteria Mode A allows S2 to be the marginal metric in the 4/5 budget per acceptance_criteria.md. Advanced variants that reduce ripple (DTC-SVM, MP-DTC, Sutikno Table 3) are out of scope.

Sibling Skills

motor-pmsm-base — base infrastructure
motor-fcs-mpc — FCS-MPC alternative
motor-smc-pmsm — SMC alternative