> 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/four-quadrant-chopper-dc-drive.md).

# Four-Quadrant Chopper 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-572e651cf31d73e4d7af4cd7991256b39cda1c5b%2FDC7_block.png?alt=media" alt=""><figcaption></figcaption></figure>

The **Four-Quadrant Chopper DC Drive** block, located in the **OPAL-RT SPS Software/Electrical Machines/Control/DC Drives** library, commonly called the **DC7 motor drive**, models a four-quadrant, DC-supplied, chopper (or DC-DC PWM converter) drive for DC motors. This drive features closed-loop speed control with four-quadrant operation. The speed control loop outputs the reference armature current of the machine. Using a PI current controller, the chopper duty cycle corresponding to the commanded armature current is derived. This duty cycle is then compared with a sawtooth carrier signal to obtain the required PWM signals for the chopper.

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). In addition, due to the use of high switching frequency DC-DC converters, a lower armature current ripple (compared with thyristor-based DC drives) is obtained. However, four switching devices 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-f275e009b60dcf89224b30ab5fb9b6b9f5207fa3%2FDC7_model_schem.png?alt=media" alt=""><figcaption></figcaption></figure>

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

* Speed Controller (DC)
* Regulation Switch
* Current Controller (DC)
* Chopper

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 an IGBT converter controlled by two PI regulators. The converter is fed by a constant DC voltage source. Armature current oscillations are reduced by a smoothing inductance connected in series with the armature circuit.

The model is discrete. Good simulation results have been obtained with a 1-µs time step. In order to simulate a digital controller device, the control system has two different sampling times:

* The speed controller sampling time
* The current controller sampling time

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

The library contains a 5 hp and a 200-hp drive parameter set. The specifications of these two drives are shown in the following table.

**5 HP and 200 HP Drive Specifications**

|                          | 5 HP Drive                                              | 200 HP Drive                                              |
| ------------------------ | ------------------------------------------------------- | --------------------------------------------------------- |
| **Drive Input Voltage**  | Amplitude: 280 V                                        | Amplitude: 550 V                                          |
| **Motor Nominal Values** | <p>Power: 5 hp<br>Speed: 1750 rpm<br>Voltage: 240 V</p> | <p>Power: 200 hp<br>Speed: 1184 rpm<br>Voltage: 440 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.</p><p>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 of the Fundamental Blocks (powerlib) library.

### Converter Tab <a href="#converter-tab" id="converter-tab"></a>

#### **Smoothing Inductance and Excitation Circuit Section**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Smoothing inductance</strong></td><td>The smoothing inductance value (H). Default is 10e-3.</td></tr><tr><td><strong>Field DC source</strong></td><td>The DC motor field voltage value (V). Default is 150.</td></tr></tbody></table>

#### **IGBT/Diode Device Section**

The **IGBT/Diode device** section of the **Converter** tab displays the parameters of the Universal Bridge block of the Fundamental Blocks (powerlib) library. 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.

### 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>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 1750.</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>Sampling time</strong></td><td>The speed controller sampling time (s). This sampling time has to be a multiple of the current controller sampling time and of the simulation time step. Default is 100e-6.</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>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>PWM switching frequency</strong></td><td>The switching frequency of the four IGBT devices (Hz). Default is 5e3.</td></tr><tr><td><strong>Sampling time</strong></td><td>The current controller sampling time (s). This sampling time has to be a submultiple of the speed controller sampling time and a multiple of the simulation time step. Default is 20e-6.</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 200*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>

### 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>Vcc, Gnd</strong></td><td>The DC voltage source electric connections. The 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>The motor measurement vector. This vector 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>The IGBT/Diode device measurement vector. This vector includes the converter output voltage. The output current is not included since it is equal to the DC motor armature current. Note that all current and voltage values of the converter can be visualized with the Multimeter block.</td></tr><tr><td><strong>Ctrl*</strong></td><td><p>The controller measurement vector. This vector contains:</p><ul><li>The armature current reference</li><li>The duty cycle of the PWM pulses</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 [DC7 - Four-Quadrant Chopper 200 HP DC Drive](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/motor-drives/dc-drives/dc7-four-quadrant-chopper-200-hp-dc-drive.md) (dc7\_example) example illustrates the four-quadrant chopper drive used with the 200-hp drive parameter set during speed regulation.

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

\[1] Boldea, Ion, and S.A. Nasar, *Electric Drives*, CRC Press LLC, 1999.

\[1] Séguier, Guy, *Electronique de puissance*, Dunod, 1999.


---

# 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/four-quadrant-chopper-dc-drive.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.
