HomeKit Smart Fish Tank Controller

Introduction: Provides remote query of water temperature and other information, remote control of water pumps, heating rods, lights, etc., and can also cooperate with the center to complete various automations
. Disclaimer: This project contains 220V strong electric connections, which requires certain basic knowledge of electricians before use. When the circuit is working and mains power is connected, you need to prepare your own insulating shell. The author is not responsible for personal accidents caused by personal reasons.
1. Product Introduction

This project is developed using ESP8266 (ESP-12E module) to realize unified management of fish tank equipment and provide remote monitoring functions for fish farming enthusiasts. The module is equipped with 4 relay modules (one of which is a solid-state relay, specifically for water pump inductive loads) to control water pumps, heating rods, lamps and fans respectively. One is DS18B20 water temperature monitoring, one is DHT11 base cabinet environment monitoring, and one is a switch contact button. Feeding trigger.


2. The application scenario

is mainly aimed at fish farming enthusiasts to realize intelligent monitoring of fish tanks
and other scenarios that require multiple relay switches


. 3. Product Overview

This module is designed as a universal version. Enthusiasts can flash different firmware and codes according to their own needs to achieve the required functions. Three access methods, Homekit, ESPHOME and tamsota, are provided for reference. All three methods can access HomeAssistant.
It is recommended to use the homekit method to connect. The module has a built-in feeding function (click the feeding button to turn off the pump and start automatically after 10 minutes). For other automation, please set up the homekit hub (ipad, homepod or appletv) and configure it under the "automation" option in the homekit app. . For the Homekit automation video tutorial, refer to the "Video Tutorial Link.txt" in the attachment.


4. Product parameters
(1) Hardware selection

master: ESP8266 (ESP12-E module)
Environmental sensor: DHT11
water temperature sensor: DS18B20 (waterproof probe)
Relay (note that the control voltage is 5V, don’t buy the wrong one):
5V solid-state relay X1: G3MB - 202PL 5V ordinary
relay​​​ Base cabinet environment measurement: Temperature 0.5℃ Humidity 1% (3) Specification parameter size: 86mm x 80mm double-layer board 5. Instructions for use: Video tutorial The video tutorial provides three methods: Homekit, ESPHome, and Tasmota, you can choose at will. Note: Video For the tutorial link, refer to the "Video Tutorial Link.txt" document in the attached material. 3D diagram introduction to firmware burning and configuration (it is recommended to watch the video tutorial for more details): 1. Unzip the attached compressed package, ground the flash port on the board, and use the serial port to ttl The module is connected to the 8266 programming interface and powered on; 2. Open flash_download_tool.exe in the compressed package and select developer mode--esp8266; 3. Configure the burning file on the SPIDownload page, and the burning file is in the firmware folder of the compressed package, in order For rboot.bin (address 0x0000), blank_config.bin (0x1000), haamain.bin (0x2000) 4. Click START to burn. After successful burning, remove the flash short-circuit jumper and connect an external 5V power supply (above 1A) , restart the module 5. After the module restarts, use a computer with wireless to turn on the wireless, find the wireless hotspot starting with HAA and connect it. After connecting, open the browser and enter 192.168.4.1:4567 to open the web configuration 6. Scan for wifi in the web configuration and enter Password 7. Open the haa_fish_tank_controller (json configuration file).txt file in the attached compressed package, copy the json text content inside, paste it in the Json text box of the configuration web page, and click Save 8. After the module is restarted, it will be automatically configured as a bridge device. Use your iPhone, iPad or Mac to open Apple Home for pairing and use (the pairing code is 02182017). Troubleshooting: 1. After the burning is completed, the ap hotspot is not found. Unplug the shorting cap of the flash pin (i.e. GPIO_0 to ground jumper) cap) and then restart 2. After opening the configuration webpage and inputting json, the ap hotspot does not disappear. If the homeki device cannot be found, restart it first. If there are still ap hotspots, it means that the json copy is incorrect. It is recommended to directly copy the content of the configuration file in the attachment and paste it 3. After the module performs relay operation, it will prompt that the accessory is not responding . It may be that the 5V power supply current is insufficient. It is recommended to use a mobile phone charger from a regular manufacturer (power greater than 5W). It may also be that the performance of the wireless router is insufficient. Check whether there are too many 2.4g devices. 4. The device cannot Networking may be a power problem, or it may be the dual-band function of the router (it is recommended to separate the SSIDs of the 2.4g and 5g bands) 6. Note that this project requires burning software before use. Please see the attachment for the Homekit version firmware and configuration file. , please refer to the video tutorial for other access methods. The attachments include the following: the firmware file used for burning, the burning tool (flash_download_tool), the json configuration file (haa_fish_tank_controller), the pairing QR code and the pairing code (either can be used) ESPHome's yaml configuration file and Tasmota's rule writing method (please refer to the video tutorial for specific burning and configuration) Video tutorial link (homekit, EspHome, and tasmota are provided) Notes: This project does not reserve an onboard burning chip, and you need to prepare your own USB to TTL module , such as ch340, etc., the very cheap power supply is divided into two parts, 5V control power supply and 220V relay power supply. For 5V power supply, a power supply of more than 1000mA is recommended. The accessories provided by this project are the homekit version, tasmota and esphome version configuration files. Please refer to the video tutorial for a total of four relays. One of the channels is a solid-state relay, dedicated to the water pump. Do not connect the water pump to other relays, otherwise it will cause the module to restart when it is turned off. This project contains strong current parts, so be sure to protect it when using it, and insulate each terminal to prevent strong currents. Electrical terminals are best used in the soldering form





































































The production cost

is about 40 yuan

7. Test video

The test video shows the functions of the fish tank controller, including homekit control switch, Siri control, temperature and humidity remote monitoring, etc. The controller has a built-in feeding function, and other automation functions need to be used in conjunction with the homekit center, such as For functions such as preventing fish cooking, please refer to the video tutorial in the attachment for setting methods.