mcb.PMSMRatedTorque

Calculate rated torque of PMSM

Since R2022b

collapse all in page

    Syntax

    rated_torque = mcb.PMSMRatedTorque(pmsm)
    rated_torque = mcb.PMSMRatedTorque(pmsm,inverter)
    [rated_torque,speeds] = mcb.PMSMRatedTorque(___)
    [rated_torque,speeds,idcurrent,iqcurrent] = mcb.PMSMRatedTorque(___)

    Description

    rated_torque = mcb.PMSMRatedTorque(pmsm) returns the rated torque for a permanent magnet synchronous motor (PMSM) with parameters pmsm. For this syntax, the function uses inverter.V_dc = 100.

    example

    rated_torque = mcb.PMSMRatedTorque(pmsm,inverter) returns the rated torque for a PMSM with parameters pmsm and inverter with parameters inverter.

    [rated_torque,speeds] = mcb.PMSMRatedTorque(___) also returns an array of milestone speeds. You can use this syntax with any of the previous input argument combinations.

    [rated_torque,speeds,idcurrent,iqcurrent] = mcb.PMSMRatedTorque(___) also returns the arrays of currents at the milestone speeds. You can use this syntax with any of the previous input argument combinations.

    Examples

    collapse all

    Get parameters for your motor. This example uses a BLY171D PMSM.

    pmsm = mcb.getPMSMParameters("BLY171D");

    Get the rated torque of the PMSM using the CVCP field-weakening control method.

    rated_torque = mcb.PMSMRatedTorque(pmsm)
    rated_torque =

        0.0566

    Input Arguments

    collapse all

    PMSM parameters, specified as a struct.

    Specify lumped linear parameters with the following required fields:

    • Ld — d-axis stator winding inductance (in henries), specified as a scalar

    • Lq — q-axis stator winding inductance (in henries), specified as a scalar

    • FluxPM — Permanent magnet flux linkage (in webers), specified as a scalar

    • p — Number of pole pairs, specified as a scalar

    • Rs — Stator resistance (in ohms), specified as a scalar

    • B — Viscous damping coefficient (in kg-m2/ sec), specified as a scalar

    • I_rated — Rated current (in amperes), specified as a scalar

    You can create a structure with lumped linear parameters using mcb.getPMSMParameters.

    Alternatively, specify nonlinear lookup table data with the following required fields:

    • PMSMLUT.idvec — d-axis current breakpoints (in amperes) of lookup tables, specified as a vector

    • PMSMLUT.iqvec — q-axis current breakpoints (in amperes) of lookup tables, specified as a vector

    • PMSMLUT.LdTable — d-axis inductance (in henries) lookup table, specified as matrix

    • PMSMLUT.LqTable — q-axis inductance (in henries) lookup table, specified as a matrix

    • PMSMLUT.FluxPMTable — Permanent magnet flux linkage (in weber) lookup table, specified as a matrix

    or the following required fields:

    • PMSMLUT.idvec — d-axis current breakpoints (in amperes) of lookup tables, specified as a vector

    • PMSMLUT.iqvec — q-axis current breakpoints (in amperes) of lookup tables, specified as a vector

    • PMSMLUT.FluxDTable — d-axis flux linkage lookup table, specified as a matrix

    • PMSMLUT.FluxQTable — q-axis flux linkage lookup table, specified as a matrix

    Whether you specify lumped parameters or lookup tables, the structure can also contain the following optional fields:

    • model — Manufacturer's model number, specified as a character vector

    • sn — Manufacturer's serial number, specified as a character vector

    • J — Motor inertia coefficient (in kg-m2), specified as a scalar

    • Ke — Back EMF constant (in volts/krpm), specified as a scalar

    • Kt — Torque constant (in Nm/amperes), specified as a scalar

    • N_max — Maximum rotor speed (in rpm), specified as a scalar

    • PositionOffset — Rotor position offset (in PU), specified as a scalar

    • QEPSlits — Number of quadrature encoder pulse (QEP) slits, specified as a scalar

    • T_rated — Rated torque (in Nm), specified as a scalar

    Data Types: struct

    Inverter parameters, specified as a struct. You can create this structure using mcb.getInverterParameters. Specify the structure with the following required field:

    • V_dc — DC voltage

    The structure can also contain the following optional fields:

    • model — Manufacturer's model number, specified as a character vector

    • sn — Manufacturer's serial number, specified as a character vector

    • I_trip — Maximum permissible inverter current (in amperes), specified as a scalar

    • Rds_on — On-state resistance of MOSFETs (in ohms), specified as a scalar

    • Rshunt — Shunt resistance for current sensing (in ohms), specified as a scalar

    • R_board — Per-phase board resistance seen by motor (in ohms), specified as a scalar

    • CtSensAOffset — ADC offset for phase A, specified as a scalar

    • CtSensBOffset — ADC offset for phase B, specified as a scalar

    • CtSensCOffset — ADC offset for phase C, specified as a scalar

    • CtSensOffsetMax — Maximum limit of automatically calibrated ADC offsets for current sensor, specified as a scalar

    • CtSensOffsetMin — Minimum limit of automatically calibrated ADC offsets for current sensor, specified as a scalar

    • ADCGain — ADC gain factor scaled by SPI, specified as a scalar

    • EnableLogic — Type of inverter, specified as one of the following:

      • 1 — Active-high enabled inverter

      • 0 — Active-low enabled inverter

    • invertingAmp — Convention for current entering motor, specified as one of the following:

      • 1 — Current entering motor sensed as positive by current sense amplifier

      • –1 — Current entering motor sensed as negative by current sense amplifier

    • ISenseVref — Reference voltage of current sensor circuit (in volts), specified as a scalar

    • ISenseVoltPerAmp — Current sensor voltage output per ampere of current (in V/A), specified as a scalar

    • ISenseMax — Maximum peak-neutral current that can be measured by current sensor (in amperes), specified as a scalar

    The following optional fields are not in the structure you create with mcb.getInverterParameters:

    • ADCOffsetCalibEnable — Auto-calibration setting for current sense ADCs, specified as one of the following:

      • 1 — Enable auto-calibration

      • 0 — Disable auto-calibration

    • SPI_Gain_Setting — SPI hex value encoding op-amp gain, specified as a scalar

    Data Types: struct

    Output Arguments

    collapse all

    Rated torque of PMSM, returned as a scalar.

    Milestone speeds of PMSM, returned as a vector.

    d-axis currents at the milestone speeds, returned as a vector.

    q-axis currents at the milestone speeds, returned as a vector.

    Version History

    Introduced in R2022b

    expand all

    See Also

    |

    Topics