# N-Channel IGBT

Model N-Channel IGBT

## Library

Semiconductor Devices

## Description

The N-Channel IGBT block models an Insulated Gate Bipolar Transistor (IGBT). The block provides two main modeling variants, accessible by right-clicking the block in your block diagram and then selecting the appropriate option from the context menu, under Simscape > Block choices:

• Full I-V and capacitance characteristics — This variant is a detailed component model suitable for simulating detailed switching characteristics and predicting component losses. This variant, in turn, provides two ways of modeling an IGBT:

The gate junction capacitance in the detailed model is represented as a fixed gate-emitter capacitance CGE and either a fixed or a nonlinear gate-collector capacitance CGC. For details, see Charge Model.

• Simplified I-V characteristics and event-based timing — This variant models the IGBT more simply by using just the on-state I-V data corresponding to the gate voltage used in your circuit. Switching between states is achieved by linearly ramping the collector-emitter voltage. This simplified model is suitable when approximate dynamic characteristics are sufficient, and simulation speed is of paramount importance. For details, see Event-Based IGBT Variant.

Together with the thermal port variants (see Thermal Port), the block therefore provides you with four choices. To select the desired variant, right-click the block in your model. From the context menu, select Simscape > Block choices, and then one of the following options:

• Full I-V and capacitance characteristics | No thermal port — Detailed model that does not simulate the effects of generated heat and device temperature. This is the default.

• Full I-V and capacitance characteristics | Show thermal port — Detailed model with exposed thermal port.

• Simplified I-V characteristics and event-based timing| No thermal port — Simplified event-based model, which also does not simulate the effects of generated heat and device temperature.

• Simplified I-V characteristics and event-based timing | Show thermal port — Simplified event-based model with exposed thermal port.

### Representation by Equivalent Circuit

The equivalent circuit of the detailed block variant consists of a PNP Bipolar Transistor block driven by an N-Channel MOSFET block, as shown in the following figure:

The MOSFET source is connected to the bipolar transistor collector, and the MOSFET drain is connected to the bipolar transistor base. The MOSFET uses the equations shown in the N-Channel MOSFET block reference page. The bipolar transistor uses the equations shown in the PNP Bipolar Transistor block reference page, but with the addition of an emission coefficient parameter N that scales kT/q.

The N-Channel IGBT block uses the on and off characteristics you specify in the block dialog box to estimate the parameter values for the underlying N-Channel MOSFET and PNP bipolar transistor.

The block uses the off characteristics to calculate the base-emitter voltage, Vbe, and the saturation current, IS.

When the transistor is off, the gate-emitter voltage is zero and the IGBT base-collector voltage is large, so the PNP base and collector current equations simplify to:

`$\begin{array}{l}{I}_{b}=0=-{I}_{s}\left[\frac{1}{{\beta }_{F}}\left({e}^{-q{V}_{be}/\left(NkT\right)}-1\right)-\frac{1}{{\beta }_{R}}\right]\\ {I}_{c}=-{I}_{s}\left[{e}^{-q{V}_{be}/\left(NkT\right)}\left(1+\frac{{V}_{bc}}{{V}_{AF}}\right)+\frac{1}{{\beta }_{R}}\right]\end{array}$`

where N is the Emission coefficient, N parameter value, VAF is the forward Early voltage, and Ic and Ib are defined as positive flowing into the collector and base, respectively. See the PNP Bipolar Transistor reference page for definitions of the remaining variables. The first equation can be solved for Vbe.

The base current is zero in the off-condition, and hence Ic = –Ices, where Ices is the Zero gate voltage collector current. The base-collector voltage, Vbc, is given by Vbc = Vces + Vces, where Vces is the voltage at which Ices is measured. Hence we can rewrite the second equation as follows:

`${I}_{ces}={I}_{s}\left[{e}^{-q{V}_{be}/\left(NkT\right)}\left(1+\frac{{V}_{ces}+{V}_{be}}{{V}_{AF}}\right)+\frac{1}{{\beta }_{R}}\right]$`

The block sets βR and βF to typical values of 1 and 50, so these two equations can be used to solve for Vbe and IS:

