Fridge or Freezer Alarm Plugin using Sonoff TH10 Smart WiFi Switch

This HomeBridge plugin provides a simple, low-cost way to receive alerts on your iPhone or Apple Watch if a fridge or freezer door has been left open. It adds a ContactSensor with embedded Temperature Sensor to HomeKit, and the ContactSensor state will raise alerts within HomeKit:

To use this plugin, you will need a £10 Sonoff TH10 Smart WiFi Switch running Tasmota firmware ('sensors' build) with an attached DS18B20 temperature sensor, and the sensor physically installed within the appliance somewhere.

Preparing the TH10

Flashing the Tasmota firmware on the device is straight-forward - you will need to download Tasmotizer for Windows and get a £5 serial programmer with wires such as WINGONEER CP2104 serial converter. The Sonoff must be opened (the case lid just pulls apart once the terminal cover screw has been removed) - ** IMPORTANT ** note that there are exposed components carrying mains electricity when the cover is removed - and solder on a 4-pin header. Connect up the serial interface (RX to TX and TX to RX), and press-and-hold the TH10 button whilst providing 3V3 power and keep holding for 10 seconds. Next load of Tasmotizer, select the 'sensors' release and hit program.

Once Tasmota has been installed, it must be configured to attach to your WiFi and so it knows it is running on a TH10 and has a DS18B20 sensor attached. This is done by through a browser and using a profile - see the Tasmotizer docs. It can take a couple of gos for these settings to 'stick' for some reason. Once working, the device will be reporting the sensor temperature in it's WebUI:

Note: Supports a single attached DS18B20 sesnor currently. These devices follow a one-wire protocol so it may be possible to connect two sensors, e.g. in a Fridge Freezer type appliance, to monitor both cavities in future.

Mounting the Sensor

Mounting the sensor in the appliance will depend on the appliance design and how permanent you want the sensor to be. This might be as simple as passing the sensor into the appliance on the door hinge side, and taping it in against the side, or you might decide to go further and drill a hole to enable permanent mounting.

In the particular freezer this was developed for, there is a temperature control knob inside that is little more than a vaiable resistor. The cavity this mounts in made an ideal installation point, with a single hole drilled through the back of the cavity through the side of the freezer, the wire passed in and the outside bunged up with a 20mm rubber gromit.

These pictures show the sensor within the appliance, and the wire tacked along the outside of the appliance (which in this case, is against a wall anyway) and finally the TH10 itself simply stuck to the back with double-sided foam sticky pads.

However the sensor is mounted, it must be within the thermal envolope within the freezer and have some air flow across it. Mounted behind the control knob as described, it is also necessary to drill some ventilation holes to ensure the interior temperature can be accurately metered through that case:

Contact and support

If find a problem or have any suggestions, please create an issue on the GitHub project page at: https://github.com/J1mbo/homebridge-TH10-Fridge-Freezer-Alarm/issues