Three Phase Permanent Magnet Synchronous Machine (Ansys ECE)

Description of the Three Phase Permanent Magnet Synchronous Machine (Ansys ECE) component in Schematic Editor.

Component Not Supported: This component is not currently supported in TyphoonSim. Adding this component to your model will prevent you from being able to run your model in TyphoonSim. Please disable or remove this component from your model before attempting to run your model in TyphoonSim mode.

Figure 1. Three Phase Permanent Magnet Synchronous Machine (Ansys ECE) component in Typhoon HIL Schematic Editor

A, B, and C are stator winding terminals. The stator winding uses the current source interface.

Equivalent-circuit extraction (ECE)

ANSYS Maxwell is a software used for simulating static, frequency-domain and time-varying magnetic and electric fields in a wide range of electric devices.

The equivalent-circuit extraction (ECE) method generates a system-level model from a finite element method (FEM) model of a radial-flux three-phase or six-phase synchronous machine (only three-phase model is supported in TyphoonHIL software). FEM method simulation of a machine is usually time consuming and might not be useful for an analysis of a wider system. The ECE method creates an equivalent circuit of a nonlinear synchronous machine and allows the simulation of the whole drive system.

Electrical parameters of the machine are exported in a .txt file. A valid data file contains all of the necessary information required for the simulation of the nonlinear synchronous machine.

ECE data file contains:

Number of poles of the machine
Stator resistance and end-winding leakage inductance
Current sweeps which might be given in the rotor dq frame, stationary alpha-beta frame or in polar dq frame as amplitude-angle sweeps
Rotation angle sweeps given in electrical degrees
Ouput fluxes which can be given in rotating dq frame, stationary abc frame or as absoulte inductance and permanent magnet flux in the rotating dq frame
Output electrical torque
Optional cogging torque data

All of the data is read from the ece data file.

Ports

A (electrical)
- Stator winding phase A port
B (electrical)
- Stator winding phase B port
C (electrical)
- Stator winding phase C port
in
- Available if Model Load source is selected
out
- Available if one of the outputs is selected

Electrical (Tab)

ECE data file path
- Path to the ece data file path
- File extension needs to be .txt

Mechanical (Tab)

Jm
- Combined rotor and load moment of inertia [kgm2]
Friction coefficient
- Machine viscous friction coefficient [Nms]
Star/delta
- Stator winding connection (star or delta)
- Stator winding connection option is not supported in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
Unconstrained mechanical angle
- Limiting mechanical angle between 0 and 2π

Load (Tab)

Load source
- Load source can be set from SCADA/external or from model (in model case, one signal processing input will appear).
- In TyphoonSim, if SCADA/external is chosen as Load source, analog signals are read from the internal virtual IO bus. Hence, if some signal is sent to analog ouput 1, it will appear on analog input 1.
External/Model load type
- Load type: torque or speed
Load ai pin
- Load ai pin for external torque/speed command.
- In real-time/VHIL simulation, Load ai pin represent HIL analog input address for external torque command.
- In TyphoonSim, analog signals are read from the internal virtual IO bus. Hence, if some signal is sent to analog ouput 1, it will appear on analog input 1.
- Available only if SCADA/external is set as Load source.
Load ai offset
- Assigned offset value to the input signal representing external torque command.
- Available only if SCADA/external is set as Load source.
Load ai gain
- Assigned gain value to the input signal representing external torque command.
- Available only if SCADA/external is set as Load source.

External load enables you to use an analog input signal from a HIL/TyphoonSim (internal virtual IO bus in TyphoonSim) analog channel with the load_ai_pin address as an external torque/speed load, and to assign offset (V) and gain (Nm/V) to the input signal, according to the formula:

$T_{l} = l o a d_a i_g a i n \cdot (A I (l o a d_a i_p i n) + l o a d_a i_o f f s e t)$

Note: An analog input pin may be overwritten if another component uses the same analog input pin. If another property (from the same or a different component) uses the same analog input pin, the input signal value will be applied to only one of those properties. For instance, if both the load and the resolver carrier signal use the same analog input pin, the signal value will only be applied only to one of these.

