> 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/machines/blocks/machines-control/dc-drives/page-2.md).

# Four-Quadrant Single-Phase Rectifier DC Drive

## Description <a href="#description" id="description"></a>

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

The **Four-Quadrant Single-Phase Rectifier DC Drive** block, located in the **OPAL-RT SPS Software/Electrical Machines/Control/DC Drives** library, commonly called the **DC2 motor drive**, represents a four-quadrant, single-phase, thyristor-based (or phase controlled) drive for DC motors. This drive features closed-loop speed control with two anti-paralleled single-phase thyristor rectifiers. The anti-parallel rectifiers operate in circulating current mode with the help of circulating current inductors. The speed control loop outputs the reference armature current of the machine. Using a PI current controller, the thyristor firing angles (for the two rectifiers) corresponding to the commanded armature current are derived. These firing angles are then used to obtain the required gate signals for the rectifiers through a thyristor bridge firing unit.

The main advantage of this drive, compared with other DC drives, is that it can operate in all four quadrants (forward motoring, reverse regeneration, reverse motoring, and forward regeneration). However, two anti-paralleled converters along with circulating current inductors are required, which increases the complexity of the drive system.

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

The Four-Quadrant Single-Phase Rectifier DC Drive block uses these blocks from the Electric Drives/Fundamental Drive Blocks library:

* Speed Controller (DC)
* Regulation Switch
* Current Controller
* Bridge Firing Unit (DC)

The machine is separately excited with a constant DC field voltage source. There is thus no field voltage control. By default, the field current is set to its steady-state value when a simulation is started.

The armature voltage is provided by two single-phase antiparallel-connected converters controlled by two PI regulators. The circulating current produced by the instantaneous voltage difference at the terminal of both converters is limited by inductors connected between these terminals. Armature current oscillations are reduced by a smoothing inductance connected in series with the armature circuit.

The average-value converter represents the average behavior of a single-phase rectifier for continuous armature current in a dual-converter topology. This model is thus not suitable for simulating DC drives under discontinuous armature current conditions. The converter outputs a continuous voltage value equal to the average-value of the real-life rectified voltage. The armature voltage, armature current, and electromagnetic torque ripples are thus not represented. The input currents have the frequency and amplitude of the fundamental current component of the real-life input currents.

The model is discrete. Good simulation results have been obtained with a 4-µs time step. The control system (speed and current controllers) samples data following a user-defined sample time in order to simulate a digital controller device. Keep in mind that this sampling time has to be a multiple of the simulation time step.

The average-value converter allows the use of bigger simulation time steps since it does not generate small time constants (due to the RC snubbers) inherent to the detailed converter. For a controller sampling time of 100-µs, good simulation results have been obtained for a simulation time step of 100 µs. This time step cannot be higher than the controller time step.

### Model Specifications <a href="#model-specifications" id="model-specifications"></a>

The library contains a 5-hp drive parameter set. The specifications of the 5-hp drive are shown in the following table.

**5 HP Drive Specifications**

|                          | 5 HP                                                    |
| ------------------------ | ------------------------------------------------------- |
| **Drive Input Voltage**  | <p>Amplitude: 320 V<br>Frequency: 60 Hz</p>             |
| **Motor Nominal Values** | <p>Power: 5 HP<br>Speed: 1750 rpm<br>Voltage: 240 V</p> |

## Parameters <a href="#parameters" id="parameters"></a>

#### General <a href="#general" id="general"></a>

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Output bus mode</strong></td><td>Select how the output variables are organized.<br>If you select <strong>Multiple output buses</strong> (default), the block has three separate output buses for motor, converter, and controller variables.<br>If you select <strong>Single output bus</strong>, all variables output on a single bus.</td></tr><tr><td><strong>Model detail level</strong></td><td>Select between the <strong>detailed</strong> and the <strong>average-value</strong> inverter. Default is Detailed.</td></tr><tr><td><strong>Mechanical input</strong></td><td><p>Select between the load torque, the motor speed and the mechanical rotational port as mechanical input. Default is Torque Tm.</p><p>If you select and apply a <strong>load torque</strong>, the output is the motor speed according to the following differential equation that describes the mechanical system dynamics:</p><p><span class="math">T_e=J\frac{d}{dt}\omega_r+F\omega_r+T_m \\[4pt]</span></p><p>This mechanical system is included in the motor model.</p><p>If you select the <strong>motor speed</strong> as mechanical input, then you get the electromagnetic torque as output, allowing you to represent externally the mechanical system dynamics. The internal mechanical system is not used with this mechanical input selection and the inertia and viscous friction parameters are not displayed.</p><p>For the <strong>mechanical rotational port</strong>, the connection port S counts for the mechanical input and output. It allows a direct connection to the Simscape environment. The mechanical system of the motor is also included in the drive and is based on the same differential equation.<br>See <a href="https://www.opal-rt.com/docs/smart-power-simulation-software-sps/library-specific-guides/motor-drives/mechanical-coupling-of-two-motor-drives.md">Mechanical Coupling of Two Motor Drives.</a></p></td></tr><tr><td><strong>Use signal names as labels</strong></td><td><p>When you select this check box, the <strong>Motor</strong>, <strong>Conv</strong>, and <strong>Ctrl</strong> measurement outputs use the signal names to identify the bus labels. Select this option for applications that require bus signal labels to have only alphanumeric characters.</p><p>When this check box is cleared (default), the measurement output uses the signal definition to identify the bus labels. The labels contain non-alphanumeric characters that are incompatible with some Simulink® applications.</p></td></tr></tbody></table>

