Device identification
-
Device name: Shelly Plus Add-on
Short description
Shelly Plus Add-on (the Device) is a galvanically isolated sensor interface to the Shelly Plus and Gen3 devices.
Main applications
-
Residential
-
MDU (Multi Dwelling Units - apartments, condominiums, hotels, etc.)
-
Light commercial (small office buildings, small retail/restaurant/gas station, etc.)
-
Agricultural (greenhouses, hotbed, nurseries, ranches, etc. )
-
Government/municipal
-
University/college
Future integrations
-
Google
-
Amazon
-
Samsung SmartThings
Device electrical interfaces
Inputs
-
1 analog input: ANALOG IN
-
1 digital input: DIGITAL IN
Output
-
1 reference voltage output: VREF OUT
-
1 reference voltage through a pull-up resistor output: VREF + R1 OUT
-
2 ground terminals: GND*
1-Wire interface
-
3 sensor power supply outputs (connected to the same PCB track): VCC
-
3 sensor data terminals (connected to the same PCB track): DATA
-
3 ground terminals: GND*
-
Connected to the same PCB ground layer.
Add-on interface
-
Shelly proprietary serial interface to connect to a Shelly Plus device
Supported sensors
-
Up to 5 DS18B20
-
Single DHT22
-
NTC resistors with 10 kΩ nominal resistance and β=4000 K
-
Photoresistors
-
PIR sensors
-
Soil moisture sensors
-
Ultrasonic proximity sensors
-
Capacitive liquid level sensors
-
Sound detectors
-
Other analog sensors with 0 to 10 V output voltage
Specifications
| Type | Value |
|---|---|
| Physical | |
| Size (HxWxD): | 37x42x15 ±0.5 mm / 1.46 x 1.65 x 0.59 ±0.02 in |
| Weigh: | 105 g / 3.70 oz |
| Shell material: | Plastic |
| Screw terminals max torque: | 0.1 Nm / 0.89 lbIn |
| Conductor cross section: | max. 1 mm² / 17 AWG |
| Conductor stripped length: | 4.5 mm / 0.18 in |
| Color: | Black |
| Environmental | |
| Ambient temperature: | -20 °C to 40 °C / -5 °F to 105 °F |
| Humidity | 30 % to 70 % RH |
| Max. altitude | 2000 m / 6562 ft |
| Electrical | |
| Power supply voltage AC: | N/A |
| Power supply voltage DC: | 3.3 V (from Shelly plus device) |
| Power consumption: | < 0.5 W (without sensors) |
| Output circuits ratings | |
| VCC max. current: | 10 mA |
| VREF OUT max. current: | 1 mA |
| VREF+R1 OUT resistor | 10 kΩ |
| Shelly Plus device firmware capabilities | |
| Shelly Plus Addon supporting devices: | Shelly Plus devices:
|
| Shelly Gen3 devices:
| |
| Shelly Gen4 devices:
| |
| Temperature reading: | Depends on the DS18B20 or DHT22 sensors |
| Humidity reading: | Depends on the DHT22 sensor |
| Digital input: | -15 V to 0.5 V (True) / 2.5 V to 15 V (False)* |
| Analog input range: | 0 to 100% |
| Analog input report threshold: | 1%** |
| Voltmeter range: | 0 to 10 V |
| Voltmeter report threshold: | 0.1 V** |
| Analog input / Voltmeter accuracy | Better than ±5% |
* Logic can be inverted in the digital input settings
** Can be configured in the analog input / voltmeter settings
Basic wiring diagrams

Legend
| Terminals | External sensor pins | ||
|---|---|---|---|
| VCC | Sensor power supply terminals | VCC/VDD | Sensor power supply pins |
| DATA | 1-wire data terminals | DATA/DQ | Sensor data pins |
| GND | Ground terminals | GND | Ground pins |
| ANALOG IN | Analog input | | |
| DIGITAL IN | Digital input | | |
| VREF OUT | Reference voltage output | | |
| VREF+R1 OUT | Reference voltage through a pull-up resistor* output | | |
| *For passive devices that need it to form a voltage divider. | | | |
Troubleshooting
...
Components and APIs
Printed user guide
Compliance
Installation guides
- Use Shelly Plus 2PM and Add-on with a wind sensor to retract your motorized awning in high winds
- Using Shelly Plus Add-on to measure soil moisture with a capacitive sensor
- Using Shelly Plus Add-on with a capacitive liquid detection sensor
- Using Shelly Plus Add-on with a LDR (photoresistor) to control lights