> 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/cmde-add-on/model-and-simulation/configure-devices-within-a-ring/device-section/adbms6830.md).

# ADBMS6830

The **ADBMS6830** is a virtualized integrated circuit designed to mimic the behavior of a real cell monitoring device. Within the VeriStand project, it is represented as a **Device** item in the configuration tree and is emulated on the FPGA of the Real-Time target upon project deployment.&#x20;

Each **ADBMS6830** device in the **Ring** supports the monitoring of up to 16 battery cells, along with 10 GPIO channels. Passive balancing functionality is also included.

## Section Channels <a href="#section-channels" id="section-channels"></a>

Expand the **Device** section in the configuration tree to display the following VeriStand channels. Channel values can be dynamically modified during execution.

<table><thead><tr><th width="149.88885498046875">Channel Name</th><th width="79.6666259765625">Type</th><th width="90.22222900390625">Format</th><th width="69.99981689453125">Units</th><th>Description</th></tr></thead><tbody><tr><td><strong>Enable</strong></td><td>Input</td><td>Binary</td><td> </td><td><p>Enables or disables the emulated device during execution.</p><ul><li><strong>0</strong> - Device is disabled and bypassed for SPI transmission.</li><li><strong>1</strong> - Device is enabled. Normal operation.</li></ul><p>Default value: 1</p></td></tr><tr><td><strong>CRC Check</strong></td><td>Input</td><td>Binary</td><td> </td><td><p>Enables or disables the cyclic redundancy check (CRC) of the command packet error code (PEC) and data packet error code (DPEC) of the SPI transmissions received by the emulated device.</p><ul><li><strong>0</strong> - No CRC check is performed.</li><li><strong>1</strong> - CRC checking is enabled. Normal operation.</li></ul><p>Default value: 1</p></td></tr><tr><td><strong>Port A Enable</strong></td><td>Input</td><td>Binary</td><td> </td><td><p>Enables or disables SPI transmission on the Port A side of the emulated device. Use this channel to simulate a fault in the SPI communication.</p><ul><li><strong>0</strong> - SPI transmission is disabled on the Port A side of the device.</li><li><strong>1</strong> - SPI transmission is enabled. Normal operation.</li></ul><p>Default value: 1</p></td></tr><tr><td><strong>Port B Enable</strong></td><td>Input</td><td>Binary</td><td> </td><td><p>Enables or disables SPI transmission on the Port B side of the emulated device. Use this channel to simulate a fault in the SPI communication.</p><ul><li><strong>0</strong> - SPI transmission is disabled on the Port B side of the device.</li><li><strong>1</strong> - SPI transmission is enabled. Normal operation.</li></ul><p>Default value: 1</p></td></tr><tr><td><strong>Redundancy Fault</strong></td><td>Input</td><td>Binary</td><td> </td><td><p>Forces a digital redundancy fault on the emulated device and stores a digital redundancy fault code in place of the ADC result.</p><ul><li><strong>0</strong> - Digital redundancy check passes.</li><li><strong>1</strong> - Digital redundancy check fails.</li></ul><p>Default value: 0</p></td></tr><tr><td><strong>Selftest Fault</strong></td><td>Input</td><td>Binary</td><td> </td><td>Obsolete. This channel does not impact the results of the emulation.<br>Default value: 0</td></tr><tr><td><strong>CRC Error</strong></td><td>Input</td><td>Binary</td><td> </td><td><p>Forces a CRC error on the SPI transmissions originating from the emulated device.</p><ul><li><strong>0</strong> - Generated device response contains the correct CRC value.</li><li><strong>1</strong> - Generated device response contains an incorrect CRC value.</li></ul><p>Default value: 0</p></td></tr><tr><td><strong>Vref1</strong></td><td>Input</td><td>Decimal</td><td>V</td><td>Emulates the V<sub>REF1</sub> pin of a real device.<br>Default value: 0</td></tr><tr><td><strong>Vref2</strong></td><td>Input</td><td>Decimal</td><td>V</td><td>Emulates the V<sub>REF2</sub> pin of a real device.<br>Default value: 0</td></tr><tr><td><strong>VA</strong></td><td>Input</td><td>Decimal</td><td>V</td><td>Emulates the Analog Power Supply Voltage measurement on the device. The measured value is stored in the VA memory location within Status Register Group B.<br>Default value: 0</td></tr><tr><td><strong>VD</strong></td><td>Input</td><td>Decimal</td><td>V</td><td>Emulates the Digital Power Supply Voltage measurement on the device. The measured value is stored in the VD memory location within Status Register Group B.<br>Default value: 0</td></tr><tr><td><strong>Internal Die Temperature</strong></td><td>Input</td><td>Decimal</td><td>°C</td><td>Emulates the Internal Die Temperature Measurement on the device, in degrees Celsius. The Internal Die Temperature is subsequently used to calculate the ITMP value stored in Status Register Group A.<br>Default value: 0</td></tr><tr><td><strong>Vres</strong></td><td>Input</td><td>Decimal</td><td>V</td><td>Emulates the Resistor Voltage measurement on the device. The measured value is stored in the VRES memory location within Status Register Group B.<br>Default value: 0</td></tr><tr><td><strong>VMV</strong></td><td>Input</td><td>Decimal</td><td>V</td><td>Emulates the V- to V- voltage measurement on the device. The measured value is stored in the VPV memory location within Auxiliary Register Group D.<br>Default value: 0</td></tr><tr><td><strong>VPV</strong></td><td>Input</td><td>Decimal</td><td>V</td><td>Emulates the V+ to V- voltage measurement on the device. The measured value is stored in the VPV memory location within Auxiliary Register Group D.<br>Default value: 0</td></tr><tr><td><strong>Cell Measurement </strong><em><strong>x</strong></em></td><td>Input</td><td>Decimal</td><td>V</td><td>Emulates the cell voltage measurement of Cell <em>x</em>. This measurement is taken between pin C<em>x</em> and pin C(<em>x</em>-1) on a real device.<br>Default value: 0</td></tr><tr><td><strong>Redundant Cell Measurement </strong><em><strong>x</strong></em></td><td>Input</td><td>Decimal</td><td>V</td><td>Emulates the redundant voltage measurement of Cell <em>x</em>. This measurement is taken between pin S<em>x</em> and pin S(<em>x</em>-1) on a real device.<br>Default value: 0</td></tr><tr><td><strong>GPIO </strong><em><strong>x</strong></em></td><td>Input</td><td>Decimal</td><td>V</td><td>Emulates pins GPIO1 through GPIO10 of a real device.<br>Default value: 0</td></tr><tr><td><strong>Serial ID</strong></td><td>Input</td><td>Hexadecimal</td><td> </td><td><p>Sets the Serial ID (SID) of the emulated device.</p><p>To set the <strong>Default Value</strong> of this channel in the system definition, convert it to decimal notation. </p><p>See <a href="https://www.opal-rt.com/docs/cmde-add-on/model-and-simulation/configure-devices-within-a-ring/manage-hexadecimal-and-binary-data-in-veristand-channels.md"><strong>Manage Hexadecimal and Binary Data in VeriStand Channels</strong></a> for more information.<br>Default value: 0</p></td></tr><tr><td><strong>Open Wire C</strong><em><strong>x</strong></em></td><td>Input</td><td>Binary</td><td> </td><td><p>Emulates an open wire between the external cells. This open wire condition can be detected using the ADOW command.</p><ul><li><strong>0</strong> - Uninterrupted connection at pin C<em>x</em>.</li><li><strong>1</strong> - Open wire at pin C<em>x</em>.</li></ul><p>Default value: 0</p></td></tr><tr><td><strong>Last Command Received</strong></td><td>Output</td><td>Hexadecimal</td><td> </td><td>Outputs the last command received from the SPI Master.<br>Default value: 0</td></tr><tr><td><strong>Command CRC Check</strong></td><td>Output</td><td>Binary</td><td> </td><td><p>Binary flag indicating a Command CRC mismatch in the last transmission received from the SPI Master.</p><ul><li><strong>0</strong> - No CRC mismatch detected.</li><li><strong>1</strong> - CRC mismatch detected.</li></ul><p>Default value: 0</p></td></tr><tr><td><strong>Data CRC Check</strong></td><td>Output</td><td>Binary</td><td> </td><td><p>Binary flag indicating a Data CRC mismatch in the last transmission received from the SPI Master.</p><ul><li><strong>0</strong> - No CRC mismatch detected.</li><li><strong>1</strong> - CRC mismatch detected.</li></ul><p>Default value: 0</p></td></tr><tr><td><strong>PWM Discharge Control </strong><em><strong>x</strong></em></td><td>Output</td><td>Binary</td><td> </td><td><p>Outputs the duty cycle of the PWM controlling the balancing switch for cell C<em>x</em>. The value is represented in 4-bit binary format and corresponds to the PWMCn value. </p><p>This channel can be mapped to the input of an external cell model to regulate its discharge process.<br>Default value: 0</p></td></tr><tr><td><strong>Discharge Cell </strong><em><strong>x</strong></em></td><td>Output</td><td>Binary</td><td> </td><td><p>Binary flag outputting the status of DCC bit <em>x</em> in Configuration Register Group B.</p><ul><li><strong>0</strong> - DCC bit is not asserted.</li><li><strong>1</strong> - DCC bit is asserted. Continuous discharge of Cell <em>x</em>.</li></ul><p>Default value: 0</p></td></tr></tbody></table>

