> 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/pe-add-on-opal-rt/model-in-schematic-editor/optimize-the-ehs-circuit/connect-gen-5-tsb-blocks-correctly.md).

# Connect Gen 5 TSB Blocks Correctly

## Overview

**Gen 5** introduces **Time-Stamped Bridge (TSB)** technology for improved switching accuracy and support for high-frequency power electronics applications. TSB technology is used by the following blocks:

* Half-Bridge Converter
* 3-Level NPC Arm
* 3-Level T-Type Arm
* Single-Phase Cycloconverter

To obtain accurate and stable simulation results, these blocks must be connected according to fundamental source interconnection rules. Certain circuit topologies may otherwise produce degraded accuracy or unstable behavior.

## Voltage and current source fundamentals

Static power converters are used to transfer, adapt, or transform electrical energy between sources and loads. Understanding the nature of the devices connected to a converter is essential when using TSB blocks.

Sources can be classified into two categories:

**Voltage sources**: A block behaves as a **voltage source** when the voltage across its terminals cannot change instantaneously.

A voltage source has an **instantaneous impedance of zero**.

**Current sources**: A block behaves as a **current source** when the current flowing through it cannot change instantaneously.

A current source has an **instantaneous impedance of infinity**.

## Modifying source behavior

The electrical nature of a circuit can be modified by adding energy storage elements:

* Adding an **inductor in series** with a voltage source makes it behave like a current source.
* Adding a **capacitor in parallel** with a current source makes it behave like a voltage source.

These techniques can be used to create valid connections when faced with source interconnection constraints.

## Source connection rules

The following rules should always be respected:

* A **voltage source** must never be **short-circuited**, but may be **open-circuited**.
* A **current source** must never be **open-circuited**, but may be **short-circuited**.

As a result:

* Two **voltage sources** should not be connected in **parallel**.
* Two **current sources** should not be connected in **series**.

Violating these rules can lead to poor simulation accuracy, numerical instability, or invalid circuit configurations.

## Applying these rules to TSB blocks

TSB blocks exhibit specific source behaviors at their terminals.

Depending on the topology and the connected network, some interconnections may violate the source connection rules described above. Although the circuit may compile and execute, the resulting behavior may be inaccurate or unstable.

When designing circuits with TSB blocks:

* Identify whether the surrounding network behaves as a voltage source or current source.
* Verify that source connection rules are respected at each TSB terminal.
* Modify the surrounding network when necessary using capacitors or inductors to change the effective source behavior.

## Cycloconverter considerations

The **Single-Phase Cycloconverter** requires special attention.

Unlike an ideal cycloconverter, the current Gen 5 implementation is **asymmetrical**. As a result, the two ports are not interchangeable and may behave differently depending on the connected circuits.

When using a cycloconverter:

* Do not assume both ports have identical behavior.
* Review the source nature of each connected network.
* Validate the topology carefully before running simulations.

## Signs of improper TSB connections

Incorrect source interconnections may result in:

* Reduced simulation accuracy
* Excessive switching oscillations
* Numerical instability
* Unexpected converter behavior
* Difficulty achieving the desired time step

If such behavior is observed, review the source nature of the networks connected to the TSB blocks and verify compliance with the source connection rules.


---

# 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/pe-add-on-opal-rt/model-in-schematic-editor/optimize-the-ehs-circuit/connect-gen-5-tsb-blocks-correctly.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.
