SPDT Relay

Single-pole, double-throw relay with delays and faults

• 

Libraries:
Simscape / Electrical / Switches & Breakers / Relays

Description

The SPDT Relay block models a single-pole, double-throw relay. The block has three potential states:

• De-energized — The common contact, C, is connected to the normally closed contact, S1.

• Energized — The common contact, C, is connected to the normally open contact, S2.

• Open Circuit — The relay is open. The common contact, C, is not connected to the normally closed contact, S1, or the normally open contact, S2.

You can:

• Control the relay state using the physical signal input port or electrical conserving ports.

• Output the relay state.

• Delay the breaking and making of either or both of the connections.

• Introduce a behavioral or temporal fault that results in a stuck connection, an open circuit, or degraded contact resistance.

Relay State Control

The block has two control variants:

• Physical signal (PS) control — The state of the relay depends on how the value of the input physical signal compares to the relay threshold. The relay threshold, th, is the value that you by specify for the Threshold parameter.

• Electrical control — The state of the relay depends on how the current through the positive and negative electrical conserving ports, which represent the relay winding, compares to the relay upper and lower thresholds. The upper and lower thresholds depend on the values that you specify for the parameters in the Winding settings.

For the PS control variant, at the start of simulation:

• If the input signal, PS, is less than or equal to th, the relay is de-energized and the common contact, C, connects to the normally closed contact, S1.

• If the input signal, PS, greater than th, the relay is energized and C connects to the normally open contact, S2.

After the simulation starts, if PS rises above th, the block goes from a de-energized state to an energized state :

• The C–S1 connection breaks after the delay specified in Time-to-break C-S1 connection.

• The C–S2 connection closes after the delay specified in Time-to-make C-S2 connection.

If the block goes from an energized state to a de-energized state, that is PS falls to or below th:

• The C–S2 connection breaks after the delay specified in Time-to-break C-S2 connection.

• The C–S1 connection closes after the delay specified in Time-to-make C-S1 connection.

For the electrical control variant, the upper and lower thresholds depend on the specified values for the Rated voltage, Percent rated voltage to energize, Percent rated voltage to de-energize, and Winding series resistance parameters. The rated current is:

$$i_{rated}=\frac{V_{rated}}{r_{coil}}.$$

The equation for the upper current threshold, i_energized, is:

$$i_{energized\_current}=\frac{RatedVoltage*Percentratedvoltagetoenergize}{Windingseriesresistance}.$$

The equation for the lower current threshold, i_de-energized, is:

$$i_{de-energized\_current}=\frac{RatedVoltage*Percentratedvoltagetode-energize}{Windingseriesresistance}.$$

At the start of simulation:

• If the control current is less than i_energized, the common contact, C, connects to the normally closed contact, S1.

• If the control current is greater than i_energized, the relay is energized and C connects to the normally open contact, S2.

After the start of simulation, if the current rises above i_energized, the block goes from a de-energized state to an energized state:

• The C–S1 connection breaks after the delay specified in Time-to-break C-S1 connection.

• The C–S2 connection closes after the delay specified in Time-to-make C-S2 connection.

If the current falls below i_de-energized, the block goes from an energized state to a de-energized state:

• The C–S2 connection breaks after the delay specified in Time-to-break C-S2 connection.

• The C–S1 connection closes after the delay specified in Time-to-make C-S1 connection.

Output the Relay State

To view the relay state, expose port x, a physical signal port that outputs the state of each connection. To expose the x port, in the Main settings, set State port to Visible.

The table shows how the state of the relay relates to the state of the connections. A closed connection has a state of 1. An open connection has a state of 0.

Relay and Connection States

C–S1 Connection State	C–S2 Connection State	Relay State
1	0	De-energized
0	1	Energized
0	0	Open Circuit

Connection Delays

You can specify delays for making and breaking connections in the Mechanical settings. The table shows how the make and brake time delays affect the connections between contacts S1 and S2 and the common contact, C.

Mechanical Settings	Relay State	C–S1 Connection State	C–S2 Connection State	Results, with C–S1 in Yellow and C–S2 in Blue
Parameter Value Time-to-break C-S1 connection 0 Time-to-make C-S1 connection 0 Time-to-break C-S2 connection 0 Time-to-make C-S2 connection 0	De-energized	1	0
	Energized	0	1
