# Borne ABB Terra AC

<!-- 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 -->

La borne de recharge ABB Terra AC existe en deux variantes de communication :
**Modbus TCP** (réseau Ethernet/LAN) et **Modbus RTU** (bus RS485).

## 1. Choix de la variante

- **TCP** : la borne est sur le réseau local, repérée par son adresse IP /
  nom d'hôte. Ajout par découverte réseau.
- **RTU** : la borne est sur un bus RS485, repérée par son adresse esclave.

## 2. Raccordement

- TCP : câble Ethernet vers le réseau du hub.
- RTU : A↔A, B↔B, masse, terminaison 120 Ω.

## 3. Ajout dans PowerSync

Variante TCP : **découverte automatique** sur le réseau, ou ajout **manuel**
(IP, port). Variante RTU : ajout via le maître RTU + adresse esclave.
Voir [Ajouter un appareil](../../installation/application.md).

## 4. Vérification

`connected`, `pluggedIn` puis `charging` reflètent l'état de la session ;
`maxChargingCurrent` reflète la consigne de courant.

---

## Référence

<!-- 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 -->