Half-Bridge (Ideal, Switching)

Half-bridge with ideal switches and thermal port

Since R2021b

• 

Libraries:
Simscape / Electrical / Semiconductors & Converters

Description

The Half-Bridge (Ideal, Switching) block models a half-bridge with ideal switches and a thermal port. To choose the ideal switching device, set the Switching device parameter to MOSFET, IGBT, or GTO.

You can specify an integral protection diode for each switching device. An integral diode protects the semiconductor device by providing a conduction path for a reverse current. An inductive load can produce a high reverse-voltage spike when the semiconductor device suddenly switches off the voltage supply to the load.

Note

The best option is to model diodes internally within the Half-Bridge (Ideal, Switching) block. To model the diodes externally, model them without capacitance or charge.

Switching Losses

For information about how the block models turn-on and turn-off losses, see the documentation page for the MOSFET (Ideal, Switching) block, IGBT (Ideal, Switching) block, or GTO block, depending on the option you select for the Switching Device parameter. The main difference between how these blocks and the Half-Bridge (Ideal, Switching) block model the losses is that, for the MOSFET and IGBT options, the Half-Bridge (Ideal, Switching) block does not use the Use last on-state current from previous cycle for turn-on loss or Use last off-state voltage from previous cycle for turn-off loss parameters. The reason for this difference is that the Half-Bridge (Ideal, Switching) block does not model diode capacitance or lead inductance because the block is designed for fast simulation using ideal switching. By modeling both switching devices in one block, you avoid the complexities associated with measuring the on-state current and off-state voltage for diode reverse recovery, so you do not need a physics-based diode charge model. The block measures the diode forward current and off-state voltages at the point that you command the complementary switching device to switch off.

By default, the block applies switching losses to the thermal node only, stepping the node temperature up by the requisite value. To draw the requisite power due to switching losses from the electrical supply, select the Apply switching losses to electrical supply parameter.

Instantaneously applying a switching loss to the electrical supply is not mathematically possible, so the block applies switching losses over a period equal to the value you specify for the Averaging period for switching losses parameter. Set this value equal to the pulse-width modulation (PWM) period of the gate driver.

Note

For all ideal switching devices, the logged simulation data reports the thermal losses as lastTurnOffLoss, lastTurnOnLoss, and lastReverseRecoveryLoss. These variables include losses as a pulse with an amplitude equal to the energy loss. If you use a script to sum the total losses over a defined simulation period, you must sum the pulse values at each pulse rising edge. Alternatively, you can extract conduction and switching losses from logged data using the ee_getPowerLossSummary and ee_getPowerLossTimeSeries functions. To learn how to log and plot simulation data, see the Log and Plot Simulation Data example.

You can also access the total accumulated switching losses for each of the two switching devices from the respective accumulatedSwitchingLosses variables in the logged simulation data. These variables sum all switching losses to date, including reverse recovery losses for the diode.

The power_dissipated variable in the logged simulation data does not include switching losses because the block models these losses as instantaneous events. The power_dissipated variable reports ohmic on-state losses.

If you are using a fixed-step solver, the shortest pulse on or pulse off that supports capture of the switching losses is three time steps long. If the pulse is shorter than three steps, the block does not report switching losses.

If you use tabulated data to model the switching losses or reverse recovery losses, check that the temperature, current, and voltage are in the range you specify. If you do not define a realistic thermal model, for example, if the junction mass or the conductance from the junction to the case is too small, the temperature can exceed the range you specify, causing the block to extrapolate the losses to nonphysical values.

Predefined Parameterization

The Half-Bridge (Ideal, Switching) block supports multiple predefined parameterizations.

Use this parameterization data to represent components by specific suppliers. The parameterizations of these half-bridges match the manufacturer data sheets. To load a predefined parameterization, double-click the Half-Bridge (Ideal, Switching) block, click the <click to select> hyperlink of the Selected part parameter, and, in the Block Parameterization Manager window, select the part you want to use from the list of available components.

Note

The predefined parameterizations of Simscape™ components use available data sources for the parameter values. Engineering judgement and simplifying assumptions are used to fill in for missing data. As a result, expect deviations between simulated and actual physical behavior. To ensure accuracy, validate the simulated behavior against experimental data and refine component models as necessary.

For more information about predefined parameterization and a list of the available components, see List of Pre-Parameterized Components.

Limitations

