# Shelly i3

Source: https://docs.evcc.io/en/external-limit/shelly-i3

Connect the relay contacts of the control box to the inputs SW1 to SW3. With three inputs only the feed-in limitation (W3, S1, S2) is mapped by default. Dimming of controllable loads (W4) requires reassigning one of the inputs.

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| host | IP address or hostname | 192.0.2.2 |  |
| w3input | W3 input Input number for the W3 signal (Zero export, 0%), 1 to 3 (SW1 = 1) | 1 |  |
| user | Username Only required if authentication is enabled on the device |  |  |
| password | Password Service account password |  |  |
| productionnominalmax | Installed generator power Rated generator/module power of the installation (reference value according to § 9 EEG). |  Wp |  |
| s1input | S1 input Input number for the S1 signal (60% export power limit), 1 to 3 (SW1 = 1) | 2 |  |
| s2input | S2 input Input number for the S2 signal (30% export power limit), 1 to 3 (SW1 = 1) | 3 |  |
| w4input | W4 input Input number for the W4 signal (Dimmer for controllable loads), 1 to 3 (SW1 = 1). Not mapped by default. |  | advanced |
| maxconsumptionpower | Guaranteed minimum power (Pmin) Power limit applied to the root circuit while the limit is active. Required if W4 is mapped. |  W | advanced |

## Configuration example for evcc.yaml

```yaml
hems:
  type: template
  template: fnn-shelly-i3
  host: 192.0.2.2 # IP address or hostname
  w3input: 1 # W3 input, Input number for the W3 signal (Zero export, 0%), 1 to 3 (SW1 = 1)
  user: # Username, Only required if authentication is enabled on the device (optional)
  password: # Password, Service account password (optional)
  productionnominalmax: # Installed generator power (Wp), Rated generator/module power of the installation (reference value according to § 9 EEG). (optional)
  s1input: 2 # S1 input, Input number for the S1 signal (60% export power limit), 1 to 3 (SW1 = 1) (optional)
  s2input: 3 # S2 input, Input number for the S2 signal (30% export power limit), 1 to 3 (SW1 = 1) (optional)
  w4input: # W4 input, Input number for the W4 signal (Dimmer for controllable loads), 1 to 3 (SW1 = 1). Not mapped by default. (optional)
  maxconsumptionpower: # Guaranteed minimum power (Pmin) (W), Power limit applied to the root circuit while the limit is active. Required if W4 is mapped. (optional)
```
