> 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/cccv-battery-charger.md).

# CCCV Battery Charger

## Description

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

The **CCCV Battery Charger block**, located in the **OPAL-RT SPS Software/Renewables** library, implements a generic dynamic model battery charger.

This model supports three-phase wye or delta AC, one-phase AC, or DC voltage input.

The model also provides an optional ambient temperature input for charging voltage temperature compensation.

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-248a0c7b597c0fc4c90215c1e4009e815bfb7849%2FCCCV_battery_charger_model.png?alt=media" alt=""><figcaption><p>Equivalent circuit for the CCCV Battery Charger block</p></figcaption></figure>

### Equations

#### **Output characteristics**

The output current of the battery charger is

$$
I\_{out}
========

# f\_1 \left( I\_{out}^{\ast},, k\_p,, k\_i,, k\_d,, I\_{out,%},, f\_{out,r},, t \right)

I\_{out}^{\ast} \frac{k\_i}{k\_d s^{2} + k\_p s + k\_i}
\+
\frac{I\_{out,%}}{100}
\sin!\left( 2\pi f\_{out,r}, t \right)
\\\[8pt]
$$

Variables for the output current and related equations are:

* *I*<sub>*out*</sub> is the output current command, in A.
* *I'*<sub>*out*</sub> is the pre-filtered current command, in A.
* *k*<sub>*p*</sub> is the PID filter proportional gain.
* *k*<sub>*i*</sub> is the PID filter integral gain.
* *k*<sub>*d*</sub> is the PID filter differential gain.
* *I*<sub>*outr%*</sub> is the current output ripple, in %.
* *f*<sub>*outir*</sub> is the current output ripple frequency, in Hz.
* *t* is the time, in s.
* *ξ* is the dampening factor, which is limited to values between 0 and 0.9.
* *⍵*<sub>*n*</sub> is the is radian frequency, in rad/s.
* *d*<sub>*%*</sub> is the overshoot, in %.
* *t*<sub>*s*</sub> is the settling time, in s.
* *I*<sub>*CC*</sub> is the pre-filtered current regulated current command, in A.
* *I*<sub>*bulk*</sub> is the constant current command, in A.
* *I*<sub>*CV*</sub> is the pre-filtered voltage regulated current command, in A.
* *V'*<sub>*out*</sub> is the voltage command, in V.
* *V'*<sub>*tc*</sub> is the voltage command, in V.
* *V*<sub>*out*</sub> is the temperature compensated voltage effect, in V.
* Vout¯ is the mean measured output voltage, in V.
* *T*<sub>*a*</sub> is the ambient temperature, in °C .
* *T*<sub>*nom*</sub> is the nominal ambient temperature, in °C.
* *V*<sub>*tc*</sub> is the voltage compensation ratio, in V/°C.
* *V*<sub>*abs*</sub> is the absorption voltage, in V.
* *V*<sub>*float*</sub> is the float voltage, in V.
* \_P\_is the output power, in W.
* Iout¯ is the mean measured output current, in A.

The control gains are:

$$
k\_d = 1 \\\[8pt]
k\_p = 2 \xi \omega\_n \\\[8pt]
k\_i = \omega\_n^{2} \\\[8pt]
$$

The dampening factor is

$$
\xi = -\frac{\ln\left(\dfrac{d}{100}\right)}
{\sqrt{\pi^{2} + \left\[\ln\left(\dfrac{d}{100}\right)\right]^{2}}}
\\\[8pt]
$$

When the output control is current regulated the radian frequency is

$$
\omega\_n = \frac{-\log(0.02)}{t\_s \xi} \\\[8pt]
$$

When the output control is voltage regulated the radian frequency is

$$
\omega\_n = \frac{-\log(0.001)}{\xi} \\\[8pt]
$$

The pre-filtered current command, *I'*<sub>*out*</sub>, is provided either from the pre-filtered current regulated current command, *I*<sub>*CC*</sub>, or from the pre-filtered voltage regulated current command, *I*<sub>*CV*</sub>. The graphs show the different charging cycle phases.

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

If the **Output control mode** is set to Constant Current only (CC) or Constant Current - Constant Voltage (CCCV) and *V*<sub>*out*</sub> is lower than **Float voltage** or **Absorption voltage**, while the **Absorption end condition** isn’t met