• If you set the Switching device parameter to GTO, the block assumes that the current change in the load between PWM cycles is small. This assumption implies that the load inductance or the switching frequency is large enough to smooth the current.

• If you select the Apply switching losses to electrical supply parameter, you must connect a power supply to the half-bridge. For example, you must clear the Apply switching losses to electrical supply parameter if your model has a switch that can disconnect one or both of the power supply connections. You can also encounter numerical initialization issues if the power supply does not initialize in the on state, for example, because of a smoothing capacitor that starts at zero charge.

Ports

Input

G — Gate terminals vector

physical signal

Physical signal conserving port associated with the gate terminals of the two switching devices, specified as a vector of two physical signals.

The first element of the vector controls the upper side switch. The second element of the vector controls the lower side switch. If, in the Diode settings, you set the Integral protection diode parameter to Yes, the first and second element of the vector also controls the lower and upper diode, respectively.

Dependencies

To enable this port, set Gate-control port to PS.

Conserving

+ — Positive terminal

electrical

Electrical conserving port associated with the positive terminal.

- — Negative terminal

electrical

Electrical conserving port associated with the negative terminal.

O — Output node

electrical

Electrical conserving port associated with the output node.

G1 — Gate terminal 1

electrical

Electrical conserving port associated with the gate terminal for the first switching device.

Dependencies

To enable this port, set Gate-control port to Electrical.

G2 — Gate terminal 2

electrical

Electrical conserving port associated with the gate terminal for the second switching device.

Dependencies

To enable this port, set Gate-control port to Electrical.

H — Thermal port

thermal

Thermal conserving port.

Parameters

Main

The visibility of the Main parameters depends on the Switching device and On-state behavior and losses parameters. To learn how to read this table, see Parameter Dependencies.

Main Parameter Dependencies

Parameters and Options
Gate-control port
Switching Device
MOSFET		IGBT		GTO
Threshold voltage, Vth		Threshold voltage, Vth		Gate trigger voltage, Vgt
				Gate turn-off voltage, Vgt_off
				Holding current
On-state behavior and losses		On-state behavior and losses		On-state behavior and losses
Specify constant values	Tabulate	Specify constant values	Tabulate	Specify constant values	Tabulate
Drain-source on resistance, R_DS(on)	On-state voltage, Vds(Tj,Ids)	Forward voltage, Vf	On-state voltage, Vds(Tj,Ice)	Forward voltage, Vf	On-state voltage, Vak(Tj,Iak)
	Temperature vector, Tj	On-state resistance	Temperature vector, Tj	On-state resistance	Temperature vector, Tj
	Drain-source current vector, Ids		Collector-emitter current vector, Ice		Anode-cathode current vector, Iak
Off-state conductance

Gate-control port — Gate-control port

PS (default) | Electrical

Option to use the physical signal input port G or the electrical conserving ports G1 and G2 as the gate control ports.

Switching device — Switching device option

MOSFET (default) | IGBT | GTO

Switching device for the half-bridge.

Threshold voltage, Vth — Threshold voltage

2 V | 6 V | positive scalar

Threshold voltage at which the device turns on. The default value depends on the Switching device setting.

Dependencies

See the Main Parameter Dependencies table.

Gate trigger voltage, Vgt — Gate trigger voltage

6 V (default) | positive scalar

Gate-cathode voltage threshold. The device turns on when the gate-cathode voltage is above this value.

Dependencies

See the Main Parameter Dependencies table.

Gate turn-off voltage, Vgt_off — Gate turn-off voltage

-1 V (default) | scalar

Gate-cathode voltage threshold. The device turns off when the gate-cathode voltage is below this value.

Dependencies

See the Main Parameter Dependencies table.

Holding current — Current threshold

1 A (default) | positive scalar

Current threshold. The device stays on when the current is above this value, even when the gate-cathode voltage falls below the gate trigger voltage.

Dependencies

See the Main Parameter Dependencies table.

On-state behavior and losses — On-state behavior and losses

Specify constant values (default) | Tabulate

Parameterization method for on-state behavior and switching losses, specified as one of these values:

• Specify constant values — Use scalar values to specify the output current, switch-on loss, and switch-off loss data. The block assumes that the energy dissipated during a single switch-on or switch-off event scales linearly with the off-state voltage and on-state current. The block also assumes that the losses are independent of temperature.

• Tabulate — Use vectors to specify the output current and temperature data. Use arrays to specify the switch-on loss and switch-off loss data.

Dependencies

