Documentation Home Page ◇ Power Electronics Add-On for NI VeriStand Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.

Template Circuits

Owned by Pierre-Luc Renault (Unlicensed)
Sept 03, 2024
7 min read

The Template Circuits directory contains a collection of circuits specifically designed for integration with Machine Models. They are intended to serve as a starting point when simulating a machine and drive. See the table below for the location of those Template Circuits.

Directory

<Public Documents>\National Instruments\<NI VeriStand 20xx>\Examples\OPAL-RT\Power Electronics Add-On\Template Circuits

See the table below for a list of available circuits and compatibility with each of the Machine Models.

Circuit

Compatible Machines

Circuit

Compatible Machines

Three Phase Open Winding

IM SM

Two-Level Inverter Field Voltage

IM SM (RRSM)

Two-Level Inverter Six Phase

6-Phase PMSM BLDC

Two-Level Inverter Three Phase

PMSM BLDC, PMSM SH, IM SM (SCIM), IM with Saturation

 

 

Integrating a Template Circuit into a VeriStand Project

  1. To avoid modifying the original circuit model file, make a local copy of the Directory shown above.

  2. From a supported version of MATLAB, open one of the .slx circuit model files from the copied directory.

  3. If desired, modify the model to suit the needs of the application. Note that many of the circuit parameters are defined in the corresponding ParameterInitialization.m file.

  4. Load the circuit model into the VeriStand project by following the steps in How to Add a Circuit Model to the System Definition.

  5. Configure the mappings of the circuit model Sources, Switches, and Measurements as shown in the Circuit Descriptions section below. Additional information about the coupling between the Circuit Model and the Machine Model can be found in How to Simulate a Drive with a Machine.

Circuit Descriptions and Mapping

To integrate a Template Circuit into an application and couple it with a machine, see the instructions How to Simulate a Drive with a Machine. Expand the sections below for a description of each Template Circuit and a summary of the mapping connections to make with the Machine Model.

The Three Phase Open Winding model is intended for use with either Machine Type of the IM SM machine model, if the Zero Sequence option is enabled. The Zero Sequence model allows for the simulation of an unbalanced system with an open winding. When it is included, all three machine stator currents should be mapped back to the circuit model, rather than two currents as is typically done without the zero sequence model. To adapt this circuit to the Round Rotor Synchronous Machine type of the IM SM, add a Field Voltage circuit as shown in the Two Level Inverter Field Voltage circuit model.

image-20240220-173249.png
Three Phase Open Winding.slx

 

Mapping Circuit Signals

  1. In the VeriStand System Definition, navigate to the Machine Model configuration page.

  2. Under Input Mapping Configuration, map the three phase voltage Measurements, Va_inv, Vb_inv, and Vc_inv, to the Stator Voltage A, Stator Voltage B, and Stator Voltage C inputs of the machine model.

image-20240220-175657.png

 

  1. Navigate to the Sources configuration page.

  2. Map the Stator Current Phase A, Stator Current Phase B, and Stator Current Phase C outputs of the machine model back to the current Sources, Ia_Machine, Ib_Machine, and Ic_Machine.

  3. Provide signals for both DC voltage sources in the model, Vdc and Vdc1. Selecting the CPU (VeriStand) option allows the DC voltages to be controlled from the User Interface. Alternately, signals could be provided through the Analog Input channels.

 

  1. Navigate to the Switches configuration page.

  2. Configure the switch mappings as required by the application. In a typical HIL application, the inverter IGBTs are controlled by an external signal physically connected to a Digital Input channel.

 

The Two-Level Inverter with Field Voltage model is intended for use with the IM SM machine model configured as a Round Rotor Synchronous Machine.

 