Parameter Value Time-to-break C-S1 connection > 0 Time-to-make C-S1 connection 0 Time-to-break C-S2 connection 0 Time-to-make C-S2 connection 0	De-energized	1	0
	Energized	1, 0	1
Parameter Value Time-to-break C-S1 connection 0 Time-to-make C-S1 connection > 0 Time-to-break C-S2 connection 0 Time-to-make C-S2 connection 0	De-nergized	0, 1	0
	Energized	0	1
Parameter Value Time-to-break C-S1 connection 0 Time-to-make C-S1 connection 0 Time-to-break C-S2 connection > 0 Time-to-make C-S2 connection 0	De-nergized	1	1, 0
	Energized	0	1
Parameter Value Time-to-break C-S1 connection 0 Time-to-make C-S1 connection 0 Time-to-break C-S2 connection 0 Time-to-make C-S2 connection > 0	De-nergized	1	0
	Energized	0	0, 1

Faults

The block provides five fault types:

• C-S1 stuck closed

• C-S2 stuck closed

• C open circuit (no path to S1 or S2)

• Degraded contact resistance

• Winding failed open circuit. This fault type is available only for the electrical control variant.

Each type of fault can take effect only when the threshold for a temporal or behavioral trigger is exceeded.

If you want to trigger a fault at a specific time, in the Fault Inspector window, set Trigger type to Timed. If you want to determine whether a system fails and, if so, when it fails, in the Fault Inspector window, set Trigger type to Behavioral.

If you select the behavioral trigger, the component fails as soon as one of the trigger conditions is true.

C–S1 Stuck Closed Fault

The C–S1 stuck closed fault occurs if the common contact, C, becomes mechanically, electrically, or chemically stuck to the normally closed contact, S1. Causes of this type of fault include:

1. Contact welding, possibly due to an inrush current or breaking current that exceeds the rating or load short circuit.

2. Mechanical damage.

3. Insulation deterioration.

4. Inductive voltage.

The table shows the faulted state for a C–S1 stuck closed fault.

Connection	State
C–S1	1
C–S2	0

A C–S1 stuck closed temporal fault can occur only if the simulation time exceeds the time threshold such that

$$t>t_{th\_t},$$

where:

• t is the simulation time.

• t_{th_t} is the specified value for the Simulation time after which contactors can stick parameter.

A C–S1 stuck closed behavioral fault can occur only if the load current exceeds the current threshold for a period of time that exceeds the behavioral trigger time threshold. That is, the behavioral fault can occur only if:

$$i_{load}>i_{th},$$

and

$$t_{i>i\text{\_}th}>t_{th\text{\_}b},$$

where:

• i_load is the load current.

• i_th is the specified value for the Maximum permissible load current parameter.

• t_{i>i_th} is the time that the current threshold is exceeded.

• t_{th_b} is the specified value for the Time to fail when exceeding current parameter.

When the temporal or behavioral fault thresholds are exceeded, if C–S1 is:

• Closed — C–S1 remains closed for the rest of the simulation.

• Open — C–S1 the fault does not take effect unless the relay becomes de-energized and the C–S1 connection closes. Once closed, the C–S1 connection remains closed for the rest of the simulation.

C–S2 Stuck Closed Fault

The C–S2 stuck closed fault occurs if the common contact, C, becomes mechanically, electrically, or chemically stuck to the normally closed contact, S2. Causes of this type of fault include:

1. Contact welding, possibly due to an inrush current or breaking current that exceeds the rating or load short circuit.

2. Mechanical damage.

3. Insulation deterioration.

The table shows the faulted state for a C–S2 stuck closed fault.

Connection	State
C–S1	0
C–S2	1

A C–S2 stuck closed temporal fault can occur only if the simulation time exceeds the time threshold such that:

$$t>t_{th\_t},$$

where:

• t is the simulation time.

• t_{th_t} is the specified value for the Simulation time after which contactors can stick parameter.

A C–S2 stuck closed behavioral fault can occur only if the load current exceeds the current threshold for a period of time that exceeds the behavioral trigger time threshold. That is, the behavioral fault can occur only if:

$$i_{load}>i_{th},$$

and

$$t_{i>i\text{\_}th}>t_{th\text{\_}b},$$

where:

• i_load is the load current.

• i_th is the specified value for the Maximum permissible load current parameter.

