SPICE Diode

SPICE-compatible diode

• Library:

• Simscape / Electrical / Additional Components / SPICE Semiconductors

Description

The SPICE Diode block represents a SPICE-compatible diode.

SPICE, or Simulation Program with Integrated Circuit Emphasis, is a simulation tool for electronic circuits. You can convert some SPICE subcircuits into equivalent Simscape™ Electrical™ models using the Environment Parameters block and SPICE-compatible blocks from the Additional Components library. For more information, see subcircuit2ssc.

Equations

Variables for the SPICE Diode block equations include:

• Variables that you define by specifying parameters for the SPICE Diode block. The visibility of some of the parameters depends on the value that you set for other parameters. For more information, see Parameters.

• Geometry-adjusted variables, which depend on several values that you specify using parameters for the SPICE Diode block. For more information, see Geometry-Adjusted Variables.

• Temperature, T, which is 300.15 K by default. You can use a different value by specifying parameters for the SPICE Diode block or by specifying parameters for both the SPICE Diode block and an Environment Parameters block. For more information, see Diode Temperature.

• Temperature-dependent variables. For more information, see Temperature Dependence.

• Minimal conductance, GMIN, which is 1e–12 1/Ohm by default. You can use a different value by specifying a parameter for an Environment Parameters block. For more information, see Minimal Conduction.

• Thermal voltage, V_t. For more information, see Thermal Voltage.

Geometry-Adjusted Variables

Several variables in the equations for the SPICE diode model consider the geometry of the device that the block represents. These geometry-adjusted variables depend on variables that you define by specifying SPICE Diode block parameters. The geometry-adjusted variables depend on these variables:

• AREA — Area of the device

• SCALE — Number of parallel connected devices

• The associated unadjusted variable

The table includes the geometry-adjusted variables and the defining equations.

Variable	Description	Equation
CJOd	Geometry-adjusted zero-bias junction capacitance	$$CJ{O}_d=CJO*AREA*SCALE$$
IBVd	Geometry-adjusted reverse breakdown current	$$IB{V}_d=IBV*AREA*SCALE$$
ISd	Geometry-adjusted saturation current	$$I{S}_d=IS*AREA*SCALE$$
RSd	Geometry-adjusted series resistance	$$R{S}_d=\frac{RS}{AREA*SCALE}$$

Diode Temperature

You can use these options to define diode temperature, T:

• Fixed temperature — The block uses a temperature that is independent from the circuit temperature when the Model temperature dependence using parameter in the Temperature settings of the Spice Diode block is set to Fixed temperature. For this model, the block sets T equal to TFIXED.

• Device temperature — The block uses a temperature that depends on circuit temperature when the Model temperature dependence using parameter in the Temperature settings of the Spice Diode block is set to Device temperature. For this model, the block defines temperature as

  $$T=T_C+TOFFSET$$

  Where:

  • T_C is the circuit temperature.

    If there is no Environment Parameters block in the circuit, T_C is equal to 300.15 K.

    If there is an Environment Parameters block in the circuit, T_C is equal to the value that you specify for the Temperature parameter in the Spice settings of the Environment Parameters block. The default value for the Temperature parameter is 300.15 K.

  • TOFFSET is the offset local circuit temperature.

Minimal Conduction

Minimal conductance, GMIN, has a default value of 1e–12 1/Ohm. To specify a different value:

1. If there is not an Environment Parameters block in the diode circuit, add one.

2. In the Spice settings of the Environment Parameters block, specify the desired GMIN value for the GMIN parameter.

Thermal Voltage

Thermal voltage, V_t, is defined by the equation

$$V_t=N\frac{k*T}{q}$$

Where:

• N is the emission coefficient.

• T is the diode temperature. For more information, see Diode Temperature.

• k is the Boltzmann constant.

• q is the elementary charge on an electron.

Current-Voltage Equations

This table shows the equations that define the relationship between the diode current, I_d, and the diode voltage, V_d. As applicable, the model parameters are first adjusted for temperature. For more information, see Temperature Dependence.

Vd Range	Id Equation
$$V_d>80*V_t$$	$$I_d=I{S}_d\left(\left(\frac{V_d}{V_t}-79\right)e^{80}-1\right)+V_d*GMIN$$
$$80*V_t\ge V_d\ge -3*V_t$$	$$I_d=I{S}_d*(e^{V_d/V_t}-1)+V_d*GMIN$$
$$-3*V_t>V_d\ge -BV$$	$$I_d=-I{S}_d\left(1+\frac{27}{{\left(V_d/V_t\right)}^3{e}^3}\right)+V_d*GMIN$$
$$V_d<-BV$$	$$\begin{array}{l}{I}_d=-IB{V}_d*\left(e^{-\left(BV+V_d\right)/V_t}-1\right)-\\ I{S}_d*\left(1-{\left(\frac{3}{\raisebox{1ex}{$\left(e*BV\right)$}\!\left/ \!\raisebox{-1ex}{$V_t$}\right.}\right)}^3\right)+V_d*GMIN\end{array}$$

Where:

• IS_d is the geometry-adjusted saturation current. For more information, see Geometry-Adjusted Variables.

• V_t is thermal voltage. For more information, see Thermal Voltage.

• N is the emission coefficient.

• q is the elementary charge on an electron.

• k is the Boltzmann constant.

• T is the diode temperature. For more information, see Diode Temperature.

• GMIN is the diode minimum conductance. For more information, see Minimal Conduction.

• BV is the reverse breakdown voltage.

Junction Charge Model

The table shows the equations that define the relationship between the diode charge Q_d, and the diode voltage, V_d. As applicable, the model parameters are first adjusted for temperature. For more information, see Temperature Dependence.

Vd Range	Qd Equation
$$V_d<FC*VJ$$	$$Q_d=TT*I_d+CJ{O}_d*VJ*\frac{1-{\left(1-\frac{V_d}{VJ}\right)}^{1-M}}{1-M}$$
$$V_d\ge FC*VJ$$	$$\begin{array}{l}{Q}_d=TT*I_d+\\ CJ{O}_d*\left(F1+\frac{F3*\left(V_d-FC*VJ\right)+\left(\frac{M}{2*VJ}\right)*\left(V_d^2-{\left(FC*VJ\right)}^2\right)}{F2}\right)\text{}\end{array}$$

Where:

• FC is the forward bias depletion capacitance coefficient.

• VJ is the junction potential.

• TT is the transit time.

• CJO_d is the geometry-adjusted zero-bias junction capacitance. For more information, see Geometry-Adjusted Variables.

• M is the grading coefficient.

• $$F1=VJ*(1-{(1-FC)}^{(1-M)})/(1-M)$$

• $$F2={(1-FC)}^{(1+M)}$$

• $$F3=1-FC*(1+M)$$

Temperature Dependence

The relationship between the geometry-adjusted saturation current and the diode temperature is

$$I{S}_d(T)=I{S}_d*{\left(T/TMEAS\right)}^{\frac{XTI}{N}}*e^{\left(\frac{T}{TMEAS}-1\right)*\frac{EG}{V_t}}$$

Where:

• IS_d is the geometry-adjusted saturation current. For more information, see Geometry-Adjusted Variables.

• T is the diode temperature. For more information, see Diode Temperature.

• TMEAS is the parameter extraction temperature.

• XTI is the saturation current temperature exponent.

• N is the emission coefficient.

• EG is the activation energy.

• V_t is thermal voltage. For more information, see Thermal Voltage.

The relationship between the junction potential and the diode temperature is

$$VJ(T)=VJ*\left(\frac{T}{TMEAS}\right)-\frac{3*k*T}{q}*\log \left(\frac{T}{TMEAS}\right)-\left(\frac{T}{TMEAS}\right)*E{G}_{TMEAS}+E{G}_T$$

Where:

• VJ is the junction potential.

• EG_TMEAS is the activation energy for the temperature at which the diode parameters were measured. The defining equation is $$E{G}_{TMEAS}=1.16eV-\left(7.02e-4*TMEA{S}^2\right)/\left(TMEAS+1108\right)$$.

• EG_T is the activation energy for the diode temperature. The defining equation is $$E{G}_T=1.16eV-\left(7.02e-4*T^2\right)/\left(T+1108\right)$$.

The relationship between the geometry-adjusted diode zero-bias junction capacitance and the diode temperature is

$$CJ{O}_d(T)=CJ{O}_d*\left[1+M*\left(400e-6*\left(T-TMEAS\right)-\frac{VJ(T)-VJ}{VJ}\right)\right]$$

Where:

• CJO_d is the geometry-adjusted zero-bias junction capacitance. For more information, see Geometry-Adjusted Variables.

• M is the grading coefficient.

Assumptions and Limitations

• The block does not support noise analysis.

• The block applies initial conditions across junction capacitors and not across the block ports.

Ports

Conserving

+ — Positive voltage

electrical

Electrical conserving port associated with positive voltage.

- — Negative voltage

electrical

Electrical conserving port associated with negative voltage.

Parameters

Main

Device area, AREA — Device area

1.0 m^2 (default) | positive scalar

Diode area. The value must be greater than 0.

Number of parallel devices, SCALE — Number of parallel devices

1 (default) | positive scalar

Number of parallel diodes that the block represents. The value must be greater than 0.

Saturation current, IS — Saturation current

1e-14 A/m^2 (default) | nonnegative scalar

Magnitude of the current that the ideal diode equation approaches asymptotically for very large reverse bias levels. The value must be greater than or equal to 0.

Ohmic resistance, RS — Series resistance

0.01 m^2*Ohm (default) | nonnegative scalar

Series diode connection resistance. The value must be greater than or equal to 0.

Emission coefficient, N — Emission coefficient,

1 (default) | positive scalar

Diode emission coefficient or ideality factor. The value must be greater than 0.

Junction Capacitance

Model junction capacitance — Junction capacitance model

No (default) | Yes

Options for modeling the junction capacitance:

• No — Do not include junction capacitance in the model.

• Yes — Specify zero-bias junction capacitance, junction potential, grading coefficient, forward-bias depletion capacitance coefficient, and transit time.