See the Main Parameter Dependencies table.

Drain-source on resistance, R_DS(on) — Drain-source on resistance

0.01 Ohm (default) | positive scalar

Drain-source resistance when the device is on.

Dependencies

See the Main Parameter Dependencies table.

On-state voltage, Vds(Tj,Ids) — On-state voltage

[0, 1.1, 1.3, 1.45, 1.75, 2.25, 2.7; 0, 1, 1.15, 1.35, 1.7, 2.35, 3] V (default) | matrix of nonnegative scalars

Voltage drop across the device in a triggered conductive state. This parameter is a function of temperature and final on-state output current.

Dependencies

See the Main Parameter Dependencies table.

Drain-source current vector, Ids — Drain-source current vector

[0 10 50 100 200 400 600] A (default) | vector of positive scalars

Drain-source currents at which you quote the on-state voltage. The sign of the drain-source current must be the same as the sign of the corresponding drain-source voltage. If the drain-source voltage is zero, the corresponding drain-source current must also be zero.

Dependencies

See the Main Parameter Dependencies table.

Forward voltage, Vf — Forward voltage

0.8 V (default) | positive scalar

Minimum voltage required across the collector and emitter or anode and cathode block ports for the gradient of the diode I-V characteristic to be 1/R_on, where R_on is the value of the On-state resistance parameter.

Dependencies

See the Main Parameter Dependencies table.

On-state resistance — On-state collector-emitter resistance

0.001 Ohm (default) | positive scalar

Collector-emitter resistance when the device is on.

Dependencies

See the Main Parameter Dependencies table.

On-state voltage, Vds(Tj,Ice) — On-state voltage

[0, .1, .6, .8, 1, 1.3, 1.6, 2, 2.4; 0, .1, .7, 1, 1.2, 1.5, 1.9, 2.4, 2.8] V (default) | matrix of nonnegative scalars

Voltage drop across the device in a triggered conductive state. This parameter is a function of temperature and final on-state output current.

Dependencies

See the Main Parameter Dependencies table.

Collector-emitter current vector, Ice — Collector-emitter current vector

[0, .1, 1, 5, 10, 20, 40, 70, 100] A (default) | vector of positive scalars

Collector-emitter currents at which you quote the on-state voltage. The sign of the collector-emitter current must be the same as the sign of the corresponding collector-emitter voltage. If the collector-emitter voltage is zero, the corresponding collector-emitter current must also be zero.

Dependencies

See the Main Parameter Dependencies table.

On-state voltage, Vak(Tj,Iak) — On-state voltage

[0, .1, .6, .8, 1, 1.3, 1.6, 2, 2.4; 0, .1, .7, 1, 1.2, 1.5, 1.9, 2.4, 2.8] V (default) | matrix of nonnegative scalars

Voltage drop across the device in a triggered conductive state. This parameter is a function of temperature and final on-state output current.

Dependencies

See the Main Parameter Dependencies table.

Anode-cathode current vector, Iak — Anode-cathode current vector

[0, .1, 1, 5, 10, 20, 40, 70, 100] A (default) | vector of positive scalars

Anode-cathode currents at which you quote the on-state voltage. The sign of the anode-cathode current must be the same as the sign of the corresponding anode-cathode voltage. If the anode-cathode voltage is zero, the corresponding anode-cathode current must also be zero.

Dependencies

See the Main Parameter Dependencies table.

Temperature vector, Tj — Temperature values

[298.15, 398.15] K (default) | vector

Temperature values at which you quote the on-state voltage.

Dependencies

See the Main Parameter Dependencies table.

Off-state conductance — Off-state collector-emitter conductance

1e-6 1/Ohm (default) | positive scalar

Conductance when the device is off. The value must be less than 1/R, where R is the value of the On-state resistance parameter.

Dependencies

See the Main Parameter Dependencies table.

Losses

Switch-on loss — Switch-on loss

22.86e-3 J (default) | positive scalar

Energy dissipated during a single switch-on event.

Dependencies

To enable this parameter, set On-state behavior and losses to Specify constant values.

Switch-off loss — Switch-off loss

17.14e-3 J (default) | positive scalar

Energy dissipated during a single switch-off event.

Dependencies

To enable this parameter, set Switching device to MOSFET or IGBT and set On-state behavior and losses to Specify constant values.

Diode reverse recovery loss — Loss from diode-reverse recovery

5.70e-3 J (default) | positive scalar