Feedback (Tab)

Encoder ppr
- Incremental encoder number of pulses per revolution
Encoder Z pulse length
- Z digital signal pulse length in periods. Can be Quarter length or Full period (default)
Resolver pole pairs
- Resolver number of pole pairs
Resolver carrier source
- Resolver carrier signal source selection (internal or external)
Resolver carrier frequency
- Resolver carrier signal frequency (internal carrier) [Hz]
- Available only if the Resolver carrier source property is set to internal
External resolver carrier source type
- External resolver carrier signal source type selection (single ended or differential)
- Available only if the Resolver carrier source property is set to external
Resolver ai pin 1
- Resolver carrier input channel 1 address (external carrier)
- Available only if the Resolver carrier source property is set to external
- In TyphoonSim, analog signals are read from the internal virtual IO bus. Hence, if some signal is sent to analog ouput 1, it will appear on analog input 1.
Resolver ai pin 2
- Resolver carrier input channel 2 address (external carrier)
- Available only if the Resolver carrier source property is set to externaland External resolver carrier source type property is set to differential
- In TyphoonSim, analog signals are read from the internal virtual IO bus. Hence, if some signal is sent to analog ouput 1, it will appear on analog input 1.
Resolver ai offset
- Resolver carrier input channel offset (external carrier)
- Available only if the Resolver carrier source property is set to external
- In TyphoonSim, analog signals are read from the internal virtual IO bus. Hence, if some signal is sent to analog ouput 1, it will appear on analog input 1.
Resolver ai gain
- Resolver carrier input channel gain (external carrier)
- Available only if the Resolver carrier source property is set to external
- In TyphoonSim, analog signals are read from the internal virtual IO bus. Hence, if some signal is sent to analog ouput 1, it will appear on analog input 1.
Absolute encoder protocol
- Standardized protocol providing the absolute machine encoder position.
- Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
Singleturn bits
- Number of machine absolute encoder singleturn bits.
- Available only if Absolute encoder protocol is not None.
- Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
Enable multiturn
- Enables multiturn absolute encoder support.
- Available only if Absolute encoder protocol is not None.
- Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
Multiturn bits
- Number of machine absolute encoder multiturn bits.
- Available only if Enable multiturn is checked.
- Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
EnDat/SSI/BiSS clock DI pin
- Clock digital input pin for the chosen absolute encoder protocol type.
- Available only if Absolute encoder protocol is not None.
- Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
Clock DI logic
- Clock DI pin logic: active high/active low.
- Available only if Absolute encoder protocol is not None.
- Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
EnDat data DI pin
- EnDat data digital input pin.
- Available only if Absolute encoder protocol is EnDat.
- Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
Data DI logic
- EnDat data DI pin logic: active high/active low.
- Available only if Absolute encoder protocol is EnDat.
- Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.

If an external resolver carrier source is selected, the source signal type can be set as either single ended or differential. The single ended external resolver carrier source type enables use of an analog input signal from the HIL/TyphoonSim (internal virtual IO bus in TyphoonSim) analog channel with the res_ai_pin_1 address as the external carrier source. Additionally, offset (V) and gain (V/V) values can be assigned to the input signal, according to the formula:

r e s_c a r r_s r c = r e s_a i_g a i n \cdot (A I (r e s_a i_p i n_1) + r e s_a i_o f f s e t)

The differential external resolver carrier source type enables use of two analog input signals from the HIL/TyphoonSim (internal virtual IO bus in TyphoonSim) analog channels with the res_ai_pin_1 and the res_ai_pin_2 addresses. Analog signals from these HIL/TyphoonSim (internal virtual IO bus in TyphoonSim) analog inputs are subtracted, and the resulting signal is used as the external differential carrier source. Additionally, offset (V) and gain (V/V) values can be assigned to the input signal (similarly to the single ended case), according to the formula:

r e s_c a r r_s r c = r e s_a i_g a i n \cdot ((A I (r e s_a i_p i n_1) - A I (r e s_a i_p i n_2)) + r e s_a i_o f f s e t)