Mapping Circuit Signals

  1. In the VeriStand System Definition, navigate to the Machine Model configuration page.

  2. Under Input Mapping Configuration, map the three phase voltage Measurements, Va_inv, Vb_inv, and Vc_inv, to the Stator Voltage A, Stator Voltage B, and Stator Voltage C inputs of the machine model.

  3. Map the field voltage Measurement, Vf, to the Field Voltage input of the machine.

 

  1. Navigate to the Sources configuration page.

  2. Map the Stator Current Phase A and Stator Current Phase B outputs of the machine model back to the current Sources, Ia_Machine and Ib_Machine.

  3. Map a signal to the Vf_Machine source of the circuit model. Selecting the CPU (VeriStand) option allows the field voltage to be controlled from the User Interface. Alternately, a signal could be provided through an Analog Input channel.

  4. This model simulates a three-phase voltage source and diode rectifier feeding the inverter. The source voltages, Va_in, Vb_in, and Vc_in, can be controlled using the Sinewave Generators. Alternately, these components could be replaced with a single DC voltage source, as demonstrated in the Three Phase Open Winding circuit model.

 

  1. Navigate to the Switches configuration page.

  2. Configure the switch mappings as required by the application. In a typical HIL application, the inverter IGBTs are controlled by an external signal physically connected to a Digital Input channel. Diode components are not controllable and their mapping does not affect the simulation.

 

The Six-Phase, Two-Level Inverter model is intended for use with the 6-Phase PMSM BLDC model.

 

Mapping Circuit Signals

  1. In the VeriStand System Definition, navigate to the Machine Model configuration page.

  2. Under Input Mapping Configuration, map the six phase voltage Measurements, Va_inv, Vb_inv, Vc_inv, Vx_inv, Vy_inv, and Vz_inv, to the Voltage Phase A, Voltage Phase B, Voltage Phase C, Voltage Phase X, Voltage Phase Y, and Voltage Phase Z inputs of the machine model.

 

  1. Navigate to the Sources configuration page.

  2. Map the Current Phase A, Current Phase B, Current Phase X, and Current Phase Y outputs of the machine model back to the current Sources, Ia_Machine, Ib_Machine, Ix_Machine and Iy_Machine.

  3. This model simulates a three-phase voltage source and diode rectifier feeding the inverters. The source voltages, Va_in, Vb_in, and Vc_in, can be controlled using the Sinewave Generators. Alternately, these components could be replaced with a single DC voltage source, as demonstrated in the Three Phase Open Winding circuit model.

 

  1. Navigate to the Switches configuration page.

  2. Configure the switch mappings as required by the application. In a typical HIL application, the inverter IGBTs are controlled by an external signal physically connected to a Digital Input channel. Diode components are not controllable and their mapping does not affect the simulation.

 

The Three-Phase, Two-Level Inverter model is intended for use with most three-phase machine models, such as the PMSM BLDC, the PMSM SH, the IM SM model configured as a Squirrel-Cage Induction Machine, and the IM with Saturation.

 

Mapping Circuit Signals

  1. In the VeriStand System Definition, navigate to the Machine Model configuration page.

  2. Under Input Mapping Configuration, map the three phase voltage Measurements, Va_inv, Vb_inv, and Vc_inv, to the Voltage Phase A, Voltage Phase B, and Voltage Phase C inputs of the machine model.

  1. Navigate to the Sources configuration page.

  2. Map the Current Phase A and Current Phase B outputs of the machine model back to the current Sources, Ia_Machine and Ib_Machine.

  3. This model simulates a three-phase voltage source and diode rectifier feeding the inverter. The source voltages, Va_in, Vb_in, and Vc_in, can be controlled using the Sinewave Generators. Alternately, these components could be replaced with a single DC voltage source, as demonstrated in the Three Phase Open Winding circuit model.

  1. Navigate to the Switches configuration page.

  2. Configure the switch mappings as required by the application. In a typical HIL application, the inverter IGBTs are controlled by an external signal physically connected to a Digital Input channel. Diode components are not controllable and their mapping does not affect the simulation.

 

Related Links

How to Create a Circuit Model

How to Add a Circuit Model to the System Definition

How to Simulate a Drive with a Machine

How to Tune Switch Conductance (Gs)

 

OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323