Dependencies

Selecting Yes exposes related parameters.

Zero-bias junction capacitance, CJO — Zero-bias junction capacitance

0 F/m^2 (default) | nonnegative scalar

Value of the capacitance placed in parallel with the exponential diode term. The value must be greater than or equal to 0.

Dependencies

This parameter is only visible when you select Yes for the Model junction capacitance parameter.

Junction potential, VJ — Junction potential

1 V (default) | VJ > 0.01 | scalar

Junction potential, VJ. The value must be greater than 0.01 V.

Dependencies

This parameter is only visible when you select Yes for the Model junction capacitance parameter.

Grading coefficient, M — Grading coefficient

0.5 (default) | 0 < M < 0.9 | scalar

Grading coefficient, M. The value must be greater than 0 and less than 0.9.

Dependencies

This parameter is only visible when you select Yes for the Model junction capacitance parameter.

Capacitance coefficient, FC — Capacitance coefficient

0.5 (default) | 0 ≤ FC < 0.95 | scalar

Fitting coefficient,, FC, that quantifies the decrease of the depletion capacitance with applied voltage. The value must be greater than or equal to 0 and less than 0.95.

Dependencies

This parameter is only visible when you select Yes for the Model junction capacitance parameter.

Transit time, TT — Transit time

0 s (default) | nonnegative scalar

Transit time, TT, of the carriers that cause diffusion capacitance. The value must be greater than or equal to 0.

Dependencies

This parameter is only visible when you select Yes for the Model junction capacitance parameter.

Specify initial condition — Initial condition model

No (default) | Yes

Options for specifying initial conditions:

• No — Do not specify an initial condition for the model.

• Yes — Specify the initial diode voltage.

  Note

  The SPICE Diode block applies the initial diode voltage across the junction capacitors and not across the ports.

Dependencies

This parameter is only visible when you select Yes for the Model junction capacitance parameter.

Selecting Yes for this parameter exposes the Initial condition voltage, V0 parameter.

Initial condition voltage, V0 — Initial voltage

0 V (default) | scalar

Diode voltage at the start of the simulation.

Note

The block applies the initial condition across the diode junction, so the initial condition is only effective when charge storage is included, that is, when one or both of the Zero-bias junction capacitance, CJO and Transit time, TT parameters are greater than zero.

Dependencies

This parameter is only visible when you select Yes for the Model junction capacitance and Yes for the Specify initial condition parameter.

Reverse Breakdown

Model reverse breakdown — Reverse breakdown model

No (default) | Yes

Options for modeling reverse breakdown:

• No — Do not model reverse breakdown.

• Yes — Introduce a second exponential term to the diode I-V relationship, thereby modeling a rapid increase in conductance as the breakdown voltage is exceeded.

Dependencies

Selecting Yes for this parameter exposes related parameters.

Reverse breakdown voltage, BV — Reverse breakdown threshold voltage

Inf V (default) | nonnegative scalar

If voltage drops below this value, the block models the rapid increase in conductance that occurs at diode breakdown. The value must be greater than or equal to 0.

Dependencies

This parameter is only visible when you select Yes for the Model reverse breakdown parameter.

Reverse breakdown current, IBV — Reverse breakdown current

1e-3 A/m^2 (default) | positive scalar

Diode current that corresponds to the voltage specified for the Reverse breakdown voltage, BV parameter. The value must be greater than 0.

Dependencies

This parameter is only visible when you select Yes for the Model reverse breakdown parameter.

Temperature

Model temperature dependence using — Temperature dependence model

Device temperature (default) | Fixed temperature

Select one of these options for modeling the diode temperature dependence:

• Device temperature — Use the device temperature to model temperature dependence.

• Fixed temperature — Use a temperature that is independent of the circuit temperature to model temperature dependence.

For more information, see Diode Temperature.

Dependencies

Selecting Device temperature exposes the Offset local circuit temperature, TOFFSET parameter. Selecting Fixed temperature exposes the Fixed circuit temperature, TFIXED parameter.

Saturation current temperature exponent, XTI — Saturation current temperature exponent

3.0 (default) | positive scalar

Order of the exponential increase in the saturation current as temperature increases. The value must be greater than 0.

Activation energy, EG — Activation energy

1.11 eV (default) | EG ≥ 0.1 | scalar

Diode activation energy. The value must be greater than or equal to 0.1 eV.

Fixed circuit temperature, TFIXED — Fixed circuit temperature

300.15 K (default) | positive scalar

Diode simulation temperature. The value must be greater than 0 K.

Dependencies

This parameter is only visible when you select Fixed temperature for the Model temperature dependence using parameter.

Parameter extraction temperature, TMEAS — Parameter extraction temperature

300.15 K (default) | positive scalar

Temperature at which the diode parameters are measured. The value must be greater than 0 K.

Offset local circuit temperature, TOFFSET — Local circuit temperature offset

0 K (default) | scalar

Amount by which the diode temperature differs from the circuit temperature.

Dependencies

This parameter is only visible when you select Device temperature for the Model temperature dependence using parameter.

Extended Capabilities

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