Transcription of THE SIMULATION PLATFORM FOR POWER ELECTRONIC …
1 Electrical engineering softwarePlexim GmbH User manual Version SIMULATION PLATFORM FORPOWER ELECTRONIC SYSTEMSUser ManualVersion to Contact Plexim:+41 44 533 51 00 Phone%+41 44 533 51 01 FaxPlexim GmbHMail)Technoparkstrasse 18005 User manual 2002 2022 by Plexim GmbHThe software PLECS described in this manual is furnished under a licenseagreement. The software may be used or copied only under the terms of thelicense agreement. No part of this manual may be photocopied or reproducedin any form without prior written consent from Plexim is a registered trademark of Plexim GmbH. MATLAB, Simulink andSimulink Coder are registered trademarks of The MathWorks, Inc. Otherproduct or brand names are trademarks or registered trademarks of their re-spective You Begin1 Installing PLECS Standalone ..1 Installation on Microsoft Windows ..1 Installation on macOS ..1 Installation on Linux ..1 Licensing ..2 Installing PLECS Blockset.
2 3 Installation on Microsoft Windows ..3 Installation on macOS ..3 Installation on Linux ..4 Licensing ..4 Configuring the MATLAB Search Path ..5 Configuring PLECS ..5 Installing Different Versions of PLECS Blockset in Parallel ..6 Uninstalling PLECS Blockset ..6 License File Location ..7 Network Licensing ..7 What s New in Version ..9 Major New Features ..9 New and Enhanced Library Components ..10 Further Enhancements ..10 Contents1 Getting Started11 Getting Started with PLECS Standalone ..11A Simple Passive Network ..11 Buck Converter ..16 Getting Started with PLECS Blockset ..19A Simple Passive Network ..19 Buck Converter ..242 How PLECS Works27 Modeling Dynamic Systems ..27 system Equations ..28 Block Diagrams ..28 Physical Models ..29 Simulating Dynamic Systems ..29 Model Initialization ..30 Model Execution ..33 Fixed-Step SIMULATION ..35 Sampled Data Systems ..37 Sample Times.
3 38 Sample Time Inheritance ..39 Multirate Systems ..40 Troubleshooting ..40 Data Types ..42 Blocks with an Implicit Output Data Type ..42 Specifying an Output Data Type ..43 Data Type Inheritance ..43ivContents3 Using PLECS45 Using PLECS Standalone ..45 Creating a New Model ..45 Importing a Schematic From PLECS Blockset ..45 Using PLECS Blockset ..46 Creating a New Circuit ..46 Importing a Schematic From PLECS Standalone ..47 Opening a PLECS Standalone Model ..47 Customizing the Circuit Block ..47 Using the Library Browser ..49 Components ..50 Copying a Component into a Schematic ..50 Moving a Component ..50 Specifying Component Parameters ..50 Displaying Parameters in the Schematic ..52 Changing Parameters of Multiple Components ..52 Changing Parameters During a SIMULATION ..52 Changing Component Names ..52 Changing the Orientation of Components ..53 Getting Component Help ..53 Libraries.
4 54 Creating a New Library in PLECS Standalone ..54 Creating a New Library in PLECS Blockset ..54 Creating a Library Reference ..54 Updating a Library Reference ..55 Breaking a Library Reference ..55 Connections ..56 Signal Connections and Physical Connections ..56 Creating Connections ..56 Creating Branches ..56 Automatic Creation of Connections ..57vContentsEditing Connections ..58 Annotations ..58 Text Annotations ..58 Box Annotations ..58 Line Annotations ..59 Subsystems ..60 Creating a Subsystem by Adding the Subsystem Block ..60 Creating a Subsystem by Grouping Existing Blocks ..60 Arranging Subsystem Terminals ..61 Resizing a Subsystem Block ..61 Placing the Subsystem Label ..62 Masking Subsystems ..63 Mask Icon ..63 Mask Dialog ..69 Mask Workspace ..73 Mask Probe Signals ..74 Mask Documentation ..75 Unprotecting Masked Subsystems ..77 Getting Started with Lua ..77 Circuit Browser.
5 82 Viewing Options ..83 PLECS Probe ..85 Copying a Probe ..86 Assertions ..87 Assertion Blocks ..88 Component Assertions ..88 Locating Assertions ..89 Controlling Access to Circuits and Subsystems ..90 Encrypting Circuits and Subsystems ..90 Exporting Schematics ..91 Using the PLECS Scope ..92viContentsGetting Started ..92 Legend ..93 Zoom Operations ..93 Scrolling ..94Y-Axis Auto-Scaling ..95 Changing Curve Properties ..95 Spreading Signals ..95 Cursors ..96 Fourier Analysis ..97 Saving a View ..97 Adding Traces ..97 Saving and Loading Trace Data ..98 Scope Parameters ..98 Printing and Exporting ..98 Using the Fourier Analysis ..99 Calculation Parameters ..99 Display Parameters .. 100 Zoom, Export and Print .. 101 Calculation of the Fourier coefficients .. 101 Using the XY Plot .. 102 Time Range Window .. 102 Zoom, Save View, Export and Print .. 103 SIMULATION Parameters.
6 104 PLECS Standalone Parameters .. 104 PLECS Blockset Parameters .. 110 Configuring PLECS .. 116 General .. 116 Libraries .. 117 Thermal .. 117 Scope Colors .. 118 Update .. 118viiContentsCoder .. 119 Installing Extensions .. 1204 Thermal Modeling123 Heat Sink Concept .. 123 Implementation .. 124 Thermal Loss Dissipation .. 124 Semiconductor Losses .. 124 Ohmic Losses .. 128 Heat Sinks and Subsystems .. 128 Temperature Initialization .. 129 Thermal Description Parameter .. 131 Selecting Thermal Data Sheets .. 131 Using Reference Variables .. 131 Thermal Library .. 134 Library Structure .. 134 Global and Local Data Sheets .. 134 Creating New Data Sheets .. 135 Browsing the Thermal Library .. 135 Thermal Editor .. 136 Thermal Description for a Single Device .. 137 Editing Switching Losses .. 137 Editing Conduction Losses .. 138 Editing the Thermal Equivalent Circuit.
7 139 Adding Custom Variables .. 140 Adding Custom Lookup Tables .. 142 Editing Lookup Tables .. 142 Thermal Package Description .. 144 Importing Data from Graphical Datasheets .. 149 Semiconductor Loss Specification .. 154 Single Semiconductor Switch Losses .. 154viiiContentsDiode Losses .. 154 Losses of Semiconductor Switch with Diode .. 1555 Magnetic Modeling157 Equivalent circuits for magnetic components .. 157 Coupled inductors .. 158 Reluctance-resistance analogy .. 158 Permeance-capacitance analogy .. 160 Magnetic Circuit Domain in PLECS .. 161 Modeling Non-Linear Magnetic Material .. 162 Saturation Curves for Soft-Magnetic Material .. 1636 Mechanical Modeling165 Flanges and Connections .. 166 Force/Torque Flows and Sign Conventions .. 166 Positions and Angles .. 167 Initial Conditions .. 167 Angle Wrapping .. 168 Ideal Clutches .. 168 Inelastic Collisions.
8 1697 Analysis Tools173 Steady-State Analysis .. 173 Algorithm .. 173 Fast Jacobian Calculation for Thermal States .. 174 Non-periodic Case .. 175 Limitations .. 175 Reference .. 175AC Analysis .. 176 Impulse Response Analysis .. 176 Algorithm .. 176 Compensation for Discrete Pulse .. 177ixContentsReference .. 177 Multitone Analysis .. 178 Algorithm .. 178 Remarks .. 179 References .. 179 Usage in PLECS Standalone .. 180 Steady-State Analysis .. 180AC Sweep .. 182 Impulse Response Analysis .. 183 Multitone Analysis .. 183 Extraction of State-Space Matrices .. 184 Application Example .. 185 Usage in PLECS Blockset .. 188 Steady-State Analysis .. 188AC Sweep / Loop Gain Analysis .. 190 Impulse Response Analysis .. 193 Multitone / Loop Gain Analysis .. 195 Extraction of State-Space Matrices .. 196 Application Example .. 1978 C-Scripts207 How C-Scripts Work.
9 207C-Script Functions .. 208 Modeling Discontinuities .. 210 Sample Time .. 212 User Parameters .. 214 Runtime Checks .. 215C-Script Examples .. 216A Simple Function Times Two .. 216 Discrete States Sampled Delay .. 217 Continuous States Integrator .. 217xContentsEvent Handling Wrapping Integrator .. 218 Piecewise Smooth Functions Saturation .. 219 Multiple Sample Times Turn-on Delay .. 220C-Script Macros .. 223 Deprecated Macros .. 2279 State Machines229 Working with State Machines .. 230 Working with States .. 231 Working with Transitions .. 232 Working with Junctions .. 234 Working with Annotations .. 234 State Machine Configuration .. 235 State Machine Execution .. 239 Transition Evaluation .. 239 Trigger Types .. 240 Trigger Lifetime .. 241 Execution of Hierarchical State Machines .. 242 State Machine Examples .. 243 Oven Control .. 243 Constant On-Time Control.
10 24510 SIMULATION Scripts247 SIMULATION Scripts in PLECS Standalone .. 247 Overview of PLECS Scripting Extensions .. 248 Example Script .. 255 RPC Interface in PLECS Standalone .. 256 Usage Examples .. 256 Overview of RPC Commands .. 257 Example Script .. 261 Scripted SIMULATION and Analysis Options .. 261 Command Line Interface in PLECS Blockset .. 266xiContents11 Code Generation273 Code Generation for Physical Systems .. 273 Reducing the Code Size .. 274 Maximum Number of Switches .. 274 Handling Naturally Commutated Devices .. 274 Unsupported Components .. 277 Code Generation with PLECS Standalone .. 278 Generating Code .. 279 Task Transitions in Multi-Tasking Mode .. 283 Simulating a Subsystem in CodeGen Mode .. 284 Code Generation with PLECS Blockset .. 285 Standalone Code Generation .. 285 Integration with Simulink Coder .. 285 Simulink Coder Options .. 285 Code Generation Targets.
