SENTRIX - User Manual.pages
Contents
1. LES 5 11 SENTRIX User Manual en nn II II nn III 2 3 Block ports Tab 1 gives an overview of the available model ports of the SENTRIX Electrical Network Each port is a multi dimensional vector depending on the amount of components per type Any suitable source from the Simulink library can be connected to the input sources port The output meters port can be connected to any suitable sink from the Simulink library Tab 1 SENTRIX Electrical Network ports Port Description Remark V I input sources voltage before current sources in ascending order e g V1 V2 V3 11 12 S switches ascending order e g S1 S2 leave open when no switches are present in the electrical network A U output meters current before voltage meters in ascending order e g A1 A2 A3 U1 U2 2 ZX zero crossing detector connect to the input of a standard Simulink HitCross block this block is always required to be present with detection in either direction offset zero and output port shown T trigger input connect to the input of a standard Simulink HitCross block this block is always required to be present with detection in either direction offset zero and output port shown SENTRIX User Manual _ _ __ _ __ _ _ __ __ ___ _ _____ _ _ _______________________________ ___ 2 4 Netlist conventions The netlist describing the electrical network has to comply2. the Simulink solver The following example will demonstrate the usage 2 1 Buck converter example Fig 1 shows a Simulink model containing a SENTRIX electrical network representation of a synchronous buck converter and its corresponding netlist V1 Vi A1 VII rc c2 D2 Ui U1 S1 i U2 S1 nva S2 Fig 1 Simulink model containing a SENTRIX electrical network representation of a buck converter with corresponding netlist pa pas co NS T ec SENTRIX buck converter m c pa e Co CO CO iO CO Ch A UN uy yu MN HIP A Co C C C C D OO J oor C Un 2 HF Uu h SD S C Un HL CO O OG HL O O OC O OC Oo OOO SENTRIX User Manual O 2 2 Block masks The actual electrical network is masked for convenience Fig 2 shows the top level mask The Open file button will pop up a window for selection of the relevant netlist file The extension of the netlist file has to be stx Alternatively a string containing the file name including absolute or relative path can be edited directly in the upper edit box The lower edit box contains a vector with the initial condition settings for all capacitor voltages and inductor currents in the network The order of appearance is the following first all capacitor voltages and then all inductor currents in numer
3. with several format rules An example netlist is shown in Fig 4 Netlist format rules e the netlist is a standard text file in ASCII format the netlist file extension is stx e the first line is a compulsory header line containing arbitrary information e subsequent lines describe the electrical network one line per component e a line has the format component type positive node negative node component value Tab 2 gives an overview of the various components e oneach line the type nodes and value are separated by a space or a tab e the node numbers need to be positive integers e all components require values see Tab 2 e NaN and Inf are not allowed as component value e the components can be in arbitrary order e atleast one capacitor or inductor should be included in the netlist e atleast one source either current or voltage should be included in the netlist e atleast one meter either current or voltage should be included in the netlist Forward converter Vi 108 S1 1290 D1 0290 52 400 D2 4198 Ul 20090 L1 2 3 100e 6 Al 348 R1 2 4 1e6 Fl 420 5 61 45 0 5 D3 568 D4 468 U2 648 A2 6790 L2 7 8 1e 3 Ci 8 4 10e 6 R2 8 4 10 11 848 U3 848 Fig 4 Example SENTRIX netlist SENTRIX User Manual Comp Description type A current meter 8 ideal capacitor D ideal diode F ideal transtormer primary G ideal transformer secondary current source S ideal switch L ideal ind
4. N POWERTEC SPECIFICALLY DISCLAIMS ANY WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE THE DOCUMENTATION SOFTWARE OR HARDWARE IS PROVIDED AS IS ZEON POWERTEC HAS NO OBLIGATION TO PROVIDE MAINTENANCE SUPPORT UPDATES ENHANCEMENTS OR MODIFICATIONS
5. QUENTIAL DAMAGES INCLUDING LOST PROFITS ARISING OUT OF THE USE OF THIS DOCUMENTATION SOFTWARE OR HARDWARE EVEN IF ZEON POWERTEC HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE ZEON POWERTEC SPECIFICALLY DISCLAIMS ANY WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE THE DOCUMENTATION SOFTWARE OR HARDWARE IS PROVIDED AS IS ZEON POWERTEC HAS NO OBLIGATION TO PROVIDE MAINTENANCE SUPPORT UPDATES ENHANCEMENTS OR SENTRIX User Manual nn In II II II 1 Introduction to SENTRIX In Simulink control and other algorithm development for power converters requires some kind of representation model for the converter A first approach is to define a behavioural model that more or less mimics the actual electrical behaviour of the converter Such a behavioural model generally allows fast simulation However the development process can be tedious and the model although fast is limited in accuracy In another approach an electrical network of the power converter is translated into an abstract mathematical model All electrical components including parasites can be taken into account These models are rather difficult to create for each individual power converter In general the electrical network models are far more accurate than the behavioural models but slow down the simulation speed tremendously Modelling becomes even more cumbersome when the electrical networ
6. SENTRIX User Manual File Edit View Display Diagram Simulation Analysis Code Tools Help 1e 4 flyback_advanced Pajflypack advanced Simulation Help a M D a a 4 AE S1 Scope 2 eoe flyback advanced stx Ready dE File Path v Desktop SENTRIX Release_3v0 Debug Full Flyback flyback_advanced stx BB flyback_advanced stx 4 no symbol selected q AE ES 1 Flyback converter with parasites and peak clamp 2 Al 1 2 0 3 A24 5 0 4 AS3 12 13 0 5 17 10e 9 6 C2 9 8 10 e 12 7 C3 14 4 10e 6 8 Di 6 7 0 8 D 0 4 4 10 D3 11 12 0 11 Fl 3 4 2 12 G1 4 10 2 13 11 13 4 0 14 11 2 3 1e 6 15 12 3 4 10e 6 16 Rl 7 1 10e3 17 R2 5 6 1e 3 18 R3 8 10 e 3 19 R4 4 9 100 20 R5 10 11 1e 3 Offset 0 T 0 0001 21 R6 13 14 10e 3 r 22 R7 13 4 10 23 si 4 8 0 24 Ul 7 0 e 25 u 4 0 0 26 U3 13 4 0 27 v1 1 Line 1 Col 47 Setext 4 Unicode UTF 8 amp Unix LF s w 389 119 27 a gt gt gt MM Loo User Manual v3 02 9 October 2015 SENTRIX User Manual Content MM odU OG ENTRIA sli aio 1 IUE A Oo UE UU non A 2 ME o o A A 2 Los ICONS MOT ALO erecta esp A 2 A eo o MINE 3 e Go A 3 2 2 A oca 4 A ONS a A E 6 20 INES CONV SAO Sr 7 A A e A Pi Um 9 Dale ENO EGOE O eli Ie 9 ze TAS PENN e y www zeonpowertec com ZEON SENTRIX User Manual Copyright 2014 2015 ZeoN PowerTec IN NO EVENT SHALL ZEON POWERTEC BE LIABLE TO ANY PARTY FOR DIRECT INDIRECT SPECIAL INCIDENTAL OR CONSE
7. adjustable transfer ratio can be applied e meters support the measurement of any current or voltage inside the electrical network e a simple ASCII netlist representation allows editing with any preferred commercially available editor e multiple electrical networks can be instantiated in a single Simulink model 1 2 Installation Extract the sentrix zip file into a directory folder of preference Add the new directory folder to the MATLAB path or execute the simulation directly from the chosen directory folder 1 3 License information A demo and a full version are available The demo version is restricted in the number of nodes 5 and components 7 in the electrical network Current sources cannot be applied in this version The demo version is valid for a period of at maximum 190 days The full version has no restrictions and has a validity of one year Entering sentrix at the MATLAB command prompt reports the current status of the license For MATLAB R2011a version 7 12 and later versions Linux is not formally supported The sentrix p file must be visible for Simulink by being in the work directory folder or search path Zee 2 11 SENTRIX User Manual A 2 Using the model A Simulink model can contain multiple instantiations of various SENTRIX electrical networks All these networks call the sentrix p level 2 MATLAB S function The respective netlists per block are imported in the simulator and used by
8. checks exist next to the common Simulink error checks and can be traced back in the Simulink Diagnostic Viewer 3 1 Error categories The various error messages are categorised into license netlist simulation and demo version related The demo version errors do not apply to the full version License information when a license error occurs can be retrieved by entering sentrix at the command prompt The actual license information will be displayed Netlist errors prevent the simulation from starting execution whereas simulation related errors can occur during the simulation 3 2 State dependence SENTRIX applies ideal components for switches and diodes Depending on the netlist and network configuration this can result in a dependence between capacitor voltages or inductor currents and sources or between sources directly Examples are e shorted capacitors e shorted voltage sources e open inductors e open current sources e capacitors in parallel to voltage sources e inductors in series with current sources e parallel voltage sources e series current sources These cases are illegal since in the ideal case they would result in infinite currents or voltages The SENTRIX algorithm however will immediately try to change to a more appropriate topology by turning on off diodes present in the network and ensure that the Simulink solver can continue the simulation without issuing an error In a practical non ideal case these state depend
9. ences would never actually occur since there is always parasitic impedance involved that limits the currents and voltages So as a solution when SENTRIX issues error E201 see Tab 3 the netlist can be changed by adding resistance s to the network such that the state dependence is removed Zee 9 11 SENTRIX User Manual A Tab 3 Error messages Code Description Cause License related E000 No valid SENTRIX license for this A license is coupled to MAC addresses computer The MAC address of the current computer is not in the license list E001 License expired visit The license has expired and has to be www zeonpowertec com for license renewed renewal Netlist related E100 Netlist file does not exist Either the path absolute or relative or file name doesn t exist E101 Netlist file requires stx extension The file doesn t have the required stx extension E102 Unidentified component in netlist A component other than defined in Tab 2 has been used E103 At least one capacitor or inductor Neither a single capacitor or inductor has to be present in the network has been used in the network E104 At least one source has to be No source has been used in the present in the network network E105 At least one meter has to be No meter has been used in the network present in the network E106 Double component entries in The same component is used multiple netlist times E107 Component values should notbe Only numerical component va
10. ical ascending order e g VC1 VC2 VC3 IL1 IL2 SENTRIX buck converter i y Function Block Parameters SENTRIX buck co Subsystem mask Parameters Open file ouck advanced stx Set initial conditions VC IL 10 0 Ha HEN NEN Fig 2 Mask of the SENTRIX block Underneath this top level mask the actual SENTRIX Electrical Network resides This next level including mask is shown in Fig 3 The top level mask entries for the netlist and initial conditions are automatically copied into the lower level mask As mentioned the top level mask is for convenience only and might be deleted such that the lower level SENTRIX Electrical Network mask becomes available at top level SENTRIX User Manual III V I Electrical Network V I A U S SENTRIX T ZX Function Block Parameters Electrical Network SENTRIX electrical network simulator mask Parameters Netlist et o Initial conditions VC IL InitCond Fig 3 SENTRIX Electric Network including mask The SENTRIX Electrical Network calls the actual level 2 MATLAB S function sentrix p during execution using the desired netlist Netlist and initial conditions InitCond A HitCross block must be connected between output ZX and input T In this HitCross block detection should be in either direction offset equals zero and the output port must be shown HitCross is a standard part of the Simulink library
11. k contains diodes The state of a diode conducting or non conducting and the precise moment of switching is not predictable a priori since the state depends on the internal network instantaneous currents and voltages Furthermore electrical engineers prefer an electrical network representation instead of a behavioural block diagram or abstract mathematical equations SENTRIX is a level 2 MATLAB S function that overcomes these hurdles The applied algorithm interprets a text file containing an electrical netlist representing the power converter to be simulated The represented power converter gets integrated into the Simulink model seamlessly Accurate switching of diodes is handled efficiently without undesired loss of simulation speed SENTRIX is available at www zeonpowertec com 1 11 SENTRIX User Manual MER UN 1 1 Features e seamless integration into Simulink and flawless operation in conjunction with the many available library components and toolboxes e MAC OS and Windows operating systems are supported e ease of installation with small software footprint e basic electrical components ideal inductors ideal capacitors and resistors are included and support initial condition setting where relevant e ideal switches and diodes incorporate very fast transient calculation e ideal transformers with
12. lues are Inf or NaN allowed E108 Only positive integers allowed for A negative or non integer node node numbering reference is made in the netlist E109 Wrong transformer dimensioning Corresponding transformer transfer ratios do not match E110 Node error in netlist A node number has been skipped from the netlist 10 11 SENTRIX User Manual A Code Description Cause Simulation related E200 Wrong number of initial conditions The number of initial conditions set set does not match the actual number of capacitors and inductors in the netlist E201 State dependence See section 3 2 E202 No solution found During simulation the solver encounters an unsolvable network configuration E203 Conflicting initial conditions The initial conditions are chosen such that the solver finds no suitable network configuration Demo version related E300 Maximum number of demo version Too many nodes or components are nodes 5 or components 7 used reached E301 No current source allowed in the Current sources are not to be used demo version ZEON 11 11 SENTRIX User Manual WWW Zeonpowertec com Copyright 2014 2015 ZeoN PowerTec IN NO EVENT SHALL ZEON POWERTEC BE LIABLE TO ANY PARTY FOR DIRECT INDIRECT SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES INCLUDING LOST PROFITS ARISING OUT OF THE USE OF THIS DOCUMENTATION SOFTWARE OR HARDWARE EVEN IF ZEON POWERTEC HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE ZEO
13. uctor U voltage meter V voltage source Positive node current in positive terminal anode positive terminal positive terminal current in current in current in positive terminal positive terminal Negative node current out negative terminal cathode negative terminal negative terminal current out current out current out negative termal negative termal Comp value capacitor value 0 transfer ratio primary secondary turns transfer ratio primary secondary turns 0 inductor value Tab 2 Netlist components Remark initial condition set via mask a Fx value Norim Nsec has to be equal to the corresponding G value so F1 G1 F2 G2 value a Gx value Norim Nsec has to be equal to the corresponding F value so G1 F1 G2 F2 value actual value set in Simulink top level model via the first input port control of the switch is via boolean logic 0 open 1 short and set in the Simulink top level model via the second input port initial condition set via mask actual value set in Simulink top level model via the first input port SENTRIX User Manual R 3 Error messages SENTRIX incorporates a limited amount of error checking Tab 3 gives an overview of the error messages and the probable causes These error
Download Pdf Manuals
Related Search