Energy dissipated during a diode-reverse recovery event.

Dependencies

To enable this parameter, set On-state behavior and losses to Specify constant values and set Integral protection diode to Yes.

On-state current for loss data — Output current

600 A (default) | positive scalar

Output current at which you quote the switch-on loss, switch-off loss, and on-state voltage.

Dependencies

To enable this parameter, set On-state behavior and losses to Specify constant values.

Off-state voltage for loss data — Off-state voltage

300 V (default) | positive scalar

Output voltage when the device is off. The loss data define the blocking voltage at this value.

Dependencies

To enable this parameter, choose one of these options:

• Set Switching device to MOSFET, set On-state behavior and losses to Tabulate, and clear the Include switching loss tabulation with off-state Vds voltage parameter.

• Set Switching device to IGBT, set On-state behavior and losses to Tabulate, and clear the Include switching loss tabulation with off-state voltage parameter.

• Set Switching device to GTO.

• Set On-state behavior and losses to Specify constant values.

Apply switching losses to electrical supply — Option to apply switching losses to electrical supply

Off (default) | On

Since R2023b

Option to apply the switching losses to the electrical supply.

Clear this parameter to apply the switching losses to the thermal node only.

Select this parameter to apply the switching losses to the thermal node and the electrical supply.

Switch-on loss, Eon(Tj,Ids) — Switch-on loss

[0, .29, 1.43, 2.86, 5.71, 13.14, 22.86; 0, .57, 2.63, 5.14, 10.29, 20.57, 30.29] * 1e-3 J (default) | vector of positive scalars

Energy dissipated during a single switch-on event as a function of temperature and final on-state drain-source current.

Dependencies

To enable this parameter:

• Set Switching device to MOSFET.

• Set On-state behavior and losses to Tabulate.

• Clear the Include switching loss tabulation with off-state Vds voltage parameter.

Switch-off loss, Eoff(Tj,Ids) — Switch-off loss

[0, .21, 1.07, 2.14, 4.29, 9.86, 17.14; 0, .43, 1.97, 3.86, 7.71, 15.43, 22.71] * 1e-3 J (default) | vector of positive scalars

Energy dissipated during a single switch-off event as a function of temperature and final on-state drain-source current.

Dependencies

To enable this parameter:

• Set Switching device to MOSFET.

• Set On-state behavior and losses to Tabulate.

• Clear the Include switching loss tabulation with off-state Vds voltage parameter.

Diode reverse recovery loss, Erec(Tj,Ids) — Loss from diode-reverse recovery

[0, .0031, .021, .11, .21, .43, .99, 1.71, 3.078; 0, .0041, .043, .2, .39, .77, 1.54, 2.27, 4.08] * 1e-3 J (default) | vector of positive scalars

Energy dissipated during a diode-reverse recovery event as a function of temperature and final on-state drain-source current.

Dependencies

To enable this parameter:

• Set Switching device to MOSFET.

• Set On-state behavior and losses to Tabulate.

• Set Integral protection diode to Yes.

Temperature vector for losses, Tj — Temperature for losses

[298.15, 398.15] K (default) | vector

Temperature values at which you quote the losses.

Dependencies

To enable this parameter, set On-state behavior and losses to Tabulate.

Drain-source current vector for losses, Ids — Drain-source current for switching losses

[0, 10, 50, 100, 200, 400, 600] A (default) | vector of positive scalars

Drain-source currents at which you quote the losses. The sign of the drain-source current must be the same as the sign of the corresponding drain-source voltage. If the drain-source voltage is zero, the corresponding drain-source current must also be zero.

Dependencies

To enable this parameter, set Switching device to MOSFET and set On-state behavior and losses to Tabulate.

Include switching loss tabulation with off-state Vds voltage — Option to tabulate switching losses with off-state Vds voltage

Off (default) | On

Since R2023b

Option to tabulate the switching losses with the off-state drain-source voltage.

Clear this parameter to tabulate the switch-on loss and switch-off loss with the on-state drain-source current and temperature. The block assumes that the losses scale linearly with the off-state drain-source voltage.

Select this parameter to tabulate the switch-on loss and switch-off loss with the temperature, on-state drain-source current, and off-state drain-source voltage.

Dependencies

To enable this parameter, set Switching device to MOSFET and set On-state behavior and losses to Tabulate.

Switch-on loss, Eon(Tj,Ids,Vds) — Switch-on loss