• t_{i>i_th} is the time that the current threshold is exceeded.

• t_{th_b} is the specified value for the Time to fail when exceeding current parameter.

When the temporal or behavioral fault thresholds are exceeded, if C–S2 is:

• Closed — C–S2 remains closed for the rest of the simulation.

• Open — The C–S2 the fault does not take effect unless the relay becomes energized and the C–S2 connection closes. Once closed, the C–S2 connection remains closed for the rest of the simulation.

C Open Circuit (No Path to S1 or S2) Fault

The C open circuit (no path to S1 or S2) fault occurs if the common contact, C, becomes mechanically stuck in an open position. This type of fault can happen if:

• There is contact damage or deterioration.

• The switch connector becomes mechanically stuck in the middle of the relay.

The table shows the faulted state for a C open circuit (no path to S1 or S2) fault.

Connection	State
C–S1	0
C–S2	0

A C open circuit temporal fault can occur only if the simulation time exceeds the time threshold such that

$$t>t_{th\_t},$$

where:

• t is the simulation time.

• t_{th_t} is the specified value for the Simulation time after which C can be open circuit parameter.

A C open circuit behavioral fault can occur only if the load current exceeds the current threshold for a period of time that exceeds the behavioral trigger time threshold. That is, the behavioral fault can occur only if:

$$i_{load}>i_{th},$$

and

$$t_{i>i\text{\_}th}>t_{th\text{\_}b},$$

where:

• i_load is the load current.

• i_th is the specified value for the Maximum permissible load current parameter.

• t_{i>i_th} is the period of time during which the current threshold is exceeded.

• t_{th_b} is the specified value for the Time to fail when exceeding current parameter.

When the temporal fault threshold is exceeded, if:

• The relay is in the open-circuit state, that is, one connection has been broken, and the other connection has not yet been made, the relay remains open for the rest of the simulation.

• Either the C–S1 or C–S2 connection is closed, the fault does not take effect unless the relay is energized or de-energized and the closed connection is broken. If the connection is broken, the relay becomes an open-circuit, and remains open for the rest of the simulation.

When the behavioral fault thresholds are exceeded, if:

• The relay is in the open-circuit state, that is, one connection has been broken, and the other connection has not yet been made, the relay remains open for the rest of the simulation.

• Either the C–S1 or C–S2 connection is closed, the relay state immediately becomes an open circuit and remains an open circuit for the rest of the simulation.

Degraded Contact Resistance Fault

Causes of the degraded contact resistance fault include:

1. Overuse-induced overload conditions. High inrush currents and voltages can cause overload conditions, as can excessive switching of the relay. Overload conditions ultimately trigger electrical arching, which generates heat that degrades the contact material.

2. Chemical contamination that interferes with the operation of the relay contacts. Contaminants, which can include oxidation films or foreign particles, tend to produce high or unstable contact resistance readings.

3. End of relay life.

The table shows the faulted state for a degraded contact resistance fault.

Connection	State
C–S1	0 or 1. The contact resistance is degraded.
C–S2	0 or 1. The contact resistance is degraded.

A degraded contact resistance temporal fault can occur only if the simulation time exceeds the time threshold such that

$$t>t_{th\_t},$$

where:

• t is the simulation time.

• t_{th_t} is the specified value for the Simulation time for fault event parameter.

The degraded contact resistances of S1 and S2 are:

$$r_{contact\_s1}(t)=r_{contact\_fault\_s1}-(r_{contact\_fault\_s1}-r_{contact})sech\left(\frac{t-t_{th\text{\_}t}}{\tau }\right),$$

$$r_{contact\_s2}(t)=r_{contact\_fault\_s2}-(r_{contact\_fault\_s2}-r_{contact})sech\left(\frac{t-t_{th\text{\_}t}}{\tau }\right),$$

where:

• r_{contact_fault_s1} is the final value of the faulted S1 contact resistance.

• r_{contact_fault_s2} is the final value of the faulted S2 contact resistance.

• r_contact is the unfaulted S1 and S2 contact resistance.

A degraded contact resistance behavioral fault can occur only if the load current exceeds the current threshold for a period of time that exceeds the behavioral trigger time threshold. That is, the behavioral fault can occur only if:

$$i_{S1-C}>i_{th},$$

and

$$t_{i1>i\text{\_}th}>t_{th\text{\_}b},$$

where:

• i_load is the load current.

• i_th is the specified value for the Maximum permissible load current parameter.

• t_{i1>i_th} is the period of time during which the current threshold for the connection C-S1 is exceeded.

• t_{th_b} is the specified value for the Time to fail when exceeding current parameter.

For a behavior-triggered fault, if $$i_{S1-C}>i_{th}$$ continuously over the time interval t_{th_b},

$$r_{contact\_s1}(t)=r_{contact\_fault\_s1}-(r_{contact\_fault\_s1}-r_{contact})sech\left(\frac{t_{i1>i\_th}-t_{th\text{\_}b}}{\tau }\right),$$

where:

• i_S1-C is the common contact to normally closed contact, C–S1, current.

• i_th is the specified value for the Maximum permissible load current parameter.

• t_{th_b} is the specified value for the Time to fail when exceeding current parameter.

• r_{contact_fault_s1} is the final value of the faulted S1 contact resistance.

• r_contact is the unfaulted S1 contact resistance.

• τ is specified value for the Time constant for degraded contact resistance parameter.

Likewise, for a C–S2 connection, if

$$i_{S2-C}>i_{th}$$

and

$$t_{i2>i\text{\_}th}>t_{th\text{\_}b},$$

then the degraded contact resistance is:

$$r_{contact\_s2}(t)=r_{contact\_fault\_s2}-(r_{contact\_fault\_s2}-r_{contact})sech\left(\frac{t_{i2>i\_th}-t_{th\_b}}{\tau }\right),$$

where:

• i_S2-C is the common contact to normally closed contact, C–S2, current.

• r_{contact_fault_s2} is the final value of the faulted S2 contact resistance

When the temporal fault threshold is exceeded, for both the C–S1 and the C–S2 connections, the contact resistance is immediately degraded and remains degraded for the rest of the simulation.

When the behavioral fault thresholds are exceeded for C–S1, in terms of i_S1-C, the resistance for the C–S1 connection is degraded after the specified value for the Time to fail when exceeding current parameter and remains degraded for the rest of the simulation.

When the behavioral fault thresholds are exceeded for C–S2, in terms of i_S2-C, the resistance for the C–S2 connection is degraded after the specified value for the Time to fail when exceeding current parameter and remains degraded for the rest of the simulation.

Winding failed open circuit

The open-circuit winding fault is available only for the electrical control variant. An open circuit in the winding coil can cause this type of fault.

The table shows the faulted state for a winding failed open circuit fault.

Connection	State
C–S1	1
C–S2	0

A winding failed open circuit temporal fault can occur only if the simulation time exceeds the time threshold such that

$$t>t_{th\_t},$$

where:

• t is the simulation time.

• t_{th_t} is the specified value for the Simulation time for fault event parameter.

For time fault, the relay switches depending on the winding current, which is approximated as:

$$L\frac{di}{dt}+Ri=v_{winding}*sech\left(\frac{t-t_{th\_t}}{\tau }\right),$$

where :

• L is the winding inductance.

• R is the winding resistance.

• i is the winding current.

• v_winding is the voltage across the winding.

• t_{th_t} is the specified value for the Simulation time for fault event parameter.

• τ is the specified value for the Time constant for winding open circuit transition parameter.

A winding failed open circuit behavioral fault can occur only if one of these conditions is met:

• The winding current exceeds the current threshold for a period of time that exceeds the behavioral trigger time threshold.

• The winding voltage exceeds the voltage threshold for a number of times that exceeds the threshold for the number of voltage overloads.

That is, the behavioral fault can occur only if:

$$i_{winding}>i_{th}$$

and then

$$t_{i>i\text{\_}th}>t_{th\text{\_}b},$$

where:

• i_winding is the winding current.

• i_th is the specified value for the Maximum permissible winding current parameter.

• t_{i>i_th} is the time that the current threshold is exceeded.

• t_{th_b} is the specified value for the Time to fail when exceeding current parameter.

or if:

$$v_{winding}>v_{th},$$

and then

$$N_{v>v\text{\_}th}>N_{th},$$

where:

• v_winding is the winding voltage.

• v_th is the specified value for the Maximum permissible winding voltage parameter.

• N_{v>v_th} is the number of times that the voltage threshold is exceeded.

• N_th is the specified value for the Number of events to fail when exceeding voltage parameter.