`$\begin{array}{l}{V}_{be}=\frac{-NkT}{q}\mathrm{log}\left(1+\frac{{\beta }_{F}}{{\beta }_{R}}\right)\\ {I}_{s}=\frac{{I}_{c}}{{e}^{-q{V}_{be}/\left(NkT\right)}+\frac{1}{{\beta }_{R}}}\end{array}$`
 Note:   The block does not require an exact value for βF because it can adjust the MOSFET gain K to ensure the overall device gain is correct.

The block parameters Collector-emitter saturation voltage, Vce(sat) and Collector current at which Vce(sat) is defined are used to determine Vbe(sat) by solving the following equation:

`${I}_{ce\left(sat\right)}={I}_{s}\left[{e}^{-q{V}_{be\left(sat\right)}/\left(NkT\right)}\left(1+\frac{{V}_{ce\left(sat\right)}+{V}_{be\left(sat\right)}}{{V}_{AF}}\right)+\frac{1}{{\beta }_{R}}\right]$`

Given this value, the block calculates the MOSFET gain, K, using the following equation:

`${I}_{ds}={I}_{b}=K\left[\left({V}_{GE\left(sat\right)}-{V}_{th}\right){V}_{ds}-\frac{{V}_{ds}{}^{2}}{2}\right]$`

where Vth is the Gate-emitter threshold voltage, Vge(th) parameter value and VGE(sat) is the Gate-emitter voltage at which Vce(sat) is defined parameter value.

Vds is related to the transistor voltages as Vds = VceVbe. The block substitutes this relationship for Vds, sets the base-emitter voltage and base current to their saturated values, and rearranges the MOSFET equation to give

`$K=\frac{{I}_{b\left(sat\right)}}{\left[\left({V}_{GE\left(sat\right)}-{V}_{th}\right)\left({V}_{be\left(sat\right)}+{V}_{ce\left(sat\right)}\right)-\frac{{\left({V}_{be\left(sat\right)}+{V}_{ce\left(sat\right)}\right)}^{2}}{2}\right]}$`

where Vce(sat) is the Collector-emitter saturation voltage, Vce(sat) parameter value.

These calculations ensure the zero gate voltage collector current and collector-emitter saturation voltage are exactly met at these two specified conditions. However, the current-voltage plots are very sensitive to the emission coefficient N and the precise value of Vth. If the manufacturer datasheet gives current-voltage plots for different VGE values, then the N and Vth can be tuned by hand to improve the match.

### Representation by Lookup Table

For the lookup table representation of the detailed block variant, you provide tabulated values for collector current as a function of gate-emitter voltage and collector-emitter voltage. The main advantage of using this option is simulation speed. It also lets you parameterize the device from either measured data or from data obtained from another simulation environment. To generate your own data from the equivalent circuit representation, you can use a test harness, such as shown in the IGBT Characteristics example.

The lookup table representation combines all of the equivalent circuit components (PNP transistor, N-channel MOSFET, collector resistor and emitter resistor) into one equivalent lookup table. Therefore, if you use this option, the Advanced tab has no parameters.

### Charge Model

The detailed variant of the block models junction capacitances either by fixed capacitance values, or by tabulated values as a function of the collector-emitter voltage. In either case, you can either directly specify the gate-emitter and gate-collector junction capacitance values, or let the block derive them from the input and reverse transfer capacitance values. Therefore, the Parameterization options for charge model on the Junction Capacitance tab are:

• ```Specify fixed input, reverse transfer and output capacitance``` — Provide fixed parameter values from datasheet and let the block convert the input and reverse transfer capacitance values to junction capacitance values, as described below. This is the default method.

• ```Specify fixed gate-emitter, gate-collector and collector-emitter capacitance``` — Provide fixed values for junction capacitance parameters directly.

• ```Specify tabulated input, reverse transfer and output capacitance``` — Provide tabulated capacitance and collector-emitter voltage values based on datasheet plots. The block converts the input and reverse transfer capacitance values to junction capacitance values, as described below.

• ```Specify tabulated gate-emitter, gate-collector and collector-emitter capacitance``` — Provide tabulated values for junction capacitances and collector-emitter voltage.

Use one of the tabulated capacitance options (```Specify tabulated input, reverse transfer and output capacitance``` or ```Specify tabulated gate-emitter, gate-collector and collector-emitter capacitance```) when the datasheet provides a plot of junction capacitances as a function of collector-emitter voltage. Using tabulated capacitance values will give more accurate dynamic characteristics, and avoids the need to iteratively tune parameters to fit the dynamics.