## SPI Mode

The SPI Mode of the ADBMS6830 device is user configurable at the **Ring** level.

## Supported Commands <a href="#supported-commands" id="supported-commands"></a>

The ADBMS6830 device supports the following SPI commands:

| Command                                          | Description                                       |
| ------------------------------------------------ | ------------------------------------------------- |
| **Configuration Register Commands**              |                                                   |
| WRCFGA                                           | Write Configuration Register Group A              |
| WRCFGB                                           | Write Configuration Register Group B              |
| RDCFGA                                           | Read Configuration Register Group A               |
| RDCFGB                                           | Read Configuration Register Group B               |
| **Read Cell Voltage Results Registers**          |                                                   |
| RDCVA                                            | Read Cell Voltage Register Group A                |
| RDCVB                                            | Read Cell Voltage Register Group B                |
| RDCVC                                            | Read Cell Voltage Register Group C                |
| RDCVD                                            | Read Cell Voltage Register Group D                |
| RDCVE                                            | Read Cell Voltage Register Group E                |
| RDCVF                                            | Read Cell Voltage Register Group F                |
| RDCVALL                                          | Read All Cell Results                             |
| **Read Averaged Cell Voltage Results Registers** |                                                   |
| RDACA                                            | Read Averaged Cell Voltage Register Group A       |
| RDACB                                            | Read Averaged Cell Voltage Register Group B       |
| RDACC                                            | Read Averaged Cell Voltage Register Group C       |
| RDACD                                            | Read Averaged Cell Voltage Register Group D       |
| RDACE                                            | Read Averaged Cell Voltage Register Group E       |
| RDACF                                            | Read Averaged Cell Voltage Register Group F       |
| RDACALL                                          | Read All Averaged Cell Results                    |
| **Read S-Voltage Result Registers**              |                                                   |
| RDSVA                                            | Read S Voltage Register Group A                   |
| RDSVB                                            | Read S Voltage Register Group B                   |
| RDSVC                                            | Read S Voltage Register Group C                   |
| RDSVD                                            | Read S Voltage Register Group D                   |
| RDSVE                                            | Read S Voltage Register Group E                   |
| RDSVF                                            | Read S Voltage Register Group F                   |
| RDSALL                                           | Read All S Results                                |
| **Read Filtered Cell Voltage Result Registers**  |                                                   |
| RDFCA                                            | Read Filtered Cell Voltage Register Group A       |
| RDFCB                                            | Read Filtered Cell Voltage Register Group B       |
| RDFCC                                            | Read Filtered Cell Voltage Register Group C       |
| RDFCD                                            | Read Filtered Cell Voltage Register Group D       |
| RDFCE                                            | Read Filtered Cell Voltage Register Group E       |
| RDFCF                                            | Read Filtered Cell Voltage Register Group F       |
| RDFCALL                                          | Read All Filtered Cell Results                    |
| **Read Auxiliary Result Registers**              |                                                   |
| RDAUXA                                           | Read Auxiliary Register Group A                   |
| RDAUXB                                           | Read Auxiliary Register Group B                   |
| RDAUXC                                           | Read Auxiliary Register Group C                   |
| RDAUXD                                           | Read Auxiliary Register Group D                   |
| RDAUXE                                           | Read Auxiliary Register Group E (ADBMS6832 Only)  |
| RDRAXA                                           | Read Redundant Auxiliary Register Group A         |
| RDRAXB                                           | Read Redundant Auxiliary Register Group B         |
| RDRAXC                                           | Read Redundant Auxiliary Register Group C         |
| RDRAXD                                           | Read Redundant Auxiliary Register Group D         |
| **Read Status Registers**                        |                                                   |
| RDSTATA                                          | Read Status Register Group A                      |
| RDSTATB                                          | Read Status Register Group B                      |
| RDSTATC                                          | Read Status Register Group C                      |
| RDSTATC with error injection (ERR=1)             | Read Status Register Group C with error injection |
| RDSTATD                                          | Read Status Register Group D                      |
| RDSTATE                                          | Read Status Register Group E                      |
| **PWM Register Commands**                        |                                                   |
| WRPWMA                                           | Write PWM Register Group A                        |
| RDPWMA                                           | Read PWM Register Group A                         |
| WRPWMB                                           | Write PWM Register Group B                        |
| RDPWMB                                           | Read PWM Register Group B                         |
| **ADC Commands**                                 |                                                   |
| ADCV                                             | Start Cell Voltage ADC Conversion and Poll Status |
| ADSV                                             | Start S-ADC Conversion and Poll Status            |
| ADAX                                             | Start AUX ADC Conversions and Poll Status         |
| ADAX2                                            | Start AUX2 ADC Conversions and Poll Status        |
| **Clear Commands**                               |                                                   |
| CLRCELL                                          | Clear Cell Voltage Register Groups                |
| CLRFC                                            | Clear Filtered Cell Voltage Register Groups       |
| CLRAUX                                           | Clear Auxiliary Register Groups                   |
| CLRSPIN                                          | Clear S-Voltage Register Groups                   |
| CLRFLAG                                          | Clear Flags                                       |
| CLOVUV                                           | Clear OVUV                                        |
| **Poll Commands**                                |                                                   |
| PLADC                                            | Poll any ADC Status                               |
| PLCADC                                           | Poll C-ADC                                        |
| PLSADC                                           | Poll S-ADC                                        |
| PLAUX                                            | Poll Aux ADC                                      |
| PLAUX2                                           | Poll Aux2 ADC                                     |
| **Master I2C Commands**                          |                                                   |
| WRCOMM                                           | Write COMM Register Group                         |
| RDCOMM                                           | Read COMM Register Group                          |
| **Control Commands**                             |                                                   |
| MUTE                                             | Mute Discharge                                    |
| UNMUTE                                           | Unmute Discharge                                  |
| RDSID                                            | Read Serial ID Register Group                     |
| RSTCC                                            | Reset Command Counter                             |
| SNAP                                             | Snapshot                                          |
| UNSNAP                                           | Release Snapshot                                  |
| SRST                                             | Soft Reset                                        |

{% hint style="info" %}
The emulated device performs cell voltage sampling at the firmware level, meaning that the sampling rates are much higher than the execution rates of the VeriStand CMDE Add-on.&#x20;

For this reason, the **Read Averaged Cell Voltage Results Registers** will report the same values as the **Cell Voltage Results Registers**.
{% endhint %}


---

# 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/cmde-add-on/model-and-simulation/configure-devices-within-a-ring/device-section/adbms6830.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.
