> 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/network-switches-and-breakers/dc-circuit-breaker.md).

# DC Circuit Breaker

## Description

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

The **DC Circuit Breaker** block, located in the **Network Switches and Breakers** library, models a hybrid HVDC breaker with two branches: an auxiliary branch that includes a Load Commutating Switch (LCS) and an Ultra Fast Disconnector (UFD), and a main branch composed of a main circuit breaker with individual surge arresters that form cells. The number of cells in the main branch is configurable.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-88cb1bef6a7497d7e7b95d2e751bc2e6b801a2c8%2Fimage%20(448).png?alt=media" alt=""><figcaption><p>DC circuit breaker block - two branches.</p></figcaption></figure>

Under normal operation, current flows through the auxiliary branch only, and the main breaker carries no current. When a DC fault occurs, the LCS immediately commutates current to the main breaker and the UFD opens. With the mechanical switch open, the main breaker interrupts the current.

The LCS and main breaker use IGBT-based switches. You can configure the number of IGBTs in series and in parallel, the switching times of the LCS, UFD, and main breakers, and the number of switching times enabled for each breaker (up to four).

{% hint style="info" %}
All switching times are relative to the trigger input (Trig).

Each switching time must be strictly increasing: T1 < T2 < T3 < T4. If not, only the first value that respects this condition is applied.
{% 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-396296950e195947cd5603e5c9b409ee980d515a%2FDC_CB.jpg?alt=media" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="259.39996337890625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Control type</strong></td><td>Select Internal to use switching times from the Timing tab, or External (input pins) to use command inputs.</td></tr><tr><td><strong>Number of cells in main breaker</strong></td><td>Number of cells in the main breaker (1 to 10).</td></tr><tr><td><strong>Include inductance</strong></td><td>Include series inductance when selected.</td></tr><tr><td><strong>Resistor</strong></td><td>Parallel resistance (Ohm). Valid range: 0 to 1e12.</td></tr><tr><td><strong>Inductance</strong></td><td>Series inductance (H). Valid range: 0 to 1e12.</td></tr><tr><td><strong>Number of IGBTs in parallel in the LCS</strong></td><td>Number of IGBTs in parallel in the LCS.</td></tr><tr><td><strong>Number of IGBTs in parallel in each cell</strong></td><td>Number of IGBTs in parallel in each main-breaker cell.</td></tr><tr><td><strong>Number of IGBTs in series in the LCS</strong></td><td>Number of IGBTs in series in the LCS.</td></tr><tr><td><strong>Number of IGBTs in series in each cell</strong></td><td>Number of IGBTs in series in each main-breaker cell.</td></tr></tbody></table>
{% endtab %}

{% tab title="Timing" %}

<table><thead><tr><th width="260.20001220703125">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Breaker initial state</strong></td><td>Initial state of each breaker (open or closed).</td></tr><tr><td><strong>T1, T2, T3, T4</strong></td><td>Switching times (s) for each breaker. Acts as a closing time if the initial state is open; otherwise, as an opening time. Valid range: 0 to 1e12 (s).</td></tr><tr><td><strong>Number of switching times enabled</strong></td><td>Number of switching times to use (0 to 4). For example, 2 enables only T1 and T2.</td></tr></tbody></table>
{% endtab %}

{% tab title="Surge arrester" %}

<table><thead><tr><th width="261">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Points in ZnO characteristic</strong></td><td>Number of points in the ZnO characteristic (1 to 12). The first point must be (0, 0).</td></tr><tr><td><strong>Voltage</strong></td><td>Voltage points (V) of the ZnO characteristic. Valid range: 0 to 1e12.</td></tr><tr><td><strong>Current</strong></td><td>Current points (A) of the ZnO characteristic. Valid range: 0 to 1e12.</td></tr></tbody></table>
{% endtab %}

{% tab title="Advanced" %}

<table><thead><tr><th width="260.199951171875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Ron resistance for each IGBT</strong></td><td>Resistance when closed (Ohm). Valid range: 0 to 1e12.</td></tr><tr><td><strong>Ron resistance for each IGBT</strong></td><td>Resistance when open (MOhm). Valid range: 0 to 1e12.</td></tr><tr><td><strong>Ron resistance for ultra fast disconnector</strong></td><td>UFD resistance when closed (Ohm). Valid range: 0 to 1e12.</td></tr><tr><td><strong>Roff resistance for ultra fast disconnector</strong></td><td>UFD resistance when open (MOhm). Valid range: 0 to 1e12.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## Conserving ports

<table><thead><tr><th width="220.39996337890625">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>Net_1</strong></td><td>Electrical network connection; “+” indicates the current measurement direction.</td></tr><tr><td><strong>Net_2</strong></td><td>Electrical network connection.</td></tr></tbody></table>

## Inputs

<table><thead><tr><th width="219.5999755859375">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>Bx (x=1 to 10)</strong></td><td>Status of each breaker.</td></tr><tr><td><strong>Trig</strong></td><td>Trigger input. Switching times are relative to this signal. A trigger occurs when the input exceeds 0.5.</td></tr><tr><td><strong>ExtCtrl - LCS</strong></td><td>LCS command input. Used only when Control type is set to External (input pins).</td></tr><tr><td><strong>ExtCtrl - UFD</strong></td><td>UFD command input. Used only when Control type is set to External (input pins).</td></tr><tr><td><strong>ExtCtrl - Bsig</strong></td><td>Main-branch breaker command inputs (bundle of size 10). Unconnected pins default to 0 (Open).</td></tr><tr><td><strong>Imain_scp</strong></td><td>Main-branch current (A).</td></tr><tr><td><strong>Iaux_scp</strong></td><td>Auxiliary-branch current (A).</td></tr></tbody></table>

## Outputs

This block has no outputs.

## Signals available for monitoring and external I/O connections (via sensors form)

All block inputs and outputs are available as signals for monitoring and for external I/O connections.

Additional signals are also available and are listed below with their descriptions.

| Signal                   | Description                                          |
| ------------------------ | ---------------------------------------------------- |
| **I\_aux**               | Current through the auxiliary branch (A).            |
| **I\_main**              | Current through the main branch (A).                 |
| **Bx\_int (x=1 to 10)**  | Internal controlled breaker status.                  |
| **LCS\_int**             | Internal controlled LCS status.                      |
| **UFD\_int**             | Internal controlled UFD status.                      |
| **iSegb\_x (x=1 to 10)** | Status of selected breaker cells.                    |
| **IZnox (x = 1 to 10)**  | Current through the main-branch surge arresters (A). |

## Characteristics and limitations

| Characteristic                                | Value                             |
| --------------------------------------------- | --------------------------------- |
| Maximum number of main-breaker cells          | 10                                |
| Maximum number of switching times per breaker | 4                                 |
| Control modes                                 | Internal or External (input pins) |

## References

1. J. Häfner, B. Jacobson, "Proactive Hybrid HVDC Breakers - A key innovation for reliable HVDC Grids", International symposium on Electric Power systems of the Future, 13-15 September, 2011


---

# 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/network-switches-and-breakers/dc-circuit-breaker.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.
