FritzGate

FritzGate transforms your Ai Thinker board into a smart thermostat controller. This project enables seamless control of thermostats connected to a FRITZ!Box (FRITZ!DECT 301 and FRITZ!DECT 302), integrating for precise temperature control any of 70+ temperature sensors from leading vendors such as Govee, Xiaomi, Shelly, Ruuvi, Inkbird, SwitchBot, and ThermoPro.

Demo

View the online demo here.

Features

• FRITZ!Box integration: FritzGate does not affect weekly plans or other thermostat settings. Connect and control thermostats directly from FritzBox.
• Binding with external Temperature Sensors: Utilize third party temperature sensors placed in living spaces for precise temperature control in a room. FritzGate automatically corrects temperature offsets of thermostat sensors.
• Embedded Web Server: Easily manage thermostat-sensor bindings, monitor temperature and humidity through a user-friendly web interface.

Advantages

• Easy Configuration: Set up effortlessly by scanning a QR code with the Ai Thinker camera for Wi-Fi credentials.
• Cost-Effective Hardware: Utilize the budget-friendly and energy efficient ESP32-CAM board.
• Powered by FRITZ!Box: Leverage the convenience of powering the device directly from the FRITZ!Box* USB port, eliminating the need for additional space and power sources.
• 70+ Supported Sensors: Use any of 70+ models of temperature sensors for precise climate control in living spaces, ensuring optimal comfort and energy savings.
• Embedded Web Server: Easily manage thermostat-sensor bindings through the embedded web server, providing an intuitive interface for users to customize and monitor their smart heating system.
• Can be used without FRITZ!Box: If you're not authorized in FritzBox, you can still monitor temperature and humidity from nearby temperature sensors.

Getting Started

Hardware Requirements

• Ai Thinker ESP32-CAM board
• Temperature sensors
• Fritzbox with compatible thermostats (optional)

Installation

1. Clone the repository to your local machine:

   git clone https://github.com/vnau/FritzGate.git

2. Open the project in PlatformIO or Arduino IDE, depending on your preference.

3. For PlatformIO Users:

   • Upload the code to your Ai Thinker ESP32-CAM board.
   • After the first start, use the Ai Thinker ESP32-CAM board camera to scan the Wi-Fi QR code. This will configure the Wi-Fi credentials automatically.

4. For Arduino IDE Users:

   • Ensure you have NTPClient and ArduinoJson Arduino libraries installed before building the project.
   • Set Wi-Fi credentials directly in the code (alternatively, you can install the ESP32QRCodeReader library from Github to be able to read the WiFi QR code).
   • Upload the code to your Ai Thinker ESP32-CAM board.

5. Access the web interface by navigating to the IP address assigned by the router, or by using the link http://fritzgate.

Compatible Sensors

• April Brother: ABN03, ABN07, ABTemp
• BlueMaestro: TD1in1, TD3in1, TD4in1
• ClearGrass/Qingping: CGC1, CGD1, CGG1, CGP1W, CGP23W
• Govee: H5072, H5074, H5075, H5100, H5101, H5102, H5104, H5105, H5106, H5108, H5174, H5177, H5179
• Inkbird: IBS-P01B, IBS-TH1, IBS-TH2, IBT_2X(S), IBT_4X(S/C), IBT_6X(S), ITH-12S
• Jaalee: F525/F51C
• MOKOSMART: MBXPRO
• Oria/Brifit/SigmaWit/SensorPro: T201, T301
• Qingping: CGDK2
• rbaron: BPv1.0-1.2
• Sensirion: SCD4X, SHT4X
• SensorBlue/Oria/Brifit: WS02/WS08
• Shelly: SBHT-003C
• Ternergy: SOLIS_6
• ThermoPro: TP357, TP358, TP359, TP393
• Xiaomi: HHCCJCY10, HHCCPOT002, LYWSD03MMC_ATC/PVVX, LYWSDCGQ, MHO/MMC-C401_ATC/PVVX, MJWSD05MMC_ATC/PVVX
• Xiaomi/Mijia: LYWSD02
• Xiaomi/VegTrug: HHCCJCY01HHCC

For a complete list, view the list of Theengs-compatible devices