If the temporal or behavioral fault thresholds are exceeded, the C–S1 remains closed for the rest of the simulation

Limitations and Assumptions

• For behavioral faults, if time to fail when exceeding the current threshold is greater than the time between switching events, no fault is triggered because the accumulated heat is not adequate for melting or breaking the contacts or windings.

• The energize and de-energize delays can differ, but the energize delay must be greater than or equal to the de-energize delay.

Ports

The type, visibility, and location of the block ports depend on how you configure these parameters in the Main settings:

• Control port — Choose between a physical signal input port, PS, or electrical conserving ports, + and -, for relay control.

• State port — Set the visibility for the relay state physical signal output port, x.

• Common port — Set the location of the common port, C, relative to the contact ports S1 and S2.

Control port	State port	Common port	Block
PS	Hidden	Adjacent to switch ports
		Adjacent to switch ports
	Visible	Across from switch ports
		Across from switch ports
Electrical	Hidden	Not applicable
	Visible	Not applicable

Input

PS — Physical signal control

physical signal

Physical signal input port that energizes and de-energizes the relay.

Dependencies

To enable this port, in the Main settings, set the Control port parameter to PS.

Output

x — Relay state

physical signal

State of the relay in terms of the C–S1 and C–S2 connections:

• 1 — Closed connection

• 0 — Open connection

Dependencies

To enable this port, in the Main settings, set the State port parameter to Visible.

Conserving

S1 — Normally closed contact

electrical

Electrical conserving port associated with the normally closed contact.

C — Common contact

electrical

Electrical conserving port associated with the common contact.

S2 — Normally open contact

electrical

Electrical conserving port associated with the normally open contact.

+ — Winding positive terminal

electrical

Electrical conserving port associated with the winding positive voltage terminal. The current through the winding controls the relay state.

Dependencies

To enable this port, in the Main settings, set the Control port parameter to Electrical.

- — Winding negative terminal

electrical

Electrical conserving port associated with the winding negative voltage terminal The current through the winding controls the relay state.

Dependencies

To enable this port, in the Main settings, set the Control port parameter to Electrical.

Parameters

Main

Control port — Input port choice

PS (default) | Electrical

Relay state control method:

• PS — PS physical signal input port

• Electrical — + and - electrical conserving ports associated with the relay winding terminals

Dependencies

If this parameter is set to:

• PS — The PS port and related parameters in the Main and Faults settings are visible. For more information, see Control Port Parameter Dependencies.

• Electrical — The + and - ports, related parameters in the Main and Faults settings, and the Windings settings are visible. For more information, see Control Port Parameter Dependencies, Faults Parameter Dependencies, and Winding.

The table shows how this parameter affects the visibility of other parameters in the Main settings. To learn how to read the table, see Parameter Dependencies.

Control Port Parameter Dependencies

Control port
PS	Electrical
Closed resistance	Closed resistance
Open conductance	Open conductance
Threshold
State port	State port
Common port

Closed resistance — Connected contact resistance

0.01 Ohm (default) | positive scalar

Resistance across closed relay contacts. The parameter value must be greater than zero.

Open conductance — Open-circuit conductance

1e-8 1/Ohm (default) | positive scalar

Conductance across open relay contacts. The parameter value must be greater than zero.

Threshold — Relay threshold

0 (default) | nonnegative scalar

If the physical signal input is above the threshold value, the relay is energized. Conversely, if the physical signal input falls is the threshold value, the relay is de-energized.

Dependencies

To enable this parameter, set Control port to PS.

State port — Relay state output port visibility

Hidden (default) | Visible

Visibility of the physical signal port that outputs the relay state. The port outputs a vector of length two, with the first element corresponding to the C–S1 connection and the second to the C–S2 connection. The elements are 1 if the corresponding connection is closed, and 0 otherwise.

Common port — Common port location

Adjacent to switch ports (default) | Across from switch ports

Location of the common port, C, relative to the S1 and S2 ports.

Dependencies

To enable this parameter, set Control port to PS.

Winding

The Winding settings are visible only if, in the Main settings, the Control port parameter is set to Electrical. For more information, see Control port.

Rated voltage — Rated voltage

5 V (default) | positive scalar

Standard voltage applied to the operating coil under normal operating conditions. The current threshold depends on the value of this parameter.

Dependencies

