> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/hypersim/library-blocks-reference/control-protection-relays/25-synchronism-check.md).

# 25 - Synchronism Check

## Description

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-1f23e6bca2701582ef66b7a603139cff9345bc24%2Fimage%20(587).png?alt=media" alt="" width="165"><figcaption></figcaption></figure>

The **25 - Synchronism Check** block, located in the **Control Protection Relays** library, models a generic synchronism-check (sync-check) relay used to verify synchronism before issuing a circuit breaker close command. It also includes a Voltage Check function that allows closing on de-energized networks. The model supports 50 Hz and 60 Hz systems.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-4ca2405d2f2e2a9ef82e8423c1a04cfd511fd6b2%2Fimage%20(588).png?alt=media" alt="" width="563"><figcaption><p>The tripping logic of the relay.</p></figcaption></figure>

The relay verifies that bus and line frequency, voltage magnitude, and phase angle meet the configured limits before allowing the breaker to close. It uses a three-phase phase-locked loop (PLL) to calculate bus and line frequencies and uses the fundamental Phase A-to-ground voltage as the operating quantity. A freeze time prevents misoperation at simulation start, and a breaker operation time can be defined to account for breaker closing delay.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-c0ce5f5f923168cc6c596a364eccc5596e81d7d7%2Fimage%20(589).png?alt=media" alt="" width="258"><figcaption><p>Schematic for the relay operation</p></figcaption></figure>

### Live bus and live line condition

Both bus and line voltages must be greater than V<sub>Max</sub> (i.e., V<sub>Bus</sub> > V<sub>Max</sub> and V<sub>Line</sub> > V<sub>Max</sub>) to be considered live. Additionally, the bus and line voltages may be either static or slipping relative to each other:

**Static voltages**

If $$|f\_{Bus} − f\_{Line}| ≤ 0.01 Hz$$|, voltages are treated as static.

If both $$|V\_{Bus} − V\_{Line}| < ΔV\_{threshold}$$ and $$|φ\_{Bus} − φ\_{Line}| < Δφ\_{threshold}$$ persist for the Ton delay (internally preset to 1 power cycle), the network is considered synchronized and CloseCB goes high.

{% hint style="info" %}
If voltages are static, the breaker operate time is not considered when issuing CloseCB.
{% endhint %}

**Slipping voltages**

If $$|f\_{Bus} − f\_{Line}| > 0.01 Hz$$, voltages are treated as slipping.

If $$|f\_{Bus} − f\_{Line}| ≥ Δf\_{threshold}$$, CloseCB is not asserted.

If $$|f\_{Bus} − f\_{Line}| < Δf\_{threshold}$$, the relay evaluates the instant to close:

* Approaching phasors: CloseCB is issued at\
  $$CB closing angle (deg) = −Δf × 360 × (breaker close time)$$ with $$Δf =f\_{Bus}-f\_{Line}$$\
  If breaker delay = 0 s, the closing angle is 0 deg.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-f8e1e7184a58fed57c52119d7847d877c9f74be9%2Fimage%20(590).png?alt=media" alt="" width="314"><figcaption><p>Approaching phasor</p></figcaption></figure>

* Parting phasors: CloseCB is issued when the closing angle is within:\
  $$\big\[(-\Delta f \times 360 \times \text{Breaker close time}), ; (\Delta \phi\_{\text{threshold}} - \Delta f \times 360 \times \text{Breaker close time}) \big] ; \text{when } \Delta f > 0$$\
  $$\big\[ (-\Delta \phi\_{\text{threshold}} - \Delta f \times 360 \times \text{Breaker close time}), ; (-\Delta f \times 360 \times \text{Breaker close time}) \big] ; \text{when } \Delta f < 0$$<br>

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-bb2edc7c70d5816953f0764379ab401ee31f69be%2Fimage%20(591).png?alt=media" alt="" width="329"><figcaption><p>Parting phasors</p></figcaption></figure>

### Dead Bus and/or Dead Line <a href="#id-25-synchronism-checkrelay-deadbusand-ordeadline" id="id-25-synchronism-checkrelay-deadbusand-ordeadline"></a>

