# ABB Terra AC charging station

<!-- BEGIN GENERATED: __badges_abbterra__ -->
<span class="badge testing">TESTING</span> <span class="badge origin-etm">ETM</span> <span class="badge consumer">CONSUMER</span>

<!-- END GENERATED -->

The ABB Terra AC charging station comes in two communication variants:
**Modbus TCP** (Ethernet/LAN) and **Modbus RTU** (RS485 bus).

## 1. Choosing the variant

- **TCP**: the station sits on the local network, addressed by its IP address
  or hostname. Added by network discovery.
- **RTU**: the station sits on an RS485 bus, addressed by its slave address.

## 2. Wiring

- TCP: an Ethernet cable into the hub's network.
- RTU: A↔A, B↔B, ground, 120 Ω termination.

## 3. Adding in PowerSync

TCP variant: **automatic discovery** on the network, or **manual** addition
(IP, port). RTU variant: added through the RTU master plus the slave address.
See [Adding a device](../../installation/application.md).

## 4. Verification

`connected`, `pluggedIn` and then `charging` reflect the state of the session;
`maxChargingCurrent` reflects the current setpoint.

---

## Reference

<!-- BEGIN GENERATED: integrationpluginabbterra.json -->
**Manufacturer:** ABB  
**Plugin:** `AbbTerra`

#### Supported models
| Model | Role | Transport | Pairing | Quantities |
| --- | --- | --- | --- | --- |
| **Terra AC Charger (TCP)** | EV charger | Modbus TCP | Manual | 17 |
| **Terra AC Charger (RTU)** | EV charger | Modbus RTU | Auto-discovery / Manual | 17 |

#### Per-model detail
??? abstract "Terra AC Charger (TCP) — `terraAcTcp`"
    _Settings:_

    | Key | Label | Type | Range | Default | Read-only |
    | --- | --- | --- | --- | --- | --- |
    | `macAddress` | MAC address | QString | — | — | yes |
    | `address` | Host address | QString | — | — | no |
    | `hostName` | Host name | QString | — | — | no |
    | `port` | Port | uint | — | `502` | no |
    | `slaveId` | Slave ID | uint | 1–255 | `1` | no |

    _Measured quantities:_

    | Key | Quantity | Type | Unit |
    | --- | --- | --- | --- |
    | `connected` | Connected | bool | — |
    | `pluggedIn` | Plugged in | bool | — |
    | `charging` | Charging | bool | — |
    | `power` | Charging enabled | bool | — |
    | `maxChargingCurrent` | Maximum charging current | double | Ampere |
    | `phaseCount` | Phase count | uint | — |
    | `currentPower` | Active power | double | Watt |
    | `currentPhase1` | Current phase 1 | double | Ampere |
    | `currentPhase2` | Current phase 2 | double | Ampere |
    | `currentPhase3` | Current phase 3 | double | Ampere |
    | `voltagePhase1` | Voltage phase 1 | double | Volt |
    | `voltagePhase2` | Voltage phase 2 | double | Volt |
    | `voltagePhase3` | Voltage phase 3 | double | Volt |
    | `sessionEnergy` | Session energy | double | KiloWattHour |
    | `firmwareVersion` | Firmware version | QString | — |
    | `serialNumber` | Serial number | QString | — |
    | `errorCode` | Error code | uint | — |

??? abstract "Terra AC Charger (RTU) — `terraAcRtu`"
    _Settings:_

    | Key | Label | Type | Range | Default | Read-only |
    | --- | --- | --- | --- | --- | --- |
    | `rtuMaster` | Modbus RTU master | QString | — | — | no |
    | `slaveId` | Modbus slave ID | uint | 1–247 | `1` | no |

    _Measured quantities:_

    | Key | Quantity | Type | Unit |
    | --- | --- | --- | --- |
    | `connected` | Connected | bool | — |
    | `pluggedIn` | Plugged in | bool | — |
    | `charging` | Charging | bool | — |
    | `power` | Charging enabled | bool | — |
    | `maxChargingCurrent` | Maximum charging current | double | Ampere |
    | `phaseCount` | Phase count | uint | — |
    | `currentPower` | Active power | double | Watt |
    | `currentPhase1` | Current phase 1 | double | Ampere |
    | `currentPhase2` | Current phase 2 | double | Ampere |
    | `currentPhase3` | Current phase 3 | double | Ampere |
    | `voltagePhase1` | Voltage phase 1 | double | Volt |
    | `voltagePhase2` | Voltage phase 2 | double | Volt |
    | `voltagePhase3` | Voltage phase 3 | double | Volt |
    | `sessionEnergy` | Session energy | double | KiloWattHour |
    | `firmwareVersion` | Firmware version | QString | — |
    | `serialNumber` | Serial number | QString | — |
    | `errorCode` | Error code | uint | — |

<!-- END GENERATED -->