To enable this parameter, in the Main settings, set the Control port parameter to Electrical. For more information, see Control port.

Percent rated voltage to energize — Percent rated voltage to energize

75 (default) | positive scalar

Minimum percent of the rated voltage required to energize the relay. The current threshold depends on the value of this parameter.

Dependencies

To enable this parameter, in the Main settings, set the Control port parameter to Electrical. For more information, see Control port.

Percent rated voltage to de-energize — Percent rated voltage to de-energize

25 (default) | positive scalar

Percent of the rated voltage required to de-energize the relay. The current threshold depends on the value of this parameter.

Dependencies

To enable this parameter, in the Main settings, set the Control port parameter to Electrical. For more information, see Control port.

Winding inductance — Winding inductance

0.08 H (default) | positive scalar

Winding inductance.

Dependencies

To enable this parameter, in the Main settings, set the Control port parameter to Electrical. For more information, see Control port.

Winding series resistance — Winding series resistance

12.5 Ohm (default) | positive scalar

Resistance between the winding terminals. The current threshold depends on the value of this parameter.

Dependencies

To enable this parameter, in the Main settings, set the Control port parameter to Electrical. For more information, see Control port.

Winding parallel conductance — Winding parallel conductance

1e-9 1/Ohm (default) | positive scalar

Winding conductance.

Dependencies

To enable this parameter, in the Main settings, set the Control port parameter to Electrical. For more information, see Control port.

Mechanical

Time-to-break C-S1 connection — Delay time for breaking connection C–S1

0 s (default) | nonnegative scalar

Mechanical switching time for breaking the connection between ports C and S1 when the relay is energized.

Time-to-make C-S1 connection — Delay time for making connection C–S1

0 s (default) | nonnegative scalar

Mechanical switching time for making the connection between ports C and S1 when the relay is de-energized.

Time-to-break C-S2 connection — Delay time for breaking connection C–S2

0 s (default) | nonnegative scalar

Mechanical switching time for breaking the connection between ports C and S2 when the relay is energized.

Time-to-make C-S2 connection — Delay time for making connection C–S2

0 s (default) | nonnegative scalar

Mechanical switching time for making the connection between ports C and S2 when the relay is de-energized.

Faults

The table shows how the specified options for certain parameters in the Faults settings affect the visibility of other parameters in the Faults settings. To learn how to read the table, see Parameter Dependencies.

Note

To enable the Failure mode parameter, in the Main settings, set Control Port to Electrical. For more information, see Control port.

Faults Parameter Dependencies

Faults
Enable faults
No	Yes
	Reporting when a fault occurs
	Failure mode
	Switch fault																Winding failed open circuit
	Switch fault
	C-S1 stuck closed				C-S2 stuck closed				C open circuit (no path to S1 or S2)				Degraded contact resistance
													Degraded contact resistance C-S1
													Degraded contact resistance C-S2
													Time constant for degraded contact resistance				Time constant for winding open circuit transition
	Fault trigger				Fault trigger				Fault trigger				Fault trigger				Fault trigger
	Behavioral		Temporal		Behavioral		Temporal		Behavioral		Temporal		Behavioral		Temporal		Behavioral		Temporal
	Maximum permissible load current		Simulation time after which contactors can stick		Maximum permissible load current		Simulation time after which contactors can stick		Maximum permissible load current		Simulation time after which C can be open circuit		Maximum permissible load current		Simulation time for fault event		Maximum permissible winding voltage		Simulation time for fault event
																	Number of events to fail when exceeding voltage
	Time to fail when exceeding current				Time to fail when exceeding current				Time to fail when exceeding current				Time to fail when exceeding current				Maximum permissible winding current
																	Time to fail when exceeding current

Enable faults — Whether to model faults

No (default) | Yes

Whether to model faults.

Dependencies

Select Yes to enable faults modeling. The associated parameters in the Faults section become visible to let you select the reporting method and specify the trigger mechanism (temporal or behavioral). For more information, see Faults Parameter Dependencies.

Reporting when a fault occurs — Reporting when a fault occurs

None (default) | Warn | Error

Simulation reporting when a fault occurs:

• None — Does not generate a warning or an error.

• Warn — Generates a warning.

• Error — The simulation stops and generates an error.

Dependencies

To enable this parameter, set Enable faults to Yes. For more information, see Faults Parameter Dependencies.

Failure mode — Fault model