Voltage Check mode (de-energized operation) also permits closing under the following conditions:

* A. Dead Line: line voltage < VMin; bus voltage and frequency within programmed limits.
* B. Dead Bus: bus voltage < VMin; line voltage and frequency within programmed limits.
* C. Dead Bus and Dead Line: both bus and line voltages < VMin.

{% hint style="info" %}
The frequencies on both sides of the breaker are measured and must not deviate from the rated frequency by more than ±5 Hz.
{% endhint %}

## Mask parameters

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-c995b9985738b5aea45a171bc8cda6204a8f060d%2F25.jpg?alt=media" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="System parameters" %}

<table><thead><tr><th width="220.28973388671875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Frequency</strong></td><td>System frequency Freq_param (Hz). Supported values: 50 Hz or 60 Hz</td></tr><tr><td><strong>Rated system voltage</strong></td><td>Rated line-to-line RMS voltage (V). VRMSLL_param: [1, 1e8]</td></tr></tbody></table>
{% endtab %}

{% tab title="Setting" %}

<table><thead><tr><th width="219.593994140625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Voltage difference threshold</strong></td><td>Voltage difference limit for synchronizing, percent of V L-L. (%) dV_threshold_param : [0.50, 50.00]</td></tr><tr><td><strong>Phase angle difference threshold</strong></td><td>Phase angle difference limit for synchronizing (deg). dPhi_threshold_param: [1.00, 90.00] deg</td></tr><tr><td><strong>Frequency difference threshold</strong></td><td>Frequency difference limit for synchronizing (Hz). dF_threshold_param: [0.02, 0.25] Hz.</td></tr><tr><td><strong>Breaker close time</strong></td><td>Breaker closing time (s). Breaker_delay [0, 60] s</td></tr><tr><td><strong>Freeze time</strong></td><td>Initial time (s) during which CloseCB remains 0 (breaker open). tunf_param: [0.10, 60.00] s</td></tr><tr><td><strong>Voltage Check</strong></td><td>Enable/disable Voltage Check functionality. Volt_Check_param : 0 = disabled, 1 = enabled</td></tr><tr><td><strong>VMin</strong></td><td>Threshold below which bus/line is considered dead (% of V L-L). VMin_param: [10.00, 80.00]%</td></tr><tr><td><strong>VMax</strong></td><td>Threshold above which bus/line is considered live (% V L-L). VMax_param: [50.00, 100.00]%</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## Inputs

<table><thead><tr><th width="239.72393798828125">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>VBus</strong></td><td>Three-phase bus voltages [Va, Vb, Vc].</td></tr><tr><td><strong>VLine</strong></td><td>Three-phase line voltages [Va, Vb, Vc].</td></tr><tr><td><strong>Reset</strong></td><td>Relay reset signal. When this input is 1, the relay is reset.</td></tr></tbody></table>

## Outputs

<table><thead><tr><th width="240.419677734375">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>CloseCB</strong></td><td>Circuit breaker close command. Default is 0; it becomes 1 when synchronism conditions are met and remain true for the internal delay Ton = 1 power cycle. CloseCB = 0: breaker open. CloseCB = 1: breaker closed.</td></tr><tr><td><strong>m</strong></td><td><p><strong>dV</strong>: Calculated magnitude difference of bus and line voltage (Phase A), unit: V.</p><p><strong>dPhi</strong>: Calculated difference of bus and line phase angle (Phase A), unit: deg.</p><p><strong>df</strong>: Calculated difference of bus and line frequency, unit: Hz.</p></td></tr></tbody></table>

## References

1. Microgrid Controller Procurement Information, NREL-GHOST Model
2. User´s manual and Technical description of ABB SPAU 140 C Synchro-check relay
3. Line distance protection, ABB REL670 Technical manual
4. Line distance protection, ABB REL670 Application manual
5. Generator and Intertie Protection Relays SEL-700G Instruction manual


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/hypersim/library-blocks-reference/control-protection-relays/25-synchronism-check.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
