Main Content

ee_importDeviceParameters

Parameterize ideal semiconductor block from Hitachi, Infineon, or Wolfspeed XML file

Since R2021b

Description

Hitachi Devices

ee_importDeviceParameters(file,"hitachi",blockPath) extracts the parameters from a datasheet in a format Hitachi supports for a diode, insulated-gate bipolar transistor (IGBT), or metal-oxide-semiconductor field-effect transistor (MOSFET). This syntax imports the parameters into a Simscape™ block at the specified blockPath. The XML file must be on the MATLAB® path. This syntax supports these blocks:

For examples of Hitachi datasheets for IGBT and diode devices, see the Insulated Gate Bipolar Transistor (IGBT) and diode modules with SPT, SPT+, SPT++ and TSPT+ chips page on the Hitachi website.

example

Infineon Devices

ee_importDeviceParameters(file,"infineon",blockPath,GateResistanceOn=Rgon) extracts the parameters from a datasheet in a format that Infineon® supports for a diode with the switch-on gate resistance value specified by Rgon. This syntax imports the parameters into a Diode block at the specified blockPath. The XML file must be on the MATLAB path (since R2024b).

ee_importDeviceParameters(file,"infineon",blockPath,GateResistanceOn=Rgon,GateResistanceOff=Rgoff) extracts the parameters from a datasheet for an IGBT with the switch-on and switch-off gate resistance values specified by Rgon and Rgoff. This syntax imports the parameters into a Simscape block at the specified blockPath. The XML file must be on the MATLAB path. This syntax supports these blocks:

For examples of Infineon datasheets for IGBT devices, see the IGBTs – Insulated Gate Bipolar Transistors page on the Infineon website.

Wolfspeed Devices

Since R2025a

ee_importDeviceParameters(file,"wolfspeed",blockPath,GateResistanceOn=Rgon) extracts the parameters from a datasheet in a format that Wolfspeed supports for a diode with the switch-on gate resistance value specified by Rgon. This syntax imports the parameters into a Diode block at the specified blockPath. The XML file must be on the MATLAB path.

Note

The function does not use the value of Rgon because Wolfspeed diode XML files presently specify the reverse recovery energy losses as constant zero. (since R2025a)

ee_importDeviceParameters(file,"wolfspeed",blockPath,GateResistanceOn=Rgon,GateResistanceOff=Rgoff) extracts the parameters from a datasheet in a format that Wolfspeed supports for a MOSFET with the switch-on and switch-off gate resistance values specified by Rgon and Rgoff. This syntax imports the parameters into a Simscape block at the specified blockPath. The XML file must be on the MATLAB path. This syntax supports these blocks:

For examples of Wolfspeed datasheets, see the LTspice and PLECS Models page on the Wolfspeed website.

Additional Options

ee_importDeviceParameters(___,Verbose=true) also enables warnings about unused fields in the XML file.

ee_importDeviceParameters(___,Verbose=false) also disables warnings about unused fields in the XML file.

Examples

collapse all

Choose the block you want to import the parameters into. Open a model that contains an IGBT (Ideal, Switching) block.

openExample("simscapeelectrical/ImportIGBTFromHitachiExample")

Edit the ee_import_igbt_device_parameters_data.xml file to inspect the content.

edit ImportIGBTFromHitachiData.xml 

Click the IGBT (Ideal, Switching) block and then call the ee_importDeviceParameters function.

ee_importDeviceParameters("ImportIGBTFromHitachiData.xml","hitachi",gcb)

Input Arguments

collapse all

Name of the XML file that you want to import and extract the parameters from.

To parameterize a Diode, IGBT (Ideal, Switching), or MOSFET (Ideal, Switching) block, specify file as a case-sensitive string.

To parameterize a Half-Bridge (Ideal, Switching) block, specify file as a cell array {file1,file2} where file1 and file2 are case-sensitive strings. file1 is the XML file that parameterizes the switching devices, which must be IGBTs or MOSFETs. file2 is the XML file that parameterizes the integral protection diodes (since R2024b).

Example: ee_importDeviceParameters("ImportIGBTFromHitachiData.xml","hitachi",gcb) parameterizes the IGBT (Ideal, Switching) block you click in your model with data in the format that Hitachi supports from the ImportIGBTFromHitachiData.xml file.