If you use the ```Specify fixed gate-emitter, gate-collector and collector-emitter capacitance``` or ```Specify tabulated gate-emitter, gate-collector and collector-emitter capacitance``` option, the Junction Capacitance tab lets you specify the Gate-emitter junction capacitance, Gate-collector junction capacitance, and Collector-emitter junction capacitance parameter values (fixed or tabulated) directly. Otherwise, the block derives them from the Input capacitance, Cies, Reverse transfer capacitance, Cres, and Output capacitance, Coes parameter values. These two parameterization methods are related as follows:

• CGE = Cres

• CGC = CiesCres

• CCE = CoesCres

The two fixed capacitance options (```Specify fixed input, reverse transfer and output capacitance``` or ```Specify fixed gate-emitter, gate-collector and collector-emitter capacitance```) let you model gate junction capacitance as a fixed gate-emitter capacitance CGE and either a fixed or a nonlinear gate-collector capacitance CGC. If you select the ```Gate-collector charge function is nonlinear``` option for the Charge-voltage linearity parameter, then the gate-collector charge relationship is defined by the piecewise-linear function shown in the following figure.

With this nonlinear capacitance, the gate-emitter and collector-emitter voltage profiles take the form shown in the next figure, where the collector-emitter voltage fall has two regions (labeled 2 and 3) and the gate-emitter voltage has two time-constants (before and after the threshold voltage Vth):

You can determine the capacitor values for Cies, Cres, and Cox as follows, assuming that the IGBT gate is driven through an external resistance RG:

1. Set Cies to get correct time-constant for VGE in Region 1. The time constant is defined by the product of Cies and RG. Alternatively, you can use a datasheet value for Cies.

2. Set Cres so as to achieve the correct VCE gradient in Region 2. The gradient is given by (VGEVth)/(Cres · RG).

3. Set VCox to the voltage at which the VCE gradient changes minus the threshold voltage Vth.

4. Set Cox to get correct Miller length and time constant in Region 4.

Because the underlying model is a simplification of an actual charge distribution, some iteration of these four steps may be required to get a best overall fit to measured data. The collector current tail when the IGBT is turned off is determined by the Total forward transit time parameter.

 Note:   Because this block implementation includes a charge model, you must model the impedance of the circuit driving the gate to obtain representative turn-on and turn-off dynamics. Therefore, if you are simplifying the gate drive circuit by representing it as a controlled voltage source, you must include a suitable series resistor between the voltage source and the gate.

### Fine-Tuning the Current-Voltage Characteristics

For the equivalent circuit representation of the detailed model, use the parameters on the Advanced tab to fine-tune the current-voltage characteristics of the modeled device. To use these additional parameters effectively, you will need a manufacturer datasheet that provides plots of the collector current versus collector-emitter voltage for different values of gate-emitter voltage. The parameters on the Advanced tab have the following effects:

• The Emission coefficient, N parameter controls the shape of the current-voltage curves around the origin.

• The Collector resistance, RC and Emitter resistance, RE parameters affect the slope of the current-voltage curve at higher currents, and when fully turned on by a high gate-emitter voltage.

• The Forward Early voltage, VAF parameter affects the shape of the current-voltage curves for gate-emitter voltages around the Gate-emitter threshold voltage, Vge(th).

### Modeling Temperature Dependence

For the lookup table representation, the electrical equations do not depend on temperature. However, you can model temperature dependence if using the equivalent circuit representation of the detailed model.

The default behavior is that dependence on temperature is not modeled, and the device is simulated at the temperature for which you provide block parameters. You can optionally include modeling the dependence of the transistor static behavior on temperature during simulation. Temperature dependence of the junction capacitances is not modeled, this being a much smaller effect.

Temperature dependence is modeled by the temperature dependence of the constituent components. See the N-Channel MOSFET and PNP Bipolar Transistor block reference pages for further information on the defining equations.

Some datasheets do not provide information on the zero gate voltage collector current, Ices, at a higher measurement temperature. In this case, you can alternatively specify the energy gap, EG, for the device, using a typical value for the semiconductor type. For silicon, the energy gap is usually `1.11` eV.