Winding failed open circuit (default) | Switch fault

Failure mode.

Dependencies

To enable this parameter, in the Main settings, set the Control port parameter to Electrical and, in the Faults settings, set the Enable faults parameter to Yes. For more information, see Control port and Faults Parameter Dependencies.

The specified option for this parameter affects the visibility of other parameters in the Faults settings. For more information, see Faults Parameter Dependencies.

Switch fault — Switch fault model

C-S1 stuck closed (default) | C-S2 stuck closed | C open circuit (no path to S1 or S2) | Degraded contact resistance

Switch fault model.

Dependencies

To enable this parameter, choose one of these options:

• In the Main settings, set Control port to PS and, in the Faults settings, set Enable faults to Yes.

• In the Main settings, set Control port to Electrical, and in the Faults settings, set Enable faults to Yes and the Failure mode parameter to Switch fault.

For more information, see Control port and Faults Parameter Dependencies.

Degraded contact resistance C-S1 — Degraded contact resistance C–S1

1e-9 Ohm (default) | positive scalar

Degraded resistance of the faulted S1 contact.

Dependencies

To enable this parameter, choose one of these condition sets:

Condition Set One

• In the Main settings, set Control port to PS.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Switch fault to Degraded contact resistance.

Condition Set Two

• In the Main settings, set Control port to Electrical.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Failure mode to Switch fault.

  • Set Switch fault to Degraded contact resistance.

For more information, see Control port and Faults Parameter Dependencies.

Degraded contact resistance C-S2 — Degraded contact resistance C–S2

1e-9 Ohm (default) | positive scalar

Degraded resistance of the faulted S2 contact.

Dependencies

To enable this parameter, choose one of these condition sets:

Condition Set One

• In the Main settings, set Control port to PS.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Switch fault to Degraded contact resistance.

Condition Set Two

• In the Main settings, set Control port to Electrical.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Failure mode to Switch fault.

  • Set Switch fault to Degraded contact resistance.

For more information, see Control port and Faults Parameter Dependencies.

Time constant for degraded contact resistance — Time constant for degraded contact resistance

1e-3 (default) | positive scalar

Time constant for contact resistance to fall into degraded status. The degraded contact resistances for S1 and S2 have the same time constant.

Dependencies

To enable this parameter, choose one of these condition sets:

Condition Set One

• In the Main settings, set Control port to PS.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Switch fault to Degraded contact resistance.

Condition Set Two

• In the Main settings, set Control port to Electrical.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Failure mode to Switch fault.

  • Set Switch fault to Degraded contact resistance.

For more information, see Control port and Faults Parameter Dependencies.

Time constant for winding open circuit transition — Time constant for winding to fail

1e-3 s (default) | positive scalar

Time constant for the winding to fail. This constant is the characteristic time that describes a transition from a normal state to an open circuit. You can calculate this value as the time it takes for the response to reach 63% of its steady-state value when the fault occurs.

Dependencies

To enable this parameter:

• In the Main settings, set Control port to Electrical.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Failure mode to Winding failed open circuit.

For more information, see Control port and Faults Parameter Dependencies.

Fault trigger — Enable time-based or behavioral fault triggering

Temporal (default) | Behavioral

Since R2023a

Set this parameter to Temporal to enable time-based fault triggering.

Set this parameter to Behavioral to enable behavioral fault triggering.

Dependencies

To enable this parameter, set Enable faults to Yes. For more information, see Faults Parameter Dependencies.

Simulation time after which contactors can stick — Simulation time after which the S1 or S2 contact can stick closed

1 s (default) | positive scalar

Simulation time after which the S1 or S2 contact can stick closed for a C-S1 stuck closed or C-S2 stuck closed fault.

Dependencies

To enable this parameter, choose one of these condition sets:

Condition Set One

• In the Main settings, set Control port to PS.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Switch fault to either C-S1 stuck closed or C-S2 stuck closed.

  • Set Fault trigger to Temporal.

Condition Set Two

• In the Main settings, set Control port to Electrical.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Failure mode to Switch fault.

  • Set Switch fault to either C-S1 stuck closed or C-S2 stuck closed.

  • Set Fault trigger to Temporal.

For more information, see Control port and Faults Parameter Dependencies.

Simulation time after which C can be open circuit — Simulation time after which the relay can be faulted to the open- circuit state