[zeros(2, 7, 3)] J (default) | 3-D array of nonnegative scalars

Since R2023b

Energy dissipated during a single switch-on event as a function of temperature, on-state drain-source current, and off-state drain-source voltage.

Dependencies

To enable this parameter:

• Set Switching device to MOSFET.

• Set On-state behavior and losses to Tabulate.

• Select the Include switching loss tabulation with off-state Vds voltage parameter.

Switch-off loss, Eoff(Tj,Ids,Vds) — Switch-off loss

[zeros(2, 7, 3)] J (default) | 3-D array of nonnegative scalars

Since R2023b

Energy dissipated during a single switch-off event as a function of temperature, on-state drain-source current, and off-state drain-source voltage.

Dependencies

To enable this parameter:

• Set Switching device to MOSFET.

• Set On-state behavior and losses to Tabulate.

• Select the Include switching loss tabulation with off-state Vds voltage parameter.

Switch-on loss, Eon(Tj,Ice) — Switch-on loss

[0, .0024, .024, .12, .2, .48, 1.04, 2.16, 3.24; 0, .003, .03, .15, .25, .6, 1.3, 2.7, 4.05] * 1e-3 J (default) | vector of positive scalars

Energy dissipated during a single switch-on event as a function of temperature and final on-state collector-emitter current.

Dependencies

To enable this parameter:

• Set Switching device to IGBT.

• Set On-state behavior and losses to Tabulate.

• Clear the Include switching loss tabulation with off-state voltage parameter.

Switch-off loss, Eoff(Tj,Ice) — Switch-off loss

[0, .0007, .0066, .033, .066, .17, .33, .83, 1.5; 0, .001, .01, .05, .1, .25, .5, 1.2, 2.2] * 1e-3 J (default) | vector of positive scalars

Energy dissipated during a single switch-off event as a function of temperature and final on-state collector-emitter current.

Dependencies

To enable this parameter:

• Set Switching device to IGBT.

• Set On-state behavior and losses to Tabulate.

• Clear the Include switching loss tabulation with off-state voltage parameter.

Diode reverse recovery loss, Erec(Tj,Ice) — Loss from diode-reverse recovery loss

[0, .0031, .021, .11, .21, .43, .99, 1.71, 3.078; 0, .0041, .043, .2, .39, .77, 1.54, 2.27, 4.08] * 1e-3 J (default) | vector of positive scalars

Energy dissipated during a diode-reverse recovery event as a function of temperature and final on-state collector-emitter current.

Dependencies

To enable this parameter:

• Set Switching device to IGBT.

• Set On-state behavior and losses to Tabulate.

• Set Integral protection diode to Yes.

Collector-emitter current vector for losses, Ice — Collector-emitter current for losses

[0, .1, 1, 5, 10, 20, 40, 70, 100] A (default) | vector of positive scalars

Collector-emitter currents at which you quote the losses. The sign of the collector-emitter current must be the same as the sign of the corresponding collector-emitter voltage. If the collector-emitter voltage is zero, the corresponding collector-emitter current must also be zero.

Dependencies

To enable this parameter, set Switching device to IGBT and set On-state behavior and losses to Tabulate.

Include switching loss tabulation with off-state voltage — Option to tabulate switching losses with off-state voltage

Off (default) | On

Since R2023b

Option to tabulate the switching losses with the off-state voltage.

Clear this parameter to tabulate the switch-on loss and switch-off loss with the on-state collector-emitter current and temperature. The block assumes that the losses scale linearly with the off-state voltage.

Select this parameter to tabulate the switch-on loss and switch-off loss with the temperature, on-state collector-emitter current, and off-state voltage.

Dependencies

To enable this parameter, set Switching device to IGBT and set On-state behavior and losses to Tabulate.

Switch-on loss, Eon(Tj,Ice,Vce) — Switch-on loss

[zeros(2, 9, 3)] J (default) | 3-D array of nonnegative scalars

Since R2023b

Energy dissipated during a single switch-on event as a function of temperature, on-state collector-emitter current, and off-state collector-emitter voltage.

Dependencies

• Set Switching device to IGBT.

• Set On-state behavior and losses to Tabulate.

• Select the Include switching loss tabulation with off-state voltage parameter.

Switch-off loss, Eoff(Tj,Ice,Vce) — Switch-off loss

[zeros(2, 9, 3)] J (default) | 3-D array of nonnegative scalars

Since R2023b