Example: ee_importDeviceParameters({"ImportIGBTFromHitachiData.xml","ImportDiodeFromHitachiData.xml"},"hitachi",gcb) parameterizes the Half-Bridge (Ideal, Switching) block you click in your model with data in the format that Hitachi supports. The function uses ImportIGBTFromHitachiData.xml to import parameters for the switching devices and ImportDiodeFromHitachiData.xml to import parameters for the integral protection diodes.

Block path of the Diode, IGBT (Ideal, Switching), MOSFET (Ideal, Switching), or Half-Bridge (Ideal, Switching) block that you want to import the parameter values into.

Since R2024a

Switch-on gate resistance for the Infineon and Wolfspeed devices, specified in ohms.

For the Half-Bridge (Ideal, Switching) block, Rgon represents the switch-on gate resistance of the switching devices, which must be IGBT or MOSFET, and the integral protection diodes.

You can use this argument only if you specify the "infineon" or "wolfspeed" input argument.

Since R2024a

Switch-off gate resistance for an Infineon IGBT or Wolfspeed MOSFET, specified in ohms. The function uses this value to parameterize an IGBT (Ideal, Switching) or MOSFET (Ideal, Switching) block, or to import parameters for the switching devices into a Half-Bridge (Ideal, Switching) block.

You can use this argument only if you specify the "infineon" or "wolfspeed" input argument.

Option to enable warnings about unused fields in the XML file when you use this function, specified as true or false.

Tips

  • Infineon, Hitachi, and Wolfspeed datasheets do not specify values for every parameter of the blocks that this function supports. If the datasheet does not provide a value, the function uses the default block parameter values and appends % Parameter not set to the value. If you simulate a model that you parameterize using the ee_importDeviceParameters function and you do not obtain the expected results, tune these parameters to get better agreement with your data.

  • To parameterize an IGBT or MOSFET with a protection diode, model the diode externally. Call the ee_importDeviceParameters function twice; once to parameterize an IGBT (Ideal, Switching) or MOSFET (Ideal, Switching) block and once to parameterize a Diode block.

  • To parameterize a half-bridge with protection diodes, model the diodes internally in the Half-Bridge (Ideal, Switching) block. Call the ee_importDeviceParameters function once to parameterize the switching devices and the integral protection diodes.

  • Infineon, Hitachi, and Wolfspeed format XML files provide information that you can use to parameterize ideal switching device models with tabulated switching losses and a thermal model. Use the ee_importDeviceParameters function when you make these modeling assumptions:

    • Tabulated on-state I-V curve

    • No charge model

    • Tabulated switching losses

    • Foster or Cauer thermal network

    If you want to change these modeling assumptions, use a different method to parameterize the block. For more information about modeling assumptions and parameterization methods, see Choose Blocks to Model Semiconductor Devices.

  • Wolfspeed MOSFET XML files contain negative values in the current and voltage axes for the lookup tables of the 3-D switch-on and switch-off loss. The MOSFET (Ideal, Switching) block does not support negative values for the current axis as it assumes that the switching losses at negative current values are always zero. As a result, this function removes these negative axis values as well as the corresponding switch-on and switch-off energy loss data. The block supports the use of negative voltage axis values but assumes that the switching losses at these voltage values are always zero. (since R2025a)

  • Wolfspeed MOSFET XML files might specify different temperature (Tj) axis values for the switch-on and switch-off loss lookup tables. As MOSFET (Ideal, Switching) and Half-Bridge (Ideal, Switching) blocks do not support different Tj axis values for these lookup tables, this function performs linear interpolation of the switch-on and switch-off loss lookup tables such that they share the same common Tj axis. (since R2025a)

  • Wolfspeed XML files for MOSFET, body diode, and standalone diode parts specify parameters for Cauer thermal network. (since R2025a)

  • Wolfspeed XML files specify a formula that determines the scaling factor of the switch-on and switch-off loss lookup tables that varies with the turn-on and turn-off gate resistances, respectively. (since R2025a)

  • Wolfspeed XML files for both the body diode of the MOSFET and standalone diode parts currently specify zero reverse recovery losses. (since R2025a)

  • If the Wolfspeed XML file uses the same gate resistance value for the computation of the switch-on and switch-off losses, the ee_importDeviceParameters function uses the values of the GateResistanceOn and GateResistanceOff arguments for their computation. (since R2025a)

  • If the Wolfspeed XML file contains on-state voltage lookup (Von(Tj,I)) values that do not monotonically increase with the values in the current vector, the ee_importDeviceParameters function removes the column of the on-state voltage drop lookup table that contains the invalid value and the corresponding element of the current vector. (since R2025a)

Version History

Introduced in R2021b

expand all