Note: In real-time/VHIL simulation, differential external resolver signal support is available from the 2023.1 software version. Only the single ended external resolver option was available in previous software versions.

Note: In order to get a resolver signal with an amplitude of 1 when using an external carrier signal, the offset and the gain should be chosen in such a way that the resolver carrier signal has an amplitude of 1 after the adjustment. As shown in Figure 2, the sinusoidal signal used to generate external resolver carrier source is fed to HIL/TyphoonSim (internal virtual IO bus in TyphoonSim) analog input 1. The analog input signal is scaled in order to get the resolver signals with an amplitude of 1.

Note: An analog input pin may be overwritten if another component uses the same analog input pin. If another property (from the same or a different component) uses the same analog input pin, the input signal value will be applied to only one of those properties. E.g. if both the load and the resolver carrier signal use the same analog input pin, the signal value will be applied only to one of these.

The following expression must hold in order to properly generate the encoder signals:

4 \cdot e n c_p p r \cdot f_{m} {\cdot T}_{s} \leq 1

Table 1. Variables in the encoder limitation expression
symbol	description
enc_ppr	Encoder number of pulses per revolution
f_m	Rotor mechanical frequency [Hz]
T_s	Simulation time step [s]

Figure 3. Machine encoder signals when *Full period* option is selected

Figure 4. Machine encoder signals when *Quarter period* option is selected

Note: While the machine speed is positive, the encoder channel B signal leads the encoder channel A signal.

Note: Absolute encoder protocol is not supported on HIL402 (configurations: 1, 2, 3, and 4).

Note: More information about absolute encoder protocol could be found here.

Snubber (Tab)

Rsnb stator
- Stator snubber resistance value [Ω]

All machines with current source based circuit interfaces have the Snubber tab in the properties window where the value of snubber resistance can be set. Snubbers are necessary in the cases when an inverter or a contactor is directly connected to the machine terminals. This value can be set to infinite (inf), but it is not recommended when a machine is directly connected to the inverter since there will be a current source directly connected to an open switch. In this case, one of each switch pairs S1 and S2, S3 and S4, and S5 and S6 will be forced closed by the circuit solver in order to avoid the topological conflicts. On the other hand, with finite snubber values, there's always a path for the currents Ia and Ib, so all inverter switches can be open in this case. Circuit representations of this circuit without and with snubber resistors are shown in Figure 5 and Figure 6 respectively. Snubbers are connected across the current sources.

Figure 5. Circuit representation of machine and inverter when all the switches are open without resistors (not recommended)

Figure 6. Circuit representation of machine and inverter when all the switches are open with resistors (recommended)

Note: Snubbers exist only in the machine components that have the current source based circuit interface.

Note: Snubbers are dynamic, which means that the snubber is dynamically added to circuit modes where topological conflicts are detected.

Output (Tab)

Execution rate
- Signal processing output execution rate [s]
Electrical torque
- Machine electrical torque [Nm]
Mechanical speed
- Machine mechanical angular speed [rad/s]
Mechanical angle
- Machine mechanical angle [rad]
Stator alpha axis current
- Alpha axis component of the stator current [A]
Stator beta axis current
- Beta axis component of the stator current [A]
Stator d-axis current
- Direct axis component of the stator current [A]
Stator q-axis current
- Quadrature axis component of the stator current [A]
Stator alpha axis flux
- Alpha axis component of the stator flux [Wb]
Stator beta axis flux
- Beta axis component of the stator flux [Wb]
Stator d-axis flux
- Direct axis component of the stator flux [Wb]
Stator q-axis flux
- Quadrature axis component of the stator flux [Wb]

Extras (Tab)

The Extras tab gives you the opportunity to set Signal Access Management for the component.

Signal visibility is calculated based on the 'signal_access' property and whether or not a parent component in its hierarchy is locked or not. Components that are not contained within locked components expose their signals regardless of the 'signal_access' property. The 'signal_access' property can have one of three values:

Public - Components marked as public expose their signals on all levels.
Protected - Components marked as protected will hide their signals to components outside of their first locked parent component.
Inherit - Components marked as inherit will take the nearest parent 'signal_access' property value that is set to a value other than inherit.