1 s (default) | positive scalar

Simulation time after which, for the C open circuit (no path to S1 or S2) fault, the relay can be faulted to the open- circuit state.

Dependencies

To enable this parameter, choose one of these condition sets:

Condition Set One

• In the Main settings, set Control port to PS.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Switch fault to C open circuit (no path to S1 or S2).

  • Set Fault trigger to Temporal.

Condition Set Two

• In the Main settings, set Control port to Electrical.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Failure mode to Switch fault.

  • Set Switch fault to C open circuit (no path to S1 or S2).

  • Set Fault trigger to Temporal.

For more information, see Control port and Faults Parameter Dependencies.

Simulation time for fault event — Simulation time for winding fault or degraded resistance fault

1 s (default) | nonnegative scalar

Simulation time after which a fault can occur for a Degraded contact resistance or a Winding failed open circuit fault.

Dependencies

To enable this parameter, choose one of these condition sets:

Condition Set One

• In the Main settings, set Control port to PS.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Switch fault to Degraded contact resistance.

  • Set Fault trigger to Temporal.

Condition Set Two

• In the Main settings, set Control port to Electrical.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Failure mode to Switch fault.

  • Set Switch fault to Degraded contact resistance.

  • Set Fault trigger to Temporal.

Condition Set Three

• In the Main settings, set Control port to Electrical.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Failure mode to Winding failed open circuit.

  • Set Fault trigger to Temporal.

For more information, see Control port and Faults Parameter Dependencies.

Maximum permissible load current — Maximum permissible load current

inf A (default) | positive scalar

Upper load-current threshold for degraded contact resistance and open-circuit winding faults.

Dependencies

To enable this parameter, choose one of these condition sets:

Condition Set One

• In the Main settings, set Control port to PS.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Fault trigger to Behavioral.

Condition Set Two

• In the Main settings, set Control port to Electrical.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Failure mode to Switch fault.

  • Set Fault trigger to Behavioral.

For more information, see Control port and Faults Parameter Dependencies.

Maximum permissible winding voltage — Maximum permissible winding voltage

inf V (default) | positive scalar

Maximum voltage for the relay winding, above which a fault may be triggered.

Dependencies

To enable this parameter:

• In the Main settings, set Control port to Electrical.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Failure mode to Winding failed open circuit.

  • Set Fault trigger to Behavioral.

For more information, see Control port and Faults Parameter Dependencies.

Number of events to fail when exceeding voltage — Number of events to fail when exceeding voltage

1 (default) | positive scalar integer

Number of times the relay must exceed the winding voltage threshold before a Winding failed open circuit fault is triggered.

Dependencies

To enable this parameter:

• In the Main settings, set Control port to Electrical.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Failure mode to Winding failed open circuit.

  • Set Fault trigger to Behavioral.

For more information, see Control port and Faults Parameter Dependencies.

Maximum permissible winding current — Maximum permissible winding current

inf A (default) | positive scalar

Winding current threshold for triggering a behavioral Winding failed open circuit fault.

Dependencies

To enable this parameter:

• In the Main settings, set Control port to Electrical.

• In the Faults settings:

  • Set Enable faults to Yes.

  • Set Failure mode to Winding failed open circuit.

  • Set Fault trigger to Behavioral.

For more information, see Control port and Faults Parameter Dependencies.

Time to fail when exceeding current — Time to fail when exceeding current

1 s (default) | positive scalar

Amount of time that the load or winding current must continuously exceed the maximum permissible current before a behavioral fault is triggered.

Dependencies

To enable this parameter:

• Set Enable faults to Yes.

• Set Fault trigger to Behavioral.

For more information, see Control port and Faults Parameter Dependencies.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2019b

R2023a: Implement temporal or behavioral triggers for faults using a single parameter

The Enable temporal trigger and Enable behavioral trigger parameters have been removed and are replaced with the Fault trigger parameter. You can set the Fault trigger parameter to Temporal or Behavioral. You can enable only one trigger.

If you created a model in an earlier release and enabled both temporal and behavioral triggers, now only the temporal trigger is enabled. Therefore, the simulation results are different if the behavioral trigger causes the fault in your model.

If you want to trigger a fault at a specific time, set the Fault trigger parameter to Temporal. If you want to determine whether a system fails and, if so, when it fails, set the Fault Trigger parameter to Behavioral.