Sterowniki do akwariów
Najprostszy do zrobienia sterownik lamp LED AQma 7 WiFI
Nowa, wersja sterownika oświetlenia akwarium AQma WiFi LED Control 7. Zarządzanie z poziomu interfejsu WEB.
Do działania potrzebuje tylko ESP32!


Po pierwszym włączeniu serownik uruchomi się w trybie hotspota, Należy
włączyć w telefonie/komputerze WiFi i połączyć się z siecią „AQmaLED” z hasłem „aqmaaqma” sieć ta nie będzie miała dostępu do Internetu (dobrze mieć wyłączoną transmisje danych). Następnie należy wejść na stronę http://10.10.10.10 (koniecznie http) teraz na karcie ustawień można skonfigurować sterownik aby łączył się z domową siecią WiFi (konfiguracja zalecana). Po tej operacji i ponownym uruchomieniu AQma WiFi LED połączy się z siecią i będzie dostępna jak inne urządzenia w domu. Aby ułatwić odnalezienie adresu, który został przydzielony sterownikowi przez domowy router (o ile na karcie ustawień nie został skonfigurowany ręcznie stały adres IP) przez 60 sekund po uruchomieniu urządzenie będzie rozgłaszać swój adres IP w nazwie SSID sieci bezprzewodowej.
Jak zwykle soft za całkowitą darmochę można wgrać samemu i to bez kompilowania, czy znajomości programowania. Na dole strony dostępny jest AQmaUpdateTool-WiFi wystarczy go ściągnąć, uruchomić, podłączyć ESP32 do USB i kliknąć Aktualizuj i to tyle.
Schemat sterownika, prościej się nie da. Wystarczy ESP32 podłączyć pod ładowarkę USB i na opisanych pinach jest wyjście na osiem driverów (lub dowolnie mniej). Nie jest wymagane nic więcej. Jedyna zmiana to taka, że sterownik w czasie uruchomienia po zaniku prądu, musi mieć dostęp do internetu, aby mógł pobrać aktualny czas. Dobrze też aby w całym układzie była wspólna masa.

Sterownik można też złożyć w wersji rozbudowanej z zasilaniem z przetwornicy, buzerem, termometrem i wyjściem na wentylator, wtedy schemat wygląda tak:

Funkcjonalności:
- 8 osobno sterowanych kanałów PWM.
Każdy z kanałów może pracować w trybie manualnym, lub automatycznym. Konfigurować można: nazwę kanału, godzinę włączenia, wyłączenia, długość wschodu i zachodu słońca, a także minimalny i maksymalny procent mocy z jakim ma pracować kanał. Dodatkowo można wybrać kolor który będzie go reprezentował na panelu głównym, jak również dwa zakresy czasowe oświetlenia nocnego i jego moc. W przypadku zakupienia driverów z „odwrotnym” sterowaniem (podając masę na pin sterowania driver daje pełną moc) można to załatwić jednym kliknięciem „Odwróć”.
Oczywiście całość jest responsywna i dostosowana do wyświetlania na urządzeniach mobilnych.
- Trzy kanały dla przekaźników SSR (7 V – 12 V). Kanały te pracują jako timery z możliwością konfiguracji czterech zakresów czasowych załączenia.
- Sterowanie załączeniem wentylatorów na podstawie temperatury lampy.
- Sterownik może pracować jako Access Point lub jako klient podłączony do domowej sieci WiFi (konfiguracja zalecana). Możliwe jest również ustawienie statycznych adresów IP.
- Możliwe jest jednoczesne korzystanie z interfejsu przez kilku użytkowników. Zmiany reprezentowane są ze skutkiem natychmiastowym (u wszystkich podłączonych użytkowników) bez konieczności odświeżania strony. Teraz po co to jest? Sporo szukałem przyzwoitego wyświetlacza do DIY, ceny są duże a jakość średnia, a już żeby był dobry dotyk itp… Ciężka sprawa. Przydałoby się coś co połączy się z domową siecią WiFi, wyświetli interfejs, w tym przypadku stronę internetową no i żeby może jeszcze miało dotyk… Mam kilka takich urządzeń w szufladzie i pewnie większość z Was też :).
- Interfejs główny ma możliwość ukrycia nieużywanych kanałów. A wygląda tak:


- Trzy profile oświetlenia np. do zdjęć, czy aklimatyzacji.
- Możliwość automatycznego ładowania profili o określonym czasie. Umożliwia to tworzenie bardzo skomplikowanych schematów oświetlenia. Każdy z kanałów ma możliwość przejścia przez trzy osobne cykle wschodów i zachodów z zachowaniem możliwości konfiguracji wszystkich parametrów kanałów.
Dodatkowo:
- Aktualizacja oprogramowania z poziomu interfejsu, po WiFi bez konieczności podłączania kabli.
- Całość oprogramowania i skrypty są „na” sterowniku, nie potrzeba dostępu do Internetu.
- Sterowanie włączeniem wentylatorów wraz z histerezą, na podstawie zewnętrznego czujnika temperatury. Jeżeli brak zewnętrznego czujnika temperatury, sterownik będzie korzystał z wbudowanego czujnika.
- Sterownik współpracuje z inteligentnym domem, możliwe jest korzystanie z API (właśnie je opisuje), aktualnie opracowałem spięcie z Home Assistant, też to opiszę. Pomysł mam taki aby moc niektórych kanałów ustawiała się zależnie od nadprodukcji z PV. Szkoda te waty tracić. Poza tym są trzy kanały SSR, które umożliwiają włączenie bardzo dużych obciążeń (230 V), co też może się przydać.
- Simple dashboard, stan wszystkich kanałów na jednej karcie.


