Shelly 2.5 - qtoggle/espqtoggle GitHub Wiki


Device

Description

Shelly 2.5 is a smart Wi-Fi-operated switch, featuring two cannels and power metering. By default, it runs the Shelly proprietary firmware.

There is no power management support in the current espQToggle firmware.

Configuration

Provisioning configuration name: espqtoggle/shelly/2.5.

Flash Parameters

  • flash mode: DIO
  • flash frequency: 40MHz

Pins

Number Function Remarks
0 status LED active low
4 relay 1 active high
5 push button 2 active low
13 push button 1 active low
15 relay 2 active high

Ports

Id Type Description Range/Unit Remarks
push_button1 boolean on/off button 1, setup button
push_button2 boolean on/off button 2
relay1 boolean relay 1
relay2 boolean relay 2
button_held button_held button held status

Installation

Requirements

Procedure

  1. :warning: 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. Identify the RX, TX, GND, VCC and GPIO0 connectors:

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

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

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

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

  8. 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.