> 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/81-frequency.md).

# 81 - Frequency

## Description

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

The **81 - Frequency** block, located in the **Control Protection Relays** library, includes three frequency elements: overfrequency (81O), underfrequency (81U), and rate-of-change-of-frequency (ROCOF, 81R). The 81O and 81U elements each provide five threshold levels; the 81R element provides one level. The relay measures frequency and ROCOF from the input voltage signals using zero-crossing detection. When the measured value exceeds the configured settings and the time delay elapses, the relay operates. 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-4759b92179d785efb44ff59d1634a62eb1a74c42%2F81%20(1).jpg?alt=media" alt="" width="563"><figcaption><p>The five-level characteristic of 81O and 81U</p></figcaption></figure>

{% hint style="info" %}
A time delay is applied to ride through momentary frequency fluctuations and prevent nuisance operation.
{% 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-65da5686054485d6845a295532fb14dfd67c01cd%2F81.jpg?alt=media" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="180.199951171875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Frequency</strong></td><td>Nominal frequency of the measured voltage signals (Hz), Freq_param = {50, 60}, Typical value: 60 Hz</td></tr><tr><td><strong>Freezing time</strong></td><td>Freezing time of the 81 relay (s), tunf_param = [0.10, 60.00]<br>While t &#x3C; freezing time, the relay does not operate,<br>typical value: 0.2 s</td></tr></tbody></table>
{% endtab %}

{% tab title="Overfrequency" %}

<table><thead><tr><th width="201">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Enable Overfrequency</strong></td><td>Enable or disable the overfrequency element, Enable_81O_param = {0, 1}</td></tr><tr><td><strong>Level 1</strong></td><td>Overfrequency threshold, level 1 (s)<br>OLevel1_param = [45, 55] for 50 Hz operation; [55, 65] for 60 Hz operation.<br>Typical value: 60.5 Hz</td></tr><tr><td><strong>Level 2</strong></td><td>Overfrequency threshold, level 2 (s)<br>OLevel2_param = [45, 55] for 50 Hz operation; [55, 65] for 60 Hz operation.<br>Typical value: 61.0 Hz</td></tr><tr><td><strong>Level 3</strong></td><td>Overfrequency threshold, level 3 (s)<br>OLevel3_param = [45, 55] for 50 Hz operation; [55, 65] for 60 Hz operation.<br>Typical value: 61.5 Hz</td></tr><tr><td><strong>Level 4</strong></td><td>Overfrequency threshold, level 4 (s)<br>OLevel4_param = [45, 55] for 50 Hz operation; [55, 65] for 60 Hz operation.<br>Typical value: 62.0 Hz</td></tr><tr><td><strong>Level 5</strong></td><td>Overfrequency threshold, level 5 (s)<br>OLevel5_param = [45, 55] for 50 Hz operation; [55, 65] for 60 Hz operation.<br>Typical value: 62.5 Hz</td></tr><tr><td><strong>Time 1</strong></td><td>Time delay for Level 1 operation (s)<br>OTime1_param = [0, 600], typical value: 2.0 s</td></tr><tr><td><strong>Time 2</strong></td><td>Time delay for Level 2 operation (s)<br>OTime2_param = [0, 600], typical value: 0.5 s</td></tr><tr><td><strong>Time 3</strong></td><td>Time delay for Level 4 operation (s)<br>OTime4_param = [0, 600], typical value: 0.4 s</td></tr><tr><td><strong>Time 4</strong></td><td>Time delay for Level 4 operation (s)<br>OTime4_param = [0, 600], typical value: 0.3 s</td></tr><tr><td><strong>Time 5</strong></td><td>Time delay for Level 5 operation (s)<br>OTime5_param = [0, 600], typical value: 0.2 s</td></tr></tbody></table>
{% endtab %}

{% tab title="Underfrequency" %}

<table><thead><tr><th width="202.60003662109375">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Enable Underfrequency</strong></td><td>Enable or disable the underfrequency element, Enable_81U_param = {0, 1}</td></tr><tr><td><strong>Level 1</strong></td><td>Underfrequency threshold, level 1 (Hz)<br>ULevel1_param = [45, 55] for 50 Hz operation; [55, 65] for 60 Hz operation.<br>Typical value: 59.5 Hz</td></tr><tr><td><strong>Level 2</strong></td><td>Underfrequency threshold, level 2 (Hz)<br>ULevel2_param = [45, 55] for 50 Hz operation; [55, 65] for 60 Hz operation.<br>Typical value: 59.0 Hz</td></tr><tr><td><strong>Level 3</strong></td><td>Underfrequency threshold, level 3 (Hz)<br>ULevel3_param = [45, 55] for 50 Hz operation; [55, 65] for 60 Hz operation.<br>Typical value: 58.5 Hz</td></tr><tr><td><strong>Level 4</strong></td><td>Underfrequency threshold, level 4 (Hz)<br>ULevel4_param = [45, 55] for 50 Hz operation; [55, 65] for 60 Hz operation.<br>Typical value: 57.0 Hz</td></tr><tr><td><strong>Level 5</strong></td><td>Underfrequency threshold, level 5 (Hz)<br>ULevel5_param = [45, 55] for 50 Hz operation; [55, 65] for 60 Hz operation.<br>Typical value: 57.5 Hz</td></tr><tr><td><strong>Time 1</strong></td><td>Time delay for Level 1 operation (s).<br>UTime1_param = [0, 600], typical value: 2.0 s</td></tr><tr><td><strong>Time 2</strong></td><td>Time delay for Level 2 operation (s).<br>UTime2_param = [0, 600], typical value: 0.5 s</td></tr><tr><td><strong>Time 3</strong></td><td>Time delay for Level 3 operation (s).<br>UTime3_param = [0, 600], typical value: 0.4 s</td></tr><tr><td><strong>Time 4</strong></td><td>Time delay for Level 4 operation (s).<br>UTime4_param = [0, 600], typical value: 0.3 s</td></tr><tr><td><strong>Time 5</strong></td><td>Time delay for Level 5 operation (s).<br>UTime5_param = [0, 600], typical value: 0.2 s</td></tr></tbody></table>
{% endtab %}

{% tab title="ROCOF" %}

<table><thead><tr><th width="201">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Enable ROCOF</strong></td><td><p>Enable or disable the ROCOF element.</p><p>Enable_ROCOF_param = {0, 1}</p></td></tr><tr><td><strong>Level 1</strong></td><td>Rate-of-change-of-frequency threshold (Hz/s)<br>Rf_param = [-10, 10], typical value: 0.3 Hz/s</td></tr><tr><td><strong>Time 1</strong></td><td>Time delay for Level 1 operation (s).<br>rocofDelay_param = [0, 600], typical value: 0.0 s</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## Inputs

<table><thead><tr><th width="199.5999755859375">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>Vabc</strong></td><td>Three-phase voltage input as a 3-element vector in the order Va, Vb, Vc.</td></tr><tr><td><strong>Reset</strong></td><td>Relay reset signal. When this signal is 1, the relay resets.</td></tr></tbody></table>

## Outputs

| Output  | Description                                                                                             |
| ------- | ------------------------------------------------------------------------------------------------------- |
| **81O** | Overfrequency element output. Default is 0; becomes 1 when an overfrequency condition is detected.      |
| **81U** | Underfrequency element output. Default is 0; becomes 1 when an underfrequency condition is detected.    |
| **81R** | ROCOF element output. Default is 0; becomes 1 when a rate-of-change-of-frequency condition is detected. |
| **m**   | The calculated frequency by the relay/the actuating quantity of the relay (Hz).                         |


---

# 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/81-frequency.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.