### Event-Based IGBT Variant

This implementation has much simpler equations than that with full I-V and capacitance characteristics. Use the event-based variant when the focus of the analysis is to understand overall circuit behavior rather than to verify the precise IGBT timing or losses characteristics.

The device is always in one of the following four states:

• Off

• Turning on

• On

• Turning off

In the off state, the relationship between collector current (ic) and collector-emitter voltage (vce) is

ic = Goffvce

In the on state, the relationship between collector current (ic) and collector-emitter voltage (vce) is

vce = tablelookup(ic)

When turning on, the collector-emitter voltage is ramped down to zero over the rise time, the device moving into the on state when the voltage falls below the tabulated on-state value. Similarly when turning off, the collector-emitter voltage is ramped up over the (current) fall time to the specified blocking voltage value.

The following figure shows the resulting voltage and current profiles when driving a resistive load.

### Thermal Port

The block has an optional thermal port, hidden by default. To expose the thermal port, right-click the block in your model, and select the appropriate block variant:

• For a detailed model, select Simscape > Block choices > Full I-V and capacitance characteristics | Show thermal port. This action displays the thermal port H on the block icon, and adds the Thermal Port tab to the block dialog box.

• For a simplified event-based model, select Simscape > Block choices > Simplified I-V characteristics and event-based timing | Show thermal port. This action displays the thermal port H on the block icon, adds the Thermal Port tab to the block dialog box, and displays additional parameters on the Main tab. To simulate thermal effects, you must provide additional tabulated data for turn-on and turn-off losses and define the collector-emitter on-state voltage as a function of both current and temperature.

Use the thermal port to simulate the effects of generated heat and device temperature. For more information on using thermal ports and on the Thermal Port tab parameters, see Simulating Thermal Effects in Semiconductors.

## Basic Assumptions and Limitations

The detailed model is based on the following assumptions:

• This block does not allow you to specify initial conditions on the junction capacitances. If you select the Start simulation from steady state option in the Solver Configuration block, the block solves the initial voltages to be consistent with the calculated steady state. Otherwise, voltages are zero at the start of the simulation.

• You may need to use nonzero junction capacitance values to prevent numerical simulation issues, but the simulation may run faster with these values set to zero.

• The block does not account for temperature-dependent effects on the junction capacitances.

The simplified, event-based model is based on the following assumptions:

• When you use a pair of IGBTs in a bridge arm, normally the gate drive circuitry will prevent a device turning on until the corresponding device has turned off, thereby implementing a minimum dead band. If you need to simulate the case where there is no minimum dead band and both devices are momentarily partially on, use the detailed IGBT model variant (Full I-V and capacitance characteristics). The assumption used by the event-based variant that the collector-emitter voltages can be ramped between on and off states is not valid for such cases.

• A minimum pulse width is applied when turning on or off; at the point where the gate-collector voltage rises above the threshold, any subsequent gate voltage changes are ignored for a time equal to the sum of the turn-on delay and current rise time. Similarly at the point where the gate collector voltage falls below the threshold, any subsequent gate voltage changes are ignored for a time equal to the sum of the turn-off delay and current fall time. This feature is normally implemented in the gate drive circuitry.

• This model does not account for charge. Hence there is no current tail when turning off an inductive load.

• Representative modeling of the current spike during turn-on of an inductive load with preexisting freewheeling current requires tuning of the Miller resistance parameter.

• The tabulated turn-on switching loss uses the previous on-state current, not the current value (which is not known until the device reaches the final on state).

• Due to high model stiffness that can arise from the simplified equations, you may get minimum step size violation warnings when using this block. Open the Solver pane of the Configuration Parameters dialog box and increase the Number of consecutive min steps parameter value as necessary to remove these warnings.

## Dialog Box and Parameters

### Main Tab (Default Block Variant)

This configuration of the Main tab corresponds to the detailed block variant, which is the default. If you are using the simplified, event-based variant of the block, see Main Tab (Event-Based Block Variant).

I-V characteristics defined by

Select the IGBT representation:

• `Fundamental nonlinear equations` — Use an equivalent circuit based on a PNP bipolar transistor and N-channel MOSFET. This is the default.

• `Lookup table` — Use a lookup table approximation to the I-V curve.

