Shelly Plug S - qtoggle/espqtoggle GitHub Wiki
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
-
:warning: Do not power the device from mains! Do not connect it to AC at all during this procedure!
-
Read the flashing instructions and be prepared to follow the flashing procedure.
-
Disassemble the device by unscrewing the screw on the back.
-
Identify the RX, TX, GND, VCC and GPIO0:
-
Ensure the USB-to-serial adapter is not plugged into your laptop.
-
Connect the following USB-to-serial adapter wires to their corresponding connectors on the board: RX, TX, GND, VCC and GPIO0.
-
Plug the USB-to-serial adapter into your laptop, effectively powering the ESP chip on the board.
-
Follow the flashing procedure to flash the espQToggle firmware on the ESP chip.
-
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.