ModCoupler User Guide
ModCoupler User Guide
User’s Guide
Powersim Inc.
ModCoupler User’s Guide
Version 1.0
Release 1.0
May 2011
Copyright © 2011 Carlos III University of Madrid, GSEP Power Electronics Systems Group, and
Microelectronic Design and Applications group, Spain.
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 and the Carlos III University of Madrid.
Disclaimer
Powersim Inc. (“Powersim”) and the Carlos III University of Madrid make 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 and the Carlos III University of Madrid 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 license to the software and documentation.
Powersim Inc.
email: [email protected]
http://www.powersimtech.com
1 Introduction
ModCoupler is a communication link between the simulation software ModelSim® and
PSIM®. By means of ModCoupler, the co-simulation of the completed power electronics
equipment can be performed. The digital control algorithm, described in VHDL, will be
simulated in Modelsim and the power stage will be simulated in PSIM.
On PSIM® side, the user must include the ModCoupler block in his schematic. On ModelSim®
side there, no changes are needed. From PSIM´s schematic, the user will provide information to
ModCoupler module, time-step, VHDL clk signal frequency and input – output signals
information, required to configure the co-simulation. Fig. 1 shows the basic co-simulation
structure.
Mod
User’s power stage Communication link User’s digital control
(PSIM schematic) (PSIM module) circuit (VHDL)
3.1 Bit
When used as input signal, ModCoupler will set the corresponding ModelSim® signal to logic
‘0’ when reads a value of 0, otherwise the signal will be set to logic ‘1’.
When used as output signal, ModCoupler will set the corresponding PSIM® output node to 0
when reads a logic value of ‘0’, otherwise the node will be set to 1.
3.2 Std_logic
With the std_logic type only two states are taken into account, the logic ‘0’ and the logic ‘1’.
When used as input signal, ModCoupler will set the corresponding ModelSim® signal to logic
‘0’ when reads a value of 0, otherwise the signal will be set to logic ‘1’.
When used as output signal, ModCoupler will set the corresponding PSIM® output node to 0
when reads a logic value of ‘0’, otherwise the node will be set to 1.
3.3 Real
With this kind of signal, the PSIM® values are directly sent to ModelSim® and vice versa.
3.4 Integer
When used as input signal, ModCoupler will round the PSIM® input node value truncating the
decimal part and after that will set the corresponding ModelSim® signal to the rounded value.
5 Simulation
The last step is running the simulation. Set the configuration ModelSim Run All parameter to
“No” the first time the simulation is run, so ModelSim® opens without actually running the
simulation. In this state, the user can select the appropriate signals to display and save them to
the wave file (wave.do by defect).
Start the simulation pressing the PSIM® “Run simulation engine” button. After a few seconds, a
ModelSim® window will appear. Once the user has selected the signals to view, the simulation
is started by pressing the “Run –All” button in ModelSim®.
In next simulations, the ModelSim Run All parameter can be set to “Yes” to start ModelSim®
and run the simulation automatically.
If a new simulation with the same VHDL model is needed (for example, after editing a VHDL
file and recompiling or after a schematic change), press the ModelSim® “Restart” button before
pressing the PSIM® “Run simulation engine” button again (closing ModelSim® window is not
required).