Energy dissipated during a single switch-off event as a function of temperature, on-state collector-emitter current, and off-state collector-emitter voltage.

Dependencies

To enable this parameter:

• Set Switching device to IGBT.

• Set On-state behavior and losses to Tabulate.

• Select the Include switching loss tabulation with off-state voltage parameter.

Off-state voltage vector for switching losses, Vce — Off-state voltage vector for switching loss data

[0, 150, 300] V (default) | vector

Since R2023b

Off-state collector-emitter voltages at which you quote the switch-on loss and switch-off loss.

Dependencies

To enable this parameter:

• Set Switching device to IGBT.

• Set On-state behavior and losses to Tabulate.

• Select the Include switching loss tabulation with off-state voltage parameter.

Forced commutation switch-off loss — Forced commutation switch-off loss

17.14e-3 J (default) | positive scalar

Energy dissipated during a forced commutation switch-off event.

Dependencies

To enable this parameter, set Switching device to GTO and set On-state behavior and losses to Specify constant values.

Natural commutation rectification loss — Natural commutation rectification loss

10e-3 J (default) | positive scalar

Rectification loss that the block applies when the device switches off because the current falls below the value of the Holding current parameter.

Dependencies

To enable this parameter, set Switching device to GTO.

Switch-on loss, Eon(Tj,Iak) — Switch-on loss

[0, .0024, .024, .12, .2, .48, 1.04, 2.16, 3.24; 0, .003, .03, .15, .25, .6, 1.3, 2.7, 4.05] * 1e-3 J (default) | matrix of nonnegative scalars

Energy dissipated during a single switch-on event as a function of temperature and final on-state anode-cathode current.

Dependencies

To enable this parameter, set Switching device to GTO and set On-state behavior and losses to Tabulate.

Switch-off loss, Eoff(Tj,Iak) — Switch-off loss

[0, .0007, .0066, .033, .066, .17, .33, .83, 1.5; 0, .001, .01, .05, .1, .25, .5, 1.2, 2.2] * 1e-3 J (default) | vector of positive scalars

Energy dissipated during a single switch-off event as function of temperature and final on-state anode-cathode current.

Dependencies

To enable this parameter, set Switching device to GTO and set On-state behavior and losses to Tabulate.

Diode reverse recovery loss, Erec(Tj,Iak) — Loss from diode-reverse recovery loss

[0, .0031, .021, .11, .21, .43, .99, 1.71, 3.078; 0, .0041, .043, .2, .39, .77, 1.54, 2.27, 4.08] * 1e-3 J (default) | vector of positive scalars

Energy dissipated during a diode-reverse recovery event as a function of temperature and final on-state anode-cathode current.

Dependencies

To enable this parameter:

• Set Switching device to GTO.

• Set On-state behavior and losses to Tabulate.

• Set Integral protection diode to Yes.

Anode-cathode current vector for losses, Iak — Anode-cathode current for losses

[0, .1, 1, 5, 10, 20, 40, 70, 100] A (default) | vector of positive scalars

Anode-cathode currents at which you quote the losses. The sign of the anode-cathode current must be the same as the sign of the corresponding anode-cathode voltage. If the anode-cathode voltage is zero, the corresponding anode-cathode current must also be zero.

Dependencies

To enable this parameter, set Switching device to GTO and set On-state behavior and losses to Tabulate.

Averaging period for switching losses — Averaging period for switching losses

1e-3 s (default) | positive scalar

Since R2023b

Duration over which the block applies the switching losses to the electrical supply.

Dependencies

To enable this parameter, select the Apply switching losses to electrical supply parameter.

Integral Diode

Integral protection diode — Protection diode

No (default) | Yes

Whether to model the block integral protection diode.

Diode model — Diode model

Piecewise Linear (default) | Tabulated I-V curve

Diode model, specified as either:

• Piecewise Linear — Use a piecewise linear model for the diode, as described in Piecewise Linear Diode.

• Tabulated I-V curve — Use tabulated forward bias I-V data and fixed reverse bias off conductance.

Dependencies

To enable this parameter, set Integral protection diode to Yes.

Forward voltage — Forward voltage

0.8 V (default) | positive scalar

Minimum voltage required across the + and - block ports for the gradient of the diode I-V characteristic to be 1/R_on, where R_on is the value of the On resistance parameter.

Dependencies

To enable this parameter, set Integral protection diode to Yes and Diode model to Piecewise linear.

On resistance — On resistance