Zero gate voltage collector current, Ices

The collector current that flows when the gate-emitter voltage is set to zero, and a large collector-emitter voltage is applied, that is, the device is in the off-state. The value of the large collector-emitter voltage is defined by the parameter Voltage at which Ices is defined. The default value is `2` mA. This parameter is visible only when you select ```Fundamental nonlinear equations``` for the I-V characteristics defined by parameter.

Voltage at which Ices is defined

The voltage used when measuring the Zero gate voltage collector current, Ices. The default value is `600` V. This parameter is visible only when you select ```Fundamental nonlinear equations``` for the I-V characteristics defined by parameter.

Gate-emitter threshold voltage, Vge(th)

The threshold voltage used in the MOSFET equations. The default value is `6` V. This parameter is visible only when you select `Fundamental nonlinear equations` for the I-V characteristics defined by parameter.

Collector-emitter saturation voltage, Vce(sat)

The collector-emitter voltage for a typical on-state as specified by the manufacturer. The default value is `2.8` V. This parameter is visible only when you select ```Fundamental nonlinear equations``` for the I-V characteristics defined by parameter.

Collector current at which Vce(sat) is defined

The collector-emitter current when the gate-emitter voltage is Vge(sat) and collector-emitter voltage is Vce(sat). The default value is `400` A. This parameter is visible only when you select `Fundamental nonlinear equations` for the I-V characteristics defined by parameter.

Gate-emitter voltage at which Vce(sat) is defined

The gate voltage used when measuring Vce(sat) and Ice(sat). The default value is `10` V. This parameter is visible only when you select `Fundamental nonlinear equations` for the I-V characteristics defined by parameter.

Measurement temperature

The temperature for which the parameters are quoted (Tm1). The default value is `25` °C. This parameter is visible only when you select ```Fundamental nonlinear equations``` for the I-V characteristics defined by parameter.

Vector of gate-emitter voltages, Vge

The vector of gate-emitter voltages, to be used for table lookup. The vector values must be strictly increasing. The values can be nonuniformly spaced. The default values, in V, are ```[-2 6 7 8 10 12 15 20]```. This parameter is visible only when you select ```Lookup table``` for the I-V characteristics defined by parameter.

Vector of collector-emitter voltages, Vce

The vector of collector-emitter voltages, to be used for table lookup. The vector values must be strictly increasing. The values can be nonuniformly spaced. The default values, in V, are ```[-1 0 0.5 1 1.5 2 2.5 3 3.5 4]```. This parameter is visible only when you select `Lookup table` for the I-V characteristics defined by parameter.

Tabulated collector currents, Ic=fcn(Vge,Vce)

Tabulated values for collector current as a function of gate-emitter voltage and collector-emitter voltage, to be used for 2D table lookup. Each value in the matrix specifies the collector current for a specific combination of gate-emitter voltage and collector-emitter voltage. The matrix size must match the dimensions defined by the gate-emitter voltage and collector-emitter voltage vectors. The default values, in A, are:

```[-1.015e-5 1.35e-8 4.7135e-4 5.092e-4 5.105e-4 5.1175e-4 5.1299e-4 5.1423e-4 5.1548e-4 5.1672e-4; -9.9869e-6 1.35e-8 4.7135e-4 5.092e-4 5.105e-4 5.1175e-4 5.1299e-4 5.1423e-4 5.1548e-4 5.1672e-4; -9.955e-6 1.35e-8 0.0065225 3.3324 48.154 93.661 105.52 105.72 105.93 106.14; -9.955e-6 1.35e-8 0.0065235 3.5783 70.264 166.33 252.4 317.67 353.38 357.39; -9.955e-6 1.35e-8 0.006524 3.7206 89.171 228.09 371.63 511.02 642.69 764.04; -9.9549e-6 1.35e-8 0.0065242 3.7716 97.793 256.21 424.27 592.92 759.2 921.52; -9.9549e-6 1.35e-8 0.0065243 3.8067 104.52 278.11 464.6 654.37 844.57 1.0339e+3; -9.9549e-6 1.35e-8 0.0065244 3.8324 109.92 295.67 496.54 702.28 909.96 1.1183e+3]```

This parameter is visible only when you select ```Lookup table``` for the I-V characteristics defined by parameter.

