Shelly H&T - qtoggle/espqtoggle GitHub Wiki

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

---

Device

Description

Shelly H&T is a WiFi-operated humidity and temperature sensor.

By default, it runs the Shelly proprietary firmware. It was designed to run either on battery or powered by a micro USB adapter.

Internally, it contains an HTS221 humidity & temperature sensor and a STM32L031 ultra-low-power microcontroller that intermediates data between the ESP8266 chip and the sensor.

:warning: The current espQToggle firmware does not allow sleep modes, meaning that you can't run your Shelly H&T device on battery, or you'll drain the battery within less than an hour.

:warning: Please note that due to the fact that the LED is controlled by the secondary microcontroller, it won't blink while in AP mode or setup mode.

Configuration

Provisioning configuration name: espqtoggle/shelly/ht.

Flash Parameters

• flash mode: DIO
• flash frequency: 80MHz

Pins

Number	Function	Remarks
12	HSPI MISO
13	HSPI MOSI
14	HSPI SCLK
15	HSPI CS

Ports

Id	Type	Description	Range/Unit	Remarks
temperature	number	temperature	-40..60 °C
humidity	number	humidity	0..100 %

Installation

Requirements

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

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. Open the device by turning one half of the device counter-clockwise:

   

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

   

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 and VCC.

7. Ensure device will boot into bootloader mode by connecting the second GND wire of your USB-to-serial adapter to the GPIO0 header.

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

   Note: if the device does not boot when plugging in the adapter, disconnect and reconnect the VCC wire. Note: if the device still doesn't want to boot, try connecting the VCC wire to the + battery connector of the device.

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

10. Disconnect all wires and reassemble the device.

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.