0.001 Ohm (default) | positive scalar

Rate of change of the voltage versus the current above the value of the Forward voltage parameter.

Dependencies

To enable this parameter, set Integral protection diode to Yes and Diode model to Piecewise linear.

Off conductance — Off conductance

1e-5 1/Ohm (default) | positive scalar

Conductance of the reverse-biased diode.

Dependencies

To enable this parameter, set Integral protection diode to Yes and Diode model to Piecewise linear.

Table type — Tabulated function

Table in If(Tj,Vf) form (default) | Table in Vf(Tj,If) form

Whether to tabulate the current as a function of temperature and voltage or the voltage as a function of temperature and current.

Dependencies

To enable this parameter, set Integral protection diode to Yes and Diode model to Tabulated I-V curve.

Forward currents, If(Tj,Vf) — Forward currents

[.07, .12, .19, 1.75, 4.24, 7.32, 11.2; .16, .3, .72, 2.14, 4.02, 6.35, 9.12] A (default) | nonnegative vector

Forward currents. This parameter must be a vector of at least three nonnegative elements.

Dependencies

To enable this parameter, set Integral protection diode to Yes, Diode model to Tabulated I-V curve, and Table type to Table in If(Tj,Vf) form.

Junction temperatures, Tj — Junction temperatures

[25, 125] degC (default) | vector of positive scalars

Vector of junction temperatures. This parameter must be a vector of at least two elements.

Dependencies

To enable this parameter, set Integral protection diode to Yes, and Diode model to Tabulated I-V curve.

Forward voltages, Vf — Forward voltages

[.5, .7, .9, 1.3, 1.7, 2.1, 2.5] V (default) | nonnegative vector

Vector of forward voltages. This parameter must be a vector of at least three nonnegative values.

Dependencies

To enable this parameter, set Integral protection diode to Yes, Diode model to Tabulated I-V curve, and Table type to Table in If(Tj,Vf) form.

Forward voltages, Vf(Tj,If) — Forward voltages

[.9, 1.15, 1.25, 1.5, 1.75, 2.17, 2.6, 2.85; .58, .68, .75, 1.1, 1.38, 1.77, 2.27, 2.7] V (default) | nonnegative vector

Forward voltages. This parameter must be a vector of at least three nonnegative elements.

Dependencies

To enable this parameter, set Integral protection diode to Yes, Diode model to Tabulated I-V curve, and Table type to Table in Vf(Tj,If) form.

Forward currents, If — Forward currents

[.1, .2, .5, 1, 2, 4, 7, 10] A (default) | nonnegative vector

Vector of forward currents. This parameter must be a vector of at least three nonnegative values.

Dependencies

To enable this parameter, set Integral protection diode to Yes, Diode model to Tabulated I-V curve, and Table type to Table in Vf(Tj,If) form.

Thermal Port

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

This block implements a single internal thermal model for both transistors and the two diodes. Any thermal model parameters, such as Cauer model parameters, apply to the aggregated thermal model. To model the thermal paths separately for each internal device, use separate discrete blocks for the transistors and diodes.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2021b

R2023b: Determine switching losses for discontinuous load currents

If you set the Switching device parameter to MOSFET or IGBT, the Half-Bridge (Ideal, Switching) block now supports discontinuous load currents.

The block supports discontinuous load currents by measuring the off-state voltage and on-state current at all turn-on and turn-off events to compute switching losses. New models behave this way by default. If you use a fixed-step solver, the shortest device on or off period is now one step. Before R2023b, the minimum period is three steps. To report switching losses, the minimum period is still three steps.

Before R2023b, the block measures the off-state voltage before turn-on and on-state current before turn-off only.

As a result of this change, if you create a model in an earlier release that uses the Half-Bridge (Ideal, Switching) block with external diodes that model capacitance or charge, you must update the model. The best option is to model diodes internally within the Half-Bridge (Ideal, Switching) block. To model the diodes externally, model them without capacitance or charge.

R2023b: Apply switching losses to electrical supply

You can now draw the power due to switching losses from the electrical supply by selecting the Apply switching losses to electrical supply parameter. Before R2023a, the block applies switching losses to the thermal node only, stepping the node temperature up by the requisite value.

R2023b: Tabulate switching losses with temperature, current, and voltage

If you set the Switching device parameter to MOSFET or IGBT, you can now tabulate switching losses with temperature, current, and voltage. In earlier releases, you can tabulate switching losses with temperature and current only.