### Junction Capacitance Tab (Default Block Variant)

Parameterization

Select one of the following methods for block parameterization:

• ```Specify fixed input, reverse transfer and output capacitance``` — Provide fixed parameter values from datasheet and let the block convert the input, output, and reverse transfer capacitance values to junction capacitance values, as described in Charge Model. This is the default method.

• ```Specify fixed gate-emitter, gate-collector and collector-emitter capacitance``` — Provide fixed values for junction capacitance parameters directly.

• ```Specify tabulated input, reverse transfer and output capacitance``` — Provide tabulated capacitance and collector-emitter voltage values based on datasheet plots. The block converts the input, output, and reverse transfer capacitance values to junction capacitance values, as described in Charge Model.

• ```Specify tabulated gate-emitter, gate-collector and collector-emitter capacitance``` — Provide tabulated values for junction capacitances and collector-emitter voltage.

Input capacitance, Cies

The gate-emitter capacitance with the collector shorted to the source. This parameter is visible only for the following two values for the Parameterization parameter:

• If you select ```Specify fixed input, reverse transfer and output capacitance```, the default value is `26.4` nF.

• If you select ```Specify tabulated input, reverse transfer and output capacitance```, the default value is `[80 40 32 28 27.5 27 26.5 26.5 26.5]` nF.

Reverse transfer capacitance, Cres

The collector-gate capacitance with the emitter connected to ground. This parameter is visible only for the following two values for the Parameterization parameter:

• If you select ```Specify fixed input, reverse transfer and output capacitance```, the default value is `2.7` nF.

• If you select ```Specify tabulated input, reverse transfer and output capacitance```, the default value is `[55 9 5.5 3.1 2.5 2.1 1.9 1.8 1.7]` nF.

Output capacitance, Coes

The collector-gate capacitance with the gate and emitter shorted. This parameter is visible only for the following two values for the Parameterization parameter:

• If you select ```Specify fixed input, reverse transfer and output capacitance```, the default value is `0` nF.

• If you select ```Specify tabulated input, reverse transfer and output capacitance```, the default value is `[60 20 12 8 6 4.8 4 3.5 3.1]` nF.

Gate-emitter junction capacitance

The value of the capacitance placed between the gate and the emitter. This parameter is visible only for the following two values for the Parameterization parameter:

• If you select ```Specify fixed gate-emitter, gate-collector and collector-emitter capacitance```, the default value is `23.7` nF.

• If you select ```Specify tabulated gate-emitter, gate-collector and collector-emitter capacitance```, the default value is `[25 31 26.5 24.9 25 24.9 24.6 24.7 24.8]` nF.

Gate-collector junction capacitance

The value of the capacitance placed between the gate and the collector. This parameter is visible only for the following two values for the Parameterization parameter:

• If you select ```Specify fixed gate-emitter, gate-collector and collector-emitter capacitance```, the default value is `2.7` nF.

• If you select ```Specify tabulated gate-emitter, gate-collector and collector-emitter capacitance```, the default value is `[55 9 5.5 3.1 2.5 2.1 1.9 1.8 1.7]` nF.

Collector-emitter junction capacitance

The value of the capacitance placed between the collector and the emitter. This parameter is visible only for the following two values for the Parameterization parameter:

• If you select ```Specify fixed gate-emitter, gate-collector and collector-emitter capacitance```, the default value is `0` nF.

• If you select ```Specify tabulated gate-emitter, gate-collector and collector-emitter capacitance```, the default value is `[5 11 6.5 4.9 3.5 2.7 2.1 1.7 1.4]` nF.

Corresponding collector-emitter voltages

The collector-emitter voltages corresponding to the tabulated capacitance values. This parameter is visible only for tabulated capacitance models (```Specify tabulated input, reverse transfer and output capacitance``` or ```Specify tabulated gate-emitter, gate-collector and output capacitance```). The default value is `[0 1 2 5 10 15 20 25 30]` V.

Charge-voltage linearity

Select whether gate-drain capacitance is fixed or nonlinear:

• `Gate-collector capacitance is constant` — The capacitance value is constant and defined according to the selected parameterization option, either directly or derived from a datasheet. This is the default method.