Najnowsza, wersja sterownika AQma WiFi LED Control ver. 2.7.14 (04.04.2026). Jest to skompilowane oprogramowanie dla ESP32, Bardzo prosta instalacja, za pomocą jednego kliknięcia. Wystarczy do USB podłączyć ESP32, uruchomić AQma Update Tool i kliknąć przycisk "Aktualizuj!". Nie wymaga środowiska programistycznego, instalacji bibliotek, kompilacji itp. W folderze WEB_Update znajduje się oprogramowanie do aktualizacji za pomocą interfejsu WEB.
Bonus, API do sterownika umożliwiające sterownie z zewnątrz:
1. Odczyt stanu urządzenia (Metoda GET)
Wszystkie te polecenia to klasyczne odpytywania typu GET
http://[IP-AQMA]/valCh.json– Główne polecenie do odczytu stanu. Zwraca obiekt JSON zawierający tablicę z aktualnym statusem dla każdego z 11 kanałów.- Zwraca format:
{"config": {"channel": [{"nr": "1", "status": "0", "testBar": "0", "onOff": "0", "testSwitch": "0", "chName": "Sump"}, ...]}}
- Zwraca format:
http://[IP-AQMA]/config/temp– Zwraca aktualną temperaturę odczytaną z czujnika DS18B20.http://[IP-AQMA]/config/time– Zwraca bieżący czas kontrolera.http://[IP-AQMA]/config/fan– Zwraca stan i ustawienia wentylatora.http://[IP-AQMA]/config/rssi– Zwraca siłę sygnału WiFi (w dBm).http://[IP-AQMA]/version– Zwraca wersję oprogramowania (np. „AQma WiFi LED v 2.7.14”).http://[IP-AQMA]/api/scan– Rozpoczyna asynchroniczne skanowanie sieci WiFi i docelowo zwraca listę odnalezionych sieci w formacie JSON względem siły sygnału.
2. Sterowanie parametrami i modułami (Metoda POST)
Do zapisu parametrów ścieżka /api. Przyjmuje ona klasyczne parametry formularza sieciowego HTTP (application/x-www-form-urlencoded – w taki sposób domyślnie komunikuje się chociażby cURL, interfejs webowy aplikacji i Home Assistant).
Możesz wywołać POST http://[IP-AQMA]/api przesyłając następujące wartości w tzw. „Body”:
A. Wysterowywanie poszczególnych kanałów LED (zamień X na numer od 1 do 11)
testBarChX(np.testBarCh1=50) – Wymusza określoną wartość jasności testowej (dla suwaka jasności).statusChX(np.statusCh3=1) – Zapisuje aktualny status logiczny dla kanału X.onOffChX("on"lub inna wartość) – Konfiguracja globalnego włączenia/wyłączenia danego kanału z poziomu interfejsu.testSwitchChX("on"lub inna wartość) – Aktywacja trybu bezpośredniego „Live” (wymuszenia) pomijająca harmonogramy.invertChX("on"lub inna wartość) – Inwersja sygnału PWM (potrzebne m.in dla przekaźników).- Parametry harmonogramów czasowych –
tOn1ChX=08:00,tOff1ChX=15:00oraz wartości minimalne i maksymalne (minChX=0,maxChX=100), czasy zachodówsrChXi wschodówssChX.
B. Sterowanie układami globalnymi i chłodzeniem
fanMode– Określa tryb chłodnicy. Przyjmuje wartości z przedziału0,1,2(Gdzie0= Auto,1= Wymuszony ON,2= Wymuszony OFF).fanOnTemp– Deklaracja granicznej temperatury dla automatycznego chłodzenia w stopniach (np.fanOnTemp=25.50).hysteresis– Histereza utrzymania temperatury chłodzenia.syncNtp=1– Wymusza nową synchronizację czasu wewnętrznego z serwerami Google/PL.
3. Sterowanie systemowe urządzenia (Metoda GET)
http://[IP-AQMA]/reboot– Powoduje twardy sprzętowy restart modułu ESP8266/ESP32.http://[IP-AQMA]/factoryReset– Czyści pamięć środowiskową EEPROM, po czym formatuje system wymazując ustawienia.









3 KOMENTARZE
Witam. Widzę nowe cudenko? Jak można go zbudować?
Hello! Thank you so much for sharing your project! I’m replacing the hardware (Arduino Mega) of my aquarium controller with your project. I’ve already tested several, currently I’m using the ESP32 version with ESP Home in Home Assistant. It’s not perfect, but it works 🙂 I’ve also tested v2.7.0 and today I installed v2.7.11 and there were some changes that were very appreciated! Especially the English version!
I still have some doubts about the temperature sensor, if it’s possible to use more than one, because in my case I have at least two (water and LED lights).
I also still don’t understand how the integration with Home Assistant works, but I think that information will be added soon 🙂
If I can help with any testing, I’m available, it will be a pleasure.
Greetings from Portugal,
Sérgio
Perfect!
Thank you so much for the „Bonus”! With this information, everything becomes much easier!
Now other questions arise, hehe 🙂
The description mentions „there are three SSR channels that allow the activation of very heavy loads (230V)”, which I can also find in the configurations (ch 9, ch10 and ch11), however, in the electrical diagram there is no associated pin… is there some detail I’m missing?
Regarding the temperature sensor, it’s OK, I can get a reading, but only from one of those I have connected to the 1wire bus. Is it possible to get readings from more sensors? That’s a key difference for monitoring in Home Assistant.
Thank you very much for sharing this project.
Sérgio