$$
I\_{out}^{\ast} = I\_{CC} = I\_{bulk} \\\[8pt]
$$

If the **Output control mode** is set to Constant Current only (CC) or Constant Current - Constant Voltage (CCCV) and *V*<sub>*out*</sub> is equal to the **Float voltage** or **Absorption voltage**, while the **Absorption end condition** isn’t met

$$
I\_{out}^{\ast}
===============

# I\_{CV}

\frac{(V\_{out}^{\ast} + V'*{tc}), I*{out}}
{V\_{out}}
\\\[8pt]
$$

When the **Enable absorption phase**option is selected and the battery charger switches from constant current to constant voltage control, if the **Absorption end condition** is not met, the ambient temperature voltage compensation, *V'*<sub>*tc*</sub> is defined as

$$
V'*{tc} = (T\_a - T*{nom}), V\_{tc} \\\[8pt]
$$

Otherwise, the ambient temperature voltage compensation, *V'*<sub>*tc*</sub> is defined as

$$
V'\_{tc} = 0 \\\[8pt]
$$

When the **Enable absorption phase** option is selected and the battery charger switches from constant current to constant voltage control, if the **Absorption end condition** is not met, the ambient temperature voltage compensation, *V'*<sub>*out*</sub> is defined as

$$
V\_{out}^{\ast} = V\_{abs} \\\[8pt]
$$

Otherwise, the ambient temperature voltage compensation, *V'*<sub>*out*</sub> is defined as

$$
V\_{out}^{\ast} = V\_{float} \\\[8pt]
$$

The output power is defined as

$$
P = \overline{V\_{out}, I\_{out}} \\\[8pt]
$$

#### **Input characteristics**

The input current of the battery charger is

$$
I\_{in}
=======

f\_2!\left(
P^{\ast},
f\_{eff}(P^{\ast}),
f\_{THD}(P^{\ast}),
f\_{PF}(P^{\ast}),
f\_{HARMS}
\right)
\\\[8pt]
$$

Variables for the input current and related equations are:

* *I*<sub>*in*</sub> is the input current command, in A.
* *P'* is the normalized output power.
* *P* is the output power, in W.
* *P*<sub>*nom*</sub> is the nominal output power, in W.
* *I'*<sub>*n*</sub> is the normalized harmonic amplitude.
* *f*<sub>*in*</sub> is the input voltage frequency, in Hz.
* *f*<sub>*n*</sub> is the harmonic frequency, in Hz.
* *t* is the time, in s.
* *V*<sub>*inA*</sub> is the input voltage delayed by the fifth of its period, in V.
* *V*<sub>*in*</sub> is the input voltage of phase A delayed by the fifth of its period, in V.
* *I*<sub>*inr%*</sub> is the input current ripple, in %.
* *f*<sub>*inir*</sub> is the input current ripple frequency, in Hz.
* *θ*<sub>*Vin*</sub> is the input voltage angle, in rad.
* *θ*<sub>*VinA*</sub> is the input voltage angle of phase A, in rad.

$$
P^{\ast} = \frac{P}{P\_{nom}} \\\[8pt]
$$

Where, *f*<sub>*eff*</sub>, is a polynomial function following the parameters **Charger efficiency** and **Efficiency usage factor**.

This polynomial order is half of the number of data pairs entered. For input values of, *P'*, between 0 and 1, the polynomial must return values between 0 and 1. Otherwise, the polynomial order is reduced until this condition is met.

If the order reaches 0, the output will remain constant for the mean value of the dataset.

Where, *f*<sub>*THD*</sub>, is a polynomial function following the parameters **Total harmonic distortion** and **THD usage factor**.

This polynomial order is half of the number of data pairs entered. For input values of, *P'*, between 0 and 1, the polynomial must return values between 0 and 1.

Otherwise, the polynomial order is reduced until this condition is met. If the order reaches 0, the output will remain constant for the mean value of the dataset.

Where, *f*<sub>*PF*</sub>, is a polynomial function following the parameters **Power factor** and **PF usage facto**r. This polynomial order is half of the number of data pairs entered. For input values of, *P'*, between 0 and 1, the polynomial must return values between 0 and 1.

Otherwise, the polynomial order is reduced until this condition is met. If the order reaches 0, the output will remain constant for the mean value of the dataset.

Where, *f*<sub>*HARMS*</sub>, is the sum of sine waves specified with the parameters **Harmonics amplitude** and **Harmonics frequency** following the expression

$$
f\_{HARMS}
==========

\sum I\_{n}^{\ast} \sin(2\pi f\_{n} t)
\\\[8pt]
$$

When the **Type** parameter is set to DC,

$$
I\_{in}
=======

\frac{P^{\ast}}{f\_{eff} V\_{in}}
\+
I\_{in,%} \sin(2\pi f\_{out,r} t)
\\\[8pt]
$$

When the **Type** parameter is set to 1-phase AC ,

$$
I\_{in}
=======

\frac{\sqrt{2} P^{\ast}}{f\_{eff} f\_{PF} V\_{in}}
\left(
f\_{THD} f\_{HARMS}
\+
\sin(\theta\_{V\_{in}} - \arccos(f\_{PF}))
\right)
\\\[8pt]
$$

When the **Type** parameter is set to 3-phase AC (wye) :

$$
I\_{inA}
========

\frac{\sqrt{2} P^{\ast}}{3 f\_{eff} f\_{PF} V\_{in\Delta}}
\left(
f\_{THD} f\_{HARMS}^{\ast}
\+
\sin(\theta\_{V\_{inA}} - \arccos(f\_{PF}))
\right)
\\\[8pt]
I\_{inB}
========

\frac{\sqrt{2} P^{\ast}}{3 f\_{eff} f\_{PF} V\_{in\Delta}}
\left(
f\_{THD} f\_{HARMS}^{\ast}
\+
\sin!\left(\theta\_{V\_{inA}} - \arccos(f\_{PF}) + \frac{1}{3 f\_{in}}\right)
\right)
\\\[8pt]

# I\_{inC}

\frac{\sqrt{2} P^{\ast}}{3 f\_{eff} f\_{PF} V\_{in\Delta}}
\left(
f\_{THD} f\_{HARMS}^{\ast}
\+
\sin!\left(\theta\_{V\_{inA}} - \arccos(f\_{PF}) + \frac{2}{3 f\_{in}}\right)
\right)
\\\[8pt]
$$

When the **Type** parameter is set to 3-phase AC (delta) :

$$
I\_{inA}
========

\frac{\sqrt{2} P^{\ast}}{3 f\_{eff} f\_{PF} V\_{in\Delta}}
\left(
\frac{1}{3} f\_{THD} f\_{HARMS}^{\prime}
\+
\frac{1}{\sqrt{3}}
\sin!\left(\theta\_{V\_{inA}} + \frac{\pi}{6} - \arccos(f\_{PF})\right)
\right)
\\\[8pt]

# I\_{inB}

\frac{\sqrt{2} P^{\ast}}{3 f\_{eff} f\_{PF} V\_{in\Delta}}
\left(
\frac{1}{3} f\_{THD} f\_{HARMS}^{\prime\prime}
\+
\frac{1}{\sqrt{3}}
\sin!\left(\theta\_{V\_{inA}} + \frac{\pi}{6} - \arccos(f\_{PF}) + \frac{1}{3 f\_{in}}\right)
\right)
\\\[8pt]
$$

Where:

$$
f\_{THD} f\_{HARMS}^{\prime}
============================

## f\_{THD} f\_{HARMS}(\omega t)

f\_{THD} f\_{HARMS}!\left(\omega t + \frac{1}{3 f\_{in}}\right)
\\\[8pt]

# f\_{THD} f\_{HARMS}^{\prime\prime}

## f\_{THD} f\_{HARMS}!\left(\omega t + \frac{1}{3 f\_{in}}\right)

f\_{THD} f\_{HARMS}!\left(\omega t + \frac{2}{3 f\_{in}}\right)
\\\[8pt]
$$

## Assumptions and Limitations

* The output load consists of an adequately sized battery.
* Three-phase alternative current inputs are balanced, synchronized, and without jitter.
* The ambient temperature does not affect the charger’s parameters. **Limitations**
* The output power is independent from the input power.

## Ports

### Input

| **Ta** — Ambient temperature scalar | Ambient temperature supplied to the model. To enable this port, select the **Simulate voltage compensation** check box.                                                                                                                                                                            |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **CC** — Constant current scalar    | Signal that defines the current threshold. This port is visible only when the **Dynamic input thresholds** parameter is selected, and when the **Output control mode** parameter is set to Constant Current - Constant Voltage or to Constant Current only.                                        |
| **CV** — Constant voltage vector    | <p>Signal that defines the voltage threshold.</p><p>This port is visible only when the <strong>Dynamic input thresholds</strong> parameter is selected, and when the <strong>Output control mode</strong> parameter is set to Constant Current - Constant Voltage or to Constant Voltage only.</p> |

### Output

| **m** — Mode scalar | <p>Simulink® output of the block specified as a vector containing eight signals.</p><p>You can demultiplex these signals by using the Bus Selector block from the Simulink library.</p> |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

<table data-header-hidden><thead><tr><th width="186.66668701171875"></th><th width="471.2220458984375"></th><th></th></tr></thead><tbody><tr><td><strong>Signal</strong></td><td><strong>Definition</strong></td><td><strong>Units</strong></td></tr><tr><td>Input Voltage</td><td>The battery charger’s input voltage</td><td>V</td></tr><tr><td>Input Current</td><td>The battery charger’s input current</td><td>A</td></tr><tr><td>Output Voltage</td><td>The battery charger’s output voltage</td><td>V</td></tr><tr><td>Output Current</td><td>The battery charger’s output current</td><td>A</td></tr><tr><td>Output Ah</td><td>The battery charger’s output <em>Ah</em>. The _Ah_is calculated as:<br><span class="math">\\[8pt]Ah = \frac{\overline{I_{out}}\, t_s}{3600}(n) + Ah(n-1) \\[8pt]</span></td><td>Ah</td></tr><tr><td>Output kWh</td><td><p>The battery charger’s output <em>kWh</em></p><p><span class="math">\\[8pt]kWh = \frac{V_{out}\, I_{out}\, t_s}{3600}(n) + Ah(n-1) \\[8pt]</span></p></td><td>kWh</td></tr><tr><td>Voltage Limit</td><td>The battery charger’s output voltage limit</td><td>V</td></tr><tr><td>Current Limit</td><td>The battery charger’s output current limit</td><td>A</td></tr></tbody></table>

### Conserving

| **A** — *a*-phase voltage scalar    | *A*-phase voltage.   |
| ----------------------------------- | -------------------- |
| **B** — *b*-phase voltage scalar    | *B*-phase voltage.   |
| **C** — *c*-phase voltage scalar    | *C*-phase voltage.   |
| **V+** — DC positive voltage scalar | Positive DC voltage. |
| **V-** — DC negative voltage scalar | Negative DC voltage. |

## Parameters

### General

<table data-header-hidden><thead><tr><th width="259.5555419921875"></th><th></th></tr></thead><tbody><tr><td><strong>Preset</strong> — Parameterization methodCustom specifications (default) | Primax P4500F-3-125-10 | Transtronic 020-0085-00</td><td><p>The parameter contains a list of two predetermined battery chargers.</p><p>The parameters in the CCCV Battery Charger block are not enabled when a preset is selected.</p></td></tr><tr><td><strong>Nominal power (W)</strong> — Nominal power1500 (default)</td><td><p>The nominal power, <em>P</em><sub><em>nom</em></sub>, of the battery charger in W.</p><p>The nominal power is used for normalized parameters <strong>Charger efficiency</strong>,** Total harmonic distortion** and <strong>Power factor</strong>.</p><p>This parameter must be greater or equal to the product of <strong>Bulk current</strong> and <strong>Float voltage</strong> or <strong>Absorption voltage</strong> if <strong>Enable absorption phase</strong> is selected.</p></td></tr></tbody></table>

### Input

<table data-header-hidden><thead><tr><th width="259.55560302734375"></th><th></th></tr></thead><tbody><tr><td><strong>Type</strong> — Input voltage type3-phases AC (wye) (default) | 3-phases AC (delta) | 1-phase AC | DC</td><td><p>Input voltage type:</p><ul><li>3-phases AC (wye) — The <strong>A</strong>, <strong>B</strong>, and <strong>C</strong> ports become visible to supply the balanced three-phase alternating current power.</li><li>3-phases AC (delta) — The <strong>A</strong>, <strong>B</strong>, and <strong>C</strong> ports become visible to supply the balanced three-phase alternating current power.</li><li>1-phases AC — The <strong>A</strong> and <strong>B</strong> ports become visible to supply the balanced single-phase alternating current power.</li><li>DC — The <strong>+</strong> and <strong>-</strong> ports become visible to supply the direct current power.</li></ul></td></tr><tr><td><strong>External neutral connection</strong> — Neutral connection option<br>cleared (default) | selected</td><td>Option to enable access to a neutral connection externally through the <strong>N</strong> port. Otherwise, the neutral is internally connected. #### Dependencies This option is enabled when the <strong>Type</strong> is set to 3-phases AC (wye).</td></tr><tr><td><strong>Effective voltage (V)</strong> — Effective voltage<br>208 (default)</td><td><p>Effective voltage, <em>V</em><sub><em>eff</em></sub>, of the battery charger power input in V.</p><p>When <strong>Type</strong> is either 3-phases AC (wye) or 3-phases AC (delta), the effective voltage must the rms line voltage.</p></td></tr><tr><td><strong>Frequency (Hz)</strong> — Frequency<br>60 (default)</td><td>Frequency, <em>f</em><sub><em>in</em></sub>, of the battery charger power input in Hz. #### Dependencies This parameter is accessible when <strong>Type</strong> is set to 3-phases AC (wye), 3-phases AC (delta), or 1-phase AC.</td></tr><tr><td><strong>Current ripple (%)</strong> — Current ripple<br>10 (default)</td><td><p>Current ripple, <em>I(</em><sub><em>inr%</em></sub><em>)</em>, of the battery charger input current.</p><p>#### Dependencies This parameter is accessible when <strong>Type</strong> is set to DC (wye).</p></td></tr><tr><td><strong>Ripple frequency (Hz)</strong> — Ripple frequency<br>1000 (default)</td><td>Ripple frequency of the battery charger input current. #### Dependencies This parameter is accessible when <strong>Type</strong> is set to DC (wye).</td></tr><tr><td><strong>Plot Curves</strong></td><td>Click to plot input parameter and input current harmonics curves for the battery charger.<br><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-4089a82a6c17b36966c67cdaf4280edba9e3a6ed%2FCCCV_battery_charger_input_param_curves.png?alt=media" alt="" data-size="original"></td></tr><tr><td><strong>Simulate efficiency</strong> — Efficiency simulation option<br>cleared (default) | selected</td><td>Option to simulate efficiency. #### Dependencies When this parameter is selected, the parameters <strong>Charger efficiency</strong> and <strong>Efficiency usage factor</strong> become visible. Otherwise, the battery charger efficiency factor is set to a constant value of 1.</td></tr><tr><td><strong>Charger efficiency [0-1]</strong> — Battery charger efficiency factor<br>[0.627 0.803 0.855 0.871 0.872 0.864] (default)</td><td>Efficiency factor, <em>η</em><sub><em>y</em></sub>, of the battery charger. This parameter is used with the <strong>Efficiency usage factor</strong> to approximate a polynomial function corresponding to the full operation range efficiency normalized on the <strong>Nominal Power</strong>.</td></tr><tr><td><strong>Efficiency usage factor (pu)</strong> — Battery charger efficiency usage factor<br>[0.063 0.177 0.293 0.483 0.674 0.914] (default)</td><td>Efficiency usage factor of the battery charger. This parameter is used with the <strong>Charger efficiency</strong> to approximate a polynomial function corresponding to the full operation range efficiency normalized on the <strong>Nominal Power</strong>.</td></tr><tr><td><strong>Simulate THD</strong> — THD simulation option<br>cleared (default) | selected</td><td><p>Total harmonic distortion (THD) simulation option. #### Dependencies When this parameter is selected, the parameters <strong>Total harmonic distortion</strong>, <strong>THD usage factor</strong>, <strong>Harmonics amplitude</strong>, and <strong>Harmonics frequency</strong> become visible.</p><p>Otherwise, the battery charger <strong>THD factor</strong> is set to a constant value of 0.</p></td></tr><tr><td><strong>Total harmonic distortion [0-1]</strong> — THD<br>[0.327 0.394 0.394 0.351 0.289 0.265] (default)</td><td>The total harmonic distortion factor, <em>THD</em><sub><em>y</em></sub>, of the battery charger. This parameter is used with the <strong>THD usage factor (pu)</strong> to approximate a polynomial function corresponding to the full operation range THD normalized on the <strong>Nominal Power</strong>.</td></tr><tr><td><strong>THD usage factor (pu)</strong> — THD usage factor<br>[0.056 0.136 0.194 0.303 0.555 0.916] (default)</td><td><p>The total harmonic distortion usage factor, <em>THD</em><sub><em>y</em></sub>, of the battery charger.</p><p>This parameter is used with the <strong>Total harmonic distortion [0-1]</strong> to approximate a polynomial function corresponding to the full operation range THD normalized on the <strong>Nominal Power</strong>.</p></td></tr><tr><td><strong>Harmonics amplitude (A)</strong> — Harmonic amplitude<br>[0.199 1.297 0.328 0.029 0.416 0.200] (default)</td><td><p>Harmonics amplitude, <em>I</em><sub><em>n</em></sub>, of the battery charger input current in A. This parameter is used with the <strong>Harmonics frequency</strong> to generate the battery charger’s input current harmonics signature.</p><p>The harmonics amplitude parameter’s values are normalized to 1 using this: We don't have a way to export this macro.</p><p>#### Dependencies This parameter is accessible when the <strong>Type</strong> is set to 3-phases AC (wye), 3-phases AC (delta), or 1-phase AC.</p></td></tr><tr><td><strong>Harmonics frequency (n)</strong> — Harmonic frequency<br>[3 5 7 9 11 13] (default)</td><td><p>The harmonics frequency, <em>f</em><sub><em>n</em></sub>, of the battery charger’s input current in <em>n</em> multiples of <strong>Frequency</strong>.</p><p>This parameter is used with the <strong>Harmonics amplitude</strong> to generate the battery charger’s input current harmonics signature.</p><p>#### Dependencies This parameter is accessible when the <strong>Type</strong>is either 3-phases AC (wye), 3-phases AC (delta), or 1-phase AC.</p></td></tr><tr><td><strong>Simulate power factor</strong> — Power factor simulation option<br>cleared (default) | selected</td><td><p>Option to simulate power factor. Otherwise, the battery charger’s PF is set to a constant equal to 1.</p><p>#### Dependencies This parameter is accessible when the <strong>Type</strong> is set to 3-phases AC (wye), 3-phases AC (delta), or 1-phase AC. When this parameter is selected, the parameters <strong>Power factor</strong> and <strong>PF usage factor</strong> become visible.</p></td></tr><tr><td><strong>Power factor [0-1]</strong> — Power factor<br>[0.316 0.532 0.662 0.731 0.780 0.792] (default)</td><td><p>Total harmonic distortion factor, or power factor, <em>PF</em><sub><em>y</em></sub>, of the battery charger.</p><p>This parameter is used with the <strong>PF usage factor</strong> to approximate a polynomial function corresponding to the full operation range’s PF normalized on the <strong>Nominal Power</strong>.</p><p>#### Dependencies This parameter is accessible when the <strong>Type</strong> is set to 3-phases AC (wye), 3-phases AC (delta), or 1-phase AC.</p></td></tr><tr><td><strong>PF usage factor (pu)</strong> — Power factor usage factor<br>[0.067 0.230 0.445 0.625 0.794 0.919] (default)</td><td><p>The <strong>PF usage factor</strong>, <em>PF</em><sub><em>y</em></sub>, of the battery charger.</p><p>This parameter is used with the <strong>Power factor</strong> to approximate a polynomial function corresponding to the full operation range PF normalized on the <strong>Nominal Power</strong></p></td></tr></tbody></table>

### Charging Mode

<table data-header-hidden><thead><tr><th width="260.66668701171875"></th><th></th></tr></thead><tbody><tr><td><strong>Output control mode</strong> — Output control method<br>Constant Current - Constant Voltage (CCCV) (default) | Constant Current only (CC) | Constant Voltage only (CV)</td><td><p>Methods for output control are:</p><ul><li>Constant Current - Constant Voltage (CCCV) — This charging mode regulates the output current and voltage.</li><li>Constant Current only (CC) — This charging mode regulates the output current.</li><li>Constant Voltage only (CV) — This charging mode regulates the output voltage.</li></ul><p>#### Dependencies Different options expose different parameters.</p></td></tr><tr><td><strong>Dynamic input thresholds</strong> — Dynamic input thresholds option<br>selected (default) | cleared</td><td><p>Option to enable dynamic access to the output current and voltage thresholds. Otherwise, these thresholds are set with <strong>Bulk current</strong> and <strong>Float voltage</strong> or <strong>Absorption voltage</strong>.</p><p>#### Dependencies The <strong>CC</strong> or <strong>CV</strong> input ports become visible to supply the current and voltage thresholds depending on the <strong>Output control mode</strong> selected.</p></td></tr><tr><td><strong>Bulk current (A)</strong> — Bulk current<br>10 (default)</td><td><p>The bulk current, <em>I</em><sub><em>bulk</em></sub>, of the battery charger maximum output current in A. While the output voltage is lower than <strong>Float voltage</strong> or <strong>Absorption voltage</strong>, the battery charger limits the output current to maintain a constant current.</p><p>#### Dependencies This parameter is accessible when the <strong>Output control mode</strong> is either Constant Current - Constant Voltage (CCCV) or Constant Current only (CC).</p></td></tr><tr><td><strong>Float voltage (V)</strong> — Float voltage<br>138 (default)</td><td><p>Float voltage, <em>V</em><sub><em>float</em></sub>, of the battery charger steady-state output voltage in V.</p><p>When the output voltage reaches this value, the battery charger reduces the output current to maintain a constant voltage.</p><p>#### Dependencies This parameter is accessible when the <strong>Output control mode</strong>is either Constant Current - Constant Voltage (CCCV) or Constant Voltage only (CV).</p></td></tr><tr><td><strong>Enable absorption phase</strong> — Absorption phase option<br>cleared (default) | selected</td><td><p>Option to enable the battery charging absorption phase.</p><p>The charging phase allows the battery charger to maintain a higher <strong>Absorption voltage</strong> than <strong>Float voltage</strong> for a specified <strong>Absorption end condition</strong> when switching from constant current to constant voltage charging.</p><p>#### Dependencies This parameter is accessible when the <strong>Output control mode</strong> is Constant Current - Constant Voltage (CCCV) and the <strong>Dynamic input thresholds</strong> is cleared.</p></td></tr><tr><td><strong>Absorption voltage (V)</strong> — Absorption voltage<br>142 (default)</td><td><p>Absorption voltage, <em>V</em><sub><em>abs</em></sub>, of the battery charger transition voltage when switching from constant current to constant voltage charging.</p><p>The battery charger’s absorption voltage will be maintained while the <strong>Absorption end condition</strong> isn’t met.</p><p>This parameter must be greater than the float voltage.</p><p>#### Dependencies This parameter is accessible when the <strong>Enable absorption phase</strong> is selected.</p></td></tr><tr><td><strong>Absorption end condition</strong> — Absorption end condition<br>Time based (default) | Current based</td><td><p>Choose between two absorption end conditions:</p><ul><li>Time based — This end condition requires a specified <strong>Absorption time</strong> while maintaining the <strong>Absorption voltage</strong>before lowering the battery charger’s output voltage to <strong>Float voltage</strong>.</li><li>Current based — This end condition requires a specified <strong>Absorption current</strong> while maintaining the <strong>Absorption voltage</strong> before lowering the battery charger’s output voltage to <strong>Float voltage</strong>.</li></ul><p>#### Dependencies This parameter is accessible when <strong>Enable absorption phase</strong> is selected.</p></td></tr><tr><td><strong>Absorption time (s)</strong> — Absorption time<br>3600 (default)</td><td><p>Absorption time, <em>t</em><sub><em>abs</em></sub>, of the time-based end condition of the absorption phase in s. When the <strong>Absorption voltage</strong> has been maintained for the specified time, the output voltage is lowered to the <strong>Float voltage</strong>.</p><p>#### Dependencies This parameter is accessible when the <strong>Absorption end condition</strong> is Time based.</p></td></tr><tr><td><strong>Absorption current (%)</strong> — Absorption current<br>40 (default)</td><td><p>Absorption current, <em>I</em><sub><em>abs%</em></sub>, of the absorption phase’s current-based end condition in %. When the output current reaches the specified percentage of the <strong>Bulk current</strong>, the output voltage lowers from the <strong>Absorption voltage</strong> to the <strong>Float voltage</strong>.</p><p>This parameter is accessible when the <strong>Absorption end condition</strong> is Current based. #### Dependencies This parameter is accessible when the <strong>Absorption end condition</strong> is Current based.</p></td></tr><tr><td><strong>Plot Curves</strong></td><td>Click to plot input parameter and input current harmonics curves for the battery charger.</td></tr></tbody></table>

### Output

<table data-header-hidden><thead><tr><th width="259.5555419921875"></th><th></th></tr></thead><tbody><tr><td><strong>Current ripple (%)</strong> — Current ripple<br>0.5 (default)</td><td>The output ripple, <em>I</em><sub><em>outr%</em></sub>, of the battery charger current specified as a %.</td></tr><tr><td><strong>Ripple frequency (Hz)</strong> — Ripple frequency<br>1000 (default)</td><td><em>f</em><sub><em>outir</em></sub> Ripple frequency, <em>f</em><sub><em>outir</em></sub>, of the battery charger output current in Hz.</td></tr><tr><td><strong>Overshoot (%)</strong> — System overshoot<br>1 (default)</td><td>The overshoot, <em>d</em><sub><em>%</em></sub>, of the battery charger’s output control dynamic in %. This parameter is applied to the <strong>Bulk current</strong>, <strong>Float voltage</strong> and <strong>Absorption voltage</strong> depending on charging phase.</td></tr><tr><td><strong>Settling time (s)</strong> — System settling time<br>5 (default)</td><td><p>Settling time, <em>t</em><sub><em>s</em></sub>, at which the battery charger’s output control dynamic reaches 2% of its steady-state value in s.</p><p>This parameter is applied to the <strong>Bulk current</strong>, <strong>Float voltage</strong> and <strong>Absorption voltage</strong> depending on charging phase.</p></td></tr><tr><td><strong>Simulate voltage compensation</strong> — Voltage compensation option<br>cleared (default) | selected</td><td>Option to enable output voltage temperature compensation. When enabled, the <strong>Float voltage</strong> and <strong>Absorption voltage</strong> will vary depending on the ambient temperature, <strong>Voltage compensation</strong> and <strong>Nominal temperature</strong>.</td></tr><tr><td><strong>Voltage compensation (V/deg. C)</strong> — Voltage compensation<br>-0.18 (default)</td><td>Voltage compensation, <em>V</em><sub><em>tc</em></sub>, of the battery charger output in V/°C. #### Dependencies This parameter is accessible when the <strong>Simulate voltage compensation</strong> is selected.</td></tr><tr><td><strong>Nominal temperature (deg. C)</strong> — Nominal temperature<br>20 (default)</td><td>Nominal temperature, <em>T</em><sub><em>nom</em></sub>, of the required battery float voltage in °C. #### Dependencies This parameter is accessible when the <strong>Simulate voltage compensation</strong> is selected.</td></tr></tbody></table>

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

\[1] Cope, R.C., and Y. Podrazhansky. *The Art of Battery Charging*. Proc. 14th Annual Battery Conference on Applications and Advances, pp. 233-235. Long Beach, CA: 1999.

\[2] Dubey, A., Santoso, S., and M.P. Cloud. *Average-Value Model of Electric Vehicle Chargers*. IEEE Transactions on Smart Grid Vol. 4 No. 3. Pp. 1549-1557. Argonne, IL: IEEE Power & Energy Society, 2013.

\[3] Elias, M., Nor, K., and A. Arof. *Design of Smart Charger for Series Lithium-Ion Batteries*. Proceedings from IEEE International Conference on Power Electronics and Drive Systems, pp. 1485-1490. Kuala Lumpur: PEDS, 2005.

\[4] Hussein A.A.-H., and I. Batarseh. *A Review of Charging Algorithms for Nickel and Lithium Battery Chargers*. IEEE Transactions on Vehicular Technology. Sendai, Japan: IEEE Vehicular Technology Society, 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/smart-power-simulation-software-sps/blocks-functions-tools/power-converters/cccv-battery-charger.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.