• `Gate-collector charge function is nonlinear` — The gate-collector charge relationship is defined according to the piecewise-nonlinear function described in Charge Model. Two additional parameters appear to let you define the gate-collector charge function.

This parameter is visible only for fixed capacitance models (`Specify fixed input, reverse transfer and output capacitance` or ```Specify fixed gate-emitter, gate-collector and output capacitance```).

Gate-collector oxide capacitance

The gate-collector capacitance when the device is on and the collector-gate voltage is small. This parameter is visible only when you select `Gate-collector charge function is nonlinear` for the Charge-voltage linearity parameter. The default value is `20` nF.

Collector-gate voltage below which oxide capacitance becomes active

The collector-gate voltage at which the collector-gate capacitance switches between off-state (CGC) and on-state (Cox) capacitance values. This parameter is visible only when you select ```Gate-collector charge function is nonlinear``` for the Charge-voltage linearity parameter. The default value is `-5` V.

Total forward transit time

The forward transit time for the PNP transistor used as part of the underlying IGBT model. It affects how quickly charge is removed from the channel when the IGBT is turned off. The default value is `0` μs.

### Advanced Tab (Default Block Variant)

The lookup table representation combines all the equivalent circuit components into one lookup table, and therefore this tab is empty. If you use the equivalent circuit representation, this tab has the following parameters.

Emission coefficient, N

The emission coefficient or ideality factor of the bipolar transistor. The default value is `1`.

Forward Early voltage, VAF

The forward Early voltage for the PNP transistor used in the IGBT model. See the PNP Bipolar Transistor block reference page for more information. The default value is `200` V.

Collector resistance, RC

Resistance at the collector. The default value is `0.001` Ohm.

Emitter resistance, RE

Resistance at the emitter. The default value is `0.001` Ohm.

Internal gate resistance, RG

The value of the internal gate resistor at the measurement temperature. Note that this is not the value of the external circuit series gate resistance, which you should model externally to the IGBT. The default value is `0.001` Ohm.

Forward current transfer ratio, BF

Ideal maximum forward current gain for the PNP transistor used in the IGBT model. See the PNP Bipolar Transistor block reference page for more information. The default value is `50`.

### Temperature Dependence Tab (Default Block Variant)

For the lookup table representation, the electrical equations do not depend on temperature and therefore this tab is empty. If you use the equivalent circuit representation, this tab has the following parameters.

Parameterization

Select one of the following methods for temperature dependence parameterization:

• ```None — Simulate at parameter measurement temperature``` — Temperature dependence is not modeled, and none of the other parameters on this tab are visible. This is the default method.

• ```Specify Ices and Vce(sat) at second measurement temperature``` — Model temperature-dependent effects by providing values for the zero gate voltage collector current, Ices, and collector-emitter voltage, Vce(sat), at the second measurement temperature.

• ```Specify Vce(sat) at second measurement temperature plus the energy gap, EG``` — Use this option when the datasheet does not provide information on the zero gate voltage collector current, Ices, at a higher measurement temperature.

Energy gap, EG

Energy gap value. This parameter is visible only when you select ```Specify Vce(sat) at second measurement temperature plus the energy gap, EG``` for the Parameterization parameter. The default value is `1.11` eV.

Zero gate voltage collector current, Ices, at second measurement temperature

The zero gate collector current value at the second measurement temperature. This parameter is visible only when you select ```Specify Ices and Vce(sat) at second measurement temperature``` for the Parameterization parameter. The default value is `100` mA.

Collector-emitter saturation voltage, Vce(sat), at second measurement temperature

The collector-emitter saturation voltage value at the second measurement temperature, and when the collector current and gate-emitter voltage are as defined by the corresponding parameters on the Main tab. The default value is `3` V.

Second measurement temperature

Second temperature Tm2 at which Zero gate voltage collector current, Ices, at second measurement temperature and Collector-emitter saturation voltage, Vce(sat), at second measurement temperature are measured. The default value is `125` °C.

Saturation current temperature exponent, XTI

The saturation current exponent value for your device type. If you have graphical data for the value of Ices as a function of temperature, you can use it to fine-tune the value of XTI. The default value is `3`.

Mobility temperature exponent, BEX

Mobility temperature coefficient value. You can use the default value for most devices. If you have graphical data for Vce(sat) at different temperatures, you can use it to fine-tune the value of BEX. The default value is `-1.5`.

