# CurrentState

## UPS Input

```
Description             type    entity      Unit

Voltage L1              273     1           0.01 V
Voltage L2              274     1           0.01 V
Voltage L3              275     1           0.01 V
Current L1              305     1           0.01 A
Current L2              306     1           0.01 A
Current L3              307     1           0.01 A
Power L1                337     1           1    W
Power L2                338     1           1    W
Power L3                339     1           1    W
Power Total             353     1           1    W
Frequency               354     1           0.01 Hz
```

{% hint style="info" %}
Power Direction

`Positive = Consuming`\
`Negative = Injecting`
{% endhint %}

## UPS Output (Protected Load)

```
Description             type    entity      Unit

Voltage L1              1297    1           0.01 V
Voltage L2              1298    1           0.01 V
Voltage L3              1299    1           0.01 V
Current L1              1329    1           0.01 A
Current L2              1330    1           0.01 A
Current L3              1331    1           0.01 A
Power L1                1361    1           1    W
Power L2                1362    1           1    W
Power L3                1363    1           1    W
Power Total             1377    1           1    W
Frequency               1378    1           0.01 Hz
```

## Battery

```
Description             type    entity      Unit

Voltage Minus-N         1041    1           0.01 V
Voltage Plus-N          1042    1           0.01 V
Current Minus           1057    1           0.01 A
Current Plus            1058    1           0.01 A
Capacity Minus %        1073    1           1    %
Capacity Plus %         1074    1           1    %
Power Total             1121    1           1    W
```

{% hint style="info" %}
**batterX Home** has only positive (plus) battery side.
{% endhint %}

{% hint style="info" %}
Power Direction

`Positive = Charging`\
`Negative = Discharging`
{% endhint %}

## Solar

```
Description             type    entity      Unit

Voltage X-1             1553    X           0.01 V
Voltage X-2             1554    X           0.01 V
Current X-1             1569    X           0.01 A
Current X-2             1570    X           0.01 A
Power X-1               1617    X           1    W
Power X-2               1618    X           1    W
Power X Total           1633    X           1    W
Power Total             1634    0           1    W
```

`X` - Solar Controller ID (1-8)\
`X-1`, `X-2` - MPPT ID in the Solar Controller

{% hint style="info" %}
**batterX Home** has one solar controller (ID 1), with 2 MPPTs
{% endhint %}

## Grid (Energy Meter)

```
Description             type    entity      Unit

Voltage L1              2833    0           0.01 V
Voltage L2              2834    0           0.01 V
Voltage L3              2835    0           0.01 V
Current L1              2865    0           0.01 A
Current L2              2866    0           0.01 A
Current L3              2867    0           0.01 A
Power L1                2897    0           1    W
Power L2                2898    0           1    W
Power L3                2899    0           1    W
Power Total             2913    0           1    W
Frequency               2914    0           0.01 Hz
```

{% hint style="info" %}
For **batterX Home** this is E.Meter with Modbus ID 1
{% endhint %}

{% hint style="info" %}
Power Direction

`Positive = Consuming`\
`Negative = Injecting`
{% endhint %}

## External Solar (Energy Meter)

```
Description             type    entity      Unit

Power L1                2897    3           1    W
Power L2                2898    3           1    W
Power L3                2899    3           1    W
Power Total             2913    3           1    W
```

{% hint style="info" %}
For **batterX Home** this is E.Meter with Modbus ID 2
{% endhint %}

## House (Unprotected Load)

```
Description             type    entity      Unit

Power L1                2897    2           1    W
Power L2                2898    2           1    W
Power L3                2899    2           1    W
Power Total             2913    2           1    W
```

Estimated values (power difference between UPS Input and Grid E.Meter)

## Grid Solar (Energy Meter)

```
Description             type    entity      Unit

Power Total             2913    9           1    W
```

This is an energy meter connected to the input of an external solar inverter which is feeding directly to the grid (full feed-in), bypassing our grid energy meter.

{% hint style="info" %}
For **batterX Home** this is E.Meter with Modbus ID 3
{% endhint %}

## batterX Home - GPIOs & Commands

```
Description                   type    entity      Unit

Input 1 State                 2321    1           0 / 1 (Off / On)
Input 2 State                 2321    2           0 / 1 (Off / On)
Input 3 State                 2321    3           0 / 1 (Off / On)
Input 4 State                 2321    4           0 / 1 (Off / On)

Output 1 State                2337    1           0 / 1 / 10 / 11 (Off / On / Forced-Off / Forced-On)
Output 2 State                2337    2           0 / 1 / 10 / 11 (Off / On / Forced-Off / Forced-On)
Output 3 State                2337    3           0 / 1 / 10 / 11 (Off / On / Forced-Off / Forced-On)
Output 4 State                2337    4           0 / 1 / 10 / 11 (Off / On / Forced-Off / Forced-On)

Grid Injection State          2465    1           0 / 1 / 10 / 11 (Off / On / Forced-Off / Forced-On)
Battery Charging State        2465    2           0 / 1 / 10 / 11 (Off / On / Forced-Off / Forced-On)
Battery Charging AC State     2465    3           0 / 1 / 10 / 11 (Off / On / Forced-Off / Forced-On)
Battery Discharging State     2465    4           0 / 1 / 10 / 11 (Off / On / Forced-Off / Forced-On)
```

{% hint style="danger" %}
Note: This GPIOs & Commands section is only for batterX Home.

Other batterX products (like the batterX Business, for example) may be using the same types and entities for something else.
{% endhint %}

These are the inputs, outputs and inverter commands that are available on the dashboard page of the batterX Portal.

There are four possible states for the outputs and commands.

* `0` = Off, turned off by the automatic
* `1` = On, turned on by the automatic
* `10` = Off, forced off by the user
* `11` = On, forced on by the user

If the state of an output/command is forced-off or forced-on by the user (state `10` or `11`) the output/command will not change its state until the user sets it to automatic.

Make sure to check the **Commands** page for more info.