> 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/smart-power-simulation-software-sps/blocks-functions-tools/power-converters/switches/universal-bridge.md).

# Universal Bridge

## Description

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-15fc0873339563ba7dfd1293dcd5f1225c8eedec%2Funiversal_bridge_block.png?alt=media" alt="" width="59"><figcaption></figcaption></figure>

The **Universal Bridge** block, located in the **OPAL-RT SPS Software/Power Electronics** library, implements a universal three-phase power converter that consists of up to six power switches connected in a bridge configuration. The type of power switch and converter configuration are selectable from the dialog box.

The Universal Bridge block allows simulation of converters using both naturally commutated (or line-commutated) power electronic devices (diodes or thyristors) and forced-commutated devices (GTO, IGBT, MOSFET).

The Universal Bridge block is the basic block for building two-level voltage-sourced converters (VSC).

The device numbering is different if the power electronic devices are naturally commutated or forced-commutated. For a naturally commutated three-phase converter (diode and thyristor), numbering follows the natural order of commutation.

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-e4f113e2e78caf7af8e752a058cdb7e209250989%2Funiversal_bridge_3P_model.png?alt=media" alt=""><figcaption></figcaption></figure>

For the case of a two-phase diode or thyristor bridge, and for any other bridge configuration, the order of commutation is the following:

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-50a8fa2cbfac0b277196c51394e06dc22554a53f%2Funiversal_bridge_2P_model.png?alt=media" alt=""><figcaption></figcaption></figure>

GTO-Diode bridge:

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-c9069d8900fd2520f29d7c71b656e1f949098de4%2Funiversal_bridge_GTO_diode_model.png?alt=media" alt=""><figcaption></figcaption></figure>

IGBT-Diode bridge:

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-d57e8ad87d351c30ba44c692bbd0c294191230f1%2Funiversal_bridge_IGBT_diode_model.png?alt=media" alt=""><figcaption></figcaption></figure>

MOSFET-Diode and Ideal Switch bridges:

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-98f01e627344f91be00a12e94d066606a2b0d2e0%2Funiversal_bridge_MOSFET_diode_model.png?alt=media" alt=""><figcaption></figcaption></figure>

## Ports

### Input

<table data-header-hidden><thead><tr><th width="205"></th><th></th></tr></thead><tbody><tr><td><p><strong>g</strong> — Gate input</p><p>Simulink® signal</p></td><td>The gate input for the controlled switch devices. The pulse ordering in the vector of the gate signals corresponds to the switch number indicated in the six circuits shown in the Description section. For the diode and thyristor bridges, the pulse ordering corresponds to the natural order of commutation. For all other forced-commutated switches, pulses are sent to upper and lower switches of phases A, B, and C.<br>Depending on the topology, pulse vector of inputs g is:<br>one arm - [Q1,Q2]<br>two arms - [Q1,Q2,Q3,Q4]<br>three arms - [Q1,Q2,Q3,Q4,Q5,Q6]</td></tr></tbody></table>

### Conserving ports

<table data-header-hidden><thead><tr><th width="228">Port</th><th>Description</th></tr></thead><tbody><tr><td>A — Phase A (SPS electrical)</td><td>SPS electrical conserving port associated with phase A.</td></tr><tr><td>B — Phase B (SPS electrical)</td><td>SPS electrical conserving port associated with phase B.</td></tr><tr><td>C — Phase C (SPS electrical)</td><td>SPS electrical conserving port associated with phase C.</td></tr><tr><td>+ — Positive terminal (SPS electrical)</td><td>SPS electrical conserving port associated with the positive terminal.</td></tr><tr><td>- — Negative terminal (SPS electrical)</td><td>SPS electrical conserving port associated with the negative terminal.</td></tr></tbody></table>

## Parameters

