User’s Manual Powersim Inc. Chapter : -7 PSIM User’s Guide Version 2020a Release 1 May 2020 Copyright © 2001-2020 Powersim Inc. All rights reserved. No part of this manual may be photocopied or reproduced in any form or by any means without the written permission of Powersim Inc. Disclaimer Powersim Inc. (“Powersim”) makes no representation or warranty with respect to the adequacy or accuracy of this documentation or the software which it describes. In no event will Powersim or its direct or indirect suppliers be liable for any damages whatsoever including, but not limited to, direct, indirect, incidental, or consequential damages of any character including, without limitation, loss of business profits, data, business information, or any and all other commercial damages or losses, or for any damages in excess of the list price for the licence to the software and documentation. Powersim Inc. Email: [email protected] powersimtech.com -6 Chapter : Contents 1 General Information 1.1 Introduction 1 1.2 Circuit Structure 4 1.3 Software/Hardware Requirement 4 1.4 Installing the Program 4 1.5 Simulating a Circuit 5 1.6 Simulation Control 5 1.7 Component Parameter Specification and Format 9 2 Circuit Schematic Design 2.1 PSIM Environment 11 2.2 Creating a Circuit 14 2.3 File Menu 15 2.4 Edit Menu 16 2.5 View Menu 17 2.6 Design Suites Menu 18 2.7 Subcircuit Menu 19 2.7.1 Creating Subcircuit - In the Main Circuit 20 2.7.2 Creating Subcircuit - Inside the Subcircuit 20 2.7.3 Connecting Subcircuit - In the Main Circuit 21 2.7.4 Other Features of the Subcircuit 22 2.8 Elements Menu 24 2.9 Simulate Menu 24 2.10 Script Menu 27 2.11 Options Menu 28 2.11.1 Setting Option 28 2.11.2 Set Path Option 31 2.11.3 Customizing Toolbars and Keyboards 32 2.12 Utilities Menu 33 2.13 Managing the PSIM Library 34 2.13.1 Creating a Secondary Image 36 2.13.2 Adding a New Subcircuit Element into the Library 36 2.13.3 Adding a New DLL Element into the Library 38 2.14 Creating a Symbol Library 39 3 Waveform Processing in SIMVIEW 3.1 File Menu 42 3.2 Edit Menu 43 3.3 View Menu 43 3.4 Axis Menu 44 3.5 Screen Menu 46 3.6 Measure Menu 50 3.7 Analysis Menu 52 Chapter : -5i 3.8 Label Menu 52 3.9 Option Menu 53 3.10 Exporting Data 54 4 Power Circuit Components 4.1 Resistor-Inductor-Capacitor Branches 55 4.1.1 Resistor 55 4.1.2 Inductor 56 4.1.3 Capacitors 57 4.1.4 Combined R-L-C Branch 58 4.1.5 Rheostat 58 4.1.6 Saturable Inductor 58 4.1.7 Saturable Inductor (2) 59 4.1.8 3-Phase R-L-C and Combination Branches 60 4.1.9 3-Phase P/Q Controlled Load 61 4.1.10 Coupled Inductors 61 4.1.11 3-Phase AC Cable 63 4.1.12 Nonlinear Elements 64 4.2 Switching Devices 66 4.2.1 Diode and LED 66 4.2.2 MOSFET 68 4.2.3 IGBT 71 4.2.4 IGBT-RB 72 4.2.5 npn and pnp Transistors 73 4.2.6 Zener Diode and DIAC 76 4.2.7 Thyristor and TRIAC 77 4.2.8 GTO 78 4.2.9 Bi-Directional Switches 78 4.2.10 Gating Blocks 79 4.2.11 Pre-Built Switch Modules 80 4.3 Transformers 88 4.3.1 Ideal Transformer 88 4.3.2 Single-Phase Transformers 88 4.3.3 3-Phase Transformers 90 4.3.4 3-Phase Transformer with Saturation 92 4.4 Magnetic Elements 94 4.4.1 Winding 94 4.4.2 Leakage Flux Path 94 4.4.3 Air Gap 95 4.4.4 Linear Core 96 4.4.5 Saturable Core 96 4.5 Other Elements 98 4.5.1 Operational Amplifier 98 4.5.2 TL431 Shunt Regulator 100 4.5.3 Opto-Coupler 100 4.5.4 dv/dt Block 101 4.5.5 Relays 102 4.6 Motor Drive Module 103 4.6.1 Reference Direction of Mechanical Systems 103 4.6.2 Induction Machines 105 4.6.3 DC Machine 110 -4ii Chapter : 4.6.4 Brushless DC Machine 111 4.6.5 Synchronous Machine with External Excitation 116 4.6.6 Permanent Magnet Synchronous Machine (PMSM) 118 4.6.6.1 PMSM Linear 118 4.6.6.2 PMSM (High Frequency) 121 4.6.6.3 PMSM (Nonlinear) 122 4.6.6.4 PMSM (Spatial Harmonics) 124 4.6.6.5 6-Phase PMSM 125 4.6.7 Switched Reluctance Machine (SRM) 126 4.6.8 Motor Control Blocks 129 4.7 MagCoupler Module 134 4.7.1 MagCoupler-DL Block 134 4.7.2 MagCoupler Block 135 4.8 MagCoupler-RT Module 138 4.9 Mechanical Elements and Sensors 142 4.9.1 Mechanical Loads 142 142 4.9.2 Mechanical-Electrical Interface Block 144 4.9.3 Mechanical Coupling Block 146 4.9.4 Gear Box 146 4.9.5 Speed/Torque Sensors 146 4.9.6 Position Sensors 148 4.10 Thermal Module 151 4.10.1 Diode Thermal Model 151 4.10.2 MOSFET Thermal Model 155 4.10.3 IGBT Thermal Model 161 4.10.4 RB-IGBT Thermal Model 165 4.10.5 Inductor Thermal Model 168 4.10.6 Device Database Editor 170 4.10.7 Adding a Switching Device to Database 171 4.11 Renewable Energy Module 176 4.11.1 Solar Modules 176 4.11.2 Wind Turbine 182 4.11.3 Battery Models 184 4.11.4 Ultracapacitor Model 190 5 Control Circuit Components 5.1 Often-Used Control Function Blocks 191 5.1.1 PID Controllers 191 5.1.2 Summers 196 5.1.3 Comparators 196 5.1.4 Limiters 198 5.1.5 Filters 198 5.2 Filters 198 5.3 Computational Function Blocks 199 5.3.1 Multiplier and Divider 199 5.3.2 Trigonometric Functions 200 5.3.3 Exponential/Power/Logarithmic Functions 200 5.3.4 Square-Root 201 5.3.5 RMS (Root-Mean-Square) 201 5.3.6 Absolute and Sign Functions 201 5.3.7 Maximum/Minimum Function 201 Chapter : -3iii 5.3.8 MOD Function 202 5.4 Other Function Blocks 202 5.4.1 Sampling/Hold Block 202 5.4.2 Lookup Table ((Trapezoidal and Square) Blocks 203 5.4.3 Fast Fourier Transform 203 5.4.4 THD Block 205 5.4.5 S-Domain Transfer Function 206 5.4.6 Time Delay Blocks 207 5.4.7 Round-Off Block 207 5.4.8 dv/dt Limiter 208 5.4.9 Multiplexers 208 5.4.10 Space Vector PWM 209 5.4.11 Discontinuous PWM 210 5.4.12 Embedded Software Block 211 5.5 Logic Components 211 5.5.1 Logic Gates 211 5.5.2 Set-Reset Flip-Flop 211 5.5.3 J-K Flip-Flops 212 5.5.4 D Flip-Flops 212 5.5.5 Monostable Multivibrator 213 5.5.6 Time Delay (Logic) 213 5.5.7 Bit Shift 213 5.5.8 Pulse Width Counter 214 5.5.9 Up/Down Counter 214 5.5.10 A/D and D/A Converters 215 5.6 Digital Control Module 216 5.6.1 Motor Control Blocks 216 5.6.2 PLL Blocks 219 5.6.3 Zero-Order Hold 221 5.6.4 Unit Delay 222 5.6.5 z-Domain Transfer Function Block 222 5.6.6 Quantization Blocks 229 5.6.7 Circular Buffers 231 5.6.8 Convolution Block 231 5.6.9 Memory Read Block 232 5.6.10 Data Array 232 5.6.11 Stack 233 5.6.12 Multi-Rate Sampling System 233 5.7 SimCoupler Module 234 5.7.1 Set-up in PSIM and Simulink 234 5.7.2 Solver Type and Time Step Selection in Simulink 235 5.7.3 Passing Parameters from Simulink to PSIM 237 5.8 PIL Module 238 5.8.1 PIL Block 238 5.8.2 PIL Block (InstaSPIN F2806x) 239 5.8.3 InstaSPIN Set Block (F2806x) 239 5.9 Design Suite Blocks 240 5.9.1 Torque Control (PMSM) 240 5.9.2 Dynamic Torque Limit Control (PMSM) 241 5.9.3 Dynamic Torque Limit Control (Nonlinear PMSM) 242 5.9.4 Voltage Control (PMSM) 243 -2iv Chapter : 5.9.5 DC-DC Charging Control 244 5.9.6 DC-DC Discharging Control 245 5.9.7 DC-DC Regeneration Control 245 5.10 PLL Blocks 246 5.10.1 1-ph PLL 246 5.10.2 3-ph PLL 247 6 Other Components 6.1 Switch Controllers 249 6.1.1 On-Off Switch Controller 249 6.1.2 On-Off Switch Controller (Multi-Level) 249 6.1.3 Alpha Controller 250 6.1.4 PWM Lookup Table Controller 251 6.2 Sensors 256 6.3 Probes, Meters, and Scopes 6.3.1 Probes and Meters 257 6.3.2 Voltage/Current Scopes 259 6.4 Function Blocks 261 6.4.1 Control-Power Interface Block 261 6.4.2 Transformation Blocks 262 6.4.3 Lookup Tables 266 6.4.4 Math Function Blocks 270 6.4.5 DLL Blocks 270 6.4.6 C Block 272 6.4.7 Simplified C Block 274 6.5 IC Models 275 6.5.1 PWM IC 275 6.5.2 Driver IC 276 6.5.3 555 Timer 277 6.6 Initial Values 277 6.7 Parameter File 277 6.8 AC Analysis 280 6.8.1 AC Sweep Probes 282 6.8.2 AC Sweep 282 6.8.3 AC Sweep (1) 283 6.8.4 AC Sweep (2) 284 6.8.5 AC Sweep Multisine 284 6.9 Parameter Sweep 285 7 Sources 7.1 Constant 287 7.2 Time 287 7.3 Ground 287 7.4 Voltage and Current Sources 288 7.4.1 DC Source 288 7.4.2 Sinusoidal Source 288 7.4.3 Square-Wave Source 289 7.4.4 Triangular/Sawtooth Sources 290 7.4.5 Step Sources 291 Chapter : -1v 7.4.6 Piecewise Linear Source 292 7.4.7 Random Source 293 7.4.8 Math Function Source 293 7.4.9 Grounded Source Multiple 293 7.4.10 Voltage/Current-Controlled Sources 294 7.4.11 Nonlinear Voltage-Controlled Sources 295 8 Error/Warning Messages and Other Simulation Issues 8.1 Simulation Issues 296 8.1.1 Time Step Selection 296 8.1.2 Propagation Delays in Logic Circuits 296 8.1.3 Interface Between Power and Control Circuits 296 8.1.4 FFT Analysis 297 8.2 Debugging 297 8.3 Error/Warning Messages 298 vi0 Chapter : 1 General Information 1.1 Introduction PSIM1 is a simulation software specifically designed for power electronics, motor drives, and power conversion systems.