Main Content

mcb.ACIMCharacteristics

Compute and plot ACIM characteristic curves

Since R2022a

    Description

    mcb.ACIMCharacteristics(acim,inverter) computes and plots characteristic curves for an AC induction motor (ACIM) with parameters acim and inverter with parameters inverter.

    The function plots torque-speed, power-speed, current-speed, and peak current-speed characteristics.

    example

    Examples

    collapse all

    Get parameters for your motor and inverter. This example uses an EM_Synergy ACIM and DRV8312-C2-KIT inverter.

    acim = mcb.getACIMParameters("EM_Synergy");
    inverter = mcb.getInverterParameters("DRV8312-C2-KIT");

    Plot characteristic curves.

    mcb.ACIMCharacteristics(acim,inverter)

    Torque-speed, power-speed, current-speed, and peak current-speed characteristic curves for ACIM

    Input Arguments

    collapse all

    ACIM parameters, specified as a struct.

    Specify lumped linear parameters with the following required fields:

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

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

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

    • Rr — Rotor resistance (in ohms), specified as a scalar

    • Lls — Stator leakage inductance (in henry), specified as a scalar

    • Lm — Magnetizing inductance (in henry), specified as a scalar

    • Llr — Rotor leakage inductance (in henry), specified as a scalar

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

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

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

    • F_rated — Rated frequency (in Hz), specified as a scalar

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

    The structure can also contain the following optional fields:

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

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

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

    • V_rated — Rated voltage (in volts), specified as a scalar

    • N_rated — Rated speed at full load (in rpm), specified as a scalar

    • Ls — Total stator inductance (in henry), specified as a scalar

    • Lr — Total rotor inductance (in henry), specified as a scalar

    • sigma — Leakage factor, specified as a scalar

    • Iq0 — Rated q-axis current (in amperes), specified as a scalar

    • FluxRated — Rated rotor flux (in weber), 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

    Version History

    Introduced in R2022a

    expand all