Internal gate resistance temperature coefficient

Represents the fractional rate of change (α) of internal gate resistance (RG) with temperature. Thus the gate resistance is R = Rmeas(1 + α (Ts – Tm1 )), where Rmeas is the Internal gate resistance, RG parameter value. The default value is `0` 1/K.

Device simulation temperature

Temperature Ts at which the device is simulated. The default value is `25` °C.

### Main Tab (Event-Based Block Variant)

This configuration of the Main tab corresponds to the simplified, event-based block variant. If you are using the detailed variant of the block, see Main Tab (Default Block Variant).

Vector of temperatures, Tj

Temperature values at which the collector-emitter and turn-on/turn-off losses are quoted. The default values, in K, are ```[298.15, 398.15]```. This parameter is visible only if your block has an exposed thermal port.

Vector of collector currents, Ic

Collector currents for which the on-state collector-emitter voltages are defined. The first element must be zero. The default values, in A, are `[0, 10, 50, 100, 200, 400, 600]`.

Corresponding on-state collector-emitter voltages

Collector-emitter voltages corresponding to the vector of collector currents. The first element must be zero. The default values, in V, are `[0, 1.1, 1.3, 1.45, 1.75, 2.25, 2.7]`. If your block has an exposed thermal port, this parameter is replaced with the Collector-emitter on-state voltages, Vce=fcn(Tj,Ic) parameter, which defines the voltages in terms of both temperature and current.

Collector-emitter on-state voltages, Vce=fcn(Tj,Ic)

Collector-emitter voltages when in the on state, defined as a function of both temperature and current. The default values, in V, are ```[0, 1.1, 1.3, 1.45, 1.75, 2.25, 2.7; 0, 1.0, 1.15, 1.35, 1.7, 2.35, 3.0]```. This parameter is visible only if your block has an exposed thermal port.

Turn-on switching losses, Eon=fcn(Tj,Ic)

Energy loss when turning the device on, defined as a function of temperature and final on-state current. The default values, in J, are ```[0, 0.2, 1, 2, 4, 8, 15; 0, 0.3, 1.3, 2.5, 5, 11, 18]*1e-3```. This parameter is visible only if your block has an exposed thermal port.

Turn-off switching losses, Eoff=fcn(Tj,Ic)

Energy loss when turning the device off, defined as a function of temperature and final on-state current. The default values, in J, are ```[0, 0.3, 1.5, 3, 6, 15, 25; 0, 0.7, 3.3, 6.5, 13, 25, 35]*1e-3```. This parameter is visible only if your block has an exposed thermal port.

Miller resistance

When the device turns on, it has a constant-value Miller resistance in series with the demanded voltage ramp. This resistance represents the partial conductance path through the device during turn on, and can be used to match the voltage spike observed when reconnecting a current-carrying inductor and corresponding freewheeling diode. A typical value is 10 to 50 times the effective on-state resistance. The default value is `0.1` Ohm.

Off-state conductance

Conductance when the device is in the off state. The default value is `1e-5` 1/Ohm.

Threshold voltage, Vth

The gate-emitter voltage must be greater than this value for the device to turn on. The default value is `6` V.

### Dynamics Tab (Event-Based Block Variant)

Turn-on delay

Time before which the device starts to ramp on. The default value is `0.07` us.

Current rise time

Time taken for the current to ramp up when driving a resistive load. The default value is `0.7` us.

Turn-off delay

Time before which the device starts to ramp off. The default value is `0.2` us.

Current fall time

Time taken for the current to ramp down when driving a resistive load. The default value is `0.5` us.

Off-state voltage for rise and fall times

Off-state collector-emitter voltage used when specifying the rise and fall times. The default value is `300` V. If your block has an exposed thermal port, this parameter is replaced with the Off-state voltage for timing and losses data parameter, which defines the voltage used when specifying the rise and fall times and also the losses data, also with the default value of `300` V.

## Ports

The block has the following ports:

`C`

Electrical conserving port associated with the PNP emitter terminal

`G`

Electrical conserving port associated with the IGBT gate terminal

`E`

Electrical conserving port associated with the PNP collector terminal

Was this topic helpful?

Get trial now