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.
SCIM with Saturation Example Configuration
- Pierre-Luc Renault (Unlicensed)
- Myriam Desranleau
Expand each of the sections below to explore the parameters configured in the SCIM With Saturation example. The information on this page can also be used to validate project settings or to re-create the example in a new VeriStand project.
Example Directory | <Public Documents>\National Instruments\<NI VeriStand 20xx>\Examples\OPAL-RT\Power Electronics Add-On\SCIM With Saturation |
---|---|
Project Path | <SCIM With Saturation>\Project\SCIM With Saturation.nivsprj |
Opening the Example
To avoid modifying the original example, make a local copy of the Example Directory shown above.
Open VeriStand and Browse to the copied directory, then continue browsing to the Project Path and select the VeriStand Project (.nivsprj) file.
Click Configure... to open the System Definition file.
See the following sections on this page to explore the parameters configured in the Configuration Tree of the System Definition file.
Hardware Configuration
In the Configuration Tree, expand Controller >> Custom Devices and click the Power Electronics Add-On custom device to open its configuration page.
The eHSx64_Quad_IM_Saturation_IO_7868R hardware configuration is selected in the Configuration dropdown.
Circuit Model
The Circuit Model in this example serves as a simple three-phase voltage source for the machines. The Sources are controlled by the same set of three Sinewave Generators, while the phase voltage Measurements are mapped to the voltage inputs of both IM with Saturation machine models.
In the Configuration Tree, expand Power Electronics Add-On and click Circuit Model.
The Circuit Model File Path points to the currently loaded Circuit Model. Open the file in Simulink to observe the circuit.
(optional) Click Reload to trigger a model update in the System Definition.
(optional) Click the Refresh button to see additional model information.
Circuit Model File Path: <SCIM With Saturation>\Circuit Model\SCIM_eHS_Passthrough.slx
Sources
The Sources page maps signals to each source of the circuit model. In this example, the machine phase currents are fed back to the circuit. The six AC voltage sources are controlled using three Sinewave Generators.
In the Configuration Tree, expand Circuit Model and click Sources. This page is populated with a list of sources from the circuit model.
The mappings are configured as shown below.
Switches
The Switches page maps signals to each switch of the circuit model. In this example, a single dummy switch is used to meet the minimum requirements of the eHS solver. The switch mapping configuration does not affect the results of the simulation.
In the Configuration Tree, expand Circuit Model and click Switches. This page is populated with a list of switches from the circuit model.
The mappings are configured as shown below; any Group and Element can be mapped to the switch.
Electric Model
In this example, two IM with Saturation models are configured using identical electrical parameters, but different Magnetizing Inductance files. The first model simulates an induction machine with a typical saturation profile, while the second model simulates a standard induction machine with no saturation.
In the configuration tree, expand Circuit Model and click IM with Saturation 1 and IM with Saturation 2 to open the configuration pages for the machines.
A different Magnetizing Inductance File Path is configured for each of the two machines:
IM with Saturation 1 | <SCIM With Saturation>\Magnetizing Inductance\MagnetizingInductance_withSaturation.json |
---|---|
IM with Saturation 2 | <SCIM With Saturation>\Magnetizing Inductance\MagnetizingInductance_withoutSaturation.json |
The other Machine Configuration parameters and the Input Mapping Configuration parameters of both machines are configured identically, as summarized below.
Machine Configuration |
---|
Machine Configuration | |
---|---|
Machine Type | Squirrel-Cage Induction Machine |
Stator Resistance (Ohm) | 0.087 |
Stator Leakage Inductance (H) | 0.000801061 |
Rotor Resistance (Ohm) | 0.228 |
Rotor Leakage Inductance (H) | 0.000801061 |
Pole Pairs | 2 |
Magnetizing Inductance Cutoff Frequency (Hz) | 3000 |
Synchronous Reference Frame Orientation | Stator Flux |
Synchronous Reference Frame Offset (Deg) | 0 |
Stator Rotor Turn Ratio | 1 |
Rotor Temperature Coefficient | 0 |
Stator Temperature Coefficient | 0 |
Input Mapping Configuration | |
Stator Voltage Phase A (IM with Saturation 1) | Circuit Model 1.Va_l-n |
Stator Voltage Phase B (IM with Saturation 1) | Circuit Model 1.Vb_l-n |
Stator Voltage Phase C (IM with Saturation 1) | Circuit Model 1.Vc_l-n |
Stator Voltage Phase A (IM with Saturation 2) | Circuit Model 1.Vx_l-n |
Stator Voltage Phase B (IM with Saturation 2) | Circuit Model 1.Vy_l-n |
Stator Voltage Phase C (IM with Saturation 2) | Circuit Model 1.Vz_l-n |
Mechanical Model
In the configuration tree, expand IM with Saturation 1 and IM with Saturation 2, then click Mechanical Model to view their respective mechanical model parameters.
The Initial Values and Configuration parameters are configured as summarized below.
In the configuration tree, expand each Mechanical Model and click the Mechanical Model Mode channel.
The Default Value of each Mechanical Model Mode channel is set to 1 (Torque Controlled).
Initial Values |
---|
Initial Values | |
---|---|
Initial Rotor Angle (Deg) | 0 |
Mechanical Model Configuration |
---|
Mechanical Model Configuration | |
---|---|
Viscous Damping | 0.006 |
Static Friction | 0 |
Inertia | 1.662 |
Mechanical Model Mode (VeriStand Channel) | 1 |
Sinewave Generators
In this example, the FPGA-based Sinewave Generators drive the six AC voltage sources of the Circuit Model.
In the configuration tree, expand Circuit Model and click Sinewave Generators.
The default channel values for SWG 0, SWG 1, and SWG 2 are configured as summarized below.
Frequency Engines | ||
| Channel Name | Default Value |
---|---|---|
| Frequency Engine 0 | 60Hz |
SWG 0 | ||
| Channel Name | Default Value |
| Frequency Engine | 0 |
| Phase | 0º |
| Amplitude | 460V |
SWG 1 |
| |
| Channel Name | Default Value |
| Frequency Engine | 0 |
| Phase | -120º |
| Amplitude | 460V |
SWG 2 | ||
| Channel Name | Default Value |
| Frequency Engine | 0 |
| Phase | 120º |
| Amplitude | 460V |
OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323
Follow OPAL-RT: LinkedIn | Facebook | YouTube | X/Twitter