<table data-header-hidden><thead><tr><th width="229.39996337890625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>Number of bridge arms — Number of bridge arms (1 (default) | 2 | 3)</td><td>Set to 1 or 2 to get a single-phase converter (two or four switching devices). Set to 3 to get a three-phase converter connected in Graetz bridge configuration (six switching devices). Default is 3.</td></tr><tr><td>Snubber resistance Rs (Ohms) — Snubber resistance (1e5 (default))</td><td>The snubber resistance, in ohms (Ω). Default is 1e5. Set the Snubber resistance Rs parameter to inf to eliminate the snubbers from the model.</td></tr><tr><td>Snubber capacitance Cs (F) — Snubber capacitance (inf (default))</td><td>The snubber capacitance, in farads (F). Default is inf. Set the Snubber capacitance Cs parameter to 0 to eliminate the snubbers, or to inf to get a resistive snubber. When using the continuous solver you can eliminate snubbers in all power electronic devices if you select the "Disable snubbers in switching devices" option in the Preference tab of the Powergui block. When your system is discretized, you can simulate power electronic devices with virtually no snubbers by specifying purely resistive snubbers with a very large resistance, thus producing negligible leakage currents. The bridge operates satisfactorily with purely resistive snubbers.</td></tr><tr><td>Power Electronic device — Type of power electronic device (Diodes (default) | Thyristors | GTO / Diodes | MOSFET / Diodes | IGBT / Diodes | Ideal Switches | Switching-function based VSC | Average-model based VSC)</td><td>Select the type of power electronic device to use in the bridge. Default is Thyristors. When you select Switching-function based VSC, a switching-function voltage source converter type equivalent model is used, where switches are replaced by two voltage sources on the AC side and a current source on the DC side. This model uses the same firing pulses as for other power electronic devices and it correctly represents harmonics normally generated by the bridge. When you select Average-model based VSC, an average-model type of voltage source converter is used to represent the power-electronic switches. Unlike the other power electronic devices, this model uses the reference signals (uref) representing the average voltages generated at the ABC terminals of the bridge. This model does not represent harmonics. It can be used with larger sample times while preserving the average voltage dynamics. See power_sfavg for an example comparing these two models to an Universal Bridge block using IGBT/Diode device.</td></tr><tr><td>Ron (Ohms) — Internal resistance (1e-3 (default))</td><td>Internal resistance of the selected device, in ohms (Ω). Default is 1e-3.</td></tr><tr><td>Lon (H) — Internal inductance (0 (default))</td><td>Internal inductance, in henries (H), for the diode or the thyristor device. Default is 0. When the bridge is discretized, the Lon parameter must be set to zero.</td></tr><tr><td>Forward voltages [ Device Vf(V) , Diode Vfd(V) ] — Forward voltages ([ 0 0 ] (default))</td><td>This parameter is available when the selected Power electronic device is GTO/Diodes or IGBT/Diodes. Forward voltages, in volts (V), of the forced-commutated devices (GTO, MOSFET, or IGBT) and of the antiparallel diodes. Default is [ 0 0 ].</td></tr><tr><td>Forward voltage Vf (V) — Forward voltage across the device (0 (default))</td><td>This parameter is available only when the selected Power electronic device is Diodes or Thyristors. Forward voltage, in volts (V), across the device when it is conducting. Default is 0.</td></tr><tr><td>Measurements — Measurement type (None (default) | Device voltages | Device currents | UAB UBC UCA UDC voltages | All voltages and currents)</td><td>Default is None. Select Device voltages to measure the voltages across the six power electronic device terminals. Select Device currents to measure the currents flowing through the six power electronic devices. If antiparallel diodes are used, the measured current is the total current in the forced-commutated device (GTO, MOSFET, or IGBT) and in the antiparallel diode. A positive current therefore indicates a current flowing in the forced-commutated device and a negative current indicates a current flowing in the diode. If snubber devices are defined, the measured currents are the ones flowing through the power electronic devices only. Select UAB UBC UCA UDC voltages to measure the terminal voltages (AC and DC) of the Universal Bridge block. Select All voltages and currents to measure all voltages and currents defined for the Universal Bridge block. Place a Multimeter block in your model to display the selected measurements during the simulation.</td></tr></tbody></table>

In the Available Measurements menu of the Multimeter block, the measurement is identified by a label followed by the block name.

| Device voltages   | Usw1: |
| ----------------- | ----- |
| Branch current    | Isw1: |
| Terminal voltages | Uab:  |

## Example <a href="#model-examples" id="model-examples"></a>

The operation of an [AC/DC/AC Converter](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/power-converters/ac-dc-ac-converter.md)


---

# 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/smart-power-simulation-software-sps/blocks-functions-tools/power-converters/switches/universal-bridge.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.