### DC Machine Tab <a href="#dc-machine-tab" id="dc-machine-tab"></a>

The **DC Machine** tab displays the parameters of the DC Machine block.

### Converters Tab <a href="#converters-tab" id="converters-tab"></a>

#### **DC Bus and Excitation Circuit Section**

| **Smoothing inductance**          | The smoothing inductance value (H). Default is 50e-3.                      |
| --------------------------------- | -------------------------------------------------------------------------- |
| **Field DC source**               | The DC motor field voltage value (V). Default is 150.                      |
| **Circulating current inductors** | The four circulating current inductors inductance value (H). Default is 0. |

**Converter Sections**

The Converter 1 and Converter 2 sections of the Converter tab display the parameters of the Universal Bridge block. For more information on the Universal Bridge block parameters, refer to the [Universal Bridge](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/power-converters/switches/universal-bridge.md) block page.

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>RMS voltage</strong></td><td>RMS voltage of the single-phase voltage source connected to the A+,A− terminals of the drive (V). This parameter is not used when using the detailed rectifier. Default is 460.</td></tr><tr><td><strong>Frequency</strong></td><td>Frequency of the single-phase voltage source connected to the A+,A− terminals of the drive (Hz). This parameter is not used when using the detailed rectifier. Default is 60.</td></tr><tr><td><strong>Source inductance</strong></td><td>Source inductance of the single-phase voltage source connected to the A+,A− terminals of the drive (H). This parameter is not used when using the detailed rectifier. Default is 0.1e-3.</td></tr><tr><td><strong>Phase angle</strong></td><td>Phase angle of the single-phase voltage source connected to the A+,A− terminals of the drive (deg.). This parameter is not used when using the detailed rectifier. Default is 0.</td></tr></tbody></table>

### Controller Tab <a href="#controller-tab" id="controller-tab"></a>

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Regulation type</strong></td><td>This pop-up menu allows you to choose between speed and torque regulation. Default is Speed regulation.</td></tr><tr><td><strong>Sampling time (s)</strong></td><td>The controller (speed and current) sampling time (s). The sampling time has to be a multiple of the simulation time step.<br>Default is 20e-6.</td></tr><tr><td><strong>Schematic</strong></td><td>When you click this button, a diagram illustrating the speed and current controllers schematics appears.</td></tr></tbody></table>

#### **Controller — Speed Controller Subtab**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Nominal speed</strong></td><td>The nominal speed value of the DC motor (rpm). This value is used to convert motor speed from rpm to pu (per unit). Default is <code>1750</code>.</td></tr><tr><td><strong>Initial speed reference</strong></td><td>The initial speed reference value (rpm). This value allows the user to start a simulation with a speed reference other than 0 rpm. Default is 0.</td></tr><tr><td><strong>Low-pass filter cutoff frequency</strong></td><td>Cutoff frequency of the low-pass filter used to filter the motor speed measurement (Hz). Default is 40.</td></tr><tr><td><strong>Proportional gain</strong></td><td>The proportional gain of the PI speed controller. Default is 10.</td></tr><tr><td><strong>Integral gain</strong></td><td>The integral gain of the PI speed controller. Default is 50.</td></tr><tr><td><strong>Acceleration</strong></td><td>The maximum change of speed allowed during motor acceleration (rpm/s). Too great a value can cause armature over-current. Default is 1000.</td></tr><tr><td><strong>Deceleration</strong></td><td>The maximum change of speed allowed during motor deceleration (rpm/s). Too great a value can cause armature over-current. Default is -1000.</td></tr></tbody></table>

