Shelly Plug S

• Device
  • Description
  • Configuration
  • Flash Parameters
  • Pins
  • Ports
• Installation
  • Requirements
  • Procedure
• Next Steps

---

Device

Description

Shelly Plug S is a smart plug, featuring:

• one remotely controllable socket
• power metering

Configuration

Provisioning configuration names: espqtoggle/shelly/plug-s.

Flash Parameters

• flash mode: DOUT
• flash frequency: 40MHz

Pins

Number	Function	Remarks
0	on/off LED	active low
2	status LED	active low
4	BL0937 CF1
5	BL0937 CF
12	BL0937 SEL
13	push button	active low
14	BL0937 CF1
15	relay	active high

Ports

Id	Type	Description	Range/Unit	Remarks
push_button	boolean	on/off button, setup button
led	boolean	on/off LED
relay	boolean	relay
active_power	number	active power	W	needs calibration
energy	number	energy	Wh	needs calibration
current	number	current	A	needs calibration
voltage	number	voltage	V	needs calibration
power_calib	number	power & energy calibration factor
voltage_calib	number	voltage calibration factor
current_calib	number	current calibration factor
apparent_power	number	apparent power	VA
power_factor	number	power factor	0..100 %

Installation

Requirements

• a USB-to-serial adapter
• a laptop running Windows, Linux or macOS

Procedure

1. ⚠️ Do not power the device from mains! Do not connect it to AC at all during this procedure!

2. Read the flashing instructions and be prepared to follow the flashing procedure.

3. Disassemble the device by unscrewing the screw on the back.

4. Identify the RX, TX, GND, VCC and GPIO0:

   

5. Ensure the USB-to-serial adapter is not plugged into your laptop.

6. Connect the following USB-to-serial adapter wires to their corresponding connectors on the board: RX, TX, GND, VCC and GPIO0.

7. Plug the USB-to-serial adapter into your laptop, effectively powering the ESP chip on the board.

8. Follow the flashing procedure to flash the espQToggle firmware on the ESP chip.

9. Disconnect all wires.

Next Steps

You can now power your device by connecting it to mains. Follow the initial setup instructions to connect the device to Wi-Fi and add it to your qToggle system.