#### **Controller — Current Controller Subtab**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Low-pass filter cutoff frequency</strong></td><td>Cutoff frequency of the low-pass filter used to filter the armature current measurement (Hz). Default is 500.</td></tr><tr><td><strong>Symmetrical reference limit</strong></td><td>Symmetrical current reference (pu) limit around 0 pu. 1.5 pu is a common value. Default is 1.5.</td></tr><tr><td><strong>Power and Voltage nominal values</strong></td><td>The DC motor nominal power (W) and voltage (V) values. These values are used to convert armature current from amperes to pu (per unit).<br>Default for <strong>Power</strong> is 5*746 and for <strong>Voltage</strong> is 440.</td></tr><tr><td><strong>Proportional gain</strong></td><td>The proportional gain of the PI current controller. Default is 2.</td></tr><tr><td><strong>Integral gain</strong></td><td>The integral gain of the PI current controller. Default is 200.</td></tr></tbody></table>

#### **Controller — Bridge Firing Unit Subtab**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Alpha min</strong></td><td>Minimum firing angle value (deg.). 20 degrees is a common value. Default is 20.</td></tr><tr><td><strong>Alpha max</strong></td><td>Maximum firing angle value (deg.). 160 degrees is a common value. Default is 160.</td></tr><tr><td><strong>Frequency of synchronization voltages</strong></td><td>Frequency of the synchronization voltages used by the discrete synchronized pulse generator block (Hz). This frequency is equal to the line frequency of the single-phase power line. This parameter is not used when using the average-value converter. Default is 60.</td></tr><tr><td><strong>Pulse width</strong></td><td>The width of the pulses applied to the thyristor gates (deg.). This parameter is not used when using the average-value converter. Default is 10.</td></tr></tbody></table>

## Inputs <a href="#block-inputs-and-outputs" id="block-inputs-and-outputs"></a>

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>SP</strong></td><td>The speed or torque set point. The speed set point can be a step function, but the speed change rate will follow the acceleration / deceleration ramps. If the load torque and the speed have opposite signs, the accelerating torque will be the sum of the electromagnetic and load torques.</td></tr><tr><td><strong>Tm</strong> or <strong>Wm</strong></td><td>The mechanical input: load torque (Tm) or motor speed (Wm). For the mechanical rotational port (S), this input is deleted.</td></tr><tr><td><strong>A+, A-</strong></td><td>The single-phase electric connections. The applied voltage must be adequate for the motor size.</td></tr></tbody></table>

## Outputs

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Wm</strong>, <strong>Te</strong> or <strong>S</strong></td><td>The mechanical output: motor speed (Wm), electromagnetic torque (Te) or mechanical rotational port (S).</td></tr><tr><td><strong>Motor*</strong></td><td><p>If <strong>Output bus mode</strong> parameter is set to <strong>Multiple output buses</strong><br>The motor measurement vector. It is composed of two elements:</p><ul><li>The armature voltage</li><li>The DC motor measurement vector (containing the speed, armature current, field current, and electromagnetic torque values). Note that the speed signal is converted from rad/s to rpm before output.</li></ul></td></tr><tr><td><strong>Conv*</strong></td><td><p>If <strong>Output bus mode</strong> parameter is set to <strong>Multiple output buses</strong><br>The single-phase converter measurement vector. This vector includes</p><ul><li>The output voltage of converter 1</li><li>The output voltage of converter 2</li><li>The output current of converter 1</li><li>The output current of converter 2 Note that all current and voltage values of the detailed bridges can be visualized with the Multimeter block.</li></ul></td></tr><tr><td><strong>Ctrl*</strong></td><td><p>If <strong>Output bus mode</strong> parameter is set to <strong>Multiple output buses</strong><br>The controller measurement vector. This vector contains:</p><ul><li>The armature current reference</li><li>The firing angle computed by the current controller</li><li>The speed or torque error (difference between the speed reference ramp and actual speed or between the torque reference and actual torque)</li><li>The speed reference ramp or torque reference</li></ul></td></tr></tbody></table>

**\*** When the **Output bus mode** parameter is set to **Single output bus**, the block groups the Motor, Conv, and Ctrl outputs into a single bus output.

## Examples <a href="#examples" id="examples"></a>

The [DC2 - Four-Quadrant Single-Phase Rectifier 5 HP DC Drive](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/motor-drives/dc-drives/dc2-four-quadrant-single-phase-rectifier-5-hp-dc-drive.md) (dc2\_example) example illustrates the single-phase dual-converter drive used with the 5-hp drive parameter set during speed regulation.

## References <a href="#references" id="references"></a>

\[1] Sen, P.C., *Thyristor DC Drives*, J.Wiley and Sons, 1981.


---

# 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/machines/blocks/machines-control/dc-drives/page-2.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.
